@senpi/runtime 1.0.95-dev.20260408174401

package/dist/scanners/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/scanners/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE3E,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,oBAAoB,EAAE,CAAC;CACpC;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AAC7D,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvD,+CAA+C;AAC/C,oBAAY,YAAY;IACtB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED,8DAA8D;AAC9D,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,mBAAmB,CAAC;IACjC,YAAY,EAAE,iBAAiB,CAAC;IAChC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,eAAe,EAAE,oBAAoB,CAAC;CACvC;AAED,MAAM,MAAM,mBAAmB,CAAC,GAAG,SAAS,iBAAiB,IAC3D,GAAG,SAAS,MAAM,sBAAsB,GACpC,sBAAsB,CAAC,GAAG,CAAC,GAC3B,OAAO,CAAC;AAEd;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB,CACrC,GAAG,SAAS,iBAAiB,GAAG,iBAAiB;IAEjD,GAAG,EAAE,GAAG,CAAC;IACT,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,oBAAoB,CAAC,GAAG,SAAS,iBAAiB,EAChE,GAAG,EAAE,GAAG,EACR,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GACjD,sBAAsB,CAAC,GAAG,CAAC,CAE7B;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB,CACtC,GAAG,SAAS,iBAAiB,GAAG,iBAAiB;IAEjD,mDAAmD;IACnD,QAAQ,EAAE,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACtC,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACxC,sDAAsD;IACtD,OAAO,CAAC,EAAE,2BAA2B,CAAC;IACtC;;;OAGG;IACH,cAAc,CAAC,EAAE,sBAAsB,CAAC;CACzC;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,GAAG,SAAS,iBAAiB,EACjE,QAAQ,EAAE,sBAAsB,CAAC,GAAG,CAAC,EACrC,OAAO,GAAE,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,EAAE,UAAU,CAAM,GAC3D,uBAAuB,CAAC,GAAG,CAAC,CAK9B;AA8BD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;EAGpC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;IAGnC,CAAC;AAEF,eAAO,MAAM,sBAAsB,gHAA6C,CAAC;AAEjF,eAAO,MAAM,mBAAmB,uCAO/B,CAAC;AAEF,eAAO,MAAM,iBAAiB,sCAM7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,qCAO5B,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;EAQrC,CAAC;AAEH,eAAO,MAAM,oBAAoB,yCAOhC,CAAC"}

package/dist/scanners/artifacts.js

@@ -0,0 +1,72 @@
+import { Type } from "@sinclair/typebox";
+/** Macro market environment classification. */
+export var MarketRegime;
+(function (MarketRegime) {
+    MarketRegime["BULLISH"] = "BULLISH";
+    MarketRegime["BEARISH"] = "BEARISH";
+    MarketRegime["NEUTRAL"] = "NEUTRAL";
+})(MarketRegime || (MarketRegime = {}));
+export function defineSharedArtifact(key, options) {
+    return { key, ...options };
+}
+/** Creates one scanner-side binding for consumed shared market intelligence. */
+export function consumeSharedArtifact(contract, options = {}) {
+    return {
+        contract,
+        ...options,
+    };
+}
+const instrumentContextSchema = Type.Object({
+    markPx: Type.Number(),
+    prevDayPx: Type.Number(),
+    midPx: Type.Number(),
+    dayNtlVlm: Type.Number(),
+    openInterest: Type.Number(),
+    funding: Type.Number(),
+}, { additionalProperties: true });
+const prescreenedCandidateSchema = Type.Object({
+    name: Type.String(),
+    context: instrumentContextSchema,
+    maxLeverage: Type.Number(),
+    score: Type.Number(),
+    changePct: Type.Number(),
+    volume: Type.Number(),
+    openInterest: Type.Number(),
+});
+const oiSnapshotSchema = Type.Object({
+    oi: Type.Number(),
+    price: Type.Number(),
+    timestamp: Type.Number(),
+});
+export const prescreenedArtifactSchema = Type.Object({
+    timestamp: Type.Number(),
+    candidates: Type.Array(prescreenedCandidateSchema),
+});
+export const oiHistoryArtifactSchema = Type.Record(Type.String(), Type.Array(oiSnapshotSchema));
+export const btcCacheArtifactSchema = Type.Record(Type.String(), Type.Unknown());
+export const prescreenedArtifact = defineSharedArtifact("prescreened", {
+    description: "Ranked liquid instruments published by the prescreener for downstream scanners.",
+    schema: prescreenedArtifactSchema,
+});
+export const oiHistoryArtifact = defineSharedArtifact("oi-history", {
+    description: "Rolling open-interest history keyed by asset name.",
+    schema: oiHistoryArtifactSchema,
+});
+export const btcCacheArtifact = defineSharedArtifact("btc-cache", {
+    description: "Shared BTC market context cache for scanners that need a global BTC reference.",
+    schema: btcCacheArtifactSchema,
+});
+export const marketRegimeArtifactSchema = Type.Object({
+    regime: Type.Enum(MarketRegime),
+    confidence: Type.Number(),
+    btcBias: Type.Enum(MarketRegime),
+    ethBias: Type.Enum(MarketRegime),
+    btcWeight: Type.Number(),
+    ethWeight: Type.Number(),
+    timestamp: Type.Number(),
+});
+export const marketRegimeArtifact = defineSharedArtifact("market-regime", {
+    description: "Macro market regime classification (BULLISH/BEARISH/NEUTRAL) from BTC+ETH analysis.",
+    schema: marketRegimeArtifactSchema,
+});
+//# sourceMappingURL=artifacts.js.map

