@lleverage-ai/agent-sdk 0.0.1

package/dist/checkpointer/memory-saver.js

@@ -0,0 +1,222 @@
+/**
+ * In-memory checkpoint saver for ephemeral storage.
+ *
+ * MemorySaver stores checkpoints in a Map, making it ideal for:
+ * - Development and testing
+ * - Single-session applications
+ * - Scenarios where persistence is not required
+ *
+ * Note: All data is lost when the process ends.
+ *
+ * @example
+ * ```typescript
+ * const saver = new MemorySaver();
+ *
+ * // Save a checkpoint
+ * await saver.save({
+ *   threadId: "session-123",
+ *   messages: [...],
+ *   state: { todos: [], files: {} },
+ *   step: 0,
+ *   createdAt: new Date().toISOString(),
+ *   updatedAt: new Date().toISOString(),
+ * });
+ *
+ * // Load it back
+ * const checkpoint = await saver.load("session-123");
+ * ```
+ *
+ * @packageDocumentation
+ */
+/**
+ * In-memory checkpoint saver.
+ *
+ * Stores checkpoints in a JavaScript Map for fast access.
+ * All data is ephemeral and lost when the process terminates.
+ *
+ * @example
+ * ```typescript
+ * const saver = new MemorySaver();
+ *
+ * // Save a checkpoint
+ * await saver.save(checkpoint);
+ *
+ * // List all threads
+ * const threads = await saver.list();
+ *
+ * // Load a specific thread
+ * const loaded = await saver.load(threads[0]);
+ *
+ * // Delete when done
+ * await saver.delete(threads[0]);
+ * ```
+ *
+ * @category Checkpointer
+ */
+export class MemorySaver {
+    checkpoints = new Map();
+    namespace;
+    /**
+     * Create a new MemorySaver.
+     *
+     * @param options - Optional configuration
+     */
+    constructor(options) {
+        this.namespace = options?.namespace;
+        // Populate with initial checkpoints if provided
+        if (options?.initialCheckpoints) {
+            for (const checkpoint of options.initialCheckpoints) {
+                const key = this.getKey(checkpoint.threadId);
+                // Deep copy to prevent external mutation
+                this.checkpoints.set(key, this.deepCopy(checkpoint));
+            }
+        }
+    }
+    /**
+     * Save a checkpoint.
+     *
+     * If a checkpoint with the same threadId exists, it will be overwritten.
+     * The checkpoint is deep-copied to prevent external mutation.
+     *
+     * @param checkpoint - The checkpoint to save
+     */
+    async save(checkpoint) {
+        const key = this.getKey(checkpoint.threadId);
+        // Deep copy to prevent external mutation affecting stored data
+        this.checkpoints.set(key, this.deepCopy(checkpoint));
+    }
+    /**
+     * Load a checkpoint by thread ID.
+     *
+     * Returns a deep copy to prevent external mutation of stored data.
+     *
+     * @param threadId - The thread ID to load
+     * @returns The checkpoint if found, undefined otherwise
+     */
+    async load(threadId) {
+        const key = this.getKey(threadId);
+        const checkpoint = this.checkpoints.get(key);
+        // Return deep copy to prevent external mutation
+        return checkpoint ? this.deepCopy(checkpoint) : undefined;
+    }
+    /**
+     * List all thread IDs that have checkpoints.
+     *
+     * If a namespace is configured, only returns threads within that namespace.
+     *
+     * @returns Array of thread IDs
+     */
+    async list() {
+        const threads = [];
+        const prefix = this.namespace ? `${this.namespace}:` : "";
+        for (const key of this.checkpoints.keys()) {
+            if (this.namespace) {
+                if (key.startsWith(prefix)) {
+                    threads.push(key.slice(prefix.length));
+                }
+            }
+            else {
+                threads.push(key);
+            }
+        }
+        return threads;
+    }
+    /**
+     * Delete a checkpoint.
+     *
+     * @param threadId - The thread ID to delete
+     * @returns True if a checkpoint was deleted, false if not found
+     */
+    async delete(threadId) {
+        const key = this.getKey(threadId);
+        return this.checkpoints.delete(key);
+    }
+    /**
+     * Check if a checkpoint exists.
+     *
+     * @param threadId - The thread ID to check
+     * @returns True if the checkpoint exists
+     */
+    async exists(threadId) {
+        const key = this.getKey(threadId);
+        return this.checkpoints.has(key);
+    }
+    // ===========================================================================
+    // Additional Utility Methods
+    // ===========================================================================
+    /**
+     * Get the number of stored checkpoints.
+     *
+     * If a namespace is configured, returns count within that namespace only.
+     */
+    get size() {
+        if (!this.namespace) {
+            return this.checkpoints.size;
+        }
+        const prefix = `${this.namespace}:`;
+        let count = 0;
+        for (const key of this.checkpoints.keys()) {
+            if (key.startsWith(prefix)) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Clear all stored checkpoints.
+     *
+     * If a namespace is configured, only clears checkpoints within that namespace.
+     */
+    clear() {
+        if (!this.namespace) {
+            this.checkpoints.clear();
+            return;
+        }
+        const prefix = `${this.namespace}:`;
+        for (const key of [...this.checkpoints.keys()]) {
+            if (key.startsWith(prefix)) {
+                this.checkpoints.delete(key);
+            }
+        }
+    }
+    // ===========================================================================
+    // Private Helpers
+    // ===========================================================================
+    /**
+     * Get the storage key for a thread ID.
+     * @internal
+     */
+    getKey(threadId) {
+        return this.namespace ? `${this.namespace}:${threadId}` : threadId;
+    }
+    /**
+     * Deep copy a checkpoint to prevent mutation.
+     * @internal
+     */
+    deepCopy(checkpoint) {
+        return JSON.parse(JSON.stringify(checkpoint));
+    }
+}
+// =============================================================================
+// Factory Function
+// =============================================================================
+/**
+ * Create a new MemorySaver instance.
+ *
+ * @param options - Optional configuration
+ * @returns A new MemorySaver instance
+ *
+ * @example
+ * ```typescript
+ * const saver = createMemorySaver();
+ *
+ * // Or with namespace for multi-tenant isolation
+ * const userSaver = createMemorySaver({ namespace: "user-123" });
+ * ```
+ *
+ * @category Checkpointer
+ */
+export function createMemorySaver(options) {
+    return new MemorySaver(options);
+}
+//# sourceMappingURL=memory-saver.js.map

package/dist/checkpointer/memory-saver.js.map

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

package/dist/checkpointer/types.d.ts

@@ -0,0 +1,353 @@
+/**
+ * Type definitions for the checkpointer system.
+ *
+ * Checkpointers provide session persistence and resumption across conversations,
+ * allowing agents to save and restore their state including message history,
+ * todos, files, and pending tool approvals.
+ *
+ * @packageDocumentation
+ */
+import type { ModelMessage } from "ai";
+import type { AgentState } from "../backends/state.js";
+/**
+ * Base interrupt type - the shared mechanism for pausing agent execution.
+ *
+ * Interrupts allow the agent to pause execution and wait for external input.
+ * This is a generalized pattern that supports:
+ * - Tool approval requests (ApprovalInterrupt)
+ * - User questions during tool execution
+ * - Custom application-specific interrupts
+ *
+ * @example
+ * ```typescript
+ * const interrupt: Interrupt = {
+ *   id: "int_abc123",
+ *   threadId: "session-456",
+ *   type: "approval",
+ *   toolCallId: "call_abc123",
+ *   toolName: "deleteFile",
+ *   request: { toolName: "deleteFile", args: { path: "/important/file.txt" } },
+ *   step: 5,
+ *   createdAt: "2026-01-30T10:00:00Z",
+ * };
+ * ```
+ *
+ * @category Checkpointer
+ */
+export interface Interrupt<TRequest = unknown, TResponse = unknown> {
+    /** Unique identifier for this interrupt */
+    id: string;
+    /** The thread this interrupt belongs to */
+    threadId: string;
+    /** Type of interrupt (e.g., "approval", "question", custom types) */
+    type: string;
+    /** The tool call ID if this interrupt is related to a tool call */
+    toolCallId?: string;
+    /** The tool name if this interrupt is related to a tool call */
+    toolName?: string;
+    /** The request data for this interrupt (type varies by interrupt type) */
+    request: TRequest;
+    /** The step number when the interrupt occurred */
+    step: number;
+    /** ISO 8601 timestamp when this interrupt was created */
+    createdAt: string;
+    /** The response to this interrupt (undefined = pending) */
+    response?: TResponse;
+}
+/**
+ * Request data for an approval interrupt.
+ *
+ * @category Checkpointer
+ */
+export interface ApprovalRequest {
+    /** Name of the tool that requires approval */
+    toolName: string;
+    /** Arguments passed to the tool */
+    args: unknown;
+}
+/**
+ * Response data for an approval interrupt.
+ *
+ * @category Checkpointer
+ */
+export interface ApprovalResponse {
+    /** Whether the tool call was approved */
+    approved: boolean;
+    /** Optional reason for the decision */
+    reason?: string;
+}
+/**
+ * Approval interrupt - a specialized interrupt for tool approval requests.
+ *
+ * When a tool requires user confirmation (via `canUseTool` returning "ask"),
+ * the agent creates an approval interrupt and pauses execution.
+ *
+ * @example
+ * ```typescript
+ * const approval: ApprovalInterrupt = {
+ *   id: "int_abc123",
+ *   threadId: "session-456",
+ *   type: "approval",
+ *   toolCallId: "call_abc123",
+ *   toolName: "deleteFile",
+ *   request: { toolName: "deleteFile", args: { path: "/important/file.txt" } },
+ *   step: 5,
+ *   createdAt: "2026-01-30T10:00:00Z",
+ * };
+ * ```
+ *
+ * @category Checkpointer
+ */
+export interface ApprovalInterrupt extends Interrupt<ApprovalRequest, ApprovalResponse> {
+    type: "approval";
+    /** Tool call ID is required for approval interrupts */
+    toolCallId: string;
+    /** Tool name is required for approval interrupts */
+    toolName: string;
+}
+/**
+ * Complete snapshot of an agent session.
+ *
+ * A checkpoint captures the full state of a conversation, including:
+ * - Message history for context continuity
+ * - Agent state (todos, virtual files)
+ * - Any pending interrupts (tool approvals, questions, etc.)
+ *
+ * @example
+ * ```typescript
+ * const checkpoint: Checkpoint = {
+ *   threadId: "session-123",
+ *   step: 5,
+ *   messages: [
+ *     { role: "user", content: "Hello" },
+ *     { role: "assistant", content: "Hi there!" },
+ *   ],
+ *   state: { todos: [], files: {} },
+ *   createdAt: "2026-01-30T10:00:00Z",
+ *   updatedAt: "2026-01-30T10:05:00Z",
+ * };
+ * ```
+ *
+ * @category Checkpointer
+ */
+export interface Checkpoint {
+    /** Unique identifier for this conversation thread */
+    threadId: string;
+    /** Step number when this checkpoint was created */
+    step: number;
+    /** Full message history */
+    messages: ModelMessage[];
+    /** Agent state including todos and virtual filesystem */
+    state: AgentState;
+    /**
+     * Pending interrupt if the agent was interrupted.
+     */
+    pendingInterrupt?: Interrupt;
+    /** ISO 8601 timestamp when this checkpoint was first created */
+    createdAt: string;
+    /** ISO 8601 timestamp when this checkpoint was last updated */
+    updatedAt: string;
+    /** Optional metadata for custom data */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for creating a checkpoint saver.
+ *
+ * @category Checkpointer
+ */
+export interface CheckpointSaverOptions {
+    /**
+     * Namespace for isolating checkpoints.
+     *
+     * Useful for multi-tenant scenarios where different users or projects
+     * need separate checkpoint storage.
+     *
+     * @defaultValue undefined (no namespace)
+     */
+    namespace?: string;
+}
+/**
+ * Abstract storage interface for checkpoints.
+ *
+ * Implement this interface to create custom checkpoint storage backends
+ * such as Redis, SQLite, cloud storage, or any other persistence layer.
+ *
+ * @example
+ * ```typescript
+ * class RedisCheckpointSaver implements BaseCheckpointSaver {
+ *   constructor(private redis: RedisClient) {}
+ *
+ *   async save(checkpoint: Checkpoint): Promise<void> {
+ *     const key = `checkpoint:${checkpoint.threadId}`;
+ *     await this.redis.set(key, JSON.stringify(checkpoint));
+ *   }
+ *
+ *   async load(threadId: string): Promise<Checkpoint | undefined> {
+ *     const key = `checkpoint:${threadId}`;
+ *     const data = await this.redis.get(key);
+ *     return data ? JSON.parse(data) : undefined;
+ *   }
+ *
+ *   // ... other methods
+ * }
+ * ```
+ *
+ * @category Checkpointer
+ */
+export interface BaseCheckpointSaver {
+    /**
+     * Save a checkpoint.
+     *
+     * If a checkpoint with the same `threadId` exists, it should be updated.
+     *
+     * @param checkpoint - The checkpoint to save
+     */
+    save(checkpoint: Checkpoint): Promise<void>;
+    /**
+     * Load a checkpoint by thread ID.
+     *
+     * @param threadId - The unique thread identifier
+     * @returns The checkpoint if found, undefined otherwise
+     */
+    load(threadId: string): Promise<Checkpoint | undefined>;
+    /**
+     * List all thread IDs that have checkpoints.
+     *
+     * @returns Array of thread IDs
+     */
+    list(): Promise<string[]>;
+    /**
+     * Delete a checkpoint.
+     *
+     * @param threadId - The thread ID to delete
+     * @returns True if a checkpoint was deleted, false if not found
+     */
+    delete(threadId: string): Promise<boolean>;
+    /**
+     * Check if a checkpoint exists.
+     *
+     * @param threadId - The thread ID to check
+     * @returns True if the checkpoint exists
+     */
+    exists(threadId: string): Promise<boolean>;
+}
+/**
+ * Event emitted when a checkpoint is saved.
+ *
+ * @category Checkpointer
+ */
+export interface CheckpointSavedEvent {
+    type: "checkpoint-saved";
+    threadId: string;
+    step: number;
+}
+/**
+ * Event emitted when a checkpoint is loaded.
+ *
+ * @category Checkpointer
+ */
+export interface CheckpointLoadedEvent {
+    type: "checkpoint-loaded";
+    threadId: string;
+    step: number;
+    messagesCount: number;
+}
+/**
+ * Union type of all checkpoint events.
+ *
+ * @category Checkpointer
+ */
+export type CheckpointEvent = CheckpointSavedEvent | CheckpointLoadedEvent;
+/**
+ * Create a new checkpoint with the given data.
+ *
+ * This is a convenience function that ensures timestamps are set correctly.
+ *
+ * @param data - Partial checkpoint data (threadId and messages required)
+ * @returns A complete checkpoint object
+ *
+ * @example
+ * ```typescript
+ * const checkpoint = createCheckpoint({
+ *   threadId: "session-123",
+ *   messages: [...],
+ *   state: { todos: [], files: {} },
+ * });
+ * ```
+ *
+ * @category Checkpointer
+ */
+export declare function createCheckpoint(data: Pick<Checkpoint, "threadId" | "messages" | "state"> & Partial<Omit<Checkpoint, "threadId" | "messages" | "state">>): Checkpoint;
+/**
+ * Update an existing checkpoint with new data.
+ *
+ * Automatically updates the `updatedAt` timestamp and increments step.
+ *
+ * @param checkpoint - The existing checkpoint
+ * @param updates - Partial updates to apply
+ * @returns A new checkpoint object with updates applied
+ *
+ * @example
+ * ```typescript
+ * const updated = updateCheckpoint(checkpoint, {
+ *   messages: [...newMessages],
+ *   step: checkpoint.step + 1,
+ * });
+ * ```
+ *
+ * @category Checkpointer
+ */
+export declare function updateCheckpoint(checkpoint: Checkpoint, updates: Partial<Omit<Checkpoint, "threadId" | "createdAt">>): Checkpoint;
+/**
+ * Type guard to check if an object is a valid Checkpoint.
+ *
+ * @param value - The value to check
+ * @returns True if the value is a valid Checkpoint
+ *
+ * @category Checkpointer
+ */
+export declare function isCheckpoint(value: unknown): value is Checkpoint;
+/**
+ * Type guard to check if an object is a valid Interrupt.
+ *
+ * @param value - The value to check
+ * @returns True if the value is a valid Interrupt
+ *
+ * @category Checkpointer
+ */
+export declare function isInterrupt(value: unknown): value is Interrupt;
+/**
+ * Type guard to check if an interrupt is an ApprovalInterrupt.
+ *
+ * @param interrupt - The interrupt to check
+ * @returns True if the interrupt is an ApprovalInterrupt
+ *
+ * @category Checkpointer
+ */
+export declare function isApprovalInterrupt(interrupt: Interrupt): interrupt is ApprovalInterrupt;
+/**
+ * Create a new interrupt with the given data.
+ *
+ * @param data - Partial interrupt data (id, threadId, type, and request required)
+ * @returns A complete interrupt object
+ *
+ * @category Checkpointer
+ */
+export declare function createInterrupt<TRequest = unknown, TResponse = unknown>(data: Pick<Interrupt<TRequest, TResponse>, "id" | "threadId" | "type" | "request"> & Partial<Omit<Interrupt<TRequest, TResponse>, "id" | "threadId" | "type" | "request">>): Interrupt<TRequest, TResponse>;
+/**
+ * Create an approval interrupt for a tool call.
+ *
+ * @param data - The approval interrupt data
+ * @returns A complete ApprovalInterrupt object
+ *
+ * @category Checkpointer
+ */
+export declare function createApprovalInterrupt(data: {
+    id: string;
+    threadId: string;
+    toolCallId: string;
+    toolName: string;
+    args: unknown;
+    step?: number;
+}): ApprovalInterrupt;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/checkpointer/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAMvD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,SAAS,CAAC,QAAQ,GAAG,OAAO,EAAE,SAAS,GAAG,OAAO;IAChE,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,OAAO,EAAE,QAAQ,CAAC;IAClB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,QAAQ,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,iBAAkB,SAAQ,SAAS,CAAC,eAAe,EAAE,gBAAgB,CAAC;IACrF,IAAI,EAAE,UAAU,CAAC;IACjB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IAEjB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IAEb,2BAA2B;IAC3B,QAAQ,EAAE,YAAY,EAAE,CAAC;IAEzB,yDAAyD;IACzD,KAAK,EAAE,UAAU,CAAC;IAElB;;OAEG;IACH,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAE7B,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAElB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAElB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAExD;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE1B;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3C;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5C;AAMD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,oBAAoB,GAAG,qBAAqB,CAAC;AAM3E;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC,GACvD,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC,CAAC,GAC7D,UAAU,CAQZ;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAAC,CAAC,GAC3D,UAAU,CAMZ;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAgBhE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAe9D;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,IAAI,iBAAiB,CAMxF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,GAAG,OAAO,EAAE,SAAS,GAAG,OAAO,EACrE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,IAAI,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC,GAChF,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,IAAI,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,GACtF,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,CAMhC;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,iBAAiB,CAcpB"}