@senpi/runtime 1.0.95-dev.20260408174401

package/dist/scanners/engine/engine.js

@@ -0,0 +1,478 @@
+import { SkipScan } from "../protocol/hooks.js";
+import { ScanStatus as ScanStatusEnum } from "../types.js";
+import { assertValidConfig, assertValidState } from "./config-validator.js";
+import { createSharedArtifactAccessor, } from "./data-providers.js";
+import { resolveScanInputs } from "./input-resolver.js";
+import { buildResult, buildRunResult, formatError, shouldPersist, } from "./result-builder.js";
+import { StrategyRegistry, } from "./strategy-registry.js";
+/** Runtime engine for scanner registration, scheduling, and one-off execution. */
+export class ScannerEngine {
+    deps;
+    composition;
+    providers;
+    now;
+    registry;
+    started = false;
+    inFlight = new Set();
+    constructor(deps, composition, registry) {
+        this.deps = deps;
+        this.composition = composition;
+        this.providers = deps.providers ?? {};
+        this.now = deps.now ?? Date.now;
+        this.registry = registry ?? new StrategyRegistry();
+    }
+    /** Registers one scanner for one strategy runtime. */
+    register(strategy, scanner) {
+        this.registry.registerStrategy(strategy);
+        const entry = this.registry.registerScanner(strategy.id, scanner);
+        assertValidConfig(scanner.definition, entry.initialConfig, strategy.id, scanner.definition.id);
+        if (this.started && entry.enabled) {
+            this.schedule(entry);
+        }
+    }
+    /** Enables scanner execution for one strategy + scanner key. */
+    enable(address, scannerId) {
+        this.registry.setEnabled(address, scannerId, true);
+        if (!this.started) {
+            return;
+        }
+        const entry = this.registry.get(address, scannerId);
+        if (entry) {
+            this.schedule(entry);
+        }
+    }
+    /** Disables scanner execution and clears active timer if present. */
+    disable(address, scannerId) {
+        this.registry.setEnabled(address, scannerId, false);
+        this.registry.setNextRunAt(address, scannerId, null);
+        const entry = this.registry.get(address, scannerId);
+        if (!entry?.timer) {
+            return;
+        }
+        clearInterval(entry.timer);
+        this.registry.setTimer(address, scannerId, null);
+    }
+    /** Starts interval scheduling for all enabled scanner registrations. */
+    async start() {
+        if (this.started) {
+            this.deps.logger?.info?.("Scanner engine start() skipped (already started)");
+            return;
+        }
+        this.deps.logger?.info?.("Scanner engine start() entered");
+        this.started = true;
+        const entries = this.registry.list();
+        const toSchedule = entries.filter((e) => e.enabled);
+        const summary = {
+            total: entries.length,
+            enabled: toSchedule.length,
+            scanners: toSchedule.map((e) => ({
+                address: e.address,
+                scannerId: e.scanner.definition.id,
+                intervalSeconds: e.intervalSeconds,
+            })),
+        };
+        this.deps.logger?.info?.("Scanner engine start: scheduling scanners", summary);
+        await this.bootstrapContextDependencies();
+        for (const entry of toSchedule) {
+            this.schedule(entry);
+        }
+        this.deps.logger?.info?.("Scanner engine start() complete");
+    }
+    /** Stops all interval schedules and awaits in-flight runs before resolving. */
+    async stop() {
+        this.started = false;
+        this.registry.clearAllTimers();
+        const pending = Array.from(this.inFlight);
+        if (pending.length > 0) {
+            await Promise.allSettled(pending);
+        }
+    }
+    /** Lists registered scanners, optionally constrained to one strategy address. */
+    list(address) {
+        return this.registry.list(address).map((entry) => ({
+            address: entry.address,
+            scannerId: entry.scanner.definition.id,
+            enabled: entry.enabled,
+            intervalSeconds: entry.intervalSeconds,
+        }));
+    }
+    /** Lists detailed registration state used by health/state inspection surfaces. */
+    describeRegistrations(address) {
+        return this.registry.list(address).map((entry) => ({
+            address: entry.address,
+            scannerId: entry.scanner.definition.id,
+            enabled: entry.enabled,
+            intervalSeconds: entry.intervalSeconds,
+            initialized: entry.initialized,
+            inFlight: entry.lastScanTime !== null,
+            nextRunAt: entry.nextRunAt,
+        }));
+    }
+    /** Reads scanner runtime config, bootstrapping runtime state when missing. */
+    async getConfig(address, scannerId) {
+        const entry = this.requireRegistration(address, scannerId);
+        const runtime = await this.deps.stores.runtimeStore.ensure(address, scannerId, {
+            config: entry.initialConfig,
+            state: this.defaultStateFor(entry),
+        });
+        assertValidConfig(entry.scanner.definition, runtime.config, address, scannerId);
+        return runtime.config;
+    }
+    /** Writes scanner runtime config after schema validation. */
+    async setConfig(address, scannerId, config) {
+        const entry = this.requireRegistration(address, scannerId);
+        assertValidConfig(entry.scanner.definition, config, address, scannerId);
+        entry.initialConfig = config;
+        const existing = await this.deps.stores.runtimeStore.read(address, scannerId);
+        if (existing) {
+            await this.deps.stores.runtimeStore.setConfig(address, scannerId, config);
+            return;
+        }
+        await this.deps.stores.runtimeStore.ensure(address, scannerId, {
+            config,
+            state: this.defaultStateFor(entry),
+        });
+    }
+    /**
+     * Executes one scanner run for one (address, scannerId) key.
+     * Flow: overlap-guard -> runtime/config -> beforeScan -> scan -> normalize -> persist.
+     */
+    async runOnce(address, scannerId) {
+        const entry = this.requireRegistration(address, scannerId);
+        const attemptTimestamp = this.now();
+        this.deps.logger?.info?.("Scan initiated", {
+            address,
+            scannerId,
+            timestamp: attemptTimestamp,
+        });
+        const earlyExit = this.buildEarlyExitResult(entry, attemptTimestamp);
+        if (earlyExit) {
+            this.emitRunResult(earlyExit);
+            return earlyExit;
+        }
+        this.emitRunStart({
+            address,
+            scannerId,
+            timestamp: attemptTimestamp,
+        });
+        this.registry.setLastScanTime(address, scannerId, attemptTimestamp);
+        try {
+            const runtime = await this.ensureInitializedRuntime(entry);
+            const context = await this.buildPreparedContext(entry, runtime, attemptTimestamp);
+            const output = await entry.scanner.scan(context);
+            const result = buildRunResult(entry, context, output, this.now, this.deps.logger);
+            await this.persistIfNeeded(entry, result);
+            this.emitRunResult(result);
+            return result;
+        }
+        catch (error) {
+            const result = this.buildFailureResult(entry, error);
+            if (!(error instanceof SkipScan)) {
+                this.deps.logger?.error?.("Scanner run failed.", {
+                    address,
+                    scannerId,
+                    error,
+                });
+            }
+            await this.persistIfNeeded(entry, result);
+            this.emitRunResult(result);
+            return result;
+        }
+        finally {
+            this.registry.setLastScanTime(address, scannerId, null);
+        }
+    }
+    /** Executes one scanner plus its dependency chain immediately in topological order. */
+    async runChain(address, scannerId) {
+        const chain = this.composition.getRunChain(scannerId);
+        const results = [];
+        for (const dependencyId of chain) {
+            results.push(await this.runOnce(address, dependencyId));
+        }
+        return results;
+    }
+    /** Reads one scanner's retained context payload, or null when it is unavailable. */
+    async getScannerContext(address, scannerId) {
+        const contract = this.composition.producedContextByScanner.get(scannerId);
+        if (!contract) {
+            return null;
+        }
+        return this.deps.stores.sharedArtifactStore.loadByScanner(address, scannerId, {
+            contract,
+        });
+    }
+    /**
+     * Builds a terminal result for pre-run guard failures such as disabled scanners
+     * or an overlapping in-flight execution for the same strategy/scanner pair.
+     */
+    buildEarlyExitResult(entry, timestamp) {
+        if (!entry.enabled) {
+            return buildResult({
+                address: entry.address,
+                scannerId: entry.scanner.definition.id,
+                timestamp,
+                status: ScanStatusEnum.DISABLED,
+                reason: "Scanner is disabled.",
+                summary: {},
+            });
+        }
+        if (entry.lastScanTime !== null) {
+            return buildResult({
+                address: entry.address,
+                scannerId: entry.scanner.definition.id,
+                timestamp,
+                status: ScanStatusEnum.HALTED,
+                reason: "Scanner run already in progress.",
+                summary: {
+                    inFlightSince: entry.lastScanTime,
+                },
+            });
+        }
+        return null;
+    }
+    /**
+     * Ensures persisted runtime state exists, validates config/state, and runs the
+     * scanner's one-time initialization lifecycle before the first scan.
+     */
+    async ensureInitializedRuntime(entry) {
+        const address = entry.address;
+        const scannerId = entry.scanner.definition.id;
+        let runtime = await this.deps.stores.runtimeStore.ensure(address, scannerId, {
+            config: entry.initialConfig,
+            state: this.defaultStateFor(entry),
+        });
+        assertValidConfig(entry.scanner.definition, runtime.config, address, scannerId);
+        runtime = await this.ensureValidState(entry, runtime);
+        if (!entry.initialized) {
+            await entry.scanner.initialize(this.buildInitContext(entry, runtime));
+            this.registry.setInitialized(address, scannerId, true);
+            runtime =
+                (await this.deps.stores.runtimeStore.read(address, scannerId)) ?? runtime;
+            runtime = await this.ensureValidState(entry, runtime);
+        }
+        return runtime;
+    }
+    /**
+     * Builds the scan context for one run and applies the optional `beforeScan`
+     * hook, allowing scanners to gate or augment the prepared context.
+     */
+    async buildPreparedContext(entry, runtime, runStartedAt) {
+        let context = await this.buildScanContext(entry, runtime, runStartedAt);
+        if (entry.scanner.hooks?.beforeScan) {
+            context = await entry.scanner.hooks.beforeScan(context);
+        }
+        return context;
+    }
+    buildFailureResult(entry, error) {
+        if (error instanceof SkipScan) {
+            return buildResult({
+                address: entry.address,
+                scannerId: entry.scanner.definition.id,
+                timestamp: this.now(),
+                status: error.status,
+                reason: error.message,
+                summary: {},
+            });
+        }
+        return buildResult({
+            address: entry.address,
+            scannerId: entry.scanner.definition.id,
+            timestamp: this.now(),
+            status: ScanStatusEnum.ERROR,
+            reason: formatError(error),
+            summary: {
+                errorName: error instanceof Error ? error.name : "UnknownError",
+            },
+        });
+    }
+    schedule(entry) {
+        const scannerId = entry.scanner.definition.id;
+        if (entry.timer || !entry.enabled) {
+            return;
+        }
+        const intervalMs = Math.max(entry.intervalSeconds, 1) * 1000;
+        const scheduleMeta = {
+            address: entry.address,
+            scannerId,
+            intervalSeconds: entry.intervalSeconds,
+            intervalMs,
+        };
+        this.deps.logger?.info?.("Scanner scheduled", scheduleMeta);
+        this.registry.setNextRunAt(entry.address, scannerId, this.now() + intervalMs);
+        const timer = setInterval(() => {
+            this.registry.setNextRunAt(entry.address, scannerId, this.now() + intervalMs);
+            this.deps.logger?.info?.("Scheduled timer fired, invoking runOnce", {
+                address: entry.address,
+                scannerId,
+            });
+            const p = this.runOnce(entry.address, scannerId);
+            this.inFlight.add(p);
+            void p
+                .catch((error) => {
+                this.deps.logger?.error?.("Scheduled scanner run failed.", {
+                    address: entry.address,
+                    scannerId,
+                    error,
+                });
+            })
+                .finally(() => {
+                this.inFlight.delete(p);
+            });
+        }, intervalMs);
+        this.registry.setTimer(entry.address, scannerId, timer);
+    }
+    buildInitContext(entry, runtime) {
+        const sharedArtifacts = createSharedArtifactAccessor(entry.address, entry.scanner.definition.id, entry.scanner.definition.artifacts?.produces?.[0], this.deps.stores.sharedArtifactStore, (artifactKey) => this.resolveSourceScannerId(artifactKey));
+        const context = {
+            ...sharedArtifacts,
+            address: entry.address,
+            scannerId: entry.scanner.definition.id,
+            definition: entry.scanner.definition,
+            runtime,
+            config: runtime.config,
+            state: runtime.state,
+            now: this.now,
+            logger: this.deps.logger,
+            setState: async (nextState) => {
+                assertValidState(entry.scanner.definition, nextState, entry.address, entry.scanner.definition.id);
+                const next = await this.deps.stores.runtimeStore.setState(entry.address, entry.scanner.definition.id, nextState);
+                context.runtime = next;
+                context.state = next.state;
+            },
+        };
+        return context;
+    }
+    async buildScanContext(entry, runtime, runStartedAt) {
+        const inputs = await resolveScanInputs({
+            address: entry.address,
+            definition: entry.scanner.definition,
+            providers: this.providers,
+            sharedArtifactStore: this.deps.stores.sharedArtifactStore,
+            availableScanners: this.buildAvailableScannerDefinitions(entry.address),
+            now: this.now,
+        });
+        return {
+            ...this.buildInitContext(entry, runtime),
+            runStartedAt,
+            inputs: inputs.inputs,
+            dependencies: inputs.dependencies,
+        };
+    }
+    /**
+     * Persists a terminal run result only when the scanner's persistence policy
+     * says the result should be written to disk.
+     */
+    async persistIfNeeded(entry, result) {
+        if (!shouldPersist(entry.scanner.definition.persistence, result)) {
+            return;
+        }
+        await this.deps.stores.signalStore.write(result, entry.scanner.definition);
+    }
+    /**
+     * Returns the registered strategy/scanner runtime entry or throws when the
+     * requested pair is unknown to the engine.
+     */
+    requireRegistration(address, scannerId) {
+        const entry = this.registry.get(address, scannerId);
+        if (!entry) {
+            throw new Error(`Scanner '${scannerId}' is not registered for strategy '${address}'.`);
+        }
+        return entry;
+    }
+    defaultStateFor(entry) {
+        const definition = entry.scanner.definition;
+        if (definition.defaultState === undefined) {
+            if (definition.stateSchema) {
+                throw new Error(`Scanner '${definition.id}' declares stateSchema but is missing defaultState.`);
+            }
+            return {};
+        }
+        assertValidState(definition, definition.defaultState, entry.address, definition.id, "default state");
+        return cloneRuntimeValue(definition.defaultState);
+    }
+    async ensureValidState(entry, runtime) {
+        try {
+            assertValidState(entry.scanner.definition, runtime.state, entry.address, entry.scanner.definition.id);
+            return runtime;
+        }
+        catch (error) {
+            const nextState = this.defaultStateFor(entry);
+            this.deps.logger?.warn?.("Scanner state failed validation; resetting to default state.", {
+                address: entry.address,
+                scannerId: entry.scanner.definition.id,
+                error,
+            });
+            return this.deps.stores.runtimeStore.setState(entry.address, entry.scanner.definition.id, nextState);
+        }
+    }
+    emitRunStart(event) {
+        try {
+            this.deps.lifecycle?.onRunStart?.(event);
+        }
+        catch (error) {
+            this.deps.logger?.warn?.("Scanner run-start lifecycle callback failed.", {
+                address: event.address,
+                scannerId: event.scannerId,
+                error,
+            });
+        }
+    }
+    emitRunResult(result) {
+        try {
+            this.deps.lifecycle?.onRunResult?.(result);
+        }
+        catch (error) {
+            this.deps.logger?.warn?.("Scanner run-result lifecycle callback failed.", {
+                address: result.address,
+                scannerId: result.scannerId,
+                error,
+            });
+        }
+    }
+    async bootstrapContextDependencies() {
+        const sourceIds = this.composition.topologicalOrder.filter((scannerId) => {
+            const node = this.composition.scanners.get(scannerId);
+            return Boolean(node &&
+                this.composition.dependencySources.has(scannerId) &&
+                node.outputs.context &&
+                !node.outputs.signals);
+        });
+        for (const scannerId of sourceIds) {
+            for (const entry of this.registry.list().filter((candidate) => {
+                return candidate.scanner.definition.id === scannerId && candidate.enabled;
+            })) {
+                const producedContract = entry.scanner.definition.artifacts?.produces?.[0];
+                if (!producedContract) {
+                    continue;
+                }
+                const existing = await this.deps.stores.sharedArtifactStore.loadEnvelopeByScanner(entry.address, scannerId, { contract: producedContract });
+                if (existing) {
+                    continue;
+                }
+                await this.runOnce(entry.address, scannerId);
+            }
+        }
+    }
+    buildAvailableScannerDefinitions(address) {
+        const definitions = new Map();
+        for (const entry of this.registry.list(address)) {
+            definitions.set(entry.scanner.definition.id, entry.scanner.definition);
+        }
+        return definitions;
+    }
+    resolveSourceScannerId(artifactKey) {
+        for (const [scannerId, contract] of this.composition.producedContextByScanner) {
+            if (contract.key === artifactKey) {
+                return scannerId;
+            }
+        }
+        return undefined;
+    }
+}
+function cloneRuntimeValue(value) {
+    if (value === null || typeof value !== "object") {
+        return value;
+    }
+    return structuredClone(value);
+}
+//# sourceMappingURL=engine.js.map

