@agent-native/core 0.92.12 → 0.94.0

package/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/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/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/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/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) — تثبيت مهارة حقيقية مدعومة بالتطبيق وتحديثها التلقائي من البداية إلى النهاية

package/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/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/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/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/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/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/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/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/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}
 
 يسجل زر صوت الملحن الصوت في المتصفح، ثم يختار الموفر: