@agent-native/core 0.109.3 → 0.110.0

package/corpus/core/docs/content/locales/de-DE/creating-templates.mdx

@@ -270,8 +270,10 @@ Verwenden Sie `http: { method: "GET" }` oder `readOnly: true` für schreibgesch
 Routen leben in `app/routes/` und verwenden das Dateirouting von React Router v8. Fragen Sie Daten über actions- oder API-Handler ab und machen Sie Mutationen standardmäßig optimistisch.
 
 ```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");
@@ -287,7 +289,7 @@ export default function ProjectsPage() {
 Verdrahten Sie die Live-Synchronisierung einmal in der Nähe der App-Shell, damit React Abfrage-Caches aktualisiert werden, wenn der Agent, eine andere Registerkarte oder eine Aktion Daten ändert:
 
 ```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() {
@@ -300,7 +302,7 @@ export function AppSync() {
 **Das agentennative Versprechen: Agentenschreibvorgänge werden im UI ohne manuelle Aktualisierung angezeigt.** `useActionQuery` ist der einfache Weg – jeder Hook wird erneut abgerufen, wenn eine mutierende Aktion `source: "action"` ausgibt. Wenn Sie mit einem benutzerdefinierten Schlüssel nach dem rohen `useQuery` greifen (z. B. einem Low-Level-Client-Helper, der den Integrationsstatus liest), falten Sie den Zähler pro Quelle in den queryKey für gezielte Aktualisierungen:
 
 ```tsx
-import { useChangeVersions } from "@agent-native/core/client";
+import { useChangeVersions } from "@agent-native/core/client/hooks";
 
 const v = useChangeVersions(["dashboards", "action"]);
 useQuery({
@@ -323,7 +325,7 @@ Durch den Anwendungsstatus weiß der Agent, was der Benutzer sieht. Fügen Sie m
 Verwenden Sie `useAgentRouteState` für den UI-Hook, damit Anwendungsstatus-Schreibvorgänge, tabulatorbezogene Befehlslesevorgänge, Löschung nach dem Lesen und Schutz vor doppelten Befehlen konsistent bleiben:
 
 ```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/corpus/core/docs/content/locales/de-DE/doctor.mdx

@@ -0,0 +1,10 @@
+---
+title: Doctor
+description: Sicherheits- und Migrationsprüfungen.
+---
+
+# Doctor
+
+`agent-native doctor` führt acht Guards aus: sieben Sicherheits-Guards und `migration-manifest`. Dieser findet Imports aus installiertem `migration-manifest.json` und hat kein Opt-out. Nutzen Sie `agent-native doctor --only migration-manifest`, prüfen Sie mit `npx @agent-native/core@latest upgrade --codemods` vor und wenden Sie mit `--yes` an. JSON listet alle acht Namen in `guardsRun`.
+
+Einträge mit `planned` werden nur als Warnungen gemeldet und nicht umgeschrieben. Aktive Einträge sind Findings; der Codemod schreibt sie nur um, wenn der Ziel-Export installiert ist.

package/corpus/core/docs/content/locales/de-DE/drop-in-agent.mdx

@@ -105,7 +105,7 @@ Kinder bleiben im Haupt-App-Bereich. Der Agenten-Chat ist der Seitenbereich.
   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="Wie kann ich helfen?"\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="Wie kann ich helfen?"\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 @@ Wenn Sie die volle Kontrolle über das Layout benötigen – eine dedizierte `/c
 
 ```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 @@ Vollständige Requisiten: `AgentPanelProps` in `@agent-native/core/client`.
 Eine Schaltfläche, die die Arbeit an den Agenten übergibt (anstatt einen Inline-`llm()`-Aufruf auszuführen – das Anti-Pattern von [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 @@ Wenn dieselbe Route als MCP-App eingebettet ist, wird sie übermittelt
 Wenn Sie einen Ladezustand wünschen, verwenden Sie den Hook `useSendToAgentChat()` – er gibt sowohl `send` als auch `isGenerating` zurück:
 
 ```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 @@ Client-Code lernt keinen zweiten Ad-hoc-Transport.
 Wenn der UI den gleichen Vorgang ausführen muss, den ein Agent-Tool ausführen würde – Strompfad 3 des [ladder](/docs/what-is-agent-native#rung-three) – verwenden Sie `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/corpus/core/docs/content/locales/de-DE/embedding-sdk.mdx

@@ -118,8 +118,7 @@ Auf dem 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(
 Verwenden Sie für eigenständige Sidecar-Apps oder ursprungsübergreifende Iframes den untergeordneten `<AgentNative />`. Es rendert den Iframe-Sidecar- und Wire-Seitenkontext, den Live-Client actions und die Aktualisierungs-/Navigationsbefehle des Hosts an einem Ort:
 
 ```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({
@@ -461,8 +461,7 @@ Starten Sie in der Sidecar-App die Browser-Session-Bridge einmal, wenn der Ifram
 
 ```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({
@@ -514,8 +513,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/corpus/core/docs/content/locales/de-DE/internationalization.mdx

@@ -15,7 +15,11 @@ Englisch, wenn eine App eine Zeichenfolge noch nicht übersetzt hat.
 Verwenden Sie den Anbieter über `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 @@ Jede lokalisierte Vorlage behält Kataloge unter `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 @@ Das Sprachsymbol in der Kopfzeile ist nur eine Verknüpfung.
 ```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/corpus/core/docs/content/locales/de-DE/key-concepts.mdx

@@ -256,8 +256,7 @@ Der UI ruft niemals einen LLM direkt auf. Wenn ein Benutzer auf „Diagramm erst
 
 ```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 @@ Datenbankänderungen werden über `useDbSync()` mit dem UI synchronisiert. Gleic
 
 ```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/corpus/core/docs/content/locales/de-DE/observability.mdx

@@ -94,8 +94,7 @@ Fügen Sie das Dashboard mit einer einzigen Route zu jeder Vorlage hinzu:
 
 ```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/corpus/core/docs/content/locales/de-DE/package-lifecycle.mdx

@@ -20,3 +20,9 @@ Dateien und startet den erkannten Paketmanager. Kollisionen und unbekannte
 Layouts werden abgelehnt; bei einem Installationsfehler werden Dateien und
 Lockdateien zurückgesetzt. Zunächst unterstützt nur Scheduling das Auswerfen;
 Pinpoint bleibt bis nach dem Pilotprojekt zurückgestellt.
+
+## Migrationen
+
+Veröffentlichte Pakete enthalten `migration-manifest.json` für verschobene Pfade und Symbole. `npx @agent-native/core@latest upgrade --codemods` zeigt den Diff; `--yes` wendet ihn nach Prüfung an. In CI: `agent-native doctor --only migration-manifest`, ohne Opt-out.
+
+Einträge mit `planned` können vor ihrem Ziel veröffentlicht werden; sie erscheinen als nicht blockierende Warnungen und werden nicht umgeschrieben. Ein aktiver Move wird nur umgeschrieben, wenn der Ziel-Export installiert ist.

package/corpus/core/docs/content/locales/de-DE/real-time-collaboration.mdx

@@ -258,7 +258,7 @@ export default createCollabPlugin({
 ### 4. Verwenden Sie den Client-Hook
 
 ```ts
-import { useCollaborativeDoc } from "@agent-native/core/client";
+import { useCollaborativeDoc } from "@agent-native/core/client/collab";
 import { emailToColor, emailToName } from "@agent-native/toolkit/collab-ui";
 
 const TAB_ID = generateTabId(); // or Math.random().toString(36)
@@ -431,8 +431,7 @@ import {
 Gibt eine reaktive Liste von Remote-Teilnehmern und einen Setter für die lokale Präsenznutzlast zurück:
 
 ```ts
-import { usePresence } from "@agent-native/core/client";
-
+import { usePresence } from "@agent-native/core/client/collab";
 const { others, setPresence } = usePresence(awareness, ydoc?.clientID);
 
 // Publish cursor position (normalized 0–1)
@@ -494,8 +493,7 @@ import { RemoteSelectionRings } from "@agent-native/toolkit/collab-ui";
 Rufen Sie einen Rückruf auf, wenn sich das Ansichtsfenster des verfolgten Teilnehmers ändert:
 
 ```ts
-import { useFollowUser } from "@agent-native/core/client";
-
+import { useFollowUser } from "@agent-native/core/client/collab";
 const { isFollowing, stopFollowing } = useFollowUser({
   others,
   followingId, // null to stop following
@@ -529,8 +527,7 @@ Die `PresenceBar`-Komponente akzeptiert jetzt optionale Follow-Mode-Requisiten:
 ### Normalisierte Koordinatenhelfer {#norm-coords}
 
 ```ts
-import { toNormalized, fromNormalized } from "@agent-native/core/client";
-
+import { toNormalized, fromNormalized } from "@agent-native/core/client/collab";
 // In a pointer event handler:
 const norm = toNormalized(
   e.clientX,

package/corpus/core/docs/content/locales/de-DE/sharing.mdx

@@ -122,8 +122,7 @@ Jede gemeinsam nutzbare Ressource erhält in ihrer Kopfzeile eine Schaltfläche
 Die Schaltfläche „Teilen“ ist ein einzelner Import:
 
 ```tsx
-import { ShareButton } from "@agent-native/core/client";
-
+import { ShareButton } from "@agent-native/core/client/sharing";
 <ShareButton
   resourceType="deck"
   resourceId={deck.id}

package/corpus/core/docs/content/locales/de-DE/template-chat.mdx

@@ -164,8 +164,7 @@ Die Chat-Seite ist absichtlich dünn:
 
 ```tsx
 // app/routes/_index.tsx
-import { AgentChatSurface } from "@agent-native/core/client";
-
+import { AgentChatSurface } from "@agent-native/core/client/agent-chat";
 export default function ChatRoute() {
   return (
     <AgentChatSurface

package/corpus/core/docs/content/locales/de-DE/toolkit-capability-packages.mdx

@@ -0,0 +1,21 @@
+---
+title: "Capability-Pakete"
+description: "Verwalten Sie fachliche Fähigkeiten und ihren manifestgesteuerten Lebenszyklus, ohne sie in Toolkit einzugliedern."
+---
+
+# Capability-Pakete
+
+Toolkit liefert bereichsübergreifende Produktgrundlagen; Capability-Pakete liefern ein abgegrenztes Domänenmodell, Actions, Skills und Lebenszyklus-Metadaten. Scheduling und Creative Context bleiben separate Capability-Pakete, keine Toolkit-Feature-Kits.
+
+`@agent-native/scheduling` nimmt am Pilot für das generische Manifest teil. Lesen Sie die paketlokale Dokumentation und das Manifest für Erweiterungspunkte und Zuständigkeit.
+
+- [Scheduling-Paketdokumentation](https://github.com/BuilderIO/agent-native/tree/main/packages/scheduling/docs)
+- [Creative-Context-Paketdokumentation](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
+```
+
+Die Regeln für Prüfung, Dry Run und Eject stehen unter [Package Lifecycle](/docs/package-lifecycle).

package/corpus/core/docs/content/locales/de-DE/toolkit-context-knowledge.mdx

@@ -0,0 +1,12 @@
+---
+title: "Kontext und Wissen"
+description: "Bauen Sie agentenfähige Kontextoberflächen mit klaren Grenzen zwischen Engine, Datenzugriff und wiederverwendbarer Darstellung."
+---
+
+# Kontext und Wissen
+
+Core besitzt Anwendungszustand, bereichsgebundenen Zugriff und die Context-X-Ray-Engine. Toolkit liefert die wiederverwendbare Darstellung; die App behält Domänendaten, Taxonomie und Auswahlregeln.
+
+Die Context-X-Ray-Engine bleibt Core-geführt. Verwenden Sie Toolkit für eine einheitliche Darstellung, behalten Sie Zustands- und Zugriffsentscheidungen aber in Core und Actions. [Context awareness](/docs/context-awareness) macht Navigation, Auswahl und Fokusobjekt für den Agent sichtbar; [Resources](/docs/toolkit-resources) deckt Dateien und Anhänge ab.
+
+Kontext ersetzt keine Zugriffskontrolle. Erhalten Sie Ressourcen- und Berechtigungsprüfungen vor dem Abruf von Anbieterwissen.

package/corpus/core/docs/content/locales/de-DE/toolkit-editors-canvases.mdx

@@ -0,0 +1,17 @@
+---
+title: "Editor und Arbeitsflächen"
+description: "Wählen Sie wiederverwendbare Oberflächen, ohne Core-Kompatibilität, Template-Muster und Toolkit-Primitiven zu verwechseln."
+---
+
+# Editor und Arbeitsflächen
+
+Editoren und Arbeitsflächen sind verwandte Oberflächen, kein einzelnes Leitfeature.
+
+| Oberfläche          | Aktuelle Zuständigkeit                                                        |
+| ------------------- | ----------------------------------------------------------------------------- |
+| Rich Editor         | Toolkit, mit Kompatibilitäts-Re-Exports aus Core.                             |
+| Blöcke              | In dieser Phase Core.                                                         |
+| Design              | Template-Muster mit `design-tweaks`, kein vollständiger Plug-and-play-Editor. |
+| Canvas-Präsentation | Toolkit- oder App-Komposition.                                                |
+
+Importieren Sie den Editor aus `@agent-native/toolkit/editor`. Die alten Core-Pfade bleiben als Kompatibilitäts-Re-Exports erhalten. Schemata, Befehle und Persistenz bleiben in der App. Blöcke bleiben in Core, werden aber hier dokumentiert, weil der Toolkit-Bereich der Katalog für wiederverwendbare UI ist.

package/corpus/core/docs/content/locales/de-DE/tracking.mdx

@@ -176,8 +176,7 @@ Identity is resolved **server-side** from the session — browser code never pas
 </Endpoint>
 
 ```ts
-import { track } from "@agent-native/core/client";
-
+import { track } from "@agent-native/core/client/analytics";
 // e.g. inside a click handler or effect
 track("checkout.completed", { total: 49.99, items: 3 });
 ```
@@ -196,8 +195,7 @@ Dies unterscheidet sich von der internen Browser-Telemetrie des Frameworks (`tra
 Agent-Native-Apps können sich für erstklassiges browserseitiges Session Replay entscheiden, ohne ein zweites Analytics-SDK hinzuzufügen. Rufen Sie `configureTracking()` einmal im Browser-Root auf und übergeben Sie den öffentlichen Analytics-Schlüssel sowie den Collector-Endpunkt:
 
 ```ts
-import { configureTracking } from "@agent-native/core/client";
-
+import { configureTracking } from "@agent-native/core/client/analytics";
 configureTracking({
   key: "anpk_...",
   endpoint: "https://analytics.example.com/api/analytics/track",

package/corpus/core/docs/content/locales/de-DE/what-is-agent-native.mdx

@@ -289,8 +289,7 @@ const { mutate } = useActionMutation("reply-to-email");
 
 ```tsx
 // And the agent panel mounted anywhere in your app
-import { AgentSidebar } from "@agent-native/core/client";
-
+import { AgentSidebar } from "@agent-native/core/client/agent-chat";
 <AgentSidebar />;
 ```
 

package/corpus/core/docs/content/locales/es-ES/actions.mdx

@@ -443,8 +443,7 @@ Dos ganchos, ambos en `@agent-native/core/client`. Los tipos se infieren a parti
 Para actions que cambia de estado:
 
 ```tsx
-import { useActionMutation } from "@agent-native/core/client";
-
+import { useActionMutation } from "@agent-native/core/client/hooks";
 const { mutate, isPending } = useActionMutation("reply-to-email");
 
 <Button
@@ -462,8 +461,7 @@ En caso de éxito, el marco emite un evento de cambio con `source: "action"` par
 Para GET actions de solo lectura:
 
 ```ts
-import { useActionQuery } from "@agent-native/core/client";
-
+import { useActionQuery } from "@agent-native/core/client/hooks";
 const { data, isLoading } = useActionQuery("get-lead", { leadId });
 ```
 

package/corpus/core/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/corpus/core/docs/content/locales/es-ES/agent-surfaces.mdx

@@ -15,8 +15,7 @@ que los modos Resources y Settings enlacen a la página completa sin duplicar
 estos flujos.
 
 ```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 />;
 }
@@ -420,8 +419,7 @@ export default createAgentNativeEmbeddedPlugin({
 El sidecar React pasa el contexto de la página y los comandos del host:
 
 ```tsx
-import { AgentNativeEmbedded } from "@agent-native/core/client";
-
+import { AgentNativeEmbedded } from "@agent-native/core/client/host";
 export function AppShell({ children }) {
   return (
     <AgentNativeEmbedded