@agent-native/core 0.93.0 → 0.94.0

package/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/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/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/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/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/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/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

package/docs/content/locales/fr-FR/template-clips.mdx

@@ -17,7 +17,7 @@ Une application permettant de tout capturer : enregistrements d'écran, notes d
   />
 </WireframeBlock>
 
-Pensez à l'exemple de Loom + Granola + Wispr Flow regroupés dans une seule application - mais l'agent est un éditeur de premier ordre sur toutes les surfaces, et les enregistrements, les réunions et les dictées vous appartiennent, et non celles d'un fournisseur SaaS. Clips rend également les enregistrements partagés lisibles par l'agent : collez un lien de partage Clips normal dans un agent et celui-ci peut "entendre" la transcription sous forme de texte et "voir" les images d'écran horodatées sous forme d'images - aucune vidéo brute n'est nécessaire. La visualisation des images fonctionne dans n'importe quel agent compatible avec les images (ChatGPT, code Claude, curseur, Codex) ; Les discussions Web en texte uniquement reçoivent toujours la transcription complète et peuvent prendre une image que vous téléchargez.
+Des enregistrements d’écran asynchrones, des notes de réunion synchronisées avec le calendrier et une dictée vocale par pression réunis dans une seule application : l’agent est un éditeur de premier ordre sur chaque surface, et les enregistrements, réunions et dictées vous appartiennent, pas à un fournisseur SaaS. Clips rend également les enregistrements partagés lisibles par les agents : collez dans un agent un lien de partage Clips public ou un lien temporaire **Copier pour l’agent** et il peut « entendre » la transcription sous forme de texte et « voir » sous forme d’images les captures d’écran horodatées, sans vidéo brute. La visualisation des images fonctionne dans tout agent compatible avec les images (ChatGPT, Claude Code, Cursor, Codex) ; les chats web textuels reçoivent toujours la transcription complète et peuvent utiliser une image que vous téléchargez.
 
 <Diagram id="doc-block-qffztn" title={"Capturer, transcrire, réutiliser"} summary={"Trois types de capture atterrissent dans une seule bibliothèque ; l'agent transcrit, titre et résume, puis chaque transcription est consultable et partageable."}>
 
