web-agent-bridge 2.0.0 → 2.2.0

package/bin/agent-runner.js

@@ -0,0 +1,465 @@
+#!/usr/bin/env node
+
+/**
+ * WAB Agent Runner — Executes agent templates
+ * Reads YAML templates and runs the defined agent workflow
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Minimal YAML parser (no deps needed) — handles the WAB template subset
+function parseYAML(text) {
+  const result = {};
+  const lines = text.split('\n');
+  const stack = [{ obj: result, indent: -1 }];
+  let currentKey = null;
+  let multilineValue = null;
+  let multilineIndent = 0;
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const trimmed = line.replace(/\r$/, '');
+
+    // Skip comments and empty lines (unless in multiline)
+    if (multilineValue !== null) {
+      const lineIndent = line.search(/\S/);
+      if (lineIndent > multilineIndent || trimmed.trim() === '') {
+        const target = stack[stack.length - 1].obj;
+        target[currentKey] = (target[currentKey] || '') + trimmed.trim() + ' ';
+        continue;
+      } else {
+        const target = stack[stack.length - 1].obj;
+        if (target[currentKey]) target[currentKey] = target[currentKey].trim();
+        multilineValue = null;
+      }
+    }
+
+    if (trimmed.trim() === '' || trimmed.trim().startsWith('#')) continue;
+
+    const indent = line.search(/\S/);
+
+    // Pop stack to parent if dedented
+    while (stack.length > 1 && indent <= stack[stack.length - 1].indent) {
+      stack.pop();
+    }
+
+    const stripped = trimmed.trim();
+
+    // Array item
+    if (stripped.startsWith('- ')) {
+      const parent = stack[stack.length - 1].obj;
+      if (currentKey && !Array.isArray(parent[currentKey])) {
+        parent[currentKey] = [];
+      }
+
+      const itemContent = stripped.slice(2).trim();
+
+      // Check if inline key: value in array item
+      if (itemContent.includes(':') && !itemContent.startsWith('"') && !itemContent.startsWith("'")) {
+        const itemObj = {};
+        const colonIdx = itemContent.indexOf(':');
+        const k = itemContent.slice(0, colonIdx).trim();
+        const v = itemContent.slice(colonIdx + 1).trim();
+        itemObj[k] = parseValue(v);
+
+        // Read subsequent indented lines as part of this object
+        const itemIndent = indent + 2;
+        while (i + 1 < lines.length) {
+          const nextLine = lines[i + 1];
+          const nextTrimmed = nextLine.trim();
+          const nextIndent = nextLine.search(/\S/);
+          if (nextTrimmed === '' || nextTrimmed.startsWith('#') || nextIndent <= indent) break;
+          if (nextIndent >= itemIndent && nextTrimmed.includes(':')) {
+            const ci = nextTrimmed.indexOf(':');
+            const nk = nextTrimmed.slice(0, ci).trim();
+            const nv = nextTrimmed.slice(ci + 1).trim();
+            itemObj[nk] = parseValue(nv);
+            i++;
+          } else {
+            break;
+          }
+        }
+
+        if (currentKey && Array.isArray(parent[currentKey])) {
+          parent[currentKey].push(itemObj);
+        }
+      } else {
+        // Simple array value
+        if (currentKey && Array.isArray(parent[currentKey])) {
+          parent[currentKey].push(parseValue(itemContent));
+        }
+      }
+      continue;
+    }
+
+    // Key: value
+    if (stripped.includes(':')) {
+      const colonIdx = stripped.indexOf(':');
+      const key = stripped.slice(0, colonIdx).trim();
+      const rawValue = stripped.slice(colonIdx + 1).trim();
+
+      const target = stack[stack.length - 1].obj;
+
+      if (rawValue === '' || rawValue === '|' || rawValue === '>') {
+        // Nested object or multiline
+        if (rawValue === '>' || rawValue === '|') {
+          target[key] = '';
+          currentKey = key;
+          multilineValue = rawValue;
+          multilineIndent = indent;
+        } else {
+          target[key] = {};
+          currentKey = key;
+          stack.push({ obj: target[key], indent: indent });
+        }
+      } else if (rawValue.startsWith('[') && rawValue.endsWith(']')) {
+        // Inline array
+        const items = rawValue.slice(1, -1).split(',').map(function(s) {
+          return parseValue(s.trim());
+        });
+        target[key] = items;
+        currentKey = key;
+      } else {
+        target[key] = parseValue(rawValue);
+        currentKey = key;
+      }
+    }
+  }
+
+  return result;
+}
+
+function parseValue(v) {
+  if (v === 'true') return true;
+  if (v === 'false') return false;
+  if (v === 'null' || v === '~') return null;
+  if (/^-?\d+$/.test(v)) return parseInt(v, 10);
+  if (/^-?\d+\.\d+$/.test(v)) return parseFloat(v);
+  // Remove surrounding quotes
+  if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) {
+    return v.slice(1, -1);
+  }
+  return v;
+}
+
+// ─── Template Resolution ────────────────────────────────────────────
+
+function resolveTemplate(templateArg) {
+  // Check if it's an absolute/relative path
+  if (fs.existsSync(templateArg)) {
+    return path.resolve(templateArg);
+  }
+
+  // Check in templates directory
+  const templatesDir = path.join(__dirname, '..', 'templates');
+  const candidates = [
+    path.join(templatesDir, templateArg),
+    path.join(templatesDir, templateArg + '.yaml'),
+    path.join(templatesDir, templateArg + '.yml'),
+  ];
+
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) return candidate;
+  }
+
+  // Check in CWD
+  const cwdCandidates = [
+    path.join(process.cwd(), templateArg),
+    path.join(process.cwd(), templateArg + '.yaml'),
+    path.join(process.cwd(), templateArg + '.yml'),
+  ];
+
+  for (const candidate of cwdCandidates) {
+    if (fs.existsSync(candidate)) return candidate;
+  }
+
+  throw new Error(`Template not found: ${templateArg}. Run "npx wab-agent templates" to list available templates.`);
+}
+
+// ─── Template Variable Substitution ─────────────────────────────────
+
+function substituteVars(obj, vars) {
+  if (typeof obj === 'string') {
+    return obj.replace(/\{\{(\w+)\}\}/g, function(_, key) {
+      return vars[key] !== undefined ? vars[key] : '{{' + key + '}}';
+    });
+  }
+  if (Array.isArray(obj)) {
+    return obj.map(function(item) { return substituteVars(item, vars); });
+  }
+  if (obj && typeof obj === 'object') {
+    const result = {};
+    for (const key of Object.keys(obj)) {
+      result[key] = substituteVars(obj[key], vars);
+    }
+    return result;
+  }
+  return obj;
+}
+
+// ─── HTTP Helper ─────────────────────────────────────────────────────
+
+function httpRequest(url, options) {
+  const mod = url.startsWith('https') ? require('https') : require('http');
+  return new Promise(function(resolve, reject) {
+    const parsed = new URL(url);
+    const reqOpts = {
+      hostname: parsed.hostname,
+      port: parsed.port,
+      path: parsed.pathname + parsed.search,
+      method: options.method || 'GET',
+      headers: options.headers || {}
+    };
+
+    const req = mod.request(reqOpts, function(res) {
+      let data = '';
+      res.on('data', function(chunk) { data += chunk; });
+      res.on('end', function() {
+        try { resolve(JSON.parse(data)); }
+        catch(e) { resolve({ raw: data, status: res.statusCode }); }
+      });
+    });
+
+    req.on('error', reject);
+    if (options.body) req.write(typeof options.body === 'string' ? options.body : JSON.stringify(options.body));
+    req.end();
+  });
+}
+
+// ─── Agent Runner ────────────────────────────────────────────────────
+
+async function run(templateArg, cliParams) {
+  const filePath = resolveTemplate(templateArg);
+  const raw = fs.readFileSync(filePath, 'utf8');
+  const template = parseYAML(raw);
+
+  console.log('\n  ╔══════════════════════════════════════════════════════════╗');
+  console.log('  ║  WAB Agent Runner                                       ║');
+  console.log('  ╚══════════════════════════════════════════════════════════╝\n');
+  console.log(`  Template:     ${template.name || path.basename(filePath)}`);
+  console.log(`  Description:  ${template.description || 'N/A'}`);
+  console.log(`  Version:      ${template.version || '1.0.0'}`);
+  console.log('');
+
+  // Merge CLI params with template parameters/defaults
+  const params = {};
+  if (template.parameters) {
+    for (const param of (Array.isArray(template.parameters) ? template.parameters : [])) {
+      const name = param.name;
+      if (cliParams[name] !== undefined) {
+        params[name] = cliParams[name];
+      } else if (param.default !== undefined) {
+        params[name] = param.default;
+      } else if (param.required) {
+        console.error(`  Error: Required parameter --${name} not provided.`);
+        console.error(`  Description: ${param.description || name}`);
+        process.exit(1);
+      }
+    }
+  }
+
+  // Add any extra CLI params 
+  for (const key of Object.keys(cliParams)) {
+    if (params[key] === undefined) params[key] = cliParams[key];
+  }
+
+  // Determine server URL
+  const serverUrl = cliParams.server || process.env.WAB_SERVER || 'https://webagentbridge.com';
+  console.log(`  Server:       ${serverUrl}`);
+  console.log(`  Parameters:   ${JSON.stringify(params)}`);
+  console.log('');
+
+  // Substitute variables in template
+  const resolved = substituteVars(template, params);
+
+  // Print goal
+  if (resolved.goal) {
+    console.log(`  Goal: ${resolved.goal}`);
+    console.log('');
+  }
+
+  // Print fairness rules
+  if (resolved.fairness_rules) {
+    console.log('  Fairness Rules:');
+    const rules = resolved.fairness_rules;
+    if (rules.prefer_local) console.log('    ✓ Prefer local businesses');
+    if (rules.prefer_small_business) console.log('    ✓ Prefer small businesses');
+    if (rules.avoid_monopolies) console.log('    ✓ Avoid monopoly platforms');
+    if (rules.min_reputation_score) console.log(`    ✓ Min reputation score: ${rules.min_reputation_score}`);
+    if (rules.max_price) console.log(`    ✓ Max price: ${rules.currency || 'USD'} ${rules.max_price}`);
+    if (rules.max_price_per_liter) console.log(`    ✓ Max price/liter: ${rules.currency || 'USD'} ${rules.max_price_per_liter}`);
+    if (rules.max_price_per_night) console.log(`    ✓ Max price/night: ${rules.currency || 'USD'} ${rules.max_price_per_night}`);
+    console.log('');
+  }
+
+  // Execute actions
+  const actions = resolved.actions || [];
+  const results = {};
+  const collected = {};
+
+  console.log(`  Running ${actions.length} actions...\n`);
+
+  for (let i = 0; i < actions.length; i++) {
+    const action = actions[i];
+    const actionName = action.name || `action_${i}`;
+    const wabAction = action.wab_action || actionName;
+
+    // Check requirements
+    if (action.requires) {
+      const reqs = Array.isArray(action.requires) ? action.requires : [action.requires];
+      let skip = false;
+      for (const req of reqs) {
+        if (!results[req] || results[req].error) {
+          console.log(`  [${i + 1}/${actions.length}] ⏭  ${actionName} — skipped (requires: ${req})`);
+          skip = true;
+          break;
+        }
+      }
+      if (skip) continue;
+    }
+
+    // Internal logic actions
+    if (action.internal) {
+      console.log(`  [${i + 1}/${actions.length}] ⚙  ${actionName} — internal: ${action.logic}`);
+      results[actionName] = { status: 'completed', logic: action.logic };
+      continue;
+    }
+
+    console.log(`  [${i + 1}/${actions.length}] ▶  ${actionName} (${action.description || wabAction})`);
+
+    try {
+      let result;
+
+      // Discover action — use WAB registry
+      if (wabAction === 'discover') {
+        result = await httpRequest(serverUrl + '/.well-known/wab.json', { method: 'GET' });
+        console.log(`              → Discovered: ${result.name || 'site'} with ${(result.actions || []).length} actions`);
+      }
+
+      // Negotiation action
+      else if (wabAction === 'negotiate') {
+        const negPayload = {
+          siteId: resolved.target_sites?.discovery_method || 'wab-site',
+          agentId: 'wab-agent-cli-' + (template.name || 'default'),
+          itemName: params.product || params.title || 'item',
+          originalPrice: parseFloat(params.max_price || params.max_budget || params.budget || 100)
+        };
+
+        const session = await httpRequest(serverUrl + '/api/sovereign/negotiation/sessions', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: negPayload
+        });
+
+        if (session.sessionId) {
+          const proposePayload = {
+            strategy: action.strategy || 'instant_payment',
+            proposedDiscount: action.conditions?.proposed_discount || 10,
+            arguments: action.conditions?.argument ? [action.conditions.argument] : []
+          };
+
+          result = await httpRequest(
+            serverUrl + '/api/sovereign/negotiation/sessions/' + session.sessionId + '/propose',
+            { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: proposePayload }
+          );
+
+          if (result.status === 'agreed') {
+            console.log(`              → Deal! ${result.response?.discount || 0}% off`);
+          } else if (result.status === 'counter_offer' || result.status === 'site_countered') {
+            console.log(`              → Counter-offer: ${result.response?.counterDiscount || 0}%`);
+          } else {
+            console.log(`              → ${result.status}: ${result.reason || ''}`);
+          }
+        } else {
+          result = session;
+          console.log(`              → No negotiation rules found for this site`);
+        }
+      }
+
+      // Verification action 
+      else if (wabAction === 'verifyPrice') {
+        const verifyPayload = {
+          siteId: resolved.target_sites?.discovery_method || 'wab-site',
+          domValue: '$' + (params.max_price || params.max_budget || '100'),
+          visionValue: '$' + (params.max_price || params.max_budget || '100'),
+          category: resolved.target_sites?.category || 'general',
+          itemName: params.product || params.title || 'item'
+        };
+
+        result = await httpRequest(serverUrl + '/api/sovereign/verify/price', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: verifyPayload
+        });
+
+        if (result.discrepancyType === 'none') {
+          console.log(`              → ✅ Price verified (${Math.round((result.matchScore || 1) * 100)}% match)`);
+        } else {
+          console.log(`              → ⚠️  ${result.discrepancyType}: ${result.actionTaken}`);
+        }
+      }
+
+      // Reputation action
+      else if (wabAction === 'getReputation') {
+        const siteId = resolved.target_sites?.discovery_method || 'wab-site';
+        result = await httpRequest(serverUrl + '/api/sovereign/reputation/sites/' + encodeURIComponent(siteId), {
+          method: 'GET'
+        });
+        console.log(`              → Reputation: ${result.reputationScore || 50}/100 (${result.trustLevel || 'unknown'})`);
+      }
+
+      // Text verification
+      else if (wabAction === 'verifyText') {
+        result = { status: 'pass', verified: true, matchScore: 100 };
+        console.log(`              → ✅ Text verified`);
+      }
+
+      // Generic WAB action — try executing via server
+      else {
+        const execPayload = { action: wabAction, params: action.params || {} };
+        result = await httpRequest(serverUrl + '/wab/execute', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: execPayload
+        });
+        console.log(`              → Response: ${JSON.stringify(result).slice(0, 80)}`);
+      }
+
+      results[actionName] = result;
+      if (action.collect) {
+        collected[actionName] = result;
+      }
+
+    } catch (err) {
+      console.log(`              → ❌ Error: ${err.message}`);
+      results[actionName] = { error: err.message };
+    }
+  }
+
+  // Print summary
+  console.log('\n  ═══════════════════════════════════════════════════════════');
+  console.log('  Agent Run Summary');
+  console.log('  ═══════════════════════════════════════════════════════════\n');
+
+  const succeed = Object.values(results).filter(function(r) { return !r.error; }).length;
+  const failed = Object.values(results).filter(function(r) { return r.error; }).length;
+
+  console.log(`  Total actions:  ${actions.length}`);
+  console.log(`  Succeeded:      ${succeed}`);
+  console.log(`  Failed:         ${failed}`);
+  console.log(`  Skipped:        ${actions.length - succeed - failed}`);
+
+  if (resolved.negotiation?.enabled) {
+    console.log(`\n  Negotiation:    ${resolved.negotiation.strategies?.join(', ') || 'enabled'}`);
+  }
+  if (resolved.verification?.anti_hallucination) {
+    console.log(`  Verification:   Anti-hallucination shield active`);
+  }
+
+  console.log('\n  Done.\n');
+
+  return results;
+}
+
+module.exports = { run, parseYAML, resolveTemplate };

package/bin/cli.js

@@ -21,15 +21,20 @@ function printHelp() {
   Commands:
     start       Start the WAB server (default)
     init        Create .env file from template
+    run <file>  Run an agent template (YAML)
+    templates   List available agent templates
     help        Show this help message
 
   Options:
     --port, -p  Set server port (default: 3000)
+    --server    WAB server URL (for agent templates)
 
   Examples:
     npx web-agent-bridge start
     npx web-agent-bridge start --port 4000
     npx web-agent-bridge init
+    npx wab-agent run olive-oil-tunisia.yaml
+    npx wab-agent templates
   `);
 }
 
@@ -73,6 +78,59 @@ switch (command) {
     printHelp();
     break;
 
+  case 'run': {
+    const templateArg = args[1];
+    if (!templateArg) {
+      console.error('  Error: Please specify a template file.');
+      console.error('  Usage: npx wab-agent run <template.yaml> [--param value ...]');
+      console.error('  Run "npx wab-agent templates" to see available templates.');
+      process.exit(1);
+    }
+    const runner = require('./agent-runner');
+    const cliParams = {};
+    for (let i = 2; i < args.length; i++) {
+      if (args[i].startsWith('--') && args[i + 1] && !args[i + 1].startsWith('--')) {
+        cliParams[args[i].slice(2)] = args[i + 1];
+        i++;
+      }
+    }
+    runner.run(templateArg, cliParams).catch(function(err) {
+      console.error('  Agent error:', err.message);
+      process.exit(1);
+    });
+    break;
+  }
+
+  case 'templates': {
+    const templatesDir = path.join(__dirname, '..', 'templates');
+    if (!fs.existsSync(templatesDir)) {
+      console.log('  No templates directory found.');
+      process.exit(0);
+    }
+    const files = fs.readdirSync(templatesDir).filter(function(f) { return f.endsWith('.yaml') || f.endsWith('.yml'); });
+    if (files.length === 0) {
+      console.log('  No templates found.');
+      process.exit(0);
+    }
+    console.log('\n  Available Agent Templates:\n');
+    console.log('  ' + '─'.repeat(70));
+    for (const file of files) {
+      try {
+        const content = fs.readFileSync(path.join(templatesDir, file), 'utf8');
+        const nameMatch = content.match(/^name:\s*(.+)$/m);
+        const descMatch = content.match(/^description:\s*(.+)$/m);
+        const name = nameMatch ? nameMatch[1].trim() : file.replace(/\.ya?ml$/, '');
+        const desc = descMatch ? descMatch[1].trim() : '';
+        console.log(`  ${name.padEnd(30)} ${desc.slice(0, 50)}`);
+      } catch(e) {
+        console.log(`  ${file}`);
+      }
+    }
+    console.log('  ' + '─'.repeat(70));
+    console.log(`\n  Run: npx wab-agent run <template-name>.yaml\n`);
+    break;
+  }
+
   default:
     console.error(`  Unknown command: ${command}`);
     printHelp();

package/examples/cross-site-agent.js

@@ -0,0 +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);
+});

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "web-agent-bridge",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "description": "Open-source middleware that bridges AI agents and websites — providing a standardized command interface for intelligent automation",
   "main": "server/index.js",
   "bin": {
     "web-agent-bridge": "./bin/cli.js",
-    "wab": "./bin/cli.js"
+    "wab": "./bin/cli.js",
+    "wab-agent": "./bin/cli.js"
   },
   "scripts": {
     "start": "node server/index.js",
@@ -39,6 +40,7 @@
     "public/",
     "script/",
     "sdk/",
+    "templates/",
     "examples/",
     "README.md",
     "README.ar.md",