@agent-native/core 0.92.12 → 0.94.0

package/corpus/core/docs/content/locales/ar-SA/template-assets.mdx

@@ -90,6 +90,18 @@ description: "مدير أصول رقمية أصلي للوكيل وخدمة إن
 - **تحتاج التطبيقات الأخرى إلى منتقي الأصول أو المنشئ** — يمكن للشرائح أو التصميم أو المحتوى أو محرر المدونات أو أداة إنشاء المواقع تضمين المنتقي أو استدعاء الأصول عبر A2A.
 - **تريد أن تكون وسائط العلامة التجارية متاحة من وكيل الترميز** — يمكن لـ Codex أو Claude Code أو Claude أو ChatGPT إنشاء الأصول واختيارها دون مغادرة الدردشة.
 
+## ما يمكنك فعله به
+
+- **إنشاء مكتبات الأصول.** تجميع الصور المرجعية ومقاطع الفيديو والشعارات الأساسية وملاحظات الأنماط واللوحات والمجلدات والمخرجات التي تم إنشاؤها حسب العلامة التجارية أو الحملة أو المنتج أو الفئة.
+- **الإنشاء من خلال الدردشة.** يقوم المؤلف الرئيسي والمكتبة بعناصر التحكم في الإنشاء بإرسال المطالبة إلى الوكيل باستخدام `sendToAgentChat()`، حتى يتمكن المستخدمون من فحص المتغيرات وتقديم التعليقات والتكرار.
+- **إنشاء صور ومقاطع فيديو.** يتوفر إنشاء الصور المُدارة بواسطة Builder عند تمكينه، ويعمل Gemini على تشغيل إنشاء الفيديو بالإضافة إلى إمكانية الرجوع اليدوي للصور.
+- **تحميل ووصف المراجع.** أضف صورًا أو مقاطع فيديو من المكتبة UI أو زر إرفاق المؤلف الفوري، ثم ابحث حسب العنوان أو الوصف أو النص البديل أو المطالبة أو النموذج أو نوع الوسائط أو الحالة أو الدور أو المجلد أو المجموعة.
+- **احتفظ بسجل تدقيق الإنشاء.** تسجل كل عملية تشغيل المطالبات والنموذج ونسبة العرض إلى الارتفاع والمراجع وأصول المصدر والنسب والأصول التي تم إنشاؤها والحالة والأخطاء والطوابع الزمنية لمراجعة التصميم لاحقًا.
+- **الحفاظ على دقة الشعار.** يمكن للوكيل إنشاء منطقة نائب ويقوم الخادم بتركيب الشعار الأساسي الذي تم تحميله على الصورة النهائية بدلاً من الاعتماد على نموذج الصورة لإعادة رسمه.
+- **التضمين كمنتقي.** يمكن للتطبيقات الأخرى وضع إطار iframe لـ `/picker` والاستماع إلى حدث `chooseAsset` من `@agent-native/embedding`، وتحويل الأصول إلى منتقي/مولد أصول لمحرري المدونات، ومنشئي المواقع، ومجموعات الشرائح، والتطبيقات المخصصة. يقوم المنتقي أيضًا بإصدار الاسم المستعار `chooseImage` القديم لمضيفي الصور فقط الحاليين.
+- **التثبيت كمهارة مدعومة بالتطبيق.** يصدر بيان `agent-native.app-skill.json` مهارة الأصول بالإضافة إلى البيانات التعريفية لموصل MCP حتى تتمكن الأسواق من تثبيت التطبيق وتعليماته ومنتقيه معًا.
+- **خدمة وكلاء آخرين.** يمكن للشرائح والتصميم والمحتوى والبريد والإرسال استدعاء الأصول من خلال A2A لسرد المكتبات وإنشاء الدفعات وإنشاء مقاطع الفيديو وتحسين الأصل وجلب الصادرات وتقديم المعاينات المضمنة حيث يُسمح بالتضمين.
+
 ## البدء
 
 عرض توضيحي مباشر: [assets.agent-native.com](https://assets.agent-native.com).
@@ -112,18 +124,6 @@ description: "مدير أصول رقمية أصلي للوكيل وخدمة إن
 - "تحويل هذا المخطط الذي تم تحميله إلى صورة توضيحية واضحة للمنتج."
 - "قم بإنشاء لوحة عمل للفيديو واحفظ أفضل إطار تم تعيينه لهذه المكتبة."
 
-## ما يمكنك فعله به
-
-- **إنشاء مكتبات الأصول.** تجميع الصور المرجعية ومقاطع الفيديو والشعارات الأساسية وملاحظات الأنماط واللوحات والمجلدات والمخرجات التي تم إنشاؤها حسب العلامة التجارية أو الحملة أو المنتج أو الفئة.
-- **الإنشاء من خلال الدردشة.** يقوم المؤلف الرئيسي والمكتبة بعناصر التحكم في الإنشاء بإرسال المطالبة إلى الوكيل باستخدام `sendToAgentChat()`، حتى يتمكن المستخدمون من فحص المتغيرات وتقديم التعليقات والتكرار.
-- **إنشاء صور ومقاطع فيديو.** يتوفر إنشاء الصور المُدارة بواسطة Builder عند تمكينه، ويعمل Gemini على تشغيل إنشاء الفيديو بالإضافة إلى إمكانية الرجوع اليدوي للصور.
-- **تحميل ووصف المراجع.** أضف صورًا أو مقاطع فيديو من المكتبة UI أو زر إرفاق المؤلف الفوري، ثم ابحث حسب العنوان أو الوصف أو النص البديل أو المطالبة أو النموذج أو نوع الوسائط أو الحالة أو الدور أو المجلد أو المجموعة.
-- **احتفظ بسجل تدقيق الإنشاء.** تسجل كل عملية تشغيل المطالبات والنموذج ونسبة العرض إلى الارتفاع والمراجع وأصول المصدر والنسب والأصول التي تم إنشاؤها والحالة والأخطاء والطوابع الزمنية لمراجعة التصميم لاحقًا.
-- **الحفاظ على دقة الشعار.** يمكن للوكيل إنشاء منطقة نائب ويقوم الخادم بتركيب الشعار الأساسي الذي تم تحميله على الصورة النهائية بدلاً من الاعتماد على نموذج الصورة لإعادة رسمه.
-- **التضمين كمنتقي.** يمكن للتطبيقات الأخرى وضع إطار iframe لـ `/picker` والاستماع إلى حدث `chooseAsset` من `@agent-native/embedding`، وتحويل الأصول إلى منتقي/مولد أصول لمحرري المدونات، ومنشئي المواقع، ومجموعات الشرائح، والتطبيقات المخصصة. يقوم المنتقي أيضًا بإصدار الاسم المستعار `chooseImage` القديم لمضيفي الصور فقط الحاليين.
-- **التثبيت كمهارة مدعومة بالتطبيق.** يصدر بيان `agent-native.app-skill.json` مهارة الأصول بالإضافة إلى البيانات التعريفية لموصل MCP حتى تتمكن الأسواق من تثبيت التطبيق وتعليماته ومنتقيه معًا.
-- **خدمة وكلاء آخرين.** يمكن للشرائح والتصميم والمحتوى والبريد والإرسال استدعاء الأصول من خلال A2A لسرد المكتبات وإنشاء الدفعات وإنشاء مقاطع الفيديو وتحسين الأصل وجلب الصادرات وتقديم المعاينات المضمنة حيث يُسمح بالتضمين.
-
 ## استخدامه من وكيل الترميز الخاص بك
 
 قم بإنشاء وسائط العلامة التجارية واختيارها دون مغادرة Codex أو Claude Code أو Claude أو ChatGPT.
@@ -166,10 +166,13 @@ description: "مدير أصول رقمية أصلي للوكيل وخدمة إن
 
 باقي هذا المستند مخصص لأي شخص يقوم بتعديل قالب الأصول أو توسيعه.
 
-### السقالات
+### بداية سريعة
 
 ```bash
 npx @agent-native/core@latest create my-assets --standalone --template assets
+cd my-assets
+pnpm install
+pnpm dev
 ```
 
 ### نموذج البيانات

package/corpus/core/docs/content/locales/ar-SA/template-brain.mdx

@@ -201,7 +201,7 @@ Postgres، وNeon، وD1، وTurso، والمضيفون المشابهون. تع
 المسار الحالي والمرشحات والمعرفات المحددة حتى يعرف الوكيل دائمًا المسار الحالي
 التنقل والاختيار.
 
-يعيش مخطط الدماغ في `templates/brain/server/db/schema.ts`. ثمانية جداول:
+يعيش مخطط الدماغ في `templates/brain/server/db/schema.ts`. تسعة جداول:
 
 | الجدول                   | ما يحمله                                                                                                                                                   |
 | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -549,3 +549,5 @@ URL كلتقطير خام قبل التقطير.
 - [**Dispatch template**](/docs/template-dispatch) — تطبيق التنسيق المدعم
 - [**Workspace**](/docs/workspace) — الموارد المشتركة عبر التطبيقات
 - [**A2A Protocol**](/docs/a2a-protocol) — التفويض عبر التطبيقات
+- [**القوالب**](/docs/cloneable-saas) — نموذج الاستنساخ والتملك، وكل قالب مجال آخر يمكنك البدء منه
+- [**بدء الاستخدام**](/docs/getting-started) — أساسيات إطار العمل: الإجراءات وحالة التطبيق والمزامنة المباشرة

package/corpus/core/docs/content/locales/ar-SA/template-clips.mdx

@@ -17,7 +17,7 @@ search: "سجلات متصفح Clips، سجلات المطورين، سجلات
   />
 </WireframeBlock>
 
-فكر على غرار Loom + Granola + Wispr Flow المدمجة في تطبيق واحد - ولكن الوكيل هو محرر من الدرجة الأولى عبر كل سطح، والتسجيلات والاجتماعات والإملاءات ملكك، وليس بائع SaaS. تجعل Clips أيضًا التسجيلات المشتركة قابلة للقراءة من قبل الوكيل: قم بلصق رابط مشاركة Clips عادي في الوكيل ويمكنه "سماع" النص كنص و"رؤية" إطارات الشاشة ذات الطوابع الزمنية كصور - لا حاجة إلى فيديو أولي. تعمل ميزة عرض الإطار في أي وكيل قادر على التقاط الصور (ChatGPT، Claude Code، Cursor، Codex)؛ لا تزال محادثات الويب النصية فقط تحصل على النص الكامل ويمكن أن تأخذ إطارًا تقوم بتحميله.
+تجمع Clips تسجيلات الشاشة غير المتزامنة وملاحظات الاجتماعات المتزامنة مع التقويم والإملاء الصوتي بالضغط للتحدث في تطبيق واحد — ويكون الوكيل محررًا من الدرجة الأولى عبر كل سطح، بينما تظل التسجيلات والاجتماعات والإملاءات ملكك لا ملك بائع SaaS. وتجعل Clips التسجيلات المشتركة قابلة للقراءة من قبل الوكيل أيضًا: الصق رابط مشاركة Clips عامًا أو رابط **نسخ للوكيل** مؤقتًا في وكيل، فيمكنه "سماع" النص مكتوبًا و"رؤية" إطارات الشاشة ذات الطوابع الزمنية كصور، من دون الحاجة إلى الفيديو الخام. تعمل مشاهدة الإطارات في أي وكيل يدعم الصور (ChatGPT وClaude Code وCursor وCodex)؛ وتحصل محادثات الويب النصية فقط على النص الكامل ويمكنها استخدام إطار ترفعه.
 
 <Diagram id="doc-block-1nucsqp" title={"التقاط ونسخ وإعادة الاستخدام"} summary={"توجد ثلاثة أنواع من الالتقاط في مكتبة واحدة؛ يقوم الوكيل بنسخ النص، والعناوين، والتلخيص، ثم يصبح كل نص قابلاً للبحث والمشاركة."}>
 
@@ -77,12 +77,13 @@ search: "سجلات متصفح Clips، سجلات المطورين، سجلات
 ## ما يمكنك فعله به
 
 - **سجل شاشتك** باستخدام مسجل مدمج وتراكب كاميرا الويب والتقاط الصوت والإيقاف المؤقت/الاقتطاع.
+- **استورد مقاطع فيديو Loom العامة.** على الويب، اختر **تسجيل ← استيراد Loom**، ثم الصق رابط مشاركة أو تضمين من Loom. يحفظ Clips نسخة في مكتبتك ويستورد النص العام عندما يكون متاحًا.
 - **التقط الاجتماعات من التقويم الخاص بك.** قم بتوصيل Google Calendar، وشاهد الاجتماعات القادمة في الشريط الجانبي، ثم اضغط على تسجيل أي اجتماع. ستحصل على نص مباشر بالإضافة إلى ملخص AI وملاحظات نقطية وعناصر عمل بمجرد انتهاء النص.
 - **إملاء الضغط والتحدث.** اضغط باستمرار على Fn على جهازك، وتحدث، وسيسقط النص المنظف في أي تطبيق تستخدمه. يتم الاحتفاظ بكل إملاء في سجل قابل للبحث مع النسخ الأصلية والإصدارات التي تم تنظيفها بواسطة الذكاء الاصطناعي جنبًا إلى جنب.
 - **احصل على عنوان وملخص وعلامات فصول يتم إنشاؤها تلقائيًا** لكل تسجيل — يقوم الوكيل بملئها وتحديثها باستمرار.
 - **البحث عبر كل نص** — تسجيلات الشاشة والاجتماعات والإملاءات، كل ذلك في مكتبة واحدة. "ابحث عن المقطع الذي ناقشنا فيه خطة الطرح."
 - **مشاركة المقاطع** مع أذونات لكل مقطع (عام، جماعي، خاص). يعمل تتبع الروابط والتعليقات المترابطة أيضًا.
-- **معاينة المقاطع العامة في Slack** مع إمكانية اللعب بنمط Loom بعد
+- **معاينة المقاطع العامة في Slack** مع توسيع فيديو قابل للتشغيل بعد
   تقوم مساحة العمل بتثبيت تطبيق Clips Slack.
 - **التقاط سجلات المتصفح باستخدام ملحق Chrome.** يمكن تسجيلات المتصفح
   أرفق سجلات وحدة التحكم المنقحة واجلب البيانات الوصفية/XHR، وهو أمر مفيد
@@ -507,7 +508,7 @@ Clips عبارة عن قالب أكبر حجمًا يحتوي على مسجل أ
 
 ### مفتاح actions
 
-كل عملية قابلة للاستدعاء للوكيل هي ملف TypeScript في `templates/clips/actions/`، مثبت تلقائيًا في `POST /_agent-native/actions/:name` وقابل للتشغيل من CLI كـ `pnpm action <name>`. هناك ~ 80 actions؛ المجموعات المفيدة:
+كل عملية قابلة للاستدعاء للوكيل هي ملف TypeScript في `templates/clips/actions/`، مثبت تلقائيًا في `POST /_agent-native/actions/:name` وقابل للتشغيل من CLI كـ `pnpm action <name>`. هناك نحو 100 إجراء؛ المجموعات المفيدة:
 
 - **دورة حياة التسجيل** — `create-recording`، `finalize-recording`، `update-recording`، `set-thumbnail`، `archive-recording` / `restore-recording` / `trash-recording` / `delete-recording-permanent`، `move-recording`، `tag-recording`.
 - **النص والذكاء الاصطناعي** — `request-transcript`، `cleanup-transcript`، `regenerate-title` / `regenerate-summary` / `regenerate-chapters`، `set-chapters`، `generate-workflow`. (`cleanup-transcript` و`finalize-meeting` عبارة عن مكالمات عبر قنوات الوسائط من جانب الخادم؛ وتفوض معظم ميزات الذكاء الاصطناعي الأخرى إلى دردشة الوكيل.)

package/corpus/core/docs/content/locales/ar-SA/template-design.mdx

@@ -11,7 +11,7 @@ description: "استوديو نماذج أولية HTML للوكيل - يمكن
   <Screen
     surface="desktop"
     html={
-      "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>صفحة إطلاق المنتج</h1><span class='wf-pill accent'>Desktop</span><span class='wf-pill'>Tablet</span><span class='wf-pill'>Mobile</span><div style='flex:1'></div><button>معاينة</button><button class='primary'>Export code</button></div><div class='wf-card' style='flex:1;display:grid;grid-template-rows:auto 1fr auto;gap:12px'><div style='display:flex;gap:8px'><span class='wf-pill accent'>Hero</span><span class='wf-pill'>Pricing</span><span class='wf-pill'>FAQ</span></div><div class='wf-box' style='display:flex;align-items:center;justify-content:center;min-height:230px'><strong>نموذج HTML أولي مولد</strong></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span class='wf-muted'>اجعل القسم الرئيسي أكثر كثافة والدعوة إلى الإجراء أوضح.</span><div style='flex:1'></div><button class='primary'>تطبيق المراجعة</button></div></div></div>"
+      "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>صفحة إطلاق المنتج</h1><span class='wf-pill accent'>Desktop</span><span class='wf-pill'>Tablet</span><span class='wf-pill'>Mobile</span><div style='flex:1'></div><button>معاينة</button><button class='primary'>Export code</button></div><div class='wf-card' style='flex:1;display:grid;grid-template-rows:auto 1fr auto;gap:12px'><div style='display:flex;gap:8px'><span class='wf-pill accent'>Hero</span><span class='wf-pill'>Pricing</span><span class='wf-pill'>FAQ</span></div><div class='wf-box' style='display:flex;flex-direction:column;gap:12px;min-height:230px;padding:20px'><div style='display:flex;flex-direction:column;align-items:center;gap:8px;text-align:center'><strong style='font-size:22px'>أطلق أسرع مع Agent-Native</strong><span class='wf-muted' style='max-width:70%'>أنشئ نموذجًا أوليًا يعمل من مطالبة، ثم حسّنه في مكانه.</span><button class='primary'>ابدأ الآن</button></div><div style='display:grid;grid-template-columns:repeat(3,1fr);gap:10px;flex:1'><div class='wf-card' style='min-height:56px'></div><div class='wf-card' style='min-height:56px'></div><div class='wf-card' style='min-height:56px'></div></div></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span class='wf-muted'>اجعل القسم الرئيسي أكثر كثافة والدعوة إلى الإجراء أوضح.</span><div style='flex:1'></div><button class='primary'>تطبيق المراجعة</button></div></div></div>"
     }
   />
 </WireframeBlock>
@@ -91,6 +91,7 @@ description: "استوديو نماذج أولية HTML للوكيل - يمكن
 ## ما يمكنك فعله به
 
 - **إنشاء نماذج أولية كاملة.** قم بوصف الشاشة أو الصفحة التي تحتاجها وسيقوم الوكيل بإنشاء مستند HTML صالح مع تصميم Tailwind وAlpine interactions.
+- **ابدأ من قوالب قابلة لإعادة الاستخدام.** اختر مقاسًا جاهزًا للإعلانات أو مستندات الصفحة الواحدة أو صفحات الهبوط، أو احفظ أي تصميم مضمّن كقالب. تعدّل المطالبة المحتوى غير المقفل فقط وتحافظ على الشعارات والخلفيات المقفلة.
 - **مقارنة المتغيرات.** ابدأ باتجاهات متعددة، واختر الاتجاه الأقوى، ثم تابع التحسين.
 - **التعديل بشكل مرئي.** استخدم عناصر التحكم في التعديل المضمنة لإجراء التغييرات الشائعة، أو اطلب من الوكيل تحديثات النسخ والتخطيط واللون والتباعد والتفاعل.
 - **تطبيق أنظمة التصميم.** يمكنك حفظ تفضيلات نظام التصميم وإعادة استخدامها حتى يظل العمل الذي يتم إنشاؤه أقرب إلى علامتك التجارية.
@@ -135,6 +136,8 @@ pnpm dev
 
 تعيش جميع البيانات في SQL عبر Drizzle ORM. المخطط: `templates/design/server/db/schema.ts`. تحمل التصميمات وأنظمة التصميم معيار `ownableColumns` وجدول مشاركات إطار عمل مطابق، بحيث يتم إدراجها في نموذج المشاركة لكل مستخدم / لكل مؤسسة.
 
+يغطي الجدول أدناه الموارد الأساسية القابلة للملكية — التصميمات والملفات والقوالب والإصدارات وأنظمة التصميم. وتدعم سبعة جداول أخرى في المخطط نفسه ميزات موضحة في مواضع أخرى من هذا المستند بدلًا من نموذج الموارد الأساسي: `design_localhost_connections` و`design_localhost_write_grants` (وضع مصدر localhost)، و`component_index` (فهرسة المكونات)، و`motion_timeline` (الحركة)، و`design_state` (لقطات حالة المحرر)، و`design_fusion_edits` (وضع دمج التطبيق الكامل)، و`design_review_snapshot` (لقطات المراجعة).
+
 | الجدول                                   | ما يحمله                                                                                                                                |
 | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
 | `designs`                                | مشروع تصميم — `title`، و`description`، و`project_type` (`prototype` / `other`)، و`data` JSON، ورابط `design_system_id` الاختياري        |

package/corpus/core/docs/content/locales/ar-SA/template-dispatch.mdx

@@ -5,7 +5,11 @@ description: "Dispatch هو مستوى التحكم في مساحة العمل
 
 # إرسال
 
-> **راجع أيضًا:** للحصول على نظرة عامة مفاهيمية حول ما تفعله Dispatch وعندما تريد ذلك، راجع [Dispatch](/docs/dispatch). هذه الصفحة هي المرجع الخاص بالقالب.
+<Callout tone="info">
+
+**راجع أيضًا:** للحصول على نظرة عامة مفاهيمية حول ما تفعله Dispatch وعندما تريد ذلك، راجع [Dispatch](/docs/dispatch). هذه الصفحة هي المرجع الخاص بالقالب.
+
+</Callout>
 
 Dispatch هو **مستوى التحكم في مساحة العمل**. في حين أن القوالب الأخرى هي تطبيقات المجال (البريد، والتقويم، والتحليلات، والدماغ)، فإن Dispatch هو التطبيق الذي تقوم بتشغيله بجانبها لتنسيق كل شيء: البريد الوارد المركزي، وقبو الأسرار، والمهام المجدولة، وتكامل Slack/Telegram، ووكيل منسق يقوم بتفويض عمل المجال إلى التطبيق المتخصص المناسب عبر [A2A](/docs/a2a-protocol).
 

package/corpus/core/docs/content/locales/ar-SA/template-mail.mdx

@@ -362,3 +362,11 @@ npx @agent-native/core@latest add-app
 **تغيير اختصارات لوحة المفاتيح.** توجد معالجات Keybind في `templates/mail/app/components/email/` — ابحث عن `useHotkeys` أو `addEventListener("keydown"` للعثور على مكان توصيل كل مفتاح.
 
 اطلب من الوكيل إجراء أي من هذه التغييرات نيابةً عنك. يمكن للوكيل تعديل المصدر الخاص به — راجع [Self-Modifying Code](/docs/key-concepts#agent-modifies-code).
+
+## ما التالي
+
+- [**القوالب**](/docs/cloneable-saas) — نموذج الاستنساخ والامتلاك، وكل قالب نطاق آخر يمكنك البدء منه
+- [**بدء الاستخدام**](/docs/getting-started) — أساسيات إطار العمل: الإجراءات وحالة التطبيق والمزامنة المباشرة
+- [**التقويم**](/docs/template-calendar) — قالب نطاق شقيق للجدولة والحجز
+- [**الأتمتة**](/docs/automations) — المحرك المستند إلى الأحداث الذي تعتمد عليه قواعد الفرز التلقائي في Mail
+- [**الإجراءات**](/docs/actions) — نظام الإجراءات الذي تستدعيه المحادثة والاختصارات والأتمتة

package/corpus/core/docs/content/locales/ar-SA/tracking.mdx

@@ -127,6 +127,8 @@ import { defineAction } from "@agent-native/core/action";
 import { track } from "@agent-native/core/tracking";
 import { z } from "zod";
 
+import { getDb, schema } from "../server/db/index.js";
+
 export default defineAction({
   description: "Create a new project.",
   schema: z.object({
@@ -134,14 +136,15 @@ export default defineAction({
     template: z.string().optional(),
   }),
   run: async ({ name, template }, ctx) => {
-    const project = await db
-      .insert(projects)
+    const db = getDb();
+    const [project] = await db
+      .insert(schema.projects)
       .values({ name, template })
       .returning();
 
-    track("project.created", { name, template }, { userId: ctx.userEmail });
+    track("project.created", { name, template }, { userId: ctx?.userEmail });
 
-    return { ok: true, projectId: project[0].id };
+    return { ok: true, projectId: project.id };
   },
 });
 ```
@@ -349,5 +352,5 @@ interface TrackingEvent {
 ## ما هي الخطوة التالية
 
 - [**Actions**](/docs/actions) — حيث تنشأ معظم مكالمات التتبع
-- [**Server Plugins**](/docs/server) — يعمل `registerBuiltinProviders()` في البرنامج الإضافي للمسارات الأساسية عند بدء التشغيل
-- [**Secrets**](/docs/security) - إدارة مفاتيح API لموفري التتبع
+- [**Server Plugins**](/docs/server#server-plugins) — يعمل `registerBuiltinProviders()` في البرنامج الإضافي للمسارات الأساسية عند بدء التشغيل
+- [**الأمان — إدارة الأسرار**](/docs/security#secrets) - إدارة مفاتيح API لموفري التتبع

package/corpus/core/docs/content/locales/ar-SA/using-your-agent.mdx

@@ -92,21 +92,14 @@ description: "الحلقة اليومية للعمل مع الوكيل: فهو
 
 الوكيل ليس تطبيقًا منفصلاً يمكنك الانتقال إليه. إنه يأتي كمجموعة من مكونات React - شريط جانبي، ولوحة أولية، ومكالمة `sendToAgentChat()` - التي تضعها في أي تطبيق. اعرض `<AgentSidebar>` لمنح كل شاشة وكيلًا قابلاً للتبديل، أو قم بتوصيل زر لتسليم مهمة معينة إلى الدردشة بدلاً من تشغيل مكالمة LLM لمرة واحدة.
 
-← [**Drop-in Agent**](/docs/drop-in-agent) - قم بتثبيت `<AgentPanel>` و`<AgentSidebar>` و`sendToAgentChat()` في أي تطبيق React.
-← [**Agent Surfaces**](/docs/agent-surfaces) - اختر ما إذا كان سير العمل يجب أن يكون بدون رأس، أو الدردشة أولاً، أو مضمنًا، أو تطبيقًا كاملاً.
-
 ## يمكنك استخدام واجهة خفيفة {#ui-light}
 
 لا يحتاج كل تطبيق إلى لوحة تحكم كاملة. عندما يكون الوكيل هو المنتج، يمكنك تخطي معظم UI المخصصة: افتح التطبيق، واطلب ما تريد، واترك الوكيل يقوم بالباقي. لا يزال لدى الوكيل سطح الإدارة الخاص به - السجل ومساحة العمل والإعدادات - ولكن التفاعل الأساسي هو المحادثة وليس النقرات.
 
-← [**Automation-First Apps**](/docs/pure-agent-apps) — تطبيقات بلا متصفح من أجل jobs وqueues وscripts وagents خارجية.
-
 ## يمكنك المشاركة في التحرير معه {#you-co-edit}
 
 عندما تعمل أنت والوكيل على نفس المستند، لا تتناوبان. من خلال التعاون في الوقت الفعلي، يتم بث تعديلات الوكيل جنبًا إلى جنب مع تعديلاتك - مؤشرات مباشرة، بدون استبدال - بنفس الطريقة التي يقوم بها زميل الفريق. يمكنك الاستمرار في الكتابة أثناء العمل، وسيرى التغييرات فور حدوثها.
 
-← [**Real-Time Collaboration**](/docs/real-time-collaboration) — تحرير تعاوني متعدد المستخدمين باستخدام المؤشرات المباشرة وتحريرات الوكيل في نفس المستند.
-
 ## ما هي الخطوة التالية {#whats-next}
 
 - [**Context Awareness**](/docs/context-awareness) — يعرف الوكيل ما تنظر إليه

package/corpus/core/docs/content/locales/ar-SA/voice-input.mdx

@@ -9,6 +9,12 @@ description: "الإملاء الصوتي في مؤلف دردشة الوكيل
 
 يتعامل إطار العمل مع كل هذا تلقائيًا. يحصل المستخدمون المتصلون بـ Builder على Gemini Flash-Lite المستضاف على Builder افتراضيًا؛ وإلا يمكن للمستخدمين إحضار مفتاح الموفر الخاص بهم أو العودة إلى التعرف على الكلام في المتصفح.
 
+## وضع المحادثة الصوتية الفورية {#realtime-speech-mode}
+
+عند فتح الميكروفون، تتيح نافذة منبثقة الاختيار بين **محادثة صوتية فورية** و**إملاء قابل للتحرير**. يتطلب الوضع الفوري مفتاح `OPENAI_API_KEY` مخصصًا للمستخدم، ويوصل المتصفح بنموذج `gpt-realtime-2.1` عبر WebRTC. تنكمش الدردشة إلى كرة صوتية في الزاوية السفلية اليسرى؛ انقر على الكرة لإظهار الدردشة أو إخفائها من دون إنهاء المحادثة.
+
+يستخدم نموذج المحادثة الصوتية أدوات Agent Native المصادق عليها نفسها التي تستخدمها الدردشة، لذا يمكنه التنقل داخل التطبيق واستدعاء الإجراءات أثناء التحدث. تظل الإجراءات التي تتطلب موافقة معلقة حتى توافق عليها. لا يُخزن الصوت مطلقًا في SQL؛ يحتفظ Agent Native فقط بحالة موجزة للجلسة والنص المنسوخ. لا تتجاوز مدة الجلسة الفورية 60 دقيقة.
+
 ## كيفية العمل {#how-it-works}
 
 يسجل زر صوت الملحن الصوت في المتصفح، ثم يختار الموفر:

package/corpus/core/docs/content/locales/ar-SA/workspace-connections.mdx

@@ -425,10 +425,9 @@ const brainCatalog = await listWorkspaceConnectionProviderCatalogForApp({
 
 ### إعداد طائرة التحكم في الإرسال
 
-يكشف Dispatch عن مستوى التحكم actions الذي يكتب نفس وظائف المتجر المشتركة التي يمكن للتطبيق الاتصال بها مباشرة:
+يكشف Dispatch عن إجراءات مستوى التحكم التي تكتب عبر وظائف المتجر المشتركة نفسها التي يمكن للتطبيق استدعاؤها مباشرة — إذ يتحقق إجراء `upsert-workspace-connection` من صحة الإدخال مقابل كتالوج الموفّرين، ثم يفوّض إلى `upsertWorkspaceConnection()` نفسها الموضحة في هذه الصفحة:
 
 ```ts
-// templates/dispatch/actions/upsert-workspace-connection.ts delegates to this.
 await upsertWorkspaceConnection({
   id: "team-slack",
   provider: "slack",
@@ -493,3 +492,11 @@ await upsertWorkspaceConnectionGrant({
 حافظ على الحدود صارمة: عرض بيانات تعريف الموفر آمن؛ تبقى قيم بيانات الاعتماد في المخزن.
 
 </details>
+
+## ما التالي {#whats-next}
+
+- [**Dispatch**](/docs/dispatch) — التطبيق الذي يدير عادةً إعداد اتصالات مساحة العمل والمخزن
+- [**الأمان**](/docs/security) — مخزن بيانات الاعتماد ونطاق الأسرار ونموذج الوصول الذي تشير إليه الاتصالات
+- [**التهيئة**](/docs/onboarding#checking-workspace-connections-in-onboarding) — التحقق من جاهزية الاتصال من قائمة إعداد القالب
+- [**عملاء MCP**](/docs/mcp-clients) — مشاركة بيانات اعتماد خادم MCP عبر مساحة العمل كنمط إعداد قابل لإعادة الاستخدام
+- [**Brain**](/docs/template-brain) — التطبيق المرجعي لصفحة مصادر الموفّرين المبنية على هذا النموذج

package/corpus/core/docs/content/locales/ar-SA/workspace.mdx

@@ -5,7 +5,11 @@ description: "تخصيص Claude على مستوى التعليمات البرم
 
 # مساحة العمل
 
-> **ما هو مستند مساحة العمل؟** تغطي هذه الصفحة **طبقة التخصيص** — ما هي مساحة العمل. للحصول على شكل النشر (مونوريبو واحد، العديد من التطبيقات) راجع [Multi-App Workspaces](/docs/multi-app-workspace)؛ بالنسبة للحوكمة (من يراجع ويوافق ويمتلك ماذا) راجع [Workspace Governance](/docs/workspace-management).
+<Callout tone="info">
+
+**ما هو مستند مساحة العمل؟** تغطي هذه الصفحة **طبقة التخصيص** — ما هي مساحة العمل. للحصول على شكل النشر (مونوريبو واحد، العديد من التطبيقات) راجع [Multi-App Workspaces](/docs/multi-app-workspace)؛ بالنسبة للحوكمة (من يراجع ويوافق ويمتلك ماذا) راجع [Workspace Governance](/docs/workspace-management).
+
+</Callout>
 
 يأتي كل تطبيق وكيل أصلي مزودًا بـ **مساحة عمل**: طبقة التخصيص التي تجعل الوكيل ملكًا لك. فهو يحتوي على تعليمات الفريق (`AGENTS.md`)، والتعلم المشترك (`LEARNINGS.md`)، والذاكرة المنظمة الشخصية (`memory/MEMORY.md`)، وskills الذي يسحبه الوكيل عند الطلب، والوكلاء الفرعيين المخصصين، والمهام المجدولة، وخوادم MCP المتصلة — كل ما تتوقعه من إعداد Claude Code / Codex.
 
@@ -82,7 +86,7 @@ description: "تخصيص Claude على مستوى التعليمات البرم
 | `CLAUDE.md` / skills لكل مشروع         | `AGENTS.md` لكل تطبيق + موارد ذاكرة مساحة العمل  |
 | تكوين MCP في ملف JSON                  | تكوين MCP في JSON _أو_ الإعدادات UI، لكل نطاق    |
 
-نفس الإمكانيات. اقتصاد مختلف. راجع [Templates](/docs/cloneable-saas) لمعرفة سبب أهمية ذلك بالنسبة إلى SaaS.
+نفس الإمكانيات. اقتصاد مختلف. راجع [التطبيقات](/docs/cloneable-saas) لمعرفة سبب أهمية ذلك بالنسبة إلى SaaS.
 
 ## نظرة عامة {#overview}
 
@@ -220,11 +224,9 @@ workspace context/brand.md
 -> personal context/brand.md
 ```
 
-اجعل ملفات `context/` قصيرة وواقعية — بضع نقاط يمكن للوكيل قراءتها:
-
-```text
-<!-- context/brand.md -->
+على سبيل المثال:
 
+```text filename="context/brand.md"
 # العلامة التجارية
 
 - Voice: direct, warm, concrete
@@ -389,15 +391,9 @@ Skills هي ملفات موارد Markdown ضمن مسار `skills/` (يفضل `
 
 استخدم الوكلاء المخصصين للتفويض داخل تطبيق واحد. استخدم الوكلاء المتصلين عندما تحتاج إلى الاتصال بتطبيق آخر عبر A2A.
 
-## @ وضع العلامات {#at-tagging}
-
-اكتب `@` في مدخلات الدردشة للإشارة إلى عناصر مساحة العمل. تظهر قائمة منسدلة عند المؤشر تعرض الوكلاء والملفات المطابقة. استخدم مفاتيح الأسهم للتنقل وEnter للاختيار. يظهر العنصر المحدد كشريحة مضمنة في الإدخال.
-
-عندما ترسل رسالة، يتم تمرير **الملفات/الموارد** كمراجع يمكن للوكيل قراءتها، ويعمل **الوكلاء المخصصون** محليًا باستخدام تعليمات ملفاتهم الشخصية، ويتم استدعاء **الوكلاء المتصلين** عبر A2A.
+## الإشارة بـ @ وأوامر / {#at-tagging}
 
-## / أوامر الشرطة المائلة {#slash-commands}
-
-اكتب `/` في بداية السطر لاستدعاء إحدى المهارات. تعرض القائمة المنسدلة skills المتاحة بأسمائها وأوصافها؛ يؤدي تحديد واحدة إلى إضافة شريحة مضمنة ويتضمن محتواها كسياق عند إرسال الرسالة. إذا لم يتم تكوين skills، فإن القائمة المنسدلة ترتبط بهذه المستندات.
+اكتب `@` في إدخال الدردشة للإشارة إلى وكيل أو ملف أو مورد، أو `/` لاستدعاء مهارة — يفتح كلاهما قائمة منسدلة عند المؤشر ويضيف شريحة مضمنة عند تحديد عنصر. راجع [إشارات الوكيل](/docs/agent-mentions) للآليات الكاملة (التوجيه و`MentionProvider` واختيار الوكيل الفرعي)، و[دليل المهارات](/docs/skills-guide) لمعرفة كيفية تأليف المهارات واكتشافها.
 
 ## وضع الكود مقابل وضع التطبيق {#dev-vs-prod}
 
@@ -417,10 +413,6 @@ Skills هي ملفات موارد Markdown ضمن مسار `skills/` (يفضل `
 
 راجع [Workspace Connections](/docs/workspace-connections) للتعرف على أمثلة التشغيل السريع والاتصال/المنح/بيانات الاعتماد API، وأمثلة Slack وHubSpot وGitHub الملموسة.
 
----
-
-# المرجع
-
 ## المورد API {#resource-api}
 
 يمكن إدارة الموارد من كود الخادم، actions، أو REST API.
@@ -464,3 +456,12 @@ pnpm action resource-write --path "notes/meeting.md" --content "# ملاحظات
 # حذف مورد
 pnpm action resource-delete --path "notes/old.md"
 ```
+
+## الخطوة التالية {#whats-next}
+
+- [**دليل المهارات**](/docs/skills-guide) — تأليف ملفات المهارات المشار إليها من `skills/` وتحديد نطاقها
+- [**إشارات الوكيل**](/docs/agent-mentions) — الآليات الكاملة لإشارات `@` وأوامر `/`
+- [**المهام المتكررة**](/docs/recurring-jobs) — جدولة المطالبات المنشأة من المهام المجدولة
+- [**حوكمة مساحة العمل**](/docs/workspace-management) — من يراجع تغييرات مساحة العمل ويوافق عليها ويمتلكها
+- [**مساحات العمل متعددة التطبيقات**](/docs/multi-app-workspace) — شكل النشر الذي تمتد إليه مساحة عمل واحدة
+- [**اتصالات مساحة العمل**](/docs/workspace-connections) — مشاركة بيانات اعتماد المزوّدين بين التطبيقات

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

@@ -11,7 +11,7 @@ Actions sind die einzige Quelle der Wahrheit für alles, was Ihre App tut. Defin
 - **Typsichere React-Hooks** – `useActionQuery("name")` und `useActionMutation("name")` im Frontend, Typen aus dem Schema abgeleitet.
 - **Imperative Client-Aufrufe** – `callAction("name", params)`, wenn ein Hook nicht passt.
 - **Framework-Transport** – wird automatisch vom Framework hinter diesen Hooks bereitgestellt und ist für externe HTTP-Clients verfügbar.
-- **Ein MCP-Tool** – verfügbar für benutzerdefinierte MCP-Apps von Claude, ChatGPT, Claude Desktop/Code, Cursor, Codex und alle anderen MCP-Clients.
+- **Ein MCP-Tool** – verfügbar für benutzerdefinierte MCP-Apps von Claude, ChatGPT, Claude Desktop/Code, Cursor, Codex und alle anderen MCP-Hosts.
 - **Ein A2A-Tool** – wird von anderen agentennativen Apps über A2A aufgerufen.
 - **Ein CLI-Befehl** – `pnpm action <name>` für Skripterstellung und Entwicklungsschleifen.
 
@@ -562,7 +562,7 @@ export default defineAction({
 });
 ```
 
-Behalten Sie `link` als Fallback für CLI- und Nicht-UI-MCP-Clients bei; Es ist auch das Startziel der Einbettung. Die Embed Bridge – die signierte Embed-Start-Sitzung, Transplantation vs. Controlled-Frame-Rendering, die `ui/*` Host Bridge, CSP und Height Clamping – ist Eigentum von [External Agents](/docs/external-agents#mcp-app-bridge).
+Behalten Sie `link` als Fallback für CLI- und Nicht-UI-MCP-Hosts bei; Es ist auch das Startziel der Einbettung. Die Embed Bridge – die signierte Embed-Start-Sitzung, Transplantation vs. Controlled-Frame-Rendering, die `ui/*` Host Bridge, CSP und Height Clamping – ist Eigentum von [External Agents](/docs/external-agents#mcp-app-bridge).
 
 ## Standard actions {#standard-actions}
 

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

@@ -97,9 +97,9 @@ coherent kit instead of exposing package boundaries in the app.
 
 - [UI Primitives](/docs/toolkit-ui) cover shared shadcn-style primitives under
   `@agent-native/toolkit/ui/*`.
-- [App Adapters](/docs/toolkit-app-adapters) show how apps wrap Toolkit pieces
+- [App Adapters](/docs/toolkit-ui#app-adapters) show how apps wrap Toolkit pieces
   through local `@/components/*` adapters.
-- [Shell & Hooks](/docs/toolkit-shell-hooks) cover header actions, mobile hooks,
+- [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.

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

@@ -141,8 +141,7 @@ pnpm install
 
 Definieren Sie dann den dauerhaften Betrieb:
 
-```ts
-// actions/summarize-week.ts
+```ts filename="actions/summarize-week.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -496,12 +495,11 @@ Halten Sie den Vertrag klein: Definieren Sie dauerhafte Operationen als actions,
 Widget-Ergebnisse, wenn der Chat umfangreiches UI benötigt, und Vollbildanzeigen nur hinzufügen, wenn Benutzer
 müssen persistente Objekte durchsuchen, vergleichen, konfigurieren oder zusammenarbeiten.
 
-## Verwandte Dokumente {#related-docs}
+## Wie geht es weiter? {#related-docs}
 
-- [Actions](/docs/actions) – Definieren Sie den Headless-Vorgang einmal.
-- [Native Chat-Oberfläche](/docs/native-chat-ui) – typisierte Aktionsergebnisse im Chat rendern.
-- [Drop-in Agent](/docs/drop-in-agent) – Chat-, Seitenleisten- oder Bedienfeldoberflächen bereitstellen.
-- [Component API](/docs/components) – React Chat-/Komponistenstücke auf niedrigerer Ebene.
-- [Embedding SDK](/docs/embedding-sdk) – Agent-Native zu einer vorhandenen App hinzufügen.
-- [External Agents](/docs/external-agents) – MCP-kompatible Hosts mit einer App verbinden.
-- [A2A Protocol](/docs/a2a-protocol) – Agenten von anderen Agenten anrufen.
+- [**Actions**](/docs/actions) – Definieren Sie den Vorgang einmal; jede Oberfläche oben ruft denselben auf
+- [**Native Chat-Oberfläche**](/docs/native-chat-ui) – Typisierte Aktionsergebnisse als Tabellen, Diagramme und Karten im Chat rendern
+- [**Generative UI**](/docs/generative-ui) – Temporäre oder persistierte Sandbox-UI direkt im Chat generieren
+- [**Automation-First Apps**](/docs/pure-agent-apps) – Das vollständige browserlose Muster für Jobs, Warteschlangen, Skripte und externe Agenten
+- [**External Agents**](/docs/external-agents) – MCP-kompatible Hosts mit einer App verbinden
+- [**A2A Protocol**](/docs/a2a-protocol) – Agenten aus anderen Agent-Native-Apps aufrufen

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

@@ -239,6 +239,7 @@ interface AgentTask {
   summary: string; // full summary once completed
   currentStep: string; // latest step label (updated while running)
   createdAt: number;
+  delegationDepth?: number; // 1 for a direct sub-agent, 2 for a sub-agent of that sub-agent, etc.
   // Additional fields: parentThreadId, name, updatedAt, startedAt,
   // completedAt, runId, error
 }

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

@@ -15,7 +15,7 @@ Auth wird automatisch über `autoMountAuth(app)` im Authentifizierungsserver-Plu
 - **Remote MCP OAuth:** Standard OAuth 2.1 für MCP-Hosts wie Claude-Code und ChatGPT-Anschlüsse.
 - **Benutzerdefiniert:** Bringen Sie Ihre eigene Authentifizierung über den `getSession`-Rückruf mit.
 
-<Diagram id="doc-block-1hpxy2j" title="Drei Wege rein, eine Sitzung" summary={"Browserbesucher, programmatische MCP-Clients und benutzerdefinierte Anbieter werden alle in dieselbe AuthSession aufgelöst, die das Downstream-Scoping liest."}>
+<Diagram id="doc-block-1hpxy2j" title="Drei Wege rein, eine Sitzung" summary={"Browserbesucher, MCP-Hosts und benutzerdefinierte Anbieter werden alle in dieselbe AuthSession aufgelöst, die das Downstream-Scoping liest."}>
 
 ```html
 <div class="auth-modes">

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

@@ -476,10 +476,12 @@ Aktion, damit UI und Agent die gleiche Funktion nutzen.
 ```ts
 import { defineAction } from "@agent-native/core/action";
 import { completeText } from "@agent-native/core/server";
+import { z } from "zod";
 
 export default defineAction({
   description: "Classify a short message",
-  run: async ({ body }: { body: string }) => {
+  schema: z.object({ body: z.string() }),
+  run: async ({ body }) => {
     const result = await completeText({
       systemPrompt: "Return exactly one label.",
       input: body,
@@ -494,3 +496,11 @@ export default defineAction({
 Verwenden Sie stattdessen `sendToAgentChat({ background: true, openSidebar: false })`, wenn
 Die Arbeit erfordert Tools, Status, Überprüfbarkeit, Benutzersteuerung oder mehrere Schritte
 Begründung.
+
+## Wie geht es weiter {#whats-next}
+
+- [**Drop-in Agent**](/docs/drop-in-agent) — `<AgentSidebar>` und `<AgentPanel>` mit einer tutorialorientierten Einführung einbinden
+- [**Native Chat UI**](/docs/native-chat-ui) — der Action-Ergebnisvertrag hinter Daten-Widgets und benutzerdefinierten Renderern
+- [**Actions**](/docs/actions) — `defineAction()`, Schemas und die von diesen Komponenten aufgerufene Action-Oberfläche
+- [**Real-Time Collaboration**](/docs/real-time-collaboration) — Kollaborations-Hooks und Anwesenheitskomponenten im Detail
+- [**Sharing**](/docs/sharing) — Verdrahtung von `<ShareButton>` und `<ShareDialog>` für besitzbare Ressourcen

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

@@ -44,7 +44,6 @@ Jede Vorlage folgt dem gleichen allgemeinen Layout:
 <FileTree
   id="doc-block-153a4yn"
   title="Projektstruktur des Templates"
-  title="my-template/"
   entries={[
     {
       path: "app/",
@@ -172,8 +171,7 @@ Die vier Bereiche jeder Vorlage sind über eine gemeinsame Aktionsoberfläche un
 
 Definieren Sie Domänentabellen mit den Framework-Drizzle-Helfern, damit Schemata über SQLite, Postgres, D1, Turso, Supabase, Neon und andere unterstützte Backends hinweg portierbar bleiben:
 
-```ts
-// server/db/schema.ts
+```ts filename="server/db/schema.ts"
 import {
   table,
   text,
@@ -204,8 +202,7 @@ Schemaänderungen müssen additiv sein. Fügen Sie Tabellen und Spalten über `r
 
 Für App-Lese- und Schreibvorgänge verwenden Sie den Abfrage-Builder von Drizzle und die portablen Operatoren von `drizzle-orm`. Schreiben Sie keinen Produktcode mit rohem SQL, wenn Drizzle die Abfrage ausdrücken kann, und importieren Sie nicht aus `drizzle-orm/sqlite-core` oder `drizzle-orm/pg-core` in Vorlagen.
 
-```ts
-// server/plugins/db.ts
+```ts filename="server/plugins/db.ts"
 import { runMigrations } from "@agent-native/core/db";
 
 export default runMigrations(
@@ -349,8 +346,7 @@ Bevorzugen Sie für die App-Navigation einen `navigate`-Befehl, der einen gleich
 `path`, wenn URL bekannt ist. Schreiben Sie nicht auch `__set_url__` für denselben Zug;
 Dieser Schlüssel ist für die Framework-URL-Tools und nur URL-Filteränderungen reserviert.
 
-```ts
-// actions/navigate.ts
+```ts filename="actions/navigate.ts"
 import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { z } from "zod";

package/corpus/core/docs/content/locales/de-DE/cross-app-sso.mdx

@@ -9,7 +9,11 @@ Jede gehostete App bei `*.agent-native.com` führt ihre eigene Bereitstellung mi
 
 Dies ist das gleiche Vertrauensprimitiv, das [A2A](/docs/a2a-protocol) und [External Agents](/docs/external-agents) bereits verwenden – ein `A2A_SECRET`-signiertes JWT, das an der Anforderungsgrenze überprüft wird – angewendet auf den menschlichen Anmeldepfad anstelle von Agent-zu-Agent-Aufrufen.
 
-> **Einheitliche Bereitstellung vs. Bereitstellung pro Domäne.** Wenn Sie alle Apps an einem Ursprung hosten (`your-agents.com/mail`, `your-agents.com/calendar`), erhalten Sie bereits eine gemeinsame Anmeldung über eine einzige Cookie-Domäne – kein Verbund erforderlich. Cross-App SSO ist nur erforderlich, wenn Apps auf separaten Domänen ausgeführt werden. Siehe [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment).
+<Callout tone="info">
+
+**Einheitliche Bereitstellung vs. Bereitstellung pro Domäne.** Wenn Sie alle Apps an einem Ursprung hosten (`your-agents.com/mail`, `your-agents.com/calendar`), erhalten Sie bereits eine gemeinsame Anmeldung über eine einzige Cookie-Domäne – kein Verbund erforderlich. Cross-App SSO ist nur erforderlich, wenn Apps auf separaten Domänen ausgeführt werden. Siehe [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment).
+
+</Callout>
 
 ## Was und warum {#what-why}
 
@@ -86,15 +90,17 @@ Der Ablauf ist eine standardmäßige Autorisierung → Signiertes Token → Rüc
 
 </Diagram>
 
-1. **App → Versenden (autorisieren).** Die App sendet den Benutzer an die Identitätsbehörde:
+1. **App → Dispatch (Autorisierung).** Die app-seitige Route `GET /_agent-native/identity/login` (auf die die Schaltfläche „Mit Agent-Native anmelden“ verweist) erstellt die Weiterleitung und sendet den Benutzer an die Identitätsautorität:
 
-   ```
+   ```http
    GET https://dispatch.agent-native.com/_agent-native/identity/authorize
        ?app=<requesting-app>
        &redirect_uri=<app-callback-url>
        &state=<csrf-state>
    ```
 
+   `redirect_uri` ist die app-eigene Route `GET /_agent-native/identity/callback` – die Route, die in Schritt 3 das signierte Token empfängt.
+
 <Endpoint id="cross-app-sso-identity-authorize-de-de" title="Identity Authorize Endpoint" method="GET" path="/_agent-native/identity/authorize" summary={"Dispatch (Identitätsbehörde) authentifiziert den Menschen und leitet ihn mit einem signierten Identitätstoken zurück"} auth="Sitzung weiterleiten (interaktive Anmeldung, falls keine)" params={[
   {
     "name": "app",
@@ -143,7 +149,7 @@ Der Ablauf ist eine standardmäßige Autorisierung → Signiertes Token → Rüc
    | `scope`      | Immer `"identity"` – dieses Token autorisiert nur die Anmeldung                  |
    | `exp`        | **≤ 2 Minuten** ab Problem                                                       |
 
-4. **App verifiziert und JIT-Links per E-Mail.** Die App überprüft die Token-Signatur mit ihrem eigenen `A2A_SECRET`, überprüft `scope: "identity"` und `exp` und führt dann **Just-in-Time-Verknüpfung ausschließlich per verifizierter E-Mail** durch:
+4. **Die App überprüft und verknüpft Just-in-Time per E-Mail.** Die Route `GET /_agent-native/identity/callback` überprüft die Token-Signatur mit `A2A_SECRET`, prüft `scope: "identity"` und `exp` und führt dann **Just-in-Time-Verknüpfung ausschließlich anhand der verifizierten E-Mail-Adresse** durch:
    - Wenn ein lokaler Benutzer mit dieser E-Mail existiert → unverändert wiederverwenden.
    - Wenn nicht → erstellen Sie einen lokalen Benutzer für diese E-Mail.
 
@@ -290,9 +296,13 @@ Sobald eine App verifiziert ist, wiederholen Sie die Schritte 2–3 für die nä
 **5. Rollback = Deaktivieren Sie die Umgebungsvariable bei der Bereitstellung dieser App.**
 Um eine App zurückzusetzen, **entfernen Sie `AGENT_NATIVE_IDENTITY_HUB_URL` aus der Umgebung dieser App und stellen Sie sie erneut bereit/starten Sie sie neu.** Die App kehrt sofort zu ihrem vorherigen Authentifizierungsverhalten zurück. Es gibt **keine Datenänderung, die rückgängig gemacht werden kann** – Identitätszeilen wurden immer nur hinzugefügt, und das Deaktivieren der Variablen macht den Verbundpfad einfach wieder in den Ruhezustand. Die Umstellung und das Rollback jeder App sind unabhängig und umkehrbar.
 
-> Beim Rollout werden Benutzer abgemeldet, wenn jede App aktiviert wird (sie authentifizieren sich erneut über Dispatch), aber sie melden sich immer wieder beim **gleichen E-Mail-abgeglichenen Konto mit intakten Daten** an, da Identitätszeilen nie zerstört oder umbenannt, sondern nur hinzugefügt werden.
+<Callout tone="info">
+
+Beim Rollout werden Benutzer abgemeldet, wenn jede App aktiviert wird (sie authentifizieren sich erneut über Dispatch), aber sie melden sich immer wieder beim **gleichen E-Mail-abgeglichenen Konto mit intakten Daten** an, da Identitätszeilen nie zerstört oder umbenannt, sondern nur hinzugefügt werden.
+
+</Callout>
 
-## Verwandt {#related}
+## Wie geht es weiter? {#whats-next}
 
 - [Authentication](/docs/authentication) – lokale Authentifizierungsmodi, Sitzungen, Organisationen, die `A2A_SECRET`-Umgebungsvariable.
 - [A2A Protocol](/docs/a2a-protocol) – das signierte JWT-Vertrauensmodell mit Überprüfung an der Grenze, das hier wiederverwendet wird.

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

@@ -452,3 +452,11 @@ Weitere Informationen zum eingebetteten Agent-Panel im Vergleich zu Cloud-Frame-
 ## Mehrinstanzbereitstellungen {#multi-instance}
 
 Agent-native Apps speichern den gesamten Status in SQL über Drizzle und synchronisieren den UI über [polling](/docs/key-concepts#polling-sync) mit der Datenbank – kein Dateisystemstatus, keine Sticky Sessions, keine In-Memory-Caches. Das bedeutet, dass Bereitstellungen mit mehreren Instanzen und serverlosen Bereitstellungen sofort funktionieren: Richten Sie jede Instanz auf denselben `DATABASE_URL` und sie konvergieren automatisch. Siehe [Key Concepts — Data in SQL](/docs/key-concepts#data-in-sql) und [Portability](/docs/key-concepts#hosting-agnostic).
+
+## Wie geht es weiter?
+
+- [**Database**](/docs/database#production) — Wählen Sie vor der ersten Produktionsbereitstellung ein persistentes SQL-Backend
+- [**Security**](/docs/security) — Die Produktionscheckliste und die auf dieser Seite erwähnten Opt-in-Flags
+- [**Authentication**](/docs/authentication) — OAuth-Anmeldedaten und Umgebungsvariablen für den gewählten Authentifizierungsmodus
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — Das Workspace-Modell hinter dem Single-Origin-Build von `deploy`
+- [**Frames**](/docs/frames) — Das eingebettete Agent-Panel gegenüber dem Cloud-Frame von Builder.io für UI-Änderungen in der Produktion