@agent-native/core 0.93.0 → 0.94.1

package/docs/content/locales/es-ES/template-design.mdx

@@ -11,7 +11,7 @@ Design es un estudio de creación de prototipos HTML nativo del agente. En lugar
   <Screen
     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'>Página de lanzamiento del producto</h1><span class='wf-pill accent'>Desktop</span><span class='wf-pill'>Tablet</span><span class='wf-pill'>Mobile</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Export code</button></div><div class='wf-card' style='flex:1;display:grid;grid-template-rows:auto 1fr auto;gap:12px'><div style='display:flex;gap:8px'><span class='wf-pill accent'>Hero</span><span class='wf-pill'>Pricing</span><span class='wf-pill'>FAQ</span></div><div class='wf-box' style='display:flex;align-items:center;justify-content:center;min-height:230px'><strong>Prototipo HTML generado</strong></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span class='wf-muted'>Haz el hero más denso y el CTA más claro.</span><div style='flex:1'></div><button class='primary'>Aplicar revisión</button></div></div></div>"
+      "<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'>Página de lanzamiento del producto</h1><span class='wf-pill accent'>Desktop</span><span class='wf-pill'>Tablet</span><span class='wf-pill'>Mobile</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Export code</button></div><div class='wf-card' style='flex:1;display:grid;grid-template-rows:auto 1fr auto;gap:12px'><div style='display:flex;gap:8px'><span class='wf-pill accent'>Hero</span><span class='wf-pill'>Pricing</span><span class='wf-pill'>FAQ</span></div><div class='wf-box' style='display:flex;flex-direction:column;gap:12px;min-height:230px;padding:20px'><div style='display:flex;flex-direction:column;align-items:center;gap:8px;text-align:center'><strong style='font-size:22px'>Lanza más rápido con Agent-Native</strong><span class='wf-muted' style='max-width:70%'>Genera un prototipo funcional a partir de un prompt y después refínalo en el mismo lugar.</span><button class='primary'>Empezar</button></div><div style='display:grid;grid-template-columns:repeat(3,1fr);gap:10px;flex:1'><div class='wf-card' style='min-height:56px'></div><div class='wf-card' style='min-height:56px'></div><div class='wf-card' style='min-height:56px'></div></div></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span class='wf-muted'>Haz el hero más denso y el CTA más claro.</span><div style='flex:1'></div><button class='primary'>Aplicar revisión</button></div></div></div>"
     }
   />
 </WireframeBlock>
@@ -134,6 +134,8 @@ pnpm dev
 
 Todos los datos residen en SQL a través de Drizzle ORM. Esquema: `templates/design/server/db/schema.ts`. Los diseños y los sistemas de diseño llevan el estándar `ownableColumns` y una tabla de recursos compartidos de marco correspondiente, por lo que encajan en el modelo de uso compartido por usuario/por organización.
 
+La tabla siguiente cubre los recursos propios principales: diseños, archivos, plantillas, versiones y sistemas de diseño. Otras siete tablas del mismo esquema respaldan funciones descritas en otras partes de este documento, en lugar del modelo de recursos principal: `design_localhost_connections` y `design_localhost_write_grants` (modo de origen localhost), `component_index` (indexación de componentes), `motion_timeline` (movimiento), `design_state` (instantáneas del estado del editor), `design_fusion_edits` (modo de fusión de aplicaciones completas) y `design_review_snapshot` (instantáneas de revisión).
+
 | Tabla                                    | Qué contiene                                                                                                                                       |
 | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `designs`                                | Un proyecto de diseño: `title`, `description`, `project_type` (`prototype` / `other`), el blob `data` JSON y un enlace `design_system_id` opcional |

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

@@ -5,7 +5,11 @@ description: "El envío es el plano de control del espacio de trabajo: bandeja d
 
 # 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.
+<Callout tone="info">
+
+**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.
+
+</Callout>
 
 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).
 

package/docs/content/locales/es-ES/template-mail.mdx

