web-agent-bridge 3.0.0 → 3.3.0

package/examples/vision-agent.js

@@ -1,171 +1,171 @@
-/**
- * Example: Vision-based AI Agent using WAB
- *
- * This agent demonstrates how a "vision" or "natural language" AI agent
- * (like OpenAI Operator, Claude Computer Use, etc.) can interact with
- * WAB using descriptive intent instead of explicit action names.
- *
- * The agent describes what it wants to do in natural language,
- * and the IntentResolver matches it to available WAB actions.
- *
- * HOW IT WORKS:
- *   The IntentResolver is a LOCAL, keyword-based NLP mapper — it does NOT
- *   call any external AI/ML API. It scores WAB actions against the intent
- *   string using word overlap, category bonuses, and synonym matching.
- *   This keeps the example dependency-free and easy to understand.
- *
- *   To integrate a real LLM (e.g., OpenAI, Claude), replace the
- *   IntentResolver.resolve() method with an API call that returns the
- *   best-matching action name from the available actions list.
- *
- * Prerequisites:
- *   npm install puppeteer
- *
- * Usage:
- *   node examples/vision-agent.js <url>
- */
-
-const puppeteer = require('puppeteer');
-
-const TARGET_URL = process.argv[2] || 'http://localhost:3000';
-
-// ─── Intent Resolver: maps natural language to WAB actions ────────────
-// This is a lightweight LOCAL resolver (no external API calls).
-// It uses keyword matching, synonym expansion, and category heuristics.
-class IntentResolver {
-  constructor(actions) {
-    this.actions = actions;
-  }
-
-  /**
-   * Find the best matching action for a natural language intent.
-   * Uses keyword matching and description similarity.
-   * @param {string} intent — Natural language description (e.g., "sign up for an account")
-   * @returns {{ action: object, confidence: number } | null}
-   */
-  resolve(intent) {
-    const intentLower = intent.toLowerCase();
-    const intentWords = intentLower.split(/\s+/);
-    let bestMatch = null;
-    let bestScore = 0;
-
-    for (const action of this.actions) {
-      const descLower = (action.description + ' ' + action.name).toLowerCase();
-      let score = 0;
-
-      // Exact name match
-      if (intentLower.includes(action.name.replace(/_/g, ' '))) {
-        score += 5;
-      }
-
-      // Word overlap scoring
-      for (const word of intentWords) {
-        if (word.length < 3) continue;
-        if (descLower.includes(word)) score += 1;
-      }
-
-      // Category bonus
-      if (action.category === 'navigation' && /navigate|go to|open|visit/i.test(intent)) score += 2;
-      if (action.trigger === 'fill_and_submit' && /fill|submit|sign up|register|login|form/i.test(intent)) score += 2;
-      if (action.trigger === 'click' && /click|press|tap|select|button/i.test(intent)) score += 1;
-
-      // Synonym matching
-      const synonyms = {
-        'sign up': ['register', 'create account', 'signup'],
-        'log in': ['login', 'sign in', 'signin'],
-        'search': ['find', 'look for', 'query'],
-        'submit': ['send', 'post', 'confirm'],
-        'navigate': ['go to', 'open', 'visit']
-      };
-
-      for (const [key, syns] of Object.entries(synonyms)) {
-        if (syns.some(s => intentLower.includes(s)) && descLower.includes(key)) score += 3;
-        if (intentLower.includes(key) && syns.some(s => descLower.includes(s))) score += 3;
-      }
-
-      if (score > bestScore) {
-        bestScore = score;
-        bestMatch = action;
-      }
-    }
-
-    if (!bestMatch || bestScore < 1) return null;
-
-    const confidence = Math.min(1, bestScore / 10);
-    return { action: bestMatch, confidence };
-  }
-}
-
-// ─── Vision Agent ─────────────────────────────────────────────────────
-async function main() {
-  console.log(`\n👁️  WAB Vision Agent`);
-  console.log(`   Target: ${TARGET_URL}\n`);
-
-  const browser = await puppeteer.launch({ headless: true });
-  const page = await browser.newPage();
-
-  await page.goto(TARGET_URL, { waitUntil: 'networkidle2' });
-  console.log(`✓ Page loaded: ${await page.title()}`);
-
-  // Wait for bridge
-  await page.waitForFunction(() => typeof window.AICommands !== 'undefined', { timeout: 10000 });
-  console.log('✓ WAB bridge detected\n');
-
-  // Get available actions
-  const actions = await page.evaluate(() => window.AICommands.getActions());
-  const resolver = new IntentResolver(actions);
-
-  console.log(`📋 Available actions: ${actions.length}`);
-  actions.forEach(a => console.log(`   • ${a.name} — ${a.description}`));
-
-  // ── Simulate vision agent intents ─────────────────────────────────
-  const intents = [
-    'I want to create a new account',
-    'Take me to the documentation page',
-    'Click the login button',
-    'Show me the dashboard'
-  ];
-
-  console.log('\n🧠 Resolving natural language intents:\n');
-
-  for (const intent of intents) {
-    const match = resolver.resolve(intent);
-
-    if (match) {
-      console.log(`  Intent: "${intent}"`);
-      console.log(`  → Action: ${match.action.name} (${match.action.trigger})`);
-      console.log(`  → Confidence: ${(match.confidence * 100).toFixed(0)}%`);
-      console.log(`  → Description: ${match.action.description}`);
-
-      // Execute if confidence is high enough
-      if (match.confidence >= 0.3) {
-        const result = await page.evaluate(
-          (name) => window.AICommands.execute(name),
-          match.action.name
-        );
-        console.log(`  → Executed: ${result.success ? '✓' : '✗ ' + result.error}`);
-      } else {
-        console.log(`  → Skipped: confidence too low`);
-      }
-    } else {
-      console.log(`  Intent: "${intent}"`);
-      console.log(`  → No matching action found`);
-    }
-    console.log('');
-  }
-
-  // ── Demonstrate page info with security context ───────────────────
-  const pageInfo = await page.evaluate(() => window.AICommands.getPageInfo());
-  console.log('📊 Page Info:');
-  console.log(`   Security sandbox: ${pageInfo.security.sandboxActive ? '✓ Active' : '✗ Inactive'}`);
-  console.log(`   Self-healing: ${pageInfo.selfHealing.tracked} tracked, ${pageInfo.selfHealing.healed} healed`);
-  console.log(`   Stealth mode: ${pageInfo.stealthMode ? 'Enabled' : 'Disabled'}`);
-
-  console.log('\n✓ Vision agent session complete.');
-  await browser.close();
-}
-
-main().catch((err) => {
-  console.error('Agent error:', err.message);
-  process.exit(1);
-});
+/**
+ * Example: Vision-based AI Agent using WAB
+ *
+ * This agent demonstrates how a "vision" or "natural language" AI agent
+ * (like OpenAI Operator, Claude Computer Use, etc.) can interact with
+ * WAB using descriptive intent instead of explicit action names.
+ *
+ * The agent describes what it wants to do in natural language,
+ * and the IntentResolver matches it to available WAB actions.
+ *
+ * HOW IT WORKS:
+ *   The IntentResolver is a LOCAL, keyword-based NLP mapper — it does NOT
+ *   call any external AI/ML API. It scores WAB actions against the intent
+ *   string using word overlap, category bonuses, and synonym matching.
+ *   This keeps the example dependency-free and easy to understand.
+ *
+ *   To integrate a real LLM (e.g., OpenAI, Claude), replace the
+ *   IntentResolver.resolve() method with an API call that returns the
+ *   best-matching action name from the available actions list.
+ *
+ * Prerequisites:
+ *   npm install puppeteer
+ *
+ * Usage:
+ *   node examples/vision-agent.js <url>
+ */
+
+const puppeteer = require('puppeteer');
+
+const TARGET_URL = process.argv[2] || 'http://localhost:3000';
+
+// ─── Intent Resolver: maps natural language to WAB actions ────────────
+// This is a lightweight LOCAL resolver (no external API calls).
+// It uses keyword matching, synonym expansion, and category heuristics.
+class IntentResolver {
+  constructor(actions) {
+    this.actions = actions;
+  }
+
+  /**
+   * Find the best matching action for a natural language intent.
+   * Uses keyword matching and description similarity.
+   * @param {string} intent — Natural language description (e.g., "sign up for an account")
+   * @returns {{ action: object, confidence: number } | null}
+   */
+  resolve(intent) {
+    const intentLower = intent.toLowerCase();
+    const intentWords = intentLower.split(/\s+/);
+    let bestMatch = null;
+    let bestScore = 0;
+
+    for (const action of this.actions) {
+      const descLower = (action.description + ' ' + action.name).toLowerCase();
+      let score = 0;
+
+      // Exact name match
+      if (intentLower.includes(action.name.replace(/_/g, ' '))) {
+        score += 5;
+      }
+
+      // Word overlap scoring
+      for (const word of intentWords) {
+        if (word.length < 3) continue;
+        if (descLower.includes(word)) score += 1;
+      }
+
+      // Category bonus
+      if (action.category === 'navigation' && /navigate|go to|open|visit/i.test(intent)) score += 2;
+      if (action.trigger === 'fill_and_submit' && /fill|submit|sign up|register|login|form/i.test(intent)) score += 2;
+      if (action.trigger === 'click' && /click|press|tap|select|button/i.test(intent)) score += 1;
+
+      // Synonym matching
+      const synonyms = {
+        'sign up': ['register', 'create account', 'signup'],
+        'log in': ['login', 'sign in', 'signin'],
+        'search': ['find', 'look for', 'query'],
+        'submit': ['send', 'post', 'confirm'],
+        'navigate': ['go to', 'open', 'visit']
+      };
+
+      for (const [key, syns] of Object.entries(synonyms)) {
+        if (syns.some(s => intentLower.includes(s)) && descLower.includes(key)) score += 3;
+        if (intentLower.includes(key) && syns.some(s => descLower.includes(s))) score += 3;
+      }
+
+      if (score > bestScore) {
+        bestScore = score;
+        bestMatch = action;
+      }
+    }
+
+    if (!bestMatch || bestScore < 1) return null;
+
+    const confidence = Math.min(1, bestScore / 10);
+    return { action: bestMatch, confidence };
+  }
+}
+
+// ─── Vision Agent ─────────────────────────────────────────────────────
+async function main() {
+  console.log(`\n👁️  WAB Vision Agent`);
+  console.log(`   Target: ${TARGET_URL}\n`);
+
+  const browser = await puppeteer.launch({ headless: true });
+  const page = await browser.newPage();
+
+  await page.goto(TARGET_URL, { waitUntil: 'networkidle2' });
+  console.log(`✓ Page loaded: ${await page.title()}`);
+
+  // Wait for bridge
+  await page.waitForFunction(() => typeof window.AICommands !== 'undefined', { timeout: 10000 });
+  console.log('✓ WAB bridge detected\n');
+
+  // Get available actions
+  const actions = await page.evaluate(() => window.AICommands.getActions());
+  const resolver = new IntentResolver(actions);
+
+  console.log(`📋 Available actions: ${actions.length}`);
+  actions.forEach(a => console.log(`   • ${a.name} — ${a.description}`));
+
+  // ── Simulate vision agent intents ─────────────────────────────────
+  const intents = [
+    'I want to create a new account',
+    'Take me to the documentation page',
+    'Click the login button',
+    'Show me the dashboard'
+  ];
+
+  console.log('\n🧠 Resolving natural language intents:\n');
+
+  for (const intent of intents) {
+    const match = resolver.resolve(intent);
+
+    if (match) {
+      console.log(`  Intent: "${intent}"`);
+      console.log(`  → Action: ${match.action.name} (${match.action.trigger})`);
+      console.log(`  → Confidence: ${(match.confidence * 100).toFixed(0)}%`);
+      console.log(`  → Description: ${match.action.description}`);
+
+      // Execute if confidence is high enough
+      if (match.confidence >= 0.3) {
+        const result = await page.evaluate(
+          (name) => window.AICommands.execute(name),
+          match.action.name
+        );
+        console.log(`  → Executed: ${result.success ? '✓' : '✗ ' + result.error}`);
+      } else {
+        console.log(`  → Skipped: confidence too low`);
+      }
+    } else {
+      console.log(`  Intent: "${intent}"`);
+      console.log(`  → No matching action found`);
+    }
+    console.log('');
+  }
+
+  // ── Demonstrate page info with security context ───────────────────
+  const pageInfo = await page.evaluate(() => window.AICommands.getPageInfo());
+  console.log('📊 Page Info:');
+  console.log(`   Security sandbox: ${pageInfo.security.sandboxActive ? '✓ Active' : '✗ Inactive'}`);
+  console.log(`   Self-healing: ${pageInfo.selfHealing.tracked} tracked, ${pageInfo.selfHealing.healed} healed`);
+  console.log(`   Stealth mode: ${pageInfo.stealthMode ? 'Enabled' : 'Disabled'}`);
+
+  console.log('\n✓ Vision agent session complete.');
+  await browser.close();
+}
+
+main().catch((err) => {
+  console.error('Agent error:', err.message);
+  process.exit(1);
+});