package/dist/scanners/artifacts.js.map

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

package/dist/scanners/context-source-mapping.d.ts

@@ -0,0 +1,4 @@
+import type { ScannerId } from "./types.js";
+/** Returns the built-in source scanner id for one retained-context key when known. */
+export declare function inferBuiltInSourceScannerId(contextKey: string): ScannerId | undefined;
+//# sourceMappingURL=context-source-mapping.d.ts.map

package/dist/scanners/context-source-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-source-mapping.d.ts","sourceRoot":"","sources":["../../src/scanners/context-source-mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAQ5C,sFAAsF;AACtF,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,GACjB,SAAS,GAAG,SAAS,CAEvB"}

package/dist/scanners/context-source-mapping.js

@@ -0,0 +1,10 @@
+const BUILT_IN_CONTEXT_SOURCE_SCANNERS = {
+    prescreened: "prescreener",
+    "oi-history": "oi-tracker",
+    "market-regime": "market-regime",
+};
+/** Returns the built-in source scanner id for one retained-context key when known. */
+export function inferBuiltInSourceScannerId(contextKey) {
+    return BUILT_IN_CONTEXT_SOURCE_SCANNERS[contextKey];
+}
+//# sourceMappingURL=context-source-mapping.js.map

package/dist/scanners/context-source-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-source-mapping.js","sourceRoot":"","sources":["../../src/scanners/context-source-mapping.ts"],"names":[],"mappings":"AAEA,MAAM,gCAAgC,GAAwC;IAC5E,WAAW,EAAE,aAA0B;IACvC,YAAY,EAAE,YAAyB;IACvC,eAAe,EAAE,eAA4B;CAC9C,CAAC;AAEF,sFAAsF;AACtF,MAAM,UAAU,2BAA2B,CACzC,UAAkB;IAElB,OAAO,gCAAgC,CAAC,UAAU,CAAC,CAAC;AACtD,CAAC"}

package/dist/scanners/create-scanner.d.ts

@@ -0,0 +1,13 @@
+import type { ScanContext, ScannerInitContext } from "./protocol/context.js";
+import type { ScannerHooks } from "./protocol/hooks.js";
+import type { Scanner } from "./protocol/scanner.js";
+import type { ScannerDefinition } from "./scanner-definition.js";
+import type { ScannerScanOutput } from "./types.js";
+export interface CreateScannerOptions<Cfg = unknown, St = unknown> extends ScannerDefinition<Cfg, St> {
+    hooks?: ScannerHooks<Cfg, St>;
+    initialize?: (ctx: ScannerInitContext<Cfg, St>) => Promise<void>;
+    scan: (ctx: ScanContext<Cfg, St>) => Promise<ScannerScanOutput>;
+}
+/** Creates a scanner from declarative definition metadata and lifecycle handlers. */
+export declare function createScanner<Cfg = unknown, St = unknown>(options: CreateScannerOptions<Cfg, St>): Scanner<Cfg, St>;
+//# sourceMappingURL=create-scanner.d.ts.map

