@guidify-ai/vapi-studio 0.1.0

package/dist/supervisor/supervisor-route.js

@@ -0,0 +1,308 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.routeIntentions = routeIntentions;
+exports.resolveViaForWinner = resolveViaForWinner;
+exports.emitRouteDecision = emitRouteDecision;
+const conversation_history_1 = require("../conversation/conversation-history");
+const standard_intentions_1 = require("../intentions/standard-intentions");
+const route_forensics_1 = require("../events/route-forensics");
+const conversation_console_1 = require("../events/conversation-console");
+const code_intention_1 = require("../intention/code-intention");
+const flow_loader_1 = require("../flow/flow-loader");
+const agent_node_1 = require("../node/agent-node");
+const supervisor_types_1 = require("./supervisor.types");
+async function routeIntentions(input) {
+    const { runtime, userText, output, ranked, forceHop, resolvedVia, confidenceThreshold, activeListen, allowMiss, } = input;
+    const rejected = [];
+    for (const scored of ranked) {
+        const intentionName = scored.name;
+        const nodeCandidates = this.flowLoader.nodesForIntention(intentionName);
+        for (const candidate of nodeCandidates) {
+            const node = this.nodes.get(candidate.class);
+            if (!node) {
+                rejected.push({
+                    nodeId: candidate.id,
+                    class: candidate.class,
+                    intention: intentionName,
+                    reason: 'missing',
+                    confidence: scored.confidence,
+                    priority: scored.priority,
+                });
+                this.events.log('warn', 'NODE_MISSING', {
+                    class: candidate.class,
+                    intention: intentionName,
+                });
+                continue;
+            }
+            // Idle still-there is forceIntention-only (channel timer). Do not let Brain
+            // promote “hey?” / filler into the still-there portal mid-flow.
+            if (intentionName === standard_intentions_1.STANDARD_INTENTIONS.isStillThere &&
+                runtime.portalState.activePortalId !== 'stillThere' &&
+                resolvedVia !== code_intention_1.ROUTE_RESOLVED_VIA.ForceIntention) {
+                rejected.push({
+                    nodeId: candidate.id,
+                    class: candidate.class,
+                    intention: intentionName,
+                    reason: 'still_there_requires_force',
+                    confidence: scored.confidence,
+                    priority: scored.priority,
+                });
+                this.events.log('info', 'NODE_REJECT', {
+                    conversationId: runtime.conversationId,
+                    runtimeInstanceId: runtime.runtimeInstanceId,
+                    nodeId: candidate.id,
+                    class: candidate.class,
+                    intention: intentionName,
+                    confidence: scored.confidence,
+                    priority: scored.priority,
+                    reason: 'still_there_requires_force',
+                });
+                continue;
+            }
+            const ctx = (0, agent_node_1.nodeContextFromRuntime)({
+                runtime,
+                userText,
+                output,
+                events: this.events,
+                brain: this.brain,
+                integrations: this.integrations,
+                forms: this.forms,
+                intention: intentionName,
+            });
+            const can = await node.before(ctx);
+            if (!can) {
+                rejected.push({
+                    nodeId: candidate.id,
+                    class: candidate.class,
+                    intention: intentionName,
+                    reason: 'before_false',
+                    confidence: scored.confidence,
+                    priority: scored.priority,
+                });
+                this.events.log('info', 'NODE_REJECT', {
+                    conversationId: runtime.conversationId,
+                    runtimeInstanceId: runtime.runtimeInstanceId,
+                    nodeId: candidate.id,
+                    class: candidate.class,
+                    intention: intentionName,
+                    confidence: scored.confidence,
+                    priority: scored.priority,
+                    reason: 'before_false',
+                });
+                continue;
+            }
+            const winner = {
+                nodeId: candidate.id,
+                class: candidate.class,
+                intention: intentionName,
+                confidence: scored.confidence,
+                priority: scored.priority,
+                portal: Boolean(candidate.portal),
+            };
+            // isContinue: never speak “Okay, continuing.” — restore portal origin and
+            // re-route the same utterance against that node’s listen. Only when a
+            // portal is active; otherwise let ContinueNode.run (e.g. catch recovery).
+            if (this.isContinueNode(candidate) &&
+                runtime.portalState.activePortalId) {
+                await this.emitRouteDecision({
+                    runtime,
+                    userText,
+                    resolvedVia: resolvedVia ?? code_intention_1.ROUTE_RESOLVED_VIA.Continue,
+                    confidenceThreshold,
+                    activeListen,
+                    ranked,
+                    rejected,
+                    winner: { ...winner, class: `${winner.class}→continue_replay` },
+                });
+                return this.replayOriginAfterContinue({
+                    runtime,
+                    userText,
+                    output,
+                    forceHop: forceHop + 1,
+                    fromNodeId: candidate.id,
+                });
+            }
+            // Still-there “yes / still here” → silent origin resume (same as Continue).
+            if (this.isStillThereNode(candidate) &&
+                runtime.portalState.activePortalId === candidate.id &&
+                (intentionName === standard_intentions_1.STANDARD_INTENTIONS.isPositive ||
+                    intentionName === 'isContinue')) {
+                runtime.portalState.stillThere.attempts = 0;
+                await this.emitRouteDecision({
+                    runtime,
+                    userText,
+                    resolvedVia: resolvedVia ?? code_intention_1.ROUTE_RESOLVED_VIA.Continue,
+                    confidenceThreshold,
+                    activeListen,
+                    ranked,
+                    rejected,
+                    winner: { ...winner, class: `${winner.class}→continue_replay` },
+                });
+                return this.replayOriginAfterContinue({
+                    runtime,
+                    userText,
+                    output,
+                    forceHop: forceHop + 1,
+                    fromNodeId: candidate.id,
+                    resolvedVia: code_intention_1.ROUTE_RESOLVED_VIA.Continue,
+                });
+            }
+            await this.emitRouteDecision({
+                runtime,
+                userText,
+                resolvedVia: this.resolveViaForWinner(resolvedVia, intentionName, forceHop),
+                confidenceThreshold,
+                activeListen,
+                ranked,
+                rejected,
+                winner,
+            });
+            let portalOriginRestored;
+            if (candidate.portal) {
+                portalOriginRestored = this.enterPortal(runtime, candidate);
+            }
+            else {
+                portalOriginRestored = this.enterNormal(runtime, candidate);
+            }
+            const executed = await this.executeNodeWithCatch({
+                runtime,
+                userText,
+                output,
+                node,
+                candidate,
+                intentionName,
+                ctx,
+                restarts: 0,
+                forceHop,
+            });
+            if (executed.kind === 'forceIntention') {
+                if (forceHop >= supervisor_types_1.MAX_FORCE_INTENTION_HOPS) {
+                    throw new Error(`forceIntention hop limit (${supervisor_types_1.MAX_FORCE_INTENTION_HOPS}) exceeded`);
+                }
+                this.events.log('info', 'CATCH_FORCE_INTENTION', {
+                    conversationId: runtime.conversationId,
+                    runtimeInstanceId: runtime.runtimeInstanceId,
+                    fromNodeId: candidate.id,
+                    intention: executed.intention,
+                    forceHop: forceHop + 1,
+                });
+                return this.routeIntentions({
+                    runtime,
+                    userText,
+                    output,
+                    ranked: [
+                        {
+                            name: executed.intention,
+                            confidence: 1,
+                            priority: conversation_history_1.DEFAULT_INTENTION_PRIORITY,
+                            rank: 0,
+                        },
+                    ],
+                    forceHop: forceHop + 1,
+                    resolvedVia: code_intention_1.ROUTE_RESOLVED_VIA.ForceIntention,
+                    confidenceThreshold,
+                    activeListen: runtime.listenExpectation,
+                });
+            }
+            return {
+                selectedNodeId: candidate.id,
+                selectedClass: candidate.class,
+                result: executed.result,
+                portalOriginRestored,
+            };
+        }
+    }
+    await this.emitRouteDecision({
+        runtime,
+        userText,
+        resolvedVia: resolvedVia ?? code_intention_1.ROUTE_RESOLVED_VIA.Brain,
+        confidenceThreshold,
+        activeListen,
+        ranked,
+        rejected,
+        winner: null,
+        failed: true,
+    });
+    if (allowMiss) {
+        return null;
+    }
+    // Brain/listen picked something every Node refused (before_false) — never 500
+    // the channel. Recover through the unknown-transition portal once.
+    if (resolvedVia !== code_intention_1.ROUTE_RESOLVED_VIA.RouteFallbackUnknown &&
+        forceHop < supervisor_types_1.MAX_FORCE_INTENTION_HOPS) {
+        this.events.log('warn', 'ROUTE_FALLBACK_UNKNOWN', {
+            conversationId: runtime.conversationId,
+            runtimeInstanceId: runtime.runtimeInstanceId,
+            turnNumber: runtime.turn.turnNumber,
+            userText,
+            rejected,
+            note: 'all candidates before() false — falling back to studio.isUnknownTransition',
+        });
+        return this.routeIntentions({
+            runtime,
+            userText,
+            output,
+            ranked: [
+                {
+                    name: standard_intentions_1.STANDARD_INTENTIONS.isUnknownTransition,
+                    confidence: 1,
+                    priority: 0,
+                    rank: 0,
+                },
+            ],
+            forceHop: forceHop + 1,
+            resolvedVia: code_intention_1.ROUTE_RESOLVED_VIA.RouteFallbackUnknown,
+            confidenceThreshold,
+            activeListen,
+        });
+    }
+    throw new Error('Supervisor could not route turn to any eligible node');
+}
+function resolveViaForWinner(resolvedVia, intentionName, forceHop) {
+    if (resolvedVia === code_intention_1.ROUTE_RESOLVED_VIA.ConditionForce) {
+        return code_intention_1.ROUTE_RESOLVED_VIA.ConditionForce;
+    }
+    if (resolvedVia === code_intention_1.ROUTE_RESOLVED_VIA.IntentionForce) {
+        return code_intention_1.ROUTE_RESOLVED_VIA.IntentionForce;
+    }
+    if (resolvedVia === code_intention_1.ROUTE_RESOLVED_VIA.IntentionMatch) {
+        return code_intention_1.ROUTE_RESOLVED_VIA.IntentionMatch;
+    }
+    if (intentionName.startsWith(flow_loader_1.CONDITION_GOTO_PREFIX)) {
+        return code_intention_1.ROUTE_RESOLVED_VIA.ConditionBoost;
+    }
+    return (resolvedVia ??
+        (forceHop > 0
+            ? code_intention_1.ROUTE_RESOLVED_VIA.ForceIntention
+            : code_intention_1.ROUTE_RESOLVED_VIA.Brain));
+}
+/** Durable + console forensic: why this node won (or none did). */
+/** Durable + console forensic: why this node won (or none did). */
+async function emitRouteDecision(input) {
+    const { runtime, userText, resolvedVia, confidenceThreshold, activeListen, ranked, rejected, winner, failed, } = input;
+    const type = failed ? 'ROUTE_FAILED' : 'ROUTE_DECISION';
+    const payload = {
+        runtimeInstanceId: runtime.runtimeInstanceId,
+        providerCallId: runtime.providerCallId,
+        turnNumber: runtime.turn.turnNumber,
+        userText,
+        resolvedVia,
+        confidenceThreshold: confidenceThreshold ?? null,
+        listen: (0, route_forensics_1.listenForensics)(activeListen),
+        walk: (0, route_forensics_1.walkForensics)(ranked),
+        rejected,
+        winner,
+        activePortalId: runtime.portalState.activePortalId ?? null,
+        originNodeId: runtime.portalState.originNodeId ?? null,
+        normalFlowNodeId: runtime.normalFlowNodeId ?? null,
+        currentNodeId: runtime.currentNodeId ?? null,
+        memory: (0, conversation_console_1.snapshotUserMemory)(runtime.memory),
+    };
+    if (runtime.conversationId) {
+        await this.events.persist(runtime.conversationId, type, payload);
+    }
+    else {
+        this.events.log(failed ? 'error' : 'info', type, payload);
+    }
+}
+//# sourceMappingURL=supervisor-route.js.map

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

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

