web-agent-bridge 3.2.0 → 3.4.0

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 (256) hide show
  1. package/LICENSE +84 -72
  2. package/README.ar.md +1304 -1152
  3. package/README.md +298 -1635
  4. package/bin/agent-runner.js +474 -474
  5. package/bin/cli.js +237 -138
  6. package/bin/wab-init.js +223 -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/shopify-hydrogen/README.md +74 -74
  24. package/examples/vision-agent.js +171 -171
  25. package/examples/wab-sign.js +74 -0
  26. package/examples/wab-verify.js +60 -0
  27. package/examples/wordpress-elementor/README.md +77 -77
  28. package/package.json +19 -6
  29. package/public/.well-known/agent-tools.json +180 -180
  30. package/public/.well-known/ai-assets.json +59 -59
  31. package/public/.well-known/security.txt +8 -0
  32. package/public/.well-known/wab.json +28 -0
  33. package/public/activate.html +368 -0
  34. package/public/adoption-metrics.html +188 -0
  35. package/public/agent-workspace.html +349 -349
  36. package/public/ai.html +198 -198
  37. package/public/api.html +413 -412
  38. package/public/azure-dns-integration.html +289 -0
  39. package/public/browser.html +486 -486
  40. package/public/cloudflare-integration.html +380 -0
  41. package/public/commander-dashboard.html +243 -243
  42. package/public/cookies.html +210 -210
  43. package/public/cpanel-integration.html +398 -0
  44. package/public/css/agent-workspace.css +1713 -1713
  45. package/public/css/premium.css +317 -317
  46. package/public/css/styles.css +1263 -1235
  47. package/public/dashboard.html +707 -706
  48. package/public/dns.html +436 -0
  49. package/public/docs.html +588 -587
  50. package/public/feed.xml +89 -89
  51. package/public/gcp-dns-integration.html +318 -0
  52. package/public/growth.html +465 -463
  53. package/public/index.html +1266 -982
  54. package/public/integrations.html +556 -0
  55. package/public/js/activate.js +145 -0
  56. package/public/js/agent-workspace.js +1740 -1740
  57. package/public/js/auth-nav.js +65 -31
  58. package/public/js/auth-redirect.js +12 -12
  59. package/public/js/cookie-consent.js +56 -56
  60. package/public/js/dns.js +438 -0
  61. package/public/js/wab-demo-page.js +721 -721
  62. package/public/js/ws-client.js +74 -74
  63. package/public/llms-full.txt +360 -360
  64. package/public/llms.txt +125 -125
  65. package/public/login.html +85 -85
  66. package/public/mesh-dashboard.html +328 -328
  67. package/public/openapi.json +669 -580
  68. package/public/phone-shield.html +281 -0
  69. package/public/plesk-integration.html +375 -0
  70. package/public/premium-dashboard.html +2489 -2489
  71. package/public/premium.html +793 -793
  72. package/public/privacy.html +297 -297
  73. package/public/provider-onboarding.html +172 -0
  74. package/public/provider-sandbox.html +134 -0
  75. package/public/providers.html +359 -0
  76. package/public/register.html +105 -105
  77. package/public/registrar-integrations.html +141 -0
  78. package/public/robots.txt +99 -87
  79. package/public/route53-integration.html +531 -0
  80. package/public/script/wab-consent.d.ts +36 -36
  81. package/public/script/wab-consent.js +104 -104
  82. package/public/script/wab-schema.js +131 -131
  83. package/public/script/wab.d.ts +108 -108
  84. package/public/script/wab.min.js +580 -580
  85. package/public/security.txt +8 -0
  86. package/public/shieldqr.html +231 -0
  87. package/public/sitemap.xml +6 -0
  88. package/public/terms.html +256 -256
  89. package/public/wab-trust.html +200 -0
  90. package/public/wab-vs-protocols.html +210 -0
  91. package/public/whitepaper.html +449 -0
  92. package/script/ai-agent-bridge.js +1754 -1754
  93. package/sdk/README.md +99 -99
  94. package/sdk/agent-mesh.js +449 -449
  95. package/sdk/auto-discovery.js +288 -0
  96. package/sdk/commander.js +262 -262
  97. package/sdk/governance.js +262 -0
  98. package/sdk/index.d.ts +464 -464
  99. package/sdk/index.js +25 -1
  100. package/sdk/multi-agent.js +318 -318
  101. package/sdk/package.json +2 -2
  102. package/sdk/safe-mode.js +221 -0
  103. package/sdk/safety-shield.js +219 -0
  104. package/sdk/schema-discovery.js +83 -83
  105. package/server/adapters/index.js +520 -520
  106. package/server/config/plans.js +367 -367
  107. package/server/config/secrets.js +102 -102
  108. package/server/control-plane/index.js +301 -301
  109. package/server/data-plane/index.js +354 -354
  110. package/server/index.js +670 -427
  111. package/server/llm/index.js +404 -404
  112. package/server/middleware/adminAuth.js +35 -35
  113. package/server/middleware/auth.js +50 -50
  114. package/server/middleware/featureGate.js +88 -88
  115. package/server/middleware/rateLimits.js +100 -100
  116. package/server/middleware/sensitiveAction.js +157 -0
  117. package/server/migrations/001_add_analytics_indexes.sql +7 -7
  118. package/server/migrations/002_premium_features.sql +418 -418
  119. package/server/migrations/003_ads_integer_cents.sql +33 -33
  120. package/server/migrations/004_agent_os.sql +158 -158
  121. package/server/migrations/005_marketplace_metering.sql +126 -126
  122. package/server/migrations/007_governance.sql +106 -0
  123. package/server/migrations/008_plans.sql +144 -0
  124. package/server/migrations/009_shieldqr.sql +30 -0
  125. package/server/migrations/010_extended_trust.sql +33 -0
  126. package/server/models/adapters/index.js +33 -33
  127. package/server/models/adapters/mysql.js +183 -183
  128. package/server/models/adapters/postgresql.js +172 -172
  129. package/server/models/adapters/sqlite.js +7 -7
  130. package/server/models/db.js +740 -681
  131. package/server/observability/failure-analysis.js +337 -337
  132. package/server/observability/index.js +394 -394
  133. package/server/protocol/capabilities.js +223 -223
  134. package/server/protocol/index.js +243 -243
  135. package/server/protocol/schema.js +584 -584
  136. package/server/registry/certification.js +271 -271
  137. package/server/registry/index.js +326 -326
  138. package/server/routes/admin-plans.js +76 -0
  139. package/server/routes/admin-premium.js +673 -671
  140. package/server/routes/admin-shieldqr.js +90 -0
  141. package/server/routes/admin-trust-monitor.js +83 -0
  142. package/server/routes/admin.js +549 -261
  143. package/server/routes/ads.js +130 -130
  144. package/server/routes/agent-workspace.js +540 -540
  145. package/server/routes/api.js +150 -150
  146. package/server/routes/auth.js +71 -71
  147. package/server/routes/billing.js +57 -45
  148. package/server/routes/commander.js +316 -316
  149. package/server/routes/demo-showcase.js +332 -332
  150. package/server/routes/demo-store.js +154 -0
  151. package/server/routes/discovery.js +2348 -417
  152. package/server/routes/gateway.js +173 -157
  153. package/server/routes/governance.js +208 -0
  154. package/server/routes/license.js +251 -240
  155. package/server/routes/mesh.js +469 -469
  156. package/server/routes/noscript.js +543 -543
  157. package/server/routes/plans.js +33 -0
  158. package/server/routes/premium-v2.js +686 -686
  159. package/server/routes/premium.js +724 -724
  160. package/server/routes/providers.js +650 -0
  161. package/server/routes/runtime.js +2148 -2147
  162. package/server/routes/shieldqr.js +88 -0
  163. package/server/routes/sovereign.js +465 -385
  164. package/server/routes/universal.js +200 -185
  165. package/server/routes/wab-api.js +850 -501
  166. package/server/runtime/container-worker.js +111 -111
  167. package/server/runtime/container.js +448 -448
  168. package/server/runtime/distributed-worker.js +362 -362
  169. package/server/runtime/event-bus.js +210 -210
  170. package/server/runtime/index.js +253 -253
  171. package/server/runtime/queue.js +599 -599
  172. package/server/runtime/replay.js +666 -666
  173. package/server/runtime/sandbox.js +266 -266
  174. package/server/runtime/scheduler.js +534 -534
  175. package/server/runtime/session-engine.js +293 -293
  176. package/server/runtime/state-manager.js +188 -188
  177. package/server/security/cross-site-redactor.js +196 -0
  178. package/server/security/dry-run.js +180 -0
  179. package/server/security/human-gate-rate-limit.js +147 -0
  180. package/server/security/human-gate-transports.js +178 -0
  181. package/server/security/human-gate.js +281 -0
  182. package/server/security/index.js +368 -368
  183. package/server/security/intent-engine.js +245 -0
  184. package/server/security/reward-guard.js +171 -0
  185. package/server/security/rollback-store.js +239 -0
  186. package/server/security/token-scope.js +404 -0
  187. package/server/security/url-policy.js +139 -0
  188. package/server/services/agent-chat.js +506 -506
  189. package/server/services/agent-learning.js +601 -575
  190. package/server/services/agent-memory.js +625 -625
  191. package/server/services/agent-mesh.js +555 -539
  192. package/server/services/agent-symphony.js +717 -717
  193. package/server/services/agent-tasks.js +1807 -1807
  194. package/server/services/api-key-engine.js +292 -261
  195. package/server/services/cluster.js +894 -894
  196. package/server/services/commander.js +738 -738
  197. package/server/services/edge-compute.js +440 -440
  198. package/server/services/email.js +233 -204
  199. package/server/services/governance.js +466 -0
  200. package/server/services/hosted-runtime.js +205 -205
  201. package/server/services/lfd.js +635 -635
  202. package/server/services/local-ai.js +389 -389
  203. package/server/services/marketplace.js +270 -270
  204. package/server/services/metering.js +182 -182
  205. package/server/services/modules/affiliate-intelligence.js +93 -93
  206. package/server/services/modules/agent-firewall.js +90 -90
  207. package/server/services/modules/bounty.js +89 -89
  208. package/server/services/modules/collective-bargaining.js +92 -92
  209. package/server/services/modules/dark-pattern.js +66 -66
  210. package/server/services/modules/gov-intelligence.js +45 -45
  211. package/server/services/modules/neural.js +55 -55
  212. package/server/services/modules/notary.js +49 -49
  213. package/server/services/modules/price-time-machine.js +86 -86
  214. package/server/services/modules/protocol.js +104 -104
  215. package/server/services/negotiation.js +439 -439
  216. package/server/services/plans.js +214 -0
  217. package/server/services/plugins.js +771 -771
  218. package/server/services/premium.js +1 -1
  219. package/server/services/price-intelligence.js +566 -566
  220. package/server/services/price-shield.js +1137 -1137
  221. package/server/services/provider-clients.js +740 -0
  222. package/server/services/reputation.js +465 -465
  223. package/server/services/search-engine.js +357 -357
  224. package/server/services/security.js +513 -513
  225. package/server/services/self-healing.js +843 -843
  226. package/server/services/shieldqr.js +322 -0
  227. package/server/services/sovereign-shield.js +542 -0
  228. package/server/services/ssl-inspector.js +42 -0
  229. package/server/services/ssl-monitor.js +167 -0
  230. package/server/services/stripe.js +205 -192
  231. package/server/services/swarm.js +788 -788
  232. package/server/services/universal-scraper.js +662 -661
  233. package/server/services/verification.js +481 -481
  234. package/server/services/vision.js +1163 -1163
  235. package/server/services/wab-crypto.js +178 -0
  236. package/server/utils/cache.js +125 -125
  237. package/server/utils/migrate.js +81 -81
  238. package/server/utils/safe-fetch.js +228 -0
  239. package/server/utils/secureFields.js +50 -50
  240. package/server/ws.js +161 -161
  241. package/templates/artisan-marketplace.yaml +104 -104
  242. package/templates/book-price-scout.yaml +98 -98
  243. package/templates/electronics-price-tracker.yaml +108 -108
  244. package/templates/flight-deal-hunter.yaml +113 -113
  245. package/templates/freelancer-direct.yaml +116 -116
  246. package/templates/grocery-price-compare.yaml +93 -93
  247. package/templates/hotel-direct-booking.yaml +113 -113
  248. package/templates/local-services.yaml +98 -98
  249. package/templates/olive-oil-tunisia.yaml +88 -88
  250. package/templates/organic-farm-fresh.yaml +101 -101
  251. package/templates/restaurant-direct.yaml +97 -97
  252. package/public/score.html +0 -263
  253. package/server/migrations/006_growth_suite.sql +0 -138
  254. package/server/routes/growth.js +0 -962
  255. package/server/services/fairness-engine.js +0 -409
  256. package/server/services/fairness.js +0 -420
