web-agent-bridge 3.3.0 → 3.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (312) hide show
  1. package/LICENSE +84 -72
  2. package/README.ar.md +1563 -1286
  3. package/README.md +137 -1764
  4. package/bin/agent-runner.js +474 -474
  5. package/bin/cli.js +237 -237
  6. package/bin/wab-init.js +244 -0
  7. package/bin/wab.js +80 -80
  8. package/examples/azure-dns-wab.js +83 -0
  9. package/examples/bidi-agent.js +119 -119
  10. package/examples/cloudflare-wab-dns.js +121 -0
  11. package/examples/cpanel-wab-dns.js +114 -0
  12. package/examples/cross-site-agent.js +91 -91
  13. package/examples/dns-discovery-agent.js +166 -0
  14. package/examples/gcp-dns-wab.js +76 -0
  15. package/examples/governance-agent.js +169 -0
  16. package/examples/mcp-agent.js +94 -94
  17. package/examples/next-app-router/README.md +44 -44
  18. package/examples/plesk-wab-dns.js +103 -0
  19. package/examples/puppeteer-agent.js +108 -108
  20. package/examples/route53-wab-dns.js +144 -0
  21. package/examples/saas-dashboard/README.md +55 -55
  22. package/examples/safe-mode-agent.js +96 -0
  23. package/examples/self-discovery.js +106 -0
  24. package/examples/shopify-hydrogen/README.md +74 -74
  25. package/examples/vision-agent.js +171 -171
  26. package/examples/wab-sign.js +74 -0
  27. package/examples/wab-verify.js +60 -0
  28. package/examples/wordpress-elementor/README.md +77 -77
  29. package/package.json +93 -93
  30. package/public/.well-known/agent-tools.json +180 -180
  31. package/public/.well-known/ai-assets.json +59 -59
  32. package/public/.well-known/security.txt +8 -8
  33. package/public/.well-known/wab.json +28 -0
  34. package/public/activate.html +448 -0
  35. package/public/adopt.html +236 -0
  36. package/public/adoption-metrics.html +188 -0
  37. package/public/agent-workspace.html +359 -349
  38. package/public/ai.html +198 -198
  39. package/public/api.html +397 -413
  40. package/public/azure-dns-integration.html +289 -0
  41. package/public/browser.html +486 -486
  42. package/public/cloudflare-integration.html +380 -0
  43. package/public/commander-dashboard.html +243 -243
  44. package/public/cookies.html +210 -210
  45. package/public/cpanel-integration.html +398 -0
  46. package/public/css/agent-workspace.css +1713 -1713
  47. package/public/css/premium.css +317 -317
  48. package/public/css/styles.css +1401 -1235
  49. package/public/dashboard-shieldlink.html +295 -0
  50. package/public/dashboard.html +711 -706
  51. package/public/dns.html +436 -507
  52. package/public/docs.html +588 -587
  53. package/public/enterprise-mesh.ar.html +80 -0
  54. package/public/enterprise-mesh.html +81 -0
  55. package/public/feed.xml +89 -89
  56. package/public/gcp-dns-integration.html +318 -0
  57. package/public/governance.ar.html +70 -0
  58. package/public/governance.html +69 -0
  59. package/public/growth.html +465 -463
  60. package/public/index.html +1372 -1070
  61. package/public/integrations.html +556 -556
  62. package/public/js/activate.js +449 -0
  63. package/public/js/agent-workspace.js +1740 -1740
  64. package/public/js/auth-nav.js +117 -31
  65. package/public/js/auth-redirect.js +12 -12
  66. package/public/js/cookie-consent.js +56 -56
  67. package/public/js/dns.js +438 -0
  68. package/public/js/wab-demo-page.js +721 -721
  69. package/public/js/ws-client.js +74 -74
  70. package/public/l-preview.html +242 -0
  71. package/public/llms-full.txt +360 -360
  72. package/public/llms.txt +125 -125
  73. package/public/login.html +85 -85
  74. package/public/mesh-dashboard.html +328 -328
  75. package/public/milestones.html +346 -0
  76. package/public/one-click.html +779 -0
  77. package/public/openapi.json +669 -580
  78. package/public/partners.ar.html +145 -0
  79. package/public/partners.html +143 -0
  80. package/public/phone-shield.html +281 -281
  81. package/public/plesk-integration.html +375 -0
  82. package/public/premium-dashboard.html +2489 -2489
  83. package/public/premium.html +793 -793
  84. package/public/privacy.html +297 -297
  85. package/public/provider-onboarding.html +172 -0
  86. package/public/provider-sandbox.html +134 -0
  87. package/public/providers.html +359 -0
  88. package/public/refusals.html +172 -0
  89. package/public/register.html +105 -105
  90. package/public/registrar-integrations.html +141 -0
  91. package/public/ring4.html +292 -0
  92. package/public/robots.txt +99 -87
  93. package/public/route53-integration.html +531 -0
  94. package/public/score.html +263 -0
  95. package/public/script/wab-consent.d.ts +36 -36
  96. package/public/script/wab-consent.js +104 -104
  97. package/public/script/wab-schema.js +131 -131
  98. package/public/script/wab.d.ts +108 -108
  99. package/public/script/wab.min.js +580 -580
  100. package/public/security.txt +8 -8
  101. package/public/shieldlink.html +244 -0
  102. package/public/shieldqr.html +231 -0
  103. package/public/sitemap.xml +19 -1
  104. package/public/terms.html +256 -256
  105. package/public/trust-graph-api.ar.html +92 -0
  106. package/public/trust-graph-api.html +91 -0
  107. package/public/wab-features.html +560 -0
  108. package/public/wab-trust.html +200 -0
  109. package/public/wab-truth.html +375 -0
  110. package/public/wab-vs-protocols.html +210 -0
  111. package/public/whitepaper.html +449 -0
  112. package/script/ai-agent-bridge.js +1754 -1754
  113. package/sdk/README.md +99 -99
  114. package/sdk/agent-mesh.js +449 -449
  115. package/sdk/auto-discovery.js +301 -0
  116. package/sdk/commander.js +262 -262
  117. package/sdk/governance.js +262 -0
  118. package/sdk/index.d.ts +464 -464
  119. package/sdk/index.js +649 -636
  120. package/sdk/multi-agent.js +318 -318
  121. package/sdk/package.json +2 -2
  122. package/sdk/safe-mode.js +221 -0
  123. package/sdk/safety-shield.js +219 -219
  124. package/sdk/schema-discovery.js +83 -83
  125. package/server/adapters/index.js +520 -520
  126. package/server/config/plans.js +412 -367
  127. package/server/config/secrets.js +102 -102
  128. package/server/control-plane/index.js +301 -301
  129. package/server/data-plane/index.js +354 -354
  130. package/server/index.js +790 -531
  131. package/server/llm/index.js +404 -404
  132. package/server/middleware/adminAuth.js +35 -35
  133. package/server/middleware/api-tier.js +170 -0
  134. package/server/middleware/auth.js +50 -50
  135. package/server/middleware/featureGate.js +88 -88
  136. package/server/middleware/rateLimits.js +100 -100
  137. package/server/middleware/sensitiveAction.js +157 -157
  138. package/server/middleware/wab-trust.js +141 -0
  139. package/server/migrations/001_add_analytics_indexes.sql +7 -7
  140. package/server/migrations/002_premium_features.sql +418 -418
  141. package/server/migrations/003_ads_integer_cents.sql +33 -33
  142. package/server/migrations/004_agent_os.sql +158 -158
  143. package/server/migrations/005_marketplace_metering.sql +126 -126
  144. package/server/migrations/006_growth_suite.sql +138 -0
  145. package/server/migrations/007_governance.sql +106 -0
  146. package/server/migrations/008_plans.sql +144 -0
  147. package/server/migrations/009_shieldqr.sql +30 -0
  148. package/server/migrations/010_extended_trust.sql +33 -0
  149. package/server/migrations/011_outreach.sql +47 -0
  150. package/server/migrations/012_shieldlink.sql +116 -0
  151. package/server/migrations/013_ct_monitor.sql +13 -0
  152. package/server/migrations/014_wab_advanced_features.sql +128 -0
  153. package/server/migrations/015_wab_truth_layer.sql +101 -0
  154. package/server/migrations/016_ring4_external_trust.sql +84 -0
  155. package/server/migrations/017_ring4_extensions.sql +69 -0
  156. package/server/migrations/018_commercial_foundations.sql +167 -0
  157. package/server/migrations/019_unify_tier_constraints.sql +133 -0
  158. package/server/models/adapters/index.js +33 -33
  159. package/server/models/adapters/mysql.js +183 -183
  160. package/server/models/adapters/postgresql.js +172 -172
  161. package/server/models/adapters/sqlite.js +7 -7
  162. package/server/models/db.js +740 -681
  163. package/server/observability/failure-analysis.js +337 -337
  164. package/server/observability/index.js +394 -394
  165. package/server/protocol/capabilities.js +223 -223
  166. package/server/protocol/index.js +243 -243
  167. package/server/protocol/schema.js +584 -584
  168. package/server/registry/certification.js +271 -271
  169. package/server/registry/index.js +326 -326
  170. package/server/routes/activate.js +478 -0
  171. package/server/routes/admin-outreach.js +239 -0
  172. package/server/routes/admin-plans.js +76 -0
  173. package/server/routes/admin-premium.js +674 -671
  174. package/server/routes/admin-shieldlink.js +137 -0
  175. package/server/routes/admin-shieldqr.js +90 -0
  176. package/server/routes/admin-trust-monitor.js +139 -0
  177. package/server/routes/admin.js +550 -261
  178. package/server/routes/adopt.js +61 -0
  179. package/server/routes/ads.js +130 -130
  180. package/server/routes/agent-workspace.js +540 -540
  181. package/server/routes/api-keys.js +127 -0
  182. package/server/routes/api.js +150 -150
  183. package/server/routes/auth.js +71 -71
  184. package/server/routes/billing.js +57 -45
  185. package/server/routes/commander.js +316 -316
  186. package/server/routes/customer-shieldlink.js +133 -0
  187. package/server/routes/demo-showcase.js +332 -332
  188. package/server/routes/demo-store.js +154 -154
  189. package/server/routes/diagnose.js +373 -0
  190. package/server/routes/discovery.js +2348 -417
  191. package/server/routes/enterprise-mesh.js +170 -0
  192. package/server/routes/gateway.js +173 -173
  193. package/server/routes/governance-saas.js +203 -0
  194. package/server/routes/governance.js +208 -0
  195. package/server/routes/growth.js +1048 -0
  196. package/server/routes/intent.js +328 -0
  197. package/server/routes/license.js +251 -251
  198. package/server/routes/mesh.js +469 -469
  199. package/server/routes/noscript.js +543 -543
  200. package/server/routes/partners.js +201 -0
  201. package/server/routes/plans.js +33 -0
  202. package/server/routes/premium-v2.js +686 -686
  203. package/server/routes/premium.js +724 -724
  204. package/server/routes/providers.js +650 -0
  205. package/server/routes/reputation.js +411 -0
  206. package/server/routes/ring4.js +885 -0
  207. package/server/routes/runtime.js +2148 -2148
  208. package/server/routes/shieldlink.js +70 -0
  209. package/server/routes/shieldqr.js +88 -0
  210. package/server/routes/sovereign.js +465 -465
  211. package/server/routes/truth-layer.js +670 -0
  212. package/server/routes/universal.js +200 -200
  213. package/server/routes/unsubscribe.js +51 -0
  214. package/server/routes/wab-api.js +850 -850
  215. package/server/routes/wab-cache.js +282 -0
  216. package/server/runtime/container-worker.js +111 -111
  217. package/server/runtime/container.js +448 -448
  218. package/server/runtime/distributed-worker.js +362 -362
  219. package/server/runtime/event-bus.js +210 -210
  220. package/server/runtime/index.js +253 -253
  221. package/server/runtime/queue.js +599 -599
  222. package/server/runtime/replay.js +666 -666
  223. package/server/runtime/sandbox.js +266 -266
  224. package/server/runtime/scheduler.js +534 -534
  225. package/server/runtime/session-engine.js +293 -293
  226. package/server/runtime/state-manager.js +188 -188
  227. package/server/secrets/wab-signing-key.pem +3 -0
  228. package/server/secrets/wab-signing-pub.pem +3 -0
  229. package/server/security/cross-site-redactor.js +196 -196
  230. package/server/security/dry-run.js +180 -180
  231. package/server/security/human-gate-rate-limit.js +147 -147
  232. package/server/security/human-gate-transports.js +178 -178
  233. package/server/security/human-gate.js +281 -281
  234. package/server/security/index.js +368 -368
  235. package/server/security/intent-engine.js +245 -245
  236. package/server/security/reward-guard.js +171 -171
  237. package/server/security/rollback-store.js +239 -239
  238. package/server/security/token-scope.js +404 -404
  239. package/server/security/url-policy.js +139 -139
  240. package/server/services/adoption-agent.js +182 -0
  241. package/server/services/agent-chat.js +506 -506
  242. package/server/services/agent-learning.js +601 -601
  243. package/server/services/agent-memory.js +625 -625
  244. package/server/services/agent-mesh.js +555 -555
  245. package/server/services/agent-symphony.js +717 -717
  246. package/server/services/agent-tasks.js +1807 -1807
  247. package/server/services/api-key-engine.js +292 -292
  248. package/server/services/cluster.js +894 -894
  249. package/server/services/commander.js +738 -738
  250. package/server/services/edge-compute.js +440 -440
  251. package/server/services/email.js +233 -204
  252. package/server/services/fairness-engine.js +409 -0
  253. package/server/services/fairness.js +420 -0
  254. package/server/services/governance.js +466 -0
  255. package/server/services/hosted-runtime.js +205 -205
  256. package/server/services/lfd.js +635 -635
  257. package/server/services/local-ai.js +389 -389
  258. package/server/services/marketplace.js +270 -270
  259. package/server/services/metering.js +182 -182
  260. package/server/services/modules/affiliate-intelligence.js +93 -93
  261. package/server/services/modules/agent-firewall.js +90 -90
  262. package/server/services/modules/bounty.js +89 -89
  263. package/server/services/modules/collective-bargaining.js +92 -92
  264. package/server/services/modules/dark-pattern.js +66 -66
  265. package/server/services/modules/gov-intelligence.js +45 -45
  266. package/server/services/modules/neural.js +55 -55
  267. package/server/services/modules/notary.js +49 -49
  268. package/server/services/modules/price-time-machine.js +86 -86
  269. package/server/services/modules/protocol.js +104 -104
  270. package/server/services/negotiation.js +439 -439
  271. package/server/services/outreach-agent.js +312 -0
  272. package/server/services/plans.js +214 -0
  273. package/server/services/plugins.js +771 -771
  274. package/server/services/premium.js +1 -1
  275. package/server/services/price-intelligence.js +566 -566
  276. package/server/services/price-shield.js +1137 -1137
  277. package/server/services/provider-clients.js +740 -0
  278. package/server/services/reputation.js +465 -465
  279. package/server/services/search-engine.js +357 -357
  280. package/server/services/security.js +513 -513
  281. package/server/services/self-healing.js +843 -843
  282. package/server/services/shieldlink.js +492 -0
  283. package/server/services/shieldqr.js +322 -0
  284. package/server/services/sovereign-shield.js +542 -542
  285. package/server/services/ssl-ct-monitor.js +224 -0
  286. package/server/services/ssl-inspector.js +42 -0
  287. package/server/services/ssl-monitor.js +167 -0
  288. package/server/services/stripe.js +206 -192
  289. package/server/services/swarm.js +788 -788
  290. package/server/services/universal-scraper.js +662 -662
  291. package/server/services/verification.js +481 -481
  292. package/server/services/vision.js +1163 -1163
  293. package/server/services/wab-crypto.js +178 -0
  294. package/server/utils/cache.js +125 -125
  295. package/server/utils/migrate.js +81 -81
  296. package/server/utils/safe-fetch.js +228 -228
  297. package/server/utils/secureFields.js +50 -50
  298. package/server/ws.js +161 -161
  299. package/templates/artisan-marketplace.yaml +104 -104
  300. package/templates/book-price-scout.yaml +98 -98
  301. package/templates/electronics-price-tracker.yaml +108 -108
  302. package/templates/flight-deal-hunter.yaml +113 -113
  303. package/templates/freelancer-direct.yaml +116 -116
  304. package/templates/grocery-price-compare.yaml +93 -93
  305. package/templates/hotel-direct-booking.yaml +113 -113
  306. package/templates/local-services.yaml +98 -98
  307. package/templates/olive-oil-tunisia.yaml +88 -88
  308. package/templates/organic-farm-fresh.yaml +101 -101
  309. package/templates/restaurant-direct.yaml +97 -97
  310. package/templates/ring4/banking-sovereign.yaml +55 -0
  311. package/templates/ring4/ecommerce-sovereign.yaml +58 -0
  312. package/templates/ring4/healthcare-sovereign.yaml +60 -0