package/dist/supervisor/supervisor-special-turns.d.ts

@@ -0,0 +1,34 @@
+import type { SupervisedConversation } from '../conversation/supervised-conversation';
+import type { SupervisorEngine } from './supervisor.types';
+import type { TurnExecutionResult } from './supervisor.types';
+/**
+ * Speak the active module's current/entry Node after WORKFLOW_HANDOFF
+ * (does not toggle openingCompleted).
+ */
+export declare function executeModuleEntryTurn(this: SupervisorEngine, input: {
+    runtime: SupervisedConversation;
+    userText: string;
+    onSay?: (text: string) => Promise<void>;
+}): Promise<TurnExecutionResult>;
+/**
+ * First Custom LLM turn: execute flow.start Node.run() so the assistant
+ * speaks before any user utterance / Brain routing.
+ */
+/**
+ * First Custom LLM turn: execute flow.start Node.run() so the assistant
+ * speaks before any user utterance / Brain routing.
+ */
+export declare function executeOpeningTurn(this: SupervisorEngine, input: {
+    runtime: SupervisedConversation;
+    userText: string;
+    onSay?: (text: string) => Promise<void>;
+}): Promise<TurnExecutionResult>;
+/**
+ * Tool-result-only Custom LLM turn — re-run the Node that emitted toolCall.
+ */
+export declare function executeToolResultTurn(this: SupervisorEngine, input: {
+    runtime: SupervisedConversation;
+    userText: string;
+    onSay?: (text: string) => Promise<void>;
+}): Promise<TurnExecutionResult>;
+//# sourceMappingURL=supervisor-special-turns.d.ts.map

