@agent-native/core 0.109.3 → 0.110.0

package/docs/content/locales/ar-SA/observability.mdx

@@ -94,8 +94,7 @@ description: "تتبعات الوكيل، وعمليات التقييم، وال
 
 ```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/ar-SA/package-lifecycle.mdx

@@ -17,3 +17,9 @@ agent-native package eject @agent-native/scheduling --apply
 الإضافة والإخراج معاينة افتراضيًا. يسمح `--apply` بالكتابة وتشغيل مدير الحزم. ترفض
 الأداة التعارضات والتخطيطات غير المعروفة، وتستعيد الملفات وملفات القفل عند فشل التثبيت.
 يدعم الإصدار التجريبي إخراج Scheduling فقط، بينما يبقى Pinpoint مؤجلاً.
+
+## الترحيل
+
+تتضمن الحزم المنشورة `migration-manifest.json` للمسارات والرموز المنقولة. يعاين `npx @agent-native/core@latest upgrade --codemods` الفرق، ثم يطبقه `--yes` بعد المراجعة. شغّل `agent-native doctor --only migration-manifest` في CI؛ لا يوجد opt-out.
+
+يمكن نشر إدخالات `planned` قبل توفر وجهتها؛ تظهر كتحذيرات غير حاجبة ولا يعيد codemod كتابتها. لا يُعاد كتابة النقل النشط إلا إذا كانت وجهة التصدير مثبتة.

package/docs/content/locales/ar-SA/real-time-collaboration.mdx

@@ -256,7 +256,7 @@ export default createCollabPlugin({
 ### 4. استخدم ربط العميل
 
 ```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)
