@turingfocus/chat-protocol 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 A2C-SMCP contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/ask-user.d.ts

@@ -0,0 +1,11 @@
+import type { AskUserInteractionAnswer, AskUserInteractionQuestion, AskUserInteractionRequest, AskUserInteractionValue } from "./models.js";
+export declare const ASK_USER_MAX_ANSWER_VALUES = 100;
+export declare const ASK_USER_MAX_OPTIONS = 100;
+export declare const ASK_USER_MAX_QUESTIONS = 20;
+export declare const ASK_USER_MAX_QUESTION_ID_CHARACTERS = 256;
+export declare const ASK_USER_MAX_REQUEST_ID_CHARACTERS = 256;
+export declare const ASK_USER_MAX_TEXT_CHARACTERS = 2000;
+export declare const isSafeAskUserQuestionId: (value: string) => boolean;
+export declare const isAskUserInteractionValueCompatible: (question: AskUserInteractionQuestion, value: AskUserInteractionValue) => boolean;
+export declare const getAskUserInteractionAnswerValidationError: (request: AskUserInteractionRequest, answer: AskUserInteractionAnswer) => string | undefined;
+//# sourceMappingURL=ask-user.d.ts.map

package/dist/ask-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user.d.ts","sourceRoot":"","sources":["../src/ask-user.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,mCAAmC,MAAM,CAAC;AACvD,eAAO,MAAM,kCAAkC,MAAM,CAAC;AACtD,eAAO,MAAM,4BAA4B,OAAQ,CAAC;AAIlD,eAAO,MAAM,uBAAuB,GAAI,OAAO,MAAM,KAAG,OACH,CAAC;AAKtD,eAAO,MAAM,mCAAmC,GAC9C,UAAU,0BAA0B,EACpC,OAAO,uBAAuB,KAC7B,OAYF,CAAC;AAEF,eAAO,MAAM,0CAA0C,GACrD,SAAS,yBAAyB,EAClC,QAAQ,wBAAwB,KAC/B,MAAM,GAAG,SA+BX,CAAC"}

package/dist/ask-user.js

@@ -0,0 +1,49 @@
+export const ASK_USER_MAX_ANSWER_VALUES = 100;
+export const ASK_USER_MAX_OPTIONS = 100;
+export const ASK_USER_MAX_QUESTIONS = 20;
+export const ASK_USER_MAX_QUESTION_ID_CHARACTERS = 256;
+export const ASK_USER_MAX_REQUEST_ID_CHARACTERS = 256;
+export const ASK_USER_MAX_TEXT_CHARACTERS = 2_000;
+const reservedQuestionIds = new Set(["__proto__", "constructor", "prototype"]);
+export const isSafeAskUserQuestionId = (value) => value.length > 0 && !reservedQuestionIds.has(value);
+const valueParts = (value) => typeof value === "string" ? [value] : value;
+export const isAskUserInteractionValueCompatible = (question, value) => {
+    if (question.multiple !== Array.isArray(value))
+        return false;
+    const parts = valueParts(value);
+    if (question.required &&
+        (parts.length === 0 || parts.some((part) => part.length === 0))) {
+        return false;
+    }
+    if (question.options.length === 0)
+        return true;
+    const allowedValues = new Set(question.options.map((option) => option.value));
+    return parts.every((part) => allowedValues.has(part));
+};
+export const getAskUserInteractionAnswerValidationError = (request, answer) => {
+    if (answer.action !== "submit")
+        return undefined;
+    const questions = new Map(request.questions.map((question) => [question.id, question]));
+    if (Object.keys(answer.answers).some((questionId) => !questions.has(questionId))) {
+        return "Interaction answers contain an unknown question";
+    }
+    for (const question of request.questions) {
+        if (!Object.hasOwn(answer.answers, question.id)) {
+            if (question.required) {
+                return "Interaction answers omit a required question";
+            }
+            continue;
+        }
+        const value = answer.answers[question.id];
+        if (typeof value !== "string" &&
+            (!Array.isArray(value) ||
+                value.some((candidate) => typeof candidate !== "string"))) {
+            return "Interaction answer values must be strings";
+        }
+        if (!isAskUserInteractionValueCompatible(question, value)) {
+            return "Interaction answer values do not match their question";
+        }
+    }
+    return undefined;
+};
+//# sourceMappingURL=ask-user.js.map

package/dist/ask-user.js.map

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

package/dist/gateway.d.ts

