@senpi/runtime 1.0.95-dev.20260408174401

package/dist/scanners/__tests__/fixtures/position-tracker-scenarios.js

@@ -0,0 +1,199 @@
+export function positionTrackerPosition(overrides) {
+    return {
+        dex: "main",
+        szi: 1,
+        entryPx: 100,
+        unrealizedPnl: 0,
+        marginUsed: 100,
+        liquidationPx: 50,
+        returnOnEquity: 0,
+        leverage: 5,
+        leverageType: "cross",
+        ...overrides,
+    };
+}
+export function positionTrackerState(positions) {
+    return {
+        accountValue: 10_000,
+        totalMarginUsed: 3_000,
+        totalUnrealizedPnl: 500,
+        totalNtlPos: 2_500,
+        withdrawable: 7_000,
+        positions,
+        time: Date.now(),
+    };
+}
+export const positionTrackerScenarios = [
+    {
+        name: "treats the first observed snapshot as opened positions",
+        runs: [
+            {
+                state: positionTrackerState([
+                    positionTrackerPosition({ coin: "BTC", szi: 1 }),
+                    positionTrackerPosition({ coin: "ETH", szi: -2 }),
+                    positionTrackerPosition({ coin: "SOL", szi: 3 }),
+                ]),
+                expectedSignals: [
+                    { signalType: "POSITION_OPENED", asset: "BTC", dex: "main" },
+                    { signalType: "POSITION_OPENED", asset: "ETH", dex: "main" },
+                    { signalType: "POSITION_OPENED", asset: "SOL", dex: "main" },
+                ],
+            },
+        ],
+    },
+    {
+        name: "detects closes after the initial scan",
+        runs: [
+            {
+                state: positionTrackerState([
+                    positionTrackerPosition({ coin: "BTC", szi: 1 }),
+                    positionTrackerPosition({ coin: "ETH", szi: -2 }),
+                    positionTrackerPosition({ coin: "SOL", szi: 3 }),
+                ]),
+                expectedSignals: [
+                    { signalType: "POSITION_OPENED", asset: "BTC", dex: "main" },
+                    { signalType: "POSITION_OPENED", asset: "ETH", dex: "main" },
+                    { signalType: "POSITION_OPENED", asset: "SOL", dex: "main" },
+                ],
+            },
+            {
+                state: positionTrackerState([
+                    positionTrackerPosition({ coin: "BTC", szi: 1 }),
+                    positionTrackerPosition({ coin: "ETH", szi: -2 }),
+                ]),
+                expectedSignals: [{ signalType: "POSITION_CLOSED", asset: "SOL", dex: "main" }],
+            },
+        ],
+    },
+    {
+        name: "detects increases, decreases, and flips in one sequence",
+        runs: [
+            {
+                state: positionTrackerState([
+                    positionTrackerPosition({ coin: "BTC", szi: 1 }),
+                    positionTrackerPosition({ coin: "ETH", szi: -4 }),
+                    positionTrackerPosition({ coin: "SOL", szi: 2 }),
+                ]),
+                expectedSignals: [
+                    { signalType: "POSITION_OPENED", asset: "BTC", dex: "main" },
+                    { signalType: "POSITION_OPENED", asset: "ETH", dex: "main" },
+                    { signalType: "POSITION_OPENED", asset: "SOL", dex: "main" },
+                ],
+            },
+            {
+                state: positionTrackerState([
+                    positionTrackerPosition({ coin: "BTC", szi: 2 }),
+                    positionTrackerPosition({ coin: "ETH", szi: -3 }),
+                    positionTrackerPosition({ coin: "SOL", szi: -1 }),
+                ]),
+                expectedSignals: [
+                    { signalType: "POSITION_INCREASED", asset: "BTC", dex: "main" },
+                    { signalType: "POSITION_DECREASED", asset: "ETH", dex: "main" },
+                    { signalType: "POSITION_FLIPPED", asset: "SOL", dex: "main" },
+                ],
+            },
+        ],
+    },
+    {
+        name: "handles mixed opened, closed, and unchanged positions",
+        runs: [
+            {
+                state: positionTrackerState([
+                    positionTrackerPosition({ coin: "BTC", szi: 1 }),
+                    positionTrackerPosition({ coin: "ETH", szi: 1 }),
+                ]),
+                expectedSignals: [
+                    { signalType: "POSITION_OPENED", asset: "BTC", dex: "main" },
+                    { signalType: "POSITION_OPENED", asset: "ETH", dex: "main" },
+                ],
+            },
+            {
+                state: positionTrackerState([
+                    positionTrackerPosition({ coin: "ETH", szi: 1 }),
+                    positionTrackerPosition({ coin: "SOL", szi: -2 }),
+                ]),
+                expectedSignals: [
+                    { signalType: "POSITION_CLOSED", asset: "BTC", dex: "main" },
+                    { signalType: "POSITION_OPENED", asset: "SOL", dex: "main" },
+                ],
+            },
+        ],
+    },
+    {
+        name: "produces no deltas on an empty first run",
+        runs: [
+            {
+                state: positionTrackerState([]),
+                expectedSignals: [],
+            },
+        ],
+    },
+    {
+        name: "closes all positions when the snapshot becomes empty",
+        runs: [
+            {
+                state: positionTrackerState([
+                    positionTrackerPosition({ coin: "BTC", szi: 1 }),
+                    positionTrackerPosition({ coin: "ETH", szi: -2 }),
+                    positionTrackerPosition({ coin: "SOL", szi: 3 }),
+                ]),
+                expectedSignals: [
+                    { signalType: "POSITION_OPENED", asset: "BTC", dex: "main" },
+                    { signalType: "POSITION_OPENED", asset: "ETH", dex: "main" },
+                    { signalType: "POSITION_OPENED", asset: "SOL", dex: "main" },
+                ],
+            },
+            {
+                state: positionTrackerState([]),
+                expectedSignals: [
+                    { signalType: "POSITION_CLOSED", asset: "BTC", dex: "main" },
+                    { signalType: "POSITION_CLOSED", asset: "ETH", dex: "main" },
+                    { signalType: "POSITION_CLOSED", asset: "SOL", dex: "main" },
+                ],
+            },
+        ],
+    },
+    {
+        name: "ignores entry-price-only changes when size and direction stay the same",
+        runs: [
+            {
+                state: positionTrackerState([
+                    positionTrackerPosition({ coin: "BTC", szi: 1, entryPx: 100 }),
+                ]),
+                expectedSignals: [
+                    { signalType: "POSITION_OPENED", asset: "BTC", dex: "main" },
+                ],
+            },
+            {
+                state: positionTrackerState([
+                    positionTrackerPosition({ coin: "BTC", szi: 1, entryPx: 110 }),
+                ]),
+                expectedSignals: [],
+            },
+        ],
+    },
+    {
+        name: "tracks same-asset positions independently across dexs",
+        runs: [
+            {
+                state: positionTrackerState([
+                    positionTrackerPosition({ coin: "BTC", dex: "main", szi: 1 }),
+                    positionTrackerPosition({ coin: "BTC", dex: "xyz", szi: -2 }),
+                ]),
+                expectedSignals: [
+                    { signalType: "POSITION_OPENED", asset: "BTC", dex: "main" },
+                    { signalType: "POSITION_OPENED", asset: "BTC", dex: "xyz" },
+                ],
+            },
+            {
+                state: positionTrackerState([
+                    positionTrackerPosition({ coin: "BTC", dex: "xyz", szi: -2 }),
+                ]),
+                expectedSignals: [
+                    { signalType: "POSITION_CLOSED", asset: "BTC", dex: "main" },
+                ],
+            },
+        ],
+    },
+];
+//# sourceMappingURL=position-tracker-scenarios.js.map

