@guidify-ai/vapi-studio 0.1.0

package/dist/supervisor/supervisor-portal.js

@@ -0,0 +1,320 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isContinueNode = isContinueNode;
+exports.isStillThereNode = isStillThereNode;
+exports.isUnknownPortalActive = isUnknownPortalActive;
+exports.tryUnknownOriginConsume = tryUnknownOriginConsume;
+exports.resolveOriginListenForReplay = resolveOriginListenForReplay;
+exports.replayOriginAfterContinue = replayOriginAfterContinue;
+const listen_expectation_1 = require("../conversation/listen-expectation");
+const brain_ranking_1 = require("../brain/brain-ranking");
+const standard_intentions_1 = require("../intentions/standard-intentions");
+const agent_node_1 = require("../node/agent-node");
+const code_intention_1 = require("../intention/code-intention");
+const supervisor_types_1 = require("./supervisor.types");
+/** Continue / isContinue is an escape hatch back to the pre-portal node. */
+function isContinueNode(candidate) {
+    return (candidate.class === 'ContinueNode' ||
+        candidate.id === 'continue' ||
+        (candidate.intentions.length === 1 &&
+            candidate.intentions[0] === 'isContinue'));
+}
+function isStillThereNode(candidate) {
+    return (candidate.class === 'StillThereNode' ||
+        candidate.id === 'stillThere' ||
+        candidate.intentions.includes(standard_intentions_1.STANDARD_INTENTIONS.isStillThere));
+}
+/** True when the active portal owns `studio.isUnknownTransition`. */
+/** True when the active portal owns `studio.isUnknownTransition`. */
+function isUnknownPortalActive(runtime) {
+    const portalId = runtime.portalState.activePortalId;
+    if (!portalId)
+        return false;
+    const def = this.flowLoader.getFlow().nodes[portalId];
+    if (!def?.portal)
+        return false;
+    return def.intentions.includes(standard_intentions_1.STANDARD_INTENTIONS.isUnknownTransition);
+}
+/**
+ * While in unknown recovery, try the origin’s listen (snapshot or refresh).
+ * If the utterance resolves / ranks as a non-unknown product (or portal)
+ * intention, exit the portal and route that intention on this turn — do not
+ * re-scan against unknown’s thin candidate list.
+ */
+/**
+ * While in unknown recovery, try the origin’s listen (snapshot or refresh).
+ * If the utterance resolves / ranks as a non-unknown product (or portal)
+ * intention, exit the portal and route that intention on this turn — do not
+ * re-scan against unknown’s thin candidate list.
+ */
+async function tryUnknownOriginConsume(input) {
+    const { runtime, userText, output, forceHop } = input;
+    const portalId = runtime.portalState.activePortalId;
+    const originId = runtime.portalState.originNodeId ?? runtime.normalFlowNodeId;
+    if (!portalId || !originId)
+        return null;
+    const savedListen = runtime.portalState.originListenExpectation ?? null;
+    const probeListen = savedListen ??
+        (await this.resolveOriginListenForReplay({
+            runtime,
+            userText,
+            output,
+            originId,
+            preferSaved: false,
+            clearSaved: false,
+        }));
+    if (!probeListen)
+        return null;
+    const confidenceThreshold = (0, brain_ranking_1.resolveConfidenceThreshold)(this.brainConfig?.confidenceThreshold);
+    const brainCandidates = this.buildBrainCandidates(probeListen, runtime);
+    const resolvedName = await (0, listen_expectation_1.tryResolveListenIntention)({
+        listen: probeListen,
+        userText,
+        memory: runtime.memory,
+    });
+    let ranked;
+    if (resolvedName) {
+        ranked = (0, brain_ranking_1.scoresToRankedCandidates)([
+            {
+                name: resolvedName,
+                confidence: 1,
+                reason: code_intention_1.ROUTE_RESOLVED_VIA.UnknownOriginConsume,
+            },
+        ], brainCandidates);
+        runtime.brainSequenceIndex = (runtime.brainSequenceIndex ?? 0) + 1;
+    }
+    else {
+        const scan = await this.brain.scan({
+            runtime,
+            userText,
+            listen: probeListen,
+            candidates: brainCandidates,
+            confidenceThreshold,
+            history: {
+                chat: runtime.history.chat,
+                nodes: runtime.history.nodes,
+            },
+        });
+        ranked = (0, brain_ranking_1.selectWalkableIntentions)(scan.intentions, confidenceThreshold, standard_intentions_1.STANDARD_INTENTIONS.isUnknownTransition);
+    }
+    ranked = ranked.filter((i) => i.name !== 'isContinue' &&
+        i.name !== standard_intentions_1.STANDARD_INTENTIONS.isUnknownTransition);
+    if (ranked.length === 0) {
+        return null;
+    }
+    this.events.log('info', 'UNKNOWN_ORIGIN_CONSUME', {
+        conversationId: runtime.conversationId,
+        runtimeInstanceId: runtime.runtimeInstanceId,
+        portalId,
+        originNodeId: originId,
+        userText,
+        resolvedName: resolvedName ?? null,
+        ranked: ranked.map((i) => i.name),
+        usedSavedOriginListen: Boolean(savedListen),
+    });
+    const portalOriginRestored = runtime.exitPortal();
+    const targetId = portalOriginRestored ?? originId;
+    runtime.enterNormalNode(targetId);
+    runtime.listenExpectation = probeListen;
+    const originCandidate = this.flowLoader.getFlow().nodes[targetId];
+    const originNode = originCandidate
+        ? this.nodes.get(originCandidate.class)
+        : undefined;
+    if (originNode) {
+        this.stampListenTimeout(runtime, originNode);
+    }
+    const routed = await this.routeIntentions({
+        runtime,
+        userText,
+        output,
+        ranked,
+        forceHop: forceHop + 1,
+        resolvedVia: code_intention_1.ROUTE_RESOLVED_VIA.UnknownOriginConsume,
+    });
+    return {
+        intentionNames: ranked.map((i) => i.name),
+        selectedNodeId: routed.selectedNodeId,
+        selectedClass: routed.selectedClass,
+        result: routed.result,
+        portalOriginRestored: portalOriginRestored ?? routed.portalOriginRestored,
+    };
+}
+/**
+ * Origin listen for Continue / unknown consume: prefer the snapshot taken at
+ * portal enter (keeps `sayAndListen` overrides + resolveIntention).
+ */
+/**
+ * Origin listen for Continue / unknown consume: prefer the snapshot taken at
+ * portal enter (keeps `sayAndListen` overrides + resolveIntention).
+ */
+async function resolveOriginListenForReplay(input) {
+    const { runtime, userText, output, originId, preferSaved, clearSaved } = input;
+    const saved = preferSaved
+        ? runtime.portalState.originListenExpectation
+        : null;
+    if (clearSaved) {
+        runtime.portalState.originListenExpectation = null;
+    }
+    if (saved) {
+        return saved;
+    }
+    const flow = this.flowLoader.getFlow();
+    const originCandidate = flow.nodes[originId];
+    if (!originCandidate)
+        return null;
+    const originNode = this.nodes.get(originCandidate.class);
+    if (!originNode)
+        return null;
+    const listenCtx = (0, agent_node_1.nodeContextFromRuntime)({
+        runtime,
+        userText,
+        output,
+        events: this.events,
+        brain: this.brain,
+        integrations: this.integrations,
+        forms: this.forms,
+        intention: 'isContinue',
+    });
+    return originNode.listen(listenCtx);
+}
+/**
+ * Exit the active portal (if any), restore the origin Node, refresh its
+ * listen, re-scan the same user text, and route again — without speaking a
+ * filler “Okay, continuing.”
+ */
+/**
+ * Exit the active portal (if any), restore the origin Node, refresh its
+ * listen, re-scan the same user text, and route again — without speaking a
+ * filler “Okay, continuing.”
+ */
+async function replayOriginAfterContinue(input) {
+    const { runtime, userText, output, forceHop, fromNodeId } = input;
+    if (forceHop >= supervisor_types_1.MAX_FORCE_INTENTION_HOPS) {
+        throw new Error(`continue replay hop limit (${supervisor_types_1.MAX_FORCE_INTENTION_HOPS}) exceeded`);
+    }
+    const originId = runtime.portalState.originNodeId ??
+        runtime.normalFlowNodeId ??
+        runtime.currentNodeId;
+    // Keep snapshot before exitPortal clears it.
+    const savedListen = runtime.portalState.originListenExpectation ?? null;
+    let portalOriginRestored = null;
+    if (runtime.portalState.activePortalId) {
+        portalOriginRestored = runtime.exitPortal();
+    }
+    const targetId = portalOriginRestored ?? originId;
+    if (!targetId || targetId === 'continue' || targetId === fromNodeId) {
+        this.events.log('warn', 'CONTINUE_NO_ORIGIN', {
+            conversationId: runtime.conversationId,
+            runtimeInstanceId: runtime.runtimeInstanceId,
+            fromNodeId,
+            originId,
+            userText,
+        });
+        // Last resort: stay silent of filler — re-ask via unknown.
+        return this.routeIntentions({
+            runtime,
+            userText,
+            output,
+            ranked: [
+                {
+                    name: standard_intentions_1.STANDARD_INTENTIONS.isUnknownTransition,
+                    confidence: 1,
+                    priority: 0,
+                    rank: 0,
+                },
+            ],
+            forceHop,
+        });
+    }
+    runtime.enterNormalNode(targetId);
+    const flow = this.flowLoader.getFlow();
+    const originCandidate = flow.nodes[targetId];
+    if (!originCandidate) {
+        throw new Error(`Continue origin node "${targetId}" missing from flow`);
+    }
+    const originNode = this.nodes.get(originCandidate.class);
+    if (!originNode) {
+        throw new Error(`Continue origin class not registered: ${originCandidate.class}`);
+    }
+    const listenExpectation = savedListen ??
+        (await this.resolveOriginListenForReplay({
+            runtime,
+            userText,
+            output,
+            originId: targetId,
+            preferSaved: false,
+            clearSaved: false,
+        }));
+    if (!listenExpectation) {
+        throw new Error(`Continue origin listen missing for "${targetId}"`);
+    }
+    runtime.listenExpectation = listenExpectation;
+    this.stampListenTimeout(runtime, originNode);
+    const confidenceThreshold = (0, brain_ranking_1.resolveConfidenceThreshold)(this.brainConfig?.confidenceThreshold);
+    const brainCandidates = this.buildBrainCandidates(listenExpectation, runtime);
+    const resolvedName = await (0, listen_expectation_1.tryResolveListenIntention)({
+        listen: listenExpectation,
+        userText,
+        memory: runtime.memory,
+    });
+    const scan = resolvedName
+        ? {
+            intentions: (0, brain_ranking_1.scoresToRankedCandidates)([
+                {
+                    name: resolvedName,
+                    confidence: 1,
+                    reason: input.resolvedVia ?? code_intention_1.ROUTE_RESOLVED_VIA.Continue,
+                },
+            ], brainCandidates),
+        }
+        : await this.brain.scan({
+            runtime,
+            userText,
+            listen: listenExpectation,
+            candidates: brainCandidates,
+            confidenceThreshold,
+            history: {
+                chat: runtime.history.chat,
+                nodes: runtime.history.nodes,
+            },
+        });
+    if (resolvedName) {
+        runtime.brainSequenceIndex = (runtime.brainSequenceIndex ?? 0) + 1;
+    }
+    let ranked = (0, brain_ranking_1.selectWalkableIntentions)(scan.intentions, confidenceThreshold, standard_intentions_1.STANDARD_INTENTIONS.isUnknownTransition).filter((i) => i.name !== 'isContinue');
+    if (ranked.length === 0) {
+        ranked = [
+            {
+                name: standard_intentions_1.STANDARD_INTENTIONS.isUnknownTransition,
+                confidence: 1,
+                priority: 0,
+                rank: 0,
+            },
+        ];
+    }
+    this.events.log('info', 'CONTINUE_REPLAY_ORIGIN', {
+        conversationId: runtime.conversationId,
+        runtimeInstanceId: runtime.runtimeInstanceId,
+        fromNodeId,
+        originNodeId: targetId,
+        userText,
+        resolvedName: resolvedName ?? null,
+        ranked: ranked.map((i) => i.name),
+        forceHop,
+        via: input.resolvedVia ?? code_intention_1.ROUTE_RESOLVED_VIA.Continue,
+        usedSavedOriginListen: Boolean(savedListen),
+    });
+    const routed = await this.routeIntentions({
+        runtime,
+        userText,
+        output,
+        ranked,
+        forceHop,
+        resolvedVia: input.resolvedVia ?? code_intention_1.ROUTE_RESOLVED_VIA.Continue,
+    });
+    return {
+        ...routed,
+        portalOriginRestored: portalOriginRestored ?? routed.portalOriginRestored,
+    };
+}
+//# sourceMappingURL=supervisor-portal.js.map

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

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

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

