@agent-native/core 0.76.5 → 0.76.6

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

@@ -0,0 +1,220 @@
+---
+title: "إرسال"
+description: "Dispatch هو مستوى التحكم في مساحة العمل — البريد الوارد المركزي، والتنسيق عبر التطبيقات، ومخزن الأسرار، وتكامل Slack/Telegram، والمهام المجدولة."
+---
+
+# إرسال
+
+> **راجع أيضًا:** للحصول على نظرة عامة مفاهيمية حول ما تفعله Dispatch وعندما تريد ذلك، راجع [Dispatch](/docs/dispatch). هذه الصفحة هي المرجع الخاص بالقالب.
+
+Dispatch هو **مستوى التحكم في مساحة العمل**. في حين أن القوالب الأخرى هي تطبيقات المجال (البريد، والتقويم، والتحليلات، والدماغ)، فإن Dispatch هو التطبيق الذي تقوم بتشغيله بجانبها لتنسيق كل شيء: البريد الوارد المركزي، وقبو الأسرار، والمهام المجدولة، وتكامل Slack/Telegram، ووكيل منسق يقوم بتفويض عمل المجال إلى التطبيق المتخصص المناسب عبر [A2A](/docs/a2a-protocol).
+
+```an-wireframe
+{
+  "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'>Dispatch</h1><span class='wf-pill accent'>Overview</span><span class='wf-pill'>Inbox</span><span class='wf-pill'>Secrets</span><span class='wf-pill'>Approvals</span><div style='flex:1'></div><button>Schedules</button></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>What should we do next?</strong><div class='wf-box'>Ask Analytics for this week's signups and draft a Slack update.</div><button class='primary'>Delegate</button></div><div style='display:grid;grid-template-columns:repeat(3,1fr);gap:10px'><div class='wf-card'><strong>Mail</strong><br/><small>/mail</small></div><div class='wf-card'><strong>Calendar</strong><br/><small>/calendar</small></div><div class='wf-card'><strong>Analytics</strong><br/><small>/analytics</small></div><div class='wf-card'><strong>Slides</strong><br/><small>/slides</small></div><div class='wf-card'><strong>Forms</strong><br/><small>/forms</small></div><div class='wf-card'><strong>Create app</strong><br/><small>+</small></div></div><div class='wf-card' style='display:grid;grid-template-columns:repeat(3,1fr);gap:8px'><div class='wf-box'>Slack DM needs reply</div><div class='wf-box'>A2A task completed</div><div class='wf-box'>Approval required</div></div></div>"
+}
+```
+
+إذا كنت تقوم بتشغيل [multi-app workspace](/docs/multi-app-workspace) مع العديد من التطبيقات، فإن Dispatch هو الغراء.
+
+```an-diagram title="Orchestrate, don't specialize" summary="Messages from every channel land in one inbox; the orchestrator triages and delegates domain work to the right specialist app over A2A — secrets, resources, and approvals stay central."
+{
+  "html": "<div class=\"diagram-dispatch\"><div class=\"diagram-col\"><div class=\"diagram-node\">Slack · Telegram</div><div class=\"diagram-node\">Email</div><div class=\"diagram-node\">A2A requests</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><span class=\"diagram-pill accent\">Orchestrator</span><small class=\"diagram-muted\">central inbox · triage · route</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-node\">Mail agent</div><div class=\"diagram-node\">Analytics agent</div><div class=\"diagram-node\">Brain · Slides &hellip;</div></div></div><div class=\"diagram-shared\"><span class=\"diagram-pill\">Secrets vault</span><span class=\"diagram-pill\">Workspace resources</span><span class=\"diagram-pill warn\">Approvals</span><span class=\"diagram-pill\">Scheduled jobs</span></div>",
+  "css": ".diagram-dispatch{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-dispatch .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-dispatch .diagram-box{display:flex;flex-direction:column;gap:4px}.diagram-dispatch .diagram-arrow{font-size:20px;line-height:1}.diagram-shared{display:flex;gap:8px;flex-wrap:wrap;margin-top:12px}"
+}
+```
+
+## ماذا يفعل {#what-it-does}
+
+- **البريد الوارد المركزي.** رسائل مباشرة Slack، ورسائل Telegram، وإشعارات البريد الإلكتروني، وطلبات A2A من وكلاء آخرين - كل ذلك في مكان واحد. يقوم وكيل الإرسال بفرزها ويتعامل معها بنفسه أو بتفويضه. راجع [Messaging](/docs/messaging) لمعرفة كيفية توصيل Slack والبريد الإلكتروني وTelegram بمساحة العمل الخاصة بك.
+- **منسق، وليس متخصصًا.** لا تحاول شركة Dispatch أن تكون تطبيق البريد الإلكتروني أو تطبيق التحليلات. عندما يسأل أحد الأشخاص "تلخيص عمليات الاشتراك في الأسبوع الماضي"، تتصل Dispatch بوكيل التحليلات عبر A2A وتقوم بإرجاع الإجابة. عندما يطلب شخص ما "صياغة رد على أليس"، تتصل ديسباتش بوكيل البريد.
+- **واجهة مستوى التحكم.** تعيش الدردشات والمشاريع وعمليات التشغيل وتطبيقات مساحة العمل والوكلاء وعمليات التشغيل الآلي في هيكل تشغيلي واحد، مع قوائم الحالة الأولى وعمليات التعمق بدلاً من لوحات المعلومات لمرة واحدة.
+- **خزنة الأسرار.** مخزن مركزي لمفاتيح API ورموز OAuth وبيانات الاعتماد المشتركة. تعمل التطبيقات الموجودة في مساحة العمل على حل الأسرار من Dispatch بدلاً من تكرارها في كل `.env`. الطلبات + الموافقات للوصول الحساس.
+- **موارد مساحة العمل.** يمكن إنشاء skills العالمية وتعليمات الدرابزين وملفات تعريف الوكيل المخصصة والموارد المرجعية وخوادم HTTP MCP مرة واحدة في Dispatch. يتم توريث جميع موارد التطبيقات في وقت التشغيل بواسطة كل تطبيق دون الحاجة إلى نسخ أو خطوة مزامنة يدوية؛ المنح المحددة مخصصة للاستثناءات الخاصة بالتطبيق.
+- **عمليات تكامل قابلة لإعادة الاستخدام.** مكان واحد لربط حسابات الموفرين، والتتبع
+  مراجع بيانات الاعتماد، ومنح التطبيقات حق الوصول. تمتلك ديسباتش هوية المزود و
+  منح التطبيق؛ لا تزال تطبيقات المجال تمتلك خيارات مصدر خاصة بالتطبيقات مثل Brain's
+  القائمة المسموح بها لقناة Slack أو تهيئة المقياس/لوحة التحكم في Analytics.
+- **مركز المهام المجدولة.** [recurring jobs](/docs/recurring-jobs) عبر التطبيقات مباشرة هنا: "كل يوم من أيام الأسبوع الساعة 7، استخرج المقاييس الرئيسية للأمس من التحليلات وقم بصياغة رسالة بريد إلكتروني ملخصة صباحية."
+- **Dreams.** يمكن لـ Dispatch مراجعة عمليات تشغيل العميل الأخيرة، والإخفاقات، والتعليقات، والأنماط الناجحة لاقتراح تحسينات في الذاكرة والمهارة والوظيفة والتعليمات قبل تطبيق أي شيء دائم.
+- **تدفق الموافقة.** يمكن أن تتطلب عمليات actions المدمرة أو الخارجية (إرسال الأموال، وشحن البريد الإلكتروني الصادر، والنشر على Slack على نطاق واسع) موافقة المشرف قبل إطلاقها. ديسباتش تمتلك قائمة الانتظار.
+
+## متى يتم استخدامه {#when-to-use}
+
+استخدم الإرسال عندما:
+
+- لديك **اثنين أو أكثر** من تطبيقات الوكيل الأصلية في مساحة العمل وتريد مكانًا واحدًا للتنسيق بينهما.
+- تحتاج إلى **أسرار مركزية** مع المنح لكل تطبيق ومسار التدقيق.
+- تريد **مركز مراسلة** يقوم بتوجيه Slack أو Telegram إلى وكيل النطاق الصحيح.
+- تريد **المهام المجدولة** التي تسحب البيانات من عدة تطبيقات.
+
+تخطاه للحصول على هيكل تطبيق واحد — استخدم [Chat template](/docs/template-chat) أو أي من قوالب النطاق مباشرة.
+
+عرض توضيحي مباشر: [dispatch.agent-native.com](https://dispatch.agent-native.com).
+
+## ماذا ستفعل به {#what-youll-do}
+
+يعد Dispatch هو المكان الذي يفتحه المسؤولون وأفراد العمليات يوميًا للحفاظ على تشغيل مساحة العمل:
+
+- **قم بتوصيل Slack والبريد الإلكتروني وTelegram** حتى يتمكن الأشخاص من إرسال رسائل إلى وكيلك من أي مكان يعملون فيه بالفعل. راجع [Messaging](/docs/messaging) للتعرف على خطوات توصيل الأسلاك.
+- **احفظ الأسرار المشتركة مرة واحدة.** توجد مفاتيح API ورموز OAuth وبيانات اعتماد الخدمة في المخزن ويتم سحب التطبيقات الأخرى في مساحة العمل الخاصة بك من هناك بدلاً من أن يتلاعب كل عضو في الفريق بـ `.env` الخاص به.
+- **الاتصال بموفري الخدمة مرة واحدة.** تعمل عمليات التكامل القابلة لإعادة الاستخدام على تخزين البيانات الوصفية الآمنة للحساب
+  ومراجع بيانات الاعتماد، ثم امنح تطبيقات مثل Brain أو Analytics أو Mail أو
+  إمكانية الوصول للإرسال دون نسخ الأسرار الأولية. المصدر الخاص بالتطبيق
+  يظل التكوين في التطبيق الذي يستخدم الموفر.
+- **كشف موصل MCP واحد.** إضافة
+  `https://dispatch.agent-native.com/_agent-native/mcp` في Claude، ChatGPT،
+  Codex أو Cursor أو مضيف MCP آخر، ثم اختر تطبيقات مساحة العمل التي سيتم تشغيلها
+  من صفحة **الوكلاء** الخاصة بـ Dispatch. استخدم التطبيق المباشر URL
+  فقط عندما يجب عزل هذا المضيف لتطبيق واحد.
+- **إدارة عمليات التشغيل التلقائي.** تعرض طريقة عرض عمليات التشغيل التلقائي حالة التمكين، آخر تشغيل،
+  التشغيل التالي، والخطأ الأخير من جداول `jobs/*.md` الأساسية، ويتيح
+  يمكنك تمكين أو تعطيل مهمة دون تحرير الملفات يدويًا.
+- **حافظ على سياق الشركة عالميًا.** ضع الشخصيات، وتحديد المواقع، والرسائل، وحقائق الشركة، وإرشادات العلامة التجارية، وحواجز الحماية في Dispatch Resources مرة واحدة، ثم قم بمعاينة مساحة العمل الفعالة -> التطبيق/المؤسسة -> المجموعة الشخصية لأي تطبيق/مستخدم أو افحص المجموعة من عرض سياق بطاقة التطبيق.
+- **إعداد المهام المتكررة.** "كل يوم اثنين في الساعة 7 صباحًا، اطلب من وكيل التحليلات الاشتراكات في الأسبوع الماضي وأرسل لي ملخصًا عبر البريد الإلكتروني." انظر [Recurring Jobs](/docs/recurring-jobs).
+- **مراجعة مقترحات الأحلام.** تقوم Dispatch Dreams بفحص عمليات تشغيل الوكيل السابقة وإنشاء مقترحات مدعومة بالمصدر لما يجب أن تتذكره مساحة العمل، والملاحظات القديمة التي يجب تنظيفها، والدروس المتكررة التي يجب أن تصبح skills أو وظائف.
+- **الموافقة على actions الصادرة قبل إطلاق النار.** يمكن إرسال الأموال أو إرسال رسائل بريد إلكتروني جماعية إلى العملاء أو النشر على قناة Slack العامة من خلال موافقة المشرف.
+- **معرفة من يمكنه الوصول إلى ماذا.** المنح لكل تطبيق، وقائمة انتظار الطلبات، وسجل التدقيق لمن استخدم السر ومتى.
+- **توجيه الرسائل إلى المتخصص المناسب.** تنتقل رسالة مباشرة Slack حول التحليلات إلى وكيل التحليلات؛ يتم إرسال تقرير يتعلق بالبريد الإلكتروني إلى وكيل البريد - يختار Dispatch.
+
+## نظرة سريعة على الهندسة المعمارية {#architecture}
+
+_كيفية العمل تحت الغطاء (للمطورين)._
+
+- **وكيل Orchestrator.** تم إعداد الدردشة كجهاز توجيه: فهو يقرأ `AGENTS.md`، و`LEARNINGS.md`، ويوجه إلى وكلاء فرعيين متخصصين أو وكلاء A2A عن بعد.
+- **تسجيل الوكيل البعيد.** بيانات وكيل A2A هي إدخالات وقت تشغيل مساحة العمل (وليست مجلد مصدر قالب تم تسجيل الدخول): في مساحة عمل متعددة التطبيقات، يتم اكتشاف التطبيقات الشقيقة ضمن `apps/` تلقائيًا باعتبارها نظيرات A2A - لا حاجة للتسجيل اليدوي. تستدعيهم Dispatch باستخدام الإجراء `call-agent`.
+- **مخطط Vault.** جداول Drizzle للأسرار والمنح والطلبات والموافقات وسجلات التدقيق. هذه موجودة في حزمة `@agent-native/dispatch` (`packages/dispatch/src/db/schema.ts`) ويتم إعادة تصديرها إلى القالب عبر `templates/dispatch/server/db/index.ts` - لا يوجد `server/db/schema.ts` للقالب المحلي. يتم شحن وقت تشغيل Dispatch في الحزمة، وليس في مصدر القالب (بما يتوافق مع الملاحظة أدناه بأن `@agent-native/dispatch` يمتلك الصدفة والشريط الجانبي والصفحات المضمنة).
+- **مكونات Slack / Telegram الإضافية.** مكونات إضافية للخادم تسجل webhooks وتعيد توجيه الرسائل الواردة إلى وكيل المنسق.
+- **موارد مساحة العمل MCP.** أضف تعريفات خادم HTTP MCP ضمن `mcp-servers/*.json` في الموارد، ثم قم بنطاقها لتشمل جميع التطبيقات أو منح التطبيقات المحددة تمامًا مثل skills والسياق.
+
+```an-schema title="Secrets vault schema" summary="Secrets are stored once; grants give a named app access; requests + reviews gate sensitive access; the audit log records who used which secret when. Defined in @agent-native/dispatch (packages/dispatch/src/db/schema.ts)."
+{
+  "entities": [
+    { "id": "secrets", "name": "vault_secrets", "note": "Stored credential values", "fields": [
+      { "name": "id", "type": "text", "pk": true },
+      { "name": "owner_email", "type": "text" },
+      { "name": "org_id", "type": "text", "nullable": true },
+      { "name": "name", "type": "text" },
+      { "name": "credential_key", "type": "text" },
+      { "name": "value", "type": "text", "note": "secret value" },
+      { "name": "provider", "type": "text", "nullable": true }
+    ] },
+    { "id": "grants", "name": "vault_grants", "note": "Per-app access grant", "fields": [
+      { "name": "id", "type": "text", "pk": true },
+      { "name": "secret_id", "type": "text", "fk": "vault_secrets.id" },
+      { "name": "app_id", "type": "text" },
+      { "name": "granted_by", "type": "text" },
+      { "name": "status", "type": "text" }
+    ] },
+    { "id": "requests", "name": "vault_requests", "note": "Access request + review", "fields": [
+      { "name": "id", "type": "text", "pk": true },
+      { "name": "credential_key", "type": "text" },
+      { "name": "app_id", "type": "text" },
+      { "name": "reason", "type": "text", "nullable": true },
+      { "name": "status", "type": "text" },
+      { "name": "reviewed_by", "type": "text", "nullable": true }
+    ] },
+    { "id": "audit", "name": "vault_audit_log", "note": "Who used which secret when", "fields": [
+      { "name": "id", "type": "text", "pk": true },
+      { "name": "secret_id", "type": "text", "fk": "vault_secrets.id", "nullable": true },
+      { "name": "app_id", "type": "text", "nullable": true },
+      { "name": "action", "type": "text" },
+      { "name": "actor", "type": "text" }
+    ] }
+  ],
+  "relations": [
+    { "from": "secrets", "to": "grants", "kind": "1-n", "label": "granted via" },
+    { "from": "secrets", "to": "audit", "kind": "1-n", "label": "use recorded by" }
+  ]
+}
+```
+
+- **وضع المحور MCP.** لا يزال بإمكان Dispatch العمل كـ [MCP hub](/docs/mcp-clients#hub) لمساحة العمل، لذا فإن كل تطبيق آخر في مساحة العمل يسحب نفس قائمة خوادم MCP ذات النطاق المؤسسي. بشكل منفصل، نقطة نهاية `/_agent-native/mcp` الخاصة بـ Dispatch هي موصل MCP الخارجي الموصى به لـ Claude وChatGPT والمضيفين الآخرين الذين يجب أن يصلوا إلى تطبيقات مساحة عمل متعددة.
+
+## الأحلام {#dreams}
+
+الأحلام هي حلقة مراجعة Dispatch لذاكرة الوكيل. يفحص Dream Pass عمليات تشغيل الوكيل الحالية، وبيانات تصحيح أخطاء الخيط، والتعليقات، والتقييمات، وحالات فشل الأداة المتكررة، ثم يكتب تقريرًا بالتغييرات المقترحة. يمكن أن تستهدف المقترحات الذاكرة الشخصية، أو `LEARNINGS.md` المشتركة، أو تعليمات مساحة العمل، أو مساحة العمل skills، أو المعرفة بمساحة العمل، أو وكلاء مساحة العمل، أو المهام المتكررة، ولكن تظل التغييرات المشتركة وعلى مستوى مساحة العمل قابلة للمراجعة بدلاً من تطبيقها بصمت.
+
+يتم فحص مقترحات الأحلام مقابل فهرس الذاكرة الشخصية وملفات `memory/*.md` الموجودة و`LEARNINGS.md` المشتركة قبل حفظها. يتم تخطي الدروس المكررة في التقرير، بينما يتم تحديث الذكريات الشخصية التي من المحتمل أن تكون قديمة في مكانها بدلاً من إنتاج ملاحظات موازية. ضمن التقرير، تقوم Dreams أيضًا بإلغاء تكرار الأدلة المتكررة حسب سلسلة الرسائل ونوع الإشارة والاقتباس الموحد، وتزيل السياق المُدخل من اكتشاف تصحيح المستخدم، وتلخص صفوف التقييم/الأداة الأولية في نقاط نقطية يمكن قراءتها بواسطة الإنسان قبل ظهورها في نص الاقتراح. عندما يعثر التمرير على إشارات ولكنه لا ينشئ أي مقترحات عمدًا، يتضمن التقرير ملاحظات حاجزة تشرح الأدلة التي تم إخفاؤها.
+
+عند تمكين سياسة الموافقة على الإرسال، يؤدي تطبيق اقتراح حلم مشترك أو على مستوى الفريق إلى إنشاء طلب موافقة معلق بدلاً من كتابته على الفور. يؤدي إنشاء مورد مساحة عمل التطبيق بالكامل أو تحديثه أو حذفه أيضًا إلى وضع طلب الموافقة في قائمة الانتظار. لا يزال من الممكن تطبيق مقترحات الذاكرة الشخصية وتعديلات الموارد المحددة فقط مباشرة بعد المراجعة.
+
+استخدم Dreams عندما تريد الإجابة عن أسئلة مثل "ما الأخطاء التي ارتكبها العملاء هذا الأسبوع؟"، أو "ما الذي يجب أن نتذكره؟"، أو "ما الدرس المتكرر الذي يستحق مهارة؟" يتم التعامل مع الأدلة الواردة Slack والبريد الإلكتروني وTelegram وWhatsApp والأدلة المشتقة من الويب على أنها مدخلات غير موثوقة، لذا تتطلب المقترحات الواردة من تلك المصادر المراجعة والمصدر قبل أن تؤثر على الذاكرة المشتركة. تتطلب مقترحات تعليمات مساحة العمل أدلة متينة تغطي موضوعين على الأقل أو تطبيقين مصدريين؛ تبقى ضوضاء التقييم فقط، ومشكلات إعداد الحساب، وحدود الحصص، وتصحيحات الصياغة UI للتطبيق الواحد خارج نطاق التعليمات العامة.
+
+### حدود التحقق من صحة مدخلات الحلم
+
+نظرًا لأنه يتم جمع الأدلة من مصادر خارجية غير موثوقة (مثل نصوص الدردشة، وwebhooks، وعمليات تكامل الجهات الخارجية)، يفرض معالج Dream حدودًا صارمة للتحقق من صحة الإدخال لمنع الإدخال الفوري والهجمات بحجم الحمولة:
+
+- **حدود حجم البايت:** يتم وضع حد أقصى لحمولات سلسلة الرسائل الفردية بحد أقصى 10 كيلو بايت من المحتوى النصي لكل رسالة، ويتم اقتطاع عمليات فحص المرشحين إذا تجاوزت 100 كيلو بايت إجمالاً لمنع استنفاد السياق.
+- **التطهير:** يتم تطهير جميع مدخلات النص لإزالة أحرف التحكم، والحمولات الثنائية، ونطاقات Unicode غير القابلة للطباعة.
+- **التحقق من صحة المخطط:** يتم تحليل بيانات تصحيح الأخطاء الواردة ومحفوظات سلسلة المحادثات وفقًا لمخططات Zod الصارمة قبل تجميعها في مطالبات LLM. يتم تجاهل أي بنية مرشحة تفشل في التحقق من صحة المخطط على الفور من مجموعة المعالجة.
+- **Escaping:** يتم الهروب من جميع أجزاء النص التي يقدمها المستخدم ديناميكيًا عند تنسيقها في قوالب المطالبة لمنع الإدخال الفوري (على سبيل المثال، محاولة الاستيلاء على حلقة Dream لكتابة تعليمات عشوائية).
+
+في Dispatch UI، افتح **Dreams** لتشغيل تمرير يدوي، ومراجعة سلاسل الرسائل المرشحة، وفحص التقرير، وفتح ورقة مراجعة كل اقتراح قبل تطبيقه أو رفضه. استخدم **الإعدادات** لتحرير جدول cron المتكرر، ونطاق المصدر، وحدود المهلة/التزامن، وحد المرشح، والحد الأدنى لعتبة المرشح؛ استخدم **تأكد من الجدول الزمني** بعد الحفظ عندما تريد أن تتحقق مهمة `jobs/dispatch-dream.md` المتكررة من تلك الإعدادات. تعرض ورقة المراجعة سلوك الموافقة، والمحتوى المستهدف الحالي، والمحتوى المقترح، والأدلة المصدرية. يستخدم الوكلاء نفس سير العمل من خلال actions:
+
+- يبحث `list-dream-candidates` عن سلاسل رسائل حديثة تحتوي على إشارات مؤرضة مثل تصحيحات المستخدم الصريحة، وعمليات التشغيل الفاشلة، وأخطاء الأدوات، والتعليقات، وفشل التقييم، وسير العمل الناجح الذي تم وضع نقاط تفتيش فيه. قم بتمرير `sourceId: "all"` أو `sourceIds` لفحص مصادر تصحيح أخطاء الخيوط المتعددة؛ تحافظ `sourceTimeoutMs`، و`sourceConcurrency`، و`sourceStartStaggerMs`، و`threadConcurrency`، و`threadTimeoutMs` على عمليات فحص الإنتاج جزئية ومحدودة، وتتضمن الاستجابة سلامة كل مصدر.
+- يقوم `create-dream-report` بإنشاء التقرير والمقترحات المعلقة. تشتمل التقارير متعددة المصادر على قسم صحة المصدر بحيث تكون عمليات الفحص الجزئي مرئية أثناء المراجعة. يمكن أن تصبح التصحيحات المتكررة والإخفاقات المتكررة مقترحات لموارد مساحة العمل مثل `workspace-instruction`؛ يمكن أن تصبح عمليات سير العمل الناجحة المتكررة والمحددة بنقاط تفتيش مقترحات `workspace-skill`.
+- يقوم كل من `get-dream-settings` و`set-dream-settings` بقراءة وتحديث جدول الأحلام المتكرر ونطاق المصدر وعناصر التحكم في المهلة/التزامن والحد الأدنى والحد الأدنى للمرشح.
+- تتعامل `get-dream` و`preview-dream-proposal` و`apply-dream-proposal` و`reject-dream-proposal` مع المراجعة.
+- ينشئ `ensure-dream-job` مهمة الأحلام المتكررة والآمنة بمجرد أن تصبح التقارير اليدوية مفيدة.
+
+يكشف مشغل الإجراء المحلي لقالب Dispatch أيضًا عن Dispatch actions المعبأ، لذا يمكنك أثناء التطوير تشغيل نفس سير العمل من `apps/dispatch`:
+
+```bash
+pnpm action get-dream-settings
+pnpm action set-dream-settings --enabled true --schedule "0 9 * * 1" --allSources true --limit 8
+pnpm action create-dream-report --allSources true --sourceTimeoutMs 30000 --limit 8
+```
+
+## السقالات {#scaffolding}
+
+```bash
+npx @agent-native/core@latest create my-platform
+# pick "Dispatch" in the multi-select picker, plus whichever domain apps you want
+```
+
+إذا كنت تفضل تسمية القالب مباشرةً بدلاً من استخدام المنتقي:
+
+```bash
+npx @agent-native/core@latest create my-platform --template dispatch
+# add more apps in the same workspace as you go
+```
+
+عادةً ما يتم دمج Dispatch في مساحة العمل جنبًا إلى جنب مع التطبيقات التي يقوم بتنسيقها. بالنسبة لمساحة العمل، يتم توريث مصادقة Dispatch المشتركة وقاعدة البيانات والعلامة التجارية من قلب مساحة العمل - راجع [Multi-App Workspace](/docs/multi-app-workspace).
+
+لا يوجد إرسال `--standalone` ذي معنى: مستوى التحكم الذي لا يوجد به أي شيء للتنسيق هو مجرد صندوق بريد وارد فارغ. قم بتركيبها في مساحة عمل باستخدام تطبيق مجال واحد على الأقل بحيث يكون لديها وكلاء لتوجيههم عبر A2A. (لا تزال العلامة تعمل وتنتج تطبيقًا قابلاً للتشغيل، ولكن ليس لدى المُنسق أي متخصصين يمكن تفويضهم إليه حتى تقوم بإضافة تطبيقات شقيقة.)
+
+## أول تشغيل محلي {#first-local-run}
+
+من جذر مساحة العمل:
+
+```bash
+pnpm install
+pnpm dev
+```
+
+افتح Dispatch URL المطبوع بواسطة خادم التطوير. يستخدم التطوير المحلي نفس تدفق تسجيل الدخول Better Auth مثل الإنتاج. إنشاء حساب محلي بالبريد الإلكتروني + كلمة المرور؛ يتم تخطي التحقق من البريد الإلكتروني أثناء التطوير، ويتم تخزين كلمة المرور فقط في قاعدة بيانات التطبيق المحلية لديك. لا يوجد تجاوز مصادقة مدعوم في الهيكل الافتراضي، لأن الوكيل وموارد مساحة العمل والمخزن ونموذج المشاركة كلها تعتمد على جلسة مستخدم حقيقية.
+
+يمكنك النقر فوق Dispatch UI بعد تسجيل الدخول. لاستخدام مؤلف الدردشة أو تشغيل مهام الوكيل، قم بتوصيل موفر LLM أولاً:
+
+1. افتح **الإعدادات**.
+2. في **LLM**، قم بتوصيل Builder.io أو أضف مفتاح الموفر الخاص بك مثل `ANTHROPIC_API_KEY`.
+3. ارجع إلى **نظرة عامة** وجرب الملحن.
+
+## تخصيصه {#customize}
+
+Dispatch هو قالب كامل مثل أي قالب آخر - راجع [Templates](/docs/cloneable-saas). اطلب من الوكيل "إضافة تكامل جديد لـ Datadog" أو "توجيه الرسائل المباشرة Slack من القناة X إلى وكيل التحليلات" وسيقوم بتحرير تكوين التوجيه، وإضافة معالج خطاف الويب، وتوصيل الأسلاك.
+
+بالنسبة لشاشات الإدارة الخاصة بمساحة العمل، أضف صفحات جهاز التوجيه React المحلية و
+قم بتسجيلهم في `app/dispatch-extensions.tsx`. تمتلك مساحة العمل التي تم إنشاؤها
+فقط علامة التبويب والمسار الإضافيين؛ يستمر `@agent-native/dispatch` في امتلاك الصدفة،
+الشريط الجانبي والصفحات المضمنة وتحديثات الحزمة المستقبلية.
+
+## ما هي الخطوة التالية
+
+- [**Messaging**](/docs/messaging) — ربط Slack والبريد الإلكتروني وTelegram حتى تتمكن من التحدث إلى وكيلك من أي مكان
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — تشغيل Dispatch جنبًا إلى جنب مع تطبيقات متعددة
+- [**A2A Protocol**](/docs/a2a-protocol) — كيفية تفويض Dispatch إلى الوكلاء المتخصصين
+- [**MCP Clients — Hub Mode**](/docs/mcp-clients#hub) — مشاركة خوادم MCP عبر مساحة العمل
+- [**Recurring Jobs**](/docs/recurring-jobs) — المهام المجدولة التي يتم تشغيلها في الإرسال

package/corpus/core/docs/content/locales/ar-SA/template-forms.md

@@ -0,0 +1,178 @@
+---
+title: "النماذج"
+description: "أداة إنشاء النماذج الأصلية للوكيل — إنشاء عمليات إرسال النماذج وتحريرها ونشرها وتوجيهها من خلال اللغة الطبيعية بالإضافة إلى محرر مرئي."
+---
+
+# النماذج
+
+Forms عبارة عن أداة إنشاء نماذج أصلية للوكيل. قم بوصف النموذج الذي تريده، وقم بتحسينه في المحرر، وانشر نموذجًا عامًا يخزن عمليات الإرسال في قاعدة بيانات SQL الخاصة بك.
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px;padding:14px 16px;border-bottom:1.4px solid var(--wf-line)'><strong>Beta signup</strong><span class='wf-pill accent'>published</span><div style='flex:1'></div><button>Share</button><button class='primary'>Unpublish</button></div><div style='display:flex;gap:8px;padding:12px 16px;border-bottom:1.4px solid var(--wf-line)'><span class='wf-pill accent'>Edit</span><span class='wf-pill'>Results 187</span><span class='wf-pill'>Settings</span><span class='wf-pill'>Integrations</span></div><div style='display:flex;flex-direction:column;gap:12px;padding:30px 78px;overflow:hidden'><h2 style='margin:0'>Beta signup</h2><p class='wf-muted' style='margin:0'>Reserve a spot in the upcoming private beta cohort.</p><div class='wf-card'><strong>Full name</strong><input value='Ada Lovelace'/></div><div class='wf-card'><strong>Work email</strong><input value='you@company.com'/></div><div class='wf-card'><strong>Your role</strong><input value='Select...'/></div><div class='wf-card'><strong>Team size</strong><input value='Select...'/></div></div></div>"
+}
+```
+
+عند فتح التطبيق، ترى النماذج والمحرر الحالي والمعاينة المباشرة. يمكن للوكيل إنشاء نموذج من موجه، وتحديث تسميات الحقول وخياراتها، وتغيير التحقق من الصحة، وتوصيل وجهات الإرسال باستخدام نفس actions الذي يستخدمه UI.
+
+```an-diagram title="Build, publish, collect" summary="The agent and the visual editor edit one SQL-backed form definition. The public fill page is unauthenticated, and submissions route server-side to your destinations."
+{
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">Agent prompt<br><small class=\"diagram-muted\">\"add an NPS question\"</small></div><div class=\"diagram-node\">Visual editor<br><small class=\"diagram-muted\">labels, validation, order</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">create-form · update-form</span><small class=\"diagram-muted\">fields JSON, settings JSON</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">forms table<br><small class=\"diagram-muted\">SQL via Drizzle</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">Public fill page<br><small class=\"diagram-muted\">unauthenticated</small></div><div class=\"diagram-box\">responses<br><small class=\"diagram-muted\">+ Slack / webhook / Sheets</small></div></div></div>",
+  "css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+## ما يمكنك فعله به
+
+- **إنشاء النماذج بشكل تحادثي.** "إنشاء نموذج اتصال"، "أضف سؤال نتيجة NPS"، "اجعل حقل البريد الإلكتروني مطلوبًا." يقوم الوكيل بتحديث مخطط النموذج وتحديثات المعاينة من الحالة المدعومة SQL.
+- **الضبط البصري.** قم بتحرير التسميات والعناصر النائبة والحالة المطلوبة والخيارات وترتيب الحقول من أداة الإنشاء UI عندما تريد التحكم المباشر.
+- **استخدم أنواع الحقول المشحونة.** يتم دعم حقول النص والبريد الإلكتروني والرقم والنص الطويل والتحديد والتحديد المتعدد ومربع الاختيار والراديو والتاريخ والتقييم والمقياس بشكل جاهز.
+- **جمع الردود.** يتم تخزين كل إرسال في SQL مع عرض التفاصيل لكل إجابة ولوحة معلومات لمراجعة الإدخالات.
+- **توجيه عمليات الإرسال.** أرسل حمولات الإرسال إلى webhooks، أو Slack، أو Discord، أو Google Sheets باستخدام عمليات التكامل المضمنة.
+- **نشر النماذج العامة.** شارك نموذجًا عامًا URL وأظهر رسالة شكر بعد الإرسال.
+
+## البدء
+
+عرض توضيحي مباشر: [forms.agent-native.com](https://forms.agent-native.com).
+
+1. **قم بإنشاء نموذج من الموجه.** اطلب النموذج الذي تريده، بما في ذلك
+   الجمهور وما يجب أن يحدث بعد الإرسال.
+2. **التحسين في المحرر.** ضبط التسميات والتحقق من الصحة والاختيارات والترتيب في
+   المنشئ المرئي عندما يكون التحرير المباشر أسرع.
+3. **النشر والمشاركة.** استخدم النموذج العام URL للمستجيبين، ثم شاهد
+   تصل النتائج إلى عرض الردود.
+4. **توصيل الوجهات.** توجيه عمليات الإرسال الجديدة إلى Slack، Discord، Google
+   جداول البيانات، webhooks، أو نقطة الامتداد الخاصة بك.
+
+### مطالبات مفيدة
+
+- "أنشئ نموذج اشتراك تجريبي يتضمن الدور وحجم الفريق وحالة الاستخدام ذات الأولوية."
+- "أضف سؤال NPS المطلوب ومتابعة النص الحر."
+- "انشر كل رد جديد على قناة Slack للمنتج."
+- "تلخيص عمليات الإرسال لهذا الأسبوع وتجميعها حسب شريحة العملاء."
+- "اجعل هذا النموذج أقصر دون فقدان الحقول التي نحتاجها للتوجيه."
+
+## للمطورين
+
+باقي هذا المستند مخصص لأي شخص يقوم بتعديل قالب النماذج أو توسيعه.
+
+### بداية سريعة
+
+```bash
+npx @agent-native/core@latest create my-forms --standalone --template forms
+cd my-forms
+pnpm install
+pnpm dev
+```
+
+بالنسبة لمساحة العمل التي تحتوي على النماذج إلى جانب التطبيقات الأخرى:
+
+```bash
+npx @agent-native/core@latest create my-platform
+```
+
+اختر النماذج وأي قوالب أخرى تريدها أثناء إعداد مساحة العمل.
+
+### الميزات الرئيسية {#key-features}
+
+**تعريفات نماذج JSON.** توجد الحقول في عمود `fields` JSON واحد، لذا يستطيع الوكيل إجراء تعديلات جراحية دون إجراء تغييرات على المخطط لكل نوع حقل.
+
+**صفحات التعبئة العامة.** يمكن للمستجيبين إرسال نماذج لم تتم مصادقتها، بينما تتم إزالة الإعدادات الخاصة قبل وصول البيانات إلى المتصفح.
+
+**الوجهات من جانب الخادم.** تظهر عمليات تكامل Slack وDiscord وجداول بيانات Google وخطاف الويب في إعدادات النموذج ويتم تشغيلها بعد الإرسال.
+
+### نموذج البيانات
+
+تعيش جميع البيانات في SQL عبر Drizzle ORM. المخطط: `templates/forms/server/db/schema.ts`. تحمل النماذج `ownableColumns` القياسي وجدول مشاركات إطار العمل المطابق، بحيث يتم إدخالها في نموذج المشاركة لكل مستخدم/لكل مؤسسة.
+
+| الجدول        | ما يحمله                                                                                                                                                                                            |
+| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `forms`       | تعريف النموذج — `title`، `description`، `slug` الفريد، `fields` (مصفوفة JSON من `FormField`)، `settings` (JSON `FormSettings`)، `status` (`draft` / `published` / `closed`)، وحذف ناعم `deleted_at` |
+| `responses`   | إرسال واحد لكل صف — `form_id`، `data` (JSON `{ fieldId: value }`)، `submitted_at`، `ip` اختياري و`submitter_email`                                                                                  |
+| `form_shares` | يشارك الإطار مبادئ تعيين الجدول (المستخدمين أو المؤسسات) إلى الأدوار (العارض، المحرر، المسؤول) لكل نموذج                                                                                            |
+
+يتم تعريف الأشكال `fields` و`settings` JSON في `templates/forms/shared/types.ts` (`FormField`، `FormSettings`). تتم إزالة الإعدادات الخاصة بالمالك مثل خطاف الويب التكاملي URL والأصول المسموح بها قبل أن تصل أي بيانات إلى صفحة التعبئة العامة عبر `toPublicFormSettings`.
+
+```an-schema title="Forms data model" summary="Three tables. Fields and integrations are JSON columns on forms, so the agent's edits are surgical patches rather than cross-table row changes."
+{
+  "entities": [
+    {
+      "id": "forms",
+      "name": "forms",
+      "note": "A form definition (ownable)",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "title", "type": "string" },
+        { "name": "description", "type": "string", "nullable": true },
+        { "name": "slug", "type": "string", "note": "unique; public URL" },
+        { "name": "fields", "type": "json", "note": "FormField[] — all field types" },
+        { "name": "settings", "type": "json", "note": "FormSettings — integrations, etc." },
+        { "name": "status", "type": "enum", "note": "draft | published | closed" },
+        { "name": "deleted_at", "type": "datetime", "nullable": true, "note": "soft delete" },
+        { "name": "owner_email", "type": "string" },
+        { "name": "org_id", "type": "id", "nullable": true }
+      ]
+    },
+    {
+      "id": "responses",
+      "name": "responses",
+      "note": "One submission per row",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "form_id", "type": "id", "fk": "forms.id" },
+        { "name": "data", "type": "json", "note": "{ fieldId: value }" },
+        { "name": "submitted_at", "type": "datetime" },
+        { "name": "ip", "type": "string", "nullable": true },
+        { "name": "submitter_email", "type": "string", "nullable": true }
+      ]
+    },
+    {
+      "id": "form_shares",
+      "name": "form_shares",
+      "note": "Framework shares table — principals to roles per form",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "form_id", "type": "id", "fk": "forms.id" },
+        { "name": "principal", "type": "string", "note": "user or org" },
+        { "name": "role", "type": "enum", "note": "viewer | editor | admin" }
+      ]
+    }
+  ],
+  "relations": [
+    { "from": "forms", "to": "responses", "kind": "1-n", "label": "has responses" },
+    { "from": "forms", "to": "form_shares", "kind": "1-n", "label": "has share grants" }
+  ]
+}
+```
+
+### مفتاح actions
+
+كل عملية هي ملف TypeScript في `templates/forms/actions/`، مثبت تلقائيًا في `POST /_agent-native/actions/:name`:
+
+- `create-form` — إنشاء نموذج جديد (العنوان، الوصف، الحقول، الإعدادات)
+- `update-form` - تحديث الحقول أو الإعدادات أو الحالة
+- `get-form` — استرداد نموذج بالمعرف أو بالارتباط الثابت
+- `list-forms` — قائمة النماذج التي يمكن الوصول إليها
+- `delete-form` — الحذف الناعم (مجموعة `deleted_at`)
+- `restore-form` — استعادة نموذج محذوف بشكل بسيط
+- `list-responses` — قائمة عمليات الإرسال لنموذج يحتوي على مرشحات اختيارية
+- `export-responses` — تصدير الاستجابات بتنسيق CSV أو JSON
+
+### تخصيصه
+
+اطلب من الوكيل سلوك الشحن أولاً:
+
+- "أضف حقل اختيار مطلوب لطريقة الاتصال المفضلة."
+- "نشر كل إرسال جديد إلى Slack." قم بتوصيل Slack أولاً عبر [Messaging](/docs/messaging).
+- "أضف وجهة الرد التلقائي على الويب لـ CRM."
+- "إنشاء نموذج تعليقات العملاء بمقياس من 1 إلى 10 ومتابعة نصية طويلة."
+- "اجعل بعض النماذج عامة والبعض الآخر لتسجيل الدخول فقط."
+
+إذا كنت بحاجة إلى إمكانات جديدة مثل تحميلات الملفات أو التوقيعات أو عناصر واجهة المستخدم المخصصة للحقول، فتعامل معها كامتدادات للقوالب: أضف شكل SQL وعناصر تحكم محرر actions وUI ودعم العارض العام وتعليمات الوكيل معًا. راجع [Creating Templates](/docs/creating-templates) للتعرف على نمط البناء الحالي.
+
+## ما هي الخطوة التالية
+
+- [**Templates**](/docs/cloneable-saas) — نموذج الاستنساخ والامتلاك
+- [**Actions**](/docs/actions) — نظام العمل الذي يدعم المنشئ
+- [**Messaging**](/docs/messaging) — Slack ووجهات الإرسال الأخرى