web-agent-bridge 3.4.0 → 3.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (310) hide show
  1. package/LICENSE +84 -84
  2. package/README.ar.md +1563 -1304
  3. package/README.md +137 -298
  4. package/bin/agent-runner.js +474 -474
  5. package/bin/cli.js +237 -237
  6. package/bin/wab-init.js +244 -223
  7. package/bin/wab.js +80 -80
  8. package/examples/azure-dns-wab.js +83 -83
  9. package/examples/bidi-agent.js +119 -119
  10. package/examples/cloudflare-wab-dns.js +121 -121
  11. package/examples/cpanel-wab-dns.js +114 -114
  12. package/examples/cross-site-agent.js +91 -91
  13. package/examples/dns-discovery-agent.js +166 -166
  14. package/examples/gcp-dns-wab.js +76 -76
  15. package/examples/governance-agent.js +169 -169
  16. package/examples/mcp-agent.js +94 -94
  17. package/examples/next-app-router/README.md +44 -44
  18. package/examples/plesk-wab-dns.js +103 -103
  19. package/examples/puppeteer-agent.js +108 -108
  20. package/examples/route53-wab-dns.js +144 -144
  21. package/examples/saas-dashboard/README.md +55 -55
  22. package/examples/safe-mode-agent.js +96 -96
  23. package/examples/self-discovery.js +106 -0
  24. package/examples/shopify-hydrogen/README.md +74 -74
  25. package/examples/vision-agent.js +171 -171
  26. package/examples/wab-sign.js +74 -74
  27. package/examples/wab-verify.js +60 -60
  28. package/examples/wordpress-elementor/README.md +77 -77
  29. package/package.json +93 -93
  30. package/public/.well-known/agent-tools.json +180 -180
  31. package/public/.well-known/ai-assets.json +59 -59
  32. package/public/.well-known/security.txt +8 -8
  33. package/public/.well-known/wab.json +28 -28
  34. package/public/activate.html +448 -368
  35. package/public/adopt.html +236 -0
  36. package/public/adoption-metrics.html +188 -188
  37. package/public/agent-workspace.html +359 -349
  38. package/public/ai.html +198 -198
  39. package/public/api.html +397 -413
  40. package/public/azure-dns-integration.html +289 -289
  41. package/public/browser.html +486 -486
  42. package/public/cloudflare-integration.html +380 -380
  43. package/public/commander-dashboard.html +243 -243
  44. package/public/cookies.html +210 -210
  45. package/public/cpanel-integration.html +398 -398
  46. package/public/css/agent-workspace.css +1713 -1713
  47. package/public/css/premium.css +317 -317
  48. package/public/css/styles.css +1401 -1263
  49. package/public/dashboard-shieldlink.html +295 -0
  50. package/public/dashboard.html +711 -707
  51. package/public/dns.html +436 -436
  52. package/public/docs.html +588 -588
  53. package/public/enterprise-mesh.ar.html +80 -0
  54. package/public/enterprise-mesh.html +81 -0
  55. package/public/feed.xml +89 -89
  56. package/public/gcp-dns-integration.html +318 -318
  57. package/public/governance.ar.html +70 -0
  58. package/public/governance.html +69 -0
  59. package/public/growth.html +465 -465
  60. package/public/index.html +1372 -1266
  61. package/public/integrations.html +556 -556
  62. package/public/js/activate.js +449 -145
  63. package/public/js/agent-workspace.js +1740 -1740
  64. package/public/js/auth-nav.js +117 -65
  65. package/public/js/auth-redirect.js +12 -12
  66. package/public/js/cookie-consent.js +56 -56
  67. package/public/js/dns.js +438 -438
  68. package/public/js/wab-demo-page.js +721 -721
  69. package/public/js/ws-client.js +74 -74
  70. package/public/l-preview.html +242 -0
  71. package/public/llms-full.txt +360 -360
  72. package/public/llms.txt +125 -125
  73. package/public/login.html +85 -85
  74. package/public/mesh-dashboard.html +328 -328
  75. package/public/milestones.html +346 -0
  76. package/public/one-click.html +779 -0
  77. package/public/openapi.json +669 -669
  78. package/public/partners.ar.html +145 -0
  79. package/public/partners.html +143 -0
  80. package/public/phone-shield.html +281 -281
  81. package/public/plesk-integration.html +375 -375
  82. package/public/premium-dashboard.html +2489 -2489
  83. package/public/premium.html +793 -793
  84. package/public/privacy.html +297 -297
  85. package/public/provider-onboarding.html +172 -172
  86. package/public/provider-sandbox.html +134 -134
  87. package/public/providers.html +359 -359
  88. package/public/refusals.html +172 -0
  89. package/public/register.html +105 -105
  90. package/public/registrar-integrations.html +141 -141
  91. package/public/ring4.html +292 -0
  92. package/public/robots.txt +99 -99
  93. package/public/route53-integration.html +531 -531
  94. package/public/score.html +263 -0
  95. package/public/script/wab-consent.d.ts +36 -36
  96. package/public/script/wab-consent.js +104 -104
  97. package/public/script/wab-schema.js +131 -131
  98. package/public/script/wab.d.ts +108 -108
  99. package/public/script/wab.min.js +580 -580
  100. package/public/security.txt +8 -8
  101. package/public/shieldlink.html +244 -0
  102. package/public/shieldqr.html +231 -231
  103. package/public/sitemap.xml +13 -1
  104. package/public/terms.html +256 -256
  105. package/public/trust-graph-api.ar.html +92 -0
  106. package/public/trust-graph-api.html +91 -0
  107. package/public/wab-features.html +560 -0
  108. package/public/wab-trust.html +200 -200
  109. package/public/wab-truth.html +375 -0
  110. package/public/wab-vs-protocols.html +210 -210
  111. package/public/whitepaper.html +449 -449
  112. package/script/ai-agent-bridge.js +1754 -1754
  113. package/sdk/README.md +99 -99
  114. package/sdk/agent-mesh.js +449 -449
  115. package/sdk/auto-discovery.js +301 -288
  116. package/sdk/commander.js +262 -262
  117. package/sdk/governance.js +262 -262
  118. package/sdk/index.d.ts +464 -464
  119. package/sdk/index.js +649 -649
  120. package/sdk/multi-agent.js +318 -318
  121. package/sdk/safe-mode.js +221 -221
  122. package/sdk/safety-shield.js +219 -219
  123. package/sdk/schema-discovery.js +83 -83
  124. package/server/adapters/index.js +520 -520
  125. package/server/config/plans.js +412 -367
  126. package/server/config/secrets.js +102 -102
  127. package/server/control-plane/index.js +301 -301
  128. package/server/data-plane/index.js +354 -354
  129. package/server/index.js +790 -670
  130. package/server/llm/index.js +404 -404
  131. package/server/middleware/adminAuth.js +35 -35
  132. package/server/middleware/api-tier.js +170 -0
  133. package/server/middleware/auth.js +50 -50
  134. package/server/middleware/featureGate.js +88 -88
  135. package/server/middleware/rateLimits.js +100 -100
  136. package/server/middleware/sensitiveAction.js +157 -157
  137. package/server/middleware/wab-trust.js +141 -0
  138. package/server/migrations/001_add_analytics_indexes.sql +7 -7
  139. package/server/migrations/002_premium_features.sql +418 -418
  140. package/server/migrations/003_ads_integer_cents.sql +33 -33
  141. package/server/migrations/004_agent_os.sql +158 -158
  142. package/server/migrations/005_marketplace_metering.sql +126 -126
  143. package/server/migrations/006_growth_suite.sql +138 -0
  144. package/server/migrations/007_governance.sql +106 -106
  145. package/server/migrations/008_plans.sql +144 -144
  146. package/server/migrations/009_shieldqr.sql +30 -30
  147. package/server/migrations/010_extended_trust.sql +33 -33
  148. package/server/migrations/011_outreach.sql +47 -0
  149. package/server/migrations/012_shieldlink.sql +116 -0
  150. package/server/migrations/013_ct_monitor.sql +13 -0
  151. package/server/migrations/014_wab_advanced_features.sql +128 -0
  152. package/server/migrations/015_wab_truth_layer.sql +101 -0
  153. package/server/migrations/016_ring4_external_trust.sql +84 -0
  154. package/server/migrations/017_ring4_extensions.sql +69 -0
  155. package/server/migrations/018_commercial_foundations.sql +167 -0
  156. package/server/migrations/019_unify_tier_constraints.sql +133 -0
  157. package/server/models/adapters/index.js +33 -33
  158. package/server/models/adapters/mysql.js +183 -183
  159. package/server/models/adapters/postgresql.js +172 -172
  160. package/server/models/adapters/sqlite.js +7 -7
  161. package/server/models/db.js +740 -740
  162. package/server/observability/failure-analysis.js +337 -337
  163. package/server/observability/index.js +394 -394
  164. package/server/protocol/capabilities.js +223 -223
  165. package/server/protocol/index.js +243 -243
  166. package/server/protocol/schema.js +584 -584
  167. package/server/registry/certification.js +271 -271
  168. package/server/registry/index.js +326 -326
  169. package/server/routes/activate.js +478 -0
  170. package/server/routes/admin-outreach.js +239 -0
  171. package/server/routes/admin-plans.js +76 -76
  172. package/server/routes/admin-premium.js +674 -673
  173. package/server/routes/admin-shieldlink.js +137 -0
  174. package/server/routes/admin-shieldqr.js +90 -90
  175. package/server/routes/admin-trust-monitor.js +139 -83
  176. package/server/routes/admin.js +550 -549
  177. package/server/routes/adopt.js +61 -0
  178. package/server/routes/ads.js +130 -130
  179. package/server/routes/agent-workspace.js +540 -540
  180. package/server/routes/api-keys.js +127 -0
  181. package/server/routes/api.js +150 -150
  182. package/server/routes/auth.js +71 -71
  183. package/server/routes/billing.js +57 -57
  184. package/server/routes/commander.js +316 -316
  185. package/server/routes/customer-shieldlink.js +133 -0
  186. package/server/routes/demo-showcase.js +332 -332
  187. package/server/routes/demo-store.js +154 -154
  188. package/server/routes/diagnose.js +373 -0
  189. package/server/routes/discovery.js +2348 -2348
  190. package/server/routes/enterprise-mesh.js +170 -0
  191. package/server/routes/gateway.js +173 -173
  192. package/server/routes/governance-saas.js +203 -0
  193. package/server/routes/governance.js +208 -208
  194. package/server/routes/growth.js +1048 -0
  195. package/server/routes/intent.js +328 -0
  196. package/server/routes/license.js +251 -251
  197. package/server/routes/mesh.js +469 -469
  198. package/server/routes/noscript.js +543 -543
  199. package/server/routes/partners.js +201 -0
  200. package/server/routes/plans.js +33 -33
  201. package/server/routes/premium-v2.js +686 -686
  202. package/server/routes/premium.js +724 -724
  203. package/server/routes/providers.js +650 -650
  204. package/server/routes/reputation.js +411 -0
  205. package/server/routes/ring4.js +885 -0
  206. package/server/routes/runtime.js +2148 -2148
  207. package/server/routes/shieldlink.js +70 -0
  208. package/server/routes/shieldqr.js +88 -88
  209. package/server/routes/sovereign.js +465 -465
  210. package/server/routes/truth-layer.js +670 -0
  211. package/server/routes/universal.js +200 -200
  212. package/server/routes/unsubscribe.js +51 -0
  213. package/server/routes/wab-api.js +850 -850
  214. package/server/routes/wab-cache.js +282 -0
  215. package/server/runtime/container-worker.js +111 -111
  216. package/server/runtime/container.js +448 -448
  217. package/server/runtime/distributed-worker.js +362 -362
  218. package/server/runtime/event-bus.js +210 -210
  219. package/server/runtime/index.js +253 -253
  220. package/server/runtime/queue.js +599 -599
  221. package/server/runtime/replay.js +666 -666
  222. package/server/runtime/sandbox.js +266 -266
  223. package/server/runtime/scheduler.js +534 -534
  224. package/server/runtime/session-engine.js +293 -293
  225. package/server/runtime/state-manager.js +188 -188
  226. package/server/secrets/wab-signing-key.pem +3 -0
  227. package/server/secrets/wab-signing-pub.pem +3 -0
  228. package/server/security/cross-site-redactor.js +196 -196
  229. package/server/security/dry-run.js +180 -180
  230. package/server/security/human-gate-rate-limit.js +147 -147
  231. package/server/security/human-gate-transports.js +178 -178
  232. package/server/security/human-gate.js +281 -281
  233. package/server/security/index.js +368 -368
  234. package/server/security/intent-engine.js +245 -245
  235. package/server/security/reward-guard.js +171 -171
  236. package/server/security/rollback-store.js +239 -239
  237. package/server/security/token-scope.js +404 -404
  238. package/server/security/url-policy.js +139 -139
  239. package/server/services/adoption-agent.js +182 -0
  240. package/server/services/agent-chat.js +506 -506
  241. package/server/services/agent-learning.js +601 -601
  242. package/server/services/agent-memory.js +625 -625
  243. package/server/services/agent-mesh.js +555 -555
  244. package/server/services/agent-symphony.js +717 -717
  245. package/server/services/agent-tasks.js +1807 -1807
  246. package/server/services/api-key-engine.js +292 -292
  247. package/server/services/cluster.js +894 -894
  248. package/server/services/commander.js +738 -738
  249. package/server/services/edge-compute.js +440 -440
  250. package/server/services/email.js +233 -233
  251. package/server/services/fairness-engine.js +409 -0
  252. package/server/services/fairness.js +420 -0
  253. package/server/services/governance.js +466 -466
  254. package/server/services/hosted-runtime.js +205 -205
  255. package/server/services/lfd.js +635 -635
  256. package/server/services/local-ai.js +389 -389
  257. package/server/services/marketplace.js +270 -270
  258. package/server/services/metering.js +182 -182
  259. package/server/services/modules/affiliate-intelligence.js +93 -93
  260. package/server/services/modules/agent-firewall.js +90 -90
  261. package/server/services/modules/bounty.js +89 -89
  262. package/server/services/modules/collective-bargaining.js +92 -92
  263. package/server/services/modules/dark-pattern.js +66 -66
  264. package/server/services/modules/gov-intelligence.js +45 -45
  265. package/server/services/modules/neural.js +55 -55
  266. package/server/services/modules/notary.js +49 -49
  267. package/server/services/modules/price-time-machine.js +86 -86
  268. package/server/services/modules/protocol.js +104 -104
  269. package/server/services/negotiation.js +439 -439
  270. package/server/services/outreach-agent.js +312 -0
  271. package/server/services/plans.js +214 -214
  272. package/server/services/plugins.js +771 -771
  273. package/server/services/price-intelligence.js +566 -566
  274. package/server/services/price-shield.js +1137 -1137
  275. package/server/services/provider-clients.js +740 -740
  276. package/server/services/reputation.js +465 -465
  277. package/server/services/search-engine.js +357 -357
  278. package/server/services/security.js +513 -513
  279. package/server/services/self-healing.js +843 -843
  280. package/server/services/shieldlink.js +492 -0
  281. package/server/services/shieldqr.js +322 -322
  282. package/server/services/sovereign-shield.js +542 -542
  283. package/server/services/ssl-ct-monitor.js +224 -0
  284. package/server/services/ssl-inspector.js +42 -42
  285. package/server/services/ssl-monitor.js +167 -167
  286. package/server/services/stripe.js +206 -205
  287. package/server/services/swarm.js +788 -788
  288. package/server/services/universal-scraper.js +662 -662
  289. package/server/services/verification.js +481 -481
  290. package/server/services/vision.js +1163 -1163
  291. package/server/services/wab-crypto.js +178 -178
  292. package/server/utils/cache.js +125 -125
  293. package/server/utils/migrate.js +81 -81
  294. package/server/utils/safe-fetch.js +228 -228
  295. package/server/utils/secureFields.js +50 -50
  296. package/server/ws.js +161 -161
  297. package/templates/artisan-marketplace.yaml +104 -104
  298. package/templates/book-price-scout.yaml +98 -98
  299. package/templates/electronics-price-tracker.yaml +108 -108
  300. package/templates/flight-deal-hunter.yaml +113 -113
  301. package/templates/freelancer-direct.yaml +116 -116
  302. package/templates/grocery-price-compare.yaml +93 -93
  303. package/templates/hotel-direct-booking.yaml +113 -113
  304. package/templates/local-services.yaml +98 -98
  305. package/templates/olive-oil-tunisia.yaml +88 -88
  306. package/templates/organic-farm-fresh.yaml +101 -101
  307. package/templates/restaurant-direct.yaml +97 -97
  308. package/templates/ring4/banking-sovereign.yaml +55 -0
  309. package/templates/ring4/ecommerce-sovereign.yaml +58 -0
  310. package/templates/ring4/healthcare-sovereign.yaml +60 -0
