snow-flow 3.0.9 → 3.0.10

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 (294) hide show
  1. package/claude-flow.bat +0 -0
  2. package/claude-flow.ps1 +0 -0
  3. package/dist/mcp/servicenow-automation-mcp.js +0 -0
  4. package/dist/mcp/servicenow-deployment-mcp.js +0 -0
  5. package/dist/mcp/servicenow-integration-mcp.js +0 -0
  6. package/dist/mcp/servicenow-mcp-server.js +0 -0
  7. package/dist/mcp/servicenow-operations-mcp.js +0 -0
  8. package/dist/mcp/servicenow-platform-development-mcp.js +0 -0
  9. package/dist/mcp/servicenow-progressive-indexer.js +0 -0
  10. package/dist/mcp/servicenow-reporting-analytics-mcp.js +133 -19
  11. package/dist/mcp/servicenow-security-compliance-mcp.js +0 -0
  12. package/dist/mcp/servicenow-update-set-mcp.js +0 -0
  13. package/dist/mcp/start-all-mcp-servers.js +0 -0
  14. package/dist/mcp/start-servicenow-mcp.js +0 -0
  15. package/memory/agents/README.md +1 -1
  16. package/memory/claude-flow-data.json +1 -1
  17. package/memory/sessions/README.md +1 -1
  18. package/package.json +2 -2
  19. package/.mcp.json +0 -22
  20. package/claude-flow.config.json +0 -20
  21. package/dist/agents/app-creator.agent.d.ts +0 -55
  22. package/dist/agents/app-creator.agent.js +0 -1292
  23. package/dist/agents/base/base-snow-agent.d.ts +0 -75
  24. package/dist/agents/base/base-snow-agent.js +0 -169
  25. package/dist/agents/base-snow-agent.d.ts +0 -63
  26. package/dist/agents/base-snow-agent.js +0 -296
  27. package/dist/agents/coordinator.d.ts +0 -200
  28. package/dist/agents/coordinator.js +0 -777
  29. package/dist/agents/flow-builder-agent.d.ts +0 -18
  30. package/dist/agents/flow-builder-agent.js +0 -197
  31. package/dist/agents/queen-403-handler.d.ts +0 -47
  32. package/dist/agents/queen-403-handler.js +0 -175
  33. package/dist/agents/queen-agent-example.d.ts +0 -23
  34. package/dist/agents/queen-agent-example.js +0 -240
  35. package/dist/agents/queen-agent.test.d.ts +0 -6
  36. package/dist/agents/script-generator.agent.d.ts +0 -32
  37. package/dist/agents/script-generator.agent.js +0 -772
  38. package/dist/agents/script-writer-agent.d.ts +0 -22
  39. package/dist/agents/script-writer-agent.js +0 -695
  40. package/dist/agents/security-agent.d.ts +0 -23
  41. package/dist/agents/security-agent.js +0 -619
  42. package/dist/agents/specialists/automation-specialist.agent.d.ts +0 -44
  43. package/dist/agents/specialists/automation-specialist.agent.js +0 -204
  44. package/dist/agents/specialists/data-specialist.agent.d.ts +0 -165
  45. package/dist/agents/specialists/data-specialist.agent.js +0 -484
  46. package/dist/agents/specialists/integration-specialist.agent.d.ts +0 -227
  47. package/dist/agents/specialists/integration-specialist.agent.js +0 -725
  48. package/dist/agents/specialists/reporting-specialist.agent.d.ts +0 -54
  49. package/dist/agents/specialists/reporting-specialist.agent.js +0 -193
  50. package/dist/agents/specialists/security-specialist.agent.d.ts +0 -85
  51. package/dist/agents/specialists/security-specialist.agent.js +0 -309
  52. package/dist/agents/teams/adaptive/adaptive-coordinator.agent.d.ts +0 -111
  53. package/dist/agents/teams/adaptive/adaptive-coordinator.agent.js +0 -383
  54. package/dist/agents/teams/base-team.d.ts +0 -72
  55. package/dist/agents/teams/base-team.js +0 -253
  56. package/dist/agents/teams/team-types.d.ts +0 -265
  57. package/dist/agents/teams/team-types.js +0 -3
  58. package/dist/agents/teams/widget/widget-architect.agent.d.ts +0 -61
  59. package/dist/agents/teams/widget/widget-architect.agent.js +0 -436
  60. package/dist/agents/teams/widget/widget-backend.agent.d.ts +0 -74
  61. package/dist/agents/teams/widget/widget-backend.agent.js +0 -1531
  62. package/dist/agents/teams/widget/widget-frontend.agent.d.ts +0 -67
  63. package/dist/agents/teams/widget/widget-frontend.agent.js +0 -1014
  64. package/dist/agents/teams/widget/widget-platform.agent.d.ts +0 -90
  65. package/dist/agents/teams/widget/widget-platform.agent.js +0 -1190
  66. package/dist/agents/teams/widget/widget-uiux.agent.d.ts +0 -107
  67. package/dist/agents/teams/widget/widget-uiux.agent.js +0 -1033
  68. package/dist/agents/test-agent.d.ts +0 -26
  69. package/dist/agents/test-agent.js +0 -734
  70. package/dist/agents/test-agents.d.ts +0 -7
  71. package/dist/agents/test-agents.js +0 -64
  72. package/dist/agents/ui-builder.agent.d.ts +0 -50
  73. package/dist/agents/ui-builder.agent.js +0 -1539
  74. package/dist/agents/widget-builder.agent.d.ts +0 -32
  75. package/dist/agents/widget-builder.agent.js +0 -439
  76. package/dist/agents/widget-creator-agent.d.ts +0 -18
  77. package/dist/agents/widget-creator-agent.js +0 -498
  78. package/dist/agents/workflow-designer.agent.d.ts +0 -31
  79. package/dist/agents/workflow-designer.agent.js +0 -583
  80. package/dist/api/error-handling.d.ts +0 -325
  81. package/dist/api/error-handling.js +0 -1488
  82. package/dist/api/flow-designer-api.d.ts +0 -167
  83. package/dist/api/flow-designer-api.js +0 -554
  84. package/dist/api/natural-language-mapper.d.ts +0 -124
  85. package/dist/api/natural-language-mapper.js +0 -501
  86. package/dist/api/performance-optimizer.d.ts +0 -240
  87. package/dist/api/performance-optimizer.js +0 -706
  88. package/dist/api/transaction-manager.d.ts +0 -189
  89. package/dist/api/transaction-manager.js +0 -576
  90. package/dist/assembly/team-assembler.d.ts +0 -140
  91. package/dist/assembly/team-assembler.js +0 -502
  92. package/dist/benchmark-performance.d.ts +0 -41
  93. package/dist/benchmark-performance.js +0 -230
  94. package/dist/cli/snow-flow-cli-integration.d.ts +0 -30
  95. package/dist/cli/snow-flow-cli-integration.js +0 -396
  96. package/dist/coordination/coordination-engine.d.ts +0 -41
  97. package/dist/coordination/coordination-engine.js +0 -324
  98. package/dist/coordination/coordination.test.d.ts +0 -6
  99. package/dist/coordination/example.d.ts +0 -31
  100. package/dist/coordination/example.js +0 -394
  101. package/dist/coordination/execution-patterns.d.ts +0 -43
  102. package/dist/coordination/execution-patterns.js +0 -507
  103. package/dist/coordination/factory.d.ts +0 -94
  104. package/dist/coordination/factory.js +0 -433
  105. package/dist/coordination/index.d.ts +0 -71
  106. package/dist/coordination/index.js +0 -135
  107. package/dist/coordination/progress-monitor.d.ts +0 -71
  108. package/dist/coordination/progress-monitor.js +0 -505
  109. package/dist/coordination/quality-gates.d.ts +0 -124
  110. package/dist/coordination/quality-gates.js +0 -577
  111. package/dist/coordination/shared-memory.d.ts +0 -39
  112. package/dist/coordination/shared-memory.js +0 -289
  113. package/dist/coordination/task-dependencies.d.ts +0 -50
  114. package/dist/coordination/task-dependencies.js +0 -407
  115. package/dist/coordination/team-coordinator.d.ts +0 -59
  116. package/dist/coordination/team-coordinator.js +0 -550
  117. package/dist/coordination/types.d.ts +0 -152
  118. package/dist/coordination/types.js +0 -3
  119. package/dist/mcp/mcp-wrapper.d.ts +0 -8
  120. package/dist/mcp/mcp-wrapper.js +0 -77
  121. package/dist/mcp/servicenow-flow-composer-enhanced.js +0 -396
  122. package/dist/mcp/servicenow-flow-composer-mcp.d.ts +0 -7
  123. package/dist/mcp/servicenow-flow-composer-mcp.js +0 -3103
  124. package/dist/mcp/servicenow-graph-memory-mcp.d.ts +0 -7
  125. package/dist/mcp/servicenow-intelligent-mcp.d.ts +0 -143
  126. package/dist/mcp/servicenow-intelligent-mcp.js +0 -4156
  127. package/dist/mcp/servicenow-xml-flow-mcp.d.ts +0 -53
  128. package/dist/mcp/servicenow-xml-flow-mcp.js +0 -1704
  129. package/dist/mcp/singleton-check.js +0 -31
  130. package/dist/mcp/test-simple-mcp.d.ts +0 -6
  131. package/dist/mcp/test-simple-mcp.js +0 -63
  132. package/dist/memory/hierarchical-memory-system.d.ts +0 -90
  133. package/dist/memory/hierarchical-memory-system.js +0 -400
  134. package/dist/memory/index.d.ts +0 -9
  135. package/dist/memory/index.js +0 -20
  136. package/dist/memory/mcp-integration-example.d.ts +0 -6
  137. package/dist/memory/mcp-integration-example.js +0 -281
  138. package/dist/memory/memory-client.d.ts +0 -199
  139. package/dist/memory/memory-client.js +0 -364
  140. package/dist/memory/memory-manager.d.ts +0 -29
  141. package/dist/memory/memory-manager.js +0 -280
  142. package/dist/memory/memory-operations.d.ts +0 -179
  143. package/dist/memory/memory-operations.js +0 -691
  144. package/dist/memory/memory-system.d.ts +0 -153
  145. package/dist/memory/memory-system.js +0 -651
  146. package/dist/memory/memory-test.d.ts +0 -6
  147. package/dist/memory/memory-test.js +0 -161
  148. package/dist/memory/snow-flow-memory-patterns.d.ts +0 -213
  149. package/dist/memory/snow-flow-memory-patterns.js +0 -200
  150. package/dist/memory/snow-memory.d.ts +0 -54
  151. package/dist/memory/snow-memory.js +0 -301
  152. package/dist/memory/swarm-memory.d.ts +0 -135
  153. package/dist/memory/swarm-memory.js +0 -378
  154. package/dist/optimization/flow-performance-optimizer.js +0 -723
  155. package/dist/orchestration/discovery/service-discovery.d.ts +0 -81
  156. package/dist/orchestration/discovery/service-discovery.js +0 -808
  157. package/dist/orchestration/distributed-orchestrator.d.ts +0 -131
  158. package/dist/orchestration/distributed-orchestrator.js +0 -712
  159. package/dist/orchestration/distribution/task-distribution-engine.d.ts +0 -53
  160. package/dist/orchestration/distribution/task-distribution-engine.js +0 -586
  161. package/dist/orchestration/flow-update-orchestrator.js +0 -648
  162. package/dist/orchestration/interfaces/distributed-orchestration.interface.d.ts +0 -606
  163. package/dist/orchestration/interfaces/distributed-orchestration.interface.js +0 -65
  164. package/dist/orchestration/protocols/mcpx-protocol.d.ts +0 -71
  165. package/dist/orchestration/protocols/mcpx-protocol.js +0 -668
  166. package/dist/orchestration/state/distributed-state-manager.d.ts +0 -89
  167. package/dist/orchestration/state/distributed-state-manager.js +0 -716
  168. package/dist/orchestrator/flow-composer.d.ts +0 -105
  169. package/dist/orchestrator/flow-composer.js +0 -404
  170. package/dist/orchestrator/flow-pattern-templates.d.ts +0 -260
  171. package/dist/orchestrator/flow-pattern-templates.js +0 -908
  172. package/dist/orchestrator/flow-subflow-decision-engine.d.ts +0 -202
  173. package/dist/orchestrator/flow-subflow-decision-engine.js +0 -769
  174. package/dist/orchestrator/flow-validation-engine.d.ts +0 -169
  175. package/dist/orchestrator/flow-validation-engine.js +0 -913
  176. package/dist/orchestrator/snow-orchestrator.d.ts +0 -49
  177. package/dist/orchestrator/snow-orchestrator.js +0 -235
  178. package/dist/orchestrator/subflow-creation-handler.d.ts +0 -230
  179. package/dist/orchestrator/subflow-creation-handler.js +0 -791
  180. package/dist/patterns/adaptive-patterns.d.ts +0 -140
  181. package/dist/patterns/adaptive-patterns.js +0 -549
  182. package/dist/queen/advanced-integration-test.d.ts +0 -48
  183. package/dist/queen/advanced-integration-test.js +0 -473
  184. package/dist/queen/integration-example.d.ts +0 -82
  185. package/dist/queen/integration-example.js +0 -219
  186. package/dist/queen/integration-test.d.ts +0 -72
  187. package/dist/queen/integration-test.js +0 -563
  188. package/dist/queen/mock-mcp-client.d.ts +0 -71
  189. package/dist/queen/mock-mcp-client.js +0 -317
  190. package/dist/queen/run-integration-tests.d.ts +0 -9
  191. package/dist/queen/run-integration-tests.js +0 -27
  192. package/dist/sparc/coordinators/adaptive-coordinator.d.ts +0 -54
  193. package/dist/sparc/coordinators/adaptive-coordinator.js +0 -367
  194. package/dist/sparc/coordinators/team-coordinator.d.ts +0 -66
  195. package/dist/sparc/coordinators/team-coordinator.js +0 -402
  196. package/dist/sparc/modes/team-modes.d.ts +0 -33
  197. package/dist/sparc/modes/team-modes.js +0 -399
  198. package/dist/sparc/teams/application-team.d.ts +0 -73
  199. package/dist/sparc/teams/application-team.js +0 -463
  200. package/dist/sparc/teams/flow-team.d.ts +0 -67
  201. package/dist/sparc/teams/flow-team.js +0 -373
  202. package/dist/sparc/teams/widget-team.d.ts +0 -61
  203. package/dist/sparc/teams/widget-team.js +0 -280
  204. package/dist/specialists/app-specialists.d.ts +0 -93
  205. package/dist/specialists/app-specialists.js +0 -1639
  206. package/dist/specialists/base-specialist.d.ts +0 -19
  207. package/dist/specialists/base-specialist.js +0 -54
  208. package/dist/specialists/flow-specialists.d.ts +0 -113
  209. package/dist/specialists/flow-specialists.js +0 -1787
  210. package/dist/specialists/individual-specialists.d.ts +0 -67
  211. package/dist/specialists/individual-specialists.js +0 -632
  212. package/dist/specialists/widget-specialists.d.ts +0 -70
  213. package/dist/specialists/widget-specialists.js +0 -1264
  214. package/dist/src/utils/agent-detector.js +0 -655
  215. package/dist/teams/adaptive-team.d.ts +0 -81
  216. package/dist/teams/adaptive-team.js +0 -1153
  217. package/dist/teams/application-team.d.ts +0 -30
  218. package/dist/teams/application-team.js +0 -547
  219. package/dist/teams/base-team.d.ts +0 -55
  220. package/dist/teams/base-team.js +0 -243
  221. package/dist/teams/flow-team.d.ts +0 -28
  222. package/dist/teams/flow-team.js +0 -525
  223. package/dist/teams/widget-team.d.ts +0 -26
  224. package/dist/teams/widget-team.js +0 -459
  225. package/dist/templates/flow-template-system.js +0 -625
  226. package/dist/test-fetch-incidents.d.ts +0 -2
  227. package/dist/test-fetch-incidents.js +0 -84
  228. package/dist/test-incident-access.d.ts +0 -2
  229. package/dist/test-incident-access.js +0 -72
  230. package/dist/test-iphone-flow.js +0 -189
  231. package/dist/test-limit-problem.d.ts +0 -2
  232. package/dist/test-limit-problem.js +0 -60
  233. package/dist/test-ml-batch-fix.d.ts +0 -2
  234. package/dist/test-ml-batch-fix.js +0 -104
  235. package/dist/test-ml-batch.d.ts +0 -2
  236. package/dist/test-ml-batch.js +0 -87
  237. package/dist/test-ml-query.d.ts +0 -2
  238. package/dist/test-ml-query.js +0 -100
  239. package/dist/test-ml-training-fix.d.ts +0 -12
  240. package/dist/test-ml-training-fix.js +0 -113
  241. package/dist/test-ml-training.d.ts +0 -2
  242. package/dist/test-ml-training.js +0 -32
  243. package/dist/test-operations-query.d.ts +0 -2
  244. package/dist/test-operations-query.js +0 -84
  245. package/dist/test-performance-query.d.ts +0 -2
  246. package/dist/test-performance-query.js +0 -52
  247. package/dist/test-singleton-protection.d.ts +0 -8
  248. package/dist/test-singleton-protection.js +0 -110
  249. package/dist/test-smart-limits.d.ts +0 -13
  250. package/dist/test-smart-limits.js +0 -100
  251. package/dist/test-snow-query-incidents.d.ts +0 -2
  252. package/dist/test-snow-query-incidents.js +0 -66
  253. package/dist/test-universal-query.d.ts +0 -2
  254. package/dist/test-universal-query.js +0 -106
  255. package/dist/testing/flow-testing-automation.js +0 -641
  256. package/dist/utils/complete-flow-xml-generator.js +0 -1285
  257. package/dist/utils/file-storage-fallback.d.ts +0 -62
  258. package/dist/utils/file-storage-fallback.js +0 -289
  259. package/dist/utils/flow-api-discovery.d.ts +0 -151
  260. package/dist/utils/flow-api-discovery.js +0 -439
  261. package/dist/utils/flow-examples.js +0 -720
  262. package/dist/utils/flow-structure-builder.js +0 -677
  263. package/dist/utils/flow-xml-generator.d.ts +0 -41
  264. package/dist/utils/flow-xml-generator.js +0 -258
  265. package/dist/utils/improved-flow-xml-generator.js +0 -820
  266. package/dist/utils/mcp-process-manager.backup.d.ts +0 -58
  267. package/dist/utils/mcp-process-manager.backup.js +0 -220
  268. package/dist/utils/mcp-singleton-enforcer.d.ts +0 -36
  269. package/dist/utils/mcp-singleton-enforcer.js +0 -201
  270. package/dist/utils/mcp-timeout-fix.d.ts +0 -53
  271. package/dist/utils/mcp-timeout-fix.js +0 -221
  272. package/dist/utils/migrate-claude-flow.d.ts +0 -22
  273. package/dist/utils/migrate-claude-flow.js +0 -120
  274. package/dist/utils/scope-utils.d.ts +0 -72
  275. package/dist/utils/scope-utils.js +0 -386
  276. package/dist/utils/snow-oauth-old.d.ts +0 -65
  277. package/dist/utils/snow-oauth-old.js +0 -345
  278. package/dist/utils/xml-first-flow-generator.js +0 -513
  279. package/memory/servicenow_artifacts/000d9224c895221055906c7518aa2d3d.json +0 -30
  280. package/memory/servicenow_artifacts/0196b66173303010e46b4a2214f6a7a2.json +0 -36
  281. package/memory/servicenow_artifacts/125e5d1d837e2a102a7ea130ceaad397.json +0 -30
  282. package/memory/servicenow_artifacts/7637c1f2b7112210a5e5911cde11a972.json +0 -30
  283. package/memory/servicenow_artifacts/default_documentation_tables_1754056582292.json +0 -55
  284. package/memory/servicenow_artifacts/default_documentation_tables_1754057477189.json +0 -55
  285. package/memory/update-set-sessions/01f82af583faea102a7ea130ceaad3d4.json +0 -9
  286. package/memory/update-set-sessions/27718fb983faea102a7ea130ceaad34b.json +0 -9
  287. package/memory/update-set-sessions/412e9bf6833e22502a7ea130ceaad30a.json +0 -8
  288. package/memory/update-set-sessions/66fc5a79837aea102a7ea130ceaad3ab.json +0 -9
  289. package/memory/update-set-sessions/71a30ff5837eea102a7ea130ceaad37f.json +0 -9
  290. package/memory/update-set-sessions/74fba27983faea102a7ea130ceaad3bd.json +0 -9
  291. package/memory/update-set-sessions/a0b147b5837eea102a7ea130ceaad344.json +0 -58
  292. package/memory/update-set-sessions/b13f5eb983baea102a7ea130ceaad33e.json +0 -9
  293. package/reports/swarm-auto-centralized-1752649029776.json +0 -13
  294. 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