@@ -1,119 +1,119 @@
1
- /**
2
- * Example: AI Agent using WebDriver BiDi Protocol via WAB
3
- *
4
- * This agent connects to a website using the __wab_bidi interface,
5
- * which follows WebDriver BiDi conventions for standardized communication.
6
- *
7
- * Prerequisites:
8
- * npm install puppeteer
9
- *
10
- * Usage:
11
- * node examples/bidi-agent.js <url>
12
- */
13
-
14
- const puppeteer = require('puppeteer');
15
-
16
- const TARGET_URL = process.argv[2] || 'http://localhost:3000';
17
-
18
- let commandId = 0;
19
-
20
- function bidiCommand(method, params = {}) {
21
- return { id: ++commandId, method, params };
22
- }
23
-
24
- async function main() {
25
- console.log(`\nšŸ”— WAB BiDi Agent`);
26
- console.log(` Target: ${TARGET_URL}\n`);
27
-
28
- const browser = await puppeteer.launch({ headless: true });
29
- const page = await browser.newPage();
30
-
31
- await page.goto(TARGET_URL, { waitUntil: 'networkidle2' });
32
- console.log(`āœ“ Page loaded: ${await page.title()}`);
33
-
34
- // Check for BiDi interface
35
- const hasBiDi = await page.evaluate(() => {
36
- return typeof window.__wab_bidi !== 'undefined' && typeof window.__wab_bidi.send === 'function';
37
- });
38
-
39
- if (!hasBiDi) {
40
- console.log('āœ— WAB BiDi interface not found on this page.');
41
- await browser.close();
42
- return;
43
- }
44
-
45
- console.log('āœ“ WAB BiDi interface detected\n');
46
-
47
- // Step 1: Get BiDi context
48
- const context = await page.evaluate(() => window.__wab_bidi.getContext());
49
- console.log('šŸ“‹ BiDi Context:');
50
- console.log(` URL: ${context.context.url}`);
51
- console.log(` Title: ${context.context.title}`);
52
- console.log(` Version: ${context.version}`);
53
- console.log(` Tier: ${context.capabilities.tier}`);
54
- console.log(` Capabilities: ${context.capabilities.actions.length} actions\n`);
55
-
56
- // Step 2: Get actions via BiDi command
57
- const actionsResult = await page.evaluate((cmd) => {
58
- return window.__wab_bidi.send(cmd);
59
- }, bidiCommand('wab.getActions'));
60
-
61
- console.log(`šŸ” Actions (via BiDi):`);
62
- if (actionsResult.result) {
63
- actionsResult.result.forEach((action) => {
64
- console.log(` • ${action.name} [${action.trigger}] — ${action.description}`);
65
- });
66
- }
67
-
68
- // Step 3: Get page info via BiDi
69
- const infoResult = await page.evaluate((cmd) => {
70
- return window.__wab_bidi.send(cmd);
71
- }, bidiCommand('wab.getPageInfo'));
72
-
73
- console.log('\nšŸ“„ Page Info (via BiDi):');
74
- if (infoResult.result) {
75
- console.log(` Title: ${infoResult.result.title}`);
76
- console.log(` Domain: ${infoResult.result.domain}`);
77
- console.log(` Bridge: v${infoResult.result.bridgeVersion}`);
78
- }
79
-
80
- // Step 4: Read content via BiDi command
81
- const readResult = await page.evaluate((cmd) => {
82
- return window.__wab_bidi.send(cmd);
83
- }, bidiCommand('wab.readContent', { selector: 'h1' }));
84
-
85
- if (readResult.result && readResult.result.success) {
86
- console.log(`\nšŸ“– Content: "${readResult.result.text}"`);
87
- }
88
-
89
- // Step 5: Execute an action via BiDi
90
- const actions = actionsResult.result || [];
91
- const firstAction = actions.find((a) => a.trigger === 'click');
92
- if (firstAction) {
93
- console.log(`\nā–¶ Executing via BiDi: "${firstAction.name}"`);
94
- const execResult = await page.evaluate((cmd) => {
95
- return window.__wab_bidi.send(cmd);
96
- }, bidiCommand('wab.executeAction', { name: firstAction.name }));
97
-
98
- const r = execResult.result;
99
- console.log(` Result: ${r && r.success ? 'āœ“ Success' : 'āœ— ' + (r?.error || 'Unknown error')}`);
100
- }
101
-
102
- // Step 6: Test error handling
103
- console.log('\n🧪 Testing error handling:');
104
- const errorResult = await page.evaluate((cmd) => {
105
- return window.__wab_bidi.send(cmd);
106
- }, bidiCommand('wab.unknownMethod'));
107
-
108
- if (errorResult.error) {
109
- console.log(` āœ“ Unknown command handled: ${errorResult.error.code} — ${errorResult.error.message}`);
110
- }
111
-
112
- console.log('\nāœ“ BiDi agent session complete.');
113
- await browser.close();
114
- }
115
-
116
- main().catch((err) => {
117
- console.error('Agent error:', err.message);
118
- process.exit(1);
119
- });
1
+ /**
2
+ * Example: AI Agent using WebDriver BiDi Protocol via WAB
3
+ *
4
+ * This agent connects to a website using the __wab_bidi interface,
5
+ * which follows WebDriver BiDi conventions for standardized communication.
6
+ *
7
+ * Prerequisites:
8
+ * npm install puppeteer
9
+ *
10
+ * Usage:
11
+ * node examples/bidi-agent.js <url>
12
+ */
13
+
14
+ const puppeteer = require('puppeteer');
15
+
16
+ const TARGET_URL = process.argv[2] || 'http://localhost:3000';
17
+
18
+ let commandId = 0;
19
+
20
+ function bidiCommand(method, params = {}) {
21
+ return { id: ++commandId, method, params };
22
+ }
23
+
24
+ async function main() {
25
+ console.log(`\nšŸ”— WAB BiDi Agent`);
26
+ console.log(` Target: ${TARGET_URL}\n`);
27
+
28
+ const browser = await puppeteer.launch({ headless: true });
29
+ const page = await browser.newPage();
30
+
31
+ await page.goto(TARGET_URL, { waitUntil: 'networkidle2' });
32
+ console.log(`āœ“ Page loaded: ${await page.title()}`);
33
+
34
+ // Check for BiDi interface
35
+ const hasBiDi = await page.evaluate(() => {
36
+ return typeof window.__wab_bidi !== 'undefined' && typeof window.__wab_bidi.send === 'function';
37
+ });
38
+
39
+ if (!hasBiDi) {
40
+ console.log('āœ— WAB BiDi interface not found on this page.');
41
+ await browser.close();
42
+ return;
43
+ }
44
+
45
+ console.log('āœ“ WAB BiDi interface detected\n');
46
+
47
+ // Step 1: Get BiDi context
48
+ const context = await page.evaluate(() => window.__wab_bidi.getContext());
49
+ console.log('šŸ“‹ BiDi Context:');
50
+ console.log(` URL: ${context.context.url}`);
51
+ console.log(` Title: ${context.context.title}`);
52
+ console.log(` Version: ${context.version}`);
53
+ console.log(` Tier: ${context.capabilities.tier}`);
54
+ console.log(` Capabilities: ${context.capabilities.actions.length} actions\n`);
55
+
56
+ // Step 2: Get actions via BiDi command
57
+ const actionsResult = await page.evaluate((cmd) => {
58
+ return window.__wab_bidi.send(cmd);
59
+ }, bidiCommand('wab.getActions'));
60
+
61
+ console.log(`šŸ” Actions (via BiDi):`);
62
+ if (actionsResult.result) {
63
+ actionsResult.result.forEach((action) => {
64
+ console.log(` • ${action.name} [${action.trigger}] — ${action.description}`);
65
+ });
66
+ }
67
+
68
+ // Step 3: Get page info via BiDi
69
+ const infoResult = await page.evaluate((cmd) => {
70
+ return window.__wab_bidi.send(cmd);
71
+ }, bidiCommand('wab.getPageInfo'));
72
+
73
+ console.log('\nšŸ“„ Page Info (via BiDi):');
74
+ if (infoResult.result) {
75
+ console.log(` Title: ${infoResult.result.title}`);
76
+ console.log(` Domain: ${infoResult.result.domain}`);
77
+ console.log(` Bridge: v${infoResult.result.bridgeVersion}`);
78
+ }
79
+
80
+ // Step 4: Read content via BiDi command
81
+ const readResult = await page.evaluate((cmd) => {
82
+ return window.__wab_bidi.send(cmd);
83
+ }, bidiCommand('wab.readContent', { selector: 'h1' }));
84
+
85
+ if (readResult.result && readResult.result.success) {
86
+ console.log(`\nšŸ“– Content: "${readResult.result.text}"`);
87
+ }
88
+
89
+ // Step 5: Execute an action via BiDi
90
+ const actions = actionsResult.result || [];
91
+ const firstAction = actions.find((a) => a.trigger === 'click');
92
+ if (firstAction) {
93
+ console.log(`\nā–¶ Executing via BiDi: "${firstAction.name}"`);
94
+ const execResult = await page.evaluate((cmd) => {
95
+ return window.__wab_bidi.send(cmd);
96
+ }, bidiCommand('wab.executeAction', { name: firstAction.name }));
97
+
98
+ const r = execResult.result;
99
+ console.log(` Result: ${r && r.success ? 'āœ“ Success' : 'āœ— ' + (r?.error || 'Unknown error')}`);
100
+ }
101
+
102
+ // Step 6: Test error handling
103
+ console.log('\n🧪 Testing error handling:');
104
+ const errorResult = await page.evaluate((cmd) => {
105
+ return window.__wab_bidi.send(cmd);
106
+ }, bidiCommand('wab.unknownMethod'));
107
+
108
+ if (errorResult.error) {
109
+ console.log(` āœ“ Unknown command handled: ${errorResult.error.code} — ${errorResult.error.message}`);
110
+ }
111
+
112
+ console.log('\nāœ“ BiDi agent session complete.');
113
+ await browser.close();
114
+ }
115
+
116
+ main().catch((err) => {
117
+ console.error('Agent error:', err.message);
118
+ process.exit(1);
119
+ });
@@ -0,0 +1,121 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * cloudflare-wab-dns.js
4
+ * ---------------------
5
+ * CLI tool: enable or disable WAB DNS Discovery TXT record on Cloudflare.
6
+ *
7
+ * Usage:
8
+ * CF_API_TOKEN=<token> node cloudflare-wab-dns.js enable example.com
9
+ * CF_API_TOKEN=<token> node cloudflare-wab-dns.js disable example.com
10
+ * CF_API_TOKEN=<token> node cloudflare-wab-dns.js status example.com
11
+ *
12
+ * Optional: set WAB_ENDPOINT env var to override the endpoint URL in the TXT record.
13
+ *
14
+ * Required npm package: node-fetch (v2 for CommonJS):
15
+ * npm install node-fetch@2
16
+ */
17
+
18
+ 'use strict';
19
+
20
+ const fetch = (() => {
21
+ try { return require('node-fetch'); }
22
+ catch { return globalThis.fetch; }
23
+ })();
24
+
25
+ const CF_TOKEN = process.env.CF_API_TOKEN;
26
+ const [,, action, domain] = process.argv;
27
+
28
+ if (!CF_TOKEN) { console.error('Error: CF_API_TOKEN env variable is required.'); process.exit(1); }
29
+ if (!action || !domain) {
30
+ console.error('Usage: node cloudflare-wab-dns.js <enable|disable|status> <domain>');
31
+ process.exit(1);
32
+ }
33
+ if (!['enable', 'disable', 'status'].includes(action)) {
34
+ console.error('Action must be one of: enable, disable, status');
35
+ process.exit(1);
36
+ }
37
+
38
+ const CF_BASE = 'https://api.cloudflare.com/client/v4';
39
+ const WAB_BASE = process.env.WAB_BASE_URL || 'https://www.webagentbridge.com';
40
+ const ENDPOINT = process.env.WAB_ENDPOINT || `https://${domain}/.well-known/wab.json`;
41
+
42
+ function cfHeaders() {
43
+ return { 'Authorization': `Bearer ${CF_TOKEN}`, 'Content-Type': 'application/json' };
44
+ }
45
+
46
+ async function cfGet(path) {
47
+ const r = await fetch(`${CF_BASE}${path}`, { headers: cfHeaders() });
48
+ const j = await r.json();
49
+ if (!j.success) throw new Error(`CF API error: ${JSON.stringify(j.errors)}`);
50
+ return j;
51
+ }
52
+
53
+ async function getZoneId() {
54
+ const j = await cfGet(`/zones?name=${encodeURIComponent(domain)}`);
55
+ if (!j.result[0]) throw new Error(`Zone not found for domain "${domain}"`);
56
+ return j.result[0].id;
57
+ }
58
+
59
+ async function getRecordTemplate() {
60
+ const url = `${WAB_BASE}/api/discovery/provider/record-template?domain=${encodeURIComponent(domain)}&endpoint=${encodeURIComponent(ENDPOINT)}`;
61
+ const r = await fetch(url);
62
+ const j = await r.json();
63
+ if (!j.record || !j.record.value) throw new Error('Could not fetch WAB record template');
64
+ return j.record.value;
65
+ }
66
+
67
+ async function findExistingRecord(zoneId) {
68
+ const j = await cfGet(`/zones/${zoneId}/dns_records?type=TXT&name=_wab.${domain}`);
69
+ return j.result && j.result[0] ? j.result[0] : null;
70
+ }
71
+
72
+ async function main() {
73
+ console.log(`[WAB] Action: ${action} | Domain: ${domain}`);
74
+
75
+ if (action === 'status') {
76
+ const url = `${WAB_BASE}/api/discovery/provider/status?domain=${encodeURIComponent(domain)}`;
77
+ const j = await (await fetch(url)).json();
78
+ console.log(`[WAB] Status: ${j.status}`);
79
+ console.log(JSON.stringify(j, null, 2));
80
+ return;
81
+ }
82
+
83
+ const txtValue = await getRecordTemplate();
84
+ console.log(`[WAB] TXT value: ${txtValue}`);
85
+
86
+ const zoneId = await getZoneId();
87
+ console.log(`[CF] Zone ID: ${zoneId}`);
88
+
89
+ const existing = await findExistingRecord(zoneId);
90
+ const recBase = `${CF_BASE}/zones/${zoneId}/dns_records`;
91
+
92
+ if (action === 'enable') {
93
+ const body = JSON.stringify({ type: 'TXT', name: `_wab.${domain}`, content: txtValue, ttl: 3600 });
94
+ if (existing) {
95
+ const r = await fetch(`${recBase}/${existing.id}`, { method: 'PUT', headers: cfHeaders(), body });
96
+ const j = await r.json();
97
+ if (!j.success) throw new Error(`PUT failed: ${JSON.stringify(j.errors)}`);
98
+ console.log(`[CF] Updated TXT record (id=${existing.id})`);
99
+ } else {
100
+ const r = await fetch(recBase, { method: 'POST', headers: cfHeaders(), body });
101
+ const j = await r.json();
102
+ if (!j.success) throw new Error(`POST failed: ${JSON.stringify(j.errors)}`);
103
+ console.log(`[CF] Created TXT record (id=${j.result.id})`);
104
+ }
105
+ console.log('[WAB] WAB Discovery ENABLED. Verification may take up to 60 s for DNS propagation.');
106
+ }
107
+
108
+ if (action === 'disable') {
109
+ if (!existing) {
110
+ console.log('[CF] No _wab TXT record found. Already disabled.');
111
+ return;
112
+ }
113
+ const r = await fetch(`${recBase}/${existing.id}`, { method: 'DELETE', headers: cfHeaders() });
114
+ const j = await r.json();
115
+ if (!j.success) throw new Error(`DELETE failed: ${JSON.stringify(j.errors)}`);
116
+ console.log(`[CF] Deleted TXT record (id=${existing.id})`);
117
+ console.log('[WAB] WAB Discovery DISABLED.');
118
+ }
119
+ }
120
+
121
+ main().catch(err => { console.error('[ERROR]', err.message); process.exit(1); });
@@ -0,0 +1,114 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * cpanel-wab-dns.js
4
+ * ------------------
5
+ * CLI tool: enable or disable WAB DNS Discovery TXT record via cPanel UAPI.
6
+ *
7
+ * Usage:
8
+ * CPANEL_API_TOKEN=<token> node cpanel-wab-dns.js enable example.com cpanel.example.com myuser
9
+ * CPANEL_API_TOKEN=<token> node cpanel-wab-dns.js disable example.com cpanel.example.com myuser
10
+ * CPANEL_API_TOKEN=<token> node cpanel-wab-dns.js status example.com
11
+ *
12
+ * Optional env vars:
13
+ * CPANEL_PORT=2083 (default: 2083)
14
+ * CPANEL_PASSWORD (used instead of API token when set; token preferred)
15
+ * WAB_BASE_URL (default: https://www.webagentbridge.com)
16
+ * WAB_ENDPOINT (override the wab.json endpoint URL in the TXT record)
17
+ * NODE_TLS_REJECT_UNAUTHORIZED=0 (set to bypass self-signed cert on test servers)
18
+ *
19
+ * Required: node-fetch v2 for CommonJS environments:
20
+ * npm install node-fetch@2
21
+ */
22
+
23
+ 'use strict';
24
+
25
+ const fetch = (() => {
26
+ try { return require('node-fetch'); }
27
+ catch { return globalThis.fetch; }
28
+ })();
29
+
30
+ const [,, action, domain, cpHost, cpUser] = process.argv;
31
+
32
+ const CP_PORT = process.env.CPANEL_PORT || '2083';
33
+ const CP_TOKEN = process.env.CPANEL_API_TOKEN;
34
+ const CP_PASS = process.env.CPANEL_PASSWORD;
35
+ const WAB_BASE = process.env.WAB_BASE_URL || 'https://www.webagentbridge.com';
36
+ const ENDPOINT = process.env.WAB_ENDPOINT || `https://${domain}/.well-known/wab.json`;
37
+
38
+ if (!action || !domain) { console.error('Usage: node cpanel-wab-dns.js <enable|disable|status> <domain> [cpanel-host] [username]'); process.exit(1); }
39
+ if (!['enable','disable','status'].includes(action)) { console.error('Action must be: enable | disable | status'); process.exit(1); }
40
+ if (action !== 'status' && (!cpHost || !cpUser)) { console.error('cpanel-host and username required for enable/disable'); process.exit(1); }
41
+ if (action !== 'status' && !CP_TOKEN && !CP_PASS) { console.error('Set CPANEL_API_TOKEN or CPANEL_PASSWORD env variable'); process.exit(1); }
42
+
43
+ function cpHeaders() {
44
+ if (CP_TOKEN) return { Authorization: `cpanel ${cpUser}:${CP_TOKEN}` };
45
+ const b64 = Buffer.from(`${cpUser}:${CP_PASS}`).toString('base64');
46
+ return { Authorization: `Basic ${b64}` };
47
+ }
48
+
49
+ function cpUrl(func, params = {}) {
50
+ const qs = new URLSearchParams({ domain, ...params }).toString();
51
+ return `https://${cpHost}:${CP_PORT}/execute/ZoneEdit/${func}?${qs}`;
52
+ }
53
+
54
+ async function cpCall(func, params = {}) {
55
+ const r = await fetch(cpUrl(func, params), { headers: cpHeaders() });
56
+ const j = await r.json();
57
+ if (j.errors && j.errors.length) throw new Error(`cPanel error: ${j.errors.join(', ')}`);
58
+ return j;
59
+ }
60
+
61
+ async function getRecordTemplate() {
62
+ const url = `${WAB_BASE}/api/discovery/provider/record-template?domain=${encodeURIComponent(domain)}&endpoint=${encodeURIComponent(ENDPOINT)}`;
63
+ const j = await (await fetch(url)).json();
64
+ if (!j.record || !j.record.value) throw new Error('Could not fetch WAB record template');
65
+ return j.record.value;
66
+ }
67
+
68
+ async function listWabRecords() {
69
+ const j = await cpCall('fetch_zone_records', { type: 'TXT', name: `_wab.${domain}.` });
70
+ return Array.isArray(j.data) ? j.data : [];
71
+ }
72
+
73
+ async function main() {
74
+ console.log(`[WAB] Action: ${action} | Domain: ${domain}`);
75
+
76
+ if (action === 'status') {
77
+ const url = `${WAB_BASE}/api/discovery/provider/status?domain=${encodeURIComponent(domain)}`;
78
+ const j = await (await fetch(url)).json();
79
+ console.log(`[WAB] Status: ${j.status}`);
80
+ console.log(JSON.stringify(j, null, 2));
81
+ return;
82
+ }
83
+
84
+ const txtValue = await getRecordTemplate();
85
+ console.log(`[WAB] TXT value: ${txtValue}`);
86
+
87
+ const records = await listWabRecords();
88
+ const existing = records[0] || null;
89
+ console.log(`[CP] Existing _wab TXT records: ${records.length}`);
90
+
91
+ if (action === 'enable') {
92
+ const payload = { type: 'TXT', name: `_wab.${domain}.`, txtdata: txtValue, ttl: 3600 };
93
+ if (existing) {
94
+ const j = await cpCall('edit_zone_record', { ...payload, line: existing.line });
95
+ console.log(`[CP] Updated TXT record (line=${existing.line})`);
96
+ console.log(JSON.stringify(j, null, 2));
97
+ } else {
98
+ const j = await cpCall('add_zone_record', payload);
99
+ console.log('[CP] Created TXT record');
100
+ console.log(JSON.stringify(j, null, 2));
101
+ }
102
+ console.log('[WAB] WAB Discovery ENABLED. Propagation may take up to 60 s.');
103
+ }
104
+
105
+ if (action === 'disable') {
106
+ if (!existing) { console.log('[CP] No _wab record found — already disabled.'); return; }
107
+ const j = await cpCall('remove_zone_record', { line: existing.line });
108
+ console.log(`[CP] Deleted TXT record (line=${existing.line})`);
109
+ console.log(JSON.stringify(j, null, 2));
110
+ console.log('[WAB] WAB Discovery DISABLED.');
111
+ }
112
+ }
113
+
114
+ main().catch(err => { console.error('[ERROR]', err.message); process.exit(1); });
@@ -1,91 +1,91 @@
1
- /**
2
- * Example: Cross-Site Agent Orchestration
3
- *
4
- * One agent manages multiple WAB-enabled sites simultaneously.
5
- * Compares prices, aggregates product data, and finds the best deal.
6
- *
7
- * Prerequisites:
8
- * npm install puppeteer web-agent-bridge-sdk
9
- *
10
- * Usage:
11
- * node examples/cross-site-agent.js site1.com site2.com site3.com
12
- */
13
-
14
- const { WABMultiAgent } = require('../sdk');
15
-
16
- const sites = process.argv.slice(2);
17
- if (sites.length < 2) {
18
- console.log('Usage: node cross-site-agent.js <url1> <url2> [url3 ...]');
19
- console.log('Example: node cross-site-agent.js https://shop1.com https://shop2.com');
20
- process.exit(1);
21
- }
22
-
23
- // Ensure URLs have protocol
24
- const urls = sites.map((s) => (s.startsWith('http') ? s : `https://${s}`));
25
-
26
- async function main() {
27
- console.log('\n🌐 WAB Cross-Site Agent Orchestration');
28
- console.log(` Sites: ${urls.length}\n`);
29
-
30
- // 1. Create multi-agent and connect to all sites
31
- const multiAgent = new WABMultiAgent(urls, {
32
- timeout: 20000,
33
- headless: true
34
- });
35
-
36
- console.log('ā³ Launching browsers and connecting...');
37
- const { connected, failed } = await multiAgent.launch();
38
-
39
- for (const site of connected) console.log(` āœ“ Connected: ${site}`);
40
- for (const site of failed) console.log(` āœ— Failed: ${site}`);
41
-
42
- if (connected.length === 0) {
43
- console.log('\nāœ— No sites connected. Exiting.');
44
- await multiAgent.close();
45
- return;
46
- }
47
-
48
- // 2. Discover all sites
49
- console.log('\nšŸ“” Discovering WAB capabilities...');
50
- const discoveries = await multiAgent.discoverAll();
51
- for (const d of discoveries) {
52
- console.log(` ${d.site}: ${d.actions.length} actions`);
53
- }
54
-
55
- // 3. Compare prices for a product
56
- console.log('\nšŸ’° Comparing prices...');
57
- const comparison = await multiAgent.comparePrices('product-sku');
58
- for (const r of comparison.results) {
59
- if (r.price != null) {
60
- console.log(` ${r.site}: ${r.currency} ${r.price.toFixed(2)} — ${r.product}`);
61
- } else {
62
- console.log(` ${r.site}: ${r.error || 'No price data'}`);
63
- }
64
- }
65
-
66
- if (comparison.cheapest) {
67
- console.log(`\nšŸ† Best deal: ${comparison.cheapest.site}`);
68
- console.log(` Price: ${comparison.cheapest.currency} ${comparison.cheapest.price.toFixed(2)}`);
69
- if (comparison.savings != null) {
70
- console.log(` You save: ${comparison.cheapest.currency} ${comparison.savings.toFixed(2)}`);
71
- }
72
- }
73
-
74
- // 4. Execute a common action across all sites
75
- console.log('\nšŸ”„ Executing getPageInfo on all sites...');
76
- const infos = await multiAgent.executeAll('getPageInfo');
77
- for (const info of infos) {
78
- if (info.status === 'fulfilled' && info.value) {
79
- console.log(` ${info.site}: "${info.value.title}" (v${info.value.bridgeVersion})`);
80
- }
81
- }
82
-
83
- // 5. Cleanup
84
- await multiAgent.close();
85
- console.log('\nāœ“ All sessions closed. Done!\n');
86
- }
87
-
88
- main().catch((err) => {
89
- console.error('Error:', err.message);
90
- process.exit(1);
91
- });
1
+ /**
2
+ * Example: Cross-Site Agent Orchestration
3
+ *
4
+ * One agent manages multiple WAB-enabled sites simultaneously.
5
+ * Compares prices, aggregates product data, and finds the best deal.
6
+ *
7
+ * Prerequisites:
8
+ * npm install puppeteer web-agent-bridge-sdk
9
+ *
10
+ * Usage:
11
+ * node examples/cross-site-agent.js site1.com site2.com site3.com
12
+ */
13
+
14
+ const { WABMultiAgent } = require('../sdk');
15
+
16
+ const sites = process.argv.slice(2);
17
+ if (sites.length < 2) {
18
+ console.log('Usage: node cross-site-agent.js <url1> <url2> [url3 ...]');
19
+ console.log('Example: node cross-site-agent.js https://shop1.com https://shop2.com');
20
+ process.exit(1);
21
+ }
22
+
23
+ // Ensure URLs have protocol
24
+ const urls = sites.map((s) => (s.startsWith('http') ? s : `https://${s}`));
25
+
26
+ async function main() {
27
+ console.log('\n🌐 WAB Cross-Site Agent Orchestration');
28
+ console.log(` Sites: ${urls.length}\n`);
29
+
30
+ // 1. Create multi-agent and connect to all sites
31
+ const multiAgent = new WABMultiAgent(urls, {
32
+ timeout: 20000,
33
+ headless: true
34
+ });
35
+
36
+ console.log('ā³ Launching browsers and connecting...');
37
+ const { connected, failed } = await multiAgent.launch();
38
+
39
+ for (const site of connected) console.log(` āœ“ Connected: ${site}`);
40
+ for (const site of failed) console.log(` āœ— Failed: ${site}`);
41
+
42
+ if (connected.length === 0) {
43
+ console.log('\nāœ— No sites connected. Exiting.');
44
+ await multiAgent.close();
45
+ return;
46
+ }
47
+
48
+ // 2. Discover all sites
49
+ console.log('\nšŸ“” Discovering WAB capabilities...');
50
+ const discoveries = await multiAgent.discoverAll();
51
+ for (const d of discoveries) {
52
+ console.log(` ${d.site}: ${d.actions.length} actions`);
53
+ }
54
+
55
+ // 3. Compare prices for a product
56
+ console.log('\nšŸ’° Comparing prices...');
57
+ const comparison = await multiAgent.comparePrices('product-sku');
58
+ for (const r of comparison.results) {
59
+ if (r.price != null) {
60
+ console.log(` ${r.site}: ${r.currency} ${r.price.toFixed(2)} — ${r.product}`);
61
+ } else {
62
+ console.log(` ${r.site}: ${r.error || 'No price data'}`);
63
+ }
64
+ }
65
+
66
+ if (comparison.cheapest) {
67
+ console.log(`\nšŸ† Best deal: ${comparison.cheapest.site}`);
68
+ console.log(` Price: ${comparison.cheapest.currency} ${comparison.cheapest.price.toFixed(2)}`);
69
+ if (comparison.savings != null) {
70
+ console.log(` You save: ${comparison.cheapest.currency} ${comparison.savings.toFixed(2)}`);
71
+ }
72
+ }
73
+
74
+ // 4. Execute a common action across all sites
75
+ console.log('\nšŸ”„ Executing getPageInfo on all sites...');
76
+ const infos = await multiAgent.executeAll('getPageInfo');
77
+ for (const info of infos) {
78
+ if (info.status === 'fulfilled' && info.value) {
79
+ console.log(` ${info.site}: "${info.value.title}" (v${info.value.bridgeVersion})`);
80
+ }
81
+ }
82
+
83
+ // 5. Cleanup
84
+ await multiAgent.close();
85
+ console.log('\nāœ“ All sessions closed. Done!\n');
86
+ }
87
+
88
+ main().catch((err) => {
89
+ console.error('Error:', err.message);
90
+ process.exit(1);
91
+ });