@@ -429,8 +429,7 @@ import {
 إرجاع قائمة تفاعلية للمشاركين عن بعد ومحدد لحمولة التواجد المحلي:
 
 ```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)
@@ -492,8 +491,7 @@ import { RemoteSelectionRings } from "@agent-native/toolkit/collab-ui";
 قم باستدعاء رد الاتصال عندما يتغير إطار عرض المشارك المتابع:
 
 ```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
@@ -527,8 +525,7 @@ const { isFollowing, stopFollowing } = useFollowUser({
 ### مساعدي التنسيق الطبيعي {#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/docs/content/locales/ar-SA/sharing.mdx

@@ -122,8 +122,7 @@ description: "مشاركة مألوفة ومتسقة مدمجة في إطار ا
 زر المشاركة عبارة عن استيراد واحد:
 
 ```tsx
-import { ShareButton } from "@agent-native/core/client";
-
+import { ShareButton } from "@agent-native/core/client/sharing";
 <ShareButton
   resourceType="deck"
   resourceId={deck.id}

package/docs/content/locales/ar-SA/template-chat.mdx

@@ -164,8 +164,7 @@ npx @agent-native/core@latest create my-agent --headless
 
 ```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/docs/content/locales/ar-SA/toolkit-capability-packages.mdx

@@ -0,0 +1,21 @@
+---
+title: "حزم القدرات"
+description: "أدر قدرات المجال ودورة حياتها المدفوعة بالبيان من دون دمجها في Toolkit."
+---
+
+# حزم القدرات
+
+يوفر Toolkit أسس منتج مشتركة بين التطبيقات؛ وتوفر حزم القدرات مجالا محدودا وactions وskills وبيانات دورة الحياة. تظل Scheduling وCreative Context حزم قدرات منفصلة وليستا مجموعات ميزات في Toolkit.
+
+تشارك `@agent-native/scheduling` في تجربة البيان العامة. ارجع إلى توثيق كل حزمة المحلي وبيان دورة حياتها لمعرفة نقاط التوسعة والملكية.
+
+- [توثيق Scheduling](https://github.com/BuilderIO/agent-native/tree/main/packages/scheduling/docs)
+- [توثيق 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
+```
+
+راجع [دورة حياة الحزمة](/docs/package-lifecycle) لقواعد الفحص والتجربة والإخراج.

package/docs/content/locales/ar-SA/toolkit-context-knowledge.mdx

@@ -0,0 +1,12 @@
+---
+title: "السياق والمعرفة"
+description: "أنشئ أسطح سياق مدركة للوكيل مع الحفاظ على الحدود بين المحرك والوصول إلى البيانات والعرض القابل لإعادة الاستخدام."
+---
+
+# السياق والمعرفة
+
+يمتلك Core حالة التطبيق والوصول المقيد ومحرك Context X-Ray. يوفر Toolkit العرض القابل لإعادة الاستخدام، بينما يملك التطبيق سجلات المجال والتصنيف وقواعد الاختيار.
+
+يبقى محرك Context X-Ray مملوكا لـ Core. استخدم عرض Toolkit للسياق المتسق، لكن أبق قرارات الحالة والوصول في Core وactions. يجعل [وعي السياق](/docs/context-awareness) التنقل والاختيار والكائن النشط مرئية للوكيل؛ وتغطي [الموارد](/docs/toolkit-resources) الملفات والمرفقات.
+
+لا يحل السياق محل التحكم بالوصول. حافظ على فحوصات المورد وبيانات الاعتماد قبل استرجاع معرفة الموفر.

package/docs/content/locales/ar-SA/toolkit-editors-canvases.mdx

@@ -0,0 +1,17 @@
+---
+title: "المحررات واللوحات"
+description: "اختر أسطحا قابلة لإعادة الاستخدام من دون الخلط بين توافق Core وأنماط القوالب وبدائيات Toolkit."
+---
+
+# المحررات واللوحات
+
+المحررات واللوحات أسطح منتج مترابطة، وليست ميزة رئيسية واحدة.
+
+| السطح        | الملكية الحالية                                              |
+| ------------ | ------------------------------------------------------------ |
+| المحرر الغني | Toolkit، مع إعادة تصدير للتوافق من Core.                     |
+| الكتل        | Core في هذه المرحلة.                                         |
+| Design       | نمط قالب مع `design-tweaks`، وليس محررا كاملا جاهزا للإضافة. |
+| عرض اللوحة   | تركيب Toolkit أو التطبيق.                                    |
+
+استورد المحرر من `@agent-native/toolkit/editor`. تستمر مسارات Core القديمة كإعادات تصدير للتوافق. أبق المخططات والأوامر والاستمرارية في التطبيق. تبقى الكتل مملوكة لـ Core، لكنها موثقة هنا لأن قسم Toolkit هو فهرس واجهات المستخدم القابلة لإعادة الاستخدام.

package/docs/content/locales/ar-SA/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 @@ track("checkout.completed", { total: 49.99, items: 3 });
 يمكن لتطبيقات Agent Native الاشتراك في إعادة تشغيل جلسة المتصفح من الطرف الأول دون إضافة SDK تحليلات ثانٍ. استدعِ `configureTracking()` مرة واحدة في جذر المتصفح ومرر مفتاح Analytics العام بالإضافة إلى نقطة نهاية المُجمِّع:
 
 ```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/docs/content/locales/ar-SA/what-is-agent-native.mdx

@@ -285,8 +285,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/docs/content/locales/de-DE/actions.mdx

@@ -443,8 +443,7 @@ Zwei Haken, beide in `@agent-native/core/client`. Typen werden aus Ihren `define
 Für actions, die den Status ändern:
 
 ```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 @@ Bei Erfolg gibt das Framework ein Änderungsereignis mit `source: "action"` aus,
 Für schreibgeschütztes GET actions:
 
 ```ts
-import { useActionQuery } from "@agent-native/core/client";
-
+import { useActionQuery } from "@agent-native/core/client/hooks";
 const { data, isLoading } = useActionQuery("get-lead", { leadId });
 ```
 

package/docs/content/locales/de-DE/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: "Ein ausgewogener Katalog wiederverwendbarer Grundlagen, Editoren und Leinwände, Agentenkontext, Governance, Workspace-Chrome, Betrieb und Toolkit-Fähigkeitsmodule."
 ---
 
 <!-- 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 ist das Regal wiederverwendbarer, praxiserprobter Bausteine für
+hochwertige agentische Anwendungen. Es macht wiederkehrende Produktarbeit zu
+Standards, ohne ein einzelnes App-Muster ins Zentrum des Katalogs zu stellen.
+
+Dieser Abschnitt ist die zentrale Entdeckungsfläche für wiederverwendbare App-UI.
+Eine Oberfläche gehört hierher, weil sie wiederverwendbar ist, auch wenn Core
+oder ein Template sie derzeit besitzt. Besitzlabels und Importpfade machen diese
+Grenze klar, ohne zusammenhängende UI-Hinweise über die Website zu verteilen.
 
 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="So passen Kits zusammen" summary={"Die Framework-Laufzeit liefert dauerhafte Garantien. Toolkit macht daraus wiederverwendbare Produktsysteme. Apps ergänzen Domänendaten, Routen und visuelle Identität."}>
 
 ```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
+    Aktionen, SQL, Authentifizierung, App-Zustand, Zugriffskontrollen,
+    Echtzeittransport
   </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 />
+    Zusammenarbeit, Teilen, Einrichtung, Review, Verlauf, Beobachtbarkeit
   </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
+    Domänenschema, Routen, Aktionen, Marke, spezialisierte Abläufe
   </div>
 </div>
 ```
@@ -68,45 +72,69 @@ 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
+## Katalog {#catalog}
+
+| Bereich                     | Einstieg                                               | Inhalt                                                                             |
+| --------------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------------------- |
+| Grundlagen                  | [UI-Primitives](/docs/toolkit-ui)                      | Gemeinsame Controls, Hooks, App-Adapter und Shell-Nähte.                           |
+| Editoren & Leinwände        | [Editoren & Leinwände](/docs/toolkit-editors-canvases) | Reichhaltige Bearbeitung, strukturierte Blöcke, Canvas-Controls und Design-Muster. |
+| Agentenerlebnis & Kontext   | [Kontext & Wissen](/docs/toolkit-context-knowledge)    | Context X-Ray, Ressourcen, Wissen, Composer-Kontext und agentensichtbarer Zustand. |
+| Zusammenarbeit & Governance | [Zusammenarbeit](/docs/toolkit-collaboration)          | Teilen, Präsenz, Review, Historie, Audit und Organisationsgrenzen.                 |
+| Workspace-Chrome            | [App-Chrome](/docs/toolkit-settings)                   | Einstellungen, Teams, Setup, Navigation, Ressourcen und Agenten-UX.                |
+| Betrieb                     | [Observability](/docs/toolkit-observability)           | Nutzung, Feedback, Replay, Diagnose und operative Sichtbarkeit.                    |
+| Toolkit-Fähigkeitsmodule    | [Fähigkeitsmodule](/docs/toolkit-capability-packages)  | Bei Bedarf installierte Domänenpakete und ihre Lifecycle-Manifeste.                |
+
+## Produkt-Kits {#product-kits}
+
+| Kit                                                      | Verwende es für                                                                                      |
+| -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
+| [Sharing](/docs/toolkit-sharing)                         | Besitzbare Ressourcen, Teilen-Dialoge/-Aktionen, Sichtbarkeit und öffentlicher/privater/Org-Zugriff. |
+| [Collaboration](/docs/toolkit-collaboration)             | Echtzeitbearbeitung, Präsenz, Live-Cursor, letzte Änderungen und gemeinsames Rückgängig.             |
+| [Settings](/docs/toolkit-settings)                       | Standardseiten/-tabs für App- und Agent-/Provider-Einstellungen an einem vorhersehbaren Ort.         |
+| [Org & Team](/docs/toolkit-org-team)                     | Teamseiten, Org-Wechsel, Einladungen, Org-Domänen, Rollen und App-Wechsel.                           |
+| [Setup & Connections](/docs/toolkit-setup-connections)   | Onboarding, Secrets, Workspace-Verbindungen, OAuth/Provider-Bereitschaft und Builder Connect.        |
+| [Command & Navigation](/docs/toolkit-command-navigation) | Befehlsmenü, Deep Links, Standardrouten sowie Sidebar- und Shell-Muster.                             |
+| [Resources](/docs/toolkit-resources)                     | Ressourcenbäume/-editoren, Dateiauswahl/-suche, Anhänge und lokaler Dateimodus.                      |
+| [Agent UX](/docs/toolkit-agent-ux)                       | Composer, Modellauswahl, Kontext-Chips, Freigaben, Wiederherstellung und Run-Leiste.                 |
+| [History](/docs/toolkit-history)                         | Versionierte Ressourcen, Snapshots, Verlauf, Audit, Undo/Redo, Wiederherstellung und Änderungen.     |
+| [Comments & Review](/docs/toolkit-comments-review)       | Prüfbare Ressourcen, Kommentare, Feedback-Warteschlangen, Threads, Erwähnungen und Review-Status.    |
+| [Observability](/docs/toolkit-observability)             | Nutzung, Ausgaben, Feedback, Replay, Fehler und Laufdiagnosen.                                       |
+
+## Paket-Reife und Ownership {#package-maturity-and-ownership}
+
+- Der Rich-Text-Editor gehört zu **Toolkit**; vorhandene Core-Imports bleiben während der Migration schlanke Kompatibilitäts-Re-Exports.
+- Design ist ein **Template-Muster** mit wiederverwendbaren `design-tweaks`, kein vollständiger Drop-in-Editor oder Canvas.
+- Blocks und die Context-X-Ray-Engine bleiben in dieser Phase **Core-owned**; die wiederverwendbare Context-X-Ray-Darstellung gehört zu Toolkit.
+- Creative Context, Scheduling und Pinpoint sind **Toolkit-Fähigkeitsmodule**, die bei Bedarf installiert werden; sie behalten separate npm-Pakete und Lifecycle-Manifeste. Dispatch bleibt ein separates Produkt.
+
+## Implementierungsgrenze {#implementation-boundary}
+
+Kits sind zuerst Produktoberflächen. Manche Teile werden von der Laufzeit
 (`@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.
+Nutze den Paketpfad, dem das benötigte Verhalten gehört, aber gestalte
+Einstellungen, Zusammenarbeit, Teilen, Team, Review und Einrichtung als ein
+stimmiges Kit statt Paketgrenzen in der App sichtbar zu machen.
+
+## Grundbausteine {#foundation-pieces}
+
+- [UI-Primitives](/docs/toolkit-ui) behandelt die gemeinsamen shadcn-artigen
+  Primitives unter `@agent-native/toolkit/ui/*`, lokale App-Adapter und
+  gemeinsame Shell-Hooks.
+- Die [Component API](/docs/components) bleibt die Referenz auf niedriger Ebene
+  für öffentliche React-Exports.
+
+## Designregel {#design-rule}
+
+Verwende ein Kit, wenn Verhalten appübergreifend wiederkehrt und Nutzer einen
+Standard erwarten: Teilen, Einstellungen, Teams, Kommentare, Verlauf und
+Agentenfortschritt sollten nicht je Template anders sein. Domänendaten,
+Abläufe, Labels und visuelles Styling bleiben in der App.
+
+## Nächste Schritte
+
+- [**Toolkit UI-Primitives**](/docs/toolkit-ui) — gemeinsame Primitives, App-Adapter und Shell-Hooks.
+- [**Sharing Kit**](/docs/toolkit-sharing) — ein guter erster Einstieg für Ressourcen, Teilen und Sichtbarkeit.
+- [**Templates erstellen**](/docs/creating-templates) — Templates Ende-zu-Ende bauen und Kits im Kontext sehen.
+- [**Komponenten-API**](/docs/components) — die Referenz aller öffentlichen React-Exports.
+- [**Paket-Lebenszyklus**](/docs/package-lifecycle) — manifestgesteuerte Toolkit-Fähigkeitsmodule sicher untersuchen, hinzufügen und auswerfen.

package/docs/content/locales/de-DE/agent-surfaces.mdx

@@ -15,8 +15,7 @@ Füge die Route zur App-Navigation hinzu und übergib `agentPageHref="/agent"` a
 Seite verweisen können, ohne diese Abläufe zu duplizieren.
 
 ```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 />;
 }
@@ -416,8 +415,7 @@ export default createAgentNativeEmbeddedPlugin({
 Der Sidecar React übergibt Seitenkontext und Hostbefehle:
 
 ```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/de-DE/audit-log.mdx

@@ -82,8 +82,7 @@ Drei gelesene actions stehen dem Agenten **und** dem Frontend in jeder App zur V
 Erstellen Sie einen Aktivitäts-Feed oder eine „Wer hat das geändert“-Zeile, indem Sie `list-audit-events` vom UI mit `useActionQuery` aufrufen – schreiben Sie niemals einen Abruf in die Prüftabelle von Hand:
 
 ```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/de-DE/authentication.mdx

@@ -363,8 +363,9 @@ interface AuthSession {
 Verwenden Sie auf dem Client den 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/de-DE/client.mdx

@@ -65,8 +65,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 });
 
@@ -83,8 +82,7 @@ await callAction("archive-lead", { leadId });
 Senden Sie eine Nachricht an den Agenten-Chat über postMessage – die übliche Methode zum Delegieren einer KI-Aufgabe aus einer UI-Interaktion. Übergeben Sie `context` für versteckten Modellkontext und `submit: true`, um es sofort zu senden, oder `submit: false`, um einen Entwurf vorab auszufüllen, den der Benutzer zuerst überprüft.
 
 ```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",
@@ -174,8 +172,7 @@ Registerkarte „Einstellungen“ der Agent-Seitenleiste. Übergeben Sie eine Ab
 `"automations"`, `"voice"` oder `"limits"`, um einen bestimmten Abschnitt zu öffnen.
 
 ```ts
-import { openAgentSettings } from "@agent-native/core/client";
-
+import { openAgentSettings } from "@agent-native/core/client/navigation";
 openAgentSettings();
 openAgentSettings("secrets");
 ```
@@ -183,8 +180,7 @@ openAgentSettings("secrets");
 Ziehen Sie diesen Helfer dem direkten Versand von `agent-panel:open-settings` vor.
 
 ```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}`;
@@ -242,8 +238,10 @@ startet die Agentenarbeit – anstatt ein benutzerdefiniertes Modal zu erstellen
 Verfassenr für Freiformdetails und ein Formular/Popover für die Eingabe mehrerer Felder.
 
 ```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)
@@ -286,7 +284,7 @@ import {
   requestMcpAppDisplayMode,
   updateMcpAppModelContext,
   useMcpAppHostContext,
-} from "@agent-native/core/client";
+} from "@agent-native/core/client/agent-chat";
 ```
 
 `getMcpAppHostContext()` liest den neuesten gepushten Host-Kontext-Snapshot;
@@ -321,8 +319,9 @@ Legen Sie `dynamicSuggestions={false}` fest, um nur statische Chips zu behalten.
 React-Hook, der sendToAgentChat mit der Ladestatusverfolgung umschließt:
 
 ```ts
-import { useAgentChatGenerating } from "@agent-native/core/client";
-
+import {
+  useAgentChatGenerating,
+} from "@agent-native/core/client/agent-chat"
 function GenerateButton() {
   const [isGenerating, send] = useAgentChatGenerating();
 
@@ -348,7 +347,9 @@ function GenerateButton() {
 React-Hook (früher `useFileWatcher`), der über SSE auf Datenbankänderungen lauscht, auf Abfragen zurückgreift und die Framework-Abfragecaches ungültig macht, die dafür sorgen, dass UI mit Agent-Schreibvorgängen in Einklang steht:
 
 ```ts
-import { useDbSync } from "@agent-native/core/client";
+import {
+  useDbSync,
+} from "@agent-native/core/client/hooks"
 import { useQueryClient } from "@tanstack/react-query";
 
 function App() {
@@ -393,8 +394,7 @@ Wenn eine serverseitige Datenbankmutation auftritt, zeichnet der Server ein Änd
 
 ```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");
@@ -459,8 +459,9 @@ function DashboardView({ id }) {
 Dienstprogramm zum Zusammenführen von Klassennamen (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/de-DE/components.mdx

@@ -13,7 +13,7 @@ Komponenten, wenn Sie können, und eine Ebene herunterklappen, wenn Sie ein benu
 Browser UI aus fokussierten Client-Unterpfaden importieren:
 
 ```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/de-DE/context-awareness.mdx

@@ -196,8 +196,7 @@ Verwenden Sie den `selection`-App-Statusschlüssel für eine dauerhafte Auswahl,
 Schreiben Sie es aus UI, wenn der Benutzer bedeutungsvolle Objekte auswählt, fokussiert oder mehrfach auswählt:
 
 ```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 @@ Der Produktionsagent fügt diesen Schlüssel als unmittelbaren Auswahlkontext in
 Benutzerdefinierte Editoren können denselben Schlüssel schreiben, wenn ihre Auswahl nicht durch die native Browserauswahl repräsentiert wird:
 
 ```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 @@ Der Agent sollte `pnpm action view-screen` aufrufen, bevor er auf den aktuellen
 Manchmal sollte der Kontext nicht nur im App-Status verbleiben. Ein Benutzer klickt auf eine Schaltfläche, hinterlässt eine Kommentarnadel, wählt ein Element aus und wählt „Agenten fragen“ oder drückt einen KI-Befehl in einer Symbolleiste. Dieser Klick ist eine Anweisung. Übergeben Sie es im Browser UI mit `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 @@ Es bleibt kurz, weil es ein dünner Wrapper um das eigentliche Framework-Grundel
 
 ```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/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/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.