@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,24 @@
1
+ import { Logger } from '@nestjs/common';
2
+ import { EventService } from '../../events/event.service';
3
+ import { BrainUsageTracker } from '../brain-usage.tracker';
4
+ import { type StudioBrainConfig } from '../brain-config';
5
+ import { type CheapClaudeModelPricing } from '../claude-cheap-models';
6
+ import type { TokenUsage } from '../llm-model-pricing';
7
+ import { JsonLlmBrainAdapter, type JsonLlmCompleteInput } from './json-llm-brain.base';
8
+ /**
9
+ * Vapi Studio Claude Brain — Anthropic Messages API on a **cheap Haiku whitelist**.
10
+ *
11
+ * Env: `ANTHROPIC_API_KEY`. Same scan/clarify/judge contracts as ChatGPT (3s timeout).
12
+ */
13
+ export declare class ClaudeBrainAdapter extends JsonLlmBrainAdapter {
14
+ protected readonly adapterId: string;
15
+ protected readonly logger: Logger;
16
+ constructor(usage: BrainUsageTracker, events: EventService, brainConfig?: StudioBrainConfig);
17
+ protected requireApiKey(op: string): string;
18
+ protected resolveModel(override?: string | null): CheapClaudeModelPricing;
19
+ protected completeJson(input: JsonLlmCompleteInput): Promise<{
20
+ content: string;
21
+ usage: TokenUsage;
22
+ }>;
23
+ }
24
+ //# sourceMappingURL=claude-brain.adapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"claude-brain.adapter.d.ts","sourceRoot":"","sources":["../../../src/brain/adapters/claude-brain.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,MAAM,EAAY,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,mBAAmB,EAEnB,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAO/B;;;;GAIG;AACH,qBACa,kBAAmB,SAAQ,mBAAmB;IACzD,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAmB;IACvD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAoC;gBAGnE,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,YAAY,EAGpB,WAAW,CAAC,EAAE,iBAAiB;IAKjC,SAAS,CAAC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAW3C,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,uBAAuB;cAIzD,YAAY,CAC1B,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAC;CAkDnD"}
@@ -0,0 +1,96 @@
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
+ var __param = (this && this.__param) || function (paramIndex, decorator) {
12
+ return function (target, key) { decorator(target, key, paramIndex); }
13
+ };
14
+ Object.defineProperty(exports, "__esModule", { value: true });
15
+ exports.ClaudeBrainAdapter = void 0;
16
+ const common_1 = require("@nestjs/common");
17
+ const event_service_1 = require("../../events/event.service");
18
+ const brain_usage_tracker_1 = require("../brain-usage.tracker");
19
+ const brain_config_1 = require("../brain-config");
20
+ const claude_cheap_models_1 = require("../claude-cheap-models");
21
+ const json_llm_brain_base_1 = require("./json-llm-brain.base");
22
+ /**
23
+ * Vapi Studio Claude Brain — Anthropic Messages API on a **cheap Haiku whitelist**.
24
+ *
25
+ * Env: `ANTHROPIC_API_KEY`. Same scan/clarify/judge contracts as ChatGPT (3s timeout).
26
+ */
27
+ let ClaudeBrainAdapter = class ClaudeBrainAdapter extends json_llm_brain_base_1.JsonLlmBrainAdapter {
28
+ adapterId = 'studio-claude';
29
+ logger = new common_1.Logger('ClaudeBrainAdapter');
30
+ constructor(usage, events, brainConfig) {
31
+ super(usage, events, brainConfig);
32
+ }
33
+ requireApiKey(op) {
34
+ const apiKey = process.env.ANTHROPIC_API_KEY?.trim();
35
+ if (!apiKey || apiKey.startsWith('sk-mock') || apiKey === 'REPLACE_ME') {
36
+ throw new Error(`ClaudeBrainAdapter.${op} requires a real ANTHROPIC_API_KEY (not mock). ` +
37
+ `Keep the app on MockBrainAdapter in code until Claude is enabled.`);
38
+ }
39
+ return apiKey;
40
+ }
41
+ resolveModel(override) {
42
+ return (0, claude_cheap_models_1.resolveCheapClaudeModel)(override || this.brainConfig?.model);
43
+ }
44
+ async completeJson(input) {
45
+ const started = Date.now();
46
+ const res = await fetch('https://api.anthropic.com/v1/messages', {
47
+ method: 'POST',
48
+ headers: {
49
+ 'x-api-key': input.apiKey,
50
+ 'anthropic-version': '2023-06-01',
51
+ 'content-type': 'application/json',
52
+ },
53
+ signal: AbortSignal.timeout(json_llm_brain_base_1.JSON_LLM_BRAIN_TIMEOUT_MS),
54
+ body: JSON.stringify({
55
+ model: input.model.id,
56
+ max_tokens: 1024,
57
+ temperature: 0,
58
+ system: input.system,
59
+ messages: [{ role: 'user', content: input.user }],
60
+ }),
61
+ });
62
+ if (!res.ok) {
63
+ const body = await res.text();
64
+ this.logger.error(`Anthropic brain ${input.kind} failed: ${res.status} ${body}`);
65
+ throw new Error(`ClaudeBrainAdapter ${input.kind} error: ${res.status}`);
66
+ }
67
+ const json = (await res.json());
68
+ const textParts = (json.content ?? [])
69
+ .filter((p) => p.type === 'text' && typeof p.text === 'string')
70
+ .map((p) => p.text);
71
+ const content = textParts.join('\n').trim() || '{}';
72
+ const usage = {
73
+ prompt_tokens: json.usage?.input_tokens ?? 0,
74
+ completion_tokens: json.usage?.output_tokens ?? 0,
75
+ total_tokens: (json.usage?.input_tokens ?? 0) + (json.usage?.output_tokens ?? 0),
76
+ };
77
+ this.recordUsage({
78
+ providerCallId: input.providerCallId,
79
+ conversationId: input.conversationId,
80
+ kind: input.kind,
81
+ model: input.model,
82
+ usage,
83
+ started,
84
+ });
85
+ return { content, usage };
86
+ }
87
+ };
88
+ exports.ClaudeBrainAdapter = ClaudeBrainAdapter;
89
+ exports.ClaudeBrainAdapter = ClaudeBrainAdapter = __decorate([
90
+ (0, common_1.Injectable)(),
91
+ __param(2, (0, common_1.Optional)()),
92
+ __param(2, (0, common_1.Inject)(brain_config_1.STUDIO_BRAIN_CONFIG)),
93
+ __metadata("design:paramtypes", [brain_usage_tracker_1.BrainUsageTracker,
94
+ event_service_1.EventService, Object])
95
+ ], ClaudeBrainAdapter);
96
+ //# sourceMappingURL=claude-brain.adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"claude-brain.adapter.js","sourceRoot":"","sources":["../../../src/brain/adapters/claude-brain.adapter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ import { Logger } from '@nestjs/common';
2
+ import { EventService } from '../../events/event.service';
3
+ import { BrainUsageTracker } from '../brain-usage.tracker';
4
+ import { type StudioBrainConfig } from '../brain-config';
5
+ import { type CheapGeminiModelPricing } from '../gemini-cheap-models';
6
+ import type { TokenUsage } from '../llm-model-pricing';
7
+ import { JsonLlmBrainAdapter, type JsonLlmCompleteInput } from './json-llm-brain.base';
8
+ /**
9
+ * Vapi Studio Gemini Brain — Google Generative Language API on a **cheap Flash whitelist**.
10
+ *
11
+ * Env: `GOOGLE_API_KEY` (or `GEMINI_API_KEY`). Same scan/clarify/judge contracts (3s timeout).
12
+ */
13
+ export declare class GeminiBrainAdapter extends JsonLlmBrainAdapter {
14
+ protected readonly adapterId: string;
15
+ protected readonly logger: Logger;
16
+ constructor(usage: BrainUsageTracker, events: EventService, brainConfig?: StudioBrainConfig);
17
+ protected requireApiKey(op: string): string;
18
+ protected resolveModel(override?: string | null): CheapGeminiModelPricing;
19
+ protected completeJson(input: JsonLlmCompleteInput): Promise<{
20
+ content: string;
21
+ usage: TokenUsage;
22
+ }>;
23
+ }
24
+ //# sourceMappingURL=gemini-brain.adapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gemini-brain.adapter.d.ts","sourceRoot":"","sources":["../../../src/brain/adapters/gemini-brain.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,MAAM,EAAY,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,mBAAmB,EAEnB,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAa/B;;;;GAIG;AACH,qBACa,kBAAmB,SAAQ,mBAAmB;IACzD,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAmB;IACvD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAoC;gBAGnE,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,YAAY,EAGpB,WAAW,CAAC,EAAE,iBAAiB;IAKjC,SAAS,CAAC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAa3C,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,uBAAuB;cAIzD,YAAY,CAC1B,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAC;CA6DnD"}
@@ -0,0 +1,106 @@
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
+ var __param = (this && this.__param) || function (paramIndex, decorator) {
12
+ return function (target, key) { decorator(target, key, paramIndex); }
13
+ };
14
+ Object.defineProperty(exports, "__esModule", { value: true });
15
+ exports.GeminiBrainAdapter = void 0;
16
+ const common_1 = require("@nestjs/common");
17
+ const event_service_1 = require("../../events/event.service");
18
+ const brain_usage_tracker_1 = require("../brain-usage.tracker");
19
+ const brain_config_1 = require("../brain-config");
20
+ const gemini_cheap_models_1 = require("../gemini-cheap-models");
21
+ const json_llm_brain_base_1 = require("./json-llm-brain.base");
22
+ /**
23
+ * Vapi Studio Gemini Brain — Google Generative Language API on a **cheap Flash whitelist**.
24
+ *
25
+ * Env: `GOOGLE_API_KEY` (or `GEMINI_API_KEY`). Same scan/clarify/judge contracts (3s timeout).
26
+ */
27
+ let GeminiBrainAdapter = class GeminiBrainAdapter extends json_llm_brain_base_1.JsonLlmBrainAdapter {
28
+ adapterId = 'studio-gemini';
29
+ logger = new common_1.Logger('GeminiBrainAdapter');
30
+ constructor(usage, events, brainConfig) {
31
+ super(usage, events, brainConfig);
32
+ }
33
+ requireApiKey(op) {
34
+ const apiKey = process.env.GOOGLE_API_KEY?.trim() ||
35
+ process.env.GEMINI_API_KEY?.trim();
36
+ if (!apiKey || apiKey.startsWith('sk-mock') || apiKey === 'REPLACE_ME') {
37
+ throw new Error(`GeminiBrainAdapter.${op} requires a real GOOGLE_API_KEY (or GEMINI_API_KEY). ` +
38
+ `Keep the app on MockBrainAdapter in code until Gemini is enabled.`);
39
+ }
40
+ return apiKey;
41
+ }
42
+ resolveModel(override) {
43
+ return (0, gemini_cheap_models_1.resolveCheapGeminiModel)(override || this.brainConfig?.model);
44
+ }
45
+ async completeJson(input) {
46
+ const started = Date.now();
47
+ const url = `https://generativelanguage.googleapis.com/v1beta/models/` +
48
+ `${encodeURIComponent(input.model.id)}:generateContent` +
49
+ `?key=${encodeURIComponent(input.apiKey)}`;
50
+ const res = await fetch(url, {
51
+ method: 'POST',
52
+ headers: { 'content-type': 'application/json' },
53
+ signal: AbortSignal.timeout(json_llm_brain_base_1.JSON_LLM_BRAIN_TIMEOUT_MS),
54
+ body: JSON.stringify({
55
+ systemInstruction: {
56
+ parts: [{ text: input.system }],
57
+ },
58
+ contents: [
59
+ {
60
+ role: 'user',
61
+ parts: [{ text: input.user }],
62
+ },
63
+ ],
64
+ generationConfig: {
65
+ temperature: 0,
66
+ responseMimeType: 'application/json',
67
+ },
68
+ }),
69
+ });
70
+ if (!res.ok) {
71
+ const body = await res.text();
72
+ this.logger.error(`Gemini brain ${input.kind} failed: ${res.status} ${body}`);
73
+ throw new Error(`GeminiBrainAdapter ${input.kind} error: ${res.status}`);
74
+ }
75
+ const json = (await res.json());
76
+ const parts = json.candidates?.[0]?.content?.parts ?? [];
77
+ const content = parts
78
+ .map((p) => p.text)
79
+ .filter((t) => typeof t === 'string' && t.length > 0)
80
+ .join('\n')
81
+ .trim() || '{}';
82
+ const usage = {
83
+ prompt_tokens: json.usageMetadata?.promptTokenCount ?? 0,
84
+ completion_tokens: json.usageMetadata?.candidatesTokenCount ?? 0,
85
+ total_tokens: json.usageMetadata?.totalTokenCount,
86
+ };
87
+ this.recordUsage({
88
+ providerCallId: input.providerCallId,
89
+ conversationId: input.conversationId,
90
+ kind: input.kind,
91
+ model: input.model,
92
+ usage,
93
+ started,
94
+ });
95
+ return { content, usage };
96
+ }
97
+ };
98
+ exports.GeminiBrainAdapter = GeminiBrainAdapter;
99
+ exports.GeminiBrainAdapter = GeminiBrainAdapter = __decorate([
100
+ (0, common_1.Injectable)(),
101
+ __param(2, (0, common_1.Optional)()),
102
+ __param(2, (0, common_1.Inject)(brain_config_1.STUDIO_BRAIN_CONFIG)),
103
+ __metadata("design:paramtypes", [brain_usage_tracker_1.BrainUsageTracker,
104
+ event_service_1.EventService, Object])
105
+ ], GeminiBrainAdapter);
106
+ //# sourceMappingURL=gemini-brain.adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gemini-brain.adapter.js","sourceRoot":"","sources":["../../../src/brain/adapters/gemini-brain.adapter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ import { Logger } from '@nestjs/common';
2
+ import { EventService } from '../../events/event.service';
3
+ import { BrainUsageTracker } from '../brain-usage.tracker';
4
+ import { type StudioBrainConfig } from '../brain-config';
5
+ import { type CheapGrokModelPricing } from '../grok-cheap-models';
6
+ import type { TokenUsage } from '../llm-model-pricing';
7
+ import { JsonLlmBrainAdapter, type JsonLlmCompleteInput } from './json-llm-brain.base';
8
+ /**
9
+ * Vapi Studio Grok Brain — xAI OpenAI-compatible Chat Completions on a **cheap whitelist**.
10
+ *
11
+ * Env: `XAI_API_KEY`. Same scan/clarify/judge contracts as ChatGPT (3s timeout).
12
+ */
13
+ export declare class GrokBrainAdapter extends JsonLlmBrainAdapter {
14
+ protected readonly adapterId: string;
15
+ protected readonly logger: Logger;
16
+ constructor(usage: BrainUsageTracker, events: EventService, brainConfig?: StudioBrainConfig);
17
+ protected requireApiKey(op: string): string;
18
+ protected resolveModel(override?: string | null): CheapGrokModelPricing;
19
+ protected completeJson(input: JsonLlmCompleteInput): Promise<{
20
+ content: string;
21
+ usage: TokenUsage;
22
+ }>;
23
+ }
24
+ //# sourceMappingURL=grok-brain.adapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"grok-brain.adapter.d.ts","sourceRoot":"","sources":["../../../src/brain/adapters/grok-brain.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,MAAM,EAAY,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,mBAAmB,EAEnB,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAO/B;;;;GAIG;AACH,qBACa,gBAAiB,SAAQ,mBAAmB;IACvD,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAiB;IACrD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAkC;gBAGjE,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,YAAY,EAGpB,WAAW,CAAC,EAAE,iBAAiB;IAKjC,SAAS,CAAC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAW3C,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,qBAAqB;cAIvD,YAAY,CAC1B,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAC;CA2CnD"}
@@ -0,0 +1,90 @@
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
+ var __param = (this && this.__param) || function (paramIndex, decorator) {
12
+ return function (target, key) { decorator(target, key, paramIndex); }
13
+ };
14
+ Object.defineProperty(exports, "__esModule", { value: true });
15
+ exports.GrokBrainAdapter = void 0;
16
+ const common_1 = require("@nestjs/common");
17
+ const event_service_1 = require("../../events/event.service");
18
+ const brain_usage_tracker_1 = require("../brain-usage.tracker");
19
+ const brain_config_1 = require("../brain-config");
20
+ const grok_cheap_models_1 = require("../grok-cheap-models");
21
+ const json_llm_brain_base_1 = require("./json-llm-brain.base");
22
+ /**
23
+ * Vapi Studio Grok Brain — xAI OpenAI-compatible Chat Completions on a **cheap whitelist**.
24
+ *
25
+ * Env: `XAI_API_KEY`. Same scan/clarify/judge contracts as ChatGPT (3s timeout).
26
+ */
27
+ let GrokBrainAdapter = class GrokBrainAdapter extends json_llm_brain_base_1.JsonLlmBrainAdapter {
28
+ adapterId = 'studio-grok';
29
+ logger = new common_1.Logger('GrokBrainAdapter');
30
+ constructor(usage, events, brainConfig) {
31
+ super(usage, events, brainConfig);
32
+ }
33
+ requireApiKey(op) {
34
+ const apiKey = process.env.XAI_API_KEY?.trim();
35
+ if (!apiKey || apiKey.startsWith('sk-mock') || apiKey === 'REPLACE_ME') {
36
+ throw new Error(`GrokBrainAdapter.${op} requires a real XAI_API_KEY (not mock). ` +
37
+ `Keep the app on MockBrainAdapter in code until Grok is enabled.`);
38
+ }
39
+ return apiKey;
40
+ }
41
+ resolveModel(override) {
42
+ return (0, grok_cheap_models_1.resolveCheapGrokModel)(override || this.brainConfig?.model);
43
+ }
44
+ async completeJson(input) {
45
+ const started = Date.now();
46
+ const res = await fetch('https://api.x.ai/v1/chat/completions', {
47
+ method: 'POST',
48
+ headers: {
49
+ authorization: `Bearer ${input.apiKey}`,
50
+ 'content-type': 'application/json',
51
+ },
52
+ signal: AbortSignal.timeout(json_llm_brain_base_1.JSON_LLM_BRAIN_TIMEOUT_MS),
53
+ body: JSON.stringify({
54
+ model: input.model.id,
55
+ temperature: 0,
56
+ response_format: { type: 'json_object' },
57
+ messages: [
58
+ { role: 'system', content: input.system },
59
+ { role: 'user', content: input.user },
60
+ ],
61
+ }),
62
+ });
63
+ if (!res.ok) {
64
+ const body = await res.text();
65
+ this.logger.error(`xAI brain ${input.kind} failed: ${res.status} ${body}`);
66
+ throw new Error(`GrokBrainAdapter ${input.kind} error: ${res.status}`);
67
+ }
68
+ const json = (await res.json());
69
+ const content = json.choices?.[0]?.message?.content ?? '{}';
70
+ const usage = json.usage ?? {};
71
+ this.recordUsage({
72
+ providerCallId: input.providerCallId,
73
+ conversationId: input.conversationId,
74
+ kind: input.kind,
75
+ model: input.model,
76
+ usage,
77
+ started,
78
+ });
79
+ return { content, usage };
80
+ }
81
+ };
82
+ exports.GrokBrainAdapter = GrokBrainAdapter;
83
+ exports.GrokBrainAdapter = GrokBrainAdapter = __decorate([
84
+ (0, common_1.Injectable)(),
85
+ __param(2, (0, common_1.Optional)()),
86
+ __param(2, (0, common_1.Inject)(brain_config_1.STUDIO_BRAIN_CONFIG)),
87
+ __metadata("design:paramtypes", [brain_usage_tracker_1.BrainUsageTracker,
88
+ event_service_1.EventService, Object])
89
+ ], GrokBrainAdapter);
90
+ //# sourceMappingURL=grok-brain.adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"grok-brain.adapter.js","sourceRoot":"","sources":["../../../src/brain/adapters/grok-brain.adapter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,63 @@
1
+ /**
2
+ * Shared JSON-LLM Brain orchestration (scan / clarify / judge).
3
+ * Provider adapters only implement auth, model whitelist, and completeJson().
4
+ */
5
+ import { Logger } from '@nestjs/common';
6
+ import { EventService } from '../../events/event.service';
7
+ import type { BrainAdapter, BrainScanInput, BrainScanResult } from '../brain.port';
8
+ import { type BrainClarifyRequest, type BrainClarifyResult } from '../brain-clarify';
9
+ import { type BrainJudgeRequest, type BrainJudgeResult } from '../brain-judge';
10
+ import type { LlmModelPricing, TokenUsage } from '../llm-model-pricing';
11
+ import { BrainUsageTracker } from '../brain-usage.tracker';
12
+ import type { StudioBrainConfig } from '../brain-config';
13
+ /** Fail the provider round-trip rather than stalling a live call. */
14
+ export declare const JSON_LLM_BRAIN_TIMEOUT_MS = 3000;
15
+ export type JsonLlmCompleteInput = {
16
+ apiKey: string;
17
+ model: LlmModelPricing;
18
+ kind: 'scan' | 'clarify' | 'judge';
19
+ providerCallId: string;
20
+ conversationId?: string;
21
+ system: string;
22
+ user: string;
23
+ };
24
+ /**
25
+ * Template for stock Brain adapters that call a JSON-capable LLM.
26
+ * Subclasses supply API key, model whitelist, and the HTTP completion call.
27
+ */
28
+ export declare abstract class JsonLlmBrainAdapter implements BrainAdapter {
29
+ protected readonly usage: BrainUsageTracker;
30
+ protected readonly events: EventService;
31
+ protected readonly brainConfig?: StudioBrainConfig | undefined;
32
+ protected abstract readonly adapterId: string;
33
+ protected abstract readonly logger: Logger;
34
+ protected constructor(usage: BrainUsageTracker, events: EventService, brainConfig?: StudioBrainConfig | undefined);
35
+ protected abstract requireApiKey(op: string): string;
36
+ protected abstract resolveModel(override?: string | null): LlmModelPricing;
37
+ protected abstract completeJson(input: JsonLlmCompleteInput): Promise<{
38
+ content: string;
39
+ usage: TokenUsage;
40
+ }>;
41
+ scan(input: BrainScanInput): Promise<BrainScanResult>;
42
+ clarify<TAnswer extends Record<string, unknown> = Record<string, unknown>>(request: BrainClarifyRequest): Promise<BrainClarifyResult<TAnswer>>;
43
+ judge<TContext = unknown>(request: BrainJudgeRequest<TContext>): Promise<BrainJudgeResult>;
44
+ /** Record usage after a successful provider call (shared by adapters). */
45
+ protected recordUsage(input: {
46
+ providerCallId: string;
47
+ conversationId?: string;
48
+ kind: 'scan' | 'clarify' | 'judge';
49
+ model: LlmModelPricing;
50
+ usage: TokenUsage;
51
+ started: number;
52
+ }): void;
53
+ private filterExtracted;
54
+ private resolveCandidates;
55
+ private unknownIntention;
56
+ }
57
+ /** Detect CallTurnQueue coalesced multi-utterance user text. */
58
+ export declare function detectUserSpeechSeries(userText: string): {
59
+ isSeries: boolean;
60
+ parts: string[];
61
+ };
62
+ export declare function safeJsonParse(content: string): unknown;
63
+ //# sourceMappingURL=json-llm-brain.base.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"json-llm-brain.base.d.ts","sourceRoot":"","sources":["../../../src/brain/adapters/json-llm-brain.base.ts"],"names":[],"mappings":"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"}