@guidify-ai/vapi-studio 0.1.0

package/dist/supervisor/supervisor-cascade.js

@@ -0,0 +1,261 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.intentionList = intentionList;
+exports.tryForceIntentions = tryForceIntentions;
+exports.tryMatchIntentions = tryMatchIntentions;
+exports.buildBrainCandidates = buildBrainCandidates;
+const conversation_history_1 = require("../conversation/conversation-history");
+const standard_intentions_1 = require("../intentions/standard-intentions");
+const code_intention_1 = require("../intention/code-intention");
+const conversation_output_1 = require("../output/conversation-output");
+const flow_loader_1 = require("../flow/flow-loader");
+const conversation_console_1 = require("../events/conversation-console");
+function intentionList() {
+    return this.intentions ? [...this.intentions.values()] : [];
+}
+/**
+ * phase: 'force' — before listen/Brain. First before()===true wins (registry order).
+ */
+/**
+ * phase: 'force' — before listen/Brain. First before()===true wins (registry order).
+ */
+async function tryForceIntentions(input) {
+    const forceList = this.intentionList().filter((i) => i.phase === code_intention_1.INTENTION_CASCADE_PHASE.Force);
+    if (!forceList.length)
+        return null;
+    const ctx = (0, code_intention_1.intentionContextFromRuntime)({
+        runtime: input.runtime,
+        userText: input.userText,
+        events: this.events,
+    });
+    const output = new conversation_output_1.BufferedConversationOutput(input.onSay);
+    for (const intention of forceList) {
+        const ok = await intention.before(ctx);
+        if (!ok)
+            continue;
+        const confidence = (await intention.match(ctx)) ?? 1;
+        const runResult = await intention.run(ctx);
+        await intention.after(ctx);
+        const gotoNodeId = runResult?.kind === code_intention_1.INTENTION_RUN_KIND.Goto
+            ? runResult.nodeId
+            : intention.toNodeId ?? null;
+        const reason = (runResult && 'reason' in runResult ? runResult.reason : undefined) ??
+            intention.reason ??
+            null;
+        const payload = {
+            conversationId: input.runtime.conversationId,
+            runtimeInstanceId: input.runtime.runtimeInstanceId,
+            providerCallId: input.runtime.providerCallId,
+            turnNumber: input.runtime.turn.turnNumber,
+            intention: intention.name,
+            phase: code_intention_1.INTENTION_CASCADE_PHASE.Force,
+            from: input.runtime.currentNodeId,
+            to: gotoNodeId,
+            confidence,
+            priority: intention.priority,
+            boost: intention.boost,
+            reason,
+            userText: input.userText,
+            memory: (0, conversation_console_1.snapshotUserMemory)(input.runtime.memory),
+        };
+        if (input.runtime.conversationId) {
+            await this.events.persist(input.runtime.conversationId, 'INTENTION_FORCE', payload);
+        }
+        else {
+            this.events.log('info', 'INTENTION_FORCE', payload);
+        }
+        const rankedName = gotoNodeId
+            ? (0, flow_loader_1.conditionGotoIntention)(gotoNodeId)
+            : intention.name;
+        const ranked = [
+            {
+                name: rankedName,
+                confidence: Math.min(1, Math.max(0, confidence)),
+                priority: intention.priority || 1_000_000,
+                rank: 0,
+            },
+        ];
+        const routed = await this.routeIntentions({
+            runtime: input.runtime,
+            userText: input.userText,
+            output,
+            ranked,
+            forceHop: 0,
+            resolvedVia: code_intention_1.ROUTE_RESOLVED_VIA.IntentionForce,
+            allowMiss: true,
+        });
+        if (!routed) {
+            this.events.log('warn', 'INTENTION_FORCE_MISSED', {
+                ...payload,
+                note: 'force intention matched but no node accepted before()',
+            });
+            continue;
+        }
+        this.stampPendingToolNode(input.runtime, routed.result, routed.selectedNodeId);
+        return {
+            runtime: input.runtime,
+            intentionNames: [intention.name],
+            selectedNodeId: routed.selectedNodeId,
+            selectedClass: routed.selectedClass,
+            result: routed.result,
+            actions: output.actions,
+            portalOriginRestored: routed.portalOriginRestored,
+        };
+    }
+    return null;
+}
+/**
+ * phase: 'match' — local confidence; may skip Brain. goto from run() routes now.
+ */
+/**
+ * phase: 'match' — local confidence; may skip Brain. goto from run() routes now.
+ */
+async function tryMatchIntentions(input) {
+    const matchList = this.intentionList().filter((i) => i.phase === code_intention_1.INTENTION_CASCADE_PHASE.Match);
+    if (!matchList.length)
+        return null;
+    const ctx = (0, code_intention_1.intentionContextFromRuntime)({
+        runtime: input.runtime,
+        userText: input.userText,
+        events: this.events,
+    });
+    for (const intention of matchList) {
+        const ok = await intention.before(ctx);
+        if (!ok)
+            continue;
+        const matched = await intention.match(ctx);
+        if (matched == null)
+            continue;
+        const confidence = Math.min(1, Math.max(0, matched));
+        if (confidence < input.confidenceThreshold)
+            continue;
+        const runResult = await intention.run(ctx);
+        await intention.after(ctx);
+        this.events.log('info', 'INTENTION_MATCH', {
+            conversationId: input.runtime.conversationId,
+            runtimeInstanceId: input.runtime.runtimeInstanceId,
+            turnNumber: input.runtime.turn.turnNumber,
+            intention: intention.name,
+            confidence,
+            run: runResult,
+            userText: input.userText,
+        });
+        const gotoNodeId = runResult?.kind === code_intention_1.INTENTION_RUN_KIND.Goto
+            ? runResult.nodeId
+            : intention.toNodeId ?? null;
+        if (gotoNodeId) {
+            const output = new conversation_output_1.BufferedConversationOutput(input.onSay);
+            const routed = await this.routeIntentions({
+                runtime: input.runtime,
+                userText: input.userText,
+                output,
+                ranked: [
+                    {
+                        name: (0, flow_loader_1.conditionGotoIntention)(gotoNodeId),
+                        confidence,
+                        priority: intention.priority || 1_000_000,
+                        rank: 0,
+                    },
+                ],
+                forceHop: 0,
+                resolvedVia: code_intention_1.ROUTE_RESOLVED_VIA.IntentionMatch,
+                allowMiss: true,
+            });
+            if (routed) {
+                this.stampPendingToolNode(input.runtime, routed.result, routed.selectedNodeId);
+                return {
+                    kind: 'routed',
+                    result: {
+                        runtime: input.runtime,
+                        intentionNames: [intention.name],
+                        selectedNodeId: routed.selectedNodeId,
+                        selectedClass: routed.selectedClass,
+                        result: routed.result,
+                        actions: output.actions,
+                        portalOriginRestored: routed.portalOriginRestored,
+                    },
+                };
+            }
+        }
+        return { kind: 'score', name: intention.name, confidence };
+    }
+    return null;
+}
+/**
+ * Limited Brain candidate set for this listen:
+ * - listen-prioritized next-node intentions (with boost + priority)
+ * - registered CodeIntention boost/priority overlays
+ * - all portal intentions (except: while in `mad`, only the mad portal — sticky)
+ * - studio.isUnknownTransition (scan-failure global; not while sticky mad)
+ * - if no listen yet: all normal-flow intentions + portals
+ */
+/**
+ * Limited Brain candidate set for this listen:
+ * - listen-prioritized next-node intentions (with boost + priority)
+ * - registered CodeIntention boost/priority overlays
+ * - all portal intentions (except: while in `mad`, only the mad portal — sticky)
+ * - studio.isUnknownTransition (scan-failure global; not while sticky mad)
+ * - if no listen yet: all normal-flow intentions + portals
+ */
+function buildBrainCandidates(listen, runtime) {
+    const byName = new Map();
+    const upsert = (option) => {
+        const existing = byName.get(option.name);
+        if (!existing) {
+            byName.set(option.name, {
+                ...option,
+                priority: option.priority ?? conversation_history_1.DEFAULT_INTENTION_PRIORITY,
+            });
+            return;
+        }
+        byName.set(option.name, {
+            ...existing,
+            boost: Math.max(existing.boost ?? 0, option.boost ?? 0),
+            priority: Math.max(existing.priority ?? conversation_history_1.DEFAULT_INTENTION_PRIORITY, option.priority ?? conversation_history_1.DEFAULT_INTENTION_PRIORITY),
+            source: existing.source === 'listen' ? 'listen' : option.source,
+        });
+    };
+    for (const intent of listen?.intentions ?? []) {
+        upsert({
+            name: intent.name,
+            boost: intent.boost,
+            priority: intent.priority,
+            source: 'listen',
+        });
+    }
+    for (const intention of this.intentionList()) {
+        if (intention.phase === code_intention_1.INTENTION_CASCADE_PHASE.Force)
+            continue;
+        upsert({
+            name: intention.name,
+            boost: intention.boost,
+            priority: intention.priority,
+            source: 'runtime',
+        });
+    }
+    const stickyMad = runtime?.portalState.activePortalId === 'mad';
+    const madIntentionNames = stickyMad
+        ? new Set(this.flowLoader.getFlow().nodes.mad?.intentions ?? [])
+        : null;
+    for (const name of this.flowLoader.portalIntentionNames()) {
+        if (madIntentionNames && !madIntentionNames.has(name)) {
+            continue;
+        }
+        upsert({ name, source: 'portal' });
+    }
+    if (!listen?.intentions?.length) {
+        for (const name of this.flowLoader.normalIntentionNames()) {
+            upsert({ name, source: 'flow' });
+        }
+    }
+    if (!stickyMad) {
+        upsert({
+            name: standard_intentions_1.STANDARD_INTENTIONS.isUnknownTransition,
+            boost: 0,
+            priority: 0,
+            source: 'runtime',
+        });
+    }
+    return [...byName.values()];
+}
+//# sourceMappingURL=supervisor-cascade.js.map

