@guidify-ai/vapi-studio 0.1.0

package/dist/supervisor/supervisor-special-turns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-special-turns.js","sourceRoot":"","sources":["../../src/supervisor/supervisor-special-turns.ts"],"names":[],"mappings":"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"}

package/dist/supervisor/supervisor.d.ts

@@ -0,0 +1,44 @@
+import { type BrainService } from '../brain/brain.service';
+import { type StudioBrainConfig } from '../brain/brain-config';
+import { type ResolvedConversationLimits } from '../conversation/conversation-limits';
+import { ConversationBootstrapService } from '../conversation/conversation-bootstrap.service';
+import type { SupervisedConversation } from '../conversation/supervised-conversation';
+import { EventService } from '../events/event.service';
+import { FormsService } from '../forms/forms.service';
+import { FlowLoader } from '../flow/flow-loader';
+import { IntegrationClient } from '../integrations/integration-client';
+import { type CodeIntentionRegistry } from '../intention/code-intention';
+import { type AgentNodeRegistry } from '../node/agent-node';
+import type { ChannelToolResult } from '../channel/channel-tools';
+import type { TurnExecutionResult } from './supervisor.types';
+export type { TurnExecutionResult } from './supervisor.types';
+/**
+ * Nest facade for turn orchestration.
+ *
+ * Implementation is split across focused modules assembled by
+ * `createSupervisorEngine`:
+ * - `supervisor-orchestration` — handleTurn / executeTurn
+ * - `supervisor-limits` — max turns / duration fail-closed endCall
+ * - `supervisor-special-turns` — opening / module entry / tool-result
+ * - `supervisor-cascade` — force / match / Brain candidates
+ * - `supervisor-route` — walk candidates → node
+ * - `supervisor-portal` — continue / unknown-origin consume
+ * - `supervisor-node-exec` — listen/run/catch + portal enter/exit
+ */
+export declare class Supervisor {
+    private readonly engine;
+    constructor(brain: BrainService, flowLoader: FlowLoader, nodes: AgentNodeRegistry, events: EventService, bootstrap: ConversationBootstrapService, integrations?: IntegrationClient, forms?: FormsService, brainConfig?: StudioBrainConfig, intentions?: CodeIntentionRegistry, conversationLimits?: ResolvedConversationLimits);
+    handleTurn(input: {
+        runtime: SupervisedConversation;
+        userText: string;
+        /** Channel tool results from this Custom LLM request (`role:tool`). */
+        toolResults?: ChannelToolResult[];
+        /**
+         * Force a known intention (idle portal, synthetic still-there, …)
+         * without Brain scan.
+         */
+        forceIntention?: string;
+        onSay?: (text: string) => Promise<void>;
+    }): Promise<TurnExecutionResult>;
+}
+//# sourceMappingURL=supervisor.d.ts.map

package/dist/supervisor/supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../src/supervisor/supervisor.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AAC9F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAKlE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,qBACa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAGjB,KAAK,EAAE,YAAY,EAC1C,UAAU,EAAE,UAAU,EACQ,KAAK,EAAE,iBAAiB,EACtD,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,4BAA4B,EAC3B,YAAY,CAAC,EAAE,iBAAiB,EAChC,KAAK,CAAC,EAAE,YAAY,EAGhC,WAAW,CAAC,EAAE,iBAAiB,EAG/B,UAAU,CAAC,EAAE,qBAAqB,EAGlC,kBAAkB,CAAC,EAAE,0BAA0B;IAgBpC,UAAU,CAAC,KAAK,EAAE;QAC7B,OAAO,EAAE,sBAAsB,CAAC;QAChC,QAAQ,EAAE,MAAM,CAAC;QACjB,uEAAuE;QACvE,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;QAClC;;;WAGG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACzC,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAGjC"}

package/dist/supervisor/supervisor.js

