@agent-native/core 0.109.3 → 0.110.0

package/docs/content/locales/fr-FR/agent-native-toolkit.mdx

@@ -1,21 +1,24 @@
 ---
-title: "Toolkits"
-description: "Battle-tested reusable building blocks for high-quality agentic applications: collaboration, sharing, settings, teams, setup, navigation, resources, agent UX, history, comments, and observability."
+title: "Toolkit"
+description: "Un catalogue équilibré de fondations réutilisables, éditeurs et canevas, contexte d’agent, gouvernance, chrome d’espace de travail, opérations et modules de capacité Toolkit."
 ---
 
 <!-- i18n-docs-ignore -->
 
-# Toolkits
+# Toolkit
 
-Toolkits are reusable, battle-tested building blocks for high-quality agentic
-applications. They turn the hard product work that repeats across apps into
-standard surfaces: realtime collaboration between humans and agents, sharing
-with humans and agents, settings, teams, setup, resources, history, review, and
-observability.
+Toolkit est l’étagère de blocs réutilisables et éprouvés pour des applications
+agentiques de qualité. Il transforme le travail produit qui se répète entre les
+apps en surfaces standard, sans placer un modèle d’app au centre du catalogue.
+
+Cette section est l’étagère unique de découverte de l’UI réutilisable. Une
+surface y figure parce qu’elle est réutilisable, même si Core ou un template en
+est aujourd’hui propriétaire. Les libellés de propriété et les chemins d’import
+clarifient cette limite sans disperser la documentation dans le site.
 
 Each kit packages the UI patterns, action contracts, app-state expectations,
 access boundaries, and agent-visible behavior that users expect to work
-consistently. Apps still own their domain model and visual identity; toolkits
+consistently. Apps still own their domain model and visual identity; Toolkit
 make the common product systems feel complete from the first version instead of
 being rebuilt in slightly different ways every time.
 
@@ -28,23 +31,24 @@ being rebuilt in slightly different ways every time.
   />
 </WireframeBlock>
 
-<Diagram id="doc-block-toolkits-boundary" title="How kits fit" summary={"The framework runtime supplies durable guarantees. Toolkits turn those guarantees into reusable product systems. Apps add domain-specific data, routes, and visual identity."}>
+<Diagram id="doc-block-toolkits-boundary" title="Comment les kits s’articulent" summary={"Le runtime du framework fournit des garanties durables. Toolkit les transforme en systèmes de produit réutilisables. Les apps ajoutent données métier, routes et identité visuelle."}>
 
 ```html
 <div class="diagram-row">
   <div class="diagram-card">
     <span class="diagram-pill accent">Runtime</span><br />
-    actions, SQL, auth, app state, access checks, realtime transport
+    actions, SQL, authentification, état d’app, contrôles d’accès, transport
+    temps réel
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-card">
-    <span class="diagram-pill accent">Toolkits</span><br />
-    collaboration, sharing, setup, review, history, observability
+    <span class="diagram-pill accent">Toolkit</span><br />
+    collaboration, partage, configuration, revue, historique, observabilité
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-card">
     <span class="diagram-pill accent">Apps</span><br />
-    domain schema, routes, actions, branding, specialized workflows
+    schéma métier, routes, actions, marque, flux spécialisés
   </div>
 </div>
 ```
@@ -68,45 +72,71 @@ being rebuilt in slightly different ways every time.
 
 </Diagram>
 