package/dist/scanners/__tests__/fixtures/position-tracker-scenarios.js.map

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

package/dist/scanners/__tests__/fixtures/scan-results.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Sample ScanResult fixtures covering common engine outcomes.
+ *
+ * Each factory accepts an optional `overrides` partial to tweak individual fields.
+ */
+import type { ScanResult } from "../../types.js";
+/** Creates an OK scan result with actionable momentum signals. */
+export declare function createOkMomentumResult(overrides?: Partial<ScanResult>): ScanResult;
+/** Creates a HEARTBEAT result (scan ran, no signals). */
+export declare function createHeartbeatResult(overrides?: Partial<ScanResult>): ScanResult;
+/** Creates a prescreener HEARTBEAT (infrastructure scanner, never emits signals). */
+export declare function createPrescreenerResult(overrides?: Partial<ScanResult>): ScanResult;
+/** Creates an OI tracker HEARTBEAT result. */
+export declare function createOiTrackerResult(overrides?: Partial<ScanResult>): ScanResult;
+/** Creates an OK emerging-movers result with signals. */
+export declare function createEmergingMoversResult(overrides?: Partial<ScanResult>): ScanResult;
+/** Creates an ERROR result (scanner threw). */
+export declare function createErrorResult(overrides?: Partial<ScanResult>): ScanResult;
+/** Creates a SKIPPED result (e.g. SkipScan thrown by beforeScan hook). */
+export declare function createSkippedResult(overrides?: Partial<ScanResult>): ScanResult;
+/** Creates a DISABLED result. */
+export declare function createDisabledResult(overrides?: Partial<ScanResult>): ScanResult;
+//# sourceMappingURL=scan-results.d.ts.map

