@agent-native/core 0.76.5 → 0.76.6

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

@@ -0,0 +1,312 @@
+---
+title: "المفاهيم الأساسية"
+description: "كيفية عمل تطبيقات الوكيل الأصلية: actions أولاً، قاعدة بيانات SQL، حلقة وكيل التطبيق، UI الاختيارية، مزامنة الاستقصاء، نقاط دخول الوكيل الخارجي، الوعي بالسياق، وقابلية النقل."
+---
+
+# المفاهيم الأساسية
+
+كيفية عمل التطبيقات الأصلية للوكيل تحت الغطاء - المبادئ والبنية. هذه الصفحة هي العقد. لرؤية وحالة البناء بهذه الطريقة، راجع [What Is Agent-Native?](/docs/what-is-agent-native).
+
+## الهندسة المعمارية {#the-architecture}
+
+يتكون كل تطبيق وكيل أصلي من ثلاثة أشياء تعمل معًا:
+
+> **Agent** — الذكاء الاصطناعي المستقل الذي يقرأ البيانات، ويكتب البيانات، ويشغل actions، ويعدل التعليمات البرمجية. قابلة للتخصيص باستخدام skills والتعليمات.
+>
+> **التطبيق** — سطح المنتج حول العامل. قد يكون هذا الإجراء فقط في البداية، أو دردشة غنية، أو مستوى تحكم صغير، أو React UI كامل مع لوحات المعلومات، وعمليات التدفق، والمرئيات.
+>
+> **الكمبيوتر** — قاعدة البيانات، المتصفح، تنفيذ التعليمات البرمجية. يعمل الوكلاء مباشرةً باستخدام SQL والأدوات المضمنة؛ خوادم MCP هي إضافات اختيارية وليست أساسية.
+
+```an-diagram title="Agent, application, and computer" summary="Three layers working together over one shared SQL store. The agent and the application both read and write the same data."
+{
+  "html": "<div class=\"diagram-arch\"><div class=\"diagram-row\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Agent</span><small class=\"diagram-muted\">reads + writes data, runs actions, modifies code</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">Application</span><small class=\"diagram-muted\">action-only, chat, control plane, or full React UI</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;&nbsp;&uarr;</div><div class=\"diagram-box\" data-rough>Computer<br><small class=\"diagram-muted\">SQL database · browser · code execution</small></div></div>",
+  "css": ".diagram-arch{display:flex;flex-direction:column;align-items:center;gap:10px}.diagram-arch .diagram-row{display:flex;gap:12px;flex-wrap:wrap;justify-content:center}.diagram-arch .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:220px}.diagram-arch .diagram-arrow{font-size:20px;line-height:1}.diagram-arch .diagram-box{text-align:center;padding:12px 18px}"
+}
+```
+
+يمكن للتطبيقات مقطوعة الرأس تشغيل نفس حلقة وكيل تطبيق الإنتاج من المجلد باستخدام `pnpm agent`، بينما تقوم تطبيقات UI بتثبيت لوحة الوكيل المضمنة وتشغيلها محليًا باستخدام `pnpm dev`. في السحابة، يوفر Builder.io إطارًا مُدارًا - البيئة التي تستضيف الوكيل بجوار تطبيقك - مع التعاون والتحرير المرئي والبنية الأساسية المُدارة للفرق.
+
+## العناصر الأساسية للوكيل {#agent-building-blocks}
+
+يحتوي كل تطبيق وكيل أصلي على نفس العناصر الأساسية للوكيل، بغض النظر عما إذا كان
+يجب أن يكون سطح المنتج بدون رأس، أو للدردشة أولاً، أو UI كاملاً:
+
+```an-file-tree title="Guidance and behavior"
+{
+  "entries": [
+    { "path": "AGENTS.md", "note": "always-on instructions: purpose, core rules, state keys, action index, skills index" },
+    { "path": ".agents/skills/<name>/SKILL.md", "note": "reusable behavior: workflow steps, policies, examples, references, and do/don't lists" },
+    { "path": "actions/<name>.ts", "note": "executable capability: typed operation exposed to the agent, UI, CLI, HTTP, MCP, A2A, jobs, and webhooks" }
+  ]
+}
+```
+
+| كتلة البناء   | استخدمه من أجل                                                                                                           | تم التحميل عندما                                        |
+| ------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------- |
+| **التعليمات** | توجيه ثابت يجب على الوكيل تنفيذه في كل مهمة: ما هو التطبيق، الثوابت، النغمة، الفهارس                                     | كل دورة                                                 |
+| **Skills**    | السلوك القابل لإعادة الاستخدام: كيفية متابعة سير العمل، أو تطبيق سياسة، أو فحص الأدلة، أو التحقق من المخرجات             | عند الطلب عندما يتطابق وصف المهارة مع المهمة            |
+| **Actions**   | العمليات الحقيقية: قراءة البيانات أو كتابتها، والاتصال بـ API، وإرسال الرسائل، وتشغيل الموافقات، وإنتاج النتائج المكتوبة | يتم إدراجه كأدوات في كل دور؛ يتم تنفيذه فقط عند الاتصال |
+
+يعمل Skills وactions معًا. مهارة تعلم الوكيل كيفية القيام بفصل
+العمل؛ الإجراء هو مسار التعليمات البرمجية الذي يمكنه الاتصال به أثناء القيام بهذا العمل. على سبيل المثال،
+قد تخبر مهارة `customer-research` الوكيل بالمصادر التي يجب فحصها و
+كيفية تلخيص الأدلة أثناء جلب `search-crm` و`create-brief` actions
+واكتب البيانات الفعلية.
+
+ستة قواعد تحكم البنية:
+
+1. **البيانات موجودة في SQL** — جميع حالات التطبيق موجودة في قاعدة البيانات عبر Drizzle ORM
+2. **كل الذكاء الاصطناعي يمر عبر الوكيل** — لا توجد مكالمات LLM مضمنة
+3. **Actions لعمليات الوكيل** — يتم تشغيل العمل المعقد كـ actions
+4. **المزامنة المباشرة تحافظ على مزامنة UI** — تدفق تغييرات قاعدة البيانات عبر SSE مع الاستقصاء كإجراء احتياطي عالمي
+5. **يمكن للوكيل تعديل التعليمات البرمجية** — يتطور التطبيق أثناء استخدامه
+6. **حالة التطبيق في SQL** — حالة UI المؤقتة موجودة في قاعدة البيانات، ويمكن قراءتها بواسطة كل من الوكيل وUI
+
+## قائمة التحقق ذات المناطق الأربعة {#four-area-checklist}
+
+يجب على كل ميزة تواجه المستخدم تحديث جميع المجالات القابلة للتطبيق. يؤدي تخطي منطقة قابلة للتطبيق إلى كسر عقد الوكيل الأصلي؛ إجبار UI على بدائية الحركة فقط هو أيضًا رائحة.
+
+| المساحة             | الوصف                                                    |
+| ------------------- | -------------------------------------------------------- |
+| **1. UI**           | الصفحة أو المكون أو مربع الحوار الذي يتفاعل معه المستخدم |
+| **2. الإجراء**      | إجراء يمكن استدعاء الوكيل فيه في actions/ لنفس العملية   |
+| **3. Skills**       | تحديث AGENTS.md و/أو إنشاء مهارة لتوثيق النمط            |
+| **4. حالة التطبيق** | حالة التنقل وبيانات شاشة العرض وأوامر التنقل             |
+
+الميزة التي تحتوي على UI فقط تكون غير مرئية للوكيل. ميزة UI الكاملة مع actions فقط غير مرئية للمستخدم. الميزة التي لا تحتوي على حالة التطبيق تعني أن الوكيل لا يرى ما يفعله المستخدم. يمكن أن تبدأ العملية بدون رأس بطريقة شرعية من خلال تعليمات الإجراء + وإضافة UI/app-state لاحقًا عندما يحتاج البشر إلى تصفحها أو الموافقة عليها أو تهيئتها أو مشاركتها.
+
+## البيانات في SQL {#data-in-sql}
+
+توجد جميع حالات التطبيق في قاعدة بيانات SQL عبر Drizzle ORM. المخططات لا تعتمد على المزود؛ قواعد البيانات المدعومة وتكوين `DATABASE_URL` وقواعد النقل موجودة في [Database](/docs/database).
+
+يتم إنشاء متاجر SQL الأساسية تلقائيًا وهي متاحة في كل قالب:
+
+- `application_state` — حالة UI سريعة الزوال (التنقل، المسودات، التحديدات)
+- `settings` — تكوين قيمة المفتاح المستمر
+- `oauth_tokens` — بيانات اعتماد OAuth
+- `sessions` — جلسات المصادقة
+
+```an-schema title="Core SQL stores" summary="Auto-created in every template — the agent and UI both read and write these."
+{
+  "entities": [
+    { "id": "application_state", "name": "application_state", "note": "Ephemeral UI state the agent reads for context", "fields": [
+      { "name": "key", "type": "text", "pk": true, "note": "e.g. 'navigation'" },
+      { "name": "value", "type": "json", "note": "view, selection, drafts" }
+    ] },
+    { "id": "settings", "name": "settings", "note": "Persistent key-value config", "fields": [
+      { "name": "key", "type": "text", "pk": true },
+      { "name": "value", "type": "json" }
+    ] },
+    { "id": "oauth_tokens", "name": "oauth_tokens", "note": "OAuth credentials", "fields": [
+      { "name": "provider", "type": "text", "pk": true },
+      { "name": "token", "type": "text" }
+    ] },
+    { "id": "sessions", "name": "sessions", "note": "Auth sessions", "fields": [
+      { "name": "id", "type": "text", "pk": true },
+      { "name": "userId", "type": "text" }
+    ] }
+  ]
+}
+```
+
+```ts
+// Drizzle schema for domain data
+import { table, text, integer } from "@agent-native/core/db/schema";
+
+export const forms = table("forms", {
+  id: text("id").primaryKey(),
+  title: text("title").notNull(),
+  schema: text("schema").notNull(), // JSON
+  ownerEmail: text("owner_email"),
+  createdAt: integer("created_at").notNull(),
+});
+```
+
+```bash
+# Core actions for quick database inspection and one-off maintenance
+pnpm action db-schema                                       # show all tables
+pnpm action db-query --sql "SELECT * FROM forms"
+pnpm action db-exec --sql "UPDATE forms SET status = ? WHERE id = ?" --args '["closed","form-1"]'
+# Surgical find/replace on a large text column — sends a diff, not the whole value
+pnpm action db-patch --table documents --column content \
+  --where "id='doc-1'" --find "old heading" --replace "new heading"
+```
+
+يتيح البرنامج الإضافي للدردشة مع وكيل الإنتاج إمكانية كتابة قاعدة البيانات الأولية بشكل افتراضي
+(`databaseTools: "write"`) حتى يتمكن الوكلاء من إصلاح البيانات المملوكة للتطبيق دون الانتظار
+إجراء مكتوب جديد. يتم تحديد نطاق عمليات الكتابة هذه للمستخدم/المؤسسة التي تمت مصادقتها. تعيين
+`databaseTools: "read"` للاحتفاظ بفحص `db-schema` / `db-query` فقط، أو
+`databaseTools: "off"` / `false` للمطالبة بالتطبيق المكتوب actions لجميع البيانات
+الوصول.
+
+## جسر دردشة الوكيل {#agent-chat-bridge}
+
+لا يتصل UI مطلقًا بـ LLM مباشرة. عندما ينقر المستخدم على "إنشاء مخطط" أو "كتابة ملخص"، يرسل UI رسالة إلى الوكيل عبر `postMessage`. يقوم الوكيل بالعمل — مع سجل المحادثات الكامل، وskills، والتعليمات، والقدرة على التكرار.
+
+```ts
+// In a React component — delegate AI work to the agent
+import { sendToAgentChat } from "@agent-native/core/client";
+
+sendToAgentChat({
+  message: "Generate a chart showing signups by source",
+  context: "Dashboard ID: main, date range: last 30 days",
+  submit: true,
+});
+```
+
+لماذا لا تتصل بـ LLM المضمّن؟
+
+- **الذكاء الاصطناعي غير حتمي.** أنت بحاجة إلى تدفق المحادثة لتقديم التعليقات والتكرار - وليس الأزرار التي تستخدم مرة واحدة.
+- **السياق مهم.** يمتلك الوكيل قاعدة التعليمات البرمجية الكاملة والتعليمات وskills والسجل. المكالمة المضمنة لا تحتوي على أي من ذلك.
+- **يمكن للوكيل فعل المزيد.** يمكنه تشغيل actions، وتصفح الويب، وتعديل التعليمات البرمجية، وتسلسل خطوات متعددة معًا.
+- **التنفيذ بدون مراقبة.** نظرًا لأن كل شيء يمر عبر الوكيل، يمكن تشغيل أي تطبيق بالكامل من Slack أو Telegram أو وكيل آخر عبر [A2A](/docs/a2a-protocol).
+
+## نظام Actions {#actions-system}
+
+عندما يحتاج الوكيل إلى القيام بشيء معقد - استدعاء API ومعالجة البيانات والاستعلام عن قاعدة البيانات - فإنه يقوم بتشغيل **إجراء**. Actions هي ملفات TypeScript في `actions/` والتي تقوم بتصدير `defineAction()` الافتراضي:
+
+```ts
+// actions/fetch-data.ts
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+export default defineAction({
+  description: "Fetch data from a source API.",
+  schema: z.object({
+    source: z.string().describe("Data source key, e.g. 'signups'"),
+  }),
+  run: async ({ source }) => {
+    const res = await fetch(`https://api.example.com/${source}`);
+    return await res.json();
+  },
+});
+```
+
+تمنحك مكالمة `defineAction()` واحدة ما يلي:
+
+- **أداة الوكيل** — يراها الوكيل باستخدام مخطط JSON المشتق من zod ويمكنه الاتصال بها.
+- **الخطاف الأمامي** — `useActionMutation("fetch-data")` مع استدلال TypeScript الكامل.
+- **نقل الإطار** — يتم تثبيته تلقائيًا خلف خطافات العميل.
+- **CLI** — `pnpm action fetch-data --source=signups` للبرمجة النصية وحلقات تطوير الوكيل.
+- **أداة MCP / أداة A2A** — عند تمكين خادم MCP أو A2A، يظهر نفس الإجراء هناك أيضًا.
+
+نفس المنطق، وتعريف واحد، يتم توصيله تلقائيًا لكل مستهلك. راجع [Actions](/docs/actions) للحصول على المرجع الكامل.
+
+## المزامنة المباشرة {#polling-sync}
+
+تتم مزامنة تغييرات قاعدة البيانات مع UI من خلال `useDbSync()`. نفس العملية تكتب الدفق عبر `/_agent-native/events`؛ يظل `/_agent-native/poll` هو الإجراء الاحتياطي متعدد العمليات وبدون خادم. عندما يكتب الوكيل إلى قاعدة البيانات (حالة التطبيق أو الإعدادات أو بيانات المجال)، يزيد عداد الإصدار ويقوم العميل بإبطال ذاكرة التخزين المؤقت للاستعلام React ذات الصلة.
+
+```ts
+// Client: subscribe to agent/UI data changes once near the app shell
+import { useDbSync } from "@agent-native/core/client";
+
+useDbSync({ queryClient });
+```
+
+التدفق هو:
+
+1. يقوم الوكيل بتشغيل إجراء يكتب إلى قاعدة البيانات
+2. يُصدر الخادم حدث تغيير بمصدر مثل `"action"` أو `"settings"`
+3. يتلقاها `useDbSync` عبر SSE أو الاستقصاء الاحتياطي
+4. إعادة جلب الخطافات `useActionQuery` والخطافات `useQuery` ذات الإصدار المصدر
+5. تعرض المكونات البيانات الجديدة دون إعادة تحميل الصفحة
+
+```an-diagram title="Live sync flow" summary="An agent write becomes a UI render with no manual refresh — SSE first, polling as the universal fallback."
+{
+  "html": "<div class=\"diagram-sync\"><div class=\"diagram-node\">Agent action<br><small class=\"diagram-muted\">writes to DB</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Change event<br><small class=\"diagram-muted\">source: action / settings</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">useDbSync</span><small class=\"diagram-muted\">SSE &middot; poll fallback</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Query refetch<br><small class=\"diagram-muted\">render, no reload</small></div></div>",
+  "css": ".diagram-sync{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-sync .diagram-arrow{font-size:22px;line-height:1}.diagram-sync .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:10px 14px}"
+}
+```
+
+يعمل هذا في جميع بيئات النشر - بما في ذلك بيئات النشر بدون خادم وبيئات Edge - لأنه يستخدم قاعدة البيانات، وليس مراقبي حالة الذاكرة أو نظام الملفات.
+
+## الإطارات {#frames}
+
+A _frame_ هي البيئة التي تستضيف الوكيل بجوار تطبيقك - محليًا هي اللوحة المضمنة؛ في السحابة، يوجد السطح المُدار لـ Builder.io. انظر [Frames](/docs/frames).
+
+تتضمن تطبيقات الوكيل الأصلية لوحة وكيل مضمنة توفر وكيل الذكاء الاصطناعي إلى جانب التطبيق UI. وهذا ما يجعل البنية تعمل: يحتاج الوكيل إلى جهاز كمبيوتر (قاعدة بيانات، ومتصفح، وتنفيذ التعليمات البرمجية)، ويحتاج التطبيق إلى الوكيل لعمل الذكاء الاصطناعي.
+
+> **Embedded Agent Panel** — الدردشة ومحطة CLI الاختيارية المدمجة في كل تطبيق. يدعم كود Claude، وCodex، وGemini، وOpenCode، وBuilder.io. يعمل محليا. مجاني ومفتوح المصدر.
+>
+> **السحابة** — النشر على أي سحابة من خلال التعاون في الوقت الفعلي والتحرير المرئي والأدوار والأذونات. الأفضل للفرق.
+
+## الوعي بالسياق {#context-awareness}
+
+يعرف الوكيل دائمًا ما يبحث عنه المستخدم. يكتب UI مفتاح `navigation` لحالة التطبيق عند كل تغيير للمسار. يقرأها الوكيل من خلال الإجراء `view-screen` قبل التصرف.
+
+على سبيل المثال، عند فتح سلسلة رسائل بريد إلكتروني، يقوم UI بإدراج صف مثل:
+
+```json
+{ "key": "navigation", "value": { "view": "thread", "threadId": "th_abc123" } }
+```
+
+يكتب UI هذا عند تغيير المسار؛ يقرأها الوكيل (عبر `view-screen`) قبل اتخاذ أي إجراء، حتى يعرف دائمًا أي موضوع - أو مخطط، أو شريحة - التي تركز عليها.
+
+راجع [Context Awareness](/docs/context-awareness) للتعرف على النمط الكامل: حالة التنقل، وشاشة العرض، وأوامر التنقل، ومنع الاهتزاز.
+
+## إجراء واحد، وأسطح متعددة {#protocols}
+
+تنفيذ عملية المجال مرة واحدة كإجراء؛ الإطار يعرضه لكل مستهلك. تصبح نفس `defineAction()` أداة وكيل، وخطاف UI آمن، ونقطة نهاية HTTP، وأمر CLI، وأداة MCP، وأداة A2A، مع إضافة `link` الاختيارية، أو `mcpApp`، أو بيانات تعريف عنصر واجهة المستخدم الأصلية الصريحة فقط عندما يحتاج السطح إليها. Skills والتعليمات تغطي السلوك.
+
+للاطلاع على البروتوكول الكامل/المصفوفة السطحية (خادم MCP وOAuth وتطبيقات MCP وA2A والارتباطات العميقة وعناصر واجهة المستخدم للدردشة الأصلية وموصلات AgentChatRuntime وAgent Web وأفق المحول لـ ACP وA2UI)، ولاختيار شكل المنتج - بدون رأس أو دردشة غنية أو عربة جانبية مضمنة أو تطبيق كامل - راجع [Agent Surfaces](/docs/agent-surfaces).
+
+## يقوم الوكيل بتعديل الكود {#agent-modifies-code}
+
+هذه ميزة وليست خطأ. يمكن للوكيل تحرير كود مصدر التطبيق بأمان: المكونات، والمسارات، والأنماط، وactions.
+
+ليس هناك قاعدة تعليمات برمجية مشتركة لكسرها. أنت تملك التطبيق، وسيعمل الوكيل على تطويره لك بمرور الوقت:
+
+1. تفرع القالب (على سبيل المثال، قالب التحليلات)
+2. قم بتخصيصه عن طريق سؤال الوكيل
+3. "إضافة نوع مخطط جديد للتحليل الجماعي" — يقوم الوكيل بإنشائه
+4. "الاتصال بحساب Stripe الخاص بنا" — يكتب الوكيل عملية التكامل
+5. يستمر تطبيقك في التحسن بدون التطوير اليدوي
+
+## محمولة بشكل افتراضي {#hosting-agnostic}
+
+هناك قاعدتان معماريتان تحافظان على إمكانية نقل التطبيقات عبر قواعد البيانات والمضيفين:
+
+- **لا تعرف قاعدة البيانات.** اكتب المخططات باستخدام `@agent-native/core/db/schema` وقم بالقراءة/الكتابة باستخدام الاستعلام المحمول Drizzle DSL بحيث يتم تشغيل نفس الكود على أي موفر مدعوم. استخدم SQL الخام فقط لعمليات الترحيل الإضافية أو الصيانة لمرة واحدة، مع الاحتفاظ بمعلمات ومحايدة للهجة. انظر [Database](/docs/database).
+- **لا تعتمد على الاستضافة.** يعمل الخادم على Nitro ويترجم إلى أي هدف نشر. لا تستخدم أبدًا APIs الخاصة بالعقدة (`fs`، `child_process`، `path`) في مسارات الخادم أو المكونات الإضافية، ولا تفترض أبدًا عملية خادم مستمرة - بدون خادم والحافة عديمة الحالة، لذا احتفظ بكل الحالة في SQL. انظر [Deployment](/docs/deployment).
+
+## مساحة العمل {#workspace}
+
+يحصل كل مستخدم على **مساحة عمل** — تعليمات، وskills، وذاكرة، ووكلاء فرعيين مخصصين، ومهام مجدولة، وخوادم MCP متصلة — وكلها مخزنة في SQL بدلاً من الملفات. وهذا يجعل التخصيص على مستوى الكود Claude قابلاً للتطبيق داخل SaaS متعدد المستأجرين دون تدوير حاوية لكل مستخدم. انظر [Workspace](/docs/workspace).
+
+## العناصر الأساسية ذات الصلة {#building-blocks}
+
+توجد هذه العناصر فوق نفس العقد ولها تفاصيل خاصة بها:
+
+- **[Dispatch](/docs/dispatch)** — مستوى التحكم في مساحة العمل: البريد الوارد المشترك، وخزينة الأسرار، والمهام المجدولة، والمنسق الذي يفوض التطبيقات المتخصصة عبر A2A.
+- **[Extensions](/docs/extensions)** — تطبيقات Alpine.js المصغرة في وضع الحماية التي ينشئها الوكيل في وقت التشغيل، بدون تغييرات في المصدر أو عمليات ترحيل.
+- **[A2A Protocol](/docs/a2a-protocol)** — كيف تكتشف التطبيقات الموجودة في مساحة العمل نفسها وتتصل ببعضها البعض عبر JSON-RPC.
+
+## ما تحصل عليه مجانًا {#what-you-get-for-free}
+
+يعد اعتماد إطار العمل أمرًا ذا قيمة في الغالب بسبب ما لم تعد بحاجة إلى بنائه. في اللحظة التي يتبع فيها تطبيقك القواعد الستة، ترث:
+
+- **إجراء واحد = كل سطح.** كل إجراء محدد باستخدام `defineAction()` هو في الوقت نفسه أداة وكيل، وخطاف أمامي آمن للكتابة (`useActionQuery` / `useActionMutation`)، ووسيلة نقل HTTP مملوكة لإطار العمل، وأمر CLI، وأداة MCP للعملاء الخارجيين، وأداة A2A لتطبيقات الوكيل الأصلية الأخرى. تضيف البيانات التعريفية الاختيارية `link` و`mcpApp` روابط عميقة وتطبيقات MCP UI بدون تنفيذ ثانٍ.
+- **مساحة عمل كاملة لكل مستخدم.** Skills، `LEARNINGS.md` المشتركة، `memory/MEMORY.md` الشخصية، `AGENTS.md`، الوكلاء الفرعيون المخصصون، المهام المجدولة، خوادم MCP المتصلة - جميعها مدعومة بـ SQL، لا يلزم وجود صندوق تطوير. انظر [Workspace](/docs/workspace).
+- **مكونات React التي يمكن إضافتها.** يعرض `<AgentPanel />` و`<AgentSidebar />` الدردشة + مساحة العمل في أي مكان في تطبيقك. انظر [Drop-in Agent](/docs/drop-in-agent).
+- ** أوقات تشغيل دردشة وكيل BYO.** يمكن أن توجد نفس الدردشة UI أعلى وكلاء OpenAI، أو ردود OpenAI، أو Claude Agent SDK، أو Vercel AI SDK، أو AG-UI، أو دفق HTTP الخاص بك. انظر [Native Chat UI](/docs/native-chat-ui#byo-agent-runtimes).
+- **مزامنة مباشرة بين الوكيل وUI.** نفس العملية تكتب الدفق مباشرة عبر `/_agent-native/events`؛ يحافظ الاستقصاء خفيف الوزن على تقارب عمليات الكتابة بدون خادم، وكرون، والعمليات المشتركة. يؤدي تغيير actions إلى إبطال الاستعلامات المدعومة بالإجراء تلقائيًا، بحيث تظهر السجلات التي أنشأها الوكيل دون تحديث يدوي. انظر [Live Sync](#polling-sync) أدناه.
+- **Auth, orgs, RBAC.** يتم توصيل مصادقة أفضل مع المؤسسات/الأعضاء/الأدوار لكل قالب. انظر [Authentication](/docs/authentication).
+- **الوعي بالسياق.** يعرف الوكيل دائمًا ما يبحث عنه المستخدم من خلال مفتاح حالة التطبيق `navigation`. انظر [Context Awareness](/docs/context-awareness).
+- **MCP العميل + الخادم، كلا الاتجاهين.** يستوعب التطبيق خوادم MCP (المحلية والبعيدة والمشتركة في المحور) _and_ ويكشف عن actions الخاص به كخادم MCP. راجع [MCP Clients](/docs/mcp-clients) و[MCP Protocol](/docs/mcp-protocol).
+- **التفويض بين التطبيقات.** يتحدث الوكلاء في التطبيقات المختلفة عبر [A2A](/docs/a2a-protocol). عمليات النشر ذات الأصل نفسه تخطي JWT؛ يستخدم cross-origin `A2A_SECRET` مشتركًا.
+- **فرق الوكلاء الفرعيين.** قم بإنشاء وكيل فرعي باستخدام سلسلة الرسائل والأدوات الخاصة به، والتي تظهر كشريحة مضمنة في الدردشة. انظر [Agent Teams](/docs/agent-teams).
+- **قابلية النقل.** أي قاعدة بيانات SQL مدعومة من Drizzle، أو أي مضيف متوافق مع Nitro (Node، Workers، Netlify، Vercel، Deno، Lambda، Bun).
+
+هذا هو "وكل شيء آخر" الذي كنت ستلصقه معًا بنفسك.
+
+## الغوص العميق {#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 Chat UI](/docs/native-chat-ui) — الجداول والرسوم البيانية التي تم الإعلان عنها، وموقف وقت التشغيل BYO
+- [Agent Surfaces](/docs/agent-surfaces) - دردشة غنية بدون رأس، وعربة جانبية مضمنة، ومسارات التطبيق الكامل
+- [A2A Protocol](/docs/a2a-protocol) — الاتصال من وكيل إلى وكيل
+- [Multi-App Workspace](/docs/multi-app-workspace) — استضافة العديد من التطبيقات في جهاز monorepo واحد مع مصادقة مشتركة وskills والمكونات وبيانات الاعتماد