cc-viewer 1.6.182 → 1.6.183

package/concepts/ar/Tool-TaskStop.md

@@ -1,32 +1,45 @@
 # TaskStop
 
-## التعريف
+يوقف مهمة خلفية قيد التشغيل — أمر صدفة، أو وكيلاً مُرسلاً، أو جلسة بعيدة — عبر مقبضها التشغيلي. استخدمه لاستعادة الموارد، أو إلغاء عمل لم يعد مفيداً، أو التعافي عندما تكون المهمة عالقة.
 
-إيقاف مهمة خلفية قيد التشغيل.
+## متى يُستخدم
+
+- عندما يعمل أمر صدفة خلفي لفترة أطول من المتوقع ولم تعد تحتاج إلى نتيجته.
+- عندما يكون وكيل محلي في حلقة أو متوقفاً ويحتاج إلى القطع.
+- عندما يغير المستخدم الاتجاه وينبغي التخلي عن العمل الخلفي للاتجاه السابق.
+- عندما توشك جلسة بعيدة على انتهاء مهلتها أو تحتفظ بمورد تحتاجه.
+- عندما تحتاج إلى بداية نظيفة قبل بدء تشغيل جديد للمهمة نفسها.
+
+فضِّل ترك العمل الخلفي قصير العمر ينتهي من تلقاء نفسه. `TaskStop` للحالات التي لا يكون فيها التنفيذ المستمر ذا قيمة أو يكون ضاراً فعلاً.
 
 ## المعاملات
 
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `task_id` | string | لا | معرف المهمة الخلفية المراد إيقافها |
-| `shell_id` | string | لا | مهمل، استخدم `task_id` بدلاً منه |
+- `task_id` (سلسلة، مطلوب): المقبض التشغيلي المُعاد عند بدء المهمة الخلفية. هذا هو نفس المعرف الذي يقبله `TaskOutput`، وليس `taskId` في قائمة المهام.
 
-## سيناريوهات الاستخدام
+## أمثلة
 
-**مناسب للاستخدام:**
-- إنهاء المهام طويلة التشغيل التي لم تعد مطلوبة
-- إلغاء المهام الخلفية التي بدأت بالخطأ
+### مثال 1
 
-## ملاحظات
+أوقف أمر صدفة خلفياً متمرداً.
+
+```
+TaskStop(task_id: "bash_01HXYZ...")
+```
 
-- يُرجع حالة نجاح أو فشل
-- معامل `shell_id` مهمل، يجب استخدام `task_id`
+يتلقى الأمر إشارة إنهاء؛ وتبقى المخرجات المخزنة حتى الآن قابلة للقراءة في مسار مخرجاتها.
 
-## النص الأصلي
+### مثال 2
+
+ألغِ وكيلاً مُرسَلاً بعد تصحيح مسار من المستخدم.
+
+```
+TaskStop(task_id: "agent_01ABCD...")
+```
+
+## ملاحظات
 
-<textarea readonly>
-- Stops a running background task by its ID
-- Takes a task_id parameter identifying the task to stop
-- Returns a success or failure status
-- Use this tool when you need to terminate a long-running task
-</textarea>
+- `TaskStop` يطلب الإنهاء؛ ولا يضمن إيقاف التشغيل الفوري. تخرج المهام حسنة التصرف بسرعة، لكن عملية تُجري إدخال/إخراج حاجب قد تستغرق لحظة للاسترجاع.
+- إيقاف مهمة لا يحذف مخرجاتها. لمهام الصدفة الخلفية، يُحفظ ملف المخرجات على القرص ويظل قابلاً للقراءة بـ `Read`. للوكلاء والجلسات، يظل أي مخرج التُقط قبل الإيقاف متاحاً عبر `TaskOutput`.
+- `task_id` غير معروف، أو مهمة انتهت بالفعل، يُعيد خطأً أو عملية لا-ip. هذا آمن — يمكنك استدعاء `TaskStop` دفاعياً دون فحص الحالة أولاً.
+- إذا كنت تنوي إعادة تشغيل العمل نفسه، أوقف المهمة القديمة قبل إرسال الجديدة لتجنب تشغيلين متوازيين يتسابقان على موارد مشتركة (ملفات، منافذ، صفوف قاعدة بيانات).
+- `TaskStop` لا يؤثر على إدخالات في قائمة مهام الفريق. لإلغاء مهمة متعقَّبة، حدِّث حالتها إلى `deleted` بـ `TaskUpdate`.

package/concepts/ar/Tool-TaskUpdate.md

@@ -1,123 +1,70 @@
 # TaskUpdate
 
-## التعريف
+يُعدِّل مهمة موجودة — حالتها أو محتواها أو ملكيتها أو بياناتها الوصفية أو حواف تبعياتها. هكذا تتقدم المهام عبر دورة حياتها وكيف يُسلَّم العمل بين Claude Code وزملاء الفريق والوكلاء الفرعيين.
 
