snow-flow 3.0.9 → 3.0.13

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