web-agent-bridge 3.2.0 → 3.3.0

package/examples/bidi-agent.js

@@ -1,119 +1,119 @@
-/**
- * Example: AI Agent using WebDriver BiDi Protocol via WAB
- *
- * This agent connects to a website using the __wab_bidi interface,
- * which follows WebDriver BiDi conventions for standardized communication.
- *
- * Prerequisites:
- *   npm install puppeteer
- *
- * Usage:
- *   node examples/bidi-agent.js <url>
- */
-
-const puppeteer = require('puppeteer');
-
-const TARGET_URL = process.argv[2] || 'http://localhost:3000';
-
-let commandId = 0;
-
-function bidiCommand(method, params = {}) {
-  return { id: ++commandId, method, params };
-}
-
-async function main() {
-  console.log(`\n🔗 WAB BiDi 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()}`);
-
-  // Check for BiDi interface
-  const hasBiDi = await page.evaluate(() => {
-    return typeof window.__wab_bidi !== 'undefined' && typeof window.__wab_bidi.send === 'function';
-  });
-
-  if (!hasBiDi) {
-    console.log('✗ WAB BiDi interface not found on this page.');
-    await browser.close();
-    return;
-  }
-
-  console.log('✓ WAB BiDi interface detected\n');
-
-  // Step 1: Get BiDi context
-  const context = await page.evaluate(() => window.__wab_bidi.getContext());
-  console.log('📋 BiDi Context:');
-  console.log(`   URL: ${context.context.url}`);
-  console.log(`   Title: ${context.context.title}`);
-  console.log(`   Version: ${context.version}`);
-  console.log(`   Tier: ${context.capabilities.tier}`);
-  console.log(`   Capabilities: ${context.capabilities.actions.length} actions\n`);
-
-  // Step 2: Get actions via BiDi command
-  const actionsResult = await page.evaluate((cmd) => {
-    return window.__wab_bidi.send(cmd);
-  }, bidiCommand('wab.getActions'));
-
-  console.log(`🔍 Actions (via BiDi):`);
-  if (actionsResult.result) {
-    actionsResult.result.forEach((action) => {
-      console.log(`   • ${action.name} [${action.trigger}] — ${action.description}`);
-    });
-  }
-
-  // Step 3: Get page info via BiDi
-  const infoResult = await page.evaluate((cmd) => {
-    return window.__wab_bidi.send(cmd);
-  }, bidiCommand('wab.getPageInfo'));
-
-  console.log('\n📄 Page Info (via BiDi):');
-  if (infoResult.result) {
-    console.log(`   Title: ${infoResult.result.title}`);
-    console.log(`   Domain: ${infoResult.result.domain}`);
-    console.log(`   Bridge: v${infoResult.result.bridgeVersion}`);
-  }
-
-  // Step 4: Read content via BiDi command
-  const readResult = await page.evaluate((cmd) => {
-    return window.__wab_bidi.send(cmd);
-  }, bidiCommand('wab.readContent', { selector: 'h1' }));
-
-  if (readResult.result && readResult.result.success) {
-    console.log(`\n📖 Content: "${readResult.result.text}"`);
-  }
-
-  // Step 5: Execute an action via BiDi
-  const actions = actionsResult.result || [];
-  const firstAction = actions.find((a) => a.trigger === 'click');
-  if (firstAction) {
-    console.log(`\n▶ Executing via BiDi: "${firstAction.name}"`);
-    const execResult = await page.evaluate((cmd) => {
-      return window.__wab_bidi.send(cmd);
-    }, bidiCommand('wab.executeAction', { name: firstAction.name }));
-
-    const r = execResult.result;
-    console.log(`   Result: ${r && r.success ? '✓ Success' : '✗ ' + (r?.error || 'Unknown error')}`);
-  }
-
-  // Step 6: Test error handling
-  console.log('\n🧪 Testing error handling:');
-  const errorResult = await page.evaluate((cmd) => {
-    return window.__wab_bidi.send(cmd);
-  }, bidiCommand('wab.unknownMethod'));
-
-  if (errorResult.error) {
-    console.log(`   ✓ Unknown command handled: ${errorResult.error.code} — ${errorResult.error.message}`);
-  }
-
-  console.log('\n✓ BiDi agent session complete.');
-  await browser.close();
-}
-
-main().catch((err) => {
-  console.error('Agent error:', err.message);
-  process.exit(1);
-});
+/**
+ * Example: AI Agent using WebDriver BiDi Protocol via WAB
+ *
+ * This agent connects to a website using the __wab_bidi interface,
+ * which follows WebDriver BiDi conventions for standardized communication.
+ *
+ * Prerequisites:
+ *   npm install puppeteer
+ *
+ * Usage:
+ *   node examples/bidi-agent.js <url>
+ */
+
+const puppeteer = require('puppeteer');
+
+const TARGET_URL = process.argv[2] || 'http://localhost:3000';
+
+let commandId = 0;
+
+function bidiCommand(method, params = {}) {
+  return { id: ++commandId, method, params };
+}
+
+async function main() {
+  console.log(`\n🔗 WAB BiDi 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()}`);
+
+  // Check for BiDi interface
+  const hasBiDi = await page.evaluate(() => {
+    return typeof window.__wab_bidi !== 'undefined' && typeof window.__wab_bidi.send === 'function';
+  });
+
+  if (!hasBiDi) {
+    console.log('✗ WAB BiDi interface not found on this page.');
+    await browser.close();
+    return;
+  }
+
+  console.log('✓ WAB BiDi interface detected\n');
+
+  // Step 1: Get BiDi context
+  const context = await page.evaluate(() => window.__wab_bidi.getContext());
+  console.log('📋 BiDi Context:');
+  console.log(`   URL: ${context.context.url}`);
+  console.log(`   Title: ${context.context.title}`);
+  console.log(`   Version: ${context.version}`);
+  console.log(`   Tier: ${context.capabilities.tier}`);
+  console.log(`   Capabilities: ${context.capabilities.actions.length} actions\n`);
+
+  // Step 2: Get actions via BiDi command
+  const actionsResult = await page.evaluate((cmd) => {
+    return window.__wab_bidi.send(cmd);
+  }, bidiCommand('wab.getActions'));
+
+  console.log(`🔍 Actions (via BiDi):`);
+  if (actionsResult.result) {
+    actionsResult.result.forEach((action) => {
+      console.log(`   • ${action.name} [${action.trigger}] — ${action.description}`);
+    });
+  }
+
+  // Step 3: Get page info via BiDi
+  const infoResult = await page.evaluate((cmd) => {
+    return window.__wab_bidi.send(cmd);
+  }, bidiCommand('wab.getPageInfo'));
+
+  console.log('\n📄 Page Info (via BiDi):');
+  if (infoResult.result) {
+    console.log(`   Title: ${infoResult.result.title}`);
+    console.log(`   Domain: ${infoResult.result.domain}`);
+    console.log(`   Bridge: v${infoResult.result.bridgeVersion}`);
+  }
+
+  // Step 4: Read content via BiDi command
+  const readResult = await page.evaluate((cmd) => {
+    return window.__wab_bidi.send(cmd);
+  }, bidiCommand('wab.readContent', { selector: 'h1' }));
+
+  if (readResult.result && readResult.result.success) {
+    console.log(`\n📖 Content: "${readResult.result.text}"`);
+  }
+
+  // Step 5: Execute an action via BiDi
+  const actions = actionsResult.result || [];
+  const firstAction = actions.find((a) => a.trigger === 'click');
+  if (firstAction) {
+    console.log(`\n▶ Executing via BiDi: "${firstAction.name}"`);
+    const execResult = await page.evaluate((cmd) => {
+      return window.__wab_bidi.send(cmd);
+    }, bidiCommand('wab.executeAction', { name: firstAction.name }));
+
+    const r = execResult.result;
+    console.log(`   Result: ${r && r.success ? '✓ Success' : '✗ ' + (r?.error || 'Unknown error')}`);
+  }
+
+  // Step 6: Test error handling
+  console.log('\n🧪 Testing error handling:');
+  const errorResult = await page.evaluate((cmd) => {
+    return window.__wab_bidi.send(cmd);
+  }, bidiCommand('wab.unknownMethod'));
+
+  if (errorResult.error) {
+    console.log(`   ✓ Unknown command handled: ${errorResult.error.code} — ${errorResult.error.message}`);
+  }
+
+  console.log('\n✓ BiDi agent session complete.');
+  await browser.close();
+}
+
+main().catch((err) => {
+  console.error('Agent error:', err.message);
+  process.exit(1);
+});