-## The Kits {#the-kits}
-
-| Kit                                                      | Use it for                                                                                                  |
-| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
-| [Sharing](/docs/toolkit-sharing)                         | Ownable resources, share dialogs, visibility badges, share actions, public/private/org access.              |
-| [Collaboration](/docs/toolkit-collaboration)             | Realtime editing, presence, live cursors, recent-edit highlights, collaborative undo.                       |
-| [Settings](/docs/toolkit-settings)                       | Standard settings pages and tabs so app settings and agent/provider settings live in one predictable place. |
-| [Org & Team](/docs/toolkit-org-team)                     | Team pages, org switching, invites, org domains, roles, and app switching.                                  |
-| [Setup & Connections](/docs/toolkit-setup-connections)   | Onboarding, secrets, workspace connections, OAuth/provider readiness, and Builder connect.                  |
-| [Command & Navigation](/docs/toolkit-command-navigation) | Command menu, deep links, standard app routes, sidebar and shell patterns.                                  |
-| [Resources](/docs/toolkit-resources)                     | Resource trees, editors, file picker/search, attachments, and local file mode.                              |
-| [Agent UX](/docs/toolkit-agent-ux)                       | Composer, model picker, context chips, approvals, run recovery, and the runs tray.                          |
-| [History](/docs/toolkit-history)                         | Version history, audit logs, undo/redo, restore, and "what changed" surfaces.                               |
-| [Comments & Review](/docs/toolkit-comments-review)       | Inline comments, annotations, mentions, resolved threads, review status.                                    |
-| [Observability](/docs/toolkit-observability)             | Usage, spend, feedback, replay, errors, and run diagnostics.                                                |
-
-## Implementation Boundary {#implementation-boundary}
-
-Kits are product surfaces first. Some pieces are runtime-backed
+## Catalogue {#catalog}
+
+| Domaine                        | Commencer ici                                                | Ce que cela couvre                                                                           |
+| ------------------------------ | ------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
+| Fondations                     | [Primitives UI](/docs/toolkit-ui)                            | Contrôles, hooks, adaptateurs d’app et points d’intégration de shell partagés.               |
+| Éditeurs et canevas            | [Éditeurs et canevas](/docs/toolkit-editors-canvases)        | Édition riche, blocs structurés, contrôles de canevas et patterns Design.                    |
+| Expérience et contexte d’agent | [Contexte et connaissances](/docs/toolkit-context-knowledge) | Context X-Ray, ressources, connaissances, contexte du composeur et état visible par l’agent. |
+| Collaboration et gouvernance   | [Collaboration](/docs/toolkit-collaboration)                 | Partage, présence, revue, historique, audit et frontières organisationnelles.                |
+| Chrome d’espace de travail     | [Chrome d’app](/docs/toolkit-settings)                       | Réglages, équipes, configuration, navigation, ressources et UX d’agent.                      |
+| Opérations                     | [Observabilité](/docs/toolkit-observability)                 | Usage, feedback, replay, diagnostic et visibilité opérationnelle.                            |
+| Modules de capacité Toolkit    | [Paquets de capacité](/docs/toolkit-capability-packages)     | Paquets de domaine installés à la demande et leurs manifests de cycle de vie.                |
+
+## Kits produit {#product-kits}
+
+| Kit                                                      | À utiliser pour                                                                                       |
+| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| [Sharing](/docs/toolkit-sharing)                         | Ressources possédables, dialogues/actions de partage, badges de visibilité et accès public/privé/org. |
+| [Collaboration](/docs/toolkit-collaboration)             | Édition temps réel, présence, curseurs actifs, changements récents et annulation collaborative.       |
+| [Settings](/docs/toolkit-settings)                       | Pages et onglets standard pour les réglages d’app et d’agent/fournisseur au même endroit.             |
+| [Org & Team](/docs/toolkit-org-team)                     | Équipes, changement d’organisation, invitations, domaines, rôles et changement d’app.                 |
+| [Setup & Connections](/docs/toolkit-setup-connections)   | Onboarding, secrets, connexions d’espace, OAuth/préparation fournisseur et Builder connect.           |
+| [Command & Navigation](/docs/toolkit-command-navigation) | Menu de commande, liens profonds, routes standard, patterns de barre latérale et de shell.            |
+| [Resources](/docs/toolkit-resources)                     | Arborescences et éditeurs, sélection/recherche de fichiers, pièces jointes et mode fichiers local.    |
+| [Agent UX](/docs/toolkit-agent-ux)                       | Composeur, modèle, puces de contexte, approbations, reprise et tiroir des exécutions.                 |
+| [History](/docs/toolkit-history)                         | Ressources versionnées, snapshots, historique, audit, annuler/rétablir, restauration et changements.  |
+| [Comments & Review](/docs/toolkit-comments-review)       | Ressources révisables, commentaires, feedback, fils, mentions, résolution et statut de revue.         |
+| [Observability](/docs/toolkit-observability)             | Usage, dépenses, feedback, replay, erreurs et diagnostics d’exécution.                                |
+
+## Maturité et propriété des paquets {#package-maturity-and-ownership}
+
+- L’éditeur riche appartient à **Toolkit** ; les imports Core existants restent de minces réexportations de compatibilité pendant la migration.
+- Design est un **pattern de template** avec des `design-tweaks` réutilisables, et non un éditeur ou canevas complet prêt à l’emploi.
+- Blocks et le moteur Context X-Ray restent détenus par **Core** à cette étape ; la présentation réutilisable de Context X-Ray appartient à Toolkit.
+- Creative Context, Scheduling et Pinpoint sont des **modules de capacité Toolkit** installés à la demande ; ils conservent des paquets npm et manifests de cycle de vie séparés. Dispatch reste un produit distinct.
+
+## Limite d’implémentation {#implementation-boundary}
+
+Les kits sont d’abord des surfaces produit. Certaines pièces sont fournies par
+le runtime
 (`@agent-native/core`), some are presentation primitives
 (`@agent-native/toolkit`), and apps usually wrap both through local adapters.
