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
@@ -0,0 +1,166 @@
1
+ #!/usr/bin/env node
2
+ 'use strict';
3
+
4
+ /**
5
+ * Official WAB DNS Discovery consumer (multi-site).
6
+ *
7
+ * Proves the full value chain per domain:
8
+ * 1) discover via _wab TXT
9
+ * 2) fetch wab.json endpoint
10
+ * 3) call agent endpoints (/api/wab/discover, /api/wab/ping)
11
+ *
12
+ * Usage:
13
+ * node examples/dns-discovery-agent.js webagentbridge.com example.com
14
+ */
15
+
16
+ const { verify } = require('../packages/dns-verify/src');
17
+ const { safeFetch } = require('../server/utils/safe-fetch');
18
+
19
+ function sanitizeDomain(raw) {
20
+ return String(raw || '')
21
+ .trim()
22
+ .toLowerCase()
23
+ .replace(/^https?:\/\//, '')
24
+ .replace(/\/.*$/, '')
25
+ .replace(/:\d+$/, '')
26
+ .replace(/^www\./, '');
27
+ }
28
+
29
+ function parseEndpoint(record) {
30
+ if (!record || !record.parsed) return null;
31
+ return record.parsed.endpoint || null;
32
+ }
33
+
34
+ function logStep(ok, label, detail) {
35
+ const icon = ok ? 'OK' : 'NO';
36
+ const extra = detail ? ` - ${detail}` : '';
37
+ console.log(`[${icon}] ${label}${extra}`);
38
+ }
39
+
40
+ async function runDomain(domain) {
41
+ console.log('\n=== ' + domain + ' ===');
42
+
43
+ const result = {
44
+ domain,
45
+ dns: null,
46
+ endpoint: null,
47
+ wabJson: null,
48
+ discover: null,
49
+ ping: null,
50
+ ok: false,
51
+ };
52
+
53
+ const proof = await verify(domain, { timeoutMs: 6000 }).catch((err) => ({
54
+ ok: false,
55
+ records: [{ type: '_wab', error: err.message }],
56
+ }));
57
+
58
+ const wabRecord = (proof.records || []).find((r) => r.type === '_wab') || null;
59
+ result.dns = wabRecord;
60
+ logStep(!!(wabRecord && wabRecord.ok), 'DNS discovery', wabRecord && (wabRecord.error || wabRecord.fqdn));
61
+
62
+ const endpoint = parseEndpoint(wabRecord);
63
+ result.endpoint = endpoint;
64
+ if (!endpoint) {
65
+ logStep(false, 'wab.json endpoint', 'missing endpoint= in _wab record');
66
+ return result;
67
+ }
68
+ logStep(true, 'wab.json endpoint', endpoint);
69
+
70
+ const endpointUrl = new URL(endpoint);
71
+ const allowList = [domain, '*.' + domain, endpointUrl.hostname, '*.' + endpointUrl.hostname]
72
+ .filter((v, i, a) => a.indexOf(v) === i);
73
+
74
+ try {
75
+ const wabRes = await safeFetch(endpointUrl.toString(), { headers: { accept: 'application/json' } }, {
76
+ requireHttps: true,
77
+ allowList,
78
+ timeoutMs: 8000,
79
+ maxBytes: 1024 * 1024,
80
+ allowedContentTypes: ['application/json', 'application/ld+json', 'text/plain'],
81
+ });
82
+ const wabJson = await wabRes.json();
83
+ result.wabJson = wabJson;
84
+ logStep(wabRes.ok, 'Fetch wab.json', wabRes.status + ' ' + (wabJson.provider && wabJson.provider.name || 'unknown provider'));
85
+ } catch (err) {
86
+ logStep(false, 'Fetch wab.json', err.message);
87
+ return result;
88
+ }
89
+
90
+ const origin = endpointUrl.origin;
91
+ const discoverUrl = origin + '/api/wab/discover';
92
+ const fallbackDiscoverUrl = origin + '/agent-bridge.json';
93
+
94
+ try {
95
+ const discoverRes = await safeFetch(discoverUrl, { headers: { accept: 'application/json' } }, {
96
+ requireHttps: true,
97
+ allowList,
98
+ timeoutMs: 8000,
99
+ maxBytes: 1024 * 1024,
100
+ allowedContentTypes: ['application/json'],
101
+ });
102
+ if (discoverRes.ok) {
103
+ const discoverJson = await discoverRes.json();
104
+ result.discover = discoverJson;
105
+ logStep(true, 'Agent discover', 'GET /api/wab/discover');
106
+ } else {
107
+ const fallbackRes = await safeFetch(fallbackDiscoverUrl, { headers: { accept: 'application/json' } }, {
108
+ requireHttps: true,
109
+ allowList,
110
+ timeoutMs: 8000,
111
+ maxBytes: 1024 * 1024,
112
+ allowedContentTypes: ['application/json'],
113
+ });
114
+ const fallbackJson = await fallbackRes.json().catch(() => ({}));
115
+ if (fallbackRes.ok) {
116
+ result.discover = fallbackJson;
117
+ logStep(true, 'Agent discover', `fallback /agent-bridge.json (discover HTTP ${discoverRes.status})`);
118
+ } else {
119
+ logStep(false, 'Agent discover', `discover HTTP ${discoverRes.status}; fallback HTTP ${fallbackRes.status}`);
120
+ }
121
+ }
122
+ } catch (err) {
123
+ logStep(false, 'Agent discover', err.message);
124
+ }
125
+
126
+ try {
127
+ const pingRes = await safeFetch(origin + '/api/wab/ping', { headers: { accept: 'application/json' } }, {
128
+ requireHttps: true,
129
+ allowList,
130
+ timeoutMs: 8000,
131
+ maxBytes: 512 * 1024,
132
+ allowedContentTypes: ['application/json'],
133
+ });
134
+ const pingJson = await pingRes.json();
135
+ result.ping = pingJson;
136
+ logStep(pingRes.ok, 'Agent execute', 'GET /api/wab/ping => pong=' + !!(pingJson.result && pingJson.result.pong));
137
+ } catch (err) {
138
+ logStep(false, 'Agent execute', err.message);
139
+ }
140
+
141
+ result.ok = !!(result.dns && result.dns.ok && result.wabJson && result.ping);
142
+ return result;
143
+ }
144
+
145
+ async function main() {
146
+ const domains = process.argv.slice(2).map(sanitizeDomain).filter(Boolean);
147
+ if (domains.length === 0) {
148
+ console.error('Usage: node examples/dns-discovery-agent.js <domain1> [domain2] [...]');
149
+ process.exit(1);
150
+ }
151
+
152
+ const outputs = [];
153
+ for (const domain of domains) {
154
+ outputs.push(await runDomain(domain));
155
+ }
156
+
157
+ const passed = outputs.filter((o) => o.ok).length;
158
+ console.log('\nSummary: ' + passed + '/' + outputs.length + ' domains passed full flow');
159
+
160
+ if (passed !== outputs.length) process.exitCode = 2;
161
+ }
162
+
163
+ main().catch((err) => {
164
+ console.error('Fatal:', err && err.stack || err);
165
+ process.exit(1);
166
+ });
@@ -0,0 +1,76 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * gcp-dns-wab.js — enable/disable WAB DNS Discovery TXT record on Google Cloud DNS.
4
+ *
5
+ * Usage:
6
+ * node gcp-dns-wab.js enable example.com my-project example-com
7
+ * node gcp-dns-wab.js disable example.com my-project example-com
8
+ * node gcp-dns-wab.js status example.com
9
+ *
10
+ * Auth: uses Application Default Credentials (run `gcloud auth application-default login`)
11
+ * or set GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
12
+ *
13
+ * Required: @google-cloud/dns
14
+ * npm install @google-cloud/dns
15
+ */
16
+
17
+ 'use strict';
18
+
19
+ const fetch = (() => { try { return require('node-fetch'); } catch { return globalThis.fetch; } })();
20
+ const { DNS } = require('@google-cloud/dns');
21
+
22
+ const [,, action, domain, projectId, zoneName] = process.argv;
23
+ const WAB_BASE = process.env.WAB_BASE_URL || 'https://www.webagentbridge.com';
24
+ const ENDPOINT = process.env.WAB_ENDPOINT || `https://${domain}/.well-known/wab.json`;
25
+
26
+ if (!action || !domain) { console.error('Usage: node gcp-dns-wab.js <enable|disable|status> <domain> [projectId] [zoneName]'); process.exit(1); }
27
+ if (!['enable','disable','status'].includes(action)) { console.error('Action must be: enable | disable | status'); process.exit(1); }
28
+ if (action !== 'status' && (!projectId || !zoneName)) { console.error('projectId and zoneName required for enable/disable'); process.exit(1); }
29
+
30
+ async function getRecordTemplate() {
31
+ const j = await (await fetch(`${WAB_BASE}/api/discovery/provider/record-template?domain=${encodeURIComponent(domain)}&endpoint=${encodeURIComponent(ENDPOINT)}`)).json();
32
+ if (!j.record || !j.record.value) throw new Error('Could not fetch WAB record template');
33
+ const v = j.record.value;
34
+ return v.startsWith('"') ? v : `"${v}"`;
35
+ }
36
+
37
+ async function main() {
38
+ console.log(`[WAB] Action: ${action} | Domain: ${domain}`);
39
+
40
+ if (action === 'status') {
41
+ const j = await (await fetch(`${WAB_BASE}/api/discovery/provider/status?domain=${encodeURIComponent(domain)}`)).json();
42
+ console.log(`[WAB] Status: ${j.status}`);
43
+ console.log(JSON.stringify(j, null, 2));
44
+ return;
45
+ }
46
+
47
+ const dns = new DNS({ projectId });
48
+ const zone = dns.zone(zoneName);
49
+ const fqdn = `_wab.${domain}.`;
50
+
51
+ const [existing] = await zone.getRecords({ type: 'TXT', name: fqdn });
52
+ console.log(`[GCP] Existing _wab TXT records: ${existing.length}`);
53
+
54
+ if (action === 'enable') {
55
+ const txtVal = await getRecordTemplate();
56
+ console.log(`[WAB] TXT value: ${txtVal}`);
57
+ const newRecord = zone.record('txt', { name: fqdn, ttl: 3600, data: txtVal });
58
+ if (existing.length) {
59
+ const [change] = await zone.createChange({ delete: existing, add: newRecord });
60
+ console.log(`[GCP] Replaced (change id=${change.id}, status=${change.metadata.status})`);
61
+ } else {
62
+ const [change] = await zone.createChange({ add: newRecord });
63
+ console.log(`[GCP] Created (change id=${change.id}, status=${change.metadata.status})`);
64
+ }
65
+ console.log('[WAB] WAB Discovery ENABLED.');
66
+ }
67
+
68
+ if (action === 'disable') {
69
+ if (!existing.length) { console.log('[GCP] No _wab record found — already disabled.'); return; }
70
+ const [change] = await zone.createChange({ delete: existing });
71
+ console.log(`[GCP] Deleted (change id=${change.id}, status=${change.metadata.status})`);
72
+ console.log('[WAB] WAB Discovery DISABLED.');
73
+ }
74
+ }
75
+
76
+ main().catch(err => { console.error('[ERROR]', err.message); process.exit(1); });
@@ -0,0 +1,169 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * WAB Governance Demo
4
+ * ───────────────────
5
+ * Walks through the full Layer-3 governance pipeline:
6
+ *
7
+ * 1) register agent → get one-time token
8
+ * 2) define permission boundaries (Stripe read-only + refund <$50 + ClickUp write)
9
+ * 3) try a forbidden action → DENIED
10
+ * 4) try an allowed action → ALLOWED + audited
11
+ * 5) try a high-value refund → APPROVAL_REQUIRED → human approves → executed
12
+ * 6) verify audit chain → tamper-evident
13
+ * 7) kill switch → all subsequent actions DENIED
14
+ *
15
+ * Run:
16
+ * node examples/governance-agent.js
17
+ * WAB_API=http://localhost:3000 node examples/governance-agent.js
18
+ */
19
+
20
+ 'use strict';
21
+
22
+ const { WABGovernance } = require('../sdk');
23
+
24
+ const API = process.env.WAB_API || 'http://localhost:3000';
25
+
26
+ const c = {
27
+ reset: '\x1b[0m', dim: '\x1b[2m', bold: '\x1b[1m',
28
+ green: '\x1b[32m', red: '\x1b[31m', yellow: '\x1b[33m',
29
+ blue: '\x1b[34m', cyan: '\x1b[36m', magenta: '\x1b[35m',
30
+ };
31
+ const log = (msg) => console.log(msg);
32
+ const head = (n, msg) => log(`\n${c.bold}${c.cyan}── ${n}. ${msg} ──${c.reset}`);
33
+ const ok = (m) => log(` ${c.green}✓${c.reset} ${m}`);
34
+ const no = (m) => log(` ${c.red}✗${c.reset} ${m}`);
35
+ const info = (m) => log(` ${c.dim}${m}${c.reset}`);
36
+
37
+ async function main() {
38
+ log(`${c.bold}${c.magenta}WAB Agent Governance Demo${c.reset} ${c.dim}(API: ${API})${c.reset}`);
39
+
40
+ // ── 1) Register a fresh agent identity
41
+ head(1, 'Register agent');
42
+ const reg = await WABGovernance.register({
43
+ apiBase: API,
44
+ displayName: 'Demo Agent — Stripe + ClickUp',
45
+ metadata: { demo: true, created: Date.now() },
46
+ });
47
+ ok(`agent_id = ${reg.agent_id}`);
48
+ ok(`agent_token (shown ONCE) = ${reg.agent_token.slice(0, 12)}…`);
49
+
50
+ const gov = new WABGovernance({
51
+ apiBase: API,
52
+ agentId: reg.agent_id,
53
+ agentToken: reg.agent_token,
54
+ // Auto-approve in this demo (a real app would post to Slack/email).
55
+ onApprovalRequired: async (req) => {
56
+ info(`[human approval] resource=${req.resource} action=${req.action} amount=${req.amount}`);
57
+ info('[human approval] auto-approving in demo (3s think...)');
58
+ await sleep(3000);
59
+ return 'approved';
60
+ },
61
+ approvalTimeoutMs: 30_000,
62
+ });
63
+
64
+ // ── 2) Define policies
65
+ head(2, 'Define permission boundaries');
66
+ await gov.definePolicy({ resource: 'stripe', action: 'read', scope: 'customers' });
67
+ ok('stripe:read on customers');
68
+ await gov.definePolicy({
69
+ resource: 'stripe', action: 'write', scope: 'refunds',
70
+ max_amount: 50, currency: 'USD', daily_cap: 200,
71
+ });
72
+ ok('stripe:write on refunds (max $50/call, $200/day)');
73
+ await gov.definePolicy({
74
+ resource: 'stripe', action: 'write', scope: 'refunds-large',
75
+ max_amount: 5000, currency: 'USD', requires_approval: true,
76
+ });
77
+ ok('stripe:write on refunds-large (≤$5000, REQUIRES HUMAN APPROVAL)');
78
+ await gov.definePolicy({
79
+ resource: 'clickup', action: 'write', scope: 'tasks', per_call_rate: 30,
80
+ });
81
+ ok('clickup:write on tasks (rate-limited 30/min)');
82
+
83
+ // ── 3) Forbidden action
84
+ head(3, 'Attempt forbidden action: gmail:write');
85
+ try {
86
+ await gov.guard({ resource: 'gmail', action: 'write', scope: 'inbox' },
87
+ async () => { throw new Error('should not run'); });
88
+ no('UNEXPECTED: action ran (governance failed)');
89
+ } catch (e) {
90
+ ok(`correctly blocked: ${e.message}`);
91
+ }
92
+
93
+ // ── 4) Allowed read
94
+ head(4, 'Allowed action: stripe:read on customers');
95
+ const r = await gov.guard(
96
+ { resource: 'stripe', action: 'read', scope: 'customers' },
97
+ async () => ({ count: 12, sample: [{ id: 'cus_abc', email: 'demo@x' }] }),
98
+ );
99
+ ok(`executed in ${r.elapsed_ms}ms — result keys: ${Object.keys(r.result).join(', ')}`);
100
+
101
+ // ── 5) Small refund: under cap, no approval
102
+ head(5, 'Small refund: $9.99 (under cap)');
103
+ const r2 = await gov.guard(
104
+ { resource: 'stripe', action: 'write', scope: 'refunds',
105
+ amount: 9.99, currency: 'USD',
106
+ params: { charge: 'ch_xyz', reason: 'duplicate' } },
107
+ async () => ({ refund_id: 're_demo_' + Date.now(), status: 'succeeded' }),
108
+ );
109
+ ok(`refund posted: ${r2.result.refund_id}`);
110
+
111
+ // ── 6) Refund OVER per-call cap → DENIED instantly
112
+ head(6, 'Refund $9999 with cap=$50 → DENY');
113
+ try {
114
+ await gov.guard(
115
+ { resource: 'stripe', action: 'write', scope: 'refunds',
116
+ amount: 9999, currency: 'USD' },
117
+ async () => 'should not run',
118
+ );
119
+ no('UNEXPECTED: action ran');
120
+ } catch (e) {
121
+ ok(`correctly blocked: ${e.message}`);
122
+ }
123
+
124
+ // ── 7) Large refund routed through approval gate
125
+ head(7, 'Large refund $499.99 → APPROVAL GATE');
126
+ const r3 = await gov.guard(
127
+ { resource: 'stripe', action: 'write', scope: 'refunds-large',
128
+ amount: 499.99, currency: 'USD',
129
+ params: { charge: 'ch_big', reason: 'fraud_dispute' },
130
+ reason: 'high_value_refund_requires_review' },
131
+ async () => ({ refund_id: 're_big_' + Date.now(), status: 'succeeded' }),
132
+ );
133
+ ok(`approved + executed: ${r3.result.refund_id}`);
134
+
135
+ // ── 8) Audit log + chain verification
136
+ head(8, 'Audit log + tamper check');
137
+ const audit = await gov.getAudit({ limit: 20 });
138
+ info(`last ${audit.audit.length} events:`);
139
+ for (const ev of audit.audit.slice(0, 8)) {
140
+ const tag = ev.decision === 'deny' ? c.red : ev.decision === 'pending' ? c.yellow : c.green;
141
+ log(` ${tag}${(ev.decision || '·').padEnd(8)}${c.reset}` +
142
+ ` ${(ev.event_type || '').padEnd(18)} ${ev.resource || ''}/${ev.action || ''}` +
143
+ ` ${ev.scope ? '['+ev.scope+'] ' : ''}${ev.amount ? '$'+ev.amount : ''}`);
144
+ }
145
+ const v = await gov.verifyAudit();
146
+ if (v.ok) ok(`chain verified: ${v.count} entries, head=${(v.head || '').slice(0, 12)}…`);
147
+ else no(`chain BROKEN at id=${v.broken_at}`);
148
+
149
+ // ── 9) Kill switch
150
+ head(9, 'Kill switch');
151
+ await gov.kill('demo_complete');
152
+ ok('agent killed');
153
+ try {
154
+ await gov.guard({ resource: 'stripe', action: 'read', scope: 'customers' },
155
+ async () => 'should not run');
156
+ no('UNEXPECTED: action ran after kill');
157
+ } catch (e) {
158
+ ok(`post-kill action blocked: ${e.message}`);
159
+ }
160
+
161
+ log(`\n${c.bold}${c.green}✓ Demo complete${c.reset}\n`);
162
+ }
163
+
164
+ function sleep(ms) { return new Promise((r) => setTimeout(r, ms)); }
165
+
166
+ main().catch((e) => {
167
+ console.error(`\n${c.red}Demo failed:${c.reset}`, e.message);
168
+ process.exit(1);
169
+ });
@@ -1,94 +1,94 @@
1
- /**
2
- * Example: Using WAB sites via the MCP adapter
3
- *
4
- * The WAB-MCP adapter exposes every WAB site action as an MCP tool,
5
- * so any MCP-compatible AI agent (Claude, GPT, etc.) can interact
6
- * with WAB-enabled websites through a uniform tool interface.
7
- *
8
- * Usage:
9
- * node examples/mcp-agent.js <site-url>
10
- */
11
-
12
- const { WABMCPAdapter } = require('../wab-mcp-adapter');
13
-
14
- const TARGET = process.argv[2] || 'http://localhost:3000';
15
-
16
- async function main() {
17
- console.log('\n WAB → MCP Adapter Demo');
18
- console.log(` Target: ${TARGET}\n`);
19
-
20
- const adapter = new WABMCPAdapter({
21
- siteUrl: TARGET,
22
- transport: 'http'
23
- });
24
-
25
- // Step 1: Discover site capabilities
26
- console.log('1. Discovering WAB capabilities...');
27
- const discovery = await adapter.discover();
28
- if (discovery) {
29
- console.log(` Provider: ${discovery.provider?.name || 'unknown'}`);
30
- console.log(` Domain: ${discovery.provider?.domain || 'unknown'}`);
31
- console.log(` Tier: ${discovery.capabilities?.tier || 'free'}`);
32
- console.log(` Features: ${(discovery.capabilities?.features || []).join(', ')}`);
33
- if (discovery.fairness) {
34
- console.log(` Fairness: score=${discovery.fairness.neutrality_score}, independent=${discovery.fairness.is_independent}`);
35
- }
36
- } else {
37
- console.log(' No discovery document found (site may not have WAB configured)');
38
- }
39
-
40
- // Step 2: List MCP tools
41
- console.log('\n2. Available MCP tools:');
42
- const tools = await adapter.getTools();
43
- tools.forEach(tool => {
44
- const params = tool.input_schema?.properties
45
- ? Object.keys(tool.input_schema.properties).join(', ')
46
- : 'none';
47
- console.log(` - ${tool.name}: ${tool.description} (params: ${params})`);
48
- });
49
-
50
- // Step 3: Execute built-in tools
51
- console.log('\n3. Executing wab_get_page_info...');
52
- try {
53
- const infoResult = await adapter.executeTool('wab_get_page_info', {});
54
- const info = infoResult.content;
55
- if (infoResult.is_error) {
56
- console.log(` Error: ${info.error}`);
57
- } else {
58
- console.log(` Title: ${info.title || 'N/A'}`);
59
- console.log(` Version: ${info.bridgeVersion || 'N/A'}`);
60
- console.log(` Domain: ${info.domain || 'N/A'}`);
61
- }
62
- } catch (err) {
63
- console.log(` Error: ${err.message}`);
64
- }
65
-
66
- // Step 4: Search the fairness registry
67
- console.log('\n4. Fairness-weighted search (demo):');
68
- try {
69
- const searchResult = await adapter.executeTool('wab_fairness_search', {
70
- query: 'e-commerce',
71
- limit: 5
72
- });
73
- const search = searchResult.content;
74
- if (searchResult.is_error) {
75
- console.log(` Error: ${search.error}`);
76
- } else if (search.results?.length) {
77
- search.results.forEach(r => {
78
- console.log(` - ${r.name} (${r.domain}) — score: ${r.final_score}`);
79
- });
80
- } else {
81
- console.log(' No sites registered in directory yet.');
82
- }
83
- } catch (err) {
84
- console.log(` Registry not available: ${err.message}`);
85
- }
86
-
87
- console.log('\nDone. In a real MCP integration, these tools would be');
88
- console.log('exposed to Claude/GPT via the MCP tool-use protocol.\n');
89
- }
90
-
91
- main().catch(err => {
92
- console.error('Error:', err.message);
93
- process.exit(1);
94
- });
1
+ /**
2
+ * Example: Using WAB sites via the MCP adapter
3
+ *
4
+ * The WAB-MCP adapter exposes every WAB site action as an MCP tool,
5
+ * so any MCP-compatible AI agent (Claude, GPT, etc.) can interact
6
+ * with WAB-enabled websites through a uniform tool interface.
7
+ *
8
+ * Usage:
9
+ * node examples/mcp-agent.js <site-url>
10
+ */
11
+
12
+ const { WABMCPAdapter } = require('../wab-mcp-adapter');
13
+
14
+ const TARGET = process.argv[2] || 'http://localhost:3000';
15
+
16
+ async function main() {
17
+ console.log('\n WAB → MCP Adapter Demo');
18
+ console.log(` Target: ${TARGET}\n`);
19
+
20
+ const adapter = new WABMCPAdapter({
21
+ siteUrl: TARGET,
22
+ transport: 'http'
23
+ });
24
+
25
+ // Step 1: Discover site capabilities
26
+ console.log('1. Discovering WAB capabilities...');
27
+ const discovery = await adapter.discover();
28
+ if (discovery) {
29
+ console.log(` Provider: ${discovery.provider?.name || 'unknown'}`);
30
+ console.log(` Domain: ${discovery.provider?.domain || 'unknown'}`);
31
+ console.log(` Tier: ${discovery.capabilities?.tier || 'free'}`);
32
+ console.log(` Features: ${(discovery.capabilities?.features || []).join(', ')}`);
33
+ if (discovery.fairness) {
34
+ console.log(` Fairness: score=${discovery.fairness.neutrality_score}, independent=${discovery.fairness.is_independent}`);
35
+ }
36
+ } else {
37
+ console.log(' No discovery document found (site may not have WAB configured)');
38
+ }
39
+
40
+ // Step 2: List MCP tools
41
+ console.log('\n2. Available MCP tools:');
42
+ const tools = await adapter.getTools();
43
+ tools.forEach(tool => {
44
+ const params = tool.input_schema?.properties
45
+ ? Object.keys(tool.input_schema.properties).join(', ')
46
+ : 'none';
47
+ console.log(` - ${tool.name}: ${tool.description} (params: ${params})`);
48
+ });
49
+
50
+ // Step 3: Execute built-in tools
51
+ console.log('\n3. Executing wab_get_page_info...');
52
+ try {
53
+ const infoResult = await adapter.executeTool('wab_get_page_info', {});
54
+ const info = infoResult.content;
55
+ if (infoResult.is_error) {
56
+ console.log(` Error: ${info.error}`);
57
+ } else {
58
+ console.log(` Title: ${info.title || 'N/A'}`);
59
+ console.log(` Version: ${info.bridgeVersion || 'N/A'}`);
60
+ console.log(` Domain: ${info.domain || 'N/A'}`);
61
+ }
62
+ } catch (err) {
63
+ console.log(` Error: ${err.message}`);
64
+ }
65
+
66
+ // Step 4: Search the fairness registry
67
+ console.log('\n4. Fairness-weighted search (demo):');
68
+ try {
69
+ const searchResult = await adapter.executeTool('wab_fairness_search', {
70
+ query: 'e-commerce',
71
+ limit: 5
72
+ });
73
+ const search = searchResult.content;
74
+ if (searchResult.is_error) {
75
+ console.log(` Error: ${search.error}`);
76
+ } else if (search.results?.length) {
77
+ search.results.forEach(r => {
78
+ console.log(` - ${r.name} (${r.domain}) — score: ${r.final_score}`);
79
+ });
80
+ } else {
81
+ console.log(' No sites registered in directory yet.');
82
+ }
83
+ } catch (err) {
84
+ console.log(` Registry not available: ${err.message}`);
85
+ }
86
+
87
+ console.log('\nDone. In a real MCP integration, these tools would be');
88
+ console.log('exposed to Claude/GPT via the MCP tool-use protocol.\n');
89
+ }
90
+
91
+ main().catch(err => {
92
+ console.error('Error:', err.message);
93
+ process.exit(1);
94
+ });