@@ -0,0 +1,79 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Supervisor = void 0;
+const common_1 = require("@nestjs/common");
+const brain_service_1 = require("../brain/brain.service");
+const brain_config_1 = require("../brain/brain-config");
+const conversation_limits_1 = require("../conversation/conversation-limits");
+const conversation_bootstrap_service_1 = require("../conversation/conversation-bootstrap.service");
+const event_service_1 = require("../events/event.service");
+const forms_service_1 = require("../forms/forms.service");
+const flow_loader_1 = require("../flow/flow-loader");
+const integration_client_1 = require("../integrations/integration-client");
+const code_intention_1 = require("../intention/code-intention");
+const agent_node_1 = require("../node/agent-node");
+const supervisor_engine_1 = require("./supervisor-engine");
+/**
+ * Nest facade for turn orchestration.
+ *
+ * Implementation is split across focused modules assembled by
+ * `createSupervisorEngine`:
+ * - `supervisor-orchestration` — handleTurn / executeTurn
+ * - `supervisor-limits` — max turns / duration fail-closed endCall
+ * - `supervisor-special-turns` — opening / module entry / tool-result
+ * - `supervisor-cascade` — force / match / Brain candidates
+ * - `supervisor-route` — walk candidates → node
+ * - `supervisor-portal` — continue / unknown-origin consume
+ * - `supervisor-node-exec` — listen/run/catch + portal enter/exit
+ */
+let Supervisor = class Supervisor {
+    engine;
+    constructor(brain, flowLoader, nodes, events, bootstrap, integrations, forms, brainConfig, intentions, conversationLimits) {
+        this.engine = (0, supervisor_engine_1.createSupervisorEngine)({
+            brain,
+            flowLoader,
+            nodes,
+            events,
+            bootstrap,
+            integrations,
+            forms,
+            brainConfig,
+            intentions,
+            conversationLimits,
+        });
+    }
+    async handleTurn(input) {
+        return this.engine.handleTurn(input);
+    }
+};
+exports.Supervisor = Supervisor;
+exports.Supervisor = Supervisor = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(brain_service_1.BRAIN_SERVICE)),
+    __param(2, (0, common_1.Inject)(agent_node_1.STUDIO_NODE_REGISTRY)),
+    __param(5, (0, common_1.Optional)()),
+    __param(6, (0, common_1.Optional)()),
+    __param(7, (0, common_1.Optional)()),
+    __param(7, (0, common_1.Inject)(brain_config_1.STUDIO_BRAIN_CONFIG)),
+    __param(8, (0, common_1.Optional)()),
+    __param(8, (0, common_1.Inject)(code_intention_1.STUDIO_INTENTION_REGISTRY)),
+    __param(9, (0, common_1.Optional)()),
+    __param(9, (0, common_1.Inject)(conversation_limits_1.STUDIO_CONVERSATION_LIMITS)),
+    __metadata("design:paramtypes", [Object, flow_loader_1.FlowLoader, Object, event_service_1.EventService,
+        conversation_bootstrap_service_1.ConversationBootstrapService,
+        integration_client_1.IntegrationClient,
+        forms_service_1.FormsService, Object, Object, Object])
+], Supervisor);
+//# sourceMappingURL=supervisor.js.map

