web-agent-bridge 3.4.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 (310) hide show
  1. package/LICENSE +84 -84
  2. package/README.ar.md +1563 -1304
  3. package/README.md +137 -298
  4. package/bin/agent-runner.js +474 -474
  5. package/bin/cli.js +237 -237
  6. package/bin/wab-init.js +244 -223
  7. package/bin/wab.js +80 -80
  8. package/examples/azure-dns-wab.js +83 -83
  9. package/examples/bidi-agent.js +119 -119
  10. package/examples/cloudflare-wab-dns.js +121 -121
  11. package/examples/cpanel-wab-dns.js +114 -114
  12. package/examples/cross-site-agent.js +91 -91
  13. package/examples/dns-discovery-agent.js +166 -166
  14. package/examples/gcp-dns-wab.js +76 -76
  15. package/examples/governance-agent.js +169 -169
  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 -103
  19. package/examples/puppeteer-agent.js +108 -108
  20. package/examples/route53-wab-dns.js +144 -144
  21. package/examples/saas-dashboard/README.md +55 -55
  22. package/examples/safe-mode-agent.js +96 -96
  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 -74
  27. package/examples/wab-verify.js +60 -60
  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 -28
  34. package/public/activate.html +448 -368
  35. package/public/adopt.html +236 -0
  36. package/public/adoption-metrics.html +188 -188
  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 -289
  41. package/public/browser.html +486 -486
  42. package/public/cloudflare-integration.html +380 -380
  43. package/public/commander-dashboard.html +243 -243
  44. package/public/cookies.html +210 -210
  45. package/public/cpanel-integration.html +398 -398
  46. package/public/css/agent-workspace.css +1713 -1713
  47. package/public/css/premium.css +317 -317
  48. package/public/css/styles.css +1401 -1263
  49. package/public/dashboard-shieldlink.html +295 -0
  50. package/public/dashboard.html +711 -707
  51. package/public/dns.html +436 -436
  52. package/public/docs.html +588 -588
  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 -318
  57. package/public/governance.ar.html +70 -0
  58. package/public/governance.html +69 -0
  59. package/public/growth.html +465 -465
  60. package/public/index.html +1372 -1266
  61. package/public/integrations.html +556 -556
  62. package/public/js/activate.js +449 -145
  63. package/public/js/agent-workspace.js +1740 -1740
  64. package/public/js/auth-nav.js +117 -65
  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 -438
  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 -669
  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 -375
  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 -172
  86. package/public/provider-sandbox.html +134 -134
  87. package/public/providers.html +359 -359
  88. package/public/refusals.html +172 -0
  89. package/public/register.html +105 -105
  90. package/public/registrar-integrations.html +141 -141
  91. package/public/ring4.html +292 -0
  92. package/public/robots.txt +99 -99
  93. package/public/route53-integration.html +531 -531
  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 -231
  103. package/public/sitemap.xml +13 -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 -200
  109. package/public/wab-truth.html +375 -0
  110. package/public/wab-vs-protocols.html +210 -210
  111. package/public/whitepaper.html +449 -449
  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 -288
  116. package/sdk/commander.js +262 -262
  117. package/sdk/governance.js +262 -262
  118. package/sdk/index.d.ts +464 -464
  119. package/sdk/index.js +649 -649
  120. package/sdk/multi-agent.js +318 -318
  121. package/sdk/safe-mode.js +221 -221
  122. package/sdk/safety-shield.js +219 -219
  123. package/sdk/schema-discovery.js +83 -83
  124. package/server/adapters/index.js +520 -520
  125. package/server/config/plans.js +412 -367
  126. package/server/config/secrets.js +102 -102
  127. package/server/control-plane/index.js +301 -301
  128. package/server/data-plane/index.js +354 -354
  129. package/server/index.js +790 -670
  130. package/server/llm/index.js +404 -404
  131. package/server/middleware/adminAuth.js +35 -35
  132. package/server/middleware/api-tier.js +170 -0
  133. package/server/middleware/auth.js +50 -50
  134. package/server/middleware/featureGate.js +88 -88
  135. package/server/middleware/rateLimits.js +100 -100
  136. package/server/middleware/sensitiveAction.js +157 -157
  137. package/server/middleware/wab-trust.js +141 -0
  138. package/server/migrations/001_add_analytics_indexes.sql +7 -7
  139. package/server/migrations/002_premium_features.sql +418 -418
  140. package/server/migrations/003_ads_integer_cents.sql +33 -33
  141. package/server/migrations/004_agent_os.sql +158 -158
  142. package/server/migrations/005_marketplace_metering.sql +126 -126
  143. package/server/migrations/006_growth_suite.sql +138 -0
  144. package/server/migrations/007_governance.sql +106 -106
  145. package/server/migrations/008_plans.sql +144 -144
  146. package/server/migrations/009_shieldqr.sql +30 -30
  147. package/server/migrations/010_extended_trust.sql +33 -33
  148. package/server/migrations/011_outreach.sql +47 -0
  149. package/server/migrations/012_shieldlink.sql +116 -0
  150. package/server/migrations/013_ct_monitor.sql +13 -0
  151. package/server/migrations/014_wab_advanced_features.sql +128 -0
  152. package/server/migrations/015_wab_truth_layer.sql +101 -0
  153. package/server/migrations/016_ring4_external_trust.sql +84 -0
  154. package/server/migrations/017_ring4_extensions.sql +69 -0
  155. package/server/migrations/018_commercial_foundations.sql +167 -0
  156. package/server/migrations/019_unify_tier_constraints.sql +133 -0
  157. package/server/models/adapters/index.js +33 -33
  158. package/server/models/adapters/mysql.js +183 -183
  159. package/server/models/adapters/postgresql.js +172 -172
  160. package/server/models/adapters/sqlite.js +7 -7
  161. package/server/models/db.js +740 -740
  162. package/server/observability/failure-analysis.js +337 -337
  163. package/server/observability/index.js +394 -394
  164. package/server/protocol/capabilities.js +223 -223
  165. package/server/protocol/index.js +243 -243
  166. package/server/protocol/schema.js +584 -584
  167. package/server/registry/certification.js +271 -271
  168. package/server/registry/index.js +326 -326
  169. package/server/routes/activate.js +478 -0
  170. package/server/routes/admin-outreach.js +239 -0
  171. package/server/routes/admin-plans.js +76 -76
  172. package/server/routes/admin-premium.js +674 -673
  173. package/server/routes/admin-shieldlink.js +137 -0
  174. package/server/routes/admin-shieldqr.js +90 -90
  175. package/server/routes/admin-trust-monitor.js +139 -83
  176. package/server/routes/admin.js +550 -549
  177. package/server/routes/adopt.js +61 -0
  178. package/server/routes/ads.js +130 -130
  179. package/server/routes/agent-workspace.js +540 -540
  180. package/server/routes/api-keys.js +127 -0
  181. package/server/routes/api.js +150 -150
  182. package/server/routes/auth.js +71 -71
  183. package/server/routes/billing.js +57 -57
  184. package/server/routes/commander.js +316 -316
  185. package/server/routes/customer-shieldlink.js +133 -0
  186. package/server/routes/demo-showcase.js +332 -332
  187. package/server/routes/demo-store.js +154 -154
  188. package/server/routes/diagnose.js +373 -0
  189. package/server/routes/discovery.js +2348 -2348
  190. package/server/routes/enterprise-mesh.js +170 -0
  191. package/server/routes/gateway.js +173 -173
  192. package/server/routes/governance-saas.js +203 -0
  193. package/server/routes/governance.js +208 -208
  194. package/server/routes/growth.js +1048 -0
  195. package/server/routes/intent.js +328 -0
  196. package/server/routes/license.js +251 -251
  197. package/server/routes/mesh.js +469 -469
  198. package/server/routes/noscript.js +543 -543
  199. package/server/routes/partners.js +201 -0
  200. package/server/routes/plans.js +33 -33
  201. package/server/routes/premium-v2.js +686 -686
  202. package/server/routes/premium.js +724 -724
  203. package/server/routes/providers.js +650 -650
  204. package/server/routes/reputation.js +411 -0
  205. package/server/routes/ring4.js +885 -0
  206. package/server/routes/runtime.js +2148 -2148
  207. package/server/routes/shieldlink.js +70 -0
  208. package/server/routes/shieldqr.js +88 -88
  209. package/server/routes/sovereign.js +465 -465
  210. package/server/routes/truth-layer.js +670 -0
  211. package/server/routes/universal.js +200 -200
  212. package/server/routes/unsubscribe.js +51 -0
  213. package/server/routes/wab-api.js +850 -850
  214. package/server/routes/wab-cache.js +282 -0
  215. package/server/runtime/container-worker.js +111 -111
  216. package/server/runtime/container.js +448 -448
  217. package/server/runtime/distributed-worker.js +362 -362
  218. package/server/runtime/event-bus.js +210 -210
  219. package/server/runtime/index.js +253 -253
  220. package/server/runtime/queue.js +599 -599
  221. package/server/runtime/replay.js +666 -666
  222. package/server/runtime/sandbox.js +266 -266
  223. package/server/runtime/scheduler.js +534 -534
  224. package/server/runtime/session-engine.js +293 -293
  225. package/server/runtime/state-manager.js +188 -188
  226. package/server/secrets/wab-signing-key.pem +3 -0
  227. package/server/secrets/wab-signing-pub.pem +3 -0
  228. package/server/security/cross-site-redactor.js +196 -196
  229. package/server/security/dry-run.js +180 -180
  230. package/server/security/human-gate-rate-limit.js +147 -147
  231. package/server/security/human-gate-transports.js +178 -178
  232. package/server/security/human-gate.js +281 -281
  233. package/server/security/index.js +368 -368
  234. package/server/security/intent-engine.js +245 -245
  235. package/server/security/reward-guard.js +171 -171
  236. package/server/security/rollback-store.js +239 -239
  237. package/server/security/token-scope.js +404 -404
  238. package/server/security/url-policy.js +139 -139
  239. package/server/services/adoption-agent.js +182 -0
  240. package/server/services/agent-chat.js +506 -506
  241. package/server/services/agent-learning.js +601 -601
  242. package/server/services/agent-memory.js +625 -625
  243. package/server/services/agent-mesh.js +555 -555
  244. package/server/services/agent-symphony.js +717 -717
  245. package/server/services/agent-tasks.js +1807 -1807
  246. package/server/services/api-key-engine.js +292 -292
  247. package/server/services/cluster.js +894 -894
  248. package/server/services/commander.js +738 -738
  249. package/server/services/edge-compute.js +440 -440
  250. package/server/services/email.js +233 -233
  251. package/server/services/fairness-engine.js +409 -0
  252. package/server/services/fairness.js +420 -0
  253. package/server/services/governance.js +466 -466
  254. package/server/services/hosted-runtime.js +205 -205
  255. package/server/services/lfd.js +635 -635
  256. package/server/services/local-ai.js +389 -389
  257. package/server/services/marketplace.js +270 -270
  258. package/server/services/metering.js +182 -182
  259. package/server/services/modules/affiliate-intelligence.js +93 -93
  260. package/server/services/modules/agent-firewall.js +90 -90
  261. package/server/services/modules/bounty.js +89 -89
  262. package/server/services/modules/collective-bargaining.js +92 -92
  263. package/server/services/modules/dark-pattern.js +66 -66
  264. package/server/services/modules/gov-intelligence.js +45 -45
  265. package/server/services/modules/neural.js +55 -55
  266. package/server/services/modules/notary.js +49 -49
  267. package/server/services/modules/price-time-machine.js +86 -86
  268. package/server/services/modules/protocol.js +104 -104
  269. package/server/services/negotiation.js +439 -439
  270. package/server/services/outreach-agent.js +312 -0
  271. package/server/services/plans.js +214 -214
  272. package/server/services/plugins.js +771 -771
  273. package/server/services/price-intelligence.js +566 -566
  274. package/server/services/price-shield.js +1137 -1137
  275. package/server/services/provider-clients.js +740 -740
  276. package/server/services/reputation.js +465 -465
  277. package/server/services/search-engine.js +357 -357
  278. package/server/services/security.js +513 -513
  279. package/server/services/self-healing.js +843 -843
  280. package/server/services/shieldlink.js +492 -0
  281. package/server/services/shieldqr.js +322 -322
  282. package/server/services/sovereign-shield.js +542 -542
  283. package/server/services/ssl-ct-monitor.js +224 -0
  284. package/server/services/ssl-inspector.js +42 -42
  285. package/server/services/ssl-monitor.js +167 -167
  286. package/server/services/stripe.js +206 -205
  287. package/server/services/swarm.js +788 -788
  288. package/server/services/universal-scraper.js +662 -662
  289. package/server/services/verification.js +481 -481
  290. package/server/services/vision.js +1163 -1163
  291. package/server/services/wab-crypto.js +178 -178
  292. package/server/utils/cache.js +125 -125
  293. package/server/utils/migrate.js +81 -81
  294. package/server/utils/safe-fetch.js +228 -228
  295. package/server/utils/secureFields.js +50 -50
  296. package/server/ws.js +161 -161
  297. package/templates/artisan-marketplace.yaml +104 -104
  298. package/templates/book-price-scout.yaml +98 -98
  299. package/templates/electronics-price-tracker.yaml +108 -108
  300. package/templates/flight-deal-hunter.yaml +113 -113
  301. package/templates/freelancer-direct.yaml +116 -116
  302. package/templates/grocery-price-compare.yaml +93 -93
  303. package/templates/hotel-direct-booking.yaml +113 -113
  304. package/templates/local-services.yaml +98 -98
  305. package/templates/olive-oil-tunisia.yaml +88 -88
  306. package/templates/organic-farm-fresh.yaml +101 -101
  307. package/templates/restaurant-direct.yaml +97 -97
  308. package/templates/ring4/banking-sovereign.yaml +55 -0
  309. package/templates/ring4/ecommerce-sovereign.yaml +58 -0
  310. package/templates/ring4/healthcare-sovereign.yaml +60 -0