@@ -83,7 +83,7 @@ Pensez à l'exemple de Loom + Granola + Wispr Flow regroupés dans une seule app
 - **Obtenez un titre, un résumé et des marqueurs de chapitre générés automatiquement** pour chaque enregistrement : l'agent les remplit et les tient à jour.
 - **Recherchez dans chaque transcription** : enregistrements d'écran, réunions et dictées dans une seule bibliothèque. "Trouvez le clip dans lequel nous avons discuté du plan de déploiement."
 - **Partagez des clips** avec des autorisations par clip (publiques, d'équipe, privées). Le suivi des liens et les commentaires en fil de discussion fonctionnent également.
-- **Prévisualisez les clips publics dans Slack** avec un déroulement jouable de style Loom après le
+- **Prévisualisez les clips publics dans Slack** avec un aperçu vidéo lisible après que le
   workspace installe votre application Clips Slack.
 - **Capturez les journaux du navigateur avec l'extension Chrome.** Les enregistrements du navigateur peuvent
   joindre les journaux de console expurgés et récupérer les métadonnées/XHR, ce qui est utile pour
@@ -508,7 +508,7 @@ Les itinéraires du UI sont en direct sous `templates/clips/app/routes/` : l'ap
 
 ### Clé actions
 
-Chaque opération appelable par un agent est un fichier TypeScript dans `templates/clips/actions/`, monté automatiquement sur `POST /_agent-native/actions/:name` et exécutable à partir du CLI en tant que `pnpm action <name>`. Il y a environ 80 actions ; les regroupements utiles :
+Chaque opération appelable par un agent est un fichier TypeScript dans `templates/clips/actions/`, monté automatiquement sur `POST /_agent-native/actions/:name` et exécutable à partir du CLI en tant que `pnpm action <name>`. Il y a environ 100 actions ; les regroupements utiles :
 
 - **Cycle de vie de l'enregistrement** — `create-recording`, `finalize-recording`, `update-recording`, `set-thumbnail`, `archive-recording` / `restore-recording` / `trash-recording` / `delete-recording-permanent`, `move-recording`, `tag-recording`.
 - **Transcription et IA** — `request-transcript`, `cleanup-transcript`, `regenerate-title` / `regenerate-summary` / `regenerate-chapters`, `set-chapters`, `generate-workflow`. (`cleanup-transcript` et `finalize-meeting` sont des appels de pipeline multimédia côté serveur ; la plupart des autres fonctionnalités d'IA délèguent au chat de l'agent.)

package/docs/content/locales/fr-FR/template-design.mdx

@@ -11,7 +11,7 @@ Design est un studio de prototypage HTML natif avec agent. Au lieu d'un canevas
   <Screen
     surface="desktop"
     html={
-      "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Page de lancement produit</h1><span class='wf-pill accent'>Desktop</span><span class='wf-pill'>Tablet</span><span class='wf-pill'>Mobile</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Export code</button></div><div class='wf-card' style='flex:1;display:grid;grid-template-rows:auto 1fr auto;gap:12px'><div style='display:flex;gap:8px'><span class='wf-pill accent'>Hero</span><span class='wf-pill'>Pricing</span><span class='wf-pill'>FAQ</span></div><div class='wf-box' style='display:flex;align-items:center;justify-content:center;min-height:230px'><strong>Prototype HTML généré</strong></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span class='wf-muted'>Rendez le hero plus dense et le CTA plus clair.</span><div style='flex:1'></div><button class='primary'>Appliquer la révision</button></div></div></div>"
+      "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Page de lancement produit</h1><span class='wf-pill accent'>Desktop</span><span class='wf-pill'>Tablet</span><span class='wf-pill'>Mobile</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Export code</button></div><div class='wf-card' style='flex:1;display:grid;grid-template-rows:auto 1fr auto;gap:12px'><div style='display:flex;gap:8px'><span class='wf-pill accent'>Hero</span><span class='wf-pill'>Pricing</span><span class='wf-pill'>FAQ</span></div><div class='wf-box' style='display:flex;flex-direction:column;gap:12px;min-height:230px;padding:20px'><div style='display:flex;flex-direction:column;align-items:center;gap:8px;text-align:center'><strong style='font-size:22px'>Lancez plus vite avec Agent-Native</strong><span class='wf-muted' style='max-width:70%'>Générez un prototype fonctionnel à partir d’une invite, puis affinez-le sur place.</span><button class='primary'>Commencer</button></div><div style='display:grid;grid-template-columns:repeat(3,1fr);gap:10px;flex:1'><div class='wf-card' style='min-height:56px'></div><div class='wf-card' style='min-height:56px'></div><div class='wf-card' style='min-height:56px'></div></div></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span class='wf-muted'>Rendez le hero plus dense et le CTA plus clair.</span><div style='flex:1'></div><button class='primary'>Appliquer la révision</button></div></div></div>"
     }
   />
 </WireframeBlock>
@@ -134,6 +134,8 @@ pnpm dev
 
 Toutes les données se trouvent dans SQL avec Drizzle ORM. Schéma : `templates/design/server/db/schema.ts`. Les conceptions et les systèmes de conception portent la norme `ownableColumns` et une table de partages de framework correspondante, ils s'intègrent donc dans le modèle de partage par utilisateur/par organisation.
 
+Le tableau ci-dessous couvre les principales ressources possédables : conceptions, fichiers, modèles, versions et systèmes de conception. Sept autres tables du même schéma prennent en charge des fonctionnalités décrites ailleurs dans ce document plutôt que le modèle de ressources principal : `design_localhost_connections` et `design_localhost_write_grants` (mode source localhost), `component_index` (indexation des composants), `motion_timeline` (mouvement), `design_state` (instantanés de l’état de l’éditeur), `design_fusion_edits` (mode de fusion d’application complète) et `design_review_snapshot` (instantanés de révision).
+
 | Tableau                                  | Ce qu'il contient                                                                                                                                     |
 | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `designs`                                | Un projet de conception : `title`, `description`, `project_type` (`prototype` / `other`), le blob `data` JSON et un lien `design_system_id` en option |

package/docs/content/locales/fr-FR/template-dispatch.mdx

@@ -5,7 +5,11 @@ description: "Dispatch est le plan de contrôle de l'espace de travail : boîte
 
 # Expédition
 
-> **Voir aussi :** pour un aperçu conceptuel de ce que fait Dispatch et quand vous le souhaitez, voir [Dispatch](/docs/dispatch). Cette page est la référence spécifique au modèle.
+<Callout tone="info">
+
+**Voir aussi :** pour un aperçu conceptuel de ce que fait Dispatch et quand vous le souhaitez, voir [Dispatch](/docs/dispatch). Cette page est la référence spécifique au modèle.
+
+</Callout>
 
 Dispatch est le **plan de contrôle de l'espace de travail**. Là où d'autres modèles sont des applications de domaine (Mail, Calendar, Analytics, Brain), Dispatch est l'application que vous exécutez _à côté_ d'eux pour tout coordonner : une boîte de réception centrale, un coffre-fort secret, des tâches planifiées, une intégration Slack/Telegram et un agent orchestrateur qui délègue le travail de domaine à la bonne application spécialisée via [A2A](/docs/a2a-protocol).
 

package/docs/content/locales/fr-FR/template-mail.mdx

@@ -362,3 +362,11 @@ C'est à vous de modifier le courrier. Tout ce qui est important se trouve dans
 **Modification des raccourcis clavier.** Les gestionnaires de raccourcis clavier se trouvent dans `templates/mail/app/components/email/` : recherchez `useHotkeys` ou `addEventListener("keydown"` pour trouver où chaque touche est câblée.
 
 Demandez à l'agent d'effectuer l'une de ces modifications pour vous. L'agent peut modifier sa propre source — voir [Self-Modifying Code](/docs/key-concepts#agent-modifies-code).
+
+## Et ensuite
+
+- [**Modèles**](/docs/cloneable-saas) — le modèle à cloner et à posséder, ainsi que tous les autres modèles de domaine pour démarrer
+- [**Bien démarrer**](/docs/getting-started) — les principes fondamentaux du framework : actions, état de l’application et synchronisation en direct
+- [**Calendrier**](/docs/template-calendar) — un modèle de domaine associé pour la planification et les réservations
+- [**Automatisations**](/docs/automations) — le moteur déclenché par des événements sur lequel reposent les règles de tri automatique de Mail
+- [**Actions**](/docs/actions) — le système d’actions appelé par le chat, les raccourcis et les automatisations

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

@@ -127,6 +127,8 @@ import { defineAction } from "@agent-native/core/action";
 import { track } from "@agent-native/core/tracking";
 import { z } from "zod";
 
+import { getDb, schema } from "../server/db/index.js";
+
 export default defineAction({
   description: "Create a new project.",
   schema: z.object({
@@ -134,14 +136,15 @@ export default defineAction({
     template: z.string().optional(),
   }),
   run: async ({ name, template }, ctx) => {
-    const project = await db
-      .insert(projects)
+    const db = getDb();
+    const [project] = await db
+      .insert(schema.projects)
       .values({ name, template })
       .returning();
 
-    track("project.created", { name, template }, { userId: ctx.userEmail });
+    track("project.created", { name, template }, { userId: ctx?.userEmail });
 
-    return { ok: true, projectId: project[0].id };
+    return { ok: true, projectId: project.id };
   },
 });
 ```
@@ -349,5 +352,5 @@ Le framework suit également `builder connect clicked` à partir des CTA Connect
 ## Quelle est la prochaine étape
 
 - [**Actions**](/docs/actions) – d'où proviennent la plupart des appels de suivi
-- [**Server Plugins**](/docs/server) — `registerBuiltinProviders()` s'exécute dans le plugin core-routes au démarrage
-- [**Secrets**](/docs/security) : gérer les clés API pour les fournisseurs de suivi
+- [**Server Plugins**](/docs/server#server-plugins) — `registerBuiltinProviders()` s'exécute dans le plugin core-routes au démarrage
+- [**Sécurité — Gestion des secrets**](/docs/security#secrets) : gérer les clés API pour les fournisseurs de suivi

package/docs/content/locales/fr-FR/using-your-agent.mdx

@@ -92,21 +92,14 @@ La plupart du temps, vous dirigez l'agent en écrivant dans le chat. Deux choses
 
 L'agent n'est pas une application distincte vers laquelle vous accédez. Il est livré sous la forme d'une poignée de composants React (une barre latérale, un panneau brut et un appel `sendToAgentChat()`) que vous déposez dans n'importe quelle application. Rendu `<AgentSidebar>` pour attribuer à chaque écran un agent commutable, ou câblez un bouton pour confier une tâche spécifique au chat au lieu d'exécuter un appel LLM unique.
 
-→ [**Drop-in Agent**](/docs/drop-in-agent) : montez les `<AgentPanel>`, `<AgentSidebar>` et `sendToAgentChat()` dans n'importe quelle application React.
-→ [**Agent Surfaces**](/docs/agent-surfaces) : choisissez si le flux de travail doit être sans tête, axé d'abord sur le chat, intégré ou une application complète.
-
 ## Vous pouvez passer au UI légère {#ui-light}
 
 Toutes les applications n'ont pas besoin d'un tableau de bord complet. Lorsque l'agent _est_ le produit, vous pouvez ignorer la plupart des UI personnalisés : ouvrez l'application, demandez ce que vous voulez et laissez l'agent faire le reste. L'agent dispose toujours de sa surface de gestion (historique, espace de travail, paramètres), mais l'interaction principale est la conversation plutôt que les clics.
 
-→ [**Automation-First Apps**](/docs/pure-agent-apps) — apps sans navigateur pour jobs, files, scripts et agents externes.
-
 ## Vous co-éditez avec lui {#you-co-edit}
 
 Lorsque vous et l'agent travaillez sur le même document, vous ne vous relayez pas. Grâce à la collaboration en temps réel, les modifications de l'agent sont diffusées parallèlement aux vôtres (curseurs en direct, pas d'écrasement) de la même manière que celles d'un coéquipier. Vous pouvez continuer à taper pendant qu'il fonctionne et il voit vos modifications au fur et à mesure qu'elles se produisent.
 
-→ [**Real-Time Collaboration**](/docs/real-time-collaboration) — édition collaborative multi-utilisateurs avec curseurs en direct et modifications d'agent dans le même document.
-
 ## Quelle est la prochaine étape {#whats-next}
 
 - [**Context Awareness**](/docs/context-awareness) — l'agent sait ce que vous regardez

package/docs/content/locales/fr-FR/voice-input.mdx

@@ -9,6 +9,12 @@ Chaque application native d'agent dispose d'un microphone dans l'éditeur de cha
 
 Le framework gère tout cela automatiquement. Les utilisateurs connectés à Builder obtiennent par défaut Gemini Flash-Lite hébergé sur Builder ; sinon, les utilisateurs peuvent apporter leur propre clé de fournisseur ou recourir à la reconnaissance vocale du navigateur.
 
+## Mode vocal en temps réel {#realtime-speech-mode}
+
+À l’ouverture du micro, une fenêtre contextuelle permet de choisir entre **Conversation en temps réel** et **Dictée modifiable**. Le mode en temps réel nécessite une `OPENAI_API_KEY` propre à l’utilisateur et connecte le navigateur à `gpt-realtime-2.1` par WebRTC. Le chat se réduit à une bulle vocale en bas à droite ; cliquez dessus pour afficher ou masquer le chat sans mettre fin à la conversation.
+
+Le modèle vocal utilise les mêmes outils Agent Native authentifiés que le chat. Il peut donc parcourir l’application et appeler des actions tout en parlant. Les actions soumises à approbation restent en pause jusqu’à votre accord. L’audio n’est jamais stocké dans SQL ; Agent Native ne conserve qu’un état compact de la session et de la transcription. Une session en temps réel dure au maximum 60 minutes.
+
 ## Comment ça marche {#how-it-works}
 
 Le bouton vocal du compositeur enregistre l'audio dans le navigateur, puis sélectionne un fournisseur :

package/docs/content/locales/fr-FR/workspace-connections.mdx

@@ -425,10 +425,9 @@ Ne dupliquez pas le stockage OAuth/jeton dans chaque application. L'enregistreme
 
 ### Configuration du plan de contrôle de répartition
 
-Dispatch expose le plan de contrôle actions qui écrit les mêmes fonctions de magasin partagé qu'une application pourrait appeler directement :
+Dispatch expose des actions de plan de contrôle qui utilisent les mêmes fonctions de stockage partagé qu’une application pourrait appeler directement : son action `upsert-workspace-connection` valide l’entrée par rapport au catalogue des fournisseurs, puis délègue à la même fonction `upsertWorkspaceConnection()` présentée dans cette page :
 
 ```ts
-// templates/dispatch/actions/upsert-workspace-connection.ts delegates to this.
 await upsertWorkspaceConnection({
   id: "team-slack",
   provider: "slack",
@@ -493,3 +492,11 @@ Le catalogue des fournisseurs et le magasin de subventions constituent la base d
 Gardez les limites strictes : les métadonnées du fournisseur peuvent être affichées en toute sécurité ; les valeurs des informations d'identification restent dans le coffre-fort.
 
 </details>
+
+## Et ensuite {#whats-next}
+
+- [**Dispatch**](/docs/dispatch) — l’application qui gère généralement la configuration des connexions de l’espace de travail et le coffre-fort
+- [**Sécurité**](/docs/security) — le coffre-fort d’identifiants, la portée des secrets et le modèle d’accès vers lesquels pointent les connexions
+- [**Intégration**](/docs/onboarding#checking-workspace-connections-in-onboarding) — vérifier l’état de préparation des connexions depuis la liste de configuration d’un modèle
+- [**Clients MCP**](/docs/mcp-clients) — partager les identifiants des serveurs MCP dans l’espace de travail, un modèle voisin de configuration réutilisable
+- [**Brain**](/docs/template-brain) — l’implémentation de référence d’une page Sources de fournisseurs basée sur ce modèle