web-agent-bridge 3.2.0 → 3.4.0

package/examples/cpanel-wab-dns.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+/**
+ * cpanel-wab-dns.js
+ * ------------------
+ * CLI tool: enable or disable WAB DNS Discovery TXT record via cPanel UAPI.
+ *
+ * Usage:
+ *   CPANEL_API_TOKEN=<token> node cpanel-wab-dns.js enable  example.com cpanel.example.com myuser
+ *   CPANEL_API_TOKEN=<token> node cpanel-wab-dns.js disable example.com cpanel.example.com myuser
+ *   CPANEL_API_TOKEN=<token> node cpanel-wab-dns.js status  example.com
+ *
+ * Optional env vars:
+ *   CPANEL_PORT=2083        (default: 2083)
+ *   CPANEL_PASSWORD         (used instead of API token when set; token preferred)
+ *   WAB_BASE_URL            (default: https://www.webagentbridge.com)
+ *   WAB_ENDPOINT            (override the wab.json endpoint URL in the TXT record)
+ *   NODE_TLS_REJECT_UNAUTHORIZED=0   (set to bypass self-signed cert on test servers)
+ *
+ * Required: node-fetch v2 for CommonJS environments:
+ *   npm install node-fetch@2
+ */
+
+'use strict';
+
+const fetch = (() => {
+  try { return require('node-fetch'); }
+  catch { return globalThis.fetch; }
+})();
+
+const [,, action, domain, cpHost, cpUser] = process.argv;
+
+const CP_PORT  = process.env.CPANEL_PORT     || '2083';
+const CP_TOKEN = process.env.CPANEL_API_TOKEN;
+const CP_PASS  = process.env.CPANEL_PASSWORD;
+const WAB_BASE = process.env.WAB_BASE_URL    || 'https://www.webagentbridge.com';
+const ENDPOINT = process.env.WAB_ENDPOINT    || `https://${domain}/.well-known/wab.json`;
+
+if (!action || !domain)              { console.error('Usage: node cpanel-wab-dns.js <enable|disable|status> <domain> [cpanel-host] [username]'); process.exit(1); }
+if (!['enable','disable','status'].includes(action)) { console.error('Action must be: enable | disable | status'); process.exit(1); }
+if (action !== 'status' && (!cpHost || !cpUser))     { console.error('cpanel-host and username required for enable/disable'); process.exit(1); }
+if (action !== 'status' && !CP_TOKEN && !CP_PASS)    { console.error('Set CPANEL_API_TOKEN or CPANEL_PASSWORD env variable'); process.exit(1); }
+
+function cpHeaders() {
+  if (CP_TOKEN) return { Authorization: `cpanel ${cpUser}:${CP_TOKEN}` };
+  const b64 = Buffer.from(`${cpUser}:${CP_PASS}`).toString('base64');
+  return { Authorization: `Basic ${b64}` };
+}
+
+function cpUrl(func, params = {}) {
+  const qs = new URLSearchParams({ domain, ...params }).toString();
+  return `https://${cpHost}:${CP_PORT}/execute/ZoneEdit/${func}?${qs}`;
+}
+
+async function cpCall(func, params = {}) {
+  const r = await fetch(cpUrl(func, params), { headers: cpHeaders() });
+  const j = await r.json();
+  if (j.errors && j.errors.length) throw new Error(`cPanel error: ${j.errors.join(', ')}`);
+  return j;
+}
+
+async function getRecordTemplate() {
+  const url = `${WAB_BASE}/api/discovery/provider/record-template?domain=${encodeURIComponent(domain)}&endpoint=${encodeURIComponent(ENDPOINT)}`;
+  const j   = await (await fetch(url)).json();
+  if (!j.record || !j.record.value) throw new Error('Could not fetch WAB record template');
+  return j.record.value;
+}
+
+async function listWabRecords() {
+  const j = await cpCall('fetch_zone_records', { type: 'TXT', name: `_wab.${domain}.` });
+  return Array.isArray(j.data) ? j.data : [];
+}
+
+async function main() {
+  console.log(`[WAB] Action: ${action} | Domain: ${domain}`);
+
+  if (action === 'status') {
+    const url = `${WAB_BASE}/api/discovery/provider/status?domain=${encodeURIComponent(domain)}`;
+    const j   = await (await fetch(url)).json();
+    console.log(`[WAB] Status: ${j.status}`);
+    console.log(JSON.stringify(j, null, 2));
+    return;
+  }
+
+  const txtValue = await getRecordTemplate();
+  console.log(`[WAB] TXT value: ${txtValue}`);
+
+  const records  = await listWabRecords();
+  const existing = records[0] || null;
+  console.log(`[CP]  Existing _wab TXT records: ${records.length}`);
+
+  if (action === 'enable') {
+    const payload = { type: 'TXT', name: `_wab.${domain}.`, txtdata: txtValue, ttl: 3600 };
+    if (existing) {
+      const j = await cpCall('edit_zone_record', { ...payload, line: existing.line });
+      console.log(`[CP]  Updated TXT record (line=${existing.line})`);
+      console.log(JSON.stringify(j, null, 2));
+    } else {
+      const j = await cpCall('add_zone_record', payload);
+      console.log('[CP]  Created TXT record');
+      console.log(JSON.stringify(j, null, 2));
+    }
+    console.log('[WAB] WAB Discovery ENABLED. Propagation may take up to 60 s.');
+  }
+
+  if (action === 'disable') {
+    if (!existing) { console.log('[CP]  No _wab record found — already disabled.'); return; }
+    const j = await cpCall('remove_zone_record', { line: existing.line });
+    console.log(`[CP]  Deleted TXT record (line=${existing.line})`);
+    console.log(JSON.stringify(j, null, 2));
+    console.log('[WAB] WAB Discovery DISABLED.');
+  }
+}
+
+main().catch(err => { console.error('[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/dns-discovery-agent.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Official WAB DNS Discovery consumer (multi-site).
+ *
+ * Proves the full value chain per domain:
+ *   1) discover via _wab TXT
+ *   2) fetch wab.json endpoint
+ *   3) call agent endpoints (/api/wab/discover, /api/wab/ping)
+ *
+ * Usage:
+ *   node examples/dns-discovery-agent.js webagentbridge.com example.com
+ */
+
+const { verify } = require('../packages/dns-verify/src');
+const { safeFetch } = require('../server/utils/safe-fetch');
+
+function sanitizeDomain(raw) {
+  return String(raw || '')
+    .trim()
+    .toLowerCase()
+    .replace(/^https?:\/\//, '')
+    .replace(/\/.*$/, '')
+    .replace(/:\d+$/, '')
+    .replace(/^www\./, '');
+}
+
+function parseEndpoint(record) {
+  if (!record || !record.parsed) return null;
+  return record.parsed.endpoint || null;
+}
+
+function logStep(ok, label, detail) {
+  const icon = ok ? 'OK' : 'NO';
+  const extra = detail ? ` - ${detail}` : '';
+  console.log(`[${icon}] ${label}${extra}`);
+}
+
+async function runDomain(domain) {
+  console.log('\n=== ' + domain + ' ===');
+
+  const result = {
+    domain,
+    dns: null,
+    endpoint: null,
+    wabJson: null,
+    discover: null,
+    ping: null,
+    ok: false,
+  };
+
+  const proof = await verify(domain, { timeoutMs: 6000 }).catch((err) => ({
+    ok: false,
+    records: [{ type: '_wab', error: err.message }],
+  }));
+
+  const wabRecord = (proof.records || []).find((r) => r.type === '_wab') || null;
+  result.dns = wabRecord;
+  logStep(!!(wabRecord && wabRecord.ok), 'DNS discovery', wabRecord && (wabRecord.error || wabRecord.fqdn));
+
+  const endpoint = parseEndpoint(wabRecord);
+  result.endpoint = endpoint;
+  if (!endpoint) {
+    logStep(false, 'wab.json endpoint', 'missing endpoint= in _wab record');
+    return result;
+  }
+  logStep(true, 'wab.json endpoint', endpoint);
+
+  const endpointUrl = new URL(endpoint);
+  const allowList = [domain, '*.' + domain, endpointUrl.hostname, '*.' + endpointUrl.hostname]
+    .filter((v, i, a) => a.indexOf(v) === i);
+
+  try {
+    const wabRes = await safeFetch(endpointUrl.toString(), { headers: { accept: 'application/json' } }, {
+      requireHttps: true,
+      allowList,
+      timeoutMs: 8000,
+      maxBytes: 1024 * 1024,
+      allowedContentTypes: ['application/json', 'application/ld+json', 'text/plain'],
+    });
+    const wabJson = await wabRes.json();
+    result.wabJson = wabJson;
+    logStep(wabRes.ok, 'Fetch wab.json', wabRes.status + ' ' + (wabJson.provider && wabJson.provider.name || 'unknown provider'));
+  } catch (err) {
+    logStep(false, 'Fetch wab.json', err.message);
+    return result;
+  }
+
+  const origin = endpointUrl.origin;
+  const discoverUrl = origin + '/api/wab/discover';
+  const fallbackDiscoverUrl = origin + '/agent-bridge.json';
+
+  try {
+    const discoverRes = await safeFetch(discoverUrl, { headers: { accept: 'application/json' } }, {
+      requireHttps: true,
+      allowList,
+      timeoutMs: 8000,
+      maxBytes: 1024 * 1024,
+      allowedContentTypes: ['application/json'],
+    });
+    if (discoverRes.ok) {
+      const discoverJson = await discoverRes.json();
+      result.discover = discoverJson;
+      logStep(true, 'Agent discover', 'GET /api/wab/discover');
+    } else {
+      const fallbackRes = await safeFetch(fallbackDiscoverUrl, { headers: { accept: 'application/json' } }, {
+        requireHttps: true,
+        allowList,
+        timeoutMs: 8000,
+        maxBytes: 1024 * 1024,
+        allowedContentTypes: ['application/json'],
+      });
+      const fallbackJson = await fallbackRes.json().catch(() => ({}));
+      if (fallbackRes.ok) {
+        result.discover = fallbackJson;
+        logStep(true, 'Agent discover', `fallback /agent-bridge.json (discover HTTP ${discoverRes.status})`);
+      } else {
+        logStep(false, 'Agent discover', `discover HTTP ${discoverRes.status}; fallback HTTP ${fallbackRes.status}`);
+      }
+    }
+  } catch (err) {
+    logStep(false, 'Agent discover', err.message);
+  }
+
+  try {
+    const pingRes = await safeFetch(origin + '/api/wab/ping', { headers: { accept: 'application/json' } }, {
+      requireHttps: true,
+      allowList,
+      timeoutMs: 8000,
+      maxBytes: 512 * 1024,
+      allowedContentTypes: ['application/json'],
+    });
+    const pingJson = await pingRes.json();
+    result.ping = pingJson;
+    logStep(pingRes.ok, 'Agent execute', 'GET /api/wab/ping => pong=' + !!(pingJson.result && pingJson.result.pong));
+  } catch (err) {
+    logStep(false, 'Agent execute', err.message);
+  }
+
+  result.ok = !!(result.dns && result.dns.ok && result.wabJson && result.ping);
+  return result;
+}
+
+async function main() {
+  const domains = process.argv.slice(2).map(sanitizeDomain).filter(Boolean);
+  if (domains.length === 0) {
+    console.error('Usage: node examples/dns-discovery-agent.js <domain1> [domain2] [...]');
+    process.exit(1);
+  }
+
+  const outputs = [];
+  for (const domain of domains) {
+    outputs.push(await runDomain(domain));
+  }
+
+  const passed = outputs.filter((o) => o.ok).length;
+  console.log('\nSummary: ' + passed + '/' + outputs.length + ' domains passed full flow');
+
+  if (passed !== outputs.length) process.exitCode = 2;
+}
+
+main().catch((err) => {
+  console.error('Fatal:', err && err.stack || err);
+  process.exit(1);
+});

package/examples/gcp-dns-wab.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+/**
+ * gcp-dns-wab.js — enable/disable WAB DNS Discovery TXT record on Google Cloud DNS.
+ *
+ * Usage:
+ *   node gcp-dns-wab.js enable  example.com my-project example-com
+ *   node gcp-dns-wab.js disable example.com my-project example-com
+ *   node gcp-dns-wab.js status  example.com
+ *
+ * Auth: uses Application Default Credentials (run `gcloud auth application-default login`)
+ *       or set GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
+ *
+ * Required: @google-cloud/dns
+ *   npm install @google-cloud/dns
+ */
+
+'use strict';
+
+const fetch = (() => { try { return require('node-fetch'); } catch { return globalThis.fetch; } })();
+const { DNS } = require('@google-cloud/dns');
+
+const [,, action, domain, projectId, zoneName] = process.argv;
+const WAB_BASE = process.env.WAB_BASE_URL  || 'https://www.webagentbridge.com';
+const ENDPOINT = process.env.WAB_ENDPOINT  || `https://${domain}/.well-known/wab.json`;
+
+if (!action || !domain) { console.error('Usage: node gcp-dns-wab.js <enable|disable|status> <domain> [projectId] [zoneName]'); process.exit(1); }
+if (!['enable','disable','status'].includes(action)) { console.error('Action must be: enable | disable | status'); process.exit(1); }
+if (action !== 'status' && (!projectId || !zoneName)) { console.error('projectId and zoneName required for enable/disable'); process.exit(1); }
+
+async function getRecordTemplate() {
+  const j = await (await fetch(`${WAB_BASE}/api/discovery/provider/record-template?domain=${encodeURIComponent(domain)}&endpoint=${encodeURIComponent(ENDPOINT)}`)).json();
+  if (!j.record || !j.record.value) throw new Error('Could not fetch WAB record template');
+  const v = j.record.value;
+  return v.startsWith('"') ? v : `"${v}"`;
+}
+
+async function main() {
+  console.log(`[WAB] Action: ${action} | Domain: ${domain}`);
+
+  if (action === 'status') {
+    const j = await (await fetch(`${WAB_BASE}/api/discovery/provider/status?domain=${encodeURIComponent(domain)}`)).json();
+    console.log(`[WAB] Status: ${j.status}`);
+    console.log(JSON.stringify(j, null, 2));
+    return;
+  }
+
+  const dns  = new DNS({ projectId });
+  const zone = dns.zone(zoneName);
+  const fqdn = `_wab.${domain}.`;
+
+  const [existing] = await zone.getRecords({ type: 'TXT', name: fqdn });
+  console.log(`[GCP] Existing _wab TXT records: ${existing.length}`);
+
+  if (action === 'enable') {
+    const txtVal = await getRecordTemplate();
+    console.log(`[WAB] TXT value: ${txtVal}`);
+    const newRecord = zone.record('txt', { name: fqdn, ttl: 3600, data: txtVal });
+    if (existing.length) {
+      const [change] = await zone.createChange({ delete: existing, add: newRecord });
+      console.log(`[GCP] Replaced (change id=${change.id}, status=${change.metadata.status})`);
+    } else {
+      const [change] = await zone.createChange({ add: newRecord });
+      console.log(`[GCP] Created (change id=${change.id}, status=${change.metadata.status})`);
+    }
+    console.log('[WAB] WAB Discovery ENABLED.');
+  }
+
+  if (action === 'disable') {
+    if (!existing.length) { console.log('[GCP] No _wab record found — already disabled.'); return; }
+    const [change] = await zone.createChange({ delete: existing });
+    console.log(`[GCP] Deleted (change id=${change.id}, status=${change.metadata.status})`);
+    console.log('[WAB] WAB Discovery DISABLED.');
+  }
+}
+
+main().catch(err => { console.error('[ERROR]', err.message); process.exit(1); });