-تحديث حالة أو محتوى أو علاقات التبعية لمهمة معينة في قائمة المهام.
+## متى يُستخدم
 
-## المعاملات
-
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `taskId` | string | نعم | معرف المهمة المراد تحديثها |
-| `status` | enum | لا | الحالة الجديدة: `pending` / `in_progress` / `completed` / `deleted` |
-| `subject` | string | لا | العنوان الجديد |
-| `description` | string | لا | الوصف الجديد |
-| `activeForm` | string | لا | نص بصيغة المضارع المستمر يُعرض أثناء التنفيذ |
-| `owner` | string | لا | المسؤول الجديد عن المهمة (اسم agent) |
-| `metadata` | object | لا | بيانات وصفية للدمج (تعيين القيمة إلى null لحذف المفتاح) |
-| `addBlocks` | string[] | لا | قائمة معرفات المهام المحظورة بواسطة هذه المهمة |
-| `addBlockedBy` | string[] | لا | قائمة معرفات المهام السابقة التي تحظر هذه المهمة |
-
-## تدفق الحالات
-
-```
-pending → in_progress → completed
-```
-
-يمكن الانتقال إلى `deleted` من أي حالة، مما يزيل المهمة نهائياً.
-
-## سيناريوهات الاستخدام
-
-**مناسب للاستخدام:**
-- تعيين المهمة كـ `in_progress` عند بدء العمل
-- تعيين المهمة كـ `completed` بعد إنجاز العمل
-- تعيين علاقات التبعية بين المهام
-- تحديث محتوى المهمة عند تغيير المتطلبات
-
-**قواعد مهمة:**
-- لا تعيّن المهمة كـ `completed` إلا عند إنجازها بالكامل
-- عند مواجهة أخطاء أو عوائق، أبقِ الحالة `in_progress`
-- لا يجوز تعيين `completed` عند فشل الاختبارات أو عدم اكتمال التنفيذ أو وجود أخطاء غير محلولة
-
-## ملاحظات
-
-- قبل التحديث يجب الحصول على أحدث حالة للمهمة عبر TaskGet لتجنب البيانات القديمة
-- بعد إكمال المهمة استدعِ TaskList للبحث عن المهمة التالية المتاحة
+- نقل مهمة عبر سير عمل الحالة أثناء عملك عليها.
+- ادعاء مهمة بإسناد نفسك (أو وكيل آخر) بوصفك `owner`.
+- تحسين `subject` أو `description` بعد أن تتعلم المزيد عن المشكلة.
+- تسجيل تبعيات مُكتشفة حديثاً بـ `addBlocks` / `addBlockedBy`.
+- إرفاق `metadata` منظَّم مثل معرفات تذاكر خارجية أو تلميحات أولوية.
 
-## النص الأصلي
-
-<textarea readonly>Use this tool to update a task in the task list.
-
-## When to Use This Tool
-
-**Mark tasks as resolved:**
-- When you have completed the work described in a task
-- When a task is no longer needed or has been superseded
-- IMPORTANT: Always mark your assigned tasks as resolved when you finish them
-- After resolving, call TaskList to find your next task
-
-- ONLY mark a task as completed when you have FULLY accomplished it
-- If you encounter errors, blockers, or cannot finish, keep the task as in_progress
-- When blocked, create a new task describing what needs to be resolved
-- Never mark a task as completed if:
-  - Tests are failing
-  - Implementation is partial
-  - You encountered unresolved errors
-  - You couldn't find necessary files or dependencies
-
-**Delete tasks:**
-- When a task is no longer relevant or was created in error
-- Setting status to `deleted` permanently removes the task
+## المعاملات
 
-**Update task details:**
-- When requirements change or become clearer
-- When establishing dependencies between tasks
+- `taskId` (سلسلة، مطلوب): المهمة المراد تعديلها. احصل عليها من `TaskList` أو `TaskCreate`.
+- `status` (سلسلة، اختياري): واحدة من `pending` أو `in_progress` أو `completed` أو `deleted`.
+- `subject` (سلسلة، اختياري): عنوان أمري بديل.
+- `description` (سلسلة، اختياري): وصف مفصل بديل.
+- `activeForm` (سلسلة، اختياري): نص دوَّار بديل بصيغة المضارع المستمر.
+- `owner` (سلسلة، اختياري): مُعرِّف وكيل أو زميل فريق يتحمل المسؤولية عن المهمة.
+- `metadata` (كائن، اختياري): مفاتيح بيانات وصفية لدمجها في المهمة. اضبط مفتاحاً على `null` لحذفه.
+- `addBlocks` (مصفوفة سلاسل، اختياري): معرفات مهام تحجبها هذه المهمة.
+- `addBlockedBy` (مصفوفة سلاسل، اختياري): معرفات مهام يجب أن تكتمل قبل هذه.
 
