web-agent-bridge 2.3.1 → 2.5.0

package/README.ar.md

@@ -9,6 +9,8 @@
 
 **برمجية وسيطة مفتوحة المصدر تربط وكلاء الذكاء الاصطناعي بالمواقع الإلكترونية — توفر واجهة أوامر موحدة للأتمتة الذكية.**
 
+🌐 **الموقع الرسمي:** [https://webagentbridge.com](https://webagentbridge.com) — جرّب مساحة عمل الوكيل الذكي ولوحات التحكم والعديد من الميزات الأخرى مباشرة.
+
 يتيح WAB لأصحاب المواقع إضافة سكريبت يكشف واجهة `window.AICommands` لوكلاء الذكاء الاصطناعي. بدلاً من تحليل شيفرة HTML المعقدة، يقرأ الوكيل قائمة الإجراءات المتاحة وينفذها بدقة وأمان.
 
 **[English Documentation](README.md)** | **العربية**
@@ -32,24 +34,60 @@
 - **وضع التخفي** — محاكاة سلوك بشري (حركة فأرة، كتابة طبيعية، تمرير تدريجي)
 - **قواعد بيانات متعددة** — SQLite + PostgreSQL + MySQL عبر محوّلات قابلة للتبديل
 - **SDK للوكلاء** — حزمة أدوات جاهزة لبناء وكلاء ذكاء اصطناعي
+- **بنية الإضافات** — نظام إضافات ديناميكي مع تنفيذ قائم على الخطافات، تثبيت لكل موقع، ترتيب أولويات، تقييمات، وتدقيق
+- **خدمة الرؤية** — تحليل لقطات شاشة متعدد الموفرين (Moondream محلي، OpenAI، Anthropic، Ollama) مع كشف العناصر التفاعلية وتشفير AES-256-GCM
+- **محرك العدالة** — طبقة حياد تضمن فرصة متساوية للمواقع الصغيرة والكبيرة مع بحث مرجح بالعدالة وتتبع شفافية العمولات
+- **ذاكرة الوكيل** — ذاكرة سلوكية دائمة مع ٤ أنواع ذاكرة، ٥ فئات، ارتباطات دلالية، تقييم الأهمية، وانتهاء صلاحية مؤقت
+- **تحليل حركة المرور المتقدم** — كشف أكثر من ٣٠ نوع بوت، تحليل سلوكي، كشف شذوذ، كشف استغلالات أمنية (SQL injection، XSS)
+- **خدمة البريد الإلكتروني** — بريد SMTP (ترحيب، تسجيل، إعادة تعيين كلمة المرور) مع قوالب HTML
+- **تتبع بدون JavaScript** — نقطة بكسل تتبع ١×١ لجمع التحليلات عند عدم توفر JavaScript
+- **محول WAB-MCP** — كشف قدرات مواقع WAB كأدوات MCP لـ Claude وGPT وGemini والوكلاء المتوافقة
+- **إضافة WordPress** — إضافة WordPress أصلية مع صفحة إعدادات، صناديق وصف لكل صفحة، توليد مستند اكتشاف، وعنصر لوحة تحكم
+- **متصفح WAB (سطح المكتب)** — متصفح Electron مستقل مع حاجب إعلانات مدمج (٨٠+ نطاق)، درع الاحتيال، تصنيف عدالة، دردشة وكيل، إشارات، سجل
+- **متصفح PWA (الهاتف)** — تطبيق ويب تقدمي لـ Android/iOS مع حجب إعلانات، بحث DuckDuckGo، كشف احتيال، تصفية شركات التقنية الكبرى
+- **SDK اكتشاف المخططات** — استخراج JSON-LD schema.org من جانب الخادم مع توليد تلميحات إجراءات WAB تلقائياً
 
 ### الإصدار 2.0 — ميزات الحصن الرقمي
 
-- **محرك التفاوض اللحظي** — يتفاوض وكيل الذكاء الاصطناعي على الأسعار مباشرة مع المواقع عبر جلسات متعددة الجولات، ٨ أنواع شروط، و٤ أنواع خصومات
-- **درع مقاومة التزييف** — محرك تحقق متقاطع يقارن DOM مع لقطات الشاشة، يتحقق من الأسعار مقابل المعايير السوقية، يفحص الاتساق الزمني، ويقيس تشابه النصوص
-- **نظام السمعة اللامركزي** — شهادات ثقة مشفرة من شبكة الوكلاء مع تقييم مرجح، مستويات ثقة (ناشئ ← موثق ← نموذجي)، ولوحة متصدرين عالمية
-- **لوحة السيادة** — مركز قيادة لحظي يعرض رادار العدالة، درع الخصوصية، سجل التفاوض، فحوصات التحقق، ومبدّل نماذج الذكاء الاصطناعي
+- **محرك التفاوض اللحظي** — يتفاوض وكيل الذكاء الاصطناعي على الأسعار مباشرة مع المواقع عبر جلسات متعددة الجولات. ٨ أنواع شروط (كميات، ولاء، وقت، أول شراء، قيمة سلة، موسمية، عضوية، إحالة) و٤ أنواع خصومات (نسبة، مبلغ ثابت، شحن مجاني، هدية). يشمل حدود يومية وقيم حد أدنى وسجل كامل
+- **درع مقاومة التزييف** — محرك تحقق متقاطع يقارن DOM مع لقطات الشاشة، يتحقق من الأسعار مقابل المعايير السوقية، يفحص الاتساق الزمني، ويقيس تشابه النصوص. ٤ مستويات خطورة (بسيط ← احتيال) و٥ إجراءات استجابة (تحذير، إيقاف، تأكيد بشري، تصحيح تلقائي، حظر)
+- **نظام السمعة اللامركزي** — شهادات ثقة موقعة بـ HMAC من شبكة الوكلاء تغطي ٦ أنواع شهادات (شراء، حجز، استعلام، نموذج، تنقل، تحقق). ٧ مستويات ثقة (مجهول ← محظور)، اضمحلال زمني، مقاومة Sybil، لوحة متصدرين عالمية، ونظام طعن/نزاع
+- **لوحة السيادة** — مركز قيادة لحظي يعرض رادار العدالة، درع الخصوصية، سجل التفاوض، فحوصات التحقق، ومبدّل نماذج الذكاء الاصطناعي. يكشف نقطة `/api/sovereign/dashboard/sovereign` للبيانات المجمعة
 - **متجر قوالب الوكلاء** — ١١ قالب YAML جاهز (حجز فنادق، مقارنة بقالة، سوق حرفيين، صفقات طيران، إلخ) مع تشغيل من سطر الأوامر: `npx wab-agent run template.yaml`
-- **تبديل عقل الوكيل** — بدّل بين Llama 3، GPT-4، Claude، Gemini، Mistral، أو Ollama (محلي) بدون إعادة إعداد
+- **تبديل عقل الوكيل** — نظام تشغيل AI محلي يكتشف Ollama وllama.cpp تلقائياً مع دعم APIs متوافقة مع OpenAI. تتبع قدرات النماذج (نص/رؤية)، إدارة نوافذ السياق، توجيه حسب زمن الاستجابة، وتسجيل الاستدلال
 - **تنسيق الوكيل عبر المواقع** — وكيل واحد يدير عدة مواقع WAB في نفس الوقت عبر `WABMultiAgent`. قارن الأسعار بين المتاجر، اجمع البيانات، نفّذ إجراءات متوازية، واعثر على أفضل صفقة تلقائياً
 
 ### الإصدار 2.3 — شبكة الوكلاء الخاصة (العقل الموزّع)
 
-- **بروتوكول التواصل بين الوكلاء** — الوكلاء يتواصلون عبر شبكة خاصة مع ٥ قنوات مدمجة (تنبيهات، اكتشافات، تكتيكات، مفاوضات، تصويت). مشاركة المعرفة في الوقت الفعلي مع تقييم الثقة ورسائل منتهية الصلاحية تلقائياً
-- **التعلم المعزز المحلي** — الوكلاء يتعلمون من كل قرار للمستخدم باستخدام خوارزمية UCB1 متعددة الأذرع، تحديث السياسات بالنزول التدريجي، واستخراج أنماط السلوك. بدون أي مكالمات API خارجية — التعلم بالكامل محلي
-- **منسق السيمفونية** — أربعة وكلاء متخصصين (باحث، محلل، مفاوض، حارس) يتعاونون ذاتياً عبر محركات قائمة على القواعد. ٥ قوالب، خط أنابيب من ٦ مراحل، حق نقض الحارس للقرارات الأمنية، إجماع مرجح. بدون أي اعتماد على نماذج LLM خارجية
+- **بروتوكول التواصل بين الوكلاء** — الوكلاء يتواصلون عبر شبكة خاصة مع ٥ قنوات مدمجة (تنبيهات، اكتشافات، تكتيكات، مفاوضات، تصويت). ٦ أنواع رسائل مع تقييم الثقة، إزالة الوكلاء الخاملين تلقائياً عبر نبضات القلب، تحقق الأقران من المعرفة المشتركة. كل الاتصال يبقى محلياً
+- **التعلم المعزز المحلي** — الوكلاء يتعلمون من كل قرار للمستخدم باستخدام خوارزمية UCB1 متعددة الأذرع، تحديث السياسات بالنزول التدريجي مع تنشيط sigmoid، تخفيض زمني، واستخراج الأنماط المتسلسلة. بدون أي مكالمات API خارجية — التعلم بالكامل محلي
+- **منسق السيمفونية** — أربعة وكلاء متخصصين (باحث، محلل، مفاوض، حارس) يتعاونون ذاتياً عبر محركات قائمة على القواعد. ٥ قوالب، خط أنابيب من ٦ مراحل (تحليل ← بحث ← تفاوض ← حراسة ← تركيب ← قرار)، حق نقض الحارس للأمان، إجماع مرجح. تسجيل كامل للمراحل مع تتبع المدة. بدون أي اعتماد على LLM خارجية
 - **لوحة شبكة الوكلاء** — عرض مباشر لشبكة الوكلاء: الوكلاء النشطون، قنوات الاتصال، قاعدة المعرفة المشتركة، تركيبات السيمفونية، ومقاييس أداء التعلم
 
+### الإصدار 2.4 — القائد والذكاء على الحافة
+
+- **نظام القائد (Commander)** — محرك تنسيق مهام محلي يفكك الأهداف العليا إلى رسوم بيانية مهام (DAG). سجل وكلاء مع تتبع القدرات، محرك تنفيذ متوازٍ، تكامل تعلم لتغذية راجعة من النتائج، وتنسيق حوسبة طرفية
+- **نظام الحوسبة الطرفية (Edge Compute)** — يحول كل جهاز مستخدم إلى عقدة AI سيادية. تحليل المعدات (CPU, RAM, GPU)، تشفير AES-256-GCM بين العقد، موازنة حمل مرجحة، مراقبة صحة بنبضات القلب مع تجاوز فشل تلقائي، وتشكيل أسراب حسب القدرات
+- **محرك التنفيذ بالسرب** — إطلاق عدة وكلاء بالتوازي لحل مهمة واحدة. استراتيجيات قابلة للتكوين (متوازي، متسلسل، هجين)، دمج النتائج بأفضل درجة، تخصص بالأدوار، تجميع مرجح بالعدالة، وتقييم ثقة لكل وكيل
+
+### الإصدار 3.0 — نظام تشغيل الوكلاء (طبقة التنفيذ للويب)
+
+الإصدار 3.0 يحوّل WAB من أداة أتمتة متقدمة إلى **نظام تشغيل حقيقي للوكلاء** — طبقة تنفيذ كاملة لوكلاء الذكاء الاصطناعي على الويب، منافس لـ MCP لكنه مصمم خصيصاً للتفاعل مع المتصفح.
+
+- **بروتوكول WAB (WABP) v1.0.0** — بروتوكول رسمي مع سجل أوامر JSON Schema، رسائل مُنمطة، التحقق من المدخلات/المخرجات، وتعريفات أوامر مُنسّخة. ١٠ أوامر مدمجة (اكتشاف، تنفيذ، تنفيذ دلالي، تسجيل وكيل، إرسال مهمة، حالة مهمة، مقارنة تجارية، تفاوض تجاري، إرسال شبكة، استدلال AI). كل أمر يعلن عن القدرات المطلوبة ومستوى الخطر وصلاحيات الوصول
+- **تفاوض القدرات** — منح قدرات ديناميكي بين الوكلاء والمواقع. موافقة تلقائية حسب مستوى الخطر (منخفض = موافقة تلقائية، عالي = يتطلب سياسة)، تحديد معدل لكل قدرة، منح قابلة للانتهاء مع تتبع الاستخدام، ودعم إبطال كامل
+- **محرك تشغيل الوكلاء** — نظام تشغيل مهام بمستوى إنتاجي مع جدولة بقائمة أولويات، حل التبعيات، إعادة المحاولة بتراجع أسي، إيقاف/استئناف/إلغاء، حدود تزامن، وانتقالات حالة. ناقل أحداث غير متزامن مع وسيط، أحرف بدل مساحات الأسماء، ذاكرة إعادة (١٠ آلاف حدث)، وقائمة الرسائل الميتة
+- **صندوق حماية التنفيذ** — عزل لكل مهمة مع حدود موارد (مهلة، ذاكرة قصوى، حد استدعاءات الشبكة، حد عمليات DOM)، قوائم نطاقات مسموحة، حظر محددات CSS، فحوصات قدرات وقت التنفيذ، وسجل تدقيق كامل لكل عملية
+- **مدير الحالة** — حفظ حالة الوكيل بنقاط تفتيش مُسمّاة، تراجع لأي نقطة تفتيش، انتقالات حالة بالتحقق، عمليات دمج، وتنظيف بانتهاء الصلاحية
+- **حزمة المراقبة** — مسجل JSON هيكلي مع مسجلات فرعية ومخارج قابلة للتوصيل، متتبع موزع بفترات أب-ابن (متوافق مع OpenTelemetry)، ومجمع مقاييس بعدادات ومقاييس ورسوم بيانية (مئينات p50/p90/p95/p99) وسلاسل زمنية للوحات التحكم
+- **نموذج الأمان** — هوية الوكيل (تسجيل، مصادقة بمفتاح API مشفر، إدارة جلسات بمدة صلاحية، قوائم IP المسموحة، إبطال)، توقيع الأوامر (HMAC-SHA256 مع رمز فريد + طابع زمني، مقارنة آمنة زمنياً)، وعزل المواقع (تحكم وصول لكل موقع، وكلاء مسموحون/محظورون، حد تزامن أقصى، حظر محددات، تصنيف بيانات)
+- **مستوى التحكم** — مدير الوكلاء لدورة حياة النشر (نشر، تعيين لمواقع، فحوصات صحة، إلغاء نشر) ومحرك السياسات بقواعد مُنمّطة، تقييم شروط (يساوي، يحتوي، نمط، حد أدنى، حد أقصى، ضمن)، ربط سياسات بأولوية، وتطبيق على مستوى الكيان
+- **مستوى البيانات** — محلل الإجراءات الدلالية يربط صيغة `domain.action` (مثل `checkout.addItem`) بالتنفيذ الفعلي لكل موقع. المنفّذ يوجّه المهام عبر التتبع + المقاييس، يدعم أوضاع التنفيذ الدلالي/الخط الأنبوبي/المتوازي، مع ٨ إجراءات دلالية مدمجة للسلة والبحث والمصادقة والتنقل والمحتوى
+- **تجريد LLM متعدد النماذج** — واجهة موحدة لـ OpenAI (محادثة + تضمينات)، Anthropic (API الرسائل)، وOllama (نماذج محلية مع اكتشاف تلقائي). مدير LLM يوفر سلسلة احتياطية تلقائية عبر جميع الموفرين، تخزين مؤقت للاستجابات (٥ دقائق)، تتبع التكاليف عبر عدد الرموز، وقائمة نماذج
+- **السجل والنظام البيئي** — سجل الأوامر (كـ npm لأوامر WAB — تسجيل، اكتشاف، بحث حسب الفئة/الوسم/القدرة، تتبع الاستخدام)، سجل المواقع (دليل مواقع WAB مع التحقق، قائمة القدرات، تتبع الزيارات)، وسجل القوالب (قوالب سير عمل قابلة لإعادة الاستخدام مع عدد التنزيلات والتقييمات)
+- **واجهة API الموحدة لنظام التشغيل** — جميع طبقات نظام التشغيل مكشوفة عبر نقاط REST على `/api/os/*`: اكتشاف البروتوكول، هوية/مصادقة الوكيل، CRUD المهام، التنفيذ الدلالي، النشر، السياسات، العزل، المراقبة (مقاييس/آثار/سجلات)، السجل (أوامر/مواقع/قوالب)، عمليات LLM، توقيع الأوامر، وأحداث Server-Sent Events للبث المباشر
+- **عميل WABAgentOS في SDK** — فئة `WABAgentOS` جديدة في SDK مع كتابة TypeScript كاملة لجميع عمليات نظام التشغيل: تسجيل ← مصادقة ← تفاوض قدرات ← إرسال مهام ← تنفيذ دلالي ← استعلام المراقبة ← الاشتراك في الأحداث
+
 ---
 
 ## 🚀 البدء السريع
@@ -108,28 +146,119 @@ const info = bridge.getPageInfo();             // معلومات الصفحة
 
 ```
 web-agent-bridge/
-├── server/                 # خادم Express.js
-│   ├── index.js            # نقطة البداية
-│   ├── ws.js               # WebSocket للتحليلات الفورية
+├── server/                         # خادم Express.js
+│   ├── index.js                    # نقطة البداية
+│   ├── ws.js                       # WebSocket للتحليلات الفورية
 │   ├── routes/
-│   │   ├── auth.js         # المصادقة (تسجيل/دخول)
-│   │   ├── api.js          # واجهة المواقع والتحليلات
-│   │   └── license.js      # التحقق من التراخيص والتتبع
+│   │   ├── auth.js                 # المصادقة (تسجيل/دخول)
+│   │   ├── api.js                  # واجهة المواقع والتحليلات
+│   │   ├── license.js              # التحقق من التراخيص والتتبع
+│   │   ├── admin.js                # واجهة الإدارة
+│   │   ├── admin-premium.js        # تحليلات الإدارة المتقدمة
+│   │   ├── billing.js              # تكامل Stripe للمدفوعات
+│   │   ├── sovereign.js            # الإصدار 2.0: تفاوض، سمعة، تحقق، لوحة سيادة
+│   │   ├── mesh.js                 # الإصدار 2.3: مسارات شبكة الوكلاء
+│   │   ├── commander.js            # الإصدار 2.4: مسارات تنسيق المهام
+│   │   ├── premium.js              # الميزات المتقدمة
+│   │   ├── premium-v2.js           # ذاكرة، رؤية، إصلاح، سرب، إضافات
+│   │   ├── discovery.js            # اكتشاف WAB + بحث مرجح بالعدالة
+│   │   ├── wab-api.js              # نقل WAB عبر HTTP
+│   │   └── noscript.js             # بكسل تتبع بدون JavaScript
+│   ├── services/
+│   │   ├── negotiation.js          # محرك التفاوض اللحظي
+│   │   ├── verification.js         # درع مقاومة التزييف
+│   │   ├── reputation.js           # نظام السمعة اللامركزي
+│   │   ├── agent-mesh.js           # بروتوكول التواصل بين الوكلاء
+│   │   ├── agent-learning.js       # التعلم المعزز المحلي (UCB1)
+│   │   ├── agent-symphony.js       # منسق السيمفونية (٤ أدوار، ٦ مراحل)
+│   │   ├── agent-memory.js         # ذاكرة الوكيل مع ارتباطات
+│   │   ├── commander.js            # تنسيق المهام ورسوم المهام (DAG)
+│   │   ├── edge-compute.js         # حوسبة طرفية / عقد AI سيادية
+│   │   ├── swarm.js                # محرك التنفيذ بالسرب
+│   │   ├── fairness.js             # محرك العدالة والحياد
+│   │   ├── vision.js               # تحليل الرؤية (متعدد الموفرين)
+│   │   ├── self-healing.js         # تصحيحات المحددات ذاتية الإصلاح
+│   │   ├── local-ai.js             # نظام تشغيل AI المحلي
+│   │   ├── plugins.js              # بنية الإضافات (خطافات، سجل)
+│   │   ├── premium.js              # تحليل حركة المرور وكشف البوتات
+│   │   ├── email.js                # خدمة البريد SMTP
+│   │   └── stripe.js               # تكامل مدفوعات Stripe
 │   ├── middleware/
-│   │   └── auth.js         # وسيط JWT
-│   └── models/
-│       └── db.js           # قاعدة بيانات SQLite
-├── public/                 # الواجهة الأمامية
-│   ├── index.html          # الصفحة الرئيسية
-│   ├── dashboard.html      # لوحة التحكم
-│   ├── docs.html           # التوثيق
-│   ├── login.html          # تسجيل الدخول
-│   └── register.html       # التسجيل
+│   │   ├── auth.js                 # وسيط JWT
+│   │   ├── adminAuth.js            # مصادقة الإدارة
+│   │   └── rateLimits.js           # تحديد معدل الطلبات متعدد الطبقات
+│   ├── models/
+│   │   ├── db.js                   # عمليات قاعدة البيانات
+│   │   └── adapters/              # محولات SQLite, PostgreSQL, MySQL
+│   ├── migrations/                 # ترحيلات SQL مرقمة
+│   └── utils/
+│       ├── cache.js                # ذاكرة مؤقتة TTL + طابور تحليلات
+│       ├── migrate.js              # مشغل الترحيلات
+│       └── secureFields.js         # أدوات تشفير الحقول
+├── public/                         # الواجهة الأمامية
+│   ├── index.html                  # الصفحة الرئيسية
+│   ├── dashboard.html              # لوحة التحكم
+│   ├── premium-dashboard.html      # لوحة التحليلات المتقدمة
+│   ├── docs.html                   # التوثيق
+│   ├── login.html / register.html  # صفحات المصادقة
+│   ├── admin/                      # لوحة الإدارة
+│   ├── pwa/                        # تطبيق الويب التقدمي (متصفح الهاتف)
+│   │   ├── manifest.json           # بيان PWA
+│   │   ├── sw.js                   # عامل الخدمة (أولوية غير متصل)
+│   │   ├── index.html              # واجهة المتصفح للهاتف
+│   │   ├── app.js                  # حاجب إعلانات، درع احتيال، عدالة
+│   │   ├── app.css                 # سمة داكنة محسنة للهاتف
+│   │   └── icons/                  # أيقونات PWA
+│   ├── script/
+│   │   ├── wab.min.js              # مكتبة WAB المصغرة
+│   │   ├── wab-consent.js          # لافتة موافقة GDPR/CCPA
+│   │   ├── wab-schema.js           # اكتشاف schema.org
+│   │   ├── wab.d.ts                # تعريفات TypeScript
+│   │   └── wab-consent.d.ts        # تعريفات TypeScript للموافقة
+│   ├── js/                         # JavaScript الواجهة
+│   └── css/                        # أوراق الأنماط
 ├── script/
-│   └── ai-agent-bridge.js  # سكريبت الجسر
-├── tests/                  # الاختبارات
-├── Dockerfile              # حاوية Docker
-├── docker-compose.yml      # تشغيل Docker
+│   └── ai-agent-bridge.js          # سكريبت الجسر (ضعه في موقعك)
+├── examples/                       # أمثلة الوكلاء
+│   ├── puppeteer-agent.js          # Puppeteer + window.AICommands
+│   ├── bidi-agent.js               # بروتوكول WebDriver BiDi
+│   ├── vision-agent.js             # تحليل رؤية/لغة طبيعية
+│   ├── mcp-agent.js                # محول MCP لـ Claude/GPT
+│   ├── cross-site-agent.js         # تنسيق متعدد النطاقات
+│   ├── next-app-router/            # تكامل Next.js App Router
+│   ├── shopify-hydrogen/           # واجهة Shopify Hydrogen
+│   ├── wordpress-elementor/        # WordPress + Elementor
+│   └── saas-dashboard/             # إجراءات لوحة SaaS
+├── packages/                       # أغلفة أطر العمل
+│   ├── react/                      # @web-agent-bridge/react
+│   ├── vue/                        # @web-agent-bridge/vue
+│   ├── svelte/                     # @web-agent-bridge/svelte
+│   └── langchain/                  # @web-agent-bridge/langchain
+├── sdk/                            # SDK الوكيل
+│   ├── index.js                    # WABAgent لـ Puppeteer/Playwright
+│   └── schema-discovery.js         # استخراج schema.org من الخادم
+├── wab-mcp-adapter/                # محول MCP لـ Claude/GPT/Gemini
+│   ├── index.js                    # تعريفات أدوات MCP
+│   └── package.json
+├── wab-browser/                    # متصفح Electron لسطح المكتب
+│   ├── main.js                     # العملية الرئيسية لـ Electron
+│   ├── preload.js                  # التحميل المسبق
+│   └── package.json
+├── web-agent-bridge-wordpress/     # إضافة WordPress
+│   ├── web-agent-bridge.php        # نقطة دخول الإضافة
+│   ├── includes/                   # فئات PHP (API, Actions, Dashboard)
+│   └── assets/                     # CSS/JS الإضافة
+├── bin/
+│   ├── cli.js                      # نقطة دخول CLI (wab-agent)
+│   └── wab.js                      # مشغل الوكلاء
+├── templates/                      # ١١ قالب YAML لمتجر الوكلاء
+├── docs/
+│   ├── SPEC.md                     # مواصفة بروتوكول WAB
+│   └── DEPLOY.md                   # دليل النشر
+├── demo-store/                     # متجر تجريبي للاختبار
+├── deploy/                         # إعدادات Nginx
+├── tests/                          # اختبارات Jest + Supertest
+├── .env                            # متغيرات البيئة
 └── package.json
 ```
 
@@ -160,6 +289,8 @@ web-agent-bridge/
 | النقطة | الطريقة | الوصف |
 |---|---|---|
 | `/api/license/verify` | POST | التحقق من مفتاح الترخيص |
+| `/api/license/token` | POST | تبادل `siteId` مقابل توكن جلسة |
+| `/api/license/session` | POST | التحقق من توكن الجلسة |
 | `/api/license/track` | POST | تسجيل حدث تحليلي |
 
 ### واجهات السيادة (الإصدار 2.0)
@@ -178,6 +309,65 @@ web-agent-bridge/
 | `/api/sovereign/verify/page` | POST | التحقق الشامل للصفحة |
 | `/api/sovereign/dashboard/sovereign` | GET | بيانات لوحة السيادة |
 
+### شبكة الوكلاء (الإصدار 2.3)
+| النقطة | الطريقة | الوصف |
+|---|---|---|
+| `/api/mesh/agents` | POST | تسجيل وكيل في الشبكة |
+| `/api/mesh/agents` | GET | عرض وكلاء الشبكة |
+| `/api/mesh/channels` | GET | عرض قنوات الاتصال |
+| `/api/mesh/messages` | POST | نشر رسالة في قناة |
+| `/api/mesh/messages/:channel` | GET | قراءة رسائل القناة |
+| `/api/mesh/knowledge` | POST | مشاركة معرفة |
+| `/api/mesh/knowledge` | GET | استعلام قاعدة المعرفة |
+| `/api/mesh/votes` | POST | بدء تصويت |
+| `/api/mesh/votes/:id/cast` | POST | الإدلاء بصوت |
+| `/api/mesh/votes/:id/tally` | GET | نتائج التصويت |
+
+### القائد (الإصدار 2.4)
+| النقطة | الطريقة | الوصف |
+|---|---|---|
+| `/api/commander/missions` | POST | إنشاء مهمة جديدة |
+| `/api/commander/missions/:id/launch` | POST | إطلاق المهمة |
+| `/api/commander/missions/:id` | GET | حالة المهمة |
+| `/api/commander/missions` | GET | عرض جميع المهام |
+| `/api/commander/agents` | POST | تسجيل وكيل |
+| `/api/commander/agents` | GET | عرض الوكلاء |
+| `/api/commander/edge/nodes` | POST | تسجيل عقدة حوسبة طرفية |
+| `/api/commander/edge/nodes` | GET | عرض العقد |
+| `/api/commander/ai/models` | GET | اكتشاف نماذج AI المحلية |
+| `/api/commander/ai/infer` | POST | تشغيل استدلال AI محلي |
+| `/api/commander/stats` | GET | إحصائيات المنصة الموحدة |
+
+### الميزات المتقدمة (الإصدار 2)
+| النقطة | الطريقة | الوصف |
+|---|---|---|
+| `/api/premium/v2/memory` | POST | تخزين ذاكرة الوكيل |
+| `/api/premium/v2/memory/:agentId` | GET | استرجاع ذكريات الوكيل |
+| `/api/premium/v2/memory/associate` | POST | إنشاء ارتباط بين ذكريات |
+| `/api/premium/v2/vision/analyze` | POST | تحليل لقطة شاشة |
+| `/api/premium/v2/vision/elements` | POST | استخراج عناصر تفاعلية |
+| `/api/premium/v2/healing/corrections` | POST | تسجيل تصحيح محدد |
+| `/api/premium/v2/healing/resolve` | POST | حل محدد معطل |
+| `/api/premium/v2/swarm/execute` | POST | إطلاق مهمة سرب |
+| `/api/premium/v2/swarm/:id` | GET | نتائج السرب |
+| `/api/premium/v2/plugins` | GET | عرض الإضافات المتاحة |
+| `/api/premium/v2/plugins/:id/install` | POST | تثبيت إضافة |
+| `/api/premium/v2/plugins/:id/hooks` | POST | تنفيذ خطاف إضافة |
+
+### الاكتشاف والعدالة
+| النقطة | الطريقة | الوصف |
+|---|---|---|
+| `/api/discovery` | GET | مستند اكتشاف WAB |
+| `/api/discovery/search` | GET | بحث مرجح بالعدالة |
+| `/api/discovery/register` | POST | تسجيل موقع في دليل WAB |
+
+### بروتوكول WAB (نقل HTTP)
+| النقطة | الطريقة | الوصف |
+|---|---|---|
+| `/api/wab/session` | POST | تبادل توكن جلسة |
+| `/api/wab/actions` | GET | الإجراءات المتاحة |
+| `/api/wab/execute` | POST | تنفيذ إجراء عبر HTTP |
+
 ### WebSocket
 | النقطة | الوصف |
 |---|---|
@@ -357,6 +547,17 @@ await browser.close();
 | `puppeteer-agent.js` | وكيل أساسي باستخدام Puppeteer و `window.AICommands` |
 | `bidi-agent.js` | وكيل يستخدم بروتوكول WebDriver BiDi عبر `window.__wab_bidi` |
 | `vision-agent.js` | وكيل رؤية — يحل أوصاف اللغة الطبيعية إلى إجراءات WAB |
+| `mcp-agent.js` | استخدام محول MCP لـ Claude وGPT مع اكتشاف الأدوات |
+| `cross-site-agent.js` | تنسيق متعدد النطاقات — مقارنة أسعار، تجميع بيانات، أفضل الصفقات |
+
+### أمثلة التكامل مع أطر العمل
+
+| المسار | الوصف |
+|---|---|
+| `examples/next-app-router/` | تكامل Next.js App Router مع `@web-agent-bridge/react` |
+| `examples/shopify-hydrogen/` | واجهة Shopify Hydrogen مع إجراءات سلة عملية |
+| `examples/wordpress-elementor/` | إعداد WordPress + Elementor مع إجراءات مدعومة بالمخطط |
+| `examples/saas-dashboard/` | لوحة SaaS بنمط Notion مع مؤشرات أداء وتشغيل سير عمل |
 
 ```bash
 node examples/puppeteer-agent.js http://localhost:3000
@@ -457,12 +658,18 @@ window.AIBridgeConfig = { stealth: { enabled: true } };
 
 ## 🛠️ التقنيات
 
-- **الخلفية**: Node.js + Express + WebSocket
-- **قاعدة البيانات**: SQLite / PostgreSQL / MySQL
-- **المصادقة**: JWT + bcrypt
+- **الخلفية**: Node.js + Express + WebSocket (ws)
+- **قاعدة البيانات**: SQLite (عبر better-sqlite3) مع مشغل ترحيلات
+- **المصادقة**: JWT + bcrypt + توكنات جلسة (مقفلة بالنطاق)
+- **التخزين المؤقت**: ذاكرة مؤقتة TTL + طابور تحليلات مجمع
+- **المدفوعات**: تكامل Stripe مع بوابة الفوترة
 - **الواجهة**: HTML/CSS/JS بدون أطر عمل
-- **الأمان**: Helmet, CORS, CSP, Rate Limiting, Security Sandbox
+- **أغلفة أطر العمل**: React, Vue 3, Svelte (اختيارية)
+- **تكامل LLM**: محول LangChain، محول MCP
+- **الأمان**: Helmet, CORS, CSP, Rate Limiting متعدد الطبقات
 - **الحاويات**: Docker + Docker Compose
+- **CI/CD**: GitHub Actions (اختبار + نشر تلقائي في npm)
+- **الاختبارات**: Jest + Supertest
 
 ---
 
@@ -567,6 +774,292 @@ npx wab-agent run hotel-direct-booking --server https://yourserver.com
 
 ---
 
+## 🎯 نظام القائد (Commander)
+
+محرك تنسيق مهام محلي يفكك الأهداف العليا إلى مهام مترابطة ويوزعها على وكلاء متخصصين:
+
+```javascript
+// إنشاء مهمة
+const mission = await fetch('/api/commander/missions', {
+  method: 'POST',
+  headers: { 'Authorization': 'Bearer ' + token, 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    goal: 'إيجاد أرخص زيت زيتون في ٥ متاجر',
+    strategy: 'parallel',
+    agents: ['researcher-1', 'analyst-1', 'negotiator-1']
+  })
+}).then(r => r.json());
+
+// إطلاق المهمة
+await fetch(`/api/commander/missions/${mission.id}/launch`, {
+  method: 'POST', headers: { 'Authorization': 'Bearer ' + token }
+});
+```
+
+| القدرة | الوصف |
+|---|---|
+| **تفكيك المهام** | تحويل الأهداف إلى رسوم بيانية مهام (DAG) مع تتبع التبعيات |
+| **سجل الوكلاء** | تتبع قدرات وأداء الوكلاء المسجلين |
+| **تنفيذ متوازٍ** | تشغيل المهام المستقلة بالتوازي عبر عدة وكلاء |
+| **تعلم من النتائج** | تسجيل النتائج لتغذية راجعة في التعلم المعزز |
+| **تنسيق حوسبة طرفية** | توزيع المهام الثقيلة على عقد الحافة |
+
+---
+
+## 🖥️ نظام الحوسبة الطرفية (Edge Compute)
+
+حوّل كل جهاز إلى عقدة AI سيادية — بدون سحابة مركزية:
+
+```javascript
+// تسجيل جهاز كعقدة حوسبة طرفية
+await fetch('/api/commander/edge/nodes', {
+  method: 'POST',
+  headers: { 'Authorization': 'Bearer ' + token, 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    name: 'حاسوبي',
+    capabilities: { cpu: 8, ram: 16384, gpu: true },
+    supportedTasks: ['text-inference', 'vision-analysis', 'price-comparison']
+  })
+}).then(r => r.json());
+```
+
+| القدرة | الوصف |
+|---|---|
+| **تحليل المعدات** | كشف إمكانيات CPU, RAM, GPU لكل عقدة |
+| **تشفير AES-256-GCM** | كل البيانات بين العقد مشفرة من الطرف للطرف |
+| **موازنة حمل مرجحة** | توجيه المهام حسب المعدات والتوفر |
+| **مراقبة بنبضات القلب** | تجاوز فشل تلقائي عند عدم استجابة العقد |
+| **تشكيل أسراب** | تجميع العقد حسب القدرات |
+
+---
+
+## 🐝 محرك التنفيذ بالسرب (Swarm)
+
+أطلق عدة وكلاء بالتوازي لحل مهمة واحدة ثم ادمج نتائجهم بذكاء:
+
+```javascript
+const swarm = await fetch('/api/premium/v2/swarm/execute', {
+  method: 'POST',
+  headers: { 'Authorization': 'Bearer ' + token, 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    task: 'أفضل عروض لاب توب تحت ١٠٠٠ دولار',
+    strategy: 'parallel',        // parallel | sequential | hybrid
+    agentCount: 4,
+    roles: ['researcher', 'analyst', 'price-checker', 'reviewer'],
+    mergeStrategy: 'best-score'  // best-score | fairness-weighted | consensus
+  })
+}).then(r => r.json());
+```
+
+---
+
+## ⚖️ محرك العدالة (Fairness Engine)
+
+طبقة حياد تضمن فرصة متساوية للمواقع الصغيرة والكبيرة:
+
+```javascript
+// بحث مرجح بالعدالة (بدلاً من ترتيب الصلة فقط)
+const results = await fetch('/api/discovery/search?q=زيت+زيتون&fairness=true', {
+  headers: { 'Authorization': 'Bearer ' + token }
+}).then(r => r.json());
+// المزارع الصغيرة تُرتّب بجانب أمازون — مرجحة بدرجة الحياد لا بـ SEO فقط
+```
+
+### كيف يعمل تقييم الحياد
+| العامل | الوزن | الوصف |
+|---|---|---|
+| **اكتمال الإعداد** | ٢٥٪ | مدى جودة إعداد WAB في الموقع |
+| **درجة الثقة** | ٢٥٪ | شهادات السمعة من شبكة الوكلاء |
+| **الشفافية** | ٢٥٪ | إفصاح العمولة، وضوح التسعير |
+| **الاستجابة** | ٢٥٪ | زمن استجابة API، وقت التشغيل، نجاح الإجراءات |
+
+---
+
+## 🧠 ذاكرة الوكيل (Agent Memory)
+
+ذاكرة سلوكية دائمة تسمح للوكلاء بتذكر تفضيلات المستخدم وبناء ارتباطات:
+
+```javascript
+// تخزين ذاكرة
+await fetch('/api/premium/v2/memory', {
+  method: 'POST',
+  headers: { 'Authorization': 'Bearer ' + token, 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    agentId: 'agent-1',
+    type: 'preference',         // preference | interaction | correction | pattern
+    category: 'purchase',       // navigation | purchase | search | form | custom
+    key: 'العلامة-المفضلة',
+    value: 'عضوي-فقط',
+    importance: 0.9
+  })
+}).then(r => r.json());
+
+// إنشاء ارتباطات بين الذكريات
+await fetch('/api/premium/v2/memory/associate', {
+  method: 'POST',
+  headers: { 'Authorization': 'Bearer ' + token, 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    sourceId: 'memory-1',
+    targetId: 'memory-2',
+    relationship: 'leads_to'   // leads_to | similar_to | replaces | depends_on
+  })
+}).then(r => r.json());
+```
+
+---
+
+## 👁️ خدمة الرؤية (Vision Analysis)
+
+تحليل لقطات شاشة متعدد الموفرين لكشف العناصر التفاعلية واستخراج البيانات:
+
+| الموفر | محلي؟ | الوصف |
+|---|---|---|
+| **Moondream** | ✅ | نموذج رؤية محلي خفيف |
+| **Ollama** | ✅ | نماذج محلية عبر Ollama (llava, bakllava) |
+| **OpenAI** | ❌ | GPT-4 Vision |
+| **Anthropic** | ❌ | Claude Vision |
+
+---
+
+## 🔌 بنية الإضافات (Plugin Architecture)
+
+نظام إضافات ديناميكي يسمح بامتدادات من أطراف ثالثة:
+
+```javascript
+// عرض الإضافات المتاحة
+const plugins = await fetch('/api/premium/v2/plugins', {
+  headers: { 'Authorization': 'Bearer ' + token }
+}).then(r => r.json());
+
+// تثبيت إضافة لموقعك
+await fetch('/api/premium/v2/plugins/price-alert/install', {
+  method: 'POST',
+  headers: { 'Authorization': 'Bearer ' + token, 'Content-Type': 'application/json' },
+  body: JSON.stringify({ siteId: 'site-uuid', config: { threshold: 10 } })
+}).then(r => r.json());
+```
+
+---
+
+## 🔍 تحليل حركة المرور المتقدم (Traffic Intelligence)
+
+| القدرة | الوصف |
+|---|---|
+| **٣٠+ نوع بوت** | كشف Google, Bing, ChatGPT, Claude, Perplexity وغيرها |
+| **تحليل سلوكي** | تصنيف سلوك الوكلاء حسب البصمة والمنصة والنوع |
+| **كشف شذوذ** | كشف الارتفاعات المفاجئة وتحليل أنماط غير عادية |
+| **كشف استغلالات أمنية** | رصد أنماط SQL injection, XSS, Rate anomalies |
+| **تنبيهات Webhook** | إطلاق webhooks عند نشاط مشبوه |
+| **تدقيق للامتثال** | سجل تدقيق كامل للتوافق التنظيمي |
+
+---
+
+## 🔗 محول WAB-MCP
+
+كشف قدرات مواقع WAB كأدوات [MCP](https://modelcontextprotocol.io/) لـ Claude وGPT وGemini:
+
+```javascript
+const { WABMCPAdapter } = require('wab-mcp-adapter');
+
+const adapter = new WABMCPAdapter({
+  siteUrl: 'https://shop.example.com',
+  transport: 'http'           // http | websocket | direct
+});
+
+const tools = await adapter.getTools();
+const result = await adapter.executeTool('execute_action', {
+  name: 'addToCart', params: { sku: 'ABC123' }
+});
+```
+
+### أدوات MCP المدمجة
+| الأداة | الوصف |
+|---|---|
+| `discover` | اكتشاف الإجراءات المتاحة تلقائياً |
+| `get_actions` | قائمة كل الإجراءات مع المعاملات |
+| `execute_action` | تنفيذ إجراء محدد |
+| `read_content` | قراءة محتوى من الصفحة |
+| `get_page_info` | معلومات وصفية عن الصفحة |
+| `fairness_search` | بحث في دليل WAB مرجح بالعدالة |
+| `authenticate` | مصادقة وكيل مع الموقع |
+
+---
+
+## 🖥️ متصفح WAB (سطح المكتب)
+
+متصفح Electron مستقل مع ميزات خصوصية وعدالة مدمجة:
+
+- **حاجب الإعلانات** — ٨٠+ نطاق محظور + مطابقة أنماط URL + قواعد CSS تجميلية
+- **درع الاحتيال** — كشف نطاقات TLD مشبوهة وانتحال أسماء العلامات التجارية
+- **تصنيف العدالة** — أولوية للمواقع المستقلة، تنبيه عن تركز الشركات الكبرى
+- **دردشة الوكيل** — مساعد AI مدمج للتصفح
+- **الإشعارات** — تحليل الصفحة مع تنبيهات أمان وعدالة
+- **وضع الشبح** — تصفح بخصوصية بدون تتبع
+- **بحث ذكي** — تكامل DuckDuckGo للبحث الخاص
+
+```bash
+# تشغيل متصفح WAB
+cd wab-browser
+npm install
+npx electron .
+
+# بناء المثبت (Windows NSIS)
+npm run build:win
+```
+
+---
+
+## 📱 متصفح PWA (الهاتف)
+
+تطبيق ويب تقدمي لـ Android وiOS — قابل للتثبيت من أي متصفح هاتف:
+
+- **حاجب إعلانات** — ٤٥+ نطاق إعلاني محظور + مطابقة أنماط URL
+- **كشف الاحتيال** — تنبيهات TLD مشبوهة وفحوصات انتحال العلامات
+- **وضع العدالة** — تصفية مواقع التقنية الكبرى لتعزيز البدائل المستقلة
+- **أولوية غير متصل** — عامل الخدمة يخزن أصول الواجهة مؤقتاً للتشغيل بدون إنترنت
+- **بحث خاص** — تكامل DuckDuckGo (بدون تتبع Google)
+- **دردشة وكيل** — مساعد AI مع احتياطي محلي
+
+ثبّته من: `https://yourserver.com/pwa/`
+
+---
+
+## 📦 إضافة WordPress
+
+إضافة WordPress أصلية لإضافة دعم WAB لأي موقع WordPress:
+
+| القدرة | الوصف |
+|---|---|
+| **صفحة إعدادات** | إعداد عنوان API، معرف الموقع، الصلاحيات |
+| **إجراءات لكل صفحة** | صندوق وصف لإضافة إجراءات WAB مخصصة لكل صفحة/مقال |
+| **مستند اكتشاف** | توليد تلقائي لنقطة اكتشاف WAB |
+| **عنصر لوحة تحكم** | عرض حالة WAB وإحصائيات تفاعل الوكلاء |
+| **كود قصير** | `[wab_bridge]` لتضمين WAB في صفحات محددة |
+| **خطافات** | `wab_before_action` / `wab_after_action` لمنطق مخصص |
+
+راجع [`web-agent-bridge-wordpress/README.md`](web-agent-bridge-wordpress/README.md) للتوثيق الكامل.
+
+---
+
+## 📋 مواصفة بروتوكول WAB
+
+المواصفة المعيارية الكاملة متاحة في [`docs/SPEC.md`](docs/SPEC.md):
+
+| الطبقة | الوصف |
+|---|---|
+| **طبقة البروتوكول** | صيغة مستند الاكتشاف، بروتوكول الأوامر، بروتوكول العدالة |
+| **طبقة التشغيل** | واجهة `window.AICommands`، محرك الاكتشاف التلقائي، صندوق الأمان |
+| **طبقة النقل** | متغير JavaScript عام، WebSocket, HTTP, WebDriver BiDi, MCP |
+
+### دورة الحياة من ٥ مراحل
+١. **اكتشاف** — الوكيل يجد مستند اكتشاف WAB (`.well-known/wab.json` أو وسم سكريبت)
+٢. **مصادقة** — الوكيل يستبدل `siteId` بتوكن جلسة
+٣. **تخطيط** — الوكيل يقرأ الإجراءات المتاحة ومعلومات الصفحة
+٤. **تنفيذ** — الوكيل يشغل الإجراءات عبر الجسر
+٥. **تأكيد** — النتائج تُتحقق عبر درع مقاومة التزييف
+
+---
+
 ## 🤝 المساهمة
 
 نرحب بالمساهمات! اقرأ [دليل المساهمة](CONTRIBUTING.md) للبدء.