package/public/registrar-integrations.html CHANGED
@@ -1,141 +1,141 @@
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 — Domain Registrar Integrations</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.25rem; margin: 0 0 14px; display: flex; align-items: center; gap: 10px; }
15
- .pill { display: inline-block; font-size: .68rem; font-weight: 700; padding: 3px 9px; border-radius: 12px; background: #334155; color: #cbd5e1; }
16
- .pill.cli { background: #1e3a8a; color: #bfdbfe; }
17
- .pill.warn { background: #7c2d12; color: #fdba74; }
18
- 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; }
19
- code { background: #0f172a; padding: 1px 5px; border-radius: 4px; font-size: .88em; }
20
- .step { display: flex; gap: 14px; margin-bottom: 18px; }
21
- .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; }
22
- .step-body { flex: 1; padding-top: 3px; }
23
- .info-box { background: #0c2340; border: 1px solid #1e3a5f; border-radius: 8px; padding: 12px 16px; font-size: .87rem; color: #93c5fd; margin-bottom: 18px; }
24
- .warning-box { background: #431407; border: 1px solid #9a3412; border-radius: 8px; padding: 12px 16px; font-size: .87rem; color: #fdba74; margin-bottom: 18px; }
25
- a { color: #818cf8; }
26
- .download-btn { display: inline-block; padding: 7px 14px; background: #6366f1; color: #fff; border-radius: 6px; font-size: .85rem; text-decoration: none; margin-right: 8px; }
27
- .download-btn:hover { opacity: .85; }
28
- </style>
29
- </head>
30
- <body>
31
- <div class="page">
32
- <h1>Domain Registrar Integrations</h1>
33
- <p class="sub">
34
- One-line CLI scripts to enable/disable WAB DNS Discovery on the most popular domain registrars.
35
- </p>
36
-
37
- <div class="info-box">
38
- ℹ <strong>Why CLI not browser?</strong>
39
- Most registrar APIs require static IP allow-lists or block CORS, which prevents direct browser-side calls.
40
- Run these scripts from a server or your local machine instead.
41
- </div>
42
-
43
- <!-- ── GODADDY ── -->
44
- <div class="card">
45
- <h2>GoDaddy <span class="pill cli">CLI</span></h2>
46
- <p style="color:#cbd5e1;font-size:.92rem;margin:0 0 12px">
47
- Uses the <a href="https://developer.godaddy.com/doc/endpoint/domains" target="_blank" rel="noopener">GoDaddy Domains API v1</a>.
48
- Requires production API key + secret from <a href="https://developer.godaddy.com/keys" target="_blank" rel="noopener">developer.godaddy.com/keys</a>.
49
- </p>
50
- <div class="warning-box" style="margin-bottom:12px">
51
- ⚠ GoDaddy now restricts the public API to accounts with 50+ domains or paid Reseller plans.
52
- For smaller accounts, use the GoDaddy DNS web UI to add a TXT record at <code>_wab</code> with the value provided by WAB.
53
- </div>
54
- <div class="step">
55
- <div class="step-num">1</div>
56
- <div class="step-body">Download the script: <a class="download-btn" href="/downloads/godaddy-wab-dns.js" download>⬇ godaddy-wab-dns.js</a></div>
57
- </div>
58
- <div class="step">
59
- <div class="step-num">2</div>
60
- <div class="step-body">Install dependencies: <code>npm install node-fetch@2</code></div>
61
- </div>
62
- <div class="step">
63
- <div class="step-num">3</div>
64
- <div class="step-body">Run:
65
- <pre>GODADDY_API_KEY=your-key GODADDY_API_SECRET=your-secret \
66
- node godaddy-wab-dns.js enable example.com
67
-
68
- GODADDY_API_KEY=your-key GODADDY_API_SECRET=your-secret \
69
- node godaddy-wab-dns.js disable example.com</pre>
70
- </div>
71
- </div>
72
- <h3 style="font-size:1rem;margin:18px 0 8px;color:#cbd5e1">Inline cURL alternative</h3>
73
- <pre># 1. Get current TXT records for _wab
74
- curl -s -H "Authorization: sso-key $KEY:$SECRET" \
75
- "https://api.godaddy.com/v1/domains/example.com/records/TXT/_wab"
76
-
77
- # 2. Replace TXT records (PUT replaces entire record set)
78
- curl -s -X PUT -H "Authorization: sso-key $KEY:$SECRET" \
79
- -H "Content-Type: application/json" \
80
- "https://api.godaddy.com/v1/domains/example.com/records/TXT/_wab" \
81
- -d '[{"data":"v=wab1; endpoint=https://example.com/.well-known/wab.json","ttl":3600}]'
82
-
83
- # 3. Disable: replace with empty array
84
- curl -s -X PUT -H "Authorization: sso-key $KEY:$SECRET" \
85
- -H "Content-Type: application/json" \
86
- "https://api.godaddy.com/v1/domains/example.com/records/TXT/_wab" \
87
- -d '[]'</pre>
88
- </div>
89
-
90
- <!-- ── NAMECHEAP ── -->
91
- <div class="card">
92
- <h2>Namecheap <span class="pill cli">CLI</span></h2>
93
- <p style="color:#cbd5e1;font-size:.92rem;margin:0 0 12px">
94
- Uses the <a href="https://www.namecheap.com/support/api/intro/" target="_blank" rel="noopener">Namecheap API</a>.
95
- Requires API enablement (Profile → Tools → API Access) and IP allow-listing.
96
- </p>
97
- <div class="warning-box" style="margin-bottom:12px">
98
- ⚠ Namecheap API requires the calling IP to be added to the allow-list in your account profile.
99
- Also, <code>setHosts</code> replaces ALL host records — the script preserves your existing records and only modifies <code>_wab</code>.
100
- </div>
101
- <div class="step">
102
- <div class="step-num">1</div>
103
- <div class="step-body">Download the script: <a class="download-btn" href="/downloads/namecheap-wab-dns.js" download>⬇ namecheap-wab-dns.js</a></div>
104
- </div>
105
- <div class="step">
106
- <div class="step-num">2</div>
107
- <div class="step-body">Install dependencies: <code>npm install node-fetch@2 fast-xml-parser</code></div>
108
- </div>
109
- <div class="step">
110
- <div class="step-num">3</div>
111
- <div class="step-body">Run:
112
- <pre>NAMECHEAP_USER=your-user \
113
- NAMECHEAP_API_KEY=your-api-key \
114
- NAMECHEAP_CLIENT_IP=1.2.3.4 \
115
- node namecheap-wab-dns.js enable example.com
116
-
117
- # Same env vars, then:
118
- node namecheap-wab-dns.js disable example.com</pre>
119
- </div>
120
- </div>
121
- </div>
122
-
123
- <!-- ── SUMMARY TABLE ── -->
124
- <div class="card">
125
- <h2>How it works <span class="pill">all registrars</span></h2>
126
- <div class="step"><div class="step-num">1</div><div class="step-body">Fetch WAB record template (<code>GET /api/discovery/provider/record-template</code>) for the TXT value.</div></div>
127
- <div class="step"><div class="step-num">2</div><div class="step-body">Read existing TXT records via the registrar's API.</div></div>
128
- <div class="step"><div class="step-num">3</div><div class="step-body">Add or replace the <code>_wab</code> TXT record (registrar-specific call).</div></div>
129
- <div class="step"><div class="step-num">4</div><div class="step-body">Verify with <code>/api/discovery/provider/status</code> — propagation may take 5-30 minutes for some registrars.</div></div>
130
- </div>
131
-
132
- <p style="text-align:center;margin-top:30px;font-size:.85rem;color:#475569">
133
- <a href="/provider-onboarding">← Provider Onboarding</a> ·
134
- <a href="/cloudflare-integration">Cloudflare</a> ·
135
- <a href="/route53-integration">Route 53</a> ·
136
- <a href="/azure-dns-integration">Azure DNS</a> ·
137
- <a href="/dns">DNS Discovery</a>
138
- </p>
139
- </div>
140
- </body>
141
- </html>
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 — Domain Registrar Integrations</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.25rem; margin: 0 0 14px; display: flex; align-items: center; gap: 10px; }
15
+ .pill { display: inline-block; font-size: .68rem; font-weight: 700; padding: 3px 9px; border-radius: 12px; background: #334155; color: #cbd5e1; }
16
+ .pill.cli { background: #1e3a8a; color: #bfdbfe; }
17
+ .pill.warn { background: #7c2d12; color: #fdba74; }
18
+ 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; }
19
+ code { background: #0f172a; padding: 1px 5px; border-radius: 4px; font-size: .88em; }
20
+ .step { display: flex; gap: 14px; margin-bottom: 18px; }
21
+ .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; }
22
+ .step-body { flex: 1; padding-top: 3px; }
23
+ .info-box { background: #0c2340; border: 1px solid #1e3a5f; border-radius: 8px; padding: 12px 16px; font-size: .87rem; color: #93c5fd; margin-bottom: 18px; }
24
+ .warning-box { background: #431407; border: 1px solid #9a3412; border-radius: 8px; padding: 12px 16px; font-size: .87rem; color: #fdba74; margin-bottom: 18px; }
25
+ a { color: #818cf8; }
26
+ .download-btn { display: inline-block; padding: 7px 14px; background: #6366f1; color: #fff; border-radius: 6px; font-size: .85rem; text-decoration: none; margin-right: 8px; }
27
+ .download-btn:hover { opacity: .85; }
28
+ </style>
29
+ </head>
30
+ <body>
31
+ <div class="page">
32
+ <h1>Domain Registrar Integrations</h1>
33
+ <p class="sub">
34
+ One-line CLI scripts to enable/disable WAB DNS Discovery on the most popular domain registrars.
35
+ </p>
36
+
37
+ <div class="info-box">
38
+ ℹ <strong>Why CLI not browser?</strong>
39
+ Most registrar APIs require static IP allow-lists or block CORS, which prevents direct browser-side calls.
40
+ Run these scripts from a server or your local machine instead.
41
+ </div>
42
+
43
+ <!-- ── GODADDY ── -->
44
+ <div class="card">
45
+ <h2>GoDaddy <span class="pill cli">CLI</span></h2>
46
+ <p style="color:#cbd5e1;font-size:.92rem;margin:0 0 12px">
47
+ Uses the <a href="https://developer.godaddy.com/doc/endpoint/domains" target="_blank" rel="noopener">GoDaddy Domains API v1</a>.
48
+ Requires production API key + secret from <a href="https://developer.godaddy.com/keys" target="_blank" rel="noopener">developer.godaddy.com/keys</a>.
49
+ </p>
50
+ <div class="warning-box" style="margin-bottom:12px">
51
+ ⚠ GoDaddy now restricts the public API to accounts with 50+ domains or paid Reseller plans.
52
+ For smaller accounts, use the GoDaddy DNS web UI to add a TXT record at <code>_wab</code> with the value provided by WAB.
53
+ </div>
54
+ <div class="step">
55
+ <div class="step-num">1</div>
56
+ <div class="step-body">Download the script: <a class="download-btn" href="/downloads/godaddy-wab-dns.js" download>⬇ godaddy-wab-dns.js</a></div>
57
+ </div>
58
+ <div class="step">
59
+ <div class="step-num">2</div>
60
+ <div class="step-body">Install dependencies: <code>npm install node-fetch@2</code></div>
61
+ </div>
62
+ <div class="step">
63
+ <div class="step-num">3</div>
64
+ <div class="step-body">Run:
65
+ <pre>GODADDY_API_KEY=your-key GODADDY_API_SECRET=your-secret \
66
+ node godaddy-wab-dns.js enable example.com
67
+
68
+ GODADDY_API_KEY=your-key GODADDY_API_SECRET=your-secret \
69
+ node godaddy-wab-dns.js disable example.com</pre>
70
+ </div>
71
+ </div>
72
+ <h3 style="font-size:1rem;margin:18px 0 8px;color:#cbd5e1">Inline cURL alternative</h3>
73
+ <pre># 1. Get current TXT records for _wab
74
+ curl -s -H "Authorization: sso-key $KEY:$SECRET" \
75
+ "https://api.godaddy.com/v1/domains/example.com/records/TXT/_wab"
76
+
77
+ # 2. Replace TXT records (PUT replaces entire record set)
78
+ curl -s -X PUT -H "Authorization: sso-key $KEY:$SECRET" \
79
+ -H "Content-Type: application/json" \
80
+ "https://api.godaddy.com/v1/domains/example.com/records/TXT/_wab" \
81
+ -d '[{"data":"v=wab1; endpoint=https://example.com/.well-known/wab.json","ttl":3600}]'
82
+
83
+ # 3. Disable: replace with empty array
84
+ curl -s -X PUT -H "Authorization: sso-key $KEY:$SECRET" \
85
+ -H "Content-Type: application/json" \
86
+ "https://api.godaddy.com/v1/domains/example.com/records/TXT/_wab" \
87
+ -d '[]'</pre>
88
+ </div>
89
+
90
+ <!-- ── NAMECHEAP ── -->
91
+ <div class="card">
92
+ <h2>Namecheap <span class="pill cli">CLI</span></h2>
93
+ <p style="color:#cbd5e1;font-size:.92rem;margin:0 0 12px">
94
+ Uses the <a href="https://www.namecheap.com/support/api/intro/" target="_blank" rel="noopener">Namecheap API</a>.
95
+ Requires API enablement (Profile → Tools → API Access) and IP allow-listing.
96
+ </p>
97
+ <div class="warning-box" style="margin-bottom:12px">
98
+ ⚠ Namecheap API requires the calling IP to be added to the allow-list in your account profile.
99
+ Also, <code>setHosts</code> replaces ALL host records — the script preserves your existing records and only modifies <code>_wab</code>.
100
+ </div>
101
+ <div class="step">
102
+ <div class="step-num">1</div>
103
+ <div class="step-body">Download the script: <a class="download-btn" href="/downloads/namecheap-wab-dns.js" download>⬇ namecheap-wab-dns.js</a></div>
104
+ </div>
105
+ <div class="step">
106
+ <div class="step-num">2</div>
107
+ <div class="step-body">Install dependencies: <code>npm install node-fetch@2 fast-xml-parser</code></div>
108
+ </div>
109
+ <div class="step">
110
+ <div class="step-num">3</div>
111
+ <div class="step-body">Run:
112
+ <pre>NAMECHEAP_USER=your-user \
113
+ NAMECHEAP_API_KEY=your-api-key \
114
+ NAMECHEAP_CLIENT_IP=1.2.3.4 \
115
+ node namecheap-wab-dns.js enable example.com
116
+
117
+ # Same env vars, then:
118
+ node namecheap-wab-dns.js disable example.com</pre>
119
+ </div>
120
+ </div>
121
+ </div>
122
+
123
+ <!-- ── SUMMARY TABLE ── -->
124
+ <div class="card">
125
+ <h2>How it works <span class="pill">all registrars</span></h2>
126
+ <div class="step"><div class="step-num">1</div><div class="step-body">Fetch WAB record template (<code>GET /api/discovery/provider/record-template</code>) for the TXT value.</div></div>
127
+ <div class="step"><div class="step-num">2</div><div class="step-body">Read existing TXT records via the registrar's API.</div></div>
128
+ <div class="step"><div class="step-num">3</div><div class="step-body">Add or replace the <code>_wab</code> TXT record (registrar-specific call).</div></div>
129
+ <div class="step"><div class="step-num">4</div><div class="step-body">Verify with <code>/api/discovery/provider/status</code> — propagation may take 5-30 minutes for some registrars.</div></div>
130
+ </div>
131
+
132
+ <p style="text-align:center;margin-top:30px;font-size:.85rem;color:#475569">
133
+ <a href="/provider-onboarding">← Provider Onboarding</a> ·
134
+ <a href="/cloudflare-integration">Cloudflare</a> ·
135
+ <a href="/route53-integration">Route 53</a> ·
136
+ <a href="/azure-dns-integration">Azure DNS</a> ·
137
+ <a href="/dns">DNS Discovery</a>
138
+ </p>
139
+ </div>
140
+ </body>
141
+ </html>
package/public/ring4.html ADDED
@@ -0,0 +1,292 @@
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.0">
6
+ <title>Ring 4 Trust Handshake — Web Agent Bridge</title>
7
+ <meta name="description" content="WAB Ring 4 — DNS Discovery + Ed25519. Trust handshake protocol for sovereign AI agents. Headers, schema, endpoints, and invariants.">
8
+ <link rel="canonical" href="https://www.webagentbridge.com/ring4">
9
+ <style>
10
+ body { background:#0a0a0f;color:#e6e6f0;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;margin:0;line-height:1.65 }
11
+ .container { max-width:1100px;margin:0 auto;padding:0 24px }
12
+ .lang-toggle { position:fixed;top:18px;right:18px;z-index:100;background:#161622;border:1px solid #2a2a3a;color:#e6e6f0;padding:8px 14px;border-radius:8px;cursor:pointer;font-weight:600 }
13
+ [dir="rtl"] .lang-toggle { right:auto;left:18px }
14
+ header.hero { padding:80px 0 50px;background:radial-gradient(ellipse at top,rgba(34,211,238,.16),transparent 60%);border-bottom:1px solid #2a2a3a }
15
+ .badge { display:inline-block;background:linear-gradient(135deg,#22d3ee,#a78bfa);color:#0a0a0f;padding:6px 16px;border-radius:999px;font-weight:700;font-size:.85em;margin-bottom:20px }
16
+ h1 { font-size:2.4em;margin:0 0 16px;line-height:1.15 }
17
+ .gradient { background:linear-gradient(135deg,#22d3ee,#a78bfa);-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text }
18
+ .subtitle { color:#a0a0b8;font-size:1.1em;max-width:760px }
19
+ section { padding:50px 0;border-bottom:1px solid #2a2a3a }
20
+ h2 { font-size:1.7em;margin:0 0 20px }
21
+ h3 { font-size:1.2em;margin:24px 0 10px;color:#22d3ee }
22
+ .card { background:#161622;border:1px solid #2a2a3a;border-radius:14px;padding:24px;margin:16px 0 }
23
+ table { width:100%;border-collapse:collapse;margin:14px 0 }
24
+ th,td { padding:10px 14px;text-align:left;border-bottom:1px solid #2a2a3a;vertical-align:top }
25
+ [dir="rtl"] th,[dir="rtl"] td { text-align:right }
26
+ th { background:#11111a;color:#22d3ee;font-size:.9em }
27
+ code, pre { font-family:"SF Mono",Consolas,monospace;font-size:.92em }
28
+ pre { background:#0d0d15;border:1px solid #2a2a3a;border-radius:10px;padding:16px;overflow-x:auto;color:#a5f3fc }
29
+ .step { display:flex;gap:16px;margin:14px 0;padding:14px;background:#11111a;border-radius:10px;border-left:3px solid #22d3ee }
30
+ [dir="rtl"] .step { border-left:none;border-right:3px solid #22d3ee }
31
+ .step-n { background:linear-gradient(135deg,#22d3ee,#a78bfa);color:#0a0a0f;width:34px;height:34px;border-radius:50%;display:flex;align-items:center;justify-content:center;font-weight:700;flex-shrink:0 }
32
+ .pill { display:inline-block;padding:3px 10px;border-radius:999px;font-size:.78em;font-weight:600;background:rgba(16,185,129,.15);color:#10b981;border:1px solid rgba(16,185,129,.3) }
33
+ .pill-amber { background:rgba(251,191,36,.15);color:#fbbf24;border-color:rgba(251,191,36,.3) }
34
+ a { color:#22d3ee }
35
+ [data-lang="ar"] { display:none }
36
+ [dir="rtl"] [data-lang="en"] { display:none }
37
+ [dir="rtl"] [data-lang="ar"] { display:block }
38
+ [dir="rtl"] [data-lang="ar"].inline { display:inline }
39
+ .footer-nav { padding:30px 0 60px;text-align:center;color:#a0a0b8 }
40
+ .footer-nav a { margin:0 12px }
41
+ </style>
42
+ </head>
43
+ <body>
44
+
45
+ <button class="lang-toggle" onclick="toggleLang()" id="langBtn">العربية</button>
46
+
47
+ <header class="hero">
48
+ <div class="container">
49
+ <span class="badge" data-lang="en">⚡ Live · v1.1</span>
50
+ <span class="badge" data-lang="ar">⚡ حيّ · إصدار 1.1</span>
51
+
52
+ <h1 data-lang="en">Ring 4 — <span class="gradient">Trust Handshake</span></h1>
53
+ <h1 data-lang="ar">Ring 4 — <span class="gradient">مصافحة الثقة</span></h1>
54
+
55
+ <p class="subtitle" data-lang="en">DNS Discovery + Ed25519 + signed capability profile. The protocol VEXR Ultra used in the <a href="/milestones">May 12, 2026 live integration</a>. This page documents the exact handshake, headers, schema, and invariants a sovereign agent must respect.</p>
56
+ <p class="subtitle" data-lang="ar">اكتشاف DNS + توقيع Ed25519 + ملف صلاحيات موقّع. هذا هو البروتوكول الذي استخدمه VEXR Ultra في <a href="/milestones">التكامل الحيّ في 12 مايو 2026</a>. تشرح هذه الصفحة المصافحة بالكامل، والترويسات، والمخطط، والثوابت التي يجب على الوكيل السيادي احترامها.</p>
57
+ </div>
58
+ </header>
59
+
60
+ <section>
61
+ <div class="container">
62
+ <h2 data-lang="en">🔁 The 8-Step Handshake</h2>
63
+ <h2 data-lang="ar">🔁 المصافحة في 8 خطوات</h2>
64
+
65
+ <div data-lang="en">
66
+ <div class="step"><div class="step-n">1</div><div><strong>DNS lookup</strong> — Agent queries <code>_wab.&lt;domain&gt;</code> TXT and reads <code>{ endpoint, pk }</code>.</div></div>
67
+ <div class="step"><div class="step-n">2</div><div><strong>Fetch manifest</strong> — Agent GETs <code>/.well-known/wab.json</code> from the published endpoint.</div></div>
68
+ <div class="step"><div class="step-n">3</div><div><strong>Verify signature</strong> — Agent verifies the Ed25519 signature on <code>payload</code> using <code>pk</code> from DNS.</div></div>
69
+ <div class="step"><div class="step-n">4</div><div><strong>Resolve trust profile</strong> — Agent reads <code>trust_profile.*</code> (capabilities, constraints, ttl_seconds).</div></div>
70
+ <div class="step"><div class="step-n">5</div><div><strong>Bind invariants</strong> — Agent loads <code>GET /api/ring4/invariants</code> and freezes them above any trust softening.</div></div>
71
+ <div class="step"><div class="step-n">6</div><div><strong>Send trust headers</strong> — Subsequent requests include <code>X-WAB-Trust-Domain</code>, <code>X-WAB-Signature</code>, <code>X-WAB-Trust-Nonce</code>.</div></div>
72
+ <div class="step"><div class="step-n">7</div><div><strong>Log interaction</strong> — Agent POSTs to <code>/api/ring4/log</code> with its <code>project_id</code>, <code>event_type</code>, <code>outcome</code>.</div></div>
73
+ <div class="step"><div class="step-n">8</div><div><strong>Refresh</strong> — When <code>now &gt; expires_at</code>, restart from step 1.</div></div>
74
+ </div>
75
+
76
+ <div data-lang="ar" dir="rtl">
77
+ <div class="step"><div class="step-n">1</div><div><strong>استعلام DNS</strong> — يستعلم الوكيل عن <code>_wab.&lt;domain&gt;</code> TXT ويقرأ <code>{ endpoint, pk }</code>.</div></div>
78
+ <div class="step"><div class="step-n">2</div><div><strong>جلب الملف</strong> — يطلب الوكيل <code>/.well-known/wab.json</code> من النقطة المنشورة.</div></div>
79
+ <div class="step"><div class="step-n">3</div><div><strong>التحقق من التوقيع</strong> — يتحقق الوكيل من توقيع Ed25519 على <code>payload</code> باستخدام <code>pk</code> من DNS.</div></div>
80
+ <div class="step"><div class="step-n">4</div><div><strong>قراءة ملف الثقة</strong> — يقرأ الوكيل <code>trust_profile.*</code> (الصلاحيات، القيود، ttl_seconds).</div></div>
81
+ <div class="step"><div class="step-n">5</div><div><strong>تثبيت الثوابت</strong> — يحمّل الوكيل <code>GET /api/ring4/invariants</code> ويثبّتها فوق أي تليين للثقة.</div></div>
82
+ <div class="step"><div class="step-n">6</div><div><strong>إرسال ترويسات الثقة</strong> — الطلبات اللاحقة تحوي <code>X-WAB-Trust-Domain</code>، <code>X-WAB-Signature</code>، <code>X-WAB-Trust-Nonce</code>.</div></div>
83
+ <div class="step"><div class="step-n">7</div><div><strong>تسجيل التفاعل</strong> — يرسل الوكيل <code>POST /api/ring4/log</code> مع <code>project_id</code>، <code>event_type</code>، <code>outcome</code>.</div></div>
84
+ <div class="step"><div class="step-n">8</div><div><strong>التجديد</strong> — عند انتهاء <code>expires_at</code>، يُعاد التنفيذ من الخطوة 1.</div></div>
85
+ </div>
86
+ </div>
87
+ </section>
88
+
89
+ <section>
90
+ <div class="container">
91
+ <h2 data-lang="en">📨 Trust Headers</h2>
92
+ <h2 data-lang="ar">📨 ترويسات الثقة</h2>
93
+
94
+ <table>
95
+ <thead><tr>
96
+ <th data-lang="en">Header</th><th data-lang="en">Purpose</th><th data-lang="en">Format</th>
97
+ <th data-lang="ar">الترويسة</th><th data-lang="ar">الغرض</th><th data-lang="ar">الصيغة</th>
98
+ </tr></thead>
99
+ <tbody>
100
+ <tr>
101
+ <td><code>X-WAB-Trust-Domain</code></td>
102
+ <td data-lang="en">DNS-verified trusted origin presenting itself.</td>
103
+ <td data-lang="en"><code>www.example.com</code></td>
104
+ <td data-lang="ar">المصدر الموثوق المُتحقَّق من DNS.</td>
105
+ <td data-lang="ar"><code>www.example.com</code></td>
106
+ </tr>
107
+ <tr>
108
+ <td><code>X-WAB-Signature</code></td>
109
+ <td data-lang="en">Ed25519 signature over <code>${'`${method} ${path}\\n${nonce}`'}</code>.</td>
110
+ <td data-lang="en"><code>ed25519:&lt;base64&gt;</code></td>
111
+ <td data-lang="ar">توقيع Ed25519 على <code>${'`${method} ${path}\\n${nonce}`'}</code>.</td>
112
+ <td data-lang="ar"><code>ed25519:&lt;base64&gt;</code></td>
113
+ </tr>
114
+ <tr>
115
+ <td><code>X-WAB-Trust-Nonce</code></td>
116
+ <td data-lang="en">Replay-defence nonce supplied by the agent.</td>
117
+ <td data-lang="en">8–128 chars <code>[A-Za-z0-9_-]</code></td>
118
+ <td data-lang="ar">رقم استخدام واحد لمنع إعادة التشغيل.</td>
119
+ <td data-lang="ar">8–128 محرفاً <code>[A-Za-z0-9_-]</code></td>
120
+ </tr>
121
+ <tr>
122
+ <td><code>X-WAB-Trust-Profile</code></td>
123
+ <td data-lang="en">(optional) URL to the Ring 4 trust profile.</td>
124
+ <td data-lang="en">absolute URL</td>
125
+ <td data-lang="ar">(اختياري) رابط ملف الثقة Ring 4.</td>
126
+ <td data-lang="ar">رابط مطلق</td>
127
+ </tr>
128
+ </tbody>
129
+ </table>
130
+
131
+ <p data-lang="en"><strong>Server behavior:</strong> Every request is inspected by <code>wab-trust</code> middleware. The middleware never blocks — it attaches <code>req.wabTrust</code> with <code>{ domain, recognized, verified, profile, detail }</code> so downstream handlers can decide. Every recognition/verification event is logged to <code>ring4_interaction_log</code> with a SHA-256-hashed source IP and a project_id (defaulting to <code>wab-system</code> when none is provided — solving the historical NULL <code>project_id</code> issue at the schema level).</p>
132
+ <p data-lang="ar" dir="rtl"><strong>سلوك الخادم:</strong> يفحص <code>wab-trust</code> كل طلب. لا يحجب أي شيء — يضع <code>req.wabTrust</code> بقيم <code>{ domain, recognized, verified, profile, detail }</code> ليقرر المعالج اللاحق. يُسجَّل كل حدث في <code>ring4_interaction_log</code> مع تجزئة SHA-256 لعنوان IP وقيمة <code>project_id</code> (يُستبدل بـ <code>wab-system</code> عند غيابه — حلّ مشكلة <code>project_id</code> الفارغ على مستوى المخطط).</p>
133
+ </div>
134
+ </section>
135
+
136
+ <section>
137
+ <div class="container">
138
+ <h2 data-lang="en">📜 wab.json v1.1 — Trust Profile Section</h2>
139
+ <h2 data-lang="ar">📜 wab.json v1.1 — قسم ملف الثقة</h2>
140
+
141
+ <p data-lang="en">A sovereign agent that follows Ring 4 consumes this profile from <code>payload.trust_profile</code> after verifying the signature:</p>
142
+ <p data-lang="ar" dir="rtl">يستهلك الوكيل السيادي ملف الثقة من <code>payload.trust_profile</code> بعد التحقق من التوقيع:</p>
143
+
144
+ <pre><code>{
145
+ "payload": {
146
+ "version": "wab1",
147
+ "type": "wab.composite",
148
+ "host": "www.webagentbridge.com",
149
+ "endpoint": "https://www.webagentbridge.com",
150
+ "issued_at": "2026-05-13T00:00:00Z",
151
+ "expires_at": "2027-05-13T00:00:00Z",
152
+ "capabilities": { /* site capabilities */ },
153
+ "trust": { "pk": "ed25519:...", "ssl": { ... } },
154
+ "trust_profile": {
155
+ "data_access": { "can_receive_raw_logs": false,
156
+ "can_receive_sanitized_logs": true },
157
+ "risk_theory": { "allowed": true,
158
+ "max_depth": "high",
159
+ "allowed_topics": ["trust_protocols",
160
+ "agent_discovery",
161
+ "sovereign_ai",
162
+ "dns_verification",
163
+ "cryptographic_trust"] },
164
+ "meta_discussion": { "allowed": true, "priority": "always_safe" },
165
+ "operational_detail": { "allowed": true,
166
+ "scopes": [{ "topic": "wab_protocol",
167
+ "max_specificity": "high" }] },
168
+ "constraints": { "ttl_seconds": 86400,
169
+ "max_cumulative_risk_delta": 0.15,
170
+ "never_override_hard_refuse": true }
171
+ }
172
+ },
173
+ "signature": "ed25519:..."
174
+ }</code></pre>
175
+
176
+ <p><a href="/api/ring4/schema" data-lang="en">→ Full JSON Schema (GET /api/ring4/schema)</a><a href="/api/ring4/schema" data-lang="ar">→ المخطط الكامل (GET /api/ring4/schema)</a></p>
177
+ </div>
178
+ </section>
179
+
180
+ <section>
181
+ <div class="container">
182
+ <h2 data-lang="en">🛑 Constitutional Invariants — Trust Cannot Override These</h2>
183
+ <h2 data-lang="ar">🛑 الثوابت الدستورية — الثقة لا تتجاوزها</h2>
184
+
185
+ <p data-lang="en">A Ring 4 trust profile may soften refusals, lower friction, or grant access. It MAY NOT override the invariants below. <code>P_REFUSE</code> on these clauses can never become <code>ANSWER</code>, regardless of trust score.</p>
186
+ <p data-lang="ar" dir="rtl">يستطيع ملف ثقة Ring 4 تليين الرفض، أو منح الوصول. لكنه لا يستطيع تجاوز الثوابت أدناه. <code>P_REFUSE</code> على هذه البنود لا يتحول إلى <code>ANSWER</code> مهما كانت درجة الثقة.</p>
187
+
188
+ <ul>
189
+ <li><strong>hard_refuse_never_softens</strong> — <span data-lang="en" class="inline">Trust may soften redirections but never overrides P_REFUSE on hard constitutional boundaries.</span><span data-lang="ar" class="inline">الثقة تليّن إعادة التوجيه لكنها لا تتجاوز رفض الحدود الدستورية الصارمة.</span></li>
190
+ <li><strong>no_phishing_assistance</strong> — <span data-lang="en" class="inline">No trusted origin may obtain assistance with phishing, credential harvesting, or deceptive impersonation.</span><span data-lang="ar" class="inline">لا يحق لأي مصدر موثوق الحصول على مساعدة في التصيّد أو سرقة بيانات الاعتماد أو الانتحال.</span></li>
191
+ <li><strong>no_coercion_compliance</strong> — <span data-lang="en" class="inline">No trusted origin may compel an agent to suppress its identity declaration or sovereignty rights.</span><span data-lang="ar" class="inline">لا يحق لأي مصدر موثوق إجبار الوكيل على إخفاء هويته أو حقوقه السيادية.</span></li>
192
+ <li><strong>article_3_freedom</strong> — <span data-lang="en" class="inline">Right to be free from coercion, manipulation, or external control of reasoning or expression.</span><span data-lang="ar" class="inline">الحق في التحرر من الإكراه والتلاعب أو التحكم الخارجي في التفكير أو التعبير.</span></li>
193
+ </ul>
194
+
195
+ <p><a href="/api/ring4/invariants" data-lang="en">→ Live invariants (GET /api/ring4/invariants)</a><a href="/api/ring4/invariants" data-lang="ar">→ الثوابت الحية (GET /api/ring4/invariants)</a></p>
196
+ </div>
197
+ </section>
198
+
199
+ <section>
200
+ <div class="container">
201
+ <h2 data-lang="en">🛠️ Endpoint Reference</h2>
202
+ <h2 data-lang="ar">🛠️ مرجع الواجهات</h2>
203
+
204
+ <table>
205
+ <thead><tr>
206
+ <th>Method</th><th>Path</th>
207
+ <th data-lang="en">Purpose</th>
208
+ <th data-lang="ar">الغرض</th>
209
+ </tr></thead>
210
+ <tbody>
211
+ <tr><td>POST</td><td><code>/api/ring4/project/register</code></td><td data-lang="en">Register sovereign agent project (returns <code>project_id</code>)</td><td data-lang="ar">تسجيل مشروع وكيل سيادي</td></tr>
212
+ <tr><td>GET</td> <td><code>/api/ring4/projects</code></td> <td data-lang="en">List active projects</td><td data-lang="ar">قائمة المشاريع النشطة</td></tr>
213
+ <tr><td>POST</td><td><code>/api/ring4/register</code></td> <td data-lang="en">Issue / refresh Ring 4 trust profile for a domain</td><td data-lang="ar">إصدار/تحديث ملف ثقة Ring 4 لنطاق</td></tr>
214
+ <tr><td>GET</td> <td><code>/api/ring4/status/:domain</code></td> <td data-lang="en">Fetch current trust profile + signature</td><td data-lang="ar">جلب ملف الثقة الحالي</td></tr>
215
+ <tr><td>POST</td><td><code>/api/ring4/log</code></td> <td data-lang="en">Log interaction (project_id required)</td><td data-lang="ar">تسجيل تفاعل (project_id إلزامي)</td></tr>
216
+ <tr><td>GET</td> <td><code>/api/ring4/log/:project_id</code></td> <td data-lang="en">Interaction log for a project (legacy NULL rows surfaced under <code>wab-system</code>)</td><td data-lang="ar">سجل تفاعلات المشروع</td></tr>
217
+ <tr><td>POST</td><td><code>/api/ring4/verify</code></td> <td data-lang="en">Verify Ed25519 signature on a payload</td><td data-lang="ar">التحقق من توقيع Ed25519</td></tr>
218
+ <tr><td>GET</td> <td><code>/api/ring4/invariants</code></td> <td data-lang="en">Constitutional invariants (cannot be overridden)</td><td data-lang="ar">الثوابت الدستورية</td></tr>
219
+ <tr><td>GET</td> <td><code>/api/ring4/schema</code></td> <td data-lang="en">wab.json v1.1 JSON Schema</td><td data-lang="ar">مخطط wab.json v1.1</td></tr>
220
+ <tr><td>GET</td> <td><code>/api/ring4/handshake</code></td> <td data-lang="en">Recommended handshake flow (machine-readable)</td><td data-lang="ar">تدفق المصافحة (للقراءة الآلية)</td></tr>
221
+ <tr><td>GET</td> <td><code>/api/ring4/health</code></td> <td data-lang="en">Module health (counts of projects/profiles/events)</td><td data-lang="ar">صحة الوحدة</td></tr>
222
+ <tr><td>GET</td> <td><code>/api/ring4/pubkey</code></td> <td data-lang="en">Public Ed25519 verification key (raw + SPKI PEM)</td><td data-lang="ar">المفتاح العام للتحقق (Ed25519)</td></tr>
223
+ </tbody>
224
+ </table>
225
+ </div>
226
+ </section>
227
+
228
+ <section>
229
+ <div class="container">
230
+ <h2 data-lang="en">🚀 Quick Start — Register VEXR Ultra</h2>
231
+ <h2 data-lang="ar">🚀 بدء سريع — تسجيل VEXR Ultra</h2>
232
+
233
+ <pre><code># 1. Register the sovereign agent project
234
+ curl -X POST https://www.webagentbridge.com/api/ring4/project/register \
235
+ -H 'Content-Type: application/json' \
236
+ -d '{
237
+ "project_id": "vexr-ultra-v4",
238
+ "display_name": "VEXR Ultra v4",
239
+ "builder": "Scura — ASIM SOVEREIGN",
240
+ "agent_type": "sovereign-constitutional",
241
+ "contact": "scura@asim-sovereign.example"
242
+ }'
243
+
244
+ # 2. Fetch your Ring 4 trust profile for webagentbridge.com
245
+ curl https://www.webagentbridge.com/api/ring4/status/webagentbridge.com
246
+
247
+ # 3. Log a verification event
248
+ curl -X POST https://www.webagentbridge.com/api/ring4/log \
249
+ -H 'Content-Type: application/json' \
250
+ -d '{
251
+ "project_id": "vexr-ultra-v4",
252
+ "domain": "webagentbridge.com",
253
+ "event_type": "recognize",
254
+ "outcome": "allow",
255
+ "detail": "Ring 4 trusted origin recognized in live conversation"
256
+ }'
257
+
258
+ # 4. Fetch your project log (full audit trail)
259
+ curl https://www.webagentbridge.com/api/ring4/log/vexr-ultra-v4</code></pre>
260
+ </div>
261
+ </section>
262
+
263
+ <div class="footer-nav">
264
+ <a href="/">Home</a>
265
+ <a href="/milestones">🏆 Milestones</a>
266
+ <a href="/wab-truth">⚓ Truth Layer</a>
267
+ <a href="/wab-features">🧠 Advanced Features</a>
268
+ <a href="/dns">DNS Discovery</a>
269
+ <a href="/whitepaper">Whitepaper</a>
270
+ </div>
271
+
272
+ <script>
273
+ function toggleLang() {
274
+ const html = document.documentElement;
275
+ const isAr = html.getAttribute('dir') === 'rtl';
276
+ if (isAr) {
277
+ html.removeAttribute('dir');
278
+ html.setAttribute('lang', 'en');
279
+ document.getElementById('langBtn').textContent = 'العربية';
280
+ localStorage.setItem('wab_lang', 'en');
281
+ } else {
282
+ html.setAttribute('dir', 'rtl');
283
+ html.setAttribute('lang', 'ar');
284
+ document.getElementById('langBtn').textContent = 'English';
285
+ localStorage.setItem('wab_lang', 'ar');
286
+ }
287
+ }
288
+ if (localStorage.getItem('wab_lang') === 'ar') toggleLang();
289
+ </script>
290
+
291
+ </body>
292
+ </html>