package/dist/supervisor/supervisor-cascade.js.map

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

package/dist/supervisor/supervisor-engine.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Assembled Supervisor runtime — Nest `Supervisor` is a thin DI facade over this.
+ * Methods live in focused modules and bind onto one engine object so cascade ↔
+ * route ↔ portal can call each other without circular Nest providers.
+ */
+import type { SupervisorEngine, SupervisorServices } from './supervisor.types';
+export type { SupervisorEngine, SupervisorServices } from './supervisor.types';
+export declare function createSupervisorEngine(services: SupervisorServices): SupervisorEngine;
+//# sourceMappingURL=supervisor-engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-engine.d.ts","sourceRoot":"","sources":["../../src/supervisor/supervisor-engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAU/E,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAY/E,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,kBAAkB,GAC3B,gBAAgB,CAWlB"}

package/dist/supervisor/supervisor-engine.js

@@ -0,0 +1,64 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSupervisorEngine = createSupervisorEngine;
+const orchestration = __importStar(require("./supervisor-orchestration"));
+const limits = __importStar(require("./supervisor-limits"));
+const specialTurns = __importStar(require("./supervisor-special-turns"));
+const route = __importStar(require("./supervisor-route"));
+const portal = __importStar(require("./supervisor-portal"));
+const nodeExec = __importStar(require("./supervisor-node-exec"));
+const cascade = __importStar(require("./supervisor-cascade"));
+const methodBags = [
+    orchestration,
+    limits,
+    specialTurns,
+    route,
+    portal,
+    nodeExec,
+    cascade,
+];
+function createSupervisorEngine(services) {
+    const engine = { ...services };
+    for (const bag of methodBags) {
+        for (const [name, fn] of Object.entries(bag)) {
+            if (typeof fn !== 'function')
+                continue;
+            engine[name] = fn.bind(engine);
+        }
+    }
+    return engine;
+}
+//# sourceMappingURL=supervisor-engine.js.map

