agent-package

Motor de agentes: API REST, gateway MCP, web e captura de tela. É o app a ser padronizado primeiro. O padrão dele vira molde para os outros backends da casa.

score de alinhamento

4001

porta da API

236

tools / MCP

24h

operação contínua

Papel na casa#

Motor de agentes: API REST, gateway MCP, web e captura de tela.

O QUE FAZ

Motor de agentes: API REST, gateway MCP, web e captura de tela.

É o app a ser padronizado primeiro. O padrão dele vira molde para os outros backends da casa.

ONDE RODA

backend, frontend, shot

API na porta 4001, banco Postgres · agentpack.

COMO ESTÁ

Referência

Tools: 236 tools em 17 toolsets. Stack: Fastify 5, Prisma, pino, zod, React.

Arquitetura e deploy#

Item	Valor
Containers	backend, frontend, shot
API	porta `4001`
Banco	Postgres · agentpack
Stack	Fastify 5, Prisma, pino, zod, React
Tools / MCP	236 tools em 17 toolsets

agent-package/ backend/ · API REST + Swagger + MCP frontend/ · SPA docs/ · contratos e ADRs

Contrato com o resto da casa#

A documentação de contrato de cada app vive dentro dele. Consulte o docs/ do app e o AGENTS.md da raiz para a visão completa da casa.

Documentação técnica#

Os documentos longos do app vivem em agent-package/docs/. O portal os serve por /app-docs/agent-package/ — antes desta rota eles existiam mas não eram alcançáveis daqui.

A pasta src/mcp/ por dentro — o gateway MCP: mapa dos 16 arquivos (3.399 linhas), o fluxo de um tools/call do mcp-server.ts ao selo do envelope, o envelope da TB-22, quem fala com quem, design contra dívida, e como se mexe ali. 7 seções · 616 linhas · conferido linha a linha em 2026-10-26
ADRs — 16 decisões registradas (o 0016 é o do envelope único e da versão por tool)
api-guidelines.md — como REST e MCP servem a mesma regra de negócio
architecture.md · data-model.md · glossary.md
backend/docs/mcp-server.md — está no git? não. Um dos 4 documentos que não estão versionados e que fazem docs:gen morrer com ENOENT em clone limpo.

A norma do padrão MCP

O documento que os outros cinco backends seguem é PADRAO-MCP.md, na raiz do repositório — norma interna, com checklist de 10 itens e a lista do que está em aberto (§8).

Nota

O código do app agent-package mora em spaceAI/agent-package/. Este portal documenta; ele não substitui o código.

Próximos passos#

Você viu o agent-package na visão da casa. A seguir, aprofunde no app que precisar.

📚 Todas as aplicações

Volte ao mapa dos apps.

Explore além:

A casa

Regra, costura e inventário completos.

agent-package

O núcleo e o padrão da casa.

motor

O motor dos agentes.