web-agent-bridge 3.2.0 → 3.4.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 (256) hide show
  1. package/LICENSE +84 -72
  2. package/README.ar.md +1304 -1152
  3. package/README.md +298 -1635
  4. package/bin/agent-runner.js +474 -474
  5. package/bin/cli.js +237 -138
  6. package/bin/wab-init.js +223 -0
  7. package/bin/wab.js +80 -80
  8. package/examples/azure-dns-wab.js +83 -0
  9. package/examples/bidi-agent.js +119 -119
  10. package/examples/cloudflare-wab-dns.js +121 -0
  11. package/examples/cpanel-wab-dns.js +114 -0
  12. package/examples/cross-site-agent.js +91 -91
  13. package/examples/dns-discovery-agent.js +166 -0
  14. package/examples/gcp-dns-wab.js +76 -0
  15. package/examples/governance-agent.js +169 -0
  16. package/examples/mcp-agent.js +94 -94
  17. package/examples/next-app-router/README.md +44 -44
  18. package/examples/plesk-wab-dns.js +103 -0
  19. package/examples/puppeteer-agent.js +108 -108
  20. package/examples/route53-wab-dns.js +144 -0
  21. package/examples/saas-dashboard/README.md +55 -55
  22. package/examples/safe-mode-agent.js +96 -0
  23. package/examples/shopify-hydrogen/README.md +74 -74
  24. package/examples/vision-agent.js +171 -171
  25. package/examples/wab-sign.js +74 -0
  26. package/examples/wab-verify.js +60 -0
  27. package/examples/wordpress-elementor/README.md +77 -77
  28. package/package.json +19 -6
  29. package/public/.well-known/agent-tools.json +180 -180
  30. package/public/.well-known/ai-assets.json +59 -59
  31. package/public/.well-known/security.txt +8 -0
  32. package/public/.well-known/wab.json +28 -0
  33. package/public/activate.html +368 -0
  34. package/public/adoption-metrics.html +188 -0
  35. package/public/agent-workspace.html +349 -349
  36. package/public/ai.html +198 -198
  37. package/public/api.html +413 -412
  38. package/public/azure-dns-integration.html +289 -0
  39. package/public/browser.html +486 -486
  40. package/public/cloudflare-integration.html +380 -0
  41. package/public/commander-dashboard.html +243 -243
  42. package/public/cookies.html +210 -210
  43. package/public/cpanel-integration.html +398 -0
  44. package/public/css/agent-workspace.css +1713 -1713
  45. package/public/css/premium.css +317 -317
  46. package/public/css/styles.css +1263 -1235
  47. package/public/dashboard.html +707 -706
  48. package/public/dns.html +436 -0
  49. package/public/docs.html +588 -587
  50. package/public/feed.xml +89 -89
  51. package/public/gcp-dns-integration.html +318 -0
  52. package/public/growth.html +465 -463
  53. package/public/index.html +1266 -982
  54. package/public/integrations.html +556 -0
  55. package/public/js/activate.js +145 -0
  56. package/public/js/agent-workspace.js +1740 -1740
  57. package/public/js/auth-nav.js +65 -31
  58. package/public/js/auth-redirect.js +12 -12
  59. package/public/js/cookie-consent.js +56 -56
  60. package/public/js/dns.js +438 -0
  61. package/public/js/wab-demo-page.js +721 -721
  62. package/public/js/ws-client.js +74 -74
  63. package/public/llms-full.txt +360 -360
  64. package/public/llms.txt +125 -125
  65. package/public/login.html +85 -85
  66. package/public/mesh-dashboard.html +328 -328
  67. package/public/openapi.json +669 -580
  68. package/public/phone-shield.html +281 -0
  69. package/public/plesk-integration.html +375 -0
  70. package/public/premium-dashboard.html +2489 -2489
  71. package/public/premium.html +793 -793
  72. package/public/privacy.html +297 -297
  73. package/public/provider-onboarding.html +172 -0
  74. package/public/provider-sandbox.html +134 -0
  75. package/public/providers.html +359 -0
  76. package/public/register.html +105 -105
  77. package/public/registrar-integrations.html +141 -0
  78. package/public/robots.txt +99 -87
  79. package/public/route53-integration.html +531 -0
  80. package/public/script/wab-consent.d.ts +36 -36
  81. package/public/script/wab-consent.js +104 -104
  82. package/public/script/wab-schema.js +131 -131
  83. package/public/script/wab.d.ts +108 -108
  84. package/public/script/wab.min.js +580 -580
  85. package/public/security.txt +8 -0
  86. package/public/shieldqr.html +231 -0
  87. package/public/sitemap.xml +6 -0
  88. package/public/terms.html +256 -256
  89. package/public/wab-trust.html +200 -0
  90. package/public/wab-vs-protocols.html +210 -0
  91. package/public/whitepaper.html +449 -0
  92. package/script/ai-agent-bridge.js +1754 -1754
  93. package/sdk/README.md +99 -99
  94. package/sdk/agent-mesh.js +449 -449
  95. package/sdk/auto-discovery.js +288 -0
  96. package/sdk/commander.js +262 -262
  97. package/sdk/governance.js +262 -0
  98. package/sdk/index.d.ts +464 -464
  99. package/sdk/index.js +25 -1
  100. package/sdk/multi-agent.js +318 -318
  101. package/sdk/package.json +2 -2
  102. package/sdk/safe-mode.js +221 -0
  103. package/sdk/safety-shield.js +219 -0
  104. package/sdk/schema-discovery.js +83 -83
  105. package/server/adapters/index.js +520 -520
  106. package/server/config/plans.js +367 -367
  107. package/server/config/secrets.js +102 -102
  108. package/server/control-plane/index.js +301 -301
  109. package/server/data-plane/index.js +354 -354
  110. package/server/index.js +670 -427
  111. package/server/llm/index.js +404 -404
  112. package/server/middleware/adminAuth.js +35 -35
  113. package/server/middleware/auth.js +50 -50
  114. package/server/middleware/featureGate.js +88 -88
  115. package/server/middleware/rateLimits.js +100 -100
  116. package/server/middleware/sensitiveAction.js +157 -0
  117. package/server/migrations/001_add_analytics_indexes.sql +7 -7
  118. package/server/migrations/002_premium_features.sql +418 -418
  119. package/server/migrations/003_ads_integer_cents.sql +33 -33
  120. package/server/migrations/004_agent_os.sql +158 -158
  121. package/server/migrations/005_marketplace_metering.sql +126 -126
  122. package/server/migrations/007_governance.sql +106 -0
  123. package/server/migrations/008_plans.sql +144 -0
  124. package/server/migrations/009_shieldqr.sql +30 -0
  125. package/server/migrations/010_extended_trust.sql +33 -0
  126. package/server/models/adapters/index.js +33 -33
  127. package/server/models/adapters/mysql.js +183 -183
  128. package/server/models/adapters/postgresql.js +172 -172
  129. package/server/models/adapters/sqlite.js +7 -7
  130. package/server/models/db.js +740 -681
  131. package/server/observability/failure-analysis.js +337 -337
  132. package/server/observability/index.js +394 -394
  133. package/server/protocol/capabilities.js +223 -223
  134. package/server/protocol/index.js +243 -243
  135. package/server/protocol/schema.js +584 -584
  136. package/server/registry/certification.js +271 -271
  137. package/server/registry/index.js +326 -326
  138. package/server/routes/admin-plans.js +76 -0
  139. package/server/routes/admin-premium.js +673 -671
  140. package/server/routes/admin-shieldqr.js +90 -0
  141. package/server/routes/admin-trust-monitor.js +83 -0
  142. package/server/routes/admin.js +549 -261
  143. package/server/routes/ads.js +130 -130
  144. package/server/routes/agent-workspace.js +540 -540
  145. package/server/routes/api.js +150 -150
  146. package/server/routes/auth.js +71 -71
  147. package/server/routes/billing.js +57 -45
  148. package/server/routes/commander.js +316 -316
  149. package/server/routes/demo-showcase.js +332 -332
  150. package/server/routes/demo-store.js +154 -0
  151. package/server/routes/discovery.js +2348 -417
  152. package/server/routes/gateway.js +173 -157
  153. package/server/routes/governance.js +208 -0
  154. package/server/routes/license.js +251 -240
  155. package/server/routes/mesh.js +469 -469
  156. package/server/routes/noscript.js +543 -543
  157. package/server/routes/plans.js +33 -0
  158. package/server/routes/premium-v2.js +686 -686
  159. package/server/routes/premium.js +724 -724
  160. package/server/routes/providers.js +650 -0
  161. package/server/routes/runtime.js +2148 -2147
  162. package/server/routes/shieldqr.js +88 -0
  163. package/server/routes/sovereign.js +465 -385
  164. package/server/routes/universal.js +200 -185
  165. package/server/routes/wab-api.js +850 -501
  166. package/server/runtime/container-worker.js +111 -111
  167. package/server/runtime/container.js +448 -448
  168. package/server/runtime/distributed-worker.js +362 -362
  169. package/server/runtime/event-bus.js +210 -210
  170. package/server/runtime/index.js +253 -253
  171. package/server/runtime/queue.js +599 -599
  172. package/server/runtime/replay.js +666 -666
  173. package/server/runtime/sandbox.js +266 -266
  174. package/server/runtime/scheduler.js +534 -534
  175. package/server/runtime/session-engine.js +293 -293
  176. package/server/runtime/state-manager.js +188 -188
  177. package/server/security/cross-site-redactor.js +196 -0
  178. package/server/security/dry-run.js +180 -0
  179. package/server/security/human-gate-rate-limit.js +147 -0
  180. package/server/security/human-gate-transports.js +178 -0
  181. package/server/security/human-gate.js +281 -0
  182. package/server/security/index.js +368 -368
  183. package/server/security/intent-engine.js +245 -0
  184. package/server/security/reward-guard.js +171 -0
  185. package/server/security/rollback-store.js +239 -0
  186. package/server/security/token-scope.js +404 -0
  187. package/server/security/url-policy.js +139 -0
  188. package/server/services/agent-chat.js +506 -506
  189. package/server/services/agent-learning.js +601 -575
  190. package/server/services/agent-memory.js +625 -625
  191. package/server/services/agent-mesh.js +555 -539
  192. package/server/services/agent-symphony.js +717 -717
  193. package/server/services/agent-tasks.js +1807 -1807
  194. package/server/services/api-key-engine.js +292 -261
  195. package/server/services/cluster.js +894 -894
  196. package/server/services/commander.js +738 -738
  197. package/server/services/edge-compute.js +440 -440
  198. package/server/services/email.js +233 -204
  199. package/server/services/governance.js +466 -0
  200. package/server/services/hosted-runtime.js +205 -205
  201. package/server/services/lfd.js +635 -635
  202. package/server/services/local-ai.js +389 -389
  203. package/server/services/marketplace.js +270 -270
  204. package/server/services/metering.js +182 -182
  205. package/server/services/modules/affiliate-intelligence.js +93 -93
  206. package/server/services/modules/agent-firewall.js +90 -90
  207. package/server/services/modules/bounty.js +89 -89
  208. package/server/services/modules/collective-bargaining.js +92 -92
  209. package/server/services/modules/dark-pattern.js +66 -66
  210. package/server/services/modules/gov-intelligence.js +45 -45
  211. package/server/services/modules/neural.js +55 -55
  212. package/server/services/modules/notary.js +49 -49
  213. package/server/services/modules/price-time-machine.js +86 -86
  214. package/server/services/modules/protocol.js +104 -104
  215. package/server/services/negotiation.js +439 -439
  216. package/server/services/plans.js +214 -0
  217. package/server/services/plugins.js +771 -771
  218. package/server/services/premium.js +1 -1
  219. package/server/services/price-intelligence.js +566 -566
  220. package/server/services/price-shield.js +1137 -1137
  221. package/server/services/provider-clients.js +740 -0
  222. package/server/services/reputation.js +465 -465
  223. package/server/services/search-engine.js +357 -357
  224. package/server/services/security.js +513 -513
  225. package/server/services/self-healing.js +843 -843
  226. package/server/services/shieldqr.js +322 -0
  227. package/server/services/sovereign-shield.js +542 -0
  228. package/server/services/ssl-inspector.js +42 -0
  229. package/server/services/ssl-monitor.js +167 -0
  230. package/server/services/stripe.js +205 -192
  231. package/server/services/swarm.js +788 -788
  232. package/server/services/universal-scraper.js +662 -661
  233. package/server/services/verification.js +481 -481
  234. package/server/services/vision.js +1163 -1163
  235. package/server/services/wab-crypto.js +178 -0
  236. package/server/utils/cache.js +125 -125
  237. package/server/utils/migrate.js +81 -81
  238. package/server/utils/safe-fetch.js +228 -0
  239. package/server/utils/secureFields.js +50 -50
  240. package/server/ws.js +161 -161
  241. package/templates/artisan-marketplace.yaml +104 -104
  242. package/templates/book-price-scout.yaml +98 -98
  243. package/templates/electronics-price-tracker.yaml +108 -108
  244. package/templates/flight-deal-hunter.yaml +113 -113
  245. package/templates/freelancer-direct.yaml +116 -116
  246. package/templates/grocery-price-compare.yaml +93 -93
  247. package/templates/hotel-direct-booking.yaml +113 -113
  248. package/templates/local-services.yaml +98 -98
  249. package/templates/olive-oil-tunisia.yaml +88 -88
  250. package/templates/organic-farm-fresh.yaml +101 -101
  251. package/templates/restaurant-direct.yaml +97 -97
  252. package/public/score.html +0 -263
  253. package/server/migrations/006_growth_suite.sql +0 -138
  254. package/server/routes/growth.js +0 -962
  255. package/server/services/fairness-engine.js +0 -409
  256. 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 };