@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,55 @@
1
+ import { DynamicModule, type Type } from '@nestjs/common';
2
+ import { type BrainAdapter } from './brain/brain.service';
3
+ import { type ConversationEntryPoint } from './conversation/conversation-entry';
4
+ import { type StudioEventListener } from './events/studio-event';
5
+ import { type AgentNode } from './node/agent-node';
6
+ import { type CodeIntention } from './intention/code-intention';
7
+ import { type StudioBrainConfig } from './brain/brain-config';
8
+ import { type ConversationLimitsConfig } from './conversation/conversation-limits';
9
+ import type { FormDisposeAdapter } from './forms/form.types';
10
+ export interface VapiStudioModuleOptions {
11
+ nodes: Array<{
12
+ className: string;
13
+ useClass: Type<AgentNode<any>>;
14
+ }>;
15
+ /**
16
+ * Optional code intentions (`CodeIntention`) — cascade meta + before/match/run.
17
+ * Force-phase intentions run before listen resolve / Brain.
18
+ */
19
+ intentions?: Array<Type<CodeIntention<any>>>;
20
+ /**
21
+ * Conversation entry point that seeds typed variables at bootstrap.
22
+ * Defaults to an empty variables object when omitted.
23
+ */
24
+ entryPoint?: Type<ConversationEntryPoint<object>>;
25
+ /**
26
+ * Brain adapter (Mock, ChatGPT, Claude, Gemini, Grok, or app-owned).
27
+ * Defaults to MockBrainAdapter. Supervisor depends only on BRAIN_SERVICE.
28
+ */
29
+ brainAdapter?: Type<BrainAdapter>;
30
+ /**
31
+ * Nest `StudioEventListener`s (in-process only — e.g. Studio UI event buffer).
32
+ * Remote exporters belong in app code via `onStudioEvent`, not here.
33
+ */
34
+ eventListeners?: Array<Type<StudioEventListener>>;
35
+ /**
36
+ * Brain settings (model, scan threshold). Code layer — not .env.
37
+ * `model` must be on the cheap whitelist. Default gpt-4.1-nano / 0.4.
38
+ */
39
+ brain?: StudioBrainConfig;
40
+ /**
41
+ * Hard conversation caps (turns + wall-clock). Always on — defaults 40 turns /
42
+ * 20 minutes. Cannot be disabled; values are clamped to safe ceilings.
43
+ */
44
+ limits?: ConversationLimitsConfig;
45
+ /**
46
+ * How to dispose `forms.expose` to the active channel.
47
+ * Default: noop (ACK never arrives → Nodes fall back to voice).
48
+ * Studio registers a developer-tools chat dispose adapter.
49
+ */
50
+ formDisposeAdapter?: Type<FormDisposeAdapter>;
51
+ }
52
+ export declare class VapiStudioModule {
53
+ static forRoot(options: VapiStudioModuleOptions): DynamicModule;
54
+ }
55
+ //# sourceMappingURL=vapi-studio.module.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vapi-studio.module.d.ts","sourceRoot":"","sources":["../src/vapi-studio.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAyB,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,mCAAmC,CAAC;AAI3C,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAwB,KAAK,SAAS,EAA0B,MAAM,mBAAmB,CAAC;AACjG,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,oCAAoC,CAAC;AAc5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;KAAE,CAAC,CAAC;IACpE;;;OAGG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7C;;;OAGG;IACH,UAAU,CAAC,EAAE,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD;;;OAGG;IACH,YAAY,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAClC;;;OAGG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAClD;;;OAGG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;CAC/C;AAED,qBACa,gBAAgB;WACb,OAAO,CAAC,OAAO,EAAE,uBAAuB,GAAG,aAAa;CA6HvE"}
@@ -0,0 +1,166 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var VapiStudioModule_1;
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.VapiStudioModule = void 0;
11
+ const common_1 = require("@nestjs/common");
12
+ const typeorm_1 = require("@nestjs/typeorm");
13
+ const brain_service_1 = require("./brain/brain.service");
14
+ const conversation_bootstrap_service_1 = require("./conversation/conversation-bootstrap.service");
15
+ const conversation_resume_service_1 = require("./conversation/conversation-resume.service");
16
+ const conversation_entry_1 = require("./conversation/conversation-entry");
17
+ const supervised_conversation_registry_1 = require("./conversation/supervised-conversation.registry");
18
+ const call_turn_queue_1 = require("./conversation/call-turn-queue");
19
+ const event_service_1 = require("./events/event.service");
20
+ const studio_event_1 = require("./events/studio-event");
21
+ const brain_usage_tracker_1 = require("./brain/brain-usage.tracker");
22
+ const integration_client_1 = require("./integrations/integration-client");
23
+ const flow_loader_1 = require("./flow/flow-loader");
24
+ const agent_node_1 = require("./node/agent-node");
25
+ const code_intention_1 = require("./intention/code-intention");
26
+ const brain_config_1 = require("./brain/brain-config");
27
+ const conversation_limits_1 = require("./conversation/conversation-limits");
28
+ const conversation_entity_1 = require("./persistence/conversation.entity");
29
+ const conversation_repository_1 = require("./persistence/conversation.repository");
30
+ const provider_ingress_entity_1 = require("./persistence/provider-ingress.entity");
31
+ const provider_ingress_repository_1 = require("./persistence/provider-ingress.repository");
32
+ const project_entity_1 = require("./persistence/project.entity");
33
+ const project_repository_1 = require("./persistence/project.repository");
34
+ const supervisor_1 = require("./supervisor/supervisor");
35
+ const vapi_sse_compiler_1 = require("./adapters/vapi/vapi-sse.compiler");
36
+ const workflow_loader_1 = require("./workflow/workflow-loader");
37
+ const workflow_handoff_service_1 = require("./workflow/workflow-handoff.service");
38
+ const forms_service_1 = require("./forms/forms.service");
39
+ const form_tokens_1 = require("./forms/form.tokens");
40
+ const noop_form_dispose_adapter_1 = require("./forms/noop-form-dispose.adapter");
41
+ let VapiStudioModule = VapiStudioModule_1 = class VapiStudioModule {
42
+ static forRoot(options) {
43
+ const nodeProviders = options.nodes.map((n) => n.useClass);
44
+ const intentionDefs = options.intentions ?? [];
45
+ const intentionProviders = intentionDefs.map((c) => c);
46
+ const BrainAdapterClass = options.brainAdapter ?? brain_service_1.MockBrainAdapter;
47
+ const extraListeners = options.eventListeners ?? [];
48
+ const brainConfig = (0, brain_config_1.resolveStudioBrainConfig)(options.brain);
49
+ const conversationLimits = (0, conversation_limits_1.resolveConversationLimits)(options.limits);
50
+ const FormDisposeClass = options.formDisposeAdapter ?? noop_form_dispose_adapter_1.NoopFormDisposeAdapter;
51
+ const registryProvider = {
52
+ provide: agent_node_1.STUDIO_NODE_REGISTRY,
53
+ useFactory: (...instances) => {
54
+ const map = new Map();
55
+ options.nodes.forEach((def, index) => {
56
+ map.set(def.className, instances[index]);
57
+ });
58
+ return map;
59
+ },
60
+ inject: options.nodes.map((n) => n.useClass),
61
+ };
62
+ const intentionRegistryProvider = {
63
+ provide: code_intention_1.STUDIO_INTENTION_REGISTRY,
64
+ useFactory: (...instances) => {
65
+ const map = new Map();
66
+ for (const instance of instances) {
67
+ if (!instance?.name) {
68
+ throw new Error('CodeIntention subclass is missing readonly name');
69
+ }
70
+ if (map.has(instance.name)) {
71
+ throw new Error(`Duplicate CodeIntention name: ${instance.name}`);
72
+ }
73
+ map.set(instance.name, instance);
74
+ }
75
+ return map;
76
+ },
77
+ inject: intentionDefs,
78
+ };
79
+ return {
80
+ module: VapiStudioModule_1,
81
+ global: true,
82
+ imports: [
83
+ typeorm_1.TypeOrmModule.forFeature([
84
+ conversation_entity_1.ConversationEntity,
85
+ provider_ingress_entity_1.ProviderIngressEntity,
86
+ project_entity_1.ProjectEntity,
87
+ ]),
88
+ ],
89
+ providers: [
90
+ ...nodeProviders,
91
+ ...intentionProviders,
92
+ registryProvider,
93
+ intentionRegistryProvider,
94
+ {
95
+ provide: conversation_entry_1.CONVERSATION_ENTRY_POINT,
96
+ useClass: options.entryPoint ?? conversation_entry_1.DefaultConversationEntry,
97
+ },
98
+ flow_loader_1.FlowLoader,
99
+ BrainAdapterClass,
100
+ { provide: brain_service_1.BRAIN_SERVICE, useExisting: BrainAdapterClass },
101
+ { provide: brain_config_1.STUDIO_BRAIN_CONFIG, useValue: brainConfig },
102
+ { provide: conversation_limits_1.STUDIO_CONVERSATION_LIMITS, useValue: conversationLimits },
103
+ supervised_conversation_registry_1.SupervisedConversationRegistry,
104
+ conversation_repository_1.ConversationRepository,
105
+ provider_ingress_repository_1.ProviderIngressRepository,
106
+ project_repository_1.ProjectRepository,
107
+ ...extraListeners,
108
+ extraListeners.length > 0
109
+ ? {
110
+ provide: studio_event_1.STUDIO_EVENT_LISTENERS,
111
+ useFactory: (...listeners) => listeners,
112
+ inject: [...extraListeners],
113
+ }
114
+ : {
115
+ provide: studio_event_1.STUDIO_EVENT_LISTENERS,
116
+ useValue: [],
117
+ },
118
+ event_service_1.EventService,
119
+ integration_client_1.IntegrationClient,
120
+ brain_usage_tracker_1.BrainUsageTracker,
121
+ conversation_bootstrap_service_1.ConversationBootstrapService,
122
+ conversation_resume_service_1.ConversationResumeService,
123
+ supervisor_1.Supervisor,
124
+ vapi_sse_compiler_1.VapiSseCompiler,
125
+ call_turn_queue_1.CallTurnQueueRegistry,
126
+ workflow_loader_1.WorkflowLoader,
127
+ workflow_handoff_service_1.WorkflowHandoffService,
128
+ FormDisposeClass,
129
+ { provide: form_tokens_1.FORM_DISPOSE_ADAPTER, useExisting: FormDisposeClass },
130
+ forms_service_1.FormsService,
131
+ ],
132
+ exports: [
133
+ flow_loader_1.FlowLoader,
134
+ BrainAdapterClass,
135
+ brain_service_1.BRAIN_SERVICE,
136
+ brain_config_1.STUDIO_BRAIN_CONFIG,
137
+ conversation_limits_1.STUDIO_CONVERSATION_LIMITS,
138
+ supervised_conversation_registry_1.SupervisedConversationRegistry,
139
+ conversation_repository_1.ConversationRepository,
140
+ provider_ingress_repository_1.ProviderIngressRepository,
141
+ project_repository_1.ProjectRepository,
142
+ event_service_1.EventService,
143
+ integration_client_1.IntegrationClient,
144
+ brain_usage_tracker_1.BrainUsageTracker,
145
+ conversation_bootstrap_service_1.ConversationBootstrapService,
146
+ conversation_resume_service_1.ConversationResumeService,
147
+ supervisor_1.Supervisor,
148
+ vapi_sse_compiler_1.VapiSseCompiler,
149
+ call_turn_queue_1.CallTurnQueueRegistry,
150
+ agent_node_1.STUDIO_NODE_REGISTRY,
151
+ code_intention_1.STUDIO_INTENTION_REGISTRY,
152
+ conversation_entry_1.CONVERSATION_ENTRY_POINT,
153
+ studio_event_1.STUDIO_EVENT_LISTENERS,
154
+ workflow_loader_1.WorkflowLoader,
155
+ workflow_handoff_service_1.WorkflowHandoffService,
156
+ forms_service_1.FormsService,
157
+ form_tokens_1.FORM_DISPOSE_ADAPTER,
158
+ ],
159
+ };
160
+ }
161
+ };
162
+ exports.VapiStudioModule = VapiStudioModule;
163
+ exports.VapiStudioModule = VapiStudioModule = VapiStudioModule_1 = __decorate([
164
+ (0, common_1.Module)({})
165
+ ], VapiStudioModule);
166
+ //# sourceMappingURL=vapi-studio.module.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vapi-studio.module.js","sourceRoot":"","sources":["../src/vapi-studio.module.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ import { FlowLoader } from '../flow/flow-loader';
2
+ import { EventService } from '../events/event.service';
3
+ import type { SupervisedConversation } from '../conversation/supervised-conversation';
4
+ import type { OutputAction } from '../output/conversation-output';
5
+ import { WorkflowLoader } from './workflow-loader';
6
+ import { ConversationBootstrapService } from '../conversation/conversation-bootstrap.service';
7
+ /**
8
+ * Applies workflow module handoffs and same-flow `continueTo` jumps on a
9
+ * shared Conversation runtime. Does not end the Conversation.
10
+ */
11
+ export declare class WorkflowHandoffService {
12
+ private readonly workflows;
13
+ private readonly flows;
14
+ private readonly events;
15
+ private readonly bootstrap;
16
+ constructor(workflows: WorkflowLoader, flows: FlowLoader, events: EventService, bootstrap: ConversationBootstrapService);
17
+ configDir(): string;
18
+ /**
19
+ * Enrich handoff actions with Vapi assistantName; apply in-memory module
20
+ * switches and same-flow continueTo jumps. Returns the (possibly enriched) actions.
21
+ */
22
+ applyHandoffs(runtime: SupervisedConversation, actions: OutputAction[]): Promise<OutputAction[]>;
23
+ private applyContinueTo;
24
+ /** Load entry module flow for a new Conversation. */
25
+ activateEntryModule(runtime: SupervisedConversation): void;
26
+ /** Ensure the flow for the runtime's active module is loaded. */
27
+ ensureActiveFlow(runtime: SupervisedConversation): void;
28
+ }
29
+ //# sourceMappingURL=workflow-handoff.service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workflow-handoff.service.d.ts","sourceRoot":"","sources":["../../src/workflow/workflow-handoff.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AAE9F;;;GAGG;AACH,qBACa,sBAAsB;IAE/B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAHT,SAAS,EAAE,cAAc,EACzB,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,4BAA4B;IAGnD,SAAS,IAAI,MAAM;IAI1B;;;OAGG;IACU,aAAa,CACxB,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,YAAY,EAAE,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC;YAsEZ,eAAe;IAkC7B,qDAAqD;IAC9C,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAWjE,iEAAiE;IAC1D,gBAAgB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;CAoB/D"}
@@ -0,0 +1,165 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.WorkflowHandoffService = void 0;
13
+ const common_1 = require("@nestjs/common");
14
+ const path_1 = require("path");
15
+ const flow_loader_1 = require("../flow/flow-loader");
16
+ const event_service_1 = require("../events/event.service");
17
+ const workflow_loader_1 = require("./workflow-loader");
18
+ const conversation_bootstrap_service_1 = require("../conversation/conversation-bootstrap.service");
19
+ /**
20
+ * Applies workflow module handoffs and same-flow `continueTo` jumps on a
21
+ * shared Conversation runtime. Does not end the Conversation.
22
+ */
23
+ let WorkflowHandoffService = class WorkflowHandoffService {
24
+ workflows;
25
+ flows;
26
+ events;
27
+ bootstrap;
28
+ constructor(workflows, flows, events, bootstrap) {
29
+ this.workflows = workflows;
30
+ this.flows = flows;
31
+ this.events = events;
32
+ this.bootstrap = bootstrap;
33
+ }
34
+ configDir() {
35
+ return process.env.CONFIG_DIR ?? (0, path_1.join)(process.cwd(), 'config');
36
+ }
37
+ /**
38
+ * Enrich handoff actions with Vapi assistantName; apply in-memory module
39
+ * switches and same-flow continueTo jumps. Returns the (possibly enriched) actions.
40
+ */
41
+ async applyHandoffs(runtime, actions) {
42
+ const out = [];
43
+ for (const action of actions) {
44
+ if (action.kind === 'continueTo' && action.continueToNodeId) {
45
+ out.push(action);
46
+ await this.applyContinueTo(runtime, action);
47
+ continue;
48
+ }
49
+ if (action.kind !== 'handoff' || !action.handoffTo) {
50
+ out.push(action);
51
+ continue;
52
+ }
53
+ if (!this.workflows.hasWorkflow()) {
54
+ // Handoff requested but no Squad workflow loaded — treat as no-op warn.
55
+ this.events.log('warn', 'HANDOFF_WITHOUT_WORKFLOW', {
56
+ conversationId: runtime.conversationId,
57
+ handoffTo: action.handoffTo,
58
+ note: 'output.handoff requires a loaded workflow.yaml; use continueTo for single-assistant jumps.',
59
+ });
60
+ out.push(action);
61
+ continue;
62
+ }
63
+ const mod = this.workflows.getModule(action.handoffTo);
64
+ const enriched = {
65
+ ...action,
66
+ assistantName: mod.assistantName,
67
+ };
68
+ out.push(enriched);
69
+ const fromModule = typeof runtime.metadata.activeModuleId === 'string'
70
+ ? runtime.metadata.activeModuleId
71
+ : null;
72
+ runtime.metadata.activeModuleId = mod.id;
73
+ runtime.metadata.workflowId = this.workflows.getWorkflow().id;
74
+ runtime.metadata.lastHandoff = {
75
+ from: fromModule,
76
+ to: mod.id,
77
+ reason: action.handoffReason ?? null,
78
+ at: new Date().toISOString(),
79
+ };
80
+ if (mod.kind === 'studio' && mod.flowFile) {
81
+ const flowPath = (0, path_1.join)(this.configDir(), mod.flowFile);
82
+ const flow = this.flows.loadFromFile(flowPath);
83
+ const entry = mod.entryNode ?? flow.start;
84
+ runtime.enterNormalNode(entry);
85
+ runtime.listenExpectation = null;
86
+ runtime.metadata.moduleNeedsEntrySpeak = true;
87
+ }
88
+ await this.events.persist(runtime.conversationId, 'WORKFLOW_HANDOFF', {
89
+ from: fromModule,
90
+ to: mod.id,
91
+ assistantName: mod.assistantName,
92
+ reason: action.handoffReason ?? null,
93
+ payload: action.handoffPayload ?? null,
94
+ turnNumber: runtime.turn.turnNumber,
95
+ providerCallId: runtime.providerCallId,
96
+ });
97
+ await this.bootstrap.checkpoint(runtime);
98
+ }
99
+ return out;
100
+ }
101
+ async applyContinueTo(runtime, action) {
102
+ const nodeId = action.continueToNodeId.trim();
103
+ const flow = this.flows.getFlow();
104
+ if (!flow.nodes[nodeId]) {
105
+ throw new Error(`continueTo node "${nodeId}" is not in the loaded flow "${flow.id}"`);
106
+ }
107
+ const fromNode = runtime.currentNodeId;
108
+ runtime.enterNormalNode(nodeId);
109
+ runtime.listenExpectation = null;
110
+ runtime.metadata.moduleNeedsEntrySpeak = true;
111
+ runtime.metadata.lastContinueTo = {
112
+ from: fromNode,
113
+ to: nodeId,
114
+ reason: action.handoffReason ?? null,
115
+ at: new Date().toISOString(),
116
+ };
117
+ await this.events.persist(runtime.conversationId, 'FLOW_CONTINUE', {
118
+ from: fromNode,
119
+ to: nodeId,
120
+ reason: action.handoffReason ?? null,
121
+ turnNumber: runtime.turn.turnNumber,
122
+ providerCallId: runtime.providerCallId,
123
+ activeModuleId: runtime.metadata.activeModuleId ?? null,
124
+ });
125
+ await this.bootstrap.checkpoint(runtime);
126
+ }
127
+ /** Load entry module flow for a new Conversation. */
128
+ activateEntryModule(runtime) {
129
+ if (!this.workflows.hasWorkflow())
130
+ return;
131
+ const wf = this.workflows.getWorkflow();
132
+ const mod = this.workflows.getModule(wf.entryModuleId);
133
+ runtime.metadata.workflowId = wf.id;
134
+ runtime.metadata.activeModuleId = mod.id;
135
+ if (mod.kind === 'studio' && mod.flowFile) {
136
+ this.flows.loadFromFile((0, path_1.join)(this.configDir(), mod.flowFile));
137
+ }
138
+ }
139
+ /** Ensure the flow for the runtime's active module is loaded. */
140
+ ensureActiveFlow(runtime) {
141
+ if (!this.workflows.hasWorkflow())
142
+ return;
143
+ const moduleId = typeof runtime.metadata.activeModuleId === 'string'
144
+ ? runtime.metadata.activeModuleId
145
+ : this.workflows.getWorkflow().entryModuleId;
146
+ const mod = this.workflows.getModule(moduleId);
147
+ if (mod.kind === 'studio' && mod.flowFile) {
148
+ const flow = this.flows.loadFromFile((0, path_1.join)(this.configDir(), mod.flowFile));
149
+ // Keep current node if it exists in this flow; else jump to entry.
150
+ if (!runtime.currentNodeId ||
151
+ !flow.nodes[runtime.currentNodeId]) {
152
+ runtime.enterNormalNode(mod.entryNode ?? flow.start);
153
+ }
154
+ }
155
+ }
156
+ };
157
+ exports.WorkflowHandoffService = WorkflowHandoffService;
158
+ exports.WorkflowHandoffService = WorkflowHandoffService = __decorate([
159
+ (0, common_1.Injectable)(),
160
+ __metadata("design:paramtypes", [workflow_loader_1.WorkflowLoader,
161
+ flow_loader_1.FlowLoader,
162
+ event_service_1.EventService,
163
+ conversation_bootstrap_service_1.ConversationBootstrapService])
164
+ ], WorkflowHandoffService);
165
+ //# sourceMappingURL=workflow-handoff.service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workflow-handoff.service.js","sourceRoot":"","sources":["../../src/workflow/workflow-handoff.service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,48 @@
1
+ export type WorkflowModuleKind = 'studio' | 'vapi';
2
+ export interface WorkflowModuleDefinition {
3
+ id: string;
4
+ /** Vapi Squad member assistantName (handoff destination). */
5
+ assistantName: string;
6
+ kind: WorkflowModuleKind;
7
+ /** Relative to CONFIG_DIR when kind === 'studio'. */
8
+ flowFile?: string;
9
+ entryNode?: string;
10
+ /** Module ids this member may hand off to (documents Squad handoff rules). */
11
+ handoffTo?: string[];
12
+ description?: string;
13
+ }
14
+ export interface WorkflowDefinition {
15
+ version: number;
16
+ id: string;
17
+ /** Module that owns the opening greeting. */
18
+ entryModuleId: string;
19
+ modules: Record<string, WorkflowModuleDefinition>;
20
+ }
21
+ interface RawWorkflowFile {
22
+ version?: number;
23
+ workflow: {
24
+ id: string;
25
+ entryModule: string;
26
+ };
27
+ modules: Record<string, {
28
+ assistantName: string;
29
+ kind?: WorkflowModuleKind;
30
+ flowFile?: string;
31
+ entryNode?: string;
32
+ handoffTo?: string[];
33
+ description?: string;
34
+ }>;
35
+ }
36
+ export declare class WorkflowLoader {
37
+ private workflow;
38
+ loadFromFile(path: string): WorkflowDefinition;
39
+ loadFromObject(raw: RawWorkflowFile): WorkflowDefinition;
40
+ getWorkflow(): WorkflowDefinition;
41
+ hasWorkflow(): boolean;
42
+ getModule(moduleId: string): WorkflowModuleDefinition;
43
+ resolveAssistantName(moduleId: string): string;
44
+ /** Map Vapi assistantName → module id (first match). */
45
+ findModuleIdByAssistantName(assistantName: string): string | null;
46
+ }
47
+ export {};
48
+ //# sourceMappingURL=workflow-loader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workflow-loader.d.ts","sourceRoot":"","sources":["../../src/workflow/workflow-loader.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEnD,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,kBAAkB,CAAC;IACzB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;CACnD;AAED,UAAU,eAAe;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE;QACR,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,OAAO,EAAE,MAAM,CACb,MAAM,EACN;QACE,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,kBAAkB,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CACF,CAAC;CACH;AAED,qBACa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAmC;IAE5C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB;IAK9C,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,kBAAkB;IAoCxD,WAAW,IAAI,kBAAkB;IAOjC,WAAW,IAAI,OAAO;IAItB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,wBAAwB;IASrD,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIrD,wDAAwD;IACjD,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAQzE"}
@@ -0,0 +1,87 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ Object.defineProperty(exports, "__esModule", { value: true });
9
+ exports.WorkflowLoader = void 0;
10
+ const fs_1 = require("fs");
11
+ const common_1 = require("@nestjs/common");
12
+ const yaml_1 = require("yaml");
13
+ let WorkflowLoader = class WorkflowLoader {
14
+ workflow = null;
15
+ loadFromFile(path) {
16
+ const raw = (0, yaml_1.parse)((0, fs_1.readFileSync)(path, 'utf8'));
17
+ return this.loadFromObject(raw);
18
+ }
19
+ loadFromObject(raw) {
20
+ if (!raw?.workflow?.id || !raw?.workflow?.entryModule || !raw?.modules) {
21
+ throw new Error('Invalid workflow schema object');
22
+ }
23
+ const modules = {};
24
+ for (const [id, def] of Object.entries(raw.modules)) {
25
+ const rawKind = (def.kind ?? (def.flowFile ? 'studio' : 'vapi'));
26
+ const kind = rawKind === 'studio' ? 'studio' : 'vapi';
27
+ if (kind === 'studio' && !def.flowFile) {
28
+ throw new Error(`Workflow module "${id}" kind=studio requires flowFile`);
29
+ }
30
+ modules[id] = {
31
+ id,
32
+ assistantName: def.assistantName,
33
+ kind,
34
+ flowFile: def.flowFile,
35
+ entryNode: def.entryNode,
36
+ handoffTo: def.handoffTo,
37
+ description: def.description,
38
+ };
39
+ }
40
+ if (!modules[raw.workflow.entryModule]) {
41
+ throw new Error(`Workflow entryModule "${raw.workflow.entryModule}" missing`);
42
+ }
43
+ this.workflow = {
44
+ version: raw.version ?? 1,
45
+ id: raw.workflow.id,
46
+ entryModuleId: raw.workflow.entryModule,
47
+ modules,
48
+ };
49
+ return this.workflow;
50
+ }
51
+ getWorkflow() {
52
+ if (!this.workflow) {
53
+ throw new Error('Workflow not loaded');
54
+ }
55
+ return this.workflow;
56
+ }
57
+ hasWorkflow() {
58
+ return this.workflow !== null;
59
+ }
60
+ getModule(moduleId) {
61
+ const wf = this.getWorkflow();
62
+ const mod = wf.modules[moduleId];
63
+ if (!mod) {
64
+ throw new Error(`Unknown workflow module "${moduleId}"`);
65
+ }
66
+ return mod;
67
+ }
68
+ resolveAssistantName(moduleId) {
69
+ return this.getModule(moduleId).assistantName;
70
+ }
71
+ /** Map Vapi assistantName → module id (first match). */
72
+ findModuleIdByAssistantName(assistantName) {
73
+ if (!this.workflow)
74
+ return null;
75
+ const needle = assistantName.trim();
76
+ for (const mod of Object.values(this.workflow.modules)) {
77
+ if (mod.assistantName === needle)
78
+ return mod.id;
79
+ }
80
+ return null;
81
+ }
82
+ };
83
+ exports.WorkflowLoader = WorkflowLoader;
84
+ exports.WorkflowLoader = WorkflowLoader = __decorate([
85
+ (0, common_1.Injectable)()
86
+ ], WorkflowLoader);
87
+ //# sourceMappingURL=workflow-loader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workflow-loader.js","sourceRoot":"","sources":["../../src/workflow/workflow-loader.ts"],"names":[],"mappings":"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"}