package/dist/scanners/__tests__/fixtures/scan-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-results.d.ts","sourceRoot":"","sources":["../../../../src/scanners/__tests__/fixtures/scan-results.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAU,MAAM,gBAAgB,CAAC;AAIzD,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAgBlF;AAED,yDAAyD;AACzD,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAYjF;AAED,qFAAqF;AACrF,wBAAgB,uBAAuB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAYnF;AAED,8CAA8C;AAC9C,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAYjF;AAED,yDAAyD;AACzD,wBAAgB,0BAA0B,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAatF;AAED,+CAA+C;AAC/C,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAa7E;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAa/E;AAED,iCAAiC;AACjC,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAahF"}

package/dist/scanners/__tests__/fixtures/scan-results.js

@@ -0,0 +1,128 @@
+/**
+ * Sample ScanResult fixtures covering common engine outcomes.
+ *
+ * Each factory accepts an optional `overrides` partial to tweak individual fields.
+ */
+import { ScanStatus } from "../../types.js";
+import { createMomentumSignal, createEmergingMoverSignal } from "./signals.js";
+/** Creates an OK scan result with actionable momentum signals. */
+export function createOkMomentumResult(overrides) {
+    const signals = [
+        createMomentumSignal(),
+        createMomentumSignal({ asset: "SOL", score: 0.58 }),
+    ];
+    return {
+        address: "alpha",
+        scannerId: "momentum",
+        status: ScanStatus.OK,
+        timestamp: 1741635600000,
+        signals,
+        actionableCount: signals.length,
+        scannedCount: 5,
+        summary: { candidates: 5, signals: signals.length },
+        ...overrides,
+    };
+}
+/** Creates a HEARTBEAT result (scan ran, no signals). */
+export function createHeartbeatResult(overrides) {
+    return {
+        address: "alpha",
+        scannerId: "momentum",
+        status: ScanStatus.HEARTBEAT,
+        timestamp: 1741635600000,
+        signals: [],
+        actionableCount: 0,
+        scannedCount: 5,
+        summary: { candidates: 5, signals: 0 },
+        ...overrides,
+    };
+}
+/** Creates a prescreener HEARTBEAT (infrastructure scanner, never emits signals). */
+export function createPrescreenerResult(overrides) {
+    return {
+        address: "alpha",
+        scannerId: "prescreener",
+        status: ScanStatus.HEARTBEAT,
+        timestamp: 1741635600000,
+        signals: [],
+        actionableCount: 0,
+        scannedCount: 120,
+        summary: { inputCount: 230, candidateCount: 30 },
+        ...overrides,
+    };
+}
+/** Creates an OI tracker HEARTBEAT result. */
+export function createOiTrackerResult(overrides) {
+    return {
+        address: "alpha",
+        scannerId: "oi-tracker",
+        status: ScanStatus.HEARTBEAT,
+        timestamp: 1741635600000,
+        signals: [],
+        actionableCount: 0,
+        scannedCount: 97,
+        summary: { instrumentCount: 230, trackedCount: 97 },
+        ...overrides,
+    };
+}
+/** Creates an OK emerging-movers result with signals. */
+export function createEmergingMoversResult(overrides) {
+    const signals = [createEmergingMoverSignal()];
+    return {
+        address: "alpha",
+        scannerId: "emerging-movers",
+        status: ScanStatus.OK,
+        timestamp: 1741635600000,
+        signals,
+        actionableCount: signals.length,
+        scannedCount: 10,
+        summary: { rankedCount: 10, scans: 4 },
+        ...overrides,
+    };
+}
+/** Creates an ERROR result (scanner threw). */
+export function createErrorResult(overrides) {
+    return {
+        address: "alpha",
+        scannerId: "momentum",
+        status: ScanStatus.ERROR,
+        timestamp: 1741635600000,
+        signals: [],
+        actionableCount: 0,
+        scannedCount: 0,
+        reason: "Provider tool call failed: Timeout after 10000ms.",
+        summary: {},
+        ...overrides,
+    };
+}
+/** Creates a SKIPPED result (e.g. SkipScan thrown by beforeScan hook). */
+export function createSkippedResult(overrides) {
+    return {
+        address: "alpha",
+        scannerId: "momentum",
+        status: ScanStatus.SKIPPED,
+        timestamp: 1741635600000,
+        signals: [],
+        actionableCount: 0,
+        scannedCount: 0,
+        reason: "Market closed",
+        summary: {},
+        ...overrides,
+    };
+}
+/** Creates a DISABLED result. */
+export function createDisabledResult(overrides) {
+    return {
+        address: "alpha",
+        scannerId: "momentum",
+        status: ScanStatus.DISABLED,
+        timestamp: 1741635600000,
+        signals: [],
+        actionableCount: 0,
+        scannedCount: 0,
+        reason: "Scanner disabled",
+        summary: {},
+        ...overrides,
+    };
+}
+//# sourceMappingURL=scan-results.js.map

