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,677 +0,0 @@
1
- #!/usr/bin/env node
2
- "use strict";
3
- /**
4
- * Flow Structure Builder - ServiceNow Flow Record Utilities
5
- * Converts flow JSON to proper ServiceNow records with correct sys_ids and logic chains
6
- */
7
- Object.defineProperty(exports, "__esModule", { value: true });
8
- exports.ACTION_TYPE_IDS = void 0;
9
- exports.generateSysId = generateSysId;
10
- exports.generateFlowComponents = generateFlowComponents;
11
- exports.createActionInstances = createActionInstances;
12
- exports.buildLogicChain = buildLogicChain;
13
- exports.generateFlowXML = generateFlowXML;
14
- exports.validateFlowComponents = validateFlowComponents;
15
- exports.convertToFlowDefinition = convertToFlowDefinition;
16
- exports.createTestFlowComponents = createTestFlowComponents;
17
- exports.extractSysIds = extractSysIds;
18
- exports.generateFlowUpdate = generateFlowUpdate;
19
- const uuid_1 = require("uuid");
20
- /**
21
- * Known ServiceNow action type sys_ids for proper flow creation
22
- */
23
- exports.ACTION_TYPE_IDS = {
24
- // Core Flow Actions
25
- notification: '716281160b100300d97d8bf637673ac7',
26
- approval: 'e3a61c920b200300d97d8bf637673a30',
27
- script: '43c8cf0e0b200300d97d8bf637673ab4',
28
- condition: 'a6e0f8890b200300d97d8bf637673a4a',
29
- create_record: '7b8cf0e20b200300d97d8bf637673a50',
30
- update_record: '8c9d0f230b200300d97d8bf637673a60',
31
- ask_for_approval: 'e3a61c920b200300d97d8bf637673a30',
32
- send_email: '716281160b100300d97d8bf637673ac7',
33
- // Integration Actions
34
- rest_step: 'f4b5c6d70b200300d97d8bf637673a80',
35
- web_service: 'a5b6c7d80b200300d97d8bf637673a90',
36
- // Utility Actions
37
- wait: '9e0f1a2b0b200300d97d8bf637673aa0',
38
- log: '0f1a2b3c0b200300d97d8bf637673ab0',
39
- set_variable: '1a2b3c4d0b200300d97d8bf637673ac0',
40
- // Default fallback
41
- default: '43c8cf0e0b200300d97d8bf637673ab4' // script action
42
- };
43
- /**
44
- * Generate a ServiceNow-compatible sys_id
45
- */
46
- function generateSysId() {
47
- return (0, uuid_1.v4)().replace(/-/g, '');
48
- }
49
- /**
50
- * Generate ServiceNow flow components from flow definition
51
- * Converts flow JSON to proper ServiceNow records with all required components
52
- */
53
- function generateFlowComponents(flowDefinition, flowSysId) {
54
- const flowId = flowSysId || generateSysId();
55
- console.log('🏗️ Generating ServiceNow flow components...');
56
- console.log(`📋 Flow: ${flowDefinition.name}`);
57
- console.log(`🆔 Flow sys_id: ${flowId}`);
58
- // 1. Create main flow record
59
- const flowRecord = {
60
- sys_id: flowId,
61
- name: flowDefinition.name,
62
- description: flowDefinition.description,
63
- internal_name: sanitizeInternalName(flowDefinition.name),
64
- type: 'flow',
65
- status: 'published',
66
- active: true,
67
- run_as: 'user', // 🔒 SEC-001 FIX: Default to 'user' to prevent privilege escalation
68
- sys_class_name: 'sys_hub_flow',
69
- table: flowDefinition.table,
70
- category: 'custom',
71
- flow_definition: JSON.stringify({
72
- name: flowDefinition.name,
73
- description: flowDefinition.description,
74
- trigger: flowDefinition.trigger,
75
- activities: flowDefinition.activities,
76
- variables: flowDefinition.variables,
77
- connections: flowDefinition.connections
78
- })
79
- };
80
- // 2. Create trigger instance
81
- const triggerInstance = createTriggerInstance(flowId, flowDefinition.trigger);
82
- // 3. Create action instances for each activity
83
- const actionInstances = createActionInstances(flowDefinition.activities, flowId);
84
- // 4. Build logic chain (connections between components)
85
- const logicChain = buildLogicChain(flowDefinition.activities, triggerInstance, actionInstances);
86
- // 5. Create flow variables
87
- const variables = createFlowVariables(flowDefinition.variables, flowId);
88
- // 6. Create connections for visual flow representation
89
- const connections = createFlowConnections(flowDefinition.connections, logicChain);
90
- console.log(`✅ Generated components:`);
91
- console.log(` • Flow record: ${flowRecord.sys_id}`);
92
- console.log(` • Trigger: ${triggerInstance.sys_id}`);
93
- console.log(` • Actions: ${actionInstances.length}`);
94
- console.log(` • Logic chain: ${logicChain.length} entries`);
95
- console.log(` • Variables: ${variables.length}`);
96
- console.log(` • Connections: ${connections.length}`);
97
- return {
98
- flowRecord,
99
- triggerInstance,
100
- actionInstances,
101
- logicChain,
102
- variables,
103
- connections
104
- };
105
- }
106
- /**
107
- * Create trigger instance record
108
- */
109
- function createTriggerInstance(flowId, trigger) {
110
- const triggerSysId = generateSysId();
111
- return {
112
- sys_id: triggerSysId,
113
- flow: flowId,
114
- name: `${trigger.type}_trigger`,
115
- type: trigger.type,
116
- table: trigger.table,
117
- condition: trigger.condition || '',
118
- active: true,
119
- order: 0,
120
- sys_class_name: 'sys_hub_trigger_instance',
121
- // Additional fields for proper trigger configuration
122
- trigger_type: trigger.type,
123
- trigger_table: trigger.table,
124
- filter: trigger.condition || '',
125
- when: getTriggerWhen(trigger.type)
126
- };
127
- }
128
- /**
129
- * Create action instances for all activities
130
- */
131
- function createActionInstances(activities, flowSysId) {
132
- console.log(`🔧 Creating ${activities.length} action instances...`);
133
- return activities.map((activity, index) => {
134
- const actionSysId = generateSysId();
135
- const actionTypeId = getActionTypeId(activity.type);
136
- console.log(` • ${activity.name} (${activity.type}) → ${actionSysId}`);
137
- return {
138
- sys_id: actionSysId,
139
- flow: flowSysId,
140
- name: activity.name,
141
- label: activity.name,
142
- action_type: actionTypeId,
143
- order: (index + 1) * 100, // ServiceNow uses 100-based ordering
144
- active: true,
145
- sys_class_name: 'sys_hub_action_instance',
146
- // Activity-specific configuration
147
- inputs: JSON.stringify(activity.inputs || {}),
148
- outputs: JSON.stringify(activity.outputs || {}),
149
- condition: activity.condition || '',
150
- // Reference fields
151
- artifact_reference: activity.artifact_reference || '',
152
- subflow_reference: activity.subflow_reference || '',
153
- // Position for Flow Designer visual representation
154
- x: 100 + (index * 200), // Horizontal spacing
155
- y: 200, // Vertical position
156
- // Additional ServiceNow fields
157
- description: `${activity.type} action: ${activity.name}`,
158
- configuration: JSON.stringify(buildActionConfiguration(activity))
159
- };
160
- });
161
- }
162
- /**
163
- * Build logic chain connecting trigger → actions → end
164
- * Creates sys_hub_flow_logic records for proper flow execution
165
- */
166
- function buildLogicChain(activities, triggerInstance, actionInstances) {
167
- console.log('🔗 Building logic chain...');
168
- const logicChain = [];
169
- // 1. Connect trigger to first action (or end if no actions)
170
- if (actionInstances.length > 0) {
171
- logicChain.push(createLogicEntry(triggerInstance.sys_id, actionInstances[0].sys_id, triggerInstance.flow, 'trigger_to_first_action', 0));
172
- console.log(` • Trigger → ${actionInstances[0].name}`);
173
- }
174
- else {
175
- // Direct trigger to end
176
- logicChain.push(createLogicEntry(triggerInstance.sys_id, 'END', triggerInstance.flow, 'trigger_to_end', 0));
177
- console.log(` • Trigger → END (no actions)`);
178
- }
179
- // 2. Connect actions in sequence
180
- for (let i = 0; i < actionInstances.length - 1; i++) {
181
- const currentAction = actionInstances[i];
182
- const nextAction = actionInstances[i + 1];
183
- logicChain.push(createLogicEntry(currentAction.sys_id, nextAction.sys_id, triggerInstance.flow, `action_${i}_to_action_${i + 1}`, i + 1));
184
- console.log(` • ${currentAction.name} → ${nextAction.name}`);
185
- }
186
- // 3. Connect last action to end
187
- if (actionInstances.length > 0) {
188
- const lastAction = actionInstances[actionInstances.length - 1];
189
- logicChain.push(createLogicEntry(lastAction.sys_id, 'END', triggerInstance.flow, 'last_action_to_end', actionInstances.length));
190
- console.log(` • ${lastAction.name} → END`);
191
- }
192
- console.log(`✅ Built logic chain with ${logicChain.length} connections`);
193
- return logicChain;
194
- }
195
- /**
196
- * Create a single logic entry (sys_hub_flow_logic record)
197
- */
198
- function createLogicEntry(fromSysId, toSysId, flowId, name, order) {
199
- return {
200
- sys_id: generateSysId(),
201
- flow: flowId,
202
- name: name,
203
- from_element: fromSysId,
204
- to_element: toSysId === 'END' ? '' : toSysId,
205
- order: order * 100,
206
- active: true,
207
- sys_class_name: 'sys_hub_flow_logic',
208
- // Visual positioning for Flow Designer
209
- from_x: 100 + (order * 200),
210
- from_y: 200,
211
- to_x: toSysId === 'END' ? 100 + ((order + 1) * 200) : 100 + ((order + 1) * 200),
212
- to_y: 200,
213
- // Connection properties
214
- condition: '',
215
- label: '',
216
- connection_type: 'sequence'
217
- };
218
- }
219
- /**
220
- * Create flow variables from variable definitions
221
- */
222
- function createFlowVariables(variables, flowId) {
223
- return variables.map((variable, index) => ({
224
- sys_id: generateSysId(),
225
- flow: flowId,
226
- name: variable.name || variable.id,
227
- label: variable.label || variable.name || variable.id,
228
- type: variable.type || 'string',
229
- input: variable.input || false,
230
- output: variable.output || false,
231
- default_value: variable.default_value || '',
232
- description: variable.description || '',
233
- order: index * 100,
234
- sys_class_name: 'sys_hub_flow_variable'
235
- }));
236
- }
237
- /**
238
- * Create visual connections for Flow Designer
239
- */
240
- function createFlowConnections(connections, logicChain) {
241
- // The logic chain already handles the actual execution flow
242
- // This creates additional visual connections if specified
243
- return connections.map((connection, index) => ({
244
- sys_id: generateSysId(),
245
- name: connection.name || `connection_${index}`,
246
- from: connection.from,
247
- to: connection.to,
248
- condition: connection.condition || 'always',
249
- label: connection.label || '',
250
- sys_class_name: 'sys_hub_flow_connection'
251
- }));
252
- }
253
- /**
254
- * Get the correct action type sys_id for an activity type
255
- */
256
- function getActionTypeId(activityType) {
257
- const normalizedType = activityType.toLowerCase().replace(/[^a-z_]/g, '_');
258
- // Direct mapping
259
- if (exports.ACTION_TYPE_IDS[normalizedType]) {
260
- return exports.ACTION_TYPE_IDS[normalizedType];
261
- }
262
- // Fuzzy matching for common variations
263
- if (normalizedType.includes('email') || normalizedType.includes('mail')) {
264
- return exports.ACTION_TYPE_IDS.notification;
265
- }
266
- if (normalizedType.includes('approval') || normalizedType.includes('approve')) {
267
- return exports.ACTION_TYPE_IDS.approval;
268
- }
269
- if (normalizedType.includes('script') || normalizedType.includes('code')) {
270
- return exports.ACTION_TYPE_IDS.script;
271
- }
272
- if (normalizedType.includes('condition') || normalizedType.includes('if')) {
273
- return exports.ACTION_TYPE_IDS.condition;
274
- }
275
- if (normalizedType.includes('create') && normalizedType.includes('record')) {
276
- return exports.ACTION_TYPE_IDS.create_record;
277
- }
278
- if (normalizedType.includes('update') && normalizedType.includes('record')) {
279
- return exports.ACTION_TYPE_IDS.update_record;
280
- }
281
- if (normalizedType.includes('rest') || normalizedType.includes('api')) {
282
- return exports.ACTION_TYPE_IDS.rest_step;
283
- }
284
- if (normalizedType.includes('wait') || normalizedType.includes('delay')) {
285
- return exports.ACTION_TYPE_IDS.wait;
286
- }
287
- if (normalizedType.includes('log')) {
288
- return exports.ACTION_TYPE_IDS.log;
289
- }
290
- // Default to script action
291
- console.warn(`⚠️ Unknown action type "${activityType}", using script action as fallback`);
292
- return exports.ACTION_TYPE_IDS.default;
293
- }
294
- /**
295
- * Get trigger when condition based on trigger type
296
- */
297
- function getTriggerWhen(triggerType) {
298
- switch (triggerType.toLowerCase()) {
299
- case 'record_created':
300
- case 'created':
301
- return 'after';
302
- case 'record_updated':
303
- case 'updated':
304
- return 'after';
305
- case 'record_deleted':
306
- case 'deleted':
307
- return 'after';
308
- case 'before_insert':
309
- return 'before';
310
- case 'before_update':
311
- return 'before';
312
- case 'before_delete':
313
- return 'before';
314
- case 'scheduled':
315
- return 'scheduled';
316
- case 'manual':
317
- default:
318
- return 'manual';
319
- }
320
- }
321
- /**
322
- * Build action-specific configuration
323
- */
324
- function buildActionConfiguration(activity) {
325
- const config = {
326
- action_type: activity.type,
327
- name: activity.name
328
- };
329
- // Add type-specific configuration
330
- switch (activity.type.toLowerCase()) {
331
- case 'notification':
332
- case 'send_email':
333
- config.recipient = activity.inputs?.recipient || '';
334
- config.subject = activity.inputs?.subject || '';
335
- config.message = activity.inputs?.message || activity.inputs?.body || '';
336
- break;
337
- case 'approval':
338
- case 'ask_for_approval':
339
- config.approver = activity.inputs?.approver || '';
340
- config.approval_message = activity.inputs?.message || '';
341
- config.due_date = activity.inputs?.due_date || '';
342
- break;
343
- case 'script':
344
- config.script = activity.inputs?.script || '';
345
- break;
346
- case 'condition':
347
- config.condition = activity.condition || activity.inputs?.condition || '';
348
- break;
349
- case 'create_record':
350
- config.table = activity.inputs?.table || '';
351
- config.fields = activity.inputs?.fields || {};
352
- break;
353
- case 'update_record':
354
- config.table = activity.inputs?.table || '';
355
- config.sys_id = activity.inputs?.sys_id || '';
356
- config.fields = activity.inputs?.fields || {};
357
- break;
358
- default:
359
- // Include all inputs as configuration
360
- config.inputs = activity.inputs || {};
361
- }
362
- return config;
363
- }
364
- /**
365
- * Sanitize flow name for ServiceNow internal_name field
366
- */
367
- function sanitizeInternalName(name) {
368
- return name
369
- .toLowerCase()
370
- .replace(/[^a-z0-9_\s]/g, '') // Remove special characters except underscores and spaces
371
- .replace(/\s+/g, '_') // Replace spaces with underscores
372
- .replace(/_+/g, '_') // Replace multiple underscores with single
373
- .replace(/^_|_$/g, '') // Remove leading/trailing underscores
374
- .substring(0, 80); // Limit length to 80 characters
375
- }
376
- /**
377
- * Convert flow definition to ServiceNow Update XML format
378
- * Enhanced with modern flow structure support and better validation
379
- */
380
- function generateFlowXML(components, options = {}) {
381
- const { includeMetadata = true, validateBeforeExport = true, compactFormat = false } = options;
382
- // Validate components before generating XML
383
- if (validateBeforeExport) {
384
- const validation = validateFlowComponents(components);
385
- if (!validation.isValid) {
386
- throw new Error(`Flow validation failed: ${validation.errors.join(', ')}`);
387
- }
388
- }
389
- const xml = [];
390
- const indent = compactFormat ? '' : ' ';
391
- const newline = compactFormat ? '' : '\n';
392
- xml.push('<?xml version="1.0" encoding="UTF-8"?>');
393
- // Add metadata if requested
394
- if (includeMetadata) {
395
- xml.push(`<!-- Generated by Snow-Flow at ${new Date().toISOString()} -->`);
396
- xml.push(`<!-- Flow: ${components.flowRecord.name || 'Unknown'} -->`);
397
- xml.push(`<!-- Actions: ${components.actionInstances.length} -->`);
398
- xml.push(`<!-- Variables: ${components.variables.length} -->`);
399
- }
400
- xml.push('<unload unload_date="' + new Date().toISOString() + '">');
401
- // Flow record with enhanced fields
402
- xml.push(`${indent}<sys_hub_flow action="INSERT_OR_UPDATE">`);
403
- Object.entries(components.flowRecord).forEach(([key, value]) => {
404
- // Ensure critical fields are properly set
405
- let processedValue = value;
406
- if (key === 'active' && typeof value !== 'boolean') {
407
- processedValue = value === 'true' || value === true;
408
- }
409
- if (key === 'validated' && typeof value !== 'boolean') {
410
- processedValue = value === 'true' || value === true;
411
- }
412
- xml.push(`${indent}${indent}<${key}>${escapeXML(String(processedValue))}</${key}>`);
413
- });
414
- xml.push(`${indent}</sys_hub_flow>`);
415
- // Enhanced trigger instance with validation
416
- if (components.triggerInstance && Object.keys(components.triggerInstance).length > 0) {
417
- xml.push(`${indent}<sys_hub_trigger_instance action="INSERT_OR_UPDATE">`);
418
- Object.entries(components.triggerInstance).forEach(([key, value]) => {
419
- xml.push(`${indent}${indent}<${key}>${escapeXML(String(value))}</${key}>`);
420
- });
421
- xml.push(`${indent}</sys_hub_trigger_instance>`);
422
- }
423
- // Action instances with proper ordering
424
- components.actionInstances
425
- .sort((a, b) => (a.order || 0) - (b.order || 0)) // Ensure proper order
426
- .forEach(action => {
427
- xml.push(`${indent}<sys_hub_action_instance action="INSERT_OR_UPDATE">`);
428
- Object.entries(action).forEach(([key, value]) => {
429
- xml.push(`${indent}${indent}<${key}>${escapeXML(String(value))}</${key}>`);
430
- });
431
- xml.push(`${indent}</sys_hub_action_instance>`);
432
- });
433
- // Logic chain with connection validation
434
- components.logicChain
435
- .sort((a, b) => (a.order || 0) - (b.order || 0)) // Ensure proper flow
436
- .forEach(logic => {
437
- xml.push(`${indent}<sys_hub_flow_logic action="INSERT_OR_UPDATE">`);
438
- Object.entries(logic).forEach(([key, value]) => {
439
- xml.push(`${indent}${indent}<${key}>${escapeXML(String(value))}</${key}>`);
440
- });
441
- xml.push(`${indent}</sys_hub_flow_logic>`);
442
- });
443
- // Variables with type validation
444
- components.variables.forEach(variable => {
445
- xml.push(`${indent}<sys_hub_flow_variable action="INSERT_OR_UPDATE">`);
446
- Object.entries(variable).forEach(([key, value]) => {
447
- xml.push(`${indent}${indent}<${key}>${escapeXML(String(value))}</${key}>`);
448
- });
449
- xml.push(`${indent}</sys_hub_flow_variable>`);
450
- });
451
- // Include connections if available (for modern flows)
452
- if (components.connections && components.connections.length > 0) {
453
- components.connections.forEach(connection => {
454
- xml.push(`${indent}<sys_hub_flow_connection action="INSERT_OR_UPDATE">`);
455
- Object.entries(connection).forEach(([key, value]) => {
456
- xml.push(`${indent}${indent}<${key}>${escapeXML(String(value))}</${key}>`);
457
- });
458
- xml.push(`${indent}</sys_hub_flow_connection>`);
459
- });
460
- }
461
- xml.push('</unload>');
462
- return xml.join(newline + (compactFormat ? '' : newline));
463
- }
464
- /**
465
- * Escape XML special characters
466
- */
467
- function escapeXML(text) {
468
- return text
469
- .replace(/&/g, '&amp;')
470
- .replace(/</g, '&lt;')
471
- .replace(/>/g, '&gt;')
472
- .replace(/"/g, '&quot;')
473
- .replace(/'/g, '&apos;');
474
- }
475
- /**
476
- * Validate flow components before deployment
477
- */
478
- function validateFlowComponents(components) {
479
- const errors = [];
480
- const warnings = [];
481
- // Validate flow record
482
- if (!components.flowRecord.name) {
483
- errors.push('Flow record missing required name field');
484
- }
485
- if (!components.flowRecord.sys_id) {
486
- errors.push('Flow record missing sys_id');
487
- }
488
- // Validate trigger
489
- if (!components.triggerInstance.sys_id) {
490
- errors.push('Trigger instance missing sys_id');
491
- }
492
- if (!components.triggerInstance.flow) {
493
- errors.push('Trigger instance not linked to flow');
494
- }
495
- // Validate actions
496
- components.actionInstances.forEach((action, index) => {
497
- if (!action.sys_id) {
498
- errors.push(`Action ${index} missing sys_id`);
499
- }
500
- if (!action.flow) {
501
- errors.push(`Action ${index} not linked to flow`);
502
- }
503
- if (!action.action_type) {
504
- errors.push(`Action ${index} missing action_type`);
505
- }
506
- });
507
- // Validate logic chain
508
- if (components.logicChain.length === 0 && components.actionInstances.length > 0) {
509
- warnings.push('No logic chain defined for flow with actions');
510
- }
511
- // Check for orphaned components
512
- const flowId = components.flowRecord.sys_id;
513
- const orphanedActions = components.actionInstances.filter(a => a.flow !== flowId);
514
- if (orphanedActions.length > 0) {
515
- errors.push(`${orphanedActions.length} actions not properly linked to flow`);
516
- }
517
- return {
518
- isValid: errors.length === 0,
519
- errors,
520
- warnings
521
- };
522
- }
523
- /**
524
- * Convert legacy flow format to FlowDefinition
525
- * Handles various input formats from existing flow creation systems
526
- */
527
- function convertToFlowDefinition(flow) {
528
- // Extract activities from various possible sources
529
- const activities = flow.activities || flow.actions || flow.steps || [];
530
- // Normalize trigger format
531
- const trigger = {
532
- type: flow.trigger_type || flow.trigger?.type || 'manual',
533
- table: flow.trigger?.table || flow.table || 'incident',
534
- condition: flow.trigger?.condition || flow.condition || flow.trigger_condition || ''
535
- };
536
- // Normalize activities format
537
- const normalizedActivities = activities.map((activity, index) => ({
538
- id: activity.id || `activity_${index}`,
539
- name: activity.name || activity.label || `Activity ${index + 1}`,
540
- type: activity.type || activity.action_type || 'script',
541
- inputs: activity.inputs || activity.config || {},
542
- outputs: activity.outputs || {},
543
- condition: activity.condition || '',
544
- artifact_reference: activity.artifact_reference || activity.artifact,
545
- subflow_reference: activity.subflow_reference || activity.subflow
546
- }));
547
- // Extract variables from various sources
548
- let variables = flow.variables || [];
549
- // Add inputs as variables
550
- if (flow.inputs && Array.isArray(flow.inputs)) {
551
- const inputVars = flow.inputs.map((input, index) => ({
552
- id: input.id || input.name || `input_${index}`,
553
- name: input.name || input.id || `input_${index}`,
554
- type: input.type || 'string',
555
- input: true,
556
- output: false,
557
- default_value: input.default_value || input.defaultValue || '',
558
- description: input.description || ''
559
- }));
560
- variables = variables.concat(inputVars);
561
- }
562
- // Add outputs as variables
563
- if (flow.outputs && Array.isArray(flow.outputs)) {
564
- const outputVars = flow.outputs.map((output, index) => ({
565
- id: output.id || output.name || `output_${index}`,
566
- name: output.name || output.id || `output_${index}`,
567
- type: output.type || 'string',
568
- input: false,
569
- output: true,
570
- default_value: output.default_value || output.defaultValue || '',
571
- description: output.description || ''
572
- }));
573
- variables = variables.concat(outputVars);
574
- }
575
- return {
576
- name: flow.name || 'Untitled Flow',
577
- description: flow.description || flow.name || 'Generated flow',
578
- table: trigger.table,
579
- trigger,
580
- activities: normalizedActivities,
581
- variables,
582
- connections: flow.connections || [],
583
- error_handling: flow.error_handling || []
584
- };
585
- }
586
- /**
587
- * Create flow components for testing/validation purposes
588
- * Generates minimal valid flow structure for testing
589
- */
590
- function createTestFlowComponents(name = 'Test Flow') {
591
- const testFlow = {
592
- name,
593
- description: `Test flow: ${name}`,
594
- table: 'incident',
595
- trigger: {
596
- type: 'manual',
597
- table: 'incident',
598
- condition: ''
599
- },
600
- activities: [
601
- {
602
- id: 'log_action',
603
- name: 'Log Message',
604
- type: 'script',
605
- inputs: {
606
- script: `gs.info('Test flow ${name} executed successfully');`
607
- },
608
- outputs: {
609
- result: 'string'
610
- }
611
- }
612
- ],
613
- variables: [
614
- {
615
- id: 'test_var',
616
- name: 'Test Variable',
617
- type: 'string',
618
- input: true,
619
- output: false,
620
- default_value: 'test_value'
621
- }
622
- ],
623
- connections: [],
624
- error_handling: []
625
- };
626
- return generateFlowComponents(testFlow);
627
- }
628
- /**
629
- * Utility to extract sys_ids from existing ServiceNow records for update operations
630
- */
631
- function extractSysIds(existingFlow) {
632
- const sysIds = {};
633
- if (existingFlow.sys_id) {
634
- sysIds.flow = existingFlow.sys_id;
635
- }
636
- if (existingFlow.trigger_instance?.sys_id) {
637
- sysIds.trigger = existingFlow.trigger_instance.sys_id;
638
- }
639
- if (existingFlow.action_instances && Array.isArray(existingFlow.action_instances)) {
640
- existingFlow.action_instances.forEach((action, index) => {
641
- if (action.sys_id) {
642
- sysIds[`action_${index}`] = action.sys_id;
643
- }
644
- });
645
- }
646
- return sysIds;
647
- }
648
- /**
649
- * Generate flow update payload for modifying existing flows
650
- */
651
- function generateFlowUpdate(flowDefinition, existingSysIds) {
652
- const components = generateFlowComponents(flowDefinition, existingSysIds.flow);
653
- // Replace generated sys_ids with existing ones where available
654
- if (existingSysIds.trigger) {
655
- components.triggerInstance.sys_id = existingSysIds.trigger;
656
- }
657
- components.actionInstances.forEach((action, index) => {
658
- const existingId = existingSysIds[`action_${index}`];
659
- if (existingId) {
660
- action.sys_id = existingId;
661
- }
662
- });
663
- return components;
664
- }
665
- exports.default = {
666
- generateFlowComponents,
667
- createActionInstances,
668
- buildLogicChain,
669
- generateSysId,
670
- validateFlowComponents,
671
- generateFlowXML,
672
- convertToFlowDefinition,
673
- createTestFlowComponents,
674
- extractSysIds,
675
- generateFlowUpdate,
676
- ACTION_TYPE_IDS: exports.ACTION_TYPE_IDS
677
- };