package/server/services/outreach-agent.js ADDED
@@ -0,0 +1,312 @@
1
+ /**
2
+ * Outreach Agent — site analysis, language detection, multilingual email drafts.
3
+ *
4
+ * Pipeline (per target URL):
5
+ * 1) discover() to extract metadata
6
+ * 2) Detect language from <html lang>, <meta>, content sniffing
7
+ * 3) Detect site kind (ecommerce / saas / blog / news / agency / static)
8
+ * 4) Pick relevant WAB features
9
+ * 5) Try to find a public contact email (mailto: in /, /contact, /about)
10
+ * 6) Compose subject + body in detected language
11
+ *
12
+ * STRICT HUMAN-IN-THE-LOOP:
13
+ * • All drafts saved with status='pending'.
14
+ * • Sending requires admin approval and respects the suppression list,
15
+ * a global hourly throttle, and per-recipient cooldown (30 days).
16
+ */
17
+
18
+ 'use strict';
19
+
20
+ const https = require('node:https');
21
+ const http = require('node:http');
22
+ const tls = require('node:tls');
23
+ const crypto = require('node:crypto');
24
+ const { URL } = require('node:url');
25
+
26
+ const { discover } = require('../../sdk/auto-discovery');
27
+
28
+ // ─── Defaults ─────────────────────────────────────────────────────────
29
+ const FETCH_TIMEOUT = 9000;
30
+ const USER_AGENT = 'WAB-OutreachAgent/1.0 (+https://www.webagentbridge.com/about)';
31
+ const SUPPORTED_LANGS = ['en', 'ar', 'fr', 'es', 'de'];
32
+ const FALLBACK_LANG = 'en';
33
+
34
+ // ─── Tiny HTTP fetcher (no external deps) ─────────────────────────────
35
+ function _fetch(urlStr, { timeoutMs = FETCH_TIMEOUT, maxBytes = 600 * 1024, headers = {} } = {}) {
36
+ return new Promise((resolve) => {
37
+ let url;
38
+ try { url = new URL(urlStr); } catch { return resolve(null); }
39
+ const lib = url.protocol === 'http:' ? http : https;
40
+ const req = lib.request({
41
+ method: 'GET',
42
+ host: url.hostname,
43
+ port: url.port || (url.protocol === 'http:' ? 80 : 443),
44
+ path: url.pathname + url.search,
45
+ headers: { 'user-agent': USER_AGENT, accept: 'text/html,*/*;q=0.8', ...headers },
46
+ timeout: timeoutMs,
47
+ rejectUnauthorized: false
48
+ }, (res) => {
49
+ // follow up to one redirect
50
+ if ([301, 302, 303, 307, 308].includes(res.statusCode) && res.headers.location && !headers._followed) {
51
+ try {
52
+ const next = new URL(res.headers.location, url).toString();
53
+ res.destroy();
54
+ return resolve(_fetch(next, { timeoutMs, maxBytes, headers: { ...headers, _followed: 1 } }));
55
+ } catch { /* fall through */ }
56
+ }
57
+ const chunks = []; let len = 0;
58
+ res.on('data', (c) => {
59
+ len += c.length;
60
+ if (len > maxBytes) { res.destroy(); return; }
61
+ chunks.push(c);
62
+ });
63
+ res.on('end', () => resolve({ status: res.statusCode, headers: res.headers, body: Buffer.concat(chunks).toString('utf8').slice(0, maxBytes) }));
64
+ res.on('error', () => resolve(null));
65
+ });
66
+ req.on('error', () => resolve(null));
67
+ req.on('timeout', () => { req.destroy(); resolve(null); });
68
+ req.end();
69
+ });
70
+ }
71
+
72
+ // ─── Language detection ──────────────────────────────────────────────
73
+ function _detectLang(env, html) {
74
+ // 1) <html lang="..."> attribute
75
+ const m1 = (html || '').match(/<html[^>]*\blang\s*=\s*["']?([a-zA-Z\-]{2,8})/i);
76
+ if (m1) return _normalizeLang(m1[1]);
77
+
78
+ // 2) <meta http-equiv="content-language"> or <meta name="language">
79
+ const m2 = (html || '').match(/<meta[^>]*(?:http-equiv\s*=\s*["']?content-language|name\s*=\s*["']?(?:language|og:locale))["']?[^>]*content\s*=\s*["']?([a-zA-Z_\-]{2,8})/i);
80
+ if (m2) return _normalizeLang(m2[1]);
81
+
82
+ // 3) discover() locale hint
83
+ if (env && env.site && env.site.locale) return _normalizeLang(env.site.locale);
84
+
85
+ // 4) Content sniff (very light)
86
+ const text = (html || '').replace(/<[^>]+>/g, ' ').slice(0, 4000);
87
+ if (/[\u0600-\u06FF]/.test(text)) return 'ar';
88
+ if (/\b(le|la|les|des|nous|vous|votre|pour|avec|aussi|merci|bienvenue)\b/i.test(text)) return 'fr';
89
+ if (/\b(que|para|los|las|gracias|bienvenido|nuestro|también)\b/i.test(text)) return 'es';
90
+ if (/\b(und|der|die|das|für|mit|wir|sie|willkommen|unser)\b/i.test(text)) return 'de';
91
+ return FALLBACK_LANG;
92
+ }
93
+ function _normalizeLang(l) {
94
+ if (!l) return FALLBACK_LANG;
95
+ const base = String(l).toLowerCase().split(/[-_]/)[0];
96
+ return SUPPORTED_LANGS.includes(base) ? base : FALLBACK_LANG;
97
+ }
98
+
99
+ // ─── Site kind heuristics ────────────────────────────────────────────
100
+ function _detectKind(env, html) {
101
+ const signals = [];
102
+ let kind = 'static';
103
+ const h = (html || '').toLowerCase();
104
+ if (/\bschema\.org\/product/i.test(html || '') || (env.products && env.products.length >= 2)) {
105
+ kind = 'ecommerce'; signals.push('schema.org/Product');
106
+ } else if (/<meta[^>]*woocommerce|wp-content\/plugins\/woocommerce|cdn\.shopify\.com|shopify\.com/i.test(html || '')) {
107
+ kind = 'ecommerce'; signals.push('shop platform');
108
+ } else if (/wp-content|wp-includes|wp-json/i.test(html || '')) {
109
+ kind = 'wordpress'; signals.push('wordpress');
110
+ } else if (/__next|next\.config|\/_next\//i.test(html || '')) {
111
+ kind = 'nextjs'; signals.push('nextjs');
112
+ } else if (/\bpricing\b|\bsign\s*up\b|\bsubscription\b|\bsaas\b|\bapi\b/i.test(h)) {
113
+ kind = 'saas'; signals.push('saas keywords');
114
+ } else if (/\bblog\b|\barticle\b|<article/i.test(html || '')) {
115
+ kind = 'blog'; signals.push('blog');
116
+ }
117
+ if (env.sitemap && env.sitemap.length > 50) signals.push(`sitemap(${env.sitemap.length})`);
118
+ return { kind, signals };
119
+ }
120
+
121
+ // ─── Feature suggestions per kind ────────────────────────────────────
122
+ function _suggestFeatures(kind, env) {
123
+ const base = ['DNS Discovery (one-click activation)', 'wab.json action manifest'];
124
+ const map = {
125
+ ecommerce: [...base, 'ShieldQR signed catalog & checkout', 'SSL Monitor (cert expiry alerts)', 'Phone Shield for refund/order disputes', 'Schema discovery for AI shopping agents'],
126
+ saas: [...base, 'Scoped tokens (rate-limited agent API keys)', 'Governance audit chain (HMAC tamper-evident logs)', 'Plans Gateway for tier upsell', 'Human-Gate for sensitive actions'],
127
+ wordpress: [...base, 'WordPress plugin (1-click install)', 'Comment shield + spam suppression', 'wab.json auto-generated from posts'],
128
+ nextjs: [...base, '@webagentbridge/next zero-config middleware', 'Edge functions for /.well-known/wab.json', 'Auto-discovery of API routes'],
129
+ blog: [...base, 'Sitemap → AI-readable index', 'Newsletter subscribe action for agents', 'Article schema for citation'],
130
+ news: [...base, 'Article action manifest', 'DNS Discovery for AI assistants'],
131
+ static: [...base, 'Cloudflare Worker zero-config snippet', 'Static .well-known/wab.json file']
132
+ };
133
+ const out = map[kind] || base;
134
+ if (env && env.products && env.products.length) out.push('Schema discovery (product graph already detected)');
135
+ return Array.from(new Set(out)).slice(0, 6);
136
+ }
137
+
138
+ // ─── Find a public contact email (mailto: only) ───────────────────────
139
+ async function _findContactEmail(baseUrl) {
140
+ const candidates = ['/', '/contact', '/contact-us', '/contact.html', '/about', '/about-us', '/imprint', '/legal', '/contacto', '/kontakt', '/contactez-nous'];
141
+ const seen = new Set();
142
+ for (const path of candidates) {
143
+ try {
144
+ const u = new URL(path, baseUrl).toString();
145
+ if (seen.has(u)) continue; seen.add(u);
146
+ const r = await _fetch(u, { timeoutMs: 5000 });
147
+ if (!r || !r.body) continue;
148
+ const matches = r.body.match(/mailto:([A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,})/g) || [];
149
+ const emails = matches.map((m) => m.replace(/^mailto:/, '').toLowerCase()).filter((e) => !/no-?reply|donot|wordpress@|admin@example/i.test(e));
150
+ if (emails.length) return { email: emails[0], source: u };
151
+ } catch { /* ignore */ }
152
+ }
153
+ return null;
154
+ }
155
+
156
+ // ─── TLS fingerprint (best effort) ────────────────────────────────────
157
+ function _tlsFp(host, timeoutMs = 5000) {
158
+ return new Promise((resolve) => {
159
+ let done = false;
160
+ try {
161
+ const sock = tls.connect({ host, port: 443, servername: host, rejectUnauthorized: false }, () => {
162
+ if (done) return; done = true;
163
+ const c = sock.getPeerCertificate(false);
164
+ const fp = c && c.fingerprint256 ? String(c.fingerprint256).replace(/:/g, '').toLowerCase() : null;
165
+ sock.end(); resolve(fp);
166
+ });
167
+ sock.setTimeout(timeoutMs, () => { if (!done) { done = true; sock.destroy(); resolve(null); } });
168
+ sock.on('error', () => { if (!done) { done = true; resolve(null); } });
169
+ } catch { resolve(null); }
170
+ });
171
+ }
172
+
173
+ // ─── Multilingual templates ──────────────────────────────────────────
174
+ const T = {
175
+ en: {
176
+ subject: (site) => `Make ${site} discoverable to AI agents — open protocol, 5-minute setup`,
177
+ greeting: (name) => `Hi ${name || 'there'},`,
178
+ intro: (site, kind) => `I noticed ${site} looks like a great ${kind} site. We built <b>Web Agent Bridge (WAB)</b> — an open AI ↔ Web protocol that lets AI agents (ChatGPT, Claude, Gemini, etc.) safely interact with your site through declared, signed actions instead of fragile HTML scraping.`,
179
+ why: 'Why now:',
180
+ cta: 'Try the one-click adoption agent',
181
+ closing: 'Best,',
182
+ signature: 'The Web Agent Bridge team',
183
+ unsubscribe: 'Don\'t want emails like this? Unsubscribe here',
184
+ footnote: 'Open Core — MIT-licensed core, opt-in commercial features. No tracking pixels in this email.'
185
+ },
186
+ ar: {
187
+ rtl: true,
188
+ subject: (site) => `اجعل ${site} قابلًا للاكتشاف من قِبَل وكلاء الذكاء الاصطناعي — بروتوكول مفتوح، إعداد في 5 دقائق`,
189
+ greeting: (name) => `مرحبًا${name ? ' ' + name : ''}،`,
190
+ intro: (site, kind) => `لاحظنا أن موقع ${site} يبدو موقع <b>${kind}</b> رائعًا. لقد قمنا ببناء <b>Web Agent Bridge (WAB)</b> — بروتوكول مفتوح للويب يربط بين وكلاء الذكاء الاصطناعي (ChatGPT، Claude، Gemini …) وموقعك عبر إجراءات مُعلنة وموقَّعة بدلاً من تحليل HTML الهش.`,
191
+ why: 'لماذا الآن:',
192
+ cta: 'جرّب وكيل التبنّي بنقرة واحدة',
193
+ closing: 'مع أطيب التحيات،',
194
+ signature: 'فريق Web Agent Bridge',
195
+ unsubscribe: 'لا ترغب في تلقّي مثل هذه الرسائل؟ إلغاء الاشتراك من هنا',
196
+ footnote: 'مفتوح المصدر (Open Core) — رخصة MIT للجزء الأساسي، ميزات تجارية اختيارية. لا توجد أيّة بكسلات تتبّع في هذا البريد.'
197
+ },
198
+ fr: {
199
+ subject: (site) => `Rendez ${site} découvrable par les agents IA — protocole ouvert, configuration en 5 minutes`,
200
+ greeting: (name) => `Bonjour${name ? ' ' + name : ''},`,
201
+ intro: (site, kind) => `Nous avons remarqué que ${site} semble être un excellent site ${kind}. Nous avons créé <b>Web Agent Bridge (WAB)</b> — un protocole IA ↔ Web ouvert qui permet aux agents IA (ChatGPT, Claude, Gemini, etc.) d'interagir avec votre site via des actions déclarées et signées plutôt que via du scraping HTML fragile.`,
202
+ why: 'Pourquoi maintenant :',
203
+ cta: 'Essayez l\'agent d\'adoption en un clic',
204
+ closing: 'Cordialement,',
205
+ signature: 'L\'équipe Web Agent Bridge',
206
+ unsubscribe: 'Vous ne souhaitez pas recevoir de tels emails ? Désabonnez-vous ici',
207
+ footnote: 'Open Core — noyau sous licence MIT, fonctionnalités commerciales optionnelles. Aucun pixel de suivi dans cet email.'
208
+ },
209
+ es: {
210
+ subject: (site) => `Haz que ${site} sea descubrible para agentes de IA — protocolo abierto, 5 min`,
211
+ greeting: (name) => `Hola${name ? ' ' + name : ''},`,
212
+ intro: (site, kind) => `Hemos visto que ${site} parece un excelente sitio ${kind}. Creamos <b>Web Agent Bridge (WAB)</b> — un protocolo IA ↔ Web abierto que permite que los agentes (ChatGPT, Claude, Gemini, etc.) interactúen con tu sitio mediante acciones declaradas y firmadas en lugar de scraping frágil.`,
213
+ why: 'Por qué ahora:',
214
+ cta: 'Prueba el agente de adopción de un clic',
215
+ closing: 'Saludos,',
216
+ signature: 'El equipo de Web Agent Bridge',
217
+ unsubscribe: '¿No deseas recibir estos correos? Cancela la suscripción aquí',
218
+ footnote: 'Open Core — núcleo MIT, funciones comerciales opcionales. Sin píxeles de seguimiento.'
219
+ },
220
+ de: {
221
+ subject: (site) => `Mach ${site} für KI-Agenten auffindbar — offenes Protokoll, in 5 Minuten`,
222
+ greeting: (name) => `Hallo${name ? ' ' + name : ''},`,
223
+ intro: (site, kind) => `Uns ist aufgefallen, dass ${site} eine ausgezeichnete ${kind}-Seite zu sein scheint. Wir haben <b>Web Agent Bridge (WAB)</b> entwickelt — ein offenes KI ↔ Web-Protokoll, mit dem KI-Agenten (ChatGPT, Claude, Gemini …) sicher mit Ihrer Website über deklarierte, signierte Aktionen interagieren statt über fragiles HTML-Scraping.`,
224
+ why: 'Warum jetzt:',
225
+ cta: 'Probieren Sie den 1-Klick-Adoptionsagenten',
226
+ closing: 'Beste Grüße,',
227
+ signature: 'Das Web Agent Bridge Team',
228
+ unsubscribe: 'Keine solchen E-Mails mehr? Hier abmelden',
229
+ footnote: 'Open Core — MIT-lizenzierter Kern, optionale kommerzielle Funktionen. Keine Tracking-Pixel.'
230
+ }
231
+ };
232
+
233
+ function _esc(s) { return String(s == null ? '' : s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;'); }
234
+
235
+ function _composeEmail({ host, kind, lang, features, recipientName, unsubscribeUrl, adoptUrl }) {
236
+ const t = T[lang] || T[FALLBACK_LANG];
237
+ const dir = t.rtl ? 'rtl' : 'ltr';
238
+ const align = t.rtl ? 'right' : 'left';
239
+ const subject = t.subject(host);
240
+ const featList = features.map((f) => `<li>${_esc(f)}</li>`).join('');
241
+ const html = `<div dir="${dir}" style="font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Arial,sans-serif;max-width:620px;margin:0 auto;background:#0a0e1a;color:#e8eeff;padding:32px;border-radius:14px;text-align:${align};line-height:1.6">
242
+ <div style="text-align:center;margin-bottom:18px"><img src="https://www.webagentbridge.com/images/wab-logo-128.png" alt="WAB" width="64" height="64" style="border-radius:12px"/></div>
243
+ <p style="margin:0 0 14px">${_esc(t.greeting(recipientName))}</p>
244
+ <p style="margin:0 0 14px">${t.intro(_esc(host), _esc(kind))}</p>
245
+ <p style="margin:18px 0 6px;color:#a8b3cf"><b>${_esc(t.why)}</b></p>
246
+ <ul style="margin:0 0 18px;padding-${t.rtl ? 'right' : 'left'}:22px;color:#cfe7ff">${featList}</ul>
247
+ <p style="margin:22px 0"><a href="${_esc(adoptUrl)}" style="display:inline-block;background:linear-gradient(135deg,#7c5cff,#22d3ee);color:#0a0e1a;font-weight:700;padding:12px 22px;border-radius:10px;text-decoration:none">${_esc(t.cta)}</a></p>
248
+ <p style="margin:0 0 6px">${_esc(t.closing)}</p>
249
+ <p style="margin:0 0 18px;color:#a8b3cf">${_esc(t.signature)}<br><a href="https://www.webagentbridge.com" style="color:#22d3ee">webagentbridge.com</a></p>
250
+ <hr style="border:0;border-top:1px solid #1f2a44;margin:18px 0"/>
251
+ <p style="font-size:12px;color:#6a7793;margin:0 0 6px">${_esc(t.footnote)}</p>
252
+ <p style="font-size:12px;color:#6a7793;margin:0"><a href="${_esc(unsubscribeUrl)}" style="color:#6a7793">${_esc(t.unsubscribe)}</a></p>
253
+ </div>`;
254
+ const text = `${t.greeting(recipientName)}\n\n${host} — ${kind}.\n\nWeb Agent Bridge (WAB) — open AI↔Web protocol.\n\n${t.why}\n${features.map((f) => ' • ' + f).join('\n')}\n\n${t.cta}: ${adoptUrl}\n\n${t.closing}\n${t.signature}\nhttps://www.webagentbridge.com\n\n${t.footnote}\n${t.unsubscribe}: ${unsubscribeUrl}\n`;
255
+ return { subject, html, text, lang, dir };
256
+ }
257
+
258
+ // ─── Public API ───────────────────────────────────────────────────────
259
+
260
+ /**
261
+ * Analyze a single URL and return a draft outreach package (no email sent).
262
+ *
263
+ * @param {string} siteUrl
264
+ * @param {object} [opts]
265
+ * @returns {Promise<object>}
266
+ */
267
+ async function analyzeSite(siteUrl, opts = {}) {
268
+ if (!siteUrl) return { ok: false, error: 'missing url' };
269
+ if (!/^https?:\/\//i.test(siteUrl)) siteUrl = `https://${siteUrl}`;
270
+ let host, baseUrl;
271
+ try { const u = new URL(siteUrl); host = u.hostname; baseUrl = `${u.protocol}//${u.hostname}`; }
272
+ catch { return { ok: false, error: 'invalid url' }; }
273
+
274
+ const env = await discover(baseUrl, { timeoutMs: opts.timeoutMs || FETCH_TIMEOUT });
275
+ const root = await _fetch(baseUrl, { timeoutMs: 6000 });
276
+ const html = (root && root.body) || '';
277
+ const lang = _detectLang(env, html);
278
+ const { kind, signals } = _detectKind(env, html);
279
+ const features = _suggestFeatures(kind, env);
280
+ const contact = await _findContactEmail(baseUrl);
281
+ const tlsFp = await _tlsFp(host);
282
+ const unsubToken = crypto.randomBytes(16).toString('hex');
283
+ const publicBase = opts.publicBase || 'https://www.webagentbridge.com';
284
+ const unsubscribeUrl = `${publicBase}/unsubscribe?token=${unsubToken}`;
285
+ const adoptUrl = `${publicBase}/adopt?url=${encodeURIComponent(baseUrl)}`;
286
+ const draft = _composeEmail({
287
+ host, kind, lang, features,
288
+ recipientName: '',
289
+ unsubscribeUrl, adoptUrl
290
+ });
291
+
292
+ return {
293
+ ok: true,
294
+ site_url: baseUrl,
295
+ host,
296
+ contact_email: contact ? contact.email : null,
297
+ contact_source: contact ? contact.source : null,
298
+ detected_lang: lang,
299
+ site_kind: kind,
300
+ signals,
301
+ suggested_features: features,
302
+ tls_fingerprint: tlsFp,
303
+ unsubscribe_token: unsubToken,
304
+ draft
305
+ };
306
+ }
307
+
308
+ module.exports = {
309
+ analyzeSite,
310
+ // exported for the route + tests
311
+ _detectLang, _detectKind, _suggestFeatures, _composeEmail, SUPPORTED_LANGS
312
+ };