@agent-native/core 0.109.2 → 0.109.4

package/corpus/README.md

@@ -27,5 +27,5 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 
 ## Generated Counts
 
-- core files: 2309
-- template files: 6148
+- core files: 2333
+- template files: 6153

package/corpus/core/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @agent-native/core
 
+## 0.109.4
+
+### Patch Changes
+
+- b6d7f87: Move portable rich-editor, context presentation, and visual design controls into Toolkit while preserving Core compatibility re-exports, and add accurate side-effect metadata to capability packages.
+- Updated dependencies [b6d7f87]
+  - @agent-native/toolkit@0.5.0
+
+## 0.109.3
+
+### Patch Changes
+
+- 5199e0b: Make Chat the first and default starting point in the new-app CLI picker.
+- 5199e0b: Track browser, server, cold-start, framework-readiness, and database latency for app requests; retain action 4xx failures; parallelize legacy route bootstrap reads; and deduplicate session lookups without treating transient auth failures as signed-out sessions.
+- 5199e0b: Deliver remote-session Expo push notifications through a retrying, batched outbox worker and verify provider receipts before marking delivery complete.
+
 ## 0.109.2
 
 ### Patch Changes

package/corpus/core/docs/content/agent-native-toolkit.mdx

@@ -1,20 +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: "One catalog of reusable foundations, editors and canvases, agent context, governance, workspace chrome, operations, and install-on-demand capability modules."
 ---
 
-# 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 is the reusable, battle-tested building-block shelf for high-quality
+agentic applications. It turns the hard product work that repeats across apps
+into standard surfaces without making one app pattern the center of the catalog.
+
+This section is the single discovery shelf for reusable app-building UI. A
+surface belongs in these docs because it is reusable, even when its current
+implementation owner is Core or a template. Ownership labels and import paths
+make that boundary explicit without scattering related UI guidance across the
+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
-make the common product systems feel complete from the first version instead of
+consistently. Apps still own their domain model and visual identity; Toolkit
+makes the common product systems feel complete from the first version instead of
 being rebuilt in slightly different ways every time.
 
 <WireframeBlock id="doc-block-toolkits-index">
@@ -26,7 +30,7 @@ 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="How kits fit" summary={"The framework runtime supplies durable guarantees. Toolkit turns those guarantees into reusable product systems. Apps add domain-specific data, routes, and visual identity."}>
 
 ```html
 <div class="diagram-row">
@@ -36,7 +40,7 @@ being rebuilt in slightly different ways every time.
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-card">
-    <span class="diagram-pill accent">Toolkits</span><br />
+    <span class="diagram-pill accent">Toolkit</span><br />
     collaboration, sharing, setup, review, history, observability
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
@@ -66,7 +70,19 @@ being rebuilt in slightly different ways every time.
 
 </Diagram>
 
-## The Kits {#the-kits}
+## Catalog {#catalog}
+
+| Area                       | Start here                                                      | What it covers                                                                  |
+| -------------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------- |
+| Foundations                | [UI Primitives](/docs/toolkit-ui)                               | Shared controls, hooks, app adapters, and shell seams.                          |
+| Editors & canvases         | [Editors & Canvases](/docs/toolkit-editors-canvases)            | Rich editing, structured blocks, reusable canvas controls, and Design patterns. |
+| Agent experience & context | [Context & Knowledge](/docs/toolkit-context-knowledge)          | Context X-Ray, resources, knowledge, composer context, and agent-visible state. |
+| Collaboration & governance | [Collaboration](/docs/toolkit-collaboration)                    | Sharing, presence, review, history, audit, and organization boundaries.         |
+| Workspace chrome           | [App Chrome](/docs/toolkit-settings)                            | Settings, teams, setup, navigation, resources, and agent UX.                    |
+| Operations                 | [Observability](/docs/toolkit-observability)                    | Usage, feedback, replay, diagnostics, and operational visibility.               |
+| Capability modules         | [Toolkit Capability Modules](/docs/toolkit-capability-packages) | Scheduling, Creative Context, and Pinpoint as install-on-demand packages.       |
+
+## Product kits {#product-kits}
 
 | Kit                                                      | Use it for                                                                                                                       |
 | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
@@ -82,8 +98,23 @@ being rebuilt in slightly different ways every time.
 | [Comments & Review](/docs/toolkit-comments-review)       | Registered reviewable resources, comment actions, feedback queues, thread panels, mentions, resolved threads, and review status. |
 | [Observability](/docs/toolkit-observability)             | Usage, spend, feedback, replay, errors, and run diagnostics.                                                                     |
 
+## Package maturity and ownership {#package-maturity-and-ownership}
+
+- The rich editor is **Toolkit-owned**. Existing Core editor imports remain thin
+  compatibility re-exports during migration.
+- Design is a **template pattern** with reusable `design-tweaks`; it is not a
+  full drop-in editor or canvas package.
+- Blocks remain **Core-owned** in this phase.
+- The Context X-Ray engine remains **Core-owned**; its reusable presentation is
+  Toolkit-owned.
+- Scheduling, Creative Context, and Pinpoint are **Toolkit capability modules,
+  installed on demand**. They remain separate npm packages so each domain can
+  keep an independent lifecycle manifest, dependency graph, and release cadence.
+- Dispatch remains a **separate product**, not a Toolkit capability module.
+
 ## Implementation Boundary {#implementation-boundary}
 
+Toolkit docs are organized by reusable product capability, not npm package.
 Kits are product surfaces first. Some pieces are runtime-backed
 (`@agent-native/core`), some are presentation primitives
 (`@agent-native/toolkit`), and apps usually wrap both through local adapters.
@@ -117,3 +148,5 @@ workflows, labels, and visual styling in the app.
   end and see where kits fit alongside your own domain model.
 - [**Component API**](/docs/components) — the generated reference for every
   public React export, including kit components.
+- [**Package Lifecycle**](/docs/package-lifecycle) — inspect, add, and eject
+  manifest-driven capability packages safely.

package/corpus/core/docs/content/locales/ar-SA/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: "كتالوج متوازن للأسس القابلة لإعادة الاستخدام والمحررات واللوحات وسياق الوكيل والحوكمة وهيكل مساحة العمل والعمليات ووحدات قدرات 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 هو رفّ اللبنات القابلة لإعادة الاستخدام والمجرّبة للتطبيقات الوكيلة
+عالية الجودة. يحوّل عمل المنتج المتكرر بين التطبيقات إلى أسطح قياسية، من دون
+جعل نمط تطبيق واحد محور الكتالوج.
+
+هذا القسم هو رف الاكتشاف الواحد لواجهة بناء التطبيقات القابلة لإعادة الاستخدام.
+ينتمي السطح إلى هذه الوثائق لأنه قابل لإعادة الاستخدام، حتى إن كان مالكه الحالي
+Core أو قالبًا. توضح تسميات الملكية ومسارات الاستيراد هذا الحد من دون تشتيت
+إرشادات الواجهة في الموقع.
 
 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,23 @@ 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="كيف تتكامل الحزم" summary={"يوفر وقت تشغيل الإطار ضمانات دائمة. يحول Toolkit تلك الضمانات إلى أنظمة منتج قابلة لإعادة الاستخدام. تضيف التطبيقات بيانات المجال والمسارات والهوية البصرية."}>
 
 ```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
