Visión general
Actualizado al 24-oct-2026 (main
f41235c7).
Agent Squad es un monorepo TypeScript sobre Bun con tres piezas principales y un substrato de ejecución detrás.
Piezas del repositorio
Sección titulada «Piezas del repositorio»| Workspace | Rol | Stack |
|---|---|---|
apps/api |
API del substrato: rutas HTTP, discovery de Nova, compose, motor de ejecución, FORGE, voz | Hono sobre Bun |
apps/web |
Experiencia del usuario: onboarding, propuesta de squad, oficina 3D, Acuerdo de Operación, informe | SvelteKit 2 con Svelte 5, Threlte (three.js), desplegada en Vercel |
packages/substrate-spec |
Catálogo de operaciones versionado, plantillas, evaluadores y contratos | TypeScript puro con Zod |
Alrededor hay infraestructura y herramientas: db/substrate (migraciones 0001 a 0020), infra (unidad del compute worker y política del gateway de herramientas), substrate-infra (scripts de despliegue y drop-ins de systemd), tools (servidor MCP del catálogo y recorrido de Playwright) y este sitio, docs-site.
Tamaño al 24-oct-2026: 53 módulos de rutas HTTP en la API (112 handlers), 31 páginas y 71 endpoints en la web, 126 migraciones, 85 tablas en la base de producción, 75 operaciones en el catálogo y 27 plantillas de trabajo. Las cifras salen de contar archivos y registros, no de un grafo de código.
Planos del substrato
Sección titulada «Planos del substrato»El diseño separa el plano de control soberano de la plomería alquilada:
- Plano de control (nuestro): el catálogo de operaciones versionado, la credencial Bearer de la API, el token de delegación que ata cada pedido a un usuario y un workspace, el aislamiento por workspace con RLS en Postgres y el discovery de Nova. El Tool Broker (permisos firmados y política que niega por defecto) está construido, pero apagado en producción.
- Plano de ejecución durable: un motor propio. El plan se compila a un grafo; cada corrida tiene un log de eventos y una cola de trabajo en Postgres, y un worker toma los nodos listos. Inngest ya no es la máquina de estados: da la entrada durable de los pedidos y los relojes que hacen avanzar la cola.
- Plano generativo: FORGE genera y ejecuta código del modelo en un sandbox, gobernado por una lista de capacidades forjables. Está activo en producción.
Rutas principales de la API
Sección titulada «Rutas principales de la API»Son los puntos de entrada reales del substrato (se montan en apps/api/src/index.ts):
/api/discovery/chaty/api/discovery/charter: el discovery conversacional de Nova y el Acuerdo de Operación./api/workspaces/:id/chaty/api/workspaces/:id/compose: interacción y composición de trabajo por workspace. En producción el compose es asíncrono: responde202con untask_idy la web consulta el estado./api/intents: declara un intent y dispara la corrida./api/forge/*: superficie de FORGE./api/approvalsy/api/approvals/*: los puntos de decisión humana./api/slo: señales de salud y objetivos de servicio./api/voice/*: relay de voz y puente de voz a compose./api/me/*,/api/tenants/*: el home workspace de cada usuario./api/demo/*: rutas públicas de la demo de tres actos. Hoy no tienen quien las use: el dominio de la demo (demo.digitalhubassist.ai) no resuelve en DNS./oauth/youtube/*: integración de publicación.
El flujo de una necesidad
Sección titulada «El flujo de una necesidad»- El usuario describe su necesidad en lenguaje natural, por texto o por voz.
- Nova interpreta y propone un equipo de dos o tres agentes, y ajusta la propuesta hasta que el usuario confirma. No hay elección manual de un catálogo: Nova propone.
- En el Acuerdo de Operación, Nova explica cómo trabaja el squad: el alcance de cada agente, dónde se espera una decisión del humano y dónde empieza la responsabilidad de cada uno.
- Cada pedido de trabajo recibe uno de siete desenlaces: conversar, pedir una aprobación, reusar un workflow curado (hay diez), reusar un SuperSkill propio, armar un plan a medida, no poder (con la rama de FORGE) o un fallo de armado.
- El trabajo se traduce en operaciones del catálogo. El plan se compila a un grafo y arranca una corrida del motor v2, con reintentos (hasta tres intentos por nodo) y todo su estado en Postgres.
- Los approvals marcan los puntos donde el humano decide antes de que el substrato avance. Si nadie decide en 72 horas, el gate falla; nunca se aprueba solo.
Seguí con El substrato soberano para el detalle de cada plano.