@agent-native/core 0.92.12 → 0.94.0

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

@@ -11,11 +11,9 @@ description: "كيفية عمل تطبيقات الوكيل الأصلية: acti
 
 يتكون كل تطبيق وكيل أصلي من ثلاثة أشياء تعمل معًا:
 
-> **Agent** — الذكاء الاصطناعي المستقل الذي يقرأ البيانات، ويكتب البيانات، ويشغل actions، ويعدل التعليمات البرمجية. قابلة للتخصيص باستخدام skills والتعليمات.
->
-> **التطبيق** — سطح المنتج حول العامل. قد يكون هذا الإجراء فقط في البداية، أو دردشة غنية، أو مستوى تحكم صغير، أو واجهة React كامل مع لوحات المعلومات، وعمليات التدفق، والمرئيات.
->
-> **الكمبيوتر** — قاعدة البيانات، المتصفح، تنفيذ التعليمات البرمجية. يعمل الوكلاء مباشرةً باستخدام SQL والأدوات المضمنة؛ خوادم MCP هي إضافات اختيارية وليست أساسية.
+- **Agent** — الذكاء الاصطناعي المستقل الذي يقرأ البيانات، ويكتب البيانات، ويشغل actions، ويعدل التعليمات البرمجية. قابلة للتخصيص باستخدام skills والتعليمات.
+- **التطبيق** — سطح المنتج حول العامل. قد يكون هذا الإجراء فقط في البداية، أو دردشة غنية، أو مستوى تحكم صغير، أو واجهة React كامل مع لوحات المعلومات، وعمليات التدفق، والمرئيات.
+- **الكمبيوتر** — قاعدة البيانات، المتصفح، تنفيذ التعليمات البرمجية. يعمل الوكلاء مباشرةً باستخدام SQL والأدوات المضمنة؛ خوادم MCP هي إضافات اختيارية وليست أساسية.
 
 <Diagram id="doc-block-u19iga" title={"الوكيل والتطبيق والكمبيوتر"} summary={"ثلاث طبقات تعمل معًا في متجر SQL واحد مشترك. يقوم كل من الوكيل والتطبيق بقراءة وكتابة نفس البيانات."}>
 
