@agent-native/core 0.92.12 → 0.94.0

package/docs/content/local-file-mode.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Local File Mode"
-description: "Run agent-native apps with local Markdown, MDX, and other repo files as the source of truth - including Obsidian-style MDX docs with custom components."
+description: "Run agent-native apps with local Markdown, MDX, and other repo files as the source of truth - including a repo-native MDX docs workflow with custom components."
 ---
 
 # Local File Mode
@@ -16,16 +16,16 @@ Content editor, and saving writes back to the selected file. The same files can
 also be edited by Codex, Claude Code, the Agent-Native sidebar agent, or a normal
 editor.
 
-For Content, this makes the product feel like open-source Obsidian for MDX:
-your docs live as files, while the app adds a visual editor, agent actions,
-shareable copies, and rich interactive MDX components.
+For Content, this makes the product a repo-native MDX docs tool: your docs
+live as files, while the app adds a visual editor, agent actions, shareable
+copies, and rich interactive MDX components.
 
 Use Local File Mode when you want a repo-first workflow:
 
 - a docs repo with `docs/*.mdx`
 - a blog with `blog/*.mdx`
 - resources such as positioning, messaging, or team notes in `resources/*.md`
-- a personal Obsidian-style knowledge base with a richer MDX editor
+- a personal knowledge base with a richer MDX editor
 - docs that need interactive custom MDX blocks generated from local React code
 - app artifacts that should be easy for coding agents to inspect and patch
 
@@ -276,8 +276,7 @@ install snippets, or framework-specific code blocks.
 
 For example, add an interactive component next to your content:
 
