@t4h/agent-runtime 0.1.1 → 0.3.0

package/README.md

@@ -1,10 +1,12 @@
 # @t4h/agent-runtime
 
 Runtime dos **colaboradores digitais** da Tech for Humans. Um agente é uma pasta
-(`agent.yaml`, `persona.md`, `skills/`, `evals/`); este pacote faz o resto:
+(`agent.yaml`, `persona.md`, `skills/`, `evals/`); este pacote faz o resto, como o
+`@t4h/mcp-provider-sdk` faz para os providers:
 
 - valida o `agent.yaml` (schema v1 em `schema/agent.schema.json` + regras entre campos);
-- caixa de entrada no Postgres: junta eventos por assunto, descarta repetido, ordena por prioridade;
+- caixa de entrada no Postgres: junta eventos por assunto, descarta repetido (por fonte),
+  ordena por prioridade; evento novo acorda o agente, e o cron fica como rede de segurança;
 - rodadas com lock, teto de itens e de tempo, backoff e exceção para o DRI;
 - portão de política em toda chamada de ferramenta: nível por rotina (shadow, copilot,
   agent, autonomous), proibidas, motivo obrigatório, idempotência, janela e teto por hora;
@@ -12,13 +14,100 @@ Runtime dos **colaboradores digitais** da Tech for Humans. Um agente é uma past
 - memória curta (SQLite, uma execução) e longa (Postgres);
 - acesso aos sistemas só pelo Enterprise MCP Gateway, com a identidade própria do agente
   (client do Keycloak com service account);
-- cérebro: Claude Agent SDK isolado (sem ferramentas built-in, sem config do disco).
+- cérebro: Claude Agent SDK isolado (sem ferramentas built-in, sem config do disco);
+- o conector `agents_<círculo>` (proto, handlers e catálogo base, versionados juntos),
+  o ambiente validado no boot e o processo inteiro em `startAgents()`.
 
-O template de repositório de agentes e o agente de referência vivem em
-[`t4h-agents`](https://github.com/tech4humans-brasil/t4h-agents).
+Cada círculo cria o seu repositório de agentes a partir de um template (ver
+[Usar como template](../../web/src/content/agents/01-usar-como-template.md)). A documentação
+completa está na seção **Agentes** do site do gateway.
 
 ```bash
 pnpm --filter @t4h/agent-runtime build
 pnpm --filter @t4h/agent-runtime test     # sem modelo: ScriptedBrain + PGlite
 t4h-agent validate agents/                 # valida os agent.yaml de um repositório
+t4h-agent catalog financeiro --endpoint agentes-financeiro.example.com:443 > catalog.yaml
 ```
+
+## Entrypoint de um repositório de agentes
+
+```ts
+import { startAgents } from '@t4h/agent-runtime';
+
+await startAgents({ agentsDir: 'agents', pluginsDir: process.env.PLUGINS_DIR });
+```
+
+`startAgents` carrega os agentes, valida o ambiente (`loadAgentEnv`), abre o banco e roda
+as migrações, sobe o webhook de eventos, o cron e o conector gRPC (`createProviderServer`
+do SDK, auditoria em JSON no stdout) e trata SIGINT/SIGTERM parando na ordem: entrada,
+conector, conversas em andamento, banco. Opções: `wiring` (substitui o gateway por um stub
+local; recusado em produção), `notifier`, `brain`. Fora de produção, sem as variáveis do
+passaporte, sobe sem o conector (com aviso).
+
+## Conector `agents_<círculo>`
+
+Contrato em `proto/t4h/agents/v1/agents.proto` (`AGENTS_SERVICE_FQN`, `agentsProtoPath()`),
+handlers em `agentsConnectorHandlers(host)` e catálogo base em
+`catalog/agents.catalog.yaml` (`agentsCatalog({ circle, endpoint })` ou
+`t4h-agent catalog`). O slug segue `^agents_[a-z0-9_]+$`. Os grants são por tabela:
+
+| Tabela | Tools | Quem recebe |
+|---|---|---|
+| `agente` | `agents_list`, `agent_ask`, `agent_answer` | quem pode ver e conversar com os agentes |
+| `acao` | `agent_explain`, `action_correct` | quem audita e corrige |
+| `proposta` | `agent_proposals`, `proposal_decide` | quem aprova (líder do time, DRI) |
+| `controle` | `agent_block`, `routine_cap` | só Segurança e o DRI |
+
+A conversa é assíncrona: o gateway corta a chamada ao provider em
+`PROVIDER_CALL_TIMEOUT_MS` (30 s por padrão). `agent_ask` espera até `AGENTS_ASK_WAIT_MS`
+(20 s) e, se a resposta não veio, devolve `running` com o `ask_id`; `agent_answer` busca
+depois, de qualquer réplica, e só para quem perguntou.
+
+## Eventos
+
+`POST /agents/:id/events` com `x-t4h-source: <fonte>` e
+`x-t4h-signature: t=<unix s>,v1=<hex>`, onde `v1 = HMAC-SHA256(segredo da fonte, "<t>.<corpo cru>")`
+(`signEvent()` monta o header). Tolerância de 300 s. O id do evento é gravado como
+`<fonte>:<id>`. `POST /agents/:id/rounds` só existe fora de produção.
+
+## Ambiente
+
+| Variável | Produção | Padrão / fora de produção |
+|---|---|---|
+| `DATABASE_URL` | `postgres://…` obrigatório | `pglite:<pasta>` ou em memória |
+| `EVENTS_HMAC_SECRETS` | `fonte=segredo,…`, ao menos uma | sem: aceita sem assinatura |
+| `EVENTS_PORT` / `EVENTS_WAKE_DEBOUNCE_MS` | | 8080 / 10000 |
+| `GATEWAY_URL`, `KEYCLOAK_ISSUER` | obrigatórios | sem `GATEWAY_URL`: `wiring` local |
+| `AGENT_<ID>_CLIENT_SECRET` | um por agente (hífen vira `_`) | |
+| `GATEWAY_DEV_TOKEN` | proibido | token fixo no lugar do Keycloak |
+| `ANTHROPIC_ORGANIZATION_ID`, `ANTHROPIC_FEDERATION_RULE_ID`, `ANTHROPIC_SERVICE_ACCOUNT_ID` (`ANTHROPIC_WORKSPACE_ID`) | credencial do modelo por federação (ou `ANTHROPIC_API_KEY`) | no GitHub Actions, a identidade é o OIDC do job |
+| `ANTHROPIC_IDENTITY_SOURCE` / `ANTHROPIC_KEYCLOAK_SCOPE` / `ANTHROPIC_OIDC_AUDIENCE` | | `keycloak` (`github-actions` no Actions) / `aud-claude-console` / `https://api.anthropic.com` |
+| `AGENTS_ASK_WAIT_MS` | | 20000, abaixo de `PROVIDER_CALL_TIMEOUT_MS` (30000) |
+| `PORT`, `GATEWAY_JWKS_URL`, `GATEWAY_ISSUER`, `SERVICE_AUDIENCE`, mTLS | como em `loadProviderEnv()` | sem passaporte: sem conector |
+
+## Credencial do modelo sem API key (0.3)
+
+Com os IDs de Workload Identity Federation da Anthropic no ambiente, o runtime troca um JWT
+por um token curto da API e o entrega ao Claude Code de cada execução
+(`ANTHROPIC_AUTH_TOKEN`). A troca é feita uma vez, no runtime, e não em cada processo: o JWT
+tem `jti` de uso único, e cada troca pede um JWT novo.
+
+- **Aplicação (`keycloak`):** o client do próprio agente (`agent-<id>`) faz
+  `client_credentials` no escopo `aud-claude-console`. O agente usa o modelo com a mesma
+  identidade com que usa o gateway.
+- **CI dos evals (`github-actions`):** o token OIDC do job (`permissions: id-token: write`),
+  sem segredo no repositório. É o padrão quando `ACTIONS_ID_TOKEN_REQUEST_URL` existe.
+- `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, profile ou Bedrock/Vertex continuam valendo
+  (o Claude Code resolve sozinho). Uma API key junto com os IDs da federação falha no boot,
+  porque a key venceria em silêncio.
+
+## Da 0.1 para a 0.2
+
+- O conector (proto, handlers, catálogo) e o wiring do gateway saíram do template e
+  vieram para cá; o template deixa de depender de `@t4h/mcp-provider-sdk` e `@grpc/grpc-js`.
+- `AskAgent` agora devolve `ask_id`/`status` e ganhou `GetAnswer`; `conversation_id` virou
+  `thread_id`. RPCs novas: `SetBlocked` e `CapRoutine` (tabela `controle`).
+- `host.listen(port, secret)` virou `host.listen(port, { secrets, allowManualRounds, production })`;
+  `EVENTS_HMAC_SECRET` virou `EVENTS_HMAC_SECRETS` (por fonte, com timestamp) e
+  `verifySignature` saiu (use `verifyEventSignature`).
+- Migração aditiva: tabela `agent_conversation` e coluna `agent_event.source`.

package/catalog/agents.catalog.yaml

@@ -0,0 +1,123 @@
+# Catálogo do conector de agentes de um círculo, gerado por
+#   t4h-agent catalog {{circle}} --endpoint {{endpoint}}
+# a partir do catálogo base do @t4h/agent-runtime (versionado junto do proto). Não edite à
+# mão: gere de novo com a versão do runtime que o círculo usa.
+#
+# Cada chave de inputSchema.properties é um campo do request no proto (snake_case). Grants
+# (URN `agents_{{circle}}:<resourceTable>:<campo>`) seguem o fluxo de permissões da
+# plataforma, nunca este arquivo:
+#   agente:   agents, agent_id, ask_id, status, answer, error  quem pode ver e conversar com os agentes
+#   acao:     actions, action_id, status, routine_level         quem audita e corrige
+#   proposta: proposals, action_id, status, result_json         quem aprova (líder do time, DRI)
+#   controle: agent_id, blocked, routine, level                 só Segurança e o DRI
+subservice: agents_{{circle}}
+endpoints:
+  local: '{{local_endpoint}}'
+  production: '{{endpoint}}'
+tools:
+  - name: agents_list
+    rpc: ListAgents
+    description: 'Lista os colaboradores digitais deste círculo: o que cada um faz, o nível de cada rotina agora (e por que desceu, se desceu), DRI, time e se está bloqueado.'
+    resourceTable: agente
+    readOnly: true
+    inputSchema: { type: object, properties: {} }
+
+  - name: agent_ask
+    rpc: AskAgent
+    description: 'Conversa com um agente. Ele só lê, com o acesso dele. Se a resposta vier com status "running", chame agent_answer com o ask_id em alguns segundos; se vier "error", agent_answer traz o motivo. Cada pessoa tem um teto de perguntas em andamento com o mesmo agente. Para pedir uma ação, abra a demanda pelo canal normal.'
+    resourceTable: agente
+    readOnly: false
+    inputSchema:
+      type: object
+      properties:
+        agent_id: { type: string }
+        message: { type: string }
+        thread_id: { type: string, description: 'Opcional: para continuar uma conversa, passe o ask_id da primeira pergunta (ou um id seu: até 64 letras, dígitos, "_" ou "-"). O agente recebe as últimas trocas desse fio feitas por você.' }
+      required: [agent_id, message]
+
+  - name: agent_answer
+    rpc: GetAnswer
+    description: 'Busca a resposta de uma pergunta feita com agent_ask. Enquanto vier "running", espere alguns segundos e chame de novo. Só quem perguntou lê a resposta.'
+    resourceTable: agente
+    readOnly: true
+    inputSchema:
+      type: object
+      properties:
+        ask_id: { type: string }
+      required: [ask_id]
+
+  - name: agent_explain
+    rpc: ExplainActions
+    description: 'Mostra o que um agente fez, em que modo (executou, propôs, só registrou, foi barrado) e com que motivo. Filtra por assunto (ex.: ticket:123).'
+    resourceTable: acao
+    readOnly: true
+    inputSchema:
+      type: object
+      properties:
+        agent_id: { type: string }
+        subject: { type: string }
+        limit: { type: integer, minimum: 1, maximum: 100 }
+      required: [agent_id]
+
+  - name: agent_proposals
+    rpc: ListProposals
+    description: 'Propostas de um agente esperando aprovação de uma pessoa (rotinas no nível Copiloto).'
+    resourceTable: proposta
+    readOnly: true
+    inputSchema:
+      type: object
+      properties:
+        agent_id: { type: string }
+      required: [agent_id]
+
+  - name: proposal_decide
+    rpc: DecideProposal
+    description: 'Aprova ou recusa uma proposta. Aprovada, a ação roda na hora com a identidade do agente e fica registrada com quem aprovou.'
+    resourceTable: proposta
+    readOnly: false
+    inputSchema:
+      type: object
+      properties:
+        action_id: { type: integer }
+        approve: { type: boolean }
+        note: { type: string }
+      required: [action_id, approve]
+
+  - name: action_correct
+    rpc: CorrectAction
+    description: 'Corrige uma ação que o agente executou: diga o que estava errado e o certo. Vira aprendizado e conta no disjuntor, que desce o nível da rotina se os erros passarem do limite.'
+    resourceTable: acao
+    readOnly: false
+    inputSchema:
+      type: object
+      properties:
+        action_id: { type: integer }
+        note: { type: string }
+      required: [action_id, note]
+
+  - name: agent_block
+    rpc: SetBlocked
+    description: 'Bloqueio de emergência: blocked=true para tudo o que o agente faz na hora, sem deploy (motivo obrigatório); blocked=false libera. Avisa o DRI e Segurança.'
+    resourceTable: controle
+    readOnly: false
+    inputSchema:
+      type: object
+      properties:
+        agent_id: { type: string }
+        blocked: { type: boolean }
+        reason: { type: string }
+      required: [agent_id, blocked]
+
+  - name: routine_cap
+    rpc: CapRoutine
+    description: 'Limita o nível de uma rotina do agente (shadow, copilot ou agent), com motivo. Com level vazio, tira o teto e volta a valer o nível do manifesto. Avisa o DRI e Segurança.'
+    resourceTable: controle
+    readOnly: false
+    inputSchema:
+      type: object
+      properties:
+        agent_id: { type: string }
+        routine: { type: string }
+        level: { type: string, enum: ['', shadow, copilot, agent] }
+        reason: { type: string }
+      required: [agent_id, routine, level]

package/dist/brain.d.ts

@@ -14,6 +14,7 @@
  */
 import { type McpServerConfig } from '@anthropic-ai/claude-agent-sdk';
 import type { LoadedAgent } from './manifest.js';
+import { type ModelAuth } from './model-auth.js';
 import type { PolicyGate } from './policy.js';
 import type { ResolvedSkills } from './plugins.js';
 import type { RuntimeTools } from './runtime-tools.js';
@@ -41,8 +42,15 @@ export interface Brain {
 }
 export declare class ClaudeBrain implements Brain {
     private readonly opts;
+    private readonly modelAuth;
+    /**
+     * `modelAuth`: de onde vem a credencial do modelo. Padrão: do ambiente
+     * (`modelAuthFromEnv`), o que cobre a federação pelo Keycloak na aplicação e pelo OIDC do
+     * GitHub nos evals da CI. `null`: deixa o Claude Code resolver sozinho.
+     */
     constructor(opts?: {
         debug?: boolean;
+        modelAuth?: ModelAuth | null;
     });
     run(task: BrainTask): Promise<BrainResult>;
 }

package/dist/brain.js

@@ -13,13 +13,21 @@
  * Os testes usam um Brain roteirizado que chama o mesmo portão, sem modelo.
  */
 import { query } from '@anthropic-ai/claude-agent-sdk';
+import { childEnv, modelAuthFromEnv } from './model-auth.js';
 function isErrorResponse(r) {
     return typeof r === 'object' && r !== null && r.isError === true;
 }
 export class ClaudeBrain {
     opts;
+    modelAuth;
+    /**
+     * `modelAuth`: de onde vem a credencial do modelo. Padrão: do ambiente
+     * (`modelAuthFromEnv`), o que cobre a federação pelo Keycloak na aplicação e pelo OIDC do
+     * GitHub nos evals da CI. `null`: deixa o Claude Code resolver sozinho.
+     */
     constructor(opts = {}) {
         this.opts = opts;
+        this.modelAuth = opts.modelAuth === undefined ? modelAuthFromEnv() : (opts.modelAuth ?? undefined);
     }
     async run(task) {
         const { gate } = task;
@@ -53,6 +61,8 @@ export class ClaudeBrain {
             return d.allow ? { behavior: 'allow', updatedInput: input } : { behavior: 'deny', message: d.message };
         };
         const m = task.agent.manifest;
+        // Token curto do modelo, trocado pelo runtime (federação); sem ele, o Claude Code resolve.
+        const auth = this.modelAuth ? await this.modelAuth.env(task.agent) : undefined;
         let text = '';
         let costUsd = 0;
         let turns = 0;
@@ -80,6 +90,7 @@ export class ClaudeBrain {
                 ...(task.budgetUsd ? { maxBudgetUsd: task.budgetUsd } : {}),
                 persistSession: false,
                 abortController,
+                ...(auth ? { env: childEnv(process.env, auth) } : {}),
                 ...(this.opts.debug ? { stderr: (s) => process.stderr.write(s) } : {}),
             },
         });

package/dist/brain.js.map

@@ -1 +1 @@
-{"version":3,"file":"brain.js","sourceRoot":"","sources":["../src/brain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,KAAK,EAAkE,MAAM,gCAAgC,CAAC;AA+BvH,SAAS,eAAe,CAAC,CAAU;IACjC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAK,CAA2B,CAAC,OAAO,KAAK,IAAI,CAAC;AAC9F,CAAC;AAED,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,OAA4B,EAAE;QAA9B,SAAI,GAAJ,IAAI,CAA0B;IAAG,CAAC;IAE/D,KAAK,CAAC,GAAG,CAAC,IAAe;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACtB,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAErF,MAAM,UAAU,GAAiB,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;YAC1D,IAAI,KAAK,CAAC,eAAe,KAAK,YAAY;gBAAE,OAAO,EAAE,CAAC;YACtD,MAAM,EAAE,GAAG,SAAS,IAAI,KAAK,CAAC,WAAW,CAAC;YAC1C,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAA4B,EAAE,EAAE,CAAC,CAAC;YACrG,OAAO;gBACL,kBAAkB,EAAE;oBAClB,aAAa,EAAE,YAAY;oBAC3B,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;oBAC9C,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,wBAAwB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC5D;aACF,CAAC;QACJ,CAAC,CAAC;QACF,MAAM,WAAW,GAAiB,KAAK,EAAE,KAAK,EAAE,EAAE;YAChD,IAAI,KAAK,CAAC,eAAe,KAAK,aAAa,EAAE,CAAC;gBAC5C,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;YAClG,CAAC;iBAAM,IAAI,KAAK,CAAC,eAAe,KAAK,oBAAoB,EAAE,CAAC;gBAC1D,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YACrE,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,mFAAmF;QACnF,MAAM,UAAU,GAAG,KAAK,EACtB,QAAgB,EAChB,KAA8B,EAC9B,CAAwB,EACG,EAAE;YAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;YACxF,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QACzG,CAAC,CAAC;QAEF,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC9B,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,KAAyB,CAAC;QAE9B,MAAM,CAAC,GAAG,KAAK,CAAC;YACd,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE;gBACP,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;gBACjD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAgB,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC1G,UAAU,EAAE,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE;gBACnE,eAAe,EAAE,IAAI;gBACrB,cAAc,EAAE,EAAE;gBAClB,cAAc,EAAE,SAAS;gBACzB,UAAU;gBACV,KAAK,EAAE;oBACL,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;oBACrC,WAAW,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;oBACvC,kBAAkB,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;iBAC/C;gBACD,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3D,cAAc,EAAE,KAAK;gBACrB,eAAe;gBACf,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/E;SACF,CAAC,CAAC;QAEH,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;YAC1B,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC1B,OAAO,GAAG,GAAG,CAAC,cAAc,CAAC;gBAC7B,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC;gBACtB,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;oBAAE,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC;;oBAC5C,KAAK,GAAG,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;YAChC,CAAC;QACH,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC/D,CAAC;CACF"}
+{"version":3,"file":"brain.js","sourceRoot":"","sources":["../src/brain.ts"],"names":[],"mappings":"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"}

package/dist/catalog.d.ts

@@ -0,0 +1,13 @@
+/** `agents_<círculo>`: o schema do catálogo não aceita hífen no subservice. */
+export declare const AGENTS_SLUG_PATTERN: RegExp;
+export declare function agentsCatalogPath(): string;
+export interface AgentsCatalogOptions {
+    /** Nome do círculo em minúsculas, com `_` no lugar de hífen: `financeiro`, `dados_bi`. */
+    circle: string;
+    /** Endpoint gRPC de produção do conector (`host:porta`). */
+    endpoint: string;
+    /** Endpoint para TARGET_ENV=local. Padrão: o mesmo de `endpoint`. */
+    localEndpoint?: string;
+}
+/** O catálogo de `agents_<círculo>` em YAML, pronto para o repositório de catálogos. */
+export declare function agentsCatalog(o: AgentsCatalogOptions): string;

package/dist/catalog.js

@@ -0,0 +1,39 @@
+/**
+ * Catálogo do conector `agents_<círculo>`: o base (`catalog/agents.catalog.yaml`) mora
+ * aqui, versionado junto do proto, para tool e RPC nunca se desencontrarem. O repositório
+ * de catálogos do gateway gera o de cada círculo com `t4h-agent catalog`, sem escrever à mão.
+ */
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { parse as parseYaml } from 'yaml';
+/** `agents_<círculo>`: o schema do catálogo não aceita hífen no subservice. */
+export const AGENTS_SLUG_PATTERN = /^agents_[a-z0-9_]+$/;
+/** Mesmo padrão de endpoint do schema do catálogo (`host:porta`). */
+const ENDPOINT_PATTERN = /^[a-zA-Z0-9.-]+:[0-9]{1,5}$/;
+/** O subservice tem no máximo 50 caracteres (schema do catálogo). */
+const MAX_SUBSERVICE = 50;
+export function agentsCatalogPath() {
+    return fileURLToPath(new URL('../catalog/agents.catalog.yaml', import.meta.url));
+}
+/** O catálogo de `agents_<círculo>` em YAML, pronto para o repositório de catálogos. */
+export function agentsCatalog(o) {
+    const slug = `agents_${o.circle}`;
+    if (!AGENTS_SLUG_PATTERN.test(slug) || slug.length > MAX_SUBSERVICE) {
+        throw new Error(`círculo "${o.circle}" inválido: use minúsculas, dígitos e _ (o slug ${slug} precisa casar ${AGENTS_SLUG_PATTERN} e ter até ${MAX_SUBSERVICE} caracteres)`);
+    }
+    const local = o.localEndpoint ?? o.endpoint;
+    for (const e of [o.endpoint, local]) {
+        if (!ENDPOINT_PATTERN.test(e))
+            throw new Error(`endpoint "${e}" inválido: use host:porta`);
+    }
+    const yaml = readFileSync(agentsCatalogPath(), 'utf8')
+        .replaceAll('{{circle}}', o.circle)
+        .replaceAll('{{local_endpoint}}', local)
+        .replaceAll('{{endpoint}}', o.endpoint);
+    // Falha aqui, e não no apply, se a substituição quebrar o YAML.
+    const parsed = parseYaml(yaml);
+    if (parsed.subservice !== slug)
+        throw new Error(`catálogo base gerou subservice "${parsed.subservice}", esperado ${slug}`);
+    return yaml;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAE1C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAEzD,qEAAqE;AACrE,MAAM,gBAAgB,GAAG,6BAA6B,CAAC;AAEvD,qEAAqE;AACrE,MAAM,cAAc,GAAG,EAAE,CAAC;AAE1B,MAAM,UAAU,iBAAiB;IAC/B,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,gCAAgC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACnF,CAAC;AAWD,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,CAAuB;IACnD,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,MAAM,mDAAmD,IAAI,kBAAkB,mBAAmB,cAAc,cAAc,cAAc,CAAC,CAAC;IAC9K,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,QAAQ,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,4BAA4B,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,IAAI,GAAG,YAAY,CAAC,iBAAiB,EAAE,EAAE,MAAM,CAAC;SACnD,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;SAClC,UAAU,CAAC,oBAAoB,EAAE,KAAK,CAAC;SACvC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC1C,gEAAgE;IAChE,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAA4B,CAAC;IAC1D,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,CAAC,UAAU,eAAe,IAAI,EAAE,CAAC,CAAC;IAC3H,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli.js

@@ -1,14 +1,16 @@
 /**
- * t4h-agent validate <pasta agents/>   valida todos os agent.yaml (schema + regras)
+ * t4h-agent validate [pasta agents/]                       valida todos os agent.yaml (schema + regras)
+ * t4h-agent catalog <círculo> --endpoint <host:porta>      imprime o catálogo de agents_<círculo>
+ *           [--local-endpoint <host:porta>]
  */
-import { loadAgents } from './manifest.js';
+import { parseArgs } from 'node:util';
+import { agentsCatalog } from './catalog.js';
 import { effectiveLevel } from './levels.js';
-const [cmd, dir = 'agents'] = process.argv.slice(2);
-if (cmd !== 'validate') {
-    console.error('uso: t4h-agent validate [pasta]');
-    process.exit(2);
-}
-try {
+import { loadAgents } from './manifest.js';
+const USAGE = `uso:
+  t4h-agent validate [pasta]
+  t4h-agent catalog <círculo> --endpoint <host:porta> [--local-endpoint <host:porta>]`;
+function validate(dir = 'agents') {
     const agents = loadAgents(dir);
     for (const a of agents) {
         const m = a.manifest;
@@ -20,6 +22,29 @@ try {
     }
     console.info(`\n${agents.length} agente(s) válido(s).`);
 }
+function catalog(args) {
+    const { values, positionals } = parseArgs({
+        args,
+        allowPositionals: true,
+        options: { endpoint: { type: 'string' }, 'local-endpoint': { type: 'string' } },
+    });
+    const [circle] = positionals;
+    if (!circle || !values.endpoint || positionals.length > 1)
+        throw new Error(USAGE);
+    // Só o YAML no stdout: dá para redirecionar direto para o catalog.yaml.
+    process.stdout.write(agentsCatalog({ circle, endpoint: values.endpoint, ...(values['local-endpoint'] ? { localEndpoint: values['local-endpoint'] } : {}) }));
+}
+const [cmd, ...rest] = process.argv.slice(2);
+try {
+    if (cmd === 'validate')
+        validate(rest[0]);
+    else if (cmd === 'catalog')
+        catalog(rest);
+    else {
+        console.error(USAGE);
+        process.exit(2);
+    }
+}
 catch (e) {
     console.error(e.message);
     process.exit(1);

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEpD,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;IACvB,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,CAAC;IACH,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QAChF,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnD,MAAM,GAAG,GAAG,cAAc,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACvE,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,MAAM,uBAAuB,CAAC,CAAC;AAC1D,CAAC;AAAC,OAAO,CAAC,EAAE,CAAC;IACX,OAAO,CAAC,KAAK,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/connector.d.ts

@@ -0,0 +1,13 @@
+import { type ProviderHandlers } from '@t4h/mcp-provider-sdk';
+import { type AgentHost } from './host.js';
+export declare const AGENTS_SERVICE_FQN = "t4h.agents.v1.AgentsService";
+/** O proto do conector, publicado com o pacote (o gateway o puxa por reflection). */
+export declare function agentsProtoPath(): string;
+export interface AgentsConnectorOptions {
+    /** Quantas ações `ExplainActions` devolve sem `limit` (padrão 20) e no máximo (100). */
+    historyLimit?: {
+        default: number;
+        max: number;
+    };
+}
+export declare function agentsConnectorHandlers(host: AgentHost, opts?: AgentsConnectorOptions): ProviderHandlers;