@sprinterai/runtime 0.3.0 → 0.5.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 (385) hide show
  1. package/LICENSE +21 -0
  2. package/dist/adapters/a2a-adapter.d.ts +37 -9
  3. package/dist/adapters/a2a-adapter.d.ts.map +1 -1
  4. package/dist/adapters/a2a-adapter.js +132 -9
  5. package/dist/adapters/a2a-adapter.js.map +1 -1
  6. package/dist/adapters/a2a-adapter.test.d.ts +2 -0
  7. package/dist/adapters/a2a-adapter.test.d.ts.map +1 -0
  8. package/dist/adapters/a2a-adapter.test.js +295 -0
  9. package/dist/adapters/a2a-adapter.test.js.map +1 -0
  10. package/dist/adapters/http-agent-adapter.d.ts +19 -9
  11. package/dist/adapters/http-agent-adapter.d.ts.map +1 -1
  12. package/dist/adapters/http-agent-adapter.js +55 -9
  13. package/dist/adapters/http-agent-adapter.js.map +1 -1
  14. package/dist/adapters/http-agent-adapter.test.d.ts +2 -0
  15. package/dist/adapters/http-agent-adapter.test.d.ts.map +1 -0
  16. package/dist/adapters/http-agent-adapter.test.js +164 -0
  17. package/dist/adapters/http-agent-adapter.test.js.map +1 -0
  18. package/dist/adapters/index.d.ts +8 -8
  19. package/dist/adapters/index.d.ts.map +1 -1
  20. package/dist/adapters/index.js +4 -4
  21. package/dist/adapters/index.js.map +1 -1
  22. package/dist/adapters/mcp-adapter.d.ts +29 -9
  23. package/dist/adapters/mcp-adapter.d.ts.map +1 -1
  24. package/dist/adapters/mcp-adapter.js +43 -8
  25. package/dist/adapters/mcp-adapter.js.map +1 -1
  26. package/dist/adapters/mcp-adapter.test.d.ts +2 -0
  27. package/dist/adapters/mcp-adapter.test.d.ts.map +1 -0
  28. package/dist/adapters/mcp-adapter.test.js +118 -0
  29. package/dist/adapters/mcp-adapter.test.js.map +1 -0
  30. package/dist/adapters/openclaw-adapter.d.ts +34 -8
  31. package/dist/adapters/openclaw-adapter.d.ts.map +1 -1
  32. package/dist/adapters/openclaw-adapter.js +38 -8
  33. package/dist/adapters/openclaw-adapter.js.map +1 -1
  34. package/dist/adapters/openclaw-adapter.test.d.ts +2 -0
  35. package/dist/adapters/openclaw-adapter.test.d.ts.map +1 -0
  36. package/dist/adapters/openclaw-adapter.test.js +77 -0
  37. package/dist/adapters/openclaw-adapter.test.js.map +1 -0
  38. package/dist/agent/agent-registry.test.js +1 -1
  39. package/dist/agent/agent-resolver.d.ts +8 -2
  40. package/dist/agent/agent-resolver.d.ts.map +1 -1
  41. package/dist/agent/agent-resolver.js +7 -1
  42. package/dist/agent/agent-resolver.js.map +1 -1
  43. package/dist/agent/agent-resolver.test.js +21 -3
  44. package/dist/agent/agent-resolver.test.js.map +1 -1
  45. package/dist/agent/delegate.test.js +1 -1
  46. package/dist/agent/execute-agent.d.ts +32 -8
  47. package/dist/agent/execute-agent.d.ts.map +1 -1
  48. package/dist/agent/execute-agent.js +40 -3
  49. package/dist/agent/execute-agent.js.map +1 -1
  50. package/dist/agent/index.d.ts +9 -9
  51. package/dist/agent/index.d.ts.map +1 -1
  52. package/dist/agent/index.js +5 -5
  53. package/dist/agent/index.js.map +1 -1
  54. package/dist/agent/prompt-builder.test.js +1 -1
  55. package/dist/approval/approval-manager.d.ts +19 -0
  56. package/dist/approval/approval-manager.d.ts.map +1 -0
  57. package/dist/approval/approval-manager.js +36 -0
  58. package/dist/approval/approval-manager.js.map +1 -0
  59. package/dist/approval/approval-manager.test.d.ts +2 -0
  60. package/dist/approval/approval-manager.test.d.ts.map +1 -0
  61. package/dist/approval/approval-manager.test.js +239 -0
  62. package/dist/approval/approval-manager.test.js.map +1 -0
  63. package/dist/approval/index.d.ts +3 -0
  64. package/dist/approval/index.d.ts.map +1 -0
  65. package/dist/approval/index.js +2 -0
  66. package/dist/approval/index.js.map +1 -0
  67. package/dist/chat/chat-handler.d.ts +14 -7
  68. package/dist/chat/chat-handler.d.ts.map +1 -1
  69. package/dist/chat/chat-handler.js +56 -11
  70. package/dist/chat/chat-handler.js.map +1 -1
  71. package/dist/chat/chat-handler.test.js +100 -11
  72. package/dist/chat/chat-handler.test.js.map +1 -1
  73. package/dist/chat/index.d.ts +3 -3
  74. package/dist/chat/index.js +2 -2
  75. package/dist/chat/message-utils.d.ts +15 -7
  76. package/dist/chat/message-utils.d.ts.map +1 -1
  77. package/dist/chat/message-utils.js +94 -22
  78. package/dist/chat/message-utils.js.map +1 -1
  79. package/dist/chat/message-utils.test.js +71 -1
  80. package/dist/chat/message-utils.test.js.map +1 -1
  81. package/dist/document/chunk-generator.d.ts +6 -0
  82. package/dist/document/chunk-generator.d.ts.map +1 -0
  83. package/dist/document/chunk-generator.js +107 -0
  84. package/dist/document/chunk-generator.js.map +1 -0
  85. package/dist/document/chunk-generator.test.d.ts +2 -0
  86. package/dist/document/chunk-generator.test.d.ts.map +1 -0
  87. package/dist/document/chunk-generator.test.js +166 -0
  88. package/dist/document/chunk-generator.test.js.map +1 -0
  89. package/dist/document/document-processor.d.ts +27 -0
  90. package/dist/document/document-processor.d.ts.map +1 -0
  91. package/dist/document/document-processor.js +44 -0
  92. package/dist/document/document-processor.js.map +1 -0
  93. package/dist/document/document-processor.test.d.ts +2 -0
  94. package/dist/document/document-processor.test.d.ts.map +1 -0
  95. package/dist/document/document-processor.test.js +197 -0
  96. package/dist/document/document-processor.test.js.map +1 -0
  97. package/dist/document/index.d.ts +5 -0
  98. package/dist/document/index.d.ts.map +1 -0
  99. package/dist/document/index.js +4 -0
  100. package/dist/document/index.js.map +1 -0
  101. package/dist/document/parsers/index.d.ts +2 -0
  102. package/dist/document/parsers/index.d.ts.map +1 -0
  103. package/dist/document/parsers/index.js +2 -0
  104. package/dist/document/parsers/index.js.map +1 -0
  105. package/dist/document/parsers/text-parser.d.ts +4 -0
  106. package/dist/document/parsers/text-parser.d.ts.map +1 -0
  107. package/dist/document/parsers/text-parser.js +23 -0
  108. package/dist/document/parsers/text-parser.js.map +1 -0
  109. package/dist/document/parsers/text-parser.test.d.ts +2 -0
  110. package/dist/document/parsers/text-parser.test.d.ts.map +1 -0
  111. package/dist/document/parsers/text-parser.test.js +64 -0
  112. package/dist/document/parsers/text-parser.test.js.map +1 -0
  113. package/dist/eval/eval-runner.test.js +2 -2
  114. package/dist/eval/index.d.ts +3 -3
  115. package/dist/eval/index.js +2 -2
  116. package/dist/eval/scorers.test.js +1 -1
  117. package/dist/events/event-bus.d.ts +12 -0
  118. package/dist/events/event-bus.d.ts.map +1 -0
  119. package/dist/events/event-bus.js +77 -0
  120. package/dist/events/event-bus.js.map +1 -0
  121. package/dist/events/event-bus.test.d.ts +2 -0
  122. package/dist/events/event-bus.test.d.ts.map +1 -0
  123. package/dist/events/event-bus.test.js +155 -0
  124. package/dist/events/event-bus.test.js.map +1 -0
  125. package/dist/events/index.d.ts +2 -0
  126. package/dist/events/index.d.ts.map +1 -0
  127. package/dist/events/index.js +2 -0
  128. package/dist/events/index.js.map +1 -0
  129. package/dist/guardrail/guardrail-pipeline.test.js +1 -1
  130. package/dist/guardrail/index.d.ts +2 -2
  131. package/dist/guardrail/index.js +1 -1
  132. package/dist/index.d.ts +81 -45
  133. package/dist/index.d.ts.map +1 -1
  134. package/dist/index.js +55 -27
  135. package/dist/index.js.map +1 -1
  136. package/dist/jobs/in-memory-job-queue.d.ts +20 -0
  137. package/dist/jobs/in-memory-job-queue.d.ts.map +1 -0
  138. package/dist/jobs/in-memory-job-queue.js +120 -0
  139. package/dist/jobs/in-memory-job-queue.js.map +1 -0
  140. package/dist/jobs/in-memory-job-queue.test.d.ts +2 -0
  141. package/dist/jobs/in-memory-job-queue.test.d.ts.map +1 -0
  142. package/dist/jobs/in-memory-job-queue.test.js +146 -0
  143. package/dist/jobs/in-memory-job-queue.test.js.map +1 -0
  144. package/dist/jobs/index.d.ts +4 -0
  145. package/dist/jobs/index.d.ts.map +1 -0
  146. package/dist/jobs/index.js +3 -0
  147. package/dist/jobs/index.js.map +1 -0
  148. package/dist/jobs/job-runner.d.ts +42 -0
  149. package/dist/jobs/job-runner.d.ts.map +1 -0
  150. package/dist/jobs/job-runner.js +119 -0
  151. package/dist/jobs/job-runner.js.map +1 -0
  152. package/dist/jobs/job-runner.test.d.ts +2 -0
  153. package/dist/jobs/job-runner.test.d.ts.map +1 -0
  154. package/dist/jobs/job-runner.test.js +190 -0
  155. package/dist/jobs/job-runner.test.js.map +1 -0
  156. package/dist/memory/index.d.ts +3 -3
  157. package/dist/memory/index.js +2 -2
  158. package/dist/memory/memory-prompt.d.ts +1 -1
  159. package/dist/module/create-runtime.d.ts +21 -6
  160. package/dist/module/create-runtime.d.ts.map +1 -1
  161. package/dist/module/create-runtime.js +7 -7
  162. package/dist/module/create-runtime.js.map +1 -1
  163. package/dist/module/create-runtime.test.js +8 -8
  164. package/dist/module/index.d.ts +5 -4
  165. package/dist/module/index.d.ts.map +1 -1
  166. package/dist/module/index.js +3 -2
  167. package/dist/module/index.js.map +1 -1
  168. package/dist/module/map-supabase-stores.d.ts +33 -0
  169. package/dist/module/map-supabase-stores.d.ts.map +1 -0
  170. package/dist/module/map-supabase-stores.js +28 -0
  171. package/dist/module/map-supabase-stores.js.map +1 -0
  172. package/dist/module/module-loader.d.ts +9 -1
  173. package/dist/module/module-loader.d.ts.map +1 -1
  174. package/dist/module/module-loader.js +40 -1
  175. package/dist/module/module-loader.js.map +1 -1
  176. package/dist/module/module-loader.test.js +38 -1
  177. package/dist/module/module-loader.test.js.map +1 -1
  178. package/dist/notification/digest-scheduler.d.ts +18 -0
  179. package/dist/notification/digest-scheduler.d.ts.map +1 -0
  180. package/dist/notification/digest-scheduler.js +44 -0
  181. package/dist/notification/digest-scheduler.js.map +1 -0
  182. package/dist/notification/digest-scheduler.test.d.ts +2 -0
  183. package/dist/notification/digest-scheduler.test.d.ts.map +1 -0
  184. package/dist/notification/digest-scheduler.test.js +306 -0
  185. package/dist/notification/digest-scheduler.test.js.map +1 -0
  186. package/dist/notification/index.d.ts +5 -0
  187. package/dist/notification/index.d.ts.map +1 -0
  188. package/dist/notification/index.js +3 -0
  189. package/dist/notification/index.js.map +1 -0
  190. package/dist/notification/notification-engine.d.ts +20 -0
  191. package/dist/notification/notification-engine.d.ts.map +1 -0
  192. package/dist/notification/notification-engine.js +78 -0
  193. package/dist/notification/notification-engine.js.map +1 -0
  194. package/dist/notification/notification-engine.test.d.ts +2 -0
  195. package/dist/notification/notification-engine.test.d.ts.map +1 -0
  196. package/dist/notification/notification-engine.test.js +364 -0
  197. package/dist/notification/notification-engine.test.js.map +1 -0
  198. package/dist/providers/index.d.ts +5 -0
  199. package/dist/providers/index.d.ts.map +1 -0
  200. package/dist/providers/index.js +3 -0
  201. package/dist/providers/index.js.map +1 -0
  202. package/dist/providers/model-resolver.d.ts +93 -0
  203. package/dist/providers/model-resolver.d.ts.map +1 -0
  204. package/dist/providers/model-resolver.js +152 -0
  205. package/dist/providers/model-resolver.js.map +1 -0
  206. package/dist/providers/model-resolver.test.d.ts +2 -0
  207. package/dist/providers/model-resolver.test.d.ts.map +1 -0
  208. package/dist/providers/model-resolver.test.js +199 -0
  209. package/dist/providers/model-resolver.test.js.map +1 -0
  210. package/dist/providers/noop-providers.d.ts +6 -0
  211. package/dist/providers/noop-providers.d.ts.map +1 -0
  212. package/dist/providers/noop-providers.js +15 -0
  213. package/dist/providers/noop-providers.js.map +1 -0
  214. package/dist/providers/noop-providers.test.d.ts +2 -0
  215. package/dist/providers/noop-providers.test.d.ts.map +1 -0
  216. package/dist/providers/noop-providers.test.js +63 -0
  217. package/dist/providers/noop-providers.test.js.map +1 -0
  218. package/dist/providers/provider-interfaces.d.ts +65 -0
  219. package/dist/providers/provider-interfaces.d.ts.map +1 -0
  220. package/dist/providers/provider-interfaces.js +2 -0
  221. package/dist/providers/provider-interfaces.js.map +1 -0
  222. package/dist/realtime/index.d.ts +3 -0
  223. package/dist/realtime/index.d.ts.map +1 -0
  224. package/dist/realtime/index.js +2 -0
  225. package/dist/realtime/index.js.map +1 -0
  226. package/dist/realtime/realtime-manager.d.ts +20 -0
  227. package/dist/realtime/realtime-manager.d.ts.map +1 -0
  228. package/dist/realtime/realtime-manager.js +110 -0
  229. package/dist/realtime/realtime-manager.js.map +1 -0
  230. package/dist/realtime/realtime-manager.test.d.ts +2 -0
  231. package/dist/realtime/realtime-manager.test.d.ts.map +1 -0
  232. package/dist/realtime/realtime-manager.test.js +273 -0
  233. package/dist/realtime/realtime-manager.test.js.map +1 -0
  234. package/dist/scoring/compute-score.test.js +1 -1
  235. package/dist/scoring/index.d.ts +2 -2
  236. package/dist/scoring/index.js +1 -1
  237. package/dist/search/cosine-similarity.d.ts +8 -0
  238. package/dist/search/cosine-similarity.d.ts.map +1 -0
  239. package/dist/search/cosine-similarity.js +28 -0
  240. package/dist/search/cosine-similarity.js.map +1 -0
  241. package/dist/search/cosine-similarity.test.d.ts +2 -0
  242. package/dist/search/cosine-similarity.test.d.ts.map +1 -0
  243. package/dist/search/cosine-similarity.test.js +49 -0
  244. package/dist/search/cosine-similarity.test.js.map +1 -0
  245. package/dist/search/hybrid-search.d.ts +47 -0
  246. package/dist/search/hybrid-search.d.ts.map +1 -0
  247. package/dist/search/hybrid-search.js +111 -0
  248. package/dist/search/hybrid-search.js.map +1 -0
  249. package/dist/search/hybrid-search.test.d.ts +2 -0
  250. package/dist/search/hybrid-search.test.d.ts.map +1 -0
  251. package/dist/search/hybrid-search.test.js +238 -0
  252. package/dist/search/hybrid-search.test.js.map +1 -0
  253. package/dist/search/in-memory-search.d.ts +17 -0
  254. package/dist/search/in-memory-search.d.ts.map +1 -0
  255. package/dist/search/in-memory-search.js +59 -0
  256. package/dist/search/in-memory-search.js.map +1 -0
  257. package/dist/search/in-memory-search.test.d.ts +2 -0
  258. package/dist/search/in-memory-search.test.d.ts.map +1 -0
  259. package/dist/search/in-memory-search.test.js +169 -0
  260. package/dist/search/in-memory-search.test.js.map +1 -0
  261. package/dist/search/index.d.ts +6 -0
  262. package/dist/search/index.d.ts.map +1 -0
  263. package/dist/search/index.js +4 -0
  264. package/dist/search/index.js.map +1 -0
  265. package/dist/testing/in-memory-agent-store.d.ts +5 -1
  266. package/dist/testing/in-memory-agent-store.d.ts.map +1 -1
  267. package/dist/testing/in-memory-agent-store.js +19 -0
  268. package/dist/testing/in-memory-agent-store.js.map +1 -1
  269. package/dist/testing/in-memory-agent-store.test.js +1 -1
  270. package/dist/testing/in-memory-chat-store.d.ts.map +1 -1
  271. package/dist/testing/in-memory-chat-store.js +2 -1
  272. package/dist/testing/in-memory-chat-store.js.map +1 -1
  273. package/dist/testing/in-memory-entity-store.d.ts +5 -1
  274. package/dist/testing/in-memory-entity-store.d.ts.map +1 -1
  275. package/dist/testing/in-memory-entity-store.js +69 -4
  276. package/dist/testing/in-memory-entity-store.js.map +1 -1
  277. package/dist/testing/in-memory-entity-store.test.js +1 -1
  278. package/dist/testing/in-memory-memory-store.d.ts +3 -1
  279. package/dist/testing/in-memory-memory-store.d.ts.map +1 -1
  280. package/dist/testing/in-memory-memory-store.js +20 -0
  281. package/dist/testing/in-memory-memory-store.js.map +1 -1
  282. package/dist/testing/in-memory-tool-store.d.ts +13 -2
  283. package/dist/testing/in-memory-tool-store.d.ts.map +1 -1
  284. package/dist/testing/in-memory-tool-store.js +51 -0
  285. package/dist/testing/in-memory-tool-store.js.map +1 -1
  286. package/dist/testing/index.d.ts +7 -7
  287. package/dist/testing/index.js +7 -7
  288. package/dist/tool/ai-bridge.d.ts +1 -0
  289. package/dist/tool/ai-bridge.d.ts.map +1 -1
  290. package/dist/tool/ai-bridge.js +1 -0
  291. package/dist/tool/ai-bridge.js.map +1 -1
  292. package/dist/tool/ai-bridge.test.js +1 -1
  293. package/dist/tool/catalog.d.ts +19 -0
  294. package/dist/tool/catalog.d.ts.map +1 -0
  295. package/dist/tool/catalog.js +88 -0
  296. package/dist/tool/catalog.js.map +1 -0
  297. package/dist/tool/catalog.test.d.ts +2 -0
  298. package/dist/tool/catalog.test.d.ts.map +1 -0
  299. package/dist/tool/catalog.test.js +129 -0
  300. package/dist/tool/catalog.test.js.map +1 -0
  301. package/dist/tool/entity-tools-factory.test.js +2 -2
  302. package/dist/tool/execute-registered-tool.d.ts +17 -0
  303. package/dist/tool/execute-registered-tool.d.ts.map +1 -0
  304. package/dist/tool/execute-registered-tool.js +24 -0
  305. package/dist/tool/execute-registered-tool.js.map +1 -0
  306. package/dist/tool/execute-registered-tool.test.d.ts +2 -0
  307. package/dist/tool/execute-registered-tool.test.d.ts.map +1 -0
  308. package/dist/tool/execute-registered-tool.test.js +73 -0
  309. package/dist/tool/execute-registered-tool.test.js.map +1 -0
  310. package/dist/tool/index.d.ts +11 -7
  311. package/dist/tool/index.d.ts.map +1 -1
  312. package/dist/tool/index.js +7 -5
  313. package/dist/tool/index.js.map +1 -1
  314. package/dist/tool/resolve-tools.d.ts +3 -1
  315. package/dist/tool/resolve-tools.d.ts.map +1 -1
  316. package/dist/tool/resolve-tools.js +1 -1
  317. package/dist/tool/resolve-tools.js.map +1 -1
  318. package/dist/tool/resolve-tools.test.js +1 -1
  319. package/dist/tool/tool-executor.d.ts +3 -2
  320. package/dist/tool/tool-executor.d.ts.map +1 -1
  321. package/dist/tool/tool-executor.js +4 -2
  322. package/dist/tool/tool-executor.js.map +1 -1
  323. package/dist/tool/tool-executor.test.js +2 -2
  324. package/dist/tool/tool-registry.test.js +1 -1
  325. package/dist/tool/zod-to-json-schema.d.ts +7 -0
  326. package/dist/tool/zod-to-json-schema.d.ts.map +1 -0
  327. package/dist/tool/zod-to-json-schema.js +12 -0
  328. package/dist/tool/zod-to-json-schema.js.map +1 -0
  329. package/dist/tool/zod-to-json-schema.test.d.ts +2 -0
  330. package/dist/tool/zod-to-json-schema.test.d.ts.map +1 -0
  331. package/dist/tool/zod-to-json-schema.test.js +127 -0
  332. package/dist/tool/zod-to-json-schema.test.js.map +1 -0
  333. package/dist/webhook/index.d.ts +4 -0
  334. package/dist/webhook/index.d.ts.map +1 -0
  335. package/dist/webhook/index.js +3 -0
  336. package/dist/webhook/index.js.map +1 -0
  337. package/dist/webhook/webhook-delivery.d.ts +12 -0
  338. package/dist/webhook/webhook-delivery.d.ts.map +1 -0
  339. package/dist/webhook/webhook-delivery.js +102 -0
  340. package/dist/webhook/webhook-delivery.js.map +1 -0
  341. package/dist/webhook/webhook-delivery.test.d.ts +2 -0
  342. package/dist/webhook/webhook-delivery.test.d.ts.map +1 -0
  343. package/dist/webhook/webhook-delivery.test.js +284 -0
  344. package/dist/webhook/webhook-delivery.test.js.map +1 -0
  345. package/dist/webhook/webhook-signer.d.ts +14 -0
  346. package/dist/webhook/webhook-signer.d.ts.map +1 -0
  347. package/dist/webhook/webhook-signer.js +31 -0
  348. package/dist/webhook/webhook-signer.js.map +1 -0
  349. package/dist/webhook/webhook-signer.test.d.ts +2 -0
  350. package/dist/webhook/webhook-signer.test.d.ts.map +1 -0
  351. package/dist/webhook/webhook-signer.test.js +74 -0
  352. package/dist/webhook/webhook-signer.test.js.map +1 -0
  353. package/dist/workflow/compile.js +4 -1
  354. package/dist/workflow/compile.js.map +1 -1
  355. package/dist/workflow/compile.test.js +1 -1
  356. package/dist/workflow/evaluate-nodes.d.ts +24 -0
  357. package/dist/workflow/evaluate-nodes.d.ts.map +1 -0
  358. package/dist/workflow/evaluate-nodes.js +126 -0
  359. package/dist/workflow/evaluate-nodes.js.map +1 -0
  360. package/dist/workflow/evaluate-nodes.test.d.ts +2 -0
  361. package/dist/workflow/evaluate-nodes.test.d.ts.map +1 -0
  362. package/dist/workflow/evaluate-nodes.test.js +363 -0
  363. package/dist/workflow/evaluate-nodes.test.js.map +1 -0
  364. package/dist/workflow/index.d.ts +8 -3
  365. package/dist/workflow/index.d.ts.map +1 -1
  366. package/dist/workflow/index.js +4 -2
  367. package/dist/workflow/index.js.map +1 -1
  368. package/dist/workflow/node-executor.d.ts +40 -0
  369. package/dist/workflow/node-executor.d.ts.map +1 -0
  370. package/dist/workflow/node-executor.js +2 -0
  371. package/dist/workflow/node-executor.js.map +1 -0
  372. package/dist/workflow/node-executor.test.d.ts +2 -0
  373. package/dist/workflow/node-executor.test.d.ts.map +1 -0
  374. package/dist/workflow/node-executor.test.js +91 -0
  375. package/dist/workflow/node-executor.test.js.map +1 -0
  376. package/dist/workflow/status.test.js +1 -1
  377. package/dist/workflow/workflow-runner.d.ts +57 -0
  378. package/dist/workflow/workflow-runner.d.ts.map +1 -0
  379. package/dist/workflow/workflow-runner.js +263 -0
  380. package/dist/workflow/workflow-runner.js.map +1 -0
  381. package/dist/workflow/workflow-runner.test.d.ts +2 -0
  382. package/dist/workflow/workflow-runner.test.d.ts.map +1 -0
  383. package/dist/workflow/workflow-runner.test.js +657 -0
  384. package/dist/workflow/workflow-runner.test.js.map +1 -0
  385. package/package.json +19 -14
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=model-resolver.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"model-resolver.test.d.ts","sourceRoot":"","sources":["../../src/providers/model-resolver.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,199 @@
1
+ import { describe, it, expect } from 'vitest';
2
+ import { MODEL_REGISTRY, getModelConfig, listModels, getDefaultModel, resolveModel, createProviderRegistry, } from './model-resolver.js';
3
+ /** Minimal LanguageModel stub for testing -- only needs the fields resolveModel returns. */
4
+ function stubModel(id) {
5
+ return { modelId: id };
6
+ }
7
+ // ---------------------------------------------------------------------------
8
+ // MODEL_REGISTRY
9
+ // ---------------------------------------------------------------------------
10
+ describe('MODEL_REGISTRY', () => {
11
+ it('contains at least one model per provider', () => {
12
+ const providers = new Set(MODEL_REGISTRY.map((m) => m.provider));
13
+ expect(providers).toContain('anthropic');
14
+ expect(providers).toContain('openai');
15
+ expect(providers).toContain('google');
16
+ expect(providers).toContain('deepseek');
17
+ expect(providers).toContain('xai');
18
+ });
19
+ it('has unique model IDs', () => {
20
+ const ids = MODEL_REGISTRY.map((m) => m.id);
21
+ expect(new Set(ids).size).toBe(ids.length);
22
+ });
23
+ it('every model has required fields', () => {
24
+ for (const m of MODEL_REGISTRY) {
25
+ expect(m.id).toBeTruthy();
26
+ expect(m.provider).toBeTruthy();
27
+ expect(m.modelId).toBeTruthy();
28
+ expect(m.displayName).toBeTruthy();
29
+ }
30
+ });
31
+ });
32
+ // ---------------------------------------------------------------------------
33
+ // getModelConfig
34
+ // ---------------------------------------------------------------------------
35
+ describe('getModelConfig', () => {
36
+ it('returns the config for a known model', () => {
37
+ const config = getModelConfig('gpt-4o');
38
+ expect(config).toBeDefined();
39
+ expect(config?.provider).toBe('openai');
40
+ expect(config?.modelId).toBe('gpt-4o');
41
+ });
42
+ it('returns undefined for an unknown model', () => {
43
+ expect(getModelConfig('nonexistent-model-xyz')).toBeUndefined();
44
+ });
45
+ it('returns correct metadata for claude-sonnet-4', () => {
46
+ const config = getModelConfig('claude-sonnet-4');
47
+ expect(config).toEqual({
48
+ id: 'claude-sonnet-4',
49
+ provider: 'anthropic',
50
+ modelId: 'claude-sonnet-4-20250514',
51
+ displayName: 'Claude Sonnet 4',
52
+ contextWindow: 200_000,
53
+ supportsVision: true,
54
+ supportsTools: true,
55
+ });
56
+ });
57
+ });
58
+ // ---------------------------------------------------------------------------
59
+ // listModels
60
+ // ---------------------------------------------------------------------------
61
+ describe('listModels', () => {
62
+ it('returns all models when no filter is given', () => {
63
+ const all = listModels();
64
+ expect(all).toHaveLength(MODEL_REGISTRY.length);
65
+ });
66
+ it('returns a copy, not a reference to the registry', () => {
67
+ const all = listModels();
68
+ all.pop();
69
+ expect(listModels()).toHaveLength(MODEL_REGISTRY.length);
70
+ });
71
+ it('filters by provider', () => {
72
+ const anthropicModels = listModels({ provider: 'anthropic' });
73
+ expect(anthropicModels.length).toBeGreaterThan(0);
74
+ expect(anthropicModels.every((m) => m.provider === 'anthropic')).toBe(true);
75
+ });
76
+ it('filters by supportsTools', () => {
77
+ const withTools = listModels({ supportsTools: true });
78
+ expect(withTools.every((m) => m.supportsTools === true)).toBe(true);
79
+ });
80
+ it('filters by supportsVision', () => {
81
+ const withVision = listModels({ supportsVision: true });
82
+ expect(withVision.length).toBeGreaterThan(0);
83
+ expect(withVision.every((m) => m.supportsVision === true)).toBe(true);
84
+ });
85
+ it('filters by supportsVision=false excludes vision models', () => {
86
+ const noVision = listModels({ supportsVision: false });
87
+ // Models without supportsVision set (undefined) should match supportsVision=false
88
+ expect(noVision.every((m) => m.supportsVision !== true)).toBe(true);
89
+ });
90
+ it('combines provider and capability filters', () => {
91
+ const googleWithVision = listModels({ provider: 'google', supportsVision: true });
92
+ expect(googleWithVision.length).toBeGreaterThan(0);
93
+ expect(googleWithVision.every((m) => m.provider === 'google' && m.supportsVision)).toBe(true);
94
+ });
95
+ it('returns empty array when no models match', () => {
96
+ const result = listModels({ provider: 'deepseek', supportsVision: true });
97
+ expect(result).toEqual([]);
98
+ });
99
+ });
100
+ // ---------------------------------------------------------------------------
101
+ // getDefaultModel
102
+ // ---------------------------------------------------------------------------
103
+ describe('getDefaultModel', () => {
104
+ it('returns gpt-4o as the default', () => {
105
+ const config = getDefaultModel();
106
+ expect(config.id).toBe('gpt-4o');
107
+ expect(config.provider).toBe('openai');
108
+ });
109
+ });
110
+ // ---------------------------------------------------------------------------
111
+ // resolveModel
112
+ // ---------------------------------------------------------------------------
113
+ describe('resolveModel', () => {
114
+ /** Track which provider-specific model ID each factory received. */
115
+ function makeTrackingProviders() {
116
+ const calls = [];
117
+ const providers = createProviderRegistry({
118
+ anthropic: (id) => {
119
+ calls.push(id);
120
+ return stubModel(id);
121
+ },
122
+ openai: (id) => {
123
+ calls.push(id);
124
+ return stubModel(id);
125
+ },
126
+ google: (id) => {
127
+ calls.push(id);
128
+ return stubModel(id);
129
+ },
130
+ deepseek: (id) => {
131
+ calls.push(id);
132
+ return stubModel(id);
133
+ },
134
+ xai: (id) => {
135
+ calls.push(id);
136
+ return stubModel(id);
137
+ },
138
+ });
139
+ return { providers, calls };
140
+ }
141
+ it('resolves a known model and passes the provider-specific modelId', () => {
142
+ const { providers, calls } = makeTrackingProviders();
143
+ const model = resolveModel('claude-sonnet-4', providers);
144
+ expect(model).toBeDefined();
145
+ expect(calls).toEqual(['claude-sonnet-4-20250514']);
146
+ });
147
+ it('resolves gpt-4o through the openai factory', () => {
148
+ const { providers, calls } = makeTrackingProviders();
149
+ const model = resolveModel('gpt-4o', providers);
150
+ expect(model).toBeDefined();
151
+ expect(calls).toEqual(['gpt-4o']);
152
+ });
153
+ it('resolves gemini models through the google factory', () => {
154
+ const { providers, calls } = makeTrackingProviders();
155
+ const model = resolveModel('gemini-2.5-pro', providers);
156
+ expect(model).toBeDefined();
157
+ expect(calls).toEqual(['gemini-2.5-pro-preview-06-05']);
158
+ });
159
+ it('throws for an unknown model ID', () => {
160
+ const { providers } = makeTrackingProviders();
161
+ expect(() => resolveModel('unknown-model', providers)).toThrow("Unknown model 'unknown-model'");
162
+ });
163
+ it('throws when no provider factory is registered', () => {
164
+ const providers = createProviderRegistry({
165
+ openai: (id) => stubModel(id),
166
+ });
167
+ expect(() => resolveModel('claude-sonnet-4', providers)).toThrow("No provider registered for 'anthropic'");
168
+ });
169
+ it('passes the provider-specific modelId for haiku', () => {
170
+ const { providers, calls } = makeTrackingProviders();
171
+ resolveModel('claude-haiku-3.5', providers);
172
+ expect(calls).toEqual(['claude-haiku-4-5-20251001']);
173
+ });
174
+ });
175
+ // ---------------------------------------------------------------------------
176
+ // createProviderRegistry
177
+ // ---------------------------------------------------------------------------
178
+ describe('createProviderRegistry', () => {
179
+ it('creates a Map from a plain object', () => {
180
+ const registry = createProviderRegistry({
181
+ openai: (id) => stubModel(id),
182
+ });
183
+ expect(registry).toBeInstanceOf(Map);
184
+ expect(registry.has('openai')).toBe(true);
185
+ });
186
+ it('creates an empty registry from an empty object', () => {
187
+ const registry = createProviderRegistry({});
188
+ expect(registry.size).toBe(0);
189
+ });
190
+ it('preserves all entries', () => {
191
+ const registry = createProviderRegistry({
192
+ anthropic: (id) => stubModel(id),
193
+ openai: (id) => stubModel(id),
194
+ google: (id) => stubModel(id),
195
+ });
196
+ expect(registry.size).toBe(3);
197
+ });
198
+ });
199
+ //# sourceMappingURL=model-resolver.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"model-resolver.test.js","sourceRoot":"","sources":["../../src/providers/model-resolver.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import type { ErrorTracker, AnalyticsTracker } from './provider-interfaces.js';
2
+ /** No-op error tracker for when no error tracking provider is configured. */
3
+ export declare const noopErrorTracker: ErrorTracker;
4
+ /** No-op analytics tracker for when no analytics provider is configured. */
5
+ export declare const noopAnalytics: AnalyticsTracker;
6
+ //# sourceMappingURL=noop-providers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"noop-providers.d.ts","sourceRoot":"","sources":["../../src/providers/noop-providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE5E,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,EAAE,YAK9B,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,aAAa,EAAE,gBAK3B,CAAC"}
@@ -0,0 +1,15 @@
1
+ /** No-op error tracker for when no error tracking provider is configured. */
2
+ export const noopErrorTracker = {
3
+ captureException: () => { },
4
+ captureMessage: () => { },
5
+ setUser: () => { },
6
+ addBreadcrumb: () => { },
7
+ };
8
+ /** No-op analytics tracker for when no analytics provider is configured. */
9
+ export const noopAnalytics = {
10
+ identify: () => { },
11
+ track: () => { },
12
+ page: () => { },
13
+ group: () => { },
14
+ };
15
+ //# sourceMappingURL=noop-providers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"noop-providers.js","sourceRoot":"","sources":["../../src/providers/noop-providers.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gBAAgB,GAAiB;IAC5C,gBAAgB,EAAE,GAAG,EAAE,GAAE,CAAC;IAC1B,cAAc,EAAE,GAAG,EAAE,GAAE,CAAC;IACxB,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;IACjB,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;CACxB,CAAC;AAEF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,aAAa,GAAqB;IAC7C,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;IAClB,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=noop-providers.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"noop-providers.test.d.ts","sourceRoot":"","sources":["../../src/providers/noop-providers.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,63 @@
1
+ import { describe, it, expect } from 'vitest';
2
+ import { noopErrorTracker, noopAnalytics } from './noop-providers.js';
3
+ describe('noopErrorTracker', () => {
4
+ it('satisfies the ErrorTracker interface', () => {
5
+ const tracker = noopErrorTracker;
6
+ expect(tracker).toBeDefined();
7
+ });
8
+ it('captureException does not throw', () => {
9
+ expect(() => noopErrorTracker.captureException(new Error('test'))).not.toThrow();
10
+ });
11
+ it('captureException accepts optional context', () => {
12
+ expect(() => noopErrorTracker.captureException(new Error('test'), {
13
+ extra: 'data',
14
+ })).not.toThrow();
15
+ });
16
+ it('captureMessage does not throw', () => {
17
+ expect(() => noopErrorTracker.captureMessage('test message')).not.toThrow();
18
+ });
19
+ it('captureMessage accepts level parameter', () => {
20
+ expect(() => noopErrorTracker.captureMessage('test', 'warning')).not.toThrow();
21
+ });
22
+ it('setUser does not throw', () => {
23
+ expect(() => noopErrorTracker.setUser({ id: 'user-1', email: 'a@b.com', tenantId: 't-1' })).not.toThrow();
24
+ });
25
+ it('addBreadcrumb does not throw', () => {
26
+ expect(() => noopErrorTracker.addBreadcrumb({
27
+ category: 'nav',
28
+ message: 'clicked button',
29
+ data: { target: '#btn' },
30
+ })).not.toThrow();
31
+ });
32
+ });
33
+ describe('noopAnalytics', () => {
34
+ it('satisfies the AnalyticsTracker interface', () => {
35
+ const tracker = noopAnalytics;
36
+ expect(tracker).toBeDefined();
37
+ });
38
+ it('identify does not throw', () => {
39
+ expect(() => noopAnalytics.identify('user-1')).not.toThrow();
40
+ });
41
+ it('identify accepts optional traits', () => {
42
+ expect(() => noopAnalytics.identify('user-1', { plan: 'pro' })).not.toThrow();
43
+ });
44
+ it('track does not throw', () => {
45
+ expect(() => noopAnalytics.track('button_click')).not.toThrow();
46
+ });
47
+ it('track accepts optional properties', () => {
48
+ expect(() => noopAnalytics.track('button_click', { variant: 'primary' })).not.toThrow();
49
+ });
50
+ it('page does not throw', () => {
51
+ expect(() => noopAnalytics.page()).not.toThrow();
52
+ });
53
+ it('page accepts name and properties', () => {
54
+ expect(() => noopAnalytics.page('Dashboard', { section: 'main' })).not.toThrow();
55
+ });
56
+ it('group does not throw', () => {
57
+ expect(() => noopAnalytics.group('team-1')).not.toThrow();
58
+ });
59
+ it('group accepts optional traits', () => {
60
+ expect(() => noopAnalytics.group('team-1', { name: 'Engineering' })).not.toThrow();
61
+ });
62
+ });
63
+ //# sourceMappingURL=noop-providers.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"noop-providers.test.js","sourceRoot":"","sources":["../../src/providers/noop-providers.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGnE,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,OAAO,GAAiB,gBAAgB,CAAC;QAC/C,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,GAAG,EAAE,CACV,gBAAgB,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE;YACnD,KAAK,EAAE,MAAM;SACd,CAAC,CACH,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,GAAG,EAAE,CACV,gBAAgB,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAC9E,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,GAAG,EAAE,CACV,gBAAgB,CAAC,aAAa,CAAC;YAC7B,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,gBAAgB;YACzB,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;SACzB,CAAC,CACH,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,OAAO,GAAqB,aAAa,CAAC;QAChD,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACrF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,65 @@
1
+ /** Error tracking provider interface for capturing exceptions and breadcrumbs. */
2
+ export interface ErrorTracker {
3
+ captureException(error: Error, context?: Record<string, unknown>): void;
4
+ captureMessage(message: string, level?: 'info' | 'warning' | 'error'): void;
5
+ setUser(user: {
6
+ id: string;
7
+ email?: string;
8
+ tenantId?: string;
9
+ }): void;
10
+ addBreadcrumb(breadcrumb: {
11
+ category: string;
12
+ message: string;
13
+ data?: Record<string, unknown>;
14
+ }): void;
15
+ }
16
+ /** Analytics tracking provider interface for user identification and event tracking. */
17
+ export interface AnalyticsTracker {
18
+ identify(userId: string, traits?: Record<string, unknown>): void;
19
+ track(event: string, properties?: Record<string, unknown>): void;
20
+ page(name?: string, properties?: Record<string, unknown>): void;
21
+ group(groupId: string, traits?: Record<string, unknown>): void;
22
+ }
23
+ /** Billing provider interface for customer and subscription management. */
24
+ export interface BillingProvider {
25
+ createCustomer(email: string, metadata?: Record<string, unknown>): Promise<{
26
+ id: string;
27
+ }>;
28
+ createCheckoutSession(options: {
29
+ priceId: string;
30
+ customerId: string;
31
+ successUrl: string;
32
+ cancelUrl: string;
33
+ }): Promise<{
34
+ url: string;
35
+ }>;
36
+ createPortalSession(customerId: string, returnUrl: string): Promise<{
37
+ url: string;
38
+ }>;
39
+ getSubscription(subscriptionId: string): Promise<{
40
+ id: string;
41
+ status: string;
42
+ currentPeriodEnd: Date;
43
+ }>;
44
+ }
45
+ /** Email provider interface for sending transactional emails. */
46
+ export interface EmailProvider {
47
+ send(options: {
48
+ to: string | string[];
49
+ subject: string;
50
+ html?: string;
51
+ text?: string;
52
+ replyTo?: string;
53
+ }): Promise<{
54
+ id: string;
55
+ }>;
56
+ sendBatch(messages: Array<{
57
+ to: string;
58
+ subject: string;
59
+ html?: string;
60
+ text?: string;
61
+ }>): Promise<{
62
+ ids: string[];
63
+ }>;
64
+ }
65
+ //# sourceMappingURL=provider-interfaces.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"provider-interfaces.d.ts","sourceRoot":"","sources":["../../src/providers/provider-interfaces.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=provider-interfaces.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"provider-interfaces.js","sourceRoot":"","sources":["../../src/providers/provider-interfaces.ts"],"names":[],"mappings":""}
@@ -0,0 +1,3 @@
1
+ export { createRealtimeManager } from './realtime-manager.js';
2
+ export type { RealtimeManagerOptions, RealtimeManager } from './realtime-manager.js';
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { createRealtimeManager } from './realtime-manager.js';
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}
@@ -0,0 +1,20 @@
1
+ import type { EventBus, RealtimeBroadcaster, PresenceState } from '@sprinterai/core';
2
+ export interface RealtimeManagerOptions {
3
+ /** Broadcaster implementation (e.g., Supabase realtime). If omitted, broadcasts are no-ops. */
4
+ broadcaster?: RealtimeBroadcaster;
5
+ /** Event bus to subscribe to for auto-broadcasting. */
6
+ eventBus?: EventBus;
7
+ }
8
+ export interface RealtimeManager {
9
+ /** Broadcast a domain event to relevant real-time channels. */
10
+ broadcastEvent(tenantId: string, eventType: string, data: Record<string, unknown>): Promise<void>;
11
+ /** Connect to the event bus and auto-broadcast relevant events. Returns a disconnect function. */
12
+ connectToEventBus(): () => void;
13
+ /** Track a user's presence on an entity. */
14
+ trackEntityPresence(tenantId: string, entityId: string, user: PresenceState): Promise<void>;
15
+ /** Untrack a user's presence from an entity. */
16
+ untrackEntityPresence(tenantId: string, entityId: string, userId: string): Promise<void>;
17
+ }
18
+ /** Create a real-time manager that bridges domain events to real-time channels. */
19
+ export declare function createRealtimeManager(options?: RealtimeManagerOptions): RealtimeManager;
20
+ //# sourceMappingURL=realtime-manager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"realtime-manager.d.ts","sourceRoot":"","sources":["../../src/realtime/realtime-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EAER,mBAAmB,EACnB,aAAa,EAEd,MAAM,kBAAkB,CAAC;AAK1B,MAAM,WAAW,sBAAsB;IACrC,+FAA+F;IAC/F,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElG,kGAAkG;IAClG,iBAAiB,IAAI,MAAM,IAAI,CAAC;IAEhC,4CAA4C;IAC5C,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5F,gDAAgD;IAChD,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1F;AAwED,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CAkE3F"}
@@ -0,0 +1,110 @@
1
+ import { buildChannelName } from '@sprinterai/core';
2
+ /**
3
+ * Maps event type prefixes to their target channel type and resource extractor.
4
+ * Order matters: first match wins.
5
+ */
6
+ const EVENT_CHANNEL_MAP = [
7
+ {
8
+ prefix: 'entity.',
9
+ target: {
10
+ type: 'entity',
11
+ resourceId: (data) => data.entityId || undefined,
12
+ },
13
+ },
14
+ {
15
+ prefix: 'workflow.',
16
+ target: {
17
+ type: 'workflow',
18
+ resourceId: (data) => data.entityId || undefined,
19
+ },
20
+ },
21
+ {
22
+ prefix: 'extraction.',
23
+ target: {
24
+ type: 'workflow',
25
+ resourceId: (data) => data.entityId || undefined,
26
+ },
27
+ },
28
+ {
29
+ prefix: 'notification.',
30
+ target: {
31
+ type: 'notifications',
32
+ resourceId: (data) => data.userId || undefined,
33
+ },
34
+ },
35
+ {
36
+ prefix: 'document.',
37
+ target: {
38
+ type: 'entity',
39
+ resourceId: (data) => data.entityId || undefined,
40
+ },
41
+ },
42
+ ];
43
+ /**
44
+ * Resolve which channel an event should be broadcast to.
45
+ * Returns null if the event type has no configured channel mapping.
46
+ */
47
+ function resolveChannel(tenantId, eventType, data) {
48
+ for (const entry of EVENT_CHANNEL_MAP) {
49
+ if (eventType.startsWith(entry.prefix)) {
50
+ const resourceId = entry.target.resourceId(data);
51
+ return buildChannelName(tenantId, entry.target.type, resourceId);
52
+ }
53
+ }
54
+ return null;
55
+ }
56
+ // ─── Factory ───────────────────────────────────────────────
57
+ /** Create a real-time manager that bridges domain events to real-time channels. */
58
+ export function createRealtimeManager(options = {}) {
59
+ const { broadcaster, eventBus } = options;
60
+ return {
61
+ async broadcastEvent(tenantId, eventType, data) {
62
+ if (!broadcaster)
63
+ return;
64
+ const channel = resolveChannel(tenantId, eventType, data);
65
+ if (!channel)
66
+ return;
67
+ await broadcaster.broadcast({
68
+ channel,
69
+ event: eventType,
70
+ payload: data,
71
+ });
72
+ },
73
+ connectToEventBus() {
74
+ if (!eventBus) {
75
+ return () => {
76
+ /* no-op */
77
+ };
78
+ }
79
+ const unsubscribe = eventBus.onAny(async (event) => {
80
+ // Extract tenantId from event data — all domain events include tenantId
81
+ const data = event.data;
82
+ const tenantId = data.tenantId;
83
+ if (!tenantId)
84
+ return;
85
+ const channel = resolveChannel(tenantId, event.type, data);
86
+ if (!channel || !broadcaster)
87
+ return;
88
+ await broadcaster.broadcast({
89
+ channel,
90
+ event: event.type,
91
+ payload: data,
92
+ });
93
+ });
94
+ return unsubscribe;
95
+ },
96
+ async trackEntityPresence(tenantId, entityId, user) {
97
+ if (!broadcaster)
98
+ return;
99
+ const channel = buildChannelName(tenantId, 'presence', entityId);
100
+ await broadcaster.trackPresence(channel, user);
101
+ },
102
+ async untrackEntityPresence(tenantId, entityId, userId) {
103
+ if (!broadcaster)
104
+ return;
105
+ const channel = buildChannelName(tenantId, 'presence', entityId);
106
+ await broadcaster.untrackPresence(channel, userId);
107
+ },
108
+ };
109
+ }
110
+ //# sourceMappingURL=realtime-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"realtime-manager.js","sourceRoot":"","sources":["../../src/realtime/realtime-manager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=realtime-manager.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"realtime-manager.test.d.ts","sourceRoot":"","sources":["../../src/realtime/realtime-manager.test.ts"],"names":[],"mappings":""}