@@ -0,0 +1,141 @@
+import type { AskUserInteractionAnswer, Capabilities, ChatError, ChatSnapshot, ChatUpdate, Conversation, ConversationId, Run, RunId } from "./models.js";
+export type MaybePromise<T> = PromiseLike<T> | T;
+export interface GatewayRequestOptions {
+    /**
+     * Unix epoch milliseconds by which the operation must settle. Adapters must
+     * return createGatewayDeadlineExceededError after the deadline, settle only
+     * once, and discard a late result. For subscribe this governs establishment;
+     * a late subscription must be disposed without notifying its observer.
+     */
+    readonly deadlineAt: number;
+}
+export declare const isGatewayDeadlineExceeded: (options: GatewayRequestOptions, now?: number) => boolean;
+export declare const createGatewayDeadlineExceededError: (conversationId?: ConversationId) => ChatError;
+export interface ListConversationsInput extends GatewayRequestOptions {
+    readonly cursor?: string | undefined;
+    readonly limit?: number | undefined;
+}
+export interface ConversationPage {
+    readonly conversations: readonly Conversation[];
+    readonly nextCursor?: string | undefined;
+}
+export type GatewayResult<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly error: ChatError;
+};
+export type GatewayOperation = "answerInteraction" | "interrupt" | "listConversations" | "loadHistory" | "sendText" | "subscribe";
+/**
+ * Maps normalized capabilities to executable Gateway operations. Adapters use
+ * this before dispatch and return a structured `unsupported` GatewayResult
+ * when it returns false. Initial snapshot loading is always allowed; only a
+ * request carrying `previousCursor` is a `loadHistory` operation.
+ */
+export declare const isGatewayOperationSupported: (capabilities: Capabilities, operation: GatewayOperation, run?: Run | null) => boolean;
+export interface LoadConversationInput extends GatewayRequestOptions {
+    readonly conversationId: ConversationId;
+    readonly previousCursor?: string | undefined;
+    readonly limit?: number | undefined;
+}
+export interface SubscribeConversationInput extends GatewayRequestOptions {
+    readonly conversationId: ConversationId;
+}
+export interface SendTextInput extends GatewayRequestOptions {
+    readonly conversationId: ConversationId;
+    readonly text: string;
+    /** Optional stable ID supplied by a Runtime or host for idempotent mapping. */
+    readonly clientMessageId?: string | undefined;
+}
+export interface SendTextSuccess {
+    /** ID of the run started by the accepted message. */
+    readonly runId: RunId;
+}
+export interface InterruptRunInput extends GatewayRequestOptions {
+    readonly conversationId: ConversationId;
+    /** Protects against interrupting a newer run when the caller has a known ID. */
+    readonly runId?: RunId | undefined;
+}
+export interface InterruptRunSuccess {
+    /** ID of the cancellation operation, which is not the interrupted run ID. */
+    readonly cancellationId: string;
+    readonly interruptedRunId?: RunId | undefined;
+}
+export interface AnswerInteractionInput extends GatewayRequestOptions {
+    readonly conversationId: ConversationId;
+    readonly answer: AskUserInteractionAnswer;
+}
+export interface AnswerInteractionSuccess {
+    readonly requestId: string;
+    readonly revision: string;
+}
+export interface GatewayObserver {
+    next(update: ChatUpdate): void;
+    error?(error: ChatError): void;
+}
+export interface GatewaySubscription {
+    /**
+     * Becomes silent synchronously and settles cleanup no later than deadlineAt.
+     * Implementations must resolve at the deadline and abandon late transport
+     * cleanup rather than blocking a conversation switch.
+     */
+    dispose(options: GatewayRequestOptions): MaybePromise<void>;
+}
+/**
+ * Host- and transport-agnostic port consumed by Chat Runtime instances.
+ * Implementations own their connection and must become silent after dispose.
+ */
+export interface ChatGateway {
+    /**
+     * Optional during migration. Runtime dispatches only when both the normalized
+     * capability and this method are present.
+     */
+    answerInteraction?(input: AnswerInteractionInput): Promise<GatewayResult<AnswerInteractionSuccess>>;
+    listConversations(input: ListConversationsInput): Promise<GatewayResult<ConversationPage>>;
+    loadConversation(input: LoadConversationInput): Promise<GatewayResult<ChatSnapshot>>;
+    subscribe(input: SubscribeConversationInput, observer: GatewayObserver): MaybePromise<GatewayResult<GatewaySubscription>>;
+    sendText(input: SendTextInput): Promise<GatewayResult<SendTextSuccess>>;
+    interrupt(input: InterruptRunInput): Promise<GatewayResult<InterruptRunSuccess>>;
+    /**
+     * Becomes silent synchronously, is idempotent, and settles no later than the
+     * supplied deadline even if transport cleanup never completes.
+     */
+    dispose(options: GatewayRequestOptions): MaybePromise<void>;
+}
+export type SessionPurpose = "connect" | "reconnect" | "request";
+export type SessionOperation = "read" | "send" | "subscribe";
+export interface SessionRequest {
+    readonly purpose: SessionPurpose;
+    readonly operation: SessionOperation;
+    readonly conversationId?: ConversationId | undefined;
+}
+export type SessionInvalidationReason = "expired" | "forbidden" | "rejected" | "unknown";
+export interface SessionInvalidation {
+    readonly reason: SessionInvalidationReason;
+    readonly error: ChatError;
+}
+/**
+ * The session value is opaque to Protocol. A concrete Gateway defines its
+ * short-lived material while the host remains responsible for refresh/login.
+ */
+export interface SessionProvider<TSession> {
+    getSession(request: SessionRequest): MaybePromise<TSession>;
+    onSessionInvalid?(invalidation: SessionInvalidation): MaybePromise<void>;
+}
+export declare const listConversationsInputSchema: import("./schema.js").RuntimeSchema<ListConversationsInput>;
+export declare const gatewayRequestOptionsSchema: import("./schema.js").RuntimeSchema<GatewayRequestOptions>;
+export declare const conversationPageSchema: import("./schema.js").RuntimeSchema<ConversationPage>;
+export declare const conversationPageResultSchema: import("./schema.js").RuntimeSchema<GatewayResult<ConversationPage>>;
+export declare const loadConversationInputSchema: import("./schema.js").RuntimeSchema<LoadConversationInput>;
+export declare const loadConversationResultSchema: import("./schema.js").RuntimeSchema<GatewayResult<ChatSnapshot>>;
+export declare const subscribeConversationInputSchema: import("./schema.js").RuntimeSchema<SubscribeConversationInput>;
+export declare const sendTextInputSchema: import("./schema.js").RuntimeSchema<SendTextInput>;
+export declare const sendTextResultSchema: import("./schema.js").RuntimeSchema<GatewayResult<SendTextSuccess>>;
+export declare const interruptRunInputSchema: import("./schema.js").RuntimeSchema<InterruptRunInput>;
+export declare const interruptRunResultSchema: import("./schema.js").RuntimeSchema<GatewayResult<InterruptRunSuccess>>;
+export declare const answerInteractionInputSchema: import("./schema.js").RuntimeSchema<AnswerInteractionInput>;
+export declare const answerInteractionResultSchema: import("./schema.js").RuntimeSchema<GatewayResult<AnswerInteractionSuccess>>;
+export declare const sessionRequestSchema: import("./schema.js").RuntimeSchema<SessionRequest>;
+export declare const sessionInvalidationSchema: import("./schema.js").RuntimeSchema<SessionInvalidation>;
+//# sourceMappingURL=gateway.d.ts.map