package/examples/cross-site-agent.js

@@ -1,91 +1,91 @@
-/**
- * Example: Cross-Site Agent Orchestration
- *
- * One agent manages multiple WAB-enabled sites simultaneously.
- * Compares prices, aggregates product data, and finds the best deal.
- *
- * Prerequisites:
- *   npm install puppeteer web-agent-bridge-sdk
- *
- * Usage:
- *   node examples/cross-site-agent.js site1.com site2.com site3.com
- */
-
-const { WABMultiAgent } = require('../sdk');
-
-const sites = process.argv.slice(2);
-if (sites.length < 2) {
-  console.log('Usage: node cross-site-agent.js <url1> <url2> [url3 ...]');
-  console.log('Example: node cross-site-agent.js https://shop1.com https://shop2.com');
-  process.exit(1);
-}
-
-// Ensure URLs have protocol
-const urls = sites.map((s) => (s.startsWith('http') ? s : `https://${s}`));
-
-async function main() {
-  console.log('\n🌐 WAB Cross-Site Agent Orchestration');
-  console.log(`   Sites: ${urls.length}\n`);
-
-  // 1. Create multi-agent and connect to all sites
-  const multiAgent = new WABMultiAgent(urls, {
-    timeout: 20000,
-    headless: true
-  });
-
-  console.log('⏳ Launching browsers and connecting...');
-  const { connected, failed } = await multiAgent.launch();
-
-  for (const site of connected) console.log(`  ✓ Connected: ${site}`);
-  for (const site of failed) console.log(`  ✗ Failed: ${site}`);
-
-  if (connected.length === 0) {
-    console.log('\n✗ No sites connected. Exiting.');
-    await multiAgent.close();
-    return;
-  }
-
-  // 2. Discover all sites
-  console.log('\n📡 Discovering WAB capabilities...');
-  const discoveries = await multiAgent.discoverAll();
-  for (const d of discoveries) {
-    console.log(`  ${d.site}: ${d.actions.length} actions`);
-  }
-
-  // 3. Compare prices for a product
-  console.log('\n💰 Comparing prices...');
-  const comparison = await multiAgent.comparePrices('product-sku');
-  for (const r of comparison.results) {
-    if (r.price != null) {
-      console.log(`  ${r.site}: ${r.currency} ${r.price.toFixed(2)} — ${r.product}`);
-    } else {
-      console.log(`  ${r.site}: ${r.error || 'No price data'}`);
-    }
-  }
-
-  if (comparison.cheapest) {
-    console.log(`\n🏆 Best deal: ${comparison.cheapest.site}`);
-    console.log(`   Price: ${comparison.cheapest.currency} ${comparison.cheapest.price.toFixed(2)}`);
-    if (comparison.savings != null) {
-      console.log(`   You save: ${comparison.cheapest.currency} ${comparison.savings.toFixed(2)}`);
-    }
-  }
-
-  // 4. Execute a common action across all sites
-  console.log('\n🔄 Executing getPageInfo on all sites...');
-  const infos = await multiAgent.executeAll('getPageInfo');
-  for (const info of infos) {
-    if (info.status === 'fulfilled' && info.value) {
-      console.log(`  ${info.site}: "${info.value.title}" (v${info.value.bridgeVersion})`);
-    }
-  }
-
-  // 5. Cleanup
-  await multiAgent.close();
-  console.log('\n✓ All sessions closed. Done!\n');
-}
-
-main().catch((err) => {
-  console.error('Error:', err.message);
-  process.exit(1);
-});
+/**
+ * Example: Cross-Site Agent Orchestration
+ *
+ * One agent manages multiple WAB-enabled sites simultaneously.
+ * Compares prices, aggregates product data, and finds the best deal.
+ *
+ * Prerequisites:
+ *   npm install puppeteer web-agent-bridge-sdk
+ *
+ * Usage:
+ *   node examples/cross-site-agent.js site1.com site2.com site3.com
+ */
+
+const { WABMultiAgent } = require('../sdk');
+
+const sites = process.argv.slice(2);
+if (sites.length < 2) {
+  console.log('Usage: node cross-site-agent.js <url1> <url2> [url3 ...]');
+  console.log('Example: node cross-site-agent.js https://shop1.com https://shop2.com');
+  process.exit(1);
+}
+
+// Ensure URLs have protocol
+const urls = sites.map((s) => (s.startsWith('http') ? s : `https://${s}`));
+
+async function main() {
+  console.log('\n🌐 WAB Cross-Site Agent Orchestration');
+  console.log(`   Sites: ${urls.length}\n`);
+
+  // 1. Create multi-agent and connect to all sites
+  const multiAgent = new WABMultiAgent(urls, {
+    timeout: 20000,
+    headless: true
+  });
+
+  console.log('⏳ Launching browsers and connecting...');
+  const { connected, failed } = await multiAgent.launch();
+
+  for (const site of connected) console.log(`  ✓ Connected: ${site}`);
+  for (const site of failed) console.log(`  ✗ Failed: ${site}`);
+
+  if (connected.length === 0) {
+    console.log('\n✗ No sites connected. Exiting.');
+    await multiAgent.close();
+    return;
+  }
+
+  // 2. Discover all sites
+  console.log('\n📡 Discovering WAB capabilities...');
+  const discoveries = await multiAgent.discoverAll();
+  for (const d of discoveries) {
+    console.log(`  ${d.site}: ${d.actions.length} actions`);
+  }
+
+  // 3. Compare prices for a product
+  console.log('\n💰 Comparing prices...');
+  const comparison = await multiAgent.comparePrices('product-sku');
+  for (const r of comparison.results) {
+    if (r.price != null) {
+      console.log(`  ${r.site}: ${r.currency} ${r.price.toFixed(2)} — ${r.product}`);
+    } else {
+      console.log(`  ${r.site}: ${r.error || 'No price data'}`);
+    }
+  }
+
+  if (comparison.cheapest) {
+    console.log(`\n🏆 Best deal: ${comparison.cheapest.site}`);
+    console.log(`   Price: ${comparison.cheapest.currency} ${comparison.cheapest.price.toFixed(2)}`);
+    if (comparison.savings != null) {
+      console.log(`   You save: ${comparison.cheapest.currency} ${comparison.savings.toFixed(2)}`);
+    }
+  }
+
+  // 4. Execute a common action across all sites
+  console.log('\n🔄 Executing getPageInfo on all sites...');
+  const infos = await multiAgent.executeAll('getPageInfo');
+  for (const info of infos) {
+    if (info.status === 'fulfilled' && info.value) {
+      console.log(`  ${info.site}: "${info.value.title}" (v${info.value.bridgeVersion})`);
+    }
+  }
+
+  // 5. Cleanup
+  await multiAgent.close();
+  console.log('\n✓ All sessions closed. Done!\n');
+}
+
+main().catch((err) => {
+  console.error('Error:', err.message);
+  process.exit(1);
+});