package/dist/scanners/create-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-scanner.d.ts","sourceRoot":"","sources":["../../src/scanners/create-scanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,oBAAoB,CAAC,GAAG,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,CAC/D,SAAQ,iBAAiB,CAAC,GAAG,EAAE,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,YAAY,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,IAAI,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACjE;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,GAAG,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,EACvD,OAAO,EAAE,oBAAoB,CAAC,GAAG,EAAE,EAAE,CAAC,GACrC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CASlB"}

package/dist/scanners/create-scanner.js

@@ -0,0 +1,11 @@
+/** Creates a scanner from declarative definition metadata and lifecycle handlers. */
+export function createScanner(options) {
+    const { hooks, initialize, scan, ...definition } = options;
+    return {
+        definition,
+        hooks,
+        initialize: initialize ?? (async () => undefined),
+        scan,
+    };
+}
+//# sourceMappingURL=create-scanner.js.map

package/dist/scanners/create-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-scanner.js","sourceRoot":"","sources":["../../src/scanners/create-scanner.ts"],"names":[],"mappings":"AAaA,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAC3B,OAAsC;IAEtC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;IAE3D,OAAO;QACL,UAAU;QACV,KAAK;QACL,UAAU,EAAE,UAAU,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC;QACjD,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/scanners/engine/config-validator.d.ts

@@ -0,0 +1,7 @@
+import type { ScannerDefinition } from "../scanner-definition.js";
+import type { ScannerId } from "../types.js";
+/** Validates scanner config against the definition's TypeBox schema. Throws on failure. */
+export declare function assertValidConfig(definition: ScannerDefinition, config: unknown, address: string, scannerId: ScannerId): void;
+/** Validates scanner-local runtime state when a state schema is declared. */
+export declare function assertValidState(definition: Pick<ScannerDefinition<unknown, unknown>, "stateSchema">, state: unknown, address: string, scannerId: ScannerId, subject?: string): void;
+//# sourceMappingURL=config-validator.d.ts.map

package/dist/scanners/engine/config-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.d.ts","sourceRoot":"","sources":["../../../src/scanners/engine/config-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAM7C,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,iBAAiB,EAC7B,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,GACnB,IAAI,CAQN;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,EACpE,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,OAAO,SAAU,GAChB,IAAI,CAQN"}

package/dist/scanners/engine/config-validator.js

@@ -0,0 +1,16 @@
+import { describeSchemaValidationError, isSchemaValueValid, } from "../schema-utils.js";
+/** Validates scanner config against the definition's TypeBox schema. Throws on failure. */
+export function assertValidConfig(definition, config, address, scannerId) {
+    if (isSchemaValueValid(definition.configSchema, config)) {
+        return;
+    }
+    throw new Error(`Invalid config for scanner '${scannerId}' in strategy '${address}': ${describeSchemaValidationError(definition.configSchema, config)}`);
+}
+/** Validates scanner-local runtime state when a state schema is declared. */
+export function assertValidState(definition, state, address, scannerId, subject = "state") {
+    if (!definition.stateSchema || isSchemaValueValid(definition.stateSchema, state)) {
+        return;
+    }
+    throw new Error(`Invalid ${subject} for scanner '${scannerId}' in strategy '${address}': ${describeSchemaValidationError(definition.stateSchema, state)}`);
+}
+//# sourceMappingURL=config-validator.js.map

package/dist/scanners/engine/config-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.js","sourceRoot":"","sources":["../../../src/scanners/engine/config-validator.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,6BAA6B,EAC7B,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB,CAC/B,UAA6B,EAC7B,MAAe,EACf,OAAe,EACf,SAAoB;IAEpB,IAAI,kBAAkB,CAAC,UAAU,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC;QACxD,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CACb,+BAA+B,SAAS,kBAAkB,OAAO,MAAM,6BAA6B,CAAC,UAAU,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,CACxI,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAC9B,UAAoE,EACpE,KAAc,EACd,OAAe,EACf,SAAoB,EACpB,OAAO,GAAG,OAAO;IAEjB,IAAI,CAAC,UAAU,CAAC,WAAW,IAAI,kBAAkB,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC;QACjF,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CACb,WAAW,OAAO,iBAAiB,SAAS,kBAAkB,OAAO,MAAM,6BAA6B,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAC1I,CAAC;AACJ,CAAC"}

package/dist/scanners/engine/data-providers.d.ts

