web-agent-bridge 2.0.0 → 2.2.0

package/README.ar.md

@@ -33,6 +33,16 @@
 - **قواعد بيانات متعددة** — SQLite + PostgreSQL + MySQL عبر محوّلات قابلة للتبديل
 - **SDK للوكلاء** — حزمة أدوات جاهزة لبناء وكلاء ذكاء اصطناعي
 
+### الإصدار 2.0 — ميزات الحصن الرقمي
+
+- **محرك التفاوض اللحظي** — يتفاوض وكيل الذكاء الاصطناعي على الأسعار مباشرة مع المواقع عبر جلسات متعددة الجولات، ٨ أنواع شروط، و٤ أنواع خصومات
+- **درع مقاومة التزييف** — محرك تحقق متقاطع يقارن DOM مع لقطات الشاشة، يتحقق من الأسعار مقابل المعايير السوقية، يفحص الاتساق الزمني، ويقيس تشابه النصوص
+- **نظام السمعة اللامركزي** — شهادات ثقة مشفرة من شبكة الوكلاء مع تقييم مرجح، مستويات ثقة (ناشئ ← موثق ← نموذجي)، ولوحة متصدرين عالمية
+- **لوحة السيادة** — مركز قيادة لحظي يعرض رادار العدالة، درع الخصوصية، سجل التفاوض، فحوصات التحقق، ومبدّل نماذج الذكاء الاصطناعي
+- **متجر قوالب الوكلاء** — ١١ قالب YAML جاهز (حجز فنادق، مقارنة بقالة، سوق حرفيين، صفقات طيران، إلخ) مع تشغيل من سطر الأوامر: `npx wab-agent run template.yaml`
+- **تبديل عقل الوكيل** — بدّل بين Llama 3، GPT-4، Claude، Gemini، Mistral، أو Ollama (محلي) بدون إعادة إعداد
+- **تنسيق الوكيل عبر المواقع** — وكيل واحد يدير عدة مواقع WAB في نفس الوقت عبر `WABMultiAgent`. قارن الأسعار بين المتاجر، اجمع البيانات، نفّذ إجراءات متوازية، واعثر على أفضل صفقة تلقائياً
+
 ---
 
 ## 🚀 البدء السريع
@@ -145,6 +155,22 @@ web-agent-bridge/
 | `/api/license/verify` | POST | التحقق من مفتاح الترخيص |
 | `/api/license/track` | POST | تسجيل حدث تحليلي |
 
+### واجهات السيادة (الإصدار 2.0)
+| النقطة | الطريقة | الوصف |
+|---|---|---|
+| `/api/sovereign/reputation/agents` | POST | تسجيل وكيل جديد |
+| `/api/sovereign/reputation/attestations` | POST | إرسال شهادة ثقة |
+| `/api/sovereign/reputation/sites/:siteId` | GET | سمعة الموقع |
+| `/api/sovereign/reputation/leaderboard` | GET | لوحة المتصدرين |
+| `/api/sovereign/negotiation/rules` | POST | إنشاء قاعدة تفاوض |
+| `/api/sovereign/negotiation/sessions` | POST | فتح جلسة تفاوض |
+| `/api/sovereign/negotiation/sessions/:id/propose` | POST | تقديم عرض مضاد |
+| `/api/sovereign/negotiation/sessions/:id/confirm` | POST | تأكيد الصفقة |
+| `/api/sovereign/verify/price` | POST | التحقق من السعر |
+| `/api/sovereign/verify/text` | POST | التحقق من النص |
+| `/api/sovereign/verify/page` | POST | التحقق الشامل للصفحة |
+| `/api/sovereign/dashboard/sovereign` | GET | بيانات لوحة السيادة |
+
 ### WebSocket
 | النقطة | الوصف |
 |---|---|
@@ -433,6 +459,107 @@ window.AIBridgeConfig = { stealth: { enabled: true } };
 
 ---
 
