@ai-setting/roy-agent-core 1.0.0

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 (378) hide show
  1. package/dist/index.js +99145 -0
  2. package/package.json +114 -0
  3. package/src/config/config-component.test.ts +627 -0
  4. package/src/config/config-component.ts +906 -0
  5. package/src/config/config-parser.test.ts +319 -0
  6. package/src/config/config-parser.ts +203 -0
  7. package/src/config/decentralized-config.test.ts +740 -0
  8. package/src/config/env-key.ts +210 -0
  9. package/src/config/env-source.test.ts +252 -0
  10. package/src/config/env-source.ts +301 -0
  11. package/src/config/file-source.test.ts +357 -0
  12. package/src/config/file-source.ts +421 -0
  13. package/src/config/index.ts +24 -0
  14. package/src/config/protocol-resolver.test.ts +217 -0
  15. package/src/config/protocol-resolver.ts +228 -0
  16. package/src/env/agent/agent-component.abort.test.ts +511 -0
  17. package/src/env/agent/agent-component.record-session.test.ts +349 -0
  18. package/src/env/agent/agent-component.test.ts +1389 -0
  19. package/src/env/agent/agent-component.tool-error.test.ts +327 -0
  20. package/src/env/agent/agent-component.ts +1711 -0
  21. package/src/env/agent/agent-config-registration.test.ts +226 -0
  22. package/src/env/agent/agent-config-registration.ts +46 -0
  23. package/src/env/agent/agent-reminder-plugin.integration.test.ts +243 -0
  24. package/src/env/agent/index.ts +10 -0
  25. package/src/env/agent/summary-agent.parse-hint.test.ts +360 -0
  26. package/src/env/agent/summary-agent.ts +508 -0
  27. package/src/env/agent/types.ts +536 -0
  28. package/src/env/commands/commands-component.test.ts +364 -0
  29. package/src/env/commands/commands-component.ts +604 -0
  30. package/src/env/commands/commands-config-registration.test.ts +198 -0
  31. package/src/env/commands/commands-config-registration.ts +38 -0
  32. package/src/env/commands/index.ts +21 -0
  33. package/src/env/commands/parser.test.ts +203 -0
  34. package/src/env/commands/parser.ts +115 -0
  35. package/src/env/commands/types.ts +184 -0
  36. package/src/env/commands-prompt-integration.test.ts +243 -0
  37. package/src/env/component-env.test.ts +119 -0
  38. package/src/env/component.ts +335 -0
  39. package/src/env/constants.test.ts +72 -0
  40. package/src/env/constants.ts +123 -0
  41. package/src/env/debug/debug-component.test.ts +114 -0
  42. package/src/env/debug/debug-component.ts +547 -0
  43. package/src/env/debug/formatters/index.ts +9 -0
  44. package/src/env/debug/formatters/repl-formatter.test.ts +139 -0
  45. package/src/env/debug/formatters/repl-formatter.ts +358 -0
  46. package/src/env/debug/formatters/trace-formatter.test.ts +119 -0
  47. package/src/env/debug/formatters/trace-formatter.ts +191 -0
  48. package/src/env/debug/formatters/tree-formatter.test.ts +107 -0
  49. package/src/env/debug/formatters/tree-formatter.ts +325 -0
  50. package/src/env/debug/index.ts +38 -0
  51. package/src/env/debug/parser/regex-parser.test.ts +201 -0
  52. package/src/env/debug/parser/regex-parser.ts +196 -0
  53. package/src/env/debug/parser/span-builder.test.ts +241 -0
  54. package/src/env/debug/parser/span-builder.ts +386 -0
  55. package/src/env/debug/reader/log-reader.test.ts +170 -0
  56. package/src/env/debug/reader/log-reader.ts +186 -0
  57. package/src/env/debug/reader/span-db-reader.test.ts +118 -0
  58. package/src/env/debug/reader/span-db-reader.ts +201 -0
  59. package/src/env/debug/types.test.ts +187 -0
  60. package/src/env/debug/types.ts +171 -0
  61. package/src/env/environment-init.test.ts +183 -0
  62. package/src/env/environment-lifecycle.test.ts +516 -0
  63. package/src/env/environment-service.test.ts +332 -0
  64. package/src/env/environment.handle-query.test.ts +96 -0
  65. package/src/env/environment.test.ts +232 -0
  66. package/src/env/environment.ts +708 -0
  67. package/src/env/errors.test.ts +165 -0
  68. package/src/env/errors.ts +157 -0
  69. package/src/env/event-source/event-source-agent-handler.test.ts +193 -0
  70. package/src/env/event-source/event-source-agent-handler.ts +111 -0
  71. package/src/env/event-source/event-source-component.process-cleanup.test.ts +236 -0
  72. package/src/env/event-source/event-source-component.stop.test.ts +346 -0
  73. package/src/env/event-source/event-source-component.test.ts +1207 -0
  74. package/src/env/event-source/event-source-component.ts +1379 -0
  75. package/src/env/event-source/event-source-config-registration.test.ts +242 -0
  76. package/src/env/event-source/event-source-config-registration.ts +37 -0
  77. package/src/env/event-source/event-source-integration.test.ts +320 -0
  78. package/src/env/event-source/event-source-platform.test.ts +630 -0
  79. package/src/env/event-source/types.ts +298 -0
  80. package/src/env/hook/global-hook-manager.ts +162 -0
  81. package/src/env/hook/hook-manager.test.ts +374 -0
  82. package/src/env/hook/hook-manager.ts +309 -0
  83. package/src/env/hook/index.ts +38 -0
  84. package/src/env/hook/types.ts +138 -0
  85. package/src/env/index.ts +144 -0
  86. package/src/env/interface.ts +203 -0
  87. package/src/env/llm/hooks.test.ts +293 -0
  88. package/src/env/llm/hooks.ts +316 -0
  89. package/src/env/llm/index.ts +61 -0
  90. package/src/env/llm/invoke-threshold-check.test.ts +88 -0
  91. package/src/env/llm/invoke-timeout.test.ts +54 -0
  92. package/src/env/llm/invoke.test.ts +71 -0
  93. package/src/env/llm/invoke.ts +1039 -0
  94. package/src/env/llm/llm-config.test.ts +523 -0
  95. package/src/env/llm/llm.test.ts +233 -0
  96. package/src/env/llm/llm.ts +568 -0
  97. package/src/env/llm/provider.test.ts +182 -0
  98. package/src/env/llm/provider.ts +108 -0
  99. package/src/env/llm/transform.test.ts +251 -0
  100. package/src/env/llm/transform.ts +286 -0
  101. package/src/env/llm/types.test.ts +580 -0
  102. package/src/env/llm/types.ts +424 -0
  103. package/src/env/log-trace/decorator-otel.test.ts +182 -0
  104. package/src/env/log-trace/decorator.ts +230 -0
  105. package/src/env/log-trace/index.ts +79 -0
  106. package/src/env/log-trace/log-trace-component.test.ts +242 -0
  107. package/src/env/log-trace/log-trace-component.ts +497 -0
  108. package/src/env/log-trace/log-trace-config-registration.test.ts +348 -0
  109. package/src/env/log-trace/log-trace-config-registration.ts +45 -0
  110. package/src/env/log-trace/logger.test.ts +149 -0
  111. package/src/env/log-trace/logger.ts +522 -0
  112. package/src/env/log-trace/opentelemetry/cli-propagation.test.ts +147 -0
  113. package/src/env/log-trace/opentelemetry/cli-propagation.ts +194 -0
  114. package/src/env/log-trace/opentelemetry/integration.test.ts +668 -0
  115. package/src/env/log-trace/opentelemetry/mod.ts +25 -0
  116. package/src/env/log-trace/opentelemetry/propagation-env.test.ts +181 -0
  117. package/src/env/log-trace/opentelemetry/propagation-env.ts +136 -0
  118. package/src/env/log-trace/opentelemetry/propagation.test.ts +259 -0
  119. package/src/env/log-trace/opentelemetry/propagation.ts +215 -0
  120. package/src/env/log-trace/opentelemetry/tracer-provider-context.test.ts +166 -0
  121. package/src/env/log-trace/opentelemetry/tracer-provider.test.ts +379 -0
  122. package/src/env/log-trace/opentelemetry/tracer-provider.ts +612 -0
  123. package/src/env/log-trace/span-storage.test.ts +145 -0
  124. package/src/env/log-trace/span-storage.ts +230 -0
  125. package/src/env/log-trace/trace-context.test.ts +187 -0
  126. package/src/env/log-trace/trace-context.ts +162 -0
  127. package/src/env/log-trace/types.test.ts +63 -0
  128. package/src/env/log-trace/types.ts +172 -0
  129. package/src/env/mcp/README.md +244 -0
  130. package/src/env/mcp/__integration__/mcp-component.integration.test.ts +373 -0
  131. package/src/env/mcp/config.test.ts +74 -0
  132. package/src/env/mcp/config.ts +116 -0
  133. package/src/env/mcp/index.ts +41 -0
  134. package/src/env/mcp/loader.test.ts +161 -0
  135. package/src/env/mcp/loader.ts +209 -0
  136. package/src/env/mcp/mcp-component.test.ts +111 -0
  137. package/src/env/mcp/mcp-component.ts +358 -0
  138. package/src/env/mcp/mcp-config-registration.test.ts +304 -0
  139. package/src/env/mcp/mcp-config-registration.ts +50 -0
  140. package/src/env/mcp/scanner.test.ts +170 -0
  141. package/src/env/mcp/scanner.ts +246 -0
  142. package/src/env/mcp/tool/adapter.test.ts +520 -0
  143. package/src/env/mcp/tool/adapter.ts +521 -0
  144. package/src/env/mcp/tool/index.ts +5 -0
  145. package/src/env/mcp/types.test.ts +171 -0
  146. package/src/env/mcp/types.ts +79 -0
  147. package/src/env/memory/README.md +177 -0
  148. package/src/env/memory/built-in/index.ts +59 -0
  149. package/src/env/memory/built-in/recall-memory.ts +103 -0
  150. package/src/env/memory/built-in/record-memory.ts +148 -0
  151. package/src/env/memory/index.ts +20 -0
  152. package/src/env/memory/memory-component.test.ts +239 -0
  153. package/src/env/memory/memory-component.ts +503 -0
  154. package/src/env/memory/memory-config-registration.test.ts +67 -0
  155. package/src/env/memory/memory-config-registration.ts +48 -0
  156. package/src/env/memory/memory-config.ts +45 -0
  157. package/src/env/memory/memory-file.test.ts +268 -0
  158. package/src/env/memory/plugin/index.ts +48 -0
  159. package/src/env/memory/plugin/memory-agent.test.ts +249 -0
  160. package/src/env/memory/plugin/memory-agent.ts +365 -0
  161. package/src/env/memory/plugin/memory-manager.ts +198 -0
  162. package/src/env/memory/plugin/memory-plugin-agent.test.ts +145 -0
  163. package/src/env/memory/plugin/memory-plugin.ts +210 -0
  164. package/src/env/memory/plugin/plugin-simplified.test.ts +51 -0
  165. package/src/env/memory/plugin/recall-memory.test.ts +106 -0
  166. package/src/env/memory/plugin/recall-memory.ts +53 -0
  167. package/src/env/memory/plugin/types.ts +101 -0
  168. package/src/env/memory/tools/memory-agent-tools.ts +228 -0
  169. package/src/env/memory/types.ts +85 -0
  170. package/src/env/paths.ts +118 -0
  171. package/src/env/prompt/index.ts +18 -0
  172. package/src/env/prompt/memory-prompts.test.ts +91 -0
  173. package/src/env/prompt/prompt-component.test.ts +491 -0
  174. package/src/env/prompt/prompt-component.ts +619 -0
  175. package/src/env/prompt/prompt-config-registration.test.ts +213 -0
  176. package/src/env/prompt/prompt-config-registration.ts +39 -0
  177. package/src/env/prompt/prompts-index.ts +504 -0
  178. package/src/env/prompt/renderer.ts +67 -0
  179. package/src/env/prompt/types.ts +136 -0
  180. package/src/env/session/hooks.ts +18 -0
  181. package/src/env/session/index.ts +37 -0
  182. package/src/env/session/search-query-parser.test.ts +425 -0
  183. package/src/env/session/search-query-parser.ts +171 -0
  184. package/src/env/session/session-checkpoint.test.ts +523 -0
  185. package/src/env/session/session-component.extract-recent-messages.test.ts +209 -0
  186. package/src/env/session/session-component.test.ts +132 -0
  187. package/src/env/session/session-component.ts +1249 -0
  188. package/src/env/session/session-config-registration.test.ts +138 -0
  189. package/src/env/session/session-config-registration.ts +52 -0
  190. package/src/env/session/session-message-converter.test.ts +763 -0
  191. package/src/env/session/session-message-converter.ts +415 -0
  192. package/src/env/session/session-message-e2e.test.ts +448 -0
  193. package/src/env/session/session-search.test.ts +391 -0
  194. package/src/env/session/session-store.test.ts +362 -0
  195. package/src/env/session/session-store.ts +141 -0
  196. package/src/env/session/storage/index.ts +6 -0
  197. package/src/env/session/storage/memory.ts +502 -0
  198. package/src/env/session/storage/sqlite.ts +794 -0
  199. package/src/env/session/types.ts +742 -0
  200. package/src/env/skill/config.ts +39 -0
  201. package/src/env/skill/index.ts +6 -0
  202. package/src/env/skill/parser.test.ts +116 -0
  203. package/src/env/skill/parser.ts +77 -0
  204. package/src/env/skill/scanner.test.ts +211 -0
  205. package/src/env/skill/scanner.ts +119 -0
  206. package/src/env/skill/skill-component.test.ts +234 -0
  207. package/src/env/skill/skill-component.ts +352 -0
  208. package/src/env/skill/skill-config-registration.test.ts +60 -0
  209. package/src/env/skill/skill-config-registration.ts +43 -0
  210. package/src/env/skill/tool/index.ts +1 -0
  211. package/src/env/skill/tool/skill-tool.test.ts +100 -0
  212. package/src/env/skill/tool/skill-tool.ts +72 -0
  213. package/src/env/skill/types.ts +64 -0
  214. package/src/env/task/delegate/delegate-tool.test.ts +498 -0
  215. package/src/env/task/delegate/delegate-tool.ts +1014 -0
  216. package/src/env/task/delegate/index.ts +18 -0
  217. package/src/env/task/delegate/stop-tool.test.ts +140 -0
  218. package/src/env/task/delegate/stop-tool.ts +119 -0
  219. package/src/env/task/delegate/task-events.test.ts +178 -0
  220. package/src/env/task/delegate/task-events.ts +143 -0
  221. package/src/env/task/hooks/contexts.test.ts +92 -0
  222. package/src/env/task/hooks/contexts.ts +192 -0
  223. package/src/env/task/hooks/index.ts +23 -0
  224. package/src/env/task/hooks/task-hook-points.test.ts +32 -0
  225. package/src/env/task/hooks/task-hook-points.ts +54 -0
  226. package/src/env/task/index.ts +7 -0
  227. package/src/env/task/plugins/index.ts +13 -0
  228. package/src/env/task/plugins/task-plugin.test.ts +74 -0
  229. package/src/env/task/plugins/task-plugin.ts +89 -0
  230. package/src/env/task/plugins/task-tag-plugin.test.ts +377 -0
  231. package/src/env/task/plugins/task-tag-plugin.ts +319 -0
  232. package/src/env/task/plugins/task-workflow-extractor.integration.test.ts +226 -0
  233. package/src/env/task/plugins/workflow-extractor-agent.test.ts +107 -0
  234. package/src/env/task/plugins/workflow-extractor-agent.ts +225 -0
  235. package/src/env/task/storage/index.ts +6 -0
  236. package/src/env/task/storage/sqlite-task-store.test.ts +283 -0
  237. package/src/env/task/storage/sqlite-task-store.ts +903 -0
  238. package/src/env/task/storage/task-search.test.ts +291 -0
  239. package/src/env/task/tag-service.test.ts +198 -0
  240. package/src/env/task/tag-service.ts +264 -0
  241. package/src/env/task/task-component.test.ts +193 -0
  242. package/src/env/task/task-component.ts +658 -0
  243. package/src/env/task/task-config-registration.test.ts +57 -0
  244. package/src/env/task/task-config-registration.ts +37 -0
  245. package/src/env/task/task-types.test.ts +137 -0
  246. package/src/env/task/tools/complete-tool.ts +44 -0
  247. package/src/env/task/tools/create-tool.ts +49 -0
  248. package/src/env/task/tools/delete-tool.ts +43 -0
  249. package/src/env/task/tools/get-tool.ts +59 -0
  250. package/src/env/task/tools/index.ts +10 -0
  251. package/src/env/task/tools/list-tool.ts +40 -0
  252. package/src/env/task/tools/operation/create-tool.ts +48 -0
  253. package/src/env/task/tools/operation/delete-tool.ts +43 -0
  254. package/src/env/task/tools/operation/get-tool.ts +43 -0
  255. package/src/env/task/tools/operation/index.ts +9 -0
  256. package/src/env/task/tools/operation/list-tool.ts +40 -0
  257. package/src/env/task/tools/operation/operation-tools.test.ts +274 -0
  258. package/src/env/task/tools/operation/operation-types.ts +75 -0
  259. package/src/env/task/tools/operation/update-tool.ts +47 -0
  260. package/src/env/task/tools/task-tools.test.ts +203 -0
  261. package/src/env/task/tools/task-types.test.ts +75 -0
  262. package/src/env/task/tools/task-types.ts +68 -0
  263. package/src/env/task/tools/update-tool.ts +70 -0
  264. package/src/env/task/types.ts +160 -0
  265. package/src/env/tool/built-in/bash.ts +201 -0
  266. package/src/env/tool/built-in/echo.ts +29 -0
  267. package/src/env/tool/built-in/edit-file.test.ts +136 -0
  268. package/src/env/tool/built-in/edit-file.ts +92 -0
  269. package/src/env/tool/built-in/glob.test.ts +94 -0
  270. package/src/env/tool/built-in/glob.ts +65 -0
  271. package/src/env/tool/built-in/grep.test.ts +122 -0
  272. package/src/env/tool/built-in/grep.ts +108 -0
  273. package/src/env/tool/built-in/index.ts +44 -0
  274. package/src/env/tool/built-in/read-file.test.ts +84 -0
  275. package/src/env/tool/built-in/read-file.ts +75 -0
  276. package/src/env/tool/built-in/write-file.test.ts +119 -0
  277. package/src/env/tool/built-in/write-file.ts +68 -0
  278. package/src/env/tool/index.ts +24 -0
  279. package/src/env/tool/registry.test.ts +257 -0
  280. package/src/env/tool/registry.ts +167 -0
  281. package/src/env/tool/tool-component.test.ts +559 -0
  282. package/src/env/tool/tool-component.ts +563 -0
  283. package/src/env/tool/tool-config-registration.test.ts +249 -0
  284. package/src/env/tool/tool-config-registration.ts +46 -0
  285. package/src/env/tool/types.ts +267 -0
  286. package/src/env/tool/validator.test.ts +143 -0
  287. package/src/env/tool/validator.ts +44 -0
  288. package/src/env/types.ts +180 -0
  289. package/src/env/workflow/ask-user-tool-registration.test.ts +216 -0
  290. package/src/env/workflow/complex-workflow.integration.test.ts +1900 -0
  291. package/src/env/workflow/decorators/decorator-node.ts +229 -0
  292. package/src/env/workflow/decorators/decorator.test.ts +196 -0
  293. package/src/env/workflow/decorators/edge.ts +82 -0
  294. package/src/env/workflow/decorators/index.ts +31 -0
  295. package/src/env/workflow/decorators/node-as.ts +98 -0
  296. package/src/env/workflow/decorators/workflow.ts +54 -0
  297. package/src/env/workflow/engine/dag-manager.test.ts +570 -0
  298. package/src/env/workflow/engine/dag-manager.ts +594 -0
  299. package/src/env/workflow/engine/engine.ts +1422 -0
  300. package/src/env/workflow/engine/event-bus.test.ts +359 -0
  301. package/src/env/workflow/engine/event-bus.ts +156 -0
  302. package/src/env/workflow/engine/executor-agent-session.test.ts +84 -0
  303. package/src/env/workflow/engine/executor.test.ts +619 -0
  304. package/src/env/workflow/engine/executor.ts +593 -0
  305. package/src/env/workflow/engine/index.ts +24 -0
  306. package/src/env/workflow/engine/node-registry.test.ts +560 -0
  307. package/src/env/workflow/engine/node-registry.ts +289 -0
  308. package/src/env/workflow/engine/resume-removed.test.ts +22 -0
  309. package/src/env/workflow/engine/scheduler.test.ts +715 -0
  310. package/src/env/workflow/engine/scheduler.ts +318 -0
  311. package/src/env/workflow/engine/workflow-engine.test.ts +815 -0
  312. package/src/env/workflow/extractor/workflow-converter.ts +306 -0
  313. package/src/env/workflow/fixtures.ts +380 -0
  314. package/src/env/workflow/index.ts +38 -0
  315. package/src/env/workflow/integration/run-resume-unified.test.ts +186 -0
  316. package/src/env/workflow/integration/service-integration.test.ts +267 -0
  317. package/src/env/workflow/metadata/keys.ts +12 -0
  318. package/src/env/workflow/nodes/agent-component-adapter.test.ts +318 -0
  319. package/src/env/workflow/nodes/agent-component-adapter.ts +448 -0
  320. package/src/env/workflow/nodes/agent-node.test.ts +371 -0
  321. package/src/env/workflow/nodes/agent-node.ts +598 -0
  322. package/src/env/workflow/nodes/ask-user-node.ts +113 -0
  323. package/src/env/workflow/nodes/condition-node.ts +200 -0
  324. package/src/env/workflow/nodes/index.ts +9 -0
  325. package/src/env/workflow/nodes/merge-node.ts +141 -0
  326. package/src/env/workflow/nodes/skill-node.test.ts +253 -0
  327. package/src/env/workflow/nodes/skill-node.ts +393 -0
  328. package/src/env/workflow/nodes/tool-node.test.ts +251 -0
  329. package/src/env/workflow/nodes/tool-node.ts +493 -0
  330. package/src/env/workflow/nodes/workflow-llm-history.test.ts +455 -0
  331. package/src/env/workflow/nodes/workflow-node.test.ts +315 -0
  332. package/src/env/workflow/nodes/workflow-node.ts +311 -0
  333. package/src/env/workflow/service/index.ts +27 -0
  334. package/src/env/workflow/service/registry.test.ts +133 -0
  335. package/src/env/workflow/service/registry.ts +71 -0
  336. package/src/env/workflow/service/workflow-service.test.ts +310 -0
  337. package/src/env/workflow/service/workflow-service.ts +393 -0
  338. package/src/env/workflow/storage/index.ts +28 -0
  339. package/src/env/workflow/storage/mock-repositories.ts +385 -0
  340. package/src/env/workflow/storage/sqlite.test.ts +179 -0
  341. package/src/env/workflow/storage/sqlite.ts +163 -0
  342. package/src/env/workflow/storage/workflow-repo.test.ts +780 -0
  343. package/src/env/workflow/storage/workflow-repo.ts +342 -0
  344. package/src/env/workflow/tools/ask-user-tool.ts +82 -0
  345. package/src/env/workflow/tools/index.ts +26 -0
  346. package/src/env/workflow/tools/run-workflow.test.ts +352 -0
  347. package/src/env/workflow/tools/run-workflow.ts +214 -0
  348. package/src/env/workflow/types/context.ts +18 -0
  349. package/src/env/workflow/types/decorators-types.ts +198 -0
  350. package/src/env/workflow/types/event.test.ts +515 -0
  351. package/src/env/workflow/types/event.ts +193 -0
  352. package/src/env/workflow/types/index.ts +49 -0
  353. package/src/env/workflow/types/run.test.ts +437 -0
  354. package/src/env/workflow/types/run.ts +173 -0
  355. package/src/env/workflow/types/workflow-hil.ts +114 -0
  356. package/src/env/workflow/types/workflow-message.test.ts +138 -0
  357. package/src/env/workflow/types/workflow-message.ts +196 -0
  358. package/src/env/workflow/types/workflow-session.test.ts +95 -0
  359. package/src/env/workflow/types/workflow-session.ts +59 -0
  360. package/src/env/workflow/types/workflow.test.ts +495 -0
  361. package/src/env/workflow/types/workflow.ts +195 -0
  362. package/src/env/workflow/types_compat.ts +51 -0
  363. package/src/env/workflow/utils/create-workflow.ts +47 -0
  364. package/src/env/workflow/utils/execution-state.ts +245 -0
  365. package/src/env/workflow/utils/index.ts +18 -0
  366. package/src/env/workflow/utils/node-registry-helper.ts +58 -0
  367. package/src/env/workflow/utils/recovery-validator.test.ts +460 -0
  368. package/src/env/workflow/utils/recovery-validator.ts +377 -0
  369. package/src/env/workflow/utils/session-parser.test.ts +111 -0
  370. package/src/env/workflow/utils/session-parser.ts +94 -0
  371. package/src/env/workflow/utils/session-recovery.test.ts +334 -0
  372. package/src/env/workflow/utils/session-recovery.ts +188 -0
  373. package/src/env/workflow/utils/template-resolver.test.ts +258 -0
  374. package/src/env/workflow/utils/template-resolver.ts +436 -0
  375. package/src/env/workflow/utils/validation-rules.ts +149 -0
  376. package/src/env/workflow/workflow-component.ts +544 -0
  377. package/src/index.ts +422 -0
  378. package/src/utils/id.ts +21 -0
