Ir al contenido

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.

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.

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.

Son los puntos de entrada reales del substrato (se montan en apps/api/src/index.ts):

  • /api/discovery/chat y /api/discovery/charter: el discovery conversacional de Nova y el Acuerdo de Operación.
  • /api/workspaces/:id/chat y /api/workspaces/:id/compose: interacción y composición de trabajo por workspace. En producción el compose es asíncrono: responde 202 con un task_id y la web consulta el estado.
  • /api/intents: declara un intent y dispara la corrida.
  • /api/forge/*: superficie de FORGE.
  • /api/approvals y /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.
  1. El usuario describe su necesidad en lenguaje natural, por texto o por voz.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.