web-agent-bridge 3.2.0 → 3.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (202) hide show
  1. package/LICENSE +72 -72
  2. package/README.ar.md +1286 -1152
  3. package/README.md +1764 -1635
  4. package/bin/agent-runner.js +474 -474
  5. package/bin/cli.js +237 -138
  6. package/bin/wab.js +80 -80
  7. package/examples/bidi-agent.js +119 -119
  8. package/examples/cross-site-agent.js +91 -91
  9. package/examples/mcp-agent.js +94 -94
  10. package/examples/next-app-router/README.md +44 -44
  11. package/examples/puppeteer-agent.js +108 -108
  12. package/examples/saas-dashboard/README.md +55 -55
  13. package/examples/shopify-hydrogen/README.md +74 -74
  14. package/examples/vision-agent.js +171 -171
  15. package/examples/wordpress-elementor/README.md +77 -77
  16. package/package.json +16 -3
  17. package/public/.well-known/agent-tools.json +180 -180
  18. package/public/.well-known/ai-assets.json +59 -59
  19. package/public/.well-known/security.txt +8 -0
  20. package/public/agent-workspace.html +349 -349
  21. package/public/ai.html +198 -198
  22. package/public/api.html +413 -412
  23. package/public/browser.html +486 -486
  24. package/public/commander-dashboard.html +243 -243
  25. package/public/cookies.html +210 -210
  26. package/public/css/agent-workspace.css +1713 -1713
  27. package/public/css/premium.css +317 -317
  28. package/public/css/styles.css +1235 -1235
  29. package/public/dashboard.html +706 -706
  30. package/public/dns.html +507 -0
  31. package/public/docs.html +587 -587
  32. package/public/feed.xml +89 -89
  33. package/public/growth.html +463 -463
  34. package/public/index.html +1070 -982
  35. package/public/integrations.html +556 -0
  36. package/public/js/agent-workspace.js +1740 -1740
  37. package/public/js/auth-nav.js +31 -31
  38. package/public/js/auth-redirect.js +12 -12
  39. package/public/js/cookie-consent.js +56 -56
  40. package/public/js/wab-demo-page.js +721 -721
  41. package/public/js/ws-client.js +74 -74
  42. package/public/llms-full.txt +360 -360
  43. package/public/llms.txt +125 -125
  44. package/public/login.html +85 -85
  45. package/public/mesh-dashboard.html +328 -328
  46. package/public/openapi.json +580 -580
  47. package/public/phone-shield.html +281 -0
  48. package/public/premium-dashboard.html +2489 -2489
  49. package/public/premium.html +793 -793
  50. package/public/privacy.html +297 -297
  51. package/public/register.html +105 -105
  52. package/public/robots.txt +87 -87
  53. package/public/script/wab-consent.d.ts +36 -36
  54. package/public/script/wab-consent.js +104 -104
  55. package/public/script/wab-schema.js +131 -131
  56. package/public/script/wab.d.ts +108 -108
  57. package/public/script/wab.min.js +580 -580
  58. package/public/security.txt +8 -0
  59. package/public/terms.html +256 -256
  60. package/script/ai-agent-bridge.js +1754 -1754
  61. package/sdk/README.md +99 -99
  62. package/sdk/agent-mesh.js +449 -449
  63. package/sdk/commander.js +262 -262
  64. package/sdk/index.d.ts +464 -464
  65. package/sdk/index.js +12 -1
  66. package/sdk/multi-agent.js +318 -318
  67. package/sdk/package.json +1 -1
  68. package/sdk/safety-shield.js +219 -0
  69. package/sdk/schema-discovery.js +83 -83
  70. package/server/adapters/index.js +520 -520
  71. package/server/config/plans.js +367 -367
  72. package/server/config/secrets.js +102 -102
  73. package/server/control-plane/index.js +301 -301
  74. package/server/data-plane/index.js +354 -354
  75. package/server/index.js +531 -427
  76. package/server/llm/index.js +404 -404
  77. package/server/middleware/adminAuth.js +35 -35
  78. package/server/middleware/auth.js +50 -50
  79. package/server/middleware/featureGate.js +88 -88
  80. package/server/middleware/rateLimits.js +100 -100
  81. package/server/middleware/sensitiveAction.js +157 -0
  82. package/server/migrations/001_add_analytics_indexes.sql +7 -7
  83. package/server/migrations/002_premium_features.sql +418 -418
  84. package/server/migrations/003_ads_integer_cents.sql +33 -33
  85. package/server/migrations/004_agent_os.sql +158 -158
  86. package/server/migrations/005_marketplace_metering.sql +126 -126
  87. package/server/models/adapters/index.js +33 -33
  88. package/server/models/adapters/mysql.js +183 -183
  89. package/server/models/adapters/postgresql.js +172 -172
  90. package/server/models/adapters/sqlite.js +7 -7
  91. package/server/models/db.js +681 -681
  92. package/server/observability/failure-analysis.js +337 -337
  93. package/server/observability/index.js +394 -394
  94. package/server/protocol/capabilities.js +223 -223
  95. package/server/protocol/index.js +243 -243
  96. package/server/protocol/schema.js +584 -584
  97. package/server/registry/certification.js +271 -271
  98. package/server/registry/index.js +326 -326
  99. package/server/routes/admin-premium.js +671 -671
  100. package/server/routes/admin.js +261 -261
  101. package/server/routes/ads.js +130 -130
  102. package/server/routes/agent-workspace.js +540 -540
  103. package/server/routes/api.js +150 -150
  104. package/server/routes/auth.js +71 -71
  105. package/server/routes/billing.js +45 -45
  106. package/server/routes/commander.js +316 -316
  107. package/server/routes/demo-showcase.js +332 -332
  108. package/server/routes/demo-store.js +154 -0
  109. package/server/routes/discovery.js +417 -417
  110. package/server/routes/gateway.js +173 -157
  111. package/server/routes/license.js +251 -240
  112. package/server/routes/mesh.js +469 -469
  113. package/server/routes/noscript.js +543 -543
  114. package/server/routes/premium-v2.js +686 -686
  115. package/server/routes/premium.js +724 -724
  116. package/server/routes/runtime.js +2148 -2147
  117. package/server/routes/sovereign.js +465 -385
  118. package/server/routes/universal.js +200 -185
  119. package/server/routes/wab-api.js +850 -501
  120. package/server/runtime/container-worker.js +111 -111
  121. package/server/runtime/container.js +448 -448
  122. package/server/runtime/distributed-worker.js +362 -362
  123. package/server/runtime/event-bus.js +210 -210
  124. package/server/runtime/index.js +253 -253
  125. package/server/runtime/queue.js +599 -599
  126. package/server/runtime/replay.js +666 -666
  127. package/server/runtime/sandbox.js +266 -266
  128. package/server/runtime/scheduler.js +534 -534
  129. package/server/runtime/session-engine.js +293 -293
  130. package/server/runtime/state-manager.js +188 -188
  131. package/server/security/cross-site-redactor.js +196 -0
  132. package/server/security/dry-run.js +180 -0
  133. package/server/security/human-gate-rate-limit.js +147 -0
  134. package/server/security/human-gate-transports.js +178 -0
  135. package/server/security/human-gate.js +281 -0
  136. package/server/security/index.js +368 -368
  137. package/server/security/intent-engine.js +245 -0
  138. package/server/security/reward-guard.js +171 -0
  139. package/server/security/rollback-store.js +239 -0
  140. package/server/security/token-scope.js +404 -0
  141. package/server/security/url-policy.js +139 -0
  142. package/server/services/agent-chat.js +506 -506
  143. package/server/services/agent-learning.js +601 -575
  144. package/server/services/agent-memory.js +625 -625
  145. package/server/services/agent-mesh.js +555 -539
  146. package/server/services/agent-symphony.js +717 -717
  147. package/server/services/agent-tasks.js +1807 -1807
  148. package/server/services/api-key-engine.js +292 -261
  149. package/server/services/cluster.js +894 -894
  150. package/server/services/commander.js +738 -738
  151. package/server/services/edge-compute.js +440 -440
  152. package/server/services/email.js +204 -204
  153. package/server/services/hosted-runtime.js +205 -205
  154. package/server/services/lfd.js +635 -635
  155. package/server/services/local-ai.js +389 -389
  156. package/server/services/marketplace.js +270 -270
  157. package/server/services/metering.js +182 -182
  158. package/server/services/modules/affiliate-intelligence.js +93 -93
  159. package/server/services/modules/agent-firewall.js +90 -90
  160. package/server/services/modules/bounty.js +89 -89
  161. package/server/services/modules/collective-bargaining.js +92 -92
  162. package/server/services/modules/dark-pattern.js +66 -66
  163. package/server/services/modules/gov-intelligence.js +45 -45
  164. package/server/services/modules/neural.js +55 -55
  165. package/server/services/modules/notary.js +49 -49
  166. package/server/services/modules/price-time-machine.js +86 -86
  167. package/server/services/modules/protocol.js +104 -104
  168. package/server/services/negotiation.js +439 -439
  169. package/server/services/plugins.js +771 -771
  170. package/server/services/price-intelligence.js +566 -566
  171. package/server/services/price-shield.js +1137 -1137
  172. package/server/services/reputation.js +465 -465
  173. package/server/services/search-engine.js +357 -357
  174. package/server/services/security.js +513 -513
  175. package/server/services/self-healing.js +843 -843
  176. package/server/services/sovereign-shield.js +542 -0
  177. package/server/services/stripe.js +192 -192
  178. package/server/services/swarm.js +788 -788
  179. package/server/services/universal-scraper.js +662 -661
  180. package/server/services/verification.js +481 -481
  181. package/server/services/vision.js +1163 -1163
  182. package/server/utils/cache.js +125 -125
  183. package/server/utils/migrate.js +81 -81
  184. package/server/utils/safe-fetch.js +228 -0
  185. package/server/utils/secureFields.js +50 -50
  186. package/server/ws.js +161 -161
  187. package/templates/artisan-marketplace.yaml +104 -104
  188. package/templates/book-price-scout.yaml +98 -98
  189. package/templates/electronics-price-tracker.yaml +108 -108
  190. package/templates/flight-deal-hunter.yaml +113 -113
  191. package/templates/freelancer-direct.yaml +116 -116
  192. package/templates/grocery-price-compare.yaml +93 -93
  193. package/templates/hotel-direct-booking.yaml +113 -113
  194. package/templates/local-services.yaml +98 -98
  195. package/templates/olive-oil-tunisia.yaml +88 -88
  196. package/templates/organic-farm-fresh.yaml +101 -101
  197. package/templates/restaurant-direct.yaml +97 -97
  198. package/public/score.html +0 -263
  199. package/server/migrations/006_growth_suite.sql +0 -138
  200. package/server/routes/growth.js +0 -962
  201. package/server/services/fairness-engine.js +0 -409
  202. package/server/services/fairness.js +0 -420
@@ -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 };