package/dist/gateway.d.ts.map

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

package/dist/gateway.js

@@ -0,0 +1,121 @@
+import { z } from "zod/v4";
+import { askUserInteractionAnswerParser, chatErrorParser, chatSnapshotParser, conversationParser, } from "./internal-schemas.js";
+import { ASK_USER_MAX_REQUEST_ID_CHARACTERS } from "./ask-user.js";
+import { createRuntimeSchema } from "./internal-runtime-schema.js";
+export const isGatewayDeadlineExceeded = (options, now = Date.now()) => now >= options.deadlineAt;
+export const createGatewayDeadlineExceededError = (conversationId) => {
+    const error = {
+        code: "timeout",
+        message: "Gateway operation exceeded its deadline",
+        retryable: true,
+    };
+    return conversationId === undefined ? error : { ...error, conversationId };
+};
+/**
+ * Maps normalized capabilities to executable Gateway operations. Adapters use
+ * this before dispatch and return a structured `unsupported` GatewayResult
+ * when it returns false. Initial snapshot loading is always allowed; only a
+ * request carrying `previousCursor` is a `loadHistory` operation.
+ */
+export const isGatewayOperationSupported = (capabilities, operation, run) => {
+    switch (operation) {
+        case "answerInteraction":
+            return capabilities.answerInteraction === true;
+        case "interrupt":
+            return (capabilities.interrupt &&
+                run?.canInterrupt === true &&
+                run.status === "running");
+        case "listConversations":
+            return capabilities.listConversations;
+        case "loadHistory":
+            return capabilities.loadHistory;
+        case "sendText":
+            return capabilities.sendText;
+        case "subscribe":
+            return capabilities.liveUpdates;
+    }
+};
+const positiveLimitParser = z.number().int().positive();
+const deadlineParser = z
+    .number()
+    .int()
+    .nonnegative()
+    .max(Number.MAX_SAFE_INTEGER);
+const gatewayRequestOptionsParser = z.object({
+    deadlineAt: deadlineParser,
+});
+const listConversationsInputParser = z.object({
+    cursor: z.string().optional(),
+    limit: positiveLimitParser.optional(),
+    deadlineAt: deadlineParser,
+});
+const conversationPageParser = z.object({
+    conversations: z.array(conversationParser),
+    nextCursor: z.string().optional(),
+});
+const loadConversationInputParser = z.object({
+    conversationId: z.string().min(1),
+    previousCursor: z.string().optional(),
+    limit: positiveLimitParser.optional(),
+    deadlineAt: deadlineParser,
+});
+const subscribeConversationInputParser = z.object({
+    conversationId: z.string().min(1),
+    deadlineAt: deadlineParser,
+});
+const sendTextInputParser = z.object({
+    conversationId: z.string().min(1),
+    text: z.string().min(1),
+    clientMessageId: z.string().min(1).optional(),
+    deadlineAt: deadlineParser,
+});
+const sendTextSuccessParser = z.object({
+    runId: z.string().min(1),
+});
+const interruptRunInputParser = z.object({
+    conversationId: z.string().min(1),
+    runId: z.string().min(1).optional(),
+    deadlineAt: deadlineParser,
+});
+const interruptRunSuccessParser = z.object({
+    cancellationId: z.string().min(1),
+    interruptedRunId: z.string().min(1).optional(),
+});
+const answerInteractionInputParser = z.object({
+    conversationId: z.string().min(1),
+    answer: askUserInteractionAnswerParser,
+    deadlineAt: deadlineParser,
+});
+const answerInteractionSuccessParser = z.object({
+    requestId: z.string().min(1).max(ASK_USER_MAX_REQUEST_ID_CHARACTERS),
+    revision: z.string().min(1).max(ASK_USER_MAX_REQUEST_ID_CHARACTERS),
+});
+const gatewayResultParser = (valueParser) => z.discriminatedUnion("ok", [
+    z.object({ ok: z.literal(true), value: valueParser }),
+    z.object({ ok: z.literal(false), error: chatErrorParser }),
+]);
+const sessionRequestParser = z.object({
+    purpose: z.enum(["connect", "reconnect", "request"]),
+    operation: z.enum(["read", "send", "subscribe"]),
+    conversationId: z.string().min(1).optional(),
+});
+const sessionInvalidationParser = z.object({
+    reason: z.enum(["expired", "forbidden", "rejected", "unknown"]),
+    error: chatErrorParser,
+});
+export const listConversationsInputSchema = createRuntimeSchema(listConversationsInputParser);
+export const gatewayRequestOptionsSchema = createRuntimeSchema(gatewayRequestOptionsParser);
+export const conversationPageSchema = createRuntimeSchema(conversationPageParser);
+export const conversationPageResultSchema = createRuntimeSchema(gatewayResultParser(conversationPageParser));
+export const loadConversationInputSchema = createRuntimeSchema(loadConversationInputParser);
+export const loadConversationResultSchema = createRuntimeSchema(gatewayResultParser(chatSnapshotParser));
+export const subscribeConversationInputSchema = createRuntimeSchema(subscribeConversationInputParser);
+export const sendTextInputSchema = createRuntimeSchema(sendTextInputParser);
+export const sendTextResultSchema = createRuntimeSchema(gatewayResultParser(sendTextSuccessParser));
+export const interruptRunInputSchema = createRuntimeSchema(interruptRunInputParser);
+export const interruptRunResultSchema = createRuntimeSchema(gatewayResultParser(interruptRunSuccessParser));
+export const answerInteractionInputSchema = createRuntimeSchema(answerInteractionInputParser);
+export const answerInteractionResultSchema = createRuntimeSchema(gatewayResultParser(answerInteractionSuccessParser));
+export const sessionRequestSchema = createRuntimeSchema(sessionRequestParser);
+export const sessionInvalidationSchema = createRuntimeSchema(sessionInvalidationParser);
+//# sourceMappingURL=gateway.js.map

