@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,385 @@
1
+ /**
2
+ * Mock Repositories for Testing
3
+ *
4
+ * Note: After session-based refactoring, workflow runs are managed via SessionComponent.
5
+ * These mock repositories only handle workflow definitions.
6
+ */
7
+
8
+ import type { Workflow, WorkflowRun, RunStatus } from '../types';
9
+
10
+ // ==================== Mock RunRepository ====================
11
+
12
+ export interface MockRunRepositoryOptions {
13
+ workflowId?: string;
14
+ workflowName?: string;
15
+ }
16
+
17
+ export class MockRunRepository {
18
+ private runs: Map<string, WorkflowRun> = new Map();
19
+ private options: MockRunRepositoryOptions;
20
+
21
+ constructor(options: MockRunRepositoryOptions = {}) {
22
+ this.options = options;
23
+ }
24
+
25
+ setWorkflowInfo(workflowId: string, workflowName: string): void {
26
+ this.options.workflowId = workflowId;
27
+ this.options.workflowName = workflowName;
28
+ }
29
+
30
+ createWorkflowRun(run: Omit<WorkflowRun, 'id'>): WorkflowRun {
31
+ const id = `run_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
32
+
33
+ const created: WorkflowRun = {
34
+ ...run,
35
+ id,
36
+ };
37
+
38
+ this.runs.set(id, created);
39
+ return created;
40
+ }
41
+
42
+ getWorkflowRun(id: string): WorkflowRun | null {
43
+ return this.runs.get(id) || null;
44
+ }
45
+
46
+ listWorkflowRuns(workflowId?: string, options?: { status?: RunStatus }): WorkflowRun[] {
47
+ let runs = Array.from(this.runs.values());
48
+
49
+ if (workflowId) {
50
+ runs = runs.filter(r => r.workflowId === workflowId);
51
+ }
52
+
53
+ if (options?.status) {
54
+ runs = runs.filter(r => r.status === options.status);
55
+ }
56
+
57
+ // Sort by startedAt descending
58
+ runs.sort((a, b) => {
59
+ const aTime = a.startedAt?.getTime() || 0;
60
+ const bTime = b.startedAt?.getTime() || 0;
61
+ return bTime - aTime;
62
+ });
63
+
64
+ return runs;
65
+ }
66
+
67
+ updateWorkflowRun(id: string, updates: Partial<WorkflowRun>): WorkflowRun | null {
68
+ const existing = this.runs.get(id);
69
+ if (!existing) return null;
70
+
71
+ const updated: WorkflowRun = {
72
+ ...existing,
73
+ ...updates,
74
+ };
75
+
76
+ this.runs.set(id, updated);
77
+ return updated;
78
+ }
79
+
80
+ // Helper for testing
81
+ clear(): void {
82
+ this.runs.clear();
83
+ }
84
+
85
+ count(): number {
86
+ return this.runs.size;
87
+ }
88
+
89
+ // Helper for MockWorkflowEngine
90
+ setWorkflowName(name: string): void {
91
+ this.options.workflowName = name;
92
+ }
93
+ }
94
+
95
+ // ==================== Mock WorkflowRepository ====================
96
+
97
+ export class MockWorkflowRepository {
98
+ private workflows: Map<string, Workflow> = new Map();
99
+ private nameIndex: Map<string, string> = new Map(); // name -> id
100
+
101
+ create(workflow: Omit<Workflow, 'id' | 'createdAt' | 'updatedAt'>): Workflow {
102
+ const id = `wf_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
103
+ const now = new Date();
104
+
105
+ const created: Workflow = {
106
+ ...workflow,
107
+ id,
108
+ createdAt: now,
109
+ updatedAt: now,
110
+ };
111
+
112
+ this.workflows.set(id, created);
113
+ this.nameIndex.set(created.name, id);
114
+
115
+ return created;
116
+ }
117
+
118
+ getById(id: string): Workflow | null {
119
+ return this.workflows.get(id) || null;
120
+ }
121
+
122
+ getByName(name: string): Workflow | null {
123
+ const id = this.nameIndex.get(name);
124
+ return id ? this.workflows.get(id) || null : null;
125
+ }
126
+
127
+ list(options?: { tag?: string; limit?: number; offset?: number }): Workflow[] {
128
+ let workflows = Array.from(this.workflows.values());
129
+
130
+ if (options?.tag) {
131
+ workflows = workflows.filter(w => w.tags.includes(options.tag!));
132
+ }
133
+
134
+ // Sort by updatedAt descending
135
+ workflows.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
136
+
137
+ if (options?.offset) {
138
+ workflows = workflows.slice(options.offset);
139
+ }
140
+
141
+ if (options?.limit) {
142
+ workflows = workflows.slice(0, options.limit);
143
+ }
144
+
145
+ return workflows;
146
+ }
147
+
148
+ update(id: string, updates: Partial<Workflow>): Workflow | null {
149
+ const existing = this.workflows.get(id);
150
+ if (!existing) return null;
151
+
152
+ const updated: Workflow = {
153
+ ...existing,
154
+ ...updates,
155
+ id, // Ensure ID doesn't change
156
+ updatedAt: new Date(),
157
+ };
158
+
159
+ // Update name index if name changed
160
+ if (updates.name && updates.name !== existing.name) {
161
+ this.nameIndex.delete(existing.name);
162
+ this.nameIndex.set(updated.name, id);
163
+ }
164
+
165
+ this.workflows.set(id, updated);
166
+ return updated;
167
+ }
168
+
169
+ delete(id: string): boolean {
170
+ const workflow = this.workflows.get(id);
171
+ if (!workflow) return false;
172
+
173
+ this.workflows.delete(id);
174
+ this.nameIndex.delete(workflow.name);
175
+ return true;
176
+ }
177
+
178
+ exists(name: string): boolean {
179
+ return this.nameIndex.has(name);
180
+ }
181
+
182
+ // Helper for testing
183
+ clear(): void {
184
+ this.workflows.clear();
185
+ this.nameIndex.clear();
186
+ }
187
+
188
+ // Helper to get count
189
+ count(): number {
190
+ return this.workflows.size;
191
+ }
192
+ }
193
+
194
+ // ==================== Mock WorkflowEngine ====================
195
+
196
+ export interface MockEngineCall {
197
+ method: string;
198
+ args: any[];
199
+ result?: any;
200
+ timestamp: number;
201
+ }
202
+
203
+ // Factory type for creating mock engines
204
+ export type MockEngineFactory = () => MockWorkflowEngine;
205
+
206
+ export class MockWorkflowEngine {
207
+ calls: MockEngineCall[] = [];
208
+ private sessionResults: Map<string, any> = new Map();
209
+ private workflowName: string = '';
210
+
211
+ constructor() {
212
+ // No longer takes runRepository parameter
213
+ }
214
+
215
+ setWorkflowName(name: string): void {
216
+ this.workflowName = name;
217
+ }
218
+
219
+ getWorkflowName(): string {
220
+ return this.workflowName;
221
+ }
222
+
223
+ async createSession(
224
+ workflowId: string,
225
+ options?: { input?: Record<string, any>; workflowName?: string; workflowVersion?: string }
226
+ ): Promise<string> {
227
+ this.calls.push({
228
+ method: 'createSession',
229
+ args: [workflowId, options],
230
+ timestamp: Date.now(),
231
+ });
232
+
233
+ const sessionId = `workflow_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
234
+ this.sessionResults.set(sessionId, {
235
+ status: 'running',
236
+ output: null,
237
+ });
238
+
239
+ return sessionId;
240
+ }
241
+
242
+ async createRun(
243
+ workflowNameOrDefinition: string | any,
244
+ options?: { input?: Record<string, any>; debug?: boolean }
245
+ ): Promise<string> {
246
+ this.calls.push({
247
+ method: 'createRun',
248
+ args: [workflowNameOrDefinition, options],
249
+ timestamp: Date.now(),
250
+ });
251
+
252
+ const runId = `run_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
253
+ this.sessionResults.set(runId, {
254
+ status: 'idle',
255
+ output: null,
256
+ });
257
+
258
+ return runId;
259
+ }
260
+
261
+ async run(runId: string, options?: any): Promise<any> {
262
+ this.calls.push({
263
+ method: 'run',
264
+ args: [runId, options],
265
+ timestamp: Date.now(),
266
+ });
267
+
268
+ const isSync = options?.sync ?? true;
269
+
270
+ this.sessionResults.set(runId, {
271
+ status: isSync ? 'completed' : 'running',
272
+ output: { result: 'mocked' },
273
+ });
274
+
275
+ return {
276
+ runId,
277
+ status: isSync ? 'completed' : 'running',
278
+ output: { result: 'mocked' },
279
+ };
280
+ }
281
+
282
+ async runWorkflow(workflow: any, options?: any): Promise<any> {
283
+ this.calls.push({
284
+ method: 'runWorkflow',
285
+ args: [workflow, options],
286
+ timestamp: Date.now(),
287
+ });
288
+
289
+ const isSync = options?.sync ?? true;
290
+ const runId = `run_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
291
+
292
+ return {
293
+ runId,
294
+ sessionId: runId,
295
+ status: isSync ? 'completed' : 'running',
296
+ output: { result: 'mocked' },
297
+ };
298
+ }
299
+
300
+ async pause(sessionId: string): Promise<void> {
301
+ this.calls.push({
302
+ method: 'pause',
303
+ args: [sessionId],
304
+ timestamp: Date.now(),
305
+ });
306
+
307
+ this.sessionResults.set(sessionId, { status: 'paused' });
308
+ }
309
+
310
+ async resume(sessionId: string, options?: { userResponse?: string; pendingNodeId?: string; agentSessionId?: string }): Promise<any> {
311
+ this.calls.push({
312
+ method: 'resume',
313
+ args: [sessionId, options],
314
+ timestamp: Date.now(),
315
+ });
316
+
317
+ this.sessionResults.set(sessionId, { status: 'running' });
318
+
319
+ return {
320
+ sessionId,
321
+ status: 'running',
322
+ };
323
+ }
324
+
325
+ async stop(sessionId: string, reason?: string): Promise<void> {
326
+ this.calls.push({
327
+ method: 'stop',
328
+ args: [sessionId, reason],
329
+ timestamp: Date.now(),
330
+ });
331
+
332
+ this.sessionResults.set(sessionId, { status: 'stopped' });
333
+ }
334
+
335
+ async addNode(sessionId: string, nodeDefinition: any): Promise<void> {
336
+ this.calls.push({
337
+ method: 'addNode',
338
+ args: [sessionId, nodeDefinition],
339
+ timestamp: Date.now(),
340
+ });
341
+ }
342
+
343
+ async removeNode(sessionId: string, nodeId: string): Promise<void> {
344
+ this.calls.push({
345
+ method: 'removeNode',
346
+ args: [sessionId, nodeId],
347
+ timestamp: Date.now(),
348
+ });
349
+ }
350
+
351
+ // Helper for testing
352
+ clearCalls(): void {
353
+ this.calls = [];
354
+ }
355
+
356
+ getLastCall(): MockEngineCall | undefined {
357
+ return this.calls[this.calls.length - 1];
358
+ }
359
+
360
+ getCallsByMethod(method: string): MockEngineCall[] {
361
+ return this.calls.filter(c => c.method === method);
362
+ }
363
+ }
364
+
365
+ // ==================== Mock NodeRegistry ====================
366
+
367
+ export class MockNodeRegistry {
368
+ private nodes: Map<string, any> = new Map();
369
+
370
+ register(type: string, factory: any): void {
371
+ this.nodes.set(type, factory);
372
+ }
373
+
374
+ get(type: string): any {
375
+ return this.nodes.get(type);
376
+ }
377
+
378
+ has(type: string): boolean {
379
+ return this.nodes.has(type);
380
+ }
381
+
382
+ list(): string[] {
383
+ return Array.from(this.nodes.keys());
384
+ }
385
+ }
@@ -0,0 +1,179 @@
1
+ import { describe, it, expect } from 'bun:test';
2
+
3
+ /**
4
+ * SQLite Storage Tests
5
+ *
6
+ * Uses Bun's built-in bun:sqlite module.
7
+ *
8
+ * Note: After session-based refactoring, workflow runs are managed via SessionComponent.
9
+ * Only the workflows table tests are relevant here.
10
+ */
11
+
12
+ describe('SQLite Storage', () => {
13
+ // Helper to get in-memory database
14
+ function createTestDatabase() {
15
+ // eslint-disable-next-line @typescript-eslint/no-require-imports
16
+ const { Database } = require("bun:sqlite");
17
+ return new Database(":memory:");
18
+ }
19
+
20
+ describe('getDatabase', () => {
21
+ it('should return a Database instance', () => {
22
+ const db = createTestDatabase();
23
+ expect(db).toBeDefined();
24
+ expect(typeof db.exec).toBe('function');
25
+ expect(typeof db.prepare).toBe('function');
26
+ db.close();
27
+ });
28
+
29
+ it('should support basic SQL execution', () => {
30
+ const db = createTestDatabase();
31
+ db.exec("CREATE TABLE test (id TEXT PRIMARY KEY, name TEXT)");
32
+
33
+ const stmt = db.prepare("INSERT INTO test (id, name) VALUES (?, ?)");
34
+ stmt.run("1", "test");
35
+
36
+ const result = db.prepare("SELECT * FROM test").all();
37
+ expect(result).toHaveLength(1);
38
+ expect(result[0].name).toBe("test");
39
+
40
+ db.close();
41
+ });
42
+ });
43
+
44
+ describe('initializeTables', () => {
45
+ it('should create workflows table', () => {
46
+ const db = createTestDatabase();
47
+
48
+ db.exec(`
49
+ CREATE TABLE IF NOT EXISTS workflows (
50
+ id TEXT PRIMARY KEY,
51
+ name TEXT NOT NULL UNIQUE,
52
+ version TEXT NOT NULL DEFAULT '1.0',
53
+ description TEXT,
54
+ definition TEXT NOT NULL,
55
+ config TEXT NOT NULL DEFAULT '{}',
56
+ metadata TEXT NOT NULL DEFAULT '{}',
57
+ tags TEXT NOT NULL DEFAULT '[]',
58
+ task_id INTEGER,
59
+ created_at TEXT NOT NULL,
60
+ updated_at TEXT NOT NULL
61
+ )
62
+ `);
63
+
64
+ // Verify table exists
65
+ const tableInfo = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='workflows'").get();
66
+ expect(tableInfo).toBeDefined();
67
+
68
+ db.close();
69
+ });
70
+
71
+ it('should create indexes', () => {
72
+ const db = createTestDatabase();
73
+
74
+ // Create workflows table first
75
+ db.exec(`
76
+ CREATE TABLE IF NOT EXISTS workflows (
77
+ id TEXT PRIMARY KEY,
78
+ name TEXT NOT NULL UNIQUE,
79
+ version TEXT NOT NULL DEFAULT '1.0',
80
+ description TEXT,
81
+ definition TEXT NOT NULL,
82
+ config TEXT NOT NULL DEFAULT '{}',
83
+ metadata TEXT NOT NULL DEFAULT '{}',
84
+ tags TEXT NOT NULL DEFAULT '[]',
85
+ task_id INTEGER,
86
+ created_at TEXT NOT NULL,
87
+ updated_at TEXT NOT NULL
88
+ )
89
+ `);
90
+
91
+ // Create indexes
92
+ db.exec(`
93
+ CREATE INDEX IF NOT EXISTS idx_workflows_name ON workflows(name);
94
+ CREATE INDEX IF NOT EXISTS idx_workflows_tags ON workflows(tags);
95
+ CREATE INDEX IF NOT EXISTS idx_workflows_task_id ON workflows(task_id);
96
+ `);
97
+
98
+ // Verify indexes exist
99
+ const indexes = db.prepare("SELECT name FROM sqlite_master WHERE type='index'").all();
100
+ const indexNames = indexes.map((idx: any) => idx.name);
101
+ expect(indexNames).toContain("idx_workflows_name");
102
+ expect(indexNames).toContain("idx_workflows_tags");
103
+ expect(indexNames).toContain("idx_workflows_task_id");
104
+
105
+ db.close();
106
+ });
107
+ });
108
+
109
+ describe('getDatabasePath', () => {
110
+ it('should return default database path', () => {
111
+ const { getDatabasePath } = require("./sqlite");
112
+ const path = getDatabasePath();
113
+ expect(path).toBeDefined();
114
+ expect(path).toContain("workflows.db");
115
+ });
116
+ });
117
+
118
+ describe('closeDatabase', () => {
119
+ it('should close database without error', () => {
120
+ const db = createTestDatabase();
121
+ expect(() => db.close()).not.toThrow();
122
+ });
123
+ });
124
+
125
+ describe('integration: workflow table operations', () => {
126
+ it('should perform CRUD operations on workflows table', () => {
127
+ const db = createTestDatabase();
128
+
129
+ // Create workflows table
130
+ db.exec(`
131
+ CREATE TABLE IF NOT EXISTS workflows (
132
+ id TEXT PRIMARY KEY,
133
+ name TEXT NOT NULL UNIQUE,
134
+ version TEXT NOT NULL DEFAULT '1.0',
135
+ description TEXT,
136
+ definition TEXT NOT NULL,
137
+ config TEXT NOT NULL DEFAULT '{}',
138
+ metadata TEXT NOT NULL DEFAULT '{}',
139
+ tags TEXT NOT NULL DEFAULT '[]',
140
+ task_id INTEGER,
141
+ created_at TEXT NOT NULL,
142
+ updated_at TEXT NOT NULL
143
+ )
144
+ `);
145
+
146
+ // Insert a workflow
147
+ const now = new Date().toISOString();
148
+ const workflowDef = JSON.stringify({ name: "Test", nodes: [] });
149
+
150
+ db.prepare(`
151
+ INSERT INTO workflows (id, name, version, description, definition, config, metadata, tags, created_at, updated_at)
152
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
153
+ `).run("wf-1", "TestWorkflow", "1.0", "A test workflow", workflowDef, "{}", "{}", "[]", now, now);
154
+
155
+ // Verify data
156
+ const workflow = db.prepare("SELECT * FROM workflows WHERE id = ?").get("wf-1");
157
+ expect(workflow).toBeDefined();
158
+ expect(workflow.name).toBe("TestWorkflow");
159
+ expect(workflow.description).toBe("A test workflow");
160
+
161
+ // Update workflow
162
+ db.prepare(`
163
+ UPDATE workflows SET description = ?, updated_at = ? WHERE id = ?
164
+ `).run("Updated description", now, "wf-1");
165
+
166
+ const updatedWorkflow = db.prepare("SELECT * FROM workflows WHERE id = ?").get("wf-1");
167
+ expect(updatedWorkflow.description).toBe("Updated description");
168
+
169
+ // Delete workflow
170
+ db.prepare("DELETE FROM workflows WHERE id = ?").run("wf-1");
171
+
172
+ const deletedWorkflow = db.prepare("SELECT * FROM workflows WHERE id = ?").get("wf-1");
173
+ // SQLite's .get() returns null when no rows found
174
+ expect(deletedWorkflow).toBeNull();
175
+
176
+ db.close();
177
+ });
178
+ });
179
+ });