visionclaw 0.1.218 → 0.1.219-dev.codex-issue-2805-worker-runtime.1

package/dist/threads/task-contracts.d.ts

@@ -1,194 +0,0 @@
-/**
- * Contracts for the thread task store (issue #1996, PR 1).
- *
- * A logical thread keeps a durable list of tasks it has accepted, plus an
- * append-only event log the task sidecar consumes. This module holds the
- * shapes and the pure rules (state transitions, change validation); the
- * SQLite side lives in `task-store.ts`.
- *
- * Rules fixed here, relied on by later PRs:
- *  - Task IDs are random UUIDs and never change. A task is created at most
- *    once per `originKey` (the event it came from plus the intent index), so
- *    replaying events cannot duplicate it.
- *  - Events are ordered by a per-database `seq`. The sidecar's consume
- *    position is the highest `seq` it has committed against.
- *  - Every update names the version it read. The store rejects the commit if
- *    the task moved on, so a stale sidecar result cannot overwrite a
- *    cancellation or modification that landed meanwhile.
- *  - `completed` and `cancelled` are terminal. Follow-up work is a new task.
- */
-import type { ApplicationId } from "../config/application-config.js";
-import type { DeliveryTarget, MessageAttachment } from "../channels/interface.js";
-export declare const TASK_STATUSES: readonly ["pending", "in_progress", "awaiting_user", "blocked", "completed", "cancelled"];
-export type TaskStatus = (typeof TASK_STATUSES)[number];
-/** Statuses that still owe the user something. */
-export declare const OPEN_TASK_STATUSES: readonly TaskStatus[];
-export declare const TASK_EVENT_KINDS: readonly ["user_message", "assistant_response", "tool_result", "todo_update", "status_report", "fast_responder_candidate", "lifecycle", "recovery"];
-export type TaskEventKind = (typeof TASK_EVENT_KINDS)[number];
-/** Where an event came from. Message events carry the queue dedup key. */
-export interface TaskEventSource {
-    channel: string;
-    sender: string;
-    messageId?: string;
-    dedupKey?: string;
-    app?: ApplicationId;
-}
-/**
- * A stable reference to an attachment. Inline base64 is never stored: the
- * event log keeps references, not copies.
- */
-export type TaskAttachmentRef = Omit<MessageAttachment, "base64">;
-export interface TaskEventPayload {
-    text?: string;
-    attachments?: TaskAttachmentRef[];
-    /** Kind-specific structured data (tool name, todo list, lifecycle phase…). */
-    data?: Record<string, unknown>;
-}
-export interface TaskEventInput {
-    /**
-     * Unique per thread. Re-appending the same key is a no-op, which is what
-     * makes message redelivery, watchdog retries and duplicate candidates safe.
-     */
-    idempotencyKey: string;
-    kind: TaskEventKind;
-    source?: TaskEventSource;
-    replyTarget?: DeliveryTarget;
-    payload: TaskEventPayload;
-}
-export interface TaskEvent extends TaskEventInput {
-    seq: number;
-    id: string;
-    threadId: string;
-    /** Process that appended it. Recorded for audit; appends are not fenced. */
-    writerId: string;
-    createdAt: number;
-}
-export interface TaskCheckpoint {
-    constraints: string[];
-    decisions: string[];
-    done: string[];
-    progress: string;
-    remaining: string[];
-    blockers: {
-        reason: string;
-        resolveWhen: string;
-    }[];
-    /** Paths, URLs or event ids of artifacts and operation results. */
-    artifacts: string[];
-}
-export interface TaskResult {
-    summary: string;
-    /** Event ids, paths or URLs proving the work was done. Required to complete. */
-    evidence: string[];
-}
-export interface ThreadTask {
-    id: string;
-    threadId: string;
-    originKey: string;
-    status: TaskStatus;
-    version: number;
-    title: string;
-    description: string;
-    /** Current effective requirements, including later additions. */
-    requirements: string[];
-    /** Events holding the original text and attachments. */
-    sourceEventIds: string[];
-    replyTarget?: DeliveryTarget;
-    notifyWhen?: string;
-    /** Epoch ms before which the task must not start. */
-    runAfter?: number;
-    /** What unblocks an `awaiting_user` or `blocked` task. */
-    resumeCondition?: string;
-    result?: TaskResult;
-    checkpoint?: TaskCheckpoint;
-    createdAt: number;
-    updatedAt: number;
-    /** Event seq the latest committed change was based on. */
-    lastEventSeq: number;
-}
-export interface NewTask {
-    title: string;
-    description?: string;
-    requirements?: string[];
-    status?: TaskStatus;
-    sourceEventIds?: string[];
-    replyTarget?: DeliveryTarget;
-    notifyWhen?: string;
-    runAfter?: number;
-    resumeCondition?: string;
-    /**
-     * Set with `status: "completed"` when one batch holds both a request and
-     * the evidence it was done (e.g. a backlog replayed after a crash). The
-     * evidence rule applies exactly as for updates.
-     */
-    result?: TaskResult;
-    checkpoint?: TaskCheckpoint;
-}
-/** Fields an update may set. `null` clears an optional field. */
-export interface TaskPatch {
-    title?: string;
-    description?: string;
-    requirements?: string[];
-    status?: TaskStatus;
-    addSourceEventIds?: string[];
-    replyTarget?: DeliveryTarget | null;
-    notifyWhen?: string | null;
-    runAfter?: number | null;
-    resumeCondition?: string | null;
-    result?: TaskResult | null;
-    checkpoint?: TaskCheckpoint | null;
-}
-export type TaskChange = {
-    op: "create";
-    originKey: string;
-    task: NewTask;
-} | {
-    op: "update";
-    taskId: string;
-    expectedVersion: number;
-    patch: TaskPatch;
-};
-/**
- * One sidecar result: changes plus the consume position they cover. The
- * store applies all of it or none of it.
- */
-export interface TaskCommit {
-    /** Consume position the sidecar read from. Must still be current. */
-    expectedPosition: number;
-    /** New consume position: every event with `seq <= throughSeq` is handled. */
-    throughSeq: number;
-    changes: TaskChange[];
-}
-export type TaskCommitRejection = 
-/** Another writer took over this thread (replaced worker or restarted process). */
-"stale_writer"
-/** The consume position moved since the sidecar read it. Re-read and retry. */
- | "position_conflict"
-/** A task changed since the sidecar read it. Re-read and retry. */
- | "version_conflict" | "unknown_task" | "invalid_change";
-export type TaskCommitResult = {
-    ok: true;
-    position: number;
-    created: {
-        originKey: string;
-        taskId: string;
-        existed: boolean;
-    }[];
-    updated: {
-        taskId: string;
-        version: number;
-    }[];
-} | {
-    ok: false;
-    reason: TaskCommitRejection;
-    detail: string;
-};
-export declare function isTaskStatus(value: unknown): value is TaskStatus;
-export declare function isTaskEventKind(value: unknown): value is TaskEventKind;
-export declare function canTransition(from: TaskStatus, to: TaskStatus): boolean;
-/**
- * Validate the task as it would look after a create or update. Returns an
- * error message, or null when valid.
- */
-export declare function validateTaskState(task: Pick<ThreadTask, "status" | "title" | "result" | "resumeCondition">): string | null;
-//# sourceMappingURL=task-contracts.d.ts.map

