@senpi/runtime 1.0.95-dev.20260408174401

package/dist/scanners/providers/client.js.map

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

package/dist/scanners/providers/factory.d.ts

@@ -0,0 +1,43 @@
+import type { ScannerDataProviders } from "../engine/data-providers.js";
+import { type ProviderLogLevel, type ProviderLogger, type SenpiToolClient } from "./client.js";
+/** Provider-specific timeout knobs by MCP tool. */
+export interface SenpiProviderTimeouts {
+    marketListInstruments?: number;
+    marketGetAssetData?: number;
+    leaderboardGetMarkets?: number;
+}
+/** Provider cache TTL knobs (milliseconds). */
+export interface SenpiProviderCacheTtlMs {
+    instruments?: number;
+    smData?: number;
+    candles?: number;
+}
+/** Tool-name overrides used when MCP aliases differ by runtime. */
+export interface SenpiProviderToolNames {
+    marketListInstruments?: string;
+    marketGetAssetData?: string;
+    leaderboardGetMarkets?: string;
+    strategyGetClearinghouseState?: string;
+}
+/** Winston-compatible logger shape accepted by provider factory. */
+export interface WinstonLikeLogger {
+    debug: (message: string, meta?: Record<string, unknown>) => void;
+    info: (message: string, meta?: Record<string, unknown>) => void;
+    warn: (message: string, meta?: Record<string, unknown>) => void;
+    error: (message: string, meta?: Record<string, unknown>) => void;
+}
+/** Factory options for live Senpi-backed scanner providers. */
+export interface SenpiScannerProviderFactoryOptions {
+    client: SenpiToolClient;
+    logger?: ProviderLogger | WinstonLikeLogger;
+    logLevel?: ProviderLogLevel;
+    candleIntervals?: string[];
+    maxCandleAssets?: number;
+    cacheTtlMs?: SenpiProviderCacheTtlMs;
+    timeouts?: SenpiProviderTimeouts;
+    retries?: number;
+    toolNames?: SenpiProviderToolNames;
+}
+/** Creates a `ScannerDataProviders` bundle backed by Senpi MCP tools. */
+export declare function createSenpiScannerProviders(options: SenpiScannerProviderFactoryOptions): ScannerDataProviders;
+//# sourceMappingURL=factory.d.ts.map

package/dist/scanners/providers/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/scanners/providers/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,oBAAoB,EACrB,MAAM,6BAA6B,CAAC;AAYrC,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAGrB,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,+CAA+C;AAC/C,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,mEAAmE;AACnE,MAAM,WAAW,sBAAsB;IACrC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,6BAA6B,CAAC,EAAE,MAAM,CAAC;CACxC;AAED,oEAAoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAChE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAChE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAClE;AAED,+DAA+D;AAC/D,MAAM,WAAW,kCAAkC;IACjD,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,cAAc,GAAG,iBAAiB,CAAC;IAC5C,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC;AAED,yEAAyE;AACzE,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,kCAAkC,GAC1C,oBAAoB,CAmLtB"}

package/dist/scanners/providers/factory.js

