LinuxDevil · Nov 14, 2026 · Nov 14, 2026
diff --git a/ar/acp.mdx b/ar/acp.mdx
@@ -2,6 +2,12 @@
 title: "Agent Client Protocol (ACP)"
 sidebarTitle: "المحررات (ACP)"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/acp).
+</Warning>
+
 {/* Generated from docs/acp.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 [Agent Client Protocol](https://agentclientprotocol.com) بروتوكول يتيح للمحرر

diff --git a/ar/agent-directories.mdx b/ar/agent-directories.mdx
@@ -1,6 +1,12 @@
 ---
 title: "مجلدات agent"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/agent-directories).
+</Warning>
+
 {/* Generated from docs/agent-directories.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 يمكنك تعريف الـ agent كمجلد. `loadAgentDir()` تقرأه وتستدعي `createAgent()` بالخيارات التي تصفها الملفات، فتُرجع بالضبط ما تُرجعه `createAgent()`. يبقى الـ typed code API هو المرجع الأساسي: المجلد طريقة أخرى لكتابة الخيارات نفسها، ويمكنك الانتقال إلى الكود في أي وقت دون إعادة كتابة.

diff --git a/ar/agent-forge.mdx b/ar/agent-forge.mdx
@@ -1,6 +1,12 @@
 ---
 title: "Agent Forge"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/agent-forge).
+</Warning>
+
 {/* Generated from docs/agent-forge.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 Agent Forge (`apps/agent-forge`، واسمه الآخر الـ Studio) هو الـ dashboard

diff --git a/ar/agent-spec.mdx b/ar/agent-spec.mdx
@@ -2,6 +2,12 @@
 title: "Agent spec v2"
 sidebarTitle: "Agent spec v2"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/agent-spec).
+</Warning>
+
 {/* Generated from docs/agent-spec.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 ملف مواصفات الـ agent بالإصدار 2 (agent spec v2) هو ملف YAML أو JSON يصف agent كاملًا كبيانات عادية: الـ model، والتعليمات، والـ tools، وخوادم MCP، والـ skills، والذاكرة، والـ sub-agents، والـ handoffs، والـ guardrails، وقواعد الصلاحيات، والـ hooks، والمخرجات المنظَّمة، والـ triggers، و flow اختياري. Agent Forge والـ Agent Author و`lousho dev` كلها تقرأ هذه الصيغة وتكتبها.

diff --git a/ar/ai-sdk-ui.mdx b/ar/ai-sdk-ui.mdx
@@ -2,6 +2,12 @@
 title: "AI SDK UI (useChat)"
 sidebarTitle: "AI SDK UI (useChat)"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/ai-sdk-ui).
+</Warning>
+
 {/* Generated from docs/ai-sdk-ui.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 إذا كانت الواجهة الأمامية (front end) لديك تستخدم أصلًا الـ UI hooks في Vercel AI SDK (`useChat` من `@ai-sdk/react` ومثيلاتها في Vue وSvelte وAngular)، فيمكنك إبقاؤها على حالها وتشغيل Lousho agent خلف الـ route. ثلاث دوال مُصدَّرة من جذر الحزمة تتولى التحويل. لا تستورد شيئًا من `ai`، ولا تستخدم أي `node:*` module، وتعمل على Node وWorkers وأي runtime مبني على Fetch.

diff --git a/ar/api-overview.mdx b/ar/api-overview.mdx
@@ -3,6 +3,12 @@ title: "نظرة عامة على الـ API"
 sidebarTitle: "نظرة عامة على الـ API"
 description: "جذر الحزمة (lousho) يصدّر كل شيء أدناه. للمرجع الكامل المولّد للـ API (كل export وكل signature وكل تعليق توثيقي)، ابنِ موقع TypeDoc:"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/api-overview).
+</Warning>
+
 {/* Generated from docs/api-overview.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 ```bash

diff --git a/ar/approvals.mdx b/ar/approvals.mdx
@@ -1,6 +1,12 @@
 ---
 title: "Approvals"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/approvals).
+</Warning>
+
 {/* Generated from docs/approvals.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 علّم الـ tool بـ `needsApproval` فيتوقف الـ run قبل تنفيذ الاستدعاء،

diff --git a/ar/auth.mdx b/ar/auth.mdx
@@ -1,6 +1,12 @@
 ---
 title: "Route auth والـ principals"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/auth).
+</Warning>
+
 {/* Generated from docs/auth.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 أي agent يعمل عبر HTTP يحتاج إلى معرفة أمرين عن كل request: هل يُسمح له بالمرور أصلًا، ومن المتصل. تجيب `lousho/auth` عن السؤالين. أنت تعطي الـ route قائمة مرتبة من مدخلات auth: `jwt()` أو `oidc()` أو `basic()` أو `apiToken()` أو `anonymous()`، أو function تكتبها بنفسك. أول entry يقبل الـ request يُرجع **principal** (هوية المتصل بعد أن تحققت منها auth)، وهذا الـ principal يدخل الـ run، وهناك تستطيع دوال `model` و`instructions` و`tools` ونطاقات الـ memory قراءته.

diff --git a/ar/build-a-coding-agent.mdx b/ar/build-a-coding-agent.mdx
@@ -2,6 +2,12 @@
 title: "ابنِ coding agent"
 sidebarTitle: "ابنِ coding agent"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/build-a-coding-agent).
+</Warning>
+
 {/* Generated from docs/build-a-coding-agent.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 هذه الصفحة تبني coding agent يعمل في الـ terminal على طريقة Claude Code: يقرأ ملفات مشروعك ويعدّلها، ويشغّل أوامر، ويسألك قبل أن يكتب ملفًا أو يشغّل شيئًا خطرًا، ويُبقي المحادثة مستمرة لأسئلة المتابعة. تحتاج إلى Node 22، ومفتاح API في متغيّر البيئة الذي يتوقعه الـ provider (`OPENAI_API_KEY` للـ model المستخدم هنا)، ومجلد مشروع تشغّله فيه. الملف الجاهز في آخر [الخطوة 5](#5-حافظ-على-استمرار-المحادثة)، وتشغّله هكذا `npx tsx coding.ts "Fix the failing test"`.

diff --git a/ar/channels.mdx b/ar/channels.mdx
@@ -1,6 +1,12 @@
 ---
 title: "Channels"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/channels).
+</Warning>
+
 {/* Generated from docs/channels.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 يربط الـ **channel** الـ agent بطرف واحد: JSON API، أو webhook، أو تطبيق

diff --git a/ar/claude-projects.mdx b/ar/claude-projects.mdx
@@ -1,6 +1,12 @@
 ---
 title: "مشاريع Claude Code"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/claude-projects).
+</Warning>
+
 {/* Generated from docs/claude-projects.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 المستودع الذي يحمل أصلًا ملفات Claude Code المعتادة —

diff --git a/ar/cli.mdx b/ar/cli.mdx
@@ -1,6 +1,12 @@
 ---
 title: "CLI"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/cli).
+</Warning>
+
 {/* Generated from docs/cli.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 تثبيت الحزمة يثبّت معها أمر `lousho`. ينشئ مشاريع جديدة، ويفحص الإعداد الخاص بك، ويشغّل agent محليًا، ويقدّمه عبر MCP، ويشغّل evals، ويعرض traces محفوظة، ويبني artifact جاهزًا للنشر، ويفتح لوحة Agent Forge. شغّله بـ `npx lousho <command>` داخل مشروع مثبّت فيه الـ SDK.

diff --git a/ar/cloudflare-workers.mdx b/ar/cloudflare-workers.mdx
@@ -2,6 +2,11 @@
 title: "Cloudflare Workers"
 ---
 
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/cloudflare-workers).
+</Warning>
+
 {/* Generated from docs/cloudflare-workers.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 الأمر `npx lousho build --target=cloudflare-worker --agent=agent.yaml` يولّد module Worker باسم `worker.ts`، و`wrangler.toml`، وbundle هو `dist/worker.js` يفحصه الـ build بحثًا عن استيرادات `node:`. يحتاج `tsup` و`wrangler` مثبتين، ويأخذ [ملف agent spec](/ar/configuration) أو [agent directory](/ar/agent-directories) (`npx lousho build ./my-agent --target=cloudflare-worker`). الـ Worker يقدّم نفس [HTTP API](/ar/deployment#http-api) التي تقدّمها الأهداف الثانية. هذا الهدف هو الأضيق حدودًا بين الثلاثة، فنبدأ بحدوده.

diff --git a/ar/code-mode.mdx b/ar/code-mode.mdx
@@ -1,6 +1,12 @@
 ---
 title: "Code mode"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/code-mode).
+</Warning>
+
 {/* Generated from docs/code-mode.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 مع code mode يحصل الموديل على tool إضافية: `run_code`. بدلًا من أن يستدعي الـ tools

diff --git a/ar/compaction.mdx b/ar/compaction.mdx
@@ -1,6 +1,12 @@
 ---
 title: "Context compaction"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/compaction).
+</Warning>
+
 {/* Generated from docs/compaction.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 run طويل لـagent يملأ الـcontext window غالبًا بنتائج الـtools: محتويات ملفات، نتائج بحث، ردود API قرأها الـmodel مرة ولم يعد يحتاجها كاملة. الـcompaction (ضغط سياق المحادثة) يُبقي run كهذا تحت حد الـmodel على مرحلتين: أولاً يستبدل بنتائج الـtools القديمة علامة قصيرة، وإذا لم يكفِ ذلك يستبدل بأقدم الدورات ملخصًا يكتبه model (أرخص).

diff --git a/ar/comparison.mdx b/ar/comparison.mdx
@@ -2,6 +2,12 @@
 title: "مقارنة Lousho بغيرها"
 description: "تقارن هذه الصفحة Lousho بأربع مكتبات وكلاء أخرى مكتوبة بـ TypeScript: Vercel AI SDK (ToolLoopAgent)، وOpenAI Agents SDK للغة JavaScript، وMastra، وLangGraph.js. كل خانة تخص مشروعًا آخر مأخوذة من توثيقه الرسمي."
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/comparison).
+</Warning>
+
 {/* Generated from docs/comparison.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 آخر تحقق: 9 نوفمبر 2026. هذه المشاريع تتغير بسرعة، لذا قد تكون بعض الخانات قديمة.

diff --git a/ar/configuration.mdx b/ar/configuration.mdx
@@ -1,6 +1,12 @@
 ---
 title: "الإعدادات"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/configuration).
+</Warning>
+
 {/* Generated from docs/configuration.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 ## ملفات تعريف الـ agent (`AgentSpec`)

diff --git a/ar/connectors.mdx b/ar/connectors.mdx
@@ -1,6 +1,12 @@
 ---
 title: "الموصِّلات (Connectors)"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/connectors).
+</Warning>
+
 {/* Generated from docs/connectors.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 الـ connectors (الموصِّلات) هي طريقة الـ agent للوصول إلى خدمات خارجية، مثل Google Docs و Slack

diff --git a/ar/decisions.mdx b/ar/decisions.mdx
@@ -1,6 +1,12 @@
 ---
 title: "Decisions"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/decisions).
+</Warning>
+
 {/* Generated from docs/decisions.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 `decide()` يستدعي OpenAI Decisions API (`POST /v1/decisions`): endpoint مصمَّم لهذا الغرض، يقيّم input مشتركًا مقابل أسئلة typed ويرجّع إجابات معايَرة (calibrated) أسرع بحوالي 10 مرات من دورة model كاملة. هو الشكل السريع والحتمي لنمط القرار الـ typed، أي التصنيف والتوجيه والبوابات والتقييم بالدرجات، دون أن تشغّل run كاملًا لـ agent.

diff --git a/ar/deployment.mdx b/ar/deployment.mdx
@@ -1,6 +1,12 @@
 ---
 title: "النشر"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/deployment).
+</Warning>
+
 {/* Generated from docs/deployment.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 يأخذ `lousho build` ملف spec للـagent (راجع [الإعداد](/ar/configuration)) ويُخرج منه artifact جاهزًا للنشر على منصة واحدة:

diff --git a/ar/durable-execution.mdx b/ar/durable-execution.mdx
@@ -1,6 +1,12 @@
 ---
 title: "Durable execution"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/durable-execution).
+</Warning>
+
 {/* Generated from docs/durable-execution.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 مرّر `store` لـ`createAgent()` ومرّر `sessionId` لـ`send()`، فيستمر الـ run رغم crash، أو restart، أو abort، أو approval (موافقة) من إنسان تستغرق أيامًا. ولا شيء هنا يعتمد على host معيّن: أي `CheckpointStore` — `memoryStore()`، أو `SqliteStore`، أو store الـ Cloudflare KV الذي يوفّره build `cloudflare-worker`، أو تنفيذك الخاص بثلاث دوال — وأي `ApprovalStore` تعمل بالطريقة نفسها.

diff --git a/ar/errors.mdx b/ar/errors.mdx
@@ -3,6 +3,11 @@ title: "الأخطاء"
 description: "كل خطأ يرميه الـ SDK عن قصد هو SDKError بكود LOUSHO_* ثابت وتلميح ورابط لقسمه هنا؛ تسرد هذه الصفحة كل كود مع سببه وحلّه."
 ---
 
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/errors).
+</Warning>
+
 {/* Generated from docs/errors.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 تقريبًا كل خطأ يرميه الـ SDK عن قصد هو `SDKError` (أو subclass منه مثل `ConfigurationError` أو `ValidationError` أو `MissingPeerDependencyError`) وفيه:

diff --git a/ar/evals.mdx b/ar/evals.mdx
@@ -1,6 +1,12 @@
 ---
 title: "Evals"
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/evals).
+</Warning>
+
 {/* Generated from docs/evals.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 الـ evals هي regression tests لـ *سلوك* الـ agent: أي tools استدعى،

diff --git a/ar/examples/heal-benchmark.mdx b/ar/examples/heal-benchmark.mdx
@@ -3,6 +3,12 @@ title: "مقياس الإصلاح الذاتي (heal-benchmark)"
 sidebarTitle: "مقياس الإصلاح الذاتي"
 description: "طريقة قابلة للتكرار لمعرفة ما إذا كان تغيير في الـ harness الخاص بالـ agent قد ساعد. تشغّل أربعة agents على 28 مهمة وتُبلغ عن معدل النجاح والضجيج والـ tokens واستدعاءات الأدوات لكل نسخة من الـ harness."
 ---
+
+{/* pending-translation */}
+<Warning>
+لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ [النسخة الإنجليزية](/examples/heal-benchmark).
+</Warning>
+
 {/* Generated from examples/heal-benchmark/README.md in LinuxDevil/lousho by scripts/sync-sdk-docs.mjs. Do not edit here. */}
 
 | الـ agent | ما يختبره |