@yak-io/javascript 0.6.0 → 0.8.0

package/dist/tool-name.js

@@ -0,0 +1,24 @@
+const TOOL_NAME_PREFIX = "yt_";
+/**
+ * Simple 32-bit hash function (djb2 variant).
+ * Produces consistent hash values for the same input string.
+ */
+function hash32(str) {
+    let hash = 5381;
+    for (let i = 0; i < str.length; i++) {
+        hash = ((hash << 5) + hash + str.charCodeAt(i)) >>> 0;
+    }
+    return hash;
+}
+/**
+ * Generates a tool ID from a tool name using a 32-bit hash.
+ * Format: `yt_<8-char-hex-hash>`.
+ *
+ * The hash is deterministic so chat and voice always derive the same id for
+ * the same tool name — this is what lets the mint route, the iframe, and the
+ * SDK all agree on which decorated id maps back to which host tool name.
+ */
+export function generateToolId(originalName) {
+    const hashValue = hash32(originalName);
+    return `${TOOL_NAME_PREFIX}${hashValue.toString(16).padStart(8, "0")}`;
+}

package/dist/types/config.d.ts

@@ -1,5 +1,5 @@
-import type { SchemaSource, ToolManifest } from "./tools.js";
 import type { RouteManifest } from "./routes.js";
+import type { SchemaSource, ToolManifest } from "./tools.js";
 /**
  * Combined configuration for the chatbot including routes, tools, and schema sources
  */

package/dist/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,qBAAqB;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,mDAAmD;IACnD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,wFAAwF;IACxF,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,qBAAqB;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,mDAAmD;IACnD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,wFAAwF;IACxF,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC"}

package/dist/types/messaging.d.ts

@@ -1,6 +1,6 @@
-import type { SchemaSource, ToolManifest, GraphQLRequest, RESTRequest } from "./tools.js";
-import type { RouteManifest } from "./routes.js";
 import type { EmbedProtocolVersion } from "../version.js";
+import type { RouteManifest } from "./routes.js";
+import type { GraphQLRequest, RESTRequest, SchemaSource, ToolManifest } from "./tools.js";
 /**
  * Color values for a single mode (light or dark).
  * Applied as CSS variables within the chat UI.
@@ -61,6 +61,21 @@ export type ChatOptions = {
     /** Disable the restart session button in the header */
     disableRestartButton?: boolean;
 };
+/**
+ * End-user identity for server-side conversation persistence.
+ *
+ * The integrator's backend signs `id` with the application's apiSecret using
+ * HMAC-SHA256 and passes `{ id, hash }` into the widget. When the hash
+ * verifies, conversations are stored server-side and the widget shows a
+ * history pane so end-users can resume past chats. When omitted, the widget
+ * operates in anonymous mode (no persistence).
+ */
+export type UserIdentity = {
+    /** Stable user id from the integrator's system. HMAC-protected. */
+    id: string;
+    /** Hex HMAC-SHA256(apiSecret, id). Computed on the integrator's backend. */
+    hash: string;
+};
 /**
  * Messages sent FROM the host application TO the iframe
  */
