web-agent-bridge 3.2.0 → 3.3.0

package/bin/agent-runner.js

@@ -1,474 +1,474 @@
-#!/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('- ')) {
-      let parent = stack[stack.length - 1].obj;
-
-      // Fix: if current stack top is an empty {} from `key:` with no value,
-      // it should be an array. Pop stack and convert.
-      if (stack.length > 1 && typeof parent === 'object' && !Array.isArray(parent) && Object.keys(parent).length === 0) {
-        stack.pop();
-        parent = stack[stack.length - 1].obj;
-        parent[currentKey] = [];
-      }
-
-      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 };
+#!/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('- ')) {
+      let parent = stack[stack.length - 1].obj;
+
+      // Fix: if current stack top is an empty {} from `key:` with no value,
+      // it should be an array. Pop stack and convert.
+      if (stack.length > 1 && typeof parent === 'object' && !Array.isArray(parent) && Object.keys(parent).length === 0) {
+        stack.pop();
+        parent = stack[stack.length - 1].obj;
+        parent[currentKey] = [];
+      }
+
+      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 };