package/dist/threads/task-contracts.d.ts.map

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

package/dist/threads/task-contracts.js

@@ -1,82 +0,0 @@
-/**
- * Contracts for the thread task store (issue #1996, PR 1).
- *
- * A logical thread keeps a durable list of tasks it has accepted, plus an
- * append-only event log the task sidecar consumes. This module holds the
- * shapes and the pure rules (state transitions, change validation); the
- * SQLite side lives in `task-store.ts`.
- *
- * Rules fixed here, relied on by later PRs:
- *  - Task IDs are random UUIDs and never change. A task is created at most
- *    once per `originKey` (the event it came from plus the intent index), so
- *    replaying events cannot duplicate it.
- *  - Events are ordered by a per-database `seq`. The sidecar's consume
- *    position is the highest `seq` it has committed against.
- *  - Every update names the version it read. The store rejects the commit if
- *    the task moved on, so a stale sidecar result cannot overwrite a
- *    cancellation or modification that landed meanwhile.
- *  - `completed` and `cancelled` are terminal. Follow-up work is a new task.
- */
-export const TASK_STATUSES = [
-    "pending",
-    "in_progress",
-    "awaiting_user",
-    "blocked",
-    "completed",
-    "cancelled",
-];
-/** Statuses that still owe the user something. */
-export const OPEN_TASK_STATUSES = ["pending", "in_progress", "awaiting_user", "blocked"];
-const TERMINAL = new Set(["completed", "cancelled"]);
-export const TASK_EVENT_KINDS = [
-    /** An owner message (new task, addition, modification, cancellation, query, chat). */
-    "user_message",
-    /** A complete model response from either engine. */
-    "assistant_response",
-    "tool_result",
-    "todo_update",
-    /** An explicit progress / waiting / done report from the main agent. */
-    "status_report",
-    /** Structured intent candidates from the fast responder. */
-    "fast_responder_candidate",
-    /** finish, session handoff, compaction, context refresh, process start. */
-    "lifecycle",
-    /** A controller-scheduled resume of an existing task (PR 5). */
-    "recovery",
-];
-const TRANSITIONS = {
-    pending: ["in_progress", "awaiting_user", "blocked", "completed", "cancelled"],
-    in_progress: ["pending", "awaiting_user", "blocked", "completed", "cancelled"],
-    awaiting_user: ["pending", "in_progress", "blocked", "completed", "cancelled"],
-    blocked: ["pending", "in_progress", "awaiting_user", "completed", "cancelled"],
-    completed: [],
-    cancelled: [],
-};
-export function isTaskStatus(value) {
-    return typeof value === "string" && TASK_STATUSES.includes(value);
-}
-export function isTaskEventKind(value) {
-    return typeof value === "string" && TASK_EVENT_KINDS.includes(value);
-}
-export function canTransition(from, to) {
-    return from === to ? !TERMINAL.has(from) : TRANSITIONS[from].includes(to);
-}
-/**
- * Validate the task as it would look after a create or update. Returns an
- * error message, or null when valid.
- */
-export function validateTaskState(task) {
-    if (!isTaskStatus(task.status))
-        return `unknown status ${String(task.status)}`;
-    if (task.title.trim().length === 0)
-        return "title is empty";
-    if (task.status === "completed" && !task.result?.evidence.some((ref) => ref.trim().length > 0)) {
-        // "Done" without proof stays open. A bare "做好了" never closes a task.
-        return "completed requires result evidence";
-    }
-    if ((task.status === "awaiting_user" || task.status === "blocked") && !task.resumeCondition?.trim()) {
-        return `${task.status} requires a resumeCondition`;
-    }
-    return null;
-}
-//# sourceMappingURL=task-contracts.js.map

