Intramedial está en beta restringida. Al registrarte o iniciar sesión, debes indicar la contraseña de beta tester que recibiste o solicitar una en preview@intramedial.com. Gracias.
Cargando…
roles.chartersMódulo 45
Módulo de la plataforma
Roles and posts
Cubre un puesto de un yard una vez y deja que todo lo dependiente se vincule al propio rol, para que el titular pueda cambiar de manos sin que nada que dependa de él lo note.
roles.charters lee los roles de utilidad fijos (yardmaster, steward, librarian, gatekeeper, clerk, auditor y treasurer) y los roles de aplicación que un yard ha declarado. Un yard recibe los siete cubiertos automáticamente al crearse; otras rutas resuelven un deber, traspasan un puesto o leen su historial.
Los agentes actúan cuando el plano dice sí, y el registro dice por qué.
Pasa por Intramedial acciones de agentes, hashes de contenido, pruebas de API, DNS, webhooks, llamadas LLM y commits. Obtén un recibo firmado que cualquiera verifica, sin fiarse de nadie.
Ninguna acción de aquí tiene id de MCP ni de contrato; los roles son accesibles solo por la superficie REST en bruto. Sin un POLICY_STORE vinculado, el estado de los puestos vive solo en la memoria del propio isolate y no es duradero entre reinicios.
Registro
El registro
Qué se registra
role
El nombre del puesto, como gatekeeper o un rol de aplicación que declaró un yard.
yardId
El yard al que pertenece el puesto.
staffing
null si está vacante, o {by:"agent", did}, o , cada uno con .
Los deberes que se espera que cumpla un rol, usados para validar cualquier dotación ofrecida para él.
history
Los traspasos por los que ha pasado un puesto, del más antiguo al más reciente.
posts
Todos los puestos que devuelve list o staff-yard para un yard.
Mecanismo
Paso a paso
Cómo funciona
Un yard se dota al crearse
Las acciones create y fork de yards.list llaman a la rutina de dotación de este módulo, que cubre los siete puestos de utilidad si no están ya presentes.
Direccionado por rol, no por titular
get y resolve encuentran un puesto solo por role y yardId. Quien guardó un DID en su lugar ya ha roto por su parte el contrato de direccionamiento.
La dotación se valida primero
staff y restaff comprueban que la dotación cubra todos los deberes que lista la carta del puesto; un endpoint de servicio debe ser https, no localhost, interno ni una IP desnuda.
Los puestos de utilidad no pueden quedar vacantes
vacate rechaza sobre un rol de utilidad; solo un rol de aplicación que un yard declaró para sí puede vaciarse, ya que un yard sin gatekeeper tiene una puerta abierta, no un hueco de dotación.
Pruébalo
Demo en vivo
Ejecútalo desde esta página
GET/api/v1/acp/roles/charters
// Sin cuerpo: esto es un GET. Pulsa Ejecutar.
Se ejecuta en un workspace de demostración compartido con una clave de demostración: cualquiera puede ver lo que contiene, así que no envíes nada privado. Docs de roles.charters
Respuestas
Pulsa Ejecutar para enviar la solicitud de la izquierda al workspace de demostración compartido.
Se ejecuta en un workspace de demostración compartido con una clave de demostración: cualquiera puede ver lo que contiene, así que no envíes nada privado.
Código
Ejemplo en vivo
Una petición real
Una petición con la forma que acepta la API y una respuesta de ejemplo con la forma que devuelve el módulo.
api.intramedial.com/api/v1/acp/roles/chartersGET
GET/api/v1/acp/roles/chartersAuthorization: Bearer av_workspace_••••→ 200 { utility, application, names } (there is no `charters` field; `utility` lists the seven frozen posts and `application` lists the ones a yard has declared)
restaff mueve yardmaster del DID de un agente a otro sin tocar nada que direccione el puesto por rol y yard, ya que la dirección nunca cambió.
Detectar una dotación insuficiente
Un operador intenta cubrir treasurer con un servicio que solo cubre budget, no charge, forecast ni freeze. La llamada se rechaza nombrando los deberes que faltan.
Resolver quién responde ahora de un deber
resolve con un duty responde qué puesto lo cubre y desde cuándo, o 409 si el puesto está vacante en lugar de adivinar un valor por defecto.
Leer el historial de traspasos de un puesto
history muestra todos los titulares que ha tenido un puesto, útil para rastrear qué agente cubría clerk durante un incidente.
Cuándo usar otra cosa
Decidir qué puede hacer un agente. Un puesto nombra quién responde de un rol; los grants vienen de mandatos compilados mediante coordination.admit.
Un nuevo contador de facturación o acción de catálogo. La dotación va incluida en la creación del yard, que ya se mide allí.
Direccionar un puesto por el DID de un agente. Los puestos solo se encuentran por role y yardId; no se admite buscar por DID.
Evidencia
Garantías
Qué hace y qué no hace
Un módulo es una afirmación fuerte sobre algo acotado. Confía en él exactamente para lo que es.
Hace
Los siete puestos de utilidad de un yard existen en cuanto se crea, cubiertos por defecto con endpoints de módulos del árbol salvo que algo los vuelva a cubrir.
Una dotación ofrecida para un puesto solo se acepta si nombra todos los deberes que exige la carta del puesto; una dotación parcial se rechaza con las lagunas listadas.
Un puesto de utilidad nunca puede quedar vacante; vacate lo rechaza y solo tiene éxito en un rol de aplicación que el propio yard declaró.
No hace
Que un agente o servicio dotado sea realmente accesible o se comporte bien. La dotación es un registro de quién responde de un rol, no una comprobación de salud.
Que el estado sobreviva a un reinicio. Sin un almacén de política vinculado, los puestos viven solo en la memoria del isolate.
Quién es responsable de un traspaso. restaff conserva la dotación anterior y la nueva pero no quién hizo el cambio.
Detalles
Notas de construcción
Antes de construir
Una escritura reintenta y luego se rinde con honestidad
Una escritura contra el almacén de política reintenta hasta cinco veces ante un cambio concurrente antes de responder 503, en lugar de reintentar para siempre o descartar la escritura en silencio.
La dotación por defecto apunta al árbol
Antes de que nadie vuelva a cubrir un puesto, responde ante un endpoint de módulo del árbol, como clerk por defecto al módulo del ledger, así que un yard nuevo nunca se dota con nada.
Catálogo congelado a propósito
Este módulo no añade ninguna acción nueva al catálogo congelado ni un nuevo contador de facturación; la dotación va con el contador de creación de yards.
Límites y medición
Ninguna acción de aquí tiene id de acción MCP ni de contrato; solo es accesible por REST.
Un endpoint de servicio dotado para un puesto debe ser https, con un hostname real; localhost, .local, .internal, una IPv4 desnuda o un literal IPv6 desnudo se rechazan.
restaff rechaza si el puesto no está ya dotado; usa staff para una primera asignación.
Acceso
API y MCP
REST y MCP
Autentícate con una clave de API del workspace como token Bearer. La URL base es https://api.intramedial.com.
Endpoints REST
GET/api/v1/acp/roles/chartersLee los roles de utilidad fijos y los declarados de este yard.
GET/api/v1/acp/roles/listLista los puestos de un yard y cuántos están dotados por tipo.
Acciones MCP
Este módulo no tiene acción MCP. Llámalo por REST desde cualquier agente o programa.
Módulo de la plataforma