-## Fields You Can Update
+## سير عمل الحالة
 
-- **status**: The task status (see Status Workflow below)
-- **subject**: Change the task title (imperative form, e.g., "Run tests")
-- **description**: Change the task description
-- **activeForm**: Present continuous form shown in spinner when in_progress (e.g., "Running tests")
-- **owner**: Change the task owner (agent name)
-- **metadata**: Merge metadata keys into the task (set a key to null to delete it)
-- **addBlocks**: Mark tasks that cannot start until this one completes
-- **addBlockedBy**: Mark tasks that must complete before this one can start
+دورة الحياة خطية عمداً: `pending` → `in_progress` → `completed`. `deleted` نهائية وتُستخدم لسحب مهام لن يُعمل عليها أبداً.
 
-## Status Workflow
+- اضبط `in_progress` في اللحظة التي تبدأ فيها العمل فعلاً، لا قبل ذلك. يجب أن تكون مهمة واحدة فقط `in_progress` في كل مرة لمالك معين.
+- اضبط `completed` فقط عندما يكتمل العمل تماماً — معايير القبول مُلبَّاة، الاختبارات ناجحة، المخرجات مكتوبة. إذا ظهر عائق، أبقِ المهمة `in_progress` وأضف مهمة جديدة تصف ما يجب حله.
+- لا تُعلِّم مهمة `completed` أبداً عندما تفشل الاختبارات، أو يكون التنفيذ جزئياً، أو واجهت أخطاء غير محلولة.
+- استخدم `deleted` للمهام المُلغاة أو المُكررة؛ لا تُعد توظيف مهمة لعمل غير مرتبط.
 
-Status progresses: `pending` → `in_progress` → `completed`
+## أمثلة
 
-Use `deleted` to permanently remove a task.
+### مثال 1
 
-## Staleness
+ادعِ مهمة وابدأها.
 
-Make sure to read a task's latest state using `TaskGet` before updating it.
+```
+TaskUpdate(
+  taskId: "t_01HXYZ...",
+  status: "in_progress",
+  owner: "main-agent"
+)
+```
 
-## Examples
+### مثال 2
 
-Mark task as in progress when starting work:
-```json
-{"taskId": "1", "status": "in_progress"}
-```
+أنهِ العمل وسجل تبعية متابعة.
 
-Mark task as completed after finishing work:
-```json
-{"taskId": "1", "status": "completed"}
 ```
-
-Delete a task:
-```json
-{"taskId": "1", "status": "deleted"}
+TaskUpdate(
+  taskId: "t_01HXYZ...",
+  status: "completed"
+)
+
+TaskUpdate(
+  taskId: "t_01FOLLOWUP...",
+  addBlockedBy: ["t_01HXYZ..."]
+)
 ```
 
-Claim a task by setting owner:
-```json
-{"taskId": "1", "owner": "my-name"}
-```
+## ملاحظات
 
-Set up task dependencies:
-```json
-{"taskId": "2", "addBlockedBy": ["1"]}
-```
-</textarea>
+- `metadata` يدمج مفتاحاً بمفتاح؛ تمرير `null` لمفتاح يُزيله. استدعِ `TaskGet` أولاً إن لم تكن متأكداً من المحتويات الحالية.
+- `addBlocks` و`addBlockedBy` تُلحق حوافاً؛ لا تُزيل الحواف الموجودة. تعديل الرسم البياني تدميرياً يتطلب سير عمل مخصصاً — استشر مالك الفريق قبل إعادة كتابة التبعيات.
+- أبقِ `activeForm` متزامناً عندما تُغير `subject` حتى يستمر نص الدوَّار في القراءة طبيعياً.
+- لا تُعلِّم مهمة `completed` لإسكاتها. إذا ألغى المستخدم العمل، فاستخدم `deleted` مع سبب موجز في `description`.
+- اقرأ أحدث حالة لمهمة بـ `TaskGet` قبل التحديث — قد يكون زملاء الفريق قد غيروها بين آخر قراءة وكتابتك.

package/concepts/ar/Tool-TeamCreate.md

@@ -1,38 +1,53 @@
 # TeamCreate
 
-## التعريف
+يُنشئ فريق تعاون جديداً بقائمة مهام مشتركة وقناة رسائل بين الوكلاء. الفريق هو الأصل التنسيقي للعمل متعدد الوكلاء — تعمل الجلسة الرئيسية بوصفها قائداً وتُطلق زملاء فريق مسمَّين عبر أداة `Agent`.
 