@@ -362,3 +362,11 @@ El correo es tuyo para cambiarlo. Todo lo importante se encuentra en unos cuanto
 **Cambio de métodos abreviados de teclado.** Los controladores de combinaciones de teclas se encuentran en `templates/mail/app/components/email/`: busque `useHotkeys` o `addEventListener("keydown"` para encontrar dónde está cableada cada tecla.
 
 Pídale al agente que realice cualquiera de estos cambios por usted. El agente puede editar su propia fuente; consulte [Self-Modifying Code](/docs/key-concepts#agent-modifies-code).
+
+## Qué sigue
+
+- [**Plantillas**](/docs/cloneable-saas) — el modelo de clonar y poseer, y cualquier otra plantilla de dominio desde la que empezar
+- [**Primeros pasos**](/docs/getting-started) — los fundamentos del marco: acciones, estado de la aplicación y sincronización en directo
+- [**Calendario**](/docs/template-calendar) — una plantilla de dominio relacionada que cubre programación y reservas
+- [**Automatizaciones**](/docs/automations) — el motor basado en eventos sobre el que se construyen las reglas de clasificación automática de Mail
+- [**Acciones**](/docs/actions) — el sistema de acciones que invocan el chat, los atajos y las automatizaciones

package/docs/content/locales/es-ES/tracking.mdx

@@ -127,6 +127,8 @@ import { defineAction } from "@agent-native/core/action";
 import { track } from "@agent-native/core/tracking";
 import { z } from "zod";
 
+import { getDb, schema } from "../server/db/index.js";
+
 export default defineAction({
   description: "Create a new project.",
   schema: z.object({
@@ -134,14 +136,15 @@ export default defineAction({
     template: z.string().optional(),
   }),
   run: async ({ name, template }, ctx) => {
-    const project = await db
-      .insert(projects)
+    const db = getDb();
+    const [project] = await db
+      .insert(schema.projects)
       .values({ name, template })
       .returning();
 
-    track("project.created", { name, template }, { userId: ctx.userEmail });
+    track("project.created", { name, template }, { userId: ctx?.userEmail });
 
-    return { ok: true, projectId: project[0].id };
+    return { ok: true, projectId: project.id };
   },
 });
 ```
@@ -349,5 +352,5 @@ El marco también rastrea `builder connect clicked` desde los CTA de Connect Bui
 ## ¿Qué sigue?
 
 - [**Actions**](/docs/actions): donde se originan la mayoría de las llamadas de seguimiento
-- [**Server Plugins**](/docs/server) — `registerBuiltinProviders()` se ejecuta en el complemento core-routes al inicio
-- [**Secrets**](/docs/security): administra claves API para proveedores de seguimiento
+- [**Server Plugins**](/docs/server#server-plugins) — `registerBuiltinProviders()` se ejecuta en el complemento core-routes al inicio
+- [**Seguridad — Gestión de secretos**](/docs/security#secrets): administra claves API para proveedores de seguimiento

package/docs/content/locales/es-ES/using-your-agent.mdx

@@ -92,21 +92,14 @@ La mayoría de las veces diriges al agente escribiendo en el chat. Hay dos cosas
 
 El agente no es una aplicación independiente a la que puedes acceder. Se envía como un puñado de componentes React (una barra lateral, un panel sin formato y una llamada `sendToAgentChat()`) que se pueden colocar en cualquier aplicación. Renderice `<AgentSidebar>` para darle a cada pantalla un agente alternable, o conecte un botón para transferir una tarea específica al chat en lugar de ejecutar una llamada única a LLM.
 
-→ [**Drop-in Agent**](/docs/drop-in-agent): monta `<AgentPanel>`, `<AgentSidebar>` y `sendToAgentChat()` en cualquier aplicación React.
-→ [**Agent Surfaces**](/docs/agent-surfaces): elija si el flujo de trabajo debe ser headless, chat primero, integrado o una aplicación completa.
-
 ## Puedes ir a UI ligera {#ui-light}
 
 No todas las aplicaciones necesitan un panel completo. Cuando el agente _es_ el producto, puede omitir la mayor parte del UI personalizado: abra la aplicación, solicite lo que desee y deje que el agente haga el resto. El agente todavía tiene su superficie de administración (historial, espacio de trabajo, configuración), pero la interacción principal es la conversación en lugar de los clics.
 
-→ [**Automation-First Apps**](/docs/pure-agent-apps): apps sin navegador para jobs, colas, scripts y agents externos.
-
 ## Coeditas con él {#you-co-edit}
 
 Cuando usted y el agente trabajan en el mismo documento, no se turnan. Con la colaboración en tiempo real, las ediciones del agente se transmiten junto con las suyas (cursores en vivo, sin sobrescrituras) de la misma manera que lo haría un compañero de equipo. Puedes seguir escribiendo mientras funciona y ve los cambios a medida que ocurren.
 
-→ [**Real-Time Collaboration**](/docs/real-time-collaboration): edición colaborativa multiusuario con cursores en vivo y ediciones de agentes en el mismo documento.
-
 ## ¿Qué sigue? {#whats-next}
 
 - [**Context Awareness**](/docs/context-awareness): el agente sabe lo que estás mirando

package/docs/content/locales/es-ES/voice-input.mdx

@@ -9,6 +9,12 @@ Cada aplicación nativa del agente tiene un micrófono en el compositor de chat.
 
 El marco maneja todo esto automáticamente. Los usuarios conectados a Builder obtienen Gemini Flash-Lite alojado en Builder de forma predeterminada; de lo contrario, los usuarios pueden traer su propia clave de proveedor o recurrir al reconocimiento de voz del navegador.
 
+## Modo de voz en tiempo real {#realtime-speech-mode}
+
+Al abrir el micrófono, un menú emergente permite elegir entre **Conversación en tiempo real** y **Dictado editable**. El modo en tiempo real requiere una `OPENAI_API_KEY` de ámbito de usuario y conecta el navegador con `gpt-realtime-2.1` mediante WebRTC. El chat se contrae en un orbe de voz situado abajo a la derecha; al pulsarlo puedes mostrar u ocultar el chat sin finalizar la conversación.
+
+El modelo de voz utiliza las mismas herramientas autenticadas de Agent Native que el chat, por lo que puede navegar por la aplicación y ejecutar acciones mientras habla. Las acciones que requieren aprobación permanecen en pausa hasta que las apruebes. El audio nunca se almacena en SQL; Agent Native conserva únicamente un estado compacto de la sesión y la transcripción. Las sesiones en tiempo real duran como máximo 60 minutos.
+
 ## Cómo funciona {#how-it-works}
 
 El botón de voz del compositor graba audio en el navegador y luego elige un proveedor:

package/docs/content/locales/es-ES/workspace-connections.mdx

@@ -425,10 +425,9 @@ No duplique OAuth/almacenamiento de tokens en cada aplicación. El registro de c
 
 ### Configuración del plano de control de despacho
 
-Dispatch expone el plano de control actions que escribe las mismas funciones de tienda compartida que una aplicación podría llamar directamente:
+Dispatch expone acciones del plano de control que escriben mediante las mismas funciones del almacén compartido que una aplicación podría llamar directamente: su acción `upsert-workspace-connection` valida la entrada frente al catálogo de proveedores y después delega en la misma `upsertWorkspaceConnection()` que se muestra en esta página:
 
 ```ts
-// templates/dispatch/actions/upsert-workspace-connection.ts delegates to this.
 await upsertWorkspaceConnection({
   id: "team-slack",
   provider: "slack",
@@ -493,3 +492,11 @@ El catálogo de proveedores y el almacén de subvenciones son la base de una cap
 Mantenga los límites estrictos: es seguro mostrar los metadatos del proveedor; los valores de credenciales permanecen en la bóveda.
 
 </details>
+
+## Qué sigue {#whats-next}
+
+- [**Dispatch**](/docs/dispatch) — la aplicación que suele administrar la configuración de conexiones del espacio de trabajo y la bóveda
+- [**Seguridad**](/docs/security) — la bóveda de credenciales, el alcance de secretos y el modelo de acceso al que apuntan las conexiones
+- [**Incorporación**](/docs/onboarding#checking-workspace-connections-in-onboarding) — comprobar la preparación de conexiones desde la lista de configuración de una plantilla
+- [**Clientes MCP**](/docs/mcp-clients) — compartir credenciales de servidores MCP en el espacio de trabajo como patrón relacionado de configuración reutilizable
+- [**Brain**](/docs/template-brain) — la implementación de referencia de una página de fuentes de proveedores basada en este modelo

package/docs/content/locales/es-ES/workspace.mdx

@@ -5,7 +5,11 @@ description: "Claude: personalización a nivel de código por usuario (skills, m
 
 # Espacio de trabajo
 
-> **¿Qué documento de espacio de trabajo?** Esta página cubre la **capa de personalización**: qué es un espacio de trabajo. Para conocer la forma de implementación (un monorepo, muchas aplicaciones), consulte [Multi-App Workspaces](/docs/multi-app-workspace); para conocer la gobernanza (quién revisa, aprueba y es propietario de qué), consulte [Workspace Governance](/docs/workspace-management).
+<Callout tone="info">
+
+**¿Qué documento de espacio de trabajo?** Esta página cubre la **capa de personalización**: qué es un espacio de trabajo. Para conocer la forma de implementación (un monorepo, muchas aplicaciones), consulte [Multi-App Workspaces](/docs/multi-app-workspace); para conocer la gobernanza (quién revisa, aprueba y es propietario de qué), consulte [Workspace Governance](/docs/workspace-management).
+
+</Callout>
 
 Cada aplicación nativa del agente viene con un **espacio de trabajo**: la capa de personalización que hace suyo al agente. Contiene instrucciones de equipo (`AGENTS.md`), aprendizajes compartidos (`LEARNINGS.md`), memoria estructurada personal (`memory/MEMORY.md`), skills que el agente utiliza según demanda, subagentes personalizados, trabajos programados y servidores MCP conectados: todo lo que esperarías de una configuración de código Claude/Codex.
 
@@ -82,7 +86,7 @@ El giro: **son filas SQL, no archivos del sistema de archivos.** Cada usuario ob
 | `CLAUDE.md` / skills por proyecto               | `AGENTS.md` por aplicación + recursos de memoria del espacio de trabajo |
 | Configuración MCP en un archivo JSON            | Configuración MCP en JSON _o_ la configuración UI, según el alcance     |
 
-Las mismas capacidades. Economía diferente. Consulte [Templates](/docs/cloneable-saas) para saber por qué esto es importante para SaaS.
+Las mismas capacidades. Economía diferente. Consulte [Aplicaciones](/docs/cloneable-saas) para saber por qué esto es importante para SaaS.
 
 ## Descripción general {#overview}
 
@@ -220,11 +224,9 @@ workspace context/brand.md
 -> personal context/brand.md
 ```
 
-Mantenga los archivos `context/` breves y objetivos: algunos puntos que el agente puede leer:
-
-```text
-<!-- context/brand.md -->
+Por ejemplo:
 
+```text filename="context/brand.md"
 # Marca
 
 - Voice: direct, warm, concrete
@@ -389,15 +391,9 @@ Hay dos tipos de agentes en Workspace:
 
 Utilice agentes personalizados para delegar dentro de una aplicación. Utilice agentes conectados cuando necesite llamar a otra aplicación a través de A2A.
 
-## @ Etiquetado {#at-tagging}
-
-Escriba `@` en la entrada del chat para hacer referencia a los elementos del espacio de trabajo. Aparece un menú desplegable en el cursor que muestra los agentes y archivos coincidentes. Utilice las teclas de flecha para navegar y Enter para seleccionar. El elemento seleccionado aparece como un chip en línea en la entrada.
-
-Cuando envía un mensaje, **archivos/recursos** se pasan como referencias que el agente puede leer, los **agentes personalizados** se ejecutan localmente con sus instrucciones de perfil y los **agentes conectados** se llaman a través de A2A.
+## Etiquetas @ y comandos / {#at-tagging}
 
-## /Comandos de barra diagonal {#slash-commands}
-
-Escriba `/` al comienzo de una línea para invocar una habilidad. Un menú desplegable muestra los skills disponibles con sus nombres y descripciones; seleccionar uno agrega un chip en línea e incluye su contenido como contexto cuando se envía el mensaje. Si no hay ningún skills configurado, el menú desplegable enlaza a estos documentos.
+Escribe `@` en la entrada del chat para hacer referencia a un agente, archivo o recurso, o `/` para invocar un skill. Ambos abren un menú desplegable en el cursor y añaden un chip en línea al seleccionar un elemento. Consulta [Menciones de agentes](/docs/agent-mentions) para ver toda la mecánica (enrutamiento, `MentionProvider` y selección de subagentes) y la [Guía de Skills](/docs/skills-guide) para saber cómo se crean y descubren los skills.
 
 ## Código versus modo de aplicación {#dev-vs-prod}
 
@@ -417,10 +413,6 @@ Workspace Connections permite que las aplicaciones compartan la misma cuenta de
 
 Consulte [Workspace Connections](/docs/workspace-connections) para obtener información sobre inicio rápido, conexión/concesión/credencialRef API y ejemplos concretos de Slack, HubSpot y GitHub.
 
----
-
-# Referencia
-
 ## Recurso API {#resource-api}
 
 Los recursos se pueden administrar desde el código del servidor, actions o REST API.
@@ -464,3 +456,12 @@ pnpm action resource-write --path "notes/meeting.md" --content "# Notas de la re
 # Eliminar un recurso
 pnpm action resource-delete --path "notes/old.md"
 ```
+
+## Qué sigue {#whats-next}
+
+- [**Guía de Skills**](/docs/skills-guide) — crear y definir el alcance de los archivos de skill referenciados desde `skills/`
+- [**Menciones de agentes**](/docs/agent-mentions) — mecánica completa de las menciones `@` y los comandos `/`
+- [**Trabajos recurrentes**](/docs/recurring-jobs) — programar los prompts creados a partir de tareas programadas
+- [**Gobernanza de Workspace**](/docs/workspace-management) — quién revisa, aprueba y posee los cambios del workspace
+- [**Workspaces de varias aplicaciones**](/docs/multi-app-workspace) — la forma de despliegue que abarca un workspace
+- [**Conexiones de Workspace**](/docs/workspace-connections) — compartir credenciales de proveedores entre aplicaciones

package/docs/content/locales/fr-FR/actions.mdx

@@ -11,7 +11,7 @@ Actions est la source unique de vérité pour tout ce que fait votre application
 - **Hooks Typesafe React** — `useActionQuery("name")` et `useActionMutation("name")` sur le frontend, types déduits du schéma.
 - **Appels client impératifs** — `callAction("name", params)` lorsqu'un hook ne rentre pas.
 - **Framework transport** — monté automatiquement par le framework derrière ces hooks et disponible pour les clients HTTP externes.
-- **Un outil MCP** — exposé aux applications Claude, ChatGPT personnalisées MCP, Claude Desktop/Code, Cursor, Codex et tout autre client MCP.
+- **Un outil MCP** — exposé aux applications Claude, ChatGPT personnalisées MCP, Claude Desktop/Code, Cursor, Codex et tout autre hôte MCP.
 - **Un outil A2A** — appelé par d'autres applications natives d'agent via A2A.
 - **Une commande CLI** — `pnpm action <name>` pour les scripts et les boucles de développement.
 
@@ -562,7 +562,7 @@ export default defineAction({
 });
 ```
 
-Conservez `link` comme solution de secours pour les clients CLI et MCP non-UI ; c'est également la cible de lancement de l'intégration. Le pont d'intégration (session de démarrage d'intégration signée, rendu de transplantation ou d'image contrôlée, pont hôte `ui/*`, CSP et serrage en hauteur) appartient à [External Agents](/docs/external-agents#mcp-app-bridge).
+Conservez `link` comme solution de secours pour la CLI et les hôtes MCP sans interface utilisateur ; c'est également la cible de lancement de l'intégration. Le pont d'intégration (session de démarrage d'intégration signée, rendu de transplantation ou d'image contrôlée, pont hôte `ui/*`, CSP et serrage en hauteur) appartient à [External Agents](/docs/external-agents#mcp-app-bridge).
 
 ## actions standard {#standard-actions}
 

package/docs/content/locales/fr-FR/agent-native-toolkit.mdx

@@ -97,9 +97,9 @@ coherent kit instead of exposing package boundaries in the app.
 
 - [UI Primitives](/docs/toolkit-ui) cover shared shadcn-style primitives under
   `@agent-native/toolkit/ui/*`.
-- [App Adapters](/docs/toolkit-app-adapters) show how apps wrap Toolkit pieces
+- [App Adapters](/docs/toolkit-ui#app-adapters) show how apps wrap Toolkit pieces
   through local `@/components/*` adapters.
-- [Shell & Hooks](/docs/toolkit-shell-hooks) cover header actions, mobile hooks,
+- [Shell & Hooks](/docs/toolkit-ui#shell-hooks) cover header actions, mobile hooks,
   toasts, and small app-shell helpers.
 - [Component API](/docs/components) remains the lower-level reference for the
   public React exports.

package/docs/content/locales/fr-FR/agent-surfaces.mdx

@@ -143,8 +143,7 @@ pnpm install
 
 Définissez ensuite l’opération durable :
 
-```ts
-// actions/summarize-week.ts
+```ts filename="actions/summarize-week.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -498,12 +497,11 @@ Gardez le contrat petit : définissez les opérations durables comme actions, r
 résultats du widget lorsque le chat a besoin de UI riche et ajout d'écrans pleins uniquement lorsque les utilisateurs
 besoin de parcourir, comparer, configurer ou collaborer sur des objets persistants.
 
-## Documents associés {#related-docs}
+## Et ensuite {#related-docs}
 
-- [Actions](/docs/actions) : définissez une fois l'opération sans tête.
-- [Native Interface de chat](/docs/native-chat-ui) : afficher les résultats des actions saisies dans le chat.
-- [Drop-in Agent](/docs/drop-in-agent) : montez les surfaces de discussion, de barre latérale ou de panneau.
-- [Component API](/docs/components) — pièces de discussion/compositeur React de niveau inférieur.
-- [Embedding SDK](/docs/embedding-sdk) : ajoutez Agent-Native à une application existante.
-- [External Agents](/docs/external-agents) : connectez des hôtes compatibles MCP à une application.
-- [A2A Protocol](/docs/a2a-protocol) – appeler des agents d'autres agents.
+- [**Actions**](/docs/actions) — définissez l’opération une fois ; toutes les surfaces ci-dessus appellent la même
+- [**Native Interface de chat**](/docs/native-chat-ui) — affichez les résultats typés sous forme de tableaux, graphiques et cartes dans le chat
+- [**Generative UI**](/docs/generative-ui) — générez une UI en bac à sable, temporaire ou persistante, dans le chat
+- [**Automation-First Apps**](/docs/pure-agent-apps) — le modèle complet sans navigateur pour les tâches, files d’attente, scripts et agents externes
+- [**External Agents**](/docs/external-agents) — connectez des hôtes compatibles MCP à une application
+- [**A2A Protocol**](/docs/a2a-protocol) — appelez des agents depuis d’autres applications Agent-Native

package/docs/content/locales/fr-FR/agent-teams.mdx

@@ -239,6 +239,7 @@ interface AgentTask {
   summary: string; // full summary once completed
   currentStep: string; // latest step label (updated while running)
   createdAt: number;
+  delegationDepth?: number; // 1 for a direct sub-agent, 2 for a sub-agent of that sub-agent, etc.
   // Additional fields: parentThreadId, name, updatedAt, startedAt,
   // completedAt, runId, error
 }

package/docs/content/locales/fr-FR/authentication.mdx

@@ -15,7 +15,7 @@ L'authentification est configurée automatiquement via `autoMountAuth(app)` dans
 - **MCP OAuth à distance :** Standard OAuth 2.1 pour les hôtes MCP tels que le code Claude et les connecteurs ChatGPT.
 - **Personnalisé :** Apportez votre propre authentification via le rappel `getSession`.
 
-<Diagram id="doc-block-16302hf" title={"Trois façons d'entrer, une seule séance"} summary={"Les visiteurs du navigateur, les clients programmatiques MCP et les fournisseurs personnalisés résolvent tous la même AuthSession que celle lue par la portée en aval."}>
+<Diagram id="doc-block-16302hf" title={"Trois façons d'entrer, une seule séance"} summary={"Les visiteurs du navigateur, les hôtes MCP et les fournisseurs personnalisés résolvent tous la même AuthSession que celle lue par la portée en aval."}>
 
 ```html
 <div class="auth-modes">

package/docs/content/locales/fr-FR/components.mdx

@@ -476,10 +476,12 @@ action pour que le UI et l'agent partagent la même capacité.
 ```ts
 import { defineAction } from "@agent-native/core/action";
 import { completeText } from "@agent-native/core/server";
+import { z } from "zod";
 
 export default defineAction({
   description: "Classify a short message",
-  run: async ({ body }: { body: string }) => {
+  schema: z.object({ body: z.string() }),
+  run: async ({ body }) => {
     const result = await completeText({
       systemPrompt: "Return exactly one label.",
       input: body,
@@ -494,3 +496,11 @@ export default defineAction({
 Utilisez plutôt `sendToAgentChat({ background: true, openSidebar: false })` lorsque
 le travail nécessite des outils, un état, une auditabilité, un pilotage utilisateur ou plusieurs étapes
 raisonnement.
+
+## Et ensuite {#whats-next}
+
+- [**Drop-in Agent**](/docs/drop-in-agent) — montez `<AgentSidebar>` et `<AgentPanel>` avec un parcours guidé axé sur le tutoriel
+- [**Native Chat UI**](/docs/native-chat-ui) — le contrat de résultat des actions derrière les widgets de données et les moteurs de rendu personnalisés
+- [**Actions**](/docs/actions) — `defineAction()`, les schémas et la surface d'actions appelée par ces composants
+- [**Real-Time Collaboration**](/docs/real-time-collaboration) — les hooks de collaboration et les composants de présence en détail
+- [**Sharing**](/docs/sharing) — câblage de `<ShareButton>` et `<ShareDialog>` pour les ressources possédables

package/docs/content/locales/fr-FR/creating-templates.mdx

@@ -44,7 +44,6 @@ Chaque modèle suit la même présentation générale :
 <FileTree
   id="doc-block-ixpw0s"
   title={"Structure du projet de modèle"}
-  title="my-template/"
   entries={[
     {
       path: "app/",
@@ -170,8 +169,7 @@ Les quatre zones de chaque modèle s'articulent via une surface d'action partag
 
 Définissez des tables de domaines avec les assistants du framework Drizzle afin que les schémas restent portables sur SQLite, Postgres, D1, Turso, Supabase, Neon et d'autres backends pris en charge :
 
-```ts
-// server/db/schema.ts
+```ts filename="server/db/schema.ts"
 import {
   table,
   text,
@@ -202,8 +200,7 @@ Les modifications du schéma doivent être additives. Ajoutez des tables et des
 
 Pour les lectures et écritures d'applications, utilisez le générateur de requêtes de Drizzle et les opérateurs portables de `drizzle-orm`. N'écrivez pas de code produit avec SQL brut lorsque Drizzle peut exprimer la requête, et n'importez pas depuis `drizzle-orm/sqlite-core` ou `drizzle-orm/pg-core` dans des modèles.
 
-```ts
-// server/plugins/db.ts
+```ts filename="server/plugins/db.ts"
 import { runMigrations } from "@agent-native/core/db";
 
 export default runMigrations(
@@ -347,8 +344,7 @@ Pour la navigation dans les applications, préférez une commande `navigate` inc
 `path` lorsque le URL est connu. N'écrivez pas également `__set_url__` pour le même coup ;
 cette clé est réservée aux outils du framework URL et aux modifications de filtre URL uniquement.
 
-```ts
-// actions/navigate.ts
+```ts filename="actions/navigate.ts"
 import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { z } from "zod";

package/docs/content/locales/fr-FR/cross-app-sso.mdx

@@ -9,7 +9,11 @@ Chaque application hébergée sur `*.agent-native.com` exécute son propre dépl
 
 Il s'agit de la même primitive de confiance que [A2A](/docs/a2a-protocol) et [External Agents](/docs/external-agents) utilisent déjà (un JWT signé `A2A_SECRET` et vérifié à la limite de la demande) appliquée au chemin de connexion humaine au lieu des appels d'agent à agent.
 
-> **Déploiement unifié ou déploiement par domaine.** Si vous hébergez toutes les applications sur une seule origine (`your-agents.com/mail`, `your-agents.com/calendar`), vous bénéficiez déjà d'une connexion partagée via un seul domaine de cookie — aucune fédération n'est nécessaire. Cross-App SSO n’est nécessaire que lorsque les applications s’exécutent sur des domaines distincts. Voir [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment).
+<Callout tone="info">
+
+**Déploiement unifié ou déploiement par domaine.** Si vous hébergez toutes les applications sur une seule origine (`your-agents.com/mail`, `your-agents.com/calendar`), vous bénéficiez déjà d'une connexion partagée via un seul domaine de cookie — aucune fédération n'est nécessaire. Cross-App SSO n’est nécessaire que lorsque les applications s’exécutent sur des domaines distincts. Voir [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment).
+
+</Callout>
 
 ## Quoi et pourquoi {#what-why}
 
@@ -86,15 +90,17 @@ Le flux est une redirection standard d'autorisation → jeton signé → rappel,
 
 </Diagram>
 
-1. **Application → Répartir (autoriser).** L'application envoie l'utilisateur à l'autorité d'identité :
+1. **Application → Dispatch (autorisation).** La route `GET /_agent-native/identity/login` de l’application (celle du bouton « Se connecter avec Agent-Native ») construit la redirection et envoie l’utilisateur à l’autorité d’identité :
 
-   ```
+   ```http
    GET https://dispatch.agent-native.com/_agent-native/identity/authorize
        ?app=<requesting-app>
        &redirect_uri=<app-callback-url>
        &state=<csrf-state>
    ```
 
+   `redirect_uri` est la propre route `GET /_agent-native/identity/callback` de cette application — celle qui reçoit le jeton signé à l’étape 3.
+
 <Endpoint id="cross-app-sso-identity-authorize-fr-fr" title={"Point de terminaison d'autorisation d'identité"} method="GET" path="/_agent-native/identity/authorize" summary={"Dispatch (autorité d'identité) authentifie l'humain et le redirige avec un jeton d'identité signé"} auth={"Session de répartition (connexion interactive si aucune)"} params={[
   {
     "name": "app",
@@ -143,7 +149,7 @@ Le flux est une redirection standard d'autorisation → jeton signé → rappel,
    | `scope`      | Toujours `"identity"` : ce jeton autorise uniquement la connexion          |
    | `exp`        | **≤ 2 minutes** à partir du problème                                       |
 
-4. **L'application vérifie et les liens JIT par e-mail.** L'application vérifie la signature du jeton avec son propre `A2A_SECRET`, vérifie `scope: "identity"` et `exp`, puis effectue **une liaison juste à temps strictement par e-mail vérifié** :
+4. **L’application vérifie et lie le compte juste à temps par e-mail.** La route `GET /_agent-native/identity/callback` vérifie la signature du jeton avec `A2A_SECRET`, contrôle `scope: "identity"` et `exp`, puis effectue **une liaison juste à temps strictement par e-mail vérifié** :
    - S'il existe un utilisateur local avec cette adresse e-mail → réutilisez-le tel quel.
    - Sinon → créez un utilisateur local pour cet e-mail.
 
@@ -290,9 +296,13 @@ Une fois qu'une application est vérifiée, répétez les étapes 2 à 3 pour l
 **5. Rollback = désactivez la variable d'environnement lors du déploiement de cette application.**
 Pour restaurer une application, **supprimez `AGENT_NATIVE_IDENTITY_HUB_URL` de l'environnement de cette application et redéployez-la/redémarrez-la.** L'application revient immédiatement à son comportement d'authentification antérieur. Il n'y a **aucune modification de données à annuler** : les lignes d'identité n'ont été ajoutées que, et la suppression de la variable rend simplement le chemin de fédération à nouveau inactif. Le basculement et la restauration de chaque application sont indépendants et réversibles.
 
-> Le déploiement déconnecte les utilisateurs lorsque chaque application est activée (ils se ré-authentifient via Dispatch), mais ils se reconnectent toujours au **même compte correspondant à l'adresse e-mail avec les données intactes**, car les lignes d'identité ne sont jamais détruites ou renommées : elles sont seulement ajoutées.
+<Callout tone="info">
+
+Le déploiement déconnecte les utilisateurs lorsque chaque application est activée (ils se ré-authentifient via Dispatch), mais ils se reconnectent toujours au **même compte correspondant à l'adresse e-mail avec les données intactes**, car les lignes d'identité ne sont jamais détruites ou renommées : elles sont seulement ajoutées.
+
+</Callout>
 
-## Connexe {#related}
+## Et ensuite {#whats-next}
 
 - [Authentication](/docs/authentication) – modes d'authentification locaux, sessions, organisations, variable d'environnement `A2A_SECRET`.
 - [A2A Protocol](/docs/a2a-protocol) — le modèle de confiance signé JWT, à vérification à la limite, réutilisé.

package/docs/content/locales/fr-FR/deployment.mdx

@@ -452,3 +452,11 @@ Voir [Frames](/docs/frames) pour en savoir plus sur le panneau d'agent intégré
 ## Déploiements multi-instances {#multi-instance}
 
 Les applications natives d'agent stockent tous les états dans SQL avec Drizzle et synchronisent le UI via [polling](/docs/key-concepts#polling-sync) avec la base de données : pas d'état du système de fichiers, pas de sessions persistantes, pas de caches en mémoire. Cela signifie que les déploiements multi-instances et sans serveur fonctionnent immédiatement : pointez chaque instance vers le même `DATABASE_URL` et elles convergent automatiquement. Voir [Key Concepts — Data in SQL](/docs/key-concepts#data-in-sql) et [Portability](/docs/key-concepts#hosting-agnostic).
+
+## Et ensuite
+
+- [**Database**](/docs/database#production) — choisissez un backend SQL persistant avant votre premier déploiement en production
+- [**Security**](/docs/security) — la liste de contrôle de production et les indicateurs facultatifs mentionnés sur cette page
+- [**Authentication**](/docs/authentication) — les identifiants OAuth et variables d’environnement du mode d’authentification choisi
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — le modèle d’espace de travail derrière la compilation à origine unique de `deploy`
+- [**Frames**](/docs/frames) — le panneau d’agent intégré face au cadre cloud de Builder.io pour les modifications de l’UI en production

package/docs/content/locales/fr-FR/external-agents.mdx

@@ -136,13 +136,9 @@ instantané jusqu'à ce que vous l'actualisiez/le révisiez à nouveau, donc ana
 ou de l'application MCP. Si vous disposez encore d'anciens connecteurs par application
 activé avec Dispatch, actualisez ou reconnectez chaque connecteur obsolète ; mise à jour
 Dispatch ne réécrit pas le calendrier/courrier/etc mis en cache de ChatGPT ou Claude.
-instantanés. Les portées sont :
-
-| Portée      | Ce qu'il permet                                                           |
-| ----------- | ------------------------------------------------------------------------- |
-| `mcp:read`  | Outils en lecture seule et découverte d'outils/ressources                 |
-| `mcp:write` | Rédaction, mise à jour et autres actions en mutation                      |
-| `mcp:apps`  | Applications MCP en ligne, graphiques, tableaux de bord, brouillons et UI |
+instantanés. Les portées `mcp:read` / `mcp:write` / `mcp:apps` sont les mêmes
+que celles décrites plus bas dans
+[OAuth MCP distant standard](#standard-oauth).
 
 Cursor, Goose, Postman, MCPJam et VS Code GitHub Copilot utilisent la même télécommande
 MCP URL via leur propre serveur MCP UI lorsque leur version prend en charge les OAuth distants

package/docs/content/locales/fr-FR/key-concepts.mdx

@@ -11,11 +11,9 @@ Comment fonctionnent les applications natives pour agents : principes et archit
 
 Chaque application native pour agent est composée de trois éléments qui fonctionnent ensemble :
 
-> **Agent** – IA autonome qui lit et écrit des données, exécute actions et modifie le code. Personnalisable avec skills et instructions.
->
-> **Application** — Surface du produit autour de l'agent. Il peut s'agir au début d'une action uniquement, d'un chat riche, d'un petit plan de contrôle ou d'un UI React complet avec des tableaux de bord, des flux et des visualisations.
->
-> **Ordinateur** — Base de données, navigateur, exécution de code. Les agents travaillent directement avec SQL et les outils intégrés ; Les serveurs MCP sont des modules complémentaires facultatifs, et non la base.
+- **Agent** – IA autonome qui lit et écrit des données, exécute actions et modifie le code. Personnalisable avec skills et instructions.
+- **Application** — Surface du produit autour de l'agent. Il peut s'agir au début d'une action uniquement, d'un chat riche, d'un petit plan de contrôle ou d'un UI React complet avec des tableaux de bord, des flux et des visualisations.
+- **Ordinateur** — Base de données, navigateur, exécution de code. Les agents travaillent directement avec SQL et les outils intégrés ; Les serveurs MCP sont des modules complémentaires facultatifs, et non la base.
 
 <Diagram id="doc-block-1w2cmz8" title="Agent, application et ordinateur" summary={"Trois couches travaillant ensemble sur un magasin SQL partagé. L'agent et l'application lisent et écrivent les mêmes données."}>
 
@@ -278,8 +276,7 @@ Pourquoi ne pas appeler un LLM en ligne ?
 
 Lorsque l'agent doit effectuer quelque chose de complexe (appeler un API, traiter des données, interroger la base de données), il exécute une **action**. Actions sont des fichiers TypeScript dans `actions/` qui exportent un `defineAction()` par défaut :
 
-```ts
-// actions/fetch-data.ts
+```ts filename="actions/fetch-data.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -383,9 +380,8 @@ Un _frame_ est l'environnement qui héberge l'agent à côté de votre applicati
 
 Les applications natives d'agent incluent un panneau d'agent intégré qui fournit l'agent IA ainsi que l'application UI. C'est ce qui fait fonctionner l'architecture : l'agent a besoin d'un ordinateur (base de données, navigateur, exécution de code) et l'application a besoin de l'agent pour le travail de l'IA.
 
-> **Panneau d'agent intégré** — Chat et terminal CLI en option intégrés à chaque application. Prend en charge le code Claude, Codex, Gemini, OpenCode et Builder.io. Fonctionne localement. Gratuit et open source.
->
-> **Cloud** : déployez sur n'importe quel cloud avec une collaboration en temps réel, une édition visuelle, des rôles et des autorisations. Idéal pour les équipes.
+- **Panneau d'agent intégré** — Chat et terminal CLI en option intégrés à chaque application. Prend en charge le code Claude, Codex, Gemini, OpenCode et Builder.io. Fonctionne localement. Gratuit et open source.
+- **Cloud** : déployez sur n'importe quel cloud avec une collaboration en temps réel, une édition visuelle, des rôles et des autorisations. Idéal pour les équipes.
 
 ## Conscience du contexte {#context-awareness}
 
@@ -457,14 +453,11 @@ L'adoption du framework est utile principalement en raison de ce que vous n'avez
 
 C'est le "et tout le reste" que vous seriez autrement en train de coller vous-même.
 
-## Plongées approfondies {#deep-dives}
-
-Pour obtenir des conseils détaillés sur des modèles spécifiques :
+## Et ensuite {#deep-dives}
 
-- [What Is Agent-Native?](/docs/what-is-agent-native) — la vision et la philosophie
-- [Context Awareness](/docs/context-awareness) — état de navigation, écran d'affichage, commandes de navigation
-- [Skills Guide](/docs/skills-guide) — framework skills, domaine skills, création de skills personnalisé
-- [Native Interface de chat](/docs/native-chat-ui) – tableaux, graphiques et posture d'exécution de BYO déclarés par action
-- [Agent Surfaces](/docs/agent-surfaces) : chat riche et sans tête, side-car intégré et chemins d'accès complets à l'application
-- [A2A Protocol](/docs/a2a-protocol) — communication d'agent à agent
-- [Multi-App Workspace](/docs/multi-app-workspace) : hébergez de nombreuses applications dans un seul dépôt unique avec authentification partagée, skills, composants et informations d'identification
+- [**What Is Agent-Native?**](/docs/what-is-agent-native) — la vision et la philosophie qui sous-tendent ces règles
+- [**Context Awareness**](/docs/context-awareness) — l’état de navigation et les commandes view-screen et navigate en détail
+- [**Skills Guide**](/docs/skills-guide) — les skills du framework et du domaine, et la création de skills personnalisées
+- [**Native Chat UI**](/docs/native-chat-ui) — les tableaux et graphiques déclarés par actions, et la prise en charge des environnements d’exécution personnalisés
+- [**Agent Surfaces**](/docs/agent-surfaces) — le chat, l’UI native intégrée, les pages d’application complètes, le sidecar intégré, l’automatisation et les parcours d’agents externes
+- [**A2A Protocol**](/docs/a2a-protocol) — la communication entre agents

package/docs/content/locales/fr-FR/multi-tenancy.mdx

@@ -17,7 +17,7 @@ Un nouvel échafaudage `npx @agent-native/core@latest create` est déjà livré
 - **Changement d'organisation** : la session suit l'organisation active (`session.orgId`) et son changement modifie les données que l'utilisateur et l'agent voient.
 - **Isolement des données par organisation** : chaque requête est automatiquement étendue à l'organisation active.
 
-Si vous évaluez un agent natif pour un CRM, un outil de suivi de projet, une boîte de réception d'assistance ou tout autre outil d'équipe, la base multi-tenant est déjà là. Tous les modèles propriétaires sont multi-tenants – voir [Cloneable SaaS templates](/docs/cloneable-saas) pour la liste.
+Si vous évaluez un agent natif pour un CRM, un outil de suivi de projet, une boîte de réception d'assistance ou tout autre outil d'équipe, la base multi-tenant est déjà là. Tous les modèles propriétaires sont multi-tenants – voir [Modèles](/docs/cloneable-saas) pour la liste.
 
 <Diagram id="doc-block-1dto6fl" title={"Appartenance à une organisation et isolement"} summary={"Les utilisateurs rejoignent les organisations en tant que owner/admin/member. Chaque ligne propriétaire porte le org_id du locataire qui en est propriétaire, et aucune ligne ne traverse la limite."}>
 
@@ -117,8 +117,8 @@ Les données des locataires sont isolées par une colonne `org_id` (ajoutée par
 
 Il s'agit du même pipeline que celui utilisé pour la portée par utilisateur. Pour les mécanismes de niveau SQL, le contrat `ownableColumns()` et les gardes `accessFilter` / `resolveAccess` / `assertAccess`, voir [Security → Data Scoping](/docs/security#data-scoping) — la source unique de vérité pour le pipeline de cadrage.
 
-## Documents associés {#related}
+## Et ensuite {#related}
 
-- [Authentication](/docs/authentication#organizations) — sessions, prestataires sociaux et surface de gestion de l'organisation
-- [Security → Data Scoping](/docs/security#data-scoping) – Isolation de niveau SQL, contrat `ownableColumns()` et protections d'accès
-- [Multi-App Workspace](/docs/multi-app-workspace) : hébergement de plusieurs applications natives d'agent dans un seul monorepo avec authentification partagée et RBAC
+- [**Authentication**](/docs/authentication#organizations) — sessions, fournisseurs sociaux et surface de gestion de l’organisation
+- [**Security — Data Scoping**](/docs/security#data-scoping) — isolation au niveau SQL, contrat `ownableColumns()` et protections d’accès
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — hébergement de plusieurs applications Agent-Native dans un monorepo avec authentification partagée et RBAC