package/dist/scanners/engine/engine.js.map

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

package/dist/scanners/engine/index.d.ts

@@ -0,0 +1,9 @@
+export { ScannerEngine, type ScannerRegistrationSummary } from "./engine.js";
+export type { ScannerDataProviders, ScannerEngineStores, ScannerEngineDependencies, ActivePosition, CandleProviderOptions, } from "./data-providers.js";
+export type { ScannerEngineLifecycle, ScannerRunStart } from "./lifecycle.js";
+export { createSharedArtifactAccessor } from "./data-providers.js";
+export { resolveScanInputs, type ResolveScanInputsOptions } from "./input-resolver.js";
+export { StrategyRegistry, type StrategyScannerRegistration, } from "./strategy-registry.js";
+export { assertValidConfig } from "./config-validator.js";
+export { buildRunResult, buildResult, shouldPersist, formatError, coerceTimestamp, coerceCount, isRecord, } from "./result-builder.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/scanners/engine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/scanners/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAC7E,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,cAAc,EACd,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EACL,gBAAgB,EAChB,KAAK,2BAA2B,GACjC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACX,eAAe,EACf,WAAW,EACX,QAAQ,GACT,MAAM,qBAAqB,CAAC"}

package/dist/scanners/engine/index.js

@@ -0,0 +1,7 @@
+export { ScannerEngine } from "./engine.js";
+export { createSharedArtifactAccessor } from "./data-providers.js";
+export { resolveScanInputs } from "./input-resolver.js";
+export { StrategyRegistry, } from "./strategy-registry.js";
+export { assertValidConfig } from "./config-validator.js";
+export { buildRunResult, buildResult, shouldPersist, formatError, coerceTimestamp, coerceCount, isRecord, } from "./result-builder.js";
+//# sourceMappingURL=index.js.map

