web-agent-bridge 3.3.0 → 3.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (312) hide show
  1. package/LICENSE +84 -72
  2. package/README.ar.md +1563 -1286
  3. package/README.md +137 -1764
  4. package/bin/agent-runner.js +474 -474
  5. package/bin/cli.js +237 -237
  6. package/bin/wab-init.js +244 -0
  7. package/bin/wab.js +80 -80
  8. package/examples/azure-dns-wab.js +83 -0
  9. package/examples/bidi-agent.js +119 -119
  10. package/examples/cloudflare-wab-dns.js +121 -0
  11. package/examples/cpanel-wab-dns.js +114 -0
  12. package/examples/cross-site-agent.js +91 -91
  13. package/examples/dns-discovery-agent.js +166 -0
  14. package/examples/gcp-dns-wab.js +76 -0
  15. package/examples/governance-agent.js +169 -0
  16. package/examples/mcp-agent.js +94 -94
  17. package/examples/next-app-router/README.md +44 -44
  18. package/examples/plesk-wab-dns.js +103 -0
  19. package/examples/puppeteer-agent.js +108 -108
  20. package/examples/route53-wab-dns.js +144 -0
  21. package/examples/saas-dashboard/README.md +55 -55
  22. package/examples/safe-mode-agent.js +96 -0
  23. package/examples/self-discovery.js +106 -0
  24. package/examples/shopify-hydrogen/README.md +74 -74
  25. package/examples/vision-agent.js +171 -171
  26. package/examples/wab-sign.js +74 -0
  27. package/examples/wab-verify.js +60 -0
  28. package/examples/wordpress-elementor/README.md +77 -77
  29. package/package.json +93 -93
  30. package/public/.well-known/agent-tools.json +180 -180
  31. package/public/.well-known/ai-assets.json +59 -59
  32. package/public/.well-known/security.txt +8 -8
  33. package/public/.well-known/wab.json +28 -0
  34. package/public/activate.html +448 -0
  35. package/public/adopt.html +236 -0
  36. package/public/adoption-metrics.html +188 -0
  37. package/public/agent-workspace.html +359 -349
  38. package/public/ai.html +198 -198
  39. package/public/api.html +397 -413
  40. package/public/azure-dns-integration.html +289 -0
  41. package/public/browser.html +486 -486
  42. package/public/cloudflare-integration.html +380 -0
  43. package/public/commander-dashboard.html +243 -243
  44. package/public/cookies.html +210 -210
  45. package/public/cpanel-integration.html +398 -0
  46. package/public/css/agent-workspace.css +1713 -1713
  47. package/public/css/premium.css +317 -317
  48. package/public/css/styles.css +1401 -1235
  49. package/public/dashboard-shieldlink.html +295 -0
  50. package/public/dashboard.html +711 -706
  51. package/public/dns.html +436 -507
  52. package/public/docs.html +588 -587
  53. package/public/enterprise-mesh.ar.html +80 -0
  54. package/public/enterprise-mesh.html +81 -0
  55. package/public/feed.xml +89 -89
  56. package/public/gcp-dns-integration.html +318 -0
  57. package/public/governance.ar.html +70 -0
  58. package/public/governance.html +69 -0
  59. package/public/growth.html +465 -463
  60. package/public/index.html +1372 -1070
  61. package/public/integrations.html +556 -556
  62. package/public/js/activate.js +449 -0
  63. package/public/js/agent-workspace.js +1740 -1740
  64. package/public/js/auth-nav.js +117 -31
  65. package/public/js/auth-redirect.js +12 -12
  66. package/public/js/cookie-consent.js +56 -56
  67. package/public/js/dns.js +438 -0
  68. package/public/js/wab-demo-page.js +721 -721
  69. package/public/js/ws-client.js +74 -74
  70. package/public/l-preview.html +242 -0
  71. package/public/llms-full.txt +360 -360
  72. package/public/llms.txt +125 -125
  73. package/public/login.html +85 -85
  74. package/public/mesh-dashboard.html +328 -328
  75. package/public/milestones.html +346 -0
  76. package/public/one-click.html +779 -0
  77. package/public/openapi.json +669 -580
  78. package/public/partners.ar.html +145 -0
  79. package/public/partners.html +143 -0
  80. package/public/phone-shield.html +281 -281
  81. package/public/plesk-integration.html +375 -0
  82. package/public/premium-dashboard.html +2489 -2489
  83. package/public/premium.html +793 -793
  84. package/public/privacy.html +297 -297
  85. package/public/provider-onboarding.html +172 -0
  86. package/public/provider-sandbox.html +134 -0
  87. package/public/providers.html +359 -0
  88. package/public/refusals.html +172 -0
  89. package/public/register.html +105 -105
  90. package/public/registrar-integrations.html +141 -0
  91. package/public/ring4.html +292 -0
  92. package/public/robots.txt +99 -87
  93. package/public/route53-integration.html +531 -0
  94. package/public/score.html +263 -0
  95. package/public/script/wab-consent.d.ts +36 -36
  96. package/public/script/wab-consent.js +104 -104
  97. package/public/script/wab-schema.js +131 -131
  98. package/public/script/wab.d.ts +108 -108
  99. package/public/script/wab.min.js +580 -580
  100. package/public/security.txt +8 -8
  101. package/public/shieldlink.html +244 -0
  102. package/public/shieldqr.html +231 -0
  103. package/public/sitemap.xml +19 -1
  104. package/public/terms.html +256 -256
  105. package/public/trust-graph-api.ar.html +92 -0
  106. package/public/trust-graph-api.html +91 -0
  107. package/public/wab-features.html +560 -0
  108. package/public/wab-trust.html +200 -0
  109. package/public/wab-truth.html +375 -0
  110. package/public/wab-vs-protocols.html +210 -0
  111. package/public/whitepaper.html +449 -0
  112. package/script/ai-agent-bridge.js +1754 -1754
  113. package/sdk/README.md +99 -99
  114. package/sdk/agent-mesh.js +449 -449
  115. package/sdk/auto-discovery.js +301 -0
  116. package/sdk/commander.js +262 -262
  117. package/sdk/governance.js +262 -0
  118. package/sdk/index.d.ts +464 -464
  119. package/sdk/index.js +649 -636
  120. package/sdk/multi-agent.js +318 -318
  121. package/sdk/package.json +2 -2
  122. package/sdk/safe-mode.js +221 -0
  123. package/sdk/safety-shield.js +219 -219
  124. package/sdk/schema-discovery.js +83 -83
  125. package/server/adapters/index.js +520 -520
  126. package/server/config/plans.js +412 -367
  127. package/server/config/secrets.js +102 -102
  128. package/server/control-plane/index.js +301 -301
  129. package/server/data-plane/index.js +354 -354
  130. package/server/index.js +790 -531
  131. package/server/llm/index.js +404 -404
  132. package/server/middleware/adminAuth.js +35 -35
  133. package/server/middleware/api-tier.js +170 -0
  134. package/server/middleware/auth.js +50 -50
  135. package/server/middleware/featureGate.js +88 -88
  136. package/server/middleware/rateLimits.js +100 -100
  137. package/server/middleware/sensitiveAction.js +157 -157
  138. package/server/middleware/wab-trust.js +141 -0
  139. package/server/migrations/001_add_analytics_indexes.sql +7 -7
  140. package/server/migrations/002_premium_features.sql +418 -418
  141. package/server/migrations/003_ads_integer_cents.sql +33 -33
  142. package/server/migrations/004_agent_os.sql +158 -158
  143. package/server/migrations/005_marketplace_metering.sql +126 -126
  144. package/server/migrations/006_growth_suite.sql +138 -0
  145. package/server/migrations/007_governance.sql +106 -0
  146. package/server/migrations/008_plans.sql +144 -0
  147. package/server/migrations/009_shieldqr.sql +30 -0
  148. package/server/migrations/010_extended_trust.sql +33 -0
  149. package/server/migrations/011_outreach.sql +47 -0
  150. package/server/migrations/012_shieldlink.sql +116 -0
  151. package/server/migrations/013_ct_monitor.sql +13 -0
  152. package/server/migrations/014_wab_advanced_features.sql +128 -0
  153. package/server/migrations/015_wab_truth_layer.sql +101 -0
  154. package/server/migrations/016_ring4_external_trust.sql +84 -0
  155. package/server/migrations/017_ring4_extensions.sql +69 -0
  156. package/server/migrations/018_commercial_foundations.sql +167 -0
  157. package/server/migrations/019_unify_tier_constraints.sql +133 -0
  158. package/server/models/adapters/index.js +33 -33
  159. package/server/models/adapters/mysql.js +183 -183
  160. package/server/models/adapters/postgresql.js +172 -172
  161. package/server/models/adapters/sqlite.js +7 -7
  162. package/server/models/db.js +740 -681
  163. package/server/observability/failure-analysis.js +337 -337
  164. package/server/observability/index.js +394 -394
  165. package/server/protocol/capabilities.js +223 -223
  166. package/server/protocol/index.js +243 -243
  167. package/server/protocol/schema.js +584 -584
  168. package/server/registry/certification.js +271 -271
  169. package/server/registry/index.js +326 -326
  170. package/server/routes/activate.js +478 -0
  171. package/server/routes/admin-outreach.js +239 -0
  172. package/server/routes/admin-plans.js +76 -0
  173. package/server/routes/admin-premium.js +674 -671
  174. package/server/routes/admin-shieldlink.js +137 -0
  175. package/server/routes/admin-shieldqr.js +90 -0
  176. package/server/routes/admin-trust-monitor.js +139 -0
  177. package/server/routes/admin.js +550 -261
  178. package/server/routes/adopt.js +61 -0
  179. package/server/routes/ads.js +130 -130
  180. package/server/routes/agent-workspace.js +540 -540
  181. package/server/routes/api-keys.js +127 -0
  182. package/server/routes/api.js +150 -150
  183. package/server/routes/auth.js +71 -71
  184. package/server/routes/billing.js +57 -45
  185. package/server/routes/commander.js +316 -316
  186. package/server/routes/customer-shieldlink.js +133 -0
  187. package/server/routes/demo-showcase.js +332 -332
  188. package/server/routes/demo-store.js +154 -154
  189. package/server/routes/diagnose.js +373 -0
  190. package/server/routes/discovery.js +2348 -417
  191. package/server/routes/enterprise-mesh.js +170 -0
  192. package/server/routes/gateway.js +173 -173
  193. package/server/routes/governance-saas.js +203 -0
  194. package/server/routes/governance.js +208 -0
  195. package/server/routes/growth.js +1048 -0
  196. package/server/routes/intent.js +328 -0
  197. package/server/routes/license.js +251 -251
  198. package/server/routes/mesh.js +469 -469
  199. package/server/routes/noscript.js +543 -543
  200. package/server/routes/partners.js +201 -0
  201. package/server/routes/plans.js +33 -0
  202. package/server/routes/premium-v2.js +686 -686
  203. package/server/routes/premium.js +724 -724
  204. package/server/routes/providers.js +650 -0
  205. package/server/routes/reputation.js +411 -0
  206. package/server/routes/ring4.js +885 -0
  207. package/server/routes/runtime.js +2148 -2148
  208. package/server/routes/shieldlink.js +70 -0
  209. package/server/routes/shieldqr.js +88 -0
  210. package/server/routes/sovereign.js +465 -465
  211. package/server/routes/truth-layer.js +670 -0
  212. package/server/routes/universal.js +200 -200
  213. package/server/routes/unsubscribe.js +51 -0
  214. package/server/routes/wab-api.js +850 -850
  215. package/server/routes/wab-cache.js +282 -0
  216. package/server/runtime/container-worker.js +111 -111
  217. package/server/runtime/container.js +448 -448
  218. package/server/runtime/distributed-worker.js +362 -362
  219. package/server/runtime/event-bus.js +210 -210
  220. package/server/runtime/index.js +253 -253
  221. package/server/runtime/queue.js +599 -599
  222. package/server/runtime/replay.js +666 -666
  223. package/server/runtime/sandbox.js +266 -266
  224. package/server/runtime/scheduler.js +534 -534
  225. package/server/runtime/session-engine.js +293 -293
  226. package/server/runtime/state-manager.js +188 -188
  227. package/server/secrets/wab-signing-key.pem +3 -0
  228. package/server/secrets/wab-signing-pub.pem +3 -0
  229. package/server/security/cross-site-redactor.js +196 -196
  230. package/server/security/dry-run.js +180 -180
  231. package/server/security/human-gate-rate-limit.js +147 -147
  232. package/server/security/human-gate-transports.js +178 -178
  233. package/server/security/human-gate.js +281 -281
  234. package/server/security/index.js +368 -368
  235. package/server/security/intent-engine.js +245 -245
  236. package/server/security/reward-guard.js +171 -171
  237. package/server/security/rollback-store.js +239 -239
  238. package/server/security/token-scope.js +404 -404
  239. package/server/security/url-policy.js +139 -139
  240. package/server/services/adoption-agent.js +182 -0
  241. package/server/services/agent-chat.js +506 -506
  242. package/server/services/agent-learning.js +601 -601
  243. package/server/services/agent-memory.js +625 -625
  244. package/server/services/agent-mesh.js +555 -555
  245. package/server/services/agent-symphony.js +717 -717
  246. package/server/services/agent-tasks.js +1807 -1807
  247. package/server/services/api-key-engine.js +292 -292
  248. package/server/services/cluster.js +894 -894
  249. package/server/services/commander.js +738 -738
  250. package/server/services/edge-compute.js +440 -440
  251. package/server/services/email.js +233 -204
  252. package/server/services/fairness-engine.js +409 -0
  253. package/server/services/fairness.js +420 -0
  254. package/server/services/governance.js +466 -0
  255. package/server/services/hosted-runtime.js +205 -205
  256. package/server/services/lfd.js +635 -635
  257. package/server/services/local-ai.js +389 -389
  258. package/server/services/marketplace.js +270 -270
  259. package/server/services/metering.js +182 -182
  260. package/server/services/modules/affiliate-intelligence.js +93 -93
  261. package/server/services/modules/agent-firewall.js +90 -90
  262. package/server/services/modules/bounty.js +89 -89
  263. package/server/services/modules/collective-bargaining.js +92 -92
  264. package/server/services/modules/dark-pattern.js +66 -66
  265. package/server/services/modules/gov-intelligence.js +45 -45
  266. package/server/services/modules/neural.js +55 -55
  267. package/server/services/modules/notary.js +49 -49
  268. package/server/services/modules/price-time-machine.js +86 -86
  269. package/server/services/modules/protocol.js +104 -104
  270. package/server/services/negotiation.js +439 -439
  271. package/server/services/outreach-agent.js +312 -0
  272. package/server/services/plans.js +214 -0
  273. package/server/services/plugins.js +771 -771
  274. package/server/services/premium.js +1 -1
  275. package/server/services/price-intelligence.js +566 -566
  276. package/server/services/price-shield.js +1137 -1137
  277. package/server/services/provider-clients.js +740 -0
  278. package/server/services/reputation.js +465 -465
  279. package/server/services/search-engine.js +357 -357
  280. package/server/services/security.js +513 -513
  281. package/server/services/self-healing.js +843 -843
  282. package/server/services/shieldlink.js +492 -0
  283. package/server/services/shieldqr.js +322 -0
  284. package/server/services/sovereign-shield.js +542 -542
  285. package/server/services/ssl-ct-monitor.js +224 -0
  286. package/server/services/ssl-inspector.js +42 -0
  287. package/server/services/ssl-monitor.js +167 -0
  288. package/server/services/stripe.js +206 -192
  289. package/server/services/swarm.js +788 -788
  290. package/server/services/universal-scraper.js +662 -662
  291. package/server/services/verification.js +481 -481
  292. package/server/services/vision.js +1163 -1163
  293. package/server/services/wab-crypto.js +178 -0
  294. package/server/utils/cache.js +125 -125
  295. package/server/utils/migrate.js +81 -81
  296. package/server/utils/safe-fetch.js +228 -228
  297. package/server/utils/secureFields.js +50 -50
  298. package/server/ws.js +161 -161
  299. package/templates/artisan-marketplace.yaml +104 -104
  300. package/templates/book-price-scout.yaml +98 -98
  301. package/templates/electronics-price-tracker.yaml +108 -108
  302. package/templates/flight-deal-hunter.yaml +113 -113
  303. package/templates/freelancer-direct.yaml +116 -116
  304. package/templates/grocery-price-compare.yaml +93 -93
  305. package/templates/hotel-direct-booking.yaml +113 -113
  306. package/templates/local-services.yaml +98 -98
  307. package/templates/olive-oil-tunisia.yaml +88 -88
  308. package/templates/organic-farm-fresh.yaml +101 -101
  309. package/templates/restaurant-direct.yaml +97 -97
  310. package/templates/ring4/banking-sovereign.yaml +55 -0
  311. package/templates/ring4/ecommerce-sovereign.yaml +58 -0
  312. package/templates/ring4/healthcare-sovereign.yaml +60 -0
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>
package/public/robots.txt CHANGED
@@ -1,87 +1,99 @@
1
- # Web Agent Bridge — robots.txt
2
- # https://webagentbridge.com
3
-
4
- User-agent: *
5
- Allow: /
6
- Allow: /docs
7
- Allow: /premium
8
- Allow: /privacy
9
- Allow: /terms
10
- Allow: /cookies
11
- Allow: /llms.txt
12
- Allow: /llms-full.txt
13
- Allow: /sitemap.xml
14
- Allow: /agent-bridge.json
15
- Allow: /.well-known/wab.json
16
- Allow: /.well-known/ai-assets.json
17
- Allow: /api/wab/discover
18
- Allow: /api/wab/ping
19
- Allow: /api/discovery/registry
20
- Allow: /api/plans
21
- Disallow: /api/admin/
22
- Disallow: /api/auth/
23
- Disallow: /api/billing/
24
- Disallow: /admin/
25
- Disallow: /dashboard
26
- Disallow: /premium-dashboard
27
-
28
- # AI Crawlers — Welcome! We have structured data for you.
29
- User-agent: GPTBot
30
- Allow: /
31
- Allow: /llms.txt
32
- Allow: /llms-full.txt
33
- Allow: /agent-bridge.json
34
- Allow: /sitemap.xml
35
- Crawl-delay: 2
36
-
37
- User-agent: ChatGPT-User
38
- Allow: /
39
- Allow: /llms.txt
40
- Allow: /llms-full.txt
41
- Crawl-delay: 2
42
-
43
- User-agent: Claude-Web
44
- Allow: /
45
- Allow: /llms.txt
46
- Allow: /llms-full.txt
47
- Crawl-delay: 2
48
-
49
- User-agent: Anthropic-AI
50
- Allow: /
51
- Allow: /llms.txt
52
- Allow: /llms-full.txt
53
- Crawl-delay: 2
54
-
55
- User-agent: Google-Extended
56
- Allow: /
57
- Crawl-delay: 2
58
-
59
- User-agent: Bingbot
60
- Allow: /
61
- Crawl-delay: 1
62
-
63
- User-agent: PerplexityBot
64
- Allow: /
65
- Allow: /llms.txt
66
- Allow: /llms-full.txt
67
- Crawl-delay: 2
68
-
69
- User-agent: YouBot
70
- Allow: /
71
- Allow: /llms.txt
72
- Allow: /llms-full.txt
73
- Crawl-delay: 2
74
-
75
- User-agent: CCBot
76
- Allow: /
77
- Crawl-delay: 5
78
-
79
- # Sitemap
80
- Sitemap: https://webagentbridge.com/sitemap.xml
81
-
82
- # AI-readable resources
83
- # llms.txt: https://webagentbridge.com/llms.txt
84
- # llms-full.txt: https://webagentbridge.com/llms-full.txt
85
- # Discovery: https://webagentbridge.com/agent-bridge.json
86
- # AI Assets: https://webagentbridge.com/.well-known/ai-assets.json
87
- # OpenAPI: https://webagentbridge.com/openapi.json
1
+ # Web Agent Bridge — robots.txt
2
+ # https://webagentbridge.com
3
+
4
+ User-agent: *
5
+ Allow: /
6
+ Allow: /docs
7
+ Allow: /premium
8
+ Allow: /privacy
9
+ Allow: /terms
10
+ Allow: /cookies
11
+ Allow: /llms.txt
12
+ Allow: /llms-full.txt
13
+ Allow: /sitemap.xml
14
+ Allow: /agent-bridge.json
15
+ Allow: /.well-known/wab.json
16
+ Allow: /.well-known/ai-assets.json
17
+ Allow: /api/wab/discover
18
+ Allow: /api/wab/ping
19
+ Allow: /api/discovery/registry
20
+ Allow: /api/plans
21
+ Disallow: /api/admin/
22
+ Disallow: /api/auth/
23
+ Disallow: /api/billing/
24
+ Disallow: /admin/
25
+ Disallow: /dashboard
26
+ Disallow: /premium-dashboard
27
+
28
+ # Whitepaper: indexable but no archive / no snippet (rights protected)
29
+ Allow: /whitepaper
30
+ Disallow: /whitepaper.html
31
+
32
+ # Block archivers explicitly
33
+ User-agent: ia_archiver
34
+ Disallow: /whitepaper
35
+ Disallow: /whitepaper.html
36
+ User-agent: archive.org_bot
37
+ Disallow: /whitepaper
38
+ Disallow: /whitepaper.html
39
+
40
+ # AI Crawlers — Welcome! We have structured data for you.
41
+ User-agent: GPTBot
42
+ Allow: /
43
+ Allow: /llms.txt
44
+ Allow: /llms-full.txt
45
+ Allow: /agent-bridge.json
46
+ Allow: /sitemap.xml
47
+ Crawl-delay: 2
48
+
49
+ User-agent: ChatGPT-User
50
+ Allow: /
51
+ Allow: /llms.txt
52
+ Allow: /llms-full.txt
53
+ Crawl-delay: 2
54
+
55
+ User-agent: Claude-Web
56
+ Allow: /
57
+ Allow: /llms.txt
58
+ Allow: /llms-full.txt
59
+ Crawl-delay: 2
60
+
61
+ User-agent: Anthropic-AI
62
+ Allow: /
63
+ Allow: /llms.txt
64
+ Allow: /llms-full.txt
65
+ Crawl-delay: 2
66
+
67
+ User-agent: Google-Extended
68
+ Allow: /
69
+ Crawl-delay: 2
70
+
71
+ User-agent: Bingbot
72
+ Allow: /
73
+ Crawl-delay: 1
74
+
75
+ User-agent: PerplexityBot
76
+ Allow: /
77
+ Allow: /llms.txt
78
+ Allow: /llms-full.txt
79
+ Crawl-delay: 2
80
+
81
+ User-agent: YouBot
82
+ Allow: /
83
+ Allow: /llms.txt
84
+ Allow: /llms-full.txt
85
+ Crawl-delay: 2
86
+
87
+ User-agent: CCBot
88
+ Allow: /
89
+ Crawl-delay: 5
90
+
91
+ # Sitemap
92
+ Sitemap: https://webagentbridge.com/sitemap.xml
93
+
94
+ # AI-readable resources
95
+ # llms.txt: https://webagentbridge.com/llms.txt
96
+ # llms-full.txt: https://webagentbridge.com/llms-full.txt
97
+ # Discovery: https://webagentbridge.com/agent-bridge.json
98
+ # AI Assets: https://webagentbridge.com/.well-known/ai-assets.json
99
+ # OpenAPI: https://webagentbridge.com/openapi.json