@@ -0,0 +1,297 @@
+import { asNumber, asString, isRecord, unwrapEnvelope } from "../../utils/response.js";
+import { createClearingHouseStalenessGuard, extractMinClearingHouseTime } from "../../utils/clearing-house-staleness.js";
+import { normalizeAssetCandles, normalizeInstrumentsWithDiagnostics, normalizeSmMarketsWithDiagnostics, } from "./adapter.js";
+import { createConsoleProviderLogger, createProviderClient, createWinstonProviderLogger, } from "./client.js";
+import { ProviderCache } from "./cache.js";
+/** Creates a `ScannerDataProviders` bundle backed by Senpi MCP tools. */
+export function createSenpiScannerProviders(options) {
+    const cache = new ProviderCache();
+    const logger = toProviderLogger(options.logger) ?? createConsoleProviderLogger();
+    const client = createProviderClient(options.client, {
+        logger,
+        logLevel: options.logLevel ?? "info",
+        retries: options.retries ?? 2,
+        timeoutMs: 10_000,
+    });
+    const candleIntervals = options.candleIntervals ?? ["1h", "4h"];
+    const maxCandleAssets = options.maxCandleAssets ?? 10;
+    const cacheTtl = {
+        instruments: options.cacheTtlMs?.instruments ?? 30_000,
+        smData: options.cacheTtlMs?.smData ?? 120_000,
+        candles: options.cacheTtlMs?.candles ?? 30_000,
+    };
+    const timeouts = {
+        marketListInstruments: options.timeouts?.marketListInstruments ?? 10_000,
+        marketGetAssetData: options.timeouts?.marketGetAssetData ?? 10_000,
+        leaderboardGetMarkets: options.timeouts?.leaderboardGetMarkets ?? 8_000,
+    };
+    const toolNames = {
+        marketListInstruments: options.toolNames?.marketListInstruments ?? "market_list_instruments",
+        marketGetAssetData: options.toolNames?.marketGetAssetData ?? "market_get_asset_data",
+        leaderboardGetMarkets: options.toolNames?.leaderboardGetMarkets ?? "leaderboard_get_markets",
+        strategyGetClearinghouseState: options.toolNames?.strategyGetClearinghouseState ?? "strategy_get_clearinghouse_state",
+    };
+    const clearingHouseStaleness = createClearingHouseStalenessGuard();
+    async function fetchClearingHouseState(address) {
+        const raw = await client.callTool(toolNames.strategyGetClearinghouseState, { strategy_wallet: address }, { address, timeoutMs: 10_000 });
+        if (isRecord(raw) && raw.success === false) {
+            const detail = mcpErrorDetail(raw);
+            logger.warn("getClearingHouseState: MCP returned success:false, skipping tick", {
+                address,
+                error: detail,
+            });
+            return null;
+        }
+        const state = normalizeClearingHouseState(raw);
+        if (clearingHouseStaleness.isStale(address, state.time)) {
+            logger.warn("getClearingHouseState: discarding stale response", {
+                address,
+                responseTime: state.time,
+                lastClearingHouseTime: clearingHouseStaleness.getLastTime(address),
+                staleness: clearingHouseStaleness.getLastTime(address) - state.time,
+            });
+            return null;
+        }
+        return state;
+    }
+    return {
+        getInstruments: async (address) => cache.getOrLoad(cacheKey("instruments", address), cacheTtl.instruments, async () => {
+            const payload = await client.callTool(toolNames.marketListInstruments, {}, {
+                address,
+                timeoutMs: timeouts.marketListInstruments,
+            });
+            throwIfMcpErrorEnvelope(payload, logger, {
+                tool: toolNames.marketListInstruments,
+                address,
+            });
+            const normalized = normalizeInstrumentsWithDiagnostics(payload);
+            warnOnNormalizationIssues(logger, {
+                tool: toolNames.marketListInstruments,
+                address,
+                diagnostics: normalized.diagnostics,
+            });
+            return normalized.value;
+        }),
+        getCandles: async (address, instruments, requestOptions) => {
+            const assets = selectCandleAssets(instruments, requestOptions, maxCandleAssets);
+            if (assets.length === 0) {
+                return {};
+            }
+            const result = {};
+            await Promise.all(assets.map(async (asset) => {
+                const key = cacheKey("candles", address, asset, candleIntervals.join(","));
+                const candles = await cache.getOrLoad(key, cacheTtl.candles, async () => {
+                    const payload = await client.callTool(toolNames.marketGetAssetData, {
+                        asset,
+                        candle_intervals: candleIntervals,
+                        include_order_book: false,
+                        include_funding: false,
+                    }, {
+                        address,
+                        scannerId: requestOptions?.scannerId,
+                        timeoutMs: timeouts.marketGetAssetData,
+                    });
+                    const normalized = normalizeAssetCandles(payload);
+                    if (normalized.error) {
+                        logger.warn("Provider candle payload had recoverable issues.", {
+                            tool: toolNames.marketGetAssetData,
+                            address,
+                            scannerId: requestOptions?.scannerId,
+                            asset,
+                            error: normalized.error,
+                        });
+                    }
+                    return normalized;
+                });
+                result[asset] = candles;
+            }));
+            return result;
+        },
+        getSmData: async (address) => cache.getOrLoad(cacheKey("sm-data", address), cacheTtl.smData, async () => {
+            const payload = await client.callTool(toolNames.leaderboardGetMarkets, {
+                limit: 100,
+            }, {
+                address,
+                timeoutMs: timeouts.leaderboardGetMarkets,
+            });
+            throwIfMcpErrorEnvelope(payload, logger, {
+                tool: toolNames.leaderboardGetMarkets,
+                address,
+            });
+            const normalized = normalizeSmMarketsWithDiagnostics(payload);
+            warnOnNormalizationIssues(logger, {
+                tool: toolNames.leaderboardGetMarkets,
+                address,
+                diagnostics: normalized.diagnostics,
+            });
+            return normalized.value;
+        }),
+        getClearingHouseState: fetchClearingHouseState,
+        getActivePositions: async (address) => {
+            const state = await fetchClearingHouseState(address);
+            if (state === null) {
+                throw new Error("strategy_get_clearinghouse_state: unavailable or error response");
+            }
+            return state.positions;
+        },
+    };
+}
+/** Adapts either the provider-local logger or a winston-style logger into one provider logger surface. */
+function toProviderLogger(logger) {
+    if (!logger) {
+        return undefined;
+    }
+    if (isProviderLogger(logger)) {
+        return logger;
+    }
+    return createWinstonProviderLogger(logger);
+}
+/** Runtime guard for objects that already satisfy the provider logger contract. */
+function isProviderLogger(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const logger = value;
+    return (typeof logger.debug === "function" &&
+        typeof logger.info === "function" &&
+        typeof logger.warn === "function" &&
+        typeof logger.error === "function");
+}
+/**
+ * Chooses which assets should receive candle requests for one run.
+ * Preferred assets win when they are present in the current instrument universe;
+ * otherwise the provider falls back to the deduplicated instrument list.
+ */
+function selectCandleAssets(instruments, requestOptions, maxCandleAssets) {
+    const preferred = requestOptions?.preferredAssets ?? [];
+    const preferredSet = new Set(preferred);
+    const validPreferred = instruments
+        .map((instrument) => instrument.name)
+        .filter((asset) => preferredSet.has(asset));
+    if (validPreferred.length > 0) {
+        return dedupeAssets(validPreferred).slice(0, maxCandleAssets);
+    }
+    return dedupeAssets(instruments.map((instrument) => instrument.name)).slice(0, maxCandleAssets);
+}
+/** Removes duplicate asset symbols while preserving first-seen order. */
+function dedupeAssets(assets) {
+    return [...new Set(assets)];
+}
+function mcpErrorDetail(raw) {
+    const err = raw.error;
+    if (isRecord(err)) {
+        return asString(err.message) ?? JSON.stringify(err);
+    }
+    return asString(raw.message) ?? "unknown error";
+}
+function throwIfMcpErrorEnvelope(raw, logger, ctx) {
+    if (!isRecord(raw) || raw.success !== false) {
+        return;
+    }
+    const detail = mcpErrorDetail(raw);
+    logger.warn(`${ctx.tool}: MCP returned success:false`, {
+        tool: ctx.tool,
+        address: ctx.address,
+        error: detail,
+    });
+    throw new Error(`${ctx.tool}: unavailable or error response`);
+}
+/** Builds a stable cache key for one provider payload family. */
+function cacheKey(prefix, ...parts) {
+    return `${prefix}:${parts.join(":")}`;
+}
+/**
+ * Normalizes the raw `strategy_get_clearinghouse_state` payload into the same
+ * contract used by `StrategyStateImpl`.
+ *
+ * The MCP response is expected to be keyed by venue, for example:
+ * `{ main: { crossMarginSummary, withdrawable, assetPositions }, xyz: { ... } }`.
+ */
+function normalizeClearingHouseState(raw) {
+    const unwrapped = unwrapEnvelope(raw);
+    const data = (unwrapped && typeof unwrapped === "object" ? unwrapped : {});
+    let accountValue = 0;
+    let totalMarginUsed = 0;
+    let totalUnrealizedPnl = 0;
+    let totalNtlPos = 0;
+    let withdrawable = 0;
+    const time = extractMinClearingHouseTime(data);
+    const positions = [];
+    for (const [dexKey, dexValue] of Object.entries(data)) {
+        if (!isRecord(dexValue)) {
+            continue;
+        }
+        const summary = dexValue.crossMarginSummary;
+        if (isRecord(summary)) {
+            accountValue += asNumber(summary.accountValue) ?? 0;
+            totalMarginUsed += asNumber(summary.totalMarginUsed) ?? 0;
+            totalUnrealizedPnl += asNumber(summary.totalUnrealizedPnl) ?? 0;
+            totalNtlPos += asNumber(summary.totalNtlPos) ?? 0;
+        }
+        withdrawable += asNumber(dexValue.withdrawable) ?? 0;
+        const assetPositions = dexValue.assetPositions;
+        if (!Array.isArray(assetPositions)) {
+            continue;
+        }
+        for (const item of assetPositions) {
+            if (!isRecord(item)) {
+                continue;
+            }
+            const positionRecord = isRecord(item.position)
+                ? item.position
+                : item;
+            const rawSzi = asNumber(positionRecord.szi) ?? 0;
+            const mag = Math.abs(rawSzi);
+            if (mag === 0) {
+                continue;
+            }
+            const dirRaw = asString(positionRecord.direction)?.trim().toUpperCase();
+            const szi = dirRaw === "LONG" ? mag : dirRaw === "SHORT" ? -mag : rawSzi;
+            const leverageRecord = isRecord(positionRecord.leverage)
+                ? positionRecord.leverage
+                : null;
+            const leverage = asNumber(leverageRecord?.value) ?? 0;
+            const leverageType = asString(leverageRecord?.type) === "isolated"
+                ? "isolated"
+                : "cross";
+            positions.push({
+                coin: asString(positionRecord.coin) ?? "",
+                dex: dexKey,
+                szi,
+                entryPx: asNumber(positionRecord.entryPx) ?? 0,
+                leverage,
+                leverageType,
+                unrealizedPnl: asNumber(positionRecord.unrealizedPnl) ?? 0,
+                marginUsed: asNumber(positionRecord.marginUsed) ?? 0,
+                liquidationPx: asNumber(positionRecord.liquidationPx) ?? null,
+                returnOnEquity: asNumber(positionRecord.returnOnEquity) ?? 0,
+            });
+        }
+    }
+    return {
+        accountValue,
+        totalMarginUsed,
+        totalUnrealizedPnl,
+        totalNtlPos,
+        withdrawable,
+        positions,
+        time,
+    };
+}
+/** Emits one warning when normalization discarded rows or recorded parse issues. */
+function warnOnNormalizationIssues(logger, params) {
+    const { diagnostics } = params;
+    if (diagnostics.discardedCount === 0 &&
+        Object.keys(diagnostics.issueCounts).length === 0) {
+        return;
+    }
+    logger.warn("Provider normalization reported discarded rows.", {
+        tool: params.tool,
+        address: params.address,
+        scannerId: params.scannerId,
+        acceptedCount: diagnostics.acceptedCount,
+        discardedCount: diagnostics.discardedCount,
+        issueCounts: diagnostics.issueCounts,
+    });
+}
+//# sourceMappingURL=factory.js.map