package/dist/supervisor/supervisor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.js","sourceRoot":"","sources":["../../src/supervisor/supervisor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA8D;AAC9D,0DAGgC;AAChC,wDAG+B;AAC/B,6EAG6C;AAC7C,mGAA8F;AAE9F,2DAAuD;AACvD,0DAAsD;AACtD,qDAAiD;AACjD,2EAAuE;AACvE,gEAGqC;AACrC,mDAG4B;AAE5B,2DAG6B;AAK7B;;;;;;;;;;;;GAYG;AAEI,IAAM,UAAU,GAAhB,MAAM,UAAU;IACJ,MAAM,CAAmB;IAE1C,YACyB,KAAmB,EAC1C,UAAsB,EACQ,KAAwB,EACtD,MAAoB,EACpB,SAAuC,EAC3B,YAAgC,EAChC,KAAoB,EAGhC,WAA+B,EAG/B,UAAkC,EAGlC,kBAA+C;QAE/C,IAAI,CAAC,MAAM,GAAG,IAAA,0CAAsB,EAAC;YACnC,KAAK;YACL,UAAU;YACV,KAAK;YACL,MAAM;YACN,SAAS;YACT,YAAY;YACZ,KAAK;YACL,WAAW;YACX,UAAU;YACV,kBAAkB;SACnB,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,KAWvB;QACC,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;CACF,CAAA;AAjDY,gCAAU;qBAAV,UAAU;IADtB,IAAA,mBAAU,GAAE;IAKR,WAAA,IAAA,eAAM,EAAC,6BAAa,CAAC,CAAA;IAErB,WAAA,IAAA,eAAM,EAAC,iCAAoB,CAAC,CAAA;IAG5B,WAAA,IAAA,iBAAQ,GAAE,CAAA;IACV,WAAA,IAAA,iBAAQ,GAAE,CAAA;IACV,WAAA,IAAA,iBAAQ,GAAE,CAAA;IACV,WAAA,IAAA,eAAM,EAAC,kCAAmB,CAAC,CAAA;IAE3B,WAAA,IAAA,iBAAQ,GAAE,CAAA;IACV,WAAA,IAAA,eAAM,EAAC,0CAAyB,CAAC,CAAA;IAEjC,WAAA,IAAA,iBAAQ,GAAE,CAAA;IACV,WAAA,IAAA,eAAM,EAAC,gDAA0B,CAAC,CAAA;6CAbvB,wBAAU,UAEd,4BAAY;QACT,6DAA4B;QACZ,sCAAiB;QACxB,4BAAY;GAVvB,UAAU,CAiDtB"}

package/dist/supervisor/supervisor.types.d.ts

@@ -0,0 +1,71 @@
+import type { SupervisedConversation } from '../conversation/supervised-conversation';
+import type { NodeResult, OutputAction } from '../output/conversation-output';
+import type { BrainService } from '../brain/brain.service';
+import type { StudioBrainConfig } from '../brain/brain-config';
+import type { ResolvedConversationLimits } from '../conversation/conversation-limits';
+import type { ConversationBootstrapService } from '../conversation/conversation-bootstrap.service';
+import type { EventService } from '../events/event.service';
+import type { FormsService } from '../forms/forms.service';
+import type { FlowLoader } from '../flow/flow-loader';
+import type { IntegrationClient } from '../integrations/integration-client';
+import type { CodeIntentionRegistry } from '../intention/code-intention';
+import type { AgentNodeRegistry } from '../node/agent-node';
+/** Max Node.catch → restartNode loops per turn. */
+export declare const MAX_NODE_RESTARTS = 2;
+/** Max forceIntention / continue hops within one turn. */
+export declare const MAX_FORCE_INTENTION_HOPS = 3;
+export interface TurnExecutionResult {
+    runtime: SupervisedConversation;
+    intentionNames: string[];
+    selectedNodeId: string;
+    selectedClass: string;
+    result: NodeResult;
+    actions: OutputAction[];
+    portalOriginRestored?: string | null;
+    extracted?: Record<string, unknown>;
+}
+/** Injectable services shared by all Supervisor method modules. */
+export interface SupervisorServices {
+    brain: BrainService;
+    flowLoader: FlowLoader;
+    nodes: AgentNodeRegistry;
+    events: EventService;
+    /** Optional in unit tests; checkpoint is try/caught. */
+    bootstrap?: ConversationBootstrapService;
+    integrations?: IntegrationClient;
+    forms?: FormsService;
+    brainConfig?: StudioBrainConfig;
+    intentions?: CodeIntentionRegistry;
+    conversationLimits?: ResolvedConversationLimits;
+}
+/**
+ * Full engine: services + methods from focused modules.
+ * `import()` type queries avoid runtime circular deps.
+ */
+export type SupervisorEngine = SupervisorServices & {
+    handleTurn: typeof import('./supervisor-orchestration').handleTurn;
+    executeTurn: typeof import('./supervisor-orchestration').executeTurn;
+    enforceConversationLimits: typeof import('./supervisor-limits').enforceConversationLimits;
+    executeModuleEntryTurn: typeof import('./supervisor-special-turns').executeModuleEntryTurn;
+    executeOpeningTurn: typeof import('./supervisor-special-turns').executeOpeningTurn;
+    executeToolResultTurn: typeof import('./supervisor-special-turns').executeToolResultTurn;
+    routeIntentions: typeof import('./supervisor-route').routeIntentions;
+    resolveViaForWinner: typeof import('./supervisor-route').resolveViaForWinner;
+    emitRouteDecision: typeof import('./supervisor-route').emitRouteDecision;
+    isContinueNode: typeof import('./supervisor-portal').isContinueNode;
+    isStillThereNode: typeof import('./supervisor-portal').isStillThereNode;
+    isUnknownPortalActive: typeof import('./supervisor-portal').isUnknownPortalActive;
+    tryUnknownOriginConsume: typeof import('./supervisor-portal').tryUnknownOriginConsume;
+    resolveOriginListenForReplay: typeof import('./supervisor-portal').resolveOriginListenForReplay;
+    replayOriginAfterContinue: typeof import('./supervisor-portal').replayOriginAfterContinue;
+    executeNodeWithCatch: typeof import('./supervisor-node-exec').executeNodeWithCatch;
+    stampListenTimeout: typeof import('./supervisor-node-exec').stampListenTimeout;
+    enterPortal: typeof import('./supervisor-node-exec').enterPortal;
+    enterNormal: typeof import('./supervisor-node-exec').enterNormal;
+    stampPendingToolNode: typeof import('./supervisor-node-exec').stampPendingToolNode;
+    intentionList: typeof import('./supervisor-cascade').intentionList;
+    tryForceIntentions: typeof import('./supervisor-cascade').tryForceIntentions;
+    tryMatchIntentions: typeof import('./supervisor-cascade').tryMatchIntentions;
+    buildBrainCandidates: typeof import('./supervisor-cascade').buildBrainCandidates;
+};
+//# sourceMappingURL=supervisor.types.d.ts.map

