@senpi/trading-runtime 1.0.0

package/dist/scanners/engine/engine.js

@@ -0,0 +1,399 @@
+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;
+    providers;
+    now;
+    registry;
+    started = false;
+    inFlight = new Set();
+    constructor(deps, registry) {
+        this.deps = deps;
+        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);
+        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);
+        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,
+        }));
+    }
+    /** 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,
+        });
+        this.emitRunStart({
+            address,
+            scannerId,
+            timestamp: attemptTimestamp,
+        });
+        const earlyExit = this.buildEarlyExitResult(entry, attemptTimestamp);
+        if (earlyExit) {
+            this.emitRunResult(earlyExit);
+            return earlyExit;
+        }
+        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);
+        }
+    }
+    /**
+     * 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);
+        const timer = setInterval(() => {
+            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, this.deps.stores.sharedArtifactStore);
+        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,
+        });
+        return {
+            ...this.buildInitContext(entry, runtime),
+            runStartedAt,
+            inputs,
+        };
+    }
+    /**
+     * 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,
+            });
+        }
+    }
+}
+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,21 @@
+import type { SharedArtifactStore } from "../store/shared-artifact-store.js";
+import type { ScanInputs } from "../protocol/context.js";
+import type { ScannerDefinition } from "../scanner-definition.js";
+import type { ScannerDataProviders } from "./data-providers.js";
+/** Input resolver contract used by engine run-loop context assembly. */
+export interface ResolveScanInputsOptions {
+    /** Strategy (wallet address) whose providers and shared artifacts should be queried. */
+    address: string;
+    /** Minimal scanner metadata needed to resolve declared inputs. */
+    definition: Pick<ScannerDefinition, "id" | "inputs">;
+    /** Provider-backed data sources available to the current runtime. */
+    providers: ScannerDataProviders;
+    /** Shared-artifact store used for artifact-backed input resolution. */
+    sharedArtifactStore: SharedArtifactStore;
+}
+/**
+ * Builds one scan-input payload from scanner provider needs and consumed artifact contracts.
+ * Shared market intelligence is loaded from artifact bindings; market data is loaded from providers.
+ */
+export declare function resolveScanInputs(options: ResolveScanInputsOptions): Promise<ScanInputs>;
+//# 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":"AAaA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,wEAAwE;AACxE,MAAM,WAAW,wBAAwB;IACvC,wFAAwF;IACxF,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAC;IACrD,qEAAqE;IACrE,SAAS,EAAE,oBAAoB,CAAC;IAChC,uEAAuE;IACvE,mBAAmB,EAAE,mBAAmB,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,UAAU,CAAC,CAwErB"}

package/dist/scanners/engine/input-resolver.js

