web-agent-bridge 3.4.0 → 3.9.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 (315) hide show
  1. package/LICENSE +84 -84
  2. package/README.ar.md +1565 -1304
  3. package/README.md +171 -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/atp.html +171 -0
  41. package/public/azure-dns-integration.html +289 -289
  42. package/public/browser.html +486 -486
  43. package/public/cloudflare-integration.html +380 -380
  44. package/public/commander-dashboard.html +243 -243
  45. package/public/cookies.html +210 -210
  46. package/public/cpanel-integration.html +398 -398
  47. package/public/css/agent-workspace.css +1713 -1713
  48. package/public/css/premium.css +317 -317
  49. package/public/css/styles.css +1401 -1263
  50. package/public/dashboard-shieldlink.html +295 -0
  51. package/public/dashboard.html +711 -707
  52. package/public/dns.html +436 -436
  53. package/public/docs.html +588 -588
  54. package/public/enterprise-mesh.ar.html +80 -0
  55. package/public/enterprise-mesh.html +81 -0
  56. package/public/feed.xml +89 -89
  57. package/public/gcp-dns-integration.html +318 -318
  58. package/public/governance.ar.html +70 -0
  59. package/public/governance.html +69 -0
  60. package/public/growth.html +465 -465
  61. package/public/index.html +1372 -1266
  62. package/public/integrations.html +556 -556
  63. package/public/js/activate.js +449 -145
  64. package/public/js/agent-workspace.js +1740 -1740
  65. package/public/js/auth-nav.js +117 -65
  66. package/public/js/auth-redirect.js +12 -12
  67. package/public/js/cookie-consent.js +56 -56
  68. package/public/js/dns.js +438 -438
  69. package/public/js/wab-demo-page.js +721 -721
  70. package/public/js/ws-client.js +74 -74
  71. package/public/l-preview.html +242 -0
  72. package/public/llms-full.txt +360 -360
  73. package/public/llms.txt +125 -125
  74. package/public/login.html +85 -85
  75. package/public/mesh-dashboard.html +328 -328
  76. package/public/milestones.html +346 -0
  77. package/public/one-click.html +779 -0
  78. package/public/openapi.json +669 -669
  79. package/public/partners.ar.html +145 -0
  80. package/public/partners.html +143 -0
  81. package/public/phone-shield.html +281 -281
  82. package/public/plesk-integration.html +375 -375
  83. package/public/premium-dashboard.html +2489 -2489
  84. package/public/premium.html +793 -793
  85. package/public/privacy.html +297 -297
  86. package/public/provider-onboarding.html +172 -172
  87. package/public/provider-sandbox.html +134 -134
  88. package/public/providers.html +359 -359
  89. package/public/refusals.html +172 -0
  90. package/public/register.html +105 -105
  91. package/public/registrar-integrations.html +141 -141
  92. package/public/ring4.html +292 -0
  93. package/public/robots.txt +99 -99
  94. package/public/route53-integration.html +531 -531
  95. package/public/score.html +263 -0
  96. package/public/script/wab-consent.d.ts +36 -36
  97. package/public/script/wab-consent.js +104 -104
  98. package/public/script/wab-schema.js +131 -131
  99. package/public/script/wab.d.ts +108 -108
  100. package/public/script/wab.min.js +580 -580
  101. package/public/security.txt +8 -8
  102. package/public/shieldlink.html +244 -0
  103. package/public/shieldqr.html +231 -231
  104. package/public/sitemap.xml +13 -1
  105. package/public/terms.html +256 -256
  106. package/public/trust-graph-api.ar.html +92 -0
  107. package/public/trust-graph-api.html +91 -0
  108. package/public/wab-features.html +560 -0
  109. package/public/wab-trust.html +200 -200
  110. package/public/wab-truth.html +375 -0
  111. package/public/wab-vs-protocols.html +210 -210
  112. package/public/whitepaper.html +449 -449
  113. package/script/ai-agent-bridge.js +1754 -1754
  114. package/sdk/README.md +99 -99
  115. package/sdk/agent-mesh.js +449 -449
  116. package/sdk/atp.js +103 -0
  117. package/sdk/auto-discovery.js +301 -288
  118. package/sdk/commander.js +262 -262
  119. package/sdk/governance.js +262 -262
  120. package/sdk/index.d.ts +464 -464
  121. package/sdk/index.js +653 -649
  122. package/sdk/multi-agent.js +318 -318
  123. package/sdk/safe-mode.js +221 -221
  124. package/sdk/safety-shield.js +219 -219
  125. package/sdk/schema-discovery.js +83 -83
  126. package/server/adapters/index.js +520 -520
  127. package/server/config/plans.js +412 -367
  128. package/server/config/secrets.js +102 -102
  129. package/server/control-plane/index.js +301 -301
  130. package/server/data-plane/index.js +354 -354
  131. package/server/index.js +793 -670
  132. package/server/llm/index.js +404 -404
  133. package/server/middleware/adminAuth.js +35 -35
  134. package/server/middleware/api-tier.js +170 -0
  135. package/server/middleware/auth.js +50 -50
  136. package/server/middleware/featureGate.js +88 -88
  137. package/server/middleware/rateLimits.js +100 -100
  138. package/server/middleware/sensitiveAction.js +157 -157
  139. package/server/middleware/wab-trust.js +141 -0
  140. package/server/migrations/001_add_analytics_indexes.sql +7 -7
  141. package/server/migrations/002_premium_features.sql +418 -418
  142. package/server/migrations/003_ads_integer_cents.sql +33 -33
  143. package/server/migrations/004_agent_os.sql +158 -158
  144. package/server/migrations/005_marketplace_metering.sql +126 -126
  145. package/server/migrations/006_growth_suite.sql +138 -0
  146. package/server/migrations/007_governance.sql +106 -106
  147. package/server/migrations/008_plans.sql +144 -144
  148. package/server/migrations/009_shieldqr.sql +30 -30
  149. package/server/migrations/010_extended_trust.sql +33 -33
  150. package/server/migrations/011_outreach.sql +47 -0
  151. package/server/migrations/012_shieldlink.sql +116 -0
  152. package/server/migrations/013_ct_monitor.sql +13 -0
  153. package/server/migrations/014_wab_advanced_features.sql +128 -0
  154. package/server/migrations/015_wab_truth_layer.sql +101 -0
  155. package/server/migrations/016_ring4_external_trust.sql +84 -0
  156. package/server/migrations/017_ring4_extensions.sql +69 -0
  157. package/server/migrations/018_commercial_foundations.sql +167 -0
  158. package/server/migrations/019_unify_tier_constraints.sql +133 -0
  159. package/server/migrations/020_agent_transaction_primitive.sql +119 -0
  160. package/server/models/adapters/index.js +33 -33
  161. package/server/models/adapters/mysql.js +183 -183
  162. package/server/models/adapters/postgresql.js +172 -172
  163. package/server/models/adapters/sqlite.js +7 -7
  164. package/server/models/db.js +740 -740
  165. package/server/observability/failure-analysis.js +337 -337
  166. package/server/observability/index.js +394 -394
  167. package/server/protocol/capabilities.js +223 -223
  168. package/server/protocol/index.js +243 -243
  169. package/server/protocol/schema.js +584 -584
  170. package/server/registry/certification.js +271 -271
  171. package/server/registry/index.js +326 -326
  172. package/server/routes/activate.js +478 -0
  173. package/server/routes/admin-outreach.js +239 -0
  174. package/server/routes/admin-plans.js +76 -76
  175. package/server/routes/admin-premium.js +674 -673
  176. package/server/routes/admin-shieldlink.js +137 -0
  177. package/server/routes/admin-shieldqr.js +90 -90
  178. package/server/routes/admin-trust-monitor.js +139 -83
  179. package/server/routes/admin.js +550 -549
  180. package/server/routes/adopt.js +61 -0
  181. package/server/routes/ads.js +130 -130
  182. package/server/routes/agent-workspace.js +540 -540
  183. package/server/routes/api-keys.js +127 -0
  184. package/server/routes/api.js +150 -150
  185. package/server/routes/auth.js +71 -71
  186. package/server/routes/billing.js +57 -57
  187. package/server/routes/commander.js +316 -316
  188. package/server/routes/customer-shieldlink.js +133 -0
  189. package/server/routes/demo-showcase.js +332 -332
  190. package/server/routes/demo-store.js +154 -154
  191. package/server/routes/diagnose.js +373 -0
  192. package/server/routes/discovery.js +2348 -2348
  193. package/server/routes/enterprise-mesh.js +170 -0
  194. package/server/routes/gateway.js +173 -173
  195. package/server/routes/governance-saas.js +203 -0
  196. package/server/routes/governance.js +208 -208
  197. package/server/routes/growth.js +1048 -0
  198. package/server/routes/intent.js +328 -0
  199. package/server/routes/license.js +251 -251
  200. package/server/routes/mesh.js +469 -469
  201. package/server/routes/noscript.js +543 -543
  202. package/server/routes/partners.js +201 -0
  203. package/server/routes/plans.js +33 -33
  204. package/server/routes/premium-v2.js +686 -686
  205. package/server/routes/premium.js +724 -724
  206. package/server/routes/providers.js +650 -650
  207. package/server/routes/reputation.js +411 -0
  208. package/server/routes/ring4.js +885 -0
  209. package/server/routes/runtime.js +2148 -2148
  210. package/server/routes/shieldlink.js +70 -0
  211. package/server/routes/shieldqr.js +88 -88
  212. package/server/routes/sovereign.js +465 -465
  213. package/server/routes/transactions.js +233 -0
  214. package/server/routes/truth-layer.js +670 -0
  215. package/server/routes/universal.js +200 -200
  216. package/server/routes/unsubscribe.js +51 -0
  217. package/server/routes/wab-api.js +850 -850
  218. package/server/routes/wab-cache.js +282 -0
  219. package/server/runtime/container-worker.js +111 -111
  220. package/server/runtime/container.js +448 -448
  221. package/server/runtime/distributed-worker.js +362 -362
  222. package/server/runtime/event-bus.js +210 -210
  223. package/server/runtime/index.js +253 -253
  224. package/server/runtime/queue.js +599 -599
  225. package/server/runtime/replay.js +666 -666
  226. package/server/runtime/sandbox.js +266 -266
  227. package/server/runtime/scheduler.js +534 -534
  228. package/server/runtime/session-engine.js +293 -293
  229. package/server/runtime/state-manager.js +188 -188
  230. package/server/secrets/wab-signing-key.pem +3 -0
  231. package/server/secrets/wab-signing-pub.pem +3 -0
  232. package/server/security/cross-site-redactor.js +196 -196
  233. package/server/security/dry-run.js +180 -180
  234. package/server/security/human-gate-rate-limit.js +147 -147
  235. package/server/security/human-gate-transports.js +178 -178
  236. package/server/security/human-gate.js +281 -281
  237. package/server/security/index.js +368 -368
  238. package/server/security/intent-engine.js +245 -245
  239. package/server/security/reward-guard.js +171 -171
  240. package/server/security/rollback-store.js +239 -239
  241. package/server/security/token-scope.js +404 -404
  242. package/server/security/url-policy.js +139 -139
  243. package/server/services/adoption-agent.js +182 -0
  244. package/server/services/agent-chat.js +506 -506
  245. package/server/services/agent-learning.js +601 -601
  246. package/server/services/agent-memory.js +625 -625
  247. package/server/services/agent-mesh.js +555 -555
  248. package/server/services/agent-symphony.js +717 -717
  249. package/server/services/agent-tasks.js +1807 -1807
  250. package/server/services/api-key-engine.js +292 -292
  251. package/server/services/cluster.js +894 -894
  252. package/server/services/commander.js +738 -738
  253. package/server/services/edge-compute.js +440 -440
  254. package/server/services/email.js +233 -233
  255. package/server/services/fairness-engine.js +409 -0
  256. package/server/services/fairness.js +420 -0
  257. package/server/services/governance.js +466 -466
  258. package/server/services/hosted-runtime.js +205 -205
  259. package/server/services/lfd.js +635 -635
  260. package/server/services/local-ai.js +389 -389
  261. package/server/services/marketplace.js +270 -270
  262. package/server/services/metering.js +182 -182
  263. package/server/services/modules/affiliate-intelligence.js +93 -93
  264. package/server/services/modules/agent-firewall.js +90 -90
  265. package/server/services/modules/bounty.js +89 -89
  266. package/server/services/modules/collective-bargaining.js +92 -92
  267. package/server/services/modules/dark-pattern.js +66 -66
  268. package/server/services/modules/gov-intelligence.js +45 -45
  269. package/server/services/modules/neural.js +55 -55
  270. package/server/services/modules/notary.js +49 -49
  271. package/server/services/modules/price-time-machine.js +86 -86
  272. package/server/services/modules/protocol.js +104 -104
  273. package/server/services/negotiation.js +439 -439
  274. package/server/services/outreach-agent.js +312 -0
  275. package/server/services/plans.js +214 -214
  276. package/server/services/plugins.js +771 -771
  277. package/server/services/price-intelligence.js +566 -566
  278. package/server/services/price-shield.js +1137 -1137
  279. package/server/services/provider-clients.js +740 -740
  280. package/server/services/reputation.js +465 -465
  281. package/server/services/search-engine.js +357 -357
  282. package/server/services/security.js +513 -513
  283. package/server/services/self-healing.js +843 -843
  284. package/server/services/shieldlink.js +492 -0
  285. package/server/services/shieldqr.js +322 -322
  286. package/server/services/sovereign-shield.js +542 -542
  287. package/server/services/ssl-ct-monitor.js +224 -0
  288. package/server/services/ssl-inspector.js +42 -42
  289. package/server/services/ssl-monitor.js +167 -167
  290. package/server/services/stripe.js +206 -205
  291. package/server/services/swarm.js +788 -788
  292. package/server/services/transactions.js +525 -0
  293. package/server/services/universal-scraper.js +662 -662
  294. package/server/services/verification.js +481 -481
  295. package/server/services/vision.js +1163 -1163
  296. package/server/services/wab-crypto.js +178 -178
  297. package/server/utils/cache.js +125 -125
  298. package/server/utils/migrate.js +81 -81
  299. package/server/utils/safe-fetch.js +228 -228
  300. package/server/utils/secureFields.js +50 -50
  301. package/server/ws.js +161 -161
  302. package/templates/artisan-marketplace.yaml +104 -104
  303. package/templates/book-price-scout.yaml +98 -98
  304. package/templates/electronics-price-tracker.yaml +108 -108
  305. package/templates/flight-deal-hunter.yaml +113 -113
  306. package/templates/freelancer-direct.yaml +116 -116
  307. package/templates/grocery-price-compare.yaml +93 -93
  308. package/templates/hotel-direct-booking.yaml +113 -113
  309. package/templates/local-services.yaml +98 -98
  310. package/templates/olive-oil-tunisia.yaml +88 -88
  311. package/templates/organic-farm-fresh.yaml +101 -101
  312. package/templates/restaurant-direct.yaml +97 -97
  313. package/templates/ring4/banking-sovereign.yaml +55 -0
  314. package/templates/ring4/ecommerce-sovereign.yaml +58 -0
  315. 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>