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