@@ -279,8 +277,7 @@ sendToAgentChat({
 
 عندما يحتاج الوكيل إلى القيام بشيء معقد - استدعاء API ومعالجة البيانات والاستعلام عن قاعدة البيانات - فإنه يقوم بتشغيل **إجراء**. Actions هي ملفات TypeScript في `actions/` والتي تقوم بتصدير `defineAction()` الافتراضي:
 
-```ts
-// actions/fetch-data.ts
+```ts filename="actions/fetch-data.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -384,9 +381,8 @@ A _frame_ هي البيئة التي تستضيف الوكيل بجوار تطب
 
 تتضمن تطبيقات الوكيل الأصلية لوحة وكيل مضمنة توفر وكيل الذكاء الاصطناعي إلى جانب التطبيق UI. وهذا ما يجعل البنية تعمل: يحتاج الوكيل إلى جهاز كمبيوتر (قاعدة بيانات، ومتصفح، وتنفيذ التعليمات البرمجية)، ويحتاج التطبيق إلى الوكيل لعمل الذكاء الاصطناعي.
 
-> **Embedded Agent Panel** — الدردشة ومحطة CLI الاختيارية المدمجة في كل تطبيق. يدعم كود Claude، وCodex، وGemini، وOpenCode، وBuilder.io. يعمل محليا. مجاني ومفتوح المصدر.
->
-> **السحابة** — النشر على أي سحابة من خلال التعاون في الوقت الفعلي والتحرير المرئي والأدوار والأذونات. الأفضل للفرق.
+- **Embedded Agent Panel** — الدردشة ومحطة CLI الاختيارية المدمجة في كل تطبيق. يدعم كود Claude، وCodex، وGemini، وOpenCode، وBuilder.io. يعمل محليا. مجاني ومفتوح المصدر.
+- **السحابة** — النشر على أي سحابة من خلال التعاون في الوقت الفعلي والتحرير المرئي والأدوار والأذونات. الأفضل للفرق.
 
 ## الوعي بالسياق {#context-awareness}
 
@@ -458,14 +454,11 @@ A _frame_ هي البيئة التي تستضيف الوكيل بجوار تطب
 
 هذا هو "وكل شيء آخر" الذي كنت ستلصقه معًا بنفسك.
 
-## الغوص العميق {#deep-dives}
-
-للحصول على إرشادات تفصيلية حول أنماط محددة:
+## الخطوات التالية {#deep-dives}
 
-- [What Is Agent-Native?](/docs/what-is-agent-native) — الرؤية والفلسفة
-- [Context Awareness](/docs/context-awareness) — حالة التنقل، شاشة العرض، أوامر التنقل
-- [Skills Guide](/docs/skills-guide) — إطار العمل skills، المجال skills، إنشاء skills مخصص
-- [Native واجهة الدردشة](/docs/native-chat-ui) — الجداول والرسوم البيانية التي تم الإعلان عنها، وموقف وقت التشغيل BYO
-- [Agent Surfaces](/docs/agent-surfaces) - دردشة غنية بدون رأس، وعربة جانبية مضمنة، ومسارات التطبيق الكامل
-- [A2A Protocol](/docs/a2a-protocol) — الاتصال من وكيل إلى وكيل
-- [Multi-App Workspace](/docs/multi-app-workspace) — استضافة العديد من التطبيقات في جهاز monorepo واحد مع مصادقة مشتركة وskills والمكونات وبيانات الاعتماد
+- [**What Is Agent-Native?**](/docs/what-is-agent-native) — الرؤية والفلسفة وراء هذه القواعد
+- [**Context Awareness**](/docs/context-awareness) — حالة التنقل وأمرا view-screen وnavigate بالتفصيل
+- [**Skills Guide**](/docs/skills-guide) — skills الإطار والمجال وإنشاء skills مخصصة
+- [**Native Chat UI**](/docs/native-chat-ui) — جداول ومخططات معلنة بواسطة actions ودعم أوقات التشغيل التي توفرها بنفسك
+- [**Agent Surfaces**](/docs/agent-surfaces) — الدردشة والواجهة الأصلية المضمنة وصفحات التطبيق الكاملة والواجهة الجانبية المضمنة والأتمتة ومسارات الوكلاء الخارجيين
+- [**A2A Protocol**](/docs/a2a-protocol) — الاتصال من وكيل إلى وكيل

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

@@ -1,11 +1,15 @@
 ---
 title: "المراسلة"
-description: "تحدث إلى وكيلك من Slack أو البريد الإلكتروني أو Telegram أو WhatsApp - نفس الوكيل، نفس الذاكرة، نفس الأدوات."
+description: "تحدث إلى وكيلك عبر Slack أو Microsoft Teams أو تفاعلات Discord أو البريد الإلكتروني أو Telegram أو WhatsApp."
 ---
 
 # المراسلة
 
-قم بتوصيل وكيلك بـ Slack أو البريد الإلكتروني أو Telegram أو WhatsApp حتى تتمكن من الدردشة معه من التطبيقات التي تستخدمها بالفعل. إنه نفس الوكيل - نفس الذاكرة، نفس الأدوات، نفس المواضيع - يمكن الوصول إليه من أماكن أكثر.
+قم بتوصيل وكيلك بـ Slack أو Microsoft Teams أو تفاعلات Discord أو البريد الإلكتروني أو Telegram أو WhatsApp. إنه الوكيل نفسه بنفس الذاكرة والأدوات وسجل المحادثات.
+
+> **نطاق الدعم بدقة:** يتحقق Teams من رموز JWT الرسمية لـ Bot Framework ويرد في المحادثة الأصلية. يدعم Discord أوامر الشرطة المائلة عبر تفاعلات HTTP الموقعة بـ Ed25519 مع إقرار مؤجل؛ ولا يستقبل رسائل الخادم العادية أو الرسائل المباشرة من دون تشغيل Gateway. يحتفظ Telegram بـ `message_thread_id` ويستخدم WhatsApp قيمة `wamid` الواردة للردود السياقية.
+>
+> يتطلب Teams القيم `MICROSOFT_TEAMS_APP_ID` و`MICROSOFT_TEAMS_APP_PASSWORD` و`MICROSOFT_TEAMS_ALLOWED_TENANT_IDS`. ويتطلب Discord القيم `DISCORD_APPLICATION_ID` و`DISCORD_PUBLIC_KEY`. كما يتطلب Telegram القيمة `TELEGRAM_WEBHOOK_SECRET` ويتطلب WhatsApp القيمة `WHATSAPP_APP_SECRET` بالإضافة إلى بيانات الاعتماد الحالية.
 
 > **هل تستخدم قالب الإرسال؟** تم إعداد كل هذا لك في **الإعدادات → المراسلة**. انقر لربط كل نظام أساسي — لن تحتاج إلى قراءة بقية هذه الصفحة إلا إذا كنت تقوم بتخصيص القالب الخاص بك أو إنشائه. راجع [Dispatch](/docs/dispatch) أو [Dispatch template reference](/docs/template-dispatch).
 
@@ -78,7 +82,6 @@ description: "تحدث إلى وكيلك من Slack أو البريد الإلك
    - `chat:write` — يتيح للوكيل إرسال الرسائل
    - `app_mentions:read` — يتيح للوكيل معرفة متى يتم ذكره @ (اختياري)
    - `im:history` — يتيح للوكيل قراءة الرسائل المباشرة المرسلة إليه
-   - `assistant:write` — اختياري؛ يتيح لـ Slack عرض حالة "يفكر..." الأصلية في سلاسل الرسائل المساعدة
    - `users:read.email` — اختياري؛ تساعد القوالب مثل البريد في التحقق من البريد الإلكتروني للمرسل Slack للحصول على هوية قائمة انتظار المسودة
 3. انقر فوق **التثبيت على مساحة العمل** أعلى تلك الصفحة. سوف يمنحك Slack **رمز Bot User OAuth** الذي يبدأ بـ `xoxb-`. انسخه.
 4. انتقل إلى **المعلومات الأساسية** في الشريط الجانبي وانسخ **سر التوقيع**.
@@ -123,12 +126,76 @@ https://your-clips.example.com/api/slack/unfurl
 
 ### نصائح
 
-- **إشارات القناة** — لا يستجيب الروبوت إلا في القنوات عندما تتم الإشارة إليها بال@، وذلك لتجنب الضوضاء.
-- **الرسائل المباشرة** — يتم التعامل مع كل رسالة مباشرة على أنها محادثة خاصة مع الوكيل.
-- **نفس الهوية، جميع القنوات** — إذا كان مستخدم Slack لديه نفس البريد الإلكتروني كمستخدم مسجل في تطبيقك، فسيعامله الوكيل على أنه نفس الشخص.
+- **إشارات القناة** — استخدم @mention لبدء العمل. تُقبل الردود بلا إشارة فقط ما دام العمل نشطًا في سلسلة الرسائل نفسها.
+- **الرسائل المباشرة** — الرسائل الخاصة المقبولة هي محادثات سرية، وتتطلب عضوًا موثّقًا في المؤسسة أو هوية Slack مرتبطة.
+- **الهوية** — يمكن للرسائل الخاصة ربط بريد Slack الموثق بالمستخدم نفسه في التطبيق؛ تستخدم القنوات المُدارة هوية الخدمة والسياسة الخاصة بها.
 - **قوائم الإنتاج المسموح بها** — قم بتعيين `SLACK_ALLOWED_TEAM_IDS`، وبالنسبة لتطبيقات Slack المشتركة، `SLACK_ALLOWED_API_APP_IDS` بحيث لا يمكن إعادة استخدام سر التوقيع الصالح بواسطة مساحة عمل غير متوقعة.
 - **نشر تطبيق Clips** — تستخدم مقاطع Agent-Native القابلة للتثبيت لـ Slack `SLACK_CLIENT_ID`، و`SLACK_CLIENT_SECRET`، و`SLACK_SIGNING_SECRET`، و`/api/slack/oauth/callback`. تحصل كل مساحة عمل Slack متصلة على رمز الروبوت المشفر الخاص بها في `app_secrets`؛ `SLACK_BOT_TOKEN` ما هو إلا نسخة احتياطية قديمة لمساحة عمل واحدة.
 
+### الإعداد المُدار عبر Add to Slack
+
+OAuth المُدار هو الإعداد الموصى به. من **الإعدادات → المراسلة**، اختر
+**Agent manifest** لتنزيل ملف `agent-native-slack-manifest.json` الخاص بمضيفك،
+ثم استورده من **App Manifest** في Slack. يفعّل الملف تجربة `agent_view` الحالية
+وعلامة تبويب **Messages** قابلة للكتابة للرسائل المباشرة. تحقّق من هذه النطاقات:
+
+لا يتضمن البيان أيقونة التطبيق. ضمن **Basic Information → Display Information**،
+ارفع أيقونة Agent Native كي تتطابق قائمة Agents مع هوية المنتج. يمكنك استخدام
+`icon-512.svg` العام للتطبيق كمصدر وتحويله إلى تنسيق رفع يدعمه Slack عند الحاجة.
+
+```text
+assistant:write
+app_mentions:read
+   channels:history
+   channels:read
+   chat:write
+files:read
+   groups:history
+   groups:read
+   im:history
+im:read
+   mpim:history
+   mpim:read
+   pins:read
+   reactions:read
+users:read
+users:read.email
+```
+
+اضبط OAuth Redirect URL على
+`https://your-app.example.com/_agent-native/integrations/slack/oauth/callback`،
+وEvent Subscriptions Request URL على
+`https://your-app.example.com/_agent-native/integrations/slack/webhook`،
+وInteractivity Request URL على
+`https://your-app.example.com/_agent-native/integrations/slack/interactions`.
+اشترك في `app_home_opened` و`app_context_changed` و`app_mention`
+و`message.channels` و`message.groups` و`message.im` و`message.mpim`.
+بعد إعداد `SLACK_CLIENT_ID` و`SLACK_CLIENT_SECRET`
+و`SLACK_SIGNING_SECRET`، افتح **الإعدادات → المراسلة** وانقر **Add to Slack**.
+يُخزّن كل تثبيت رمزًا مشفرًا منفصلًا، وتفصل مفاتيح المحادثة بين مساحة العمل
+والتطبيق والقناة وسلسلة الرسائل.
+
+أعد تثبيت تطبيق Slack بعد تغيير البيان أو النطاقات أو الأحداث أو Agent view أو
+علامة تبويب Messages. يستخدم `app_home_opened` لاكتشاف فتح الرسائل المباشرة،
+ويضيف `app_context_changed` سياق العرض الحالي، ويسلّم `message.im` الرسائل الخاصة.
+قد يخفي مسؤولو Slack الوكلاء المثبتين عن المؤسسة، كما يمكن لكل مستخدم إخفاؤهم من
+الشريط العلوي. إذا نجح التثبيت ولم يظهر الوكيل، فتحقق من عناصر التحكم هذه أو افتحه
+من **Tools → Apps**.
+
+لا تُقبل الرسائل الخاصة الشخصية في Slack إلا من عضو موثّق في مؤسسة Agent Native
+أو من هوية Slack مرتبطة مسبقًا بذلك العضو. أما سياسات وميزانيات هوية الخدمة الخاصة
+بالقناة فهي منفصلة.
+
+أثناء تشغيل مهمة في سلسلة رسائل، تواصل الردود غير المشار إليها المهمة نفسها؛
+ولا تبدأ محادثات القناة العامة مهمة. يحمّل الوكيل سياقًا محدودًا مع التفاعلات
+ومراجع الملفات فقط، ويعرض خطة وتقدمًا مباشرًا مع أزرار الإلغاء والموافقة/الرفض.
+الرسائل الخاصة تستخدم هوية المستخدم الشخصية، بينما تستخدم القنوات المُدارة هوية
+خدمة صريحة وسياسات للضيوف وSlack Connect والنموذج الافتراضي. ذاكرة القناة صريحة
+ومعزولة ولا تُحفظ تلقائيًا. تحتفظ الإجراءات الدورية التي تُنشأ من القناة بوجهة
+Slack، وتفرض ميزانيات يومية أو شهرية للمؤسسة أو الطالب أو القناة مع سجل تدقيق كامل.
+يتيح `assistant:write` أحداث سياق Agent View، بينما يتيح `chat:write` الردود
+وتحديثات الحالة المباشرة.
+
 ## إعداد تيليجرام {#telegram}
 
 ### ما ستحتاج إليه
@@ -435,7 +502,9 @@ POST /_agent-native/integrations/telegram/setup
 | البريد الإلكتروني | `EMAIL_AGENT_ADDRESS`، بالإضافة إلى واحد من `RESEND_API_KEY` أو `SENDGRID_API_KEY` | `EMAIL_INBOUND_WEBHOOK_SECRET`                        |
 | واتساب            | `WHATSAPP_ACCESS_TOKEN`, `WHATSAPP_VERIFY_TOKEN`, `WHATSAPP_PHONE_NUMBER_ID`       | —                                                     |
 
-جميع بيانات الاعتماد موجودة في env vars - وليس قاعدة البيانات أبدًا، ولا كود المصدر أبدًا. استخدم إعدادات الشريط الجانبي UI أو لوحة البيئة الخاصة بموفر الاستضافة.
+يتم حل بيانات اعتماد التكامل أولاً من الأسرار ذات النطاق لمالك التكامل (المستخدم ثم المؤسسة ثم مساحة العمل)؛ وتكون متغيرات بيئة النشر بديلاً للتثبيت المحلي أو أحادي المستأجر المقصود. تحفظ واجهة الإعداد أسراراً ذات نطاق؛ ولا تُعاد القيم أبداً إلى المتصفح أو تُخزَّن في كود المصدر.
+
+محولات وقت التشغيل المضمنة هي **Slack** و**Telegram** و**WhatsApp Cloud API** والبريد الإلكتروني عبر webhooks لموفر الخدمة (Resend أو SendGrid). لا يمكن توصيل Discord أو Microsoft Teams حتى يتم تنفيذ محول تم التحقق منه وتسجيله.
 
 ### الترابط والهوية {#threading-and-identity}
 
@@ -481,13 +550,13 @@ import type {
 import type { EnvKeyConfig } from "@agent-native/core/server";
 
 const myAdapter: PlatformAdapter = {
-  platform: "discord",
-  label: "Discord",
+  platform: "my-chat",
+  label: "My Chat",
 
   // Env keys this adapter needs (rendered in the settings UI)
   getRequiredEnvKeys(): EnvKeyConfig[] {
     return [
-      { key: "DISCORD_BOT_TOKEN", label: "Discord Bot Token", required: true },
+      { key: "MY_CHAT_BOT_TOKEN", label: "My Chat Bot Token", required: true },
     ];
   },
 
@@ -507,10 +576,10 @@ const myAdapter: PlatformAdapter = {
   // Return null to silently ignore the event (bot messages, edits, etc.).
   async parseIncomingMessage(event: H3Event): Promise<IncomingMessage | null> {
     return {
-      platform: "discord",
+      platform: "my-chat",
       externalThreadId: "channel-or-thread-id",
       text: "the user's message",
-      senderId: "discord-user-id",
+      senderId: "my-chat-user-id",
       platformContext: { channelId: "channel-id" },
       timestamp: Date.now(),
     };
@@ -538,10 +607,10 @@ const myAdapter: PlatformAdapter = {
   // baseUrl is the app's public URL, used for status checks that need it.
   async getStatus(baseUrl?: string) {
     return {
-      platform: "discord",
-      label: "Discord",
+      platform: "my-chat",
+      label: "My Chat",
       enabled: true,
-      configured: !!process.env.DISCORD_BOT_TOKEN,
+      configured: !!process.env.MY_CHAT_BOT_TOKEN,
     };
   },
 };

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

@@ -17,7 +17,7 @@ description: "يعد كل تطبيق أصلي للوكيل متعدد المست
 - **تبديل المؤسسة** — تتعقب الجلسة المؤسسة النشطة (`session.orgId`)، ويؤدي تبديلها إلى تغيير البيانات التي يراها المستخدم والوكيل.
 - **عزل البيانات لكل مؤسسة** — يتم تحديد نطاق كل استعلام تلقائيًا ليشمل المؤسسة النشطة.
 
-إذا كنت تقوم بتقييم الوكيل الأصلي لـ CRM، أو متتبع المشروع، أو صندوق بريد الدعم، أو أي أداة فريق، فإن الأساس متعدد المستأجرين موجود بالفعل. جميع قوالب الطرف الأول متعددة المستأجرين — راجع [Cloneable SaaS templates](/docs/cloneable-saas) للحصول على القائمة.
+إذا كنت تقوم بتقييم الوكيل الأصلي لـ CRM، أو متتبع المشروع، أو صندوق بريد الدعم، أو أي أداة فريق، فإن الأساس متعدد المستأجرين موجود بالفعل. جميع قوالب الطرف الأول متعددة المستأجرين — راجع [القوالب](/docs/cloneable-saas) للحصول على القائمة.
 
 <Diagram id="doc-block-1junwhj" title={"عضوية المنظمة وعزلها"} summary={"ينضم المستخدمون إلى المؤسسات باسم owner/admin/member. يحمل كل صف قابل للتملك org_id للمستأجر الذي يمتلكه، ولا يتسرب أي صف عبر الحدود."}>
 
@@ -117,8 +117,8 @@ description: "يعد كل تطبيق أصلي للوكيل متعدد المست
 
 هذا هو نفس المسار المستخدم لتحديد النطاق لكل مستخدم. بالنسبة للميكانيكا على مستوى SQL، وعقد `ownableColumns()`، وحراس `accessFilter` / `resolveAccess` / `assertAccess`, راجع [Security → Data Scoping](/docs/security#data-scoping) - المصدر الوحيد للحقيقة لمسار تحديد النطاق.
 
-## المستندات ذات الصلة {#related}
+## الخطوات التالية {#related}
 
-- [Authentication](/docs/authentication#organizations) — الجلسات ومقدمو الخدمات الاجتماعية وسطح إدارة المؤسسة
-- [Security → Data Scoping](/docs/security#data-scoping) — العزل على مستوى SQL، وعقد `ownableColumns()`، ووحدات حماية الوصول
-- [Multi-App Workspace](/docs/multi-app-workspace) — استضافة العديد من تطبيقات الوكيل الأصلية في monorepo واحد مع مصادقة مشتركة وRBAC
+- [**Authentication**](/docs/authentication#organizations) — الجلسات ومقدمو الخدمات الاجتماعية وسطح إدارة المؤسسة
+- [**Security — Data Scoping**](/docs/security#data-scoping) — العزل على مستوى SQL وعقد `ownableColumns()` ووحدات حماية الوصول
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — استضافة العديد من تطبيقات Agent-Native في monorepo واحد مع مصادقة مشتركة وRBAC

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

@@ -113,6 +113,7 @@ await notify(
 | `inbox`   | الاستمرار في الجدول `notifications`؛ يحرك الجرس UI | تشغيل دائمًا — جزء من البدائي.                                |
 | `webhook` | POST JSON إلى URL التي تم تكوينها                  | تم تعيين `NOTIFICATIONS_WEBHOOK_URL` env var عند بدء التشغيل. |
 
+تُسجَّل قنوات البريد الإلكتروني وSlack والـ webhook دائمًا إلى جانب صندوق الوارد. يفضّل التسليم عنوان URL أو المستلمين المحددين في بيانات الإشعار، ثم يعود إلى متغير البيئة المطابق. وإذا لم يُضبط أي منهما، فلا تنفّذ تلك القناة شيئًا عند الإرسال.
 تعمل قناة webhook على حل مراجع `${keys.NAME}` في كل من URL و`NOTIFICATIONS_WEBHOOK_AUTH` مقابل [secrets](/docs/security) المخصص للمالك، لذلك لا تدخل القيمة الأولية مطلقًا في سياق الوكيل. يتم فرض قوائم URL المسموح بها لكل مفتاح - نفس القاعدة التي تستخدمها أداة `web-request` للتشغيل الآلي.
 
 <Diagram id="doc-block-knshu4" title={"القنوات وخطورتها"} summary={"البريد الوارد قيد التشغيل دائمًا؛ يحتاج خطاف الويب إلى env var؛ يتم تسجيل القنوات المخصصة عند بدء التشغيل. تؤدي درجة الخطورة إلى تصميم الشارة ويتم تمريرها إلى كل قناة."}>
@@ -203,7 +204,7 @@ await notify(
 
 قم بتسجيل قناة مخصصة من أي مكون إضافي للخادم.
 
-```ts
+```ts filename="server/plugins/notifications-slack-ops.ts"
 import { registerNotificationChannel } from "@agent-native/core/notifications";
 
 registerNotificationChannel({
@@ -274,15 +275,15 @@ interface NotificationMeta {
 
 تم تركيبه على `/_agent-native/notifications/*` بواسطة البرنامج الإضافي للمسارات الأساسية. يتم تحديد نطاق كافة المسارات إلى البريد الإلكتروني للجلسة التي تمت مصادقتها.
 
-| الطريقة  | المسار                                              |
-| -------- | --------------------------------------------------- |
-| `GET`    | `/_agent-native/notifications?unread=true&limit=50` |
-| `GET`    | `/_agent-native/notifications/count`                |
-| `POST`   | `/_agent-native/notifications/:id/read`             |
-| `POST`   | `/_agent-native/notifications/read-all`             |
-| `DELETE` | `/_agent-native/notifications/:id`                  |
+| الطريقة  | المسار                                                         |
+| -------- | -------------------------------------------------------------- |
+| `GET`    | `/_agent-native/notifications?unread=true&limit=50&before=ISO` |
+| `GET`    | `/_agent-native/notifications/count`                           |
+| `POST`   | `/_agent-native/notifications/:id/read`                        |
+| `POST`   | `/_agent-native/notifications/read-all`                        |
+| `DELETE` | `/_agent-native/notifications/:id`                             |
 
-<Endpoint id="doc-block-1beurdp" title={"قائمة الإشعارات"} summary={"The route behind listNotifications() — scoped to the authenticated session's email."} method="GET" path={"/_agent-native/notifications?unread=true&limit=50"} summary={"قم بإدراج الإشعارات الأخيرة للمستخدم الحالي"} auth={"Authenticated session; results are scoped to the session's email."} params={[
+<Endpoint id="doc-block-1beurdp" title={"قائمة الإشعارات"} method="GET" path={"/_agent-native/notifications?unread=true&limit=50&before=ISO"} summary={"قم بإدراج الإشعارات الأخيرة للمستخدم الحالي"} auth={"Authenticated session; results are scoped to the session's email."} params={[
   {
     "name": "unread",
     "in": "query",
@@ -296,6 +297,13 @@ interface NotificationMeta {
     "type": "number",
     "required": false,
     "description": "Max rows to return."
+  },
+  {
+    "name": "before",
+    "in": "query",
+    "type": "string",
+    "required": false,
+    "description": "مؤشر زمني بتنسيق ISO — يعيد الإشعارات التي أُنشئت قبل هذا الوقت، لاستخدامه في ترقيم الصفحات."
   }
 ]} responses={[
   {
@@ -308,7 +316,7 @@ interface NotificationMeta {
 
 ## مكون UI {#ui}
 
-```tsx
+```tsx filename="app/components/HeaderBar.tsx"
 import { NotificationsBell } from "@agent-native/core/client/notifications";
 
 export function HeaderBar() {

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

@@ -51,8 +51,11 @@ description: "حلقة المراقبة الداخلية/خطافات الدرا
 
 </Diagram>
 
-> [!WARNING]
-> المعالج هو **تكوين**، وليس أداة، وليس إجراءً، وليس تأليفًا DSL. تقوم المعالجات فقط بمراقبة وتعديل حالة نطاق الدفق الخاصة بها و`abort()`. ولا تحدد أبدًا سلوك التطبيق، أو تستبدل actions, أو تظهر للنموذج. تنتمي عمليات التطبيق إلى [actions](/docs/actions).
+<Callout id="doc-block-proc1cfg" tone="warning">
+
+المعالج هو **تكوين**، وليس أداة، وليس إجراءً، وليس تأليفًا DSL. تقوم المعالجات فقط بمراقبة وتعديل حالة نطاق الدفق الخاصة بها و`abort()`. ولا تحدد أبدًا سلوك التطبيق، أو تستبدل actions, أو تظهر للنموذج. تنتمي عمليات التطبيق إلى [actions](/docs/actions).
+
+</Callout>
 
 ## الخطافات {#hooks}
 
@@ -133,10 +136,13 @@ await runAgentLoop({
 
 **الحمل الصفري عند عدم الاستخدام.** تقوم الحلقة ببناء سلسلة المعالج فقط عند توفير معالج واحد على الأقل؛ عند حذف `processors` أو تركه فارغًا، لن يتم تشغيل أي من أكواد التماس وتكون الحلقة بدون تغيير بايت مقابل بايت. تعمل الخطافات بترتيب التسجيل وقد تكون متزامنة أو غير متزامنة.
 
-> [!NOTE]
-> يعتبر التماس على مستوى الحلقة هو ما يمكن تسليمه اليوم ويمكن استدعاؤه مباشرة بواسطة الوكلاء الفرعيين، A2A، MCP، والاختبارات. يعد ربط `processors` من خلال معالج الدردشة HTTP (بحيث يمكن لمحلل كل طلب تهيئتها دون الاتصال بـ `runAgentLoop` مباشرة) بمثابة توصيلات ملائمة لم يتم توصيلها بعد - قم بتكوين المعالجات في موقع الاتصال `runAgentLoop` في الوقت الحالي.
+<Callout id="doc-block-proc1note" tone="info">
+
+يعتبر التماس على مستوى الحلقة هو ما يمكن تسليمه اليوم ويمكن استدعاؤه مباشرة بواسطة الوكلاء الفرعيين، A2A، MCP، والاختبارات. يعد ربط `processors` من خلال معالج الدردشة HTTP (بحيث يمكن لمحلل كل طلب تهيئتها دون الاتصال بـ `runAgentLoop` مباشرة) بمثابة توصيلات ملائمة لم يتم توصيلها بعد - قم بتكوين المعالجات في موقع الاتصال `runAgentLoop` في الوقت الحالي.
+
+</Callout>
 
-## ذات صلة
+## ما التالي
 
 - [**Durable Resume**](/docs/durable-resume) — كيف تتغلب الحلقة على الانقطاعات دون إعادة تشغيل التأثيرات الجانبية المكتملة.
 - [**Custom Agents & Teams**](/docs/agent-teams) — يقوم الوكلاء الفرعيون بتشغيل نفس الحلقة ويمكنهم حمل المعالجات الخاصة بهم.

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

@@ -96,8 +96,7 @@ server/routes/
 
 يقوم كل مسار بتصدير `defineEventHandler`:
 
-```ts
-// server/routes/api/health.get.ts
+```ts filename="server/routes/api/health.get.ts"
 import { defineEventHandler } from "h3";
 
 export default defineEventHandler(() => ({
@@ -137,8 +136,7 @@ export default defineEventHandler(() => ({
 
 لإنشاء endpoint حالة للقراءة فقط، اجعله action:
 
-```ts
-// actions/get-status.ts
+```ts filename="actions/get-status.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -171,8 +169,7 @@ GET /_agent-native/actions/get-status?service=billing
 الأدوات أو سجل الدردشة أو حالة التشغيل، استخدم `completeText()` كهروب صريح
 يفقس.
 
-```ts
-// actions/classify-message.ts
+```ts filename="actions/classify-message.ts"
 import { defineAction } from "@agent-native/core/action";
 import { completeText } from "@agent-native/core/server";
 import { z } from "zod";
@@ -237,8 +234,7 @@ export default defineAction({
 
 المكونات الإضافية موجودة في `server/plugins/` ويتم تشغيلها عند بدء التشغيل. استخدمها لعمليات الترحيل وإعداد الموفر والمهام المتكررة ومحولات التكامل وتكوين المكونات الإضافية لإطار العمل.
 
-```ts
-// server/plugins/db.ts
+```ts filename="server/plugins/db.ts"
 import { runMigrations } from "@agent-native/core/db";
 
 export default runMigrations(
@@ -416,8 +412,11 @@ export default runMigrations(
 
 </Diagram>
 
-> [!WARNING]
-> لا تعتمد على الوعود غير المنتظرة بعد إرجاع الرد - حيث يقوم المضيفون بدون خادم بتجميد التنفيذ. راجع [Messaging](/docs/messaging) للتعرف على قائمة انتظار التكامل الأساسية.
+<Callout tone="warning">
+  لا تعتمد على الوعود غير المنتظرة بعد إرجاع الرد - حيث يقوم المضيفون بدون خادم
+  بتجميد التنفيذ. راجع [Messaging](/docs/messaging) للتعرف على قائمة انتظار
+  التكامل الأساسية.
+</Callout>
 
 ## متقدم: فتحات الهروب {#advanced-escape-hatches}
 
@@ -459,3 +458,11 @@ const handler = createProductionAgentHandler({
   systemPrompt: "You are the app agent...",
 });
 ```
+
+## الخطوة التالية
+
+- [**الإجراءات**](/docs/actions) — سطح العمليات الافتراضي؛ استخدم مسارًا مخصصًا فقط عندما لا يناسبه
+- [**قاعدة البيانات**](/docs/database) — نمط `getDb()`/`schema` الذي تستورده المسارات المخصصة والإجراءات
+- [**الأمان**](/docs/security#access-guards) — `accessFilter`/`assertAccess` ونموذج تحديد نطاق البيانات الكامل
+- [**المراسلة**](/docs/messaging) — نمط قائمة انتظار التكامل القياسي للـ webhooks الواردة
+- [**بروتوكول MCP**](/docs/mcp-protocol) — نقطة النهاية `/_agent-native/mcp` التي يثبّتها هذا الخادم تلقائيًا

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

@@ -1,13 +1,13 @@
 ---
 title: "المشاركة والخصوصية"
-description: "المشاركة بأسلوب Google-Docs، المضمنة في إطار العمل. يحصل كل مورد أنشأه المستخدم - المستندات، ولوحات المعلومات، والتصميمات، والمجموعات، والمقاطع، والتسجيلات، والنماذج - على نفس النموذج الخاص الافتراضي بمشاركة واحدة متسقة UI."
+description: "مشاركة مألوفة ومتسقة مدمجة في إطار العمل. يحصل كل مورد ينشئه المستخدم — المستندات ولوحات المعلومات والتصميمات والعروض والمقاطع والتسجيلات والنماذج — على النموذج نفسه الذي يكون خاصًا افتراضيًا مع واجهة مشاركة واحدة متسقة."
 ---
 
 # المشاركة والخصوصية
 
 كل مورد ينشئه المستخدم في تطبيق وكيل أصلي - مستند، أو لوحة معلومات، أو تصميم، أو مجموعة، أو تسجيل شاشة، أو نص اجتماع، أو نموذج، أو رابط حجز - يكون **خاصًا بالمنشئ بشكل افتراضي**. ولا يراها الأشخاص الآخرون إلا عندما يشاركها منشئ المحتوى بشكل صريح، أو يغير مستوى رؤيتها إلى `org` أو `public`.
 
-يبدو ويعمل مثل مستندات Google. نفس زر المشاركة، ونفس مربع الحوار، ونفس نموذج الرؤية ثلاثي المستويات، ونفس المنح لكل مستخدم/لكل مؤسسة - عبر كل قالب، بدون إعادة اختراع لكل تطبيق.
+إنه نموذج مشاركة واحد مألوف في كل مكان: زر المشاركة نفسه، ومربع الحوار نفسه، ونموذج الرؤية نفسه المكوّن من ثلاث طبقات، والمنح نفسها لكل مستخدم ولكل مؤسسة — عبر كل قالب، دون إعادة ابتكار لكل تطبيق.
 
 ## لماذا نموذج واحد {#why}
 
@@ -92,7 +92,7 @@ description: "المشاركة بأسلوب Google-Docs، المضمنة في إ
 - **المحتوى** — المستندات
 - **الشرائح** — التشكيلات
 - **التصميم** — التصاميم والأصول
-- **المقاطع** — تسجيلات الشاشة (نمط المنوال)
+- **المقاطع** — تسجيلات الشاشة
 - **Plan** — visual plans and PR recaps
 - **النماذج** — تعريفات النماذج
 - **التقويم** — الأحداث وروابط الحجز
@@ -115,7 +115,7 @@ description: "المشاركة بأسلوب Google-Docs، المضمنة في إ
 
 - محدد الرؤية (`Private` / `Organization` / `Public link`).
 - الإكمال التلقائي "إضافة أشخاص أو فرق" — ابحث عن المستخدمين في المؤسسة أو الصق بريدًا إلكترونيًا.
-- مربع اختيار `إشعار people` بنمط محرّر مستندات Google لمنح البريد الإلكتروني الفردية.
+- مربع اختيار `إشعار الأشخاص` لمنح البريد الإلكتروني الفردية.
 - قائمة المنح الحالية مع منتقي الأدوار وعنصر تحكم الإزالة.
 - زر نسخ الارتباط الذي يحترم الرؤية الحالية.
 
@@ -270,7 +270,7 @@ export const deckShares = createSharesTable("deck_shares");
 
 مكالمة تسجيل واحدة في `server/db/index.ts`:
 
-```ts
+```ts filename="server/db/index.ts"
 import { registerShareableResource } from "@agent-native/core/sharing";
 
 registerShareableResource({
@@ -315,9 +315,9 @@ For resources that execute code or carry elevated trust (like extensions), set `
 
 مشاركة الرحلات على نموذج تحديد نطاق البيانات الأوسع لإطار العمل - الوصول إلى القائمة/القراءة/الكتابة إلى الجداول القابلة للملكية يمر عبر `accessFilter()` / `resolveAccess()` / `assertAccess()`, وتكون الموارد ذات العلامات `org_id` غير مرئية عبر المؤسسات. راجع [Security → Data Scoping](/docs/security#data-scoping) للتعرف على المسار الكامل وحارس CI وسطح التهديد.
 
-## انظر أيضًا {#see-also}
+## الخطوة التالية {#see-also}
 
-- [Security & Data Scoping](/docs/security) — مرشح الوصول ونموذج الملكية الذي تعتمد عليه المشاركة.
-- [Authentication](/docs/authentication) — الجلسات والمؤسسات وكيفية تدفق الهوية إلى سياق الطلب.
-- [Extensions](/docs/extensions#sharing) — المشاركة في سطح التطبيق المصغر في وضع الحماية.
-- [Creating Templates](/docs/creating-templates) — توصيل `ownableColumns` بمخطط القالب الجديد.
+- [**الأمان — تحديد نطاق البيانات**](/docs/security#data-scoping) — نموذج تصفية الوصول والملكية الذي تعتمد عليه المشاركة
+- [**المصادقة**](/docs/authentication) — الجلسات والمؤسسات وكيف تتدفق الهوية إلى سياق الطلب
+- [**الإضافات**](/docs/extensions#sharing) — المشاركة في سطح التطبيقات المصغرة المعزول
+- [**إنشاء القوالب**](/docs/creating-templates) — توصيل `ownableColumns` بمخطط قالب جديد

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

@@ -5,7 +5,7 @@ description: "كيفية عمل skills في الوكيل الأصلي: إطار
 
 # دليل Skills
 
-Skills هي ملفات Markdown التي تمنح الوكيل معرفة عميقة حول أنماط ومسارات عمل محددة.
+المهارات هي ملفات Markdown تمنح الوكيل معرفة عميقة بأنماط وسير عمل محددين. وبدلاً من حشد كل قاعدة في مطالبة نظام واحدة، تقسّم المعرفة إلى ملفات مركّزة لا يحمّلها الوكيل إلا عندما تحتاج المهمة إليها فعلاً — فيظل السياق الافتراضي صغيراً مع تمكين الوكيل من التعمق عند الطلب.
 
 ## ما هي skills {#what-are-skills}
 
@@ -120,9 +120,11 @@ Skills موجود في `.agents/skills/<name>/SKILL.md` ويحتوي على إر
 
 تشمل skills المدعومة بالتطبيق حاليًا `visual-plan` و`visual-recap` و`visualize-repo` من Plan، و`visual-edit` من Design، و`assets` من Assets، و`content` لتحرير docs/blog/MDX المدعوم بالمستودع.
 
-تحزم skills المدعومة بالتطبيق تطبيقًا أصليًا للوكيل باعتباره قطعة أثرية في سوق المهارات. يمكن أن تتضمن الحزمة تعليمات الوكيل، وبيانات تعريف موصل skills المصدرة، وتعليمات التشغيل المستضافة/المحلية، وأسطح UI مثل تطبيقات MCP.
+<Callout tone="info">
 
-> **التفاصيل الكاملة أدناه:** يتم تغطية آليات skills المدعومة بالتطبيق (تنسيق البيان، وأوامر CLI، ومحولات السوق، وتجزئة التحديث التلقائي) في [App-backed skills — full details](#app-backed-skills-full).
+**التفاصيل الكاملة أدناه:** يتم تغطية آليات skills المدعومة بالتطبيق (تنسيق البيان، وأوامر CLI، ومحولات السوق، وتجزئة التحديث التلقائي) في [App-backed skills — full details](#app-backed-skills-full).
+
+</Callout>
 
 ## إنشاء skills مخصص {#creating-skills}
 
@@ -177,7 +179,11 @@ Skills موجود في `.agents/skills/<name>/SKILL.md` ويحتوي على إر
 
 احفظ الملف في `.agents/skills/my-skill/SKILL.md`. يجب أن يتطابق اسم الدليل مع `name` في المادة الأمامية.
 
-> **راجع أيضًا:** [Writing Agent Instructions](/docs/writing-agent-instructions) للتعرف على كيفية صياغة أوصاف المهارات، وتطبيق الكشف التدريجي، والحفاظ على `AGENTS.md`. تستخدم كلتا الصفحتين مهارة `project-imports` كمثال عملي.
+<Callout tone="info">
+
+**راجع أيضًا:** [Writing Agent Instructions](/docs/writing-agent-instructions) للتعرف على كيفية صياغة أوصاف المهارات، وتطبيق الكشف التدريجي، والحفاظ على `AGENTS.md`. تستخدم كلتا الصفحتين مهارة `project-imports` كمثال عملي.
+
+</Callout>
 
 ## نطاق المهارة: وقت التشغيل مقابل التطوير {#skill-scope}
 
@@ -267,33 +273,37 @@ scope: dev
 
 </Diagram>
 
-> **راجع أيضًا:** [Writing Agent Instructions](/docs/writing-agent-instructions) للتعرف على كيفية صياغة أوصاف المهارات، وتطبيق الإفصاح التدريجي، والحفاظ على `AGENTS.md`.
-
 ## Skills مقابل AGENTS.md {#skills-vs-agents-md}
 
-> **AGENTS.md** — النظرة العامة. يسرد كافة البرامج النصية، ويصف نموذج البيانات، ويشرح بنية التطبيق. يقرأ الوكيل هذا أولاً لفهم التطبيق.
->
-> **Skills** — الغوص العميق. تركز كل مهارة على نمط واحد يحتوي على قواعد تفصيلية، وأمثلة للتعليمات البرمجية، وقوائم المهام/المحظورات. يقرأ الوكيل هذه العناصر عندما يحتاج إلى اتباع نمط معين.
+<Callout tone="info">
+
+**AGENTS.md** — النظرة العامة. يسرد كافة البرامج النصية، ويصف نموذج البيانات، ويشرح بنية التطبيق. يقرأ الوكيل هذا أولاً لفهم التطبيق.
+
+**Skills** — الغوص العميق. تركز كل مهارة على نمط واحد يحتوي على قواعد تفصيلية، وأمثلة للتعليمات البرمجية، وقوائم المهام/المحظورات. يقرأ الوكيل هذه العناصر عندما يحتاج إلى اتباع نمط معين.
+
+</Callout>
 
 يخبر `AGENTS.md` الوكيل _ما_ يفعله التطبيق. Skills أخبر الوكيل بكيفية القيام بأشياء محددة بشكل صحيح. كلاهما مطلوب — `AGENTS.md` للتوجيه، وskills للتنفيذ.
 
 ## Skills مقابل الذاكرة {#skills-vs-memory}
 
-> **Skills** — أدلة إرشادية مؤلفة وقابلة لإعادة الاستخدام. تنطبق على كل مستخدم، ويتم استدعاؤها عند الطلب عندما تتطابق المهمة.
->
-> **الذاكرة (`LEARNINGS.md` / `memory/MEMORY.md`)** — يتم تحميل الدروس المستفادة من المشروعات المشتركة والذاكرة المنظمة الشخصية في كل دورة.
+<Callout tone="info">
+
+**Skills** — أدلة إرشادية مؤلفة وقابلة لإعادة الاستخدام. تنطبق على كل مستخدم، ويتم استدعاؤها عند الطلب عندما تتطابق المهمة.
+
+**الذاكرة (`LEARNINGS.md` / `memory/MEMORY.md`)** — يتم تحميل الدروس المستفادة من المشروعات المشتركة والذاكرة المنظمة الشخصية في كل دورة.
+
+</Callout>
 
 إذا كانت المعرفة تنطبق على _جميع_ الأشخاص\_ الذين يعملون في التطبيق ("يفضلون دائمًا CTEs على الاستعلامات الفرعية")، فهي مهارة أو `LEARNINGS.md` مشتركة. إذا كان الأمر يتعلق بهذا المستخدم تحديدًا ("يحب ستيف الإجابات المختصرة")، فهو ينتمي إلى `memory/MEMORY.md`. راجع [Workspace Memory](/docs/workspace#memory) للحصول على العلاج الكامل.
 
----
+## المهارات مقابل موارد SQL {#skills-vs-resources}
 
-# متقدم
+تعرض هذه الصفحة المهارة كملف في `.agents/skills/<name>/SKILL.md`. وتعرض [مساحة العمل](/docs/workspace#skills) المهارة نفسها كمورد SQL في المسار `skills/<slug>/SKILL.md`، بنطاق مساحة العمل أو النطاق المشترك أو الشخصي. وهما المفهوم نفسه من زاويتين: يقرأ وضع Code الملف ويكتبه مباشرةً؛ بينما يخزّنه وضع App كسجل مورد ليعمل من دون نظام ملفات. اكتب المحتوى بتنسيق هذه الصفحة في الحالتين.
 
 ## skills المدعوم بالتطبيق - التفاصيل الكاملة {#app-backed-skills-full}
 
-يحزم skills المدعوم بالتطبيق تطبيقًا أصليًا للوكيل باعتباره أحد عناصر سوق المهارات.
-يمكن أن تتضمن الحزمة تعليمات الوكيل، وموصل skills، وموصل MCP المُصدر
-البيانات الوصفية وتعليمات التشغيل المستضافة/المحلية وأسطح UI مثل تطبيقات MCP.
+التفاصيل الكاملة لتنسيق البيان وأوامر CLI ومحولات السوق وتجزئة التحديث التلقائي وراء [المهارات المدعومة بالتطبيق](#app-backed-skills):
 
 تبدأ كل مهارة مدعومة بالتطبيق بـ `agent-native.app-skill.json` في جذر التطبيق:
 
@@ -410,3 +420,10 @@ npx @agent-native/core@latest skills update scaffold --project
 يظل `AGENTS.md` و`.agents/skills` أساسيين. يقوم أمر التحديث أيضًا بإصلاح
 روابط التوافق Claude (`CLAUDE.md` و`.claude/skills`) حتى يرى رمز Claude
 نفس التعليمات دون الاحتفاظ بنسخة ثانية.
+
+## الخطوة التالية {#whats-next}
+
+- [**كتابة تعليمات الوكيل**](/docs/writing-agent-instructions) — صياغة أوصاف المهارات وتوزيع الإرشادات بين AGENTS.md والمهارات والذاكرة
+- [**مساحة العمل**](/docs/workspace#skills) — موضع المهارات كموارد SQL في وضع App
+- [**إشارات الوكيل**](/docs/agent-mentions) — مشغّل أوامر `/` الذي يستدعي مهارة في الدردشة
+- [**إضافة Plan والسوق**](/docs/plan-plugin) — تثبيت مهارة حقيقية مدعومة بالتطبيق وتحديثها التلقائي من البداية إلى النهاية