@agent-native/core 0.109.3 → 0.109.4

package/docs/content/locales/es-ES/agent-native-toolkit.mdx

@@ -1,21 +1,25 @@
 ---
-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 catálogo equilibrado de bases reutilizables, editores y lienzos, contexto de agentes, gobernanza, chrome del espacio de trabajo, operaciones y módulos de capacidad de 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 es la estantería de bloques reutilizables y probados para aplicaciones
+agénticas de alta calidad. Convierte el trabajo de producto que se repite entre
+apps en superficies estándar, sin poner un patrón de aplicación en el centro del
+catálogo.
+
+Esta sección es el único lugar para descubrir UI reutilizable al crear apps. Una
+superficie pertenece a estos documentos porque es reutilizable, incluso si hoy
+la implementa Core o una plantilla. Las etiquetas de propiedad y las rutas de
+importación hacen explícito ese límite sin dispersar la guía por el sitio.
 
 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 +32,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="Cómo encajan los kits" summary={"El runtime del framework ofrece garantías duraderas. Toolkit las convierte en sistemas de producto reutilizables. Las apps añaden datos de dominio, rutas e identidad visual."}>
 
 ```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
+    acciones, SQL, autenticación, estado de app, controles de acceso, transporte
+    en tiempo real
   </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 />
+    colaboración, compartir, configuración, revisión, historial, observabilidad
   </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
+    esquema de dominio, rutas, acciones, marca, flujos especializados
   </div>
 </div>
 ```
@@ -68,45 +73,69 @@ being rebuilt in slightly different ways every time.
 
 </Diagram>
 
-## The Kits {#the-kits}
+## Catálogo {#catalog}
+
+| Área                              | Empieza aquí                                               | Qué cubre                                                                                       |
+| --------------------------------- | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
+| Fundamentos                       | [Primitivas de UI](/docs/toolkit-ui)                       | Controles, hooks, adaptadores de app y puntos de integración de shell compartidos.              |
+| Editores y lienzos                | [Editores y lienzos](/docs/toolkit-editors-canvases)       | Edición enriquecida, bloques estructurados, controles de lienzo y patrones de Design.           |
+| Experiencia y contexto del agente | [Contexto y conocimiento](/docs/toolkit-context-knowledge) | Context X-Ray, recursos, conocimiento, contexto del compositor y estado visible para el agente. |
+| Colaboración y gobernanza         | [Colaboración](/docs/toolkit-collaboration)                | Compartir, presencia, revisión, historial, auditoría y límites de organización.                 |
+| Chrome del espacio de trabajo     | [Chrome de app](/docs/toolkit-settings)                    | Ajustes, equipos, configuración, navegación, recursos y UX de agente.                           |
+| Operaciones                       | [Observabilidad](/docs/toolkit-observability)              | Uso, feedback, replay, diagnóstico y visibilidad operativa.                                     |
+| Módulos de capacidad de Toolkit   | [Paquetes de capacidad](/docs/toolkit-capability-packages) | Paquetes de dominio instalados bajo demanda y sus manifiestos de ciclo de vida.                 |
+
+## Kits de producto {#product-kits}
 
-| Kit                                                      | Use it for                                                                                                  |
+| Kit                                                      | Úsalo para                                                                                                  |
 | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