package/public/route53-integration.html ADDED
@@ -0,0 +1,531 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width,initial-scale=1">
6
+ <title>WAB DNS — AWS Route 53 Integration</title>
7
+ <link rel="stylesheet" href="/css/main.css">
8
+ <style>
9
+ body { font-family: system-ui, sans-serif; background: #0f172a; color: #e2e8f0; margin: 0; padding: 0; }
10
+ .page { max-width: 880px; margin: 0 auto; padding: 40px 20px 80px; }
11
+ h1 { font-size: 1.7rem; margin-bottom: 6px; }
12
+ .sub { color: #94a3b8; margin-bottom: 32px; font-size: .97rem; }
13
+ .card { background: #1e293b; border-radius: 10px; padding: 24px; margin-bottom: 24px; }
14
+ h2 { font-size: 1.1rem; margin: 0 0 14px; }
15
+ label { display: block; font-size: .85rem; color: #94a3b8; margin-bottom: 4px; margin-top: 14px; }
16
+ label:first-child { margin-top: 0; }
17
+ input[type=text], input[type=password] {
18
+ width: 100%; box-sizing: border-box; background: #0f172a; border: 1px solid #334155;
19
+ color: #e2e8f0; border-radius: 6px; padding: 9px 12px; font-size: .93rem;
20
+ }
21
+ input:focus { outline: 2px solid #6366f1; border-color: transparent; }
22
+ .row { display: flex; gap: 12px; }
23
+ .row > * { flex: 1; }
24
+ .actions { display: flex; gap: 10px; margin-top: 20px; flex-wrap: wrap; }
25
+ .btn { padding: 9px 20px; border-radius: 7px; border: none; cursor: pointer; font-size: .92rem; font-weight: 600; transition: opacity .15s; }
26
+ .btn:hover { opacity: .85; }
27
+ .btn:disabled { opacity: .45; cursor: not-allowed; }
28
+ .btn-enable { background: #f59e0b; color: #000; }
29
+ .btn-disable { background: #ef4444; color: #fff; }
30
+ .btn-verify { background: #6366f1; color: #fff; }
31
+ .btn-secondary { background: #334155; color: #e2e8f0; }
32
+ #statusBar { margin-top: 18px; min-height: 36px; padding: 10px 14px; border-radius: 7px; background: #0f172a; font-size: .88rem; color: #94a3b8; display: none; }
33
+ #statusBar.ok { display: block; color: #4ade80; border: 1px solid #166534; }
34
+ #statusBar.err { display: block; color: #f87171; border: 1px solid #7f1d1d; }
35
+ #statusBar.info { display: block; color: #93c5fd; border: 1px solid #1e3a5f; }
36
+ pre { background: #0f172a; border-radius: 7px; padding: 14px 16px; font-size: .82rem; color: #94a3b8; overflow-x: auto; white-space: pre-wrap; word-break: break-word; margin: 14px 0 0; }
37
+ code { background: #0f172a; padding: 1px 5px; border-radius: 4px; font-size: .88em; }
38
+ .tab-bar { display: flex; gap: 4px; margin-bottom: 14px; }
39
+ .tab { padding: 5px 14px; border-radius: 6px; cursor: pointer; font-size: .84rem; background: #0f172a; color: #94a3b8; border: 1px solid #334155; }
40
+ .tab.active { background: #6366f1; color: #fff; border-color: transparent; }
41
+ .tab-panel { display: none; }
42
+ .tab-panel.active { display: block; }
43
+ .step { display: flex; gap: 14px; margin-bottom: 18px; }
44
+ .step-num { flex-shrink: 0; width: 28px; height: 28px; border-radius: 50%; background: #334155; color: #e2e8f0; font-size: .82rem; font-weight: 700; display: flex; align-items: center; justify-content: center; }
45
+ .step-body { flex: 1; padding-top: 3px; }
46
+ .warning-box { background: #431407; border: 1px solid #9a3412; border-radius: 8px; padding: 12px 16px; font-size: .87rem; color: #fdba74; margin-bottom: 18px; }
47
+ .info-box { background: #0c2340; border: 1px solid #1e3a5f; border-radius: 8px; padding: 12px 16px; font-size: .87rem; color: #93c5fd; margin-bottom: 18px; }
48
+ a { color: #818cf8; }
49
+ </style>
50
+ </head>
51
+ <body>
52
+ <div class="page">
53
+ <h1>AWS Route 53 × WAB DNS Discovery</h1>
54
+ <p class="sub">
55
+ One-click enable or disable the WAB DNS Discovery TXT record on any Route 53 hosted zone.
56
+ Uses the AWS Route 53 REST API via <a href="https://sdk.amazonaws.com/js/aws-sdk-2.x.min.js" target="_blank" rel="noopener">AWS SDK v2</a> — your credentials stay in your browser only.
57
+ </p>
58
+
59
+ <div class="info-box">
60
+ ℹ <strong>Recommended:</strong> Create a dedicated IAM user with only <code>route53:ChangeResourceRecordSets</code>
61
+ and <code>route53:ListResourceRecordSets</code> permissions on the specific hosted zone.
62
+ Never use root account credentials.
63
+ </div>
64
+
65
+ <div class="warning-box">
66
+ ⚠ AWS Access Key and Secret Key are used client-side only to sign requests directly to Route 53.
67
+ They are <strong>never sent to WAB servers</strong>. Use temporary STS credentials (AssumeRole) when possible.
68
+ </div>
69
+
70
+ <!-- ── STEP 1: credentials ── -->
71
+ <div class="card">
72
+ <h2>1. AWS Credentials</h2>
73
+ <div class="row">
74
+ <div>
75
+ <label>AWS Access Key ID</label>
76
+ <input type="text" id="awsKeyId" placeholder="AKIAIOSFODNN7EXAMPLE" autocomplete="off">
77
+ </div>
78
+ <div>
79
+ <label>AWS Secret Access Key</label>
80
+ <input type="password" id="awsSecret" placeholder="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" autocomplete="off">
81
+ </div>
82
+ </div>
83
+ <label>AWS Region <span style="color:#64748b;font-weight:400">(Route 53 is always us-east-1)</span></label>
84
+ <input type="text" id="awsRegion" value="us-east-1" style="max-width:160px">
85
+ </div>
86
+
87
+ <!-- ── STEP 2: hosted zone + domain ── -->
88
+ <div class="card">
89
+ <h2>2. Hosted Zone &amp; Domain</h2>
90
+ <div class="row">
91
+ <div>
92
+ <label>Domain</label>
93
+ <input type="text" id="r53Domain" placeholder="example.com">
94
+ </div>
95
+ <div>
96
+ <label>Hosted Zone ID <span style="color:#64748b;font-weight:400">(leave blank to auto-discover)</span></label>
97
+ <input type="text" id="r53ZoneId" placeholder="Z1D633PJN98FT9">
98
+ </div>
99
+ </div>
100
+ <label>Endpoint URL <span style="color:#64748b;font-weight:400">(leave blank for auto)</span></label>
101
+ <input type="text" id="r53Endpoint" placeholder="https://example.com/.well-known/wab.json">
102
+ </div>
103
+
104
+ <!-- ── STEP 3: actions ── -->
105
+ <div class="card">
106
+ <h2>3. Actions</h2>
107
+ <div class="actions">
108
+ <button class="btn btn-enable" id="btnEnable" onclick="r53Action('UPSERT')">✓ Enable WAB Discovery</button>
109
+ <button class="btn btn-disable" id="btnDisable" onclick="r53Action('DELETE')">✗ Disable WAB Discovery</button>
110
+ <button class="btn btn-verify" id="btnVerify" onclick="r53Verify()">⟳ Verify Status</button>
111
+ <button class="btn btn-secondary" onclick="window.open('/provider-sandbox','_blank')">Open Sandbox</button>
112
+ </div>
113
+ <div id="statusBar"></div>
114
+ <pre id="jsonOut" style="display:none"></pre>
115
+ </div>
116
+
117
+ <!-- ── HOW IT WORKS ── -->
118
+ <div class="card">
119
+ <h2>How it works</h2>
120
+ <div>
121
+ <div class="step">
122
+ <div class="step-num">1</div>
123
+ <div class="step-body">Fetch the WAB <strong>record template</strong> (<code>GET /api/discovery/provider/record-template</code>) to get TXT value: <code>v=wab1; endpoint=https://…</code></div>
124
+ </div>
125
+ <div class="step">
126
+ <div class="step-num">2</div>
127
+ <div class="step-body">If no Zone ID provided, call Route 53 <code>ListHostedZonesByName</code> to resolve it from the domain name.</div>
128
+ </div>
129
+ <div class="step">
130
+ <div class="step-num">3</div>
131
+ <div class="step-body"><strong>Enable:</strong> call <code>ChangeResourceRecordSets</code> with action <code>UPSERT</code> — creates or updates <code>_wab.example.com TXT</code>.<br>
132
+ <strong>Disable:</strong> list existing record → call <code>ChangeResourceRecordSets</code> with action <code>DELETE</code>.</div>
133
+ </div>
134
+ <div class="step">
135
+ <div class="step-num">4</div>
136
+ <div class="step-body">Confirm with <code>/api/discovery/provider/status</code>. Route 53 propagation is typically 60 s or less.</div>
137
+ </div>
138
+ </div>
139
+ </div>
140
+
141
+ <!-- ── CODE SNIPPETS ── -->
142
+ <div class="card">
143
+ <h2>Code Snippets</h2>
144
+ <div class="tab-bar">
145
+ <div class="tab active" onclick="switchTab('nodejs')">Node.js (AWS SDK v3)</div>
146
+ <div class="tab" onclick="switchTab('cli')">AWS CLI</div>
147
+ <div class="tab" onclick="switchTab('tf')">Terraform</div>
148
+ </div>
149
+
150
+ <div id="tab-nodejs" class="tab-panel active">
151
+ <pre>// npm install @aws-sdk/client-route-53
152
+ import { Route53Client, ChangeResourceRecordSetsCommand, ListHostedZonesByNameCommand, ListResourceRecordSetsCommand } from '@aws-sdk/client-route-53';
153
+
154
+ const client = new Route53Client({ region: 'us-east-1' });
155
+ const DOMAIN = 'example.com';
156
+ const ENDPOINT = `https://${DOMAIN}/.well-known/wab.json`;
157
+ const TXT_VAL = `"v=wab1; endpoint=${ENDPOINT}"`; // Route 53 requires double-quoted TXT
158
+
159
+ async function getZoneId() {
160
+ const r = await client.send(new ListHostedZonesByNameCommand({ DNSName: DOMAIN, MaxItems: '1' }));
161
+ const zone = r.HostedZones.find(z => z.Name === `${DOMAIN}.`);
162
+ if (!zone) throw new Error(`No hosted zone found for ${DOMAIN}`);
163
+ return zone.Id.replace('/hostedzone/', '');
164
+ }
165
+
166
+ async function getCurrentRecord(zoneId) {
167
+ const r = await client.send(new ListResourceRecordSetsCommand({
168
+ HostedZoneId: zoneId, StartRecordName: `_wab.${DOMAIN}`, StartRecordType: 'TXT', MaxItems: '1'
169
+ }));
170
+ return r.ResourceRecordSets.find(rr => rr.Name === `_wab.${DOMAIN}.` && rr.Type === 'TXT') || null;
171
+ }
172
+
173
+ async function enableWAB() {
174
+ const zoneId = await getZoneId();
175
+ await client.send(new ChangeResourceRecordSetsCommand({
176
+ HostedZoneId: zoneId,
177
+ ChangeBatch: {
178
+ Changes: [{ Action: 'UPSERT', ResourceRecordSet: {
179
+ Name: `_wab.${DOMAIN}`, Type: 'TXT', TTL: 3600,
180
+ ResourceRecords: [{ Value: TXT_VAL }]
181
+ }}]
182
+ }
183
+ }));
184
+ console.log('WAB Discovery ENABLED (UPSERT applied)');
185
+ }
186
+
187
+ async function disableWAB() {
188
+ const zoneId = await getZoneId();
189
+ const existing = await getCurrentRecord(zoneId);
190
+ if (!existing) { console.log('Already disabled.'); return; }
191
+ await client.send(new ChangeResourceRecordSetsCommand({
192
+ HostedZoneId: zoneId,
193
+ ChangeBatch: { Changes: [{ Action: 'DELETE', ResourceRecordSet: existing }] }
194
+ }));
195
+ console.log('WAB Discovery DISABLED (record deleted)');
196
+ }
197
+
198
+ enableWAB().catch(console.error);
199
+ </pre>
200
+ </div>
201
+
202
+ <div id="tab-cli" class="tab-panel">
203
+ <pre># Set credentials
204
+ export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
205
+ export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
206
+ export AWS_DEFAULT_REGION=us-east-1
207
+
208
+ # 1. Get Hosted Zone ID
209
+ ZONE_ID=$(aws route53 list-hosted-zones-by-name \
210
+ --dns-name example.com --query "HostedZones[0].Id" --output text | cut -d/ -f3)
211
+
212
+ # 2. Enable (UPSERT)
213
+ aws route53 change-resource-record-sets \
214
+ --hosted-zone-id "$ZONE_ID" \
215
+ --change-batch '{
216
+ "Changes": [{
217
+ "Action": "UPSERT",
218
+ "ResourceRecordSet": {
219
+ "Name": "_wab.example.com",
220
+ "Type": "TXT",
221
+ "TTL": 3600,
222
+ "ResourceRecords": [{"Value": "\"v=wab1; endpoint=https://example.com/.well-known/wab.json\""}]
223
+ }
224
+ }]
225
+ }'
226
+
227
+ # 3. Disable (DELETE) — first fetch current record to match exactly
228
+ CURRENT_VALUE=$(aws route53 list-resource-record-sets \
229
+ --hosted-zone-id "$ZONE_ID" \
230
+ --query "ResourceRecordSets[?Name=='_wab.example.com.'].ResourceRecords[0].Value" \
231
+ --output text)
232
+
233
+ aws route53 change-resource-record-sets \
234
+ --hosted-zone-id "$ZONE_ID" \
235
+ --change-batch "{
236
+ \"Changes\": [{
237
+ \"Action\": \"DELETE\",
238
+ \"ResourceRecordSet\": {
239
+ \"Name\": \"_wab.example.com\",
240
+ \"Type\": \"TXT\",
241
+ \"TTL\": 3600,
242
+ \"ResourceRecords\": [{\"Value\": \"$CURRENT_VALUE\"}]
243
+ }
244
+ }]
245
+ }"
246
+ </pre>
247
+ </div>
248
+
249
+ <div id="tab-tf" class="tab-panel">
250
+ <pre># terraform — manages _wab TXT record declaratively
251
+ data "aws_route53_zone" "zone" {
252
+ name = "example.com."
253
+ }
254
+
255
+ resource "aws_route53_record" "wab_discovery" {
256
+ zone_id = data.aws_route53_zone.zone.zone_id
257
+ name = "_wab.example.com"
258
+ type = "TXT"
259
+ ttl = 3600
260
+ records = ["v=wab1; endpoint=https://example.com/.well-known/wab.json"]
261
+ }
262
+
263
+ # To disable: remove the resource block and run `terraform apply`
264
+ # Or use count = 0 to toggle:
265
+ # count = var.wab_enabled ? 1 : 0
266
+ </pre>
267
+ </div>
268
+ </div>
269
+
270
+ <!-- ── IAM POLICY ── -->
271
+ <div class="card">
272
+ <h2>Minimal IAM Policy</h2>
273
+ <p style="font-size:.85rem;color:#94a3b8;margin:0 0 10px">
274
+ Create a dedicated IAM user / role with this policy, scoped to only the required hosted zone.
275
+ Replace <code>ZONE_ID</code> with your actual Zone ID.
276
+ </p>
277
+ <pre>{
278
+ "Version": "2012-10-17",
279
+ "Statement": [
280
+ {
281
+ "Effect": "Allow",
282
+ "Action": [
283
+ "route53:ChangeResourceRecordSets",
284
+ "route53:ListResourceRecordSets"
285
+ ],
286
+ "Resource": "arn:aws:route53:::hostedzone/ZONE_ID"
287
+ },
288
+ {
289
+ "Effect": "Allow",
290
+ "Action": "route53:ListHostedZonesByName",
291
+ "Resource": "*"
292
+ }
293
+ ]
294
+ }</pre>
295
+ </div>
296
+
297
+ <p style="text-align:center;margin-top:30px;font-size:.85rem;color:#475569">
298
+ <a href="/provider-onboarding">← Back to Provider Onboarding</a> ·
299
+ <a href="/cloudflare-integration">Cloudflare</a> ·
300
+ <a href="/cpanel-integration">cPanel</a> ·
301
+ <a href="/provider-sandbox">Sandbox</a> ·
302
+ <a href="/dns">DNS Discovery</a>
303
+ </p>
304
+ </div>
305
+
306
+ <script>
307
+ // AWS SigV4 signing (Route 53 requires Signature Version 4)
308
+ // Since browser-side SigV4 is complex, we proxy via WAB's enable-plan endpoint
309
+ // and display the steps — for real browser automation we use an approach that
310
+ // signs requests via the WAB backend acting as a signing proxy (zero credential exposure).
311
+
312
+ function switchTab(name) {
313
+ document.querySelectorAll('.tab').forEach(t => t.classList.remove('active'));
314
+ document.querySelectorAll('.tab-panel').forEach(p => p.classList.remove('active'));
315
+ document.querySelector(`#tab-${name}`).classList.add('active');
316
+ event.target.classList.add('active');
317
+ }
318
+
319
+ function setStatus(msg, type) {
320
+ const bar = document.getElementById('statusBar');
321
+ bar.textContent = msg;
322
+ bar.className = type;
323
+ }
324
+
325
+ function showJson(obj) {
326
+ const pre = document.getElementById('jsonOut');
327
+ pre.textContent = JSON.stringify(obj, null, 2);
328
+ pre.style.display = 'block';
329
+ }
330
+
331
+ function getInputs() {
332
+ return {
333
+ keyId: document.getElementById('awsKeyId').value.trim(),
334
+ secret: document.getElementById('awsSecret').value.trim(),
335
+ region: document.getElementById('awsRegion').value.trim() || 'us-east-1',
336
+ domain: document.getElementById('r53Domain').value.trim().toLowerCase().replace(/^https?:\/\//, '').replace(/\/$/, ''),
337
+ zoneId: document.getElementById('r53ZoneId').value.trim(),
338
+ endpoint: document.getElementById('r53Endpoint').value.trim(),
339
+ };
340
+ }
341
+
342
+ // SigV4 implementation using WebCrypto
343
+ async function hmacSha256(key, data) {
344
+ const k = typeof key === 'string' ? new TextEncoder().encode(key) : key;
345
+ const cryptoKey = await crypto.subtle.importKey('raw', k, { name: 'HMAC', hash: 'SHA-256' }, false, ['sign']);
346
+ return new Uint8Array(await crypto.subtle.sign('HMAC', cryptoKey, new TextEncoder().encode(data)));
347
+ }
348
+
349
+ async function sha256hex(data) {
350
+ const buf = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(data));
351
+ return Array.from(new Uint8Array(buf)).map(b => b.toString(16).padStart(2, '0')).join('');
352
+ }
353
+
354
+ function toHex(buf) {
355
+ return Array.from(buf).map(b => b.toString(16).padStart(2, '0')).join('');
356
+ }
357
+
358
+ async function sigV4Sign({ method, host, path, query = '', body = '', keyId, secret, region, service, amzdate, datestamp }) {
359
+ const payloadHash = await sha256hex(body);
360
+ const canonicalHeaders = `host:${host}\nx-amz-date:${amzdate}\n`;
361
+ const signedHeaders = 'host;x-amz-date';
362
+ const canonicalRequest = [method, path, query, canonicalHeaders, signedHeaders, payloadHash].join('\n');
363
+ const credentialScope = `${datestamp}/${region}/${service}/aws4_request`;
364
+ const stringToSign = `AWS4-HMAC-SHA256\n${amzdate}\n${credentialScope}\n${await sha256hex(canonicalRequest)}`;
365
+
366
+ let sigKey = await hmacSha256('AWS4' + secret, datestamp);
367
+ sigKey = await hmacSha256(sigKey, region);
368
+ sigKey = await hmacSha256(sigKey, service);
369
+ sigKey = await hmacSha256(sigKey, 'aws4_request');
370
+ const signature = toHex(await hmacSha256(sigKey, stringToSign));
371
+
372
+ const authHeader = `AWS4-HMAC-SHA256 Credential=${keyId}/${credentialScope}, SignedHeaders=${signedHeaders}, Signature=${signature}`;
373
+ return { authHeader, payloadHash, amzdate };
374
+ }
375
+
376
+ async function r53Request({ keyId, secret, region, method, path, query = '', body = '' }) {
377
+ const host = 'route53.amazonaws.com';
378
+ const now = new Date();
379
+ const amzdate = now.toISOString().replace(/[:\-]|\.\d{3}/g, '').slice(0, 15) + 'Z';
380
+ const datestamp = amzdate.slice(0, 8);
381
+
382
+ const { authHeader, payloadHash } = await sigV4Sign({ method, host, path, query, body, keyId, secret, region, service: 'route53', amzdate, datestamp });
383
+
384
+ const headers = {
385
+ 'Host': host,
386
+ 'X-Amz-Date': amzdate,
387
+ 'Authorization': authHeader,
388
+ 'X-Amz-Content-Sha256': payloadHash,
389
+ };
390
+ if (body) headers['Content-Type'] = 'text/xml';
391
+
392
+ const url = `https://${host}${path}${query ? '?' + query : ''}`;
393
+ const r = await fetch(url, { method, headers, body: body || undefined });
394
+ const text = await r.text();
395
+ if (!r.ok) throw new Error(`Route53 ${r.status}: ${text.slice(0, 300)}`);
396
+ return text;
397
+ }
398
+
399
+ function parseZoneId(xml) {
400
+ const m = xml.match(/<Id>\/hostedzone\/([^<]+)<\/Id>/);
401
+ return m ? m[1] : null;
402
+ }
403
+
404
+ function parseTxtRecord(xml, fqdn) {
405
+ // returns { ttl, value } or null
406
+ const sets = xml.match(/<ResourceRecordSet>[\s\S]*?<\/ResourceRecordSet>/g) || [];
407
+ for (const s of sets) {
408
+ if (s.includes(`<Name>${fqdn}</Name>`) && s.includes('<Type>TXT</Type>')) {
409
+ const ttl = (s.match(/<TTL>(\d+)<\/TTL>/) || [])[1] || '3600';
410
+ const val = (s.match(/<Value>([^<]+)<\/Value>/) || [])[1] || '';
411
+ return { ttl, value: val };
412
+ }
413
+ }
414
+ return null;
415
+ }
416
+
417
+ async function resolveZoneId(inp) {
418
+ if (inp.zoneId) return inp.zoneId;
419
+ setStatus('Resolving Route 53 Hosted Zone ID…', 'info');
420
+ const xml = await r53Request({ ...inp, method: 'GET', path: '/2013-04-01/hostedzonesbyname', query: `dnsname=${encodeURIComponent(inp.domain)}&maxitems=1` });
421
+ const id = parseZoneId(xml);
422
+ if (!id) throw new Error(`No hosted zone found for domain "${inp.domain}". Check the domain and your IAM permissions.`);
423
+ return id;
424
+ }
425
+
426
+ async function r53Action(action) {
427
+ const inp = getInputs();
428
+ if (!inp.keyId) return setStatus('Please enter your AWS Access Key ID.', 'err');
429
+ if (!inp.secret) return setStatus('Please enter your AWS Secret Access Key.', 'err');
430
+ if (!inp.domain) return setStatus('Please enter the domain name.', 'err');
431
+
432
+ document.getElementById('btnEnable').disabled = true;
433
+ document.getElementById('btnDisable').disabled = true;
434
+
435
+ try {
436
+ setStatus('Fetching WAB record template…', 'info');
437
+ const ep = inp.endpoint || `https://${inp.domain}/.well-known/wab.json`;
438
+ const tplRes = await fetch(`/api/discovery/provider/record-template?domain=${encodeURIComponent(inp.domain)}&endpoint=${encodeURIComponent(ep)}`);
439
+ const tpl = await tplRes.json();
440
+ const rawTxt = tpl.record && tpl.record.value;
441
+ if (!rawTxt) throw new Error('Could not fetch WAB record template.');
442
+ // Route 53 requires TXT value wrapped in double-quotes
443
+ const txtVal = rawTxt.startsWith('"') ? rawTxt : `"${rawTxt}"`;
444
+
445
+ const zoneId = await resolveZoneId(inp);
446
+ document.getElementById('r53ZoneId').value = zoneId;
447
+ const fqdn = `_wab.${inp.domain}.`;
448
+
449
+ if (action === 'DELETE') {
450
+ setStatus('Fetching existing _wab TXT record…', 'info');
451
+ const listXml = await r53Request({ ...inp, method: 'GET', path: `/2013-04-01/hostedzone/${zoneId}/rrset`, query: `name=${encodeURIComponent(fqdn)}&type=TXT&maxitems=1` });
452
+ const existing = parseTxtRecord(listXml, fqdn);
453
+ if (!existing) {
454
+ setStatus(`No _wab TXT record found for ${inp.domain} — already disabled.`, 'ok');
455
+ showJson({ note: 'no record found', domain: inp.domain });
456
+ return;
457
+ }
458
+ // DELETE requires exact match of TTL + value
459
+ const deleteBody = `<?xml version="1.0" encoding="UTF-8"?>
460
+ <ChangeResourceRecordSetsRequest xmlns="https://route53.amazonaws.com/doc/2013-04-01/">
461
+ <ChangeBatch>
462
+ <Changes>
463
+ <Change>
464
+ <Action>DELETE</Action>
465
+ <ResourceRecordSet>
466
+ <Name>${fqdn}</Name>
467
+ <Type>TXT</Type>
468
+ <TTL>${existing.ttl}</TTL>
469
+ <ResourceRecords>
470
+ <ResourceRecord><Value>${existing.value}</Value></ResourceRecord>
471
+ </ResourceRecords>
472
+ </ResourceRecordSet>
473
+ </Change>
474
+ </Changes>
475
+ </ChangeBatch>
476
+ </ChangeResourceRecordSetsRequest>`;
477
+ setStatus('Deleting _wab TXT record…', 'info');
478
+ const xml = await r53Request({ ...inp, method: 'POST', path: `/2013-04-01/hostedzone/${zoneId}/rrset`, body: deleteBody });
479
+ setStatus(`✓ _wab TXT record deleted for ${inp.domain}. WAB Discovery is DISABLED.`, 'ok');
480
+ showJson({ action: 'DELETE', domain: inp.domain, response: xml.slice(0, 400) });
481
+ } else {
482
+ // UPSERT
483
+ const upsertBody = `<?xml version="1.0" encoding="UTF-8"?>
484
+ <ChangeResourceRecordSetsRequest xmlns="https://route53.amazonaws.com/doc/2013-04-01/">
485
+ <ChangeBatch>
486
+ <Changes>
487
+ <Change>
488
+ <Action>UPSERT</Action>
489
+ <ResourceRecordSet>
490
+ <Name>${fqdn}</Name>
491
+ <Type>TXT</Type>
492
+ <TTL>3600</TTL>
493
+ <ResourceRecords>
494
+ <ResourceRecord><Value>${txtVal}</Value></ResourceRecord>
495
+ </ResourceRecords>
496
+ </ResourceRecordSet>
497
+ </Change>
498
+ </Changes>
499
+ </ChangeBatch>
500
+ </ChangeResourceRecordSetsRequest>`;
501
+ setStatus('Applying UPSERT for _wab TXT record…', 'info');
502
+ const xml = await r53Request({ ...inp, method: 'POST', path: `/2013-04-01/hostedzone/${zoneId}/rrset`, body: upsertBody });
503
+ setStatus(`✓ _wab TXT record upserted for ${inp.domain}. WAB Discovery is ENABLED.`, 'ok');
504
+ showJson({ action: 'UPSERT', domain: inp.domain, zoneId, txtValue: txtVal, response: xml.slice(0, 400) });
505
+ }
506
+ } catch (err) {
507
+ setStatus(`Error: ${err.message}`, 'err');
508
+ } finally {
509
+ document.getElementById('btnEnable').disabled = false;
510
+ document.getElementById('btnDisable').disabled = false;
511
+ }
512
+ }
513
+
514
+ async function r53Verify() {
515
+ const { domain } = getInputs();
516
+ if (!domain) return setStatus('Please enter a domain name.', 'err');
517
+ setStatus('Checking WAB status via DNS…', 'info');
518
+ try {
519
+ const r = await fetch(`/api/discovery/provider/status?domain=${encodeURIComponent(domain)}`);
520
+ const j = await r.json();
521
+ if (j.status === 'enabled') setStatus(`✓ ${domain} — WAB Discovery is ENABLED.`, 'ok');
522
+ else if (j.status === 'partial') setStatus(`⚠ ${domain} — DNS found but endpoint has issues.`, 'info');
523
+ else setStatus(`✗ ${domain} — WAB Discovery is DISABLED (no valid TXT record found).`, 'err');
524
+ showJson(j);
525
+ } catch (err) {
526
+ setStatus(`Verify error: ${err.message}`, 'err');
527
+ }
528
+ }
529
+ </script>
530
+ </body>
531
+ </html>
package/public/script/wab-consent.d.ts CHANGED
@@ -1,36 +1,36 @@
1
- /**
2
- * WAB Consent — GDPR/CCPA consent banner for AI agent actions.
3
- * Loaded after wab.min.js: <script src="/script/wab-consent.js"></script>
4
- */
5
-
6
- export interface WABConsentBannerOptions {
7
- /** URL to the privacy policy page. */
8
- policyUrl?: string;
9
- /** Custom banner message. */
10
- message?: string;
11
- /** Called when user clicks Allow. */
12
- onAccept?: () => void;
13
- /** Called when user clicks Decline. */
14
- onDecline?: () => void;
15
- /** If true (default), skip banner if consent already granted. */
16
- skipIfGranted?: boolean;
17
- }
18
-
19
- export interface WABConsentAPI {
20
- /** Show the consent banner (skips if already granted unless skipIfGranted is false). */
21
- showBanner(options?: WABConsentBannerOptions): void;
22
- /** Returns true if the user has granted consent. */
23
- hasConsent(): boolean;
24
- /** Clear stored consent (resets to un-decided). */
25
- clear(): void;
26
- /** localStorage key used for persisting consent. */
27
- STORAGE_KEY: string;
28
- }
29
-
30
- declare global {
31
- interface Window {
32
- WABConsent: WABConsentAPI;
33
- }
34
- }
35
-
36
- export {};
1
+ /**
2
+ * WAB Consent — GDPR/CCPA consent banner for AI agent actions.
3
+ * Loaded after wab.min.js: <script src="/script/wab-consent.js"></script>
4
+ */
5
+
6
+ export interface WABConsentBannerOptions {
7
+ /** URL to the privacy policy page. */
8
+ policyUrl?: string;
9
+ /** Custom banner message. */
10
+ message?: string;
11
+ /** Called when user clicks Allow. */
12
+ onAccept?: () => void;
13
+ /** Called when user clicks Decline. */
14
+ onDecline?: () => void;
15
+ /** If true (default), skip banner if consent already granted. */
16
+ skipIfGranted?: boolean;
17
+ }
18
+
19
+ export interface WABConsentAPI {
20
+ /** Show the consent banner (skips if already granted unless skipIfGranted is false). */
21
+ showBanner(options?: WABConsentBannerOptions): void;
22
+ /** Returns true if the user has granted consent. */
23
+ hasConsent(): boolean;
24
+ /** Clear stored consent (resets to un-decided). */
25
+ clear(): void;
26
+ /** localStorage key used for persisting consent. */
27
+ STORAGE_KEY: string;
28
+ }
29
+
30
+ declare global {
31
+ interface Window {
32
+ WABConsent: WABConsentAPI;
33
+ }
34
+ }
35
+
36
+ export {};