package/dist/supervisor/supervisor.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.types.d.ts","sourceRoot":"","sources":["../../src/supervisor/supervisor.types.ts"],"names":[],"mappings":"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"}

package/dist/supervisor/supervisor.types.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_FORCE_INTENTION_HOPS = exports.MAX_NODE_RESTARTS = void 0;
+/** Max Node.catch → restartNode loops per turn. */
+exports.MAX_NODE_RESTARTS = 2;
+/** Max forceIntention / continue hops within one turn. */
+exports.MAX_FORCE_INTENTION_HOPS = 3;
+//# sourceMappingURL=supervisor.types.js.map

package/dist/supervisor/supervisor.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.types.js","sourceRoot":"","sources":["../../src/supervisor/supervisor.types.ts"],"names":[],"mappings":";;;AAaA,mDAAmD;AACtC,QAAA,iBAAiB,GAAG,CAAC,CAAC;AAEnC,0DAA0D;AAC7C,QAAA,wBAAwB,GAAG,CAAC,CAAC"}

package/dist/tasks/studio-task-queue.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Studio Task Queue — work counterpart to CallTurnQueue.
+ *
+ * Dispatch I/O as wait (block the node turn) or async (return immediately;
+ * speech phrase pool still buffers user talk). Dedupe by key while a task is
+ * pending/running. Later nodes can `require` a prior async task (postponed debt).
+ *
+ * The queue is conversation-scoped (stored on SupervisedConversation.metadata)
+ * so async work survives node transitions.
+ */
+import type { EventService } from '../events/event.service';
+import type { SupervisedConversation } from '../conversation/supervised-conversation';
+/** Runtime metadata key for the conversation-scoped task queue. */
+export declare const STUDIO_TASK_QUEUE_META = "__studioTaskQueue";
+export declare const STUDIO_TASK_EVENTS: {
+    readonly TASK_ENQUEUED: "TASK_ENQUEUED";
+    readonly TASK_STARTED: "TASK_STARTED";
+    readonly TASK_COMPLETED: "TASK_COMPLETED";
+    readonly TASK_FAILED: "TASK_FAILED";
+    readonly TASK_DEDUPED: "TASK_DEDUPED";
+    /** A later node is waiting on a previously dispatched task. */
+    readonly TASK_AWAITED: "TASK_AWAITED";
+};
+export type StudioTaskMode = 'wait' | 'async';
+export type StudioTaskStatus = 'pending' | 'running' | 'completed' | 'failed';
+export interface StudioTaskSpec<TResult = unknown> {
+    kind: string;
+    run: () => Promise<TResult>;
+    /**
+     * Stable key for dedupe + cross-node `require`.
+     * While pending/running, same key returns the existing handle.
+     * After complete/fail, `require(key)` still resolves that result until a
+     * new dispatch overwrites the key.
+     */
+    dedupeKey?: string;
+    mode?: StudioTaskMode;
+    payload?: Record<string, unknown>;
+}
+export interface StudioTaskHandle<TResult = unknown> {
+    taskId: string;
+    kind: string;
+    dedupeKey?: string;
+    mode: StudioTaskMode;
+    status: StudioTaskStatus;
+    /** Resolves when the task finishes (success or throw). */
+    result: Promise<TResult>;
+}
+export type StudioTaskRequireRef = string | {
+    taskId?: string;
+    dedupeKey?: string;
+};
+export interface StudioTasksApi {
+    dispatch: <TResult = unknown>(spec: StudioTaskSpec<TResult>) => Promise<StudioTaskHandle<TResult>>;
+    get: (taskId: string) => StudioTaskHandle | undefined;
+    getByKey: (dedupeKey: string) => StudioTaskHandle | undefined;
+    /** Await a previously dispatched task by id. */
+    await: <TResult = unknown>(taskId: string) => Promise<TResult>;
+    /**
+     * Dependency / postponed debt: wait for a task started earlier (often async
+     * in a previous node). Pass `dedupeKey` and/or `taskId`.
+     */
+    require: <TResult = unknown>(ref: StudioTaskRequireRef) => Promise<TResult>;
+}
+export declare class StudioTaskQueue {
+    private readonly events?;
+    private readonly meta?;
+    private readonly byId;
+    /** Latest task id for each dedupe key (kept after complete/fail for require). */
+    private readonly byDedupe;
+    constructor(events?: EventService | undefined, meta?: {
+        conversationId?: string;
+        runtimeInstanceId?: string;
+        nodeId?: string;
+    } | undefined);
+    api(): StudioTasksApi;
+    dispatch<TResult>(spec: StudioTaskSpec<TResult>): Promise<StudioTaskHandle<TResult>>;
+    require<TResult>(ref: StudioTaskRequireRef): Promise<TResult>;
+    private resolveRefToTaskId;
+    private emit;
+}
+/** Get or create the conversation-scoped queue on the runtime. */
+export declare function studioTaskQueueForRuntime(runtime: SupervisedConversation, events?: EventService): StudioTaskQueue;
+/** Build a tasks API bound to the conversation-scoped queue. */
+export declare function createStudioTasksApi(input: {
+    events?: EventService;
+    conversationId?: string;
+    runtimeInstanceId?: string;
+    nodeId?: string;
+    runtime?: SupervisedConversation;
+    /** Optional shared queue so async tasks survive across turns. */
+    queue?: StudioTaskQueue;
+}): StudioTasksApi;
+//# sourceMappingURL=studio-task-queue.d.ts.map