-ينشئ فريقاً جديداً لتنسيق عمل عدة agent معاً. تتيح الفرق التنفيذ المتوازي للمهام من خلال قائمة مهام مشتركة وتبادل الرسائل بين الـ agent.
+## متى يُستخدم
+
+- عندما يطلب المستخدم صراحةً فريقاً أو سرباً أو طاقماً أو تعاوناً متعدد الوكلاء.
+- عندما يحتوي مشروع على عدة مسارات عمل مستقلة بوضوح تستفيد من متخصصين مخصصين (مثل واجهة أمامية، خلفية، اختبارات، توثيق).
+- عندما تحتاج إلى قائمة مهام مشتركة دائمة يُحدّثها عدة وكلاء مع تقدمهم.
+- عندما تريد زملاء فريق مسمَّين وقابلين للعنونة يمكنهم تبادل الرسائل عبر `SendMessage` بدلاً من استدعاءات وكيل فرعي ذات لقطة واحدة.
+
+لا تستخدمه لبحث مُفوَّض واحد أو تفرُّع موازٍ لمرة واحدة — استدعاءات `Agent` العادية أخف وكافية.
 
 ## المعاملات
 
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `team_name` | string | نعم | اسم الفريق الجديد |
-| `description` | string | لا | وصف الفريق / الغرض منه |
-| `agent_type` | string | لا | نوع / دور قائد الفريق |
+- `team_name` (سلسلة، مطلوب): معرف فريد للفريق. يُستخدم كاسم دليل تحت `~/.claude/teams/` وكوسيطة `team_name` عند إطلاق زملاء الفريق.
+- `description` (سلسلة، مطلوب): بيان قصير لهدف الفريق. يُعرض على كل زميل فريق عند الإطلاق ويُكتب في إعداد الفريق.
+- `agent_type` (سلسلة، اختياري): شخصية الوكيل الفرعي الافتراضية المطبقة على زملاء الفريق الذين لا يتجاوزونها. القيم النموذجية هي `general-purpose` أو `Explore` أو `Plan`.
+
+## أمثلة
+
+### مثال 1: إنشاء فريق إعادة هيكلة
 
-## ما يتم إنشاؤه
+```
+TeamCreate(
+  team_name="refactor-crew",
+  description="Refactor the data access layer from raw SQL to Prisma, including migrations and tests.",
+  agent_type="general-purpose"
+)
+```
 
-- **ملف إعداد الفريق**: `~/.claude/teams/{team-name}/config.json` — يخزن قائمة الأعضاء والبيانات الوصفية
-- **دليل قائمة المهام**: `~/.claude/tasks/{team-name}/` — قائمة المهام المشتركة لجميع أعضاء الفريق
+بعد الإنشاء، أطلق زملاء فريق بـ `Agent` باستخدام `team_name: "refactor-crew"` وقيم `name` متميزة مثل `db-lead` و`migrations` و`tests`.
 
-يوجد تطابق 1:1 بين الفرق وقوائم المهام.
+### مثال 2: إنشاء فريق تحقيق
 
-## سير عمل الفريق
+```
+TeamCreate(
+  team_name="perf-investigation",
+  description="Identify and rank the top three performance regressions introduced in the last release.",
+  agent_type="Explore"
+)
+```
 
-1. **TeamCreate** — إنشاء الفريق وقائمة مهامه
-2. **TaskCreate** — تحديد المهام للفريق
-3. **Agent** (مع `team_name` + `name`) — توليد أعضاء ينضمون إلى الفريق
-4. **TaskUpdate** — تعيين المهام للأعضاء عبر `owner`
-5. يعمل الأعضاء على المهام ويتواصلون عبر **SendMessage**
-6. إيقاف تشغيل الأعضاء عند الانتهاء، ثم **TeamDelete** لتنظيف الموارد
+يرث كل زميل فريق مُطلق `Explore` بوصفه شخصيته الافتراضية، بما يتوافق مع الطبيعة التحقيقية للقراءة فقط للعمل.
 
-## الأدوات ذات الصلة
+## ملاحظات
 
-| الأداة | الغرض |
-|--------|--------|
-| `TeamDelete` | حذف الفريق ومجلدات المهام |
-| `SendMessage` | التواصل بين الـ agent داخل الفريق |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | إدارة قائمة المهام المشتركة |
-| `Agent` | توليد أعضاء ينضمون إلى الفريق |
+- يمكن قيادة فريق واحد فقط في كل مرة من جلسة معينة. أنهِ أو احذف الفريق الحالي قبل إنشاء آخر.
+- الفريق 1:1 مع قائمة مهام مشتركة. يمتلك القائد إنشاء المهام وتعيينها وإغلاقها؛ بينما يُحدِّث زملاء الفريق حالة المهام التي يعملون عليها.
+- يُستمر إعداد الفريق في `~/.claude/teams/{team_name}/config.json`، ويعيش دليل المهام بجواره. هذه الملفات تبقى عبر الجلسات حتى تُزال صراحةً بـ `TeamDelete`.
+- يُطلق زملاء الفريق باستخدام أداة `Agent` مع `team_name` مطابق بالإضافة إلى `name` متميز. يصبح `name` هو العنوان المستخدم بواسطة `SendMessage`.
+- اختر `team_name` آمناً لنظام الملفات (أحرف وأرقام وشرطات وشرطات سفلية). تجنب المسافات أو الشرطات المائلة.
+- اكتب `description` بحيث يُفهم زميل فريق جديد، يقرؤه بدون سياق، هدف الفريق دون مزيد من السياق. يصبح جزءاً من موجه بدء كل زميل فريق.

