@guidify-ai/vapi-studio 0.1.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 (407) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +129 -0
  3. package/agent/AGENTS.md +42 -0
  4. package/agent/CLAUDE.md +15 -0
  5. package/agent/claude/rules/ui-and-api-identity.md +9 -0
  6. package/agent/claude/rules/vapi-studio-best-practices.md +36 -0
  7. package/agent/cursor/ui-and-api-identity.mdc +16 -0
  8. package/agent/cursor/vapi-studio-best-practices.mdc +43 -0
  9. package/dist/adapters/vapi/vapi-sse.compiler.d.ts +61 -0
  10. package/dist/adapters/vapi/vapi-sse.compiler.d.ts.map +1 -0
  11. package/dist/adapters/vapi/vapi-sse.compiler.js +396 -0
  12. package/dist/adapters/vapi/vapi-sse.compiler.js.map +1 -0
  13. package/dist/analytics/analytics-tags.d.ts +60 -0
  14. package/dist/analytics/analytics-tags.d.ts.map +1 -0
  15. package/dist/analytics/analytics-tags.js +27 -0
  16. package/dist/analytics/analytics-tags.js.map +1 -0
  17. package/dist/brain/adapters/chatgpt-brain.adapter.d.ts +27 -0
  18. package/dist/brain/adapters/chatgpt-brain.adapter.d.ts.map +1 -0
  19. package/dist/brain/adapters/chatgpt-brain.adapter.js +94 -0
  20. package/dist/brain/adapters/chatgpt-brain.adapter.js.map +1 -0
  21. package/dist/brain/adapters/claude-brain.adapter.d.ts +24 -0
  22. package/dist/brain/adapters/claude-brain.adapter.d.ts.map +1 -0
  23. package/dist/brain/adapters/claude-brain.adapter.js +96 -0
  24. package/dist/brain/adapters/claude-brain.adapter.js.map +1 -0
  25. package/dist/brain/adapters/gemini-brain.adapter.d.ts +24 -0
  26. package/dist/brain/adapters/gemini-brain.adapter.d.ts.map +1 -0
  27. package/dist/brain/adapters/gemini-brain.adapter.js +106 -0
  28. package/dist/brain/adapters/gemini-brain.adapter.js.map +1 -0
  29. package/dist/brain/adapters/grok-brain.adapter.d.ts +24 -0
  30. package/dist/brain/adapters/grok-brain.adapter.d.ts.map +1 -0
  31. package/dist/brain/adapters/grok-brain.adapter.js +90 -0
  32. package/dist/brain/adapters/grok-brain.adapter.js.map +1 -0
  33. package/dist/brain/adapters/json-llm-brain.base.d.ts +63 -0
  34. package/dist/brain/adapters/json-llm-brain.base.d.ts.map +1 -0
  35. package/dist/brain/adapters/json-llm-brain.base.js +511 -0
  36. package/dist/brain/adapters/json-llm-brain.base.js.map +1 -0
  37. package/dist/brain/adapters/mock-brain.adapter.d.ts +32 -0
  38. package/dist/brain/adapters/mock-brain.adapter.d.ts.map +1 -0
  39. package/dist/brain/adapters/mock-brain.adapter.js +201 -0
  40. package/dist/brain/adapters/mock-brain.adapter.js.map +1 -0
  41. package/dist/brain/adapters/mock-provider-brains.adapter.d.ts +22 -0
  42. package/dist/brain/adapters/mock-provider-brains.adapter.d.ts.map +1 -0
  43. package/dist/brain/adapters/mock-provider-brains.adapter.js +48 -0
  44. package/dist/brain/adapters/mock-provider-brains.adapter.js.map +1 -0
  45. package/dist/brain/brain-clarify.d.ts +75 -0
  46. package/dist/brain/brain-clarify.d.ts.map +1 -0
  47. package/dist/brain/brain-clarify.js +146 -0
  48. package/dist/brain/brain-clarify.js.map +1 -0
  49. package/dist/brain/brain-config.d.ts +20 -0
  50. package/dist/brain/brain-config.d.ts.map +1 -0
  51. package/dist/brain/brain-config.js +20 -0
  52. package/dist/brain/brain-config.js.map +1 -0
  53. package/dist/brain/brain-judge.d.ts +68 -0
  54. package/dist/brain/brain-judge.d.ts.map +1 -0
  55. package/dist/brain/brain-judge.js +111 -0
  56. package/dist/brain/brain-judge.js.map +1 -0
  57. package/dist/brain/brain-ranking.d.ts +41 -0
  58. package/dist/brain/brain-ranking.d.ts.map +1 -0
  59. package/dist/brain/brain-ranking.js +103 -0
  60. package/dist/brain/brain-ranking.js.map +1 -0
  61. package/dist/brain/brain-usage.tracker.d.ts +48 -0
  62. package/dist/brain/brain-usage.tracker.d.ts.map +1 -0
  63. package/dist/brain/brain-usage.tracker.js +106 -0
  64. package/dist/brain/brain-usage.tracker.js.map +1 -0
  65. package/dist/brain/brain.port.d.ts +63 -0
  66. package/dist/brain/brain.port.d.ts.map +1 -0
  67. package/dist/brain/brain.port.js +7 -0
  68. package/dist/brain/brain.port.js.map +1 -0
  69. package/dist/brain/brain.service.d.ts +14 -0
  70. package/dist/brain/brain.service.d.ts.map +1 -0
  71. package/dist/brain/brain.service.js +27 -0
  72. package/dist/brain/brain.service.js.map +1 -0
  73. package/dist/brain/claude-cheap-models.d.ts +18 -0
  74. package/dist/brain/claude-cheap-models.d.ts.map +1 -0
  75. package/dist/brain/claude-cheap-models.js +53 -0
  76. package/dist/brain/claude-cheap-models.js.map +1 -0
  77. package/dist/brain/gemini-cheap-models.d.ts +18 -0
  78. package/dist/brain/gemini-cheap-models.d.ts.map +1 -0
  79. package/dist/brain/gemini-cheap-models.js +53 -0
  80. package/dist/brain/gemini-cheap-models.js.map +1 -0
  81. package/dist/brain/grok-cheap-models.d.ts +18 -0
  82. package/dist/brain/grok-cheap-models.d.ts.map +1 -0
  83. package/dist/brain/grok-cheap-models.js +53 -0
  84. package/dist/brain/grok-cheap-models.js.map +1 -0
  85. package/dist/brain/llm-model-pricing.d.ts +29 -0
  86. package/dist/brain/llm-model-pricing.d.ts.map +1 -0
  87. package/dist/brain/llm-model-pricing.js +38 -0
  88. package/dist/brain/llm-model-pricing.js.map +1 -0
  89. package/dist/brain/openai-cheap-models.d.ts +34 -0
  90. package/dist/brain/openai-cheap-models.d.ts.map +1 -0
  91. package/dist/brain/openai-cheap-models.js +72 -0
  92. package/dist/brain/openai-cheap-models.js.map +1 -0
  93. package/dist/brain/prompt-injection-guard.d.ts +34 -0
  94. package/dist/brain/prompt-injection-guard.d.ts.map +1 -0
  95. package/dist/brain/prompt-injection-guard.js +109 -0
  96. package/dist/brain/prompt-injection-guard.js.map +1 -0
  97. package/dist/channel/channel-tools.d.ts +72 -0
  98. package/dist/channel/channel-tools.d.ts.map +1 -0
  99. package/dist/channel/channel-tools.js +131 -0
  100. package/dist/channel/channel-tools.js.map +1 -0
  101. package/dist/conversation/call-turn-queue.d.ts +64 -0
  102. package/dist/conversation/call-turn-queue.d.ts.map +1 -0
  103. package/dist/conversation/call-turn-queue.js +156 -0
  104. package/dist/conversation/call-turn-queue.js.map +1 -0
  105. package/dist/conversation/conversation-bootstrap.service.d.ts +60 -0
  106. package/dist/conversation/conversation-bootstrap.service.d.ts.map +1 -0
  107. package/dist/conversation/conversation-bootstrap.service.js +383 -0
  108. package/dist/conversation/conversation-bootstrap.service.js.map +1 -0
  109. package/dist/conversation/conversation-entry.d.ts +38 -0
  110. package/dist/conversation/conversation-entry.d.ts.map +1 -0
  111. package/dist/conversation/conversation-entry.js +17 -0
  112. package/dist/conversation/conversation-entry.js.map +1 -0
  113. package/dist/conversation/conversation-history.d.ts +31 -0
  114. package/dist/conversation/conversation-history.d.ts.map +1 -0
  115. package/dist/conversation/conversation-history.js +53 -0
  116. package/dist/conversation/conversation-history.js.map +1 -0
  117. package/dist/conversation/conversation-limits.d.ts +49 -0
  118. package/dist/conversation/conversation-limits.d.ts.map +1 -0
  119. package/dist/conversation/conversation-limits.js +44 -0
  120. package/dist/conversation/conversation-limits.js.map +1 -0
  121. package/dist/conversation/conversation-resume.service.d.ts +39 -0
  122. package/dist/conversation/conversation-resume.service.d.ts.map +1 -0
  123. package/dist/conversation/conversation-resume.service.js +234 -0
  124. package/dist/conversation/conversation-resume.service.js.map +1 -0
  125. package/dist/conversation/conversation-schema.d.ts +23 -0
  126. package/dist/conversation/conversation-schema.d.ts.map +1 -0
  127. package/dist/conversation/conversation-schema.js +3 -0
  128. package/dist/conversation/conversation-schema.js.map +1 -0
  129. package/dist/conversation/listen-expectation.d.ts +145 -0
  130. package/dist/conversation/listen-expectation.d.ts.map +1 -0
  131. package/dist/conversation/listen-expectation.js +219 -0
  132. package/dist/conversation/listen-expectation.js.map +1 -0
  133. package/dist/conversation/listen-timeout.d.ts +42 -0
  134. package/dist/conversation/listen-timeout.d.ts.map +1 -0
  135. package/dist/conversation/listen-timeout.js +57 -0
  136. package/dist/conversation/listen-timeout.js.map +1 -0
  137. package/dist/conversation/supervised-conversation.d.ts +64 -0
  138. package/dist/conversation/supervised-conversation.d.ts.map +1 -0
  139. package/dist/conversation/supervised-conversation.js +198 -0
  140. package/dist/conversation/supervised-conversation.js.map +1 -0
  141. package/dist/conversation/supervised-conversation.registry.d.ts +14 -0
  142. package/dist/conversation/supervised-conversation.registry.d.ts.map +1 -0
  143. package/dist/conversation/supervised-conversation.registry.js +47 -0
  144. package/dist/conversation/supervised-conversation.registry.js.map +1 -0
  145. package/dist/conversation/types.d.ts +52 -0
  146. package/dist/conversation/types.d.ts.map +1 -0
  147. package/dist/conversation/types.js +3 -0
  148. package/dist/conversation/types.js.map +1 -0
  149. package/dist/events/conversation-console.d.ts +17 -0
  150. package/dist/events/conversation-console.d.ts.map +1 -0
  151. package/dist/events/conversation-console.js +863 -0
  152. package/dist/events/conversation-console.js.map +1 -0
  153. package/dist/events/daily-log.driver.d.ts +35 -0
  154. package/dist/events/daily-log.driver.d.ts.map +1 -0
  155. package/dist/events/daily-log.driver.js +206 -0
  156. package/dist/events/daily-log.driver.js.map +1 -0
  157. package/dist/events/event.service.d.ts +24 -0
  158. package/dist/events/event.service.d.ts.map +1 -0
  159. package/dist/events/event.service.js +141 -0
  160. package/dist/events/event.service.js.map +1 -0
  161. package/dist/events/route-forensics.d.ts +38 -0
  162. package/dist/events/route-forensics.d.ts.map +1 -0
  163. package/dist/events/route-forensics.js +85 -0
  164. package/dist/events/route-forensics.js.map +1 -0
  165. package/dist/events/studio-event-bus.d.ts +17 -0
  166. package/dist/events/studio-event-bus.d.ts.map +1 -0
  167. package/dist/events/studio-event-bus.js +37 -0
  168. package/dist/events/studio-event-bus.js.map +1 -0
  169. package/dist/events/studio-event.d.ts +44 -0
  170. package/dist/events/studio-event.d.ts.map +1 -0
  171. package/dist/events/studio-event.js +27 -0
  172. package/dist/events/studio-event.js.map +1 -0
  173. package/dist/flow/condition.d.ts +35 -0
  174. package/dist/flow/condition.d.ts.map +1 -0
  175. package/dist/flow/condition.js +246 -0
  176. package/dist/flow/condition.js.map +1 -0
  177. package/dist/flow/flow-loader.d.ts +71 -0
  178. package/dist/flow/flow-loader.d.ts.map +1 -0
  179. package/dist/flow/flow-loader.js +182 -0
  180. package/dist/flow/flow-loader.js.map +1 -0
  181. package/dist/forms/form-html.d.ts +30 -0
  182. package/dist/forms/form-html.d.ts.map +1 -0
  183. package/dist/forms/form-html.js +130 -0
  184. package/dist/forms/form-html.js.map +1 -0
  185. package/dist/forms/form.tokens.d.ts +3 -0
  186. package/dist/forms/form.tokens.d.ts.map +1 -0
  187. package/dist/forms/form.tokens.js +6 -0
  188. package/dist/forms/form.tokens.js.map +1 -0
  189. package/dist/forms/form.types.d.ts +81 -0
  190. package/dist/forms/form.types.d.ts.map +1 -0
  191. package/dist/forms/form.types.js +36 -0
  192. package/dist/forms/form.types.js.map +1 -0
  193. package/dist/forms/forms.service.d.ts +52 -0
  194. package/dist/forms/forms.service.d.ts.map +1 -0
  195. package/dist/forms/forms.service.js +434 -0
  196. package/dist/forms/forms.service.js.map +1 -0
  197. package/dist/forms/noop-form-dispose.adapter.d.ts +12 -0
  198. package/dist/forms/noop-form-dispose.adapter.d.ts.map +1 -0
  199. package/dist/forms/noop-form-dispose.adapter.js +27 -0
  200. package/dist/forms/noop-form-dispose.adapter.js.map +1 -0
  201. package/dist/forms/twilio-sms-form-dispose.adapter.d.ts +33 -0
  202. package/dist/forms/twilio-sms-form-dispose.adapter.d.ts.map +1 -0
  203. package/dist/forms/twilio-sms-form-dispose.adapter.js +125 -0
  204. package/dist/forms/twilio-sms-form-dispose.adapter.js.map +1 -0
  205. package/dist/forms/twilio-sms.env.d.ts +62 -0
  206. package/dist/forms/twilio-sms.env.d.ts.map +1 -0
  207. package/dist/forms/twilio-sms.env.js +147 -0
  208. package/dist/forms/twilio-sms.env.js.map +1 -0
  209. package/dist/forms/twilio-sms.sender.d.ts +27 -0
  210. package/dist/forms/twilio-sms.sender.d.ts.map +1 -0
  211. package/dist/forms/twilio-sms.sender.js +75 -0
  212. package/dist/forms/twilio-sms.sender.js.map +1 -0
  213. package/dist/identity/email-parse.d.ts +20 -0
  214. package/dist/identity/email-parse.d.ts.map +1 -0
  215. package/dist/identity/email-parse.js +102 -0
  216. package/dist/identity/email-parse.js.map +1 -0
  217. package/dist/identity/index.d.ts +17 -0
  218. package/dist/identity/index.d.ts.map +1 -0
  219. package/dist/identity/index.js +23 -0
  220. package/dist/identity/index.js.map +1 -0
  221. package/dist/index.d.ts +108 -0
  222. package/dist/index.d.ts.map +1 -0
  223. package/dist/index.js +300 -0
  224. package/dist/index.js.map +1 -0
  225. package/dist/integrations/integration-client.d.ts +41 -0
  226. package/dist/integrations/integration-client.d.ts.map +1 -0
  227. package/dist/integrations/integration-client.js +152 -0
  228. package/dist/integrations/integration-client.js.map +1 -0
  229. package/dist/integrations/jwt-hmac.d.ts +33 -0
  230. package/dist/integrations/jwt-hmac.d.ts.map +1 -0
  231. package/dist/integrations/jwt-hmac.js +108 -0
  232. package/dist/integrations/jwt-hmac.js.map +1 -0
  233. package/dist/intention/code-intention.d.ts +94 -0
  234. package/dist/intention/code-intention.d.ts.map +1 -0
  235. package/dist/intention/code-intention.js +89 -0
  236. package/dist/intention/code-intention.js.map +1 -0
  237. package/dist/intention/intention-constants.d.ts +37 -0
  238. package/dist/intention/intention-constants.d.ts.map +1 -0
  239. package/dist/intention/intention-constants.js +37 -0
  240. package/dist/intention/intention-constants.js.map +1 -0
  241. package/dist/intentions/standard-intentions.d.ts +26 -0
  242. package/dist/intentions/standard-intentions.d.ts.map +1 -0
  243. package/dist/intentions/standard-intentions.js +28 -0
  244. package/dist/intentions/standard-intentions.js.map +1 -0
  245. package/dist/node/agent-node.d.ts +156 -0
  246. package/dist/node/agent-node.d.ts.map +1 -0
  247. package/dist/node/agent-node.js +179 -0
  248. package/dist/node/agent-node.js.map +1 -0
  249. package/dist/node/catch-directive.d.ts +33 -0
  250. package/dist/node/catch-directive.d.ts.map +1 -0
  251. package/dist/node/catch-directive.js +41 -0
  252. package/dist/node/catch-directive.js.map +1 -0
  253. package/dist/output/conversation-output.d.ts +113 -0
  254. package/dist/output/conversation-output.d.ts.map +1 -0
  255. package/dist/output/conversation-output.js +100 -0
  256. package/dist/output/conversation-output.js.map +1 -0
  257. package/dist/persistence/conversation.entity.d.ts +27 -0
  258. package/dist/persistence/conversation.entity.d.ts.map +1 -0
  259. package/dist/persistence/conversation.entity.js +115 -0
  260. package/dist/persistence/conversation.entity.js.map +1 -0
  261. package/dist/persistence/conversation.repository.d.ts +82 -0
  262. package/dist/persistence/conversation.repository.d.ts.map +1 -0
  263. package/dist/persistence/conversation.repository.js +277 -0
  264. package/dist/persistence/conversation.repository.js.map +1 -0
  265. package/dist/persistence/project.entity.d.ts +12 -0
  266. package/dist/persistence/project.entity.d.ts.map +1 -0
  267. package/dist/persistence/project.entity.js +46 -0
  268. package/dist/persistence/project.entity.js.map +1 -0
  269. package/dist/persistence/project.repository.d.ts +17 -0
  270. package/dist/persistence/project.repository.d.ts.map +1 -0
  271. package/dist/persistence/project.repository.js +69 -0
  272. package/dist/persistence/project.repository.js.map +1 -0
  273. package/dist/persistence/provider-ingress.entity.d.ts +18 -0
  274. package/dist/persistence/provider-ingress.entity.d.ts.map +1 -0
  275. package/dist/persistence/provider-ingress.entity.js +91 -0
  276. package/dist/persistence/provider-ingress.entity.js.map +1 -0
  277. package/dist/persistence/provider-ingress.repository.d.ts +21 -0
  278. package/dist/persistence/provider-ingress.repository.d.ts.map +1 -0
  279. package/dist/persistence/provider-ingress.repository.js +76 -0
  280. package/dist/persistence/provider-ingress.repository.js.map +1 -0
  281. package/dist/studio-ui/assets/index-BGd2OhLv.js +84 -0
  282. package/dist/studio-ui/assets/index-BGd2OhLv.js.map +1 -0
  283. package/dist/studio-ui/assets/index-DnJos5x2.css +1 -0
  284. package/dist/studio-ui/index.html +13 -0
  285. package/dist/studio-ui-mount/index.d.ts +6 -0
  286. package/dist/studio-ui-mount/index.d.ts.map +1 -0
  287. package/dist/studio-ui-mount/index.js +13 -0
  288. package/dist/studio-ui-mount/index.js.map +1 -0
  289. package/dist/studio-ui-mount/resolve-studio-ui-root.d.ts +6 -0
  290. package/dist/studio-ui-mount/resolve-studio-ui-root.d.ts.map +1 -0
  291. package/dist/studio-ui-mount/resolve-studio-ui-root.js +25 -0
  292. package/dist/studio-ui-mount/resolve-studio-ui-root.js.map +1 -0
  293. package/dist/studio-ui-mount/studio-spa.controller.d.ts +18 -0
  294. package/dist/studio-ui-mount/studio-spa.controller.d.ts.map +1 -0
  295. package/dist/studio-ui-mount/studio-spa.controller.js +57 -0
  296. package/dist/studio-ui-mount/studio-spa.controller.js.map +1 -0
  297. package/dist/studio-ui-mount/studio-ui.module.d.ts +15 -0
  298. package/dist/studio-ui-mount/studio-ui.module.d.ts.map +1 -0
  299. package/dist/studio-ui-mount/studio-ui.module.js +47 -0
  300. package/dist/studio-ui-mount/studio-ui.module.js.map +1 -0
  301. package/dist/studio-ui-mount/studio-ui.tokens.d.ts +2 -0
  302. package/dist/studio-ui-mount/studio-ui.tokens.d.ts.map +1 -0
  303. package/dist/studio-ui-mount/studio-ui.tokens.js +5 -0
  304. package/dist/studio-ui-mount/studio-ui.tokens.js.map +1 -0
  305. package/dist/supervisor/supervisor-cascade.d.ts +55 -0
  306. package/dist/supervisor/supervisor-cascade.d.ts.map +1 -0
  307. package/dist/supervisor/supervisor-cascade.js +261 -0
  308. package/dist/supervisor/supervisor-cascade.js.map +1 -0
  309. package/dist/supervisor/supervisor-engine.d.ts +9 -0
  310. package/dist/supervisor/supervisor-engine.d.ts.map +1 -0
  311. package/dist/supervisor/supervisor-engine.js +64 -0
  312. package/dist/supervisor/supervisor-engine.js.map +1 -0
  313. package/dist/supervisor/supervisor-limits.d.ts +8 -0
  314. package/dist/supervisor/supervisor-limits.d.ts.map +1 -0
  315. package/dist/supervisor/supervisor-limits.js +36 -0
  316. package/dist/supervisor/supervisor-limits.js.map +1 -0
  317. package/dist/supervisor/supervisor-node-exec.d.ts +39 -0
  318. package/dist/supervisor/supervisor-node-exec.d.ts.map +1 -0
  319. package/dist/supervisor/supervisor-node-exec.js +201 -0
  320. package/dist/supervisor/supervisor-node-exec.js.map +1 -0
  321. package/dist/supervisor/supervisor-orchestration.d.ts +24 -0
  322. package/dist/supervisor/supervisor-orchestration.d.ts.map +1 -0
  323. package/dist/supervisor/supervisor-orchestration.js +395 -0
  324. package/dist/supervisor/supervisor-orchestration.js.map +1 -0
  325. package/dist/supervisor/supervisor-portal.d.ts +75 -0
  326. package/dist/supervisor/supervisor-portal.d.ts.map +1 -0
  327. package/dist/supervisor/supervisor-portal.js +320 -0
  328. package/dist/supervisor/supervisor-portal.js.map +1 -0
  329. package/dist/supervisor/supervisor-route.d.ts +53 -0
  330. package/dist/supervisor/supervisor-route.d.ts.map +1 -0
  331. package/dist/supervisor/supervisor-route.js +308 -0
  332. package/dist/supervisor/supervisor-route.js.map +1 -0
  333. package/dist/supervisor/supervisor-special-turns.d.ts +34 -0
  334. package/dist/supervisor/supervisor-special-turns.d.ts.map +1 -0
  335. package/dist/supervisor/supervisor-special-turns.js +308 -0
  336. package/dist/supervisor/supervisor-special-turns.js.map +1 -0
  337. package/dist/supervisor/supervisor.d.ts +44 -0
  338. package/dist/supervisor/supervisor.d.ts.map +1 -0
  339. package/dist/supervisor/supervisor.js +79 -0
  340. package/dist/supervisor/supervisor.js.map +1 -0
  341. package/dist/supervisor/supervisor.types.d.ts +71 -0
  342. package/dist/supervisor/supervisor.types.d.ts.map +1 -0
  343. package/dist/supervisor/supervisor.types.js +8 -0
  344. package/dist/supervisor/supervisor.types.js.map +1 -0
  345. package/dist/tasks/studio-task-queue.d.ts +93 -0
  346. package/dist/tasks/studio-task-queue.d.ts.map +1 -0
  347. package/dist/tasks/studio-task-queue.js +226 -0
  348. package/dist/tasks/studio-task-queue.js.map +1 -0
  349. package/dist/util/studio-env.d.ts +7 -0
  350. package/dist/util/studio-env.d.ts.map +1 -0
  351. package/dist/util/studio-env.js +32 -0
  352. package/dist/util/studio-env.js.map +1 -0
  353. package/dist/vapi-studio.module.d.ts +55 -0
  354. package/dist/vapi-studio.module.d.ts.map +1 -0
  355. package/dist/vapi-studio.module.js +166 -0
  356. package/dist/vapi-studio.module.js.map +1 -0
  357. package/dist/workflow/workflow-handoff.service.d.ts +29 -0
  358. package/dist/workflow/workflow-handoff.service.d.ts.map +1 -0
  359. package/dist/workflow/workflow-handoff.service.js +165 -0
  360. package/dist/workflow/workflow-handoff.service.js.map +1 -0
  361. package/dist/workflow/workflow-loader.d.ts +48 -0
  362. package/dist/workflow/workflow-loader.d.ts.map +1 -0
  363. package/dist/workflow/workflow-loader.js +87 -0
  364. package/dist/workflow/workflow-loader.js.map +1 -0
  365. package/docs/README.md +69 -0
  366. package/docs/assets/deterministic-assistant-flow.svg +128 -0
  367. package/docs/assets/vapi-studio-stack.svg +26 -0
  368. package/docs/best-practices/README.md +37 -0
  369. package/docs/best-practices/brain-and-prompt-injection.md +70 -0
  370. package/docs/best-practices/conversation-design.md +152 -0
  371. package/docs/best-practices/debugging-and-observability.md +49 -0
  372. package/docs/best-practices/documentation-layers.md +31 -0
  373. package/docs/best-practices/identity-and-pii.md +66 -0
  374. package/docs/best-practices/nodes-and-listens.md +116 -0
  375. package/docs/best-practices/ui-and-api-identity.md +51 -0
  376. package/docs/building-apps/creating-an-app.md +59 -0
  377. package/docs/building-apps/example-apps.md +23 -0
  378. package/docs/building-apps/overview.md +27 -0
  379. package/docs/getting-started/installation.md +52 -0
  380. package/docs/getting-started/introduction.md +23 -0
  381. package/docs/getting-started/quick-start.md +23 -0
  382. package/docs/guide/concepts.md +103 -0
  383. package/docs/guide/forms.md +102 -0
  384. package/docs/guide/handbook.md +21 -0
  385. package/docs/guide/introduction.md +56 -0
  386. package/docs/guide/module-setup.md +68 -0
  387. package/docs/guide/vapi-adapter.md +70 -0
  388. package/docs/guide/workflow-squad.md +59 -0
  389. package/docs/guides/agents.md +85 -0
  390. package/docs/guides/docker-compose.events.stub.yaml +27 -0
  391. package/docs/guides/documentation.md +13 -0
  392. package/docs/guides/extending-events.md +155 -0
  393. package/docs/guides/node-conventions.md +59 -0
  394. package/docs/guides/speckit.md +56 -0
  395. package/docs/reference/data-model.md +79 -0
  396. package/docs/reference/environment-variables.md +60 -0
  397. package/docs/reference/events-and-logging.md +137 -0
  398. package/docs/reference/flow-schema.md +79 -0
  399. package/docs/reference/runtime-api.md +708 -0
  400. package/docs/reference/security.md +41 -0
  401. package/docs/reference/standard-intentions.md +49 -0
  402. package/docs/reference/testing.md +15 -0
  403. package/docs/samples/events/nest-listener.example.ts +17 -0
  404. package/docs/samples/events/redis-bridge.example.ts +44 -0
  405. package/package.json +81 -0
  406. package/scripts/fix-access-modifiers.mjs +85 -0
  407. package/scripts/install-agent-refs.cjs +196 -0
