@agent-native/core 0.93.0 → 0.94.0

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

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

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

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

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

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

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

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

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

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

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

@@ -113,6 +113,7 @@ La gravité détermine le style du badge dans la liste déroulante et est transm
 | `inbox`   | Persiste dans la table `notifications` ; entraîne la cloche UI | Toujours activé – fait partie de la primitive.                        |
 | `webhook` | POST JSON vers un URL configuré                                | Var d'environnement `NOTIFICATIONS_WEBHOOK_URL` définie au démarrage. |
 
+L'e-mail, Slack et le webhook sont toujours enregistrés avec la boîte de réception. La livraison privilégie l'URL ou les destinataires des métadonnées de la notification, puis utilise la variable d'environnement correspondante. Si aucun des deux n'est défini, ce canal ne fait rien lors de l'émission.
 Le canal webhook résout les références `${keys.NAME}` dans les URL et `NOTIFICATIONS_WEBHOOK_AUTH` par rapport au [secrets](/docs/security) ad hoc du propriétaire, de sorte que la valeur brute n'entre jamais dans le contexte de l'agent. Les listes d'autorisation URL par clé sont appliquées – même règle que celle utilisée par l'outil d'automatisation `web-request`.
 
 <Diagram id="doc-block-1c0wbur" title={"Canaux et gravité"} summary={"la boîte de réception est toujours activée ; le webhook a besoin d'une variable d'environnement ; les canaux personnalisés s'enregistrent au démarrage. La gravité détermine le style du badge et est transmise à tous les canaux."}>