@@ -0,0 +1,48 @@
+import type { SharedArtifactContract } from "../artifacts.js";
+import type { RuntimeStore } from "../store/runtime-store.js";
+import type { SharedArtifactStore } from "../store/shared-artifact-store.js";
+import type { SignalStore } from "../store/signal-store.js";
+import type { CandlesByAsset, ScannerLogger, SharedArtifactAccessor } from "../protocol/context.js";
+import type { Instrument, ScannerId, SmMarket } from "../types.js";
+import type { ClearingHouseState } from "../implementations/liquidation-watchdog.js";
+import type { DslState } from "../../types/dsl/index.js";
+import type { ScannerEngineLifecycle } from "./lifecycle.js";
+/** Minimal active-position shape consumed by scanner contexts. */
+export type ActivePosition = Record<string, unknown>;
+/** Optional metadata passed to candle providers to optimize request fanout. */
+export interface CandleProviderOptions {
+    /** Scanner id requesting candle data. */
+    scannerId?: ScannerId;
+    /** Preferred candidate assets pre-selected by upstream artifacts (for example prescreener). */
+    preferredAssets?: string[];
+}
+/**
+ * External data sources used by the engine for provider-backed inputs only.
+ * Shared market intelligence is resolved separately through shared artifact bindings.
+ */
+export interface ScannerDataProviders {
+    getInstruments?: (address: string) => Promise<Instrument[]>;
+    getCandles?: (address: string, instruments: Instrument[], options?: CandleProviderOptions) => Promise<CandlesByAsset>;
+    getOiHistory?: (address: string) => Promise<Record<string, import("../types.js").OiSnapshot[]>>;
+    getSmData?: (address: string) => Promise<SmMarket[]>;
+    getActivePositions?: (address: string) => Promise<ActivePosition[]>;
+    getClearingHouseState?: (address: string) => Promise<ClearingHouseState | null>;
+    getDslStatesForStrategy?: (address: string) => Promise<DslState[]>;
+}
+/** Stores required by the scanner engine runtime. */
+export interface ScannerEngineStores {
+    runtimeStore: RuntimeStore;
+    signalStore: SignalStore;
+    sharedArtifactStore: SharedArtifactStore;
+}
+/** Constructor options for scanner engine orchestration. */
+export interface ScannerEngineDependencies {
+    stores: ScannerEngineStores;
+    providers?: ScannerDataProviders;
+    logger?: ScannerLogger;
+    lifecycle?: ScannerEngineLifecycle;
+    now?: () => number;
+}
+/** Shared-artifact store accessors exposed through scanner init/run contexts. */
+export declare function createSharedArtifactAccessor(address: string, scannerId: ScannerId, producedContract: SharedArtifactContract | undefined, sharedArtifactStore: SharedArtifactStore, resolveSourceScannerId: (artifactKey: string) => ScannerId | undefined): SharedArtifactAccessor;
+//# sourceMappingURL=data-providers.d.ts.map

package/dist/scanners/engine/data-providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-providers.d.ts","sourceRoot":"","sources":["../../../src/scanners/engine/data-providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,QAAQ,EACT,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE7D,kEAAkE;AAClE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,+FAA+F;IAC/F,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC5D,UAAU,CAAC,EAAE,CACX,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,UAAU,EAAE,EACzB,OAAO,CAAC,EAAE,qBAAqB,KAC5B,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,aAAa,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;IAChG,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrD,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACpE,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAChF,uBAAuB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;CACpE;AAED,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,WAAW,CAAC;IACzB,mBAAmB,EAAE,mBAAmB,CAAC;CAC1C;AAED,4DAA4D;AAC5D,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,iFAAiF;AACjF,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,gBAAgB,EAAE,sBAAsB,GAAG,SAAS,EACpD,mBAAmB,EAAE,mBAAmB,EACxC,sBAAsB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS,GACrE,sBAAsB,CA8BxB"}

package/dist/scanners/engine/data-providers.js