package/dist/tasks/studio-task-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-task-queue.d.ts","sourceRoot":"","sources":["../../src/tasks/studio-task-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAEtF,mEAAmE;AACnE,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAE1D,eAAO,MAAM,kBAAkB;;;;;;IAM7B,+DAA+D;;CAEvD,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC;AAE9C,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,CAAC;AAEb,MAAM,WAAW,cAAc,CAAC,OAAO,GAAG,OAAO;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB,CAAC,OAAO,GAAG,OAAO;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,0DAA0D;IAC1D,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B;AAED,MAAM,MAAM,oBAAoB,GAC5B,MAAM,GACN;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,CAAC,OAAO,GAAG,OAAO,EAC1B,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,KAC1B,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IACxC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAC;IACtD,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAC;IAC9D,gDAAgD;IAChD,KAAK,EAAE,CAAC,OAAO,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D;;;OAGG;IACH,OAAO,EAAE,CAAC,OAAO,GAAG,OAAO,EAAE,GAAG,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7E;AAQD,qBAAa,eAAe;IAMxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IANxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwC;IAC7D,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;gBAGxC,MAAM,CAAC,EAAE,YAAY,YAAA,EACrB,IAAI,CAAC,EAAE;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,YAAA;IAGI,GAAG,IAAI,cAAc;IAaf,QAAQ,CAAC,OAAO,EAC3B,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,GAC5B,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IA4GxB,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAyB1E,OAAO,CAAC,kBAAkB;YAmBZ,IAAI;CAUnB;AAED,kEAAkE;AAClE,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,sBAAsB,EAC/B,MAAM,CAAC,EAAE,YAAY,GACpB,eAAe,CAWjB;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,iEAAiE;IACjE,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB,GAAG,cAAc,CAWjB"}

