@guidify-ai/vapi-studio 0.1.0

package/dist/channel/channel-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-tools.d.ts","sourceRoot":"","sources":["../../src/channel/channel-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,IAAI,WAAW,EAAE,CAAC;IACtB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;CAC5C;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAcD,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,EAAE,CAkCpE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,eAAe,CAO7E;AAED,KAAK,WAAW,GAAG;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAClD,CAAC,CAAC;CACJ,CAAC;AAgCF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B,GAAG,iBAAiB,EAAE,CAiCtB;AAED,qFAAqF;AACrF,eAAO,MAAM,YAAY;;;;;CAKf,CAAC"}

package/dist/channel/channel-tools.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * Optional tool ads from the channel (e.g. Vapi Custom LLM `body.tools`).
+ *
+ * Convention: Vapi Studio requests tools **by name** assuming the Vapi assistant was
+ * pre-provisioned with them. This snapshot is visibility for operators / soft
+ * warnings — not a required inventory gate, and not shared sync state.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHANNEL_META = void 0;
+exports.extractAdvertisedTools = extractAdvertisedTools;
+exports.channelToolsApiFromList = channelToolsApiFromList;
+exports.extractToolResults = extractToolResults;
+/** Normalize Vapi/OpenAI tool advertisements into a flat list. */
+function extractAdvertisedTools(tools) {
+    if (!Array.isArray(tools))
+        return [];
+    const out = [];
+    const seen = new Set();
+    for (const tool of tools) {
+        if (!tool || typeof tool !== 'object')
+            continue;
+        const t = tool;
+        const fn = t.function && typeof t.function === 'object' ? t.function : null;
+        const name = (fn && typeof fn.name === 'string' ? fn.name.trim() : '') ||
+            (typeof t.name === 'string' ? t.name.trim() : '') ||
+            (typeof t.type === 'string' &&
+                ['endCall', 'transferCall', 'handoff'].includes(t.type)
+                ? t.type
+                : '');
+        if (!name || seen.has(name))
+            continue;
+        seen.add(name);
+        out.push({
+            name,
+            description: (fn && typeof fn.description === 'string' ? fn.description : undefined) ??
+                (typeof t.description === 'string' ? t.description : undefined),
+            parameters: (fn && fn.parameters && typeof fn.parameters === 'object'
+                ? fn.parameters
+                : undefined) ??
+                (t.parameters && typeof t.parameters === 'object'
+                    ? t.parameters
+                    : undefined),
+            type: typeof t.type === 'string' ? t.type : undefined,
+        });
+    }
+    return out;
+}
+function channelToolsApiFromList(tools) {
+    const byName = new Map(tools.map((t) => [t.name, t]));
+    return {
+        list: () => [...tools],
+        has: (name) => byName.has(name.trim()),
+        get: (name) => byName.get(name.trim()),
+    };
+}
+function contentToString(content) {
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map((part) => typeof part === 'object' && part && 'text' in part
+            ? String(part.text)
+            : '')
+            .join(' ')
+            .trim();
+    }
+    if (content == null)
+        return '';
+    try {
+        return JSON.stringify(content);
+    }
+    catch {
+        return String(content);
+    }
+}
+function tryParseJson(text) {
+    const t = text.trim();
+    if (!t)
+        return undefined;
+    try {
+        return JSON.parse(t);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Collect `role:tool` messages from the newest Custom LLM request,
+ * pairing names from prior assistant `tool_calls` when possible.
+ */
+function extractToolResults(body) {
+    const messages = body.messages ?? [];
+    const nameByCallId = new Map();
+    for (const msg of messages) {
+        if (msg.role !== 'assistant' || !Array.isArray(msg.tool_calls))
+            continue;
+        for (const tc of msg.tool_calls) {
+            const id = typeof tc.id === 'string' ? tc.id : '';
+            const name = tc.function && typeof tc.function.name === 'string'
+                ? tc.function.name
+                : '';
+            if (id && name)
+                nameByCallId.set(id, name);
+        }
+    }
+    const results = [];
+    for (const msg of messages) {
+        if (msg.role !== 'tool')
+            continue;
+        const content = contentToString(msg.content);
+        const toolCallId = typeof msg.tool_call_id === 'string' ? msg.tool_call_id : undefined;
+        const name = (typeof msg.name === 'string' && msg.name) ||
+            (toolCallId ? nameByCallId.get(toolCallId) : undefined);
+        results.push({
+            toolCallId,
+            name,
+            content,
+            parsed: tryParseJson(content),
+        });
+    }
+    return results;
+}
+/** Metadata keys stashed on SupervisedConversation.metadata each Custom LLM turn. */
+exports.CHANNEL_META = {
+    tools: 'channelTools',
+    toolResults: 'lastToolResults',
+    vapi: 'vapi',
+    pendingToolNodeId: 'pendingToolCallNodeId',
+};
+//# sourceMappingURL=channel-tools.js.map

package/dist/channel/channel-tools.js.map

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

package/dist/conversation/call-turn-queue.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Per-call Custom LLM turn queue.
+ *
+ * While a node turn is working (listen→run→after), late user utterances are
+ * buffered. Once the turn finishes (listening again), queued speech is drained
+ * as one combined prompt — a series of user talk, not N racing turns.
+ */
+export declare function coalesceUserUtterances(utterances: string[]): string;
+export type TurnQueueWorkMeta = {
+    /** Raw utterance parts that were coalesced (after near-dup folding). */
+    parts: string[];
+    /** True when more than one distinct utterance was merged. */
+    series: boolean;
+};
+export declare class CallTurnQueue {
+    private working;
+    private readonly pending;
+    /** Mutex chain — only one exclusive section runs at a time. */
+    private tail;
+    get isWorking(): boolean;
+    get pendingCount(): number;
+    /**
+     * Buffer user speech.
+     * Empty string is allowed once — Vapi "assistant speaks first" Custom LLM
+     * requests arrive with no user text and must still run the opening node.
+     */
+    enqueue(userText: string): void;
+    private drain;
+    /**
+     * Enqueue this request's user text, wait if another turn is working, then
+     * run `work` with the coalesced pending series (or skip if already drained).
+     *
+     * After `work` returns, further pending utterances run on this same call
+     * only when `continueDraining()` is true. Vapi Custom LLM must leave them
+     * for the waiting HTTP request — that is the stream the provider plays.
+     */
+    runExclusive<T>(input: {
+        userText: string;
+        continueDraining?: () => boolean;
+        /**
+         * After the last queued utterance, wait this many ms for more ASR fragments
+         * before running work. 0 / omitted = no hold (opening turn, tests).
+         */
+        listenHoldMs?: number;
+        work: (combinedUserText: string, meta: TurnQueueWorkMeta) => Promise<T>;
+    }): Promise<{
+        status: 'ran';
+        result: T;
+    } | {
+        status: 'skipped';
+    }>;
+    /**
+     * Debounce: wait until `holdMs` of silence after the last queued utterance,
+     * capped at 2× holdMs from when the hold started.
+     */
+    private holdForMoreUtterances;
+}
+/** Process-local queues keyed by provider call id. */
+export declare class CallTurnQueueRegistry {
+    private readonly queues;
+    get(providerCallId: string): CallTurnQueue;
+    delete(providerCallId: string): void;
+}
+//# sourceMappingURL=call-turn-queue.d.ts.map

package/dist/conversation/call-turn-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-turn-queue.d.ts","sourceRoot":"","sources":["../../src/conversation/call-turn-queue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAyBnE;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,wEAAwE;IACxE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6DAA6D;IAC7D,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,+DAA+D;IAC/D,OAAO,CAAC,IAAI,CAAoC;IAEhD,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED;;;;OAIG;IACI,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAStC,OAAO,CAAC,KAAK;IAIb;;;;;;;OAOG;IACU,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE;QAClC,QAAQ,EAAE,MAAM,CAAC;QACjB,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC;QACjC;;;WAGG;QACH,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,CAAC,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;KACzE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,CAAC,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,SAAS,CAAA;KAAE,CAAC;IAgDjE;;;OAGG;YACW,qBAAqB;CAgBpC;AAED,sDAAsD;AACtD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgE;IAEhF,GAAG,CAAC,cAAc,EAAE,MAAM,GAAG,aAAa;IAS1C,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;CAG5C"}

package/dist/conversation/call-turn-queue.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * Per-call Custom LLM turn queue.
+ *
+ * While a node turn is working (listen→run→after), late user utterances are
+ * buffered. Once the turn finishes (listening again), queued speech is drained
+ * as one combined prompt — a series of user talk, not N racing turns.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CallTurnQueueRegistry = exports.CallTurnQueue = void 0;
+exports.coalesceUserUtterances = coalesceUserUtterances;
+function coalesceUserUtterances(utterances) {
+    const cleaned = [];
+    for (const raw of utterances) {
+        const text = raw.trim().replace(/\s+/g, ' ');
+        if (!text)
+            continue;
+        const prev = cleaned[cleaned.length - 1];
+        if (prev &&
+            (prev === text || prev.includes(text) || text.includes(prev))) {
+            // Prefer the longer near-duplicate.
+            if (text.length > prev.length)
+                cleaned[cleaned.length - 1] = text;
+            continue;
+        }
+        cleaned.push(text);
+    }
+    if (cleaned.length === 0)
+        return '';
+    if (cleaned.length === 1)
+        return cleaned[0];
+    return [
+        'The user spoke several times in quick succession (overlapping speech / barge-in).',
+        'Treat the following series as one combined user answer — not separate turns:',
+        ...cleaned.map((text, i) => `${i + 1}) ${text}`),
+    ].join('\n');
+}
+class CallTurnQueue {
+    working = false;
+    pending = [];
+    /** Mutex chain — only one exclusive section runs at a time. */
+    tail = Promise.resolve();
+    get isWorking() {
+        return this.working;
+    }
+    get pendingCount() {
+        return this.pending.length;
+    }
+    /**
+     * Buffer user speech.
+     * Empty string is allowed once — Vapi "assistant speaks first" Custom LLM
+     * requests arrive with no user text and must still run the opening node.
+     */
+    enqueue(userText) {
+        const text = userText.trim();
+        const last = this.pending[this.pending.length - 1];
+        if (last === text)
+            return;
+        // At most one empty opening token waiting in the queue.
+        if (!text && this.pending.some((p) => p === ''))
+            return;
+        this.pending.push(text);
+    }
+    drain() {
+        return this.pending.splice(0, this.pending.length);
+    }
+    /**
+     * Enqueue this request's user text, wait if another turn is working, then
+     * run `work` with the coalesced pending series (or skip if already drained).
+     *
+     * After `work` returns, further pending utterances run on this same call
+     * only when `continueDraining()` is true. Vapi Custom LLM must leave them
+     * for the waiting HTTP request — that is the stream the provider plays.
+     */
+    async runExclusive(input) {
+        this.enqueue(input.userText);
+        let release;
+        const mySlot = new Promise((resolve) => {
+            release = resolve;
+        });
+        const previous = this.tail;
+        this.tail = this.tail.then(() => mySlot);
+        await previous;
+        if (this.pending.length === 0) {
+            release();
+            return { status: 'skipped' };
+        }
+        this.working = true;
+        let lastResult;
+        try {
+            const holdMs = input.listenHoldMs ?? 0;
+            if (holdMs > 0 && this.pending.some((p) => p.trim().length > 0)) {
+                await this.holdForMoreUtterances(holdMs);
+            }
+            do {
+                const parts = this.drain();
+                if (!parts.length)
+                    break;
+                const combined = coalesceUserUtterances(parts);
+                const nonEmptyParts = parts.map((p) => p.trim()).filter(Boolean);
+                // Empty combined is valid for speak-first opening (parts === ['']).
+                const openingOnly = nonEmptyParts.length === 0;
+                if (!combined && !openingOnly)
+                    break;
+                lastResult = await input.work(combined, {
+                    parts: openingOnly ? [''] : nonEmptyParts.length ? nonEmptyParts : parts,
+                    series: nonEmptyParts.length > 1,
+                });
+            } while (this.pending.length > 0 &&
+                (input.continueDraining?.() ?? false));
+            return { status: 'ran', result: lastResult };
+        }
+        finally {
+            this.working = false;
+            release();
+        }
+    }
+    /**
+     * Debounce: wait until `holdMs` of silence after the last queued utterance,
+     * capped at 2× holdMs from when the hold started.
+     */
+    async holdForMoreUtterances(holdMs) {
+        const started = Date.now();
+        const maxMs = holdMs * 2;
+        let lastCount = this.pending.length;
+        let lastChange = Date.now();
+        while (Date.now() - started < maxMs) {
+            if (Date.now() - lastChange >= holdMs) {
+                return;
+            }
+            await new Promise((r) => setTimeout(r, 25));
+            if (this.pending.length !== lastCount) {
+                lastCount = this.pending.length;
+                lastChange = Date.now();
+            }
+        }
+    }
+}
+exports.CallTurnQueue = CallTurnQueue;
+/** Process-local queues keyed by provider call id. */
+class CallTurnQueueRegistry {
+    queues = new Map();
+    get(providerCallId) {
+        let q = this.queues.get(providerCallId);
+        if (!q) {
+            q = new CallTurnQueue();
+            this.queues.set(providerCallId, q);
+        }
+        return q;
+    }
+    delete(providerCallId) {
+        this.queues.delete(providerCallId);
+    }
+}
+exports.CallTurnQueueRegistry = CallTurnQueueRegistry;
+//# sourceMappingURL=call-turn-queue.js.map

package/dist/conversation/call-turn-queue.js.map

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

package/dist/conversation/conversation-bootstrap.service.d.ts

@@ -0,0 +1,60 @@
+import { SupervisedConversation } from './supervised-conversation';
+import { SupervisedConversationRegistry } from './supervised-conversation.registry';
+import { CallTurnQueueRegistry } from './call-turn-queue';
+import { ConversationRepository } from '../persistence/conversation.repository';
+import { EventService } from '../events/event.service';
+import { BrainUsageTracker } from '../brain/brain-usage.tracker';
+import { FlowLoader } from '../flow/flow-loader';
+import { type ConversationEntryPoint } from './conversation-entry';
+export declare class ConversationBootstrapService {
+    private readonly conversations;
+    private readonly registry;
+    private readonly flowLoader;
+    private readonly events;
+    private readonly turnQueues;
+    private readonly brainUsage;
+    private readonly entry;
+    /** Serialize concurrent bootstrap for the same Vapi call (assistant.started ∥ Custom LLM). */
+    private readonly bootstrapping;
+    constructor(conversations: ConversationRepository, registry: SupervisedConversationRegistry, flowLoader: FlowLoader, events: EventService, turnQueues: CallTurnQueueRegistry, brainUsage: BrainUsageTracker, entryPoint?: ConversationEntryPoint);
+    bootstrap(input: {
+        projectId: string;
+        providerCallId: string;
+        brainProfileId: string;
+        metadata?: Record<string, unknown>;
+        variables?: Record<string, unknown>;
+    }): Promise<SupervisedConversation>;
+    private bootstrapExclusive;
+    private openCallLog;
+    finalizeEnded(providerCallId: string): Promise<void>;
+    /** Persist live runtime so a process crash can restore ACTIVE conversations. */
+    checkpoint(runtime: SupervisedConversation): Promise<void>;
+    /**
+     * Simulate process memory loss: drop all in-memory runtimes without ending DB rows.
+     * Checkpoints already in Postgres remain ACTIVE for restore.
+     */
+    simulateCrash(): {
+        dropped: number;
+        providerCallIds: string[];
+    };
+    /** Reload every ACTIVE conversation that has a runtime_state checkpoint. */
+    restoreAllActive(): Promise<{
+        restored: number;
+        skipped: number;
+        conversationIds: string[];
+    }>;
+    disasterStatus(): Promise<{
+        memoryCount: number;
+        dbActiveCount: number;
+        dbCheckpointCount: number;
+        memory: Array<{
+            conversationId: string;
+            providerCallId: string;
+            currentNodeId: string | null;
+            turnNumber: number;
+        }>;
+    }>;
+    /** Registry has no public iterator — poke via provider ids we track on restore/bootstrap. */
+    private listRegistryRuntimes;
+}
+//# sourceMappingURL=conversation-bootstrap.service.d.ts.map

package/dist/conversation/conversation-bootstrap.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-bootstrap.service.d.ts","sourceRoot":"","sources":["../../src/conversation/conversation-bootstrap.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,8BAA8B,EAAE,MAAM,oCAAoC,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,sBAAsB,CAAC;AAQ9B,qBACa,4BAA4B;IASrC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAb7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,8FAA8F;IAC9F,OAAO,CAAC,QAAQ,CAAC,aAAa,CAG1B;gBAGe,aAAa,EAAE,sBAAsB,EACrC,QAAQ,EAAE,8BAA8B,EACxC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,qBAAqB,EACjC,UAAU,EAAE,iBAAiB,EAG9C,UAAU,CAAC,EAAE,sBAAsB;IAKxB,SAAS,CAAC,KAAK,EAAE;QAC5B,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,GAAG,OAAO,CAAC,sBAAsB,CAAC;YA2BrB,kBAAkB;IAoIhC,OAAO,CAAC,WAAW;IAqBN,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmEjE,gFAAgF;IACnE,UAAU,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBvE;;;OAGG;IACI,aAAa,IAAI;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B;IAmBD,4EAA4E;IAC/D,gBAAgB,IAAI,OAAO,CAAC;QACvC,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;IA+CW,cAAc,IAAI,OAAO,CAAC;QACrC,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,MAAM,EAAE,KAAK,CAAC;YACZ,cAAc,EAAE,MAAM,CAAC;YACvB,cAAc,EAAE,MAAM,CAAC;YACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;YAC7B,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC,CAAC;KACJ,CAAC;IAiBF,6FAA6F;IAC7F,OAAO,CAAC,oBAAoB;CAG7B"}