package/dist/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EACL,8BAA8B,EAC9B,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kCAAkC,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAyBnE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,OAA8B,EAC9B,MAAc,IAAI,CAAC,GAAG,EAAE,EACf,EAAE,CAAC,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;AAExC,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAChD,cAA+B,EACpB,EAAE;IACb,MAAM,KAAK,GAAG;QACZ,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,yCAAyC;QAClD,SAAS,EAAE,IAAI;KACP,CAAC;IACX,OAAO,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,CAAC;AAC7E,CAAC,CAAC;AAwBF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,YAA0B,EAC1B,SAA2B,EAC3B,GAAgB,EACP,EAAE;IACX,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,mBAAmB;YACtB,OAAO,YAAY,CAAC,iBAAiB,KAAK,IAAI,CAAC;QACjD,KAAK,WAAW;YACd,OAAO,CACL,YAAY,CAAC,SAAS;gBACtB,GAAG,EAAE,YAAY,KAAK,IAAI;gBAC1B,GAAG,CAAC,MAAM,KAAK,SAAS,CACzB,CAAC;QACJ,KAAK,mBAAmB;YACtB,OAAO,YAAY,CAAC,iBAAiB,CAAC;QACxC,KAAK,aAAa;YAChB,OAAO,YAAY,CAAC,WAAW,CAAC;QAClC,KAAK,UAAU;YACb,OAAO,YAAY,CAAC,QAAQ,CAAC;QAC/B,KAAK,WAAW;YACd,OAAO,YAAY,CAAC,WAAW,CAAC;IACpC,CAAC;AACH,CAAC,CAAC;AAuHF,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;AACxD,MAAM,cAAc,GAAG,CAAC;KACrB,MAAM,EAAE;KACR,GAAG,EAAE;KACL,WAAW,EAAE;KACb,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAEhC,MAAM,2BAA2B,GAAqC,CAAC,CAAC,MAAM,CAAC;IAC7E,UAAU,EAAE,cAAc;CAC3B,CAAC,CAAC;AAEH,MAAM,4BAA4B,GAChC,CAAC,CAAC,MAAM,CAAC;IACP,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,mBAAmB,CAAC,QAAQ,EAAE;IACrC,UAAU,EAAE,cAAc;CAC3B,CAAC,CAAC;AAEL,MAAM,sBAAsB,GAAgC,CAAC,CAAC,MAAM,CAAC;IACnE,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;IAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH,MAAM,2BAA2B,GAAqC,CAAC,CAAC,MAAM,CAAC;IAC7E,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,KAAK,EAAE,mBAAmB,CAAC,QAAQ,EAAE;IACrC,UAAU,EAAE,cAAc;CAC3B,CAAC,CAAC;AAEH,MAAM,gCAAgC,GACpC,CAAC,CAAC,MAAM,CAAC;IACP,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,UAAU,EAAE,cAAc;CAC3B,CAAC,CAAC;AAEL,MAAM,mBAAmB,GAA6B,CAAC,CAAC,MAAM,CAAC;IAC7D,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7C,UAAU,EAAE,cAAc;CAC3B,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAA+B,CAAC,CAAC,MAAM,CAAC;IACjE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAiC,CAAC,CAAC,MAAM,CAAC;IACrE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,UAAU,EAAE,cAAc;CAC3B,CAAC,CAAC;AAEH,MAAM,yBAAyB,GAAmC,CAAC,CAAC,MAAM,CAAC;IACzE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC/C,CAAC,CAAC;AAEH,MAAM,4BAA4B,GAChC,CAAC,CAAC,MAAM,CAAC;IACP,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,MAAM,EAAE,8BAA8B;IACtC,UAAU,EAAE,cAAc;CAC3B,CAAC,CAAC;AAEL,MAAM,8BAA8B,GAClC,CAAC,CAAC,MAAM,CAAC;IACP,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,kCAAkC,CAAC;IACpE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,kCAAkC,CAAC;CACpE,CAAC,CAAC;AAEL,MAAM,mBAAmB,GAAG,CAC1B,WAAyB,EACI,EAAE,CAC/B,CAAC,CAAC,kBAAkB,CAAC,IAAI,EAAE;IACzB,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IACrD,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;CAC3D,CAAC,CAAC;AAEL,MAAM,oBAAoB,GAA8B,CAAC,CAAC,MAAM,CAAC;IAC/D,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IACpD,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAChD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAEH,MAAM,yBAAyB,GAAmC,CAAC,CAAC,MAAM,CAAC;IACzE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAC/D,KAAK,EAAE,eAAe;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,mBAAmB,CAC7D,4BAA4B,CAC7B,CAAC;AACF,MAAM,CAAC,MAAM,2BAA2B,GAAG,mBAAmB,CAC5D,2BAA2B,CAC5B,CAAC;AACF,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CACvD,sBAAsB,CACvB,CAAC;AACF,MAAM,CAAC,MAAM,4BAA4B,GAAG,mBAAmB,CAC7D,mBAAmB,CAAC,sBAAsB,CAAC,CAC5C,CAAC;AACF,MAAM,CAAC,MAAM,2BAA2B,GAAG,mBAAmB,CAC5D,2BAA2B,CAC5B,CAAC;AACF,MAAM,CAAC,MAAM,4BAA4B,GAAG,mBAAmB,CAC7D,mBAAmB,CAAC,kBAAkB,CAAC,CACxC,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAG,mBAAmB,CACjE,gCAAgC,CACjC,CAAC;AACF,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,mBAAmB,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CACrD,mBAAmB,CAAC,qBAAqB,CAAC,CAC3C,CAAC;AACF,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CACxD,uBAAuB,CACxB,CAAC;AACF,MAAM,CAAC,MAAM,wBAAwB,GAAG,mBAAmB,CACzD,mBAAmB,CAAC,yBAAyB,CAAC,CAC/C,CAAC;AACF,MAAM,CAAC,MAAM,4BAA4B,GAAG,mBAAmB,CAC7D,4BAA4B,CAC7B,CAAC;AACF,MAAM,CAAC,MAAM,6BAA6B,GAAG,mBAAmB,CAC9D,mBAAmB,CAAC,8BAA8B,CAAC,CACpD,CAAC;AACF,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;AAC9E,MAAM,CAAC,MAAM,yBAAyB,GAAG,mBAAmB,CAC1D,yBAAyB,CAC1B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./gateway.js";
+export { ASK_USER_MAX_ANSWER_VALUES, ASK_USER_MAX_OPTIONS, ASK_USER_MAX_QUESTIONS, ASK_USER_MAX_QUESTION_ID_CHARACTERS, ASK_USER_MAX_REQUEST_ID_CHARACTERS, ASK_USER_MAX_TEXT_CHARACTERS, getAskUserInteractionAnswerValidationError, isAskUserInteractionValueCompatible, isSafeAskUserQuestionId, } from "./ask-user.js";
+export { agentEventSchema, askUserInteractionAnswerSchema, askUserInteractionRequestSchema, askUserInteractionResultSchema, capabilitiesSchema, chatErrorSchema, chatSnapshotSchema, chatUpdateSchema, compareTimelineItems, conversationSchema, getTimelineItemKey, hasCompatibleAgentEventMetadata, messageSchema, runSchema, timelineItemSchema, unknownEventSchema, } from "./models.js";
+export { compareAgentEventTransitions } from "./ordering.js";
+export type { AgentEvent, AgentEventStatus, AgentEventTransition, AgentEventTransitionPayload, AgentEventTransitionUpdate, AskUserInteractionAnswer, AskUserInteractionOption, AskUserInteractionQuestion, AskUserInteractionRequest, AskUserInteractionResult, AskUserInteractionValue, Capabilities, ChatError, ChatErrorCode, ChatSnapshot, ChatUpdate, Conversation, ConversationId, ContactMessageContent, FileMessageContent, GenericAgentEvent, GenericAgentEventTransitionPayload, MediaMessageContent, Message, MessageAuthor, MessageContent, MessageRole, Run, RunId, RunStatus, TimelineItem, TimelineItemId, TimelinePageInfo, TextMessageContent, ToolAgentEvent, ToolAgentEventTransitionPayload, ToolCall, ToolEventTransition, ToolReturn, UnknownEvent, UnknownMessageContent, UrlMessageContent, } from "./models.js";
+export * from "./raw.js";
+export { ProtocolValidationError } from "./schema.js";
+export type { ProtocolParseResult, ProtocolValidationIssue, ProtocolValidationPathSegment, RuntimeSchema, } from "./schema.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,sBAAsB,EACtB,mCAAmC,EACnC,kCAAkC,EAClC,4BAA4B,EAC5B,0CAA0C,EAC1C,mCAAmC,EACnC,uBAAuB,GACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gBAAgB,EAChB,8BAA8B,EAC9B,+BAA+B,EAC/B,8BAA8B,EAC9B,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,+BAA+B,EAC/B,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,EACvB,YAAY,EACZ,SAAS,EACT,aAAa,EACb,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,kCAAkC,EAClC,mBAAmB,EACnB,OAAO,EACP,aAAa,EACb,cAAc,EACd,WAAW,EACX,GAAG,EACH,KAAK,EACL,SAAS,EACT,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,+BAA+B,EAC/B,QAAQ,EACR,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,6BAA6B,EAC7B,aAAa,GACd,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./gateway.js";
+export { ASK_USER_MAX_ANSWER_VALUES, ASK_USER_MAX_OPTIONS, ASK_USER_MAX_QUESTIONS, ASK_USER_MAX_QUESTION_ID_CHARACTERS, ASK_USER_MAX_REQUEST_ID_CHARACTERS, ASK_USER_MAX_TEXT_CHARACTERS, getAskUserInteractionAnswerValidationError, isAskUserInteractionValueCompatible, isSafeAskUserQuestionId, } from "./ask-user.js";
+export { agentEventSchema, askUserInteractionAnswerSchema, askUserInteractionRequestSchema, askUserInteractionResultSchema, capabilitiesSchema, chatErrorSchema, chatSnapshotSchema, chatUpdateSchema, compareTimelineItems, conversationSchema, getTimelineItemKey, hasCompatibleAgentEventMetadata, messageSchema, runSchema, timelineItemSchema, unknownEventSchema, } from "./models.js";
+export { compareAgentEventTransitions } from "./ordering.js";
+export * from "./raw.js";
+export { ProtocolValidationError } from "./schema.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,sBAAsB,EACtB,mCAAmC,EACnC,kCAAkC,EAClC,4BAA4B,EAC5B,0CAA0C,EAC1C,mCAAmC,EACnC,uBAAuB,GACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gBAAgB,EAChB,8BAA8B,EAC9B,+BAA+B,EAC/B,8BAA8B,EAC9B,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,+BAA+B,EAC/B,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AA6C7D,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}