+## 💰 محرك التفاوض اللحظي
+
+يحدد أصحاب المواقع قواعد التفاوض. يتفاوض وكيل الذكاء الاصطناعي على الأسعار في جلسات متعددة الجولات:
+
+```javascript
+// فتح جلسة تفاوض
+const session = await fetch('/api/sovereign/negotiation/sessions', {
+  method: 'POST',
+  headers: { 'Authorization': 'Bearer ' + token, 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    siteId: 'site-uuid',
+    agentId: 'agent-id',
+    originalPrice: 49.99,
+    itemId: 'product-123',
+    itemName: 'زيت زيتون ١ لتر'
+  })
+}).then(r => r.json());
+
+// تقديم عرض مضاد
+const counter = await fetch(`/api/sovereign/negotiation/sessions/${session.sessionId}/propose`, {
+  method: 'POST',
+  headers: { 'Authorization': 'Bearer ' + token, 'Content-Type': 'application/json' },
+  body: JSON.stringify({ agentId: 'agent-id', proposedPrice: 39.99 })
+}).then(r => r.json());
+// → { status: 'accepted', finalPrice: 42.49, message: 'صفقة! ...' }
+```
+
+### أنواع الشروط
+| الشرط | الوصف |
+|---|---|
+| `bulk_quantity` | خصم على الكميات الكبيرة |
+| `loyalty` | مكافأة للعملاء المتكررين |
+| `time_based` | عروض الساعة السعيدة |
+| `first_purchase` | خصم ترحيبي للمشترين الجدد |
+| `cart_value` | حد أدنى لقيمة السلة |
+| `seasonal` | عروض موسمية بتواريخ محددة |
+| `membership` | أسعار خاصة للأعضاء |
+| `referral` | خصومات الإحالة |
+
+---
+
+## 🛡️ درع مقاومة التزييف (Anti-Hallucination Shield)
+
+محرك تحقق متقاطع يكتشف أكاذيب الذكاء الاصطناعي قبل وصولها للمستخدم:
+
+```javascript
+// التحقق من سعر
+const result = await fetch('/api/sovereign/verify/price', {
+  method: 'POST',
+  headers: { 'Authorization': 'Bearer ' + token, 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    siteId: 'site-uuid',
+    domValue: 29.99,
+    visionValue: 29.99,
+    category: 'electronics',
+    itemName: 'كابل USB'
+  })
+}).then(r => r.json());
+// → { verified: true, confidence: 0.98, severity: 'none' }
+```
+
+### طبقات التحقق
+١. **DOM مقابل الرؤية** — يقارن السعر المستخرج من DOM مع قراءة لقطة الشاشة
+٢. **المعيار السوقي** — يتحقق من السعر مقابل البيانات التاريخية للفئة
+٣. **الاتساق الزمني** — يفحص هل تغير السعر بشكل مريب منذ آخر تحقق
+٤. **النتيجة المركبة** — مزيج مرجح من جميع الطبقات مع تصنيف الخطورة
+
+---
+
+## 📦 متجر قوالب الوكلاء (Community Agent Hub)
+
+قوالب YAML جاهزة لحالات الاستخدام الشائعة. شغّل أي قالب من سطر الأوامر:
+
+```bash
+# عرض القوالب المتاحة
+npx wab-agent templates
+
+# تشغيل قالب
+npx wab-agent run olive-oil-tunisia --budget 50 --region tunis
+
+# تشغيل مع خادم مخصص
+npx wab-agent run hotel-direct-booking --server https://yourserver.com
+```
+
+### القوالب المتاحة
+| القالب | الوصف |
+|---|---|
+| `olive-oil-tunisia` | زيت زيتون من مزارع تونسية صغيرة |
+| `hotel-direct-booking` | حجز فنادق مباشر بدون وسطاء |
+| `artisan-marketplace` | منتجات يدوية من حرفيين مستقلين |
+| `grocery-price-compare` | مقارنة أسعار البقالة بين المتاجر المحلية |
+| `freelancer-direct` | مستقلون بدون رسوم منصات |
+| `restaurant-direct` | مطاعم بدون تطبيقات توصيل |
+| `book-price-scout` | كتب من مكتبات مستقلة |
+| `flight-deal-hunter` | رحلات مباشرة من شركات الطيران |
+| `electronics-price-tracker` | تتبع أسعار الإلكترونيات |
+| `local-services` | مزودي خدمات محليين |
+| `organic-farm-fresh` | منتجات عضوية مباشرة من المزارع |
+
+---
+
 ## 🤝 المساهمة
 
 نرحب بالمساهمات! اقرأ [دليل المساهمة](CONTRIBUTING.md) للبدء.

package/README.md

@@ -57,6 +57,16 @@ WAB is an open-source middleware layer that bridges AI agents and websites — l
 - **Admin Dashboard** — User management, tier grants, system analytics
 - **Stripe Integration** — Payment processing with customer portal
 
