@substrate-ai/core 0.19.54

package/dist/persistence/dolt-init.js

@@ -0,0 +1,233 @@
+/**
+ * Dolt initialization logic for the Substrate state layer.
+ *
+ * Provides `initializeDolt()` which creates and seeds a Dolt repository
+ * using only the Dolt CLI — no mysql2 dependency is required at this stage.
+ * Extracted to @substrate-ai/core so downstream packages can import it.
+ */
+import { spawn } from 'node:child_process';
+import { mkdir, access } from 'node:fs/promises';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Error classes
+// ---------------------------------------------------------------------------
+/**
+ * Thrown when the `dolt` binary cannot be found in PATH.
+ */
+export class DoltNotInstalled extends Error {
+    constructor() {
+        super('Dolt CLI not found in PATH. Install Dolt from https://docs.dolthub.com/introduction/installation');
+        this.name = 'DoltNotInstalled';
+    }
+}
+/**
+ * Thrown when a Dolt CLI command exits with a non-zero status code.
+ */
+export class DoltInitError extends Error {
+    constructor(args, exitCode, stderr) {
+        super(`Dolt command "dolt ${args.join(' ')}" failed with exit code ${exitCode}${stderr ? `: ${stderr}` : ''}`);
+        this.name = 'DoltInitError';
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Verify that the `dolt` binary is installed and accessible.
+ *
+ * @throws {DoltNotInstalled} If the binary is not found in PATH.
+ */
+export async function checkDoltInstalled() {
+    return new Promise((resolve, reject) => {
+        let child;
+        try {
+            child = spawn('dolt', ['version'], { stdio: 'ignore' });
+        }
+        catch (err) {
+            const nodeErr = err;
+            if (nodeErr.code === 'ENOENT') {
+                reject(new DoltNotInstalled());
+            }
+            else {
+                reject(err);
+            }
+            return;
+        }
+        child.on('error', (err) => {
+            if (err.code === 'ENOENT') {
+                reject(new DoltNotInstalled());
+            }
+            else {
+                reject(err);
+            }
+        });
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                // dolt exited non-zero but was found — treat as installed but broken
+                resolve();
+            }
+        });
+    });
+}
+/**
+ * Run a Dolt CLI command in the given working directory.
+ *
+ * @param args - Arguments to pass to `dolt` (e.g. `['init']`).
+ * @param cwd  - Working directory for the command.
+ * @throws {DoltInitError} If the command exits with a non-zero code.
+ */
+export async function runDoltCommand(args, cwd) {
+    return new Promise((resolve, reject) => {
+        const stderrChunks = [];
+        const child = spawn('dolt', args, { cwd, stdio: ['ignore', 'ignore', 'pipe'] });
+        child.stderr?.on('data', (chunk) => {
+            stderrChunks.push(chunk);
+        });
+        child.on('error', (err) => {
+            reject(err);
+        });
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                const stderr = Buffer.concat(stderrChunks).toString('utf8').trim();
+                reject(new DoltInitError(args, code ?? -1, stderr));
+            }
+        });
+    });
+}
+/**
+ * Ensure that Dolt has a global user identity configured.
+ * `dolt init` and `dolt commit` fail with "empty ident name not allowed"
+ * when no identity exists. This function checks for an existing identity
+ * and configures a default one if absent.
+ */
+async function ensureDoltIdentity() {
+    const hasIdentity = await doltConfigGet('user.name');
+    if (hasIdentity)
+        return;
+    // Configure a default identity for substrate state commits
+    await runDoltConfigSet('user.name', 'substrate');
+    await runDoltConfigSet('user.email', 'substrate@localhost');
+}
+/**
+ * Check if a Dolt global config key has a value set.
+ */
+async function doltConfigGet(key) {
+    return new Promise((resolve) => {
+        const child = spawn('dolt', ['config', '--global', '--get', key], {
+            stdio: ['ignore', 'ignore', 'ignore'],
+        });
+        child.on('error', () => resolve(false));
+        child.on('close', (code) => resolve(code === 0));
+    });
+}
+/**
+ * Set a Dolt global config value.
+ */
+async function runDoltConfigSet(key, value) {
+    return new Promise((resolve, reject) => {
+        const child = spawn('dolt', ['config', '--global', '--add', key, value], {
+            stdio: ['ignore', 'ignore', 'pipe'],
+        });
+        const stderrChunks = [];
+        child.stderr?.on('data', (chunk) => stderrChunks.push(chunk));
+        child.on('error', reject);
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                const stderr = Buffer.concat(stderrChunks).toString('utf8').trim();
+                reject(new DoltInitError(['config', '--global', '--add', key, value], code ?? -1, stderr));
+            }
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Initialize a Dolt repository for Substrate state storage.
+ *
+ * This function is idempotent: running it a second time on an already-
+ * initialized repository is safe — `dolt init` is skipped, existing tables
+ * are not re-created (IF NOT EXISTS guards), and the schema version row is
+ * not duplicated (INSERT IGNORE).
+ *
+ * @param config - Initialization configuration. `schemaPath` is required.
+ * @throws {DoltNotInstalled} If the `dolt` binary is not in PATH.
+ * @throws {DoltInitError} If any Dolt CLI command fails.
+ */
+export async function initializeDolt(config) {
+    // Resolve paths
+    const statePath = config.statePath ?? join(config.projectRoot, '.substrate', 'state');
+    const schemaPath = config.schemaPath;
+    // 1. Verify Dolt is installed
+    await checkDoltInstalled();
+    // 2. Create the state directory (recursive — idempotent)
+    await mkdir(statePath, { recursive: true });
+    // 3. Ensure Dolt has a user identity configured (required for `dolt init`
+    //    and `dolt commit`). If no global identity exists, configure one
+    //    automatically so init doesn't fail with "empty ident name not allowed".
+    await ensureDoltIdentity();
+    // 4. Initialize Dolt repo only if .dolt/ does not already exist
+    const doltDir = join(statePath, '.dolt');
+    let doltDirExists = false;
+    try {
+        await access(doltDir);
+        doltDirExists = true;
+    }
+    catch {
+        doltDirExists = false;
+    }
+    if (!doltDirExists) {
+        await runDoltCommand(['init'], statePath);
+    }
+    // 5. Apply the DDL (idempotent via IF NOT EXISTS / INSERT IGNORE)
+    await runDoltCommand(['sql', '-f', schemaPath], statePath);
+    // 6. Create the initial commit only if no commits exist yet
+    let hasCommits = false;
+    try {
+        await runDoltCommand(['log', '--oneline'], statePath);
+        // If this succeeds, check whether there is any output.
+        // We use a separate helper that captures stdout to detect empty log.
+        hasCommits = await doltLogHasCommits(statePath);
+    }
+    catch {
+        hasCommits = false;
+    }
+    if (!hasCommits) {
+        await runDoltCommand(['add', '-A'], statePath);
+        await runDoltCommand(['commit', '-m', 'Initialize substrate state schema v1'], statePath);
+    }
+}
+/**
+ * Returns `true` if there is at least one commit in the Dolt repo.
+ */
+async function doltLogHasCommits(cwd) {
+    return new Promise((resolve) => {
+        const stdoutChunks = [];
+        const child = spawn('dolt', ['log', '--oneline'], {
+            cwd,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        child.stdout?.on('data', (chunk) => {
+            stdoutChunks.push(chunk);
+        });
+        child.on('error', () => resolve(false));
+        child.on('close', (code) => {
+            if (code !== 0) {
+                resolve(false);
+                return;
+            }
+            const output = Buffer.concat(stdoutChunks).toString('utf8').trim();
+            resolve(output.length > 0);
+        });
+    });
+}
+//# sourceMappingURL=dolt-init.js.map

package/dist/persistence/dolt-init.js.map

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

package/dist/persistence/index.d.ts

@@ -0,0 +1,23 @@
+export * from './types.js';
+export * from './schema-version.js';
+export * from './adapter.js';
+export * from './dolt-adapter.js';
+export * from './memory-adapter.js';
+export { initSchema } from './schema.js';
+export * from './cost-types.js';
+export * from './schemas/decisions.js';
+export * from './schemas/operational.js';
+export * from './queries/amendments.js';
+export { createDecision, upsertDecision, getDecisionsByPhase, getDecisionsByPhaseForRun, getDecisionsByCategory, getDecisionByKey, updateDecision, createRequirement, listRequirements, updateRequirementStatus, createConstraint, listConstraints, registerArtifact, getArtifactsByPhase, getArtifactByType, getArtifactByTypeForRun, getArtifactsByRun, getPipelineRunById, updatePipelineRunConfig, createPipelineRun, updatePipelineRun, getRunningPipelineRuns, getLatestRun, addTokenUsage, getTokenUsageSummary, } from './queries/decisions.js';
+export type { TokenUsageSummary } from './queries/decisions.js';
+export * from './queries/cost.js';
+export * from './queries/metrics.js';
+export * from './queries/retry-escalated.js';
+export * from './monitor-database.js';
+export { DoltClient, createDoltClient } from './dolt-client.js';
+export type { DoltClientOptions } from './dolt-client.js';
+export { initializeDolt, checkDoltInstalled, runDoltCommand } from './dolt-init.js';
+export type { DoltInitConfig } from './dolt-init.js';
+export { DoltNotInstalled, DoltInitError } from './dolt-init.js';
+export { DoltQueryError } from './dolt-errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/persistence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/persistence/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,cAAc,qBAAqB,CAAA;AACnC,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AAEvC,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,oBAAoB,GACrB,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,uBAAuB,CAAA;AACrC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAC/D,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACnF,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/persistence/index.js

@@ -0,0 +1,23 @@
+// @substrate-ai/core — persistence public API
+export * from './types.js';
+export * from './schema-version.js';
+export * from './adapter.js';
+export * from './dolt-adapter.js';
+export * from './memory-adapter.js';
+export { initSchema } from './schema.js';
+// Canonical cost types — single source of truth (avoids dual-definition with src/modules/cost-tracker/types.ts)
+export * from './cost-types.js';
+export * from './schemas/decisions.js';
+export * from './schemas/operational.js';
+export * from './queries/amendments.js';
+// Export decisions query functions explicitly; Decision/Requirement/etc. types come from schemas/decisions.js above
+export { createDecision, upsertDecision, getDecisionsByPhase, getDecisionsByPhaseForRun, getDecisionsByCategory, getDecisionByKey, updateDecision, createRequirement, listRequirements, updateRequirementStatus, createConstraint, listConstraints, registerArtifact, getArtifactsByPhase, getArtifactByType, getArtifactByTypeForRun, getArtifactsByRun, getPipelineRunById, updatePipelineRunConfig, createPipelineRun, updatePipelineRun, getRunningPipelineRuns, getLatestRun, addTokenUsage, getTokenUsageSummary, } from './queries/decisions.js';
+export * from './queries/cost.js';
+export * from './queries/metrics.js';
+export * from './queries/retry-escalated.js';
+export * from './monitor-database.js';
+export { DoltClient, createDoltClient } from './dolt-client.js';
+export { initializeDolt, checkDoltInstalled, runDoltCommand } from './dolt-init.js';
+export { DoltNotInstalled, DoltInitError } from './dolt-init.js';
+export { DoltQueryError } from './dolt-errors.js';
+//# sourceMappingURL=index.js.map

package/dist/persistence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/persistence/index.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,cAAc,YAAY,CAAA;AAC1B,cAAc,qBAAqB,CAAA;AACnC,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,gHAAgH;AAChH,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,oHAAoH;AACpH,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,oBAAoB,GACrB,MAAM,wBAAwB,CAAA;AAE/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,uBAAuB,CAAA;AACrC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAE/D,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEnF,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/persistence/memory-adapter.d.ts

@@ -0,0 +1,156 @@
+/**
+ * InMemoryDatabaseAdapter — satisfies the DatabaseAdapter interface using
+ * plain in-memory Maps and arrays.  Designed for CI environments and unit
+ * tests where no external database is available.
+ *
+ * SQL support is intentionally limited to the patterns used by
+ * `src/persistence/queries/`:
+ *   - CREATE TABLE [IF NOT EXISTS] name (col type, ...)
+ *   - DROP TABLE [IF EXISTS] name
+ *   - INSERT INTO name (cols) VALUES (vals)
+ *   - SELECT * / cols FROM name [WHERE simple-conditions]
+ *   - SELECT literal-expressions (no FROM clause)
+ *   - UPDATE name SET col = val [WHERE simple-conditions]
+ *   - DELETE FROM name [WHERE simple-conditions]
+ *
+ * WHERE clauses support simple equality conditions joined by AND.
+ * Transactions use a snapshot-and-restore pattern.
+ */
+import type { DatabaseAdapter, SyncAdapter } from './types.js';
+export declare class InMemoryDatabaseAdapter implements DatabaseAdapter, SyncAdapter {
+    readonly backendType: "memory";
+    private _tables;
+    private _indexes;
+    /** Maps table name → auto-increment column name */
+    private _autoIncrementCols;
+    /** Maps table name → last assigned auto-increment value */
+    private _autoIncrementCounters;
+    /** Maps "tableName.colName" → default value expression ('CURRENT_TIMESTAMP' → ISO string, else literal) */
+    private _columnDefaults;
+    /** Maps table name → array of primary key column names */
+    private _primaryKeys;
+    /** Maps table name → ordered list of column names (from CREATE TABLE) */
+    private _tableColumns;
+    query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;
+    exec(sql: string): Promise<void>;
+    querySync<T = unknown>(sql: string, params?: unknown[]): T[];
+    execSync(sql: string): void;
+    transaction<T>(fn: (adapter: DatabaseAdapter) => Promise<T>): Promise<T>;
+    close(): Promise<void>;
+    /**
+     * Work graph not supported in InMemoryDatabaseAdapter.
+     * Returns `[]` to signal the caller to use the legacy discovery path.
+     */
+    queryReadyStories(): Promise<string[]>;
+    private _execute;
+    /**
+     * Replace each `?` placeholder with an escaped literal value.
+     */
+    private _substituteParams;
+    private _createTable;
+    private _dropTable;
+    private _createIndex;
+    private _dropIndex;
+    /**
+     * Emulate PRAGMA table_info(tableName) — returns one row per column with
+     * {cid, name, type, notnull, dflt_value, pk} shape.
+     * Column names are derived from the CREATE TABLE definition order.
+     * This is sufficient for schema compatibility checks.
+     */
+    private _pragmaTableInfo;
+    private _selectFromSqliteMaster;
+    private _insert;
+    private _select;
+    /**
+     * Apply GROUP BY: bucket rows by the group-by columns, then evaluate
+     * aggregate expressions for each bucket. Plain column references in the
+     * SELECT list that are also GROUP BY columns return the group value from
+     * the first row in the bucket (all rows in a group share the same value).
+     */
+    private _applyGroupBy;
+    /**
+     * Parse ORDER BY expression list into sort keys.
+     * Handles: simple columns, COALESCE(col, default) DESC, CASE...END expressions.
+     */
+    private _parseOrderBy;
+    /**
+     * Sort rows according to ORDER BY expression list.
+     */
+    private _applyOrderBy;
+    /**
+     * Evaluate an ORDER BY expression for a single row.
+     */
+    private _evalOrderByExpr;
+    /**
+     * Compare two values for sorting (handles null, numbers, strings).
+     * Returns negative if a < b, 0 if equal, positive if a > b.
+     */
+    private _compareValues;
+    /**
+     * Evaluate SELECT expressions against a single GROUP BY bucket.
+     * Handles both aggregate expressions (SUM, COUNT, COALESCE) and plain
+     * column references (for GROUP BY projected columns).
+     */
+    private _evalAggregateGroup;
+    /**
+     * Evaluate a single aggregate expression against a GROUP BY bucket.
+     * Extends _evalAggregateExpr with:
+     *   - SUM(expr)       where expr may be CASE WHEN ... END
+     *   - Plain column references (returns first-row value, for GROUP BY cols)
+     */
+    private _evalAggregateExprGrouped;
+    /**
+     * Evaluate an expression for a single row.
+     * Supports CASE WHEN conditions, COALESCE, column references, and literals.
+     * Used by _evalAggregateExprGrouped to evaluate the argument of SUM().
+     */
+    private _evalRowExpr;
+    /**
+     * Evaluate a simple condition (col = 'str', col = num) for a single row.
+     * Returns true if the condition holds.
+     */
+    private _evalRowCondition;
+    private _update;
+    private _delete;
+    /**
+     * Evaluate a simple WHERE clause against a row.
+     * Supports: `col = val` conditions joined by AND.
+     */
+    private _matchWhere;
+    private _projectCols;
+    private _evalSelectExprs;
+    private _evalLiteral;
+    private _evalExprAgainstRow;
+    /**
+     * Split a string by commas that are NOT inside parentheses.
+     * E.g. "COALESCE(SUM(x), 0) as a, y" → ["COALESCE(SUM(x), 0) as a", "y"]
+     */
+    private _splitTopLevelCommas;
+    /**
+     * Evaluate aggregate SELECT expressions (SUM, COALESCE, COUNT) across
+     * a set of filtered rows, returning a single result row.
+     */
+    private _evalAggregate;
+    /**
+     * Evaluate a single aggregate expression against a set of rows.
+     * Supports: SUM(expr), COALESCE(expr, default), COUNT(*), MAX(col), MIN(col).
+     */
+    private _evalAggregateExpr;
+    /**
+     * Parse a comma-separated list of SQL literal values.
+     * Handles: NULL, numbers, single-quoted strings.
+     * Simple split by comma (assumes no commas inside string values).
+     */
+    private _parseValueList;
+    /**
+     * Parse `col1 = val1, col2 = val2` assignments into an array of [col, val] pairs.
+     * Evaluates each RHS expression against the provided row for arithmetic support.
+     */
+    private _parseAssignmentsForRow;
+    /**
+     * Evaluate a SET assignment RHS expression against the current row.
+     * Handles: simple literals, column arithmetic (col +/- val), COALESCE, CURRENT_TIMESTAMP.
+     */
+    private _evalAssignmentExpr;
+}
+//# sourceMappingURL=memory-adapter.d.ts.map

package/dist/persistence/memory-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-adapter.d.ts","sourceRoot":"","sources":["../../src/persistence/memory-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAQ9D,qBAAa,uBAAwB,YAAW,eAAe,EAAE,WAAW;IAC1E,QAAQ,CAAC,WAAW,EAAG,QAAQ,CAAS;IACxC,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAA8D;IAC9E,mDAAmD;IACnD,OAAO,CAAC,kBAAkB,CAA4B;IACtD,2DAA2D;IAC3D,OAAO,CAAC,sBAAsB,CAA4B;IAC1D,2GAA2G;IAC3G,OAAO,CAAC,eAAe,CAA4B;IACnD,0DAA0D;IAC1D,OAAO,CAAC,YAAY,CAA8B;IAClD,yEAAyE;IACzE,OAAO,CAAC,aAAa,CAA8B;IAM7C,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAKjE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtC,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE;IAK5D,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIrB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmBxE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAQ5C,OAAO,CAAC,QAAQ;IA8ChB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,YAAY;IAiFpB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,UAAU;IAalB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,uBAAuB;IA6B/B,OAAO,CAAC,OAAO;IA6Df,OAAO,CAAC,OAAO;IAwFf;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAoBrB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAOtB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAgEjC;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAgCpB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAwBzB,OAAO,CAAC,OAAO;IA4Bf,OAAO,CAAC,OAAO;IA0Bf;;;OAGG;IACH,OAAO,CAAC,WAAW;IA4HnB,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,mBAAmB;IAa3B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAwC5B;;;OAGG;IACH,OAAO,CAAC,cAAc;IActB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAuE1B;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAoCvB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAuC/B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CAsC5B"}