@@ -0,0 +1,53 @@
+import type { SupervisedConversation } from '../conversation/supervised-conversation';
+import type { IntentionCandidate } from '../conversation/types';
+import type { ListenExpectation } from '../conversation/listen-expectation';
+import { BufferedConversationOutput, type NodeResult } from '../output/conversation-output';
+import { type RouteRejectRow, type RouteWinnerRow } from '../events/route-forensics';
+import type { SupervisorEngine } from './supervisor.types';
+export declare function routeIntentions(this: SupervisorEngine, input: {
+    runtime: SupervisedConversation;
+    userText: string;
+    output: BufferedConversationOutput;
+    ranked: IntentionCandidate[];
+    forceHop: number;
+    resolvedVia?: string;
+    confidenceThreshold?: number;
+    activeListen?: ListenExpectation | null;
+    allowMiss: true;
+}): Promise<{
+    selectedNodeId: string;
+    selectedClass: string;
+    result: NodeResult;
+    portalOriginRestored?: string | null;
+} | null>;
+export declare function routeIntentions(this: SupervisorEngine, input: {
+    runtime: SupervisedConversation;
+    userText: string;
+    output: BufferedConversationOutput;
+    ranked: IntentionCandidate[];
+    forceHop: number;
+    resolvedVia?: string;
+    confidenceThreshold?: number;
+    activeListen?: ListenExpectation | null;
+    allowMiss?: false;
+}): Promise<{
+    selectedNodeId: string;
+    selectedClass: string;
+    result: NodeResult;
+    portalOriginRestored?: string | null;
+}>;
+export declare function resolveViaForWinner(this: SupervisorEngine, resolvedVia: string | undefined, intentionName: string, forceHop: number): string;
+/** Durable + console forensic: why this node won (or none did). */
+/** Durable + console forensic: why this node won (or none did). */
+export declare function emitRouteDecision(this: SupervisorEngine, input: {
+    runtime: SupervisedConversation;
+    userText: string;
+    resolvedVia: string;
+    confidenceThreshold?: number;
+    activeListen?: ListenExpectation | null;
+    ranked: IntentionCandidate[];
+    rejected: RouteRejectRow[];
+    winner: RouteWinnerRow | null;
+    failed?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=supervisor-route.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-route.d.ts","sourceRoot":"","sources":["../../src/supervisor/supervisor-route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAG5E,OAAO,EAAE,0BAA0B,EAAE,KAAK,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAKnC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D,wBAAsB,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE;IACnE,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,0BAA0B,CAAC;IACnC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,IAAI,CAAC;CACjB,GAAG,OAAO,CAAC;IACV,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC,GAAG,IAAI,CAAC,CAAC;AACV,wBAAsB,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE;IACnE,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,0BAA0B,CAAC;IACnC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxC,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB,GAAG,OAAO,CAAC;IACV,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC,CAAC,CAAC;AAgTH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,EACxD,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,MAAM,CAmBR;AAED,mEAAmE;AAInE,mEAAmE;AACnE,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE;IACrE,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChB"}