@@ -0,0 +1,17 @@
1
+ /**
2
+ * In-process Studio event bus — Node EventEmitter.
3
+ *
4
+ * `EventService.emit` fires {@link STUDIO_EVENT_BUS_CHANNEL} with a {@link StudioEvent}.
5
+ * Apps may {@link onStudioEvent} and forward elsewhere if they operate their own sinks.
6
+ */
7
+ import { EventEmitter } from 'events';
8
+ import type { StudioEvent } from './studio-event';
9
+ /** Channel name passed to `studioEventBus.on(STUDIO_EVENT_BUS_CHANNEL, handler)`. */
10
+ export declare const STUDIO_EVENT_BUS_CHANNEL = "studio.event";
11
+ /** Shared process-local bus. Do not replace. */
12
+ export declare function studioEventBus(): EventEmitter;
13
+ export type StudioEventBusHandler = (event: StudioEvent) => void | Promise<void>;
14
+ /** Subscribe without Nest DI. Returns an unsubscribe function. */
15
+ export declare function onStudioEvent(handler: StudioEventBusHandler): () => void;
16
+ export declare function emitStudioEventBus(event: StudioEvent): void;
17
+ //# sourceMappingURL=studio-event-bus.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"studio-event-bus.d.ts","sourceRoot":"","sources":["../../src/events/studio-event-bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,qFAAqF;AACrF,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AAKvD,gDAAgD;AAChD,wBAAgB,cAAc,IAAI,YAAY,CAE7C;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjF,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAUxE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAE3D"}
@@ -0,0 +1,37 @@
1
+ "use strict";
2
+ /**
3
+ * In-process Studio event bus — Node EventEmitter.
4
+ *
5
+ * `EventService.emit` fires {@link STUDIO_EVENT_BUS_CHANNEL} with a {@link StudioEvent}.
6
+ * Apps may {@link onStudioEvent} and forward elsewhere if they operate their own sinks.
7
+ */
8
+ Object.defineProperty(exports, "__esModule", { value: true });
9
+ exports.STUDIO_EVENT_BUS_CHANNEL = void 0;
10
+ exports.studioEventBus = studioEventBus;
11
+ exports.onStudioEvent = onStudioEvent;
12
+ exports.emitStudioEventBus = emitStudioEventBus;
13
+ const events_1 = require("events");
14
+ /** Channel name passed to `studioEventBus.on(STUDIO_EVENT_BUS_CHANNEL, handler)`. */
15
+ exports.STUDIO_EVENT_BUS_CHANNEL = 'studio.event';
16
+ const bus = new events_1.EventEmitter();
17
+ bus.setMaxListeners(50);
18
+ /** Shared process-local bus. Do not replace. */
19
+ function studioEventBus() {
20
+ return bus;
21
+ }
22
+ /** Subscribe without Nest DI. Returns an unsubscribe function. */
23
+ function onStudioEvent(handler) {
24
+ const wrapped = (event) => {
25
+ void Promise.resolve(handler(event)).catch(() => {
26
+ /* subscriber errors must not break emit */
27
+ });
28
+ };
29
+ bus.on(exports.STUDIO_EVENT_BUS_CHANNEL, wrapped);
30
+ return () => {
31
+ bus.off(exports.STUDIO_EVENT_BUS_CHANNEL, wrapped);
32
+ };
33
+ }
34
+ function emitStudioEventBus(event) {
35
+ bus.emit(exports.STUDIO_EVENT_BUS_CHANNEL, event);
36
+ }
37
+ //# sourceMappingURL=studio-event-bus.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"studio-event-bus.js","sourceRoot":"","sources":["../../src/events/studio-event-bus.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAYH,wCAEC;AAKD,sCAUC;AAED,gDAEC;AA/BD,mCAAsC;AAGtC,qFAAqF;AACxE,QAAA,wBAAwB,GAAG,cAAc,CAAC;AAEvD,MAAM,GAAG,GAAiB,IAAI,qBAAY,EAAE,CAAC;AAC7C,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;AAExB,gDAAgD;AAChD,SAAgB,cAAc;IAC5B,OAAO,GAAG,CAAC;AACb,CAAC;AAID,kEAAkE;AAClE,SAAgB,aAAa,CAAC,OAA8B;IAC1D,MAAM,OAAO,GAAG,CAAC,KAAkB,EAAQ,EAAE;QAC3C,KAAK,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YAC9C,2CAA2C;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,GAAG,CAAC,EAAE,CAAC,gCAAwB,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,GAAG,EAAE;QACV,GAAG,CAAC,GAAG,CAAC,gCAAwB,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAAC,KAAkB;IACnD,GAAG,CAAC,IAAI,CAAC,gCAAwB,EAAE,KAAK,CAAC,CAAC;AAC5C,CAAC"}
@@ -0,0 +1,44 @@
1
+ /**
2
+ * Framework events — produce here; subscribers decide what to do.
3
+ *
4
+ * Console + in-process Node EventEmitter (`onStudioEvent`) + optional Nest
5
+ * `eventListeners` (e.g. in-memory Studio UI buffer). Durable sinks are
6
+ * application-owned — not part of this package.
7
+ */
8
+ import type { StudioLogLevel } from './conversation-console';
9
+ export declare const STUDIO_EVENT_LISTENERS: unique symbol;
10
+ export declare const STUDIO_EVENTS: {
11
+ readonly INTEGRATION_REQUEST: "INTEGRATION_REQUEST";
12
+ readonly INTEGRATION_RESPONSE: "INTEGRATION_RESPONSE";
13
+ readonly INTEGRATION_ERROR: "INTEGRATION_ERROR";
14
+ /** Outbound SMS / push / email — emit for app-owned sinks / logs. */
15
+ readonly OUTBOUND_NOTIFICATION: "OUTBOUND_NOTIFICATION";
16
+ readonly OUTBOUND_NOTIFICATION_ERROR: "OUTBOUND_NOTIFICATION_ERROR";
17
+ /** Studio Task Queue lifecycle (see StudioTaskQueue). */
18
+ readonly TASK_ENQUEUED: "TASK_ENQUEUED";
19
+ readonly TASK_STARTED: "TASK_STARTED";
20
+ readonly TASK_COMPLETED: "TASK_COMPLETED";
21
+ readonly TASK_FAILED: "TASK_FAILED";
22
+ readonly TASK_DEDUPED: "TASK_DEDUPED";
23
+ readonly TASK_AWAITED: "TASK_AWAITED";
24
+ };
25
+ export type StudioEventType = (typeof STUDIO_EVENTS)[keyof typeof STUDIO_EVENTS] | string;
26
+ export interface StudioEvent {
27
+ id: string;
28
+ type: StudioEventType;
29
+ ts: string;
30
+ level: StudioLogLevel;
31
+ conversationId?: string;
32
+ runtimeInstanceId?: string;
33
+ providerCallId?: string;
34
+ payload: Record<string, unknown>;
35
+ }
36
+ export type StudioEventInput = Omit<StudioEvent, 'id' | 'ts' | 'level'> & {
37
+ id?: string;
38
+ ts?: string;
39
+ level?: StudioLogLevel;
40
+ };
41
+ export interface StudioEventListener {
42
+ handle(event: StudioEvent): void | Promise<void>;
43
+ }
44
+ //# sourceMappingURL=studio-event.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"studio-event.d.ts","sourceRoot":"","sources":["../../src/events/studio-event.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,eAAO,MAAM,sBAAsB,eAAmC,CAAC;AAEvE,eAAO,MAAM,aAAa;;;;IAIxB,qEAAqE;;;IAGrE,yDAAyD;;;;;;;CAOjD,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,GAAG,MAAM,CAAC;AAE1F,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,eAAe,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,cAAc,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC,GAAG;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD"}
@@ -0,0 +1,27 @@
1
+ "use strict";
2
+ /**
3
+ * Framework events — produce here; subscribers decide what to do.
4
+ *
5
+ * Console + in-process Node EventEmitter (`onStudioEvent`) + optional Nest
6
+ * `eventListeners` (e.g. in-memory Studio UI buffer). Durable sinks are
7
+ * application-owned — not part of this package.
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.STUDIO_EVENTS = exports.STUDIO_EVENT_LISTENERS = void 0;
11
+ exports.STUDIO_EVENT_LISTENERS = Symbol('STUDIO_EVENT_LISTENERS');
12
+ exports.STUDIO_EVENTS = {
13
+ INTEGRATION_REQUEST: 'INTEGRATION_REQUEST',
14
+ INTEGRATION_RESPONSE: 'INTEGRATION_RESPONSE',
15
+ INTEGRATION_ERROR: 'INTEGRATION_ERROR',
16
+ /** Outbound SMS / push / email — emit for app-owned sinks / logs. */
17
+ OUTBOUND_NOTIFICATION: 'OUTBOUND_NOTIFICATION',
18
+ OUTBOUND_NOTIFICATION_ERROR: 'OUTBOUND_NOTIFICATION_ERROR',
19
+ /** Studio Task Queue lifecycle (see StudioTaskQueue). */
20
+ TASK_ENQUEUED: 'TASK_ENQUEUED',
21
+ TASK_STARTED: 'TASK_STARTED',
22
+ TASK_COMPLETED: 'TASK_COMPLETED',
23
+ TASK_FAILED: 'TASK_FAILED',
24
+ TASK_DEDUPED: 'TASK_DEDUPED',
25
+ TASK_AWAITED: 'TASK_AWAITED',
26
+ };
27
+ //# sourceMappingURL=studio-event.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"studio-event.js","sourceRoot":"","sources":["../../src/events/studio-event.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAIU,QAAA,sBAAsB,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;AAE1D,QAAA,aAAa,GAAG;IAC3B,mBAAmB,EAAE,qBAAqB;IAC1C,oBAAoB,EAAE,sBAAsB;IAC5C,iBAAiB,EAAE,mBAAmB;IACtC,qEAAqE;IACrE,qBAAqB,EAAE,uBAAuB;IAC9C,2BAA2B,EAAE,6BAA6B;IAC1D,yDAAyD;IACzD,aAAa,EAAE,eAAe;IAC9B,YAAY,EAAE,cAAc;IAC5B,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;CACpB,CAAC"}
@@ -0,0 +1,35 @@
1
+ /**
2
+ * Safe, Brain-free condition evaluation for flow transitions.
3
+ * No `eval` — path lookups + a tiny boolean/compare grammar.
4
+ *
5
+ * Paths: `memory.foo`, `variables.bar` (also `var.` alias for variables).
6
+ * Ops: `==`, `!=`, `!path` (falsy), bare `path` (truthy).
7
+ * Join: `&&`, `||` (&& binds tighter). Parentheses supported.
8
+ */
9
+ export type ConditionContext = {
10
+ memory: Record<string, unknown>;
11
+ variables: Record<string, unknown>;
12
+ };
13
+ /** Compile a condition string into a predicate. Throws on syntax error. */
14
+ export declare function compileCondition(expression: string): (ctx: ConditionContext) => boolean;
15
+ /** Evaluate once (compiles each call — prefer compileCondition in hot paths). */
16
+ export declare function evaluateCondition(expression: string, ctx: ConditionContext): boolean;
17
+ export interface FlowConditionTransition {
18
+ id: string;
19
+ /** If set, only when current node is one of these (or absent = any except `to`). */
20
+ from?: string[];
21
+ /** Destination node id in the same flow. */
22
+ to: string;
23
+ /** Condition expression over memory / variables. */
24
+ when: string;
25
+ /**
26
+ * true → skip listen_resolve + Brain; route straight to `to`.
27
+ * false → inject a high-priority synthetic intention for cascade with Brain.
28
+ */
29
+ force?: boolean;
30
+ /** Walk / log priority when force=false (default 1_000_000). */
31
+ priority?: number;
32
+ /** Forensic reason string (also FLOW_CONTINUE-style). */
33
+ reason?: string;
34
+ }
35
+ //# sourceMappingURL=condition.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"condition.d.ts","sourceRoot":"","sources":["../../src/flow/condition.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAmOF,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,GACjB,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAMpC;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAET;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
@@ -0,0 +1,246 @@
1
+ "use strict";
2
+ /**
3
+ * Safe, Brain-free condition evaluation for flow transitions.
4
+ * No `eval` — path lookups + a tiny boolean/compare grammar.
5
+ *
6
+ * Paths: `memory.foo`, `variables.bar` (also `var.` alias for variables).
7
+ * Ops: `==`, `!=`, `!path` (falsy), bare `path` (truthy).
8
+ * Join: `&&`, `||` (&& binds tighter). Parentheses supported.
9
+ */
10
+ Object.defineProperty(exports, "__esModule", { value: true });
11
+ exports.compileCondition = compileCondition;
12
+ exports.evaluateCondition = evaluateCondition;
13
+ function isTruthy(value) {
14
+ if (value === undefined || value === null)
15
+ return false;
16
+ if (typeof value === 'boolean')
17
+ return value;
18
+ if (typeof value === 'number')
19
+ return value !== 0 && !Number.isNaN(value);
20
+ if (typeof value === 'string')
21
+ return value.trim().length > 0;
22
+ return true;
23
+ }
24
+ function readPath(ctx, path) {
25
+ const parts = path.split('.').filter(Boolean);
26
+ if (parts.length < 2)
27
+ return undefined;
28
+ const root = parts[0];
29
+ const bag = root === 'memory'
30
+ ? ctx.memory
31
+ : root === 'variables' || root === 'var'
32
+ ? ctx.variables
33
+ : null;
34
+ if (!bag)
35
+ return undefined;
36
+ let cur = bag;
37
+ for (const key of parts.slice(1)) {
38
+ if (cur == null || typeof cur !== 'object')
39
+ return undefined;
40
+ cur = cur[key];
41
+ }
42
+ return cur;
43
+ }
44
+ function parseLiteral(raw) {
45
+ const t = raw.trim();
46
+ if (t === 'true')
47
+ return true;
48
+ if (t === 'false')
49
+ return false;
50
+ if (t === 'null' || t === 'undefined')
51
+ return null;
52
+ if (/^-?\d+(\.\d+)?$/.test(t))
53
+ return Number(t);
54
+ if ((t.startsWith('"') && t.endsWith('"')) ||
55
+ (t.startsWith("'") && t.endsWith("'"))) {
56
+ return t.slice(1, -1);
57
+ }
58
+ // Bare word → treat as string (channel names, etc.)
59
+ return t;
60
+ }
61
+ function tokenize(input) {
62
+ const src = input.trim();
63
+ const out = [];
64
+ let i = 0;
65
+ while (i < src.length) {
66
+ const ch = src[i];
67
+ if (/\s/.test(ch)) {
68
+ i += 1;
69
+ continue;
70
+ }
71
+ if (src.startsWith('&&', i)) {
72
+ out.push({ kind: 'op', value: '&&' });
73
+ i += 2;
74
+ continue;
75
+ }
76
+ if (src.startsWith('||', i)) {
77
+ out.push({ kind: 'op', value: '||' });
78
+ i += 2;
79
+ continue;
80
+ }
81
+ if (src.startsWith('==', i)) {
82
+ out.push({ kind: 'op', value: '==' });
83
+ i += 2;
84
+ continue;
85
+ }
86
+ if (src.startsWith('!=', i)) {
87
+ out.push({ kind: 'op', value: '!=' });
88
+ i += 2;
89
+ continue;
90
+ }
91
+ if (ch === '!' || ch === '(' || ch === ')') {
92
+ out.push({ kind: 'op', value: ch });
93
+ i += 1;
94
+ continue;
95
+ }
96
+ if (ch === '"' || ch === "'") {
97
+ const quote = ch;
98
+ let j = i + 1;
99
+ let buf = '';
100
+ while (j < src.length && src[j] !== quote) {
101
+ buf += src[j];
102
+ j += 1;
103
+ }
104
+ out.push({ kind: 'lit', value: buf });
105
+ i = j + 1;
106
+ continue;
107
+ }
108
+ let j = i;
109
+ while (j < src.length && /[A-Za-z0-9_.-]/.test(src[j]))
110
+ j += 1;
111
+ const word = src.slice(i, j);
112
+ if (!word) {
113
+ throw new Error(`Unexpected character in condition: ${ch}`);
114
+ }
115
+ if (word === 'true' ||
116
+ word === 'false' ||
117
+ word === 'null' ||
118
+ word === 'undefined' ||
119
+ /^-?\d+(\.\d+)?$/.test(word)) {
120
+ out.push({ kind: 'lit', value: parseLiteral(word) });
121
+ }
122
+ else if (word.startsWith('memory.') || word.startsWith('variables.') || word.startsWith('var.')) {
123
+ out.push({ kind: 'path', value: word });
124
+ }
125
+ else {
126
+ out.push({ kind: 'lit', value: word });
127
+ }
128
+ i = j;
129
+ }
130
+ return out;
131
+ }
132
+ class Parser {
133
+ toks;
134
+ i = 0;
135
+ constructor(toks) {
136
+ this.toks = toks;
137
+ }
138
+ parse() {
139
+ const fn = this.parseOr();
140
+ if (this.i < this.toks.length) {
141
+ throw new Error('Trailing tokens in condition');
142
+ }
143
+ return fn;
144
+ }
145
+ peek() {
146
+ return this.toks[this.i];
147
+ }
148
+ take() {
149
+ const t = this.toks[this.i];
150
+ if (!t)
151
+ throw new Error('Unexpected end of condition');
152
+ this.i += 1;
153
+ return t;
154
+ }
155
+ parseOr() {
156
+ let left = this.parseAnd();
157
+ while (this.peek()?.kind === 'op' && this.peek()?.value === '||') {
158
+ this.take();
159
+ const right = this.parseAnd();
160
+ const L = left;
161
+ left = (ctx) => L(ctx) || right(ctx);
162
+ }
163
+ return left;
164
+ }
165
+ parseAnd() {
166
+ let left = this.parseUnary();
167
+ while (this.peek()?.kind === 'op' && this.peek()?.value === '&&') {
168
+ this.take();
169
+ const right = this.parseUnary();
170
+ const L = left;
171
+ left = (ctx) => L(ctx) && right(ctx);
172
+ }
173
+ return left;
174
+ }
175
+ parseUnary() {
176
+ if (this.peek()?.kind === 'op' && this.peek()?.value === '!') {
177
+ this.take();
178
+ const inner = this.parseUnary();
179
+ return (ctx) => !inner(ctx);
180
+ }
181
+ return this.parsePrimary();
182
+ }
183
+ parsePrimary() {
184
+ const t = this.peek();
185
+ if (!t)
186
+ throw new Error('Unexpected end of condition');
187
+ if (t.kind === 'op' && t.value === '(') {
188
+ this.take();
189
+ const inner = this.parseOr();
190
+ const close = this.take();
191
+ if (close.kind !== 'op' || close.value !== ')') {
192
+ throw new Error('Expected )');
193
+ }
194
+ return inner;
195
+ }
196
+ if (t.kind === 'path') {
197
+ this.take();
198
+ const path = t.value;
199
+ const next = this.peek();
200
+ if (next?.kind === 'op' && (next.value === '==' || next.value === '!=')) {
201
+ this.take();
202
+ const rhs = this.take();
203
+ const expected = rhs.kind === 'lit'
204
+ ? rhs.value
205
+ : rhs.kind === 'path'
206
+ ? undefined
207
+ : (() => {
208
+ throw new Error('Expected literal after comparison');
209
+ })();
210
+ if (rhs.kind === 'path') {
211
+ const other = rhs.value;
212
+ return (ctx) => {
213
+ const a = readPath(ctx, path);
214
+ const b = readPath(ctx, other);
215
+ return next.value === '==' ? a === b : a !== b;
216
+ };
217
+ }
218
+ // `null` / `undefined` literals use loose nullish compare so missing
219
+ // memory keys match `== undefined` / `== null`.
220
+ const nullish = expected === null || expected === undefined;
221
+ return (ctx) => {
222
+ const a = readPath(ctx, path);
223
+ if (nullish) {
224
+ return next.value === '==' ? a == null : a != null;
225
+ }
226
+ return next.value === '==' ? a === expected : a !== expected;
227
+ };
228
+ }
229
+ return (ctx) => isTruthy(readPath(ctx, path));
230
+ }
231
+ throw new Error(`Expected path or (, got ${JSON.stringify(t)}`);
232
+ }
233
+ }
234
+ /** Compile a condition string into a predicate. Throws on syntax error. */
235
+ function compileCondition(expression) {
236
+ const trimmed = expression.trim();
237
+ if (!trimmed) {
238
+ return () => false;
239
+ }
240
+ return new Parser(tokenize(trimmed)).parse();
241
+ }
242
+ /** Evaluate once (compiles each call — prefer compileCondition in hot paths). */
243
+ function evaluateCondition(expression, ctx) {
244
+ return compileCondition(expression)(ctx);
245
+ }
246
+ //# sourceMappingURL=condition.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"condition.js","sourceRoot":"","sources":["../../src/flow/condition.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAyOH,4CAQC;AAGD,8CAKC;AAlPD,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1E,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,QAAQ,CAAC,GAAqB,EAAE,IAAY;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACvC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,GAAG,GACP,IAAI,KAAK,QAAQ;QACf,CAAC,CAAC,GAAG,CAAC,MAAM;QACZ,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,KAAK;YACtC,CAAC,CAAC,GAAG,CAAC,SAAS;YACf,CAAC,CAAC,IAAI,CAAC;IACb,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,IAAI,GAAG,GAAY,GAAG,CAAC;IACvB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC7D,GAAG,GAAI,GAA+B,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAChD,IACE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EACtC,CAAC;QACD,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,oDAAoD;IACpD,OAAO,CAAC,CAAC;AACX,CAAC;AAOD,SAAS,QAAQ,CAAC,KAAa;IAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACzB,MAAM,GAAG,GAAU,EAAE,CAAC;IACtB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAClB,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YAC5B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YAC5B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YAC5B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YAC5B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAC3C,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YACpC,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,IAAI,GAAG,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;gBAC1C,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;gBACd,CAAC,IAAI,CAAC,CAAC;YACT,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACtC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACV,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAAE,CAAC,IAAI,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,sCAAsC,EAAE,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,IACE,IAAI,KAAK,MAAM;YACf,IAAI,KAAK,OAAO;YAChB,IAAI,KAAK,MAAM;YACf,IAAI,KAAK,WAAW;YACpB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAC5B,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvD,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAClG,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,CAAC,GAAG,CAAC,CAAC;IACR,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,MAAM;IAE0B;IAD5B,CAAC,GAAW,CAAC,CAAC;IACtB,YAAoC,IAAW;QAAX,SAAI,GAAJ,IAAI,CAAO;IAAG,CAAC;IAE5C,KAAK;QACV,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAEO,IAAI;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAEO,IAAI;QACV,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACvD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QACZ,OAAO,CAAC,CAAC;IACX,CAAC;IAEO,OAAO;QACb,IAAI,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,KAAK,IAAI,EAAE,CAAC;YACjE,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,IAAI,CAAC;YACf,IAAI,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,QAAQ;QACd,IAAI,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,KAAK,IAAI,EAAE,CAAC;YACjE,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,IAAI,CAAC;YACf,IAAI,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,UAAU;QAChB,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,KAAK,GAAG,EAAE,CAAC;YAC7D,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;IAC7B,CAAC;IAEO,YAAY;QAClB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACvD,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,GAAG,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,KAAK,KAAK,GAAG,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;YAChC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC;YACrB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACzB,IAAI,IAAI,EAAE,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,EAAE,CAAC;gBACxE,IAAI,CAAC,IAAI,EAAE,CAAC;gBACZ,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBACxB,MAAM,QAAQ,GACZ,GAAG,CAAC,IAAI,KAAK,KAAK;oBAChB,CAAC,CAAC,GAAG,CAAC,KAAK;oBACX,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM;wBACnB,CAAC,CAAC,SAAS;wBACX,CAAC,CAAC,CAAC,GAAG,EAAE;4BACJ,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;wBACvD,CAAC,CAAC,EAAE,CAAC;gBACb,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBACxB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;oBACxB,OAAO,CAAC,GAAG,EAAE,EAAE;wBACb,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;wBAC9B,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;wBAC/B,OAAO,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;oBACjD,CAAC,CAAC;gBACJ,CAAC;gBACD,qEAAqE;gBACrE,gDAAgD;gBAChD,MAAM,OAAO,GAAG,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,CAAC;gBAC5D,OAAO,CAAC,GAAG,EAAE,EAAE;oBACb,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;oBAC9B,IAAI,OAAO,EAAE,CAAC;wBACZ,OAAO,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;oBACrD,CAAC;oBACD,OAAO,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;gBAC/D,CAAC,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;CACF;AAED,2EAA2E;AAC3E,SAAgB,gBAAgB,CAC9B,UAAkB;IAElB,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;AAC/C,CAAC;AAED,iFAAiF;AACjF,SAAgB,iBAAiB,CAC/B,UAAkB,EAClB,GAAqB;IAErB,OAAO,gBAAgB,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC;AAC3C,CAAC"}
@@ -0,0 +1,71 @@
1
+ import { type ConditionContext, type FlowConditionTransition } from './condition';
2
+ export interface FlowNodeDefinition {
3
+ id: string;
4
+ class: string;
5
+ intentions: string[];
6
+ portal?: boolean;
7
+ priority?: number;
8
+ terminal?: boolean;
9
+ }
10
+ export interface CompiledConditionTransition extends FlowConditionTransition {
11
+ /** Compiled `when` predicate (throws at load if `when` is invalid). */
12
+ test: (ctx: ConditionContext) => boolean;
13
+ }
14
+ export interface FlowDefinition {
15
+ version: number;
16
+ id: string;
17
+ start: string;
18
+ nodes: Record<string, FlowNodeDefinition>;
19
+ /** Declarative memory/variable gates — evaluated before listen/Brain when force. */
20
+ transitions: CompiledConditionTransition[];
21
+ }
22
+ export interface RawFlowFile {
23
+ version: number;
24
+ flow: {
25
+ id: string;
26
+ start: string;
27
+ };
28
+ nodes: Record<string, {
29
+ class: string;
30
+ intentions?: string[];
31
+ portal?: boolean;
32
+ priority?: number;
33
+ terminal?: boolean;
34
+ }>;
35
+ transitions?: Array<{
36
+ id?: string;
37
+ from?: string | string[];
38
+ to: string;
39
+ when: string;
40
+ force?: boolean;
41
+ priority?: number;
42
+ reason?: string;
43
+ }>;
44
+ }
45
+ /** Synthetic intention → execute a node by id (condition transitions / goto). */
46
+ export declare const CONDITION_GOTO_PREFIX = "studio.goto.";
47
+ export declare function conditionGotoIntention(nodeId: string): string;
48
+ export declare function parseConditionGotoNodeId(intention: string): string | null;
49
+ export declare class FlowLoader {
50
+ private flow;
51
+ loadFromFile(path: string): FlowDefinition;
52
+ loadFromObject(raw: RawFlowFile): FlowDefinition;
53
+ getFlow(): FlowDefinition;
54
+ nodesForIntention(intention: string): FlowNodeDefinition[];
55
+ /** All intention names declared on portal nodes. */
56
+ portalIntentionNames(): string[];
57
+ /** All intention names on non-portal nodes. */
58
+ normalIntentionNames(): string[];
59
+ /**
60
+ * Condition transitions whose `when` is true for this runtime snapshot.
61
+ * Skips when current node is already `to`, or `from` does not include current.
62
+ */
63
+ matchingConditionTransitions(input: {
64
+ currentNodeId: string | null | undefined;
65
+ memory: Record<string, unknown>;
66
+ variables: Record<string, unknown>;
67
+ }, opts?: {
68
+ force?: boolean;
69
+ }): CompiledConditionTransition[];
70
+ }
71
+ //# sourceMappingURL=flow-loader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"flow-loader.d.ts","sourceRoot":"","sources":["../../src/flow/flow-loader.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC7B,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,2BAA4B,SAAQ,uBAAuB;IAC1E,uEAAuE;IACvE,IAAI,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC;CAC1C;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC1C,oFAAoF;IACpF,WAAW,EAAE,2BAA2B,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,KAAK,EAAE,MAAM,CACX,MAAM,EACN;QACE,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CACF,CAAC;IACF,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QACzB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,iBAAiB,CAAC;AAEpD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIzE;AAED,qBACa,UAAU;IACrB,OAAO,CAAC,IAAI,CAA+B;IAEpC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAK1C,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,cAAc;IA8EhD,OAAO,IAAI,cAAc;IAOzB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAkBjE,oDAAoD;IAC7C,oBAAoB,IAAI,MAAM,EAAE;IAYvC,+CAA+C;IACxC,oBAAoB,IAAI,MAAM,EAAE;IAYvC;;;OAGG;IACI,4BAA4B,CACjC,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;QACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,EACD,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACzB,2BAA2B,EAAE;CAoBjC"}