package/dist/threads/task-contracts.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"task-contracts.js","sourceRoot":"","sources":["../../src/threads/task-contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,SAAS;IACT,aAAa;IACb,eAAe;IACf,SAAS;IACT,WAAW;IACX,WAAW;CACH,CAAC;AAGX,kDAAkD;AAClD,MAAM,CAAC,MAAM,kBAAkB,GAA0B,CAAC,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,CAAC,CAAC;AAEhH,MAAM,QAAQ,GAA4B,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;AAE9E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,sFAAsF;IACtF,cAAc;IACd,oDAAoD;IACpD,oBAAoB;IACpB,aAAa;IACb,aAAa;IACb,wEAAwE;IACxE,eAAe;IACf,4DAA4D;IAC5D,0BAA0B;IAC1B,2EAA2E;IAC3E,WAAW;IACX,gEAAgE;IAChE,UAAU;CACF,CAAC;AA8JX,MAAM,WAAW,GAA8C;IAC7D,OAAO,EAAE,CAAC,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC;IAC9E,WAAW,EAAE,CAAC,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC;IAC9E,aAAa,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC;IAC9E,OAAO,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,CAAC;IAC9E,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;CACd,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,aAAmC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,gBAAsC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAgB,EAAE,EAAc;IAC5D,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAyE;IACzG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,kBAAkB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IAC/E,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;QAC/F,qEAAqE;QACrE,OAAO,oCAAoC,CAAC;IAC9C,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,eAAe,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,EAAE,EAAE,CAAC;QACpG,OAAO,GAAG,IAAI,CAAC,MAAM,6BAA6B,CAAC;IACrD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/threads/task-sidecar.d.ts

@@ -1,143 +0,0 @@
-/**
- * Task sidecar (issue #1996, PR 2): one bounded structured LLM call that
- * reads a thread's open tasks plus a batch of new events and proposes
- * incremental task changes. It never runs user work, sends messages or
- * browses. {@link ThreadTaskController} owns persistence; this module only
- * builds the prompt, calls the model and turns its output into a validated
- * {@link TaskCommit}.
- *
- * originKey scheme (left open by PR 1): `<origin>#<n>`. `origin` is the
- * owner message the intent came from — `message:<queue dedupKey>` whenever
- * the event carries a source dedup key, so a message, its redelivery and the
- * fast responder's candidate for it all share one origin — and otherwise the
- * event's own idempotency key (e.g. a commitment the agent made in a status
- * report). `n` is the 0-based index of the new-task intent for that origin
- * within the batch. The store dedups creates by originKey, so none of these
- * paths can create the same task twice.
- */
-import { z } from "zod";
-import type { VisionClawConfig } from "../config/types.js";
-import { type TaskChange, type TaskEvent, type ThreadTask } from "./task-contracts.js";
-/** Caps that keep one sidecar call bounded regardless of thread history. */
-export declare const SIDECAR_LIMITS: {
-    /** Characters of an event's text shown to the model. */
-    readonly eventTextChars: 2000;
-    /** Characters of a tool result / response shown to the model. */
-    readonly eventDataChars: 600;
-    /** Most recently updated closed tasks included for "it's done" style references. */
-    readonly recentClosedTasks: 5;
-    /** Serialized UTF-8 bytes, including JSON keys and escaping. */
-    readonly checkpointBytes: 1200;
-    readonly outputBytes: 6000;
-    /** Larger legacy checkpoints stay in the store, but are omitted from this prompt. */
-    readonly inputCheckpointBytes: 12000;
-    /** Fixed headroom above the compact output budget; never escalated on retries. */
-    readonly maxTokens: 8192;
-};
-declare const IntentSchema: z.ZodObject<{
-    kind: z.ZodEnum<{
-        chat: "chat";
-        progress: "progress";
-        new_task: "new_task";
-        supplement: "supplement";
-        modify: "modify";
-        cancel: "cancel";
-        complete: "complete";
-        await_user: "await_user";
-        block: "block";
-        unclear: "unclear";
-        query: "query";
-    }>;
-    eventSeq: z.ZodNumber;
-    taskRef: z.ZodString;
-    title: z.ZodString;
-    description: z.ZodString;
-    requirements: z.ZodArray<z.ZodString>;
-    resumeCondition: z.ZodString;
-    providesAwaitedInput: z.ZodBoolean;
-    resultSummary: z.ZodString;
-    evidence: z.ZodArray<z.ZodString>;
-    checkpoint: z.ZodNullable<z.ZodObject<{
-        constraints: z.ZodArray<z.ZodString>;
-        decisions: z.ZodArray<z.ZodString>;
-        done: z.ZodArray<z.ZodString>;
-        progress: z.ZodString;
-        remaining: z.ZodArray<z.ZodString>;
-        blockers: z.ZodArray<z.ZodObject<{
-            reason: z.ZodString;
-            resolveWhen: z.ZodString;
-        }, z.core.$strip>>;
-        artifacts: z.ZodArray<z.ZodString>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export declare const SidecarOutputSchema: z.ZodObject<{
-    intents: z.ZodArray<z.ZodObject<{
-        kind: z.ZodEnum<{
-            chat: "chat";
-            progress: "progress";
-            new_task: "new_task";
-            supplement: "supplement";
-            modify: "modify";
-            cancel: "cancel";
-            complete: "complete";
-            await_user: "await_user";
-            block: "block";
-            unclear: "unclear";
-            query: "query";
-        }>;
-        eventSeq: z.ZodNumber;
-        taskRef: z.ZodString;
-        title: z.ZodString;
-        description: z.ZodString;
-        requirements: z.ZodArray<z.ZodString>;
-        resumeCondition: z.ZodString;
-        providesAwaitedInput: z.ZodBoolean;
-        resultSummary: z.ZodString;
-        evidence: z.ZodArray<z.ZodString>;
-        checkpoint: z.ZodNullable<z.ZodObject<{
-            constraints: z.ZodArray<z.ZodString>;
-            decisions: z.ZodArray<z.ZodString>;
-            done: z.ZodArray<z.ZodString>;
-            progress: z.ZodString;
-            remaining: z.ZodArray<z.ZodString>;
-            blockers: z.ZodArray<z.ZodObject<{
-                reason: z.ZodString;
-                resolveWhen: z.ZodString;
-            }, z.core.$strip>>;
-            artifacts: z.ZodArray<z.ZodString>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type SidecarIntent = z.infer<typeof IntentSchema>;
-export type SidecarOutput = z.infer<typeof SidecarOutputSchema>;
-export declare const SIDECAR_SYSTEM_PROMPT: string;
-/**
- * The tasks the sidecar sees: every open task plus the few most recently
- * closed ones, so "that's done" or "cancel the last one" can resolve. The
- * same list must go to the model and to {@link toTaskChanges}.
- */
-export declare function selectSidecarTasks(tasks: ThreadTask[]): ThreadTask[];
-/** A JSON-safe, trimmed view of the inputs. Exported for tests. */
-export declare function buildSidecarInput(tasks: ThreadTask[], events: TaskEvent[]): string;
-export interface SidecarCallOptions {
-    timeoutMs: number;
-    signal?: AbortSignal;
-}
-/** Narrow seam so the controller can be tested with canned outputs. */
-export type SidecarModel = (input: {
-    tasks: ThreadTask[];
-    events: TaskEvent[];
-}, options: SidecarCallOptions) => Promise<unknown>;
-/** The production model: one structured `runSideCall` on the balanced tier. */
-export declare function createSidecarModel(config: VisionClawConfig): SidecarModel;
-export declare class SidecarOutputError extends Error {
-}
-/**
- * Turn raw model output into store changes against the tasks the model read.
- * Throws {@link SidecarOutputError} on malformed output or references to
- * unknown tasks/events — the caller retries without consuming the batch.
- * Intents that create nothing (query, chat) are dropped here.
- */
-export declare function toTaskChanges(raw: unknown, tasks: ThreadTask[], events: TaskEvent[]): TaskChange[];
-export {};
-//# sourceMappingURL=task-sidecar.d.ts.map

package/dist/threads/task-sidecar.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"task-sidecar.d.ts","sourceRoot":"","sources":["../../src/threads/task-sidecar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,SAAS,EAGd,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAE7B,4EAA4E;AAC5E,eAAO,MAAM,cAAc;IACzB,wDAAwD;;IAExD,iEAAiE;;IAEjE,oFAAoF;;IAEpF,gEAAgE;;;IAGhE,qFAAqF;;IAErF,kFAAkF;;CAE1E,CAAC;AAmBX,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkChB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIwD,CAAC;AAEzF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACzD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,qBAAqB,QAqB4C,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAOpE;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CA0BlF;AAUD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,uEAAuE;AACvE,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,CAAA;CAAE,EAAE,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAElI,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,YAAY,CAWzE;AAED,qBAAa,kBAAmB,SAAQ,KAAK;CAAG;AAEhD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE,CA4HlG"}