@@ -0,0 +1,815 @@
1
+ /**
2
+ * WorkflowEngine Integration Tests
3
+ *
4
+ * Tests for the WorkflowEngine class including:
5
+ * - Session ID generation and formatting
6
+ * - @TracedAs decorator presence
7
+ * - Basic engine state management
8
+ * - Method signatures
9
+ */
10
+
11
+ import { describe, it, expect, beforeEach, vi } from 'vitest';
12
+ import { WorkflowEngine } from './engine';
13
+ import { DAGManager } from './dag-manager';
14
+ import { NodeRegistry } from './node-registry';
15
+ import type { WorkflowDefinition, WorkflowSessionMetadata } from '../types';
16
+
17
+ // ==================== Mock Dependencies ====================
18
+
19
+ /**
20
+ * Create a minimal mock NodeRegistry for testing
21
+ */
22
+ function createMockNodeRegistry(): NodeRegistry {
23
+ // Create a minimal implementation that satisfies the interface
24
+ const mockGetNodeConfig = vi.fn();
25
+ const mockCreateExecutorContext = vi.fn();
26
+
27
+ return {
28
+ getNodeConfig: mockGetNodeConfig,
29
+ createExecutorContext: mockCreateExecutorContext,
30
+ } as unknown as NodeRegistry;
31
+ }
32
+
33
+ /**
34
+ * Create a mock SessionComponent for testing
35
+ */
36
+ function createMockSessionComponent() {
37
+ const sessions = new Map<string, any>();
38
+ const messages = new Map<string, any[]>();
39
+
40
+ // Create implementations first
41
+ const createImpl = async (session: any) => {
42
+ sessions.set(session.id, {
43
+ ...session,
44
+ metadata: session.metadata || {},
45
+ });
46
+ messages.set(session.id, []);
47
+ return session;
48
+ };
49
+
50
+ const getImpl = async (sessionId: string) => {
51
+ return sessions.get(sessionId) || null;
52
+ };
53
+
54
+ const updateImpl = async (sessionId: string, updates: any) => {
55
+ const session = sessions.get(sessionId);
56
+ if (session) {
57
+ Object.assign(session, updates);
58
+ }
59
+ return session;
60
+ };
61
+
62
+ const addMessageImpl = async (sessionId: string, message: any) => {
63
+ const msgs = messages.get(sessionId) || [];
64
+ msgs.push(message);
65
+ messages.set(sessionId, msgs);
66
+ return message;
67
+ };
68
+
69
+ const getMessagesImpl = async (sessionId: string) => {
70
+ return messages.get(sessionId) || [];
71
+ };
72
+
73
+ const clearImpl = () => {
74
+ sessions.clear();
75
+ messages.clear();
76
+ };
77
+
78
+ return {
79
+ sessions,
80
+ messages,
81
+
82
+ create: vi.fn(createImpl),
83
+ get: vi.fn(getImpl),
84
+ update: vi.fn(updateImpl),
85
+ addMessage: vi.fn(addMessageImpl),
86
+ getMessages: vi.fn(getMessagesImpl),
87
+ clear: vi.fn(clearImpl),
88
+ };
89
+ }
90
+
91
+ // ==================== Test Suite ====================
92
+
93
+ describe('WorkflowEngine', () => {
94
+ let mockNodeRegistry: NodeRegistry;
95
+ let mockSessionComponent: ReturnType<typeof createMockSessionComponent>;
96
+
97
+ beforeEach(() => {
98
+ mockNodeRegistry = createMockNodeRegistry();
99
+ mockSessionComponent = createMockSessionComponent();
100
+ });
101
+
102
+ // ==================== Constructor and Factory ====================
103
+
104
+ describe('constructor', () => {
105
+ it('should create engine with NodeRegistry', () => {
106
+ const engine = new WorkflowEngine(mockNodeRegistry);
107
+ expect(engine).toBeDefined();
108
+ // WorkflowEngine extends EventEmitter - verify basic functionality
109
+ expect(typeof engine.on).toBe('function');
110
+ expect(typeof engine.emit).toBe('function');
111
+ });
112
+
113
+ it('should create engine with NodeRegistry and SessionComponent', () => {
114
+ const engine = new WorkflowEngine(mockNodeRegistry, mockSessionComponent as any);
115
+ expect(engine).toBeDefined();
116
+ });
117
+
118
+ it('should create engine with all dependencies', () => {
119
+ const mockWorkflowRepo = {
120
+ getById: vi.fn(),
121
+ getByName: vi.fn(),
122
+ };
123
+
124
+ const engine = new WorkflowEngine(
125
+ mockNodeRegistry,
126
+ mockSessionComponent as any,
127
+ mockWorkflowRepo as any
128
+ );
129
+ expect(engine).toBeDefined();
130
+ });
131
+ });
132
+
133
+ // ==================== Session ID Methods ====================
134
+
135
+ describe('getSessionId', () => {
136
+ it('should generate correct session ID format', () => {
137
+ const engine = new WorkflowEngine(mockNodeRegistry);
138
+ const runId = 'run_12345_1_abc123';
139
+ const sessionId = engine.getSessionId(runId);
140
+
141
+ expect(sessionId).toBe('workflow_run_12345_1_abc123');
142
+ expect(sessionId.startsWith('workflow_')).toBe(true);
143
+ });
144
+
145
+ it('should handle different run ID formats', () => {
146
+ const engine = new WorkflowEngine(mockNodeRegistry);
147
+
148
+ // Test various run ID formats
149
+ expect(engine.getSessionId('run_1')).toBe('workflow_run_1');
150
+ expect(engine.getSessionId('run_123')).toBe('workflow_run_123');
151
+ expect(engine.getSessionId('simple')).toBe('workflow_simple');
152
+ });
153
+ });
154
+
155
+ // ==================== Session Creation ====================
156
+
157
+ describe('createSession', () => {
158
+ it('should create session with correct metadata', async () => {
159
+ const engine = new WorkflowEngine(mockNodeRegistry, mockSessionComponent as any);
160
+
161
+ // New API: first argument is WorkflowDefinition or Workflow
162
+ const workflow: WorkflowDefinition = {
163
+ name: 'Test Workflow',
164
+ version: '1.0',
165
+ nodes: [],
166
+ };
167
+
168
+ const sessionId = await engine.createSession(workflow, {
169
+ input: { test: 'data' },
170
+ });
171
+
172
+ // Verify session was created with correct ID format
173
+ expect(sessionId.startsWith('workflow_')).toBe(true);
174
+
175
+ // Verify session metadata
176
+ expect(mockSessionComponent.create).toHaveBeenCalledTimes(1);
177
+ const createCall = (mockSessionComponent.create as any).mock.calls[0][0];
178
+ expect(createCall.id).toBe(sessionId);
179
+ expect(createCall.metadata.type).toBe('workflow');
180
+ // workflowId is derived from workflow.id or 'inline_' + workflow.name
181
+ expect(createCall.metadata.workflowId).toBe('inline_Test Workflow');
182
+ expect(createCall.metadata.workflowName).toBe('Test Workflow');
183
+ expect(createCall.metadata.status).toBe('running');
184
+ expect(createCall.metadata.input).toEqual({ test: 'data' });
185
+ });
186
+
187
+ it('should create session without SessionComponent', async () => {
188
+ const engine = new WorkflowEngine(mockNodeRegistry);
189
+
190
+ const workflow: WorkflowDefinition = {
191
+ name: 'test-workflow',
192
+ version: '1.0',
193
+ nodes: [],
194
+ };
195
+
196
+ const sessionId = await engine.createSession(workflow);
197
+
198
+ // Should still return session ID even without SessionComponent
199
+ expect(sessionId).toBeDefined();
200
+ expect(sessionId.startsWith('workflow_')).toBe(true);
201
+ });
202
+
203
+ it('should include workflow version in metadata when provided', async () => {
204
+ const engine = new WorkflowEngine(mockNodeRegistry, mockSessionComponent as any);
205
+
206
+ const workflow: WorkflowDefinition = {
207
+ name: 'Test Workflow',
208
+ version: '2.0.0',
209
+ nodes: [],
210
+ };
211
+
212
+ await engine.createSession(workflow);
213
+
214
+ const createCall = (mockSessionComponent.create as any).mock.calls[0][0];
215
+ expect(createCall.metadata.workflowVersion).toBe('2.0.0');
216
+ });
217
+
218
+ it('should use Unknown as default workflow name', async () => {
219
+ const engine = new WorkflowEngine(mockNodeRegistry, mockSessionComponent as any);
220
+
221
+ const workflow: WorkflowDefinition = {
222
+ name: 'test-workflow',
223
+ version: '1.0',
224
+ nodes: [],
225
+ };
226
+
227
+ await engine.createSession(workflow);
228
+
229
+ const createCall = (mockSessionComponent.create as any).mock.calls[0][0];
230
+ expect(createCall.metadata.workflowName).toBe('test-workflow');
231
+ });
232
+ });
233
+
234
+ // ==================== Session Status Methods ====================
235
+
236
+ describe('getSessionStatus', () => {
237
+ it('should return null for non-existent session', () => {
238
+ const engine = new WorkflowEngine(mockNodeRegistry);
239
+
240
+ const status = engine.getSessionStatus('non-existent-session');
241
+ expect(status).toBeNull();
242
+ });
243
+ });
244
+
245
+ describe('isSessionActive', () => {
246
+ it('should return false for non-existent session', () => {
247
+ const engine = new WorkflowEngine(mockNodeRegistry);
248
+
249
+ expect(engine.isSessionActive('non-existent-session')).toBe(false);
250
+ });
251
+ });
252
+
253
+ // ==================== @TracedAs Decorator Tests ====================
254
+
255
+ describe('@TracedAs decorator presence', () => {
256
+ it('should have TracedAs on createSession method', async () => {
257
+ // The @TracedAs decorator wraps methods, so we verify it by checking
258
+ // the method exists and has expected behavior
259
+ const engine = new WorkflowEngine(mockNodeRegistry);
260
+
261
+ expect(typeof engine.createSession).toBe('function');
262
+
263
+ // The method should be traceable - verify it with proper WorkflowDefinition
264
+ const workflow: WorkflowDefinition = {
265
+ name: 'test',
266
+ version: '1.0',
267
+ nodes: [],
268
+ };
269
+ const sessionId = await engine.createSession(workflow);
270
+ expect(typeof sessionId).toBe('string');
271
+ expect(sessionId.startsWith('workflow_')).toBe(true);
272
+ });
273
+
274
+ it('should have TracedAs on run method', () => {
275
+ const engine = new WorkflowEngine(mockNodeRegistry);
276
+
277
+ expect(typeof engine.run).toBe('function');
278
+ });
279
+
280
+ it('should have TracedAs on runWorkflow method', () => {
281
+ const engine = new WorkflowEngine(mockNodeRegistry);
282
+
283
+ expect(typeof engine.runWorkflow).toBe('function');
284
+ });
285
+
286
+ it('should have TracedAs on pause method', () => {
287
+ const engine = new WorkflowEngine(mockNodeRegistry);
288
+
289
+ expect(typeof engine.pause).toBe('function');
290
+ });
291
+
292
+ it('should have TracedAs on stop method', () => {
293
+ const engine = new WorkflowEngine(mockNodeRegistry);
294
+
295
+ expect(typeof engine.stop).toBe('function');
296
+ });
297
+
298
+ // Note: The actual @TracedAs decorator behavior would be tested in
299
+ // integration tests that verify trace context propagation.
300
+ // Here we verify the methods exist and are callable.
301
+ });
302
+
303
+ // ==================== Static Factory Method ====================
304
+
305
+ describe('static create', () => {
306
+ it('should create engine via static factory', async () => {
307
+ const mockEnv = {
308
+ getComponent: vi.fn((name: string) => {
309
+ if (name === 'agent') return { /* mock agent */ };
310
+ if (name === 'session') return mockSessionComponent;
311
+ return undefined;
312
+ }),
313
+ };
314
+
315
+ const engine = await WorkflowEngine.create({
316
+ env: mockEnv as any,
317
+ });
318
+
319
+ expect(engine).toBeDefined();
320
+ expect(engine).toBeInstanceOf(WorkflowEngine);
321
+ });
322
+
323
+ it('should pass components to NodeRegistry', async () => {
324
+ const mockAgent = { name: 'mock-agent' };
325
+ const mockEnv = {
326
+ getComponent: vi.fn((name: string) => {
327
+ if (name === 'agent') return mockAgent;
328
+ return undefined;
329
+ }),
330
+ };
331
+
332
+ const engine = await WorkflowEngine.create({
333
+ env: mockEnv as any,
334
+ });
335
+
336
+ expect(engine).toBeDefined();
337
+ expect(mockEnv.getComponent).toHaveBeenCalledWith('agent');
338
+ });
339
+ });
340
+
341
+ // ==================== Run Method Tests ====================
342
+
343
+ describe('run', () => {
344
+ it('should throw error for new session without workflowId', async () => {
345
+ const engine = new WorkflowEngine(mockNodeRegistry);
346
+
347
+ await expect(engine.run('new-session-id')).rejects.toThrow(
348
+ 'workflowId required for new session'
349
+ );
350
+ });
351
+
352
+ it('should return completed status for completed session', async () => {
353
+ // Setup: Create a session with completed status
354
+ const completedSession = {
355
+ id: 'workflow_completed',
356
+ title: 'Test',
357
+ metadata: {
358
+ type: 'workflow',
359
+ workflowId: 'test-workflow',
360
+ workflowName: 'test-workflow',
361
+ status: 'completed',
362
+ },
363
+ };
364
+
365
+ // Mock the session component to return the completed session
366
+ const mockSC = createMockSessionComponent();
367
+ mockSC.sessions.set('workflow_completed', completedSession);
368
+ mockSC.get.mockResolvedValueOnce(completedSession);
369
+
370
+ // Mock workflow repository to return a valid workflow
371
+ const mockRepo = {
372
+ getById: vi.fn().mockReturnValue({
373
+ id: 'test-workflow',
374
+ definition: {
375
+ name: 'test-workflow',
376
+ version: '1.0',
377
+ nodes: [{ id: 'a', type: 'tool', config: {} }],
378
+ },
379
+ }),
380
+ getByName: vi.fn(),
381
+ };
382
+
383
+ const engine = new WorkflowEngine(mockNodeRegistry, mockSC as any, mockRepo as any);
384
+
385
+ const result = await engine.run('workflow_completed');
386
+ expect(result.status).toBe('completed');
387
+ });
388
+
389
+ it('should return failed status for failed session', async () => {
390
+ const failedSession = {
391
+ id: 'workflow_failed',
392
+ title: 'Test',
393
+ metadata: {
394
+ type: 'workflow',
395
+ workflowId: 'test-workflow',
396
+ workflowName: 'test-workflow',
397
+ status: 'failed',
398
+ },
399
+ };
400
+
401
+ // Mock the session component to return the failed session
402
+ const mockSC = createMockSessionComponent();
403
+ mockSC.sessions.set('workflow_failed', failedSession);
404
+ mockSC.get.mockResolvedValueOnce(failedSession);
405
+
406
+ // Mock workflow repository to return a valid workflow
407
+ const mockRepo = {
408
+ getById: vi.fn().mockReturnValue({
409
+ id: 'test-workflow',
410
+ definition: {
411
+ name: 'test-workflow',
412
+ version: '1.0',
413
+ nodes: [{ id: 'a', type: 'tool', config: {} }],
414
+ },
415
+ }),
416
+ getByName: vi.fn(),
417
+ };
418
+
419
+ const engine = new WorkflowEngine(mockNodeRegistry, mockSC as any, mockRepo as any);
420
+
421
+ const result = await engine.run('workflow_failed');
422
+ expect(result.status).toBe('failed');
423
+ });
424
+
425
+ // SKIP: Full run/resume tests require extensive mocking of DAGManager, Scheduler, Executor
426
+ it.skip('should start from entry node on fresh run - requires full integration', () => {
427
+ // This would require mocking DAGManager, Scheduler, Executor
428
+ // and verifying that execution starts from the workflow's entry node
429
+ });
430
+
431
+ it.skip('should validate recovery before execution on resume - requires full integration', () => {
432
+ // This would require setting up a paused session with messages
433
+ // and verifying that inferNextNode is called correctly
434
+ });
435
+ });
436
+
437
+ // ==================== Stop Method Tests ====================
438
+
439
+ describe('stop', () => {
440
+ it('should return without error for non-existent session', async () => {
441
+ const engine = new WorkflowEngine(mockNodeRegistry);
442
+
443
+ // New implementation returns void without throwing for non-existent session
444
+ await expect(engine.stop('non-existent')).resolves.toBeUndefined();
445
+ });
446
+
447
+ // SKIP: Full stop tests require active run state
448
+ it.skip('should update session status to stopped - requires active run', async () => {
449
+ // This requires an active run which is managed internally
450
+ // The test would need to trigger a workflow run and then stop it
451
+ });
452
+ });
453
+
454
+ // ==================== Pause Method Tests ====================
455
+
456
+ describe('pause', () => {
457
+ it('should throw error for non-existent session', async () => {
458
+ const engine = new WorkflowEngine(mockNodeRegistry);
459
+
460
+ await expect(engine.pause('non-existent')).rejects.toThrow(
461
+ 'Session not found'
462
+ );
463
+ });
464
+
465
+ it('should throw error for non-running session', async () => {
466
+ // Create an engine with a session that's not in activeRuns
467
+ const engine = new WorkflowEngine(mockNodeRegistry, mockSessionComponent as any);
468
+
469
+ // Even if session exists in sessionComponent, it's not in activeRuns
470
+ // so we should get "Session not found"
471
+ await expect(engine.pause('any-session')).rejects.toThrow(
472
+ 'Session not found'
473
+ );
474
+ });
475
+
476
+ // SKIP: Full pause tests require active run state
477
+ it.skip('should update session status to paused - requires active run', () => {
478
+ // This requires an active run which is managed internally
479
+ });
480
+ });
481
+
482
+ // ==================== RunWorkflow Method Tests ====================
483
+
484
+ describe('runWorkflow', () => {
485
+ it.skip('should execute workflow with valid definition - requires full integration', () => {
486
+ // This would require extensive mocking of the execution pipeline
487
+ });
488
+
489
+ it.skip('should validate DAG before execution - requires full integration', () => {
490
+ // This would require testing with an invalid workflow definition
491
+ });
492
+ });
493
+
494
+ // ==================== Internal Method Tests ====================
495
+
496
+ describe('internal methods', () => {
497
+ it('should generate unique run IDs', async () => {
498
+ const engine = new WorkflowEngine(mockNodeRegistry);
499
+
500
+ // Access internal generator through createSession
501
+ const workflow1: WorkflowDefinition = {
502
+ name: 'wf1',
503
+ version: '1.0',
504
+ nodes: [],
505
+ };
506
+ const workflow2: WorkflowDefinition = {
507
+ name: 'wf2',
508
+ version: '1.0',
509
+ nodes: [],
510
+ };
511
+
512
+ const sessionId1 = await engine.createSession(workflow1);
513
+ const sessionId2 = await engine.createSession(workflow2);
514
+
515
+ // Each session should have a unique run ID portion
516
+ expect(sessionId1).not.toBe(sessionId2);
517
+ });
518
+
519
+ it('should parse workflow ID from session ID', () => {
520
+ const engine = new WorkflowEngine(mockNodeRegistry);
521
+ const runId = 'run_123_1_abc';
522
+ const sessionId = `workflow_${runId}`;
523
+
524
+ const parsedRunId = sessionId.replace('workflow_', '');
525
+ expect(parsedRunId).toBe(runId);
526
+ });
527
+ });
528
+
529
+ // ==================== Event Emission Tests ====================
530
+
531
+ describe('event emission', () => {
532
+ it('should extend EventEmitter', () => {
533
+ const engine = new WorkflowEngine(mockNodeRegistry);
534
+
535
+ const eventHandler = vi.fn();
536
+ engine.on('test-event', eventHandler);
537
+ engine.emit('test-event', { data: 'test' });
538
+
539
+ expect(eventHandler).toHaveBeenCalledTimes(1);
540
+ });
541
+ });
542
+
543
+ // ==================== Error Handling Tests ====================
544
+
545
+ describe('error handling', () => {
546
+ it('should handle sessionComponent errors gracefully in createSession', async () => {
547
+ const failingSessionComponent = {
548
+ create: vi.fn().mockRejectedValue(new Error('DB connection failed')),
549
+ };
550
+
551
+ const engine = new WorkflowEngine(mockNodeRegistry, failingSessionComponent as any);
552
+
553
+ const workflow: WorkflowDefinition = {
554
+ name: 'test',
555
+ version: '1.0',
556
+ nodes: [],
557
+ };
558
+
559
+ // The error should propagate
560
+ await expect(engine.createSession(workflow)).rejects.toThrow('DB connection failed');
561
+ });
562
+
563
+ it('should handle missing workflow definition', async () => {
564
+ const engine = new WorkflowEngine(mockNodeRegistry);
565
+
566
+ // Trying to run with a workflowId that doesn't exist in the repository
567
+ await expect(
568
+ engine.run('new-session', { workflowId: 'non-existent-workflow' })
569
+ ).rejects.toThrow('Workflow not found');
570
+ });
571
+ });
572
+ });
573
+
574
+ // ==================== WorkflowEngine with DAGManager Integration ====================
575
+
576
+ describe('WorkflowEngine DAG Integration', () => {
577
+ let mockNodeRegistry: NodeRegistry;
578
+
579
+ beforeEach(() => {
580
+ mockNodeRegistry = createMockNodeRegistry();
581
+ });
582
+
583
+ describe('DAG validation', () => {
584
+ it('should use DAGManager for workflow validation', () => {
585
+ // Verify DAGManager can be instantiated with a workflow
586
+ const workflow: WorkflowDefinition = {
587
+ name: 'test-workflow',
588
+ version: '1.0',
589
+ nodes: [
590
+ { id: 'a', type: 'tool', config: {} },
591
+ { id: 'b', type: 'tool', config: {}, depends_on: ['a'] },
592
+ ],
593
+ };
594
+
595
+ const dagManager = new DAGManager(workflow);
596
+ const validation = dagManager.validate();
597
+
598
+ expect(validation.valid).toBe(true);
599
+ });
600
+
601
+ it('should detect invalid DAGs', () => {
602
+ const invalidWorkflow: WorkflowDefinition = {
603
+ name: 'invalid-workflow',
604
+ version: '1.0',
605
+ nodes: [
606
+ { id: 'a', type: 'tool', config: {} },
607
+ { id: 'b', type: 'tool', config: {}, depends_on: ['c'] }, // References non-existent node
608
+ ],
609
+ };
610
+
611
+ const dagManager = new DAGManager(invalidWorkflow);
612
+ const validation = dagManager.validate();
613
+
614
+ expect(validation.valid).toBe(false);
615
+ expect(validation.errors.length).toBeGreaterThan(0);
616
+ });
617
+
618
+ it('should detect circular dependencies', () => {
619
+ const circularWorkflow: WorkflowDefinition = {
620
+ name: 'circular-workflow',
621
+ version: '1.0',
622
+ nodes: [
623
+ { id: 'a', type: 'tool', config: {}, depends_on: ['b'] },
624
+ { id: 'b', type: 'tool', config: {}, depends_on: ['a'] },
625
+ ],
626
+ };
627
+
628
+ const dagManager = new DAGManager(circularWorkflow);
629
+ const validation = dagManager.validate();
630
+
631
+ expect(validation.valid).toBe(false);
632
+ });
633
+ });
634
+
635
+ describe('DAG analysis', () => {
636
+ it('should identify entry nodes', () => {
637
+ const workflow: WorkflowDefinition = {
638
+ name: 'test',
639
+ nodes: [
640
+ { id: 'a', type: 'tool', config: {} },
641
+ { id: 'b', type: 'tool', config: {} },
642
+ { id: 'c', type: 'tool', config: {}, depends_on: ['a', 'b'] },
643
+ ],
644
+ };
645
+
646
+ const dagManager = new DAGManager(workflow);
647
+ const analysis = dagManager.analyze();
648
+
649
+ expect(analysis.entryNodes).toContain('a');
650
+ expect(analysis.entryNodes).toContain('b');
651
+ expect(analysis.entryNodes).not.toContain('c');
652
+ });
653
+
654
+ it('should identify exit nodes', () => {
655
+ const workflow: WorkflowDefinition = {
656
+ name: 'test',
657
+ nodes: [
658
+ { id: 'a', type: 'tool', config: {} },
659
+ { id: 'b', type: 'tool', config: {}, depends_on: ['a'] },
660
+ { id: 'c', type: 'tool', config: {} },
661
+ ],
662
+ };
663
+
664
+ const dagManager = new DAGManager(workflow);
665
+ const analysis = dagManager.analyze();
666
+
667
+ expect(analysis.exitNodes).toContain('b');
668
+ expect(analysis.exitNodes).toContain('c');
669
+ });
670
+ });
671
+ });
672
+
673
+ // ==================== Session ID Format Tests ====================
674
+
675
+ describe('Session ID Format', () => {
676
+ let mockNodeRegistry: NodeRegistry;
677
+
678
+ beforeEach(() => {
679
+ mockNodeRegistry = createMockNodeRegistry();
680
+ });
681
+
682
+ it('should generate session ID with workflow_ prefix', () => {
683
+ const engine = new WorkflowEngine(mockNodeRegistry);
684
+ const sessionId = engine.getSessionId('run_123');
685
+ expect(sessionId.startsWith('workflow_')).toBe(true);
686
+ });
687
+
688
+ it('should preserve run ID in session ID', () => {
689
+ const engine = new WorkflowEngine(mockNodeRegistry);
690
+ const runId = 'run_12345_1_abc';
691
+ const sessionId = engine.getSessionId(runId);
692
+
693
+ expect(sessionId).toContain(runId);
694
+ });
695
+
696
+ it('should format session ID consistently', () => {
697
+ const engine = new WorkflowEngine(mockNodeRegistry);
698
+
699
+ const sessionId1 = engine.getSessionId('run_1');
700
+ const sessionId2 = engine.getSessionId('run_1');
701
+
702
+ expect(sessionId1).toBe(sessionId2);
703
+ });
704
+ });
705
+
706
+ // ==================== Integration Scenario Tests ====================
707
+
708
+ describe('WorkflowEngine Integration Scenarios', () => {
709
+ let mockNodeRegistry: NodeRegistry;
710
+ let mockSessionComponent: ReturnType<typeof createMockSessionComponent>;
711
+
712
+ beforeEach(() => {
713
+ mockNodeRegistry = createMockNodeRegistry();
714
+ mockSessionComponent = createMockSessionComponent();
715
+ });
716
+
717
+ describe('Session lifecycle', () => {
718
+ it('should track session creation flow', async () => {
719
+ const engine = new WorkflowEngine(mockNodeRegistry, mockSessionComponent as any);
720
+
721
+ const workflow: WorkflowDefinition = {
722
+ name: 'Test Workflow',
723
+ version: '1.0',
724
+ nodes: [],
725
+ };
726
+
727
+ const sessionId = await engine.createSession(workflow);
728
+
729
+ expect(mockSessionComponent.create).toHaveBeenCalledTimes(1);
730
+
731
+ // Use the mocked get method instead of direct access
732
+ const createdSession = await mockSessionComponent.get(sessionId);
733
+ expect(createdSession).toBeDefined();
734
+ expect(createdSession.metadata.status).toBe('running');
735
+ });
736
+
737
+ it('should handle session metadata updates', async () => {
738
+ const engine = new WorkflowEngine(mockNodeRegistry, mockSessionComponent as any);
739
+
740
+ const workflow: WorkflowDefinition = {
741
+ name: 'test-workflow',
742
+ version: '1.0',
743
+ nodes: [],
744
+ };
745
+
746
+ const sessionId = await engine.createSession(workflow);
747
+
748
+ // Simulate updating session status
749
+ await mockSessionComponent.update(sessionId, {
750
+ metadata: { status: 'paused' },
751
+ });
752
+
753
+ // Use the mocked get method instead of direct access
754
+ const updatedSession = await mockSessionComponent.get(sessionId);
755
+ expect(updatedSession.metadata.status).toBe('paused');
756
+ });
757
+ });
758
+
759
+ describe('Multiple concurrent sessions', () => {
760
+ it('should handle multiple session creations', async () => {
761
+ const engine = new WorkflowEngine(mockNodeRegistry, mockSessionComponent as any);
762
+
763
+ const workflow1: WorkflowDefinition = {
764
+ name: 'Workflow 1',
765
+ version: '1.0',
766
+ nodes: [],
767
+ };
768
+ const workflow2: WorkflowDefinition = {
769
+ name: 'Workflow 2',
770
+ version: '1.0',
771
+ nodes: [],
772
+ };
773
+ const workflow3: WorkflowDefinition = {
774
+ name: 'Workflow 3',
775
+ version: '1.0',
776
+ nodes: [],
777
+ };
778
+
779
+ const sessionId1 = await engine.createSession(workflow1);
780
+ const sessionId2 = await engine.createSession(workflow2);
781
+ const sessionId3 = await engine.createSession(workflow3);
782
+
783
+ expect(sessionId1).not.toBe(sessionId2);
784
+ expect(sessionId2).not.toBe(sessionId3);
785
+ expect(sessionId1).not.toBe(sessionId3);
786
+
787
+ expect(mockSessionComponent.create).toHaveBeenCalledTimes(3);
788
+ });
789
+
790
+ it('should store session metadata independently', async () => {
791
+ const engine = new WorkflowEngine(mockNodeRegistry, mockSessionComponent as any);
792
+
793
+ const workflow1: WorkflowDefinition = {
794
+ name: 'First',
795
+ version: '1.0',
796
+ nodes: [],
797
+ };
798
+ const workflow2: WorkflowDefinition = {
799
+ name: 'Second',
800
+ version: '1.0',
801
+ nodes: [],
802
+ };
803
+
804
+ const sessionId1 = await engine.createSession(workflow1);
805
+ const sessionId2 = await engine.createSession(workflow2);
806
+
807
+ // Use the mocked get method instead of direct access
808
+ const session1 = await mockSessionComponent.get(sessionId1);
809
+ const session2 = await mockSessionComponent.get(sessionId2);
810
+
811
+ expect(session1.metadata.workflowName).toBe('First');
812
+ expect(session2.metadata.workflowName).toBe('Second');
813
+ });
814
+ });
815
+ });