@agent-native/core 0.79.25 → 0.79.27

package/corpus/core/docs/content/locales/fr-FR/processors.mdx

@@ -7,13 +7,50 @@ description: "Crochets d'observateur/garde-corps internes à la boucle qui surve
 
 Un `Processor` est un **observateur/garde-corps** interne à la boucle pour l'exécution de l'agent. Il surveille la sortie diffusée en continu du modèle et l'outil l'appelle _au fur et à mesure que l'exécution progresse_, conserve son propre état de travail et peut **abandonner** l'exécution avant qu'un « terminé » ne soit revendiqué. Il s'agit de la condition structurelle préalable aux garde-fous en temps réel (bloquer les sorties interdites à mi-parcours) et à une porte de preuve de réalisation/de couverture (inspecter ce que le modèle est sur le point de faire et l'arrêter).
 
-```an-diagram title="Où les trois crochets tirent en courant" summary="processOutputStream surveille chaque morceau, processOutputStep appelle les outils par réponse, processOutputResult enregistre un verdict à la fin. N'importe quel hook peut abandonner avec un TripWire."
-{
-  "html": "<div class=\"diagram-proc\"><div class=\"diagram-node\" data-rough>stream chunks<br><small class=\"diagram-muted\">processOutputStream</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>per model response<br><small class=\"diagram-muted\">processOutputStep — contrôle les appels d’outils</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>run end<br><small class=\"diagram-muted\">processOutputResult — décision</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-pill warn\">abort() &rarr; TripWire &rarr; tripwire event</div></div>",
-  "css": ".diagram-proc{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-proc .diagram-arrow{font-size:22px;line-height:1}.diagram-proc .diagram-pill{flex-basis:100%}"
+<Diagram id="doc-block-17fm1db" title={"Où les trois crochets tirent en courant"} summary={"processOutputStream surveille chaque morceau, processOutputStep appelle les outils par réponse, processOutputResult enregistre un verdict à la fin. N'importe quel hook peut abandonner avec un TripWire."}>
+
+```html
+<div class="diagram-proc">
+  <div class="diagram-node" data-rough>
+    stream chunks<br /><small class="diagram-muted">processOutputStream</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node" data-rough>
+    per model response<br /><small class="diagram-muted"
+      >processOutputStep — contrôle les appels d’outils</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node" data-rough>
+    run end<br /><small class="diagram-muted"
+      >processOutputResult — décision</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-pill warn">
+    abort() &rarr; TripWire &rarr; tripwire event
+  </div>
+</div>
+```
+
+```css
+.diagram-proc {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+.diagram-proc .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-proc .diagram-pill {
+  flex-basis: 100%;
 }
 ```
 
+</Diagram>
+
 > [!WARNING]
 > Un processeur est une **configuration**, pas un outil, pas une action, ni une création DSL. Les processeurs observent et modifient uniquement leur propre état de flux et `abort()`. Ils ne définissent jamais le comportement de l'application, ne remplacent jamais actions et n'apparaissent jamais dans le modèle. Les opérations d'application appartiennent à [actions](/docs/actions).
 

package/corpus/core/docs/content/locales/fr-FR/progress.mdx

@@ -41,13 +41,55 @@ Préoccupation distincte de [notifications](/docs/notifications) : les notifica
 | `failed`    | Terminal d'erreur               |
 | `cancelled` | Utilisateur interrompu          |
 
-```an-diagram title="Exécuter le cycle de vie" summary="startRun ouvre une ligne en cours d'exécution ; updateRunProgress le corrige ; completeRun le déplace vers un état de terminal et tamponne completed_at."
-{
-  "html": "<div class=\"diagram-run\"><div class=\"diagram-box\" data-rough>startRun()</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel running\" data-rough><span class=\"diagram-pill accent\">running</span><small class=\"diagram-muted\">updateRunProgress() &#8635; percent + step</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col terminal\"><span class=\"diagram-pill ok\">succeeded</span><span class=\"diagram-pill warn\">failed</span><span class=\"diagram-pill\">cancelled</span><small class=\"diagram-muted\">completeRun() &rarr; sets completed_at</small></div></div>",
-  "css": ".diagram-run{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-run .diagram-panel{display:flex;flex-direction:column;gap:6px;padding:12px 16px}.diagram-run .terminal{display:flex;flex-direction:column;gap:6px;align-items:flex-start}.diagram-run .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-verg77" title={"Exécuter le cycle de vie"} summary={"startRun ouvre une ligne en cours d'exécution ; updateRunProgress le corrige ; completeRun le déplace vers un état de terminal et tamponne completed_at."}>
+
+```html
+<div class="diagram-run">
+  <div class="diagram-box" data-rough>startRun()</div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel running" data-rough>
+    <span class="diagram-pill accent">running</span
+    ><small class="diagram-muted"
+      >updateRunProgress() &#8635; percent + step</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-col terminal">
+    <span class="diagram-pill ok">succeeded</span
+    ><span class="diagram-pill warn">failed</span
+    ><span class="diagram-pill">cancelled</span
+    ><small class="diagram-muted">completeRun() &rarr; sets completed_at</small>
+  </div>
+</div>
+```
+
+```css
+.diagram-run {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-run .diagram-panel {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 12px 16px;
+}
+.diagram-run .terminal {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  align-items: flex-start;
+}
+.diagram-run .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 Les états des terminaux sont définis `completed_at`. Le bac UI affiche uniquement les lignes `running` ; les lignes complétées restent dans la base de données pour les requêtes `action=list`.
 
 ## API {#api}

package/corpus/core/docs/content/locales/fr-FR/pure-agent-apps.mdx

@@ -12,13 +12,57 @@ mesures quotidiennes vers Slack" — et l'agent agit et renvoie le résultat où
 appartient. C'est toujours une vraie application : actions, sessions, état de l'application, historique,
 les paramètres, les informations d'identification et les enregistrements de partage sont tous présents dans SQL.
 
-```an-diagram title="La boucle app-agent est la porte d’entrée" summary="De nombreux points d'entrée atteignent une boucle d'agent via les actions et l'état SQL-backed ; les résultats reviennent d'où que vient la demande. L'interface utilisateur est ajoutée uniquement lorsque des humains doivent superviser."
-{
-  "html": "<div class=\"diagram-pure\"><div class=\"diagram-col\"><div class=\"diagram-pill\">Terminal</div><div class=\"diagram-pill\">Slack · e-mail</div><div class=\"diagram-pill\">Tâche planifiée</div><div class=\"diagram-pill\">Another agent (A2A)</div><div class=\"diagram-pill\">Chat</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\">Boucle agent d’app</span><small class=\"diagram-muted\">actions · sessions · état d’app en SQL</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Le résultat revient<br><small class=\"diagram-muted\">to where it belongs</small></div></div>",
-  "css": ".diagram-pure{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-pure .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-pure .diagram-arrow{font-size:22px;line-height:1}.diagram-pure .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+<Diagram id="doc-block-bmd6at" title={"La boucle app-agent est la porte d’entrée"} summary={"De nombreux points d'entrée atteignent une boucle d'agent via les actions et l'état SQL-backed ; les résultats reviennent d'où que vient la demande. L'interface utilisateur est ajoutée uniquement lorsque des humains doivent superviser."}>
+
+```html
+<div class="diagram-pure">
+  <div class="diagram-col">
+    <div class="diagram-pill">Terminal</div>
+    <div class="diagram-pill">Slack · e-mail</div>
+    <div class="diagram-pill">Tâche planifiée</div>
+    <div class="diagram-pill">Another agent (A2A)</div>
+    <div class="diagram-pill">Chat</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">Boucle agent d’app</span
+    ><small class="diagram-muted">actions · sessions · état d’app en SQL</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box" data-rough>
+    Le résultat revient<br /><small class="diagram-muted"
+      >to where it belongs</small
+    >
+  </div>
+</div>
+```
+
+```css
+.diagram-pure {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-pure .diagram-col {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.diagram-pure .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-pure .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
 }
 ```
 
+</Diagram>
+
 Atteignez cette forme lorsque le travail s'exécute en arrière-plan, la sortie quitte le
 , le domaine est unique ou vous êtes en train de créer un prototype. L'agent a toujours besoin d'un UI —
 pas un tableau de bord, mais un endroit où les humains peuvent le superviser, le configurer et le piloter —

package/corpus/core/docs/content/locales/fr-FR/real-time-collaboration.mdx

@@ -36,13 +36,58 @@ Ceci s'appuie sur trois technologies éprouvées : **Yjs** (CRDT pour une fusio
 
 Le système de collaboration comporte cinq couches imbriquées.
 
-```an-diagram title="Cinq couches imbriquées" summary="Du CRDT en mémoire au transport qui transporte les mises à jour entre les pairs, chaque couche a une tâche."
-{
-  "html": "<div class=\"diagram-stack\"><div class=\"diagram-card layer\"><span class=\"diagram-pill accent\">1 &middot; Yjs Y.Doc</span><small class=\"diagram-muted\">CRDT &mdash; fusion sans conflit, sans coordinateur</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">2 &middot; Contenu canonique SQL</span><small class=\"diagram-muted\">_collab_docs &mdash; durable source of truth, versioned</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">3 &middot; réconciliation contrôlée par updatedAt</span><small class=\"diagram-muted\">les modifications de l’agent se propagent via le bump SQL</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">4 &middot; Élection du client leader</span><small class=\"diagram-muted\">un seul onglet applique l’instantané</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill ok\">5 &middot; chemin rapide SSE + polling</span><small class=\"diagram-muted\">~quelques dizaines de ms, retombe sur un polling de 2 s partout</small></div></div>",
-  "css": ".diagram-stack{display:flex;flex-direction:column;gap:8px}.diagram-stack .layer{display:flex;flex-direction:column;gap:4px;padding:12px 14px}"
+<Diagram id="doc-block-a2h5v7" title={"Cinq couches imbriquées"} summary={"Du CRDT en mémoire au transport qui transporte les mises à jour entre les pairs, chaque couche a une tâche."}>
+
+```html
+<div class="diagram-stack">
+  <div class="diagram-card layer">
+    <span class="diagram-pill accent">1 &middot; Yjs Y.Doc</span
+    ><small class="diagram-muted"
+      >CRDT &mdash; fusion sans conflit, sans coordinateur</small
+    >
+  </div>
+  <div class="diagram-card layer">
+    <span class="diagram-pill">2 &middot; Contenu canonique SQL</span
+    ><small class="diagram-muted"
+      >_collab_docs &mdash; durable source of truth, versioned</small
+    >
+  </div>
+  <div class="diagram-card layer">
+    <span class="diagram-pill"
+      >3 &middot; réconciliation contrôlée par updatedAt</span
+    ><small class="diagram-muted"
+      >les modifications de l’agent se propagent via le bump SQL</small
+    >
+  </div>
+  <div class="diagram-card layer">
+    <span class="diagram-pill">4 &middot; Élection du client leader</span
+    ><small class="diagram-muted">un seul onglet applique l’instantané</small>
+  </div>
+  <div class="diagram-card layer">
+    <span class="diagram-pill ok">5 &middot; chemin rapide SSE + polling</span
+    ><small class="diagram-muted"
+      >~quelques dizaines de ms, retombe sur un polling de 2 s partout</small
+    >
+  </div>
+</div>
+```
+
+```css
+.diagram-stack {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.diagram-stack .layer {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 12px 14px;
 }
 ```
 
+</Diagram>
+
 ### 1. Yjs Y.Doc (couche CRDT)
 
 Chaque document collaboratif est un `Y.Doc` contenant des types partagés (généralement un
@@ -100,13 +145,67 @@ cycle.
 
 Les erreurs réseau utilisent un intervalle exponentiel avec gigue, plafonné à environ 15 s.
 
-```an-diagram title="Deux chemins d'édition, un de fusion" summary="Les frappes humaines circulent Y.Doc → serveur → SSE. Les modifications de l'agent passent par SQL : l'action est déplacée vers updateAt, le client principal se réconcilie, puis la modification entre à nouveau dans Yjs."
-{
-  "html": "<div class=\"diagram-collab\"><div class=\"lane\"><span class=\"diagram-pill\">Modification humaine</span><div class=\"diagram-node\">Y.Doc update<br><small class=\"diagram-muted\">debounce ~80 ms</small></div><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\" data-rough>POST /update<br><small class=\"diagram-muted\">apply + persist</small></div><span class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box diagram-accent\">SSE push<br><small class=\"diagram-muted\">to all peers</small></div></div><div class=\"lane\"><span class=\"diagram-pill warn\">Modification agent</span><div class=\"diagram-node\">L’action écrit SQL<br><small class=\"diagram-muted\">met à jour updatedAt</small></div><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\" data-rough>Client principal<br><small class=\"diagram-muted\">setContent dans Y.Doc</small></div><span class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box diagram-accent\">POST /update<br><small class=\"diagram-muted\">re-enters Yjs &middot; SSE push</small></div></div></div>",
-  "css": ".diagram-collab{display:flex;flex-direction:column;gap:14px}.diagram-collab .lane{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-collab .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-1k569ij" title={"Deux chemins d'édition, un de fusion"} summary={"Les frappes humaines circulent Y.Doc → serveur → SSE. Les modifications de l'agent passent par SQL : l'action est déplacée vers updateAt, le client principal se réconcilie, puis la modification entre à nouveau dans Yjs."}>
+
+```html
+<div class="diagram-collab">
+  <div class="lane">
+    <span class="diagram-pill">Modification humaine</span>
+    <div class="diagram-node">
+      Y.Doc update<br /><small class="diagram-muted">debounce ~80 ms</small>
+    </div>
+    <span class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</span>
+    <div class="diagram-box" data-rough>
+      POST /update<br /><small class="diagram-muted">apply + persist</small>
+    </div>
+    <span class="diagram-arrow diagram-accent" aria-hidden="true">&rarr;</span>
+    <div class="diagram-box diagram-accent">
+      SSE push<br /><small class="diagram-muted">to all peers</small>
+    </div>
+  </div>
+  <div class="lane">
+    <span class="diagram-pill warn">Modification agent</span>
+    <div class="diagram-node">
+      L’action écrit SQL<br /><small class="diagram-muted"
+        >met à jour updatedAt</small
+      >
+    </div>
+    <span class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</span>
+    <div class="diagram-box" data-rough>
+      Client principal<br /><small class="diagram-muted"
+        >setContent dans Y.Doc</small
+      >
+    </div>
+    <span class="diagram-arrow diagram-accent" aria-hidden="true">&rarr;</span>
+    <div class="diagram-box diagram-accent">
+      POST /update<br /><small class="diagram-muted"
+        >re-enters Yjs &middot; SSE push</small
+      >
+    </div>
+  </div>
+</div>
+```
+
+```css
+.diagram-collab {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+}
+.diagram-collab .lane {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  flex-wrap: wrap;
+}
+.diagram-collab .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 ## Démarrage rapide {#quickstart}
 
 ### 1. Installer les packages

package/corpus/core/docs/content/locales/fr-FR/recurring-jobs.mdx

@@ -113,13 +113,68 @@ Summarize overnight emails.`,
 
 Le planificateur est un plugin de framework (la routine interne `processRecurringJobs()`) qui s'exécute en cours de processus : un `setInterval` se déclenche toutes les 60 secondes (avec un délai de démarrage de 10 secondes) dans le plugin de chat de l'agent, partout où le serveur est en cours d'exécution.
 
-```an-diagram title="Une coche du planificateur" summary="Toutes les 60 secondes, le planificateur recherche les tâches dues, les exécute en tant que nouveau thread d'agent et réécrit le résultat dans le fichier de tâches."
-{
-  "html": "<div class=\"sched\"><div class=\"diagram-box accent\"><code>setInterval</code> &bull; 60s &#8635;</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">1 &middot; scan</span><small class=\"diagram-muted\">list every enabled <code>jobs/*.md</code> across all owners</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">2 &middot; due?</span><small class=\"diagram-muted\">compare <code>nextRun</code> to now</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card accent\"><span class=\"diagram-pill accent\">3 &middot; run</span><small class=\"diagram-muted\">fresh agent thread, job body as the user message &mdash; actions, SQL, A2A, email</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card ok\"><span class=\"diagram-pill ok\">4 &middot; record</span><small class=\"diagram-muted\">write <code>lastRun</code> / <code>lastStatus</code> / <code>lastError</code>, recompute <code>nextRun</code></small></div></div>",
-  "css": ".sched{display:flex;flex-direction:column;gap:6px;max-width:520px}.sched .diagram-card{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.sched .diagram-box{align-self:flex-start}.sched .diagram-arrow{font-size:18px;align-self:center}"
+<Diagram id="doc-block-1fo15gx" title="Une coche du planificateur" summary={"Toutes les 60 secondes, le planificateur recherche les tâches dues, les exécute en tant que nouveau thread d'agent et réécrit le résultat dans le fichier de tâches."}>
+
+```html
+<div class="sched">
+  <div class="diagram-box accent">
+    <code>setInterval</code> &bull; 60s &#8635;
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill">1 &middot; scan</span
+    ><small class="diagram-muted"
+      >list every enabled <code>jobs/*.md</code> across all owners</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill">2 &middot; due?</span
+    ><small class="diagram-muted">compare <code>nextRun</code> to now</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card accent">
+    <span class="diagram-pill accent">3 &middot; run</span
+    ><small class="diagram-muted"
+      >fresh agent thread, job body as the user message &mdash; actions, SQL,
+      A2A, email</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-card ok">
+    <span class="diagram-pill ok">4 &middot; record</span
+    ><small class="diagram-muted"
+      >write <code>lastRun</code> / <code>lastStatus</code> /
+      <code>lastError</code>, recompute <code>nextRun</code></small
+    >
+  </div>
+</div>
+```
+
+```css
+.sched {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  max-width: 520px;
+}
+.sched .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  padding: 10px 14px;
+}
+.sched .diagram-box {
+  align-self: flex-start;
+}
+.sched .diagram-arrow {
+  font-size: 18px;
+  align-self: center;
 }
 ```
 
+</Diagram>
+
 <Callout id="doc-block-j6yn07" tone="risk">
 
 **Scale-to-zero caveat.** The scheduler is in-process, so on serverless hosts jobs only fire while an instance is warm. If reliable scheduling matters, keep an instance warm with keep-alive pings or use an always-on host (Fly, Render, a VPS).

package/corpus/core/docs/content/locales/fr-FR/routing.mdx

@@ -21,14 +21,53 @@ Les applications natives d'agent utilisent le **routeur React v8** avec un routa
 
 Préfixez un segment avec `$` pour un paramètre dynamique. Préfixez `_` pour en faire un itinéraire de tracé sans chemin (pas de segment URL). Les modèles utilisent `flatRoutes()` — le fichier de notation par points ci-dessus est principal ; le formulaire de dossier imbriqué `inbox/route.tsx` fonctionne également.
 
-```an-diagram title="La mise en page sans chemin enveloppe les pages" summary="Une disposition _app.tsx (pas de segment URL) restitue le shell partagé une fois ; les pages correspondantes s'affichent dans son <Outlet/>, de sorte que la barre latérale de l'agent ne remonte jamais lors de la navigation."
-{
-"html": "<div class=\"diagram-layout\" data-rough><div class=\"diagram-shell\"><span class=\"diagram-pill accent\">_app.tsx</span><small class=\"diagram-muted\">layout sans chemin · shell persistant + barre agent</small><div class=\"diagram-outlet\" data-rough><small class=\"diagram-muted\">&lt;Outlet/&gt; — the matched page</small><div class=\"diagram-row\"><span class=\"diagram-pill\">_index.tsx &rarr; /</span><span class=\"diagram-pill\">settings.tsx &rarr; /settings</span><span class=\"diagram-pill\">inbox.$threadId.tsx &rarr; /inbox/:threadId</span></div></div></div></div>",
-"css": ".diagram-layout .diagram-shell{display:flex;flex-direction:column;gap:8px;padding:16px}.diagram-layout .diagram-outlet{display:flex;flex-direction:column;gap:8px;padding:14px;margin-top:6px}.diagram-layout .diagram-row{display:flex;flex-wrap:wrap;gap:8px;margin-top:4px}"
-}
+<Diagram id="doc-block-chuvll" title="La mise en page sans chemin enveloppe les pages" summary={"Une disposition _app.tsx (pas de segment URL) restitue le shell partagé une fois ; les pages correspondantes s'affichent dans son <Outlet/>, de sorte que la barre latérale de l'agent ne remonte jamais lors de la navigation."}>
+
+```html
+<div class="diagram-layout" data-rough>
+  <div class="diagram-shell">
+    <span class="diagram-pill accent">_app.tsx</span
+    ><small class="diagram-muted"
+      >layout sans chemin · shell persistant + barre agent</small
+    >
+    <div class="diagram-outlet" data-rough>
+      <small class="diagram-muted">&lt;Outlet/&gt; — the matched page</small>
+      <div class="diagram-row">
+        <span class="diagram-pill">_index.tsx &rarr; /</span
+        ><span class="diagram-pill">settings.tsx &rarr; /settings</span
+        ><span class="diagram-pill"
+          >inbox.$threadId.tsx &rarr; /inbox/:threadId</span
+        >
+      </div>
+    </div>
+  </div>
+</div>
+```
 
+```css
+.diagram-layout .diagram-shell {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 16px;
+}
+.diagram-layout .diagram-outlet {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px;
+  margin-top: 6px;
+}
+.diagram-layout .diagram-row {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  margin-top: 4px;
+}
 ```
 
+</Diagram>
+
 ## Ajout d'une nouvelle page {#adding-a-page}
 
 Créez le fichier et exportez un composant par défaut :

package/corpus/core/docs/content/locales/fr-FR/sandbox-adapters.mdx

@@ -40,13 +40,53 @@ Le backend par défaut génère un processus enfant de nœud local verrouillé.
 
 En gardant le contrat étroit, un adaptateur distant hérite de la même posture de sécurité. Le processus parent conserve la propriété de tout ce qui porte secret : il construit le module sandbox, exécute le pont localhost (qui contient le contexte de la demande et applique les listes autorisées d'hôtes + les gardes SSRF), nettoie l'environnement et formate la sortie. Un adaptateur reçoit uniquement une source de module **non secrète** déjà préparée ainsi que les limites de ressources — il est uniquement responsable de son _exécution_ et de la capture de l'état stdout/stderr/exit.
 
-```an-diagram title="Le parent garde les secrets ; l'adaptateur exécute uniquement du code" summary="run-code construit le module et exécute le pont de bouclage ; l'adaptateur reçoit un module non secret + limites et renvoie stdout/stderr/exit."
-{
-  "html": "<div class=\"diagram-sandbox\"><div class=\"diagram-box\" data-rough><strong>Processus parent</strong><small class=\"diagram-muted\">construit le module · pont loopback · nettoyage env · format de sortie</small></div><div class=\"diagram-col\"><div class=\"diagram-pill accent\">non-secret module + limits &rarr;</div><div class=\"diagram-pill ok\">&larr; stdout / stderr / exitCode</div><div class=\"diagram-pill\">&harr; bridge calls (127.0.0.1)</div></div><div class=\"diagram-panel center\" data-rough><strong>SandboxAdapter.run</strong><small class=\"diagram-muted\">processus enfant local · Docker · distant · durable</small></div></div>",
-  "css": ".diagram-sandbox{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-sandbox .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-sandbox .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+<Diagram id="doc-block-1l35sn9" title={"Le parent garde les secrets ; l'adaptateur exécute uniquement du code"} summary={"run-code construit le module et exécute le pont de bouclage ; l'adaptateur reçoit un module non secret + limites et renvoie stdout/stderr/exit."}>
+
+```html
+<div class="diagram-sandbox">
+  <div class="diagram-box" data-rough>
+    <strong>Processus parent</strong
+    ><small class="diagram-muted"
+      >construit le module · pont loopback · nettoyage env · format de
+      sortie</small
+    >
+  </div>
+  <div class="diagram-col">
+    <div class="diagram-pill accent">non-secret module + limits &rarr;</div>
+    <div class="diagram-pill ok">&larr; stdout / stderr / exitCode</div>
+    <div class="diagram-pill">&harr; bridge calls (127.0.0.1)</div>
+  </div>
+  <div class="diagram-panel center" data-rough>
+    <strong>SandboxAdapter.run</strong
+    ><small class="diagram-muted"
+      >processus enfant local · Docker · distant · durable</small
+    >
+  </div>
+</div>
+```
+
+```css
+.diagram-sandbox {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-sandbox .diagram-col {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.diagram-sandbox .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
 }
 ```
 
+</Diagram>
+
 ## L'interface {#interface}
 
 La couture réside dans le noyau de `packages/core/src/coding-tools/sandbox/` : `adapter.ts` (le contrat), `index.ts` (sélection : `getSandboxAdapter()` / `registerSandboxAdapter()`) et `local-child-process-adapter.ts` (la valeur par défaut). Il est câblé dans l'emballage par `run-code.ts` ; un hôte connecte un backend différent via l'assistant d'enregistrement `index.ts` (ou, pour un backend Docker, via le [blueprint](/docs/blueprint-installer) qui édite directement ces fichiers).

package/corpus/core/docs/content/locales/fr-FR/security.mdx

@@ -9,13 +9,45 @@ Les applications natives d'agent sont conçues pour être sécurisées par défa
 
 ## Ce que vous obtenez gratuitement et ce que vous possédez {#what-you-own}
 
-```an-diagram title="Défense en couches" summary="Le framework possède la majeure partie de la surface des menaces ; vous possédez deux choses : le marquage des tables pour la portée et la validation des entrées externes."
-{
-  "html": "<div class=\"sec-layers\"><div class=\"diagram-card free\"><span class=\"diagram-pill ok\">Possédé par le framework</span><small class=\"diagram-muted\">SQL isolation &middot; parameterized queries &middot; XSS escaping &middot; auth guard &middot; CSRF cookies &middot; secret encryption</small></div><div class=\"diagram-card you\"><span class=\"diagram-pill warn\">Vous en gardez le contrôle</span><small class=\"diagram-muted\">A. tag tables with ownableColumns() &amp; route through access guards<br>B. give every action a Zod schema &amp; send user URLs through the SSRF guard</small></div></div>",
-  "css": ".sec-layers{display:flex;flex-direction:column;gap:12px}.sec-layers .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px}"
+<Diagram id="doc-block-1jaem9n" title={"Défense en couches"} summary={"Le framework possède la majeure partie de la surface des menaces ; vous possédez deux choses : le marquage des tables pour la portée et la validation des entrées externes."}>
+
+```html
+<div class="sec-layers">
+  <div class="diagram-card free">
+    <span class="diagram-pill ok">Possédé par le framework</span
+    ><small class="diagram-muted"
+      >SQL isolation &middot; parameterized queries &middot; XSS escaping
+      &middot; auth guard &middot; CSRF cookies &middot; secret
+      encryption</small
+    >
+  </div>
+  <div class="diagram-card you">
+    <span class="diagram-pill warn">Vous en gardez le contrôle</span
+    ><small class="diagram-muted"
+      >A. tag tables with ownableColumns() &amp; route through access guards<br />B.
+      give every action a Zod schema &amp; send user URLs through the SSRF
+      guard</small
+    >
+  </div>
+</div>
+```
+
+```css
+.sec-layers {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+.sec-layers .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 14px 16px;
 }
 ```
 
+</Diagram>
+
 Lorsque vous vous basez sur les modèles standards, le framework gère déjà la majeure partie de la surface des menaces pour vous :
 
 - **Isolement des données** : l'agent SQL est réécrit afin qu'il ne puisse voir que les lignes de l'utilisateur actuel (et de l'organisation active). Voir [Data Scoping](#data-scoping).
@@ -122,13 +154,55 @@ La portée s'étend de la session authentifiée jusqu'au SQL exécuté par l'age
 session.orgId → AGENT_ORG_ID → SQL row scoping
 ```
 
-```an-diagram title="Le pipeline de cadrage" summary="L'agent SQL ne touche jamais directement les tables de base : il lit une vue temporaire limitée à l'identité actuelle, de sorte qu'un nom de table nu ne peut renvoyer que les lignes possédées."
-{
-  "html": "<div class=\"scope-pipe\"><div class=\"diagram-node\">Session connectée<br><small class=\"diagram-muted\">email &middot; orgId</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Request context<br><small class=\"diagram-muted\">AGENT_ORG_ID</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Temporary VIEW<br><small class=\"diagram-muted\">WHERE owner_email = ? AND org_id = ?</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node ok\">SQL de l’agent<br><small class=\"diagram-muted\">bare table names only</small></div></div>",
-  "css": ".scope-pipe{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.scope-pipe .diagram-node{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.scope-pipe .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-u1hl1o" title="Le pipeline de cadrage" summary={"L'agent SQL ne touche jamais directement les tables de base : il lit une vue temporaire limitée à l'identité actuelle, de sorte qu'un nom de table nu ne peut renvoyer que les lignes possédées."}>
+
+```html
+<div class="scope-pipe">
+  <div class="diagram-node">
+    Session connectée<br /><small class="diagram-muted"
+      >email &middot; orgId</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node">
+    Request context<br /><small class="diagram-muted">AGENT_ORG_ID</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box">
+    Temporary VIEW<br /><small class="diagram-muted"
+      >WHERE owner_email = ? AND org_id = ?</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node ok">
+    SQL de l’agent<br /><small class="diagram-muted"
+      >bare table names only</small
+    >
+  </div>
+</div>
+```
+
+```css
+.scope-pipe {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+.scope-pipe .diagram-node {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  padding: 10px 14px;
+}
+.scope-pipe .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 La session connectée contient `email` et (lorsqu'une organisation est active) `orgId`. L'infrastructure établit le contexte de requête à partir de cette session, expose l'organisation active à l'agent SQL sous le nom `AGENT_ORG_ID` et réécrit chaque requête afin qu'elle ne puisse voir que les lignes appartenant à l'identité actuelle. Le même chemin s'applique que la requête provienne du UI, d'une action ou de l'agent : l'agent ne peut pas lire les données d'une organisation dont l'utilisateur n'est pas membre.
 
 ### Portée par utilisateur (`owner_email`)