@@ -0,0 +1,140 @@
+import { isConsumedArtifactBinding, isProviderInputDescriptor, } from "../input-descriptors.js";
+/**
+ * Builds one scan-input payload from scanner provider needs and consumed artifact contracts.
+ * Shared market intelligence is loaded from artifact bindings; market data is loaded from providers.
+ */
+export async function resolveScanInputs(options) {
+    const { address, definition, providers, sharedArtifactStore } = options;
+    const providerInputs = definition.inputs.filter(isProviderInputDescriptor);
+    const consumedArtifacts = definition.inputs.filter(isConsumedArtifactBinding);
+    const resolvedInputs = {
+        artifacts: {},
+    };
+    let instruments;
+    const candlesInput = findProviderInput(providerInputs, "candles");
+    const requiresInstruments = candlesInput !== undefined || hasProviderInput(providerInputs, "instruments");
+    if (requiresInstruments) {
+        if (!providers.getInstruments) {
+            throw new Error(`Scanner '${definition.id}' requires instruments provider for strategy '${address}'.`);
+        }
+        instruments = await providers.getInstruments(address);
+    }
+    if (hasProviderInput(providerInputs, "instruments")) {
+        resolvedInputs.instruments = instruments ?? [];
+    }
+    await loadConsumedArtifacts(consumedArtifacts, resolvedInputs, address, providers, sharedArtifactStore, definition.id);
+    if (candlesInput) {
+        if (!providers.getCandles) {
+            throw new Error(`Scanner '${definition.id}' requires candles provider for strategy '${address}'.`);
+        }
+        resolvedInputs.candles = await providers.getCandles(address, instruments ?? [], {
+            scannerId: definition.id,
+            preferredAssets: resolvePreferredAssets(resolvedInputs.artifacts, candlesInput),
+        });
+    }
+    if (hasProviderInput(providerInputs, "smData")) {
+        if (!providers.getSmData) {
+            throw new Error(`Scanner '${definition.id}' requires smData provider for strategy '${address}'.`);
+        }
+        resolvedInputs.smData = await providers.getSmData(address);
+    }
+    if (hasProviderInput(providerInputs, "activePositions")) {
+        if (!providers.getActivePositions) {
+            throw new Error(`Scanner '${definition.id}' requires activePositions provider for strategy '${address}'.`);
+        }
+        resolvedInputs.activePositions = await providers.getActivePositions(address);
+    }
+    return resolvedInputs;
+}
+/** Returns true when one provider-backed input kind appears anywhere in the descriptor list. */
+function hasProviderInput(inputs, kind) {
+    return inputs.some((input) => input.kind === kind);
+}
+/** Returns the first provider-backed input descriptor of the requested kind, if present. */
+function findProviderInput(inputs, kind) {
+    return inputs.find((input) => input.kind === kind);
+}
+/**
+ * Loads all consumed shared-artifact bindings into the in-progress scan input payload.
+ * Missing optional bindings are skipped; missing required bindings fail earlier through
+ * `resolveConsumedArtifact()`.
+ */
+async function loadConsumedArtifacts(bindings, inputs, address, providers, sharedArtifactStore, scannerId) {
+    for (const binding of bindings) {
+        const value = await resolveConsumedArtifact(binding, address, providers, sharedArtifactStore, scannerId);
+        if (value !== undefined) {
+            assignArtifactInput(inputs, binding.contract.key, value);
+        }
+    }
+}
+/**
+ * Resolves one consumed shared-artifact binding, preferring provider-backed sources
+ * when the binding declares one before falling back to persisted shared artifacts.
+ */
+async function resolveConsumedArtifact(binding, address, providers, sharedArtifactStore, scannerId) {
+    const providerValue = await loadArtifactFromProvider(binding, address, providers);
+    if (providerValue !== undefined) {
+        return providerValue;
+    }
+    const storedValue = (await sharedArtifactStore.load(address, binding.contract, {
+        maxAgeMs: binding.maxAgeMs,
+    })) ?? undefined;
+    if (storedValue !== undefined) {
+        return storedValue;
+    }
+    if (binding.required) {
+        throw new Error(`Scanner '${scannerId}' requires shared market intelligence '${binding.contract.key}' for strategy '${address}'.`);
+    }
+    return undefined;
+}
+/** Loads a shared-artifact value from an optional provider-backed equivalent, when configured. */
+async function loadArtifactFromProvider(binding, address, providers) {
+    switch (binding.providerSource) {
+        case "oiHistory":
+            return providers.getOiHistory
+                ? (await providers.getOiHistory(address))
+                : undefined;
+        default:
+            return undefined;
+    }
+}
+/** Writes one resolved shared-artifact value into the mutable scan-input draft. */
+function assignArtifactInput(inputs, key, value) {
+    inputs.artifacts[key] = value;
+}
+/** Extracts candidate asset names from the prescreener artifact for candle fanout hints. */
+function readPreferredAssets(artifact) {
+    if (!artifact) {
+        return undefined;
+    }
+    const assets = artifact.candidates
+        .map((candidate) => {
+        return typeof candidate.name === "string" ? candidate.name : null;
+    })
+        .filter((asset) => asset !== null);
+    return assets.length > 0 ? assets : undefined;
+}
+/**
+ * Resolves candle preferred-asset hints from previously loaded shared artifacts
+ * or from a hardcoded `fixedAssets` list on the descriptor.
+ * This lets candle providers narrow their asset fanout when an upstream scanner,
+ * such as the prescreener, already selected a smaller candidate set.
+ */
+function resolvePreferredAssets(artifacts, descriptor) {
+    if (descriptor.fixedAssets && descriptor.fixedAssets.length > 0) {
+        return descriptor.fixedAssets;
+    }
+    if (!descriptor.preferredAssetsFrom) {
+        return undefined;
+    }
+    const preferredAssetsKey = typeof descriptor.preferredAssetsFrom === "string"
+        ? descriptor.preferredAssetsFrom
+        : descriptor.preferredAssetsFrom.key;
+    switch (preferredAssetsKey) {
+        case "prescreened":
+            return readPreferredAssets(artifacts.prescreened);
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=input-resolver.js.map

package/dist/scanners/engine/input-resolver.js.map

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

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

@@ -0,0 +1,21 @@
+import type { ScanResult, ScannerId } from "../types.js";
+/** Payload emitted immediately before one scanner execution attempt starts. */
+export interface ScannerRunStart {
+    address: string;
+    scannerId: ScannerId;
+    timestamp: number;
+}
+/** Optional lifecycle callbacks emitted by the engine around each run attempt. */
+export interface ScannerEngineLifecycle {
+    /**
+     * Fires once per execution attempt before any early-exit or scanner work begins.
+     * This callback should be treated as observational and must not throw.
+     */
+    onRunStart?: (event: ScannerRunStart) => void;
+    /**
+     * Fires exactly once per execution attempt with the terminal run result.
+     * This callback receives successful, skipped, disabled, halted, and error results.
+     */
+    onRunResult?: (result: ScanResult) => void;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/scanners/engine/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzD,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kFAAkF;AAClF,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAE9C;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;CAC5C"}

package/dist/scanners/engine/lifecycle.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lifecycle.js.map