package/dist/scanners/__tests__/fixtures/scan-results.js.map

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

package/dist/scanners/__tests__/fixtures/signals.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Sample Signal fixtures for each built-in scanner type.
+ *
+ * Use the factory functions to create realistic Signal objects for testing
+ * downstream consumers (actions, hooks, notifications).
+ *
+ * Each factory accepts an optional `overrides` partial to tweak individual fields.
+ */
+import type { Signal } from "../../types.js";
+/** Creates a momentum breakout signal (from the momentum scanner). */
+export declare function createMomentumSignal(overrides?: Partial<Signal>): Signal;
+/** Creates a short-side momentum signal. */
+export declare function createMomentumShortSignal(overrides?: Partial<Signal>): Signal;
+/** Creates an emerging mover signal (from the emerging-movers scanner). */
+export declare function createEmergingMoverSignal(overrides?: Partial<Signal>): Signal;
+/** Creates a weak/borderline signal useful for threshold testing. */
+export declare function createWeakSignal(overrides?: Partial<Signal>): Signal;
+//# sourceMappingURL=signals.d.ts.map

package/dist/scanners/__tests__/fixtures/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../../../src/scanners/__tests__/fixtures/signals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,sEAAsE;AACtE,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAqBxE;AAED,4CAA4C;AAC5C,wBAAgB,yBAAyB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAa7E;AAED,2EAA2E;AAC3E,wBAAgB,yBAAyB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAqB7E;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAYpE"}

package/dist/scanners/__tests__/fixtures/signals.js