package/dist/supervisor/supervisor-special-turns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-special-turns.d.ts","sourceRoot":"","sources":["../../src/supervisor/supervisor-special-turns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAOtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE;IAC1E,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA8F/B;AAED;;;GAGG;AAIH;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE;IACtE,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAwG/B;AAID;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE;IACzE,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqG/B"}

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

@@ -0,0 +1,308 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeModuleEntryTurn = executeModuleEntryTurn;
+exports.executeOpeningTurn = executeOpeningTurn;
+exports.executeToolResultTurn = executeToolResultTurn;
+const conversation_history_1 = require("../conversation/conversation-history");
+const channel_tools_1 = require("../channel/channel-tools");
+const standard_intentions_1 = require("../intentions/standard-intentions");
+const agent_node_1 = require("../node/agent-node");
+const conversation_output_1 = require("../output/conversation-output");
+const conversation_console_1 = require("../events/conversation-console");
+/**
+ * Speak the active module's current/entry Node after WORKFLOW_HANDOFF
+ * (does not toggle openingCompleted).
+ */
+async function executeModuleEntryTurn(input) {
+    const { runtime, userText, onSay } = input;
+    const flow = this.flowLoader.getFlow();
+    const entryId = runtime.currentNodeId ?? flow.start;
+    const candidate = flow.nodes[entryId];
+    if (!candidate) {
+        throw new Error(`Module entry node "${entryId}" missing`);
+    }
+    const node = this.nodes.get(candidate.class);
+    if (!node) {
+        throw new Error(`Module entry class not registered: ${candidate.class}`);
+    }
+    const output = new conversation_output_1.BufferedConversationOutput(onSay);
+    const ctx = (0, agent_node_1.nodeContextFromRuntime)({
+        runtime,
+        userText,
+        output,
+        events: this.events,
+        brain: this.brain,
+        integrations: this.integrations,
+        forms: this.forms,
+        intention: candidate.intentions[0] ?? 'studio.moduleEntry',
+    });
+    this.events.log('info', 'MODULE_ENTRY_TURN', {
+        conversationId: runtime.conversationId,
+        providerCallId: runtime.providerCallId,
+        runtimeInstanceId: runtime.runtimeInstanceId,
+        entryNodeId: entryId,
+        class: candidate.class,
+        activeModuleId: runtime.metadata.activeModuleId ?? null,
+        workflowId: runtime.metadata.workflowId ?? null,
+        turnNumber: runtime.turn.turnNumber,
+        memory: (0, conversation_console_1.snapshotUserMemory)(runtime.memory),
+    });
+    const can = await node.before(ctx);
+    if (!can) {
+        throw new Error(`Module entry node ${entryId} rejected before()`);
+    }
+    if (candidate.portal) {
+        this.enterPortal(runtime, candidate);
+    }
+    else {
+        this.enterNormal(runtime, candidate);
+    }
+    const executed = await this.executeNodeWithCatch({
+        runtime,
+        userText,
+        output,
+        node,
+        candidate,
+        intentionName: candidate.intentions[0] ?? 'studio.moduleEntry',
+        ctx,
+        restarts: 0,
+        forceHop: 0,
+    });
+    if (executed.kind === 'forceIntention') {
+        const routed = await this.routeIntentions({
+            runtime,
+            userText,
+            output,
+            ranked: [
+                {
+                    name: executed.intention,
+                    confidence: 1,
+                    priority: conversation_history_1.DEFAULT_INTENTION_PRIORITY,
+                    rank: 0,
+                },
+            ],
+            forceHop: 1,
+        });
+        return {
+            runtime,
+            intentionNames: ['studio.moduleEntry', executed.intention],
+            selectedNodeId: routed.selectedNodeId,
+            selectedClass: routed.selectedClass,
+            result: routed.result,
+            actions: output.actions,
+            portalOriginRestored: routed.portalOriginRestored,
+        };
+    }
+    return {
+        runtime,
+        intentionNames: ['studio.moduleEntry'],
+        selectedNodeId: candidate.id,
+        selectedClass: candidate.class,
+        result: executed.result,
+        actions: output.actions,
+    };
+}
+/**
+ * First Custom LLM turn: execute flow.start Node.run() so the assistant
+ * speaks before any user utterance / Brain routing.
+ */
+/**
+ * First Custom LLM turn: execute flow.start Node.run() so the assistant
+ * speaks before any user utterance / Brain routing.
+ */
+async function executeOpeningTurn(input) {
+    const { runtime, userText, onSay } = input;
+    const flow = this.flowLoader.getFlow();
+    const startId = flow.start;
+    const candidate = flow.nodes[startId];
+    if (!candidate) {
+        throw new Error(`Flow start node "${startId}" missing`);
+    }
+    const node = this.nodes.get(candidate.class);
+    if (!node) {
+        throw new Error(`Start node class not registered: ${candidate.class}`);
+    }
+    const openingIntention = 'studio.opening';
+    const output = new conversation_output_1.BufferedConversationOutput(onSay);
+    const ctx = (0, agent_node_1.nodeContextFromRuntime)({
+        runtime,
+        userText,
+        output,
+        events: this.events,
+        brain: this.brain,
+        integrations: this.integrations,
+        forms: this.forms,
+        // Never use flow.nodes[start].intentions[0] — that list is for *routing into*
+        // the node (e.g. soft re-ask), not for the speak-first opening turn.
+        intention: openingIntention,
+    });
+    this.events.log('info', 'OPENING_TURN', {
+        conversationId: runtime.conversationId,
+        providerCallId: runtime.providerCallId,
+        runtimeInstanceId: runtime.runtimeInstanceId,
+        startNodeId: startId,
+        class: candidate.class,
+        userText,
+        turnNumber: runtime.turn.turnNumber,
+        memory: (0, conversation_console_1.snapshotUserMemory)(runtime.memory),
+    });
+    const can = await node.before(ctx);
+    if (!can) {
+        throw new Error(`Opening start node ${startId} rejected before()`);
+    }
+    if (candidate.portal) {
+        this.enterPortal(runtime, candidate);
+    }
+    else {
+        this.enterNormal(runtime, candidate);
+    }
+    const executed = await this.executeNodeWithCatch({
+        runtime,
+        userText,
+        output,
+        node,
+        candidate,
+        intentionName: openingIntention,
+        ctx,
+        restarts: 0,
+        forceHop: 0,
+    });
+    if (executed.kind === 'forceIntention') {
+        runtime.openingCompleted = true;
+        this.events.log('info', 'OPENING_FORCE_INTENTION', {
+            conversationId: runtime.conversationId,
+            runtimeInstanceId: runtime.runtimeInstanceId,
+            intention: executed.intention,
+        });
+        const routed = await this.routeIntentions({
+            runtime,
+            userText,
+            output,
+            ranked: [
+                {
+                    name: executed.intention,
+                    confidence: 1,
+                    priority: conversation_history_1.DEFAULT_INTENTION_PRIORITY,
+                    rank: 0,
+                },
+            ],
+            forceHop: 1,
+        });
+        return {
+            runtime,
+            intentionNames: ['studio.opening', executed.intention],
+            selectedNodeId: routed.selectedNodeId,
+            selectedClass: routed.selectedClass,
+            result: routed.result,
+            actions: output.actions,
+            portalOriginRestored: routed.portalOriginRestored,
+        };
+    }
+    runtime.openingCompleted = true;
+    return {
+        runtime,
+        intentionNames: ['studio.opening'],
+        selectedNodeId: candidate.id,
+        selectedClass: candidate.class,
+        result: executed.result,
+        actions: output.actions,
+    };
+}
+/**
+ * Tool-result-only Custom LLM turn — re-run the Node that emitted toolCall.
+ */
+async function executeToolResultTurn(input) {
+    const { runtime, userText, onSay } = input;
+    const flow = this.flowLoader.getFlow();
+    const pendingId = typeof runtime.metadata[channel_tools_1.CHANNEL_META.pendingToolNodeId] === 'string'
+        ? String(runtime.metadata[channel_tools_1.CHANNEL_META.pendingToolNodeId])
+        : null;
+    const entryId = pendingId ||
+        runtime.currentNodeId ||
+        runtime.normalFlowNodeId ||
+        flow.start;
+    const candidate = flow.nodes[entryId];
+    if (!candidate) {
+        throw new Error(`Tool-result node "${entryId}" missing`);
+    }
+    const node = this.nodes.get(candidate.class);
+    if (!node) {
+        throw new Error(`Tool-result class not registered: ${candidate.class}`);
+    }
+    const output = new conversation_output_1.BufferedConversationOutput(onSay);
+    const ctx = (0, agent_node_1.nodeContextFromRuntime)({
+        runtime,
+        userText,
+        output,
+        events: this.events,
+        brain: this.brain,
+        integrations: this.integrations,
+        forms: this.forms,
+        intention: standard_intentions_1.STANDARD_INTENTIONS.isToolResult,
+    });
+    this.events.log('info', 'TOOL_RESULT_TURN', {
+        conversationId: runtime.conversationId,
+        providerCallId: runtime.providerCallId,
+        runtimeInstanceId: runtime.runtimeInstanceId,
+        entryNodeId: entryId,
+        class: candidate.class,
+        turnNumber: runtime.turn.turnNumber,
+    });
+    const can = await node.before(ctx);
+    if (!can) {
+        throw new Error(`Tool-result node ${entryId} rejected before()`);
+    }
+    if (candidate.portal) {
+        this.enterPortal(runtime, candidate);
+    }
+    else {
+        this.enterNormal(runtime, candidate);
+    }
+    const executed = await this.executeNodeWithCatch({
+        runtime,
+        userText,
+        output,
+        node,
+        candidate,
+        intentionName: standard_intentions_1.STANDARD_INTENTIONS.isToolResult,
+        ctx,
+        restarts: 0,
+        forceHop: 0,
+    });
+    if (executed.kind === 'forceIntention') {
+        const routed = await this.routeIntentions({
+            runtime,
+            userText,
+            output,
+            ranked: [
+                {
+                    name: executed.intention,
+                    confidence: 1,
+                    priority: conversation_history_1.DEFAULT_INTENTION_PRIORITY,
+                    rank: 0,
+                },
+            ],
+            forceHop: 1,
+        });
+        this.stampPendingToolNode(runtime, routed.result, routed.selectedNodeId);
+        return {
+            runtime,
+            intentionNames: [standard_intentions_1.STANDARD_INTENTIONS.isToolResult, executed.intention],
+            selectedNodeId: routed.selectedNodeId,
+            selectedClass: routed.selectedClass,
+            result: routed.result,
+            actions: output.actions,
+            portalOriginRestored: routed.portalOriginRestored,
+        };
+    }
+    this.stampPendingToolNode(runtime, executed.result, candidate.id);
+    return {
+        runtime,
+        intentionNames: [standard_intentions_1.STANDARD_INTENTIONS.isToolResult],
+        selectedNodeId: candidate.id,
+        selectedClass: candidate.class,
+        result: executed.result,
+        actions: output.actions,
+    };
+}
+//# sourceMappingURL=supervisor-special-turns.js.map