@elaraai/e3-core 0.0.2-beta.3 → 0.0.2-beta.31

package/dist/src/dataflow/orchestrator/interfaces.js

@@ -0,0 +1,51 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Convert execution state to status summary.
+ */
+export function stateToStatus(state) {
+    const completed = [];
+    const running = [];
+    const pending = [];
+    const failed = [];
+    const skipped = [];
+    for (const [name, taskState] of state.tasks) {
+        switch (taskState.status) {
+            case 'completed':
+                completed.push(name);
+                break;
+            case 'in_progress':
+                running.push(name);
+                break;
+            case 'pending':
+            case 'ready':
+                pending.push(name);
+                break;
+            case 'failed':
+                failed.push(name);
+                break;
+            case 'skipped':
+                skipped.push(name);
+                break;
+        }
+    }
+    // Get error value (handle Option type)
+    const errorValue = state.error.type === 'some' ? state.error.value : undefined;
+    // Get completedAt value (handle Option type)
+    const completedAtValue = state.completedAt.type === 'some' ? state.completedAt.value : undefined;
+    return {
+        id: state.id,
+        state: state.status,
+        completed,
+        running,
+        pending,
+        failed,
+        skipped,
+        error: errorValue,
+        startedAt: state.startedAt,
+        completedAt: completedAtValue,
+    };
+}
+//# sourceMappingURL=interfaces.js.map

package/dist/src/dataflow/orchestrator/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/dataflow/orchestrator/interfaces.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsKH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAA6B;IACzD,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC5C,QAAQ,SAAS,CAAC,MAAM,EAAE,CAAC;YACzB,KAAK,WAAW;gBACd,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrB,MAAM;YACR,KAAK,aAAa;gBAChB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnB,MAAM;YACR,KAAK,SAAS,CAAC;YACf,KAAK,OAAO;gBACV,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnB,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClB,MAAM;YACR,KAAK,SAAS;gBACZ,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnB,MAAM;QACV,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/E,6CAA6C;IAC7C,MAAM,gBAAgB,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjG,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC,MAA0D;QACvE,SAAS;QACT,OAAO;QACP,OAAO;QACP,MAAM;QACN,OAAO;QACP,KAAK,EAAE,UAAU;QACjB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,WAAW,EAAE,gBAAgB;KAC9B,CAAC;AACJ,CAAC"}

package/dist/src/dataflow/state-store/FileStateStore.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { ExecutionStateStore, TaskStatusDetails, ExecutionStatusDetails } from './interfaces.js';
+import { type DataflowExecutionState, type ExecutionEvent, type TaskStatus } from '../types.js';
+/**
+ * File-based state store for local filesystem persistence.
+ *
+ * @remarks
+ * - Uses atomic writes (write to temp, then rename) for durability
+ * - State is stored in beast2 binary format for type safety
+ * - Events are stored inline in the execution state
+ * - Thread-safe for concurrent access within a single process (via file locking)
+ * - Suitable for local CLI and API server usage
+ */
+export declare class FileStateStore implements ExecutionStateStore {
+    private readonly workspacesDir;
+    /**
+     * Create a new FileStateStore.
+     *
+     * @param workspacesDir - Path to the workspaces directory (e.g., repo/workspaces)
+     */
+    constructor(workspacesDir: string);
+    /**
+     * Get the path to a workspace's directory.
+     */
+    private workspacePath;
+    /**
+     * Get the path to a workspace's execution state file.
+     */
+    private statePath;
+    /**
+     * Get the path to a workspace's execution counter file.
+     */
+    private counterPath;
+    create(state: DataflowExecutionState): Promise<void>;
+    read(repo: string, workspace: string, id: string): Promise<DataflowExecutionState | null>;
+    readLatest(_repo: string, workspace: string): Promise<DataflowExecutionState | null>;
+    update(state: DataflowExecutionState): Promise<void>;
+    updateTaskStatus(repo: string, workspace: string, executionId: string, task: string, status: TaskStatus, details?: TaskStatusDetails): Promise<void>;
+    updateStatus(repo: string, workspace: string, executionId: string, status: 'running' | 'completed' | 'failed' | 'cancelled', details?: ExecutionStatusDetails): Promise<void>;
+    recordEvent(repo: string, workspace: string, executionId: string, event: ExecutionEvent): Promise<void>;
+    getEventsSince(repo: string, workspace: string, executionId: string, sinceSeq: number): Promise<ExecutionEvent[]>;
+    nextExecutionId(_repo: string, workspace: string): Promise<string>;
+    delete(_repo: string, workspace: string, executionId: string): Promise<void>;
+    /**
+     * Check if an incomplete execution exists for a workspace.
+     *
+     * An execution is incomplete if its status is 'running'.
+     * This is used to detect crash recovery scenarios.
+     *
+     * @param repo - Repository identifier
+     * @param workspace - Workspace name
+     * @returns The incomplete execution if one exists, null otherwise
+     */
+    getIncompleteExecution(repo: string, workspace: string): Promise<DataflowExecutionState | null>;
+    /**
+     * Write a binary file atomically using temp file + rename.
+     */
+    private atomicWrite;
+    /**
+     * Write a text file atomically using temp file + rename.
+     */
+    private atomicWriteText;
+}
+//# sourceMappingURL=FileStateStore.d.ts.map

