@tidblink/server 0.0.0-stage → 0.4.0-rc.0

package/dist/skills.js.map

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

package/dist/sse.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Decode data frames only. A frame is complete only at its blank line.
+ * `onBytes` runs for every chunk read, including comment-only keep-alives.
+ */
+export declare function decodeSse(body: ReadableStream<Uint8Array>, onBytes?: () => void): AsyncGenerator<{
+    id: string;
+    event: string;
+    data: string;
+}>;
+//# sourceMappingURL=sse.d.ts.map

package/dist/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAuB,SAAS,CAC9B,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,OAAO,CAAC,EAAE,MAAM,IAAI,GACnB,cAAc,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAwCD"}

package/dist/sse.js

@@ -0,0 +1,50 @@
+/**
+ * Decode data frames only. A frame is complete only at its blank line.
+ * `onBytes` runs for every chunk read, including comment-only keep-alives.
+ */
+export async function* decodeSse(body, onBytes) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder("utf-8", { fatal: true });
+    let buffer = "";
+    let id = "";
+    let event = "";
+    let data = [];
+    try {
+        while (true) {
+            const chunk = await reader.read();
+            if (!chunk.done)
+                onBytes?.();
+            buffer += decoder.decode(chunk.value, { stream: !chunk.done });
+            let end;
+            while ((end = buffer.search(/[\r\n]/)) !== -1) {
+                if (buffer[end] === "\r" && end === buffer.length - 1 && !chunk.done)
+                    break;
+                const line = buffer.slice(0, end);
+                buffer = buffer.slice(end + (buffer.slice(end, end + 2) === "\r\n" ? 2 : 1));
+                if (line === "") {
+                    if (data.length)
+                        yield { id, event, data: data.join("\n") };
+                    event = "";
+                    data = [];
+                    continue;
+                }
+                const separator = line.indexOf(":");
+                const field = separator === -1 ? line : line.slice(0, separator);
+                const value = separator === -1 ? "" : line.slice(separator + 1).replace(/^ /, "");
+                if (field === "data")
+                    data.push(value);
+                else if (field === "event")
+                    event = value;
+                else if (field === "id" && !value.includes("\0"))
+                    id = value;
+            }
+            if (chunk.done)
+                return;
+        }
+    }
+    finally {
+        await reader.cancel().catch(() => undefined);
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/sse.js.map

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

package/dist/template-switch.d.ts

@@ -0,0 +1,51 @@
+import { HttpClient } from "./http.js";
+import type { RequestOptions } from "./organization.js";
+export interface SwitchTemplateInput extends RequestOptions {
+    /** The active Template the Session moves to. */
+    templateId: string;
+    /** Keep the same key and input to recover a lost response. */
+    idempotencyKey: string;
+    /** Required as `true` when the target Template enables cross-Session Recall. */
+    acknowledgeSessionRecall?: boolean;
+}
+declare const STATUSES: readonly ["pending", "succeeded", "failed", "unchanged"];
+/**
+ * `pending`: a Handoff Turn runs under the target Template; `succeeded`: the
+ * Session is on the target; `failed`: it stays on its previous Template;
+ * `unchanged`: the target matched the current configuration.
+ */
+export type TemplateSwitchStatus = (typeof STATUSES)[number];
+interface TemplateSwitchReceiptBase {
+    commandId: string;
+    sessionId: string;
+    /** The target Template. */
+    agentTemplateId: string;
+    /** The epoch the switch started from; after `succeeded`, the new current epoch. */
+    configurationEpoch: number;
+    createdAt: string;
+    completedAt?: string;
+}
+export type TemplateSwitchReceipt = (TemplateSwitchReceiptBase & {
+    status: "pending";
+    /** The running Handoff Turn, a `kind: "template_handoff"` Turn. */
+    handoffTurnId: string;
+    error?: never;
+}) | (TemplateSwitchReceiptBase & {
+    status: "succeeded";
+    /** Absent when the Session had no history and no Handoff ran. */
+    handoffTurnId?: string;
+    error?: never;
+}) | (TemplateSwitchReceiptBase & {
+    status: "failed";
+    handoffTurnId?: string;
+    error: {
+        code: "session_switch_conflict" | "agent_template_unavailable" | "session_switch_unsupported";
+    };
+}) | (TemplateSwitchReceiptBase & {
+    status: "unchanged";
+    handoffTurnId?: never;
+    error?: never;
+});
+export declare function switchTemplate(http: HttpClient, sessionId: string, input: SwitchTemplateInput): Promise<TemplateSwitchReceipt>;
+export {};
+//# sourceMappingURL=template-switch.d.ts.map

package/dist/template-switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-switch.d.ts","sourceRoot":"","sources":["../src/template-switch.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EAIX,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,QAAA,MAAM,QAAQ,0DAA2D,CAAC;AAE1E;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,UAAU,yBAAyB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,qBAAqB,GAC7B,CAAC,yBAAyB,GAAG;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC,GACF,CAAC,yBAAyB,GAAG;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC,GACF,CAAC,yBAAyB,GAAG;IAC3B,MAAM,EAAE,QAAQ,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE;QACL,IAAI,EACA,yBAAyB,GACzB,4BAA4B,GAC5B,4BAA4B,CAAC;KAClC,CAAC;CACH,CAAC,GACF,CAAC,yBAAyB,GAAG;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC,CAAC;AAyCP,wBAAsB,cAAc,CAClC,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,qBAAqB,CAAC,CAqEhC"}

package/dist/template-switch.js

@@ -0,0 +1,81 @@
+import { OutcomeUnknownError, TiDBLinkApiError } from "./errors.js";
+import { HttpClient, requireCreationKey, requireKnownKeys, requireTemplateId, } from "./http.js";
+const STATUSES = ["pending", "succeeded", "failed", "unchanged"];
+/** 503 codes the service returns before it records the switch. */
+const REFUSED_BEFORE_RECORDING = new Set([
+    "turn_admission_closed",
+    "skill_package_store_unavailable",
+]);
+const isText = (value) => typeof value === "string" && value.length > 0;
+const isReceipt = (value, sessionId, templateId) => {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const receipt = value;
+    if (!isText(receipt.commandId) ||
+        receipt.sessionId !== sessionId ||
+        receipt.agentTemplateId !== templateId ||
+        typeof receipt.createdAt !== "string" ||
+        !Number.isInteger(receipt.configurationEpoch) ||
+        receipt.configurationEpoch < 1 ||
+        !STATUSES.includes(receipt.status))
+        return false;
+    if (receipt.status === "pending")
+        return isText(receipt.handoffTurnId);
+    if (receipt.status === "failed") {
+        const error = receipt.error;
+        return typeof error === "object" && error !== null && isText(error.code);
+    }
+    if (receipt.status === "unchanged")
+        return receipt.handoffTurnId === undefined;
+    return true;
+};
+const RECOVER = "repeat it with the same idempotencyKey and input to recover its receipt";
+export async function switchTemplate(http, sessionId, input) {
+    requireKnownKeys(input, [
+        "templateId",
+        "idempotencyKey",
+        "acknowledgeSessionRecall",
+        "signal",
+        "requestId",
+    ], "Template switch input");
+    requireTemplateId(input.templateId, "Template switch");
+    requireCreationKey(input.idempotencyKey, "Template switch");
+    const { templateId, idempotencyKey, acknowledgeSessionRecall, signal, requestId, } = input;
+    if (acknowledgeSessionRecall !== undefined &&
+        typeof acknowledgeSessionRecall !== "boolean")
+        throw new TypeError("acknowledgeSessionRecall must be a boolean");
+    let result;
+    try {
+        result = await http.postResponse(`/sessions/${encodeURIComponent(sessionId)}/template-switches`, {
+            agentTemplateId: templateId,
+            ...(acknowledgeSessionRecall === undefined
+                ? {}
+                : { acknowledgeSessionRecall }),
+        }, {
+            idempotencyKey,
+            idempotent: true,
+            outcomeUnknown: true,
+            ...(signal ? { signal } : {}),
+            ...(requestId ? { requestId } : {}),
+        });
+    }
+    catch (error) {
+        if (!(error instanceof OutcomeUnknownError))
+            throw error;
+        const cause = error.cause;
+        if (cause instanceof TiDBLinkApiError &&
+            cause.status === 503 &&
+            REFUSED_BEFORE_RECORDING.has(cause.code))
+            throw cause;
+        throw new OutcomeUnknownError(`Template switch outcome is unknown; ${RECOVER}`, {
+            sessionId,
+            ...(error.requestId ? { requestId: error.requestId } : {}),
+            cause: error,
+        });
+    }
+    const receipt = result.data?.receipt;
+    if (!isReceipt(receipt, sessionId, templateId))
+        throw new OutcomeUnknownError(`Template switch returned no usable receipt; ${RECOVER}`, { requestId: result.requestId, sessionId });
+    return receipt;
+}
+//# sourceMappingURL=template-switch.js.map

package/dist/template-switch.js.map

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

package/dist/templates.d.ts

@@ -0,0 +1,129 @@
+import { HttpClient } from "./http.js";
+import type { RequestOptions } from "./organization.js";
+export type TemplateRealtimeLanguage = "zh-CN" | "en-US";
+/**
+ * The definition of an Agent Template. Fields the SDK does not model are
+ * returned and accepted unchanged.
+ */
+export interface TemplateContent {
+    schemaVersion?: "agent-template-content@7";
+    identity: {
+        agentName: string;
+        description?: string;
+    };
+    instructions?: string;
+    /** A Sandbox profile from `templates.catalog()`. */
+    sandbox: {
+        profileId: string;
+    };
+    /** The language of voice conversations on Sessions created from it. */
+    realtime: {
+        language: TemplateRealtimeLanguage;
+    };
+    /** Published Skill versions from `skills` or `templates.catalog()`. */
+    skills?: {
+        skillId: string;
+        version: number;
+    }[];
+    capabilities?: {
+        sessionRecall?: {
+            enabled?: boolean;
+        };
+    };
+    /**
+     * Organization MCP Servers and Connectors the Template uses, by `serverId`.
+     * On replace, omitting `tools` keeps the current references.
+     */
+    tools?: {
+        mcp: {
+            serverId: string;
+        }[];
+    };
+    /** A task the voice model keeps working on across a Realtime connection. */
+    standingTask?: {
+        goal: string;
+    };
+    [field: string]: unknown;
+}
+export interface TemplateSummary {
+    id: string;
+    organizationId: string;
+    name: string;
+    displayName: string;
+    sandboxProfile: string;
+    lifecycleStatus: "active" | "archived";
+    /** Pass this exact value as `ifMatch` to replace or archive the Template. */
+    etag: string;
+    contentDigest: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Template {
+    template: TemplateSummary;
+    content: TemplateContent;
+}
+export interface TemplatePage {
+    data: TemplateSummary[];
+    hasMore: boolean;
+    nextCursor: string | null;
+    readAt: string;
+}
+export interface TemplateListOptions extends RequestOptions {
+    sort?: "updated_desc" | "created_desc" | "name_asc";
+    /** Defaults to the service's choice when omitted. */
+    lifecycleStatus?: "all" | "active" | "archived";
+    /** Text search over Template names. */
+    q?: string;
+    limit?: number;
+    cursor?: string;
+}
+/** What a Template may reference in this Organization. */
+export interface TemplateCatalog {
+    models: {
+        id: string;
+        available: boolean;
+    }[];
+    sandboxes: {
+        id: string;
+        label: string;
+        capabilities: string[];
+    }[];
+    skills: {
+        skillId: string;
+        name: string;
+        description: string;
+        version: number;
+        available: boolean;
+    }[];
+}
+export interface TemplateInput {
+    displayName: string;
+    content: TemplateContent;
+}
+export interface CreateTemplateInput extends TemplateInput, RequestOptions {
+    /** Keep the same key and input when recovering an uncertain creation. */
+    idempotencyKey: string;
+}
+export interface TemplateMutationOptions extends RequestOptions {
+    /** The `etag` of the Template version you read. A stale value is refused with ConflictError. */
+    ifMatch: string;
+    /** Keep the same key and input when recovering an uncertain change. */
+    idempotencyKey: string;
+}
+/** Organization Agent Templates: what Sessions are created from. */
+export declare class Templates {
+    #private;
+    constructor(http: HttpClient);
+    list(options?: TemplateListOptions): Promise<TemplatePage>;
+    get(templateId: string, options?: RequestOptions): Promise<Template>;
+    /** Models, Sandbox profiles and published Skills a Template may use. */
+    catalog(options?: RequestOptions & {
+        limit?: number;
+    }): Promise<TemplateCatalog>;
+    create(input: CreateTemplateInput): Promise<Template>;
+    /** Replace the whole definition. Sessions already created keep their snapshot. */
+    replace(templateId: string, input: TemplateInput, options: TemplateMutationOptions): Promise<Template>;
+    /** Archive the Template; it can no longer be used to create Sessions. */
+    archive(templateId: string, options: TemplateMutationOptions): Promise<Template>;
+}
+//# sourceMappingURL=templates.d.ts.map

package/dist/templates.d.ts.map

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

package/dist/templates.js

@@ -0,0 +1,92 @@
+import { OutcomeUnknownError } from "./errors.js";
+import { HttpClient, requireCreationKey, requireKnownKeys, requestOptions, } from "./http.js";
+const templatePath = (id) => `/agent-templates/${encodeURIComponent(id)}`;
+const templateReceipt = (result) => {
+    if (typeof result.data?.template?.id !== "string" ||
+        !result.data.template.id ||
+        typeof result.data.content !== "object" ||
+        result.data.content === null)
+        throw new OutcomeUnknownError("Template mutation returned no usable Template; repeat it with the same idempotency key", { requestId: result.requestId });
+    return result.data;
+};
+const requireTemplateInput = (input, label) => {
+    if (typeof input.displayName !== "string" || !input.displayName.trim())
+        throw new TypeError(`${label} requires a displayName`);
+    if (typeof input.content !== "object" ||
+        input.content === null ||
+        Array.isArray(input.content))
+        throw new TypeError(`${label} requires content`);
+};
+const requireMutationOptions = (options, label) => {
+    requireKnownKeys(options, ["ifMatch", "idempotencyKey", "signal", "requestId"], `${label} options`);
+    if (typeof options.ifMatch !== "string" || !options.ifMatch)
+        throw new TypeError(`${label} requires ifMatch`);
+    requireCreationKey(options.idempotencyKey);
+};
+/** Organization Agent Templates: what Sessions are created from. */
+export class Templates {
+    #http;
+    constructor(http) {
+        this.#http = http;
+    }
+    async list(options = {}) {
+        requireKnownKeys(options, ["sort", "lifecycleStatus", "q", "limit", "cursor", "signal", "requestId"], "Template list options");
+        const { signal, requestId, ...filters } = options;
+        const query = new URLSearchParams();
+        for (const [key, value] of Object.entries(filters))
+            if (value !== undefined)
+                query.set(key, String(value));
+        return this.#http.get(`/agent-templates${query.size ? `?${query}` : ""}`, { ...(signal ? { signal } : {}), ...(requestId ? { requestId } : {}) });
+    }
+    get(templateId, options) {
+        return this.#http.get(templatePath(templateId), requestOptions(options));
+    }
+    /** Models, Sandbox profiles and published Skills a Template may use. */
+    catalog(options) {
+        requireKnownKeys(options ?? {}, ["limit", "signal", "requestId"], "Template catalog options");
+        const { limit, ...request } = options ?? {};
+        return this.#http.get(`/agent-template-reference-catalog${limit === undefined ? "" : `?limit=${limit}`}`, request);
+    }
+    async create(input) {
+        requireKnownKeys(input, ["displayName", "content", "idempotencyKey", "signal", "requestId"], "Template creation");
+        requireTemplateInput(input, "Template creation");
+        requireCreationKey(input.idempotencyKey);
+        const { idempotencyKey, signal, requestId, ...body } = input;
+        return templateReceipt(await this.#http.postResponse("/agent-templates", body, {
+            idempotencyKey,
+            idempotent: true,
+            outcomeUnknown: true,
+            ...(signal ? { signal } : {}),
+            ...(requestId ? { requestId } : {}),
+        }));
+    }
+    /** Replace the whole definition. Sessions already created keep their snapshot. */
+    async replace(templateId, input, options) {
+        requireKnownKeys(input, ["displayName", "content"], "Template replacement");
+        requireTemplateInput(input, "Template replacement");
+        requireMutationOptions(options, "Template replacement");
+        const { ifMatch, idempotencyKey, ...request } = options;
+        return templateReceipt(await this.#http.response(templatePath(templateId), {
+            method: "PUT",
+            body: input,
+            ifMatch,
+            idempotencyKey,
+            retry: "safe",
+            outcomeUnknown: true,
+            ...request,
+        }));
+    }
+    /** Archive the Template; it can no longer be used to create Sessions. */
+    async archive(templateId, options) {
+        requireMutationOptions(options, "Template archive");
+        const { ifMatch, idempotencyKey, ...request } = options;
+        return templateReceipt(await this.#http.postResponse(`${templatePath(templateId)}/archive`, {}, {
+            ifMatch,
+            idempotencyKey,
+            idempotent: true,
+            outcomeUnknown: true,
+            ...request,
+        }));
+    }
+}
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

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