-Use the package path that owns the needed behavior, but design the user-facing
-settings, collaboration, sharing, team, review, and setup experiences as one
-coherent kit instead of exposing package boundaries in the app.
-
-## Foundation Pieces {#foundation-pieces}
-
-- [UI Primitives](/docs/toolkit-ui) cover shared shadcn-style primitives under
-  `@agent-native/toolkit/ui/*`.
-- [App Adapters](/docs/toolkit-ui#app-adapters) show how apps wrap Toolkit pieces
-  through local `@/components/*` adapters.
-- [Shell & Hooks](/docs/toolkit-ui#shell-hooks) cover header actions, mobile hooks,
-  toasts, and small app-shell helpers.
-- [Component API](/docs/components) remains the lower-level reference for the
-  public React exports.
-
-## Design Rule {#design-rule}
-
-Use a toolkit when the behavior repeats across apps and users expect it to feel
-standard: sharing, settings, teams, comments, history, and agent progress should
-not be slightly different in every template. Keep domain-specific data,
-workflows, labels, and visual styling in the app.
+Utilisez le chemin du paquet qui possède le comportement, mais concevez les
+expériences de réglages, collaboration, partage, équipe, revue et configuration
+comme un kit cohérent, sans exposer les limites de paquets dans l’app.
+
+## Pièces fondamentales {#foundation-pieces}
+
+- [Primitives UI](/docs/toolkit-ui) couvre les primitives partagées de style
+  shadcn sous `@agent-native/toolkit/ui/*`, les adaptateurs locaux et les hooks
+  de shell partagés.
+- [API des composants](/docs/components) reste la référence de bas niveau des
+  exports React publics.
+
+## Règle de conception {#design-rule}
+
+Utilisez un kit lorsque le comportement se répète entre les apps et que les
+utilisateurs attendent une expérience standard : partage, réglages, équipes,
+commentaires, historique et progrès de l’agent ne doivent pas varier d’un
+template à l’autre. Gardez dans l’app les données, flux, libellés et style
+visuel propres au domaine.
+
+## Étapes suivantes
+
+- [**Primitives UI Toolkit**](/docs/toolkit-ui) — primitives partagées, adaptateurs d’app et hooks de shell.
+- [**Kit de partage**](/docs/toolkit-sharing) — un bon premier kit pour les ressources, boîtes de partage et la visibilité.
+- [**Créer des templates**](/docs/creating-templates) — créez un template de bout en bout et voyez où les kits s’intègrent.
+- [**API des composants**](/docs/components) — la référence de tous les exports React publics.
+- [**Cycle de vie des paquets**](/docs/package-lifecycle) — inspectez, ajoutez et éjectez les modules de capacité Toolkit pilotés par manifest en sécurité.

package/docs/content/locales/fr-FR/agent-surfaces.mdx

@@ -15,8 +15,7 @@ navigation de l'application et passez `agentPageHref="/agent"` à
 complète sans dupliquer ces flux.
 
 ```tsx filename="app/routes/agent.tsx"
-import { AgentTabsPage } from "@agent-native/core/client";
-
+import { AgentTabsPage } from "@agent-native/core/client/agent-chat";
 export default function AgentRoute() {
   return <AgentTabsPage />;
 }
@@ -418,8 +417,7 @@ export default createAgentNativeEmbeddedPlugin({
 Le side-car React transmet le contexte de la page et les commandes de l'hôte :
 
 ```tsx
-import { AgentNativeEmbedded } from "@agent-native/core/client";
-
+import { AgentNativeEmbedded } from "@agent-native/core/client/host";
 export function AppShell({ children }) {
   return (
     <AgentNativeEmbedded

package/docs/content/locales/fr-FR/audit-log.mdx

@@ -82,8 +82,7 @@ Trois actions en lecture sont disponibles pour l'agent **et** le frontend dans c
 Créez un flux d'activité ou une ligne « qui a modifié cela » en appelant `list-audit-events` à partir du UI avec `useActionQuery` — n'écrivez jamais manuellement une récupération dans la table d'audit :
 
 ```tsx
-import { useActionQuery } from "@agent-native/core/client";
-
+import { useActionQuery } from "@agent-native/core/client/hooks";
 const { data } = useActionQuery("list-audit-events", {
   targetType: "recording",
   targetId: recordingId,

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

@@ -363,8 +363,9 @@ interface AuthSession {
 Sur le client, utilisez le hook `useSession()` :
 
 ```ts
-import { useSession } from "@agent-native/core/client";
-
+import {
+  useSession,
+} from "@agent-native/core/client/hooks"
 function MyComponent() {
   const { session, isLoading } = useSession();
   if (isLoading) return <p>Loading...</p>;

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

@@ -67,8 +67,7 @@ import {
   useActionQuery,
   useActionMutation,
   callAction,
-} from "@agent-native/core/client";
-
+} from "@agent-native/core/client/hooks";
 // Read: auto-cached, auto-invalidated on mutations
 const { data, isLoading } = useActionQuery("get-lead", { leadId });
 
@@ -85,8 +84,7 @@ await callAction("archive-lead", { leadId });
 Envoyez un message au chat de l'agent via postMessage : le moyen courant de déléguer une tâche d'IA à partir d'une interaction UI. Transmettez `context` pour le contexte de modèle masqué et `submit: true` pour l'envoyer immédiatement, ou `submit: false` pour pré-remplir un brouillon que l'utilisateur examine en premier.
 
 ```ts
-import { sendToAgentChat } from "@agent-native/core/client";
-
+import { sendToAgentChat } from "@agent-native/core/client/agent-chat";
 // Auto-submit a prompt with hidden context
 sendToAgentChat({
   message: "Generate alt text for this image",
@@ -176,8 +174,7 @@ onglet Paramètres de la barre latérale de l'agent. Transmettez un identifiant
 `"automations"`, `"voice"` ou `"limits"` pour ouvrir une section spécifique.
 
 ```ts
-import { openAgentSettings } from "@agent-native/core/client";
-
+import { openAgentSettings } from "@agent-native/core/client/navigation";
 openAgentSettings();
 openAgentSettings("secrets");
 ```
@@ -185,8 +182,7 @@ openAgentSettings("secrets");
 Préférez cette aide à l’envoi direct de `agent-panel:open-settings`.
 
 ```tsx
-import { useAgentChatContext } from "@agent-native/core/client";
-
+import { useAgentChatContext } from "@agent-native/core/client/agent-chat";
 function SelectionContextButton({ record }: { record: { id: string } }) {
   const chatContext = useAgentChatContext();
   const contextKey = `selected-record:${record.id}`;
@@ -244,8 +240,10 @@ lance le travail des agents — au lieu de créer un modal personnalisé. Atteig
 compositeur pour les détails de forme libre et un formulaire/popover pour la saisie multi-champs.
 
 ```tsx
-import { askUserQuestion, sendToAgentChat } from "@agent-native/core/client";
-
+import {
+  askUserQuestion,
+  sendToAgentChat,
+} from "@agent-native/core/client/agent-chat";
 const length = await askUserQuestion({
   question: "How long should this deck be?",
   header: "Deck length", // optional short chip/heading (≈12 chars)
@@ -288,7 +286,7 @@ import {
   requestMcpAppDisplayMode,
   updateMcpAppModelContext,
   useMcpAppHostContext,
-} from "@agent-native/core/client";
+} from "@agent-native/core/client/agent-chat";
 ```
 
 `getMcpAppHostContext()` lit le dernier instantané de contexte d'hôte poussé ;
@@ -323,8 +321,9 @@ Définissez `dynamicSuggestions={false}` pour conserver uniquement les puces sta
 Hook React qui encapsule sendToAgentChat avec le suivi de l'état de chargement :
 
 ```ts
-import { useAgentChatGenerating } from "@agent-native/core/client";
-
+import {
+  useAgentChatGenerating,
+} from "@agent-native/core/client/agent-chat"
 function GenerateButton() {
   const [isGenerating, send] = useAgentChatGenerating();
 
@@ -350,7 +349,9 @@ function GenerateButton() {
 Hook React (anciennement `useFileWatcher`) qui écoute les modifications de la base de données sur SSE, revient à l'interrogation et invalide les caches de requêtes du framework qui maintiennent le UI aligné avec les écritures de l'agent :
 
 ```ts
-import { useDbSync } from "@agent-native/core/client";
+import {
+  useDbSync,
+} from "@agent-native/core/client/hooks"
 import { useQueryClient } from "@tanstack/react-query";
 
 function App() {
@@ -395,8 +396,7 @@ Lorsqu'une mutation de base de données côté serveur se produit, le serveur en
 
 ```tsx
 import { useQuery } from "@tanstack/react-query";
-import { useChangeVersion } from "@agent-native/core/client";
-
+import { useChangeVersion } from "@agent-native/core/client/hooks";
 function DashboardView({ id }) {
   // Get version for dashboards domain source
   const v = useChangeVersion("dashboards");
@@ -461,8 +461,9 @@ function DashboardView({ id }) {
 Utilitaire de fusion des noms de classes (clsx + tailwind-merge) :
 
 ```ts
-import { cn } from "@agent-native/core/client";
-
+import {
+  cn,
+} from "@agent-native/toolkit/utils"
 <div className={cn(
   "px-4 py-2 rounded",
   isActive && "bg-primary text-primary-foreground",

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

@@ -13,7 +13,7 @@ composants lorsque vous le pouvez, et déposez un calque lorsque vous avez besoi
 Importer le navigateur UI à partir des sous-chemins client ciblés :
 
 ```tsx
-import { AgentSidebar } from "@agent-native/core/client";
+import { AgentSidebar } from "@agent-native/core/client/agent-chat";
 import { PromptComposer } from "@agent-native/core/client/composer";
 import { AgentConversation } from "@agent-native/core/client/conversation";
 import { usePresence } from "@agent-native/core/client/collab";

package/docs/content/locales/fr-FR/context-awareness.mdx

@@ -196,8 +196,7 @@ Utilisez la clé d'état de l'application `selection` pour une sélection durabl
 Écrivez-le à partir du UI lorsque l'utilisateur sélectionne, concentre ou sélectionne plusieurs objets significatifs :
 
 ```tsx
-import { setClientAppState } from "@agent-native/core/client";
-
+import { setClientAppState } from "@agent-native/core/client/hooks";
 async function syncSelection(selection: unknown | null) {
   await setClientAppState("selection", selection, { keepalive: true });
 }
@@ -226,8 +225,7 @@ L'agent de production injecte cette clé dans le tour suivant comme contexte de
 Les éditeurs personnalisés peuvent écrire la même clé lorsque leur sélection n'est pas représentée par la sélection native du navigateur :
 
 ```tsx
-import { setClientAppState } from "@agent-native/core/client";
-
+import { setClientAppState } from "@agent-native/core/client/hooks";
 await setClientAppState(
   "pending-selection-context",
   {
@@ -289,8 +287,7 @@ L'agent doit appeler `pnpm action view-screen` avant d'agir sur le UI actuel. Il
 Parfois, le contexte ne doit pas simplement rester dans l'état de l'application. Un utilisateur clique sur un bouton, dépose une épingle de commentaire, sélectionne un élément et choisit « Demander à l'agent » ou appuie sur une commande AI dans une barre d'outils. Ce clic est une instruction. Dans le navigateur UI, remettez-le à l'agent avec `sendToAgentChat()`.
 
 ```tsx
-import { sendToAgentChat } from "@agent-native/core/client";
-
+import { sendToAgentChat } from "@agent-native/core/client/agent-chat";
 function askAgentAboutSelection(selection: {
   documentId: string;
   blockId: string;
@@ -373,7 +370,7 @@ Il reste court car il s'agit d'une fine enveloppe autour de la véritable primit
 
 ```tsx
 // app/hooks/use-navigation-state.ts -- this file lives in YOUR app
-import { useAgentRouteState } from "@agent-native/core/client";
+import { useAgentRouteState } from "@agent-native/core/client/navigation";
 import { TAB_ID } from "@/lib/tab-id";
 
 interface NavigationState {

package/docs/content/locales/fr-FR/creating-templates.mdx

@@ -268,8 +268,10 @@ Utilisez `http: { method: "GET" }` ou `readOnly: true` pour actions en lecture s
 Les itinéraires résident dans `app/routes/` et utilisent le routage de fichiers React Router v8. Interrogez les données via les gestionnaires actions ou API et rendez les mutations optimistes par défaut.
 
 ```tsx
-import { useActionMutation, useActionQuery } from "@agent-native/core/client";
-
+import {
+  useActionMutation,
+  useActionQuery,
+} from "@agent-native/core/client/hooks";
 export default function ProjectsPage() {
   const { data: projects = [] } = useActionQuery("list-projects", {});
   const create = useActionMutation("create-project");
@@ -285,7 +287,7 @@ export default function ProjectsPage() {
 Câblez la synchronisation en direct une fois à proximité du shell de l'application afin que les caches de requête React s'actualisent lorsque l'agent, un autre onglet ou une action modifie les données :
 
 ```tsx
-import { useDbSync } from "@agent-native/core/client";
+import { useDbSync } from "@agent-native/core/client/hooks";
 import { useQueryClient } from "@tanstack/react-query";
 
 export function AppSync() {
@@ -298,7 +300,7 @@ export function AppSync() {
 **La promesse native de l'agent : les écritures de l'agent s'affichent dans le UI sans actualisation manuelle.** `useActionQuery` est la voie la plus simple : chaque hook est récupéré lorsqu'une action de mutation émet `source: "action"`. Si vous accédez au `useQuery` brut avec une clé personnalisée (par exemple, un assistant client de bas niveau qui lit l'état d'intégration), insérez le compteur par source dans la clé de requête pour des actualisations ciblées :
 
 ```tsx
-import { useChangeVersions } from "@agent-native/core/client";
+import { useChangeVersions } from "@agent-native/core/client/hooks";
 
 const v = useChangeVersions(["dashboards", "action"]);
 useQuery({
@@ -321,7 +323,7 @@ L'état de l'application indique comment l'agent sait ce que l'utilisateur voit.
 Utilisez `useAgentRouteState` pour le hook UI afin que les écritures dans l'état de l'application, les lectures de commandes par tabulation, la suppression après lecture et la protection contre les commandes en double restent cohérentes :
 
 ```tsx
-import { useAgentRouteState } from "@agent-native/core/client";
+import { useAgentRouteState } from "@agent-native/core/client/navigation";
 import { TAB_ID } from "@/lib/tab-id";
 
 export function useNavigationState() {

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

@@ -0,0 +1,10 @@
+---
+title: Doctor
+description: Vérifications de sécurité et de migration.
+---
+
+# Doctor
+
+`agent-native doctor` exécute huit contrôles: les sept contrôles de sécurité et `migration-manifest`. Celui-ci détecte les imports présents dans le `migration-manifest.json` installé et n'a pas d'opt-out. Lancez `agent-native doctor --only migration-manifest`, prévisualisez avec `npx @agent-native/core@latest upgrade --codemods`, puis appliquez avec `--yes`. La sortie JSON liste les huit noms dans `guardsRun`.
+
+Les entrées marquées `planned` sont uniquement signalées comme avertissements et ne sont pas réécrites. Les entrées actives sont des constats; le codemod ne les réécrit que si l'export de destination est installé.

package/docs/content/locales/fr-FR/drop-in-agent.mdx

@@ -105,7 +105,7 @@ les enfants restent dans la zone principale de l'application. Le chat de l'agent
   filename="app/root.tsx"
   language="tsx"
   code={
-    'import { Outlet } from "react-router";\nimport { AgentSidebar, AgentToggleButton } from "@agent-native/core/client";\n\nexport default function Root() {\n  return (\n    <AgentSidebar\n      emptyStateText="Comment puis-je aider ?"\n      suggestions={[\n        "Summarize my inbox",\n        "Draft a reply to the latest email",\n        "Show me yesterday\'s signup numbers",\n      ]}\n      dynamicSuggestions\n      defaultSidebarWidth={420}\n      position="right"\n    >\n      <header>\n        <AgentToggleButton />\n      </header>\n\n      <main>\n        <Outlet />\n      </main>\n    </AgentSidebar>\n  );\n}'
+    'import { Outlet } from "react-router";\nimport { AgentSidebar, AgentToggleButton } from "@agent-native/core/client/agent-chat";\n\nexport default function Root() {\n  return (\n    <AgentSidebar\n      emptyStateText="Comment puis-je aider ?"\n      suggestions={[\n        "Summarize my inbox",\n        "Draft a reply to the latest email",\n        "Show me yesterday\'s signup numbers",\n      ]}\n      dynamicSuggestions\n      defaultSidebarWidth={420}\n      position="right"\n    >\n      <header>\n        <AgentToggleButton />\n      </header>\n\n      <main>\n        <Outlet />\n      </main>\n    </AgentSidebar>\n  );\n}'
   }
   annotations={[
     {
@@ -154,8 +154,7 @@ Lorsque vous avez besoin d'un contrôle total sur la mise en page (un itinérair
 
 ```tsx
 // app/routes/agent.tsx
-import { AgentPanel } from "@agent-native/core/client";
-
+import { AgentPanel } from "@agent-native/core/client/agent-chat";
 export default function AgentRoute() {
   return (
     <div className="h-screen">
@@ -182,8 +181,7 @@ Accessoires complets : `AgentPanelProps` dans `@agent-native/core/client`.
 Un bouton qui confie le travail à l'agent (au lieu d'exécuter un appel `llm()` en ligne — l'anti-modèle du [ladder](/docs/what-is-agent-native#the-ladder)) :
 
 ```tsx
-import { sendToAgentChat } from "@agent-native/core/client";
-
+import { sendToAgentChat } from "@agent-native/core/client/agent-chat";
 <Button
   onClick={() =>
     sendToAgentChat({
@@ -232,8 +230,7 @@ Les appels `sendToAgentChat()` sont transférés vers le chat hôte lorsque cela
 Si vous souhaitez un état de chargement, utilisez le hook `useSendToAgentChat()` : il renvoie à la fois `send` et `isGenerating` :
 
 ```ts
-import { useSendToAgentChat } from "@agent-native/core/client";
-
+import { useSendToAgentChat } from "@agent-native/core/client/agent-chat";
 const { send, isGenerating } = useSendToAgentChat();
 ```
 
@@ -267,8 +264,7 @@ le code client n'apprend pas un deuxième transport ad hoc.
 Lorsque le UI doit exécuter la même opération qu'un outil d'agent exécuterait (échelon 3 du [ladder](/docs/what-is-agent-native#rung-three)), utilisez `useActionMutation` :
 
 ```tsx
-import { useActionMutation } from "@agent-native/core/client";
-
+import { useActionMutation } from "@agent-native/core/client/hooks";
 const { mutate, isPending } = useActionMutation("reply-to-email");
 
 <Button onClick={() => mutate({ emailId, body: "Thanks!" })}>
@@ -298,8 +294,7 @@ import {
   AgentSidebar,
   AgentToggleButton,
   sendToAgentChat,
-} from "@agent-native/core/client";
-
+} from "@agent-native/core/client/agent-chat";
 export default function Root() {
   return (
     <AgentSidebar suggestions={["Draft a reply", "Summarize selection"]}>

package/docs/content/locales/fr-FR/embedding-sdk.mdx

@@ -118,8 +118,7 @@ Sur le client :
 import {
   AgentNativeEmbedded,
   defineClientAction,
-} from "@agent-native/core/client";
-
+} from "@agent-native/core/client/host";
 export function BuilderAppShell({ children, content, editor }) {
   return (
     <AgentNativeEmbedded
@@ -297,8 +296,10 @@ for await (const chunk of sendMessage(
 Pour les applications side-car autonomes ou les iframes d'origine croisée, utilisez le `<AgentNative />` de niveau inférieur. Il restitue le contexte de la page side-car et des fils iframe, le client en direct actions et les commandes d'actualisation/navigation de l'hôte en un seul endroit :
 
 ```tsx
-import { AgentNative, defineClientAction } from "@agent-native/core/client";
-
+import {
+  AgentNative,
+  defineClientAction,
+} from "@agent-native/core/client/host";
 export function AssistantDock({ customer, sessionToken }) {
   return (
     <AgentNative
@@ -385,8 +386,7 @@ import {
   requestAgentNativeHostContext,
   runAgentNativeHostAction,
   sendAgentNativeHostCommand,
-} from "@agent-native/core/client";
-
+} from "@agent-native/core/client/host";
 announceAgentNativeFrameReady({ hostOrigin: "https://app.example.com" });
 
 const context = await requestAgentNativeHostContext({
@@ -463,8 +463,7 @@ Dans l'application side-car, démarrez le pont de session de navigateur une fois
 
 ```tsx
 import { useEffect } from "react";
-import { startAgentNativeBrowserSessionBridge } from "@agent-native/core/client";
-
+import { startAgentNativeBrowserSessionBridge } from "@agent-native/core/client/host";
 export function SidecarRuntime() {
   useEffect(() => {
     const bridge = startAgentNativeBrowserSessionBridge({
@@ -516,8 +515,7 @@ import {
   AgentNativeExtensionSlot,
   createHttpAgentNativeExtensionStorage,
   defineClientAction,
-} from "@agent-native/core/client";
-
+} from "@agent-native/core/client/host";
 const storage = createHttpAgentNativeExtensionStorage({
   endpoint: "/api/agent-native/extensions/storage",
   headers: () => ({ Authorization: `Bearer ${sessionToken()}` }),

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

@@ -15,7 +15,11 @@ En anglais lorsqu'une application n'a pas encore traduit une chaîne.
 Utilisez le fournisseur via `AppProviders` :
 
 ```tsx
-import { AppProviders, getLocaleInitScript } from "@agent-native/core/client";
+import {
+  AppProviders,
+} from "@agent-native/core/client/hooks"import {
+  getLocaleInitScript,
+} from "@agent-native/core/client/i18n"
 import { i18nCatalog } from "./i18n";
 
 const LOCALE_INIT_SCRIPT = getLocaleInitScript();
@@ -42,8 +46,7 @@ Chaque modèle localisé conserve les catalogues sous `app/i18n/` :
 ```ts
 // app/i18n/index.ts
 import enUS from "./en-US";
-import type { AgentNativeI18nCatalog } from "@agent-native/core/client";
-
+import type { AgentNativeI18nCatalog } from "@agent-native/core/client/i18n";
 export const i18nCatalog = {
   sourceLocale: "en-US",
   messages: enUS,
@@ -71,10 +74,10 @@ l'icône de langue d'en-tête n'est qu'un raccourci.
 ```tsx
 import {
   LanguagePicker,
-  openAgentSettings,
   useT,
-} from "@agent-native/core/client";
-
+} from "@agent-native/core/client/i18n"import {
+  openAgentSettings,
+} from "@agent-native/core/client/navigation"
 function SettingsPage() {
   const t = useT();
   return (

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

@@ -256,8 +256,7 @@ Le UI n’appelle jamais directement un LLM. Lorsqu'un utilisateur clique sur «
 
 ```ts
 // In a React component — delegate AI work to the agent
-import { sendToAgentChat } from "@agent-native/core/client";
-
+import { sendToAgentChat } from "@agent-native/core/client/agent-chat";
 sendToAgentChat({
   message: "Generate a chart showing signups by source",
   context: "Dashboard ID: main, date range: last 30 days",
@@ -308,8 +307,7 @@ Les modifications de la base de données sont synchronisées avec le UI via `use
 
 ```ts
 // Client: subscribe to agent/UI data changes once near the app shell
-import { useDbSync } from "@agent-native/core/client";
-
+import { useDbSync } from "@agent-native/core/client/hooks";
 useDbSync({ queryClient });
 ```
 

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

@@ -96,8 +96,7 @@ Ajoutez le tableau de bord à n'importe quel modèle avec un seul itinéraire :
 
 ```tsx
 // app/routes/observability.tsx
-import { ObservabilityDashboard } from "@agent-native/core/client";
-
+import { ObservabilityDashboard } from "@agent-native/core/client/observability";
 export default function ObservabilityPage() {
   return (
     <div className="min-h-screen bg-background p-6">

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

@@ -19,3 +19,9 @@ L'ajout et l'éjection sont simulés par défaut. `--apply` autorise les écritu
 et le gestionnaire de paquets. La CLI refuse les collisions et dispositions
 inconnues, puis restaure fichiers et verrous si l'installation échoue. Seul
 Scheduling est éjectable pendant ce pilote; Pinpoint reste différé.
+
+## Migrations
+
+Les paquets publiés livrent `migration-manifest.json` pour les chemins et symboles déplacés. `npx @agent-native/core@latest upgrade --codemods` prévisualise le diff; `--yes` l'applique après revue. Exécutez `agent-native doctor --only migration-manifest` en CI: aucun opt-out.
+
+Les entrées `planned` peuvent être publiées avant leur destination; elles apparaissent comme des avertissements non bloquants et le codemod ne les réécrit pas. Un déplacement actif n'est réécrit que si l'export de destination est installé.