@@ -0,0 +1,84 @@
+/**
+ * Sample Signal fixtures for each built-in scanner type.
+ *
+ * Use the factory functions to create realistic Signal objects for testing
+ * downstream consumers (actions, hooks, notifications).
+ *
+ * Each factory accepts an optional `overrides` partial to tweak individual fields.
+ */
+/** Creates a momentum breakout signal (from the momentum scanner). */
+export function createMomentumSignal(overrides) {
+    return {
+        address: "alpha",
+        scannerId: "momentum",
+        signalType: "MOMENTUM_BREAKOUT",
+        asset: "BTC",
+        direction: "LONG",
+        score: 0.82,
+        timestamp: 1741635600000,
+        factors: {
+            move_threshold: true,
+            prescreened: true,
+        },
+        meta: {
+            timeframe: "1h",
+            changePct: 3.47,
+            lastClose: 87450,
+            prevClose: 84520,
+        },
+        ...overrides,
+    };
+}
+/** Creates a short-side momentum signal. */
+export function createMomentumShortSignal(overrides) {
+    return createMomentumSignal({
+        asset: "ETH",
+        direction: "SHORT",
+        score: 0.65,
+        meta: {
+            timeframe: "1h",
+            changePct: -2.14,
+            lastClose: 3120,
+            prevClose: 3188,
+        },
+        ...overrides,
+    });
+}
+/** Creates an emerging mover signal (from the emerging-movers scanner). */
+export function createEmergingMoverSignal(overrides) {
+    return {
+        address: "alpha",
+        scannerId: "emerging-movers",
+        signalType: "EMERGING_MOVER",
+        asset: "SOL",
+        direction: "LONG",
+        score: 0.71,
+        timestamp: 1741635600000,
+        factors: {
+            rank_jump: true,
+            gain_threshold: true,
+        },
+        meta: {
+            rank: 3,
+            prevRank: 14,
+            jump: 11,
+            topTradersGain: 0.28,
+        },
+        ...overrides,
+    };
+}
+/** Creates a weak/borderline signal useful for threshold testing. */
+export function createWeakSignal(overrides) {
+    return createMomentumSignal({
+        asset: "DOGE",
+        score: 0.15,
+        meta: {
+            timeframe: "1h",
+            changePct: 0.62,
+            lastClose: 0.187,
+            prevClose: 0.1858,
+        },
+        ...overrides,
+    });
+}
+//# sourceMappingURL=signals.js.map

package/dist/scanners/__tests__/fixtures/signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.js","sourceRoot":"","sources":["../../../../src/scanners/__tests__/fixtures/signals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,sEAAsE;AACtE,MAAM,UAAU,oBAAoB,CAAC,SAA2B;IAC9D,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,SAAS,EAAE,UAAU;QACrB,UAAU,EAAE,mBAAmB;QAC/B,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,MAAM;QACjB,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,aAAa;QACxB,OAAO,EAAE;YACP,cAAc,EAAE,IAAI;YACpB,WAAW,EAAE,IAAI;SAClB;QACD,IAAI,EAAE;YACJ,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,KAAK;YAChB,SAAS,EAAE,KAAK;SACjB;QACD,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,yBAAyB,CAAC,SAA2B;IACnE,OAAO,oBAAoB,CAAC;QAC1B,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,OAAO;QAClB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE;YACJ,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,CAAC,IAAI;YAChB,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,IAAI;SAChB;QACD,GAAG,SAAS;KACb,CAAC,CAAC;AACL,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,yBAAyB,CAAC,SAA2B;IACnE,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,SAAS,EAAE,iBAAiB;QAC5B,UAAU,EAAE,gBAAgB;QAC5B,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,MAAM;QACjB,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,aAAa;QACxB,OAAO,EAAE;YACP,SAAS,EAAE,IAAI;YACf,cAAc,EAAE,IAAI;SACrB;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,CAAC;YACP,QAAQ,EAAE,EAAE;YACZ,IAAI,EAAE,EAAE;YACR,cAAc,EAAE,IAAI;SACrB;QACD,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,gBAAgB,CAAC,SAA2B;IAC1D,OAAO,oBAAoB,CAAC;QAC1B,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,IAAI;QACX,IAAI,EAAE;YACJ,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,KAAK;YAChB,SAAS,EAAE,MAAM;SAClB;QACD,GAAG,SAAS;KACb,CAAC,CAAC;AACL,CAAC"}

