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,686 +1,686 @@
1
- 'use strict';
2
-
3
- const express = require('express');
4
- const router = express.Router();
5
- const { authenticateToken } = require('../middleware/auth');
6
- const { findSiteById } = require('../models/db');
7
- const memory = require('../services/agent-memory');
8
- const healing = require('../services/self-healing');
9
- const vision = require('../services/vision');
10
- const swarm = require('../services/swarm');
11
- const plugins = require('../services/plugins');
12
-
13
- // ─── Middleware ───────────────────────────────────────────────────────────────
14
-
15
- function requireSiteOwnership(req, res, next) {
16
- const siteId = req.params.siteId || req.body.siteId;
17
- if (!siteId) return res.status(400).json({ error: 'siteId is required' });
18
-
19
- const site = findSiteById.get(siteId);
20
- if (!site) return res.status(404).json({ error: 'Site not found' });
21
- if (site.user_id !== req.user.id) return res.status(403).json({ error: 'Access denied' });
22
-
23
- req.site = site;
24
- next();
25
- }
26
-
27
- // ═════════════════════════════════════════════════════════════════════════════
28
- // MEMORY API
29
- // ═════════════════════════════════════════════════════════════════════════════
30
-
31
- router.post('/memory/:siteId/store', authenticateToken, requireSiteOwnership, (req, res) => {
32
- try {
33
- const { agentId, type, category, key, value, importance, ttlSeconds } = req.body;
34
- if (!agentId || !key) return res.status(400).json({ error: 'agentId and key are required' });
35
-
36
- const result = memory.storeMemory(req.params.siteId, agentId, { type, category, key, value, importance, ttlSeconds });
37
- res.status(201).json({ memory: result });
38
- } catch (err) {
39
- res.status(500).json({ error: 'Failed to store memory', details: err.message });
40
- }
41
- });
42
-
43
- router.post('/memory/:siteId/recall', authenticateToken, requireSiteOwnership, (req, res) => {
44
- try {
45
- const { agentId, query, category, type, limit, minImportance } = req.body;
46
- if (!agentId) return res.status(400).json({ error: 'agentId is required' });
47
-
48
- const results = memory.recallMemories(req.params.siteId, agentId, { query, category, type, limit, minImportance });
49
- res.json({ memories: results, count: results.length });
50
- } catch (err) {
51
- res.status(500).json({ error: 'Failed to recall memories', details: err.message });
52
- }
53
- });
54
-
55
- router.post('/memory/:siteId/associate', authenticateToken, requireSiteOwnership, (req, res) => {
56
- try {
57
- const { sourceId, targetId, relationship, strength } = req.body;
58
- if (!sourceId || !targetId || !relationship) {
59
- return res.status(400).json({ error: 'sourceId, targetId, and relationship are required' });
60
- }
61
-
62
- const result = memory.associateMemories(sourceId, targetId, relationship, strength);
63
- res.status(201).json({ association: result });
64
- } catch (err) {
65
- res.status(500).json({ error: 'Failed to associate memories', details: err.message });
66
- }
67
- });
68
-
69
- router.delete('/memory/:siteId/:memoryId', authenticateToken, requireSiteOwnership, (req, res) => {
70
- try {
71
- const ok = memory.forgetMemory(req.params.memoryId);
72
- if (!ok) return res.status(404).json({ error: 'Memory not found' });
73
- res.json({ success: true });
74
- } catch (err) {
75
- res.status(500).json({ error: 'Failed to forget memory', details: err.message });
76
- }
77
- });
78
-
79
- router.post('/memory/:siteId/consolidate', authenticateToken, requireSiteOwnership, (req, res) => {
80
- try {
81
- const { agentId } = req.body;
82
- if (!agentId) return res.status(400).json({ error: 'agentId is required' });
83
-
84
- const stats = memory.consolidateMemories(req.params.siteId, agentId);
85
- res.json({ stats });
86
- } catch (err) {
87
- res.status(500).json({ error: 'Failed to consolidate memories', details: err.message });
88
- }
89
- });
90
-
91
- router.get('/memory/:siteId/stats', authenticateToken, requireSiteOwnership, (req, res) => {
92
- try {
93
- const { agentId } = req.query;
94
- if (!agentId) return res.status(400).json({ error: 'agentId query param is required' });
95
-
96
- const stats = memory.getMemoryStats(req.params.siteId, agentId);
97
- res.json({ stats });
98
- } catch (err) {
99
- res.status(500).json({ error: 'Failed to get memory stats', details: err.message });
100
- }
101
- });
102
-
103
- router.post('/memory/:siteId/session/start', authenticateToken, requireSiteOwnership, (req, res) => {
104
- try {
105
- const { agentId, context } = req.body;
106
- if (!agentId) return res.status(400).json({ error: 'agentId is required' });
107
-
108
- const session = memory.startSession(req.params.siteId, agentId, context);
109
- res.status(201).json({ session });
110
- } catch (err) {
111
- res.status(500).json({ error: 'Failed to start session', details: err.message });
112
- }
113
- });
114
-
115
- router.post('/memory/:siteId/session/:sessionId/end', authenticateToken, requireSiteOwnership, (req, res) => {
116
- try {
117
- const { summary } = req.body;
118
- const ok = memory.endSession(req.params.sessionId, summary);
119
- if (!ok) return res.status(404).json({ error: 'Session not found' });
120
- res.json({ success: true });
121
- } catch (err) {
122
- res.status(500).json({ error: 'Failed to end session', details: err.message });
123
- }
124
- });
125
-
126
- router.get('/memory/:siteId/sessions', authenticateToken, requireSiteOwnership, (req, res) => {
127
- try {
128
- const { agentId, limit } = req.query;
129
- if (!agentId) return res.status(400).json({ error: 'agentId query param is required' });
130
-
131
- const sessions = memory.getSessionHistory(req.params.siteId, agentId, {
132
- limit: limit ? parseInt(limit, 10) : undefined,
133
- });
134
- res.json({ sessions });
135
- } catch (err) {
136
- res.status(500).json({ error: 'Failed to get session history', details: err.message });
137
- }
138
- });
139
-
140
- router.get('/memory/:siteId/preferences', authenticateToken, requireSiteOwnership, (req, res) => {
141
- try {
142
- const { agentId } = req.query;
143
- if (!agentId) return res.status(400).json({ error: 'agentId query param is required' });
144
-
145
- const preferences = memory.getPreferences(req.params.siteId, agentId);
146
- res.json({ preferences });
147
- } catch (err) {
148
- res.status(500).json({ error: 'Failed to get preferences', details: err.message });
149
- }
150
- });
151
-
152
- router.post('/memory/:siteId/preferences', authenticateToken, requireSiteOwnership, (req, res) => {
153
- try {
154
- const { agentId, key, value } = req.body;
155
- if (!agentId || !key) return res.status(400).json({ error: 'agentId and key are required' });
156
-
157
- const result = memory.recordPreference(req.params.siteId, agentId, key, value);
158
- res.status(201).json({ preference: result });
159
- } catch (err) {
160
- res.status(500).json({ error: 'Failed to record preference', details: err.message });
161
- }
162
- });
163
-
164
- router.get('/memory/:siteId/export', authenticateToken, requireSiteOwnership, (req, res) => {
165
- try {
166
- const { agentId, format } = req.query;
167
- if (!agentId) return res.status(400).json({ error: 'agentId query param is required' });
168
-
169
- const data = memory.exportMemories(req.params.siteId, agentId, { format });
170
-
171
- if (format === 'csv') {
172
- res.setHeader('Content-Type', 'text/csv');
173
- res.setHeader('Content-Disposition', 'attachment; filename="memories.csv"');
174
- return res.send(data);
175
- }
176
-
177
- res.setHeader('Content-Type', 'application/json');
178
- res.send(data);
179
- } catch (err) {
180
- res.status(500).json({ error: 'Failed to export memories', details: err.message });
181
- }
182
- });
183
-
184
- router.post('/memory/:siteId/import', authenticateToken, requireSiteOwnership, (req, res) => {
185
- try {
186
- const { agentId, data } = req.body;
187
- if (!agentId || !Array.isArray(data)) {
188
- return res.status(400).json({ error: 'agentId and data (array) are required' });
189
- }
190
-
191
- const result = memory.importMemories(req.params.siteId, agentId, data);
192
- res.status(201).json(result);
193
- } catch (err) {
194
- res.status(500).json({ error: 'Failed to import memories', details: err.message });
195
- }
196
- });
197
-
198
- // ═════════════════════════════════════════════════════════════════════════════
199
- // SELF-HEALING API
200
- // ═════════════════════════════════════════════════════════════════════════════
201
-
202
- router.post('/healing/:siteId/register', authenticateToken, requireSiteOwnership, (req, res) => {
203
- try {
204
- const { actionName, selector, selectorType, elementSignature } = req.body;
205
- if (!actionName || !selector) {
206
- return res.status(400).json({ error: 'actionName and selector are required' });
207
- }
208
-
209
- const result = healing.registerSelector(req.params.siteId, { actionName, selector, selectorType, elementSignature });
210
- res.status(201).json({ selector: result });
211
- } catch (err) {
212
- res.status(500).json({ error: 'Failed to register selector', details: err.message });
213
- }
214
- });
215
-
216
- router.post('/healing/:siteId/heal', authenticateToken, requireSiteOwnership, (req, res) => {
217
- try {
218
- const { actionName, failedSelector, pageElements } = req.body;
219
- if (!actionName || !failedSelector) {
220
- return res.status(400).json({ error: 'actionName and failedSelector are required' });
221
- }
222
-
223
- const result = healing.healSelector(req.params.siteId, actionName, failedSelector, pageElements || []);
224
- res.json(result);
225
- } catch (err) {
226
- res.status(500).json({ error: 'Failed to heal selector', details: err.message });
227
- }
228
- });
229
-
230
- router.post('/healing/:siteId/correct', authenticateToken, requireSiteOwnership, (req, res) => {
231
- try {
232
- const { registryId, oldSelector, newSelector, correctedBy, reason, shared } = req.body;
233
- if (!oldSelector || !newSelector) {
234
- return res.status(400).json({ error: 'oldSelector and newSelector are required' });
235
- }
236
-
237
- const result = healing.submitCorrection(req.params.siteId, registryId, {
238
- oldSelector, newSelector, correctedBy, reason, shared,
239
- });
240
- res.status(201).json({ correction: result });
241
- } catch (err) {
242
- res.status(500).json({ error: 'Failed to submit correction', details: err.message });
243
- }
244
- });
245
-
246
- router.get('/healing/:siteId/suggestions', authenticateToken, requireSiteOwnership, (req, res) => {
247
- try {
248
- const { failedSelector } = req.query;
249
- if (!failedSelector) return res.status(400).json({ error: 'failedSelector query param is required' });
250
-
251
- const suggestions = healing.getCommunitySuggestions(req.params.siteId, failedSelector);
252
- res.json({ suggestions });
253
- } catch (err) {
254
- res.status(500).json({ error: 'Failed to get community suggestions', details: err.message });
255
- }
256
- });
257
-
258
- router.post('/healing/:siteId/verify', authenticateToken, requireSiteOwnership, (req, res) => {
259
- try {
260
- const { actionName, elementData } = req.body;
261
- if (!actionName || !elementData) {
262
- return res.status(400).json({ error: 'actionName and elementData are required' });
263
- }
264
-
265
- const result = healing.verifySelector(req.params.siteId, actionName, elementData);
266
- res.json(result);
267
- } catch (err) {
268
- res.status(500).json({ error: 'Failed to verify selector', details: err.message });
269
- }
270
- });
271
-
272
- router.get('/healing/:siteId/health', authenticateToken, requireSiteOwnership, (req, res) => {
273
- try {
274
- const health = healing.getSelectorHealth(req.params.siteId);
275
- res.json({ health });
276
- } catch (err) {
277
- res.status(500).json({ error: 'Failed to get selector health', details: err.message });
278
- }
279
- });
280
-
281
- router.get('/healing/:siteId/history', authenticateToken, requireSiteOwnership, (req, res) => {
282
- try {
283
- const { limit, actionName } = req.query;
284
- const history = healing.getHealingHistory(req.params.siteId, {
285
- limit: limit ? parseInt(limit, 10) : undefined,
286
- actionName,
287
- });
288
- res.json({ history });
289
- } catch (err) {
290
- res.status(500).json({ error: 'Failed to get healing history', details: err.message });
291
- }
292
- });
293
-
294
- router.post('/healing/:siteId/snapshot', authenticateToken, requireSiteOwnership, (req, res) => {
295
- try {
296
- const { url, elements } = req.body;
297
- if (!url || !Array.isArray(elements)) {
298
- return res.status(400).json({ error: 'url and elements (array) are required' });
299
- }
300
-
301
- const result = healing.snapshotElements(req.params.siteId, url, elements);
302
- res.status(201).json({ snapshot: result });
303
- } catch (err) {
304
- res.status(500).json({ error: 'Failed to snapshot elements', details: err.message });
305
- }
306
- });
307
-
308
- router.post('/healing/:siteId/drift', authenticateToken, requireSiteOwnership, (req, res) => {
309
- try {
310
- const { url, currentElements } = req.body;
311
- if (!url || !Array.isArray(currentElements)) {
312
- return res.status(400).json({ error: 'url and currentElements (array) are required' });
313
- }
314
-
315
- const result = healing.detectDrift(req.params.siteId, url, currentElements);
316
- res.json(result);
317
- } catch (err) {
318
- res.status(500).json({ error: 'Failed to detect drift', details: err.message });
319
- }
320
- });
321
-
322
- // ═════════════════════════════════════════════════════════════════════════════
323
- // VISION API
324
- // ═════════════════════════════════════════════════════════════════════════════
325
-
326
- router.put('/vision/:siteId/config', authenticateToken, requireSiteOwnership, (req, res) => {
327
- try {
328
- const { provider, model, endpoint, apiKey, maxResolution, cacheTtl } = req.body;
329
- const config = vision.configureVision(req.params.siteId, { provider, model, endpoint, apiKey, maxResolution, cacheTtl });
330
- res.json({ config });
331
- } catch (err) {
332
- res.status(500).json({ error: 'Failed to configure vision', details: err.message });
333
- }
334
- });
335
-
336
- router.get('/vision/:siteId/config', authenticateToken, requireSiteOwnership, (req, res) => {
337
- try {
338
- const config = vision.getVisionConfig(req.params.siteId);
339
- if (!config) return res.status(404).json({ error: 'Vision not configured for this site' });
340
- res.json({ config });
341
- } catch (err) {
342
- res.status(500).json({ error: 'Failed to get vision config', details: err.message });
343
- }
344
- });
345
-
346
- router.post('/vision/:siteId/analyze', authenticateToken, requireSiteOwnership, async (req, res) => {
347
- try {
348
- const { screenshotBase64, url, prompt } = req.body;
349
- if (!screenshotBase64) return res.status(400).json({ error: 'screenshotBase64 is required' });
350
-
351
- const result = await vision.analyzeScreenshot(req.params.siteId, { screenshotBase64, url, prompt });
352
- res.json(result);
353
- } catch (err) {
354
- const status = err.message.includes('not configured') || err.message.includes('disabled') ? 400 : 500;
355
- res.status(status).json({ error: 'Failed to analyze screenshot', details: err.message });
356
- }
357
- });
358
-
359
- router.post('/vision/:siteId/find-element', authenticateToken, requireSiteOwnership, (req, res) => {
360
- try {
361
- const { url, description, type, label } = req.body;
362
- const elements = vision.findElement(req.params.siteId, url, { description, type, label });
363
- res.json({ elements, count: elements.length });
364
- } catch (err) {
365
- res.status(500).json({ error: 'Failed to find element', details: err.message });
366
- }
367
- });
368
-
369
- router.post('/vision/:siteId/compare', authenticateToken, requireSiteOwnership, (req, res) => {
370
- try {
371
- const { url, screenshotAHash, screenshotBHash } = req.body;
372
- if (!screenshotAHash || !screenshotBHash) {
373
- return res.status(400).json({ error: 'screenshotAHash and screenshotBHash are required' });
374
- }
375
-
376
- const result = vision.compareScreenshots(req.params.siteId, url, screenshotAHash, screenshotBHash);
377
- res.json(result);
378
- } catch (err) {
379
- res.status(500).json({ error: 'Failed to compare screenshots', details: err.message });
380
- }
381
- });
382
-
383
- router.get('/vision/:siteId/cache-stats', authenticateToken, requireSiteOwnership, (req, res) => {
384
- try {
385
- const stats = vision.getCacheStats(req.params.siteId);
386
- res.json({ stats });
387
- } catch (err) {
388
- res.status(500).json({ error: 'Failed to get cache stats', details: err.message });
389
- }
390
- });
391
-
392
- router.delete('/vision/:siteId/cache', authenticateToken, requireSiteOwnership, (req, res) => {
393
- try {
394
- const { olderThan } = req.query;
395
- const result = vision.clearCache(req.params.siteId, {
396
- olderThan: olderThan ? parseInt(olderThan, 10) : undefined,
397
- });
398
- res.json(result);
399
- } catch (err) {
400
- res.status(500).json({ error: 'Failed to clear cache', details: err.message });
401
- }
402
- });
403
-
404
- router.get('/vision/:siteId/history', authenticateToken, requireSiteOwnership, (req, res) => {
405
- try {
406
- const { limit, url } = req.query;
407
- const history = vision.getVisionHistory(req.params.siteId, {
408
- limit: limit ? parseInt(limit, 10) : undefined,
409
- url,
410
- });
411
- res.json({ history });
412
- } catch (err) {
413
- res.status(500).json({ error: 'Failed to get vision history', details: err.message });
414
- }
415
- });
416
-
417
- router.get('/vision/models', (_req, res) => {
418
- try {
419
- const models = vision.getSupportedModels();
420
- res.json({ models });
421
- } catch (err) {
422
- res.status(500).json({ error: 'Failed to get supported models', details: err.message });
423
- }
424
- });
425
-
426
- // ═════════════════════════════════════════════════════════════════════════════
427
- // SWARM API
428
- // ═════════════════════════════════════════════════════════════════════════════
429
-
430
- router.put('/swarm/:siteId/config', authenticateToken, requireSiteOwnership, (req, res) => {
431
- try {
432
- const { name, strategy, maxAgents, timeoutMs, mergeStrategy } = req.body;
433
- const config = swarm.configureSwarm(req.params.siteId, { name, strategy, maxAgents, timeoutMs, mergeStrategy });
434
- res.json({ config });
435
- } catch (err) {
436
- res.status(500).json({ error: 'Failed to configure swarm', details: err.message });
437
- }
438
- });
439
-
440
- router.get('/swarm/:siteId/config', authenticateToken, requireSiteOwnership, (req, res) => {
441
- try {
442
- const config = swarm.getSwarmConfig(req.params.siteId);
443
- if (!config) return res.status(404).json({ error: 'Swarm not configured for this site' });
444
- res.json({ config });
445
- } catch (err) {
446
- res.status(500).json({ error: 'Failed to get swarm config', details: err.message });
447
- }
448
- });
449
-
450
- router.post('/swarm/:siteId/tasks', authenticateToken, requireSiteOwnership, (req, res) => {
451
- try {
452
- const { taskType, objective, parameters } = req.body;
453
- if (!objective) return res.status(400).json({ error: 'objective is required' });
454
-
455
- const task = swarm.createTask(req.params.siteId, {
456
- taskType, objective, parameters, createdBy: req.user.id,
457
- });
458
- res.status(201).json({ task });
459
- } catch (err) {
460
- res.status(500).json({ error: 'Failed to create task', details: err.message });
461
- }
462
- });
463
-
464
- router.post('/swarm/tasks/:taskId/agents', authenticateToken, (req, res) => {
465
- try {
466
- const { agents: agentDefinitions } = req.body;
467
- if (!Array.isArray(agentDefinitions) || agentDefinitions.length === 0) {
468
- return res.status(400).json({ error: 'agents (non-empty array) is required' });
469
- }
470
-
471
- const agents = swarm.assignAgents(req.params.taskId, agentDefinitions);
472
- res.status(201).json({ agents });
473
- } catch (err) {
474
- const status = err.message.includes('not found') ? 404 : 500;
475
- res.status(status).json({ error: 'Failed to assign agents', details: err.message });
476
- }
477
- });
478
-
479
- router.post('/swarm/tasks/:taskId/run', authenticateToken, async (req, res) => {
480
- try {
481
- const result = await swarm.runSwarmTask(req.params.taskId);
482
- res.json(result);
483
- } catch (err) {
484
- const status = err.message.includes('not found') ? 404
485
- : err.message.includes('cancelled') ? 400
486
- : err.message.includes('No agents') ? 400 : 500;
487
- res.status(status).json({ error: 'Failed to run swarm task', details: err.message });
488
- }
489
- });
490
-
491
- router.get('/swarm/tasks/:taskId', authenticateToken, (req, res) => {
492
- try {
493
- const status = swarm.getTaskStatus(req.params.taskId);
494
- if (!status) return res.status(404).json({ error: 'Task not found' });
495
- res.json({ task: status });
496
- } catch (err) {
497
- res.status(500).json({ error: 'Failed to get task status', details: err.message });
498
- }
499
- });
500
-
501
- router.get('/swarm/tasks/:taskId/result', authenticateToken, (req, res) => {
502
- try {
503
- const result = swarm.getTaskResult(req.params.taskId);
504
- if (!result) return res.status(404).json({ error: 'Task not found' });
505
- res.json(result);
506
- } catch (err) {
507
- res.status(500).json({ error: 'Failed to get task result', details: err.message });
508
- }
509
- });
510
-
511
- router.post('/swarm/tasks/:taskId/cancel', authenticateToken, (req, res) => {
512
- try {
513
- const result = swarm.cancelTask(req.params.taskId);
514
- if (!result) return res.status(404).json({ error: 'Task not found' });
515
- res.json(result);
516
- } catch (err) {
517
- res.status(500).json({ error: 'Failed to cancel task', details: err.message });
518
- }
519
- });
520
-
521
- router.get('/swarm/:siteId/history', authenticateToken, requireSiteOwnership, (req, res) => {
522
- try {
523
- const { limit, taskType } = req.query;
524
- const history = swarm.getSwarmHistory(req.params.siteId, {
525
- limit: limit ? parseInt(limit, 10) : undefined,
526
- taskType,
527
- });
528
- res.json({ history });
529
- } catch (err) {
530
- res.status(500).json({ error: 'Failed to get swarm history', details: err.message });
531
- }
532
- });
533
-
534
- router.get('/swarm/:siteId/stats', authenticateToken, requireSiteOwnership, (req, res) => {
535
- try {
536
- const stats = swarm.getSwarmStats(req.params.siteId);
537
- res.json({ stats });
538
- } catch (err) {
539
- res.status(500).json({ error: 'Failed to get swarm stats', details: err.message });
540
- }
541
- });
542
-
543
- // ═════════════════════════════════════════════════════════════════════════════
544
- // PLUGINS API
545
- // ═════════════════════════════════════════════════════════════════════════════
546
-
547
- router.get('/plugins/marketplace', (req, res) => {
548
- try {
549
- const { category, search, limit, offset } = req.query;
550
- const result = plugins.listPlugins({
551
- category, search,
552
- limit: limit ? parseInt(limit, 10) : undefined,
553
- offset: offset ? parseInt(offset, 10) : undefined,
554
- });
555
- res.json(result);
556
- } catch (err) {
557
- res.status(500).json({ error: 'Failed to list plugins', details: err.message });
558
- }
559
- });
560
-
561
- router.get('/plugins/hooks', (req, res) => {
562
- try {
563
- const hooks = plugins.getAvailableHooks();
564
- res.json({ hooks });
565
- } catch (err) {
566
- res.status(500).json({ error: 'Failed to get available hooks', details: err.message });
567
- }
568
- });
569
-
570
- router.get('/plugins/:pluginId', authenticateToken, (req, res) => {
571
- try {
572
- const plugin = plugins.getPlugin(req.params.pluginId);
573
- if (!plugin) return res.status(404).json({ error: 'Plugin not found' });
574
- res.json({ plugin });
575
- } catch (err) {
576
- res.status(500).json({ error: 'Failed to get plugin', details: err.message });
577
- }
578
- });
579
-
580
- router.post('/plugins/register', authenticateToken, (req, res) => {
581
- try {
582
- const { name, description, version, author, hooks, configSchema, category } = req.body;
583
- if (!name || !version) return res.status(400).json({ error: 'name and version are required' });
584
-
585
- const plugin = plugins.registerPlugin({
586
- name, description, version, author, hooks, configSchema, category,
587
- registeredBy: req.user.id,
588
- });
589
- res.status(201).json({ plugin });
590
- } catch (err) {
591
- res.status(500).json({ error: 'Failed to register plugin', details: err.message });
592
- }
593
- });
594
-
595
- router.post('/plugins/:pluginId/install/:siteId', authenticateToken, requireSiteOwnership, (req, res) => {
596
- try {
597
- const { config } = req.body;
598
- const installation = plugins.installPlugin(req.params.pluginId, req.params.siteId, req.user.id, config);
599
- res.status(201).json({ installation });
600
- } catch (err) {
601
- const status = err.message.includes('not found') ? 404 : 500;
602
- res.status(status).json({ error: 'Failed to install plugin', details: err.message });
603
- }
604
- });
605
-
606
- router.delete('/plugins/:pluginId/uninstall/:siteId', authenticateToken, requireSiteOwnership, (req, res) => {
607
- try {
608
- const ok = plugins.uninstallPlugin(req.params.pluginId, req.params.siteId);
609
- if (!ok) return res.status(404).json({ error: 'Plugin installation not found' });
610
- res.json({ success: true });
611
- } catch (err) {
612
- res.status(500).json({ error: 'Failed to uninstall plugin', details: err.message });
613
- }
614
- });
615
-
616
- router.put('/plugins/installations/:installationId/config', authenticateToken, (req, res) => {
617
- try {
618
- const { config } = req.body;
619
- if (!config) return res.status(400).json({ error: 'config is required' });
620
-
621
- const result = plugins.configurePlugin(req.params.installationId, config);
622
- if (!result) return res.status(404).json({ error: 'Installation not found' });
623
- res.json({ installation: result });
624
- } catch (err) {
625
- res.status(500).json({ error: 'Failed to configure plugin', details: err.message });
626
- }
627
- });
628
-
629
- router.get('/plugins/installed/:siteId', authenticateToken, requireSiteOwnership, (req, res) => {
630
- try {
631
- const installed = plugins.getInstalledPlugins(req.params.siteId);
632
- res.json({ plugins: installed });
633
- } catch (err) {
634
- res.status(500).json({ error: 'Failed to get installed plugins', details: err.message });
635
- }
636
- });
637
-
638
- router.post('/plugins/:pluginId/rate', authenticateToken, (req, res) => {
639
- try {
640
- const { rating, review } = req.body;
641
- if (rating == null || rating < 1 || rating > 5) {
642
- return res.status(400).json({ error: 'rating (1-5) is required' });
643
- }
644
-
645
- const result = plugins.ratePlugin(req.params.pluginId, req.user.id, rating);
646
- res.status(201).json(result);
647
- } catch (err) {
648
- const status = err.message.includes('not found') ? 404 : 500;
649
- res.status(status).json({ error: 'Failed to rate plugin', details: err.message });
650
- }
651
- });
652
-
653
- router.get('/plugins/:pluginId/stats', authenticateToken, (req, res) => {
654
- try {
655
- const stats = plugins.getPluginStats(req.params.pluginId);
656
- if (!stats) return res.status(404).json({ error: 'Plugin not found' });
657
- res.json({ stats });
658
- } catch (err) {
659
- res.status(500).json({ error: 'Failed to get plugin stats', details: err.message });
660
- }
661
- });
662
-
663
- router.post('/plugins/hooks/:hookName/execute/:siteId', authenticateToken, requireSiteOwnership, async (req, res) => {
664
- try {
665
- const { payload } = req.body;
666
- const result = await plugins.executeHook(req.params.hookName, req.params.siteId, payload || {});
667
- res.json(result);
668
- } catch (err) {
669
- res.status(500).json({ error: 'Failed to execute hook', details: err.message });
670
- }
671
- });
672
-
673
- router.get('/plugins/hooks/log/:siteId', authenticateToken, requireSiteOwnership, (req, res) => {
674
- try {
675
- const { limit, hookName } = req.query;
676
- const logs = plugins.getHookExecutionLog(req.params.siteId, {
677
- limit: limit ? parseInt(limit, 10) : undefined,
678
- hookName,
679
- });
680
- res.json({ logs });
681
- } catch (err) {
682
- res.status(500).json({ error: 'Failed to get hook execution log', details: err.message });
683
- }
684
- });
685
-
686
- module.exports = router;
1
+ 'use strict';
2
+
3
+ const express = require('express');
4
+ const router = express.Router();
5
+ const { authenticateToken } = require('../middleware/auth');
6
+ const { findSiteById } = require('../models/db');
7
+ const memory = require('../services/agent-memory');
8
+ const healing = require('../services/self-healing');
9
+ const vision = require('../services/vision');
10
+ const swarm = require('../services/swarm');
11
+ const plugins = require('../services/plugins');
12
+
13
+ // ─── Middleware ───────────────────────────────────────────────────────────────
14
+
15
+ function requireSiteOwnership(req, res, next) {
16
+ const siteId = req.params.siteId || req.body.siteId;
17
+ if (!siteId) return res.status(400).json({ error: 'siteId is required' });
18
+
19
+ const site = findSiteById.get(siteId);
20
+ if (!site) return res.status(404).json({ error: 'Site not found' });
21
+ if (site.user_id !== req.user.id) return res.status(403).json({ error: 'Access denied' });
22
+
23
+ req.site = site;
24
+ next();
25
+ }
26
+
27
+ // ═════════════════════════════════════════════════════════════════════════════
28
+ // MEMORY API
29
+ // ═════════════════════════════════════════════════════════════════════════════
30
+
31
+ router.post('/memory/:siteId/store', authenticateToken, requireSiteOwnership, (req, res) => {
32
+ try {
33
+ const { agentId, type, category, key, value, importance, ttlSeconds } = req.body;
34
+ if (!agentId || !key) return res.status(400).json({ error: 'agentId and key are required' });
35
+
36
+ const result = memory.storeMemory(req.params.siteId, agentId, { type, category, key, value, importance, ttlSeconds });
37
+ res.status(201).json({ memory: result });
38
+ } catch (err) {
39
+ res.status(500).json({ error: 'Failed to store memory', details: err.message });
40
+ }
41
+ });
42
+
43
+ router.post('/memory/:siteId/recall', authenticateToken, requireSiteOwnership, (req, res) => {
44
+ try {
45
+ const { agentId, query, category, type, limit, minImportance } = req.body;
46
+ if (!agentId) return res.status(400).json({ error: 'agentId is required' });
47
+
48
+ const results = memory.recallMemories(req.params.siteId, agentId, { query, category, type, limit, minImportance });
49
+ res.json({ memories: results, count: results.length });
50
+ } catch (err) {
51
+ res.status(500).json({ error: 'Failed to recall memories', details: err.message });
52
+ }
53
+ });
54
+
55
+ router.post('/memory/:siteId/associate', authenticateToken, requireSiteOwnership, (req, res) => {
56
+ try {
57
+ const { sourceId, targetId, relationship, strength } = req.body;
58
+ if (!sourceId || !targetId || !relationship) {
59
+ return res.status(400).json({ error: 'sourceId, targetId, and relationship are required' });
60
+ }
61
+
62
+ const result = memory.associateMemories(sourceId, targetId, relationship, strength);
63
+ res.status(201).json({ association: result });
64
+ } catch (err) {
65
+ res.status(500).json({ error: 'Failed to associate memories', details: err.message });
66
+ }
67
+ });
68
+
69
+ router.delete('/memory/:siteId/:memoryId', authenticateToken, requireSiteOwnership, (req, res) => {
70
+ try {
71
+ const ok = memory.forgetMemory(req.params.memoryId);
72
+ if (!ok) return res.status(404).json({ error: 'Memory not found' });
73
+ res.json({ success: true });
74
+ } catch (err) {
75
+ res.status(500).json({ error: 'Failed to forget memory', details: err.message });
76
+ }
77
+ });
78
+
79
+ router.post('/memory/:siteId/consolidate', authenticateToken, requireSiteOwnership, (req, res) => {
80
+ try {
81
+ const { agentId } = req.body;
82
+ if (!agentId) return res.status(400).json({ error: 'agentId is required' });
83
+
84
+ const stats = memory.consolidateMemories(req.params.siteId, agentId);
85
+ res.json({ stats });
86
+ } catch (err) {
87
+ res.status(500).json({ error: 'Failed to consolidate memories', details: err.message });
88
+ }
89
+ });
90
+
91
+ router.get('/memory/:siteId/stats', authenticateToken, requireSiteOwnership, (req, res) => {
92
+ try {
93
+ const { agentId } = req.query;
94
+ if (!agentId) return res.status(400).json({ error: 'agentId query param is required' });
95
+
96
+ const stats = memory.getMemoryStats(req.params.siteId, agentId);
97
+ res.json({ stats });
98
+ } catch (err) {
99
+ res.status(500).json({ error: 'Failed to get memory stats', details: err.message });
100
+ }
101
+ });
102
+
103
+ router.post('/memory/:siteId/session/start', authenticateToken, requireSiteOwnership, (req, res) => {
104
+ try {
105
+ const { agentId, context } = req.body;
106
+ if (!agentId) return res.status(400).json({ error: 'agentId is required' });
107
+
108
+ const session = memory.startSession(req.params.siteId, agentId, context);
109
+ res.status(201).json({ session });
110
+ } catch (err) {
111
+ res.status(500).json({ error: 'Failed to start session', details: err.message });
112
+ }
113
+ });
114
+
115
+ router.post('/memory/:siteId/session/:sessionId/end', authenticateToken, requireSiteOwnership, (req, res) => {
116
+ try {
117
+ const { summary } = req.body;
118
+ const ok = memory.endSession(req.params.sessionId, summary);
119
+ if (!ok) return res.status(404).json({ error: 'Session not found' });
120
+ res.json({ success: true });
121
+ } catch (err) {
122
+ res.status(500).json({ error: 'Failed to end session', details: err.message });
123
+ }
124
+ });
125
+
126
+ router.get('/memory/:siteId/sessions', authenticateToken, requireSiteOwnership, (req, res) => {
127
+ try {
128
+ const { agentId, limit } = req.query;
129
+ if (!agentId) return res.status(400).json({ error: 'agentId query param is required' });
130
+
131
+ const sessions = memory.getSessionHistory(req.params.siteId, agentId, {
132
+ limit: limit ? parseInt(limit, 10) : undefined,
133
+ });
134
+ res.json({ sessions });
135
+ } catch (err) {
136
+ res.status(500).json({ error: 'Failed to get session history', details: err.message });
137
+ }
138
+ });
139
+
140
+ router.get('/memory/:siteId/preferences', authenticateToken, requireSiteOwnership, (req, res) => {
141
+ try {
142
+ const { agentId } = req.query;
143
+ if (!agentId) return res.status(400).json({ error: 'agentId query param is required' });
144
+
145
+ const preferences = memory.getPreferences(req.params.siteId, agentId);
146
+ res.json({ preferences });
147
+ } catch (err) {
148
+ res.status(500).json({ error: 'Failed to get preferences', details: err.message });
149
+ }
150
+ });
151
+
152
+ router.post('/memory/:siteId/preferences', authenticateToken, requireSiteOwnership, (req, res) => {
153
+ try {
154
+ const { agentId, key, value } = req.body;
155
+ if (!agentId || !key) return res.status(400).json({ error: 'agentId and key are required' });
156
+
157
+ const result = memory.recordPreference(req.params.siteId, agentId, key, value);
158
+ res.status(201).json({ preference: result });
159
+ } catch (err) {
160
+ res.status(500).json({ error: 'Failed to record preference', details: err.message });
161
+ }
162
+ });
163
+
164
+ router.get('/memory/:siteId/export', authenticateToken, requireSiteOwnership, (req, res) => {
165
+ try {
166
+ const { agentId, format } = req.query;
167
+ if (!agentId) return res.status(400).json({ error: 'agentId query param is required' });
168
+
169
+ const data = memory.exportMemories(req.params.siteId, agentId, { format });
170
+
171
+ if (format === 'csv') {
172
+ res.setHeader('Content-Type', 'text/csv');
173
+ res.setHeader('Content-Disposition', 'attachment; filename="memories.csv"');
174
+ return res.send(data);
175
+ }
176
+
177
+ res.setHeader('Content-Type', 'application/json');
178
+ res.send(data);
179
+ } catch (err) {
180
+ res.status(500).json({ error: 'Failed to export memories', details: err.message });
181
+ }
182
+ });
183
+
184
+ router.post('/memory/:siteId/import', authenticateToken, requireSiteOwnership, (req, res) => {
185
+ try {
186
+ const { agentId, data } = req.body;
187
+ if (!agentId || !Array.isArray(data)) {
188
+ return res.status(400).json({ error: 'agentId and data (array) are required' });
189
+ }
190
+
191
+ const result = memory.importMemories(req.params.siteId, agentId, data);
192
+ res.status(201).json(result);
193
+ } catch (err) {
194
+ res.status(500).json({ error: 'Failed to import memories', details: err.message });
195
+ }
196
+ });
197
+
198
+ // ═════════════════════════════════════════════════════════════════════════════
199
+ // SELF-HEALING API
200
+ // ═════════════════════════════════════════════════════════════════════════════
201
+
202
+ router.post('/healing/:siteId/register', authenticateToken, requireSiteOwnership, (req, res) => {
203
+ try {
204
+ const { actionName, selector, selectorType, elementSignature } = req.body;
205
+ if (!actionName || !selector) {
206
+ return res.status(400).json({ error: 'actionName and selector are required' });
207
+ }
208
+
209
+ const result = healing.registerSelector(req.params.siteId, { actionName, selector, selectorType, elementSignature });
210
+ res.status(201).json({ selector: result });
211
+ } catch (err) {
212
+ res.status(500).json({ error: 'Failed to register selector', details: err.message });
213
+ }
214
+ });
215
+
216
+ router.post('/healing/:siteId/heal', authenticateToken, requireSiteOwnership, (req, res) => {
217
+ try {
218
+ const { actionName, failedSelector, pageElements } = req.body;
219
+ if (!actionName || !failedSelector) {
220
+ return res.status(400).json({ error: 'actionName and failedSelector are required' });
221
+ }
222
+
223
+ const result = healing.healSelector(req.params.siteId, actionName, failedSelector, pageElements || []);
224
+ res.json(result);
225
+ } catch (err) {
226
+ res.status(500).json({ error: 'Failed to heal selector', details: err.message });
227
+ }
228
+ });
229
+
230
+ router.post('/healing/:siteId/correct', authenticateToken, requireSiteOwnership, (req, res) => {
231
+ try {
232
+ const { registryId, oldSelector, newSelector, correctedBy, reason, shared } = req.body;
233
+ if (!oldSelector || !newSelector) {
234
+ return res.status(400).json({ error: 'oldSelector and newSelector are required' });
235
+ }
236
+
237
+ const result = healing.submitCorrection(req.params.siteId, registryId, {
238
+ oldSelector, newSelector, correctedBy, reason, shared,
239
+ });
240
+ res.status(201).json({ correction: result });
241
+ } catch (err) {
242
+ res.status(500).json({ error: 'Failed to submit correction', details: err.message });
243
+ }
244
+ });
245
+
246
+ router.get('/healing/:siteId/suggestions', authenticateToken, requireSiteOwnership, (req, res) => {
247
+ try {
248
+ const { failedSelector } = req.query;
249
+ if (!failedSelector) return res.status(400).json({ error: 'failedSelector query param is required' });
250
+
251
+ const suggestions = healing.getCommunitySuggestions(req.params.siteId, failedSelector);
252
+ res.json({ suggestions });
253
+ } catch (err) {
254
+ res.status(500).json({ error: 'Failed to get community suggestions', details: err.message });
255
+ }
256
+ });
257
+
258
+ router.post('/healing/:siteId/verify', authenticateToken, requireSiteOwnership, (req, res) => {
259
+ try {
260
+ const { actionName, elementData } = req.body;
261
+ if (!actionName || !elementData) {
262
+ return res.status(400).json({ error: 'actionName and elementData are required' });
263
+ }
264
+
265
+ const result = healing.verifySelector(req.params.siteId, actionName, elementData);
266
+ res.json(result);
267
+ } catch (err) {
268
+ res.status(500).json({ error: 'Failed to verify selector', details: err.message });
269
+ }
270
+ });
271
+
272
+ router.get('/healing/:siteId/health', authenticateToken, requireSiteOwnership, (req, res) => {
273
+ try {
274
+ const health = healing.getSelectorHealth(req.params.siteId);
275
+ res.json({ health });
276
+ } catch (err) {
277
+ res.status(500).json({ error: 'Failed to get selector health', details: err.message });
278
+ }
279
+ });
280
+
281
+ router.get('/healing/:siteId/history', authenticateToken, requireSiteOwnership, (req, res) => {
282
+ try {
283
+ const { limit, actionName } = req.query;
284
+ const history = healing.getHealingHistory(req.params.siteId, {
285
+ limit: limit ? parseInt(limit, 10) : undefined,
286
+ actionName,
287
+ });
288
+ res.json({ history });
289
+ } catch (err) {
290
+ res.status(500).json({ error: 'Failed to get healing history', details: err.message });
291
+ }
292
+ });
293
+
294
+ router.post('/healing/:siteId/snapshot', authenticateToken, requireSiteOwnership, (req, res) => {
295
+ try {
296
+ const { url, elements } = req.body;
297
+ if (!url || !Array.isArray(elements)) {
298
+ return res.status(400).json({ error: 'url and elements (array) are required' });
299
+ }
300
+
301
+ const result = healing.snapshotElements(req.params.siteId, url, elements);
302
+ res.status(201).json({ snapshot: result });
303
+ } catch (err) {
304
+ res.status(500).json({ error: 'Failed to snapshot elements', details: err.message });
305
+ }
306
+ });
307
+
308
+ router.post('/healing/:siteId/drift', authenticateToken, requireSiteOwnership, (req, res) => {
309
+ try {
310
+ const { url, currentElements } = req.body;
311
+ if (!url || !Array.isArray(currentElements)) {
312
+ return res.status(400).json({ error: 'url and currentElements (array) are required' });
313
+ }
314
+
315
+ const result = healing.detectDrift(req.params.siteId, url, currentElements);
316
+ res.json(result);
317
+ } catch (err) {
318
+ res.status(500).json({ error: 'Failed to detect drift', details: err.message });
319
+ }
320
+ });
321
+
322
+ // ═════════════════════════════════════════════════════════════════════════════
323
+ // VISION API
324
+ // ═════════════════════════════════════════════════════════════════════════════
325
+
326
+ router.put('/vision/:siteId/config', authenticateToken, requireSiteOwnership, (req, res) => {
327
+ try {
328
+ const { provider, model, endpoint, apiKey, maxResolution, cacheTtl } = req.body;
329
+ const config = vision.configureVision(req.params.siteId, { provider, model, endpoint, apiKey, maxResolution, cacheTtl });
330
+ res.json({ config });
331
+ } catch (err) {
332
+ res.status(500).json({ error: 'Failed to configure vision', details: err.message });
333
+ }
334
+ });
335
+
336
+ router.get('/vision/:siteId/config', authenticateToken, requireSiteOwnership, (req, res) => {
337
+ try {
338
+ const config = vision.getVisionConfig(req.params.siteId);
339
+ if (!config) return res.status(404).json({ error: 'Vision not configured for this site' });
340
+ res.json({ config });
341
+ } catch (err) {
342
+ res.status(500).json({ error: 'Failed to get vision config', details: err.message });
343
+ }
344
+ });
345
+
346
+ router.post('/vision/:siteId/analyze', authenticateToken, requireSiteOwnership, async (req, res) => {
347
+ try {
348
+ const { screenshotBase64, url, prompt } = req.body;
349
+ if (!screenshotBase64) return res.status(400).json({ error: 'screenshotBase64 is required' });
350
+
351
+ const result = await vision.analyzeScreenshot(req.params.siteId, { screenshotBase64, url, prompt });
352
+ res.json(result);
353
+ } catch (err) {
354
+ const status = err.message.includes('not configured') || err.message.includes('disabled') ? 400 : 500;
355
+ res.status(status).json({ error: 'Failed to analyze screenshot', details: err.message });
356
+ }
357
+ });
358
+
359
+ router.post('/vision/:siteId/find-element', authenticateToken, requireSiteOwnership, (req, res) => {
360
+ try {
361
+ const { url, description, type, label } = req.body;
362
+ const elements = vision.findElement(req.params.siteId, url, { description, type, label });
363
+ res.json({ elements, count: elements.length });
364
+ } catch (err) {
365
+ res.status(500).json({ error: 'Failed to find element', details: err.message });
366
+ }
367
+ });
368
+
369
+ router.post('/vision/:siteId/compare', authenticateToken, requireSiteOwnership, (req, res) => {
370
+ try {
371
+ const { url, screenshotAHash, screenshotBHash } = req.body;
372
+ if (!screenshotAHash || !screenshotBHash) {
373
+ return res.status(400).json({ error: 'screenshotAHash and screenshotBHash are required' });
374
+ }
375
+
376
+ const result = vision.compareScreenshots(req.params.siteId, url, screenshotAHash, screenshotBHash);
377
+ res.json(result);
378
+ } catch (err) {
379
+ res.status(500).json({ error: 'Failed to compare screenshots', details: err.message });
380
+ }
381
+ });
382
+
383
+ router.get('/vision/:siteId/cache-stats', authenticateToken, requireSiteOwnership, (req, res) => {
384
+ try {
385
+ const stats = vision.getCacheStats(req.params.siteId);
386
+ res.json({ stats });
387
+ } catch (err) {
388
+ res.status(500).json({ error: 'Failed to get cache stats', details: err.message });
389
+ }
390
+ });
391
+
392
+ router.delete('/vision/:siteId/cache', authenticateToken, requireSiteOwnership, (req, res) => {
393
+ try {
394
+ const { olderThan } = req.query;
395
+ const result = vision.clearCache(req.params.siteId, {
396
+ olderThan: olderThan ? parseInt(olderThan, 10) : undefined,
397
+ });
398
+ res.json(result);
399
+ } catch (err) {
400
+ res.status(500).json({ error: 'Failed to clear cache', details: err.message });
401
+ }
402
+ });
403
+
404
+ router.get('/vision/:siteId/history', authenticateToken, requireSiteOwnership, (req, res) => {
405
+ try {
406
+ const { limit, url } = req.query;
407
+ const history = vision.getVisionHistory(req.params.siteId, {
408
+ limit: limit ? parseInt(limit, 10) : undefined,
409
+ url,
410
+ });
411
+ res.json({ history });
412
+ } catch (err) {
413
+ res.status(500).json({ error: 'Failed to get vision history', details: err.message });
414
+ }
415
+ });
416
+
417
+ router.get('/vision/models', (_req, res) => {
418
+ try {
419
+ const models = vision.getSupportedModels();
420
+ res.json({ models });
421
+ } catch (err) {
422
+ res.status(500).json({ error: 'Failed to get supported models', details: err.message });
423
+ }
424
+ });
425
+
426
+ // ═════════════════════════════════════════════════════════════════════════════
427
+ // SWARM API
428
+ // ═════════════════════════════════════════════════════════════════════════════
429
+
430
+ router.put('/swarm/:siteId/config', authenticateToken, requireSiteOwnership, (req, res) => {
431
+ try {
432
+ const { name, strategy, maxAgents, timeoutMs, mergeStrategy } = req.body;
433
+ const config = swarm.configureSwarm(req.params.siteId, { name, strategy, maxAgents, timeoutMs, mergeStrategy });
434
+ res.json({ config });
435
+ } catch (err) {
436
+ res.status(500).json({ error: 'Failed to configure swarm', details: err.message });
437
+ }
438
+ });
439
+
440
+ router.get('/swarm/:siteId/config', authenticateToken, requireSiteOwnership, (req, res) => {
441
+ try {
442
+ const config = swarm.getSwarmConfig(req.params.siteId);
443
+ if (!config) return res.status(404).json({ error: 'Swarm not configured for this site' });
444
+ res.json({ config });
445
+ } catch (err) {
446
+ res.status(500).json({ error: 'Failed to get swarm config', details: err.message });
447
+ }
448
+ });
449
+
450
+ router.post('/swarm/:siteId/tasks', authenticateToken, requireSiteOwnership, (req, res) => {
451
+ try {
452
+ const { taskType, objective, parameters } = req.body;
453
+ if (!objective) return res.status(400).json({ error: 'objective is required' });
454
+
455
+ const task = swarm.createTask(req.params.siteId, {
456
+ taskType, objective, parameters, createdBy: req.user.id,
457
+ });
458
+ res.status(201).json({ task });
459
+ } catch (err) {
460
+ res.status(500).json({ error: 'Failed to create task', details: err.message });
461
+ }
462
+ });
463
+
464
+ router.post('/swarm/tasks/:taskId/agents', authenticateToken, (req, res) => {
465
+ try {
466
+ const { agents: agentDefinitions } = req.body;
467
+ if (!Array.isArray(agentDefinitions) || agentDefinitions.length === 0) {
468
+ return res.status(400).json({ error: 'agents (non-empty array) is required' });
469
+ }
470
+
471
+ const agents = swarm.assignAgents(req.params.taskId, agentDefinitions);
472
+ res.status(201).json({ agents });
473
+ } catch (err) {
474
+ const status = err.message.includes('not found') ? 404 : 500;
475
+ res.status(status).json({ error: 'Failed to assign agents', details: err.message });
476
+ }
477
+ });
478
+
479
+ router.post('/swarm/tasks/:taskId/run', authenticateToken, async (req, res) => {
480
+ try {
481
+ const result = await swarm.runSwarmTask(req.params.taskId);
482
+ res.json(result);
483
+ } catch (err) {
484
+ const status = err.message.includes('not found') ? 404
485
+ : err.message.includes('cancelled') ? 400
486
+ : err.message.includes('No agents') ? 400 : 500;
487
+ res.status(status).json({ error: 'Failed to run swarm task', details: err.message });
488
+ }
489
+ });
490
+
491
+ router.get('/swarm/tasks/:taskId', authenticateToken, (req, res) => {
492
+ try {
493
+ const status = swarm.getTaskStatus(req.params.taskId);
494
+ if (!status) return res.status(404).json({ error: 'Task not found' });
495
+ res.json({ task: status });
496
+ } catch (err) {
497
+ res.status(500).json({ error: 'Failed to get task status', details: err.message });
498
+ }
499
+ });
500
+
501
+ router.get('/swarm/tasks/:taskId/result', authenticateToken, (req, res) => {
502
+ try {
503
+ const result = swarm.getTaskResult(req.params.taskId);
504
+ if (!result) return res.status(404).json({ error: 'Task not found' });
505
+ res.json(result);
506
+ } catch (err) {
507
+ res.status(500).json({ error: 'Failed to get task result', details: err.message });
508
+ }
509
+ });
510
+
511
+ router.post('/swarm/tasks/:taskId/cancel', authenticateToken, (req, res) => {
512
+ try {
513
+ const result = swarm.cancelTask(req.params.taskId);
514
+ if (!result) return res.status(404).json({ error: 'Task not found' });
515
+ res.json(result);
516
+ } catch (err) {
517
+ res.status(500).json({ error: 'Failed to cancel task', details: err.message });
518
+ }
519
+ });
520
+
521
+ router.get('/swarm/:siteId/history', authenticateToken, requireSiteOwnership, (req, res) => {
522
+ try {
523
+ const { limit, taskType } = req.query;
524
+ const history = swarm.getSwarmHistory(req.params.siteId, {
525
+ limit: limit ? parseInt(limit, 10) : undefined,
526
+ taskType,
527
+ });
528
+ res.json({ history });
529
+ } catch (err) {
530
+ res.status(500).json({ error: 'Failed to get swarm history', details: err.message });
531
+ }
532
+ });
533
+
534
+ router.get('/swarm/:siteId/stats', authenticateToken, requireSiteOwnership, (req, res) => {
535
+ try {
536
+ const stats = swarm.getSwarmStats(req.params.siteId);
537
+ res.json({ stats });
538
+ } catch (err) {
539
+ res.status(500).json({ error: 'Failed to get swarm stats', details: err.message });
540
+ }
541
+ });
542
+
543
+ // ═════════════════════════════════════════════════════════════════════════════
544
+ // PLUGINS API
545
+ // ═════════════════════════════════════════════════════════════════════════════
546
+
547
+ router.get('/plugins/marketplace', (req, res) => {
548
+ try {
549
+ const { category, search, limit, offset } = req.query;
550
+ const result = plugins.listPlugins({
551
+ category, search,
552
+ limit: limit ? parseInt(limit, 10) : undefined,
553
+ offset: offset ? parseInt(offset, 10) : undefined,
554
+ });
555
+ res.json(result);
556
+ } catch (err) {
557
+ res.status(500).json({ error: 'Failed to list plugins', details: err.message });
558
+ }
559
+ });
560
+
561
+ router.get('/plugins/hooks', (req, res) => {
562
+ try {
563
+ const hooks = plugins.getAvailableHooks();
564
+ res.json({ hooks });
565
+ } catch (err) {
566
+ res.status(500).json({ error: 'Failed to get available hooks', details: err.message });
567
+ }
568
+ });
569
+
570
+ router.get('/plugins/:pluginId', authenticateToken, (req, res) => {
571
+ try {
572
+ const plugin = plugins.getPlugin(req.params.pluginId);
573
+ if (!plugin) return res.status(404).json({ error: 'Plugin not found' });
574
+ res.json({ plugin });
575
+ } catch (err) {
576
+ res.status(500).json({ error: 'Failed to get plugin', details: err.message });
577
+ }
578
+ });
579
+
580
+ router.post('/plugins/register', authenticateToken, (req, res) => {
581
+ try {
582
+ const { name, description, version, author, hooks, configSchema, category } = req.body;
583
+ if (!name || !version) return res.status(400).json({ error: 'name and version are required' });
584
+
585
+ const plugin = plugins.registerPlugin({
586
+ name, description, version, author, hooks, configSchema, category,
587
+ registeredBy: req.user.id,
588
+ });
589
+ res.status(201).json({ plugin });
590
+ } catch (err) {
591
+ res.status(500).json({ error: 'Failed to register plugin', details: err.message });
592
+ }
593
+ });
594
+
595
+ router.post('/plugins/:pluginId/install/:siteId', authenticateToken, requireSiteOwnership, (req, res) => {
596
+ try {
597
+ const { config } = req.body;
598
+ const installation = plugins.installPlugin(req.params.pluginId, req.params.siteId, req.user.id, config);
599
+ res.status(201).json({ installation });
600
+ } catch (err) {
601
+ const status = err.message.includes('not found') ? 404 : 500;
602
+ res.status(status).json({ error: 'Failed to install plugin', details: err.message });
603
+ }
604
+ });
605
+
606
+ router.delete('/plugins/:pluginId/uninstall/:siteId', authenticateToken, requireSiteOwnership, (req, res) => {
607
+ try {
608
+ const ok = plugins.uninstallPlugin(req.params.pluginId, req.params.siteId);
609
+ if (!ok) return res.status(404).json({ error: 'Plugin installation not found' });
610
+ res.json({ success: true });
611
+ } catch (err) {
612
+ res.status(500).json({ error: 'Failed to uninstall plugin', details: err.message });
613
+ }
614
+ });
615
+
616
+ router.put('/plugins/installations/:installationId/config', authenticateToken, (req, res) => {
617
+ try {
618
+ const { config } = req.body;
619
+ if (!config) return res.status(400).json({ error: 'config is required' });
620
+
621
+ const result = plugins.configurePlugin(req.params.installationId, config);
622
+ if (!result) return res.status(404).json({ error: 'Installation not found' });
623
+ res.json({ installation: result });
624
+ } catch (err) {
625
+ res.status(500).json({ error: 'Failed to configure plugin', details: err.message });
626
+ }
627
+ });
628
+
629
+ router.get('/plugins/installed/:siteId', authenticateToken, requireSiteOwnership, (req, res) => {
630
+ try {
631
+ const installed = plugins.getInstalledPlugins(req.params.siteId);
632
+ res.json({ plugins: installed });
633
+ } catch (err) {
634
+ res.status(500).json({ error: 'Failed to get installed plugins', details: err.message });
635
+ }
636
+ });
637
+
638
+ router.post('/plugins/:pluginId/rate', authenticateToken, (req, res) => {
639
+ try {
640
+ const { rating, review } = req.body;
641
+ if (rating == null || rating < 1 || rating > 5) {
642
+ return res.status(400).json({ error: 'rating (1-5) is required' });
643
+ }
644
+
645
+ const result = plugins.ratePlugin(req.params.pluginId, req.user.id, rating);
646
+ res.status(201).json(result);
647
+ } catch (err) {
648
+ const status = err.message.includes('not found') ? 404 : 500;
649
+ res.status(status).json({ error: 'Failed to rate plugin', details: err.message });
650
+ }
651
+ });
652
+
653
+ router.get('/plugins/:pluginId/stats', authenticateToken, (req, res) => {
654
+ try {
655
+ const stats = plugins.getPluginStats(req.params.pluginId);
656
+ if (!stats) return res.status(404).json({ error: 'Plugin not found' });
657
+ res.json({ stats });
658
+ } catch (err) {
659
+ res.status(500).json({ error: 'Failed to get plugin stats', details: err.message });
660
+ }
661
+ });
662
+
663
+ router.post('/plugins/hooks/:hookName/execute/:siteId', authenticateToken, requireSiteOwnership, async (req, res) => {
664
+ try {
665
+ const { payload } = req.body;
666
+ const result = await plugins.executeHook(req.params.hookName, req.params.siteId, payload || {});
667
+ res.json(result);
668
+ } catch (err) {
669
+ res.status(500).json({ error: 'Failed to execute hook', details: err.message });
670
+ }
671
+ });
672
+
673
+ router.get('/plugins/hooks/log/:siteId', authenticateToken, requireSiteOwnership, (req, res) => {
674
+ try {
675
+ const { limit, hookName } = req.query;
676
+ const logs = plugins.getHookExecutionLog(req.params.siteId, {
677
+ limit: limit ? parseInt(limit, 10) : undefined,
678
+ hookName,
679
+ });
680
+ res.json({ logs });
681
+ } catch (err) {
682
+ res.status(500).json({ error: 'Failed to get hook execution log', details: err.message });
683
+ }
684
+ });
685
+
686
+ module.exports = router;