-```tsx
-// components/ImpactCounter.tsx
+```tsx filename="components/ImpactCounter.tsx"
 import { useState } from "react";
 
 export function ImpactCounter({
@@ -449,7 +448,7 @@ For v1, local extensions are intentionally conservative:
 - raw SQL helpers and external `extensionFetch` are disabled
 - slot targets are declared in `extension.json`, not installed through SQL
 
-This gives local workspaces an Obsidian-like plugin surface without letting an
+This gives local workspaces a lightweight plugin surface without letting an
 arbitrary repo file inherit every capability of a database-backed extension.
 
 ## How Apps Use It
@@ -523,3 +522,10 @@ AGENT_NATIVE_ALLOW_LOCAL_FILES_IN_PRODUCTION=true
 Only set that for a trusted single-tenant deployment where everyone who can use
 the app is allowed to read and write the configured files. For normal hosted,
 multi-user apps, use database mode and SQL-backed sharing.
+
+## What's next
+
+- [**Database**](/docs/database) — the SQL-backed mode this page contrasts with
+- [**Sharing**](/docs/sharing) — the standard document-sharing model that database-mode copies use
+- [**Extensions**](/docs/extensions) — the SQL-backed extension model that local extensions intentionally simplify
+- [**Creating Templates**](/docs/creating-templates) — adopting the same local-artifact pattern in a new app

package/docs/content/locales/ar-SA/actions.mdx

@@ -11,7 +11,7 @@ Actions هي المصدر الوحيد للحقيقة لأي شيء يفعله
 - **خطافات Typesafe React** — `useActionQuery("name")` و`useActionMutation("name")` في الواجهة الأمامية، الأنواع المستنتجة من المخطط.
 - **استدعاءات العميل الحتمية** — `callAction("name", params)` عندما لا يكون الخطاف مناسبًا.
 - **نقل إطار العمل** — يتم تركيبه تلقائيًا بواسطة إطار العمل خلف تلك الخطافات وهو متاح لعملاء HTTP الخارجيين.
-- **أداة MCP** — مكشوفة لتطبيقات Claude وChatGPT المخصصة MCP وClaude Desktop/Code وCursor وCodex وأي عميل MCP آخر.
+- **أداة MCP** — مكشوفة لتطبيقات Claude وChatGPT المخصصة MCP وClaude Desktop/Code وCursor وCodex وأي مضيف MCP آخر.
 - **أداة A2A** — يتم استدعاؤها بواسطة تطبيقات الوكيل الأصلية الأخرى عبر A2A.
 - **أمر CLI** — `pnpm action <name>` للبرمجة النصية وحلقات التطوير.
 
@@ -560,7 +560,7 @@ export default defineAction({
 });
 ```
 
-احتفظ بـ `link` كبديل لعملاء CLI وغير UI MCP؛ وهو أيضًا هدف إطلاق التضمين. جسر التضمين - جلسة بدء التضمين الموقعة، والزرع مقابل عرض الإطار المتحكم فيه، والجسر المضيف `ui/*`، وCSP، وتثبيت الارتفاع - مملوك لشركة [External Agents](/docs/external-agents#mcp-app-bridge).
+احتفظ بـ `link` كبديل لـ CLI ومضيفي MCP بدون واجهة مستخدم؛ وهو أيضًا هدف إطلاق التضمين. جسر التضمين - جلسة بدء التضمين الموقعة، والزرع مقابل عرض الإطار المتحكم فيه، والجسر المضيف `ui/*`، وCSP، وتثبيت الارتفاع - مملوك لشركة [External Agents](/docs/external-agents#mcp-app-bridge).
 
 ## قياسي actions {#standard-actions}
 

package/docs/content/locales/ar-SA/agent-native-toolkit.mdx

@@ -97,9 +97,9 @@ coherent kit instead of exposing package boundaries in the app.
 
 - [UI Primitives](/docs/toolkit-ui) cover shared shadcn-style primitives under
   `@agent-native/toolkit/ui/*`.
-- [App Adapters](/docs/toolkit-app-adapters) show how apps wrap Toolkit pieces
+- [App Adapters](/docs/toolkit-ui#app-adapters) show how apps wrap Toolkit pieces
   through local `@/components/*` adapters.
-- [Shell & Hooks](/docs/toolkit-shell-hooks) cover header actions, mobile hooks,
+- [Shell & Hooks](/docs/toolkit-ui#shell-hooks) cover header actions, mobile hooks,
   toasts, and small app-shell helpers.
 - [Component API](/docs/components) remains the lower-level reference for the
   public React exports.

package/docs/content/locales/ar-SA/agent-surfaces.mdx

@@ -139,8 +139,7 @@ pnpm install
 
 ثم حدد العملية الدائمة:
 
-```ts
-// actions/summarize-week.ts
+```ts filename="actions/summarize-week.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -494,12 +493,11 @@ export function AppShell({ children }) {
 نتائج الأدوات عندما تحتاج الدردشة إلى UI، وإضافة شاشات كاملة فقط عند المستخدمين
 تحتاج إلى تصفح الكائنات الثابتة أو مقارنتها أو تكوينها أو التعاون عليها.
 
-## المستندات ذات الصلة {#related-docs}
+## الخطوات التالية {#related-docs}
 
-- [Actions](/docs/actions) — حدد عملية مقطوعة الرأس مرة واحدة.
-- [Native واجهة الدردشة](/docs/native-chat-ui) — عرض نتائج الإجراءات المكتوبة في الدردشة.
-- [Drop-in Agent](/docs/drop-in-agent) — قم بتثبيت الدردشة أو الشريط الجانبي أو أسطح اللوحات.
-- [Component API](/docs/components) — مقطوعات الدردشة/الملحن React ذات المستوى الأدنى.
-- [Embedding SDK](/docs/embedding-sdk) — أضف Agent-Native إلى تطبيق موجود.
-- [External Agents](/docs/external-agents) — توصيل الأجهزة المضيفة المتوافقة مع MCP بأحد التطبيقات.
-- [A2A Protocol](/docs/a2a-protocol) — استدعاء الوكلاء من الوكلاء الآخرين.
+- [**Actions**](/docs/actions) — عرّف العملية مرة واحدة؛ كل سطح أعلاه يستدعي العملية نفسها
+- [**Native Chat UI**](/docs/native-chat-ui) — اعرض نتائج actions كجداول ومخططات وبطاقات في الدردشة
+- [**Generative UI**](/docs/generative-ui) — أنشئ واجهة مستخدم مؤقتة أو دائمة ضمن بيئة معزولة داخل الدردشة
+- [**Automation-First Apps**](/docs/pure-agent-apps) — النمط الكامل دون متصفح للوظائف وقوائم الانتظار والبرامج النصية والوكلاء الخارجيين
+- [**External Agents**](/docs/external-agents) — صِل المضيفين المتوافقين مع MCP بتطبيق
+- [**A2A Protocol**](/docs/a2a-protocol) — استدعِ الوكلاء من تطبيقات Agent-Native أخرى

package/docs/content/locales/ar-SA/agent-teams.mdx

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

package/docs/content/locales/ar-SA/authentication.mdx

@@ -15,7 +15,7 @@ description: "تكامل أفضل للمصادقة مع البريد الإلك
 - **جهاز التحكم عن بعد MCP OAuth:** معيار OAuth 2.1 لمضيفي MCP مثل Claude Code وموصلات ChatGPT.
 - **مخصص:** قم بإحضار المصادقة الخاصة بك عبر رد الاتصال `getSession`.
 
-<Diagram id="doc-block-5y2l0x" title={"ثلاث طرق في جلسة واحدة"} summary={"يقوم كل زوار المستعرض وعملاء MCP الآليين والموفرين المخصصين بالتوصل إلى نفس AuthSession الذي يقرأه النطاق النهائي."}>
+<Diagram id="doc-block-5y2l0x" title={"ثلاث طرق في جلسة واحدة"} summary={"يقوم كل زوار المستعرض ومضيفي MCP والموفرين المخصصين بالتوصل إلى نفس AuthSession الذي يقرأه النطاق النهائي."}>
 
 ```html
 <div class="auth-modes">

package/docs/content/locales/ar-SA/components.mdx

@@ -472,10 +472,12 @@ function WorkspaceResources() {
 ```ts
 import { defineAction } from "@agent-native/core/action";
 import { completeText } from "@agent-native/core/server";
+import { z } from "zod";
 
 export default defineAction({
   description: "Classify a short message",
-  run: async ({ body }: { body: string }) => {
+  schema: z.object({ body: z.string() }),
+  run: async ({ body }) => {
     const result = await completeText({
       systemPrompt: "Return exactly one label.",
       input: body,
@@ -490,3 +492,11 @@ export default defineAction({
 استخدم `sendToAgentChat({ background: true, openSidebar: false })` بدلاً من ذلك عندما
 يحتاج العمل إلى أدوات، أو حالة، أو إمكانية التدقيق، أو توجيه المستخدم، أو الخطوات المتعددة
 الاستدلال.
+
+## ما التالي {#whats-next}
+
+- [**Drop-in Agent**](/docs/drop-in-agent) — ثبّت `<AgentSidebar>` و`<AgentPanel>` مع شرح إرشادي يبدأ بالبرنامج التعليمي
+- [**Native Chat UI**](/docs/native-chat-ui) — عقد نتيجة الإجراء وراء عناصر واجهة البيانات وأدوات العرض المخصصة
+- [**Actions**](/docs/actions) — ‏`defineAction()` والمخططات وسطح الإجراءات الذي تستدعيه هذه المكونات
+- [**Real-Time Collaboration**](/docs/real-time-collaboration) — تفاصيل ربط التعاون ومكونات الحضور
+- [**Sharing**](/docs/sharing) — توصيل `<ShareButton>` و`<ShareDialog>` للموارد القابلة للامتلاك

package/docs/content/locales/ar-SA/creating-templates.mdx

@@ -44,7 +44,6 @@ npx @agent-native/core@latest create my-platform
 <FileTree
   id="doc-block-15r9qt6"
   title={"بنية مشروع ال template"}
-  title="my-template/"
   entries={[
     {
       path: "app/",
@@ -172,8 +171,7 @@ npx @agent-native/core@latest create my-platform
 
 حدد جداول المجال باستخدام إطار العمل المساعد Drizzle بحيث تظل المخططات قابلة للنقل عبر SQLite، وPostgres، وD1، وTurso، وSupabase، وNeon، والواجهات الخلفية المدعومة الأخرى:
 
-```ts
-// server/db/schema.ts
+```ts filename="server/db/schema.ts"
 import {
   table,
   text,
@@ -204,8 +202,7 @@ export const projectShares = createSharesTable("project_shares");
 
 لقراءة التطبيق وكتابته، استخدم منشئ الاستعلامات والمشغلات المحمولة Drizzle من `drizzle-orm`. لا تكتب رمز المنتج باستخدام SQL الخام عندما يتمكن Drizzle من التعبير عن الاستعلام، ولا تستورد من `drizzle-orm/sqlite-core` أو `drizzle-orm/pg-core` في القوالب.
 
-```ts
-// server/plugins/db.ts
+```ts filename="server/plugins/db.ts"
 import { runMigrations } from "@agent-native/core/db";
 
 export default runMigrations(
@@ -349,8 +346,7 @@ export function useNavigationState() {
 `path` عندما يكون URL معروفًا. ولا تكتب أيضًا `__set_url__` لنفس الحركة؛
 هذا المفتاح محجوز لأدوات إطار العمل URL وتغييرات مرشح URL فقط.
 
-```ts
-// actions/navigate.ts
+```ts filename="actions/navigate.ts"
 import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { z } from "zod";

package/docs/content/locales/ar-SA/cross-app-sso.mdx

@@ -9,7 +9,11 @@ description: "قم بتسجيل الدخول مرة واحدة عبر كل تط
 
 هذا هو نفس مبدأ الثقة الأساسي [A2A](/docs/a2a-protocol) و[External Agents](/docs/external-agents) الذي يستخدمه بالفعل - `A2A_SECRET` الموقع JWT والذي تم التحقق منه عند حد الطلب - والذي يتم تطبيقه على مسار تسجيل الدخول البشري بدلاً من مكالمات وكيل إلى وكيل.
 
-> **النشر الموحد مقابل النشر لكل مجال.** إذا كنت تستضيف جميع التطبيقات في مصدر واحد (`your-agents.com/mail`، `your-agents.com/calendar`)، فستحصل بالفعل على تسجيل دخول مشترك عبر مجال ملف تعريف ارتباط واحد - لا حاجة إلى اتحاد. يعد Cross-App SSO ضروريًا فقط عند تشغيل التطبيقات على مجالات منفصلة. انظر [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment).
+<Callout tone="info">
+
+**النشر الموحد مقابل النشر لكل مجال.** إذا كنت تستضيف جميع التطبيقات في مصدر واحد (`your-agents.com/mail`، `your-agents.com/calendar`)، فستحصل بالفعل على تسجيل دخول مشترك عبر مجال ملف تعريف ارتباط واحد - لا حاجة إلى اتحاد. يعد Cross-App SSO ضروريًا فقط عند تشغيل التطبيقات على مجالات منفصلة. انظر [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment).
+
+</Callout>
 
 ## ماذا ولماذا {#what-why}
 
@@ -86,15 +90,17 @@ description: "قم بتسجيل الدخول مرة واحدة عبر كل تط
 
 </Diagram>
 
-1. **التطبيق → إرسال (تفويض).** يرسل التطبيق المستخدم إلى سلطة الهوية:
+1. **التطبيق → Dispatch (التفويض).** ينشئ مسار `GET /_agent-native/identity/login` في التطبيق (وهو المسار الذي يرتبط به زر «تسجيل الدخول باستخدام Agent-Native») إعادة التوجيه ويرسل المستخدم إلى جهة الهوية:
 
-   ```
+   ```http
    GET https://dispatch.agent-native.com/_agent-native/identity/authorize
        ?app=<requesting-app>
        &redirect_uri=<app-callback-url>
        &state=<csrf-state>
    ```
 
+   `redirect_uri` هو مسار `GET /_agent-native/identity/callback` الخاص بهذا التطبيق — وهو المسار الذي يستقبل الرمز الموقّع في الخطوة 3.
+
 <Endpoint id="cross-app-sso-identity-authorize-ar-sa" title={"الهوية تأذن بنقطة النهاية"} method="GET" path="/_agent-native/identity/authorize" summary={"تقوم شركة Dispatch (سلطة الهوية) بالمصادقة على المستخدم وإعادة التوجيه مرة أخرى باستخدام رمز هوية موقّع"} auth={"جلسة الإرسال (تسجيل الدخول التفاعلي إذا لم يكن هناك)"} params={[
   {
     "name": "app",
@@ -143,7 +149,7 @@ description: "قم بتسجيل الدخول مرة واحدة عبر كل تط
    | `scope`      | `"identity"` دائمًا — يسمح هذا الرمز المميز بتسجيل الدخول فقط                    |
    | `exp`        | **≥ دقيقتين** من الإصدار                                                         |
 
-4. **يتحقق التطبيق من روابط JIT عبر البريد الإلكتروني.** يتحقق التطبيق من توقيع الرمز المميز باستخدام `A2A_SECRET` الخاص به، ويتحقق من `scope: "identity"` و`exp`، ثم ينفذ **الربط في الوقت المناسب تمامًا عن طريق البريد الإلكتروني الذي تم التحقق منه**:
+4. **يتحقق التطبيق ويربط الحساب في الوقت المناسب عبر البريد الإلكتروني.** يتحقق مسار `GET /_agent-native/identity/callback` في التطبيق من توقيع الرمز المميز باستخدام `A2A_SECRET` الخاص به، ويتحقق من `scope: "identity"` و`exp`، ثم ينفذ **الربط في الوقت المناسب حصريًا عبر البريد الإلكتروني المتحقق منه**:
    - في حالة وجود مستخدم محلي لديه هذا البريد الإلكتروني → أعد استخدامه دون تغيير.
    - إذا لم يكن الأمر كذلك، قم بإنشاء مستخدم محلي لهذا البريد الإلكتروني.
 
@@ -290,9 +296,13 @@ AGENT_NATIVE_IDENTITY_HUB_URL=https://dispatch.agent-native.com
 **5. التراجع = إلغاء تعيين env var عند نشر هذا التطبيق.**
 للتراجع عن أي تطبيق، **قم بإزالة `AGENT_NATIVE_IDENTITY_HUB_URL` من بيئة ذلك التطبيق وأعد نشره/أعد تشغيله.** يعود التطبيق فورًا إلى سلوك المصادقة السابق الخاص به. لا يوجد **لا يوجد تغيير في البيانات للتراجع عنه** — تمت إضافة صفوف الهوية فقط، كما أن إلغاء تعيين المتغير يجعل مسار الاتحاد خاملًا مرة أخرى. تعتبر عمليات الاستبدال والتراجع لكل تطبيق مستقلة وقابلة للعكس.
 
-> يقوم الطرح بتسجيل خروج المستخدمين عند تمكين كل تطبيق (يقومون بإعادة المصادقة عبر Dispatch)، ولكنهم دائمًا ما يقومون بتسجيل الدخول مرة أخرى إلى **نفس الحساب المطابق للبريد الإلكتروني مع الحفاظ على البيانات**، لأنه لا يتم إتلاف صفوف الهوية أو إعادة تسميتها أبدًا، بل تتم إضافتها فقط.
+<Callout tone="info">
+
+يقوم الطرح بتسجيل خروج المستخدمين عند تمكين كل تطبيق (يقومون بإعادة المصادقة عبر Dispatch)، ولكنهم دائمًا ما يقومون بتسجيل الدخول مرة أخرى إلى **نفس الحساب المطابق للبريد الإلكتروني مع الحفاظ على البيانات**، لأنه لا يتم إتلاف صفوف الهوية أو إعادة تسميتها أبدًا، بل تتم إضافتها فقط.
+
+</Callout>
 
-## ذات صلة {#related}
+## الخطوات التالية {#whats-next}
 
 - [Authentication](/docs/authentication) — أوضاع المصادقة المحلية، والجلسات، والمؤسسات، ومتغير البيئة `A2A_SECRET`.
 - [A2A Protocol](/docs/a2a-protocol) — نموذج الثقة JWT المُوقع، الذي يتم التحقق منه عند الحدود والذي يُعاد استخدامه.

package/docs/content/locales/ar-SA/deployment.mdx

@@ -452,3 +452,11 @@ export default createAgentChatPlugin({
 ## نشر المثيلات المتعددة {#multi-instance}
 
 تقوم تطبيقات Agent-Native بتخزين جميع الحالات في SQL عبر Drizzle ومزامنة UI عبر [polling](/docs/key-concepts#polling-sync) مع قاعدة البيانات - لا توجد حالة نظام ملفات، ولا توجد جلسات ثابتة، ولا توجد ذاكرة تخزين مؤقت في الذاكرة. وهذا يعني أن عمليات النشر متعددة المثيلات وبدون خادم تعمل خارج الصندوق: قم بتوجيه كل مثيل إلى نفس `DATABASE_URL` وستتقارب تلقائيًا. انظر [Key Concepts — Data in SQL](/docs/key-concepts#data-in-sql) و[Portability](/docs/key-concepts#hosting-agnostic).
+
+## الخطوات التالية
+
+- [**Database**](/docs/database#production) — اختر قاعدة بيانات SQL دائمة قبل أول نشر للإنتاج
+- [**Security**](/docs/security) — قائمة تحقق الإنتاج والعلامات الاختيارية المشار إليها في هذه الصفحة
+- [**Authentication**](/docs/authentication) — بيانات اعتماد OAuth ومتغيرات البيئة لوضع المصادقة الذي تختاره
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — نموذج مساحة العمل وراء بنية `deploy` ذات الأصل الواحد
+- [**Frames**](/docs/frames) — لوحة الوكيل المضمنة مقارنةً بإطار Builder.io السحابي لتعديلات واجهة الإنتاج

package/docs/content/locales/ar-SA/extensions.mdx

@@ -11,6 +11,14 @@ description: "التطبيقات المصغرة التي ينشئها المست
 
 التأطير مهم: الإضافة ليست عبارة عن وضع حماية عام "افعل ما تريد". إنه **تطبيق صغير يعمل على توسيع قالب معين** - البريد والتحليلات والتقويم والقصاصات والتصميم - ويستخدم actions لهذا القالب وبياناته. ملحق البريد يقرأ رسائل البريد الإلكتروني. يقرأ ملحق Analytics مقاييس لوحة المعلومات. يعمل ملحق التقويم على الحدث المفتوح. إنهم يشعرون وكأنهم جزء من المنتج المضيف لأنهم _هم_ جزء من المنتج المضيف.
 
+> **تضيف الامتدادات واجهة مستخدم، لكنها لا تعيد كتابة واجهة التطبيق
+> المضيف.** يظهر الامتداد في صفحته الخاصة أو داخل [فتحة](#slots) مسماة
+> يوفّرها القالب. ولا يمكنه إدراج عناصر داخل مكونات أصلية عشوائية — مثل
+> وضع عنصر بجوار كل حاضر في التقويم — ما لم يوفّر القالب فتحة في ذلك الموضع.
+> وللتخصيص الأعمق، اطلب من الوكيل تعديل التعليمات البرمجية المصدرية للقالب.
+> يُعد التخصيص الكامل للتعليمات البرمجية قدرة أساسية في Agent Native؛ أما
+> الامتدادات فهي طبقة سريعة لا تتطلب النشر.
+
 هناك ثلاثة أشياء تجعل الإضافات تعمل:
 
 - **لا يوجد تعليمات برمجية، ولا يوجد نشر.** يكتبها الوكيل وستكون مباشرة في ثوانٍ. مخزنة في قاعدة البيانات، وليس الريبو.

package/docs/content/locales/ar-SA/external-agents.mdx

@@ -136,13 +136,8 @@ ChatGPT: استخدم مساحة عمل حيث توجد موصلات MCP الم
 تغييرات البيانات التعريفية لتطبيق MCP. إذا كان لا يزال لديك موصلات قديمة لكل تطبيق
 ممكّن جنبًا إلى جنب مع Dispatch أو تحديث أو إعادة توصيل كل موصل قديم؛ التحديث
 لا يقوم Dispatch بإعادة كتابة تقويم/بريد ChatGPT أو Claude المخزن مؤقتًا/البريد/إلخ.
-لقطات. النطاقات هي:
-
-| النطاق      | ما يتيحه                                                          |
-| ----------- | ----------------------------------------------------------------- |
-| `mcp:read`  | أدوات للقراءة فقط واكتشاف الأدوات/الموارد                         |
-| `mcp:write` | الصياغة والتحديث وغيرها من تعديلات actions                        |
-| `mcp:apps`  | تطبيقات MCP المضمّنة، والمخططات، ولوحات المعلومات، والمسودات، وUI |
+لقطات. نطاقات `mcp:read` / `mcp:write` / `mcp:apps` هي نفسها الموضحة في
+[OAuth القياسي لـ MCP البعيد](#standard-oauth) أدناه.
 
 يستخدم كل من Cursor وGoose وPostman وMCPJam وVS Code GitHub Copilot نفس جهاز التحكم عن بعد
 MCP URL من خلال خادم MCP الخاص بهم UI عندما يدعم تصميمهم OAuth عن بعد

package/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/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/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