package/dist/turn.d.ts

@@ -0,0 +1,47 @@
+import { HttpClient } from "./http.js";
+import { type SessionInteraction } from "./history.js";
+import type { BillingTag, ClarificationItem } from "./session.js";
+export interface CreateTurnInput {
+    /** Persist this Session-local command identity before dispatch. */
+    clientEventId: string;
+    text: string | [string, ...string[]];
+    userFileIds?: string[];
+    clarificationSourceTurnId?: string;
+    billingTag?: BillingTag | null;
+    requestId?: string;
+    signal?: AbortSignal;
+}
+export interface WaitForResultOptions {
+    /** Local deadline only; default 60 seconds. Never cancels execution. */
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    requestId?: string;
+    signal?: AbortSignal;
+}
+type ResultIdentity = {
+    sessionId: string;
+    inputId: string;
+    turnId: string;
+    messageId: string;
+    text: string;
+    interaction: SessionInteraction;
+};
+export type TurnResult = ResultIdentity & ({
+    type: "answer";
+} | {
+    type: "clarification";
+    clarification: ClarificationItem;
+});
+export declare const validClarification: (value: unknown) => value is ClarificationItem;
+/** The message command's data the REST route and `session.send` share. */
+export type MessageData = Omit<CreateTurnInput, "clientEventId" | "requestId" | "signal">;
+/** Check message data before dispatch. */
+export declare function validateMessageData(data: MessageData): void;
+export declare const submitMessage: (http: HttpClient, sessionId: string, input: CreateTurnInput) => Promise<SessionInteraction>;
+export declare const validateWaitOptions: (options?: WaitForResultOptions) => {
+    timeoutMs: number;
+    pollIntervalMs: number;
+};
+export declare const waitForResult: (http: HttpClient, sessionId: string, inputId: string, options?: WaitForResultOptions) => Promise<TurnResult>;
+export {};
+//# sourceMappingURL=turn.d.ts.map

package/dist/turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn.d.ts","sourceRoot":"","sources":["../src/turn.ts"],"names":[],"mappings":"AASA,OAAO,EACL,UAAU,EAIX,MAAM,WAAW,CAAC;AACnB,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAElE,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,KAAK,cAAc,GAAG;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,kBAAkB,CAAC;CACjC,CAAC;AACF,MAAM,MAAM,UAAU,GAAG,cAAc,GACrC,CACI;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,aAAa,EAAE,iBAAiB,CAAA;CAAE,CAC9D,CAAC;AAEJ,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,iBAkC5D,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,EAAE,eAAe,GAAG,WAAW,GAAG,QAAQ,CAAC,CAAC;AAE1F,0CAA0C;AAC1C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CA2B3D;AAED,eAAO,MAAM,aAAa,GACxB,MAAM,UAAU,EAChB,WAAW,MAAM,EACjB,OAAO,eAAe,KACrB,OAAO,CAAC,kBAAkB,CA0D5B,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,UAAS,oBAAyB,KACjC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAyB7C,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,MAAM,UAAU,EAChB,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,UAAS,oBAAyB,KACjC,OAAO,CAAC,UAAU,CAwHpB,CAAC"}