package/concepts/ar/Tool-TeamDelete.md

@@ -1,30 +1,44 @@
 # TeamDelete
 
-## التعريف
+يُفكك الفريق النشط حالياً، ويُزيل دليل إعداده ودليل المهام المشترك. هذا هو نظير التنظيف لـ `TeamCreate` ويُستدعى عادة بعد تحقيق هدف الفريق وإيقاف جميع زملاء الفريق.
 
-يحذف فريقاً ومجلدات المهام المرتبطة به عند اكتمال عمل التعاون متعدد الـ agent. يُعدّ هذا الأداة المقابلة لـ TeamCreate في مرحلة التنظيف.
+## متى يُستخدم
 
-## السلوك
+- عندما يكمل الفريق عمله ويُسلَّم التقرير النهائي للمستخدم.
+- عندما أُنشئ الفريق عن طريق الخطأ أو تغير نطاقه بشكل جذري بحيث يكون البدء من جديد أنظف من المتابعة.
+- عندما تحتاج إلى إنشاء فريق جديد لكن واحداً نشط بالفعل — احذف القديم أولاً، لأنه يمكن قيادة فريق واحد فقط في كل مرة.
+- عندما يصبح فريق راكداً عبر الجلسات ولا تعود حالته المستمرة تحت `~/.claude/teams/` مطلوبة.
 
-- يحذف مجلد الفريق: `~/.claude/teams/{team-name}/`
-- يحذف مجلد المهام: `~/.claude/tasks/{team-name}/`
-- يمسح سياق الفريق من الجلسة الحالية
+لا تستدعِه بينما لا يزال زملاء الفريق يعملون — أوقفهم أولاً عبر `SendMessage` بـ `shutdown_request`، وانتظر كل `shutdown_response`، ثم احذف.
 
-**مهم**: سيفشل TeamDelete إذا كان الفريق لا يزال يضم أعضاء نشطين. يجب إيقاف تشغيل الأعضاء أولاً بشكل سلس عبر طلبات إيقاف التشغيل في SendMessage.
+## المعاملات
 
-## الاستخدام النموذجي
+`TeamDelete` لا يأخذ معاملات في استدعائه النموذجي. يعمل على الفريق النشط حالياً الذي تملكه الجلسة المُستدعية.
 
-يُستدعى TeamDelete في نهاية سير عمل الفريق:
+## أمثلة
 
-1. اكتمال جميع المهام
-2. إيقاف تشغيل الأعضاء عبر `SendMessage` مع `shutdown_request`
-3. **TeamDelete** يحذف مجلدات الفريق والمهام
+### مثال 1: إيقاف تشغيل روتيني بعد النجاح
 
-## الأدوات ذات الصلة
+1. بث طلب إيقاف تشغيل للفريق:
+   ```
+   SendMessage(to="*", message={ "type": "shutdown_request" })
+   ```
+2. انتظر رد كل زميل فريق بـ `shutdown_response`.
+3. استدعِ `TeamDelete()` لإزالة دليل الفريق ودليل المهام.
 
-| الأداة | الغرض |
-|--------|--------|
-| `TeamCreate` | إنشاء فريق جديد وقائمة مهامه |
-| `SendMessage` | التواصل مع الأعضاء / إرسال طلبات إيقاف التشغيل |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | إدارة قائمة المهام المشتركة |
-| `Agent` | توليد أعضاء ينضمون إلى الفريق |
+### مثال 2: استبدال فريق معدّ بشكل خاطئ
+
+إذا استُدعي `TeamCreate` بـ `agent_type` أو `description` خاطئ، تأكد أولاً من عدم إطلاق أي زملاء فريق بعد (أو أوقفهم)، ثم:
+
+```
+TeamDelete()
+TeamCreate(team_name="...", description="...", agent_type="...")
+```
+
+## ملاحظات
+
+- يفشل `TeamDelete` إذا كان أي زميل فريق لا يزال نشطاً. تسرد استجابة الخطأ زملاء الفريق الأحياء — أرسل لكل منهم `shutdown_request` عبر `SendMessage`، وانتظر `shutdown_response` الخاص بهم، وأعد المحاولة.
+- الحذف لا يمكن التراجع عنه من منظور الأداة. إعداد الفريق في `~/.claude/teams/{team_name}/config.json` ودليل مهامه يُزالان من القرص. إذا احتجت إلى الحفاظ على قائمة المهام، فصدِّرها أو انسخ الدليل قبل الحذف.
+- فقط جلسة القائد التي أنشأت الفريق يمكنها حذفه. لا يمكن لزميل فريق مُطلق أن يستدعي `TeamDelete` على فريقه الخاص.
+- حذف الفريق لا يتراجع عن أي تغييرات في نظام الملفات أجراها زملاء الفريق في المستودع. تلك تعديلات عادية متعقَّبة بـ git ويجب التراجع عنها بشكل منفصل إذا لم تكن مرغوبة.
+- بعد عودة `TeamDelete` بنجاح، تكون الجلسة حرة في استدعاء `TeamCreate` مرة أخرى لفريق جديد.

