snow-flow 3.0.9 → 3.0.13

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 (302) hide show
  1. package/claude-flow.bat +0 -0
  2. package/claude-flow.ps1 +0 -0
  3. package/dist/mcp/intelligent-reporting-mcp.d.ts +7 -0
  4. package/dist/mcp/intelligent-reporting-mcp.js +379 -0
  5. package/dist/mcp/servicenow-automation-mcp.js +0 -0
  6. package/dist/mcp/servicenow-deployment-mcp.js +0 -0
  7. package/dist/mcp/servicenow-integration-mcp.js +0 -0
  8. package/dist/mcp/servicenow-mcp-server.js +0 -0
  9. package/dist/mcp/servicenow-operations-mcp.js +0 -0
  10. package/dist/mcp/servicenow-platform-development-mcp.js +0 -0
  11. package/dist/mcp/servicenow-progressive-indexer.js +0 -0
  12. package/dist/mcp/servicenow-reporting-analytics-mcp.js +280 -29
  13. package/dist/mcp/servicenow-security-compliance-mcp.js +0 -0
  14. package/dist/mcp/servicenow-update-set-mcp.js +0 -0
  15. package/dist/mcp/start-all-mcp-servers.js +0 -0
  16. package/dist/mcp/start-servicenow-mcp.js +0 -0
  17. package/dist/services/widget-deployment-service.d.ts +2 -1
  18. package/dist/services/widget-deployment-service.js +17 -16
  19. package/dist/utils/anti-mock-data-validator.d.ts +66 -0
  20. package/dist/utils/anti-mock-data-validator.js +316 -0
  21. package/dist/utils/servicenow-eventual-consistency.d.ts +120 -0
  22. package/dist/utils/servicenow-eventual-consistency.js +220 -0
  23. package/memory/agents/README.md +1 -1
  24. package/memory/claude-flow-data.json +1 -1
  25. package/memory/sessions/README.md +1 -1
  26. package/package.json +4 -3
  27. package/.mcp.json +0 -22
  28. package/claude-flow.config.json +0 -20
  29. package/dist/agents/app-creator.agent.d.ts +0 -55
  30. package/dist/agents/app-creator.agent.js +0 -1292
  31. package/dist/agents/base/base-snow-agent.d.ts +0 -75
  32. package/dist/agents/base/base-snow-agent.js +0 -169
  33. package/dist/agents/base-snow-agent.d.ts +0 -63
  34. package/dist/agents/base-snow-agent.js +0 -296
  35. package/dist/agents/coordinator.d.ts +0 -200
  36. package/dist/agents/coordinator.js +0 -777
  37. package/dist/agents/flow-builder-agent.d.ts +0 -18
  38. package/dist/agents/flow-builder-agent.js +0 -197
  39. package/dist/agents/queen-403-handler.d.ts +0 -47
  40. package/dist/agents/queen-403-handler.js +0 -175
  41. package/dist/agents/queen-agent-example.d.ts +0 -23
  42. package/dist/agents/queen-agent-example.js +0 -240
  43. package/dist/agents/queen-agent.test.d.ts +0 -6
  44. package/dist/agents/script-generator.agent.d.ts +0 -32
  45. package/dist/agents/script-generator.agent.js +0 -772
  46. package/dist/agents/script-writer-agent.d.ts +0 -22
  47. package/dist/agents/script-writer-agent.js +0 -695
  48. package/dist/agents/security-agent.d.ts +0 -23
  49. package/dist/agents/security-agent.js +0 -619
  50. package/dist/agents/specialists/automation-specialist.agent.d.ts +0 -44
  51. package/dist/agents/specialists/automation-specialist.agent.js +0 -204
  52. package/dist/agents/specialists/data-specialist.agent.d.ts +0 -165
  53. package/dist/agents/specialists/data-specialist.agent.js +0 -484
  54. package/dist/agents/specialists/integration-specialist.agent.d.ts +0 -227
  55. package/dist/agents/specialists/integration-specialist.agent.js +0 -725
  56. package/dist/agents/specialists/reporting-specialist.agent.d.ts +0 -54
  57. package/dist/agents/specialists/reporting-specialist.agent.js +0 -193
  58. package/dist/agents/specialists/security-specialist.agent.d.ts +0 -85
  59. package/dist/agents/specialists/security-specialist.agent.js +0 -309
  60. package/dist/agents/teams/adaptive/adaptive-coordinator.agent.d.ts +0 -111
  61. package/dist/agents/teams/adaptive/adaptive-coordinator.agent.js +0 -383
  62. package/dist/agents/teams/base-team.d.ts +0 -72
  63. package/dist/agents/teams/base-team.js +0 -253
  64. package/dist/agents/teams/team-types.d.ts +0 -265
  65. package/dist/agents/teams/team-types.js +0 -3
  66. package/dist/agents/teams/widget/widget-architect.agent.d.ts +0 -61
  67. package/dist/agents/teams/widget/widget-architect.agent.js +0 -436
  68. package/dist/agents/teams/widget/widget-backend.agent.d.ts +0 -74
  69. package/dist/agents/teams/widget/widget-backend.agent.js +0 -1531
  70. package/dist/agents/teams/widget/widget-frontend.agent.d.ts +0 -67
  71. package/dist/agents/teams/widget/widget-frontend.agent.js +0 -1014
  72. package/dist/agents/teams/widget/widget-platform.agent.d.ts +0 -90
  73. package/dist/agents/teams/widget/widget-platform.agent.js +0 -1190
  74. package/dist/agents/teams/widget/widget-uiux.agent.d.ts +0 -107
  75. package/dist/agents/teams/widget/widget-uiux.agent.js +0 -1033
  76. package/dist/agents/test-agent.d.ts +0 -26
  77. package/dist/agents/test-agent.js +0 -734
  78. package/dist/agents/test-agents.d.ts +0 -7
  79. package/dist/agents/test-agents.js +0 -64
  80. package/dist/agents/ui-builder.agent.d.ts +0 -50
  81. package/dist/agents/ui-builder.agent.js +0 -1539
  82. package/dist/agents/widget-builder.agent.d.ts +0 -32
  83. package/dist/agents/widget-builder.agent.js +0 -439
  84. package/dist/agents/widget-creator-agent.d.ts +0 -18
  85. package/dist/agents/widget-creator-agent.js +0 -498
  86. package/dist/agents/workflow-designer.agent.d.ts +0 -31
  87. package/dist/agents/workflow-designer.agent.js +0 -583
  88. package/dist/api/error-handling.d.ts +0 -325
  89. package/dist/api/error-handling.js +0 -1488
  90. package/dist/api/flow-designer-api.d.ts +0 -167
  91. package/dist/api/flow-designer-api.js +0 -554
  92. package/dist/api/natural-language-mapper.d.ts +0 -124
  93. package/dist/api/natural-language-mapper.js +0 -501
  94. package/dist/api/performance-optimizer.d.ts +0 -240
  95. package/dist/api/performance-optimizer.js +0 -706
  96. package/dist/api/transaction-manager.d.ts +0 -189
  97. package/dist/api/transaction-manager.js +0 -576
  98. package/dist/assembly/team-assembler.d.ts +0 -140
  99. package/dist/assembly/team-assembler.js +0 -502
  100. package/dist/benchmark-performance.d.ts +0 -41
  101. package/dist/benchmark-performance.js +0 -230
  102. package/dist/cli/snow-flow-cli-integration.d.ts +0 -30
  103. package/dist/cli/snow-flow-cli-integration.js +0 -396
  104. package/dist/coordination/coordination-engine.d.ts +0 -41
  105. package/dist/coordination/coordination-engine.js +0 -324
  106. package/dist/coordination/coordination.test.d.ts +0 -6
  107. package/dist/coordination/example.d.ts +0 -31
  108. package/dist/coordination/example.js +0 -394
  109. package/dist/coordination/execution-patterns.d.ts +0 -43
  110. package/dist/coordination/execution-patterns.js +0 -507
  111. package/dist/coordination/factory.d.ts +0 -94
  112. package/dist/coordination/factory.js +0 -433
  113. package/dist/coordination/index.d.ts +0 -71
  114. package/dist/coordination/index.js +0 -135
  115. package/dist/coordination/progress-monitor.d.ts +0 -71
  116. package/dist/coordination/progress-monitor.js +0 -505
  117. package/dist/coordination/quality-gates.d.ts +0 -124
  118. package/dist/coordination/quality-gates.js +0 -577
  119. package/dist/coordination/shared-memory.d.ts +0 -39
  120. package/dist/coordination/shared-memory.js +0 -289
  121. package/dist/coordination/task-dependencies.d.ts +0 -50
  122. package/dist/coordination/task-dependencies.js +0 -407
  123. package/dist/coordination/team-coordinator.d.ts +0 -59
  124. package/dist/coordination/team-coordinator.js +0 -550
  125. package/dist/coordination/types.d.ts +0 -152
  126. package/dist/coordination/types.js +0 -3
  127. package/dist/mcp/mcp-wrapper.d.ts +0 -8
  128. package/dist/mcp/mcp-wrapper.js +0 -77
  129. package/dist/mcp/servicenow-flow-composer-enhanced.js +0 -396
  130. package/dist/mcp/servicenow-flow-composer-mcp.d.ts +0 -7
  131. package/dist/mcp/servicenow-flow-composer-mcp.js +0 -3103
  132. package/dist/mcp/servicenow-graph-memory-mcp.d.ts +0 -7
  133. package/dist/mcp/servicenow-intelligent-mcp.d.ts +0 -143
  134. package/dist/mcp/servicenow-intelligent-mcp.js +0 -4156
  135. package/dist/mcp/servicenow-xml-flow-mcp.d.ts +0 -53
  136. package/dist/mcp/servicenow-xml-flow-mcp.js +0 -1704
  137. package/dist/mcp/singleton-check.js +0 -31
  138. package/dist/mcp/test-simple-mcp.d.ts +0 -6
  139. package/dist/mcp/test-simple-mcp.js +0 -63
  140. package/dist/memory/hierarchical-memory-system.d.ts +0 -90
  141. package/dist/memory/hierarchical-memory-system.js +0 -400
  142. package/dist/memory/index.d.ts +0 -9
  143. package/dist/memory/index.js +0 -20
  144. package/dist/memory/mcp-integration-example.d.ts +0 -6
  145. package/dist/memory/mcp-integration-example.js +0 -281
  146. package/dist/memory/memory-client.d.ts +0 -199
  147. package/dist/memory/memory-client.js +0 -364
  148. package/dist/memory/memory-manager.d.ts +0 -29
  149. package/dist/memory/memory-manager.js +0 -280
  150. package/dist/memory/memory-operations.d.ts +0 -179
  151. package/dist/memory/memory-operations.js +0 -691
  152. package/dist/memory/memory-system.d.ts +0 -153
  153. package/dist/memory/memory-system.js +0 -651
  154. package/dist/memory/memory-test.d.ts +0 -6
  155. package/dist/memory/memory-test.js +0 -161
  156. package/dist/memory/snow-flow-memory-patterns.d.ts +0 -213
  157. package/dist/memory/snow-flow-memory-patterns.js +0 -200
  158. package/dist/memory/snow-memory.d.ts +0 -54
  159. package/dist/memory/snow-memory.js +0 -301
  160. package/dist/memory/swarm-memory.d.ts +0 -135
  161. package/dist/memory/swarm-memory.js +0 -378
  162. package/dist/optimization/flow-performance-optimizer.js +0 -723
  163. package/dist/orchestration/discovery/service-discovery.d.ts +0 -81
  164. package/dist/orchestration/discovery/service-discovery.js +0 -808
  165. package/dist/orchestration/distributed-orchestrator.d.ts +0 -131
  166. package/dist/orchestration/distributed-orchestrator.js +0 -712
  167. package/dist/orchestration/distribution/task-distribution-engine.d.ts +0 -53
  168. package/dist/orchestration/distribution/task-distribution-engine.js +0 -586
  169. package/dist/orchestration/flow-update-orchestrator.js +0 -648
  170. package/dist/orchestration/interfaces/distributed-orchestration.interface.d.ts +0 -606
  171. package/dist/orchestration/interfaces/distributed-orchestration.interface.js +0 -65
  172. package/dist/orchestration/protocols/mcpx-protocol.d.ts +0 -71
  173. package/dist/orchestration/protocols/mcpx-protocol.js +0 -668
  174. package/dist/orchestration/state/distributed-state-manager.d.ts +0 -89
  175. package/dist/orchestration/state/distributed-state-manager.js +0 -716
  176. package/dist/orchestrator/flow-composer.d.ts +0 -105
  177. package/dist/orchestrator/flow-composer.js +0 -404
  178. package/dist/orchestrator/flow-pattern-templates.d.ts +0 -260
  179. package/dist/orchestrator/flow-pattern-templates.js +0 -908
  180. package/dist/orchestrator/flow-subflow-decision-engine.d.ts +0 -202
  181. package/dist/orchestrator/flow-subflow-decision-engine.js +0 -769
  182. package/dist/orchestrator/flow-validation-engine.d.ts +0 -169
  183. package/dist/orchestrator/flow-validation-engine.js +0 -913
  184. package/dist/orchestrator/snow-orchestrator.d.ts +0 -49
  185. package/dist/orchestrator/snow-orchestrator.js +0 -235
  186. package/dist/orchestrator/subflow-creation-handler.d.ts +0 -230
  187. package/dist/orchestrator/subflow-creation-handler.js +0 -791
  188. package/dist/patterns/adaptive-patterns.d.ts +0 -140
  189. package/dist/patterns/adaptive-patterns.js +0 -549
  190. package/dist/queen/advanced-integration-test.d.ts +0 -48
  191. package/dist/queen/advanced-integration-test.js +0 -473
  192. package/dist/queen/integration-example.d.ts +0 -82
  193. package/dist/queen/integration-example.js +0 -219
  194. package/dist/queen/integration-test.d.ts +0 -72
  195. package/dist/queen/integration-test.js +0 -563
  196. package/dist/queen/mock-mcp-client.d.ts +0 -71
  197. package/dist/queen/mock-mcp-client.js +0 -317
  198. package/dist/queen/run-integration-tests.d.ts +0 -9
  199. package/dist/queen/run-integration-tests.js +0 -27
  200. package/dist/sparc/coordinators/adaptive-coordinator.d.ts +0 -54
  201. package/dist/sparc/coordinators/adaptive-coordinator.js +0 -367
  202. package/dist/sparc/coordinators/team-coordinator.d.ts +0 -66
  203. package/dist/sparc/coordinators/team-coordinator.js +0 -402
  204. package/dist/sparc/modes/team-modes.d.ts +0 -33
  205. package/dist/sparc/modes/team-modes.js +0 -399
  206. package/dist/sparc/teams/application-team.d.ts +0 -73
  207. package/dist/sparc/teams/application-team.js +0 -463
  208. package/dist/sparc/teams/flow-team.d.ts +0 -67
  209. package/dist/sparc/teams/flow-team.js +0 -373
  210. package/dist/sparc/teams/widget-team.d.ts +0 -61
  211. package/dist/sparc/teams/widget-team.js +0 -280
  212. package/dist/specialists/app-specialists.d.ts +0 -93
  213. package/dist/specialists/app-specialists.js +0 -1639
  214. package/dist/specialists/base-specialist.d.ts +0 -19
  215. package/dist/specialists/base-specialist.js +0 -54
  216. package/dist/specialists/flow-specialists.d.ts +0 -113
  217. package/dist/specialists/flow-specialists.js +0 -1787
  218. package/dist/specialists/individual-specialists.d.ts +0 -67
  219. package/dist/specialists/individual-specialists.js +0 -632
  220. package/dist/specialists/widget-specialists.d.ts +0 -70
  221. package/dist/specialists/widget-specialists.js +0 -1264
  222. package/dist/src/utils/agent-detector.js +0 -655
  223. package/dist/teams/adaptive-team.d.ts +0 -81
  224. package/dist/teams/adaptive-team.js +0 -1153
  225. package/dist/teams/application-team.d.ts +0 -30
  226. package/dist/teams/application-team.js +0 -547
  227. package/dist/teams/base-team.d.ts +0 -55
  228. package/dist/teams/base-team.js +0 -243
  229. package/dist/teams/flow-team.d.ts +0 -28
  230. package/dist/teams/flow-team.js +0 -525
  231. package/dist/teams/widget-team.d.ts +0 -26
  232. package/dist/teams/widget-team.js +0 -459
  233. package/dist/templates/flow-template-system.js +0 -625
  234. package/dist/test-fetch-incidents.d.ts +0 -2
  235. package/dist/test-fetch-incidents.js +0 -84
  236. package/dist/test-incident-access.d.ts +0 -2
  237. package/dist/test-incident-access.js +0 -72
  238. package/dist/test-iphone-flow.js +0 -189
  239. package/dist/test-limit-problem.d.ts +0 -2
  240. package/dist/test-limit-problem.js +0 -60
  241. package/dist/test-ml-batch-fix.d.ts +0 -2
  242. package/dist/test-ml-batch-fix.js +0 -104
  243. package/dist/test-ml-batch.d.ts +0 -2
  244. package/dist/test-ml-batch.js +0 -87
  245. package/dist/test-ml-query.d.ts +0 -2
  246. package/dist/test-ml-query.js +0 -100
  247. package/dist/test-ml-training-fix.d.ts +0 -12
  248. package/dist/test-ml-training-fix.js +0 -113
  249. package/dist/test-ml-training.d.ts +0 -2
  250. package/dist/test-ml-training.js +0 -32
  251. package/dist/test-operations-query.d.ts +0 -2
  252. package/dist/test-operations-query.js +0 -84
  253. package/dist/test-performance-query.d.ts +0 -2
  254. package/dist/test-performance-query.js +0 -52
  255. package/dist/test-singleton-protection.d.ts +0 -8
  256. package/dist/test-singleton-protection.js +0 -110
  257. package/dist/test-smart-limits.d.ts +0 -13
  258. package/dist/test-smart-limits.js +0 -100
  259. package/dist/test-snow-query-incidents.d.ts +0 -2
  260. package/dist/test-snow-query-incidents.js +0 -66
  261. package/dist/test-universal-query.d.ts +0 -2
  262. package/dist/test-universal-query.js +0 -106
  263. package/dist/testing/flow-testing-automation.js +0 -641
  264. package/dist/utils/complete-flow-xml-generator.js +0 -1285
  265. package/dist/utils/file-storage-fallback.d.ts +0 -62
  266. package/dist/utils/file-storage-fallback.js +0 -289
  267. package/dist/utils/flow-api-discovery.d.ts +0 -151
  268. package/dist/utils/flow-api-discovery.js +0 -439
  269. package/dist/utils/flow-examples.js +0 -720
  270. package/dist/utils/flow-structure-builder.js +0 -677
  271. package/dist/utils/flow-xml-generator.d.ts +0 -41
  272. package/dist/utils/flow-xml-generator.js +0 -258
  273. package/dist/utils/improved-flow-xml-generator.js +0 -820
  274. package/dist/utils/mcp-process-manager.backup.d.ts +0 -58
  275. package/dist/utils/mcp-process-manager.backup.js +0 -220
  276. package/dist/utils/mcp-singleton-enforcer.d.ts +0 -36
  277. package/dist/utils/mcp-singleton-enforcer.js +0 -201
  278. package/dist/utils/mcp-timeout-fix.d.ts +0 -53
  279. package/dist/utils/mcp-timeout-fix.js +0 -221
  280. package/dist/utils/migrate-claude-flow.d.ts +0 -22
  281. package/dist/utils/migrate-claude-flow.js +0 -120
  282. package/dist/utils/scope-utils.d.ts +0 -72
  283. package/dist/utils/scope-utils.js +0 -386
  284. package/dist/utils/snow-oauth-old.d.ts +0 -65
  285. package/dist/utils/snow-oauth-old.js +0 -345
  286. package/dist/utils/xml-first-flow-generator.js +0 -513
  287. package/memory/servicenow_artifacts/000d9224c895221055906c7518aa2d3d.json +0 -30
  288. package/memory/servicenow_artifacts/0196b66173303010e46b4a2214f6a7a2.json +0 -36
  289. package/memory/servicenow_artifacts/125e5d1d837e2a102a7ea130ceaad397.json +0 -30
  290. package/memory/servicenow_artifacts/7637c1f2b7112210a5e5911cde11a972.json +0 -30
  291. package/memory/servicenow_artifacts/default_documentation_tables_1754056582292.json +0 -55
  292. package/memory/servicenow_artifacts/default_documentation_tables_1754057477189.json +0 -55
  293. package/memory/update-set-sessions/01f82af583faea102a7ea130ceaad3d4.json +0 -9
  294. package/memory/update-set-sessions/27718fb983faea102a7ea130ceaad34b.json +0 -9
  295. package/memory/update-set-sessions/412e9bf6833e22502a7ea130ceaad30a.json +0 -8
  296. package/memory/update-set-sessions/66fc5a79837aea102a7ea130ceaad3ab.json +0 -9
  297. package/memory/update-set-sessions/71a30ff5837eea102a7ea130ceaad37f.json +0 -9
  298. package/memory/update-set-sessions/74fba27983faea102a7ea130ceaad3bd.json +0 -9
  299. package/memory/update-set-sessions/a0b147b5837eea102a7ea130ceaad344.json +0 -58
  300. package/memory/update-set-sessions/b13f5eb983baea102a7ea130ceaad33e.json +0 -9
  301. package/reports/swarm-auto-centralized-1752649029776.json +0 -13
  302. package/src/memory/README.md +0 -240