package/dist/internal-runtime-schema.d.ts

@@ -0,0 +1,4 @@
+import type { z } from "zod/v4";
+import { type RuntimeSchema } from "./schema.js";
+export declare const createRuntimeSchema: <T>(schema: z.ZodType<T>) => RuntimeSchema<T>;
+//# sourceMappingURL=internal-runtime-schema.d.ts.map

package/dist/internal-runtime-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-runtime-schema.d.ts","sourceRoot":"","sources":["../src/internal-runtime-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AAiCrB,eAAO,MAAM,mBAAmB,GAAI,CAAC,EACnC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KACnB,aAAa,CAAC,CAAC,CA+BjB,CAAC"}

package/dist/internal-runtime-schema.js

@@ -0,0 +1,49 @@
+import { ProtocolValidationError, } from "./schema.js";
+const normalizePath = (path) => Object.freeze(path.map((segment) => typeof segment === "symbol"
+    ? (segment.description ?? segment.toString())
+    : segment));
+const freezeRecursively = (value, seen = new WeakSet()) => {
+    if (value === null ||
+        (typeof value !== "object" && typeof value !== "function")) {
+        return value;
+    }
+    const objectValue = value;
+    if (seen.has(objectValue))
+        return value;
+    seen.add(objectValue);
+    for (const key of Reflect.ownKeys(objectValue)) {
+        const property = objectValue[key];
+        freezeRecursively(property, seen);
+    }
+    return Object.freeze(value);
+};
+export const createRuntimeSchema = (schema) => {
+    const safeParse = (input) => {
+        const result = schema.safeParse(input);
+        if (result.success) {
+            return Object.freeze({
+                success: true,
+                data: freezeRecursively(result.data),
+            });
+        }
+        const issues = result.error.issues.map((issue) => Object.freeze({
+            code: issue.code,
+            message: issue.message,
+            path: normalizePath(issue.path),
+        }));
+        return Object.freeze({
+            success: false,
+            error: new ProtocolValidationError(issues),
+        });
+    };
+    return Object.freeze({
+        parse: (input) => {
+            const result = safeParse(input);
+            if (!result.success)
+                throw result.error;
+            return result.data;
+        },
+        safeParse,
+    });
+};
+//# sourceMappingURL=internal-runtime-schema.js.map