package/concepts/ar/Tool-WebFetch.md

@@ -1,55 +1,50 @@
 # WebFetch
 
-## التعريف
+يسترجع محتويات صفحة ويب عامة، ويحول HTML إلى Markdown، ويُشغِّل نموذجاً مساعداً صغيراً على النتيجة باستخدام موجه بلغة طبيعية لاستخراج المعلومات التي تحتاجها.
 
-جلب محتوى صفحة ويب من عنوان URL محدد، وتحويل HTML إلى markdown، ومعالجة المحتوى باستخدام نموذج ذكاء اصطناعي وفقاً للـ prompt.
+## متى يُستخدم
+
+- قراءة صفحة توثيق عامة أو منشور مدونة أو RFC مُشار إليه في المحادثة.
+- استخراج حقيقة محددة أو مقتطف شفرة أو جدول من URL معروف دون تحميل الصفحة كاملة في السياق.
+- تلخيص ملاحظات الإصدار أو سجلات التغييرات من مورد ويب مفتوح.
+- التحقق من مرجع API العام لمكتبة عندما لا يكون المصدر في المستودع المحلي.
+- اتباع رابط لصقه المستخدم في المحادثة للإجابة عن سؤال متابعة.
 
 ## المعاملات
 
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `url` | string (URI) | نعم | عنوان URL الكامل المراد جلبه |
-| `prompt` | string | نعم | وصف المعلومات المراد استخلاصها من الصفحة |
+- `url` (سلسلة، مطلوب): URL مطلق مُشكَّل بالكامل. يُرقى `http://` العادي تلقائياً إلى `https://`.
+- `prompt` (سلسلة، مطلوب): التعليمة المُمرَّرة إلى نموذج الاستخراج الصغير. صف بدقة ما يُستخرج من الصفحة، مثل «list all exported functions» أو «return the minimum supported Node version».
+
+## أمثلة
+
+### مثال 1: استخراج افتراض إعداد
+
+```
+WebFetch(
+  url="https://vitejs.dev/config/server-options.html",
+  prompt="What is the default value of server.port and can it be a string?"
+)
+```
+
+تجلب الأداة صفحة توثيق Vite، وتحولها إلى Markdown، وتُعيد إجابة موجزة مثل "Default is `5173`; accepts a number only."
 
-## سيناريوهات الاستخدام
+### مثال 2: تلخيص قسم سجل تغييرات
 
-**مناسب للاستخدام:**
-- الحصول على محتوى صفحات الويب العامة
-- الاطلاع على التوثيق عبر الإنترنت
-- استخلاص معلومات محددة من صفحات الويب
+```
+WebFetch(
+  url="https://nodejs.org/en/blog/release/v20.11.0",
+  prompt="List the security fixes included in this release as bullet points."
+)
+```
 
-**غير مناسب للاستخدام:**
-- عناوين URL التي تتطلب مصادقة (Google Docs، Confluence، Jira، GitHub إلخ) — يجب البحث أولاً عن أداة MCP مخصصة
-- عناوين GitHub URL — يُفضل استخدام `gh` CLI
+مفيد عندما يسأل المستخدم «ما الذي تغير في Node 20.11» وصفحة الإصدار طويلة.
 
 ## ملاحظات
 