package/examples/mcp-agent.js

@@ -1,94 +1,94 @@
-/**
- * Example: Using WAB sites via the MCP adapter
- *
- * The WAB-MCP adapter exposes every WAB site action as an MCP tool,
- * so any MCP-compatible AI agent (Claude, GPT, etc.) can interact
- * with WAB-enabled websites through a uniform tool interface.
- *
- * Usage:
- *   node examples/mcp-agent.js <site-url>
- */
-
-const { WABMCPAdapter } = require('../wab-mcp-adapter');
-
-const TARGET = process.argv[2] || 'http://localhost:3000';
-
-async function main() {
-  console.log('\n  WAB → MCP Adapter Demo');
-  console.log(`  Target: ${TARGET}\n`);
-
-  const adapter = new WABMCPAdapter({
-    siteUrl: TARGET,
-    transport: 'http'
-  });
-
-  // Step 1: Discover site capabilities
-  console.log('1. Discovering WAB capabilities...');
-  const discovery = await adapter.discover();
-  if (discovery) {
-    console.log(`   Provider: ${discovery.provider?.name || 'unknown'}`);
-    console.log(`   Domain:   ${discovery.provider?.domain || 'unknown'}`);
-    console.log(`   Tier:     ${discovery.capabilities?.tier || 'free'}`);
-    console.log(`   Features: ${(discovery.capabilities?.features || []).join(', ')}`);
-    if (discovery.fairness) {
-      console.log(`   Fairness: score=${discovery.fairness.neutrality_score}, independent=${discovery.fairness.is_independent}`);
-    }
-  } else {
-    console.log('   No discovery document found (site may not have WAB configured)');
-  }
-
-  // Step 2: List MCP tools
-  console.log('\n2. Available MCP tools:');
-  const tools = await adapter.getTools();
-  tools.forEach(tool => {
-    const params = tool.input_schema?.properties
-      ? Object.keys(tool.input_schema.properties).join(', ')
-      : 'none';
-    console.log(`   - ${tool.name}: ${tool.description} (params: ${params})`);
-  });
-
-  // Step 3: Execute built-in tools
-  console.log('\n3. Executing wab_get_page_info...');
-  try {
-    const infoResult = await adapter.executeTool('wab_get_page_info', {});
-    const info = infoResult.content;
-    if (infoResult.is_error) {
-      console.log(`   Error: ${info.error}`);
-    } else {
-      console.log(`   Title:   ${info.title || 'N/A'}`);
-      console.log(`   Version: ${info.bridgeVersion || 'N/A'}`);
-      console.log(`   Domain:  ${info.domain || 'N/A'}`);
-    }
-  } catch (err) {
-    console.log(`   Error: ${err.message}`);
-  }
-
-  // Step 4: Search the fairness registry
-  console.log('\n4. Fairness-weighted search (demo):');
-  try {
-    const searchResult = await adapter.executeTool('wab_fairness_search', {
-      query: 'e-commerce',
-      limit: 5
-    });
-    const search = searchResult.content;
-    if (searchResult.is_error) {
-      console.log(`   Error: ${search.error}`);
-    } else if (search.results?.length) {
-      search.results.forEach(r => {
-        console.log(`   - ${r.name} (${r.domain}) — score: ${r.final_score}`);
-      });
-    } else {
-      console.log('   No sites registered in directory yet.');
-    }
-  } catch (err) {
-    console.log(`   Registry not available: ${err.message}`);
-  }
-
-  console.log('\nDone. In a real MCP integration, these tools would be');
-  console.log('exposed to Claude/GPT via the MCP tool-use protocol.\n');
-}
-
-main().catch(err => {
-  console.error('Error:', err.message);
-  process.exit(1);
-});
+/**
+ * Example: Using WAB sites via the MCP adapter
+ *
+ * The WAB-MCP adapter exposes every WAB site action as an MCP tool,
+ * so any MCP-compatible AI agent (Claude, GPT, etc.) can interact
+ * with WAB-enabled websites through a uniform tool interface.
+ *
+ * Usage:
+ *   node examples/mcp-agent.js <site-url>
+ */
+
+const { WABMCPAdapter } = require('../wab-mcp-adapter');
+
+const TARGET = process.argv[2] || 'http://localhost:3000';
+
+async function main() {
+  console.log('\n  WAB → MCP Adapter Demo');
+  console.log(`  Target: ${TARGET}\n`);
+
+  const adapter = new WABMCPAdapter({
+    siteUrl: TARGET,
+    transport: 'http'
+  });
+
+  // Step 1: Discover site capabilities
+  console.log('1. Discovering WAB capabilities...');
+  const discovery = await adapter.discover();
+  if (discovery) {
+    console.log(`   Provider: ${discovery.provider?.name || 'unknown'}`);
+    console.log(`   Domain:   ${discovery.provider?.domain || 'unknown'}`);
+    console.log(`   Tier:     ${discovery.capabilities?.tier || 'free'}`);
+    console.log(`   Features: ${(discovery.capabilities?.features || []).join(', ')}`);
+    if (discovery.fairness) {
+      console.log(`   Fairness: score=${discovery.fairness.neutrality_score}, independent=${discovery.fairness.is_independent}`);
+    }
+  } else {
+    console.log('   No discovery document found (site may not have WAB configured)');
+  }
+
+  // Step 2: List MCP tools
+  console.log('\n2. Available MCP tools:');
+  const tools = await adapter.getTools();
+  tools.forEach(tool => {
+    const params = tool.input_schema?.properties
+      ? Object.keys(tool.input_schema.properties).join(', ')
+      : 'none';
+    console.log(`   - ${tool.name}: ${tool.description} (params: ${params})`);
+  });
+
+  // Step 3: Execute built-in tools
+  console.log('\n3. Executing wab_get_page_info...');
+  try {
+    const infoResult = await adapter.executeTool('wab_get_page_info', {});
+    const info = infoResult.content;
+    if (infoResult.is_error) {
+      console.log(`   Error: ${info.error}`);
+    } else {
+      console.log(`   Title:   ${info.title || 'N/A'}`);
+      console.log(`   Version: ${info.bridgeVersion || 'N/A'}`);
+      console.log(`   Domain:  ${info.domain || 'N/A'}`);
+    }
+  } catch (err) {
+    console.log(`   Error: ${err.message}`);
+  }
+
+  // Step 4: Search the fairness registry
+  console.log('\n4. Fairness-weighted search (demo):');
+  try {
+    const searchResult = await adapter.executeTool('wab_fairness_search', {
+      query: 'e-commerce',
+      limit: 5
+    });
+    const search = searchResult.content;
+    if (searchResult.is_error) {
+      console.log(`   Error: ${search.error}`);
+    } else if (search.results?.length) {
+      search.results.forEach(r => {
+        console.log(`   - ${r.name} (${r.domain}) — score: ${r.final_score}`);
+      });
+    } else {
+      console.log('   No sites registered in directory yet.');
+    }
+  } catch (err) {
+    console.log(`   Registry not available: ${err.message}`);
+  }
+
+  console.log('\nDone. In a real MCP integration, these tools would be');
+  console.log('exposed to Claude/GPT via the MCP tool-use protocol.\n');
+}
+
+main().catch(err => {
+  console.error('Error:', err.message);
+  process.exit(1);
+});