@@ -0,0 +1,28 @@
+/** Shared-artifact store accessors exposed through scanner init/run contexts. */
+export function createSharedArtifactAccessor(address, scannerId, producedContract, sharedArtifactStore, resolveSourceScannerId) {
+    return {
+        loadSharedArtifact: (artifact, opts) => sharedArtifactStore.loadByScanner(address, resolveSharedArtifactScannerId(artifact, resolveSourceScannerId), {
+            contract: typeof artifact === "string" ? undefined : artifact,
+            maxAgeMs: opts?.maxAgeMs,
+        }),
+        saveSharedArtifact: (artifact, value) => {
+            const contract = typeof artifact === "string" ? producedContract : artifact;
+            const artifactKey = typeof artifact === "string" ? artifact : artifact.key;
+            if (producedContract && artifactKey !== producedContract.key) {
+                throw new Error(`Scanner '${scannerId}' can only save its declared retained context '${producedContract.key}', but tried to save '${artifactKey}'.`);
+            }
+            return sharedArtifactStore.saveByScanner(address, scannerId, value, {
+                contract,
+            });
+        },
+    };
+}
+function resolveSharedArtifactScannerId(artifact, resolveSourceScannerId) {
+    const key = typeof artifact === "string" ? artifact : artifact.key;
+    const scannerId = resolveSourceScannerId(key);
+    if (!scannerId) {
+        throw new Error(`No source scanner is registered for retained context '${key}'.`);
+    }
+    return scannerId;
+}
+//# sourceMappingURL=data-providers.js.map