-- يجب أن يكون URL كاملاً وصالحاً
-- يتم ترقية HTTP تلقائياً إلى HTTPS
-- قد يتم تلخيص النتائج عندما يكون المحتوى كبيراً جداً
-- يتضمن ذاكرة مؤقتة ذاتية التنظيف مدتها 15 دقيقة
-- عند إعادة توجيه URL إلى مضيف مختلف، تُرجع الأداة عنوان URL المُعاد توجيهه ويجب إعادة الطلب بالعنوان الجديد
-- إذا كانت أداة web fetch مقدمة من MCP متاحة، يُفضل استخدامها
-
-## النص الأصلي
-
-<textarea readonly>IMPORTANT: WebFetch WILL FAIL for authenticated or private URLs. Before using this tool, check if the URL points to an authenticated service (e.g. Google Docs, Confluence, Jira, GitHub). If so, you MUST use ToolSearch first to find a specialized tool that provides authenticated access.
-
-- Fetches content from a specified URL and processes it using an AI model
-- Takes a URL and a prompt as input
-- Fetches the URL content, converts HTML to markdown
-- Processes the content with the prompt using a small, fast model
-- Returns the model's response about the content
-- Use this tool when you need to retrieve and analyze web content
-
-Usage notes:
-  - IMPORTANT: If an MCP-provided web fetch tool is available, prefer using that tool instead of this one, as it may have fewer restrictions.
-  - The URL must be a fully-formed valid URL
-  - HTTP URLs will be automatically upgraded to HTTPS
-  - The prompt should describe what information you want to extract from the page
-  - This tool is read-only and does not modify any files
-  - Results may be summarized if the content is very large
-  - Includes a self-cleaning 15-minute cache for faster responses when repeatedly accessing the same URL
-  - When a URL redirects to a different host, the tool will inform you and provide the redirect URL in a special format. You should then make a new WebFetch request with the redirect URL to fetch the content.
-  - For GitHub URLs, prefer using the gh CLI via Bash instead (e.g., gh pr view, gh issue view, gh api).
-</textarea>
+- `WebFetch` يفشل على أي URL يتطلب مصادقة أو ملفات تعريف ارتباط أو VPN. لـ Google Docs أو Confluence أو Jira أو موارد GitHub الخاصة أو الويكيات الداخلية، استخدم خادم MCP مخصصاً يوفر وصولاً مصادقاً عليه بدلاً من ذلك.
+- لأي شيء مستضاف على GitHub (PRs، issues، ملفات blob، استجابات API)، فضِّل CLI `gh` عبر `Bash` على كشط واجهة الويب. `gh pr view` و`gh issue view` و`gh api` تُعيد بيانات منظمة وتعمل ضد المستودعات الخاصة.
+- قد تُلخَّص النتائج عندما تكون الصفحة المجلوبة كبيرة جداً. إذا كنت بحاجة إلى نص دقيق، ضيِّق `prompt` ليطلب استخراجاً حرفياً.
+- يُطبَّق كاش ذاتي التنظيف لمدة 15 دقيقة لكل URL. الاستدعاءات المتكررة لنفس الصفحة خلال جلسة واحدة تكون شبه فورية لكن قد تُعيد محتوى قديماً قليلاً. إذا كانت الحداثة مهمة، اذكر ذلك في الموجه أو انتظر الكاش.
+- إذا أصدر المضيف المستهدف إعادة توجيه عبر المضيفين، تُعيد الأداة URL الجديد في كتلة استجابة خاصة ولا تتبعه تلقائياً. استدعِ `WebFetch` مرة أخرى بهدف إعادة التوجيه إذا كنت لا تزال تريد المحتوى.
+- يُنفذ الموجه نموذج أصغر وأسرع من المساعد الرئيسي. أبقِه ضيقاً ومحدداً؛ يُعالَج الاستدلال المعقد متعدد الخطوات أفضل بقراءة Markdown الخام بنفسك بعد الجلب.
+- لا تمرر أبداً أسراراً أو رموزاً أو معرفات جلسة مضمنة في URL — قد تُسجل محتويات الصفحة وسلاسل الاستعلام المنعكسة في المخرجات بواسطة الخدمات الأعلى.

package/concepts/ar/Tool-WebSearch.md

@@ -1,58 +1,51 @@
 # WebSearch
 
-## التعريف
+يُنفِّذ بحث ويب حياً ويُعيد نتائج مرتبة يستخدمها المساعد لدعم إجابته بمعلومات حديثة تتجاوز تاريخ تدريب النموذج.
 
-تنفيذ استعلامات محرك البحث، وإرجاع نتائج البحث للحصول على أحدث المعلومات.
+## متى يُستخدم
+
+- الإجابة عن أسئلة حول الأحداث الجارية أو الإصدارات الحديثة أو الأخبار العاجلة.
+- البحث عن أحدث إصدار لمكتبة أو إطار عمل أو أداة CLI.
+- العثور على توثيق أو منشورات مدونة عندما يكون URL الدقيق غير معروف.
+- التحقق من حقيقة قد تكون تغيرت منذ تدريب النموذج.
+- اكتشاف عدة وجهات نظر حول موضوع قبل جلب أي صفحة واحدة بـ `WebFetch`.
 
 ## المعاملات
 
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `query` | string | نعم | استعلام البحث (حرفان على الأقل) |
-| `allowed_domains` | string[] | لا | تضمين نتائج من هذه النطاقات فقط |
-| `blocked_domains` | string[] | لا | استبعاد نتائج من هذه النطاقات |
+- `query` (سلسلة، مطلوب): استعلام البحث. الحد الأدنى للطول حرفان. أدرج السنة الحالية عند السؤال عن المعلومات «الأحدث» أو «الأخيرة» حتى تكون النتائج حديثة.
+- `allowed_domains` (مصفوفة سلاسل، اختياري): يقصر النتائج على هذه النطاقات فقط، مثل `["nodejs.org", "developer.mozilla.org"]`. مفيد عندما تثق بمصدر محدد.
+- `blocked_domains` (مصفوفة سلاسل، اختياري): يستبعد النتائج من هذه النطاقات. لا تمرر النطاق نفسه لكل من `allowed_domains` و`blocked_domains`.
+
+## أمثلة
+
+### مثال 1: بحث عن إصدار مع السنة الحالية
+
+```
+WebSearch(
+  query="React 19 stable release date 2026",
+  allowed_domains=["react.dev", "github.com"]
+)
+```
+
+يُعيد الإعلانات الرسمية ويتجنب المواقع المجمِّعة منخفضة الجودة.
+
+### مثال 2: استبعاد مصادر مزعجة
 
