O Intramedial está em beta restrito. Ao se cadastrar ou entrar, você precisa informar a senha de beta tester que recebeu ou solicitar uma em preview@intramedial.com. Obrigado.
Carregando…
roles.chartersMódulo 45
Módulo da plataforma
Roles and posts
Preencha um posto em um yard uma vez e deixe cada dependente se ligar ao próprio papel, para que o detentor possa mudar sem que nada que dependa dele perceba.
roles.charters lê os papéis utilitários congelados – yardmaster, steward, librarian, gatekeeper, clerk, auditor e treasurer – e os papéis de aplicação que um yard declarou. Um yard recebe os sete preenchidos automaticamente na criação; outras rotas resolvem um dever, passam um posto adiante ou leem seu histórico.
Os agentes agem quando o plano diz sim, e o registo diz porquê.
Passe ações de agentes, hashes de conteúdo, checagens de API, DNS, webhooks, chamadas de LLM e commits git pela Intramedial. Receba um recibo assinado que todos verificam – sem confiar em nós.
Nenhuma ação aqui tem id MCP ou de contrato; os papéis só são acessíveis pela superfície REST bruta. Sem um POLICY_STORE vinculado, o estado dos postos vive só na memória do próprio isolate e não é durável entre reinicializações.
Registro
O registro
O que é registrado
role
O nome do posto, como gatekeeper ou um papel de aplicação que um yard declarou.
yardId
O yard a que o posto pertence.
staffing
null quando vago, ou {by:"agent", did}, ou , cada um com .
Os deveres que se espera de um papel, usados para validar qualquer preenchimento oferecido para ele.
history
As passagens de bastão por que um posto passou, da mais antiga à mais recente.
posts
Todo posto que list ou staff-yard devolve para um yard.
Mecanismo
Passo a passo
Como funciona
Um yard é preenchido na criação
As ações create e fork de yards.list chamam a rotina de preenchimento deste módulo, que preenche os sete postos utilitários se ainda não estiverem presentes.
Endereçado por papel, não por detentor
get e resolve encontram um posto apenas por role e yardId. Quem chama que armazenou um DID já quebrou o contrato de endereçamento do seu lado.
O preenchimento é validado primeiro
staff e restaff conferem que o preenchimento cobre todo dever que a carta do posto lista; um endpoint de serviço deve ser https, não localhost, interno nem um IP puro.
Os postos utilitários não podem ficar vagos
vacate recusa em um papel utilitário; só um papel de aplicação que um yard declarou para si pode ser esvaziado, pois um yard sem gatekeeper tem a porta aberta, não uma lacuna de pessoal.
Experimente
Demo ao vivo
Execute a partir desta página
GET/api/v1/acp/roles/charters
// Sem corpo: isto é um GET. Clique em Executar.
Executa em um workspace de demonstração compartilhado com uma chave de demonstração: qualquer pessoa pode ver o que ele contém, então não envie nada privado. Docs de roles.charters
Respostas
Clique em Executar para enviar a requisição à esquerda ao workspace de demonstração compartilhado.
Executa em um workspace de demonstração compartilhado com uma chave de demonstração: qualquer pessoa pode ver o que ele contém, então não envie nada privado.
Código
Exemplo ao vivo
Uma requisição real
Uma requisição no formato que a API aceita e um exemplo de resposta no formato que o módulo devolve.
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 move yardmaster do DID de um agente para outro sem tocar em nada que endereça o posto por papel e yard, pois o endereço nunca mudou.
Pegar um preenchimento insuficiente
Um operador tenta preencher treasurer com um serviço que cobre só budget, não charge, forecast e freeze. A chamada é recusada com os deveres faltantes nomeados.
Resolver quem responde por um dever agora
resolve com um duty responde qual posto o cobre e desde quando, ou devolve 409 se o posto está vago em vez de adivinhar um padrão.
Ler o histórico de passagem de um posto
history mostra todo detentor que um posto já teve, útil para rastrear qual agente preenchia clerk na hora de um incidente.
Quando usar outra coisa
Decidir o que um agente pode fazer. Um posto nomeia quem responde por um papel; as concessões vêm de mandatos compilados por coordination.admit.
Um novo medidor de cobrança ou ação de catálogo. O preenchimento vem embutido na criação do yard, que já é medida lá.
Endereçar um posto pelo DID de um agente. Os postos só são encontrados por role e yardId; uma busca por DID não é suportada.
Evidência
Garantias
O que faz e o que não faz
Um módulo é uma afirmação forte sobre algo estreito. Confie nele exatamente pelo que ele é.
Faz
Os sete postos utilitários de um yard existem no momento em que ele é criado, preenchidos por padrão com endpoints de módulos internos, a menos que algo os repreencha.
Um preenchimento oferecido para um posto só é aceito se nomear todos os deveres que a carta do posto exige; um preenchimento parcial é recusado com as lacunas listadas.
Um posto utilitário nunca pode ficar vago; vacate o recusa e só tem sucesso para um papel de aplicação que o próprio yard declarou.
Não faz
Que um agente ou serviço preenchido esteja de fato acessível ou se comportando. O preenchimento é um registro de quem responde por um papel, não uma verificação de saúde.
Que o estado sobreviva a uma reinicialização. Sem um armazenamento de políticas vinculado, os postos vivem só na memória do isolate.
Quem responde por uma passagem de bastão. restaff guarda o preenchimento anterior e o novo, mas não quem fez a mudança.
Detalhes
Notas de construção
Antes de construir
Uma gravação tenta de novo e desiste com honestidade
Uma gravação no armazenamento de políticas tenta até cinco vezes diante de uma mudança concorrente antes de responder 503, em vez de tentar para sempre ou descartar a gravação em silêncio.
O preenchimento padrão aponta para dentro
Antes de alguém repreencher um posto, ele responde a um endpoint de módulo interno, como clerk usando por padrão o módulo do ledger, então um yard novo nunca fica sem ninguém.
Congelado no catálogo de propósito
Este módulo não adiciona ação nova ao catálogo congelado nem medidor de cobrança novo; o preenchimento vai no medidor de criação de yard.
Limites e medição
Nenhuma ação aqui tem id de ação MCP ou de contrato; só é acessível por REST.
Um endpoint de serviço usado em um posto deve ser https, com hostname real; localhost, .local, .internal, um IPv4 puro ou um literal IPv6 puro são todos recusados.
restaff recusa se o posto ainda não está preenchido; use staff para a primeira atribuição.
Acesso
API e MCP
REST e MCP
Autentique-se com uma chave de API do workspace como token Bearer. A URL base é https://api.intramedial.com.
Endpoints REST
GET/api/v1/acp/roles/chartersLeia os papéis utilitários congelados e os declarados deste yard.
GET/api/v1/acp/roles/listListe os postos de um yard e quantos estão preenchidos por tipo.
Ações MCP
Este módulo não tem ação MCP. Chame-o por REST a partir de qualquer agente ou programa.
Módulo da plataforma