package/dist/supervisor/supervisor-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-engine.js","sourceRoot":"","sources":["../../src/supervisor/supervisor-engine.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,wDAaC;AAjCD,0EAA4D;AAC5D,4DAA8C;AAC9C,yEAA2D;AAC3D,0DAA4C;AAC5C,4DAA8C;AAC9C,iEAAmD;AACnD,8DAAgD;AAIhD,MAAM,UAAU,GAAG;IACjB,aAAa;IACb,MAAM;IACN,YAAY;IACZ,KAAK;IACL,MAAM;IACN,QAAQ;IACR,OAAO;CACC,CAAC;AAEX,SAAgB,sBAAsB,CACpC,QAA4B;IAE5B,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAsB,CAAC;IACnD,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,IAAI,OAAO,EAAE,KAAK,UAAU;gBAAE,SAAS;YACtC,MAA6C,CAAC,IAAI,CAAC,GAClD,EACD,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/supervisor/supervisor-limits.d.ts

@@ -0,0 +1,8 @@
+import type { SupervisedConversation } from '../conversation/supervised-conversation';
+import type { SupervisorEngine } from './supervisor.types';
+import type { TurnExecutionResult } from './supervisor.types';
+export declare function enforceConversationLimits(this: SupervisorEngine, input: {
+    runtime: SupervisedConversation;
+    onSay?: (text: string) => Promise<void>;
+}): Promise<TurnExecutionResult | null>;
+//# sourceMappingURL=supervisor-limits.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-limits.d.ts","sourceRoot":"","sources":["../../src/supervisor/supervisor-limits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAMtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE;IAC7E,OAAO,EAAE,sBAAsB,CAAC;IAChC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAgCtC"}

