@agent-native/core 0.76.5 → 0.76.6

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

@@ -0,0 +1,146 @@
+---
+title: "Envío"
+description: "El plano de control del espacio de trabajo: bóveda de secretos, centro de integración, delegado entre aplicaciones y bandeja de entrada central para Slack, correo electrónico, Telegram y WhatsApp."
+---
+
+# Envío
+
+Dispatch es la aplicación central que se ubica frente a todas las demás aplicaciones en su espacio de trabajo y maneja secretos, integraciones, mensajería y delegación entre aplicaciones. Es el **plano de control del espacio de trabajo**: el único agente con el que habla su equipo, las credenciales del único lugar en vivo y el único enrutador que decide qué aplicación especializada debe manejar una solicitud determinada.
+
+> **Dispatch la plantilla frente a `@agent-native/dispatch` el paquete.** Esta página cubre el concepto de aplicación/plantilla Dispatch: qué hace y por qué lo desea. El paquete `@agent-native/dispatch` npm es el tiempo de ejecución publicado por separado que agrupa la lógica del servidor de la plantilla de Dispatch (bóveda, integraciones, destinos, trabajos programados y delegación entre aplicaciones) como un paquete directo para espacios de trabajo que lo amplían. Para conocer la aplicación estructurada (rutas, pantallas, guía del agente), consulte [Dispatch template](/docs/template-dispatch).
+
+Sin Dispatch, cada aplicación en un espacio de trabajo de múltiples aplicaciones termina reimplementando la misma plomería: su propio bot Slack, su propio almacén secreto, sus propios trabajos programados, su propia copia de las instrucciones del espacio de trabajo. Girar una tecla API se convierte en diez redespliegues. Agregar una nueva política se convierte en diez copiar y pegar. Dispatch centraliza todo eso en una aplicación para que los demás se mantengan concentrados en su dominio.
+
+```an-diagram title="Dispatch as the workspace control plane" summary="One inbox, one vault, one MCP gateway, and shared resources sit in front of the domain apps, which Dispatch reaches as A2A peers."
+{
+  "html": "<div class=\"dsp-hub\"><div class=\"diagram-node\">Users &amp; external agents<br><small class=\"diagram-muted\">Slack · email · Telegram · WhatsApp · MCP</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel dsp-control\" data-rough><span class=\"diagram-pill accent\">Dispatch &mdash; control plane</span><div class=\"dsp-caps\"><span class=\"diagram-pill\">Central inbox</span><span class=\"diagram-pill\">Secret vault</span><span class=\"diagram-pill\">Cross-app delegation</span><span class=\"diagram-pill\">MCP gateway</span><span class=\"diagram-pill\">Workspace resources</span></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"dsp-peers\"><div class=\"diagram-box\" data-rough>Mail</div><div class=\"diagram-box\" data-rough>Calendar</div><div class=\"diagram-box\" data-rough>Analytics</div></div><small class=\"diagram-muted\">domain apps &mdash; A2A peers</small></div>",
+  "css": ".dsp-hub{display:flex;flex-direction:column;align-items:center;gap:10px}.dsp-hub .dsp-control{display:flex;flex-direction:column;align-items:center;gap:10px;width:100%}.dsp-hub .dsp-caps{display:flex;gap:8px;flex-wrap:wrap;justify-content:center}.dsp-hub .dsp-peers{display:flex;gap:10px;flex-wrap:wrap;justify-content:center}"
+}
+```
+
+## Cuando quieras el envío {#when}
+
+Acceda a Dispatch cuando se cumpla alguna de estas condiciones:
+
+- Estás ejecutando un [multi-app workspace](/docs/multi-app-workspace) (correo, calendario, análisis, contenido) y no quieres un bot Slack por aplicación.
+- Quieres **una bandeja de entrada para "el agente"** para que los usuarios envíen mensajes de texto a un único bot y la aplicación especializada adecuada se encargue del trabajo entre bastidores.
+- Tienes **secretos para todo el espacio de trabajo** (clave Stripe, clave OpenAI, tokens API de terceros) que varias aplicaciones necesitan y quieres una bóveda en lugar de copiar valores en cada `.env`.
+- Desea un **flujo de aprobación en tiempo de ejecución** delante de los cambios confidenciales (destinos guardados, ediciones de políticas) para que los no administradores puedan solicitar y los administradores puedan cerrar sesión sin implementar el código.
+- Quiere **skills, instrucciones, perfiles de agente y servidores MCP compartidos** que las aplicaciones en el espacio de trabajo hereden: cambie una vez y llegue a todos.
+
+Si está ejecutando una única plantilla independiente, no necesita Dispatch: cada plantilla puede conectar sus propias integraciones de mensajería directamente. Consulte [Messaging](/docs/messaging) para conocer la configuración independiente.
+
+## Qué hace Dispatch {#what-it-does}
+
+Siete capacidades, todas ubicadas encima de la misma base de datos del espacio de trabajo que usan las otras aplicaciones:
+
+| Capacidad                           | Lo que te aporta                                                                                             | Configurarlo                                                  |
+| ----------------------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------- |
+| **Bandeja de entrada central**      | Slack, correo electrónico, Telegram y WhatsApp llegan a un solo agente con memoria compartida y herramientas | **Configuración → Mensajería** ([Messaging](/docs/messaging)) |
+| **Bóveda secreta**                  | Almacene cada credencial una vez; rotar en un solo lugar en cada aplicación                                  | **Vault** + modo de acceso (todas las aplicaciones o manual)  |
+| **Delegación entre aplicaciones**   | Envía una solicitud a la aplicación especializada adecuada a través de A2A y responde en el hilo             | Automático ([A2A](/docs/a2a-protocol))                        |
+| **Puerta de enlace MCP unificada**  | Un conector MCP para agentes externos llega a todas las aplicaciones del espacio de trabajo otorgado         | [External Agents](/docs/external-agents)                      |
+| **Recursos del espacio de trabajo** | Autor skills/instrucciones/perfiles una vez; las aplicaciones los heredan en tiempo de ejecución             | **Recursos** ([Workspace](/docs/workspace#global-resources))  |
+| **Sueños**                          | Revisa ejecuciones y comentarios anteriores y propone mejoras duraderas para que usted las apruebe           | Pestaña **Sueños**                                            |
+| **Flujo de aprobación**             | Cambios en el tiempo de ejecución sensibles de la puerta detrás de la revisión del administrador en línea    | **política de aprobación de envío**                           |
+
+Cada uno se detalla a continuación.
+
+### Bandeja de entrada central
+
+Slack, correo electrónico, Telegram y WhatsApp fluyen hacia el bucle de agentes de Dispatch. Conecte cada plataforma una vez en **Configuración → Mensajería** y cada canal llega al mismo agente con la misma memoria y herramientas. Un DM de Slack y un correo electrónico a `agent@yourcompany.com` terminan como dos superficies en un historial de conversación, no como dos bots desconectados. Consulte [Messaging](/docs/messaging) para obtener las credenciales y el webhook URL.
+
+### Bóveda secreta
+
+Almacenar las credenciales una vez en la bóveda de Dispatch. De forma predeterminada, el acceso a la bóveda es **todas las aplicaciones**: cada clave guardada está disponible para cada aplicación del espacio de trabajo y `sync-vault-to-app` envía la bóveda completa a la aplicación de destino. Los espacios de trabajo que necesitan una separación más estricta pueden cambiar la bóveda al modo **manual**, donde se requieren concesiones explícitas por aplicación antes de la sincronización. Los no administradores pueden **solicitar** un secreto para una aplicación; los administradores **aprueban**, que crea el secreto y, en flujos de trabajo manuales, la concesión. Cada lectura, concesión, sincronización y rotación se captura en un registro de auditoría. Esto es lo que hace que "rotar la tecla OpenAI" sea una operación con un solo clic en diez aplicaciones en lugar de diez PR.
+
+### Delegación entre aplicaciones
+
+Dispatch descubre automáticamente las otras aplicaciones en su espacio de trabajo como pares A2A: sin registro manual ni configuración por aplicación. Cuando un usuario pregunta "resumir los registros de la semana pasada" en Slack, Dispatch lo reconoce como una solicitud de análisis y llama a la aplicación de análisis a través de [A2A](/docs/a2a-protocol). Cuando preguntan "redactar una respuesta para Alice", se dirige a la aplicación de correo. Dispatch publica la respuesta final en el hilo de origen. La regla de comportamiento reside en las instrucciones del agente de despacho: el trabajo del dominio pertenece a la aplicación del dominio. Dispatch es el orquestador, no el especialista.
+
+### Puerta de enlace unificada MCP
+
+Dispatch puede ser el único conector MCP para agentes externos: agregue `https://dispatch.agent-native.com/_agent-native/mcp` una vez en Claude, ChatGPT, Codex o Cursor, y una autorización llega a cada aplicación de espacio de trabajo otorgada en lugar de un conector por aplicación. Consulte [External Agents](/docs/external-agents) para conocer el flujo de conexión completo, las concesiones de aplicaciones, OAuth y las vistas previas de la aplicación MCP en línea.
+
+```an-api
+{
+  "method": "POST",
+  "path": "/_agent-native/mcp",
+  "summary": "Unified MCP gateway endpoint",
+  "description": "The single MCP connector URL external agents add (e.g. `https://dispatch.agent-native.com/_agent-native/mcp`). One authorization here reaches every **granted** workspace app instead of wiring one connector per app. App grants, OAuth, and inline MCP App previews are covered in [External Agents](/docs/external-agents).",
+  "auth": "Standard remote MCP OAuth, handled by the framework. The granted-app set scopes which workspace apps the connector can reach.",
+  "responses": [
+    { "status": "200", "description": "MCP JSON-RPC response — tools, resources, and MCP App UI resources aggregated across granted workspace apps." }
+  ]
+}
+```
+
+### Recursos del espacio de trabajo
+
+Skills, las instrucciones de medida de seguridad, los perfiles de agentes y los recursos de referencia se pueden crear una vez en Dispatch y heredados por el resto del espacio de trabajo. Los recursos con alcance **Todas las aplicaciones** son globales: Dispatch los almacena una vez en el alcance del espacio de trabajo y cada agente de aplicación los lee en tiempo de ejecución. No se copian en cada aplicación y no existe un paso manual de sincronización del espacio de trabajo y los recursos. Los recursos compartidos de la aplicación y los recursos personales pueden anular o limitar los valores predeterminados del espacio de trabajo localmente.
+
+Consulte [Workspace — Global resources](/docs/workspace#global-resources) para conocer la tabla de rutas canónicas, el paquete de inicio y el modelo de anulación.
+
+Los recursos del servidor MCP utilizan JSON e intencionalmente son solo para HTTP. Almacenar tokens en
+Dispatch Vault, otorga o sincroniza esas claves con las aplicaciones de destino y haz referencia a ellas
+de encabezados con `${keys.NAME}` para que la credencial sin formato nunca viva en el
+cuerpo del recurso.
+
+La página **Recursos** resalta el paquete de inicio recomendado para que los administradores puedan ver rápidamente qué archivos existen, restaurar los archivos de inicio que faltan sin sobrescribir los existentes y editar su contenido. Expanda cualquier recurso para obtener una vista previa de su pila de tiempo de ejecución efectiva para una aplicación/usuario seleccionado. Cada tarjeta de aplicación también tiene una vista **Contexto** que muestra exactamente lo que recibe esa aplicación.
+
+### Sueños
+
+Dispatch Dreams revisa ejecuciones anteriores del agente, comentarios, evaluaciones y fallas repetidas para proponer mejoras duraderas. Un informe de sueño es una superficie de revisión, no una reescritura silenciosa: puede sugerir actualizaciones de memoria personal, limpieza de memoria obsoleta, ediciones compartidas de `LEARNINGS.md`, recursos de instrucciones/habilidades/conocimientos/agentes del espacio de trabajo o trabajos recurrentes, y cada propuesta enlaza con las ejecuciones que la justifican. Las instrucciones compartidas y los recursos de todo el equipo requieren revisión antes de aplicarse, especialmente cuando la evidencia proviene de Slack entrante, correo electrónico, Telegram, WhatsApp o contenido web.
+
+Antes de proponer una escritura, Dreams compara la evidencia con el índice de memoria personal, las notas `memory/*.md` existentes y el `LEARNINGS.md` compartido. Si ya se capturó una lección, el informe registra que se omitió; Si un recuerdo personal relacionado parece obsoleto, la propuesta se centra en esa nota existente en lugar de crear un duplicado.
+
+Empiece desde la pestaña **Sueños** en Dispatch. Primero ejecute una revisión manual, abra una hoja de revisión de propuesta para comparar el objetivo actual con el contenido propuesto y la evidencia fuente, luego aplique solo los cambios que desee conservar. Una vez que los informes sean útiles de manera constante, Dispatch puede crear el trabajo soñado recurrente que siga produciendo propuestas sin aplicar automáticamente cambios compartidos o a nivel de instrucción.
+
+### Flujo de aprobación
+
+Dispatch puede bloquear cambios confidenciales en el tiempo de ejecución tras la revisión del administrador. Hoy en día, esto cubre **destinos guardados** (los canales Slack y las direcciones de correo electrónico a las que el agente puede enviar proactivamente), **propuestas de ensueño** compartidas/en equipo, **recursos de espacio de trabajo** creados/actualizados/eliminados en todas las aplicaciones y la **política de aprobación de envío** en sí. Cuando la política está habilitada, el cambio se pone en cola y el agente muestra una vista previa de aprobación en línea directamente en el chat: los administradores aprueban o rechazan sin salir de la conversación.
+
+## Cómo fluye un mensaje Slack a través de Dispatch {#flow}
+
+Recorra un ejemplo de principio a fin. Un usuario envía un mensaje directo al bot: _"resumen los registros de la semana pasada."_
+
+1. **Slack → webhook.** Slack `POST` a `/_agent-native/integrations/slack/webhook` en la aplicación Dispatch. El controlador verifica la firma e **inserta una fila en `integration_pending_tasks`**, luego activa un `POST` autodirigido a su propio procesador y devuelve `200` inmediatamente para que Slack no vuelva a intentarlo.
+2. **Ejecución nueva del procesador.** El punto final del procesador se ejecuta en una ejecución de función completamente nueva con su propio tiempo de espera completo. Reclama atómicamente la tarea e inicia el ciclo del agente.
+3. **El agente de envío decide.** El agente lee el mensaje, reconoce los "registros" como una intención de análisis e invoca `call-agent` contra el [A2A endpoint](/docs/a2a-protocol) de la aplicación de análisis. El trabajo real de SQL se ejecuta allí.
+4. **Respuesta publicada en el hilo.** El agente de análisis devuelve un resultado. Dispatch lo formatea y lo publica nuevamente en el mismo hilo Slack en el que escribió el usuario, utilizando la identidad vinculada, si la hay (de modo que el agente actúa con los permisos del solicitante, no con los del propietario del espacio de trabajo).
+5. **Recuperación si algo falla.** Si el procesador falla en pleno funcionamiento (tiempo de espera de A2A, error del agente descendente, congelación de funciones), un trabajo de reintento barre las tareas atascadas cada 60 segundos y vuelve a encender el procesador. Hasta tres intentos antes de que la tarea se marque como `failed`.
+
+```an-diagram title="A Slack message through Dispatch" summary="Slack enqueues into SQL, a fresh execution drains it, the Dispatch agent delegates the domain work over A2A, and the reply lands back in the originating thread. A 60s retry job recovers anything that dies mid-flight."
+{
+  "html": "<div class=\"dsp-flow\"><div class=\"dsp-row\"><div class=\"diagram-node\">Slack DM<br><small class=\"diagram-muted\">\"summarize last week's signups\"</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><strong>/slack/webhook</strong><br><small class=\"diagram-muted\">verify + INSERT pending task</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">200</div></div><div class=\"dsp-row\"><div class=\"diagram-box\" data-rough><strong>fresh processor</strong><br><small class=\"diagram-muted\">claim task · start agent loop</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">Dispatch agent decides</span><small class=\"diagram-muted\">analytics intent &rarr; call-agent</small></div></div><div class=\"dsp-row\"><div class=\"diagram-box\" data-rough>Analytics app<br><small class=\"diagram-muted\">A2A peer · runs the SQL work</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">reply posted in thread</div></div><div class=\"diagram-panel dsp-retry\" data-rough><span class=\"diagram-pill warn\">recovery</span> <span class=\"diagram-muted\">if the processor crashes &mdash; A2A timeout, downstream error, freeze &mdash; the 60s retry job re-fires it (&le;3 attempts) so the Slack reply still arrives</span> <span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</span></div></div>",
+  "css": ".dsp-flow{display:flex;flex-direction:column;gap:12px}.dsp-flow .dsp-row{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.dsp-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}.dsp-flow .dsp-retry{display:flex;align-items:center;gap:8px;flex-wrap:wrap}"
+}
+```
+
+El mismo flujo se aplica al correo electrónico, Telegram y WhatsApp: solo cambia el adaptador.
+
+## Historia de confiabilidad {#reliability}
+
+Todo el proceso está diseñado para sobrevivir en todos los hosts sin servidor (Netlify, Vercel, Cloudflare Workers) sin depender de API de ejecución en segundo plano específicos de la plataforma.
+
+- **Webhook → cola SQL → procesador de nueva ejecución.** El bucle del agente nunca se ejecuta dentro del controlador del webhook. El único trabajo del controlador es verificar, poner en cola y devolver 200. Una nueva ejecución separada drena la cola, por lo que una ejecución lenta del agente nunca puede bloquear el webhook entrante ni hacer que la plataforma vuelva a intentarlo.
+- **A2A sondeo de continuación.** Cuando Dispatch delega en otra aplicación, sondea la tarea posterior con un tiempo de espera limitado. Si el agente de nivel inferior tarda demasiado o falla, Dispatch registra la continuación y el trabajo de reintento la retoma; la respuesta Slack del usuario aún llega.
+- **A2A entre aplicaciones con firma automática.** Los espacios de trabajo hospedados con varias aplicaciones generan automáticamente credenciales A2A por aplicación en el momento de la implementación, de modo que las aplicaciones en el mismo espacio de trabajo pueden llamarse entre sí sin que usted tenga que pegar un secreto JWT. La capa de descubrimiento de agentes de Dispatch lee esos créditos de la base de datos del espacio de trabajo para que las aplicaciones recién agregadas aparezcan automáticamente como pares a los que se puede llamar.
+
+## Configuración {#setup}
+
+Tres breves pasos:
+
+1. **Crea un espacio de trabajo que incluya Dispatch.** Ejecute `npx @agent-native/core@latest create my-company-platform` y elija `dispatch` junto con las plantillas de dominio que desee. Dispatch vive en `apps/dispatch` y el resto de las aplicaciones se encuentran a su lado. Ver [Multi-App Workspace](/docs/multi-app-workspace).
+2. **Conectar mensajes.** Abra **Configuración → Mensajes** en Dispatch y haga clic en conectar para Slack, correo electrónico, Telegram o WhatsApp. Los campos del formulario coinciden con las variables de entorno en el documento [Messaging](/docs/messaging); consulte allí lo que necesita cada plataforma.
+3. **Agregue otras aplicaciones.** Ejecute `npx @agent-native/core@latest add-app` desde la raíz del espacio de trabajo para cada aplicación de dominio. Aparecen automáticamente como pares A2A en `list-workspace-apps` de Dispatch: sin registro manual ni edición de tarjetas de agente. Dispatch comenzará a delegarles tan pronto como sus tarjetas de agente estén disponibles.
+
+Luego agregue credenciales a la bóveda y (opcionalmente) cree recursos del espacio de trabajo global en **Recursos**. Las claves de la bóveda aún se pueden sincronizar u otorgar según el modo de acceso; Los recursos del espacio de trabajo de todas las aplicaciones se heredan automáticamente. Si necesita aislamiento secreto por aplicación, cambie la configuración de acceso a la bóveda a manual antes de otorgar aplicaciones individuales.
+
+## Ver también {#see-also}
+
+- [Dispatch template](/docs/template-dispatch): la aplicación estructurada real, con su catálogo de acciones completo y guía para agentes
+- [Messaging](/docs/messaging) — conexión de Slack, correo electrónico, Telegram, WhatsApp
+- [A2A Protocol](/docs/a2a-protocol): cómo funciona la delegación entre aplicaciones en su interior
+- [Multi-App Workspace](/docs/multi-app-workspace): la forma de implementación para la que está diseñado Dispatch
+- [Workspace Governance](/docs/workspace-management): gobernanza de git/GitHub que se combina con la gobernanza del tiempo de ejecución de Dispatch

package/docs/content/locales/es-ES/drop-in-agent.md

@@ -0,0 +1,260 @@
+---
+title: "Agente sin cita previa"
+description: "Monte el espacio de trabajo y chat del agente en cualquier aplicación React con <AgentPanel>, <AgentSidebar> y sendToAgentChat()."
+---
+
+# Agente sin cita previa
+
+> **Página del desarrollador.** Esta página es para desarrolladores que integran el agente en una aplicación React. Para conocer la experiencia del usuario final al trabajar con el agente, consulte [Using Your Agent](/docs/using-your-agent).
+
+No es necesario crear un agente nativo desde cero. El chat del agente, la pestaña del espacio de trabajo, el terminal CLI, la entrada de voz y toda la infraestructura relacionada se envían como un puñado de componentes React que se pueden colocar en cualquier aplicación.
+
+> **Requisito previo:** el servidor debe ejecutar `agent-chat-plugin` (se monta automáticamente en cada plantilla). Si estás empezando desde cero, consulta [Server](/docs/server).
+>
+> ¿Necesita el mapa público API en lugar de un tutorial? Ver [Component API](/docs/components).
+
+## Los componentes de un vistazo {#components}
+
+| Componente            | Qué es                                                                                                      | Úselo cuando                                                                         |
+| --------------------- | ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
+| `<AgentSidebar>`      | Ajusta el diseño de tu aplicación raíz y agrega un panel lateral alternable que contiene el agente completo | Quieres que el agente esté disponible junto con tu aplicación en todas las pantallas |
+| `<AgentToggleButton>` | Abre/cierra `<AgentSidebar>` (ponlo en tu encabezado)                                                       | Emparejar con `<AgentSidebar>`                                                       |
+| `<AgentPanel>`        | El panel sin formato en sí: chat + CLI + pestañas del espacio de trabajo                                    | Quieres control total sobre el diseño o una página de agente dedicada                |
+| `<AgentChatSurface>`  | Un panel/superficie de chat de página precableado                                                           | Quieres chatear sin el envoltorio de la barra lateral                                |
+| `<AssistantChat>`     | Representador de chat de nivel inferior con enlaces de compositor/historial                                 | Necesitas Chrome personalizado en torno a la conversación estándar UI                |
+| `sendToAgentChat()`   | Enviar un mensaje al chat mediante programación                                                             | Un botón que entrega el trabajo al agente en lugar de ejecutarlo en línea            |
+| `useActionMutation()` | Envoltura de interfaz Typesafe alrededor de una acción                                                      | El UI necesita ejecutar la misma operación que ejecutaría una herramienta de agente  |
+
+Todos estos se exportan desde `@agent-native/core/client`.
+
+```an-diagram title="The mount model" summary="<AgentSidebar> wraps your existing layout. Your routes render in the main area; the agent panel mounts beside them. <AgentPanel> is the same panel without the wrapper."
+{
+  "html": "<div class=\"diagram-mount\"><div class=\"diagram-box sidebar\" data-rough><span class=\"diagram-pill accent\">&lt;AgentSidebar&gt;</span><div class=\"inner\"><div class=\"diagram-node main\">Your app<br><small class=\"diagram-muted\">children: header + &lt;Outlet/&gt;</small></div><div class=\"diagram-node panel\">Agent panel<br><small class=\"diagram-muted\">chat &middot; CLI &middot; workspace</small></div></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-card alt\"><span class=\"diagram-pill\">&lt;AgentPanel&gt;</span><small class=\"diagram-muted\">same panel, no wrapper &mdash; you own the layout</small></div></div>",
+  "css": ".diagram-mount{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-mount .sidebar{display:flex;flex-direction:column;gap:8px;padding:14px}.diagram-mount .inner{display:flex;gap:10px}.diagram-mount .main{flex:2}.diagram-mount .panel{flex:1}.diagram-mount .alt{display:flex;flex-direction:column;gap:6px;padding:14px}.diagram-mount .diagram-arrow{font-size:22px;line-height:1}"
+}
+```
+
+## El caso del 80%: `<AgentSidebar>` {#sidebar}
+
+La configuración más común es una barra lateral que se abre desde la derecha en cualquier pantalla.
+Ajuste su diseño raíz existente con `<AgentSidebar>`; lo que sea que pases por
+los niños permanecen en el área principal de la aplicación. El chat del agente es el panel lateral.
+
+```an-annotated-code title="Wrapping the root layout with <AgentSidebar>"
+{
+  "filename": "app/root.tsx",
+  "language": "tsx",
+  "code": "import { Outlet } from \"react-router\";\nimport { AgentSidebar, AgentToggleButton } from \"@agent-native/core/client\";\n\nexport default function Root() {\n  return (\n    <AgentSidebar\n      emptyStateText=\"How can I help?\"\n      suggestions={[\n        \"Summarize my inbox\",\n        \"Draft a reply to the latest email\",\n        \"Show me yesterday's signup numbers\",\n      ]}\n      dynamicSuggestions\n      defaultSidebarWidth={420}\n      position=\"right\"\n    >\n      <header>\n        <AgentToggleButton />\n      </header>\n\n      <main>\n        <Outlet />\n      </main>\n    </AgentSidebar>\n  );\n}",
+  "annotations": [
+    { "lines": "6", "label": "Wrapper", "note": "`<AgentSidebar>` wraps your whole layout. It adds the toggleable side panel; everything you pass as children stays in the main app area." },
+    { "lines": "8-12", "label": "Starter prompts", "note": "`suggestions` render as clickable chips on the empty chat." },
+    { "lines": "13", "label": "Context-aware chips", "note": "`dynamicSuggestions` merges screen-aware prompts (e.g. \"Summarize this selection\") with your static ones. On by default." },
+    { "lines": "18-20", "label": "Toggle button", "note": "Put `<AgentToggleButton />` anywhere in your header to open and close the panel." },
+    { "lines": "22-24", "label": "Your app", "note": "`<Outlet/>` (your routes) renders in the main area, untouched." }
+  ]
+}
+```
+
+Eso es todo. El usuario ahora tiene un agente alternable en cada página, con historial de chat, pestaña de espacio de trabajo, terminal CLI, entrada de voz y modo de pantalla completa. El estado persiste entre recargas a través de `localStorage`.
+
+### Accesorios
+
+- **`children`**: el diseño y las rutas normales de tu aplicación. Representado en el área principal; el panel del agente se monta junto a él en el escritorio y encima en el móvil/pantalla completa.
+- **`emptyStateText`**: saludo que se muestra cuando el chat no tiene mensajes. Valor predeterminado: `"How can I help you?"`.
+- **`suggestions`**: los mensajes de inicio se muestran como chips en los que se puede hacer clic cuando están vacíos.
+- **`dynamicSuggestions`**: chips de aviso contextuales fusionados con `suggestions`. Habilitado de forma predeterminada; pase `false` para mostrar solo sugerencias estáticas o `{ max, includeStatic, getSuggestions }` para personalizar.
+- **`defaultSidebarWidth`**: ancho de píxel inicial (solo montaje; cambio de tamaño por parte del usuario y anulación del valor guardado). Valor predeterminado: `380`.
+- **`position`** — `"left"` o `"right"`. Valor predeterminado: `"right"`.
+- **`defaultOpen`**: si la barra lateral comienza a abrirse (solo en escritorio). Valor predeterminado: `false`.
+
+## El otro 20%: `<AgentPanel>` {#panel}
+
+Cuando necesite control total sobre el diseño (una ruta `/chat` dedicada, un panel integrado en una columna lateral que administre o una ventana emergente), renderice `<AgentPanel>` directamente:
+
+```tsx
+// app/routes/agent.tsx
+import { AgentPanel } from "@agent-native/core/client";
+
+export default function AgentRoute() {
+  return (
+    <div className="h-screen">
+      <AgentPanel defaultMode="chat" className="h-full" />
+    </div>
+  );
+}
+```
+
+`<AgentPanel>` le ofrece pestañas sin formato (Chat/CLI/Espacio de trabajo) sin el envoltorio de la barra lateral, el botón contraer ni ninguna persistencia de estado. Ponlo donde quieras; tú manejas el diseño.
+
+### Accesorios seleccionados
+
+- **`defaultMode`** — `"chat"` o `"cli"`. Valor predeterminado: `"chat"`.
+- **`className`** — Clase CSS para el contenedor exterior.
+- **`onCollapse`**: si se proporciona, aparece un botón para contraer en el encabezado.
+- **`isFullscreen`** / **`onToggleFullscreen`**: conecte el estado de pantalla completa externo si desea una columna centrada estilo Claude.
+- **`storageKey`**: espacio de nombres para claves `localStorage`. Útil cuando renderizas varios paneles (diferentes instancias de aplicaciones o espacios de trabajo) en la misma página.
+
+Accesorios completos: `AgentPanelProps` en `@agent-native/core/client`.
+
+## Mensajes programáticos: `sendToAgentChat()` {#send}
+
+Un botón que entrega el trabajo al agente (en lugar de ejecutar una llamada `llm()` en línea, el antipatrón del [ladder](/docs/what-is-agent-native#the-ladder)):
+
+```tsx
+import { sendToAgentChat } from "@agent-native/core/client";
+
+<Button
+  onClick={() =>
+    sendToAgentChat({
+      message: "Generate a chart showing signups by source",
+      context: `Dashboard ID: ${dashboardId}, date range: last 30 days`,
+      submit: true,
+    })
+  }
+>
+  Generate chart
+</Button>;
+```
+
+### Opciones
+
+- **`message`**: el mensaje visible que se muestra en el chat.
+- **`context`**: contexto oculto agregado al mensaje (texto seleccionado, posición del cursor, ID de entidad actual: cualquier cosa que el agente debería saber pero que el usuario no debería ver dos veces).
+- **`submit`**: `true` se ejecutará automáticamente, `false` se precargará pero espere. Omita utilizar el valor predeterminado del proyecto.
+- **`newTab`**: crea un hilo de chat independiente para este mensaje.
+- **`background`** — con `newTab`, ejecute sin enfocar el nuevo hilo. La ejecución oculta se rastrea en `RunsTray`.
+- **`openSidebar`**: configurado en `false` para envíos en segundo plano/silenciosos. Predeterminado abre la barra lateral para que el usuario vea la respuesta.
+- **`type`**: `"content"` (predeterminado) mantiene el trabajo en el agente de aplicación integrado. `"code"` enruta al marco de edición de código (para cambios de código escritos por el agente, consulte [Frames](/docs/frames)).
+
+`sendToAgentChat` devuelve un `tabId` estable que puedes utilizar para realizar un seguimiento de la ejecución del chat.
+
+Para trabajo silencioso, empareje `newTab`, `background` y `openSidebar: false`:
+
+```ts
+sendToAgentChat({
+  message: "Summarize the selected thread and save the summary",
+  context: `Thread id: ${threadId}`,
+  submit: true,
+  newTab: true,
+  background: true,
+  openSidebar: false,
+});
+```
+
+Esto sigue siendo una ejecución completa del agente con herramientas, actions, estado del hilo y ejecución
+seguimiento. Simplemente no roba el foco del estado actual de la barra lateral del usuario.
+
+Cuando la misma ruta está integrada como una aplicación MCP, enviada
+Las llamadas `sendToAgentChat()` se reenvían al chat del anfitrión cuando sea compatible; ver
+[Client](/docs/client#sendtoagentchat) para el comportamiento del puente de la aplicación MCP.
+
+Si desea un estado de carga, utilice el gancho `useSendToAgentChat()`; devuelve tanto `send` como `isGenerating`:
+
+```ts
+import { useSendToAgentChat } from "@agent-native/core/client";
+
+const { send, isGenerating } = useSendToAgentChat();
+```
+
+## Cuando la barra lateral de acciones no es la adecuada {#custom-chat-ui}
+
+`<AgentSidebar>` y `<AgentPanel>` cubren la mayoría de las aplicaciones. Cuando necesitas ser dueño del
+diseño alrededor del agente, o desea impulsar la conversación con un agente
+construiste en otro lugar, despliega una capa, pero sigue dejando que el marco sea dueño del
+tiempo de ejecución, actions y estado respaldado por SQL:
+
+- **Sea propietario de Chrome en el tiempo de ejecución estándar.** Utilice `<AgentChatSurface>` para
+  una ruta de chat dedicada, o `<AssistantChat>` cuando quieras encabezados personalizados,
+  pestañas y estados vacíos alrededor de la conversación estándar. El mapa de capas completo:
+  cada componente, gancho, compositor y adaptador, con rutas de importación, vive en
+  [Component API](/docs/components#agent-chat-ui).
+- **Traiga su propio tiempo de ejecución de agente.** Si un agente que creó en otro lugar debería hacerlo
+  impulsa la conversación mientras Agent-Native mantiene el compositor, la transcripción y la herramienta
+  tarjetas, aprobaciones y widgets nativos, pase un `AgentChatRuntime` a
+  `<AssistantChat runtime={...} />`. Los conectores
+  (`createHttpAgentChatRuntime()` y OpenAI / Claude / Vercel AI / AG-UI
+  helpers) y el contrato del evento están documentados en
+  [Native Chat UI — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes).
+
+Cualquiera que sea la capa que elija, mantenga el estado de la aplicación respaldada por actions y SQL como contrato,
+y evite publicar directamente en `/_agent-native/agent-chat` desde el producto UI. Si un
+Falta el ayudante con nombre para una superficie personalizada real, agregue ese ayudante primero
+El código del cliente no aprende un segundo transporte ad hoc.
+
+## actions con seguridad tipográfica desde UI: `useActionMutation()` {#use-action-mutation}
+
+Cuando UI necesita ejecutar la misma operación que ejecutaría una herramienta de agente (rango 3 de [ladder](/docs/what-is-agent-native#rung-three)), use `useActionMutation`:
+
+```tsx
+import { useActionMutation } from "@agent-native/core/client";
+
+const { mutate, isPending } = useActionMutation("reply-to-email");
+
+<Button onClick={() => mutate({ emailId, body: "Thanks!" })}>
+  Send Reply
+</Button>;
+```
+
+Los argumentos de tipo seguro provienen del esquema zod en su `defineAction()`. Consulte [Actions](/docs/actions) para conocer el sistema de acción completo.
+
+```an-callout
+{
+  "tone": "decision",
+  "body": "**`useActionMutation` vs `sendToAgentChat`.** Run the operation directly with `useActionMutation` when the user clicked a deterministic button (\"Send reply\"). Hand it to `sendToAgentChat` when the work needs the agent's reasoning, tools, or multi-step planning. Never call an inline `llm()` from UI — that is rung 1 of the [ladder](/docs/what-is-agent-native#the-ladder)."
+}
+```
+
+## Selección + reconocimiento del cursor {#selection}
+
+El agente puede ver lo que el usuario ha seleccionado (texto, celdas, diapositivas, contactos) a través de las teclas `navigation` y `selection` en el estado de aplicación. El chat vacío también utiliza esas teclas para ofrecer sugerencias dinámicas como "Resumir esta selección" o "Mejorar esta diapositiva" cuando la pantalla actual las hace relevantes. Si desea que Cmd-I (o similar) envíe un rango seleccionado al chat como contexto, consulte [Context Awareness](/docs/context-awareness).
+
+## Poniéndolo todo junto {#putting-it-together}
+
+Una configuración típica sin cita previa:
+
+```tsx
+// app/root.tsx
+import {
+  AgentSidebar,
+  AgentToggleButton,
+  sendToAgentChat,
+} from "@agent-native/core/client";
+
+export default function Root() {
+  return (
+    <AgentSidebar suggestions={["Draft a reply", "Summarize selection"]}>
+      <Header>
+        <AgentToggleButton />
+      </Header>
+
+      <Main>
+        <YourRoutes />
+      </Main>
+    </AgentSidebar>
+  );
+}
+```
+
+```tsx
+// Anywhere else in the app
+<Button
+  onClick={() =>
+    sendToAgentChat({
+      message: "Summarize this thread",
+      context: `Thread id: ${threadId}`,
+      submit: true,
+    })
+  }
+>
+  Summarize
+</Button>
+```
+
+El usuario ve un botón de chat en el encabezado, puede abrirlo y hablar con el agente. Sus botones entregan el trabajo a ese mismo agente en lugar de ejecutar llamadas LLM únicas.
+
+## ¿Qué sigue?
+
+- [**Actions**](/docs/actions) — `defineAction()` y `useActionMutation()`
+- [**Context Awareness**](/docs/context-awareness) — selección, navegación, visualización de pantalla
+- [**Workspace**](/docs/workspace): qué contiene la pestaña Espacio de trabajo (skills, memoria, servidores MCP, trabajos programados)
+- [**Voice Input**](/docs/voice-input) — el micrófono en el compositor de chat

package/docs/content/locales/es-ES/durable-resume.md

@@ -0,0 +1,65 @@
+---
+title: "Currículum vitae duradero"
+description: "Cuando la ejecución de un agente alojado se interrumpe y se reanuda, las llamadas de herramientas de efectos secundarios completadas no se vuelven a ejecutar: un diario de llamadas de herramientas derivado del libro mayor duradero bloquea envíos, cargos y tickets duplicados."
+---
+
+# Currículum vitae duradero
+
+> **¿Para quién es?** cualquiera que quiera entender cómo se ejecuta el marco
+> evita efectos secundarios duplicados. Este es un comportamiento incorporado: existe
+> no hay nada que conectar.
+
+Las ejecuciones del agente alojado se interrumpen: una función sin servidor alcanza su tiempo de espera a mitad de camino, una puerta de enlace interrumpe la conexión a 45 segundos, un socket se cuelga y la plataforma se inicia en frío. El marco ya se recupera de estos guardando el prefijo de la conversación y volviendo a ejecutar la llamada LLM ("continuar desde donde lo dejó"). Pero la recuperación por sí sola tiene una ventaja: si el intento interrumpido **ya envió un correo electrónico o creó un ticket**, un currículum ingenuo podría hacerlo nuevamente.
+
+Un currículum duradero cierra esa brecha. Al reanudar, el marco sabe qué llamadas a herramientas de efectos secundarios ya se completaron y se niega a volver a ejecutarlas, en dos capas.
+
+```an-diagram title="Two layers block duplicate side effects on resume" summary="The journal reads the durable ledger and classifies prior calls; layer 1 tells the model, layer 2 hard-blocks a re-dispatched write that matches a completed entry."
+{
+  "html": "<div class=\"diagram-durable\"><div class=\"diagram-box\" data-rough>Run-event ledger<br><small class=\"diagram-muted\">tool_start / tool_done</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><strong>Tool-call journal</strong><small class=\"diagram-ok\">completed = start+done</small><small class=\"diagram-warn\">interrupted = start, no done</small></div><div class=\"diagram-col\"><div class=\"diagram-pill\">Layer 1 · prompt note &rarr; model</div><div class=\"diagram-pill accent\">Layer 2 · hard-block re-dispatched write</div></div></div>",
+  "css": ".diagram-durable{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-durable .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-durable .diagram-arrow{font-size:22px;line-height:1}.diagram-durable .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+## El diario de llamadas de herramientas {#journal}
+
+El diario es una **lectura pura del libro mayor duradero de eventos de ejecución**: no hay ningún nuevo enlace de grabación en la ruta activa. Clasifica las llamadas de herramientas ya registradas para el turno actual:
+
+- **Completado**: un `tool_start` con un `tool_done` coincidente. Se realizó la llamada, se produjo el efecto secundario y se registró el resultado. **No volver a ejecutar.**
+- **Interrumpido**: un `tool_start` con **ningún** `tool_done` coincidente. La llamada comenzó, su efecto secundario puede haber ocurrido o no, y la interrupción se comió el resultado. Resultado desconocido.
+
+La combinación refleja cómo se reconstruyen los giros duraderos en otros lugares: un `tool_done` se empareja con el `tool_start` más antiguo aún abierto para el mismo nombre de herramienta (FIFO por herramienta). Un evento `clear` (salida parcial descartada) restablece el recuento por turno para que los parciales abandonados no dejen llamadas abiertas fantasmas.
+
+## Capa 1: nota de diario a nivel de mensaje {#prompt-note}
+
+Cuando se reanuda una ejecución (tiempo de espera temporal, tiempo de espera de la puerta de enlace o cualquier error de transporte reanudable), el marco agrega una **nota de diario estructurado** al mensaje de reanudación, justo después del empujón "continuar desde donde lo dejó". La nota le dice al modelo, en texto plano:
+
+- qué herramienta llama **ya completado** (con resultados breves) para que los reutilice y **no** los vuelva a ejecutar, y
+- qué llamadas a herramientas fueron **interrumpidas con resultado desconocido** para verificar el estado antes de asumir el éxito o el fracaso.
+
+Cuando el diario está vacío (un turno sin actividad de herramienta o una continuación limpia), no se agrega nada adicional y el comportamiento del currículum es byte por byte igual que antes. La nota es de mejor esfuerzo: una lectura fallida del libro mayor nunca bloquea una recuperación que de otro modo sería exitosa.
+
+## Capa 2: bloque duro de capa de herramienta {#hard-block}
+
+La nota de aviso es de asesoramiento: un modelo con buen comportamiento la presta atención, pero un modelo no es una garantía. Entonces el bucle también lo aplica en la capa de herramientas.
+
+Antes de que el ciclo se ejecute en un fragmento reanudado, toma una instantánea del diario una vez (capturando solo fragmentos **anteriores** de este giro lógico). Cuando el modelo vuelve a enviar una herramienta de **escritura** cuyo nombre de herramienta **y entrada** coinciden con una entrada de diario completada, el bucle sufre un cortocircuito: devuelve el resultado registrado en el diario en lugar de ejecutar la acción, con una nota de que la llamada ya se completó en un intento anterior interrumpido y no se volvió a ejecutar para evitar un efecto secundario duplicado.
+
+Propiedades clave:
+
+- **Solo herramientas de escritura.** Los actions de solo lectura (`readOnly` / GET) nunca se bloquean; la relectura es segura e idempotente.
+- **Contenido dirigido.** La coincidencia se realiza en el nombre de la herramienta + firma ingresada, por lo que una llamada reanudada que se encuentra en una posición diferente en el turno aún coincide; una llamada _diferente_ (argumentos diferentes) se trata como nueva y se ejecuta normalmente.
+- **Consume una vez.** Cada entrada completada se reclama cuando coincide, por lo que dos llamadas nuevas idénticas genuinamente distintas en el mismo turno no provocan un cortocircuito en una finalización registrada.
+- **Nuevas llamadas intactas.** Una llamada de primer turno ve un diario vacío; nada cambia para ejecuciones normales.
+
+```an-callout
+{
+  "tone": "success",
+  "body": "Together the two layers mean an interrupted run that already had a real side effect resumes **without repeating it** — no duplicate emails, charges, or tickets — while genuinely new work still runs. Read-only actions are never blocked; re-reading is always safe."
+}
+```
+
+## Relacionado
+
+- [**Real-Time Sync**](/docs/real-time-collaboration): cómo el libro de contabilidad de ejecución duradera se transmite al cliente y se reproduce al volver a conectarse.
+- [**Actions**](/docs/actions): `readOnly` marca la lectura como segura para volver a ejecutarla; todo lo demás se considera un efecto secundario.
+- [**In-Loop Processors**](/docs/processors) — otra costura de endurecimiento interna en bucle.