package/examples/wordpress-elementor/README.md

@@ -1,77 +1,77 @@
-# WordPress + Elementor + WAB
-
-This snippet works with Elementor pages and exposes actions without changing your theme files heavily.
-
-## 1) Add WAB scripts
-
-In WordPress (Elementor Custom Code or theme footer):
-
-```html
-<script src="https://webagentbridge.com/script/wab.min.js"></script>
-<script src="https://webagentbridge.com/script/wab-schema.js"></script>
-<script src="/wp-content/uploads/wab-elementor.js"></script>
-```
-
-## 2) Add this JS file as `wab-elementor.js`
-
-```js
-(function () {
-  if (!window.WAB) return;
-
-  var products = window.WABSchema ? window.WABSchema.scanJsonLd() : [];
-  var suggested = window.WABSchema ? window.WABSchema.suggestActions(products) : [];
-
-  var config = window.WABSchema
-    ? window.WABSchema.mergeWithManual(
-        {
-          getHeroTitle: {
-            description: 'Read Elementor hero heading',
-            run: function () {
-              var title = document.querySelector('.elementor-heading-title');
-              return { title: title ? title.textContent.trim() : null };
-            }
-          },
-          submitVisibleElementorForm: {
-            description: 'Fill and submit the first visible Elementor form',
-            run: function (params) {
-              var form = document.querySelector('.elementor-form');
-              if (!form) return { success: false, error: 'No Elementor form found' };
-
-              var fields = form.querySelectorAll('input, textarea, select');
-              fields.forEach(function (field) {
-                var key = field.name || field.id;
-                if (!key || params[key] == null) return;
-                field.value = String(params[key]);
-                field.dispatchEvent(new Event('input', { bubbles: true }));
-                field.dispatchEvent(new Event('change', { bubbles: true }));
-              });
-
-              var submit = form.querySelector('[type="submit"], button');
-              if (!submit) return { success: false, error: 'No submit button found' };
-              submit.click();
-              return { success: true };
-            }
-          }
-        },
-        suggested
-      )
-    : {
-        actions: {
-          getHeroTitle: {
-            description: 'Read Elementor hero heading',
-            run: function () {
-              var title = document.querySelector('.elementor-heading-title');
-              return { title: title ? title.textContent.trim() : null };
-            }
-          }
-        }
-      };
-
-  window.WAB.init({
-    name: document.title,
-    actions: config.actions
-  });
-})();
-```
-
-This gives agents discoverable actions for Elementor content + schema-derived product helpers.
+# WordPress + Elementor + WAB
+
+This snippet works with Elementor pages and exposes actions without changing your theme files heavily.
+
+## 1) Add WAB scripts
+
+In WordPress (Elementor Custom Code or theme footer):
+
+```html
+<script src="https://webagentbridge.com/script/wab.min.js"></script>
+<script src="https://webagentbridge.com/script/wab-schema.js"></script>
+<script src="/wp-content/uploads/wab-elementor.js"></script>
+```
+
+## 2) Add this JS file as `wab-elementor.js`
+
+```js
+(function () {
+  if (!window.WAB) return;
+
+  var products = window.WABSchema ? window.WABSchema.scanJsonLd() : [];
+  var suggested = window.WABSchema ? window.WABSchema.suggestActions(products) : [];
+
+  var config = window.WABSchema
+    ? window.WABSchema.mergeWithManual(
+        {
+          getHeroTitle: {
+            description: 'Read Elementor hero heading',
+            run: function () {
+              var title = document.querySelector('.elementor-heading-title');
+              return { title: title ? title.textContent.trim() : null };
+            }
+          },
+          submitVisibleElementorForm: {
+            description: 'Fill and submit the first visible Elementor form',
+            run: function (params) {
+              var form = document.querySelector('.elementor-form');
+              if (!form) return { success: false, error: 'No Elementor form found' };
+
+              var fields = form.querySelectorAll('input, textarea, select');
+              fields.forEach(function (field) {
+                var key = field.name || field.id;
+                if (!key || params[key] == null) return;
+                field.value = String(params[key]);
+                field.dispatchEvent(new Event('input', { bubbles: true }));
+                field.dispatchEvent(new Event('change', { bubbles: true }));
+              });
+
+              var submit = form.querySelector('[type="submit"], button');
+              if (!submit) return { success: false, error: 'No submit button found' };
+              submit.click();
+              return { success: true };
+            }
+          }
+        },
+        suggested
+      )
+    : {
+        actions: {
+          getHeroTitle: {
+            description: 'Read Elementor hero heading',
+            run: function () {
+              var title = document.querySelector('.elementor-heading-title');
+              return { title: title ? title.textContent.trim() : null };
+            }
+          }
+        }
+      };
+
+  window.WAB.init({
+    name: document.title,
+    actions: config.actions
+  });
+})();
+```
+
+This gives agents discoverable actions for Elementor content + schema-derived product helpers.

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "web-agent-bridge",
-  "version": "3.0.0",
-  "description": "Open-source middleware that bridges AI agents and websites — providing a standardized command interface for intelligent automation",
+  "version": "3.3.0",
+  "description": "Open AI↔Web protocol & agent platform: standardized command interface, sovereign browser, phone shield, DNS discovery, agent mesh, and unified API gateway for safe AI–website interaction",
+  "author": "Web Agent Bridge <dev@webagentbridge.com>",
   "main": "server/index.js",
   "bin": {
     "web-agent-bridge": "./bin/cli.js",
@@ -19,10 +20,16 @@
     "ai",
     "agent",
     "bridge",
+    "protocol",
+    "platform",
     "automation",
     "web",
-    "middleware",
     "ai-agent",
+    "agent-mesh",
+    "sovereign-browser",
+    "phone-shield",
+    "dns-discovery",
+    "api-gateway",
     "browser-automation",
     "webdriver-bidi"
   ],
@@ -73,7 +80,14 @@
     "ws": "^8.20.0"
   },
   "devDependencies": {
+    "all-contributors-cli": "^6.26.1",
     "jest": "^30.3.0",
     "supertest": "^7.2.2"
+  },
+  "jest": {
+    "testPathIgnorePatterns": [
+      "/node_modules/",
+      "/packages/"
+    ]
   }
 }