+    الإجراءات، SQL، المصادقة، حالة التطبيق، فحوصات الوصول، النقل الفوري
   </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 />
+    التعاون، المشاركة، الإعداد، المراجعة، السجل، قابلية الرصد
   </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
+    <span class="diagram-pill accent">التطبيقات</span><br />
+    مخطط المجال، المسارات، الإجراءات، العلامة التجارية، تدفقات متخصصة
   </div>
 </div>
 ```
@@ -68,45 +71,66 @@ 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
+## الكتالوج {#catalog}
+
+| المجال              | ابدأ من هنا                                         | ما الذي يغطيه                                                          |
+| ------------------- | --------------------------------------------------- | ---------------------------------------------------------------------- |
+| الأسس               | [أوليات الواجهة](/docs/toolkit-ui)                  | عناصر تحكم وخطافات ومهايئات تطبيق ونقاط وصل للهيكل مشتركة.             |
+| المحررات واللوحات   | [المحررات واللوحات](/docs/toolkit-editors-canvases) | تحرير غني وكتل منظمة وعناصر تحكم قابلة لإعادة الاستخدام وأنماط Design. |
+| تجربة الوكيل وسياقه | [السياق والمعرفة](/docs/toolkit-context-knowledge)  | Context X-Ray والموارد والمعرفة وسياق المؤلف والحالة المرئية للوكيل.   |
+| التعاون والحوكمة    | [التعاون](/docs/toolkit-collaboration)              | المشاركة والحضور والمراجعة والسجل والتدقيق وحدود المؤسسة.              |
+| هيكل مساحة العمل    | [هيكل التطبيق](/docs/toolkit-settings)              | الإعدادات والفرق والإعداد والتنقل والموارد وتجربة الوكيل.              |
+| العمليات            | [قابلية المراقبة](/docs/toolkit-observability)      | الاستخدام والملاحظات وإعادة التشغيل والتشخيص والرؤية التشغيلية.        |
+| وحدات قدرات Toolkit | [حزم القدرات](/docs/toolkit-capability-packages)    | حزم نطاق تثبت عند الحاجة وبيانات دورة حياتها.                          |
+
+## مجموعات المنتج {#product-kits}
+
+| الحزمة                                                | استخدمها من أجل                                                                   |
+| ----------------------------------------------------- | --------------------------------------------------------------------------------- |
+| [المشاركة](/docs/toolkit-sharing)                     | موارد مملوكة، حوارات وإجراءات المشاركة، شارات الرؤية والوصول العام/الخاص/المنظمة. |
+| [التعاون](/docs/toolkit-collaboration)                | تحرير فوري، حضور، مؤشرات حية، إبراز التعديلات الأخيرة وتراجع تعاوني.              |
+| [الإعدادات](/docs/toolkit-settings)                   | صفحات وعلامات إعدادات قياسية لإعدادات التطبيق والوكيل/المزود في مكان متوقع.       |
+| [المنظمة والفريق](/docs/toolkit-org-team)             | صفحات الفريق، تبديل المنظمة، الدعوات، النطاقات، الأدوار وتبديل التطبيقات.         |
+| [الإعداد والاتصالات](/docs/toolkit-setup-connections) | التهيئة، الأسرار، اتصالات مساحة العمل، OAuth وجاهزية المزود وBuilder connect.     |
+| [الأوامر والتنقل](/docs/toolkit-command-navigation)   | قائمة الأوامر، الروابط العميقة، المسارات القياسية وأنماط الشريط الجانبي والصدفة.  |
+| [الموارد](/docs/toolkit-resources)                    | أشجار ومحررات الموارد، منتقي/بحث الملفات، المرفقات ووضع الملفات المحلي.           |
+| [تجربة الوكيل](/docs/toolkit-agent-ux)                | المؤلف، منتقي النموذج، شرائح السياق، الموافقات، الاسترداد ودرج التشغيل.           |
+| [السجل](/docs/toolkit-history)                        | موارد مإصدرة، لقطات، سجل، تدقيق، تراجع/إعادة، استعادة وأسـطح التغييرات.           |
+| [التعليقات والمراجعة](/docs/toolkit-comments-review)  | موارد قابلة للمراجعة، تعليقات، قوائم ملاحظات، سلاسل، إشارات وحالة مراجعة.         |
+| [قابلية الرصد](/docs/toolkit-observability)           | الاستخدام، الإنفاق، الملاحظات، الإعادة، الأخطاء وتشخيصات التشغيل.                 |
+
+## نضج الحزمة وملكيتها {#package-maturity-and-ownership}
+
+- المحرر الغني مملوك لـ **Toolkit**؛ وتبقى استيرادات Core الحالية عمليات إعادة تصدير متوافقة وخفيفة أثناء الترحيل.
+- Design هو **نمط قالب** مع `design-tweaks` قابلة لإعادة الاستخدام، وليس محررًا أو لوحة كاملة قابلة للإضافة مباشرة.
+- تظل Blocks ومحرك Context X-Ray مملوكين لـ **Core** في هذه المرحلة؛ أما عرض Context X-Ray القابل لإعادة الاستخدام فمملوك لـ Toolkit.
+- Creative Context وScheduling وPinpoint هي **وحدات قدرات Toolkit** تثبت عند الحاجة؛ وتحافظ على حزم npm وبيانات دورة حياة منفصلة. ويظل Dispatch منتجًا منفصلًا.
+
+## حد التنفيذ {#implementation-boundary}
+
+الحزم هي أسطح منتج أولًا. بعض الأجزاء مدعومة بوقت التشغيل
 (`@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.