package/dist/scanners/engine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/scanners/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAmC,MAAM,aAAa,CAAC;AAS7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAiC,MAAM,qBAAqB,CAAC;AACvF,OAAO,EACL,gBAAgB,GAEjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACX,eAAe,EACf,WAAW,EACX,QAAQ,GACT,MAAM,qBAAqB,CAAC"}

package/dist/scanners/engine/input-resolver.d.ts

@@ -0,0 +1,33 @@
+import type { ResolvedScannerDependency, ScanInputs } from "../protocol/context.js";
+import type { ScannerDefinition } from "../scanner-definition.js";
+import type { SharedArtifactStore } from "../store/shared-artifact-store.js";
+import type { ScannerId } from "../types.js";
+import type { ScannerDataProviders } from "./data-providers.js";
+type ScannerDefinitionSummary = Pick<ScannerDefinition, "id" | "inputs" | "dependsOn" | "artifacts">;
+/** Input resolver contract used by engine run-loop context assembly. */
+export interface ResolveScanInputsOptions {
+    /** Strategy (wallet address) whose providers and retained scanner context should be queried. */
+    address: string;
+    /** Minimal scanner metadata needed to resolve declared inputs. */
+    definition: ScannerDefinitionSummary;
+    /** Provider-backed data sources available to the current runtime. */
+    providers: ScannerDataProviders;
+    /** Context store used for retained scanner context resolution. */
+    sharedArtifactStore: SharedArtifactStore;
+    /** Configured scanner definitions available for dependency/source lookup. */
+    availableScanners: ReadonlyMap<ScannerId, Pick<ScannerDefinition, "id" | "artifacts">>;
+    /** Injectable clock for freshness evaluation. */
+    now?: () => number;
+}
+export interface ResolvedScanContextInputs {
+    inputs: ScanInputs;
+    dependencies: ResolvedScannerDependency[];
+}
+/**
+ * Builds one scan-input payload from provider needs plus scanner context dependencies.
+ * Shared market intelligence is loaded from retained scanner context; market data is
+ * loaded from providers.
+ */
+export declare function resolveScanInputs(options: ResolveScanInputsOptions): Promise<ResolvedScanContextInputs>;
+export {};
+//# sourceMappingURL=input-resolver.d.ts.map

package/dist/scanners/engine/input-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-resolver.d.ts","sourceRoot":"","sources":["../../../src/scanners/engine/input-resolver.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,yBAAyB,EACzB,UAAU,EACX,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,KAAK,wBAAwB,GAAG,IAAI,CAClC,iBAAiB,EACjB,IAAI,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAC5C,CAAC;AAEF,wEAAwE;AACxE,MAAM,WAAW,wBAAwB;IACvC,gGAAgG;IAChG,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,UAAU,EAAE,wBAAwB,CAAC;IACrC,qEAAqE;IACrE,SAAS,EAAE,oBAAoB,CAAC;IAChC,kEAAkE;IAClE,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,6EAA6E;IAC7E,iBAAiB,EAAE,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC;IACvF,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,yBAAyB,EAAE,CAAC;CAC3C;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,yBAAyB,CAAC,CAgGpC"}