package/dist/supervisor/supervisor-limits.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enforceConversationLimits = enforceConversationLimits;
+const conversation_limits_1 = require("../conversation/conversation-limits");
+const conversation_output_1 = require("../output/conversation-output");
+async function enforceConversationLimits(input) {
+    const limits = this.conversationLimits ?? (0, conversation_limits_1.resolveConversationLimits)();
+    const check = (0, conversation_limits_1.evaluateConversationLimits)({
+        turnNumber: input.runtime.turn.turnNumber,
+        createdAt: input.runtime.createdAt,
+        limits,
+    });
+    if (!check.exceeded)
+        return null;
+    const output = new conversation_output_1.BufferedConversationOutput(input.onSay);
+    const result = await output.endCall(limits.endMessage);
+    this.events.log('warn', 'CONVERSATION_LIMIT_EXCEEDED', {
+        conversationId: input.runtime.conversationId,
+        providerCallId: input.runtime.providerCallId,
+        runtimeInstanceId: input.runtime.runtimeInstanceId,
+        turnNumber: input.runtime.turn.turnNumber,
+        reason: check.reason,
+        elapsedMs: check.elapsedMs,
+        maxTurns: limits.maxTurns,
+        maxDurationMs: limits.maxDurationMs,
+    });
+    return {
+        runtime: input.runtime,
+        intentionNames: [],
+        selectedNodeId: input.runtime.currentNodeId ?? 'conversation_limit',
+        selectedClass: 'ConversationLimit',
+        result,
+        actions: output.actions,
+    };
+}
+//# sourceMappingURL=supervisor-limits.js.map

package/dist/supervisor/supervisor-limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-limits.js","sourceRoot":"","sources":["../../src/supervisor/supervisor-limits.ts"],"names":[],"mappings":";;AAUA,8DAmCC;AA5CD,6EAG6C;AAC7C,uEAA2E;AAKpE,KAAK,UAAU,yBAAyB,CAAyB,KAGvE;IACC,MAAM,MAAM,GACV,IAAI,CAAC,kBAAkB,IAAI,IAAA,+CAAyB,GAAE,CAAC;IACzD,MAAM,KAAK,GAAG,IAAA,gDAA0B,EAAC;QACvC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU;QACzC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS;QAClC,MAAM;KACP,CAAC,CAAC;IACH,IAAI,CAAC,KAAK,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAEjC,MAAM,MAAM,GAAG,IAAI,gDAA0B,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAEvD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,6BAA6B,EAAE;QACrD,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,cAAc;QAC5C,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,cAAc;QAC5C,iBAAiB,EAAE,KAAK,CAAC,OAAO,CAAC,iBAAiB;QAClD,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU;QACzC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,aAAa,EAAE,MAAM,CAAC,aAAa;KACpC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,cAAc,EAAE,EAAE;QAClB,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,aAAa,IAAI,oBAAoB;QACnE,aAAa,EAAE,mBAAmB;QAClC,MAAM;QACN,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC"}