+استخدم مسار الحزمة التي تملك السلوك المطلوب، لكن صمّم الإعدادات والتعاون
+والمشاركة والفريق والمراجعة والإعداد كتجربة حزمة متماسكة بدل كشف حدود الحزم في
+التطبيق.
+
+## اللبنات الأساسية {#foundation-pieces}
+
+- [أوليات الواجهة](/docs/toolkit-ui) تغطي أوليات شبيهة بـ shadcn تحت
+  `@agent-native/toolkit/ui/*`، ومحولات التطبيق المحلية وخطافات الصدفة المشتركة.
+- تبقى [واجهة مكونات API](/docs/components) المرجع الأدنى لصادرات React العامة.
+
+## قاعدة التصميم {#design-rule}
+
+استخدم حزمة عندما يتكرر السلوك عبر التطبيقات ويتوقع المستخدمون أن يكون قياسيًا:
+لا ينبغي أن تختلف المشاركة والإعدادات والفرق والتعليقات والسجل وتقدم الوكيل بين
+القوالب. أبقِ بيانات المجال وتدفقات العمل والتسميات والأسلوب البصري داخل التطبيق.
+
+## الخطوات التالية
+
+- [**أوليات واجهة Toolkit**](/docs/toolkit-ui) — أوليات ومهايئات تطبيق وخطافات shell مشتركة.
+- [**مجموعة المشاركة**](/docs/toolkit-sharing) — بداية جيدة للموارد وحوارات المشاركة والرؤية.
+- [**إنشاء القوالب**](/docs/creating-templates) — أنشئ قالباً كاملاً لترى موضع المجموعات.
+- [**واجهة مكونات API**](/docs/components) — مرجع exports العامة لـ React.
+- [**دورة حياة الحزم**](/docs/package-lifecycle) — افحص وأضف وأخرج وحدات قدرات Toolkit المعتمدة على manifest بأمان.

package/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/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.