npm - @agent-native/core - Versions diffs - 0.77.2 → 0.77.4 - Mend

@agent-native/core 0.77.2 → 0.77.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2004) hide show

package/docs/content/locales/fr-FR/code-agents-ui.md CHANGED Viewed

@@ -27,7 +27,7 @@ Il y a trois couches :
 ```an-diagram title="Trois couches sur un seul magasin" summary="CLI, Desktop et l'interface utilisateur partagée sont des surfaces différentes sur le même magasin d'exécution et le même exécuteur sauvegardés sur des fichiers ; les hôtes l'adaptent via le contrat CodeAgentsHost."
 {
-  "html": "<div class=\"diagram-layers\"><div class=\"diagram-row\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">CLI</span><small class=\"diagram-muted\">start · resume · status · stop</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">Desktop</span><small class=\"diagram-muted\">native terminal · webviews · deep links</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">Partagerd UI</span><small class=\"diagram-muted\">@agent-native/code-agents-ui</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill\">CodeAgentsHost</span><small class=\"diagram-muted\">host contract</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>File-backed run store + executor<br><small class=\"diagram-muted\">@agent-native/core/code-agents</small></div></div>",
+  "html": "<div class=\"diagram-layers\"><div class=\"diagram-row\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">CLI</span><small class=\"diagram-muted\">démarrer · reprendre · statut · arrêter</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">Desktop</span><small class=\"diagram-muted\">terminal natif · webviews · liens profonds</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">Partagerd UI</span><small class=\"diagram-muted\">@agent-native/code-agents-ui</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill\">CodeAgentsHost</span><small class=\"diagram-muted\">host contract</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>Store d’exécution sur fichiers + exécuteur<br><small class=\"diagram-muted\">@agent-native/core/code-agents</small></div></div>",
   "css": ".diagram-layers{display:flex;flex-direction:column;gap:10px;align-items:center}.diagram-layers .diagram-row{display:flex;gap:12px;flex-wrap:wrap;justify-content:center}.diagram-layers .diagram-card{display:flex;flex-direction:column;gap:4px;padding:12px 16px}.diagram-layers .diagram-arrow{font-size:22px;line-height:1}.diagram-layers .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
@@ -375,18 +375,18 @@ La connexion est sortante uniquement depuis Desktop :
 ```an-diagram title="Le Dispatch distant est uniquement sortant" summary="Le mobile ne parle jamais directement au bureau. Desktop interroge longuement Dispatch, revendique les commandes, pilote le magasin d'exécution local et reflète les résultats."
 {
-  "html": "<div class=\"diagram-remote\"><div class=\"diagram-node\" data-rough>Mobile / Telegram<br><small class=\"diagram-muted\">/code · sessions</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Dispatch relay<br><small class=\"diagram-muted\">hosts · runs · transcript</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div><div class=\"diagram-node\" data-rough>Desktop<br><small class=\"diagram-muted\">long-polls · claims · drives run store</small></div></div>",
+  "html": "<div class=\"diagram-remote\"><div class=\"diagram-node\" data-rough>Application mobile / Telegram<br><small class=\"diagram-muted\">/code · séances</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Relais Dispatch<br><small class=\"diagram-muted\">hôtes · exécutions · transcription</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div><div class=\"diagram-node\" data-rough>Desktop<br><small class=\"diagram-muted\">long-polls · revendique · pilote le store d’exécution</small></div></div>",
   "css": ".diagram-remote{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-remote .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
 Les points de terminaison canoniques du relais distant sont :
-```an-api title="Desktop claims queued work"
+```an-api title="Le bureau revendique le travail en file d'attente"
 {
   "method": "POST",
   "path": "/_agent-native/integrations/remote/poll",
-  "summary": "Desktop long-polls the relay to claim enqueued commands",
+  "summary": "Le bureau interroge longuement le relais pour réclamer les commandes mises en file d'attente",
   "description": "Outbound-only from a paired Desktop host. Desktop authenticates with its device token and claims work that mobile or Telegram enqueued.",
   "auth": "Desktop device token",
   "responses": [

package/docs/content/locales/fr-FR/components.md CHANGED Viewed

@@ -27,7 +27,7 @@ les bundlers choisissent donc l'entrée sécurisée pour le navigateur.
 ```an-diagram title="Déposez un calque, pas hors du cadre" summary="Chaque couche conserve le même temps d'exécution (actions, état du thread et synchronisation SQL-backed) tout en vous donnant plus de contrôle sur le chrome."
 {
-  "html": "<div class=\"diagram-layers\"><div class=\"diagram-card layer\"><span class=\"diagram-pill accent\">&lt;AgentSidebar&gt;</span><small class=\"diagram-muted\">Whole sidebar around your app. The 80% case.</small></div><div class=\"diagram-card layer l2\"><span class=\"diagram-pill\">&lt;AgentPanel&gt; &middot; &lt;AgentChatSurface&gt;</span><small class=\"diagram-muted\">The panel or a chat page in your own layout.</small></div><div class=\"diagram-card layer l3\"><span class=\"diagram-pill\">&lt;AssistantChat&gt; + runtime</span><small class=\"diagram-muted\">Own the chrome; optionally pass a BYO AgentChatRuntime.</small></div><div class=\"diagram-card layer l4\"><span class=\"diagram-pill\">&lt;PromptComposer&gt; &middot; &lt;AgentConversation&gt;</span><small class=\"diagram-muted\">Composer and transcript primitives only.</small></div><div class=\"diagram-rail\" data-rough>Same runtime: actions &middot; thread state &middot; SQL-backed sync</div></div>",
+  "html": "<div class=\"diagram-layers\"><div class=\"diagram-card layer\"><span class=\"diagram-pill accent\">&lt;AgentSidebar&gt;</span><small class=\"diagram-muted\">Toute la barre latérale autour de votre app. Le cas des 80 %.</small></div><div class=\"diagram-card layer l2\"><span class=\"diagram-pill\">&lt;AgentPanel&gt; &middot; &lt;AgentChatSurface&gt;</span><small class=\"diagram-muted\">Le panneau ou une page de chat dans votre propre layout.</small></div><div class=\"diagram-card layer l3\"><span class=\"diagram-pill\">&lt;AssistantChat&gt; + runtime</span><small class=\"diagram-muted\">Own the chrome; optionally pass a BYO AgentChatRuntime.</small></div><div class=\"diagram-card layer l4\"><span class=\"diagram-pill\">&lt;PromptComposer&gt; &middot; &lt;AgentConversation&gt;</span><small class=\"diagram-muted\">Composerr and transcript primitives only.</small></div><div class=\"diagram-rail\" data-rough>Même runtime: actions &middot; thread state &middot; SQL-backed sync</div></div>",
   "css": ".diagram-layers{display:flex;flex-direction:column;gap:10px}.diagram-layers .layer{display:flex;flex-direction:column;gap:4px;padding:12px 14px}.diagram-layers .l2{margin-inline-start:24px}.diagram-layers .l3{margin-inline-start:48px}.diagram-layers .l4{margin-inline-start:72px}.diagram-layers .diagram-rail{margin-top:6px;padding:10px 14px;text-align:center}"
 }
 ```
@@ -58,7 +58,7 @@ les bundlers choisissent donc l'entrée sécurisée pour le navigateur.
 conversation pendant que Agent-Native conserve le compositeur, la transcription, les fiches outils et
 rendu natif des widgets. Les connecteurs ci-dessus sont la surface API ; le moteur d'exécution
 Les formes de contrats et d'événements sont enseignées
-[Native Chat UI — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes).
+[Native Interface de chat — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes).
 Si vous choisissez entre des agents sans tête, un chat enrichi, un side-car intégré et
 Formes d'application complètes, voir [Agent Surfaces](/docs/agent-surfaces).
@@ -96,7 +96,7 @@ function CustomChat({ projectSlug }: { projectSlug: string }) {
 Pour un point de terminaison d'agent à emporter, créez un `AgentChatRuntime` avec l'un des
 connecteurs ci-dessus et transmettez-le à `<AssistantChat runtime={...} />`. Voir
-[Native Chat UI — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes)
+[Native Interface de chat — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes)
 pour l'utilisation du connecteur, le flux d'événements normalisé et quand l'atteindre
 `createHttpAgentChatRuntime()` par rapport à un connecteur spécifique au protocole.
@@ -151,7 +151,7 @@ Utiliser des widgets d'outils natifs lorsqu'un résultat d'action doit s'affiche
 dans le chat au lieu de JSON simple. Les sorties réutilisables intégrées incluent
 `DataTableWidget`, `DataChartWidget` et `DataWidgetResult` ; ils sont exportés
 à partir de `@agent-native/core/client/chat` et de l'entrée du client racine. Voir
-[Native Chat UI](/docs/native-chat-ui) pour le contrat de résultat de l'action.
+[Native Interface de chat](/docs/native-chat-ui) pour le contrat de résultat de l'action.
 | API                              | Utiliser quand                                                                                                  |
 | -------------------------------- | --------------------------------------------------------------------------------------------------------------- |
@@ -180,7 +180,7 @@ crochets de documents collaboratifs.
 ```an-diagram title="Présence : les humains et l'agent partagent une couche de sensibilisation" summary="useCollaborativeDoc est propriétaire de l'instance de sensibilisation ; les hooks clients publient des curseurs et des sélections ; les assistants du serveur permettent à une action d'agent d'apparaître en tant que participant en direct."
 {
-  "html": "<div class=\"diagram-presence\"><div class=\"diagram-col\"><div class=\"diagram-node\">Humans<br><small class=\"diagram-muted\">usePresence &middot; cursors, selection</small></div><div class=\"diagram-node diagram-accent\">Agent action<br><small class=\"diagram-muted\">agentUpdateSelection()</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">useCollaborativeDoc</span><small class=\"diagram-muted\">awareness layer</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">&lt;PresenceBar&gt; &middot; &lt;LiveCursorOverlay&gt;<br><small class=\"diagram-muted\">render everyone, agent included</small></div></div>",
+  "html": "<div class=\"diagram-presence\"><div class=\"diagram-col\"><div class=\"diagram-node\">Humans<br><small class=\"diagram-muted\">usePresence &middot; cursors, selection</small></div><div class=\"diagram-node diagram-accent\">Action d’agent<br><small class=\"diagram-muted\">agentUpdateSelection()</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">useCollaborativeDoc</span><small class=\"diagram-muted\">awareness layer</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">&lt;PresenceBar&gt; &middot; &lt;LiveCursorOverlay&gt;<br><small class=\"diagram-muted\">rend tout le monde, agent compris</small></div></div>",
   "css": ".diagram-presence{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-presence .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-presence .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px}.diagram-presence .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```

package/docs/content/locales/fr-FR/context-awareness.md CHANGED Viewed

@@ -26,7 +26,7 @@ Six modèles résolvent ce problème :
 ```an-diagram title="Comment l'agent voit ce que vous voyez" summary="L'interface utilisateur écrit des clés d'état légères ; l'écran de visualisation les hydrate en enregistrements réels ; l'agent peut écrire, revenir en arrière pour déplacer l'interface utilisateur."
 {
-  "html": "<div class=\"diagram-ctx\"><div class=\"diagram-card col\"><span class=\"diagram-pill\">UI writes</span><div class=\"diagram-node\">navigation<br><small class=\"diagram-muted\">view, open ids</small></div><div class=\"diagram-node\">__url__<br><small class=\"diagram-muted\">shareable filters</small></div><div class=\"diagram-node\">selection<br><small class=\"diagram-muted\">rows, blocks, shapes</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">view-screen</span><small class=\"diagram-muted\">reads state &middot; fetches records</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Agent acts<br><small class=\"diagram-muted\">on the real object</small></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box diagram-accent\">navigate<br><small class=\"diagram-muted\">agent moves the UI</small></div></div>",
+  "html": "<div class=\"diagram-ctx\"><div class=\"diagram-card col\"><span class=\"diagram-pill\">L’UI écrit</span><div class=\"diagram-node\">navigation<br><small class=\"diagram-muted\">vue, IDs ouverts</small></div><div class=\"diagram-node\">__url__<br><small class=\"diagram-muted\">shareable filters</small></div><div class=\"diagram-node\">selection<br><small class=\"diagram-muted\">lignes, blocs, formes</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">view-screen</span><small class=\"diagram-muted\">reads state &middot; fetches records</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">L’agent agit<br><small class=\"diagram-muted\">on the real object</small></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box diagram-accent\">navigate<br><small class=\"diagram-muted\">l’agent déplace l’UI</small></div></div>",
   "css": ".diagram-ctx{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-ctx .col{display:flex;flex-direction:column;gap:8px;padding:14px}.diagram-ctx .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px}.diagram-ctx .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -133,7 +133,7 @@ Utilisez la clé d'état de l'application `selection` pour une sélection durabl
       "id": "hero-title",
       "selector": "[data-block-id='hero-title']",
       "label": "Hero title",
-      "text": "Q3 launch plan"
+      "text": "Lancement T3 plan"
     }
   ],
   "capturedAt": 1780332977027
@@ -197,10 +197,10 @@ Chaque modèle doit avoir une action `view-screen`. Il lit l'état de navigation
   "language": "ts",
   "code": "import { defineAction } from \"@agent-native/core/action\";\nimport { readAppState } from \"@agent-native/core/application-state\";\nimport { eq, inArray } from \"drizzle-orm\";\nimport { z } from \"zod\";\nimport { getDb, schema } from \"../server/db/index.js\";\n\nexport default defineAction({\n  description:\n    \"See what the user is currently looking at on screen.\",\n  schema: z.object({}),\n  http: false,\n  run: async () => {\n    const navigation = (await readAppState(\"navigation\")) as any;\n    const selection = (await readAppState(\"selection\")) as any;\n    const screen: Record<string, unknown> = {};\n    if (navigation) screen.navigation = navigation;\n    if (selection) screen.selection = selection;\n\n    const db = getDb();\n\n    // Fetch data based on what the user is viewing\n    if (navigation?.view === \"inbox\") {\n      screen.emailList = await db\n        .select()\n        .from(schema.emails)\n        .where(eq(schema.emails.label, navigation.label));\n    }\n    if (navigation?.threadId) {\n      screen.thread = await db\n        .select()\n        .from(schema.threads)\n        .where(eq(schema.threads.id, navigation.threadId));\n    }\n    if (selection?.kind === \"email.messages\") {\n      screen.selectedMessages = await db\n        .select()\n        .from(schema.emails)\n        .where(inArray(schema.emails.id, selection.messageIds));\n    }\n\n    if (Object.keys(screen).length === 0) {\n      return \"No application state found. Is the app running?\";\n    }\n    return screen;\n  },\n});",
   "annotations": [
-    { "lines": "10-11", "label": "Tool surface", "note": "The agent reads this description to know it can call `view-screen` to see the current UI." },
-    { "lines": "13", "label": "http: false", "note": "Internal action — not exposed over HTTP. The agent and `pnpm action` call it, not the browser." },
-    { "lines": "15-16", "label": "Read state", "note": "Pulls the lightweight `navigation` and `selection` keys the UI wrote." },
-    { "lines": "23-37", "label": "Hydrate", "note": "Turns those IDs into **fresh** records straight from SQL, so the agent verifies the live object before acting." }
+    { "lines": "10-11", "label": "Surface de l'outil", "note": "L'agent lit cette description pour savoir qu'il peut appeler `view-screen` pour voir l'interface utilisateur actuelle." },
+    { "lines": "13", "label": "http: false", "note": "Action interne – non exposée sur HTTP. L'agent et `pnpm action` l'appellent, pas le navigateur." },
+    { "lines": "15-16", "label": "Lire l'état", "note": "Extrait les touches légères `navigation` et `selection` écrites par l'interface utilisateur." },
+    { "lines": "23-37", "label": "Hydratation", "note": "Transforme ces IDs en enregistrements **frais** directement à partir de `application_state`, afin que l'agent vérifie l'objet actif avant d'agir." }
   ]
 }
 ```
@@ -210,7 +210,7 @@ L'agent doit appeler `pnpm action view-screen` avant d'agir sur le UI actuel. Il
 ```an-callout
 {
   "tone": "info",
-  "body": "**Keep `navigation` and `selection` small.** Store IDs plus short labels, not whole records. `view-screen` fetches the source of truth on demand, so stale or bulky state never reaches the agent."
+  "body": "**Gardez `navigation` et `selection` petits.** Stockez IDs ainsi que des étiquettes courtes, pas des disques entiers. `view-screen` récupère la source de vérité à la demande, de sorte qu'un état obsolète ou volumineux n'atteigne jamais l'agent."
 }
 ```
@@ -367,7 +367,7 @@ Comment ça marche :
 ```an-diagram title="Le marquage de la source arrête la gigue de la récupération automatique" summary="Un onglet ignore les événements de synchronisation marqués de son propre TAB_ID, mais réagit toujours aux écritures de l'agent et des autres onglets."
 {
-  "html": "<div class=\"diagram-jitter\"><div class=\"diagram-node\">This tab writes<br><small class=\"diagram-muted\">X-Request-Source: TAB_ID</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Server stores source<br>on the event</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card col\"><div class=\"diagram-pill warn\">source == TAB_ID &rarr; ignored</div><small class=\"diagram-muted\">no refetch, no flicker</small><div class=\"diagram-pill ok\">agent / other tab &rarr; applied</div><small class=\"diagram-muted\">UI updates live</small></div></div>",
+  "html": "<div class=\"diagram-jitter\"><div class=\"diagram-node\">Cet onglet écrit<br><small class=\"diagram-muted\">X-Request-Source: TAB_ID</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Le serveur stocke la source<br>on the event</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card col\"><div class=\"diagram-pill warn\">source == TAB_ID &rarr; ignored</div><small class=\"diagram-muted\">pas de refetch, pas de scintillement</small><div class=\"diagram-pill ok\">agent / other tab &rarr; applied</div><small class=\"diagram-muted\">L’UI se met à jour en direct</small></div></div>",
   "css": ".diagram-jitter{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-jitter .col{display:flex;flex-direction:column;gap:6px;padding:14px}.diagram-jitter .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```

package/docs/content/locales/fr-FR/creating-templates.md CHANGED Viewed

@@ -69,7 +69,7 @@ Les quatre zones de chaque modèle s'articulent via une surface d'action partag
 ```an-diagram title="Comment les quatre zones d'un modèle se connectent" summary="L'interface utilisateur et l'agent atteignent tous deux SQL via les mêmes actions ; l'état de l'application et la synchronisation des interrogations les maintiennent alignés."
 {
-  "html": "<div class=\"diagram-tmpl\"><div class=\"diagram-col\"><div class=\"diagram-node\">React UI<br><small class=\"diagram-muted\">app/routes · components</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">AGENTS.md · skills</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">defineAction()</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>SQL via Drizzle<br><small class=\"diagram-muted\">additive schema</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-pill ok\">Polling sync</div></div>",
+  "html": "<div class=\"diagram-tmpl\"><div class=\"diagram-col\"><div class=\"diagram-node\">UI React<br><small class=\"diagram-muted\">app/routes · composants</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">AGENTS.md · skills</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Opérations</span><small class=\"diagram-muted\">defineAction()</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>SQL avec Drizzle<br><small class=\"diagram-muted\">additive schema</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-pill ok\">Sondageing sync</div></div>",
   "css": ".diagram-tmpl{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-tmpl .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-tmpl .diagram-arrow{font-size:22px;line-height:1}.diagram-tmpl .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
@@ -137,9 +137,9 @@ export default runMigrations(
 Utilisez les documents [Database](/docs/database) et [Security](/docs/security) avant d'ajouter des schémas contenant des données utilisateur ou organisationnelles.
-## Définir les opérations comme Actions {#actions}
+## Définir les opérations {#actions}
-Actions est la source unique de vérité sur le comportement des applications. L'agent les appelle en tant qu'outils, le frontend les appelle via des hooks et d'autres applications peuvent les atteindre via MCP/A2A.
+Les actions sont la source unique de vérité sur le comportement des applications. L'agent les appelle en tant qu'outils, le frontend les appelle via des hooks et d'autres applications peuvent les atteindre via MCP/A2A.
 ```an-annotated-code title="actions/create-project.ts"
 {
@@ -148,9 +148,9 @@ Actions est la source unique de vérité sur le comportement des applications. L
   "code": "import { defineAction } from \"@agent-native/core/action\";\nimport { getDb } from \"../server/db/index.js\";\nimport { nanoid } from \"nanoid\";\nimport { z } from \"zod\";\nimport * as schema from \"../server/db/schema\";\n\nexport default defineAction({\n  description: \"Create a project.\",\n  schema: z.object({\n    title: z.string().min(1).describe(\"Project title\"),\n  }),\n  run: async ({ title }, ctx) => {\n    const db = getDb();\n    const id = nanoid();\n    await db.insert(schema.projects).values({\n      id,\n      title,\n      ownerEmail: ctx.userEmail,\n      orgId: ctx.orgId,\n    });\n    return { id, title };\n  },\n});",
   "annotations": [
     { "lines": "2", "note": "`getDb` is created per app via `createGetDb(schema)` in `server/db/index.ts`." },
-    { "lines": "8", "label": "Tool surface", "note": "The `description` is what the agent reads to decide when to call this action as a tool." },
+    { "lines": "8", "label": "Surface de l'outil", "note": "`description` est ce que l'agent lit pour décider quand appeler cette action en tant qu'outil." },
     { "lines": "9-11", "label": "Contrat typé", "note": "Un zod `schema` valide les entrées de l’agent, de l’UI, de HTTP, de MCP et d’A2A." },
-    { "lines": "18-19", "label": "Scoped write", "note": "Stamp `ownerEmail` / `orgId` from `ctx` so the row is correctly scoped for sharing and access checks." }
+    { "lines": "18-19", "label": "Écriture étendue", "note": "Tamponnez `ownerEmail` / `orgId` à partir de `ctx` afin que la ligne soit correctement délimitée pour les contrôles de partage et d'accès." }
   ]
 }
 ```
@@ -278,21 +278,21 @@ ligne d'objectif, règles de base, clés d'état d'application, table d'action e
 index :
 ```markdown
-# My Template
+# Mon modèle
 One workspace for projects, tasks, and notes.
-## Core Rules
+## Règles de base
-- Data lives in SQL via Drizzle. Use actions for all writes; schema is additive.
+- Data lives in SQL avec Drizzle. Use actions for all writes; schema is additive.
 - Use `view-screen` before acting on "this project" if the screen is unclear.
-## Application State
+## État de la demande
 - `navigation.view`: `home` | `project`
 - `navigation.projectId`: selected project on a project page
-## Actions
+## Opérations
 | Action           | Purpose                  |
 | ---------------- | ------------------------ |
@@ -316,11 +316,11 @@ name: project-imports
 description: How to import projects from the legacy CSV export.
 ---
-# Project Imports
+# Importations de projets
 Use this skill when the user uploads a legacy project CSV.
-## Rules
+## Règles
 - Validate required columns before creating rows.
 - Use `create-project` for each project so ownership and sync are correct.

package/docs/content/locales/fr-FR/cross-app-sso.md CHANGED Viewed

@@ -28,7 +28,7 @@ Le flux est une redirection standard d'autorisation → jeton signé → rappel,
 ```an-diagram title="Flux de fédération d'identité" summary="Dispatch authentifie l'humain et renvoie une assertion signée de courte durée d'une chose : l'e-mail vérifié. L'application est liée par e-mail et crée sa propre session locale."
 {
-  "html": "<div class=\"diagram-sso\"><div class=\"diagram-card\" data-rough><strong>Client app</strong><small class=\"diagram-muted\">own user store</small></div><div class=\"diagram-step\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><span class=\"diagram-pill\">authorize</span></div><div class=\"diagram-card\" data-rough><strong>Dispatch</strong><small class=\"diagram-muted\">identity authority</small><span class=\"diagram-pill accent\">authenticates human</span></div><div class=\"diagram-step\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><span class=\"diagram-pill accent\">302 + signed JWT</span></div><div class=\"diagram-card\" data-rough><strong>App callback</strong><small class=\"diagram-muted\">verify signature · scope:identity · exp &le; 2 min</small><span class=\"diagram-pill ok\">JIT-link by email</span><span class=\"diagram-pill ok\">mint local session</span></div></div>",
+  "html": "<div class=\"diagram-sso\"><div class=\"diagram-card\" data-rough><strong>Application cliente</strong><small class=\"diagram-muted\">own user store</small></div><div class=\"diagram-step\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><span class=\"diagram-pill\">authorize</span></div><div class=\"diagram-card\" data-rough><strong>Dispatch</strong><small class=\"diagram-muted\">identity authority</small><span class=\"diagram-pill accent\">authenticates human</span></div><div class=\"diagram-step\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><span class=\"diagram-pill accent\">302 + signed JWT</span></div><div class=\"diagram-card\" data-rough><strong>Callback de l’application</strong><small class=\"diagram-muted\">verify signature · scope:identity · exp &le; 2 min</small><span class=\"diagram-pill ok\">Association JIT par e-mail</span><span class=\"diagram-pill ok\">mint local session</span></div></div>",
   "css": ".diagram-sso{display:flex;align-items:stretch;gap:12px;flex-wrap:wrap}.diagram-sso .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:150px}.diagram-sso .diagram-step{display:flex;flex-direction:column;align-items:center;justify-content:center;gap:6px}.diagram-sso .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -50,7 +50,7 @@ Le flux est une redirection standard d'autorisation → jeton signé → rappel,
      "auth": "Session de répartition (connexion interactive si aucune)",
      "params": [
        { "name": "app", "in": "query", "type": "string", "required": true, "description": "L'identifiant de l'application demandeuse." },
-       { "name": "redirect_uri", "in": "query", "type": "string", "required": true, "description": "App callback URL. Validé par rapport à une liste blanche stricte (`*.agent-native.com` ou localhost par défaut)." },
+       { "name": "redirect_uri", "in": "query", "type": "string", "required": true, "description": "Callback de l’application URL. Validé par rapport à une liste blanche stricte (`*.agent-native.com` ou localhost par défaut)." },
        { "name": "state", "in": "query", "type": "string", "required": true, "description": "L'état CSRF a été renvoyé lors de la redirection."
      ],
      "réponses" : [
@@ -103,7 +103,7 @@ L'ensemble du modèle repose sur quelques garanties volontairement petites :
 ```an-callout
 {
   "tone": "success",
-  "body": "**Safe to enable, safe to revert.** Identity writes are **additive only** — an existing same-email account is reused untouched, and a new email just inserts a fresh row. There is no schema change and nothing to migrate, so flipping `AGENT_NATIVE_IDENTITY_HUB_URL` on or off is fully reversible at any time, per app."
+  "body": "**Activation sûre, restauration sécurisée.** Les écritures d'identité sont **additifs uniquement** : un compte de même adresse e-mail existant est réutilisé sans modification et un nouvel e-mail insère simplement une nouvelle ligne. Il n'y a aucun changement de schéma et rien à migrer, donc l'activation ou la désactivation de `AGENT_NATIVE_IDENTITY_HUB_URL` est entièrement réversible à tout moment, par application."
 }
 ```
@@ -111,7 +111,7 @@ Le lien juste à temps est une décision unique entièrement saisie sur l’e-ma
 ```an-diagram title="Décision JIT-link" summary="Le lien est saisi sur l'e-mail vérifié et est uniquement additif : les comptes existants sont réutilisés sans modification, les nouveaux e-mails créent un nouvel utilisateur local."
 {
-  "html": "<div class=\"diagram-jit\"><div class=\"diagram-node\" data-rough>Verified email<br><small class=\"diagram-muted\">from signed identity JWT</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-branch\"><div class=\"diagram-box\" data-rough>Local user exists?<span class=\"diagram-pill ok\">yes &rarr; reuse unchanged</span><span class=\"diagram-pill accent\">no &rarr; create local user</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Mint normal local session</div></div></div>",
+  "html": "<div class=\"diagram-jit\"><div class=\"diagram-node\" data-rough>E-mail vérifié<br><small class=\"diagram-muted\">depuis un JWT d’identité signé</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-branch\"><div class=\"diagram-box\" data-rough>Local user exists?<span class=\"diagram-pill ok\">yes &rarr; reuse unchanged</span><span class=\"diagram-pill accent\">no &rarr; create local user</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Émettre une session locale normale</div></div></div>",
   "css": ".diagram-jit{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-jit .diagram-node{display:flex;flex-direction:column;gap:4px;padding:12px 14px}.diagram-jit .diagram-branch{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-jit .diagram-box{display:flex;flex-direction:column;gap:6px;padding:12px 14px}.diagram-jit .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```

package/docs/content/locales/fr-FR/database.md CHANGED Viewed

@@ -31,7 +31,7 @@ DATABASE_URL=postgres://user:pass@ep-cool-name-123456.us-east-2.aws.neon.tech/my
 # Supabase Postgres
 DATABASE_URL=postgres://postgres.xxxx:pass@aws-0-us-east-1.pooler.supabase.com:6543/postgres
-# Plain Postgres
+# Postgres simple
 DATABASE_URL=postgres://user:pass@localhost:5432/mydb
 # Turso (libSQL)
@@ -89,7 +89,7 @@ export const tasks = table("tasks", {
 Le tableau `tasks` ci-dessus définit les mêmes colonnes sur chaque backend :
-```an-schema title="The tasks table" summary="Defined once with the framework helpers; the dialect is chosen at runtime from DATABASE_URL."
+```an-schema title="Le tableau des tâches" summary="Définie une seule fois avec les helpers du framework ; le dialecte est choisi à l’exécution à partir de DATABASE_URL."
 {
   "entities": [
     {
@@ -168,9 +168,9 @@ Au lieu de pousser directement, les modifications de schéma doivent être appli
   "language": "ts",
   "code": "import { runMigrations } from \"@agent-native/core/db\";\n\nexport default runMigrations(\n  [\n    {\n      version: 1,\n      sql: `ALTER TABLE projects ADD COLUMN IF NOT EXISTS sort_order INTEGER NOT NULL DEFAULT 0`,\n    },\n    {\n      // Dialect-gated: runs only on the matching backend. Omit the other key\n      // to make it a no-op on that dialect.\n      version: 2,\n      sql: {\n        postgres: `ALTER TABLE projects ADD COLUMN IF NOT EXISTS tsv tsvector`,\n        sqlite: `SELECT 1`, // no-op; tsvector is Postgres-only\n      },\n    },\n  ],\n  { table: \"my_app_migrations\" },\n);",
   "annotations": [
-    { "lines": "6-7", "label": "Additive only", "note": "`ADD COLUMN IF NOT EXISTS` is safe to re-run and never drops data. Renames look like drop+create to Drizzle, so add-then-migrate instead." },
-    { "lines": "13-16", "label": "Dialect gating", "note": "Pass an object keyed by dialect to run different SQL per backend. Make the other key a no-op (`SELECT 1`) for Postgres-only or SQLite-only features." },
-    { "lines": "19", "label": "Per-app version table", "note": "Each app tracks its own applied versions so migrations are idempotent across restarts and instances." }
+    { "lines": "6-7", "label": "Additif uniquement", "note": "`ADD COLUMN IF NOT EXISTS` peut être réexécuté en toute sécurité et ne perd jamais de données. Les noms ressemblent à drop+create en Drizzle, alors ajoutez-puis-migrez à la place." },
+    { "lines": "13-16", "label": "Ouverture de dialecte", "note": "Passez un objet indexé par dialecte pour exécuter un SQL différent selon le backend. Rendez l’autre clé no-op (`SELECT 1`) pour les fonctionnalités propres à Postgres ou à SQLite." },
+    { "lines": "19", "label": "Tableau des versions par application", "note": "Chaque application suit ses propres versions appliquées afin que les migrations soient idempotentes lors des redémarrages et des instances." }
   ]
 }
 ```

package/docs/content/locales/fr-FR/deployment.md CHANGED Viewed

@@ -30,7 +30,7 @@ Chaque application est construite avec `APP_BASE_PATH=/<name>` et `VITE_APP_BASE
 ```an-diagram title="Une origine, de nombreuses applications" summary="Chaque application d'espace de travail est créée avec son propre chemin de base et montée sous un préfixe de chemin sur une seule origine. Ainsi, la connexion et l'application inter-application A2A sont de même origine et gratuites."
 {
-  "html": "<div class=\"diagram-ws\"><div class=\"diagram-panel\" data-rough><strong>https://your-agents.com</strong><div class=\"diagram-row\"><span class=\"diagram-pill accent\">/mail/*</span><small class=\"diagram-muted\">apps/mail</small></div><div class=\"diagram-row\"><span class=\"diagram-pill accent\">/calendar/*</span><small class=\"diagram-muted\">apps/calendar</small></div><div class=\"diagram-row\"><span class=\"diagram-pill accent\">/forms/*</span><small class=\"diagram-muted\">apps/forms</small></div></div><div class=\"diagram-col wins\"><span class=\"diagram-pill ok\">shared login session</span><span class=\"diagram-pill ok\">zero-config cross-app A2A</span></div></div>",
+  "html": "<div class=\"diagram-ws\"><div class=\"diagram-panel\" data-rough><strong>https://your-agents.com</strong><div class=\"diagram-row\"><span class=\"diagram-pill accent\">/mail/*</span><small class=\"diagram-muted\">apps/mail</small></div><div class=\"diagram-row\"><span class=\"diagram-pill accent\">/calendar/*</span><small class=\"diagram-muted\">apps/calendar</small></div><div class=\"diagram-row\"><span class=\"diagram-pill accent\">/forms/*</span><small class=\"diagram-muted\">apps/forms</small></div></div><div class=\"diagram-col wins\"><span class=\"diagram-pill ok\">shared login session</span><span class=\"diagram-pill ok\">A2A inter-apps sans configuration</span></div></div>",
   "css": ".diagram-ws{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.diagram-ws .diagram-panel{display:flex;flex-direction:column;gap:6px;padding:14px 16px}.diagram-ws .diagram-row{display:flex;align-items:center;gap:8px}.diagram-ws .wins{display:flex;flex-direction:column;gap:8px;align-items:flex-start}"
 }
 ```
@@ -85,7 +85,7 @@ La sortie est autonome : copiez `.output/` dans n'importe quel environnement et
 ```an-diagram title="Construire pour déployer" summary="Une arborescence source se construit selon un préréglage Nitro ; la même sortie autonome s'exécute sur Node, Vercel, Netlify, Cloudflare, AWS ou Deno. Chaque instance pointe vers le même DATABASE_URL persistant."
 {
-  "html": "<div class=\"diagram-deploy\"><div class=\"diagram-box\" data-rough>App source</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">build</span><small class=\"diagram-muted\">Nitro preset</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><span class=\"diagram-pill\">Node.js</span><span class=\"diagram-pill\">Vercel</span><span class=\"diagram-pill\">Netlify</span><span class=\"diagram-pill\">Cloudflare</span><span class=\"diagram-pill\">AWS Lambda</span><span class=\"diagram-pill\">Deno</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Persistent DATABASE_URL<br><small class=\"diagram-muted\">shared by every instance</small></div></div>",
+  "html": "<div class=\"diagram-deploy\"><div class=\"diagram-box\" data-rough>Source de l’app</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">build</span><small class=\"diagram-muted\">Nitro preset</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><span class=\"diagram-pill\">Node.js</span><span class=\"diagram-pill\">Vercel</span><span class=\"diagram-pill\">Netlify</span><span class=\"diagram-pill\">Cloudflare</span><span class=\"diagram-pill\">AWS Lambda</span><span class=\"diagram-pill\">Deno</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>DATABASE_URL persistante<br><small class=\"diagram-muted\">shared by every instance</small></div></div>",
   "css": ".diagram-deploy{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-deploy .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px 16px}.diagram-deploy .diagram-arrow{font-size:22px;line-height:1}.diagram-deploy .diagram-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:8px}"
 }
 ```
@@ -137,8 +137,8 @@ RUN pnpm build
 FROM node:24-slim
 WORKDIR /app
 COPY --from=build /app/.output .output
-# data/ is a runtime-created SQLite directory — do not copy a dev DB into prod.
-# For production, set DATABASE_URL to a hosted Postgres or Turso instance.
+# data/ est un répertoire SQLite créé au moment de l'exécution — ne copiez pas une base de données de développement dans prod.
+# Pour la production, définissez DATABASE_URL sur une instance hébergée de Postgres ou Turso.
 RUN mkdir -p /app/data
 ENV PORT=3000
 EXPOSE 3000
@@ -345,4 +345,4 @@ 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 via 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).
+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).

package/docs/content/locales/fr-FR/dispatch.md CHANGED Viewed

@@ -13,7 +13,7 @@ Sans Dispatch, chaque application dans un espace de travail multi-applications f
 ```an-diagram title="Dispatch comme plan de contrôle de l'espace de travail" summary="Une boîte de réception, un coffre-fort, une passerelle MCP et des ressources partagées se trouvent devant les applications de domaine, que Dispatch atteint en tant que pairs A2A."
 {
-  "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>",
+  "html": "<div class=\"dsp-hub\"><div class=\"diagram-node\">Users &amp; external agents<br><small class=\"diagram-muted\">Slack · e-mail · 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\">Boîte de réception centrale</span><span class=\"diagram-pill\">Coffre des secrets</span><span class=\"diagram-pill\">Délégation inter-apps</span><span class=\"diagram-pill\">MCP gateway</span><span class=\"diagram-pill\">Ressources d’espace de travail</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}"
 }
 ```
@@ -66,7 +66,7 @@ Dispatch peut être le connecteur MCP unique pour les agents externes : ajoutez
 {
   "method": "POST",
   "path": "/_agent-native/mcp",
-  "summary": "Unified MCP gateway endpoint",
+  "summary": "Point de terminaison de passerelle MCP unifiée",
   "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": [
@@ -112,7 +112,7 @@ Parcourez un exemple de bout en bout. Un utilisateur envoie un message privé au
 ```an-diagram title="Un message Slack via Dispatch" summary="Slack est mis en file d'attente dans SQL, une nouvelle exécution le draine, l'agent Dispatch délègue le travail de domaine sur A2A et la réponse revient dans le thread d'origine. Une nouvelle tentative de 60 s récupère tout ce qui meurt en plein vol."
 {
-  "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>",
+  "html": "<div class=\"dsp-flow\"><div class=\"dsp-row\"><div class=\"diagram-node\">DM Slack<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\">vérifie + INSERT tâche en attente</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\">revendique la tâche · démarre la boucle agent</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\">L’agent Dispatch décide</span><small class=\"diagram-muted\">analytics intent &rarr; call-agent</small></div></div><div class=\"dsp-row\"><div class=\"diagram-box\" data-rough>App d’analyse<br><small class=\"diagram-muted\">pair A2A · exécute le travail SQL</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}"
 }
 ```

package/docs/content/locales/fr-FR/drop-in-agent.md CHANGED Viewed

@@ -23,13 +23,13 @@ Vous n'avez pas besoin de créer un agent natif à partir de zéro. Le chat de l
 | `<AgentChatSurface>`  | Une surface de discussion panneau/page pré-câblée                                                                       | Vous souhaitez discuter sans le wrapper de la barre latérale                            |
 | `<AssistantChat>`     | Rendu de chat de niveau inférieur avec crochets de composition/historique                                               | Vous avez besoin d'un chrome personnalisé autour de la conversation standard UI         |
 | `sendToAgentChat()`   | Envoyer un message au chat par programmation                                                                            | Un bouton qui confie le travail à l'agent au lieu de l'exécuter en ligne                |
-| `useActionMutation()` | Wrapper frontal Typesafe autour d'une action                                                                            | Le UI doit exécuter la même opération qu'un outil d'agent exécuterait                   |
+| `useActionMutation()` | Emballage frontal Typesafe autour d'une action                                                                          | Le UI doit exécuter la même opération qu'un outil d'agent exécuterait                   |
 Tous ces éléments sont exportés depuis `@agent-native/core/client`.
 ```an-diagram title="Le modèle de monture" summary="<AgentSidebar> enveloppe votre mise en page existante. Vos itinéraires s'affichent dans la zone principale ; le panneau d'agent se monte à côté d'eux. <AgentPanel> est le même panneau sans le 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>",
+  "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\">Votre application<br><small class=\"diagram-muted\">children: header + &lt;Outlet/&gt;</small></div><div class=\"diagram-node panel\">Panneau de l’agent<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}"
 }
 ```
@@ -44,13 +44,13 @@ les enfants restent dans la zone principale de l'application. Le chat de l'agent
 {
   "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}",
+  "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=\"Comment puis-je aider ?\"\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." }
+    { "lines": "6", "label": "Emballage", "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": "Invites de démarrage", "note": "`suggestions` s’affiche sous forme de puces cliquables sur le chat vide." },
+    { "lines": "13", "label": "Puces contextuelles", "note": "`dynamicSuggestions` merges screen-aware prompts (e.g. \"Summarize this selection\") with your static ones. On by default." },
+    { "lines": "18-20", "label": "Bouton bascule", "note": "Put `<AgentToggleButton />` anywhere in your header to open and close the panel." },
+    { "lines": "22-24", "label": "Votre application", "note": "`<Outlet/>` (your routes) renders in the main area, untouched." }
   ]
 }
 ```
@@ -174,7 +174,7 @@ vous avez construit ailleurs, déposez une couche — mais continuez à laisser
   `<AssistantChat runtime={...} />`. Les connecteurs
   (`createHttpAgentChatRuntime()` et le OpenAI / Claude / Vercel AI / AG-UI
   aides) et le contrat d'événement sont documentés dans
-  [Native Chat UI — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes).
+  [Native Interface de chat — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes).
 Quelle que soit la couche que vous choisissez, conservez l'état des applications soutenues par actions et SQL comme contrat,
 et évitez de publier directement sur `/_agent-native/agent-chat` à partir du produit UI. Si un

package/docs/content/locales/fr-FR/durable-resume.md CHANGED Viewed

@@ -15,7 +15,7 @@ Un CV durable comble cet écart. À la reprise, le framework sait quels appels d
 ```an-diagram title="Deux couches bloquent les effets secondaires en double lors de la reprise" summary="Le journal lit le grand livre durable et classe les appels antérieurs ; la couche 1 indique au modèle, la couche 2 bloque en dur une écriture redistribuée qui correspond à une entrée terminée."
 {
-  "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>",
+  "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\">Couche 2 · écriture re-dispatchée avec blocage dur</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}"
 }
 ```

package/docs/content/locales/fr-FR/embedding-sdk.md CHANGED Viewed

@@ -13,7 +13,7 @@ side-car intégré ou application complète, commencez par
 ```an-diagram title="La membrane d'encastrement" summary="L'application hôte fournit l'authentification côté serveur et le contexte de la page en direct ; Agent-Native exécute le side-car durable et atteint l'onglet ouvert via les actions du client et les commandes de l'hôte."
 {
-  "html": "<div class=\"diagram-embed\"><div class=\"diagram-box\" data-rough><strong>Host SaaS app</strong><small class=\"diagram-muted\">your UI, your auth</small></div><div class=\"diagram-col\"><div class=\"diagram-pill accent\">getContext &rarr;</div><div class=\"diagram-pill\">&larr; client actions</div><div class=\"diagram-pill\">&larr; host commands</div></div><div class=\"diagram-panel center\" data-rough><strong>Agent-Native sidecar</strong><small class=\"diagram-muted\">durable chat · app state · extensions</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>SQL<br><small class=\"diagram-muted\">framework tables</small></div></div>",
+  "html": "<div class=\"diagram-embed\"><div class=\"diagram-box\" data-rough><strong>App SaaS hôte</strong><small class=\"diagram-muted\">votre UI, votre auth</small></div><div class=\"diagram-col\"><div class=\"diagram-pill accent\">getContext &rarr;</div><div class=\"diagram-pill\">&larr; actions client</div><div class=\"diagram-pill\">&larr; commandes hôte</div></div><div class=\"diagram-panel center\" data-rough><strong>Agent-Native sidecar</strong><small class=\"diagram-muted\">chat durable · état de l’app · extensions</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>SQL<br><small class=\"diagram-muted\">tables du framework</small></div></div>",
   "css": ".diagram-embed{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-embed .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-embed .diagram-arrow{font-size:22px;line-height:1}.diagram-embed .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
@@ -147,7 +147,7 @@ uniquement lorsque cela correspond mieux à votre situation :
 | Mode                                   | Utilisez-le quand                                                                                                                                     | Forfait                                             |
 | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
 | **Sélecteur d'applications intégrées** | Lancement d'une application Agent-Native complète en tant qu'iframe ciblée (sélecteur d'actifs, générateur de formulaires, panneau d'approbation).    | `@agent-native/embedding`                           |
-| **Pont hôte `<AgentNative>`**          | Applications side-car autonomes ou iframes d'origine croisée qui relient manuellement le contexte de la page et le client actions.                    | `@agent-native/core/client`                         |
+| **Pont hôte `<AgentNative>`**          | Applications side-car autonomes ou iframes d'origine croisée qui relient manuellement le contexte de la page et le actions client.                    | `@agent-native/core/client`                         |
 | **Extensions portables**               | Permettre aux utilisateurs hôtes de créer des mini-applications en bac à sable lorsque le SaaS possède déjà le stockage/l'approbation des extensions. | Emplacement d'extension `@agent-native/core/client` |
 Le package `@agent-native/embedding` de niveau inférieur expose :
@@ -247,7 +247,7 @@ for await (const chunk of sendMessage(
 > Le plugin ci-dessus avec piles incluses est préférable. Utilisez ce pont de niveau inférieur
 > uniquement pour les applications side-car autonomes ou les iframes d'origine croisée dans lesquels vous câblez la page
-> contexte et client actions vous-même.
+> contexte et actions client vous-même.
 Pour les applications side-car autonomes ou les iframes d'origine croisée, utilisez le `<AgentNative />` de niveau inférieur. Il restitue le contexte de la page side-car et des fils iframe, le client en direct actions et les commandes d'actualisation/navigation de l'hôte en un seul endroit :
@@ -375,7 +375,7 @@ Pour un collègue de style CLAW, l'iframe peut également enregistrer son onglet
 ```an-diagram title="Pont de session de navigateur géré par le serveur" summary="Un outil backend met le travail en file d'attente ; l'onglet enregistré le revendique, l'exécute sur la page en direct et le résultat est renvoyé à l'agent — afin qu'un agent backend/Slack/A2A puisse toujours toucher l'onglet ouvert."
 {
-  "html": "<div class=\"diagram-bridge\"><div class=\"diagram-node\" data-rough>Backend agent<br><small class=\"diagram-muted\">chat · Slack · A2A</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>enqueue request<br><small class=\"diagram-muted\">/_agent-native/browser-sessions</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>Live tab claims it<br><small class=\"diagram-muted\">registered bridge</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">result &rarr; agent</div></div>",
+  "html": "<div class=\"diagram-bridge\"><div class=\"diagram-node\" data-rough>Agent backend<br><small class=\"diagram-muted\">discussion · Slack · A2A</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>enqueue request<br><small class=\"diagram-muted\">/_agent-native/browser-sessions</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>L’onglet actif le réclame<br><small class=\"diagram-muted\">registered bridge</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">result &rarr; agent</div></div>",
   "css": ".diagram-bridge{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-bridge .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -422,7 +422,7 @@ Il existe deux classes d'actions :
 Le backend actions doit être le serveur par défaut pour tout ce qui doit survivre aux actualisations, aux navigateurs fermés, aux tentatives ou aux exécutions déclenchées par l'intégration. Ils appartiennent à la couche d'action/outil Agent-Native normale de l'application side-car, où l'agent peut les appeler à partir du chat, des automatisations, des intégrations Slack/Telegram/e-mail et des tâches en arrière-plan.
-Le client actions constitue un pont actif vers un onglet de navigateur. L'hôte les annonce avec `source: "client"` et `availability: "browser-session"`, et le side-car doit traiter ce manifeste comme temporaire. Ré-listez actions lorsque l'itinéraire ou la sélection change, et revenez au backend actions lorsque l'onglet disparaît.
+Le actions client constitue un pont actif vers un onglet de navigateur. L'hôte les annonce avec `source: "client"` et `availability: "browser-session"`, et le side-car doit traiter ce manifeste comme temporaire. Ré-listez actions lorsque l'itinéraire ou la sélection change, et revenez au backend actions lorsque l'onglet disparaît.
 ### Extensions portables
@@ -548,9 +548,9 @@ Modèle de sécurité :
 ### Sessions et onglets
-Le pont hôte est limité à une paire iframe/fenêtre hôte. Si le même utilisateur ouvre plusieurs onglets, chaque onglet possède son propre `session`, son propre contexte, sa sélection, son client actions et ses propres réponses de commande en attente. Ne présumez pas qu'une action client découverte dans un onglet peut s'exécuter dans un autre onglet, ou qu'elle existera toujours après la navigation.
+Le pont hôte est limité à une paire iframe/fenêtre hôte. Si le même utilisateur ouvre plusieurs onglets, chaque onglet possède son propre `session`, son propre contexte, sa sélection, son actions client et ses propres réponses de commande en attente. Ne présumez pas qu'une action client découverte dans un onglet peut s'exécuter dans un autre onglet, ou qu'elle existera toujours après la navigation.
-Pour les produits multi-onglets, conservez l'état durable dans SQL/backend actions et utilisez le client actions uniquement pour les parties locales des onglets : focalisation d'une ligne, copie de l'état visible de l'éditeur, sélection d'un élément de canevas ou actualisation du cache de requête React actuel. Incluez suffisamment de contexte `route`, `resource` et `selection` pour que le side-car décide si l'onglet actuel est le bon endroit pour exécuter une action de session de navigateur.
+Pour les produits multi-onglets, conservez l'état durable dans SQL/backend actions et utilisez le actions client uniquement pour les parties locales des onglets : focalisation d'une ligne, copie de l'état visible de l'éditeur, sélection d'un élément de canevas ou actualisation du cache de requête React actuel. Incluez suffisamment de contexte `route`, `resource` et `selection` pour que le side-car décide si l'onglet actuel est le bon endroit pour exécuter une action de session de navigateur.
 ### Modèle de commande