package/dist/supervisor/supervisor-node-exec.d.ts

@@ -0,0 +1,39 @@
+import type { SupervisedConversation } from '../conversation/supervised-conversation';
+import { type NodeContext, type AgentNode } from '../node/agent-node';
+import { BufferedConversationOutput, type NodeResult } from '../output/conversation-output';
+import type { FlowNodeDefinition } from '../flow/flow-loader';
+import type { SupervisorEngine } from './supervisor.types';
+export declare function executeNodeWithCatch(this: SupervisorEngine, input: {
+    runtime: SupervisedConversation;
+    userText: string;
+    output: BufferedConversationOutput;
+    node: AgentNode;
+    candidate: FlowNodeDefinition;
+    intentionName: string;
+    ctx: NodeContext;
+    restarts: number;
+    forceHop: number;
+}): Promise<{
+    kind: 'done';
+    result: NodeResult;
+} | {
+    kind: 'forceIntention';
+    intention: string;
+}>;
+/**
+ * Stamp the resolved listen window onto the active expectation.
+ * sayAndListen timeout > listen() timeout > Node.listenTimeoutSeconds > default.
+ */
+export declare function stampListenTimeout(this: SupervisorEngine, runtime: SupervisedConversation, node: AgentNode, fromSayAndListen?: number): void;
+export declare function enterPortal(this: SupervisorEngine, runtime: SupervisedConversation, candidate: FlowNodeDefinition): string | null | undefined;
+export declare function enterNormal(this: SupervisorEngine, runtime: SupervisedConversation, candidate: FlowNodeDefinition): string | null | undefined;
+/**
+ * After a toolCall terminal action, remember which Node requested it so the
+ * next Custom LLM turn with role:tool can re-enter without Brain scan.
+ */
+/**
+ * After a toolCall terminal action, remember which Node requested it so the
+ * next Custom LLM turn with role:tool can re-enter without Brain scan.
+ */
+export declare function stampPendingToolNode(this: SupervisorEngine, runtime: SupervisedConversation, result: NodeResult, selectedNodeId: string): void;
+//# sourceMappingURL=supervisor-node-exec.d.ts.map

package/dist/supervisor/supervisor-node-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-node-exec.d.ts","sourceRoot":"","sources":["../../src/supervisor/supervisor-node-exec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAOtF,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,0BAA0B,EAC1B,KAAK,UAAU,EAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAM9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE;IACxE,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,0BAA0B,CAAC;IACnC,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,WAAW,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CACP;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAChD,CA+HA;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EACvD,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,SAAS,EACf,gBAAgB,CAAC,EAAE,MAAM,GACxB,IAAI,CAkBN;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,EAChD,OAAO,EAAE,sBAAsB,EAC/B,SAAS,EAAE,kBAAkB,GAC5B,MAAM,GAAG,IAAI,GAAG,SAAS,CA4B3B;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,EAChD,OAAO,EAAE,sBAAsB,EAC/B,SAAS,EAAE,kBAAkB,GAC5B,MAAM,GAAG,IAAI,GAAG,SAAS,CAc3B;AAED;;;GAGG;AAIH;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,EACzD,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE,UAAU,EAClB,cAAc,EAAE,MAAM,GACrB,IAAI,CAeN"}

package/dist/supervisor/supervisor-node-exec.js

