@agent-native/core 0.92.12 → 0.94.0

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/messaging.mdx

@@ -1,11 +1,15 @@
 ---
 title: "Messagerie"
-description: "Parlez à votre agent depuis Slack, par e-mail, Telegram ou WhatsApp : même agent, même mémoire, mêmes outils."
+description: "Parlez à votre agent depuis Slack, Microsoft Teams, les interactions Discord, l’e-mail, Telegram ou WhatsApp."
 ---
 
 # Messagerie
 
-Connectez votre agent à Slack, à la messagerie électronique, à Telegram ou à WhatsApp afin de pouvoir discuter avec lui à partir des applications que vous utilisez déjà. Il s'agit du même agent : même mémoire, mêmes outils, mêmes threads, accessible depuis plusieurs endroits.
+Connectez votre agent à Slack, Microsoft Teams, aux interactions Discord, à l’e-mail, Telegram ou WhatsApp. Il s’agit du même agent, avec la même mémoire, les mêmes outils et le même historique.
+
+> **Périmètre exact :** Teams valide les JWT officiels de Bot Framework et répond dans la conversation d’origine. Discord prend en charge les commandes slash via des interactions HTTP signées Ed25519 avec accusé différé ; les messages serveur ordinaires et les DM nécessitent toujours un runtime Gateway. Telegram conserve `message_thread_id` et WhatsApp utilise le `wamid` entrant pour les réponses contextuelles.
+>
+> Teams requiert `MICROSOFT_TEAMS_APP_ID`, `MICROSOFT_TEAMS_APP_PASSWORD` et `MICROSOFT_TEAMS_ALLOWED_TENANT_IDS`. Discord requiert `DISCORD_APPLICATION_ID` et `DISCORD_PUBLIC_KEY`. Telegram requiert aussi `TELEGRAM_WEBHOOK_SECRET`, et WhatsApp `WHATSAPP_APP_SECRET`.
 
 > **Vous utilisez le modèle Dispatch ?** Tout cela est configuré pour vous dans **Paramètres → Messagerie**. Cliquez pour connecter chaque plateforme. Vous n'avez pas besoin de lire le reste de cette page, sauf si vous personnalisez ou créez votre propre modèle. Voir [Dispatch](/docs/dispatch) ou [Dispatch template reference](/docs/template-dispatch).
 
@@ -78,7 +82,6 @@ Connectez votre agent à Slack, à la messagerie électronique, à Telegram ou
    - `chat:write` : permet à l'agent d'envoyer des messages
    - `app_mentions:read` — permet à l'agent de voir quand il est @-mentionné (facultatif)
    - `im:history` — permet à l'agent de lire les DM qui lui sont envoyés
-   - `assistant:write` — facultatif ; permet à Slack d'afficher le statut natif "pense..." dans les fils de discussion de l'assistant
    - `users:read.email` — facultatif ; aide les modèles tels que Mail à vérifier l'e-mail de l'expéditeur Slack pour l'identité de la file d'attente des brouillons
 3. Cliquez sur **Installer sur Workspace** en haut de cette page. Slack vous donnera un **Jeton OAuth d'utilisateur de robot** qui commence par `xoxb-`. Copiez-le.
 4. Accédez à **Informations de base** dans la barre latérale et copiez le **Secret de signature**.
@@ -123,12 +126,83 @@ et les événements `link_shared` vers le gestionnaire de déploiement des clips
 
 ### Conseils
 
