@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.
- package/LICENSE +21 -0
- package/README.md +129 -0
- package/agent/AGENTS.md +42 -0
- package/agent/CLAUDE.md +15 -0
- package/agent/claude/rules/ui-and-api-identity.md +9 -0
- package/agent/claude/rules/vapi-studio-best-practices.md +36 -0
- package/agent/cursor/ui-and-api-identity.mdc +16 -0
- package/agent/cursor/vapi-studio-best-practices.mdc +43 -0
- package/dist/adapters/vapi/vapi-sse.compiler.d.ts +61 -0
- package/dist/adapters/vapi/vapi-sse.compiler.d.ts.map +1 -0
- package/dist/adapters/vapi/vapi-sse.compiler.js +396 -0
- package/dist/adapters/vapi/vapi-sse.compiler.js.map +1 -0
- package/dist/analytics/analytics-tags.d.ts +60 -0
- package/dist/analytics/analytics-tags.d.ts.map +1 -0
- package/dist/analytics/analytics-tags.js +27 -0
- package/dist/analytics/analytics-tags.js.map +1 -0
- package/dist/brain/adapters/chatgpt-brain.adapter.d.ts +27 -0
- package/dist/brain/adapters/chatgpt-brain.adapter.d.ts.map +1 -0
- package/dist/brain/adapters/chatgpt-brain.adapter.js +94 -0
- package/dist/brain/adapters/chatgpt-brain.adapter.js.map +1 -0
- package/dist/brain/adapters/claude-brain.adapter.d.ts +24 -0
- package/dist/brain/adapters/claude-brain.adapter.d.ts.map +1 -0
- package/dist/brain/adapters/claude-brain.adapter.js +96 -0
- package/dist/brain/adapters/claude-brain.adapter.js.map +1 -0
- package/dist/brain/adapters/gemini-brain.adapter.d.ts +24 -0
- package/dist/brain/adapters/gemini-brain.adapter.d.ts.map +1 -0
- package/dist/brain/adapters/gemini-brain.adapter.js +106 -0
- package/dist/brain/adapters/gemini-brain.adapter.js.map +1 -0
- package/dist/brain/adapters/grok-brain.adapter.d.ts +24 -0
- package/dist/brain/adapters/grok-brain.adapter.d.ts.map +1 -0
- package/dist/brain/adapters/grok-brain.adapter.js +90 -0
- package/dist/brain/adapters/grok-brain.adapter.js.map +1 -0
- package/dist/brain/adapters/json-llm-brain.base.d.ts +63 -0
- package/dist/brain/adapters/json-llm-brain.base.d.ts.map +1 -0
- package/dist/brain/adapters/json-llm-brain.base.js +511 -0
- package/dist/brain/adapters/json-llm-brain.base.js.map +1 -0
- package/dist/brain/adapters/mock-brain.adapter.d.ts +32 -0
- package/dist/brain/adapters/mock-brain.adapter.d.ts.map +1 -0
- package/dist/brain/adapters/mock-brain.adapter.js +201 -0
- package/dist/brain/adapters/mock-brain.adapter.js.map +1 -0
- package/dist/brain/adapters/mock-provider-brains.adapter.d.ts +22 -0
- package/dist/brain/adapters/mock-provider-brains.adapter.d.ts.map +1 -0
- package/dist/brain/adapters/mock-provider-brains.adapter.js +48 -0
- package/dist/brain/adapters/mock-provider-brains.adapter.js.map +1 -0
- package/dist/brain/brain-clarify.d.ts +75 -0
- package/dist/brain/brain-clarify.d.ts.map +1 -0
- package/dist/brain/brain-clarify.js +146 -0
- package/dist/brain/brain-clarify.js.map +1 -0
- package/dist/brain/brain-config.d.ts +20 -0
- package/dist/brain/brain-config.d.ts.map +1 -0
- package/dist/brain/brain-config.js +20 -0
- package/dist/brain/brain-config.js.map +1 -0
- package/dist/brain/brain-judge.d.ts +68 -0
- package/dist/brain/brain-judge.d.ts.map +1 -0
- package/dist/brain/brain-judge.js +111 -0
- package/dist/brain/brain-judge.js.map +1 -0
- package/dist/brain/brain-ranking.d.ts +41 -0
- package/dist/brain/brain-ranking.d.ts.map +1 -0
- package/dist/brain/brain-ranking.js +103 -0
- package/dist/brain/brain-ranking.js.map +1 -0
- package/dist/brain/brain-usage.tracker.d.ts +48 -0
- package/dist/brain/brain-usage.tracker.d.ts.map +1 -0
- package/dist/brain/brain-usage.tracker.js +106 -0
- package/dist/brain/brain-usage.tracker.js.map +1 -0
- package/dist/brain/brain.port.d.ts +63 -0
- package/dist/brain/brain.port.d.ts.map +1 -0
- package/dist/brain/brain.port.js +7 -0
- package/dist/brain/brain.port.js.map +1 -0
- package/dist/brain/brain.service.d.ts +14 -0
- package/dist/brain/brain.service.d.ts.map +1 -0
- package/dist/brain/brain.service.js +27 -0
- package/dist/brain/brain.service.js.map +1 -0
- package/dist/brain/claude-cheap-models.d.ts +18 -0
- package/dist/brain/claude-cheap-models.d.ts.map +1 -0
- package/dist/brain/claude-cheap-models.js +53 -0
- package/dist/brain/claude-cheap-models.js.map +1 -0
- package/dist/brain/gemini-cheap-models.d.ts +18 -0
- package/dist/brain/gemini-cheap-models.d.ts.map +1 -0
- package/dist/brain/gemini-cheap-models.js +53 -0
- package/dist/brain/gemini-cheap-models.js.map +1 -0
- package/dist/brain/grok-cheap-models.d.ts +18 -0
- package/dist/brain/grok-cheap-models.d.ts.map +1 -0
- package/dist/brain/grok-cheap-models.js +53 -0
- package/dist/brain/grok-cheap-models.js.map +1 -0
- package/dist/brain/llm-model-pricing.d.ts +29 -0
- package/dist/brain/llm-model-pricing.d.ts.map +1 -0
- package/dist/brain/llm-model-pricing.js +38 -0
- package/dist/brain/llm-model-pricing.js.map +1 -0
- package/dist/brain/openai-cheap-models.d.ts +34 -0
- package/dist/brain/openai-cheap-models.d.ts.map +1 -0
- package/dist/brain/openai-cheap-models.js +72 -0
- package/dist/brain/openai-cheap-models.js.map +1 -0
- package/dist/brain/prompt-injection-guard.d.ts +34 -0
- package/dist/brain/prompt-injection-guard.d.ts.map +1 -0
- package/dist/brain/prompt-injection-guard.js +109 -0
- package/dist/brain/prompt-injection-guard.js.map +1 -0
- package/dist/channel/channel-tools.d.ts +72 -0
- package/dist/channel/channel-tools.d.ts.map +1 -0
- package/dist/channel/channel-tools.js +131 -0
- package/dist/channel/channel-tools.js.map +1 -0
- package/dist/conversation/call-turn-queue.d.ts +64 -0
- package/dist/conversation/call-turn-queue.d.ts.map +1 -0
- package/dist/conversation/call-turn-queue.js +156 -0
- package/dist/conversation/call-turn-queue.js.map +1 -0
- package/dist/conversation/conversation-bootstrap.service.d.ts +60 -0
- package/dist/conversation/conversation-bootstrap.service.d.ts.map +1 -0
- package/dist/conversation/conversation-bootstrap.service.js +383 -0
- package/dist/conversation/conversation-bootstrap.service.js.map +1 -0
- package/dist/conversation/conversation-entry.d.ts +38 -0
- package/dist/conversation/conversation-entry.d.ts.map +1 -0
- package/dist/conversation/conversation-entry.js +17 -0
- package/dist/conversation/conversation-entry.js.map +1 -0
- package/dist/conversation/conversation-history.d.ts +31 -0
- package/dist/conversation/conversation-history.d.ts.map +1 -0
- package/dist/conversation/conversation-history.js +53 -0
- package/dist/conversation/conversation-history.js.map +1 -0
- package/dist/conversation/conversation-limits.d.ts +49 -0
- package/dist/conversation/conversation-limits.d.ts.map +1 -0
- package/dist/conversation/conversation-limits.js +44 -0
- package/dist/conversation/conversation-limits.js.map +1 -0
- package/dist/conversation/conversation-resume.service.d.ts +39 -0
- package/dist/conversation/conversation-resume.service.d.ts.map +1 -0
- package/dist/conversation/conversation-resume.service.js +234 -0
- package/dist/conversation/conversation-resume.service.js.map +1 -0
- package/dist/conversation/conversation-schema.d.ts +23 -0
- package/dist/conversation/conversation-schema.d.ts.map +1 -0
- package/dist/conversation/conversation-schema.js +3 -0
- package/dist/conversation/conversation-schema.js.map +1 -0
- package/dist/conversation/listen-expectation.d.ts +145 -0
- package/dist/conversation/listen-expectation.d.ts.map +1 -0
- package/dist/conversation/listen-expectation.js +219 -0
- package/dist/conversation/listen-expectation.js.map +1 -0
- package/dist/conversation/listen-timeout.d.ts +42 -0
- package/dist/conversation/listen-timeout.d.ts.map +1 -0
- package/dist/conversation/listen-timeout.js +57 -0
- package/dist/conversation/listen-timeout.js.map +1 -0
- package/dist/conversation/supervised-conversation.d.ts +64 -0
- package/dist/conversation/supervised-conversation.d.ts.map +1 -0
- package/dist/conversation/supervised-conversation.js +198 -0
- package/dist/conversation/supervised-conversation.js.map +1 -0
- package/dist/conversation/supervised-conversation.registry.d.ts +14 -0
- package/dist/conversation/supervised-conversation.registry.d.ts.map +1 -0
- package/dist/conversation/supervised-conversation.registry.js +47 -0
- package/dist/conversation/supervised-conversation.registry.js.map +1 -0
- package/dist/conversation/types.d.ts +52 -0
- package/dist/conversation/types.d.ts.map +1 -0
- package/dist/conversation/types.js +3 -0
- package/dist/conversation/types.js.map +1 -0
- package/dist/events/conversation-console.d.ts +17 -0
- package/dist/events/conversation-console.d.ts.map +1 -0
- package/dist/events/conversation-console.js +863 -0
- package/dist/events/conversation-console.js.map +1 -0
- package/dist/events/daily-log.driver.d.ts +35 -0
- package/dist/events/daily-log.driver.d.ts.map +1 -0
- package/dist/events/daily-log.driver.js +206 -0
- package/dist/events/daily-log.driver.js.map +1 -0
- package/dist/events/event.service.d.ts +24 -0
- package/dist/events/event.service.d.ts.map +1 -0
- package/dist/events/event.service.js +141 -0
- package/dist/events/event.service.js.map +1 -0
- package/dist/events/route-forensics.d.ts +38 -0
- package/dist/events/route-forensics.d.ts.map +1 -0
- package/dist/events/route-forensics.js +85 -0
- package/dist/events/route-forensics.js.map +1 -0
- package/dist/events/studio-event-bus.d.ts +17 -0
- package/dist/events/studio-event-bus.d.ts.map +1 -0
- package/dist/events/studio-event-bus.js +37 -0
- package/dist/events/studio-event-bus.js.map +1 -0
- package/dist/events/studio-event.d.ts +44 -0
- package/dist/events/studio-event.d.ts.map +1 -0
- package/dist/events/studio-event.js +27 -0
- package/dist/events/studio-event.js.map +1 -0
- package/dist/flow/condition.d.ts +35 -0
- package/dist/flow/condition.d.ts.map +1 -0
- package/dist/flow/condition.js +246 -0
- package/dist/flow/condition.js.map +1 -0
- package/dist/flow/flow-loader.d.ts +71 -0
- package/dist/flow/flow-loader.d.ts.map +1 -0
- package/dist/flow/flow-loader.js +182 -0
- package/dist/flow/flow-loader.js.map +1 -0
- package/dist/forms/form-html.d.ts +30 -0
- package/dist/forms/form-html.d.ts.map +1 -0
- package/dist/forms/form-html.js +130 -0
- package/dist/forms/form-html.js.map +1 -0
- package/dist/forms/form.tokens.d.ts +3 -0
- package/dist/forms/form.tokens.d.ts.map +1 -0
- package/dist/forms/form.tokens.js +6 -0
- package/dist/forms/form.tokens.js.map +1 -0
- package/dist/forms/form.types.d.ts +81 -0
- package/dist/forms/form.types.d.ts.map +1 -0
- package/dist/forms/form.types.js +36 -0
- package/dist/forms/form.types.js.map +1 -0
- package/dist/forms/forms.service.d.ts +52 -0
- package/dist/forms/forms.service.d.ts.map +1 -0
- package/dist/forms/forms.service.js +434 -0
- package/dist/forms/forms.service.js.map +1 -0
- package/dist/forms/noop-form-dispose.adapter.d.ts +12 -0
- package/dist/forms/noop-form-dispose.adapter.d.ts.map +1 -0
- package/dist/forms/noop-form-dispose.adapter.js +27 -0
- package/dist/forms/noop-form-dispose.adapter.js.map +1 -0
- package/dist/forms/twilio-sms-form-dispose.adapter.d.ts +33 -0
- package/dist/forms/twilio-sms-form-dispose.adapter.d.ts.map +1 -0
- package/dist/forms/twilio-sms-form-dispose.adapter.js +125 -0
- package/dist/forms/twilio-sms-form-dispose.adapter.js.map +1 -0
- package/dist/forms/twilio-sms.env.d.ts +62 -0
- package/dist/forms/twilio-sms.env.d.ts.map +1 -0
- package/dist/forms/twilio-sms.env.js +147 -0
- package/dist/forms/twilio-sms.env.js.map +1 -0
- package/dist/forms/twilio-sms.sender.d.ts +27 -0
- package/dist/forms/twilio-sms.sender.d.ts.map +1 -0
- package/dist/forms/twilio-sms.sender.js +75 -0
- package/dist/forms/twilio-sms.sender.js.map +1 -0
- package/dist/identity/email-parse.d.ts +20 -0
- package/dist/identity/email-parse.d.ts.map +1 -0
- package/dist/identity/email-parse.js +102 -0
- package/dist/identity/email-parse.js.map +1 -0
- package/dist/identity/index.d.ts +17 -0
- package/dist/identity/index.d.ts.map +1 -0
- package/dist/identity/index.js +23 -0
- package/dist/identity/index.js.map +1 -0
- package/dist/index.d.ts +108 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +300 -0
- package/dist/index.js.map +1 -0
- package/dist/integrations/integration-client.d.ts +41 -0
- package/dist/integrations/integration-client.d.ts.map +1 -0
- package/dist/integrations/integration-client.js +152 -0
- package/dist/integrations/integration-client.js.map +1 -0
- package/dist/integrations/jwt-hmac.d.ts +33 -0
- package/dist/integrations/jwt-hmac.d.ts.map +1 -0
- package/dist/integrations/jwt-hmac.js +108 -0
- package/dist/integrations/jwt-hmac.js.map +1 -0
- package/dist/intention/code-intention.d.ts +94 -0
- package/dist/intention/code-intention.d.ts.map +1 -0
- package/dist/intention/code-intention.js +89 -0
- package/dist/intention/code-intention.js.map +1 -0
- package/dist/intention/intention-constants.d.ts +37 -0
- package/dist/intention/intention-constants.d.ts.map +1 -0
- package/dist/intention/intention-constants.js +37 -0
- package/dist/intention/intention-constants.js.map +1 -0
- package/dist/intentions/standard-intentions.d.ts +26 -0
- package/dist/intentions/standard-intentions.d.ts.map +1 -0
- package/dist/intentions/standard-intentions.js +28 -0
- package/dist/intentions/standard-intentions.js.map +1 -0
- package/dist/node/agent-node.d.ts +156 -0
- package/dist/node/agent-node.d.ts.map +1 -0
- package/dist/node/agent-node.js +179 -0
- package/dist/node/agent-node.js.map +1 -0
- package/dist/node/catch-directive.d.ts +33 -0
- package/dist/node/catch-directive.d.ts.map +1 -0
- package/dist/node/catch-directive.js +41 -0
- package/dist/node/catch-directive.js.map +1 -0
- package/dist/output/conversation-output.d.ts +113 -0
- package/dist/output/conversation-output.d.ts.map +1 -0
- package/dist/output/conversation-output.js +100 -0
- package/dist/output/conversation-output.js.map +1 -0
- package/dist/persistence/conversation.entity.d.ts +27 -0
- package/dist/persistence/conversation.entity.d.ts.map +1 -0
- package/dist/persistence/conversation.entity.js +115 -0
- package/dist/persistence/conversation.entity.js.map +1 -0
- package/dist/persistence/conversation.repository.d.ts +82 -0
- package/dist/persistence/conversation.repository.d.ts.map +1 -0
- package/dist/persistence/conversation.repository.js +277 -0
- package/dist/persistence/conversation.repository.js.map +1 -0
- package/dist/persistence/project.entity.d.ts +12 -0
- package/dist/persistence/project.entity.d.ts.map +1 -0
- package/dist/persistence/project.entity.js +46 -0
- package/dist/persistence/project.entity.js.map +1 -0
- package/dist/persistence/project.repository.d.ts +17 -0
- package/dist/persistence/project.repository.d.ts.map +1 -0
- package/dist/persistence/project.repository.js +69 -0
- package/dist/persistence/project.repository.js.map +1 -0
- package/dist/persistence/provider-ingress.entity.d.ts +18 -0
- package/dist/persistence/provider-ingress.entity.d.ts.map +1 -0
- package/dist/persistence/provider-ingress.entity.js +91 -0
- package/dist/persistence/provider-ingress.entity.js.map +1 -0
- package/dist/persistence/provider-ingress.repository.d.ts +21 -0
- package/dist/persistence/provider-ingress.repository.d.ts.map +1 -0
- package/dist/persistence/provider-ingress.repository.js +76 -0
- package/dist/persistence/provider-ingress.repository.js.map +1 -0
- package/dist/studio-ui/assets/index-BGd2OhLv.js +84 -0
- package/dist/studio-ui/assets/index-BGd2OhLv.js.map +1 -0
- package/dist/studio-ui/assets/index-DnJos5x2.css +1 -0
- package/dist/studio-ui/index.html +13 -0
- package/dist/studio-ui-mount/index.d.ts +6 -0
- package/dist/studio-ui-mount/index.d.ts.map +1 -0
- package/dist/studio-ui-mount/index.js +13 -0
- package/dist/studio-ui-mount/index.js.map +1 -0
- package/dist/studio-ui-mount/resolve-studio-ui-root.d.ts +6 -0
- package/dist/studio-ui-mount/resolve-studio-ui-root.d.ts.map +1 -0
- package/dist/studio-ui-mount/resolve-studio-ui-root.js +25 -0
- package/dist/studio-ui-mount/resolve-studio-ui-root.js.map +1 -0
- package/dist/studio-ui-mount/studio-spa.controller.d.ts +18 -0
- package/dist/studio-ui-mount/studio-spa.controller.d.ts.map +1 -0
- package/dist/studio-ui-mount/studio-spa.controller.js +57 -0
- package/dist/studio-ui-mount/studio-spa.controller.js.map +1 -0
- package/dist/studio-ui-mount/studio-ui.module.d.ts +15 -0
- package/dist/studio-ui-mount/studio-ui.module.d.ts.map +1 -0
- package/dist/studio-ui-mount/studio-ui.module.js +47 -0
- package/dist/studio-ui-mount/studio-ui.module.js.map +1 -0
- package/dist/studio-ui-mount/studio-ui.tokens.d.ts +2 -0
- package/dist/studio-ui-mount/studio-ui.tokens.d.ts.map +1 -0
- package/dist/studio-ui-mount/studio-ui.tokens.js +5 -0
- package/dist/studio-ui-mount/studio-ui.tokens.js.map +1 -0
- package/dist/supervisor/supervisor-cascade.d.ts +55 -0
- package/dist/supervisor/supervisor-cascade.d.ts.map +1 -0
- package/dist/supervisor/supervisor-cascade.js +261 -0
- package/dist/supervisor/supervisor-cascade.js.map +1 -0
- package/dist/supervisor/supervisor-engine.d.ts +9 -0
- package/dist/supervisor/supervisor-engine.d.ts.map +1 -0
- package/dist/supervisor/supervisor-engine.js +64 -0
- package/dist/supervisor/supervisor-engine.js.map +1 -0
- package/dist/supervisor/supervisor-limits.d.ts +8 -0
- package/dist/supervisor/supervisor-limits.d.ts.map +1 -0
- package/dist/supervisor/supervisor-limits.js +36 -0
- package/dist/supervisor/supervisor-limits.js.map +1 -0
- package/dist/supervisor/supervisor-node-exec.d.ts +39 -0
- package/dist/supervisor/supervisor-node-exec.d.ts.map +1 -0
- package/dist/supervisor/supervisor-node-exec.js +201 -0
- package/dist/supervisor/supervisor-node-exec.js.map +1 -0
- package/dist/supervisor/supervisor-orchestration.d.ts +24 -0
- package/dist/supervisor/supervisor-orchestration.d.ts.map +1 -0
- package/dist/supervisor/supervisor-orchestration.js +395 -0
- package/dist/supervisor/supervisor-orchestration.js.map +1 -0
- package/dist/supervisor/supervisor-portal.d.ts +75 -0
- package/dist/supervisor/supervisor-portal.d.ts.map +1 -0
- package/dist/supervisor/supervisor-portal.js +320 -0
- package/dist/supervisor/supervisor-portal.js.map +1 -0
- package/dist/supervisor/supervisor-route.d.ts +53 -0
- package/dist/supervisor/supervisor-route.d.ts.map +1 -0
- package/dist/supervisor/supervisor-route.js +308 -0
- package/dist/supervisor/supervisor-route.js.map +1 -0
- package/dist/supervisor/supervisor-special-turns.d.ts +34 -0
- package/dist/supervisor/supervisor-special-turns.d.ts.map +1 -0
- package/dist/supervisor/supervisor-special-turns.js +308 -0
- package/dist/supervisor/supervisor-special-turns.js.map +1 -0
- package/dist/supervisor/supervisor.d.ts +44 -0
- package/dist/supervisor/supervisor.d.ts.map +1 -0
- package/dist/supervisor/supervisor.js +79 -0
- package/dist/supervisor/supervisor.js.map +1 -0
- package/dist/supervisor/supervisor.types.d.ts +71 -0
- package/dist/supervisor/supervisor.types.d.ts.map +1 -0
- package/dist/supervisor/supervisor.types.js +8 -0
- package/dist/supervisor/supervisor.types.js.map +1 -0
- package/dist/tasks/studio-task-queue.d.ts +93 -0
- package/dist/tasks/studio-task-queue.d.ts.map +1 -0
- package/dist/tasks/studio-task-queue.js +226 -0
- package/dist/tasks/studio-task-queue.js.map +1 -0
- package/dist/util/studio-env.d.ts +7 -0
- package/dist/util/studio-env.d.ts.map +1 -0
- package/dist/util/studio-env.js +32 -0
- package/dist/util/studio-env.js.map +1 -0
- package/dist/vapi-studio.module.d.ts +55 -0
- package/dist/vapi-studio.module.d.ts.map +1 -0
- package/dist/vapi-studio.module.js +166 -0
- package/dist/vapi-studio.module.js.map +1 -0
- package/dist/workflow/workflow-handoff.service.d.ts +29 -0
- package/dist/workflow/workflow-handoff.service.d.ts.map +1 -0
- package/dist/workflow/workflow-handoff.service.js +165 -0
- package/dist/workflow/workflow-handoff.service.js.map +1 -0
- package/dist/workflow/workflow-loader.d.ts +48 -0
- package/dist/workflow/workflow-loader.d.ts.map +1 -0
- package/dist/workflow/workflow-loader.js +87 -0
- package/dist/workflow/workflow-loader.js.map +1 -0
- package/docs/README.md +69 -0
- package/docs/assets/deterministic-assistant-flow.svg +128 -0
- package/docs/assets/vapi-studio-stack.svg +26 -0
- package/docs/best-practices/README.md +37 -0
- package/docs/best-practices/brain-and-prompt-injection.md +70 -0
- package/docs/best-practices/conversation-design.md +152 -0
- package/docs/best-practices/debugging-and-observability.md +49 -0
- package/docs/best-practices/documentation-layers.md +31 -0
- package/docs/best-practices/identity-and-pii.md +66 -0
- package/docs/best-practices/nodes-and-listens.md +116 -0
- package/docs/best-practices/ui-and-api-identity.md +51 -0
- package/docs/building-apps/creating-an-app.md +59 -0
- package/docs/building-apps/example-apps.md +23 -0
- package/docs/building-apps/overview.md +27 -0
- package/docs/getting-started/installation.md +52 -0
- package/docs/getting-started/introduction.md +23 -0
- package/docs/getting-started/quick-start.md +23 -0
- package/docs/guide/concepts.md +103 -0
- package/docs/guide/forms.md +102 -0
- package/docs/guide/handbook.md +21 -0
- package/docs/guide/introduction.md +56 -0
- package/docs/guide/module-setup.md +68 -0
- package/docs/guide/vapi-adapter.md +70 -0
- package/docs/guide/workflow-squad.md +59 -0
- package/docs/guides/agents.md +85 -0
- package/docs/guides/docker-compose.events.stub.yaml +27 -0
- package/docs/guides/documentation.md +13 -0
- package/docs/guides/extending-events.md +155 -0
- package/docs/guides/node-conventions.md +59 -0
- package/docs/guides/speckit.md +56 -0
- package/docs/reference/data-model.md +79 -0
- package/docs/reference/environment-variables.md +60 -0
- package/docs/reference/events-and-logging.md +137 -0
- package/docs/reference/flow-schema.md +79 -0
- package/docs/reference/runtime-api.md +708 -0
- package/docs/reference/security.md +41 -0
- package/docs/reference/standard-intentions.md +49 -0
- package/docs/reference/testing.md +15 -0
- package/docs/samples/events/nest-listener.example.ts +17 -0
- package/docs/samples/events/redis-bridge.example.ts +44 -0
- package/package.json +81 -0
- package/scripts/fix-access-modifiers.mjs +85 -0
- 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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"}
|