package/dist/tasks/studio-task-queue.js

@@ -0,0 +1,226 @@
+"use strict";
+/**
+ * Studio Task Queue — work counterpart to CallTurnQueue.
+ *
+ * Dispatch I/O as wait (block the node turn) or async (return immediately;
+ * speech phrase pool still buffers user talk). Dedupe by key while a task is
+ * pending/running. Later nodes can `require` a prior async task (postponed debt).
+ *
+ * The queue is conversation-scoped (stored on SupervisedConversation.metadata)
+ * so async work survives node transitions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StudioTaskQueue = exports.STUDIO_TASK_EVENTS = exports.STUDIO_TASK_QUEUE_META = void 0;
+exports.studioTaskQueueForRuntime = studioTaskQueueForRuntime;
+exports.createStudioTasksApi = createStudioTasksApi;
+const crypto_1 = require("crypto");
+/** Runtime metadata key for the conversation-scoped task queue. */
+exports.STUDIO_TASK_QUEUE_META = '__studioTaskQueue';
+exports.STUDIO_TASK_EVENTS = {
+    TASK_ENQUEUED: 'TASK_ENQUEUED',
+    TASK_STARTED: 'TASK_STARTED',
+    TASK_COMPLETED: 'TASK_COMPLETED',
+    TASK_FAILED: 'TASK_FAILED',
+    TASK_DEDUPED: 'TASK_DEDUPED',
+    /** A later node is waiting on a previously dispatched task. */
+    TASK_AWAITED: 'TASK_AWAITED',
+};
+class StudioTaskQueue {
+    events;
+    meta;
+    byId = new Map();
+    /** Latest task id for each dedupe key (kept after complete/fail for require). */
+    byDedupe = new Map();
+    constructor(events, meta) {
+        this.events = events;
+        this.meta = meta;
+    }
+    api() {
+        return {
+            dispatch: (spec) => this.dispatch(spec),
+            get: (taskId) => this.byId.get(taskId)?.handle,
+            getByKey: (dedupeKey) => {
+                const id = this.byDedupe.get(dedupeKey.trim());
+                return id ? this.byId.get(id)?.handle : undefined;
+            },
+            await: (taskId) => this.require({ taskId }),
+            require: (ref) => this.require(ref),
+        };
+    }
+    async dispatch(spec) {
+        const mode = spec.mode ?? 'wait';
+        const dedupeKey = spec.dedupeKey?.trim() || undefined;
+        if (dedupeKey) {
+            const existingId = this.byDedupe.get(dedupeKey);
+            if (existingId) {
+                const existing = this.byId.get(existingId);
+                if (existing &&
+                    (existing.handle.status === 'pending' ||
+                        existing.handle.status === 'running')) {
+                    await this.emit(exports.STUDIO_TASK_EVENTS.TASK_DEDUPED, {
+                        taskId: existing.handle.taskId,
+                        kind: existing.handle.kind,
+                        dedupeKey,
+                        mode: existing.handle.mode,
+                        status: existing.handle.status,
+                    });
+                    return existing.handle;
+                }
+            }
+        }
+        const taskId = (0, crypto_1.randomUUID)();
+        let resolve;
+        let reject;
+        const result = new Promise((res, rej) => {
+            resolve = (v) => res(v);
+            reject = rej;
+        });
+        const handle = {
+            taskId,
+            kind: spec.kind,
+            dedupeKey,
+            mode,
+            status: 'pending',
+            result,
+        };
+        const entry = {
+            handle: handle,
+            resolve,
+            reject,
+        };
+        this.byId.set(taskId, entry);
+        if (dedupeKey)
+            this.byDedupe.set(dedupeKey, taskId);
+        await this.emit(exports.STUDIO_TASK_EVENTS.TASK_ENQUEUED, {
+            taskId,
+            kind: spec.kind,
+            dedupeKey: dedupeKey ?? null,
+            mode,
+            payload: spec.payload ?? null,
+            nodeId: this.meta?.nodeId ?? null,
+        });
+        const runWork = async () => {
+            handle.status = 'running';
+            entry.handle.status = 'running';
+            const started = Date.now();
+            await this.emit(exports.STUDIO_TASK_EVENTS.TASK_STARTED, {
+                taskId,
+                kind: spec.kind,
+                dedupeKey: dedupeKey ?? null,
+                mode,
+            });
+            try {
+                const value = await spec.run();
+                handle.status = 'completed';
+                entry.handle.status = 'completed';
+                resolve(value);
+                await this.emit(exports.STUDIO_TASK_EVENTS.TASK_COMPLETED, {
+                    taskId,
+                    kind: spec.kind,
+                    dedupeKey: dedupeKey ?? null,
+                    mode,
+                    durationMs: Date.now() - started,
+                });
+                return value;
+            }
+            catch (err) {
+                handle.status = 'failed';
+                entry.handle.status = 'failed';
+                const reason = err instanceof Error ? err.message : String(err);
+                reject(err);
+                await this.emit(exports.STUDIO_TASK_EVENTS.TASK_FAILED, {
+                    taskId,
+                    kind: spec.kind,
+                    dedupeKey: dedupeKey ?? null,
+                    mode,
+                    durationMs: Date.now() - started,
+                    reason,
+                });
+                throw err;
+            }
+        };
+        if (mode === 'wait') {
+            await runWork();
+            return handle;
+        }
+        void runWork().catch(() => undefined);
+        return handle;
+    }
+    async require(ref) {
+        const taskId = typeof ref === 'string'
+            ? this.resolveRefToTaskId(ref)
+            : this.resolveRefToTaskId(ref.taskId, ref.dedupeKey);
+        const entry = this.byId.get(taskId);
+        if (!entry) {
+            throw new Error(`Unknown studio task (require): ${taskId}`);
+        }
+        const waiting = entry.handle.status === 'pending' || entry.handle.status === 'running';
+        if (waiting) {
+            await this.emit(exports.STUDIO_TASK_EVENTS.TASK_AWAITED, {
+                taskId: entry.handle.taskId,
+                kind: entry.handle.kind,
+                dedupeKey: entry.handle.dedupeKey ?? null,
+                status: entry.handle.status,
+                nodeId: this.meta?.nodeId ?? null,
+            });
+        }
+        return entry.handle.result;
+    }
+    resolveRefToTaskId(taskId, dedupeKey) {
+        const id = typeof taskId === 'string' ? taskId.trim() : '';
+        if (id && this.byId.has(id))
+            return id;
+        const key = typeof dedupeKey === 'string' ? dedupeKey.trim() : '';
+        // Plain string ref: treat as dedupeKey first, then taskId.
+        if (!key && id) {
+            const byKey = this.byDedupe.get(id);
+            if (byKey)
+                return byKey;
+            if (this.byId.has(id))
+                return id;
+            throw new Error(`Unknown studio task ref: ${id}`);
+        }
+        if (key) {
+            const byKey = this.byDedupe.get(key);
+            if (byKey)
+                return byKey;
+            throw new Error(`Unknown studio task dedupeKey: ${key}`);
+        }
+        throw new Error('require() needs taskId or dedupeKey');
+    }
+    async emit(type, payload) {
+        if (!this.events || !this.meta?.conversationId)
+            return;
+        await this.events.persist(this.meta.conversationId, type, {
+            ...payload,
+            runtimeInstanceId: this.meta.runtimeInstanceId ?? null,
+        });
+    }
+}
+exports.StudioTaskQueue = StudioTaskQueue;
+/** Get or create the conversation-scoped queue on the runtime. */
+function studioTaskQueueForRuntime(runtime, events) {
+    const existing = runtime.metadata[exports.STUDIO_TASK_QUEUE_META];
+    if (existing instanceof StudioTaskQueue) {
+        return existing;
+    }
+    const queue = new StudioTaskQueue(events, {
+        conversationId: runtime.conversationId,
+        runtimeInstanceId: runtime.runtimeInstanceId,
+    });
+    runtime.metadata[exports.STUDIO_TASK_QUEUE_META] = queue;
+    return queue;
+}
+/** Build a tasks API bound to the conversation-scoped queue. */
+function createStudioTasksApi(input) {
+    const queue = input.queue ??
+        (input.runtime
+            ? studioTaskQueueForRuntime(input.runtime, input.events)
+            : new StudioTaskQueue(input.events, {
+                conversationId: input.conversationId,
+                runtimeInstanceId: input.runtimeInstanceId,
+                nodeId: input.nodeId,
+            }));
+    return queue.api();
+}
+//# sourceMappingURL=studio-task-queue.js.map

