@exellix/exellix-runtime 3.5.1

package/dist/execution-matrix/runtime-store.js

@@ -0,0 +1,506 @@
+import { RUNTIME_ROW_INPUT_SOURCE_ID_KEY } from './contracts.js';
+import { rollupSourceExecutionStatuses } from './records-eligibility.js';
+import { assertExecutionMatrixStatus, normalizeExecutionMatrixStatus } from './status.js';
+function isoNow() {
+    return new Date().toISOString();
+}
+function emptyCounts() {
+    return {
+        'not-started': 0,
+        'in-progress': 0,
+        completed: 0,
+        failed: 0,
+        skipped: 0,
+    };
+}
+function rowMatchesExtraFilter(row, filter) {
+    if (!filter || Object.keys(filter).length === 0)
+        return true;
+    for (const [path, expected] of Object.entries(filter)) {
+        const parts = path.split('.').filter(Boolean);
+        let cur = row;
+        for (const p of parts) {
+            if (cur == null || typeof cur !== 'object')
+                return false;
+            cur = cur[p];
+        }
+        if (cur !== expected)
+            return false;
+    }
+    return true;
+}
+/**
+ * When **every** scope specifies non-empty `graphIds`, rollups use their union; otherwise all graphs
+ * on matched rows are included.
+ */
+function rollupGraphIdsUnion(scopes) {
+    if (scopes.length === 0)
+        return undefined;
+    const allHave = scopes.every((s) => Array.isArray(s.graphIds) && s.graphIds.length > 0);
+    if (!allHave)
+        return undefined;
+    return [...new Set(scopes.flatMap((s) => s.graphIds))];
+}
+/** xronox / memory filter for matrix rows scoped by catalog and optional per-graph execution slot. */
+export function buildMatrixRowReadFilter(matrixCatalogId, matrixRunId, graphId, status, extra) {
+    const base = { matrixCatalogId, ...(matrixRunId ? { matrixRunId } : {}) };
+    if (graphId && status) {
+        return {
+            ...base,
+            execution: { $elemMatch: { graphId, status } },
+            ...extra,
+        };
+    }
+    if (graphId) {
+        return { ...base, execution: { $elemMatch: { graphId } }, ...extra };
+    }
+    return { ...base, ...extra };
+}
+/** xronox filter for snapshot reads (shared by {@link ExecutionMatrixRuntime.listSnapshots} / {@link ExecutionMatrixRuntime.countSnapshots}). */
+export function buildSnapshotsReadFilter(opts) {
+    const filter = {};
+    if (opts.matrixCatalogId !== undefined)
+        filter.matrixCatalogId = opts.matrixCatalogId;
+    if (opts.matrixRunId !== undefined)
+        filter.matrixRunId = opts.matrixRunId;
+    if ('entityType' in opts && opts.entityType !== undefined)
+        filter.entityType = opts.entityType;
+    const xf = 'extraFilter' in opts ? opts.extraFilter : undefined;
+    if (xf && Object.keys(xf).length > 0) {
+        Object.assign(filter, xf);
+    }
+    return filter;
+}
+/** xronox filter for failure reads (shared by count/list). */
+export function buildFailureRecordsReadFilter(opts) {
+    const filter = { matrixCatalogId: opts.matrixCatalogId };
+    if (opts.matrixRunId !== undefined)
+        filter.matrixRunId = opts.matrixRunId;
+    if (opts.graphId !== undefined)
+        filter.graphId = opts.graphId;
+    if (opts.matrixRowId !== undefined)
+        filter.matrixRowId = opts.matrixRowId;
+    if (opts.createdAtMin !== undefined || opts.createdAtMax !== undefined) {
+        const bounds = {};
+        if (opts.createdAtMin !== undefined)
+            bounds.$gte = opts.createdAtMin;
+        if (opts.createdAtMax !== undefined)
+            bounds.$lte = opts.createdAtMax;
+        filter.createdAt = bounds;
+    }
+    return filter;
+}
+function buildLastAttempt(status, endedAt, meta) {
+    const out = { status, endedAt };
+    if (meta?.modelProfile)
+        out.modelProfile = meta.modelProfile;
+    if (meta?.jobId)
+        out.jobId = meta.jobId;
+    return out;
+}
+/**
+ * Runtime persistence for execution matrix rows, failure side-channel, and snapshots.
+ * **All reads and writes go through {@link @x12i/xronox-store} collections** — this package does not
+ * accept or open a native Mongo `Db` handle. Claims use read–modify–write on the rows collection;
+ * set `serializeClaims: false` only when a single worker owns claims (unsafe under concurrent claimants).
+ *
+ * Snapshots are operational artifacts produced by `query-snapshot` data sources (see
+ * {@link ExecutionMatrixSnapshotRecord}). The collection is optional — when omitted the
+ * snapshot CRUD methods throw, which keeps existing callers (no snapshot use case) unaffected.
+ */
+export class ExecutionMatrixRuntime {
+    rows;
+    failures;
+    options;
+    claimChain = Promise.resolve();
+    snapshots;
+    constructor(rows, failures, options = {}) {
+        this.rows = rows;
+        this.failures = failures;
+        this.options = options;
+        this.snapshots = options.snapshots;
+    }
+    withClaimLock(fn) {
+        if (this.options.serializeClaims !== false) {
+            const run = this.claimChain.then(fn, fn);
+            this.claimChain = run.then(() => undefined, () => undefined);
+            return run;
+        }
+        return fn();
+    }
+    requireSnapshots() {
+        if (!this.snapshots) {
+            throw new Error('ExecutionMatrixRuntime: snapshots collection not configured (pass options.snapshots or use the runtime factory)');
+        }
+        return this.snapshots;
+    }
+    async insertRuntimeRow(row) {
+        const id = await this.rows.insert(row);
+        return id;
+    }
+    async getRecord(matrixRowId) {
+        const doc = await this.rows.getByKey(matrixRowId);
+        return doc ? doc : null;
+    }
+    async listRecords(opts) {
+        const filter = buildMatrixRowReadFilter(opts.matrixCatalogId, opts.matrixRunId, opts.graphId, opts.status, opts.extraFilter);
+        const list = await this.rows.readMany(filter, {
+            limit: opts.limit ?? 200,
+            sort: opts.sort ?? { materializationOrder: 1, updatedAt: 1 },
+            mergeCache: true,
+        });
+        return list;
+    }
+    /**
+     * Batch read execution slots for many source keys across one or more matrix catalogs, then
+     * {@link rollupSourceExecutionStatuses}.
+     *
+     * Uses {@link listRecords} with `extraFilter` `{ [sourceKeyPath]: { $in: sourceKeys } }` per scope.
+     */
+    async batchLookupSourceExecutionStatuses(opts) {
+        const limitPerScope = opts.limitPerScope ?? 5000;
+        const globalCap = opts.globalRowCap ?? 50_000;
+        const sourceKeyPath = opts.sourceKeyPath ?? `input.${RUNTIME_ROW_INPUT_SOURCE_ID_KEY}`;
+        const extraFilter = {
+            [sourceKeyPath]: { $in: [...opts.sourceKeys] },
+        };
+        const allRows = [];
+        for (const scope of opts.scopes) {
+            if (allRows.length >= globalCap)
+                break;
+            const take = Math.min(limitPerScope, globalCap - allRows.length);
+            const rows = await this.listRecords({
+                matrixCatalogId: scope.matrixCatalogId,
+                matrixRunId: scope.matrixRunId,
+                extraFilter,
+                limit: take,
+            });
+            allRows.push(...rows);
+        }
+        const graphIds = rollupGraphIdsUnion(opts.scopes);
+        return rollupSourceExecutionStatuses(allRows, { sourceKeyPath, graphIds });
+    }
+    async getStatusCounts(matrixCatalogId, graphId, matrixRunId) {
+        const rows = await this.listRecords({ matrixCatalogId, matrixRunId, limit: 10_000 });
+        const out = emptyCounts();
+        for (const r of rows) {
+            for (const step of r.execution) {
+                if (step.graphId !== graphId)
+                    continue;
+                const st = normalizeExecutionMatrixStatus(step.status);
+                if (st)
+                    out[st] += 1;
+            }
+        }
+        return out;
+    }
+    /**
+     * Count matrix rows matching a Mongo-style filter (same shapes as {@link listRecords} / xronox).
+     * Uses {@link XronoxCollection.countMatching} when the backing collection implements it; otherwise
+     * falls back to a capped {@link readMany} (up to `readManyFallbackCap` documents).
+     */
+    async countRowsMatching(filter, readManyFallbackCap = 100_000) {
+        const coll = this.rows;
+        if (typeof coll.countMatching === 'function') {
+            return await coll.countMatching(filter);
+        }
+        const list = await this.rows.readMany(filter, { limit: readManyFallbackCap, mergeCache: true });
+        return list.length;
+    }
+    /**
+     * Count failure audit documents for dashboards / alerts via xronox `readMany`
+     * (best-effort; cap via `readManyCap` for very large collections).
+     *
+     * Prefer this API (or {@link listFailureRecords}) over calling the failures collection's
+     * `readMany` directly so filter shapes stay aligned with runtime indexing.
+     */
+    async countFailureRecords(opts, readManyCap = 50_000) {
+        const filter = buildFailureRecordsReadFilter(opts);
+        const docs = await this.failures.readMany(filter, { limit: readManyCap, mergeCache: true });
+        return docs.length;
+    }
+    /**
+     * List failure audit documents through the runtime (newest first by default: `createdAt: -1`).
+     *
+     * @param readManyCap Upper bound on documents read from storage (default `50_000`).
+     *   Effective row limit is `min(opts.limit ?? 200, readManyCap)`.
+     */
+    async listFailureRecords(opts, readManyCap = 50_000) {
+        const filter = buildFailureRecordsReadFilter(opts);
+        const limit = Math.min(opts.limit ?? 200, readManyCap);
+        const list = await this.failures.readMany(filter, {
+            limit,
+            ...(opts.skip !== undefined ? { skip: opts.skip } : {}),
+            sort: opts.sort ?? { createdAt: -1 },
+            mergeCache: true,
+        });
+        return list;
+    }
+    /** Read one failure audit document by primary key (`failureId`). */
+    async getFailureRecord(failureId) {
+        const doc = await this.failures.getByKey(failureId);
+        return doc ? doc : null;
+    }
+    /**
+     * Latest failure for a matrix row + graph (by `createdAt`, newest first).
+     * Optional `matrixCatalogId` tightens the filter when the caller knows it.
+     */
+    async getLatestFailureRecordForRowGraph(matrixRowId, graphId, opts) {
+        const filter = { matrixRowId, graphId };
+        if (opts?.matrixCatalogId !== undefined)
+            filter.matrixCatalogId = opts.matrixCatalogId;
+        const list = await this.failures.readMany(filter, {
+            limit: 1,
+            sort: { createdAt: -1 },
+            mergeCache: true,
+        });
+        const first = list[0];
+        return first ? first : null;
+    }
+    async claimNext(opts) {
+        return this.withClaimLock(() => this._claimNextInner(opts));
+    }
+    async claimRecord(opts) {
+        return this.withClaimLock(() => this._claimRecordInner(opts));
+    }
+    async _claimNextInner(opts) {
+        const from = (opts.fromStatuses ?? ['not-started']).map((s) => assertExecutionMatrixStatus(s));
+        const candidates = await this.listRecords({
+            matrixCatalogId: opts.matrixCatalogId,
+            matrixRunId: opts.matrixRunId,
+            graphId: opts.graphId,
+            limit: 5000,
+            sort: { materializationOrder: 1, updatedAt: 1 },
+            extraFilter: opts.extraFilter,
+        });
+        for (const row of candidates) {
+            if (!rowMatchesExtraFilter(row, opts.extraFilter))
+                continue;
+            const idx = row.execution.findIndex((e) => e.graphId === opts.graphId && from.includes(e.status));
+            if (idx < 0)
+                continue;
+            const fresh = await this.rows.getByKey(row.matrixRowId);
+            if (!fresh)
+                continue;
+            const cur = fresh;
+            const j = cur.execution.findIndex((e) => e.graphId === opts.graphId && from.includes(e.status));
+            if (j < 0)
+                continue;
+            const now = isoNow();
+            const nextExec = cur.execution.map((e, i) => i === j
+                ? {
+                    ...e,
+                    status: 'in-progress',
+                    start: now,
+                    lastUpdated: now,
+                    ...(opts.workerId ? { workerId: opts.workerId } : {}),
+                }
+                : e);
+            const next = {
+                ...cur,
+                execution: nextExec,
+                updatedAt: now,
+                claimVersion: (cur.claimVersion ?? 0) + 1,
+            };
+            await this.rows.update(cur.matrixRowId, next);
+            return { ok: true, record: next, graphId: opts.graphId, stepIndex: j };
+        }
+        return { ok: false, reason: 'no_eligible_row' };
+    }
+    async _claimRecordInner(opts) {
+        const from = (opts.fromStatuses ?? ['not-started']).map((s) => assertExecutionMatrixStatus(s));
+        const cur = await this.getRecord(opts.matrixRowId);
+        if (!cur)
+            return { ok: false, reason: 'row_not_found' };
+        if (!rowMatchesExtraFilter(cur, opts.extraFilter))
+            return { ok: false, reason: 'no_eligible_row' };
+        const j = cur.execution.findIndex((e) => e.graphId === opts.graphId && from.includes(e.status));
+        if (j < 0)
+            return { ok: false, reason: 'no_eligible_row' };
+        const now = isoNow();
+        const nextExec = cur.execution.map((e, i) => i === j
+            ? {
+                ...e,
+                status: 'in-progress',
+                start: now,
+                lastUpdated: now,
+                ...(opts.workerId ? { workerId: opts.workerId } : {}),
+            }
+            : e);
+        const next = {
+            ...cur,
+            execution: nextExec,
+            updatedAt: now,
+            claimVersion: (cur.claimVersion ?? 0) + 1,
+        };
+        await this.rows.update(cur.matrixRowId, next);
+        return { ok: true, record: next, graphId: opts.graphId, stepIndex: j };
+    }
+    /** Persist `jobId` on the in-progress execution slot for `graphId` (immediately before `executeGraph`). */
+    async setExecutionStepJobId(matrixRowId, graphId, jobId) {
+        const now = isoNow();
+        const cur = await this.getRecord(matrixRowId);
+        if (!cur)
+            throw new Error(`setExecutionStepJobId: row not found ${matrixRowId}`);
+        const j = cur.execution.findIndex((e) => e.graphId === graphId && e.status === 'in-progress');
+        if (j < 0)
+            throw new Error(`setExecutionStepJobId: no in-progress slot for graph ${graphId}`);
+        const nextExec = cur.execution.map((e, i) => i === j ? { ...e, jobId, lastUpdated: now } : e);
+        await this.rows.update(matrixRowId, {
+            ...cur,
+            execution: nextExec,
+            updatedAt: now,
+        });
+    }
+    async markCompleted(matrixRowId, graphId, inference, attemptMeta) {
+        const cur = await this.getRecord(matrixRowId);
+        if (!cur)
+            throw new Error(`markCompleted: row not found ${matrixRowId}`);
+        const now = isoNow();
+        const lastAttempt = buildLastAttempt('completed', now, attemptMeta);
+        const nextExec = cur.execution.map((e) => e.graphId === graphId && e.status === 'in-progress'
+            ? { ...e, status: 'completed', end: now, lastUpdated: now, lastAttempt }
+            : e);
+        const next = {
+            ...cur,
+            execution: nextExec,
+            inferences: [...cur.inferences, inference],
+            updatedAt: now,
+        };
+        await this.rows.update(matrixRowId, next);
+    }
+    async markFailed(matrixRowId, graphId, reason, failureExtras, attemptMeta) {
+        const cur = await this.getRecord(matrixRowId);
+        if (!cur)
+            throw new Error(`markFailed: row not found ${matrixRowId}`);
+        const now = isoNow();
+        const lastAttempt = buildLastAttempt('failed', now, attemptMeta);
+        const nextExec = cur.execution.map((e) => e.graphId === graphId && e.status === 'in-progress'
+            ? { ...e, status: 'failed', end: now, lastUpdated: now, reason, lastAttempt }
+            : e);
+        const next = {
+            ...cur,
+            execution: nextExec,
+            updatedAt: now,
+        };
+        await this.rows.update(matrixRowId, next);
+        const failure = {
+            failureId: '',
+            matrixRowId,
+            matrixCatalogId: cur.matrixCatalogId,
+            matrixItemId: cur.matrixItemId,
+            matrixRunId: cur.matrixRunId,
+            graphId,
+            reason,
+            inputSnapshot: cur.input,
+            ...failureExtras,
+            createdAt: now,
+        };
+        await this.failures.insert(failure);
+    }
+    async markSkipped(matrixRowId, graphId, reason) {
+        const cur = await this.getRecord(matrixRowId);
+        if (!cur)
+            throw new Error(`markSkipped: row not found ${matrixRowId}`);
+        const now = isoNow();
+        const nextExec = cur.execution.map((e) => e.graphId === graphId && e.status === 'not-started'
+            ? {
+                ...e,
+                status: 'skipped',
+                end: now,
+                lastUpdated: now,
+                reason,
+            }
+            : e);
+        const next = {
+            ...cur,
+            execution: nextExec,
+            updatedAt: now,
+        };
+        await this.rows.update(matrixRowId, next);
+    }
+    /** Apply condition evaluation: mark steps skipped when conditions object is not satisfied (host calls this). */
+    async markStepsSkippedByPredicate(matrixRowId, shouldSkip, reason) {
+        const cur = await this.getRecord(matrixRowId);
+        if (!cur)
+            throw new Error(`markStepsSkippedByPredicate: row not found ${matrixRowId}`);
+        const now = isoNow();
+        const nextExec = cur.execution.map((e) => {
+            if (e.status !== 'not-started')
+                return e;
+            if (!shouldSkip(e))
+                return e;
+            return { ...e, status: 'skipped', end: now, lastUpdated: now, reason };
+        });
+        await this.rows.update(matrixRowId, {
+            ...cur,
+            execution: nextExec,
+            updatedAt: now,
+        });
+    }
+    /* --------------------------------------------------------------------------
+     * Per-status convenience listings (waiting / in-progress / completed / ...)
+     * Thin wrappers over `listRecords` that fix the `status` filter.
+     * ------------------------------------------------------------------------*/
+    /** Rows whose `graphId` slot is in `not-started` (waiting to be claimed). */
+    async listWaiting(opts) {
+        return this.listRecords({ ...opts, status: 'not-started' });
+    }
+    /** Rows whose `graphId` slot is currently `in-progress`. */
+    async listInProgress(opts) {
+        return this.listRecords({ ...opts, status: 'in-progress' });
+    }
+    /** Rows whose `graphId` slot has `completed`. */
+    async listCompleted(opts) {
+        return this.listRecords({ ...opts, status: 'completed' });
+    }
+    /** Rows whose `graphId` slot has `failed`. */
+    async listFailed(opts) {
+        return this.listRecords({ ...opts, status: 'failed' });
+    }
+    /** Rows whose `graphId` slot has been `skipped`. */
+    async listSkipped(opts) {
+        return this.listRecords({ ...opts, status: 'skipped' });
+    }
+    /* --------------------------------------------------------------------------
+     * Snapshots (query-snapshot data source artifacts)
+     * ------------------------------------------------------------------------*/
+    /** Persist a snapshot record. Throws when the snapshots collection is not configured. */
+    async insertSnapshot(record) {
+        const coll = this.requireSnapshots();
+        const id = await coll.insert(record);
+        return id;
+    }
+    /** Read a snapshot by id. Returns `null` when missing. */
+    async getSnapshot(snapshotId) {
+        const coll = this.requireSnapshots();
+        const doc = await coll.getByKey(snapshotId);
+        return doc ? doc : null;
+    }
+    /** List snapshots filtered by matrix / run / optional `entityType` / `extraFilter`, newest first by default. */
+    async listSnapshots(opts) {
+        const coll = this.requireSnapshots();
+        const filter = buildSnapshotsReadFilter(opts);
+        const list = await coll.readMany(filter, {
+            limit: opts.limit ?? 200,
+            ...(opts.skip !== undefined ? { skip: opts.skip } : {}),
+            sort: opts.sort ?? { createdAt: -1 },
+            mergeCache: true,
+        });
+        return list;
+    }
+    /**
+     * Count snapshot documents matching optional catalog / run / entity type / `extraFilter`.
+     * Implemented via capped **`readMany`** (default **50_000**) — not a precise DB count at huge scale.
+     */
+    async countSnapshots(opts, readManyCap = 50_000) {
+        const coll = this.requireSnapshots();
+        const filter = buildSnapshotsReadFilter(opts);
+        const docs = await coll.readMany(filter, { limit: readManyCap, mergeCache: true });
+        return docs.length;
+    }
+}
+export function createExecutionMatrixRuntime(rows, failures, options) {
+    return new ExecutionMatrixRuntime(rows, failures, options ?? {});
+}
+//# sourceMappingURL=runtime-store.js.map

