@guidify-ai/vapi-studio 0.1.0

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

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

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

@@ -0,0 +1,24 @@
+import type { SupervisedConversation } from '../conversation/supervised-conversation';
+import type { ChannelToolResult } from '../channel/channel-tools';
+import type { SupervisorEngine } from './supervisor.types';
+import type { TurnExecutionResult } from './supervisor.types';
+export declare function handleTurn(this: SupervisorEngine, 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>;
+export declare function executeTurn(this: SupervisorEngine, input: {
+    runtime: SupervisedConversation;
+    userText: string;
+    toolResults?: ChannelToolResult[];
+    forceIntention?: string;
+    onSay?: (text: string) => Promise<void>;
+}): Promise<TurnExecutionResult>;
+//# sourceMappingURL=supervisor-orchestration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-orchestration.d.ts","sourceRoot":"","sources":["../../src/supervisor/supervisor-orchestration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAEtF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAiBlE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,wBAAsB,UAAU,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE;IAC9D,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAY/B;AAID,wBAAsB,WAAW,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE;IAC/D,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAya/B"}

package/dist/supervisor/supervisor-orchestration.js

@@ -0,0 +1,395 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleTurn = handleTurn;
+exports.executeTurn = executeTurn;
+const channel_tools_1 = require("../channel/channel-tools");
+const conversation_history_1 = require("../conversation/conversation-history");
+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 conversation_output_1 = require("../output/conversation-output");
+const code_intention_1 = require("../intention/code-intention");
+const flow_loader_1 = require("../flow/flow-loader");
+const conversation_console_1 = require("../events/conversation-console");
+async function handleTurn(input) {
+    const result = await this.executeTurn(input);
+    try {
+        await this.bootstrap?.checkpoint(input.runtime);
+    }
+    catch (error) {
+        this.events.log('warn', 'RUNTIME_CHECKPOINT_FAILED', {
+            conversationId: input.runtime.conversationId,
+            providerCallId: input.runtime.providerCallId,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+    return result;
+}
+async function executeTurn(input) {
+    const { runtime, userText, onSay } = input;
+    runtime.turn.turnNumber += 1;
+    runtime.turn.interrupted = false;
+    if (userText.trim()) {
+        (0, conversation_history_1.appendChat)(runtime.history, 'user', userText);
+    }
+    const toolResults = input.toolResults ?? [];
+    if (toolResults.length > 0) {
+        runtime.metadata[channel_tools_1.CHANNEL_META.toolResults] = toolResults;
+        this.events.log('info', 'TOOL_RESULT_RECEIVED', {
+            conversationId: runtime.conversationId,
+            providerCallId: runtime.providerCallId,
+            runtimeInstanceId: runtime.runtimeInstanceId,
+            turnNumber: runtime.turn.turnNumber,
+            count: toolResults.length,
+            names: toolResults.map((r) => r.name ?? r.toolCallId ?? '?'),
+        });
+    }
+    else {
+        delete runtime.metadata[channel_tools_1.CHANNEL_META.toolResults];
+    }
+    const recordSay = async (text) => {
+        (0, conversation_history_1.appendChat)(runtime.history, 'assistant', text);
+        if (onSay)
+            await onSay(text);
+    };
+    const limitResult = await this.enforceConversationLimits({
+        runtime,
+        onSay: recordSay,
+    });
+    if (limitResult)
+        return limitResult;
+    /**
+     * Vapi Custom LLM (assistant speaks first / generated message mode):
+     * the first request must run() flow.start — no Brain scan, no sequence advance.
+     */
+    if (!runtime.openingCompleted) {
+        return this.executeOpeningTurn({ runtime, userText, onSay: recordSay });
+    }
+    /**
+     * After a workflow handoff into a Studio module, speak the destination entry
+     * Node once (same Conversation; does not re-run call opening).
+     */
+    if (runtime.metadata.moduleNeedsEntrySpeak === true) {
+        runtime.metadata.moduleNeedsEntrySpeak = false;
+        return this.executeModuleEntryTurn({
+            runtime,
+            userText,
+            onSay: recordSay,
+        });
+    }
+    // Tool-result-only turn: re-enter the Node that requested the toolCall.
+    if (toolResults.length > 0 && !userText.trim()) {
+        return this.executeToolResultTurn({
+            runtime,
+            userText,
+            onSay: recordSay,
+        });
+    }
+    // Forced intention (e.g. Studio/Vapi idle → still-there portal).
+    if (input.forceIntention?.trim()) {
+        const output = new conversation_output_1.BufferedConversationOutput(recordSay);
+        const routed = await this.routeIntentions({
+            runtime,
+            userText,
+            output,
+            ranked: [
+                {
+                    name: input.forceIntention.trim(),
+                    confidence: 1,
+                    priority: conversation_history_1.DEFAULT_INTENTION_PRIORITY,
+                    rank: 0,
+                },
+            ],
+            forceHop: 0,
+            resolvedVia: code_intention_1.ROUTE_RESOLVED_VIA.ForceIntention,
+        });
+        this.stampPendingToolNode(runtime, routed.result, routed.selectedNodeId);
+        return {
+            runtime,
+            intentionNames: [input.forceIntention.trim()],
+            selectedNodeId: routed.selectedNodeId,
+            selectedClass: routed.selectedClass,
+            result: routed.result,
+            actions: output.actions,
+            portalOriginRestored: routed.portalOriginRestored,
+        };
+    }
+    /**
+     * Cascade step 0 — code intentions with phase: 'force'.
+     * Full before/match/run freedom; no listen_resolve, no Brain.
+     */
+    {
+        const forced = await this.tryForceIntentions({
+            runtime,
+            userText,
+            onSay: recordSay,
+        });
+        if (forced) {
+            return forced;
+        }
+    }
+    /**
+     * Cascade step 1 — condition `force: true` transitions (YAML sugar).
+     * Pure memory/variable gates; no listen_resolve, no Brain.
+     */
+    {
+        const forced = this.flowLoader.matchingConditionTransitions({
+            currentNodeId: runtime.currentNodeId,
+            memory: runtime.memory,
+            variables: runtime.variables,
+        }, { force: true });
+        if (forced.length > 0) {
+            const output = new conversation_output_1.BufferedConversationOutput(recordSay);
+            for (const t of forced) {
+                const payload = {
+                    conversationId: runtime.conversationId,
+                    runtimeInstanceId: runtime.runtimeInstanceId,
+                    providerCallId: runtime.providerCallId,
+                    turnNumber: runtime.turn.turnNumber,
+                    transitionId: t.id,
+                    from: runtime.currentNodeId,
+                    to: t.to,
+                    when: t.when,
+                    force: true,
+                    reason: t.reason ?? null,
+                    userText,
+                    memory: (0, conversation_console_1.snapshotUserMemory)(runtime.memory),
+                };
+                if (runtime.conversationId) {
+                    await this.events.persist(runtime.conversationId, 'CONDITION_TRANSITION', payload);
+                }
+                else {
+                    this.events.log('info', 'CONDITION_TRANSITION', payload);
+                }
+            }
+            const ranked = forced.map((t, i) => ({
+                name: (0, flow_loader_1.conditionGotoIntention)(t.to),
+                confidence: 1,
+                priority: t.priority ?? 1_000_000,
+                rank: i,
+            }));
+            const routed = await this.routeIntentions({
+                runtime,
+                userText,
+                output,
+                ranked,
+                forceHop: 0,
+                resolvedVia: code_intention_1.ROUTE_RESOLVED_VIA.ConditionForce,
+                allowMiss: true,
+            });
+            if (routed) {
+                this.stampPendingToolNode(runtime, routed.result, routed.selectedNodeId);
+                return {
+                    runtime,
+                    intentionNames: ranked.map((i) => i.name),
+                    selectedNodeId: routed.selectedNodeId,
+                    selectedClass: routed.selectedClass,
+                    result: routed.result,
+                    actions: output.actions,
+                    portalOriginRestored: routed.portalOriginRestored,
+                };
+            }
+            this.events.log('warn', 'CONDITION_TRANSITION_MISSED', {
+                conversationId: runtime.conversationId,
+                runtimeInstanceId: runtime.runtimeInstanceId,
+                turnNumber: runtime.turn.turnNumber,
+                tried: forced.map((t) => t.id),
+                note: 'force transitions matched when but every before() refused; falling through cascade',
+            });
+        }
+    }
+    /**
+     * Unknown portal: consume the restatement against the origin listen first
+     * (Continue-style). Prevents unknown’s thin candidate list from stealing
+     * the turn to the wrong happy-path node.
+     */
+    if (this.isUnknownPortalActive(runtime) && userText.trim()) {
+        const output = new conversation_output_1.BufferedConversationOutput(recordSay);
+        const consumed = await this.tryUnknownOriginConsume({
+            runtime,
+            userText,
+            output,
+            forceHop: 0,
+        });
+        if (consumed) {
+            this.stampPendingToolNode(runtime, consumed.result, consumed.selectedNodeId);
+            return {
+                runtime,
+                intentionNames: consumed.intentionNames,
+                selectedNodeId: consumed.selectedNodeId,
+                selectedClass: consumed.selectedClass,
+                result: consumed.result,
+                actions: output.actions,
+                portalOriginRestored: consumed.portalOriginRestored,
+            };
+        }
+    }
+    const activeListen = runtime.listenExpectation;
+    const candidates = this.buildBrainCandidates(activeListen, runtime);
+    const confidenceThreshold = (0, brain_ranking_1.resolveConfidenceThreshold)(this.brainConfig?.confidenceThreshold);
+    /**
+     * Cascade — phase: 'match' code intentions (local confidence, may skip Brain).
+     */
+    const matchOutcome = await this.tryMatchIntentions({
+        runtime,
+        userText,
+        onSay: recordSay,
+        confidenceThreshold,
+    });
+    if (matchOutcome?.kind === 'routed') {
+        return matchOutcome.result;
+    }
+    const matchResolved = matchOutcome?.kind === 'score'
+        ? { name: matchOutcome.name, confidence: matchOutcome.confidence }
+        : null;
+    const resolvedName = matchResolved?.name ??
+        (await (0, listen_expectation_1.tryResolveListenIntention)({
+            listen: activeListen,
+            userText,
+            memory: runtime.memory,
+        }));
+    const scan = resolvedName
+        ? {
+            intentions: (0, brain_ranking_1.scoresToRankedCandidates)([
+                {
+                    name: resolvedName,
+                    confidence: matchResolved?.confidence ?? 1,
+                    reason: matchResolved
+                        ? code_intention_1.ROUTE_RESOLVED_VIA.IntentionMatch
+                        : code_intention_1.ROUTE_RESOLVED_VIA.ListenResolve,
+                },
+            ], candidates),
+        }
+        : await this.brain.scan({
+            runtime,
+            userText,
+            listen: activeListen,
+            candidates,
+            confidenceThreshold,
+            history: {
+                chat: runtime.history.chat,
+                nodes: runtime.history.nodes,
+            },
+        });
+    if (resolvedName) {
+        runtime.brainSequenceIndex = (runtime.brainSequenceIndex ?? 0) + 1;
+        this.events.log('info', matchResolved ? 'INTENTION_MATCHED' : 'LISTEN_RESOLVED', {
+            conversationId: runtime.conversationId,
+            runtimeInstanceId: runtime.runtimeInstanceId,
+            turnNumber: runtime.turn.turnNumber,
+            intention: resolvedName,
+            userText,
+            via: matchResolved
+                ? code_intention_1.ROUTE_RESOLVED_VIA.IntentionMatch
+                : code_intention_1.ROUTE_RESOLVED_VIA.ListenResolve,
+            confidence: matchResolved?.confidence ?? 1,
+        });
+    }
+    const intentions = scan.intentions;
+    if (activeListen?.extract?.fields?.length) {
+        const missingRequired = (0, listen_expectation_1.missingRequiredExtractKeys)(activeListen.extract.fields, scan.extracted);
+        if (activeListen.extract.onExtracted) {
+            await activeListen.extract.onExtracted(scan.extracted ?? {}, {
+                memory: runtime.memory,
+                variables: runtime.variables,
+                userText,
+            });
+        }
+        this.events.log('info', 'LISTEN_EXTRACTED', {
+            conversationId: runtime.conversationId,
+            runtimeInstanceId: runtime.runtimeInstanceId,
+            turnNumber: runtime.turn.turnNumber,
+            extracted: scan.extracted,
+            missingRequired,
+            appliedViaCallback: Boolean(activeListen.extract.onExtracted),
+            memory: (0, conversation_console_1.snapshotUserMemory)(runtime.memory),
+        });
+    }
+    this.events.log('info', 'INTENTION_SCAN', {
+        conversationId: runtime.conversationId,
+        providerCallId: runtime.providerCallId,
+        runtimeInstanceId: runtime.runtimeInstanceId,
+        turnNumber: runtime.turn.turnNumber,
+        intentions,
+        extracted: scan.extracted,
+        listen: activeListen,
+        candidates,
+        confidenceThreshold,
+        activePortalId: runtime.portalState.activePortalId,
+        originNodeId: runtime.portalState.originNodeId,
+        normalFlowNodeId: runtime.normalFlowNodeId,
+        memory: (0, conversation_console_1.snapshotUserMemory)(runtime.memory),
+    });
+    const ranked = (0, brain_ranking_1.selectWalkableIntentions)(intentions, confidenceThreshold, standard_intentions_1.STANDARD_INTENTIONS.isUnknownTransition);
+    /**
+     * Cascade step 3 — soft condition boosts (force: false).
+     * High priority studio.goto.* candidates merged ahead of Brain walk.
+     * Default priority 50: above normal nodes, below typical portals (85+).
+     */
+    const soft = this.flowLoader.matchingConditionTransitions({
+        currentNodeId: runtime.currentNodeId,
+        memory: runtime.memory,
+        variables: runtime.variables,
+    }, { force: false });
+    const softRanked = [];
+    for (const [i, t] of soft.entries()) {
+        const payload = {
+            conversationId: runtime.conversationId,
+            runtimeInstanceId: runtime.runtimeInstanceId,
+            providerCallId: runtime.providerCallId,
+            turnNumber: runtime.turn.turnNumber,
+            transitionId: t.id,
+            from: runtime.currentNodeId,
+            to: t.to,
+            when: t.when,
+            force: false,
+            reason: t.reason ?? null,
+            userText,
+            memory: (0, conversation_console_1.snapshotUserMemory)(runtime.memory),
+        };
+        if (runtime.conversationId) {
+            await this.events.persist(runtime.conversationId, 'CONDITION_TRANSITION', payload);
+        }
+        else {
+            this.events.log('info', 'CONDITION_TRANSITION', payload);
+        }
+        softRanked.push({
+            name: (0, flow_loader_1.conditionGotoIntention)(t.to),
+            confidence: 1,
+            priority: t.priority ?? 50,
+            rank: -(soft.length - i),
+        });
+    }
+    const mergedRanked = [...softRanked, ...ranked].sort((a, b) => {
+        if (b.priority !== a.priority)
+            return b.priority - a.priority;
+        return a.rank - b.rank;
+    });
+    const output = new conversation_output_1.BufferedConversationOutput(recordSay);
+    const routed = await this.routeIntentions({
+        runtime,
+        userText,
+        output,
+        ranked: mergedRanked,
+        forceHop: 0,
+        resolvedVia: matchResolved
+            ? code_intention_1.ROUTE_RESOLVED_VIA.IntentionMatch
+            : resolvedName
+                ? code_intention_1.ROUTE_RESOLVED_VIA.ListenResolve
+                : code_intention_1.ROUTE_RESOLVED_VIA.Brain,
+        confidenceThreshold,
+        activeListen,
+    });
+    this.stampPendingToolNode(runtime, routed.result, routed.selectedNodeId);
+    return {
+        runtime,
+        intentionNames: mergedRanked.map((i) => i.name),
+        selectedNodeId: routed.selectedNodeId,
+        selectedClass: routed.selectedClass,
+        result: routed.result,
+        actions: output.actions,
+        portalOriginRestored: routed.portalOriginRestored,
+        extracted: scan.extracted,
+    };
+}
+//# sourceMappingURL=supervisor-orchestration.js.map

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

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

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

@@ -0,0 +1,75 @@
+import type { SupervisedConversation } from '../conversation/supervised-conversation';
+import { type ListenExpectation } from '../conversation/listen-expectation';
+import { BufferedConversationOutput, type NodeResult } from '../output/conversation-output';
+import type { FlowNodeDefinition } from '../flow/flow-loader';
+import type { SupervisorEngine } from './supervisor.types';
+/** Continue / isContinue is an escape hatch back to the pre-portal node. */
+export declare function isContinueNode(this: SupervisorEngine, candidate: FlowNodeDefinition): boolean;
+export declare function isStillThereNode(this: SupervisorEngine, candidate: FlowNodeDefinition): boolean;
+/** True when the active portal owns `studio.isUnknownTransition`. */
+/** True when the active portal owns `studio.isUnknownTransition`. */
+export declare function isUnknownPortalActive(this: SupervisorEngine, runtime: SupervisedConversation): boolean;
+/**
+ * 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.
+ */
+export declare function tryUnknownOriginConsume(this: SupervisorEngine, input: {
+    runtime: SupervisedConversation;
+    userText: string;
+    output: BufferedConversationOutput;
+    forceHop: number;
+}): Promise<{
+    intentionNames: string[];
+    selectedNodeId: string;
+    selectedClass: string;
+    result: NodeResult;
+    portalOriginRestored?: string | null;
+} | null>;
+/**
+ * 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).
+ */
+export declare function resolveOriginListenForReplay(this: SupervisorEngine, input: {
+    runtime: SupervisedConversation;
+    userText: string;
+    output: BufferedConversationOutput;
+    originId: string;
+    preferSaved: boolean;
+    clearSaved: boolean;
+}): Promise<ListenExpectation | null>;
+/**
+ * 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.”
+ */
+export declare function replayOriginAfterContinue(this: SupervisorEngine, input: {
+    runtime: SupervisedConversation;
+    userText: string;
+    output: BufferedConversationOutput;
+    forceHop: number;
+    fromNodeId: string;
+    resolvedVia?: string;
+}): Promise<{
+    selectedNodeId: string;
+    selectedClass: string;
+    result: NodeResult;
+    portalOriginRestored?: string | null;
+}>;
+//# sourceMappingURL=supervisor-portal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-portal.d.ts","sourceRoot":"","sources":["../../src/supervisor/supervisor-portal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAEtF,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,oCAAoC,CAAC;AAO5C,OAAO,EAAE,0BAA0B,EAAE,KAAK,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAG5F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAO7F;AAID,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAM/F;AAED,qEAAqE;AAIrE,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAMtG;AAED;;;;;GAKG;AAIH;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE;IAC3E,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,0BAA0B,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC;IACV,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,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,CA+GR;AAED;;;GAGG;AAIH;;;GAGG;AACH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE;IAChF,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,0BAA0B,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CA8BpC;AAED;;;;GAIG;AAIH;;;;GAIG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE;IAC7E,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,0BAA0B,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,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,CAkKD"}