+### v2.0 — Digital Fortress Features
+
+- **Real-time Negotiation Engine** — AI agents negotiate prices directly with WAB-enabled sites using multi-round sessions, 8 condition types, and 4 discount types
+- **Anti-Hallucination Shield** — Cross-verification engine comparing DOM vs vision screenshots, market benchmark validation, temporal consistency checks, and Levenshtein text similarity scoring
+- **Decentralized Reputation System** — Cryptographic trust attestations from the agent network with weighted scoring, trust levels (emerging → verified → exemplary), and global leaderboard
+- **Sovereign Dashboard** — Real-time command center with fairness radar, privacy shield, negotiation logs, verification checks, and AI model switcher
+- **Community Agent Hub** — 11 pre-built YAML agent templates (hotel booking, grocery comparison, artisan marketplace, flight deals, etc.) with CLI runner: `npx wab-agent run template.yaml`
+- **AI Brain Swapping** — Switch between Llama 3, GPT-4, Claude, Gemini, Mistral, or Ollama (local) without reconfiguration
+- **Cross-Site Agent Orchestration** — One agent manages multiple WAB-enabled sites simultaneously via `WABMultiAgent`. Compare prices across stores, aggregate data, run parallel actions, and find the best deal automatically
+
 ---
 
 ## Quick Start
@@ -126,7 +136,12 @@ web-agent-bridge/
 │   │   ├── api.js          # Sites, config, analytics API
 │   │   ├── license.js      # License verification, token exchange & tracking
 │   │   ├── admin.js        # Admin dashboard API
-│   │   └── billing.js      # Stripe billing integration
+│   │   ├── billing.js      # Stripe billing integration
+│   │   └── sovereign.js    # v2.0: negotiation, reputation, verification
+│   ├── services/
+│   │   ├── negotiation.js  # Real-time negotiation engine
+│   │   ├── verification.js # Anti-hallucination shield
+│   │   └── reputation.js   # Decentralized reputation system
 │   ├── middleware/
 │   │   └── auth.js         # JWT authentication middleware
 │   ├── models/
@@ -154,6 +169,10 @@ web-agent-bridge/
 │   ├── svelte/             # @web-agent-bridge/svelte
 │   └── langchain/          # @web-agent-bridge/langchain
 ├── sdk/                    # Agent SDK for Puppeteer/Playwright
+├── bin/
+│   ├── cli.js              # CLI entry point (wab-agent)
+│   └── agent-runner.js     # YAML template runner
+├── templates/              # Community Agent Hub YAML templates
 ├── .env                    # Environment variables
 └── package.json
 ```
@@ -189,6 +208,23 @@ web-agent-bridge/
 | `/api/license/session` | POST | Validate session token (domain-locked) |
 | `/api/license/track` | POST | Record analytics (`sessionToken` + Origin; legacy `licenseKey` only if `ALLOW_LEGACY_LICENSE_TRACK`) |
 
+### Sovereign (v2.0)
+| Endpoint | Method | Description |
+|---|---|---|
+| `/api/sovereign/reputation/agents` | POST | Register a new agent |
+| `/api/sovereign/reputation/attestations` | POST | Submit a trust attestation |
+| `/api/sovereign/reputation/sites/:siteId` | GET | Get site reputation |
+| `/api/sovereign/reputation/leaderboard` | GET | Get reputation leaderboard |
+| `/api/sovereign/negotiation/rules` | POST | Create negotiation rule |
+| `/api/sovereign/negotiation/rules/:siteId` | GET | Get rules for a site |
+| `/api/sovereign/negotiation/sessions` | POST | Open negotiation session |
+| `/api/sovereign/negotiation/sessions/:id/propose` | POST | Submit counter-offer |
+| `/api/sovereign/negotiation/sessions/:id/confirm` | POST | Confirm a deal |
+| `/api/sovereign/verify/price` | POST | Verify price (DOM vs vision) |
+| `/api/sovereign/verify/text` | POST | Verify text accuracy |
+| `/api/sovereign/verify/page` | POST | Full page verification |
+| `/api/sovereign/dashboard/sovereign` | GET | Dashboard aggregate data |
+
 ---
 
 ## Bridge Script API
@@ -775,6 +811,159 @@ First admin: set `BOOTSTRAP_ADMIN_EMAIL` / `BOOTSTRAP_ADMIN_PASSWORD` when the `
 
 ---
 