-- **Mentions de canal** : le bot ne répond dans les canaux que lorsqu'il est mentionné par @, pour éviter le bruit.
-- **DMs** — chaque DM est traité comme une conversation privée avec l'agent.
-- **Même identité, tous les canaux** — si un utilisateur Slack a la même adresse e-mail qu'un utilisateur enregistré dans votre application, l'agent le traite comme la même personne.
+- **Mentions de canal** : utilisez une @mention pour démarrer le travail. Les réponses sans mention ne continuent que tant que ce fil précis contient un travail actif.
+- **Messages directs** — les messages directs personnels acceptés restent privés et exigent un membre vérifié de l’organisation ou une identité Slack associée.
+- **Identité** — les DM peuvent associer un e-mail Slack vérifié au même utilisateur de l'application ; les canaux gérés utilisent leur identité de service et leur règle.
 - **Listes autorisées de production** : définissez `SLACK_ALLOWED_TEAM_IDS` et, pour les applications Slack partagées, `SLACK_ALLOWED_API_APP_IDS` afin qu'un secret de signature valide ne puisse pas être réutilisé par un espace de travail inattendu.
 - **L'application Clips se déploie** — Les clips Agent-Native installables pour Slack utilisent `SLACK_CLIENT_ID`, `SLACK_CLIENT_SECRET`, `SLACK_SIGNING_SECRET` et `/api/slack/oauth/callback`. Chaque espace de travail Slack connecté obtient son propre jeton de bot crypté dans `app_secrets` ; `SLACK_BOT_TOKEN` n'est qu'une solution de secours héritée pour un seul espace de travail.
 
+### Add to Slack géré
+
+OAuth géré est la configuration recommandée. Dans **Paramètres → Messagerie**,
+sélectionnez **Agent manifest** pour télécharger le fichier propre à l’hôte
+`agent-native-slack-manifest.json`, puis importez-le dans **App Manifest** dans
+Slack. Le manifeste active l’expérience `agent_view` actuelle et un onglet
+**Messages** modifiable pour les messages directs. Vérifiez ces portées de bot :
+
+L’icône de l’application ne fait pas partie du manifeste. Dans **Basic
+Information → Display Information**, chargez l’icône Agent Native afin que le
+sélecteur Agents respecte l’identité du produit. Vous pouvez partir du fichier
+public `icon-512.svg` de l’application et le convertir dans un format de
+téléversement accepté par Slack si nécessaire.
+
+```text
+assistant:write
+app_mentions:read
+   channels:history
+   channels:read
+   chat:write
+files:read
+   groups:history
+   groups:read
+   im:history
+im:read
+   mpim:history
+   mpim:read
+   pins:read
+   reactions:read
+users:read
+users:read.email
+```
+
+Définissez OAuth Redirect URL sur
+`https://your-app.example.com/_agent-native/integrations/slack/oauth/callback`,
+Event Subscriptions Request URL sur
+`https://your-app.example.com/_agent-native/integrations/slack/webhook` et
+Interactivity Request URL sur
+`https://your-app.example.com/_agent-native/integrations/slack/interactions`.
+Abonnez-vous à `app_home_opened`, `app_context_changed`, `app_mention`,
+`message.channels`, `message.groups`, `message.im` et `message.mpim`.
+Configurez `SLACK_CLIENT_ID`, `SLACK_CLIENT_SECRET` et
+`SLACK_SIGNING_SECRET`, puis cliquez sur **Add to Slack** dans
+**Paramètres → Messagerie**. Chaque installation conserve son jeton chiffré et
+isole ses clés par espace, application, canal et fil.
+
+Réinstallez l’application Slack après toute modification du manifeste, des
+portées, des événements, de la vue Agent ou de l’onglet Messages.
+`app_home_opened` détecte l’ouverture des messages directs,
+`app_context_changed` fournit le contexte Slack affiché et `message.im` transmet
+les messages directs. Les administrateurs Slack peuvent masquer les agents
+installés pour l’organisation, et chaque membre peut les masquer de sa propre
+barre supérieure. Si l’installation réussit mais que l’agent reste invisible,
+vérifiez ces contrôles ou ouvrez-le via **Tools → Apps**.
+
+Les messages directs Slack personnels ne sont acceptés que pour un membre
+vérifié de l’organisation Agent Native ou une identité Slack déjà associée.
+Les règles et budgets du principal de service d’un canal restent distincts.
+
+Les réponses sans mention ne pilotent qu'un fil dont la tâche est active ; les
+autres messages du canal n'appellent pas l'agent. Un contexte borné charge les
+réactions et références de fichiers, tandis qu'une carte native affiche plan,
+progression, annulation et approbation/refus. Les DM utilisent l'identité personnelle ;
+les canaux gérés utilisent une identité de service explicite et des règles pour
+invités, Slack Connect et modèle. La mémoire de canal est explicite, isolée et
+jamais automatique. Les routines créées dans le canal y renvoient leurs résultats.
+Des budgets quotidiens ou mensuels par organisation, demandeur et canal sont
+appliqués avec une traçabilité d'audit. `assistant:write` active les événements
+de contexte Agent View ; `chat:write` permet les réponses et les mises à jour
+d’état en direct.
+
 ## Configurer Telegram {#telegram}
 
 ### Ce dont vous aurez besoin