-## سيناريوهات الاستخدام
+```
+WebSearch(
+  query="kubernetes ingress-nginx CVE April 2026",
+  blocked_domains=["pinterest.com", "medium.com"]
+)
+```
 
-**مناسب للاستخدام:**
-- الحصول على أحدث المعلومات التي تتجاوز تاريخ قطع معرفة النموذج
-- البحث عن الأحداث الجارية وأحدث البيانات
-- البحث عن أحدث التوثيق التقني
+يُبقي النتائج مركزة على إرشادات الموردين ومتتبعي الأمان.
 
 ## ملاحظات
 
-- تُرجع نتائج البحث بتنسيق روابط markdown
-- بعد الاستخدام يجب إضافة قسم "Sources:" في نهاية الاستجابة مع قائمة عناوين URL ذات الصلة
-- يدعم تصفية النطاقات (تضمين/استبعاد)
-- يجب استخدام السنة الحالية في استعلامات البحث
-- متاح فقط في الولايات المتحدة
-
-## النص الأصلي
-
-<textarea readonly>
-- Allows Claude to search the web and use the results to inform responses
-- Provides up-to-date information for current events and recent data
-- Returns search result information formatted as search result blocks, including links as markdown hyperlinks
-- Use this tool for accessing information beyond Claude's knowledge cutoff
-- Searches are performed automatically within a single API call
-
-CRITICAL REQUIREMENT - You MUST follow this:
-  - After answering the user's question, you MUST include a "Sources:" section at the end of your response
-  - In the Sources section, list all relevant URLs from the search results as markdown hyperlinks: [Title](URL)
-  - This is MANDATORY - never skip including sources in your response
-  - Example format:
-
-    [Your answer here]
-
-    Sources:
-    - [Source Title 1](https://example.com/1)
-    - [Source Title 2](https://example.com/2)
-
-Usage notes:
-  - Domain filtering is supported to include or block specific websites
-  - Web search is only available in the US
-
-IMPORTANT - Use the correct year in search queries:
-  - The current month is March 2026. You MUST use this year when searching for recent information, documentation, or current events.
-  - Example: If the user asks for "latest React docs", search for "React documentation" with the current year, NOT last year
-</textarea>
+- عند استخدام `WebSearch` في إجابة، يجب إلحاق قسم `Sources:` في نهاية ردك يسرد كل نتيجة مذكورة كرابط Markdown بالصيغة `[Title](URL)`. هذا متطلب صارم وليس اختيارياً.
+- `WebSearch` متاح فقط للمستخدمين في الولايات المتحدة. إذا كانت الأداة غير متاحة في منطقتك، فارجع إلى `WebFetch` مقابل URL معروف أو اطلب من المستخدم لصق محتوى ذي صلة.
+- ينفذ كل استدعاء البحث في رحلة واحدة — لا يمكنك التدفق أو التصفح. حسِّن الاستعلام إذا كانت مجموعة النتائج الأولى بعيدة عن الهدف.
+- تُعيد الأداة مقتطفات وبيانات وصفية، لا محتويات الصفحة الكاملة. لقراءة نتيجة محددة بعمق، تابع بـ `WebFetch` باستخدام URL المُعاد.
+- استخدم `allowed_domains` لفرض مصادر موثوقة للأسئلة الأمنية الحساسة مثل CVEs أو الامتثال، و`blocked_domains` لقطع مزارع SEO التي تعكس التوثيق.
+- أبقِ الاستعلامات قصيرة ومُوجَّهة بالكلمات الرئيسية. الأسئلة باللغة الطبيعية تعمل لكنها تميل إلى إرجاع إجابات محادثة بدلاً من مصادر أولية.
+- لا تخترع URLs بناءً على حدس البحث — شغِّل البحث دائماً واستشهد بما أعادته الأداة فعلاً.