package/dist/internal-runtime-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-runtime-schema.js","sourceRoot":"","sources":["../src/internal-runtime-schema.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,uBAAuB,GAIxB,MAAM,aAAa,CAAC;AAErB,MAAM,aAAa,GAAG,CACpB,IAA4B,EACc,EAAE,CAC5C,MAAM,CAAC,MAAM,CACX,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACnB,OAAO,OAAO,KAAK,QAAQ;IACzB,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC7C,CAAC,CAAC,OAAO,CACZ,CACF,CAAC;AAEJ,MAAM,iBAAiB,GAAG,CAAI,KAAQ,EAAE,OAAO,IAAI,OAAO,EAAU,EAAK,EAAE;IACzE,IACE,KAAK,KAAK,IAAI;QACd,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,EAC1D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,KAAe,CAAC;IACpC,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAEtB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAI,WAA4C,CAAC,GAAG,CAAC,CAAC;QACpE,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,MAAoB,EACF,EAAE;IACpB,MAAM,SAAS,GAAG,CAAC,KAAc,EAA0B,EAAE;QAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,OAAO,EAAE,IAAa;gBACtB,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC;aACrC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC/C,MAAM,CAAC,MAAM,CAAC;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC;SAChC,CAAC,CACH,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,OAAO,EAAE,KAAc;YACvB,KAAK,EAAE,IAAI,uBAAuB,CAAC,MAAM,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,CAAC,KAAc,EAAK,EAAE;YAC3B,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,MAAM,MAAM,CAAC,KAAK,CAAC;YACxC,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QACD,SAAS;KACV,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/internal-schemas.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod/v4";
+import type { AgentEvent, AskUserInteractionAnswer, AskUserInteractionRequest, AskUserInteractionResult, Capabilities, ChatError, ChatSnapshot, ChatUpdate, Conversation, Message, Run, TimelineItem, UnknownEvent } from "./models.js";
+export declare const conversationParser: z.ZodType<Conversation>;
+export declare const chatErrorParser: z.ZodType<ChatError>;
+export declare const messageParser: z.ZodType<Message>;
+export declare const askUserInteractionRequestParser: z.ZodType<AskUserInteractionRequest>;
+export declare const askUserInteractionAnswerParser: z.ZodType<AskUserInteractionAnswer>;
+export declare const askUserInteractionResultParser: z.ZodType<AskUserInteractionResult>;
+export declare const agentEventParser: z.ZodType<AgentEvent>;
+export declare const unknownEventParser: z.ZodType<UnknownEvent>;
+export declare const timelineItemParser: z.ZodType<TimelineItem>;
+export declare const runParser: z.ZodType<Run>;
+export declare const capabilitiesParser: z.ZodType<Capabilities>;
+export declare const chatSnapshotParser: z.ZodType<ChatSnapshot>;
+export declare const chatUpdateParser: z.ZodType<ChatUpdate>;
+//# sourceMappingURL=internal-schemas.d.ts.map

package/dist/internal-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-schemas.d.ts","sourceRoot":"","sources":["../src/internal-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAY3B,OAAO,KAAK,EACV,UAAU,EAGV,wBAAwB,EAGxB,yBAAyB,EACzB,wBAAwB,EAExB,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,UAAU,EACV,YAAY,EAMZ,OAAO,EAGP,GAAG,EAMH,YAAY,EAEZ,YAAY,EACb,MAAM,aAAa,CAAC;AAmBrB,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAMrD,CAAC;AAyCH,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAiB/C,CAAC;AAoBH,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAY3C,CAAC;AA6JH,eAAO,MAAM,+BAA+B,EAAE,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAU7E,CAAC;AAEL,eAAO,MAAM,8BAA8B,EAAE,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAM3E,CAAC;AAEL,eAAO,MAAM,8BAA8B,EAAE,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAe3E,CAAC;AA0CL,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAsE/C,CAAC;AAuBL,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAUrD,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAIrD,CAAC;AAEH,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAiBjC,CAAC;AAEL,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAOrD,CAAC;AAOH,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CA8CnD,CAAC;AAEL,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CA6F/C,CAAC"}