@@ -203,7 +204,7 @@ await notify(
 
 Enregistrez un canal personnalisé à partir de n'importe quel plugin de serveur.
 
-```ts
+```ts filename="server/plugins/notifications-slack-ops.ts"
 import { registerNotificationChannel } from "@agent-native/core/notifications";
 
 registerNotificationChannel({
@@ -274,15 +275,15 @@ interface NotificationMeta {
 
 Monté sur `/_agent-native/notifications/*` par le plugin core-routes. Toutes les routes sont limitées à l'e-mail de la session authentifiée.
 
-| Méthode  | Chemin                                              |
-| -------- | --------------------------------------------------- |
-| `GET`    | `/_agent-native/notifications?unread=true&limit=50` |
-| `GET`    | `/_agent-native/notifications/count`                |
-| `POST`   | `/_agent-native/notifications/:id/read`             |
-| `POST`   | `/_agent-native/notifications/read-all`             |
-| `DELETE` | `/_agent-native/notifications/:id`                  |
+| Méthode  | Chemin                                                         |
+| -------- | -------------------------------------------------------------- |
+| `GET`    | `/_agent-native/notifications?unread=true&limit=50&before=ISO` |
+| `GET`    | `/_agent-native/notifications/count`                           |
+| `POST`   | `/_agent-native/notifications/:id/read`                        |
+| `POST`   | `/_agent-native/notifications/read-all`                        |
+| `DELETE` | `/_agent-native/notifications/:id`                             |
 
-<Endpoint id="doc-block-1wwo0xz" title="Liste des notifications" summary={"The route behind listNotifications() — scoped to the authenticated session's email."} method="GET" path={"/_agent-native/notifications?unread=true&limit=50"} summary={"Répertorier les notifications récentes pour l'utilisateur actuel"} auth={"Authenticated session; results are scoped to the session's email."} params={[
+<Endpoint id="doc-block-1wwo0xz" title="Liste des notifications" method="GET" path={"/_agent-native/notifications?unread=true&limit=50&before=ISO"} summary={"Répertorier les notifications récentes pour l'utilisateur actuel"} auth={"Authenticated session; results are scoped to the session's email."} params={[
   {
     "name": "unread",
     "in": "query",
@@ -296,6 +297,13 @@ Monté sur `/_agent-native/notifications/*` par le plugin core-routes. Toutes le
     "type": "number",
     "required": false,
     "description": "Max rows to return."
+  },
+  {
+    "name": "before",
+    "in": "query",
+    "type": "string",
+    "required": false,
+    "description": "Curseur d'horodatage ISO — renvoie les notifications créées avant cette date pour la pagination."
   }
 ]} responses={[
   {
@@ -308,7 +316,7 @@ Monté sur `/_agent-native/notifications/*` par le plugin core-routes. Toutes le
 
 ## Composant UI {#ui}
 
-```tsx
+```tsx filename="app/components/HeaderBar.tsx"
 import { NotificationsBell } from "@agent-native/core/client/notifications";
 
 export function HeaderBar() {

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

@@ -51,8 +51,11 @@ Un `Processor` est un **observateur/garde-corps** interne à la boucle pour l'ex
 
 </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).
+<Callout id="doc-block-proc1cfg" tone="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).
+
+</Callout>
 
 ## Les crochets {#hooks}
 
@@ -133,10 +136,13 @@ await runAgentLoop({
 
 **Zéro surcharge lorsqu'il n'est pas utilisé.** La boucle construit la chaîne de processeurs uniquement lorsqu'au moins un processeur est fourni ; lorsque `processors` est omis ou vide, aucun des codes de couture ne s'exécute et la boucle reste inchangée octet par octet. Les hooks s'exécutent dans l'ordre d'enregistrement et peuvent être synchronisés ou asynchrones.
 
-> [!NOTE]
-> La couture au niveau de la boucle est le livrable aujourd'hui et peut être appelée directement par les sous-agents, A2A, MCP et les tests. Faire passer `processors` via le gestionnaire de discussion HTTP (afin qu'un résolveur par requête puisse les configurer sans appeler directement `runAgentLoop`) est une plomberie pratique qui n'est pas encore câblée : configurez les processeurs sur le site d'appel `runAgentLoop` pour l'instant.
+<Callout id="doc-block-proc1note" tone="info">
+
+La couture au niveau de la boucle est le livrable aujourd'hui et peut être appelée directement par les sous-agents, A2A, MCP et les tests. Faire passer `processors` via le gestionnaire de discussion HTTP (afin qu'un résolveur par requête puisse les configurer sans appeler directement `runAgentLoop`) est une plomberie pratique qui n'est pas encore câblée : configurez les processeurs sur le site d'appel `runAgentLoop` pour l'instant.
+
+</Callout>
 
-## Connexe
+## Et ensuite
 
 - [**Durable Resume**](/docs/durable-resume) — comment la boucle survit aux interruptions sans réexécuter les effets secondaires terminés.
 - [**Custom Agents & Teams**](/docs/agent-teams) — les sous-agents exécutent la même boucle et peuvent transporter leurs propres processeurs.

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

@@ -96,8 +96,7 @@ server/routes/
 
 Chaque itinéraire exporte un `defineEventHandler` :
 
-```ts
-// server/routes/api/health.get.ts
+```ts filename="server/routes/api/health.get.ts"
 import { defineEventHandler } from "h3";
 
 export default defineEventHandler(() => ({
@@ -137,8 +136,7 @@ Utilisez l'option `http` de l'action pour façonner l'accès HTTP direct : les a
 
 Pour un endpoint de statut en lecture seule, gardez-le comme une action :
 
-```ts
-// actions/get-status.ts
+```ts filename="actions/get-status.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -171,8 +169,7 @@ que s'est-il passé. Pour les transformations étroites côté serveur qui n'ont
 outils, historique des discussions ou état d'exécution, utilisez `completeText()` comme échappement explicite
 trappe.
 
-```ts
-// actions/classify-message.ts
+```ts filename="actions/classify-message.ts"
 import { defineAction } from "@agent-native/core/action";
 import { completeText } from "@agent-native/core/server";
 import { z } from "zod";
@@ -239,8 +236,7 @@ Actions monté par le framework s'exécute automatiquement avec le contexte de l
 
 Les plugins résident dans `server/plugins/` et s'exécutent au démarrage. Utilisez-les pour les migrations, la configuration du fournisseur, les tâches récurrentes, les adaptateurs d'intégration et la configuration du plugin framework.
 
-```ts
-// server/plugins/db.ts
+```ts filename="server/plugins/db.ts"
 import { runMigrations } from "@agent-native/core/db";
 
 export default runMigrations(
@@ -418,8 +414,11 @@ Le webhooks entrant doit être vérifié, conservé et renvoyé rapidement. Le t
 
 </Diagram>
 
-> [!WARNING]
-> Ne vous fiez pas à des promesses non attendues après avoir renvoyé une réponse : les hôtes sans serveur gèlent l'exécution. Voir [Messaging](/docs/messaging) pour la file d'attente d'intégration canonique.
+<Callout tone="warning">
+  Ne vous fiez pas à des promesses non attendues après avoir renvoyé une
+  réponse : les hôtes sans serveur gèlent l'exécution. Voir
+  [Messaging](/docs/messaging) pour la file d'attente d'intégration canonique.
+</Callout>
 
 ## Avancé : trappes d'évacuation {#advanced-escape-hatches}
 
@@ -461,3 +460,11 @@ const handler = createProductionAgentHandler({
   systemPrompt: "You are the app agent...",
 });
 ```
+
+## Et ensuite
+
+- [**Actions**](/docs/actions) — la surface d'opération par défaut ; n'utilisez une route personnalisée que si elle ne convient pas
+- [**Base de données**](/docs/database) — le modèle `getDb()`/`schema` importé par les routes personnalisées et les actions
+- [**Sécurité**](/docs/security#access-guards) — `accessFilter`/`assertAccess` et le modèle complet de portée des données
+- [**Messagerie**](/docs/messaging) — le modèle canonique de file d'attente d'intégration pour les webhooks entrants
+- [**Protocole MCP**](/docs/mcp-protocol) — le point de terminaison `/_agent-native/mcp` que ce serveur monte automatiquement

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

@@ -1,13 +1,13 @@
 ---
 title: "Partage et confidentialité"
-description: "Partage de style Google Docs, intégré au framework. Chaque ressource créée par l'utilisateur (documents, tableaux de bord, conceptions, présentations, clips, enregistrements, formulaires) obtient le même modèle privé par défaut avec un partage cohérent UI."
+description: "Un partage familier et cohérent, intégré au framework. Chaque ressource créée par l’utilisateur — documents, tableaux de bord, conceptions, présentations, clips, enregistrements et formulaires — bénéficie du même modèle privé par défaut avec une interface de partage cohérente."
 ---
 
 # Partage et confidentialité
 
 Chaque ressource qu'un utilisateur crée dans une application native d'agent (un document, un tableau de bord, une conception, une présentation, un enregistrement d'écran, une transcription de réunion, un formulaire, un lien de réservation) est **privée par défaut pour le créateur**. Les autres personnes ne le voient que lorsque le créateur le partage explicitement ou modifie sa visibilité en `org` ou `public`.
 
-Il ressemble et fonctionne comme Google Docs. Le même bouton de partage, la même boîte de dialogue, le même modèle de visibilité à trois niveaux, les mêmes subventions par utilisateur/par organisation, dans chaque modèle, sans réinvention par application.
+C'est un modèle de partage familier partout : le même bouton de partage, la même boîte de dialogue, le même modèle de visibilité à trois niveaux et les mêmes autorisations par utilisateur et par organisation, dans chaque modèle, sans réinvention par application.
 
 ## Pourquoi un modèle {#why}
 
@@ -92,7 +92,7 @@ Chaque modèle qui stocke le travail créé par l'utilisateur utilise ce modèle
 - **Contenu** — documents
 - **Diapositives** — présentations
 - **Conception** – conceptions et éléments
-- **Clips** – enregistrements d'écran (style Loom)
+- **Clips** – enregistrements d'écran
 - **Plan** — visual plans and PR recaps
 - **Formulaires** — définitions de formulaire
 - **Calendrier** — événements et liens de réservation
@@ -115,7 +115,7 @@ Chaque ressource partageable reçoit un bouton de partage dans son en-tête. Cli
 
 - Sélecteur de visibilité (`Private` / `Organization` / `Public link`).
 - Saisie automatique « Ajouter des personnes ou des équipes » : recherchez des utilisateurs dans l'organisation ou collez un e-mail.
-- Une case à cocher `Notifier people` de style Google Docs pour les autorisations individuelles par e-mail.
+- Une case à cocher `Notifier les personnes` pour les autorisations individuelles par e-mail.
 - Une liste des subventions actuelles avec des sélecteurs de rôles et un contrôle de suppression.
 - Un bouton copier-lien qui respecte la visibilité actuelle.
 
@@ -270,7 +270,7 @@ export const deckShares = createSharesTable("deck_shares");
 
 Un appel d'inscription dans `server/db/index.ts` :
 
-```ts
+```ts filename="server/db/index.ts"
 import { registerShareableResource } from "@agent-native/core/sharing";
 
 registerShareableResource({
@@ -315,9 +315,9 @@ For resources that execute code or carry elevated trust (like extensions), set `
 
 Le partage s'appuie sur le modèle de portée des données plus large du framework : l'accès en liste/lecture/écriture aux tables propriétaires passe par `accessFilter()` / `resolveAccess()` / `assertAccess()`, et les ressources marquées `org_id` sont invisibles dans les organisations. Voir [Security → Data Scoping](/docs/security#data-scoping) pour le pipeline complet, la protection CI et la surface des menaces.
 
-## Voir aussi {#see-also}
+## Et ensuite {#see-also}
 
-- [Security & Data Scoping](/docs/security) : le modèle de filtre d'accès et de propriété sur lequel repose le partage.
-- [Authentication](/docs/authentication) : sessions, organisations et manière dont l'identité circule dans le contexte de la demande.
-- [Extensions](/docs/extensions#sharing) : partage dans la surface de la mini-application en bac à sable.
-- [Creating Templates](/docs/creating-templates) — câblage de `ownableColumns` dans le schéma d'un nouveau modèle.
+- [**Sécurité — Portée des données**](/docs/security#data-scoping) — le modèle de filtre d'accès et de propriété sur lequel repose le partage
+- [**Authentification**](/docs/authentication) — les sessions, les organisations et la manière dont l'identité alimente le contexte de la requête
+- [**Extensions**](/docs/extensions#sharing) — le partage dans la surface de mini-application en bac à sable
+- [**Création de modèles**](/docs/creating-templates) — l'intégration de `ownableColumns` au schéma d'un nouveau modèle

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

@@ -5,7 +5,7 @@ description: "Comment fonctionne skills dans l'agent natif : framework skills,
 
 # Guide Skills
 
-Skills sont des fichiers Markdown qui donnent à l'agent des connaissances approfondies sur des modèles et des flux de travail spécifiques.
+Les skills sont des fichiers Markdown qui apportent à l'agent une connaissance approfondie de modèles et de workflows précis. Au lieu d'entasser toutes les règles dans une seule invite système, vous répartissez les connaissances dans des fichiers ciblés que l'agent ne charge que lorsqu'une tâche en a réellement besoin. Le contexte par défaut reste ainsi réduit, tout en permettant à l'agent d'aller en profondeur à la demande.
 
 ## Que sont les skills {#what-are-skills}
 
@@ -120,9 +120,11 @@ Le domaine skills suit le même format que le framework skills. Ils codent des m
 
 Les skills basées sur des apps incluent aujourd'hui `visual-plan`, `visual-recap` et `visualize-repo` depuis Plan, `visual-edit` depuis Design, `assets` depuis Assets et `content` pour l'édition docs/blog/MDX adossée au dépôt.
 
-skills basé sur une application regroupe une application native d'agent en tant qu'artefact de marché de compétences. L'ensemble peut inclure des instructions d'agent, des métadonnées de connecteur skills exportées et MCP, des instructions de lancement hébergées/locales et des surfaces UI telles que les applications MCP.
+<Callout tone="info">
 
-> **Tous les détails ci-dessous :** les mécanismes du skills basé sur l'application (format du manifeste, commandes CLI, adaptateurs de marché, hachage de mise à jour automatique) sont couverts dans [App-backed skills — full details](#app-backed-skills-full).
+**Tous les détails ci-dessous :** les mécanismes du skills basé sur l'application (format du manifeste, commandes CLI, adaptateurs de marché, hachage de mise à jour automatique) sont couverts dans [App-backed skills — full details](#app-backed-skills-full).
+
+</Callout>
 
 ## Création d'un skills personnalisé {#creating-skills}
 
@@ -177,7 +179,11 @@ Les frontmatters `name` et `description` sont utilisés par le système d'outils
 
 Enregistrez le fichier sous `.agents/skills/my-skill/SKILL.md`. Le nom du répertoire doit correspondre au `name` en première page.
 
-> **Voir aussi :** [Writing Agent Instructions](/docs/writing-agent-instructions) pour savoir comment rédiger des descriptions de compétences, appliquer la divulgation progressive et maintenir `AGENTS.md` simple. Les deux pages utilisent la compétence `project-imports` comme exemple courant.
+<Callout tone="info">
+
+**Voir aussi :** [Writing Agent Instructions](/docs/writing-agent-instructions) pour savoir comment rédiger des descriptions de compétences, appliquer la divulgation progressive et maintenir `AGENTS.md` simple. Les deux pages utilisent la compétence `project-imports` comme exemple courant.
+
+</Callout>
 
 ## Portée des compétences : runtime vs dev {#skill-scope}
 
@@ -267,33 +273,37 @@ Cela remplace l'ancien hack consistant à s'appuyer sur le code Claude lisant un
 
 </Diagram>
 
-> **Voir aussi :** [Writing Agent Instructions](/docs/writing-agent-instructions) pour savoir comment rédiger des descriptions de compétences, appliquer la divulgation progressive et maintenir `AGENTS.md` simple.
-
 ## Skills contre AGENTS.md {#skills-vs-agents-md}
 
-> **AGENTS.md** — La présentation. Répertorie tous les scripts, décrit le modèle de données, explique l'architecture de l'application. L'agent lit ceci en premier pour comprendre l'application.
->
-> **Skills** — Analyses approfondies. Chaque compétence se concentre sur un modèle avec des règles détaillées, des exemples de code et des listes de choses à faire/à ne pas faire. L'agent les lit lorsqu'il doit suivre un modèle spécifique.
+<Callout tone="info">
+
+**AGENTS.md** — La présentation. Répertorie tous les scripts, décrit le modèle de données, explique l'architecture de l'application. L'agent lit ceci en premier pour comprendre l'application.
+
+**Skills** — Analyses approfondies. Chaque compétence se concentre sur un modèle avec des règles détaillées, des exemples de code et des listes de choses à faire/à ne pas faire. L'agent les lit lorsqu'il doit suivre un modèle spécifique.
+
+</Callout>
 
 `AGENTS.md` indique à l'agent _ce que_ l'application fait. Skills indique à l'agent _comment_ faire des choses spécifiques correctement. Les deux sont nécessaires : `AGENTS.md` pour l'orientation, skills pour l'exécution.
 
 ## Skills contre mémoire {#skills-vs-memory}
 
-> **Skills** — Guides pratiques rédigés et réutilisables. S'applique à chaque utilisateur, invoqué à la demande lorsque la tâche correspond.
->
-> **Mémoire (`LEARNINGS.md` / `memory/MEMORY.md`)** — Apprentissages partagés du projet et mémoire structurée personnelle chargée à chaque tour.
+<Callout tone="info">
+
+**Skills** — Guides pratiques rédigés et réutilisables. S'applique à chaque utilisateur, invoqué à la demande lorsque la tâche correspond.
+
+**Mémoire (`LEARNINGS.md` / `memory/MEMORY.md`)** — Apprentissages partagés du projet et mémoire structurée personnelle chargée à chaque tour.
+
+</Callout>
 
 Si les connaissances s'appliquent à _tout le monde_ travaillant dans l'application (« préférez toujours les CTE aux sous-requêtes »), il s'agit d'une compétence ou d'un `LEARNINGS.md` partagé. S'il s'agit de _cet utilisateur particulier_ ("Steve aime les réponses concises"), cela appartient à `memory/MEMORY.md`. Voir [Workspace Memory](/docs/workspace#memory) pour le traitement complet.
 
----
+## Skills et ressources SQL {#skills-vs-resources}
 
-# Avancé
+Cette page présente un skill comme un fichier situé dans `.agents/skills/<name>/SKILL.md`. [Workspace](/docs/workspace#skills) présente ce même skill comme une ressource SQL au chemin `skills/<slug>/SKILL.md`, de portée workspace, partagée ou personnelle. Il s'agit du même concept vu sous deux angles : le mode Code lit et écrit directement le fichier ; le mode App le stocke sous forme de ligne de ressource afin qu'il fonctionne sans système de fichiers. Dans les deux cas, rédigez le contenu au format décrit sur cette page.
 
 ## skills basé sur une application — tous les détails {#app-backed-skills-full}
 
-skills basé sur une application regroupe une application native d'agent en tant qu'artefact de marché de compétences.
-Le bundle peut inclure des instructions d'agent, un connecteur skills exporté et un connecteur MCP
-métadonnées, instructions de lancement hébergées/locales et surfaces UI telles que les applications MCP.
+Le format du manifeste, les commandes CLI, les adaptateurs de marketplace et le hachage de mise à jour automatique qui sous-tendent les [skills basés sur une application](#app-backed-skills), en détail :
 
 Chaque compétence basée sur l'application commence par `agent-native.app-skill.json` à la racine de l'application :
 
@@ -410,3 +420,10 @@ npx @agent-native/core@latest skills update scaffold --project
 `AGENTS.md` et `.agents/skills` restent canoniques. La commande update répare également
 Liens de compatibilité Claude (`CLAUDE.md` et `.claude/skills`) pour que le code Claude voie
 les mêmes instructions sans conserver une deuxième copie.
+
+## Et ensuite ? {#whats-next}
+
+- [**Rédiger les instructions de l'agent**](/docs/writing-agent-instructions) — formuler les descriptions des skills et répartir les consignes entre AGENTS.md, les skills et la mémoire
+- [**Workspace**](/docs/workspace#skills) — où les skills résident sous forme de ressources SQL en mode App
+- [**Mentions d'agents**](/docs/agent-mentions) — le déclencheur de commande `/` qui invoque un skill dans le chat
+- [**Plugin et marketplace Plan**](/docs/plan-plugin) — installation et mise à jour automatique de bout en bout d'un véritable skill basé sur une application

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

@@ -94,6 +94,18 @@ Lorsque vous ouvrez l'application, la bibliothèque sélectionnée, l'invite, le
 - **D'autres applications nécessitent un sélecteur ou un générateur d'éléments** : Slides, Design, Content, un éditeur de blog ou un créateur de site peuvent intégrer le sélecteur ou appeler des éléments via A2A.
 - **Vous souhaitez que les médias de marque soient disponibles auprès de votre agent de codage** : Codex, Claude Code, Claude ou ChatGPT peuvent générer et sélectionner des éléments sans quitter le chat.
 
+## Ce que vous pouvez en faire
+
+- **Créez des bibliothèques d'éléments.** Regroupez les images de référence, les vidéos, les logos canoniques, les notes de style, les palettes, les dossiers et les résultats générés par marque, campagne, produit ou catégorie.
+- **Générer via le chat.** Les contrôles de génération du composeur d'accueil et de la bibliothèque envoient l'invite à l'agent avec `sendToAgentChat()`, afin que les utilisateurs puissent inspecter les variantes, donner leur avis et itérer.
+- **Générer des images et des vidéos.** La génération d'images gérée par Builder est disponible lorsqu'elle est activée, et Gemini alimente la génération vidéo ainsi que le repli manuel des images.
+- **Téléchargez et décrivez les références.** Ajoutez des images ou des vidéos de la bibliothèque UI ou du bouton de pièce jointe du compositeur d'invite, puis recherchez par titre, description, texte alternatif, invite, modèle, type de média, statut, rôle, dossier ou collection.
+- **Conservez un journal d'audit de génération.** Chaque exécution enregistre les invites, le modèle, les proportions, les références, l'actif source, le lignage, les actifs générés, l'état, les erreurs et les horodatages pour une révision ultérieure de la conception.
+- **Préserver la précision du logo.** L'agent peut générer une zone d'espace réservé et le serveur compose le logo canonique téléchargé sur l'image finale au lieu de s'appuyer sur le modèle d'image pour le redessiner.
+- **Intégrer en tant que sélecteur.** D'autres applications peuvent iframer `/picker` et écouter l'événement `chooseAsset` de `@agent-native/embedding`, transformant ainsi les ressources en un sélecteur/générateur d'actifs pour les éditeurs de blogs, les créateurs de sites, les présentations de diapositives et les applications personnalisées. Le sélecteur émet également l'ancien alias `chooseImage` pour les hôtes d'images uniquement existants.
+- **Installer en tant que compétence basée sur une application.** Le manifeste `agent-native.app-skill.json` exporte une compétence Actifs ainsi que les métadonnées du connecteur MCP afin que les places de marché puissent installer ensemble l'application, ses instructions et son sélecteur.
+- **Servir d'autres agents.** Slides, Design, Content, Mail et Dispatch peuvent appeler des ressources via A2A pour répertorier les bibliothèques, générer des lots, créer des vidéos, affiner une ressource, récupérer des exportations et afficher des aperçus en ligne là où l'intégration est autorisée.
+
 ## Démarrer
 
 Démo en direct : [assets.agent-native.com](https://assets.agent-native.com).
@@ -116,18 +128,6 @@ Démo en direct : [assets.agent-native.com](https://assets.agent-native.com).
 - "Transformez ce diagramme téléchargé en une image explicative du produit plus claire."
 - "Créez un storyboard vidéo et enregistrez le meilleur ensemble d'images dans cette bibliothèque."
 
-## Ce que vous pouvez en faire
-
-- **Créez des bibliothèques d'éléments.** Regroupez les images de référence, les vidéos, les logos canoniques, les notes de style, les palettes, les dossiers et les résultats générés par marque, campagne, produit ou catégorie.
-- **Générer via le chat.** Les contrôles de génération du composeur d'accueil et de la bibliothèque envoient l'invite à l'agent avec `sendToAgentChat()`, afin que les utilisateurs puissent inspecter les variantes, donner leur avis et itérer.
-- **Générer des images et des vidéos.** La génération d'images gérée par Builder est disponible lorsqu'elle est activée, et Gemini alimente la génération vidéo ainsi que le repli manuel des images.
-- **Téléchargez et décrivez les références.** Ajoutez des images ou des vidéos de la bibliothèque UI ou du bouton de pièce jointe du compositeur d'invite, puis recherchez par titre, description, texte alternatif, invite, modèle, type de média, statut, rôle, dossier ou collection.
-- **Conservez un journal d'audit de génération.** Chaque exécution enregistre les invites, le modèle, les proportions, les références, l'actif source, le lignage, les actifs générés, l'état, les erreurs et les horodatages pour une révision ultérieure de la conception.
-- **Préserver la précision du logo.** L'agent peut générer une zone d'espace réservé et le serveur compose le logo canonique téléchargé sur l'image finale au lieu de s'appuyer sur le modèle d'image pour le redessiner.
-- **Intégrer en tant que sélecteur.** D'autres applications peuvent iframer `/picker` et écouter l'événement `chooseAsset` de `@agent-native/embedding`, transformant ainsi les ressources en un sélecteur/générateur d'actifs pour les éditeurs de blogs, les créateurs de sites, les présentations de diapositives et les applications personnalisées. Le sélecteur émet également l'ancien alias `chooseImage` pour les hôtes d'images uniquement existants.
-- **Installer en tant que compétence basée sur une application.** Le manifeste `agent-native.app-skill.json` exporte une compétence Actifs ainsi que les métadonnées du connecteur MCP afin que les places de marché puissent installer ensemble l'application, ses instructions et son sélecteur.
-- **Servir d'autres agents.** Slides, Design, Content, Mail et Dispatch peuvent appeler des ressources via A2A pour répertorier les bibliothèques, générer des lots, créer des vidéos, affiner une ressource, récupérer des exportations et afficher des aperçus en ligne là où l'intégration est autorisée.
-
 ## L'utiliser depuis votre agent de codage
 
 Générez et sélectionnez des médias de marque sans quitter le code Codex, Claude, Claude ou ChatGPT.
@@ -170,10 +170,13 @@ Générez et sélectionnez des médias de marque sans quitter le code Codex, Cla
 
 Le reste de ce document s'adresse à toute personne qui crée ou étend le modèle Assets.
 
-### Échafaudage
+### Démarrage rapide
 
 ```bash
 npx @agent-native/core@latest create my-assets --standalone --template assets
+cd my-assets
+pnpm install
+pnpm dev
 ```
 
 ### Modèle de données

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

@@ -205,7 +205,7 @@ Postgres, Neon, D1, Turso et hôtes similaires. L'état de l'application reflèt
 itinéraire actuel, filtres et ID sélectionnés afin que l'agent connaisse toujours l'itinéraire actuel
 navigation et sélection.
 
-Le schéma du cerveau réside dans `templates/brain/server/db/schema.ts`. Huit tableaux :
+Le schéma du cerveau réside dans `templates/brain/server/db/schema.ts`. Neuf tableaux :
 
 | Tableau                  | Ce qu'il contient                                                                                                                                                               |
 | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -553,3 +553,5 @@ Demandez à l'agent d'apporter des modifications à votre place : il peut modif
 - [**Dispatch template**](/docs/template-dispatch) — l'application de coordination d'échafaudage
 - [**Workspace**](/docs/workspace) – ressources partagées entre les applications
 - [**A2A Protocol**](/docs/a2a-protocol) – délégation inter-applications
+- [**Modèles**](/docs/cloneable-saas) — le modèle de clonage et de propriété, ainsi que tous les autres modèles de domaine pour commencer
+- [**Premiers pas**](/docs/getting-started) — les principes fondamentaux du framework : actions, état de l'application et synchronisation en direct