@@ -0,0 +1,201 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeNodeWithCatch = executeNodeWithCatch;
+exports.stampListenTimeout = stampListenTimeout;
+exports.enterPortal = enterPortal;
+exports.enterNormal = enterNormal;
+exports.stampPendingToolNode = stampPendingToolNode;
+const conversation_history_1 = require("../conversation/conversation-history");
+const listen_expectation_1 = require("../conversation/listen-expectation");
+const listen_timeout_1 = require("../conversation/listen-timeout");
+const channel_tools_1 = require("../channel/channel-tools");
+const conversation_console_1 = require("../events/conversation-console");
+const route_forensics_1 = require("../events/route-forensics");
+const supervisor_types_1 = require("./supervisor.types");
+async function executeNodeWithCatch(input) {
+    const { runtime, output, node, candidate, intentionName, ctx, restarts, } = input;
+    // Register listen BEFORE speech so mid-talk interrupts still bind here.
+    const listenExpectation = await node.listen(ctx);
+    runtime.listenExpectation = listenExpectation;
+    this.stampListenTimeout(runtime, node);
+    if (listenExpectation) {
+        this.events.log('info', 'LISTEN_REGISTERED', {
+            conversationId: runtime.conversationId,
+            runtimeInstanceId: runtime.runtimeInstanceId,
+            nodeId: candidate.id,
+            class: candidate.class,
+            listen: runtime.listenExpectation,
+            restart: restarts,
+        });
+    }
+    this.events.log('info', 'NODE_ENTER', {
+        conversationId: runtime.conversationId,
+        runtimeInstanceId: runtime.runtimeInstanceId,
+        nodeId: candidate.id,
+        class: candidate.class,
+        intention: intentionName,
+        portal: Boolean(candidate.portal),
+        originNodeId: runtime.portalState.originNodeId,
+        normalFlowNodeId: runtime.normalFlowNodeId,
+        activePortalId: runtime.portalState.activePortalId,
+        restart: restarts,
+        turnNumber: runtime.turn.turnNumber,
+        memory: (0, conversation_console_1.snapshotUserMemory)(runtime.memory),
+    });
+    if (restarts === 0) {
+        (0, conversation_history_1.appendNodeVisit)(runtime.history, {
+            nodeId: candidate.id,
+            intention: intentionName,
+            turnNumber: runtime.turn.turnNumber,
+            at: new Date().toISOString(),
+        });
+    }
+    try {
+        const result = await node.run(ctx);
+        if (result.kind === 'sayAndListen') {
+            runtime.listenExpectation = (0, listen_expectation_1.mergeSayAndListenOptions)(runtime.listenExpectation, result.sayAndListen);
+            this.stampListenTimeout(runtime, node, result.sayAndListen?.timeoutSeconds);
+            if (result.sayAndListen?.extract?.fields?.length) {
+                this.events.log('info', 'LISTEN_EXTRACT_REGISTERED', {
+                    conversationId: runtime.conversationId,
+                    runtimeInstanceId: runtime.runtimeInstanceId,
+                    nodeId: candidate.id,
+                    fields: result.sayAndListen.extract.fields,
+                    hasOnExtracted: Boolean(result.sayAndListen.extract.onExtracted),
+                });
+            }
+        }
+        await node.after(ctx, result);
+        this.events.log('info', 'NODE_AFTER', {
+            conversationId: runtime.conversationId,
+            runtimeInstanceId: runtime.runtimeInstanceId,
+            providerCallId: runtime.providerCallId,
+            nodeId: candidate.id,
+            class: candidate.class,
+            intention: intentionName,
+            resultKind: result.kind,
+            resultDetail: (0, route_forensics_1.nodeResultForensics)(result),
+            turnNumber: runtime.turn.turnNumber,
+            memory: (0, conversation_console_1.snapshotUserMemory)(runtime.memory),
+            actions: (0, route_forensics_1.actionForensics)(output.actions),
+        });
+        return { kind: 'done', result };
+    }
+    catch (error) {
+        const directive = await node.catch(ctx, error);
+        this.events.log('warn', 'NODE_CATCH', {
+            conversationId: runtime.conversationId,
+            runtimeInstanceId: runtime.runtimeInstanceId,
+            nodeId: candidate.id,
+            class: candidate.class,
+            error: error instanceof Error
+                ? { name: error.name, message: error.message }
+                : { message: String(error) },
+            directive,
+            restart: restarts,
+        });
+        if (directive.kind === 'restartNode') {
+            if (restarts >= supervisor_types_1.MAX_NODE_RESTARTS) {
+                throw new Error(`restartNode limit (${supervisor_types_1.MAX_NODE_RESTARTS}) exceeded for ${candidate.id}`);
+            }
+            // Drop partial speech from the failed attempt before retrying.
+            output.actions.length = 0;
+            return this.executeNodeWithCatch({
+                ...input,
+                restarts: restarts + 1,
+            });
+        }
+        if (directive.kind === 'forceIntention') {
+            output.actions.length = 0;
+            return { kind: 'forceIntention', intention: directive.intention };
+        }
+        if (directive.kind === 'result') {
+            await node.after(ctx, directive.result);
+            return { kind: 'done', result: directive.result };
+        }
+        throw error;
+    }
+}
+/**
+ * Stamp the resolved listen window onto the active expectation.
+ * sayAndListen timeout > listen() timeout > Node.listenTimeoutSeconds > default.
+ */
+function stampListenTimeout(runtime, node, fromSayAndListen) {
+    const timeoutSeconds = (0, listen_timeout_1.resolveListenTimeoutSeconds)({
+        fromSayAndListen,
+        fromListen: runtime.listenExpectation?.timeoutSeconds,
+        fromNode: node.listenTimeoutSeconds,
+    });
+    if (!runtime.listenExpectation) {
+        runtime.listenExpectation = {
+            intentions: [],
+            timeoutSeconds,
+            interruptible: node.interruptible,
+        };
+        return;
+    }
+    runtime.listenExpectation.timeoutSeconds = timeoutSeconds;
+    if (runtime.listenExpectation.interruptible === undefined) {
+        runtime.listenExpectation.interruptible = node.interruptible;
+    }
+}
+function enterPortal(runtime, candidate) {
+    const switching = runtime.portalState.activePortalId &&
+        runtime.portalState.activePortalId !== candidate.id;
+    if (switching) {
+        const restored = runtime.exitPortal();
+        this.events.log('info', 'PORTAL_EXIT', {
+            conversationId: runtime.conversationId,
+            runtimeInstanceId: runtime.runtimeInstanceId,
+            restoredOriginNodeId: restored,
+            reason: 'switch_portal',
+        });
+    }
+    const alreadyInSame = runtime.portalState.activePortalId === candidate.id;
+    runtime.enterPortal(candidate.id);
+    this.events.log('info', alreadyInSame ? 'PORTAL_REENTER' : 'PORTAL_ENTER', {
+        conversationId: runtime.conversationId,
+        runtimeInstanceId: runtime.runtimeInstanceId,
+        portalId: candidate.id,
+        originNodeId: runtime.portalState.originNodeId,
+    });
+    return undefined;
+}
+function enterNormal(runtime, candidate) {
+    let restored;
+    if (runtime.portalState.activePortalId) {
+        restored = runtime.exitPortal();
+        this.events.log('info', 'PORTAL_EXIT', {
+            conversationId: runtime.conversationId,
+            runtimeInstanceId: runtime.runtimeInstanceId,
+            restoredOriginNodeId: restored,
+            nextNodeId: candidate.id,
+            reason: 'normal_intention',
+        });
+    }
+    runtime.enterNormalNode(candidate.id);
+    return restored;
+}
+/**
+ * After a toolCall terminal action, remember which Node requested it so the
+ * next Custom LLM turn with role:tool can re-enter without Brain scan.
+ */
+/**
+ * After a toolCall terminal action, remember which Node requested it so the
+ * next Custom LLM turn with role:tool can re-enter without Brain scan.
+ */
+function stampPendingToolNode(runtime, result, selectedNodeId) {
+    if (result.kind === 'toolCall') {
+        runtime.metadata[channel_tools_1.CHANNEL_META.pendingToolNodeId] = selectedNodeId;
+        return;
+    }
+    // Non-tool terminals clear the pending marker.
+    if (result.kind === 'sayAndListen' ||
+        result.kind === 'endCall' ||
+        result.kind === 'transferToHuman' ||
+        result.kind === 'handoff' ||
+        result.kind === 'continueTo') {
+        delete runtime.metadata[channel_tools_1.CHANNEL_META.pendingToolNodeId];
+    }
+}
+//# sourceMappingURL=supervisor-node-exec.js.map