+## Real-time Negotiation Engine
+
+Site owners define negotiation rules. AI agents negotiate prices in multi-round sessions:
+
+```javascript
+// Agent opens a negotiation session
+const session = await fetch('/api/sovereign/negotiation/sessions', {
+  method: 'POST',
+  headers: { 'Authorization': 'Bearer ' + token, 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    siteId: 'site-uuid',
+    agentId: 'agent-id',
+    originalPrice: 49.99,
+    itemId: 'product-123',
+    itemName: 'Olive Oil 1L'
+  })
+}).then(r => r.json());
+
+// Agent makes a counter-offer
+const counter = await fetch(`/api/sovereign/negotiation/sessions/${session.sessionId}/propose`, {
+  method: 'POST',
+  headers: { 'Authorization': 'Bearer ' + token, 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    agentId: 'agent-id',
+    proposedPrice: 39.99
+  })
+}).then(r => r.json());
+// → { status: 'accepted', finalPrice: 42.49, message: 'Deal! ...' }
+```
+
+### Condition Types
+| Condition | Description |
+|---|---|
+| `bulk_quantity` | Discounts based on order quantity |
+| `loyalty` | Rewards for repeat customers |
+| `time_based` | Happy hour / flash sale windows |
+| `first_purchase` | Welcome discount for new buyers |
+| `cart_value` | Minimum cart value threshold |
+| `seasonal` | Date-range seasonal promotions |
+| `membership` | Member-only pricing |
+| `referral` | Referral-based discounts |
+
+---
+
+## Anti-Hallucination Shield
+
+Cross-verification engine that catches AI hallucinations before they reach users:
+
+```javascript
+// Verify a price
+const result = await fetch('/api/sovereign/verify/price', {
+  method: 'POST',
+  headers: { 'Authorization': 'Bearer ' + token, 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    siteId: 'site-uuid',
+    domValue: 29.99,
+    visionValue: 29.99,
+    category: 'electronics',
+    itemName: 'USB Cable'
+  })
+}).then(r => r.json());
+// → { verified: true, confidence: 0.98, severity: 'none', layers: { dom_vision: { match: true }, ... } }
+
+// Verify text content
+const textResult = await fetch('/api/sovereign/verify/text', {
+  method: 'POST',
+  headers: { 'Authorization': 'Bearer ' + token, 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    siteId: 'site-uuid',
+    source: 'dom',
+    value: 'Free shipping on orders over $50',
+    expected: 'Free shipping on orders over $50'
+  })
+}).then(r => r.json());
+// → { verified: true, similarity: 1.0 }
+```
+
+### Verification Layers
+1. **DOM vs Vision** — Compares DOM-extracted price with screenshot OCR value
+2. **Market Benchmark** — Validates against historical price benchmarks for the category
+3. **Temporal Consistency** — Checks if price changed suspiciously since last verification
+4. **Composite Score** — Weighted combination of all layers with severity classification
+
+---
+
+## Community Agent Hub
+
+Pre-built YAML agent templates for common use cases. Run any template from the CLI:
+
+```bash
+# List available templates
+npx wab-agent templates
+
+# Run a template
+npx wab-agent run olive-oil-tunisia --budget 50 --region tunis
+
+# Run with custom server
+npx wab-agent run hotel-direct-booking --server https://yourserver.com --checkin 2025-01-15
+```
+
+### Available Templates
+| Template | Description |
+|---|---|
+| `olive-oil-tunisia` | Find olive oil from small Tunisian farms |
+| `hotel-direct-booking` | Book hotels directly, bypass aggregators |
+| `artisan-marketplace` | Handmade products from independent artisans |
+| `grocery-price-compare` | Compare grocery prices across local stores |
+| `freelancer-direct` | Find freelancers without platform fees |
+| `restaurant-direct` | Order from restaurants without delivery apps |
+| `book-price-scout` | Find books from indie bookstores |
+| `flight-deal-hunter` | Find flights direct from airlines |
+| `electronics-price-tracker` | Track electronics prices with history |
+| `local-services` | Find local service providers |
+| `organic-farm-fresh` | Organic produce direct from farms |
+
+### Create Your Own Template
+
+```yaml
+name: my-custom-agent
+description: My custom agent template
+goal: Find the best deals on custom products
+version: "1.0"
+target_sites:
+  - https://example.com
+parameters:
+  budget:
+    type: number
+    default: 100
+    description: Maximum budget
+actions:
+  - name: discover
+    wab_action: discover
+  - name: search
+    wab_action: execute
+    action_name: search
+    params:
+      query: "{{keyword}}"
+  - name: negotiate
+    wab_action: negotiate
+    params:
+      item_id: "{{item_id}}"
+      max_price: "{{budget}}"
+negotiation:
+  enabled: true
+  max_rounds: 3
+  accept_threshold: 0.85
+fairness_rules:
+  - Prefer independent sellers over large platforms
+  - Verify all prices before purchase
+```
+
+---
+
 ## License
 
 MIT — Free to use, modify, and distribute.