package/dist/scanners/engine/data-providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-providers.js","sourceRoot":"","sources":["../../../src/scanners/engine/data-providers.ts"],"names":[],"mappings":"AAkEA,iFAAiF;AACjF,MAAM,UAAU,4BAA4B,CAC1C,OAAe,EACf,SAAoB,EACpB,gBAAoD,EACpD,mBAAwC,EACxC,sBAAsE;IAEtE,OAAO;QACL,kBAAkB,EAAE,CAClB,QAA2C,EAC3C,IAA4B,EACc,EAAE,CAC5C,mBAAmB,CAAC,aAAa,CAC/B,OAAO,EACP,8BAA8B,CAAC,QAAQ,EAAE,sBAAsB,CAAC,EAChE;YACE,QAAQ,EAAE,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;YAC7D,QAAQ,EAAE,IAAI,EAAE,QAAQ;SACzB,CAC0C;QAC/C,kBAAkB,EAAE,CAClB,QAA2C,EAC3C,KAA+B,EAChB,EAAE;YACjB,MAAM,QAAQ,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC5E,MAAM,WAAW,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAC3E,IAAI,gBAAgB,IAAI,WAAW,KAAK,gBAAgB,CAAC,GAAG,EAAE,CAAC;gBAC7D,MAAM,IAAI,KAAK,CACb,YAAY,SAAS,kDAAkD,gBAAgB,CAAC,GAAG,yBAAyB,WAAW,IAAI,CACpI,CAAC;YACJ,CAAC;YACD,OAAO,mBAAmB,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE;gBAClE,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,8BAA8B,CACrC,QAAyC,EACzC,sBAAsE;IAEtE,MAAM,GAAG,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;IACnE,MAAM,SAAS,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,yDAAyD,GAAG,IAAI,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,92 @@
+import type { Scanner } from "../protocol/scanner.js";
+import type { ScanResult, ScannerId, StrategyRegistration } from "../types.js";
+import { type ScannerEngineDependencies } from "./data-providers.js";
+import { StrategyRegistry } from "./strategy-registry.js";
+import type { ScannerComposition } from "../../runtime/scanner-composition.js";
+/** Public scanner registration shape exposed for list operations. */
+export interface ScannerRegistrationSummary {
+    address: string;
+    scannerId: ScannerId;
+    enabled: boolean;
+    intervalSeconds: number;
+}
+export interface ScannerRegistrationStateSummary extends ScannerRegistrationSummary {
+    initialized: boolean;
+    inFlight: boolean;
+    nextRunAt: number | null;
+}
+/** Runtime engine for scanner registration, scheduling, and one-off execution. */
+export declare class ScannerEngine {
+    private readonly deps;
+    private readonly composition;
+    private readonly providers;
+    private readonly now;
+    private readonly registry;
+    private started;
+    private readonly inFlight;
+    constructor(deps: ScannerEngineDependencies, composition: ScannerComposition, registry?: StrategyRegistry);
+    /** Registers one scanner for one strategy runtime. */
+    register<Cfg = unknown, St = unknown>(strategy: StrategyRegistration, scanner: Scanner<Cfg, St>): void;
+    /** Enables scanner execution for one strategy + scanner key. */
+    enable(address: string, scannerId: ScannerId): void;
+    /** Disables scanner execution and clears active timer if present. */
+    disable(address: string, scannerId: ScannerId): void;
+    /** Starts interval scheduling for all enabled scanner registrations. */
+    start(): Promise<void>;
+    /** Stops all interval schedules and awaits in-flight runs before resolving. */
+    stop(): Promise<void>;
+    /** Lists registered scanners, optionally constrained to one strategy address. */
+    list(address?: string): ScannerRegistrationSummary[];
+    /** Lists detailed registration state used by health/state inspection surfaces. */
+    describeRegistrations(address?: string): ScannerRegistrationStateSummary[];
+    /** Reads scanner runtime config, bootstrapping runtime state when missing. */
+    getConfig(address: string, scannerId: ScannerId): Promise<unknown>;
+    /** Writes scanner runtime config after schema validation. */
+    setConfig(address: string, scannerId: ScannerId, config: unknown): Promise<void>;
+    /**
+     * Executes one scanner run for one (address, scannerId) key.
+     * Flow: overlap-guard -> runtime/config -> beforeScan -> scan -> normalize -> persist.
+     */
+    runOnce(address: string, scannerId: ScannerId): Promise<ScanResult>;
+    /** Executes one scanner plus its dependency chain immediately in topological order. */
+    runChain(address: string, scannerId: ScannerId): Promise<ScanResult[]>;
+    /** Reads one scanner's retained context payload, or null when it is unavailable. */
+    getScannerContext(address: string, scannerId: ScannerId): Promise<unknown | 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.
+     */
+    private buildEarlyExitResult;
+    /**
+     * Ensures persisted runtime state exists, validates config/state, and runs the
+     * scanner's one-time initialization lifecycle before the first scan.
+     */
+    private ensureInitializedRuntime;
+    /**
+     * Builds the scan context for one run and applies the optional `beforeScan`
+     * hook, allowing scanners to gate or augment the prepared context.
+     */
+    private buildPreparedContext;
+    private buildFailureResult;
+    private schedule;
+    private buildInitContext;
+    private buildScanContext;
+    /**
+     * Persists a terminal run result only when the scanner's persistence policy
+     * says the result should be written to disk.
+     */
+    private persistIfNeeded;
+    /**
+     * Returns the registered strategy/scanner runtime entry or throws when the
+     * requested pair is unknown to the engine.
+     */
+    private requireRegistration;
+    private defaultStateFor;
+    private ensureValidState;
+    private emitRunStart;
+    private emitRunResult;
+    private bootstrapContextDependencies;
+    private buildAvailableScannerDefinitions;
+    private resolveSourceScannerId;
+}
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/scanners/engine/engine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EAET,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,EACL,gBAAgB,EAEjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAI/E,qEAAqE;AACrE,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,+BAAgC,SAAQ,0BAA0B;IACjF,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,kFAAkF;AAClF,qBAAa,aAAa;IAQtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAR9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;gBAGrC,IAAI,EAAE,yBAAyB,EAC/B,WAAW,EAAE,kBAAkB,EAChD,QAAQ,CAAC,EAAE,gBAAgB;IAO7B,sDAAsD;IACtD,QAAQ,CAAC,GAAG,GAAG,OAAO,EAAE,EAAE,GAAG,OAAO,EAClC,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,GACxB,IAAI;IASP,gEAAgE;IAChE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAYnD,qEAAqE;IACrE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAYpD,wEAAwE;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B5B,+EAA+E;IACzE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,iFAAiF;IACjF,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,0BAA0B,EAAE;IASpD,kFAAkF;IAClF,qBAAqB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,+BAA+B,EAAE;IAY1E,8EAA8E;IACxE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAUxE,6DAA6D;IACvD,SAAS,CACb,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;OAGG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAgDzE,uFAAuF;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAS5E,oFAAoF;IAC9E,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAU1B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA+B5B;;;OAGG;YACW,wBAAwB;IAgCtC;;;OAGG;YACW,oBAAoB;IAYlC,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,QAAQ;IAyChB,OAAO,CAAC,gBAAgB;YA0CV,gBAAgB;IAsB9B;;;OAGG;YACW,eAAe;IAW7B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,eAAe;YAqBT,gBAAgB;IA2B9B,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,aAAa;YAYP,4BAA4B;IAgC1C,OAAO,CAAC,gCAAgC;IAaxC,OAAO,CAAC,sBAAsB;CAQ/B"}