package/dist/execution-matrix/runtime-store.js.map

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

package/dist/execution-matrix/snapshot-runner.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Snapshot transform runner: executes the inline JS source declared on a `query-snapshot`
+ * data source under `node:vm` with a wall-clock timeout.
+ *
+ * **Sandbox is best-effort, NOT a security boundary.** `node:vm` shares the same V8 process and
+ * does not isolate prototype tampering or long synchronous loops perfectly. Hosts that expose this
+ * to untrusted authors must add their own process-level isolation. We intentionally do not pass
+ * `require`, `process`, network globals, or filesystem APIs into the sandbox.
+ */
+import { type ExecutionMatrixSnapshotRecord, type SnapshotTransform } from './contracts.js';
+/** Result of running a snapshot transform — payload is whatever the function returns. */
+export type SnapshotTransformResult = {
+    payload: unknown;
+    transformVersion: string;
+};
+export declare class SnapshotTransformError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+/**
+ * Compile and execute `transform.source` in `node:vm`.
+ *
+ * Source contract: the script is wrapped in `(function(records, params){ ... })(records, params)` so
+ * authors can write either a `return ...` body or a top-level expression. The returned value is
+ * the snapshot payload.
+ */
+export declare function runSnapshotTransform(transform: SnapshotTransform, inputs: {
+    records: ReadonlyArray<unknown>;
+    params?: Record<string, unknown>;
+}): SnapshotTransformResult;
+/**
+ * Stable hash over a (selection, sourceIds) pair, used to dedupe / correlate snapshots
+ * built from the same source query. SHA-256 hex truncated to 32 chars (sufficient for collision
+ * resistance within a single matrix's history).
+ */
+export declare function buildSourceQueryHash(selection: Record<string, unknown> | undefined, sourceIds: ReadonlyArray<string> | undefined): string;
+/**
+ * Convenience: build a fully-formed {@link ExecutionMatrixSnapshotRecord} from transform output.
+ * Caller still needs to persist via `ExecutionMatrixRuntime.insertSnapshot`.
+ */
+export declare function buildSnapshotRecord(input: {
+    matrixCatalogId: string;
+    matrixRunId?: string;
+    /** Optional discriminator for {@link ExecutionMatrixRuntime.listSnapshots} / facet APIs. */
+    entityType?: string;
+    selection?: Record<string, unknown>;
+    sourceIds?: string[];
+    transformResult: SnapshotTransformResult;
+}): ExecutionMatrixSnapshotRecord;
+//# sourceMappingURL=snapshot-runner.d.ts.map

package/dist/execution-matrix/snapshot-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-runner.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/snapshot-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAC;AAIxB,yFAAyF;AACzF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,qBAAa,sBAAuB,SAAQ,KAAK;aACF,KAAK,CAAC,EAAE,OAAO;gBAAhD,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAI7D;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE;IAAE,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC5E,uBAAuB,CAkDzB;AAaD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC9C,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,GAC3C,MAAM,CAMR;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,EAAE,uBAAuB,CAAC;CAC1C,GAAG,6BAA6B,CAYhC"}