@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,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* In-process Studio event bus — Node EventEmitter.
|
|
3
|
+
*
|
|
4
|
+
* `EventService.emit` fires {@link STUDIO_EVENT_BUS_CHANNEL} with a {@link StudioEvent}.
|
|
5
|
+
* Apps may {@link onStudioEvent} and forward elsewhere if they operate their own sinks.
|
|
6
|
+
*/
|
|
7
|
+
import { EventEmitter } from 'events';
|
|
8
|
+
import type { StudioEvent } from './studio-event';
|
|
9
|
+
/** Channel name passed to `studioEventBus.on(STUDIO_EVENT_BUS_CHANNEL, handler)`. */
|
|
10
|
+
export declare const STUDIO_EVENT_BUS_CHANNEL = "studio.event";
|
|
11
|
+
/** Shared process-local bus. Do not replace. */
|
|
12
|
+
export declare function studioEventBus(): EventEmitter;
|
|
13
|
+
export type StudioEventBusHandler = (event: StudioEvent) => void | Promise<void>;
|
|
14
|
+
/** Subscribe without Nest DI. Returns an unsubscribe function. */
|
|
15
|
+
export declare function onStudioEvent(handler: StudioEventBusHandler): () => void;
|
|
16
|
+
export declare function emitStudioEventBus(event: StudioEvent): void;
|
|
17
|
+
//# sourceMappingURL=studio-event-bus.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"studio-event-bus.d.ts","sourceRoot":"","sources":["../../src/events/studio-event-bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,qFAAqF;AACrF,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AAKvD,gDAAgD;AAChD,wBAAgB,cAAc,IAAI,YAAY,CAE7C;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjF,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAUxE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAE3D"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* In-process Studio event bus — Node EventEmitter.
|
|
4
|
+
*
|
|
5
|
+
* `EventService.emit` fires {@link STUDIO_EVENT_BUS_CHANNEL} with a {@link StudioEvent}.
|
|
6
|
+
* Apps may {@link onStudioEvent} and forward elsewhere if they operate their own sinks.
|
|
7
|
+
*/
|
|
8
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
9
|
+
exports.STUDIO_EVENT_BUS_CHANNEL = void 0;
|
|
10
|
+
exports.studioEventBus = studioEventBus;
|
|
11
|
+
exports.onStudioEvent = onStudioEvent;
|
|
12
|
+
exports.emitStudioEventBus = emitStudioEventBus;
|
|
13
|
+
const events_1 = require("events");
|
|
14
|
+
/** Channel name passed to `studioEventBus.on(STUDIO_EVENT_BUS_CHANNEL, handler)`. */
|
|
15
|
+
exports.STUDIO_EVENT_BUS_CHANNEL = 'studio.event';
|
|
16
|
+
const bus = new events_1.EventEmitter();
|
|
17
|
+
bus.setMaxListeners(50);
|
|
18
|
+
/** Shared process-local bus. Do not replace. */
|
|
19
|
+
function studioEventBus() {
|
|
20
|
+
return bus;
|
|
21
|
+
}
|
|
22
|
+
/** Subscribe without Nest DI. Returns an unsubscribe function. */
|
|
23
|
+
function onStudioEvent(handler) {
|
|
24
|
+
const wrapped = (event) => {
|
|
25
|
+
void Promise.resolve(handler(event)).catch(() => {
|
|
26
|
+
/* subscriber errors must not break emit */
|
|
27
|
+
});
|
|
28
|
+
};
|
|
29
|
+
bus.on(exports.STUDIO_EVENT_BUS_CHANNEL, wrapped);
|
|
30
|
+
return () => {
|
|
31
|
+
bus.off(exports.STUDIO_EVENT_BUS_CHANNEL, wrapped);
|
|
32
|
+
};
|
|
33
|
+
}
|
|
34
|
+
function emitStudioEventBus(event) {
|
|
35
|
+
bus.emit(exports.STUDIO_EVENT_BUS_CHANNEL, event);
|
|
36
|
+
}
|
|
37
|
+
//# sourceMappingURL=studio-event-bus.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"studio-event-bus.js","sourceRoot":"","sources":["../../src/events/studio-event-bus.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAYH,wCAEC;AAKD,sCAUC;AAED,gDAEC;AA/BD,mCAAsC;AAGtC,qFAAqF;AACxE,QAAA,wBAAwB,GAAG,cAAc,CAAC;AAEvD,MAAM,GAAG,GAAiB,IAAI,qBAAY,EAAE,CAAC;AAC7C,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;AAExB,gDAAgD;AAChD,SAAgB,cAAc;IAC5B,OAAO,GAAG,CAAC;AACb,CAAC;AAID,kEAAkE;AAClE,SAAgB,aAAa,CAAC,OAA8B;IAC1D,MAAM,OAAO,GAAG,CAAC,KAAkB,EAAQ,EAAE;QAC3C,KAAK,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YAC9C,2CAA2C;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,GAAG,CAAC,EAAE,CAAC,gCAAwB,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,GAAG,EAAE;QACV,GAAG,CAAC,GAAG,CAAC,gCAAwB,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAAC,KAAkB;IACnD,GAAG,CAAC,IAAI,CAAC,gCAAwB,EAAE,KAAK,CAAC,CAAC;AAC5C,CAAC"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Framework events — produce here; subscribers decide what to do.
|
|
3
|
+
*
|
|
4
|
+
* Console + in-process Node EventEmitter (`onStudioEvent`) + optional Nest
|
|
5
|
+
* `eventListeners` (e.g. in-memory Studio UI buffer). Durable sinks are
|
|
6
|
+
* application-owned — not part of this package.
|
|
7
|
+
*/
|
|
8
|
+
import type { StudioLogLevel } from './conversation-console';
|
|
9
|
+
export declare const STUDIO_EVENT_LISTENERS: unique symbol;
|
|
10
|
+
export declare const STUDIO_EVENTS: {
|
|
11
|
+
readonly INTEGRATION_REQUEST: "INTEGRATION_REQUEST";
|
|
12
|
+
readonly INTEGRATION_RESPONSE: "INTEGRATION_RESPONSE";
|
|
13
|
+
readonly INTEGRATION_ERROR: "INTEGRATION_ERROR";
|
|
14
|
+
/** Outbound SMS / push / email — emit for app-owned sinks / logs. */
|
|
15
|
+
readonly OUTBOUND_NOTIFICATION: "OUTBOUND_NOTIFICATION";
|
|
16
|
+
readonly OUTBOUND_NOTIFICATION_ERROR: "OUTBOUND_NOTIFICATION_ERROR";
|
|
17
|
+
/** Studio Task Queue lifecycle (see StudioTaskQueue). */
|
|
18
|
+
readonly TASK_ENQUEUED: "TASK_ENQUEUED";
|
|
19
|
+
readonly TASK_STARTED: "TASK_STARTED";
|
|
20
|
+
readonly TASK_COMPLETED: "TASK_COMPLETED";
|
|
21
|
+
readonly TASK_FAILED: "TASK_FAILED";
|
|
22
|
+
readonly TASK_DEDUPED: "TASK_DEDUPED";
|
|
23
|
+
readonly TASK_AWAITED: "TASK_AWAITED";
|
|
24
|
+
};
|
|
25
|
+
export type StudioEventType = (typeof STUDIO_EVENTS)[keyof typeof STUDIO_EVENTS] | string;
|
|
26
|
+
export interface StudioEvent {
|
|
27
|
+
id: string;
|
|
28
|
+
type: StudioEventType;
|
|
29
|
+
ts: string;
|
|
30
|
+
level: StudioLogLevel;
|
|
31
|
+
conversationId?: string;
|
|
32
|
+
runtimeInstanceId?: string;
|
|
33
|
+
providerCallId?: string;
|
|
34
|
+
payload: Record<string, unknown>;
|
|
35
|
+
}
|
|
36
|
+
export type StudioEventInput = Omit<StudioEvent, 'id' | 'ts' | 'level'> & {
|
|
37
|
+
id?: string;
|
|
38
|
+
ts?: string;
|
|
39
|
+
level?: StudioLogLevel;
|
|
40
|
+
};
|
|
41
|
+
export interface StudioEventListener {
|
|
42
|
+
handle(event: StudioEvent): void | Promise<void>;
|
|
43
|
+
}
|
|
44
|
+
//# sourceMappingURL=studio-event.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"studio-event.d.ts","sourceRoot":"","sources":["../../src/events/studio-event.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,eAAO,MAAM,sBAAsB,eAAmC,CAAC;AAEvE,eAAO,MAAM,aAAa;;;;IAIxB,qEAAqE;;;IAGrE,yDAAyD;;;;;;;CAOjD,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,GAAG,MAAM,CAAC;AAE1F,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,eAAe,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,cAAc,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC,GAAG;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Framework events — produce here; subscribers decide what to do.
|
|
4
|
+
*
|
|
5
|
+
* Console + in-process Node EventEmitter (`onStudioEvent`) + optional Nest
|
|
6
|
+
* `eventListeners` (e.g. in-memory Studio UI buffer). Durable sinks are
|
|
7
|
+
* application-owned — not part of this package.
|
|
8
|
+
*/
|
|
9
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
10
|
+
exports.STUDIO_EVENTS = exports.STUDIO_EVENT_LISTENERS = void 0;
|
|
11
|
+
exports.STUDIO_EVENT_LISTENERS = Symbol('STUDIO_EVENT_LISTENERS');
|
|
12
|
+
exports.STUDIO_EVENTS = {
|
|
13
|
+
INTEGRATION_REQUEST: 'INTEGRATION_REQUEST',
|
|
14
|
+
INTEGRATION_RESPONSE: 'INTEGRATION_RESPONSE',
|
|
15
|
+
INTEGRATION_ERROR: 'INTEGRATION_ERROR',
|
|
16
|
+
/** Outbound SMS / push / email — emit for app-owned sinks / logs. */
|
|
17
|
+
OUTBOUND_NOTIFICATION: 'OUTBOUND_NOTIFICATION',
|
|
18
|
+
OUTBOUND_NOTIFICATION_ERROR: 'OUTBOUND_NOTIFICATION_ERROR',
|
|
19
|
+
/** Studio Task Queue lifecycle (see StudioTaskQueue). */
|
|
20
|
+
TASK_ENQUEUED: 'TASK_ENQUEUED',
|
|
21
|
+
TASK_STARTED: 'TASK_STARTED',
|
|
22
|
+
TASK_COMPLETED: 'TASK_COMPLETED',
|
|
23
|
+
TASK_FAILED: 'TASK_FAILED',
|
|
24
|
+
TASK_DEDUPED: 'TASK_DEDUPED',
|
|
25
|
+
TASK_AWAITED: 'TASK_AWAITED',
|
|
26
|
+
};
|
|
27
|
+
//# sourceMappingURL=studio-event.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"studio-event.js","sourceRoot":"","sources":["../../src/events/studio-event.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAIU,QAAA,sBAAsB,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;AAE1D,QAAA,aAAa,GAAG;IAC3B,mBAAmB,EAAE,qBAAqB;IAC1C,oBAAoB,EAAE,sBAAsB;IAC5C,iBAAiB,EAAE,mBAAmB;IACtC,qEAAqE;IACrE,qBAAqB,EAAE,uBAAuB;IAC9C,2BAA2B,EAAE,6BAA6B;IAC1D,yDAAyD;IACzD,aAAa,EAAE,eAAe;IAC9B,YAAY,EAAE,cAAc;IAC5B,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;CACpB,CAAC"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Safe, Brain-free condition evaluation for flow transitions.
|
|
3
|
+
* No `eval` — path lookups + a tiny boolean/compare grammar.
|
|
4
|
+
*
|
|
5
|
+
* Paths: `memory.foo`, `variables.bar` (also `var.` alias for variables).
|
|
6
|
+
* Ops: `==`, `!=`, `!path` (falsy), bare `path` (truthy).
|
|
7
|
+
* Join: `&&`, `||` (&& binds tighter). Parentheses supported.
|
|
8
|
+
*/
|
|
9
|
+
export type ConditionContext = {
|
|
10
|
+
memory: Record<string, unknown>;
|
|
11
|
+
variables: Record<string, unknown>;
|
|
12
|
+
};
|
|
13
|
+
/** Compile a condition string into a predicate. Throws on syntax error. */
|
|
14
|
+
export declare function compileCondition(expression: string): (ctx: ConditionContext) => boolean;
|
|
15
|
+
/** Evaluate once (compiles each call — prefer compileCondition in hot paths). */
|
|
16
|
+
export declare function evaluateCondition(expression: string, ctx: ConditionContext): boolean;
|
|
17
|
+
export interface FlowConditionTransition {
|
|
18
|
+
id: string;
|
|
19
|
+
/** If set, only when current node is one of these (or absent = any except `to`). */
|
|
20
|
+
from?: string[];
|
|
21
|
+
/** Destination node id in the same flow. */
|
|
22
|
+
to: string;
|
|
23
|
+
/** Condition expression over memory / variables. */
|
|
24
|
+
when: string;
|
|
25
|
+
/**
|
|
26
|
+
* true → skip listen_resolve + Brain; route straight to `to`.
|
|
27
|
+
* false → inject a high-priority synthetic intention for cascade with Brain.
|
|
28
|
+
*/
|
|
29
|
+
force?: boolean;
|
|
30
|
+
/** Walk / log priority when force=false (default 1_000_000). */
|
|
31
|
+
priority?: number;
|
|
32
|
+
/** Forensic reason string (also FLOW_CONTINUE-style). */
|
|
33
|
+
reason?: string;
|
|
34
|
+
}
|
|
35
|
+
//# sourceMappingURL=condition.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"condition.d.ts","sourceRoot":"","sources":["../../src/flow/condition.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAmOF,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,GACjB,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAMpC;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAET;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
|
|
@@ -0,0 +1,246 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Safe, Brain-free condition evaluation for flow transitions.
|
|
4
|
+
* No `eval` — path lookups + a tiny boolean/compare grammar.
|
|
5
|
+
*
|
|
6
|
+
* Paths: `memory.foo`, `variables.bar` (also `var.` alias for variables).
|
|
7
|
+
* Ops: `==`, `!=`, `!path` (falsy), bare `path` (truthy).
|
|
8
|
+
* Join: `&&`, `||` (&& binds tighter). Parentheses supported.
|
|
9
|
+
*/
|
|
10
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
11
|
+
exports.compileCondition = compileCondition;
|
|
12
|
+
exports.evaluateCondition = evaluateCondition;
|
|
13
|
+
function isTruthy(value) {
|
|
14
|
+
if (value === undefined || value === null)
|
|
15
|
+
return false;
|
|
16
|
+
if (typeof value === 'boolean')
|
|
17
|
+
return value;
|
|
18
|
+
if (typeof value === 'number')
|
|
19
|
+
return value !== 0 && !Number.isNaN(value);
|
|
20
|
+
if (typeof value === 'string')
|
|
21
|
+
return value.trim().length > 0;
|
|
22
|
+
return true;
|
|
23
|
+
}
|
|
24
|
+
function readPath(ctx, path) {
|
|
25
|
+
const parts = path.split('.').filter(Boolean);
|
|
26
|
+
if (parts.length < 2)
|
|
27
|
+
return undefined;
|
|
28
|
+
const root = parts[0];
|
|
29
|
+
const bag = root === 'memory'
|
|
30
|
+
? ctx.memory
|
|
31
|
+
: root === 'variables' || root === 'var'
|
|
32
|
+
? ctx.variables
|
|
33
|
+
: null;
|
|
34
|
+
if (!bag)
|
|
35
|
+
return undefined;
|
|
36
|
+
let cur = bag;
|
|
37
|
+
for (const key of parts.slice(1)) {
|
|
38
|
+
if (cur == null || typeof cur !== 'object')
|
|
39
|
+
return undefined;
|
|
40
|
+
cur = cur[key];
|
|
41
|
+
}
|
|
42
|
+
return cur;
|
|
43
|
+
}
|
|
44
|
+
function parseLiteral(raw) {
|
|
45
|
+
const t = raw.trim();
|
|
46
|
+
if (t === 'true')
|
|
47
|
+
return true;
|
|
48
|
+
if (t === 'false')
|
|
49
|
+
return false;
|
|
50
|
+
if (t === 'null' || t === 'undefined')
|
|
51
|
+
return null;
|
|
52
|
+
if (/^-?\d+(\.\d+)?$/.test(t))
|
|
53
|
+
return Number(t);
|
|
54
|
+
if ((t.startsWith('"') && t.endsWith('"')) ||
|
|
55
|
+
(t.startsWith("'") && t.endsWith("'"))) {
|
|
56
|
+
return t.slice(1, -1);
|
|
57
|
+
}
|
|
58
|
+
// Bare word → treat as string (channel names, etc.)
|
|
59
|
+
return t;
|
|
60
|
+
}
|
|
61
|
+
function tokenize(input) {
|
|
62
|
+
const src = input.trim();
|
|
63
|
+
const out = [];
|
|
64
|
+
let i = 0;
|
|
65
|
+
while (i < src.length) {
|
|
66
|
+
const ch = src[i];
|
|
67
|
+
if (/\s/.test(ch)) {
|
|
68
|
+
i += 1;
|
|
69
|
+
continue;
|
|
70
|
+
}
|
|
71
|
+
if (src.startsWith('&&', i)) {
|
|
72
|
+
out.push({ kind: 'op', value: '&&' });
|
|
73
|
+
i += 2;
|
|
74
|
+
continue;
|
|
75
|
+
}
|
|
76
|
+
if (src.startsWith('||', i)) {
|
|
77
|
+
out.push({ kind: 'op', value: '||' });
|
|
78
|
+
i += 2;
|
|
79
|
+
continue;
|
|
80
|
+
}
|
|
81
|
+
if (src.startsWith('==', i)) {
|
|
82
|
+
out.push({ kind: 'op', value: '==' });
|
|
83
|
+
i += 2;
|
|
84
|
+
continue;
|
|
85
|
+
}
|
|
86
|
+
if (src.startsWith('!=', i)) {
|
|
87
|
+
out.push({ kind: 'op', value: '!=' });
|
|
88
|
+
i += 2;
|
|
89
|
+
continue;
|
|
90
|
+
}
|
|
91
|
+
if (ch === '!' || ch === '(' || ch === ')') {
|
|
92
|
+
out.push({ kind: 'op', value: ch });
|
|
93
|
+
i += 1;
|
|
94
|
+
continue;
|
|
95
|
+
}
|
|
96
|
+
if (ch === '"' || ch === "'") {
|
|
97
|
+
const quote = ch;
|
|
98
|
+
let j = i + 1;
|
|
99
|
+
let buf = '';
|
|
100
|
+
while (j < src.length && src[j] !== quote) {
|
|
101
|
+
buf += src[j];
|
|
102
|
+
j += 1;
|
|
103
|
+
}
|
|
104
|
+
out.push({ kind: 'lit', value: buf });
|
|
105
|
+
i = j + 1;
|
|
106
|
+
continue;
|
|
107
|
+
}
|
|
108
|
+
let j = i;
|
|
109
|
+
while (j < src.length && /[A-Za-z0-9_.-]/.test(src[j]))
|
|
110
|
+
j += 1;
|
|
111
|
+
const word = src.slice(i, j);
|
|
112
|
+
if (!word) {
|
|
113
|
+
throw new Error(`Unexpected character in condition: ${ch}`);
|
|
114
|
+
}
|
|
115
|
+
if (word === 'true' ||
|
|
116
|
+
word === 'false' ||
|
|
117
|
+
word === 'null' ||
|
|
118
|
+
word === 'undefined' ||
|
|
119
|
+
/^-?\d+(\.\d+)?$/.test(word)) {
|
|
120
|
+
out.push({ kind: 'lit', value: parseLiteral(word) });
|
|
121
|
+
}
|
|
122
|
+
else if (word.startsWith('memory.') || word.startsWith('variables.') || word.startsWith('var.')) {
|
|
123
|
+
out.push({ kind: 'path', value: word });
|
|
124
|
+
}
|
|
125
|
+
else {
|
|
126
|
+
out.push({ kind: 'lit', value: word });
|
|
127
|
+
}
|
|
128
|
+
i = j;
|
|
129
|
+
}
|
|
130
|
+
return out;
|
|
131
|
+
}
|
|
132
|
+
class Parser {
|
|
133
|
+
toks;
|
|
134
|
+
i = 0;
|
|
135
|
+
constructor(toks) {
|
|
136
|
+
this.toks = toks;
|
|
137
|
+
}
|
|
138
|
+
parse() {
|
|
139
|
+
const fn = this.parseOr();
|
|
140
|
+
if (this.i < this.toks.length) {
|
|
141
|
+
throw new Error('Trailing tokens in condition');
|
|
142
|
+
}
|
|
143
|
+
return fn;
|
|
144
|
+
}
|
|
145
|
+
peek() {
|
|
146
|
+
return this.toks[this.i];
|
|
147
|
+
}
|
|
148
|
+
take() {
|
|
149
|
+
const t = this.toks[this.i];
|
|
150
|
+
if (!t)
|
|
151
|
+
throw new Error('Unexpected end of condition');
|
|
152
|
+
this.i += 1;
|
|
153
|
+
return t;
|
|
154
|
+
}
|
|
155
|
+
parseOr() {
|
|
156
|
+
let left = this.parseAnd();
|
|
157
|
+
while (this.peek()?.kind === 'op' && this.peek()?.value === '||') {
|
|
158
|
+
this.take();
|
|
159
|
+
const right = this.parseAnd();
|
|
160
|
+
const L = left;
|
|
161
|
+
left = (ctx) => L(ctx) || right(ctx);
|
|
162
|
+
}
|
|
163
|
+
return left;
|
|
164
|
+
}
|
|
165
|
+
parseAnd() {
|
|
166
|
+
let left = this.parseUnary();
|
|
167
|
+
while (this.peek()?.kind === 'op' && this.peek()?.value === '&&') {
|
|
168
|
+
this.take();
|
|
169
|
+
const right = this.parseUnary();
|
|
170
|
+
const L = left;
|
|
171
|
+
left = (ctx) => L(ctx) && right(ctx);
|
|
172
|
+
}
|
|
173
|
+
return left;
|
|
174
|
+
}
|
|
175
|
+
parseUnary() {
|
|
176
|
+
if (this.peek()?.kind === 'op' && this.peek()?.value === '!') {
|
|
177
|
+
this.take();
|
|
178
|
+
const inner = this.parseUnary();
|
|
179
|
+
return (ctx) => !inner(ctx);
|
|
180
|
+
}
|
|
181
|
+
return this.parsePrimary();
|
|
182
|
+
}
|
|
183
|
+
parsePrimary() {
|
|
184
|
+
const t = this.peek();
|
|
185
|
+
if (!t)
|
|
186
|
+
throw new Error('Unexpected end of condition');
|
|
187
|
+
if (t.kind === 'op' && t.value === '(') {
|
|
188
|
+
this.take();
|
|
189
|
+
const inner = this.parseOr();
|
|
190
|
+
const close = this.take();
|
|
191
|
+
if (close.kind !== 'op' || close.value !== ')') {
|
|
192
|
+
throw new Error('Expected )');
|
|
193
|
+
}
|
|
194
|
+
return inner;
|
|
195
|
+
}
|
|
196
|
+
if (t.kind === 'path') {
|
|
197
|
+
this.take();
|
|
198
|
+
const path = t.value;
|
|
199
|
+
const next = this.peek();
|
|
200
|
+
if (next?.kind === 'op' && (next.value === '==' || next.value === '!=')) {
|
|
201
|
+
this.take();
|
|
202
|
+
const rhs = this.take();
|
|
203
|
+
const expected = rhs.kind === 'lit'
|
|
204
|
+
? rhs.value
|
|
205
|
+
: rhs.kind === 'path'
|
|
206
|
+
? undefined
|
|
207
|
+
: (() => {
|
|
208
|
+
throw new Error('Expected literal after comparison');
|
|
209
|
+
})();
|
|
210
|
+
if (rhs.kind === 'path') {
|
|
211
|
+
const other = rhs.value;
|
|
212
|
+
return (ctx) => {
|
|
213
|
+
const a = readPath(ctx, path);
|
|
214
|
+
const b = readPath(ctx, other);
|
|
215
|
+
return next.value === '==' ? a === b : a !== b;
|
|
216
|
+
};
|
|
217
|
+
}
|
|
218
|
+
// `null` / `undefined` literals use loose nullish compare so missing
|
|
219
|
+
// memory keys match `== undefined` / `== null`.
|
|
220
|
+
const nullish = expected === null || expected === undefined;
|
|
221
|
+
return (ctx) => {
|
|
222
|
+
const a = readPath(ctx, path);
|
|
223
|
+
if (nullish) {
|
|
224
|
+
return next.value === '==' ? a == null : a != null;
|
|
225
|
+
}
|
|
226
|
+
return next.value === '==' ? a === expected : a !== expected;
|
|
227
|
+
};
|
|
228
|
+
}
|
|
229
|
+
return (ctx) => isTruthy(readPath(ctx, path));
|
|
230
|
+
}
|
|
231
|
+
throw new Error(`Expected path or (, got ${JSON.stringify(t)}`);
|
|
232
|
+
}
|
|
233
|
+
}
|
|
234
|
+
/** Compile a condition string into a predicate. Throws on syntax error. */
|
|
235
|
+
function compileCondition(expression) {
|
|
236
|
+
const trimmed = expression.trim();
|
|
237
|
+
if (!trimmed) {
|
|
238
|
+
return () => false;
|
|
239
|
+
}
|
|
240
|
+
return new Parser(tokenize(trimmed)).parse();
|
|
241
|
+
}
|
|
242
|
+
/** Evaluate once (compiles each call — prefer compileCondition in hot paths). */
|
|
243
|
+
function evaluateCondition(expression, ctx) {
|
|
244
|
+
return compileCondition(expression)(ctx);
|
|
245
|
+
}
|
|
246
|
+
//# sourceMappingURL=condition.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"condition.js","sourceRoot":"","sources":["../../src/flow/condition.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
import { type ConditionContext, type FlowConditionTransition } from './condition';
|
|
2
|
+
export interface FlowNodeDefinition {
|
|
3
|
+
id: string;
|
|
4
|
+
class: string;
|
|
5
|
+
intentions: string[];
|
|
6
|
+
portal?: boolean;
|
|
7
|
+
priority?: number;
|
|
8
|
+
terminal?: boolean;
|
|
9
|
+
}
|
|
10
|
+
export interface CompiledConditionTransition extends FlowConditionTransition {
|
|
11
|
+
/** Compiled `when` predicate (throws at load if `when` is invalid). */
|
|
12
|
+
test: (ctx: ConditionContext) => boolean;
|
|
13
|
+
}
|
|
14
|
+
export interface FlowDefinition {
|
|
15
|
+
version: number;
|
|
16
|
+
id: string;
|
|
17
|
+
start: string;
|
|
18
|
+
nodes: Record<string, FlowNodeDefinition>;
|
|
19
|
+
/** Declarative memory/variable gates — evaluated before listen/Brain when force. */
|
|
20
|
+
transitions: CompiledConditionTransition[];
|
|
21
|
+
}
|
|
22
|
+
export interface RawFlowFile {
|
|
23
|
+
version: number;
|
|
24
|
+
flow: {
|
|
25
|
+
id: string;
|
|
26
|
+
start: string;
|
|
27
|
+
};
|
|
28
|
+
nodes: Record<string, {
|
|
29
|
+
class: string;
|
|
30
|
+
intentions?: string[];
|
|
31
|
+
portal?: boolean;
|
|
32
|
+
priority?: number;
|
|
33
|
+
terminal?: boolean;
|
|
34
|
+
}>;
|
|
35
|
+
transitions?: Array<{
|
|
36
|
+
id?: string;
|
|
37
|
+
from?: string | string[];
|
|
38
|
+
to: string;
|
|
39
|
+
when: string;
|
|
40
|
+
force?: boolean;
|
|
41
|
+
priority?: number;
|
|
42
|
+
reason?: string;
|
|
43
|
+
}>;
|
|
44
|
+
}
|
|
45
|
+
/** Synthetic intention → execute a node by id (condition transitions / goto). */
|
|
46
|
+
export declare const CONDITION_GOTO_PREFIX = "studio.goto.";
|
|
47
|
+
export declare function conditionGotoIntention(nodeId: string): string;
|
|
48
|
+
export declare function parseConditionGotoNodeId(intention: string): string | null;
|
|
49
|
+
export declare class FlowLoader {
|
|
50
|
+
private flow;
|
|
51
|
+
loadFromFile(path: string): FlowDefinition;
|
|
52
|
+
loadFromObject(raw: RawFlowFile): FlowDefinition;
|
|
53
|
+
getFlow(): FlowDefinition;
|
|
54
|
+
nodesForIntention(intention: string): FlowNodeDefinition[];
|
|
55
|
+
/** All intention names declared on portal nodes. */
|
|
56
|
+
portalIntentionNames(): string[];
|
|
57
|
+
/** All intention names on non-portal nodes. */
|
|
58
|
+
normalIntentionNames(): string[];
|
|
59
|
+
/**
|
|
60
|
+
* Condition transitions whose `when` is true for this runtime snapshot.
|
|
61
|
+
* Skips when current node is already `to`, or `from` does not include current.
|
|
62
|
+
*/
|
|
63
|
+
matchingConditionTransitions(input: {
|
|
64
|
+
currentNodeId: string | null | undefined;
|
|
65
|
+
memory: Record<string, unknown>;
|
|
66
|
+
variables: Record<string, unknown>;
|
|
67
|
+
}, opts?: {
|
|
68
|
+
force?: boolean;
|
|
69
|
+
}): CompiledConditionTransition[];
|
|
70
|
+
}
|
|
71
|
+
//# sourceMappingURL=flow-loader.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"flow-loader.d.ts","sourceRoot":"","sources":["../../src/flow/flow-loader.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC7B,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,2BAA4B,SAAQ,uBAAuB;IAC1E,uEAAuE;IACvE,IAAI,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC;CAC1C;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC1C,oFAAoF;IACpF,WAAW,EAAE,2BAA2B,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,KAAK,EAAE,MAAM,CACX,MAAM,EACN;QACE,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CACF,CAAC;IACF,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QACzB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,iBAAiB,CAAC;AAEpD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIzE;AAED,qBACa,UAAU;IACrB,OAAO,CAAC,IAAI,CAA+B;IAEpC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAK1C,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,cAAc;IA8EhD,OAAO,IAAI,cAAc;IAOzB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAkBjE,oDAAoD;IAC7C,oBAAoB,IAAI,MAAM,EAAE;IAYvC,+CAA+C;IACxC,oBAAoB,IAAI,MAAM,EAAE;IAYvC;;;OAGG;IACI,4BAA4B,CACjC,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;QACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,EACD,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACzB,2BAA2B,EAAE;CAoBjC"}
|