-| [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
+| [Sharing](/docs/toolkit-sharing)                         | Recursos propios, diálogos y acciones de compartir, insignias de visibilidad y acceso público/privado/org.  |
+| [Collaboration](/docs/toolkit-collaboration)             | Edición en tiempo real, presencia, cursores en vivo, cambios recientes y deshacer colaborativo.             |
+| [Settings](/docs/toolkit-settings)                       | Páginas y pestañas estándar para ajustes de la app y del agente/proveedor en un lugar predecible.           |
+| [Org & Team](/docs/toolkit-org-team)                     | Páginas de equipo, cambio de organización, invitaciones, dominios, roles y cambio de app.                   |
+| [Setup & Connections](/docs/toolkit-setup-connections)   | Incorporación, secretos, conexiones de espacio de trabajo, OAuth/preparación de proveedor y Builder.        |
+| [Command & Navigation](/docs/toolkit-command-navigation) | Menú de comandos, enlaces profundos, rutas estándar, patrones de barra lateral y shell.                     |
+| [Resources](/docs/toolkit-resources)                     | Árboles y editores de recursos, selector/búsqueda de archivos, adjuntos y modo de archivo local.            |
+| [Agent UX](/docs/toolkit-agent-ux)                       | Compositor, selector de modelo, chips de contexto, aprobaciones, recuperación y bandeja de ejecuciones.     |
+| [History](/docs/toolkit-history)                         | Recursos versionados, acciones de instantánea, historial, auditoría, deshacer/rehacer, restaurar y cambios. |
+| [Comments & Review](/docs/toolkit-comments-review)       | Recursos revisables, comentarios, colas de feedback, hilos, menciones, resolución y estado de revisión.     |
+| [Observability](/docs/toolkit-observability)             | Uso, gasto, feedback, replay, errores y diagnósticos de ejecución.                                          |
+
+## Madurez y propiedad de paquetes {#package-maturity-and-ownership}
+
+- El editor enriquecido es propiedad de **Toolkit**; los imports existentes de Core siguen siendo reexportaciones de compatibilidad ligeras durante la migración.
+- Design es un **patrón de plantilla** con `design-tweaks` reutilizables, no un editor ni lienzo completo listo para usar.
+- Blocks y el motor Context X-Ray siguen siendo propiedad de **Core** en esta fase; la presentación reutilizable de Context X-Ray es de Toolkit.
+- Creative Context, Scheduling y Pinpoint son **módulos de capacidad de Toolkit** instalados bajo demanda; conservan paquetes npm y manifiestos de ciclo de vida separados. Dispatch sigue siendo un producto separado.
+
+## Límite de implementación {#implementation-boundary}
+
+Los kits son primero superficies de producto. Algunas piezas usan el 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.
+Usa la ruta del paquete que posee el comportamiento necesario, pero diseña las
+experiencias de ajustes, colaboración, compartir, equipo, revisión y
+configuración como un kit coherente, sin exponer límites de paquetes en la app.
+
+## Piezas fundamentales {#foundation-pieces}
+
+- [Primitivas de UI](/docs/toolkit-ui) cubre las primitivas compartidas estilo
+  shadcn bajo `@agent-native/toolkit/ui/*`, el patrón de adaptador local de cada
+  plantilla y los hooks de shell compartidos.
+- [API de componentes](/docs/components) sigue siendo la referencia de nivel
+  inferior para los exports públicos de React.
+
+## Regla de diseño {#design-rule}
+
+Usa un kit cuando el comportamiento se repite entre apps y los usuarios esperan
+que sea estándar: compartir, ajustes, equipos, comentarios, historial y
+progreso del agente no deberían variar entre plantillas. Conserva en la app los
+datos, flujos, etiquetas y estilo visual específicos del dominio.
+
+## Próximos pasos
+
+- [**Primitivas de UI de Toolkit**](/docs/toolkit-ui) — primitivas compartidas, adaptadores de app y hooks de shell.
+- [**Kit de compartir**](/docs/toolkit-sharing) — un buen primer kit para recursos, diálogos de compartir y visibilidad.
+- [**Crear plantillas**](/docs/creating-templates) — crea una plantilla completa y ve dónde encajan los kits.
+- [**API de componentes**](/docs/components) — la referencia de todos los exports públicos de React.
+- [**Ciclo de vida de paquetes**](/docs/package-lifecycle) — inspecciona, añade y expulsa módulos de capacidad de Toolkit guiados por manifiestos de forma segura.

package/docs/content/locales/es-ES/toolkit-capability-packages.mdx

@@ -0,0 +1,21 @@
+---
+title: "Paquetes de capacidad"
+description: "Gestiona capacidades de dominio y su ciclo de vida mediante manifiestos sin incorporarlas a Toolkit."
+---
+
+# Paquetes de capacidad
+
+Toolkit ofrece bases de producto transversales; los paquetes de capacidad aportan un dominio delimitado, acciones, habilidades y metadatos de ciclo de vida. Scheduling y Creative Context son paquetes de capacidad separados, no kits de Toolkit.
+
+`@agent-native/scheduling` participa en el piloto del manifiesto genérico. Consulta la documentación local y el manifiesto de cada paquete para sus puntos de extensión y propiedad.
+
+- [Documentación del paquete Scheduling](https://github.com/BuilderIO/agent-native/tree/main/packages/scheduling/docs)
+- [Documentación del paquete Creative Context](https://github.com/BuilderIO/agent-native/tree/main/packages/creative-context/docs)
+
+```bash
+agent-native package inspect @agent-native/scheduling
+agent-native package add @agent-native/scheduling --apply
+agent-native package eject @agent-native/scheduling --apply
+```
+
+Consulta [Ciclo de vida de paquetes](/docs/package-lifecycle) para las reglas de inspección, simulación y expulsión.

package/docs/content/locales/es-ES/toolkit-context-knowledge.mdx

@@ -0,0 +1,12 @@
+---
+title: "Contexto y conocimiento"
+description: "Crea superficies de contexto para agentes respetando las capas de motor, acceso a datos y presentación reutilizable."
+---
+
+# Contexto y conocimiento
+
+Core conserva el estado de aplicación, el acceso con alcance y el motor de Context X-Ray. Toolkit proporciona la presentación reutilizable; la app conserva sus registros de dominio, taxonomía y reglas de selección.
+
+El motor de Context X-Ray sigue siendo de Core. Usa la presentación de Toolkit para mostrar contexto de forma coherente, pero mantén decisiones de estado y acceso en Core y acciones. [Context awareness](/docs/context-awareness) hace visible para el agente la navegación, selección y objeto enfocado; [Resources](/docs/toolkit-resources) cubre archivos y adjuntos.
+
+El contexto nunca sustituye los controles de acceso. Conserva las comprobaciones de recursos y credenciales antes de recuperar conocimiento de proveedores.

package/docs/content/locales/es-ES/toolkit-editors-canvases.mdx

@@ -0,0 +1,21 @@
+---
+title: "Editores y lienzos"
+description: "Elige superficies reutilizables sin confundir compatibilidad de Core, patrones de plantilla y primitivas de Toolkit."
+---
+
+# Editores y lienzos
+
+Los editores y lienzos son superficies relacionadas, no una única función principal.
+
+| Superficie             | Propiedad actual                                                           |
+| ---------------------- | -------------------------------------------------------------------------- |
+| Editor enriquecido     | Toolkit, con reexportaciones de compatibilidad desde Core.                 |
+| Bloques                | Core en esta fase.                                                         |
+| Design                 | Patrón de plantilla con `design-tweaks`, no un editor instalable completo. |
+| Presentación de lienzo | Composición de Toolkit o de la app.                                        |
+
+Importa el editor desde `@agent-native/toolkit/editor`. Las rutas antiguas de Core siguen funcionando como reexportaciones de compatibilidad. Mantén en la app los esquemas, comandos y persistencia. Los bloques siguen en Core, pero se documentan aquí porque la sección Toolkit es el catálogo de UI reutilizable.
+
+- [Resumen de Toolkit](/docs/agent-native-toolkit)
+- [Plantilla Design](/docs/template-design)
+- [Colaboración en tiempo real](/docs/real-time-collaboration)

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/toolkit-capability-packages.mdx

@@ -0,0 +1,21 @@
+---
+title: "Packages de capacité"
+description: "Gérez des capacités métier et leur cycle de vie piloté par manifeste sans les intégrer à Toolkit."
+---
+
+# Packages de capacité
+
+Toolkit fournit des fondations produit transversales ; les packages de capacité apportent un domaine borné, des actions, des skills et des métadonnées de cycle de vie. Scheduling et Creative Context restent des packages de capacité séparés, pas des kits Toolkit.
+
+`@agent-native/scheduling` participe au pilote de manifeste générique. Consultez la documentation locale et le manifeste de chaque package pour les points d'extension et la propriété.
+
+- [Documentation du package Scheduling](https://github.com/BuilderIO/agent-native/tree/main/packages/scheduling/docs)
+- [Documentation du package Creative Context](https://github.com/BuilderIO/agent-native/tree/main/packages/creative-context/docs)
+
+```bash
+agent-native package inspect @agent-native/scheduling
+agent-native package add @agent-native/scheduling --apply
+agent-native package eject @agent-native/scheduling --apply
+```
+
+Consultez [Cycle de vie des packages](/docs/package-lifecycle) pour l'inspection, le mode simulation et l'éjection.

package/docs/content/locales/fr-FR/toolkit-context-knowledge.mdx

@@ -0,0 +1,12 @@
+---
+title: "Contexte et connaissances"
+description: "Construisez des surfaces de contexte pour l'agent en respectant les couches moteur, accès aux données et présentation réutilisable."
+---
+
+# Contexte et connaissances
+
+Core conserve l'état applicatif, l'accès limité et le moteur Context X-Ray. Toolkit fournit la présentation réutilisable ; l'app conserve ses données de domaine, sa taxonomie et ses règles de sélection.
+
+Le moteur Context X-Ray reste dans Core. Utilisez la présentation Toolkit pour afficher un contexte cohérent, mais gardez état et décisions d'accès dans Core et les actions. [Context awareness](/docs/context-awareness) expose navigation, sélection et objet actif à l'agent ; [Resources](/docs/toolkit-resources) couvre fichiers et pièces jointes.
+
+Le contexte ne remplace jamais les contrôles d'accès. Préservez les vérifications de ressources et de secrets avant de récupérer des connaissances fournisseur.

package/docs/content/locales/fr-FR/toolkit-editors-canvases.mdx

@@ -0,0 +1,21 @@
+---
+title: "Éditeurs et canevas"
+description: "Choisissez des surfaces réutilisables sans confondre compatibilité Core, patrons de modèle et primitives Toolkit."
+---
+
+# Éditeurs et canevas
+
+Les éditeurs et canevas sont des surfaces complémentaires, pas une fonctionnalité vedette unique.
+
+| Surface                 | Propriété actuelle                                                             |
+| ----------------------- | ------------------------------------------------------------------------------ |
+| Éditeur riche           | Toolkit, avec réexportations de compatibilité depuis Core.                     |
+| Blocs                   | Core durant cette phase.                                                       |
+| Design                  | Patron de modèle avec `design-tweaks`, pas un éditeur prêt à l'emploi complet. |
+| Présentation de canevas | Composition Toolkit ou application.                                            |
+
+Importez l'éditeur depuis `@agent-native/toolkit/editor`. Les anciens chemins Core restent disponibles comme réexportations de compatibilité. Gardez schémas, commandes et persistance dans l'app. Les blocs restent dans Core, mais sont documentés ici car la section Toolkit est le catalogue de l'interface réutilisable.
+
+- [Vue d’ensemble Toolkit](/docs/agent-native-toolkit)
+- [Modèle Design](/docs/template-design)
+- [Collaboration temps réel](/docs/real-time-collaboration)