@agent-native/core 0.76.5 → 0.76.6

package/docs/content/locales/es-ES/template-dispatch.md

@@ -0,0 +1,220 @@
+---
+title: "Envío"
+description: "El envío es el plano de control del espacio de trabajo: bandeja de entrada central, orquestación entre aplicaciones, bóveda de secretos, integración Slack/Telegram y trabajos programados."
+---
+
+# Envío
+
+> **Consulte también:** para obtener una descripción general conceptual de lo que hace Dispatch y cuándo lo desea, consulte [Dispatch](/docs/dispatch). Esta página es la referencia específica de la plantilla.
+
+El envío es el **plano de control del espacio de trabajo**. Mientras que otras plantillas son aplicaciones de dominio (Mail, Calendar, Analytics, Brain), Dispatch es la aplicación que ejecuta _junto_ con ellas para coordinar todo: una bandeja de entrada central, una bóveda de secretos, trabajos programados, integración Slack/Telegram y un agente orquestador que delega el trabajo del dominio a la aplicación especializada adecuada a través de [A2A](/docs/a2a-protocol).
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Dispatch</h1><span class='wf-pill accent'>Overview</span><span class='wf-pill'>Inbox</span><span class='wf-pill'>Secrets</span><span class='wf-pill'>Approvals</span><div style='flex:1'></div><button>Schedules</button></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>What should we do next?</strong><div class='wf-box'>Ask Analytics for this week's signups and draft a Slack update.</div><button class='primary'>Delegate</button></div><div style='display:grid;grid-template-columns:repeat(3,1fr);gap:10px'><div class='wf-card'><strong>Mail</strong><br/><small>/mail</small></div><div class='wf-card'><strong>Calendar</strong><br/><small>/calendar</small></div><div class='wf-card'><strong>Analytics</strong><br/><small>/analytics</small></div><div class='wf-card'><strong>Slides</strong><br/><small>/slides</small></div><div class='wf-card'><strong>Forms</strong><br/><small>/forms</small></div><div class='wf-card'><strong>Create app</strong><br/><small>+</small></div></div><div class='wf-card' style='display:grid;grid-template-columns:repeat(3,1fr);gap:8px'><div class='wf-box'>Slack DM needs reply</div><div class='wf-box'>A2A task completed</div><div class='wf-box'>Approval required</div></div></div>"
+}
+```
+
+Si está ejecutando un [multi-app workspace](/docs/multi-app-workspace) con muchas aplicaciones, Dispatch es el pegamento.
+
+```an-diagram title="Orchestrate, don't specialize" summary="Messages from every channel land in one inbox; the orchestrator triages and delegates domain work to the right specialist app over A2A — secrets, resources, and approvals stay central."
+{
+  "html": "<div class=\"diagram-dispatch\"><div class=\"diagram-col\"><div class=\"diagram-node\">Slack · Telegram</div><div class=\"diagram-node\">Email</div><div class=\"diagram-node\">A2A requests</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><span class=\"diagram-pill accent\">Orchestrator</span><small class=\"diagram-muted\">central inbox · triage · route</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-node\">Mail agent</div><div class=\"diagram-node\">Analytics agent</div><div class=\"diagram-node\">Brain · Slides &hellip;</div></div></div><div class=\"diagram-shared\"><span class=\"diagram-pill\">Secrets vault</span><span class=\"diagram-pill\">Workspace resources</span><span class=\"diagram-pill warn\">Approvals</span><span class=\"diagram-pill\">Scheduled jobs</span></div>",
+  "css": ".diagram-dispatch{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-dispatch .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-dispatch .diagram-box{display:flex;flex-direction:column;gap:4px}.diagram-dispatch .diagram-arrow{font-size:20px;line-height:1}.diagram-shared{display:flex;gap:8px;flex-wrap:wrap;margin-top:12px}"
+}
+```
+
+## Qué hace {#what-it-does}
+
+- **Bandeja de entrada central.** DM de Slack, mensajes de Telegram, notificaciones por correo electrónico, solicitudes de A2A de otros agentes: todo llega a un solo lugar. El agente de despacho los clasifica y los maneja él mismo o los delega. Consulte [Messaging](/docs/messaging) para saber cómo conectar Slack, correo electrónico y Telegram a su espacio de trabajo.
+- **Orquestador, no especialista.** Dispatch _no_ intenta ser la aplicación de correo electrónico ni la aplicación de análisis. Cuando alguien pregunta "resume los registros de la semana pasada", Dispatch llama al agente de análisis a través de A2A y devuelve la respuesta. Cuando alguien pregunta "redactar una respuesta para Alice", Dispatch llama al agente de correo.
+- **Shell del plano de control.** Chats, proyectos, ejecuciones, aplicaciones de espacio de trabajo, agentes y automatizaciones viven en un shell operativo, con listas de estado primero y desgloses en lugar de paneles únicos.
+- **Bóveda de secretos.** Un almacén central para claves API, tokens OAuth y credenciales compartidas. Las aplicaciones en el espacio de trabajo resuelven secretos de Dispatch en lugar de duplicarlos en cada `.env`. Solicitudes + aprobaciones para acceso confidencial.
+- **Recursos del espacio de trabajo.** skills global, instrucciones de protección, perfiles de agente personalizados, recursos de referencia y servidores HTTP MCP se pueden crear una vez en Dispatch. Los recursos de todas las aplicaciones se heredan en tiempo de ejecución por cada aplicación sin copia ni paso de sincronización manual; Las concesiones seleccionadas son para excepciones específicas de aplicaciones.
+- **Integraciones reutilizables.** Un lugar para conectar cuentas de proveedores y realizar un seguimiento
+  referencias de credenciales y otorgar acceso a las aplicaciones. Dispatch posee la identidad del proveedor y
+  subvenciones para aplicaciones; las aplicaciones de dominio aún poseen opciones de fuentes específicas de la aplicación, como Brain's
+  Lista de canales permitidos Slack o configuración de métricas/panel de Analytics.
+- **Centro de trabajos programados.** [recurring jobs](/docs/recurring-jobs) de aplicaciones cruzadas disponible aquí: "todos los días laborables a las 7, extraiga las métricas clave de ayer de los análisis y redacte un correo electrónico de resumen por la mañana".
+- **Dreams.** Dispatch puede revisar ejecuciones recientes de agentes, fallas, comentarios y patrones exitosos para proponer mejoras en la memoria, las habilidades, el trabajo y las instrucciones antes de aplicar algo duradero.
+- **Flujo de aprobación.** actions destructivo o externo (enviar dinero, enviar un correo electrónico saliente, publicar en Slack a gran escala) puede requerir la aprobación de un administrador antes de activarse. El despacho es dueño de la cola.
+
+## Cuándo usarlo {#when-to-use}
+
+Utilice Envío cuando:
+
+- Tiene **dos o más** aplicaciones nativas del agente en un espacio de trabajo y desea un lugar para coordinarlas.
+- Necesitas **secretos centralizados** con subvenciones por aplicación y un seguimiento de auditoría.
+- Quieres un **centro de mensajería** que enrute Slack o Telegram al agente de dominio adecuado.
+- Quieres **trabajos programados** que extraigan datos de varias aplicaciones.
+
+Omítalo para una estructura de aplicación única: use [Chat template](/docs/template-chat) o cualquiera de las plantillas de dominio directamente.
+
+Demostración en vivo: [dispatch.agent-native.com](https://dispatch.agent-native.com).
+
+## Qué harás con él {#what-youll-do}
+
+Día a día, Dispatch es el lugar donde los administradores y el personal de operaciones abren para mantener el espacio de trabajo en funcionamiento:
+
+- **Conecte Slack, correo electrónico y Telegram** para que las personas puedan enviar mensajes a su agente desde dondequiera que ya trabajen. Consulte [Messaging](/docs/messaging) para conocer los pasos de cableado.
+- **Guarde los secretos compartidos una vez.** Las claves API, los tokens OAuth y las credenciales de servicio se encuentran en la bóveda y las otras aplicaciones en su espacio de trabajo se extraen de allí en lugar de que cada miembro del equipo haga malabarismos con su propio `.env`.
+- **Conecta proveedores una vez.** Las integraciones reutilizables almacenan metadatos seguros de la cuenta
+  y referencias de credenciales, luego otorga aplicaciones como Brain, Analytics, Mail o
+  Acceso de envío sin copiar secretos sin procesar. Fuente específica de la aplicación
+  la configuración permanece en la aplicación que utiliza el proveedor.
+- **Exponer un conector MCP.** Agregar
+  `https://dispatch.agent-native.com/_agent-native/mcp` en Claude, ChatGPT,
+  Codex, Cursor u otro host MCP, luego elija qué aplicaciones del espacio de trabajo
+  puede comunicarse desde la página **Agentes** de Dispatch. Utilice una aplicación directa URL
+  solo cuando ese host debe estar aislado en una aplicación.
+- **Administrar automatizaciones.** La vista Automatizaciones muestra el estado habilitado, la última ejecución,
+  siguiente ejecución y último error de los cronogramas `jobs/*.md` subyacentes, y vamos
+  activas o desactivas un trabajo sin editar archivos a mano.
+- **Mantenga el contexto de la empresa global.** Coloque personas, posicionamiento, mensajes, datos de la empresa, pautas de marca y barreras de seguridad en Recursos de envío una vez, luego obtenga una vista previa del espacio de trabajo efectivo -> aplicación/org -> pila personal para cualquier aplicación/usuario o inspeccione la pila desde la vista Contexto de una tarjeta de aplicación.
+- **Configurar trabajos recurrentes.** "Todos los lunes a las 7 a. m., pregúntele al agente de análisis los registros de la semana pasada y envíeme un resumen por correo electrónico". Ver [Recurring Jobs](/docs/recurring-jobs).
+- **Revisar las propuestas de los sueños.** Dispatch Dreams inspecciona las ejecuciones anteriores del agente y crea propuestas respaldadas por el código fuente sobre lo que debe recordar el espacio de trabajo, qué notas obsoletas deben limpiarse y qué lecciones repetidas deben convertirse en skills o trabajos.
+- **Apruebe el actions saliente antes de que se activen.** Enviar dinero, enviar correos electrónicos masivos a los clientes o publicar en un canal público Slack se puede controlar detrás de una autorización de administrador.
+- **Vea quién tiene acceso a qué.** Concesiones por aplicación, cola de solicitudes y un registro de auditoría de quién usó qué secreto y cuándo.
+- **Enrutar mensajes al especialista adecuado.** Un DM Slack sobre análisis se envía al agente de análisis; uno sobre el correo electrónico va al agente de correo: selecciones de envío.
+
+## Arquitectura de un vistazo {#architecture}
+
+_Cómo funciona internamente (para desarrolladores)._
+
+- **Agente orquestador.** El chat está configurado como un enrutador: lee `AGENTS.md`, `LEARNINGS.md` y enruta a subagentes especializados o agentes A2A remotos.
+- **Registro de agente remoto.** Los manifiestos del agente A2A son entradas de tiempo de ejecución del espacio de trabajo (no una carpeta de origen de plantilla registrada): en un espacio de trabajo de múltiples aplicaciones, las aplicaciones hermanas en `apps/` se descubren automáticamente como pares A2A, sin necesidad de registro manual. Dispatch los llama usando la acción `call-agent`.
+- **Esquema de Vault.** Tablas Drizzle para secretos, concesiones, solicitudes, aprobaciones y registros de auditoría. Estos se encuentran en el paquete `@agent-native/dispatch` (`packages/dispatch/src/db/schema.ts`) y se reexportan a la plantilla a través de `templates/dispatch/server/db/index.ts`; no hay ningún `server/db/schema.ts` local de plantilla. El tiempo de ejecución de Dispatch se envía en el paquete, no en la fuente de la plantilla (consistente con la nota a continuación de que `@agent-native/dispatch` posee el shell, la barra lateral y las páginas integradas).
+- **Slack / Complementos de Telegram.** Complementos de servidor que registran webhooks y reenvían mensajes entrantes al agente orquestador.
+- **Recursos del espacio de trabajo MCP.** Agregue definiciones de servidor HTTP MCP en `mcp-servers/*.json` en Recursos y luego alíselas a Todas las aplicaciones o concesiones de aplicaciones seleccionadas como skills y contexto.
+
+```an-schema title="Secrets vault schema" summary="Secrets are stored once; grants give a named app access; requests + reviews gate sensitive access; the audit log records who used which secret when. Defined in @agent-native/dispatch (packages/dispatch/src/db/schema.ts)."
+{
+  "entities": [
+    { "id": "secrets", "name": "vault_secrets", "note": "Stored credential values", "fields": [
+      { "name": "id", "type": "text", "pk": true },
+      { "name": "owner_email", "type": "text" },
+      { "name": "org_id", "type": "text", "nullable": true },
+      { "name": "name", "type": "text" },
+      { "name": "credential_key", "type": "text" },
+      { "name": "value", "type": "text", "note": "secret value" },
+      { "name": "provider", "type": "text", "nullable": true }
+    ] },
+    { "id": "grants", "name": "vault_grants", "note": "Per-app access grant", "fields": [
+      { "name": "id", "type": "text", "pk": true },
+      { "name": "secret_id", "type": "text", "fk": "vault_secrets.id" },
+      { "name": "app_id", "type": "text" },
+      { "name": "granted_by", "type": "text" },
+      { "name": "status", "type": "text" }
+    ] },
+    { "id": "requests", "name": "vault_requests", "note": "Access request + review", "fields": [
+      { "name": "id", "type": "text", "pk": true },
+      { "name": "credential_key", "type": "text" },
+      { "name": "app_id", "type": "text" },
+      { "name": "reason", "type": "text", "nullable": true },
+      { "name": "status", "type": "text" },
+      { "name": "reviewed_by", "type": "text", "nullable": true }
+    ] },
+    { "id": "audit", "name": "vault_audit_log", "note": "Who used which secret when", "fields": [
+      { "name": "id", "type": "text", "pk": true },
+      { "name": "secret_id", "type": "text", "fk": "vault_secrets.id", "nullable": true },
+      { "name": "app_id", "type": "text", "nullable": true },
+      { "name": "action", "type": "text" },
+      { "name": "actor", "type": "text" }
+    ] }
+  ],
+  "relations": [
+    { "from": "secrets", "to": "grants", "kind": "1-n", "label": "granted via" },
+    { "from": "secrets", "to": "audit", "kind": "1-n", "label": "use recorded by" }
+  ]
+}
+```
+
+- **Modo concentrador MCP.** Dispatch aún puede actuar como [MCP hub](/docs/mcp-clients#hub) del espacio de trabajo, por lo que todas las demás aplicaciones del espacio de trabajo extraen la misma lista de servidores MCP del ámbito de la organización. Por otra parte, el punto final `/_agent-native/mcp` de Dispatch es el conector MCP externo recomendado para Claude, ChatGPT y otros hosts que deberían llegar a múltiples aplicaciones de espacio de trabajo.
+
+## Sueños {#dreams}
+
+Los sueños son el ciclo de revisión de Dispatch para la memoria del agente. Un pase de ensueño examina las ejecuciones de agentes existentes, los datos de depuración de subprocesos, los comentarios, las evaluaciones y los fallos repetidos de las herramientas, y luego escribe un informe con los cambios propuestos. Las propuestas pueden apuntar a la memoria personal, `LEARNINGS.md` compartido, instrucciones del espacio de trabajo, skills del espacio de trabajo, conocimiento del espacio de trabajo, agentes del espacio de trabajo o trabajos recurrentes, pero los cambios compartidos y a nivel del espacio de trabajo siguen siendo revisables en lugar de aplicarse silenciosamente.
+
+Las propuestas de sueños se comparan con el índice de memoria personal, los archivos `memory/*.md` existentes y el `LEARNINGS.md` compartido antes de guardarlos. En el informe se omiten lecciones duplicadas, mientras que los recuerdos personales probablemente obsoletos se actualizan en el lugar en lugar de producir notas paralelas. Dentro de un informe, Dreams también deduplica evidencia repetida por hilo, tipo de señal y cita normalizada, elimina el contexto inyectado de la detección de corrección del usuario y resume filas de herramientas/evaluación sin procesar en viñetas legibles por humanos antes de que aparezcan en el texto de la propuesta. Cuando un pase encuentra señales pero intencionalmente no crea propuestas, el informe incluye notas de barrera que explican qué evidencia se suprimió.
+
+Cuando la política de aprobación de Envío está habilitada, la aplicación de una propuesta de sueño compartida o de todo el equipo crea una solicitud de aprobación pendiente en lugar de escribirla inmediatamente. La creación, actualización o eliminación de un recurso del espacio de trabajo de todas las aplicaciones también pone en cola una solicitud de aprobación. Las propuestas de memoria personal y las ediciones de recursos solo seleccionados aún se pueden aplicar directamente después de la revisión.
+
+Utiliza Dreams cuando quieras responder preguntas como "¿en qué siguieron equivocándose los agentes esta semana?", "¿qué debemos recordar?" o "¿qué lección repetida merece una habilidad?". La evidencia entrante Slack, correo electrónico, Telegram, WhatsApp y derivada de la web se trata como información no confiable, por lo que las propuestas de esas fuentes requieren revisión y procedencia antes de que afecten la memoria compartida. Las propuestas de instrucción en el espacio de trabajo requieren evidencia duradera que abarque al menos dos subprocesos o dos aplicaciones fuente; El ruido de solo evaluación, los problemas de configuración de la cuenta, los límites de cuota y las correcciones de redacción de UI de una sola aplicación quedan fuera de las instrucciones globales.
+
+### Límites de validación de entrada de sueños
+
+Debido a que la evidencia se recopila de fuentes externas que no son confiables (como transcripciones de chat, webhooks e integraciones de terceros), el procesador Dream aplica límites estrictos de validación de entrada para evitar inyecciones rápidas y ataques de tamaño de carga útil:
+
+- **Límites de tamaño de bytes:** las cargas útiles de subprocesos individuales tienen un límite de 10 KB de contenido de texto por mensaje, y los análisis de candidatos se truncan si superan los 100 KB en total para evitar el agotamiento del contexto.
+- **Desinfección:** Todas las entradas de texto se desinfectan para eliminar caracteres de control, cargas útiles binarias y rangos Unicode no imprimibles.
+- **Validación del esquema:** Los datos de depuración entrantes y el historial de subprocesos se analizan con esquemas estrictos Zod antes de compilarse en los mensajes LLM. Cualquier estructura candidata que no supere la validación del esquema se descarta inmediatamente del lote de procesamiento.
+- **Escapar:** Todos los fragmentos de texto proporcionados por el usuario se escapan dinámicamente cuando se formatean en las plantillas de mensajes para evitar inyecciones de mensajes (por ejemplo, intentar secuestrar el bucle Dream para escribir instrucciones arbitrarias).
+
+En Dispatch UI, abra **Dreams** para ejecutar una revisión manual, revisar los hilos candidatos, inspeccionar el informe y abrir la hoja de revisión de cada propuesta antes de aplicarla o rechazarla. Utilice **Configuración** para editar la programación cron recurrente, el alcance de la fuente, los límites de tiempo de espera/concurrencia, el límite de candidatos y el umbral mínimo de candidatos; use **Asegurar programación** después de guardar cuando desee que el trabajo recurrente `jobs/dispatch-dream.md` se materialice a partir de esa configuración. La hoja de revisión muestra el comportamiento de aprobación, el contenido objetivo actual, el contenido propuesto y la evidencia fuente. Los agentes utilizan el mismo flujo de trabajo a través de actions:
+
+- `list-dream-candidates` encuentra subprocesos recientes con señales fundamentadas, como correcciones explícitas del usuario, ejecuciones fallidas, errores de herramientas, comentarios, errores de evaluación y flujos de trabajo exitosos con puntos de control. Pase `sourceId: "all"` o `sourceIds` para escanear múltiples fuentes de depuración de subprocesos; `sourceTimeoutMs`, `sourceConcurrency`, `sourceStartStaggerMs`, `threadConcurrency` y `threadTimeoutMs` mantienen los escaneos de producción parciales y limitados, y la respuesta incluye el estado por fuente.
+- `create-dream-report` crea el informe y las propuestas pendientes. Los informes de múltiples fuentes incluyen una sección Estado de la fuente para que los escaneos parciales sean visibles durante la revisión. Las correcciones repetidas y los fallos recurrentes pueden convertirse en propuestas de recursos del espacio de trabajo como `workspace-instruction`; Los flujos de trabajo repetidos y exitosos con puntos de control pueden convertirse en propuestas `workspace-skill`.
+- `get-dream-settings` y `set-dream-settings` leen y actualizan la programación del sueño recurrente, el alcance de la fuente, los controles de tiempo de espera/concurrencia, el límite y el umbral mínimo del candidato.
+- `get-dream`, `preview-dream-proposal`, `apply-dream-proposal` y `reject-dream-proposal` manejan la revisión.
+- `ensure-dream-job` crea el trabajo soñado recurrente y seguro una vez que los informes manuales son útiles.
+
+El ejecutor de acción local de la plantilla de Dispatch también expone el Dispatch actions empaquetado, por lo que en desarrollo puede ejecutar el mismo flujo de trabajo desde `apps/dispatch`:
+
+```bash
+pnpm action get-dream-settings
+pnpm action set-dream-settings --enabled true --schedule "0 9 * * 1" --allSources true --limit 8
+pnpm action create-dream-report --allSources true --sourceTimeoutMs 30000 --limit 8
+```
+
+## Andamio {#scaffolding}
+
+```bash
+npx @agent-native/core@latest create my-platform
+# pick "Dispatch" in the multi-select picker, plus whichever domain apps you want
+```
+
+Si prefieres nombrar la plantilla directamente en lugar de utilizar el selector:
+
+```bash
+npx @agent-native/core@latest create my-platform --template dispatch
+# add more apps in the same workspace as you go
+```
+
+Dispatch generalmente se estructura en un espacio de trabajo junto con las aplicaciones que coordina. Para un espacio de trabajo, la autenticación, la base de datos y la marca compartidas de Dispatch se heredan del núcleo del espacio de trabajo; consulte [Multi-App Workspace](/docs/multi-app-workspace).
+
+No hay un envío `--standalone` significativo: un plano de control sin nada que coordinar es solo una bandeja de entrada vacía. Insértelo en un espacio de trabajo con al menos una aplicación de dominio para que tenga agentes a los que enrutar a través de A2A. (La bandera todavía funciona y produce una aplicación ejecutable, pero el orquestador no tiene especialistas en quienes delegar hasta que agregue aplicaciones hermanas).
+
+## Primera ejecución local {#first-local-run}
+
+Desde la raíz del espacio de trabajo:
+
+```bash
+pnpm install
+pnpm dev
+```
+
+Abra el Dispatch URL impreso por el servidor de desarrollo. El desarrollo local utiliza el mismo flujo de inicio de sesión de Better Auth que la producción. Cree una cuenta local con correo electrónico + contraseña; La verificación por correo electrónico se omite en el desarrollo y la contraseña se almacena solo en la base de datos de su aplicación local. No se admite ninguna omisión de autenticación en la estructura predeterminada, porque el agente, los recursos del espacio de trabajo, la bóveda y el modelo de uso compartido dependen de una sesión de usuario real.
+
+Puede hacer clic en Dispatch UI después de iniciar sesión. Para usar el compositor de chat o ejecutar tareas de agente, primero conecte un proveedor de LLM:
+
+1. Abre **Configuración**.
+2. En **LLM**, conecte Builder.io o agregue su propia clave de proveedor, como `ANTHROPIC_API_KEY`.
+3. Vuelve a **Descripción general** y prueba el compositor.
+
+## Personalizarlo {#customize}
+
+Dispatch es una plantilla completa como cualquier otra; consulte [Templates](/docs/cloneable-saas). Pídale al agente que "agregue una nueva integración para Datadog" o "enrute los mensajes directos de Slack desde el canal X al agente de análisis" y editará la configuración de enrutamiento, agregará el controlador de webhook y lo conectará.
+
+Para pantallas de administración específicas del espacio de trabajo, agregue páginas locales del enrutador React y
+regístrelos en `app/dispatch-extensions.tsx`. El espacio de trabajo generado es propietario
+solo la pestaña y ruta adicionales; `@agent-native/dispatch` sigue siendo dueño del caparazón,
+barra lateral, páginas integradas y futuras actualizaciones de paquetes.
+
+## ¿Qué sigue?
+
+- [**Messaging**](/docs/messaging): conecta Slack, correo electrónico y Telegram para que puedas hablar con tu agente desde cualquier lugar
+- [**Multi-App Workspace**](/docs/multi-app-workspace): ejecutar Dispatch junto con varias aplicaciones
+- [**A2A Protocol**](/docs/a2a-protocol): cómo Dispatch delega a agentes especializados
+- [**MCP Clients — Hub Mode**](/docs/mcp-clients#hub): compartir servidores MCP en todo el espacio de trabajo
+- [**Recurring Jobs**](/docs/recurring-jobs): ejecuciones de envío de tareas programadas

package/docs/content/locales/es-ES/template-forms.md

@@ -0,0 +1,178 @@
+---
+title: "Formularios"
+description: "Creador de formularios nativo del agente: cree, edite, publique y enrute envíos de formularios a través de lenguaje natural más un editor visual."
+---
+
+# Formularios
+
+Forms es un creador de formularios nativo del agente. Describe el formulario que deseas, refinelo en el editor y publica un formulario público que almacene los envíos en tu propia base de datos SQL.
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px;padding:14px 16px;border-bottom:1.4px solid var(--wf-line)'><strong>Beta signup</strong><span class='wf-pill accent'>published</span><div style='flex:1'></div><button>Share</button><button class='primary'>Unpublish</button></div><div style='display:flex;gap:8px;padding:12px 16px;border-bottom:1.4px solid var(--wf-line)'><span class='wf-pill accent'>Edit</span><span class='wf-pill'>Results 187</span><span class='wf-pill'>Settings</span><span class='wf-pill'>Integrations</span></div><div style='display:flex;flex-direction:column;gap:12px;padding:30px 78px;overflow:hidden'><h2 style='margin:0'>Beta signup</h2><p class='wf-muted' style='margin:0'>Reserve a spot in the upcoming private beta cohort.</p><div class='wf-card'><strong>Full name</strong><input value='Ada Lovelace'/></div><div class='wf-card'><strong>Work email</strong><input value='you@company.com'/></div><div class='wf-card'><strong>Your role</strong><input value='Select...'/></div><div class='wf-card'><strong>Team size</strong><input value='Select...'/></div></div></div>"
+}
+```
+
+Cuando abres la aplicación, ves tus formularios, el editor actual y una vista previa en vivo. El agente puede crear un formulario a partir de un mensaje, actualizar etiquetas y opciones de campo, cambiar la validación y conectar destinos de envío utilizando el mismo actions que utiliza el UI.
+
+```an-diagram title="Build, publish, collect" summary="The agent and the visual editor edit one SQL-backed form definition. The public fill page is unauthenticated, and submissions route server-side to your destinations."
+{
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">Agent prompt<br><small class=\"diagram-muted\">\"add an NPS question\"</small></div><div class=\"diagram-node\">Visual editor<br><small class=\"diagram-muted\">labels, validation, order</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">create-form · update-form</span><small class=\"diagram-muted\">fields JSON, settings JSON</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">forms table<br><small class=\"diagram-muted\">SQL via Drizzle</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">Public fill page<br><small class=\"diagram-muted\">unauthenticated</small></div><div class=\"diagram-box\">responses<br><small class=\"diagram-muted\">+ Slack / webhook / Sheets</small></div></div></div>",
+  "css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+## Qué puedes hacer con él
+
+- **Crea formularios de forma conversacional.** "Crea un formulario de contacto", "agrega una pregunta de puntuación NPS", "haz que el campo de correo electrónico sea obligatorio". El agente actualiza el esquema del formulario y las actualizaciones de vista previa desde el estado respaldado por SQL.
+- **Ajuste visualmente.** Edite etiquetas, marcadores de posición, estados requeridos, opciones y orden de campos desde el generador UI cuando desee un control directo.
+- **Utilice los tipos de campos enviados.** Los campos de texto, correo electrónico, número, texto largo, selección, selección múltiple, casilla de verificación, radio, fecha, calificación y escala se admiten desde el primer momento.
+- **Recopilar respuestas.** Cada envío se almacena en SQL con una vista detallada por respuesta y un panel para revisar las entradas.
+- **Enrutar envíos.** Envíe cargas útiles de envío a webhooks, Slack, Discord o Google Sheets mediante las integraciones integradas.
+- **Publicar formularios públicos.** Comparta un formulario público URL y muestre un mensaje de agradecimiento después de enviarlo.
+
+## Para empezar
+
+Demostración en vivo: [forms.agent-native.com](https://forms.agent-native.com).
+
+1. **Cree un formulario a partir de un mensaje.** Solicite el formulario que desee, incluido el
+   audiencia y qué debería suceder después del envío.
+2. **Refinar en el editor.** Ajustar etiquetas, validación, opciones y orden en
+   el constructor visual cuando la edición directa es más rápida.
+3. **Publica y comparte.** Utiliza el formulario público URL para los encuestados y luego mira
+   Los resultados llegan a la vista Respuestas.
+4. **Conectar destinos.** Dirigir nuevos envíos a Slack, Discord, Google
+   Hojas, webhooks o su propio punto de extensión.
+
+### Indicaciones útiles
+
+- "Cree un formulario de registro beta con función, tamaño del equipo y caso de uso prioritario".
+- "Agregue una pregunta NPS obligatoria y un seguimiento de texto libre."
+- "Publica cada nueva respuesta en el canal del producto Slack."
+- "Resuma los envíos de esta semana y agrúpelos por segmento de clientes."
+- "Acorta este formulario sin perder los campos que necesitamos para el enrutamiento."
+
+## Para desarrolladores
+
+El resto de este documento es para cualquiera que bifurque la plantilla de Formularios o la amplíe.
+
+### Inicio rápido
+
+```bash
+npx @agent-native/core@latest create my-forms --standalone --template forms
+cd my-forms
+pnpm install
+pnpm dev
+```
+
+Para un espacio de trabajo con Formularios junto con otras aplicaciones:
+
+```bash
+npx @agent-native/core@latest create my-platform
+```
+
+Elija formularios y cualquier otra plantilla que desee durante la configuración del espacio de trabajo.
+
+### Características clave {#key-features}
+
+**Definiciones de formulario JSON.** Los campos se encuentran en una columna `fields` JSON, por lo que el agente puede realizar ediciones quirúrgicas sin cambios de esquema para cada tipo de campo.
+
+**Páginas de relleno públicas.** Los encuestados pueden enviar formularios no autenticados, mientras que la configuración privada se elimina antes de que los datos lleguen al navegador.
+
+**Destinos del lado del servidor.** Las integraciones de Slack, Discord, Google Sheets y webhooks se encuentran en la configuración del formulario y se ejecutan después del envío.
+
+### Modelo de datos
+
+Todos los datos residen en SQL a través de Drizzle ORM. Esquema: `templates/forms/server/db/schema.ts`. Los formularios llevan el estándar `ownableColumns` y una tabla de recursos compartidos de marco coincidente, por lo que encajan en el modelo de uso compartido por usuario/por organización.
+
+| Tabla         | Qué contiene                                                                                                                                                                                                                         |
+| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `forms`       | Una definición de formulario: `title`, `description`, `slug` único, `fields` (matriz JSON de `FormField`), `settings` (JSON `FormSettings`), `status` (`draft` / `published` / `closed`), y una eliminación temporal de `deleted_at` |
+| `responses`   | Un envío por fila: `form_id`, `data` (JSON `{ fieldId: value }`), `submitted_at`, `ip` y `submitter_email` opcionales                                                                                                                |
+| `form_shares` | El marco comparte la tabla que asigna principales (usuarios u organizaciones) a roles (espectador, editor, administrador) por formulario                                                                                             |
+
+Las formas `fields` y `settings` JSON están definidas en `templates/forms/shared/types.ts` (`FormField`, `FormSettings`). Las configuraciones privadas del propietario, como el webhook de integración URL y los orígenes permitidos, se eliminan antes de que los datos lleguen a la página de llenado público a través de `toPublicFormSettings`.
+
+```an-schema title="Forms data model" summary="Three tables. Fields and integrations are JSON columns on forms, so the agent's edits are surgical patches rather than cross-table row changes."
+{
+  "entities": [
+    {
+      "id": "forms",
+      "name": "forms",
+      "note": "A form definition (ownable)",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "title", "type": "string" },
+        { "name": "description", "type": "string", "nullable": true },
+        { "name": "slug", "type": "string", "note": "unique; public URL" },
+        { "name": "fields", "type": "json", "note": "FormField[] — all field types" },
+        { "name": "settings", "type": "json", "note": "FormSettings — integrations, etc." },
+        { "name": "status", "type": "enum", "note": "draft | published | closed" },
+        { "name": "deleted_at", "type": "datetime", "nullable": true, "note": "soft delete" },
+        { "name": "owner_email", "type": "string" },
+        { "name": "org_id", "type": "id", "nullable": true }
+      ]
+    },
+    {
+      "id": "responses",
+      "name": "responses",
+      "note": "One submission per row",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "form_id", "type": "id", "fk": "forms.id" },
+        { "name": "data", "type": "json", "note": "{ fieldId: value }" },
+        { "name": "submitted_at", "type": "datetime" },
+        { "name": "ip", "type": "string", "nullable": true },
+        { "name": "submitter_email", "type": "string", "nullable": true }
+      ]
+    },
+    {
+      "id": "form_shares",
+      "name": "form_shares",
+      "note": "Framework shares table — principals to roles per form",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "form_id", "type": "id", "fk": "forms.id" },
+        { "name": "principal", "type": "string", "note": "user or org" },
+        { "name": "role", "type": "enum", "note": "viewer | editor | admin" }
+      ]
+    }
+  ],
+  "relations": [
+    { "from": "forms", "to": "responses", "kind": "1-n", "label": "has responses" },
+    { "from": "forms", "to": "form_shares", "kind": "1-n", "label": "has share grants" }
+  ]
+}
+```
+
+### Clave actions
+
+Cada operación es un archivo TypeScript en `templates/forms/actions/`, montado automáticamente en `POST /_agent-native/actions/:name`:
+
+- `create-form`: crea un nuevo formulario (título, descripción, campos, configuración)
+- `update-form`: actualizar campos, configuraciones o estado
+- `get-form`: recuperar un formulario por id o slug
+- `list-forms`: lista de formularios accesibles
+- `delete-form`: eliminación temporal (establece `deleted_at`)
+- `restore-form`: restaurar un formulario eliminado temporalmente
+- `list-responses`: enumerar envíos para un formulario con filtros opcionales
+- `export-responses`: exporta respuestas como CSV o JSON
+
+### Personalizarlo
+
+Pregunte primero al agente sobre el comportamiento del envío:
+
+- "Agregue un campo de radio obligatorio para el método de contacto preferido."
+- "Publique cada nuevo envío en Slack." Conecte Slack primero a través de [Messaging](/docs/messaging).
+- "Agregar un destino de webhook para nuestro CRM."
+- "Crea un formulario de comentarios de clientes con una escala del 1 al 10 y un seguimiento de texto largo".
+- "Haga que algunos formularios sean públicos y otros solo para iniciar sesión."
+
+Si necesita nuevas capacidades, como carga de archivos, firmas o widgets de campos personalizados, trátelos como extensiones de plantilla: agregue la forma SQL, los controles del editor actions, UI, la compatibilidad con el renderizador público y las instrucciones del agente. Consulte [Creating Templates](/docs/creating-templates) para conocer el patrón de compilación actual.
+
+## ¿Qué sigue?
+
+- [**Templates**](/docs/cloneable-saas): el modelo de clonar y poseer
+- [**Actions**](/docs/actions): el sistema de acción que impulsa al constructor
+- [**Messaging**](/docs/messaging) — Slack y otros destinos de envío