package/dist/scanners/__tests__/test-helpers.d.ts

@@ -0,0 +1,4 @@
+export declare function createTempDir(prefix: string): Promise<string>;
+export declare function removeDir(path: string): Promise<void>;
+export declare function listFilesRecursive(root: string): Promise<string[]>;
+//# sourceMappingURL=test-helpers.d.ts.map

package/dist/scanners/__tests__/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../../src/scanners/__tests__/test-helpers.ts"],"names":[],"mappings":"AAIA,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnE;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAcxE"}

package/dist/scanners/__tests__/test-helpers.js

@@ -0,0 +1,23 @@
+import { mkdtemp, readdir, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+export async function createTempDir(prefix) {
+    return mkdtemp(join(tmpdir(), prefix));
+}
+export async function removeDir(path) {
+    await rm(path, { recursive: true, force: true });
+}
+export async function listFilesRecursive(root) {
+    const out = [];
+    const entries = await readdir(root, { withFileTypes: true });
+    for (const entry of entries) {
+        const entryPath = join(root, entry.name);
+        if (entry.isDirectory()) {
+            out.push(...(await listFilesRecursive(entryPath)));
+            continue;
+        }
+        out.push(entryPath);
+    }
+    return out;
+}
+//# sourceMappingURL=test-helpers.js.map

package/dist/scanners/__tests__/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../../src/scanners/__tests__/test-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAc;IAChD,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY;IACnD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACnD,SAAS;QACX,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/scanners/artifacts.d.ts

@@ -0,0 +1,131 @@
+import { type TSchema } from "@sinclair/typebox";
+import type { ScannerDependencyPolicyMode } from "./scanner-definition.js";
+import type { Candidate, OiSnapshot, SharedArtifactKey } from "./types.js";
+export interface PrescreenedCandidate extends Candidate {
+    score: number;
+    changePct: number;
+    volume: number;
+    openInterest: number;
+}
+export interface PrescreenedArtifact {
+    timestamp: number;
+    candidates: PrescreenedCandidate[];
+}
+export type OiHistoryArtifact = Record<string, OiSnapshot[]>;
+export type BtcCacheArtifact = Record<string, unknown>;
+/** Macro market environment classification. */
+export declare enum MarketRegime {
+    BULLISH = "BULLISH",
+    BEARISH = "BEARISH",
+    NEUTRAL = "NEUTRAL"
+}
+/** Shared artifact published by the market-regime scanner. */
+export interface MarketRegimeArtifact {
+    regime: MarketRegime;
+    confidence: number;
+    btcBias: MarketRegime;
+    ethBias: MarketRegime;
+    btcWeight: number;
+    ethWeight: number;
+    timestamp: number;
+}
+/**
+ * Compatibility map for built-in retained-context payloads.
+ *
+ * The runtime no longer treats shared-artifact keys as a closed set; any
+ * scanner may publish one retained context contract in v1. Keep this map only
+ * for built-in scanner/test typing and helper generics.
+ */
+export interface SharedArtifactValueMap {
+    prescreened: PrescreenedArtifact;
+    "oi-history": OiHistoryArtifact;
+    "btc-cache": BtcCacheArtifact;
+    "market-regime": MarketRegimeArtifact;
+}
+export type SharedArtifactValue<Key extends SharedArtifactKey> = Key extends keyof SharedArtifactValueMap ? SharedArtifactValueMap[Key] : unknown;
+/**
+ * Contract describing one shared artifact channel.
+ *
+ * Shared artifacts are internal shared market intelligence between scanners:
+ * strategy-scoped persisted data products that scanners publish and consume.
+ * They are not downstream trading signals and they are not scanner-local state.
+ */
+export interface SharedArtifactContract<Key extends SharedArtifactKey = SharedArtifactKey> {
+    key: Key;
+    description: string;
+    schema?: TSchema;
+}
+export declare function defineSharedArtifact<Key extends SharedArtifactKey>(key: Key, options: {
+    description: string;
+    schema?: TSchema;
+}): SharedArtifactContract<Key>;
+/**
+ * Optional provider-backed source that can satisfy an artifact input before store fallback.
+ * Current support is intentionally small; expand it only when a shared artifact has a
+ * clear provider-backed equivalent.
+ */
+export type ArtifactProviderSource = "oiHistory";
+/**
+ * Consumer-side binding for one shared artifact.
+ *
+ * This keeps the global artifact contract separate from scanner-local consumption policy.
+ * A binding answers: how should this scanner load and validate this shared market intelligence?
+ */
+export interface ConsumedArtifactBinding<Key extends SharedArtifactKey = SharedArtifactKey> {
+    /** The shared artifact contract being consumed. */
+    contract: SharedArtifactContract<Key>;
+    /** Fail the run when the artifact cannot be resolved from providers or store. */
+    required?: boolean;
+    /** Maximum acceptable age in milliseconds when loading from the shared-artifact store. */
+    maxAgeMs?: number;
+    /** Behavior when the artifact is missing after provider/store resolution. */
+    onMissing?: ScannerDependencyPolicyMode;
+    /** Behavior when the artifact exists but is stale. */
+    onStale?: ScannerDependencyPolicyMode;
+    /**
+     * Optional provider-backed source that can populate this artifact input before
+     * falling back to the persisted shared-artifact store.
+     */
+    providerSource?: ArtifactProviderSource;
+}
+/** Creates one scanner-side binding for consumed shared market intelligence. */
+export declare function consumeSharedArtifact<Key extends SharedArtifactKey>(contract: SharedArtifactContract<Key>, options?: Omit<ConsumedArtifactBinding<Key>, "contract">): ConsumedArtifactBinding<Key>;
+export declare const prescreenedArtifactSchema: import("@sinclair/typebox").TObject<{
+    timestamp: import("@sinclair/typebox").TNumber;
+    candidates: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        name: import("@sinclair/typebox").TString;
+        context: import("@sinclair/typebox").TObject<{
+            markPx: import("@sinclair/typebox").TNumber;
+            prevDayPx: import("@sinclair/typebox").TNumber;
+            midPx: import("@sinclair/typebox").TNumber;
+            dayNtlVlm: import("@sinclair/typebox").TNumber;
+            openInterest: import("@sinclair/typebox").TNumber;
+            funding: import("@sinclair/typebox").TNumber;
+        }>;
+        maxLeverage: import("@sinclair/typebox").TNumber;
+        score: import("@sinclair/typebox").TNumber;
+        changePct: import("@sinclair/typebox").TNumber;
+        volume: import("@sinclair/typebox").TNumber;
+        openInterest: import("@sinclair/typebox").TNumber;
+    }>>;
+}>;
+export declare const oiHistoryArtifactSchema: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+    oi: import("@sinclair/typebox").TNumber;
+    price: import("@sinclair/typebox").TNumber;
+    timestamp: import("@sinclair/typebox").TNumber;
+}>>>;
+export declare const btcCacheArtifactSchema: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>;
+export declare const prescreenedArtifact: SharedArtifactContract<"prescreened">;
+export declare const oiHistoryArtifact: SharedArtifactContract<"oi-history">;
+export declare const btcCacheArtifact: SharedArtifactContract<"btc-cache">;
+export declare const marketRegimeArtifactSchema: import("@sinclair/typebox").TObject<{
+    regime: import("@sinclair/typebox").TEnum<typeof MarketRegime>;
+    confidence: import("@sinclair/typebox").TNumber;
+    btcBias: import("@sinclair/typebox").TEnum<typeof MarketRegime>;
+    ethBias: import("@sinclair/typebox").TEnum<typeof MarketRegime>;
+    btcWeight: import("@sinclair/typebox").TNumber;
+    ethWeight: import("@sinclair/typebox").TNumber;
+    timestamp: import("@sinclair/typebox").TNumber;
+}>;
+export declare const marketRegimeArtifact: SharedArtifactContract<"market-regime">;
+//# sourceMappingURL=artifacts.d.ts.map