@@ -435,7 +509,9 @@ POST /_agent-native/integrations/telegram/setup
 | E-mail     | `EMAIL_AGENT_ADDRESS`, plus un parmi `RESEND_API_KEY` ou `SENDGRID_API_KEY`  | `EMAIL_INBOUND_WEBHOOK_SECRET`                        |
 | WhatsApp   | `WHATSAPP_ACCESS_TOKEN`, `WHATSAPP_VERIFY_TOKEN`, `WHATSAPP_PHONE_NUMBER_ID` | —                                                     |
 
-Toutes les informations d'identification résident dans les variables d'environnement – jamais dans la base de données, jamais dans le code source. Utilisez les paramètres de la barre latérale UI ou le panneau d'environnement de votre fournisseur d'hébergement.
+Les identifiants d’intégration sont d’abord résolus depuis les secrets à portée du propriétaire de l’intégration (utilisateur, organisation, puis espace de travail) ; les variables d’environnement de déploiement servent de secours pour une installation locale ou volontairement mono-tenant. L’UI de configuration enregistre des secrets à portée ; les valeurs ne sont jamais renvoyées au navigateur ni stockées dans le code source.
+
+Les adaptateurs d’exécution intégrés sont **Slack**, **Telegram**, **WhatsApp Cloud API** et l’e-mail via webhook de fournisseur (Resend ou SendGrid). Discord et Microsoft Teams ne sont pas connectables tant qu’un adaptateur vérifié n’est pas implémenté et enregistré.
 
 ### Threading et identité {#threading-and-identity}
 
@@ -481,13 +557,13 @@ import type {
 import type { EnvKeyConfig } from "@agent-native/core/server";
 
 const myAdapter: PlatformAdapter = {
-  platform: "discord",
-  label: "Discord",
+  platform: "my-chat",
+  label: "My Chat",
 
   // Env keys this adapter needs (rendered in the settings UI)
   getRequiredEnvKeys(): EnvKeyConfig[] {
     return [
-      { key: "DISCORD_BOT_TOKEN", label: "Discord Bot Token", required: true },
+      { key: "MY_CHAT_BOT_TOKEN", label: "My Chat Bot Token", required: true },
     ];
   },
 
@@ -507,10 +583,10 @@ const myAdapter: PlatformAdapter = {
   // Return null to silently ignore the event (bot messages, edits, etc.).
   async parseIncomingMessage(event: H3Event): Promise<IncomingMessage | null> {
     return {
-      platform: "discord",
+      platform: "my-chat",
       externalThreadId: "channel-or-thread-id",
       text: "the user's message",
-      senderId: "discord-user-id",
+      senderId: "my-chat-user-id",
       platformContext: { channelId: "channel-id" },
       timestamp: Date.now(),
     };
@@ -538,10 +614,10 @@ const myAdapter: PlatformAdapter = {
   // baseUrl is the app's public URL, used for status checks that need it.
   async getStatus(baseUrl?: string) {
     return {
-      platform: "discord",
-      label: "Discord",
+      platform: "my-chat",
+      label: "My Chat",
       enabled: true,
-      configured: !!process.env.DISCORD_BOT_TOKEN,
+      configured: !!process.env.MY_CHAT_BOT_TOKEN,
     };
   },
 };

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