package/dist/tasks/studio-task-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-task-queue.js","sourceRoot":"","sources":["../../src/tasks/studio-task-queue.ts"],"names":[],"mappings":"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"}

package/dist/util/studio-env.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Studio env helpers. Prefer `STUDIO_*` names in apps and docs.
+ */
+export declare function envFlag(primary: string, legacy: string | undefined, defaultOn: boolean): boolean;
+export declare function envString(primary: string, legacy: string | undefined, fallback: string): string;
+export declare function envNumber(primary: string, legacy: string | undefined, fallback: number): number;
+//# sourceMappingURL=studio-env.d.ts.map

package/dist/util/studio-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-env.d.ts","sourceRoot":"","sources":["../../src/util/studio-env.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,SAAS,EAAE,OAAO,GACjB,OAAO,CAYT;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,EAAE,MAAM,GACf,MAAM,CAKR;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,EAAE,MAAM,GACf,MAAM,CAIR"}

package/dist/util/studio-env.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.envFlag = envFlag;
+exports.envString = envString;
+exports.envNumber = envNumber;
+/**
+ * Studio env helpers. Prefer `STUDIO_*` names in apps and docs.
+ */
+function envFlag(primary, legacy, defaultOn) {
+    const raw = (process.env[primary] ??
+        (legacy ? process.env[legacy] : undefined) ??
+        (defaultOn ? '1' : '0'))
+        .trim()
+        .toLowerCase();
+    if (defaultOn) {
+        return !['0', 'false', 'no', 'off'].includes(raw);
+    }
+    return ['1', 'true', 'yes', 'on'].includes(raw);
+}
+function envString(primary, legacy, fallback) {
+    const v = process.env[primary] ?? (legacy ? process.env[legacy] : undefined);
+    if (v === undefined || v === null)
+        return fallback;
+    const t = String(v).trim();
+    return t.length ? t : fallback;
+}
+function envNumber(primary, legacy, fallback) {
+    const raw = process.env[primary] ?? (legacy ? process.env[legacy] : undefined);
+    const n = Number(raw);
+    return Number.isFinite(n) && n > 0 ? n : fallback;
+}
+//# sourceMappingURL=studio-env.js.map

package/dist/util/studio-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-env.js","sourceRoot":"","sources":["../../src/util/studio-env.ts"],"names":[],"mappings":";;AAGA,0BAgBC;AAED,8BASC;AAED,8BAQC;AAxCD;;GAEG;AACH,SAAgB,OAAO,CACrB,OAAe,EACf,MAA0B,EAC1B,SAAkB;IAElB,MAAM,GAAG,GAAG,CACV,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;QACpB,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1C,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CACxB;SACE,IAAI,EAAE;SACN,WAAW,EAAE,CAAC;IACjB,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAClD,CAAC;AAED,SAAgB,SAAS,CACvB,OAAe,EACf,MAA0B,EAC1B,QAAgB;IAEhB,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7E,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC;IACnD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3B,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACjC,CAAC;AAED,SAAgB,SAAS,CACvB,OAAe,EACf,MAA0B,EAC1B,QAAgB;IAEhB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC/E,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACpD,CAAC"}