package/dist/src/dataflow/state-store/FileStateStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileStateStore.d.ts","sourceRoot":"","sources":["../../../../src/dataflow/state-store/FileStateStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EAEnB,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AASrB;;;;;;;;;GASG;AACH,qBAAa,cAAe,YAAW,mBAAmB;IAM5C,OAAO,CAAC,QAAQ,CAAC,aAAa;IAL1C;;;;OAIG;gBAC0B,aAAa,EAAE,MAAM;IAElD;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,WAAW;IAIb,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAcpD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IA0BzF,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAcpF,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpD,gBAAgB,CACpB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAqCV,YAAY,CAChB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,EACxD,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC;IAyBV,WAAW,CACf,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,IAAI,CAAC;IAYV,cAAc,CAClB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,EAAE,CAAC;IAetB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBlE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBlF;;;;;;;;;OASG;IACG,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAQrG;;OAEG;YACW,WAAW;IAmBzB;;OAEG;YACW,eAAe;CAkB9B"}

package/dist/src/dataflow/state-store/FileStateStore.js

@@ -0,0 +1,286 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * File-based implementation of ExecutionStateStore.
+ *
+ * Persists execution state to the workspace directory structure:
+ * - workspaces/{ws}/execution.beast2 - Current/last execution state (binary format)
+ * - workspaces/{ws}/execution-counter - Auto-increment counter
+ *
+ * Events are stored inline in the execution state (not as a separate file).
+ * This enables crash recovery and external monitoring of execution progress.
+ */
+import { promises as fs } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { encodeBeast2For, decodeBeast2For, some } from '@elaraai/east';
+import { DataflowExecutionStateType, } from '../types.js';
+// Create encoder/decoder for beast2 serialization
+const encode = encodeBeast2For(DataflowExecutionStateType);
+const decode = decodeBeast2For(DataflowExecutionStateType);
+/**
+ * File-based state store for local filesystem persistence.
+ *
+ * @remarks
+ * - Uses atomic writes (write to temp, then rename) for durability
+ * - State is stored in beast2 binary format for type safety
+ * - Events are stored inline in the execution state
+ * - Thread-safe for concurrent access within a single process (via file locking)
+ * - Suitable for local CLI and API server usage
+ */
+export class FileStateStore {
+    workspacesDir;
+    /**
+     * Create a new FileStateStore.
+     *
+     * @param workspacesDir - Path to the workspaces directory (e.g., repo/workspaces)
+     */
+    constructor(workspacesDir) {
+        this.workspacesDir = workspacesDir;
+    }
+    /**
+     * Get the path to a workspace's directory.
+     */
+    workspacePath(workspace) {
+        return join(this.workspacesDir, workspace);
+    }
+    /**
+     * Get the path to a workspace's execution state file.
+     */
+    statePath(workspace) {
+        return join(this.workspacePath(workspace), 'execution.beast2');
+    }
+    /**
+     * Get the path to a workspace's execution counter file.
+     */
+    counterPath(workspace) {
+        return join(this.workspacePath(workspace), 'execution-counter');
+    }
+    async create(state) {
+        const path = this.statePath(state.workspace);
+        // Check if execution already exists
+        const existing = await this.read(state.repo, state.workspace, state.id);
+        if (existing) {
+            throw new Error(`Execution ${state.id} already exists in workspace '${state.workspace}'`);
+        }
+        // Write state atomically using beast2 encoding
+        const data = encode(state);
+        await this.atomicWrite(path, data);
+    }
+    async read(repo, workspace, id) {
+        const path = this.statePath(workspace);
+        try {
+            const data = await fs.readFile(path);
+            const state = decode(data);
+            // Check if this is the requested execution
+            if (state.id !== id) {
+                return null;
+            }
+            // Verify repo matches (if stored)
+            if (state.repo && state.repo !== repo) {
+                return null;
+            }
+            return state;
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                return null;
+            }
+            throw err;
+        }
+    }
+    async readLatest(_repo, workspace) {
+        const path = this.statePath(workspace);
+        try {
+            const data = await fs.readFile(path);
+            return decode(data);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                return null;
+            }
+            throw err;
+        }
+    }
+    async update(state) {
+        const path = this.statePath(state.workspace);
+        const data = encode(state);
+        await this.atomicWrite(path, data);
+    }
+    async updateTaskStatus(repo, workspace, executionId, task, status, details) {
+        const state = await this.read(repo, workspace, executionId);
+        if (!state) {
+            throw new Error(`Execution ${executionId} not found in workspace '${workspace}'`);
+        }
+        const taskState = state.tasks.get(task);
+        if (!taskState) {
+            throw new Error(`Task '${task}' not found in execution ${executionId}`);
+        }
+        const mutableState = state;
+        taskState.status = status;
+        if (details) {
+            if (details.cached !== undefined)
+                taskState.cached = some(details.cached);
+            if (details.outputHash !== undefined)
+                taskState.outputHash = some(details.outputHash);
+            if (details.error !== undefined)
+                taskState.error = some(details.error);
+            if (details.exitCode !== undefined)
+                taskState.exitCode = some(BigInt(details.exitCode));
+            if (details.duration !== undefined)
+                taskState.duration = some(BigInt(details.duration));
+        }
+        taskState.completedAt = some(new Date());
+        // Update counters based on status
+        if (status === 'completed' && details?.cached) {
+            mutableState.cached = state.cached + 1n;
+        }
+        else if (status === 'completed') {
+            mutableState.executed = state.executed + 1n;
+        }
+        else if (status === 'failed') {
+            mutableState.failed = state.failed + 1n;
+        }
+        else if (status === 'skipped') {
+            mutableState.skipped = state.skipped + 1n;
+        }
+        await this.update(state);
+    }
+    async updateStatus(repo, workspace, executionId, status, details) {
+        const state = await this.read(repo, workspace, executionId);
+        if (!state) {
+            throw new Error(`Execution ${executionId} not found in workspace '${workspace}'`);
+        }
+        const mutableState = state;
+        mutableState.status = status;
+        if (status !== 'running') {
+            mutableState.completedAt = some(new Date());
+        }
+        if (details?.error) {
+            mutableState.error = some(details.error);
+        }
+        if (details?.summary) {
+            mutableState.executed = BigInt(details.summary.executed);
+            mutableState.cached = BigInt(details.summary.cached);
+            mutableState.failed = BigInt(details.summary.failed);
+            mutableState.skipped = BigInt(details.summary.skipped);
+        }
+        await this.update(state);
+    }
+    async recordEvent(repo, workspace, executionId, event) {
+        const state = await this.read(repo, workspace, executionId);
+        if (!state) {
+            throw new Error(`Execution ${executionId} not found in workspace '${workspace}'`);
+        }
+        // Append event to inline events array (cast to mutable array)
+        state.events.push(event);
+        await this.update(state);
+    }
+    async getEventsSince(repo, workspace, executionId, sinceSeq) {
+        const state = await this.read(repo, workspace, executionId);
+        if (!state) {
+            return [];
+        }
+        // Filter events from inline array
+        const sinceSeqBigInt = BigInt(sinceSeq);
+        return state.events.filter(e => {
+            // Events are variants, so we access seq via e.value.seq
+            const seq = e.value.seq;
+            return seq > sinceSeqBigInt;
+        });
+    }
+    async nextExecutionId(_repo, workspace) {
+        const path = this.counterPath(workspace);
+        let current = 0;
+        try {
+            const data = await fs.readFile(path, 'utf-8');
+            current = parseInt(data.trim(), 10) || 0;
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT') {
+                throw err;
+            }
+        }
+        const next = current + 1;
+        await this.atomicWriteText(path, String(next));
+        return String(next);
+    }
+    async delete(_repo, workspace, executionId) {
+        // Only delete if the stored execution matches the requested ID
+        const state = await this.readLatest(_repo, workspace);
+        if (state && state.id === executionId) {
+            const statePath = this.statePath(workspace);
+            try {
+                await fs.unlink(statePath);
+            }
+            catch (err) {
+                if (err.code !== 'ENOENT') {
+                    throw err;
+                }
+            }
+        }
+    }
+    /**
+     * Check if an incomplete execution exists for a workspace.
+     *
+     * An execution is incomplete if its status is 'running'.
+     * This is used to detect crash recovery scenarios.
+     *
+     * @param repo - Repository identifier
+     * @param workspace - Workspace name
+     * @returns The incomplete execution if one exists, null otherwise
+     */
+    async getIncompleteExecution(repo, workspace) {
+        const state = await this.readLatest(repo, workspace);
+        if (state && state.status === 'running') {
+            return state;
+        }
+        return null;
+    }
+    /**
+     * Write a binary file atomically using temp file + rename.
+     */
+    async atomicWrite(path, content) {
+        const dir = dirname(path);
+        const tmpPath = join(dir, `.tmp-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        try {
+            await fs.mkdir(dir, { recursive: true });
+            await fs.writeFile(tmpPath, content);
+            await fs.rename(tmpPath, path);
+        }
+        catch (err) {
+            // Clean up temp file on failure
+            try {
+                await fs.unlink(tmpPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            throw err;
+        }
+    }
+    /**
+     * Write a text file atomically using temp file + rename.
+     */
+    async atomicWriteText(path, content) {
+        const dir = dirname(path);
+        const tmpPath = join(dir, `.tmp-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        try {
+            await fs.mkdir(dir, { recursive: true });
+            await fs.writeFile(tmpPath, content, 'utf-8');
+            await fs.rename(tmpPath, path);
+        }
+        catch (err) {
+            // Clean up temp file on failure
+            try {
+                await fs.unlink(tmpPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=FileStateStore.js.map

package/dist/src/dataflow/state-store/FileStateStore.js.map

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

package/dist/src/dataflow/state-store/InMemoryStateStore.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { ExecutionStateStore, TaskStatusDetails, ExecutionStatusDetails } from './interfaces.js';
+import type { DataflowExecutionState, ExecutionEvent, TaskStatus } from '../types.js';
+/**
+ * In-memory state store for testing and simple use cases.
+ *
+ * @remarks
+ * - Thread-safe for concurrent access within a single process
+ * - State is lost on process exit
+ * - No durability guarantees
+ */
+export declare class InMemoryStateStore implements ExecutionStateStore {
+    /** Map of "repo::workspace" -> execution ID -> state */
+    private states;
+    /** Map of "repo::workspace" -> next execution ID counter */
+    private counters;
+    private makeKey;
+    create(state: DataflowExecutionState): Promise<void>;
+    read(repo: string, workspace: string, id: string): Promise<DataflowExecutionState | null>;
+    readLatest(repo: string, workspace: string): Promise<DataflowExecutionState | null>;
+    update(state: DataflowExecutionState): Promise<void>;
+    updateTaskStatus(repo: string, workspace: string, executionId: string, task: string, status: TaskStatus, details?: TaskStatusDetails): Promise<void>;
+    updateStatus(repo: string, workspace: string, executionId: string, status: 'running' | 'completed' | 'failed' | 'cancelled', details?: ExecutionStatusDetails): Promise<void>;
+    recordEvent(repo: string, workspace: string, executionId: string, event: ExecutionEvent): Promise<void>;
+    getEventsSince(repo: string, workspace: string, executionId: string, sinceSeq: number): Promise<ExecutionEvent[]>;
+    nextExecutionId(repo: string, workspace: string): Promise<string>;
+    delete(repo: string, workspace: string, executionId: string): Promise<void>;
+    /**
+     * Clear all state (for testing).
+     */
+    clear(): void;
+    /**
+     * Deep clone execution state to prevent external mutation.
+     *
+     * Note: We use spread and some() to properly clone the branded option types.
+     */
+    private cloneState;
+}
+//# sourceMappingURL=InMemoryStateStore.d.ts.map

package/dist/src/dataflow/state-store/InMemoryStateStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryStateStore.d.ts","sourceRoot":"","sources":["../../../../src/dataflow/state-store/InMemoryStateStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,sBAAsB,EAEtB,cAAc,EACd,UAAU,EAEX,MAAM,aAAa,CAAC;AAKrB;;;;;;;GAOG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D,wDAAwD;IACxD,OAAO,CAAC,MAAM,CAA0D;IAExE,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAA6B;IAE7C,OAAO,CAAC,OAAO;IAKT,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBpD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAYzF,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAwBnF,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpD,gBAAgB,CACpB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAwBV,YAAY,CAChB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,EACxD,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC;IAyBV,WAAW,CACf,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,IAAI,CAAC;IAaV,cAAc,CAClB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,EAAE,CAAC;IActB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASjE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjF;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,OAAO,CAAC,UAAU;CAmCnB"}