package/dist/scanners/providers/factory.js.map

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

package/dist/scanners/providers/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Raw MCP payload contracts used by scanner provider adapters.
+ * These types reflect the expected wire shape before normalization.
+ */
+/** Common MCP envelope shape (`{ success, data }`) returned by some clients. */
+export interface SenpiEnvelope<T> {
+    success: boolean;
+    data: T;
+}
+/** Raw instrument context payload returned by `market_list_instruments`. */
+export interface RawInstrumentContext {
+    markPx: unknown;
+    prevDayPx: unknown;
+    midPx: unknown;
+    dayNtlVlm: unknown;
+    openInterest: unknown;
+    funding: unknown;
+    [key: string]: unknown;
+}
+/** Raw instrument row returned by `market_list_instruments`. */
+export interface RawInstrument {
+    name: unknown;
+    is_delisted: unknown;
+    max_leverage: unknown;
+    context: RawInstrumentContext | unknown;
+}
+/** Raw response shape for `market_list_instruments`. */
+export interface RawMarketListInstrumentsResponse {
+    instruments: RawInstrument[] | unknown;
+}
+/** Raw candle row returned by `market_get_asset_data`. */
+export interface RawCandleRow {
+    t: unknown;
+    o: unknown;
+    h: unknown;
+    l: unknown;
+    c: unknown;
+    v: unknown;
+}
+/** Raw response shape for `market_get_asset_data`. */
+export interface RawMarketAssetDataResponse {
+    candles?: Record<string, RawCandleRow[] | unknown> | unknown;
+    error?: unknown;
+}
+/** Raw smart-money market row returned by `leaderboard_get_markets`. */
+export interface RawSmMarket {
+    token: unknown;
+    dex?: unknown;
+    direction: unknown;
+    pct_of_top_traders_gain: unknown;
+    trader_count: unknown;
+    token_price_change_pct_4h: unknown;
+    [key: string]: unknown;
+}
+/** Raw response shape for `leaderboard_get_markets`. */
+export interface RawLeaderboardMarketsResponse {
+    markets?: {
+        markets?: RawSmMarket[] | unknown;
+    } | RawSmMarket[] | unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/scanners/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/scanners/providers/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gFAAgF;AAChF,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,CAAC,CAAC;CACT;AAED,4EAA4E;AAC5E,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC;CACzC;AAED,wDAAwD;AACxD,MAAM,WAAW,gCAAgC;IAC/C,WAAW,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;CACxC;AAED,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,OAAO,CAAC;IACX,CAAC,EAAE,OAAO,CAAC;IACX,CAAC,EAAE,OAAO,CAAC;IACX,CAAC,EAAE,OAAO,CAAC;IACX,CAAC,EAAE,OAAO,CAAC;IACX,CAAC,EAAE,OAAO,CAAC;CACZ;AAED,sDAAsD;AACtD,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,uBAAuB,EAAE,OAAO,CAAC;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,yBAAyB,EAAE,OAAO,CAAC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wDAAwD;AACxD,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,CAAA;KAAE,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC;CAC3E"}

package/dist/scanners/providers/types.js

@@ -0,0 +1,6 @@
+/**
+ * Raw MCP payload contracts used by scanner provider adapters.
+ * These types reflect the expected wire shape before normalization.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/scanners/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/scanners/providers/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/scanners/runtime-module.d.ts

@@ -0,0 +1,79 @@
+import type { ScannerComponentHealthStatus, ScannerSystemState } from "../health/types.js";
+import type { ScannerDataProviders } from "./engine/data-providers.js";
+import { type ScannerRegistrationSummary } from "./engine/engine.js";
+import type { ScannerComposition } from "../runtime/scanner-composition.js";
+import { type ScannerRuntimeEventMap, type ScannerRuntimeEventName } from "./events.js";
+import type { ScannerLogger } from "./protocol/context.js";
+import { type ScannerFactory } from "./prepare-scanner-inputs.js";
+import type { ReadSignalsFilter, ScanResult, ScannerId, Signal, StrategyRegistration } from "./types.js";
+/** Factory that creates one scanner instance for one strategy registration. */
+export type { ScannerFactory } from "./prepare-scanner-inputs.js";
+/**
+ * Scanner registration input accepted by module bootstrap.
+ * Each entry must build a fresh scanner instance for each strategy registration.
+ */
+export type ScannerInput<Cfg = unknown, St = unknown> = ScannerFactory<Cfg, St>;
+/** Runtime-module bootstrap options for scanner registration and state wiring. */
+export interface ScannerRuntimeModuleOptions {
+    stateDir: string;
+    strategy: StrategyRegistration;
+    scanners: ScannerInput[];
+    /** Explicit scanner dependency composition — required so callers declare the dependency graph upfront. */
+    composition: ScannerComposition;
+    providers?: ScannerDataProviders;
+    logger?: ScannerLogger;
+    now?: () => number;
+}
+/** Public control surface exposed by the standalone scanner runtime module. */
+export interface ScannerRuntimeModule {
+    /** Starts interval scheduling for all enabled scanner registrations. */
+    start(): Promise<void>;
+    /** Stops interval scheduling; in-flight runs are allowed to finish. */
+    stop(): Promise<void>;
+    /** Runs one scanner immediately for one strategy. */
+    runOnce(address: string, scannerId: ScannerId): Promise<ScanResult>;
+    /** Runs one scanner and its configured dependency chain immediately in order. */
+    runChain(address: string, scannerId: ScannerId): Promise<ScanResult[]>;
+    /** Lists registered scanners and enablement state, optionally filtered by address. */
+    listScanners(address?: string): Promise<ScannerRegistrationSummary[]>;
+    /** Enables one scanner registration for future scheduled/manual runs. */
+    enableScanner(address: string, scannerId: ScannerId): Promise<void>;
+    /** Disables one scanner registration for future scheduled/manual runs. */
+    disableScanner(address: string, scannerId: ScannerId): Promise<void>;
+    /** Reads current persisted config for one scanner registration. */
+    getScannerConfig(address: string, scannerId: ScannerId): Promise<unknown>;
+    /** Writes validated config for one scanner registration. */
+    setScannerConfig(address: string, scannerId: ScannerId, config: unknown): Promise<void>;
+    /** Reads the latest committed retained context for one scanner registration. */
+    getScannerContext(address: string, scannerId: ScannerId): Promise<unknown | null>;
+    /** Queries persisted latest signals. */
+    querySignals(filter?: ReadSignalsFilter): Promise<Signal[]>;
+    /** Subscribes one event listener to runtime lifecycle events. */
+    on<Name extends ScannerRuntimeEventName>(eventName: Name, listener: (event: ScannerRuntimeEventMap[Name]) => void): void;
+    /** Unsubscribes one event listener from runtime lifecycle events. */
+    off<Name extends ScannerRuntimeEventName>(eventName: Name, listener: (event: ScannerRuntimeEventMap[Name]) => void): void;
+    /** Lightweight health summary for the scanners component. */
+    getHealthStatus(): Promise<ScannerComponentHealthStatus>;
+    /** Full configuration/runtime snapshot for the scanners component. */
+    getSystemState(): Promise<ScannerSystemState>;
+}
+/**
+ * Creates a standalone scanner runtime module with strategy-scoped scanner instances.
+ * Registered scanners are supplied as factories so the module never reuses mutable scanner objects.
+ */
+export declare function createScannerRuntimeModule(options: ScannerRuntimeModuleOptions): ScannerRuntimeModule;
+/**
+ * Builds a scanner composition from scanner factories.
+ *
+ * Convenience wrapper for the programmatic API: instantiates each factory once
+ * to extract definitions, validates the dependency graph, and returns both the
+ * composition and deduplicated factories ready to pass to `createScannerRuntimeModule`.
+ *
+ * Scanner definitions that consume shared artifacts from other scanners must
+ * declare `dependsOn` explicitly — no auto-inference is performed.
+ */
+export declare function buildCompositionFromScanners(scanners: ScannerInput[]): {
+    composition: ScannerComposition;
+    scanners: ScannerInput[];
+};
+//# sourceMappingURL=runtime-module.d.ts.map

package/dist/scanners/runtime-module.d.ts.map

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