@@ -1,716 +0,0 @@
1
- "use strict";
2
- /**
3
- * Distributed State Management System
4
- *
5
- * Manages distributed shared memory and state synchronization across
6
- * external Claude Code instances using consensus algorithms and conflict resolution.
7
- */
8
- Object.defineProperty(exports, "__esModule", { value: true });
9
- exports.DistributedStateError = exports.DistributedStateManager = void 0;
10
- const events_1 = require("events");
11
- const distributed_orchestration_interface_js_1 = require("../interfaces/distributed-orchestration.interface.js");
12
- const logger_js_1 = require("../../utils/logger.js");
13
- class DistributedStateManager extends events_1.EventEmitter {
14
- constructor(instanceId, config) {
15
- super();
16
- this.config = config;
17
- this.localCache = new Map();
18
- this.subscriptions = new Map();
19
- this.instanceId = instanceId;
20
- this.distributedStore = new DistributedStore(config.storage);
21
- this.conflictResolver = new ConflictResolver(config.conflictResolution);
22
- this.eventBus = new EventBus(config.eventBus);
23
- this.consensusManager = new ConsensusManager(config.consensus);
24
- this.replicationManager = new ReplicationManager(config.replication);
25
- this.setupEventHandlers();
26
- this.startPeriodicSync();
27
- }
28
- // ========================================
29
- // Core State Management Operations
30
- // ========================================
31
- async store(key, value, ttl, consistency = distributed_orchestration_interface_js_1.ConsistencyLevel.EVENTUAL) {
32
- logger_js_1.logger.info(`💾 Storing distributed state`, { key, consistency, ttl });
33
- try {
34
- // Create memory value with metadata
35
- const memoryValue = {
36
- value,
37
- timestamp: Date.now(),
38
- version: await this.getNextVersion(key),
39
- instanceId: this.instanceId,
40
- metadata: {
41
- ttl: ttl ? Date.now() + ttl : undefined,
42
- checksum: this.calculateChecksum(value),
43
- consistency,
44
- tags: this.extractTags(key, value)
45
- }
46
- };
47
- // Handle different consistency levels
48
- switch (consistency) {
49
- case distributed_orchestration_interface_js_1.ConsistencyLevel.STRONG:
50
- await this.storeWithStrongConsistency(key, memoryValue);
51
- break;
52
- case distributed_orchestration_interface_js_1.ConsistencyLevel.EVENTUAL:
53
- await this.storeWithEventualConsistency(key, memoryValue);
54
- break;
55
- case distributed_orchestration_interface_js_1.ConsistencyLevel.WEAK:
56
- await this.storeWithWeakConsistency(key, memoryValue);
57
- break;
58
- }
59
- logger_js_1.logger.info(`✅ Successfully stored state: ${key}`);
60
- this.emit('state:stored', { key, value: memoryValue, consistency });
61
- }
62
- catch (error) {
63
- logger_js_1.logger.error(`❌ Failed to store state: ${key}`, { error: error.message });
64
- throw new DistributedStateError(`Store operation failed: ${error.message}`);
65
- }
66
- }
67
- async retrieve(key, consistency = distributed_orchestration_interface_js_1.ConsistencyLevel.EVENTUAL) {
68
- logger_js_1.logger.debug(`🔍 Retrieving distributed state: ${key}`, { consistency });
69
- try {
70
- let memoryValue = null;
71
- switch (consistency) {
72
- case distributed_orchestration_interface_js_1.ConsistencyLevel.STRONG:
73
- memoryValue = await this.retrieveWithStrongConsistency(key);
74
- break;
75
- case distributed_orchestration_interface_js_1.ConsistencyLevel.EVENTUAL:
76
- memoryValue = await this.retrieveWithEventualConsistency(key);
77
- break;
78
- case distributed_orchestration_interface_js_1.ConsistencyLevel.WEAK:
79
- memoryValue = await this.retrieveWithWeakConsistency(key);
80
- break;
81
- }
82
- if (!memoryValue) {
83
- logger_js_1.logger.debug(`🔍 State not found: ${key}`);
84
- return undefined;
85
- }
86
- // Check TTL expiration
87
- if (this.isExpired(memoryValue)) {
88
- await this.delete(key);
89
- return undefined;
90
- }
91
- logger_js_1.logger.debug(`✅ Successfully retrieved state: ${key}`);
92
- this.emit('state:retrieved', { key, value: memoryValue, consistency });
93
- return memoryValue.value;
94
- }
95
- catch (error) {
96
- logger_js_1.logger.error(`❌ Failed to retrieve state: ${key}`, { error: error.message });
97
- throw new DistributedStateError(`Retrieve operation failed: ${error.message}`);
98
- }
99
- }
100
- async delete(key) {
101
- logger_js_1.logger.info(`🗑️ Deleting distributed state: ${key}`);
102
- try {
103
- // Remove from local cache
104
- this.localCache.delete(key);
105
- // Remove from distributed store
106
- await this.distributedStore.delete(key);
107
- // Notify subscribers
108
- this.notifySubscribers(key, undefined, 'delete');
109
- logger_js_1.logger.info(`✅ Successfully deleted state: ${key}`);
110
- this.emit('state:deleted', { key });
111
- }
112
- catch (error) {
113
- logger_js_1.logger.error(`❌ Failed to delete state: ${key}`, { error: error.message });
114
- throw new DistributedStateError(`Delete operation failed: ${error.message}`);
115
- }
116
- }
117
- // ========================================
118
- // Subscription Management
119
- // ========================================
120
- async subscribe(pattern, callback) {
121
- const subscriptionId = this.generateSubscriptionId();
122
- logger_js_1.logger.info(`👁️ Creating subscription: ${subscriptionId}`, { pattern });
123
- const subscription = {
124
- id: subscriptionId,
125
- pattern,
126
- callback,
127
- createdAt: new Date(),
128
- lastNotified: new Date()
129
- };
130
- this.subscriptions.set(subscriptionId, subscription);
131
- // Register with event bus
132
- await this.eventBus.subscribe(`state.${pattern}`, (event) => {
133
- this.handleSubscriptionEvent(subscriptionId, event);
134
- });
135
- logger_js_1.logger.info(`✅ Subscription created: ${subscriptionId}`);
136
- return subscriptionId;
137
- }
138
- async unsubscribe(subscriptionId) {
139
- logger_js_1.logger.info(`🛑 Removing subscription: ${subscriptionId}`);
140
- const subscription = this.subscriptions.get(subscriptionId);
141
- if (!subscription) {
142
- throw new DistributedStateError(`Subscription not found: ${subscriptionId}`);
143
- }
144
- // Unregister from event bus
145
- await this.eventBus.unsubscribe(`state.${subscription.pattern}`);
146
- // Remove from local subscriptions
147
- this.subscriptions.delete(subscriptionId);
148
- logger_js_1.logger.info(`✅ Subscription removed: ${subscriptionId}`);
149
- }
150
- // ========================================
151
- // State Synchronization
152
- // ========================================
153
- async synchronize(targetInstances, keys) {
154
- logger_js_1.logger.info(`🔄 Starting state synchronization`, {
155
- targetInstances: targetInstances.length,
156
- keys: keys?.length || 'all'
157
- });
158
- const startTime = Date.now();
159
- const synchronized = [];
160
- const conflicts = [];
161
- const errors = [];
162
- try {
163
- // Determine which keys to sync
164
- const keysToSync = keys || Array.from(this.localCache.keys());
165
- // Sync each key with target instances
166
- for (const key of keysToSync) {
167
- try {
168
- const keyResult = await this.synchronizeKey(key, targetInstances);
169
- if (keyResult.synchronized) {
170
- synchronized.push(key);
171
- }
172
- conflicts.push(...keyResult.conflicts);
173
- errors.push(...keyResult.errors);
174
- }
175
- catch (error) {
176
- logger_js_1.logger.warn(`⚠️ Failed to sync key: ${key}`, { error: error.message });
177
- errors.push({
178
- instanceId: 'local',
179
- error: `Key sync failed: ${error.message}`,
180
- retryable: true
181
- });
182
- }
183
- }
184
- // Resolve conflicts if any
185
- if (conflicts.length > 0) {
186
- await this.resolveConflicts(conflicts);
187
- }
188
- const result = {
189
- success: errors.length === 0,
190
- synchronized,
191
- conflicts: conflicts.filter(c => !c.resolutionStrategy),
192
- errors,
193
- duration: Date.now() - startTime
194
- };
195
- logger_js_1.logger.info(`✅ Synchronization completed`, {
196
- synchronized: synchronized.length,
197
- conflicts: conflicts.length,
198
- errors: errors.length,
199
- duration: result.duration
200
- });
201
- this.emit('state:synchronized', result);
202
- return result;
203
- }
204
- catch (error) {
205
- logger_js_1.logger.error(`❌ Synchronization failed`, { error: error.message });
206
- return {
207
- success: false,
208
- synchronized,
209
- conflicts,
210
- errors: [...errors, {
211
- instanceId: 'local',
212
- error: `Sync operation failed: ${error.message}`,
213
- retryable: false
214
- }],
215
- duration: Date.now() - startTime
216
- };
217
- }
218
- }
219
- // ========================================
220
- // Consistency Implementation
221
- // ========================================
222
- async storeWithStrongConsistency(key, memoryValue) {
223
- logger_js_1.logger.debug(`🔒 Strong consistency store: ${key}`);
224
- // 1. Propose change to consensus group
225
- const proposal = await this.consensusManager.proposeChange({
226
- type: 'store',
227
- key,
228
- value: memoryValue,
229
- proposer: this.instanceId
230
- });
231
- if (!proposal.approved) {
232
- throw new DistributedStateError(`Consensus failed for key: ${key}`);
233
- }
234
- // 2. Store locally after consensus
235
- this.localCache.set(key, memoryValue);
236
- // 3. Replicate to all nodes synchronously
237
- await this.replicationManager.replicateSync(key, memoryValue);
238
- // 4. Notify subscribers
239
- this.notifySubscribers(key, memoryValue, 'create');
240
- }
241
- async storeWithEventualConsistency(key, memoryValue) {
242
- logger_js_1.logger.debug(`⏰ Eventual consistency store: ${key}`);
243
- // 1. Store locally first
244
- this.localCache.set(key, memoryValue);
245
- // 2. Replicate asynchronously
246
- this.replicationManager.replicateAsync(key, memoryValue)
247
- .catch(error => {
248
- logger_js_1.logger.warn(`⚠️ Async replication failed for key: ${key}`, { error: error.message });
249
- });
250
- // 3. Notify subscribers immediately
251
- this.notifySubscribers(key, memoryValue, 'create');
252
- }
253
- async storeWithWeakConsistency(key, memoryValue) {
254
- logger_js_1.logger.debug(`📡 Weak consistency store: ${key}`);
255
- // 1. Store locally only
256
- this.localCache.set(key, memoryValue);
257
- // 2. Broadcast change event (best effort)
258
- this.eventBus.broadcast('state.changed', { key, value: memoryValue, instanceId: this.instanceId })
259
- .catch(error => {
260
- logger_js_1.logger.debug(`📡 Broadcast failed for key: ${key}`, { error: error.message });
261
- });
262
- // 3. Notify local subscribers
263
- this.notifySubscribers(key, memoryValue, 'create');
264
- }
265
- async retrieveWithStrongConsistency(key) {
266
- logger_js_1.logger.debug(`🔒 Strong consistency retrieve: ${key}`);
267
- // Read from consensus group to ensure latest value
268
- const consensusValue = await this.consensusManager.readWithConsensus(key);
269
- if (consensusValue) {
270
- // Update local cache with consensus value
271
- this.localCache.set(key, consensusValue);
272
- return consensusValue;
273
- }
274
- return null;
275
- }
276
- async retrieveWithEventualConsistency(key) {
277
- logger_js_1.logger.debug(`⏰ Eventual consistency retrieve: ${key}`);
278
- // Check local cache first
279
- const localValue = this.localCache.get(key);
280
- if (localValue) {
281
- return localValue;
282
- }
283
- // Fallback to distributed store
284
- const distributedValue = await this.distributedStore.read(key);
285
- if (distributedValue) {
286
- this.localCache.set(key, distributedValue);
287
- return distributedValue;
288
- }
289
- return null;
290
- }
291
- async retrieveWithWeakConsistency(key) {
292
- logger_js_1.logger.debug(`📡 Weak consistency retrieve: ${key}`);
293
- // Only check local cache for weak consistency
294
- return this.localCache.get(key) || null;
295
- }
296
- // ========================================
297
- // Key Synchronization
298
- // ========================================
299
- async synchronizeKey(key, targetInstances) {
300
- const localValue = this.localCache.get(key);
301
- const synchronized = [];
302
- const conflicts = [];
303
- const errors = [];
304
- for (const instanceId of targetInstances) {
305
- try {
306
- const remoteValue = await this.getRemoteValue(instanceId, key);
307
- if (!remoteValue && localValue) {
308
- // Local has value, remote doesn't - push to remote
309
- await this.pushValueToRemote(instanceId, key, localValue);
310
- synchronized.push(true);
311
- }
312
- else if (remoteValue && !localValue) {
313
- // Remote has value, local doesn't - pull from remote
314
- this.localCache.set(key, remoteValue);
315
- synchronized.push(true);
316
- }
317
- else if (remoteValue && localValue) {
318
- // Both have values - check for conflicts
319
- const conflict = this.detectConflict(key, localValue, remoteValue);
320
- if (conflict) {
321
- conflicts.push(conflict);
322
- synchronized.push(false);
323
- }
324
- else {
325
- // Values are compatible
326
- synchronized.push(true);
327
- }
328
- }
329
- else {
330
- // Neither has value - nothing to sync
331
- synchronized.push(true);
332
- }
333
- }
334
- catch (error) {
335
- logger_js_1.logger.warn(`⚠️ Failed to sync key ${key} with instance: ${instanceId}`, { error: error.message });
336
- errors.push({
337
- instanceId,
338
- error: error.message,
339
- retryable: true
340
- });
341
- synchronized.push(false);
342
- }
343
- }
344
- return {
345
- synchronized: synchronized.every(s => s),
346
- conflicts,
347
- errors
348
- };
349
- }
350
- async getRemoteValue(instanceId, key) {
351
- // Implementation would make remote call to get value
352
- // For now, return null (would use MCPX protocol)
353
- return null;
354
- }
355
- async pushValueToRemote(instanceId, key, value) {
356
- // Implementation would push value to remote instance
357
- // For now, just log (would use MCPX protocol)
358
- logger_js_1.logger.debug(`📤 Pushing value to remote: ${instanceId}`, { key });
359
- }
360
- // ========================================
361
- // Conflict Detection and Resolution
362
- // ========================================
363
- detectConflict(key, localValue, remoteValue) {
364
- // Check if values conflict
365
- if (localValue.version !== remoteValue.version ||
366
- localValue.timestamp !== remoteValue.timestamp ||
367
- localValue.metadata?.checksum !== remoteValue.metadata?.checksum) {
368
- return {
369
- key,
370
- localValue,
371
- remoteValues: new Map([[remoteValue.instanceId, remoteValue]]),
372
- resolutionStrategy: this.selectConflictResolutionStrategy(localValue, remoteValue)
373
- };
374
- }
375
- return null;
376
- }
377
- selectConflictResolutionStrategy(localValue, remoteValue) {
378
- // Default to last write wins
379
- return {
380
- type: 'last_write_wins',
381
- parameters: {}
382
- };
383
- }
384
- async resolveConflicts(conflicts) {
385
- logger_js_1.logger.info(`🔧 Resolving ${conflicts.length} conflicts`);
386
- for (const conflict of conflicts) {
387
- try {
388
- const resolution = await this.conflictResolver.resolve(conflict);
389
- if (resolution.resolved) {
390
- // Apply resolution
391
- this.localCache.set(conflict.key, resolution.resolvedValue);
392
- logger_js_1.logger.info(`✅ Conflict resolved for key: ${conflict.key}`);
393
- }
394
- else {
395
- logger_js_1.logger.warn(`⚠️ Could not resolve conflict for key: ${conflict.key}`);
396
- }
397
- }
398
- catch (error) {
399
- logger_js_1.logger.error(`❌ Failed to resolve conflict for key: ${conflict.key}`, { error: error.message });
400
- }
401
- }
402
- }
403
- // ========================================
404
- // Event Handling and Subscriptions
405
- // ========================================
406
- setupEventHandlers() {
407
- // Handle remote state changes
408
- this.eventBus.on('state.remote_change', (event) => {
409
- this.handleRemoteStateChange(event);
410
- });
411
- // Handle consensus events
412
- this.consensusManager.on('consensus.change', (event) => {
413
- this.handleConsensusChange(event);
414
- });
415
- // Handle replication events
416
- this.replicationManager.on('replication.conflict', (event) => {
417
- this.handleReplicationConflict(event);
418
- });
419
- }
420
- handleRemoteStateChange(event) {
421
- logger_js_1.logger.debug(`📡 Remote state change received`, { key: event.key, source: event.sourceInstance });
422
- // Update local cache with remote change
423
- if (event.operation === 'store') {
424
- this.localCache.set(event.key, event.value);
425
- this.notifySubscribers(event.key, event.value, 'update');
426
- }
427
- else if (event.operation === 'delete') {
428
- this.localCache.delete(event.key);
429
- this.notifySubscribers(event.key, undefined, 'delete');
430
- }
431
- }
432
- handleConsensusChange(event) {
433
- logger_js_1.logger.info(`🗳️ Consensus change applied`, { key: event.key });
434
- // Apply consensus decision to local state
435
- if (event.decision.approved) {
436
- this.localCache.set(event.key, event.decision.value);
437
- this.notifySubscribers(event.key, event.decision.value, 'update');
438
- }
439
- }
440
- handleReplicationConflict(event) {
441
- logger_js_1.logger.warn(`⚔️ Replication conflict detected`, { key: event.key });
442
- // Queue conflict for resolution
443
- this.resolveConflicts([event.conflict]).catch(error => {
444
- logger_js_1.logger.error(`❌ Failed to resolve replication conflict`, { error: error.message });
445
- });
446
- }
447
- notifySubscribers(key, value, changeType) {
448
- this.subscriptions.forEach((subscription, subscriptionId) => {
449
- if (this.matchesPattern(key, subscription.pattern)) {
450
- try {
451
- subscription.callback(key, value, changeType);
452
- subscription.lastNotified = new Date();
453
- }
454
- catch (error) {
455
- logger_js_1.logger.error(`❌ Subscription callback failed: ${subscriptionId}`, { error: error.message });
456
- }
457
- }
458
- });
459
- }
460
- handleSubscriptionEvent(subscriptionId, event) {
461
- const subscription = this.subscriptions.get(subscriptionId);
462
- if (subscription) {
463
- try {
464
- subscription.callback(event.key, event.value, event.changeType);
465
- subscription.lastNotified = new Date();
466
- }
467
- catch (error) {
468
- logger_js_1.logger.error(`❌ Subscription event handling failed: ${subscriptionId}`, { error: error.message });
469
- }
470
- }
471
- }
472
- // ========================================
473
- // Utility Methods
474
- // ========================================
475
- async getNextVersion(key) {
476
- const existing = this.localCache.get(key);
477
- return existing ? existing.version + 1 : 1;
478
- }
479
- calculateChecksum(value) {
480
- // Simple checksum calculation - in production would use proper hashing
481
- const str = JSON.stringify(value);
482
- let hash = 0;
483
- for (let i = 0; i < str.length; i++) {
484
- const char = str.charCodeAt(i);
485
- hash = ((hash << 5) - hash) + char;
486
- hash = hash & hash; // Convert to 32-bit integer
487
- }
488
- return Math.abs(hash).toString(16);
489
- }
490
- extractTags(key, value) {
491
- const tags = [];
492
- // Add key-based tags
493
- if (key.includes('session'))
494
- tags.push('session');
495
- if (key.includes('task'))
496
- tags.push('task');
497
- if (key.includes('agent'))
498
- tags.push('agent');
499
- // Add value-based tags
500
- if (typeof value === 'object' && value !== null) {
501
- if (value.type)
502
- tags.push(`type:${value.type}`);
503
- if (value.category)
504
- tags.push(`category:${value.category}`);
505
- }
506
- return tags;
507
- }
508
- isExpired(memoryValue) {
509
- if (!memoryValue.metadata?.ttl)
510
- return false;
511
- return Date.now() > memoryValue.metadata.ttl;
512
- }
513
- matchesPattern(key, pattern) {
514
- // Simple pattern matching - would implement proper glob pattern matching
515
- if (pattern === '*')
516
- return true;
517
- if (pattern.endsWith('*')) {
518
- return key.startsWith(pattern.slice(0, -1));
519
- }
520
- return key === pattern;
521
- }
522
- generateSubscriptionId() {
523
- return `sub_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
524
- }
525
- startPeriodicSync() {
526
- const interval = this.config.syncInterval || 60000; // 1 minute default
527
- setInterval(async () => {
528
- try {
529
- logger_js_1.logger.debug('🔄 Running periodic state sync');
530
- // Get list of all known instances
531
- const instances = await this.getKnownInstances();
532
- if (instances.length > 0) {
533
- await this.synchronize(instances);
534
- }
535
- }
536
- catch (error) {
537
- logger_js_1.logger.warn('⚠️ Periodic sync failed', { error: error.message });
538
- }
539
- }, interval);
540
- }
541
- async getKnownInstances() {
542
- // Implementation would get list of known instances from discovery service
543
- return [];
544
- }
545
- }
546
- exports.DistributedStateManager = DistributedStateManager;
547
- // ========================================
548
- // Supporting Classes
549
- // ========================================
550
- class DistributedStore {
551
- constructor(config) {
552
- this.config = config;
553
- }
554
- async read(key) {
555
- // Implementation would read from persistent storage
556
- return null;
557
- }
558
- async write(key, value) {
559
- // Implementation would write to persistent storage
560
- }
561
- async delete(key) {
562
- // Implementation would delete from persistent storage
563
- }
564
- async replicate(key, value) {
565
- // Implementation would replicate to other storage nodes
566
- }
567
- }
568
- class ConflictResolver {
569
- constructor(config) {
570
- this.config = config;
571
- }
572
- async resolve(conflict) {
573
- logger_js_1.logger.info(`🔧 Resolving conflict for key: ${conflict.key}`);
574
- switch (conflict.resolutionStrategy.type) {
575
- case 'last_write_wins':
576
- return this.resolveLastWriteWins(conflict);
577
- case 'vector_clock':
578
- return this.resolveVectorClock(conflict);
579
- case 'merge':
580
- return this.resolveMerge(conflict);
581
- case 'manual':
582
- return this.resolveManual(conflict);
583
- default:
584
- return { resolved: false, reason: `Unknown resolution strategy: ${conflict.resolutionStrategy.type}` };
585
- }
586
- }
587
- resolveLastWriteWins(conflict) {
588
- // Find the value with the latest timestamp
589
- let latestValue = conflict.localValue;
590
- let latestTimestamp = conflict.localValue.timestamp;
591
- for (const remoteValue of conflict.remoteValues.values()) {
592
- if (remoteValue.timestamp > latestTimestamp) {
593
- latestValue = remoteValue;
594
- latestTimestamp = remoteValue.timestamp;
595
- }
596
- }
597
- return {
598
- resolved: true,
599
- resolvedValue: latestValue,
600
- strategy: 'last_write_wins'
601
- };
602
- }
603
- resolveVectorClock(conflict) {
604
- // Implementation would use vector clocks for resolution
605
- // For now, fallback to last write wins
606
- return this.resolveLastWriteWins(conflict);
607
- }
608
- resolveMerge(conflict) {
609
- // Implementation would merge conflicting values
610
- // For now, fallback to last write wins
611
- return this.resolveLastWriteWins(conflict);
612
- }
613
- resolveManual(conflict) {
614
- // Implementation would queue for manual resolution
615
- return {
616
- resolved: false,
617
- reason: 'Manual resolution required',
618
- requiresManualIntervention: true
619
- };
620
- }
621
- }
622
- class EventBus {
623
- constructor(config) {
624
- this.config = config;
625
- this.events = new Map();
626
- }
627
- on(eventType, callback) {
628
- if (!this.events.has(eventType)) {
629
- this.events.set(eventType, []);
630
- }
631
- this.events.get(eventType).push(callback);
632
- }
633
- off(eventType, callback) {
634
- const callbacks = this.events.get(eventType);
635
- if (callbacks) {
636
- const index = callbacks.indexOf(callback);
637
- if (index !== -1) {
638
- callbacks.splice(index, 1);
639
- }
640
- }
641
- }
642
- emit(eventType, event) {
643
- const callbacks = this.events.get(eventType);
644
- if (callbacks) {
645
- callbacks.forEach(callback => {
646
- try {
647
- callback(event);
648
- }
649
- catch (error) {
650
- logger_js_1.logger.error(`❌ Event callback failed`, { eventType, error: error.message });
651
- }
652
- });
653
- }
654
- }
655
- async subscribe(pattern, callback) {
656
- // Implementation would subscribe to distributed event stream
657
- this.on(pattern, callback);
658
- }
659
- async unsubscribe(pattern) {
660
- // Implementation would unsubscribe from distributed event stream
661
- this.events.delete(pattern);
662
- }
663
- async broadcast(eventType, event) {
664
- // Implementation would broadcast to all instances
665
- this.emit(eventType, event);
666
- }
667
- }
668
- class ConsensusManager extends events_1.EventEmitter {
669
- constructor(config) {
670
- super();
671
- this.config = config;
672
- }
673
- async proposeChange(proposal) {
674
- logger_js_1.logger.info(`🗳️ Proposing consensus change`, { type: proposal.type, key: proposal.key });
675
- // Simplified consensus - in production would implement Raft or similar
676
- const result = {
677
- approved: true,
678
- votes: new Map([['local', true]]),
679
- proposal
680
- };
681
- this.emit('consensus.change', {
682
- key: proposal.key,
683
- decision: result
684
- });
685
- return result;
686
- }
687
- async readWithConsensus(key) {
688
- // Implementation would read with consensus guarantees
689
- return null;
690
- }
691
- }
692
- class ReplicationManager extends events_1.EventEmitter {
693
- constructor(config) {
694
- super();
695
- this.config = config;
696
- }
697
- async replicateSync(key, value) {
698
- logger_js_1.logger.debug(`📋 Synchronous replication: ${key}`);
699
- // Implementation would replicate synchronously to all replicas
700
- }
701
- async replicateAsync(key, value) {
702
- logger_js_1.logger.debug(`📋 Asynchronous replication: ${key}`);
703
- // Implementation would replicate asynchronously to replicas
704
- }
705
- }
706
- // ========================================
707
- // Error Classes
708
- // ========================================
709
- class DistributedStateError extends Error {
710
- constructor(message) {
711
- super(message);
712
- this.name = 'DistributedStateError';
713
- }
714
- }
715
- exports.DistributedStateError = DistributedStateError;
716
- //# sourceMappingURL=distributed-state-manager.js.map