@@ -79,6 +94,24 @@ export type IframeMessageFromHost = {
         options?: ChatOptions;
         /** Logging enabled flag from host (for cross-origin sync) */
         loggingEnabled?: boolean;
+        /**
+         * Signed end-user identity. Optional metadata used to link
+         * conversations back to the integrator's user records.
+         */
+        user?: UserIdentity;
+        /**
+         * Signed session token previously minted by the server and stored in
+         * the host SDK's localStorage. When absent, the iframe will mint a
+         * fresh one and `yak:session` it back so we can persist it.
+         */
+        sessionToken?: string;
+        /**
+         * Pointer to the active conversation in the form
+         * `<conversationId>.<savedAt>`. Persisted in the host SDK's
+         * localStorage and shipped back into the iframe so the embed can
+         * restore that specific thread on mount.
+         */
+        conversationPointer?: string;
     };
 } | {
     type: "yak:tool_result";
@@ -145,6 +178,26 @@ export type IframeMessageToHost = {
     payload: {
         path: string;
     };
+} | {
+    /**
+     * Iframe → host: a freshly-minted or refreshed session token. The host
+     * SDK persists this in `localStorage` so future widget loads can pass
+     * it straight back via the next `yak:config`.
+     */
+    type: "yak:session";
+    payload: {
+        sessionToken: string;
+        issuedAt: number;
+    };
+} | {
+    /**
+     * Iframe → host: persist (or clear) the active-conversation pointer.
+     * `null` means "drop the stored key" (restart, stale, or invalid).
+     */
+    type: "yak:conversation";
+    payload: {
+        pointer: string | null;
+    };
 } | {
     type: "yak:close";
 };

package/dist/types/messaging.d.ts.map

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

package/dist/voice-machine.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Pure state machine for a single voice session.
+ *
+ * The reducer has no DOM or WebRTC dependencies — it can be unit-tested by
+ * driving events through `voiceReducer` and checking the resulting state.
+ *
+ * The companion `handleRealtimeMessage` parses an OpenAI Realtime data-channel
+ * message and dispatches reducer events plus side effects (tool dispatch,
+ * sending follow-up events back over the data channel). Side effects are
+ * delegated to the injected `RealtimeMessageContext` so the function is
+ * testable with a plain in-memory mock.
+ */
+export type VoiceState = "idle" | "connecting" | "listening" | "thinking" | "speaking" | "error";
+export type VoiceEvent = {
+    type: "start";
+} | {
+    type: "connected";
+} | {
+    type: "speech_started";
+} | {
+    type: "speech_stopped";
+} | {
+    type: "audio_delta";
+} | {
+    type: "audio_stopped";
+} | {
+    type: "stop";
+} | {
+    type: "error";
+    message: string;
+};
+export interface VoiceMachine {
+    state: VoiceState;
+    errorMessage?: string;
+}
+export declare const INITIAL_VOICE_MACHINE: VoiceMachine;
+export declare function voiceReducer(machine: VoiceMachine, event: VoiceEvent): VoiceMachine;
+/**
+ * Per-`response.done` token usage emitted by OpenAI's Realtime API.
+ * The SDK accumulates these across the session and ships the totals to the
+ * `session-event` stop endpoint so billing has the dimensions it needs.
+ */
+export interface RealtimeResponseUsage {
+    /** Total input tokens for this response (text + audio combined). */
+    inputTokens?: number;
+    /** Cached input tokens — subset of `inputTokens`. */
+    cachedInputTokens?: number;
+    /** Total output tokens for this response (text + audio combined). */
+    outputTokens?: number;
+    /** Audio-input tokens (subset of `inputTokens`). */
+    audioInputTokens?: number;
+    /** Audio-output tokens (subset of `outputTokens`). */
+    audioOutputTokens?: number;
+    /** Text-input tokens (subset of `inputTokens`). */
+    textInputTokens?: number;
+    /** Text-output tokens (subset of `outputTokens`). */
+    textOutputTokens?: number;
+}
+export interface RealtimeMessageContext {
+    send: (event: VoiceEvent) => void;
+    sendData: (payload: unknown) => void;
+    dispatchToolCall: (name: string, args: unknown) => Promise<unknown>;
+    isDispatched: (callId: string) => boolean;
+    markDispatched: (callId: string) => void;
+    /** Forward a per-response usage payload to the session for accumulation. */
+    recordUsage?: (usage: RealtimeResponseUsage) => void;
+}
+export declare function handleRealtimeMessage(raw: string, ctx: RealtimeMessageContext): Promise<void>;
+//# sourceMappingURL=voice-machine.d.ts.map

package/dist/voice-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-machine.d.ts","sourceRoot":"","sources":["../src/voice-machine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AAEjG,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,qBAAqB,EAAE,YAAgC,CAAC;AAErE,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,GAAG,YAAY,CA4BnF;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAClC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpE,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,4EAA4E;IAC5E,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACtD;AAmID,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAmCf"}

package/dist/voice-machine.js

@@ -0,0 +1,163 @@
+/**
+ * Pure state machine for a single voice session.
+ *
+ * The reducer has no DOM or WebRTC dependencies — it can be unit-tested by
+ * driving events through `voiceReducer` and checking the resulting state.
+ *
+ * The companion `handleRealtimeMessage` parses an OpenAI Realtime data-channel
+ * message and dispatches reducer events plus side effects (tool dispatch,
+ * sending follow-up events back over the data channel). Side effects are
+ * delegated to the injected `RealtimeMessageContext` so the function is
+ * testable with a plain in-memory mock.
+ */
+export const INITIAL_VOICE_MACHINE = { state: "idle" };
+export function voiceReducer(machine, event) {
+    switch (event.type) {
+        case "start":
+            return machine.state === "idle" ? { state: "connecting" } : machine;
+        case "connected":
+            return machine.state === "connecting" ? { state: "listening" } : machine;
+        case "speech_started":
+            if (machine.state === "idle" || machine.state === "error")
+                return machine;
+            return { state: "listening" };
+        case "speech_stopped":
+            return machine.state === "listening" ? { state: "thinking" } : machine;
+        case "audio_delta":
+            if (machine.state === "thinking" || machine.state === "speaking") {
+                return { state: "speaking" };
+            }
+            return machine;
+        case "audio_stopped":
+            return machine.state === "speaking" ? { state: "listening" } : machine;
+        case "stop":
+            return { state: "idle" };
+        case "error":
+            return { state: "error", errorMessage: event.message };
+        default: {
+            const _exhaustive = event;
+            void _exhaustive;
+            return machine;
+        }
+    }
+}
+function isFunctionCall(item) {
+    return item.type === "function_call";
+}
+function parseToolArgs(raw) {
+    if (!raw)
+        return {};
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+async function dispatchFunctionCall(call, ctx) {
+    const callId = call.call_id;
+    const name = call.name;
+    if (!callId || !name)
+        return;
+    if (ctx.isDispatched(callId))
+        return;
+    ctx.markDispatched(callId);
+    const args = parseToolArgs(call.arguments);
+    let output;
+    try {
+        const result = await ctx.dispatchToolCall(name, args);
+        output = JSON.stringify(result ?? null);
+    }
+    catch (error) {
+        output = JSON.stringify({
+            error: error instanceof Error ? error.message : "Tool execution failed",
+        });
+    }
+    ctx.sendData({
+        type: "conversation.item.create",
+        item: { type: "function_call_output", call_id: callId, output },
+    });
+    ctx.sendData({ type: "response.create" });
+}
+function extractUsage(raw) {
+    if (!raw)
+        return null;
+    const usage = {};
+    if (typeof raw.input_tokens === "number")
+        usage.inputTokens = raw.input_tokens;
+    if (typeof raw.output_tokens === "number")
+        usage.outputTokens = raw.output_tokens;
+    const inDetails = raw.input_token_details;
+    if (inDetails) {
+        if (typeof inDetails.cached_tokens === "number") {
+            usage.cachedInputTokens = inDetails.cached_tokens;
+        }
+        if (typeof inDetails.audio_tokens === "number") {
+            usage.audioInputTokens = inDetails.audio_tokens;
+        }
+        if (typeof inDetails.text_tokens === "number") {
+            usage.textInputTokens = inDetails.text_tokens;
+        }
+    }
+    const outDetails = raw.output_token_details;
+    if (outDetails) {
+        if (typeof outDetails.audio_tokens === "number") {
+            usage.audioOutputTokens = outDetails.audio_tokens;
+        }
+        if (typeof outDetails.text_tokens === "number") {
+            usage.textOutputTokens = outDetails.text_tokens;
+        }
+    }
+    return Object.keys(usage).length > 0 ? usage : null;
+}
+async function handleResponseDone(response, ctx) {
+    const usage = extractUsage(response?.usage);
+    if (usage && ctx.recordUsage) {
+        try {
+            ctx.recordUsage(usage);
+        }
+        catch {
+            // recordUsage is best-effort; never let it break the session loop.
+        }
+    }
+    const calls = (response?.output ?? []).filter(isFunctionCall);
+    for (const call of calls) {
+        await dispatchFunctionCall(call, ctx);
+    }
+}
+export async function handleRealtimeMessage(raw, ctx) {
+    let message;
+    try {
+        message = JSON.parse(raw);
+    }
+    catch {
+        return;
+    }
+    switch (message.type) {
+        case "input_audio_buffer.speech_started":
+            ctx.send({ type: "speech_started" });
+            return;
+        case "input_audio_buffer.speech_stopped":
+            ctx.send({ type: "speech_stopped" });
+            return;
+        case "response.output_audio_transcript.delta":
+        case "response.audio_transcript.delta":
+            ctx.send({ type: "audio_delta" });
+            return;
+        case "output_audio_buffer.stopped":
+        case "response.output_audio_buffer.stopped":
+            ctx.send({ type: "audio_stopped" });
+            return;
+        case "response.done":
+            await handleResponseDone(message.response, ctx);
+            return;
+        case "error":
+            ctx.send({
+                type: "error",
+                message: message.error?.message ?? "Voice session error",
+            });
+            return;
+        default:
+            return;
+    }
+}

package/dist/voice-session.d.ts

@@ -0,0 +1,102 @@
+import type { ChatConfig, ChatConfigProvider } from "./types/config.js";
+import type { GraphQLSchemaHandler, RESTSchemaHandler, ToolCallHandler } from "./types/tools.js";
+import { type VoiceMachine } from "./voice-machine.js";
+declare global {
+    interface Window {
+        __YAK_INTERNAL_DEV__?: boolean;
+    }
+}
+export type VoiceStateListener = (machine: VoiceMachine) => void;
+export interface YakVoiceSessionConfig {
+    appId: string;
+    /** Tool call handler. Same shape as `YakClientConfig.onToolCall`. */
+    onToolCall?: ToolCallHandler;
+    onGraphQLSchemaCall?: GraphQLSchemaHandler;
+    onRESTSchemaCall?: RESTSchemaHandler;
+    onRedirect?: (path: string) => void;
+    /**
+     * Static chat config (routes + tools). Sent to the mint endpoint so the LLM
+     * knows what tools are available. Use this OR `getConfig`.
+     */
+    chatConfig?: ChatConfig;
+    /**
+     * Async provider for chat config. Called on every session start — useful when
+     * tools/routes depend on the current page or user. Takes precedence over
+     * `chatConfig` if both are provided.
+     */
+    getConfig?: ChatConfigProvider;
+    /**
+     * Override the API origin. Defaults to chat.yak.io (prod), chat.yak.supply
+     * (dev stage), or http://localhost:3001 when `__YAK_INTERNAL_DEV__` is set.
+     */
+    apiOrigin?: string;
+}
+export declare class YakVoiceSession {
+    private config;
+    private machine;
+    private resources;
+    private dispatchedCallIds;
+    private listeners;
+    private pageHideHandler;
+    /** Per-session token totals, accumulated from each `response.done` event. */
+    private usage;
+    /**
+     * Reverse map: hashed tool id (what OpenAI calls back with) → original host
+     * tool name (what `onToolCall` expects). Populated on every `start()` from
+     * the resolved chat config.
+     */
+    private toolNameById;
+    constructor(config: YakVoiceSessionConfig);
+    /**
+     * Resolve the API origin lazily on each call. The internal-dev flag
+     * (`window.__YAK_INTERNAL_DEV__`) is often set in a `useEffect` that fires
+     * after this session is constructed, so resolving at construction would
+     * bake in the production URL.
+     */
+    private get apiOrigin();
+    /** Update mutable config fields (handlers, getConfig). */
+    updateConfig(patch: Partial<YakVoiceSessionConfig>): void;
+    getState(): VoiceMachine;
+    /**
+     * The current API origin (`chat.yak.io`, `chat.yak.supply`, or
+     * `http://localhost:3001` when `__YAK_INTERNAL_DEV__` is set). Useful for
+     * building URLs to static assets like the brand logo.
+     */
+    getApiOrigin(): string;
+    onStateChange(listener: VoiceStateListener): () => void;
+    /**
+     * Begin a voice session. Should be invoked from a user gesture (button
+     * click) so `getUserMedia` and audio playback both have transient activation.
+     */
+    start(): Promise<void>;
+    /** Stop the session and tear down all resources. */
+    stop(): Promise<void>;
+    /** Tear down everything and remove listeners. Call once before discarding the instance. */
+    destroy(): void;
+    private buildMessageContext;
+    private accumulateUsage;
+    private sendOverDataChannel;
+    private routeToolCall;
+    /**
+     * Relay an MCP tool call to the server, which holds the org's credentials
+     * and executes against the remote MCP server. The browser only ever passes
+     * through the tool name, args, and the opaque result.
+     */
+    private execMcpTool;
+    private mintToken;
+    /**
+     * Decorate the host's tool manifest + schema sources with hashed ids and
+     * populate `this.toolNameById` for reverse lookup. Mirrors the decoration
+     * the chat-ui iframe applies before sending tools to `/api/chat`.
+     */
+    private buildDecoratedManifest;
+    private exchangeSdp;
+    private buildStopEventBody;
+    private postSessionEvent;
+    private teardown;
+    private failWith;
+    private dispatch;
+    private safeExtractPageContext;
+    private attachPageHide;
+}
+//# sourceMappingURL=voice-session.d.ts.map

package/dist/voice-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-session.d.ts","sourceRoot":"","sources":["../src/voice-session.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,KAAK,EAEV,oBAAoB,EAEpB,iBAAiB,EACjB,eAAe,EAEhB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAKL,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC;CACF;AAkBD,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;AAEjE,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,mBAAmB,CAAC,EAAE,oBAAoB,CAAC;IAC3C,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IACrC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2DD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,eAAe,CAA6B;IACpD,6EAA6E;IAC7E,OAAO,CAAC,KAAK,CAAkC;IAC/C;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAA6B;gBAErC,MAAM,EAAE,qBAAqB;IAKzC;;;;;OAKG;IACH,OAAO,KAAK,SAAS,GAEpB;IAED,0DAA0D;IACnD,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI;IAIzD,QAAQ,IAAI,YAAY;IAI/B;;;;OAIG;IACI,YAAY,IAAI,MAAM;IAItB,aAAa,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAO9D;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+InC,oDAAoD;IACvC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC,2FAA2F;IACpF,OAAO,IAAI,IAAI;IAWtB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,mBAAmB;YAeb,aAAa;IAsC3B;;;;OAIG;YACW,WAAW;YAwBX,SAAS;IAuBvB;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;YA4BhB,WAAW;IAmBzB,OAAO,CAAC,kBAAkB;YAWZ,gBAAgB;YA2BhB,QAAQ;YAuCR,QAAQ;IAMtB,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,cAAc;CAevB"}