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
@@ -1,362 +1,362 @@
1
- 'use strict';
2
-
3
- /**
4
- * WAB Distributed Worker — Standalone Worker Process
5
- *
6
- * Runs as an independent process/machine that:
7
- * 1. Registers with the Coordinator (WAB server)
8
- * 2. Pulls tasks from the queue
9
- * 3. Executes tasks in containers (process isolation)
10
- * 4. Reports results back
11
- * 5. Sends periodic heartbeats
12
- *
13
- * Usage:
14
- * node distributed-worker.js --coordinator=https://wab.example.com --name=worker-1
15
- *
16
- * Or programmatically:
17
- * const { DistributedWorker } = require('./distributed-worker');
18
- * const worker = new DistributedWorker({ coordinatorUrl: '...', name: '...' });
19
- * await worker.start();
20
- */
21
-
22
- const crypto = require('crypto');
23
- const http = require('http');
24
- const https = require('https');
25
- const { URL } = require('url');
26
- const os = require('os');
27
- const { bus } = require('./event-bus');
28
-
29
- class DistributedWorker {
30
- constructor(options = {}) {
31
- this.coordinatorUrl = (options.coordinatorUrl || process.env.WAB_COORDINATOR_URL || 'http://localhost:3000').replace(/\/$/, '');
32
- this.name = options.name || `worker-${os.hostname()}-${process.pid}`;
33
- this.region = options.region || process.env.WAB_REGION || 'default';
34
- this.zone = options.zone || process.env.WAB_ZONE || 'a';
35
- this.capacity = options.capacity || parseInt(process.env.WAB_WORKER_CAPACITY) || 10;
36
- this.tags = options.tags || (process.env.WAB_WORKER_TAGS || '').split(',').filter(Boolean);
37
- this.pollInterval = options.pollInterval || 5000;
38
- this.heartbeatInterval = options.heartbeatInterval || 30000;
39
- this.useContainers = options.useContainers !== false;
40
- this.listenPort = options.listenPort || 0; // 0 = auto
41
-
42
- this.nodeId = null;
43
- this._running = new Map(); // taskId → { task, startedAt }
44
- this._handlers = new Map(); // taskType → handler function
45
- this._started = false;
46
- this._pollTimer = null;
47
- this._heartbeatTimer = null;
48
- this._server = null;
49
- this._stats = { executed: 0, succeeded: 0, failed: 0 };
50
- this._containerRunner = null;
51
- }
52
-
53
- // ─── Lifecycle ──────────────────────────────────────────────────────
54
-
55
- /**
56
- * Start the worker — register, start polling, start heartbeat
57
- */
58
- async start() {
59
- if (this._started) return;
60
-
61
- // Optionally load container runner
62
- if (this.useContainers) {
63
- try {
64
- const { containerRunner } = require('./container');
65
- this._containerRunner = containerRunner;
66
- } catch {
67
- this.useContainers = false;
68
- }
69
- }
70
-
71
- // Start push notification server
72
- await this._startNotificationServer();
73
-
74
- // Register with coordinator
75
- const endpoint = `http://${this._getLocalIP()}:${this._actualPort}`;
76
- const reg = await this._post('/api/os/cluster/nodes', {
77
- name: this.name,
78
- endpoint,
79
- region: this.region,
80
- zone: this.zone,
81
- capacity: this.capacity,
82
- tags: this.tags,
83
- hardware: this._getHardware(),
84
- version: require('../../package.json').version,
85
- });
86
-
87
- this.nodeId = reg.nodeId;
88
- this._started = true;
89
-
90
- // Start polling for tasks
91
- this._pollTimer = setInterval(() => this._poll(), this.pollInterval);
92
-
93
- // Start heartbeat
94
- this._heartbeatTimer = setInterval(() => this._heartbeat(), this.heartbeatInterval);
95
-
96
- console.log(`[Worker] ${this.name} registered as ${this.nodeId} at ${endpoint}`);
97
- console.log(`[Worker] Coordinator: ${this.coordinatorUrl}, Region: ${this.region}, Capacity: ${this.capacity}`);
98
-
99
- bus.emit('worker.started', { nodeId: this.nodeId, name: this.name });
100
- return { nodeId: this.nodeId, name: this.name };
101
- }
102
-
103
- /**
104
- * Stop the worker gracefully — finish running tasks, deregister
105
- */
106
- async stop() {
107
- if (!this._started) return;
108
- this._started = false;
109
-
110
- if (this._pollTimer) clearInterval(this._pollTimer);
111
- if (this._heartbeatTimer) clearInterval(this._heartbeatTimer);
112
-
113
- // Wait for running tasks to complete (with timeout)
114
- if (this._running.size > 0) {
115
- console.log(`[Worker] Waiting for ${this._running.size} running tasks...`);
116
- const deadline = Date.now() + 30000;
117
- while (this._running.size > 0 && Date.now() < deadline) {
118
- await new Promise(r => setTimeout(r, 1000));
119
- }
120
- }
121
-
122
- // Deregister
123
- if (this.nodeId) {
124
- try {
125
- await this._delete(`/api/os/cluster/nodes/${this.nodeId}`);
126
- } catch {}
127
- }
128
-
129
- if (this._server) {
130
- this._server.close();
131
- }
132
-
133
- console.log(`[Worker] ${this.name} stopped. Executed: ${this._stats.executed}`);
134
- bus.emit('worker.stopped', { nodeId: this.nodeId, stats: this._stats });
135
- }
136
-
137
- /**
138
- * Register a task type handler
139
- */
140
- registerHandler(taskType, handler) {
141
- this._handlers.set(taskType, handler);
142
- }
143
-
144
- // ─── Task Execution ─────────────────────────────────────────────────
145
-
146
- /**
147
- * Execute a task
148
- */
149
- async _executeTask(task) {
150
- const taskId = task.taskId;
151
- this._running.set(taskId, { task, startedAt: Date.now() });
152
- this._stats.executed++;
153
-
154
- // Report started
155
- try {
156
- await this._post(`/api/os/cluster/tasks/${taskId}/started`, {});
157
- } catch {}
158
-
159
- try {
160
- let result;
161
- const handler = this._handlers.get(task.type);
162
-
163
- if (handler) {
164
- // Use registered handler
165
- result = await handler(task.params, {
166
- taskId,
167
- type: task.type,
168
- objective: task.objective,
169
- priority: task.priority,
170
- timeout: task.timeout,
171
- nodeId: this.nodeId,
172
- workerName: this.name,
173
- });
174
- } else if (this._containerRunner && typeof task.params === 'object' && task.params._code) {
175
- // Execute in container isolation
176
- const containerResult = await this._containerRunner.runInProcess(taskId, task.params._code, {
177
- params: task.params,
178
- timeout: task.timeout || 60000,
179
- maxMemory: task.params._maxMemory || 256 * 1024 * 1024,
180
- });
181
- result = containerResult.success ? containerResult.result : { error: containerResult.error };
182
- if (!containerResult.success) throw new Error(containerResult.error);
183
- } else {
184
- // Default: return params as acknowledgment
185
- result = { received: true, type: task.type, params: task.params };
186
- }
187
-
188
- // Report completed
189
- await this._post(`/api/os/cluster/tasks/${taskId}/completed`, { result });
190
- this._stats.succeeded++;
191
- bus.emit('worker.task.completed', { taskId, nodeId: this.nodeId });
192
- } catch (err) {
193
- // Report failed
194
- try {
195
- await this._post(`/api/os/cluster/tasks/${taskId}/failed`, { error: err.message });
196
- } catch {}
197
- this._stats.failed++;
198
- bus.emit('worker.task.failed', { taskId, nodeId: this.nodeId, error: err.message });
199
- } finally {
200
- this._running.delete(taskId);
201
- }
202
- }
203
-
204
- // ─── Polling ────────────────────────────────────────────────────────
205
-
206
- async _poll() {
207
- if (!this._started || !this.nodeId) return;
208
-
209
- const available = this.capacity - this._running.size;
210
- if (available <= 0) return;
211
-
212
- try {
213
- const response = await this._post(`/api/os/cluster/nodes/${this.nodeId}/pull`, {
214
- limit: Math.min(available, 5),
215
- });
216
-
217
- if (response.tasks && response.tasks.length > 0) {
218
- for (const task of response.tasks) {
219
- // Execute each task concurrently
220
- this._executeTask(task).catch(() => {});
221
- }
222
- }
223
- } catch (err) {
224
- // Coordinator unreachable — will retry on next poll
225
- }
226
- }
227
-
228
- // ─── Heartbeat ──────────────────────────────────────────────────────
229
-
230
- async _heartbeat() {
231
- if (!this._started || !this.nodeId) return;
232
-
233
- try {
234
- await this._post(`/api/os/cluster/nodes/${this.nodeId}/heartbeat`, {
235
- capacityUsed: this._running.size,
236
- capacityTotal: this.capacity,
237
- hardware: this._getHardware(),
238
- version: require('../../package.json').version,
239
- });
240
- } catch {
241
- // Will retry next interval
242
- }
243
- }
244
-
245
- // ─── Push Notification Server ───────────────────────────────────────
246
-
247
- async _startNotificationServer() {
248
- return new Promise((resolve) => {
249
- this._server = http.createServer((req, res) => {
250
- if (req.method === 'POST' && req.url === '/wab-worker/tasks/notify') {
251
- let body = '';
252
- req.on('data', d => { body += d; if (body.length > 1024 * 1024) req.destroy(); });
253
- req.on('end', () => {
254
- try {
255
- const msg = JSON.parse(body);
256
- if (msg.type === 'task.assigned' && msg.taskId) {
257
- // Start executing the pushed task
258
- this._executeTask({
259
- taskId: msg.taskId,
260
- type: msg.taskType,
261
- objective: msg.objective,
262
- params: msg.params,
263
- priority: msg.priority,
264
- timeout: msg.timeout,
265
- }).catch(() => {});
266
- }
267
- res.writeHead(200, { 'Content-Type': 'application/json' });
268
- res.end('{"ok":true}');
269
- } catch {
270
- res.writeHead(400);
271
- res.end('{"error":"bad request"}');
272
- }
273
- });
274
- } else if (req.method === 'GET' && req.url === '/health') {
275
- res.writeHead(200, { 'Content-Type': 'application/json' });
276
- res.end(JSON.stringify({
277
- nodeId: this.nodeId,
278
- name: this.name,
279
- running: this._running.size,
280
- capacity: this.capacity,
281
- stats: this._stats,
282
- }));
283
- } else {
284
- res.writeHead(404);
285
- res.end('{"error":"not found"}');
286
- }
287
- });
288
-
289
- this._server.listen(this.listenPort, () => {
290
- this._actualPort = this._server.address().port;
291
- resolve();
292
- });
293
- });
294
- }
295
-
296
- // ─── HTTP Helpers ───────────────────────────────────────────────────
297
-
298
- _post(path, data) {
299
- return this._request('POST', path, data);
300
- }
301
-
302
- _delete(path) {
303
- return this._request('DELETE', path);
304
- }
305
-
306
- _request(method, urlPath, data) {
307
- return new Promise((resolve, reject) => {
308
- const url = new URL(urlPath, this.coordinatorUrl);
309
- const mod = url.protocol === 'https:' ? https : http;
310
- const payload = data ? JSON.stringify(data) : null;
311
-
312
- const req = mod.request(url, {
313
- method,
314
- headers: {
315
- 'Content-Type': 'application/json',
316
- ...(payload ? { 'Content-Length': Buffer.byteLength(payload) } : {}),
317
- 'X-WAB-Worker': this.nodeId || this.name,
318
- },
319
- timeout: 10000,
320
- }, (res) => {
321
- let body = '';
322
- res.on('data', d => body += d);
323
- res.on('end', () => {
324
- try {
325
- resolve(JSON.parse(body));
326
- } catch {
327
- resolve({ raw: body });
328
- }
329
- });
330
- });
331
-
332
- req.on('error', reject);
333
- req.on('timeout', () => { req.destroy(); reject(new Error('Request timeout')); });
334
- if (payload) req.write(payload);
335
- req.end();
336
- });
337
- }
338
-
339
- _getLocalIP() {
340
- const ifaces = os.networkInterfaces();
341
- for (const name of Object.keys(ifaces)) {
342
- for (const iface of ifaces[name]) {
343
- if (iface.family === 'IPv4' && !iface.internal) return iface.address;
344
- }
345
- }
346
- return '127.0.0.1';
347
- }
348
-
349
- _getHardware() {
350
- return {
351
- cpus: os.cpus().length,
352
- totalMemory: os.totalmem(),
353
- freeMemory: os.freemem(),
354
- platform: os.platform(),
355
- arch: os.arch(),
356
- uptime: os.uptime(),
357
- loadAvg: os.loadavg(),
358
- };
359
- }
360
- }
361
-
362
- module.exports = { DistributedWorker };
1
+ 'use strict';
2
+
3
+ /**
4
+ * WAB Distributed Worker — Standalone Worker Process
5
+ *
6
+ * Runs as an independent process/machine that:
7
+ * 1. Registers with the Coordinator (WAB server)
8
+ * 2. Pulls tasks from the queue
9
+ * 3. Executes tasks in containers (process isolation)
10
+ * 4. Reports results back
11
+ * 5. Sends periodic heartbeats
12
+ *
13
+ * Usage:
14
+ * node distributed-worker.js --coordinator=https://wab.example.com --name=worker-1
15
+ *
16
+ * Or programmatically:
17
+ * const { DistributedWorker } = require('./distributed-worker');
18
+ * const worker = new DistributedWorker({ coordinatorUrl: '...', name: '...' });
19
+ * await worker.start();
20
+ */
21
+
22
+ const crypto = require('crypto');
23
+ const http = require('http');
24
+ const https = require('https');
25
+ const { URL } = require('url');
26
+ const os = require('os');
27
+ const { bus } = require('./event-bus');
28
+
29
+ class DistributedWorker {
30
+ constructor(options = {}) {
31
+ this.coordinatorUrl = (options.coordinatorUrl || process.env.WAB_COORDINATOR_URL || 'http://localhost:3000').replace(/\/$/, '');
32
+ this.name = options.name || `worker-${os.hostname()}-${process.pid}`;
33
+ this.region = options.region || process.env.WAB_REGION || 'default';
34
+ this.zone = options.zone || process.env.WAB_ZONE || 'a';
35
+ this.capacity = options.capacity || parseInt(process.env.WAB_WORKER_CAPACITY) || 10;
36
+ this.tags = options.tags || (process.env.WAB_WORKER_TAGS || '').split(',').filter(Boolean);
37
+ this.pollInterval = options.pollInterval || 5000;
38
+ this.heartbeatInterval = options.heartbeatInterval || 30000;
39
+ this.useContainers = options.useContainers !== false;
40
+ this.listenPort = options.listenPort || 0; // 0 = auto
41
+
42
+ this.nodeId = null;
43
+ this._running = new Map(); // taskId → { task, startedAt }
44
+ this._handlers = new Map(); // taskType → handler function
45
+ this._started = false;
46
+ this._pollTimer = null;
47
+ this._heartbeatTimer = null;
48
+ this._server = null;
49
+ this._stats = { executed: 0, succeeded: 0, failed: 0 };
50
+ this._containerRunner = null;
51
+ }
52
+
53
+ // ─── Lifecycle ──────────────────────────────────────────────────────
54
+
55
+ /**
56
+ * Start the worker — register, start polling, start heartbeat
57
+ */
58
+ async start() {
59
+ if (this._started) return;
60
+
61
+ // Optionally load container runner
62
+ if (this.useContainers) {
63
+ try {
64
+ const { containerRunner } = require('./container');
65
+ this._containerRunner = containerRunner;
66
+ } catch {
67
+ this.useContainers = false;
68
+ }
69
+ }
70
+
71
+ // Start push notification server
72
+ await this._startNotificationServer();
73
+
74
+ // Register with coordinator
75
+ const endpoint = `http://${this._getLocalIP()}:${this._actualPort}`;
76
+ const reg = await this._post('/api/os/cluster/nodes', {
77
+ name: this.name,
78
+ endpoint,
79
+ region: this.region,
80
+ zone: this.zone,
81
+ capacity: this.capacity,
82
+ tags: this.tags,
83
+ hardware: this._getHardware(),
84
+ version: require('../../package.json').version,
85
+ });
86
+
87
+ this.nodeId = reg.nodeId;
88
+ this._started = true;
89
+
90
+ // Start polling for tasks
91
+ this._pollTimer = setInterval(() => this._poll(), this.pollInterval);
92
+
93
+ // Start heartbeat
94
+ this._heartbeatTimer = setInterval(() => this._heartbeat(), this.heartbeatInterval);
95
+
96
+ console.log(`[Worker] ${this.name} registered as ${this.nodeId} at ${endpoint}`);
97
+ console.log(`[Worker] Coordinator: ${this.coordinatorUrl}, Region: ${this.region}, Capacity: ${this.capacity}`);
98
+
99
+ bus.emit('worker.started', { nodeId: this.nodeId, name: this.name });
100
+ return { nodeId: this.nodeId, name: this.name };
101
+ }
102
+
103
+ /**
104
+ * Stop the worker gracefully — finish running tasks, deregister
105
+ */
106
+ async stop() {
107
+ if (!this._started) return;
108
+ this._started = false;
109
+
110
+ if (this._pollTimer) clearInterval(this._pollTimer);
111
+ if (this._heartbeatTimer) clearInterval(this._heartbeatTimer);
112
+
113
+ // Wait for running tasks to complete (with timeout)
114
+ if (this._running.size > 0) {
115
+ console.log(`[Worker] Waiting for ${this._running.size} running tasks...`);
116
+ const deadline = Date.now() + 30000;
117
+ while (this._running.size > 0 && Date.now() < deadline) {
118
+ await new Promise(r => setTimeout(r, 1000));
119
+ }
120
+ }
121
+
122
+ // Deregister
123
+ if (this.nodeId) {
124
+ try {
125
+ await this._delete(`/api/os/cluster/nodes/${this.nodeId}`);
126
+ } catch {}
127
+ }
128
+
129
+ if (this._server) {
130
+ this._server.close();
131
+ }
132
+
133
+ console.log(`[Worker] ${this.name} stopped. Executed: ${this._stats.executed}`);
134
+ bus.emit('worker.stopped', { nodeId: this.nodeId, stats: this._stats });
135
+ }
136
+
137
+ /**
138
+ * Register a task type handler
139
+ */
140
+ registerHandler(taskType, handler) {
141
+ this._handlers.set(taskType, handler);
142
+ }
143
+
144
+ // ─── Task Execution ─────────────────────────────────────────────────
145
+
146
+ /**
147
+ * Execute a task
148
+ */
149
+ async _executeTask(task) {
150
+ const taskId = task.taskId;
151
+ this._running.set(taskId, { task, startedAt: Date.now() });
152
+ this._stats.executed++;
153
+
154
+ // Report started
155
+ try {
156
+ await this._post(`/api/os/cluster/tasks/${taskId}/started`, {});
157
+ } catch {}
158
+
159
+ try {
160
+ let result;
161
+ const handler = this._handlers.get(task.type);
162
+
163
+ if (handler) {
164
+ // Use registered handler
165
+ result = await handler(task.params, {
166
+ taskId,
167
+ type: task.type,
168
+ objective: task.objective,
169
+ priority: task.priority,
170
+ timeout: task.timeout,
171
+ nodeId: this.nodeId,
172
+ workerName: this.name,
173
+ });
174
+ } else if (this._containerRunner && typeof task.params === 'object' && task.params._code) {
175
+ // Execute in container isolation
176
+ const containerResult = await this._containerRunner.runInProcess(taskId, task.params._code, {
177
+ params: task.params,
178
+ timeout: task.timeout || 60000,
179
+ maxMemory: task.params._maxMemory || 256 * 1024 * 1024,
180
+ });
181
+ result = containerResult.success ? containerResult.result : { error: containerResult.error };
182
+ if (!containerResult.success) throw new Error(containerResult.error);
183
+ } else {
184
+ // Default: return params as acknowledgment
185
+ result = { received: true, type: task.type, params: task.params };
186
+ }
187
+
188
+ // Report completed
189
+ await this._post(`/api/os/cluster/tasks/${taskId}/completed`, { result });
190
+ this._stats.succeeded++;
191
+ bus.emit('worker.task.completed', { taskId, nodeId: this.nodeId });
192
+ } catch (err) {
193
+ // Report failed
194
+ try {
195
+ await this._post(`/api/os/cluster/tasks/${taskId}/failed`, { error: err.message });
196
+ } catch {}
197
+ this._stats.failed++;
198
+ bus.emit('worker.task.failed', { taskId, nodeId: this.nodeId, error: err.message });
199
+ } finally {
200
+ this._running.delete(taskId);
201
+ }
202
+ }
203
+
204
+ // ─── Polling ────────────────────────────────────────────────────────
205
+
206
+ async _poll() {
207
+ if (!this._started || !this.nodeId) return;
208
+
209
+ const available = this.capacity - this._running.size;
210
+ if (available <= 0) return;
211
+
212
+ try {
213
+ const response = await this._post(`/api/os/cluster/nodes/${this.nodeId}/pull`, {
214
+ limit: Math.min(available, 5),
215
+ });
216
+
217
+ if (response.tasks && response.tasks.length > 0) {
218
+ for (const task of response.tasks) {
219
+ // Execute each task concurrently
220
+ this._executeTask(task).catch(() => {});
221
+ }
222
+ }
223
+ } catch (err) {
224
+ // Coordinator unreachable — will retry on next poll
225
+ }
226
+ }
227
+
228
+ // ─── Heartbeat ──────────────────────────────────────────────────────
229
+
230
+ async _heartbeat() {
231
+ if (!this._started || !this.nodeId) return;
232
+
233
+ try {
234
+ await this._post(`/api/os/cluster/nodes/${this.nodeId}/heartbeat`, {
235
+ capacityUsed: this._running.size,
236
+ capacityTotal: this.capacity,
237
+ hardware: this._getHardware(),
238
+ version: require('../../package.json').version,
239
+ });
240
+ } catch {
241
+ // Will retry next interval
242
+ }
243
+ }
244
+
245
+ // ─── Push Notification Server ───────────────────────────────────────
246
+
247
+ async _startNotificationServer() {
248
+ return new Promise((resolve) => {
249
+ this._server = http.createServer((req, res) => {
250
+ if (req.method === 'POST' && req.url === '/wab-worker/tasks/notify') {
251
+ let body = '';
252
+ req.on('data', d => { body += d; if (body.length > 1024 * 1024) req.destroy(); });
253
+ req.on('end', () => {
254
+ try {
255
+ const msg = JSON.parse(body);
256
+ if (msg.type === 'task.assigned' && msg.taskId) {
257
+ // Start executing the pushed task
258
+ this._executeTask({
259
+ taskId: msg.taskId,
260
+ type: msg.taskType,
261
+ objective: msg.objective,
262
+ params: msg.params,
263
+ priority: msg.priority,
264
+ timeout: msg.timeout,
265
+ }).catch(() => {});
266
+ }
267
+ res.writeHead(200, { 'Content-Type': 'application/json' });
268
+ res.end('{"ok":true}');
269
+ } catch {
270
+ res.writeHead(400);
271
+ res.end('{"error":"bad request"}');
272
+ }
273
+ });
274
+ } else if (req.method === 'GET' && req.url === '/health') {
275
+ res.writeHead(200, { 'Content-Type': 'application/json' });
276
+ res.end(JSON.stringify({
277
+ nodeId: this.nodeId,
278
+ name: this.name,
279
+ running: this._running.size,
280
+ capacity: this.capacity,
281
+ stats: this._stats,
282
+ }));
283
+ } else {
284
+ res.writeHead(404);
285
+ res.end('{"error":"not found"}');
286
+ }
287
+ });
288
+
289
+ this._server.listen(this.listenPort, () => {
290
+ this._actualPort = this._server.address().port;
291
+ resolve();
292
+ });
293
+ });
294
+ }
295
+
296
+ // ─── HTTP Helpers ───────────────────────────────────────────────────
297
+
298
+ _post(path, data) {
299
+ return this._request('POST', path, data);
300
+ }
301
+
302
+ _delete(path) {
303
+ return this._request('DELETE', path);
304
+ }
305
+
306
+ _request(method, urlPath, data) {
307
+ return new Promise((resolve, reject) => {
308
+ const url = new URL(urlPath, this.coordinatorUrl);
309
+ const mod = url.protocol === 'https:' ? https : http;
310
+ const payload = data ? JSON.stringify(data) : null;
311
+
312
+ const req = mod.request(url, {
313
+ method,
314
+ headers: {
315
+ 'Content-Type': 'application/json',
316
+ ...(payload ? { 'Content-Length': Buffer.byteLength(payload) } : {}),
317
+ 'X-WAB-Worker': this.nodeId || this.name,
318
+ },
319
+ timeout: 10000,
320
+ }, (res) => {
321
+ let body = '';
322
+ res.on('data', d => body += d);
323
+ res.on('end', () => {
324
+ try {
325
+ resolve(JSON.parse(body));
326
+ } catch {
327
+ resolve({ raw: body });
328
+ }
329
+ });
330
+ });
331
+
332
+ req.on('error', reject);
333
+ req.on('timeout', () => { req.destroy(); reject(new Error('Request timeout')); });
334
+ if (payload) req.write(payload);
335
+ req.end();
336
+ });
337
+ }
338
+
339
+ _getLocalIP() {
340
+ const ifaces = os.networkInterfaces();
341
+ for (const name of Object.keys(ifaces)) {
342
+ for (const iface of ifaces[name]) {
343
+ if (iface.family === 'IPv4' && !iface.internal) return iface.address;
344
+ }
345
+ }
346
+ return '127.0.0.1';
347
+ }
348
+
349
+ _getHardware() {
350
+ return {
351
+ cpus: os.cpus().length,
352
+ totalMemory: os.totalmem(),
353
+ freeMemory: os.freemem(),
354
+ platform: os.platform(),
355
+ arch: os.arch(),
356
+ uptime: os.uptime(),
357
+ loadAvg: os.loadavg(),
358
+ };
359
+ }
360
+ }
361
+
362
+ module.exports = { DistributedWorker };