@senpi/trading-recipe 1.0.21

package/dist/runtime/reconcile-state.js

@@ -0,0 +1,112 @@
+/**
+ * Post-hydrate reconciliation: align StateManager DSL state with backend (Senpi/MCP) open positions.
+ * Best-effort: on backend failure for an address, we skip that address entirely (do not archive).
+ */
+import { CLOSE_REASON } from "../constants/dsl/index.js";
+import { EVENTS } from "../constants/dsl/index.js";
+import { createLogger } from "../utils/logger.js";
+const logger = createLogger("[senpi-core][reconcile]");
+function positionKey(address, asset, dex) {
+    return `${address}:${asset}:${dex ?? ""}`;
+}
+/**
+ * Parse a state key "address/dsl-ASSET" or "address/dsl-xyz--ASSET" to address, asset, dex.
+ */
+function parseDslKey(key) {
+    const i = key.indexOf("/dsl-");
+    if (i <= 0)
+        return null;
+    const address = key.slice(0, i);
+    const suffix = key.slice(i + 5);
+    if (suffix.startsWith("xyz--")) {
+        return { address, asset: suffix.slice(5), dex: "xyz" };
+    }
+    return { address, asset: suffix, dex: "" };
+}
+function effectiveDex(parsed) {
+    return parsed.dex ?? "";
+}
+/**
+ * Reconcile state with backend: fetch open positions per address and archive local DSL state
+ * for positions that are no longer on the exchange (e.g. closed manually externally).
+ * Only archives positions for addresses where listOpenPositions succeeded; if the API throws
+ * or is unavailable for an address, we do not archive any position for that address.
+ *
+ * Call after hydrate() in Runtime.start() and periodically from the DSL monitor tick.
+ *
+ * @param addressesOrStrategiesMap - strategy addresses to reconcile, or strategies Map (uses its keys)
+ * @param options - optional bus to emit POSITION_CLOSED when archiving (e.g. from monitor)
+ */
+export async function reconcileStateWithBackend(stateManager, senpi, addressesOrStrategiesMap, options) {
+    const { bus } = options ?? {};
+    const addresses = addressesOrStrategiesMap instanceof Map
+        ? Array.from(addressesOrStrategiesMap.keys())
+        : addressesOrStrategiesMap;
+    const backendPositionKeys = new Set();
+    const successfullyFetchedAddresses = new Set();
+    for (const address of addresses) {
+        try {
+            const positions = await senpi.listOpenPositions(address);
+            successfullyFetchedAddresses.add(address);
+            for (const p of positions) {
+                const coin = p.coin ?? "";
+                const dex = p.dex ?? "";
+                if (coin)
+                    backendPositionKeys.add(positionKey(address, coin, dex));
+            }
+        }
+        catch (err) {
+            logger.warn("reconcile: listOpenPositions failed, skipping wallet (no positions archived)", {
+                address,
+                err,
+            });
+        }
+    }
+    logger.debug("reconcile: backend positions collected", {
+        backendPositionKeysCount: backendPositionKeys.size,
+        successfullyFetchedCount: successfullyFetchedAddresses.size,
+    });
+    const dslKeys = stateManager.listDslKeys("");
+    const ts = new Date().toISOString();
+    for (const key of dslKeys) {
+        const parsed = parseDslKey(key);
+        if (!parsed)
+            continue;
+        if (!successfullyFetchedAddresses.has(parsed.address))
+            continue;
+        const state = stateManager.get(key);
+        if (!state || !state.active)
+            continue;
+        const pk = positionKey(parsed.address, parsed.asset, parsed.dex);
+        if (backendPositionKeys.has(pk))
+            continue;
+        try {
+            const closedState = {
+                ...state,
+                active: false,
+                closedAt: ts,
+                closeReason: CLOSE_REASON.CLOSED_EXTERNALLY,
+            };
+            await stateManager.archiveAndDeleteDslState(parsed.address, parsed.asset, effectiveDex(parsed), closedState);
+            logger.info("reconcile: archived DSL state (position no longer on backend)", {
+                address: parsed.address,
+                asset: parsed.asset,
+            });
+            if (bus) {
+                const tsEmit = new Date().toISOString();
+                bus.emit(EVENTS.POSITION_CLOSED, {
+                    address: parsed.address,
+                    asset: parsed.asset,
+                    wallet: state.wallet,
+                    reason: CLOSE_REASON.CLOSED_EXTERNALLY,
+                    closeReason: CLOSE_REASON.CLOSED_EXTERNALLY,
+                    timestamp: tsEmit,
+                });
+            }
+        }
+        catch (err) {
+            logger.warn("reconcile: failed to archive state", { key, err });
+        }
+    }
+}
+//# sourceMappingURL=reconcile-state.js.map

package/dist/runtime/reconcile-state.js.map

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

package/dist/runtime/risk-guard.d.ts

@@ -0,0 +1,6 @@
+/**
+ * RiskGuard: gate check and record entry (stub - gate always OPEN, record no-op).
+ */
+import type { RiskGuard as IRiskGuard } from "../types/action.js";
+export declare function createRiskGuard(): IRiskGuard;
+//# sourceMappingURL=risk-guard.d.ts.map

package/dist/runtime/risk-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-guard.d.ts","sourceRoot":"","sources":["../../src/runtime/risk-guard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAmB,SAAS,IAAI,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEnF,wBAAgB,eAAe,IAAI,UAAU,CAS5C"}

package/dist/runtime/risk-guard.js

@@ -0,0 +1,14 @@
+/**
+ * RiskGuard: gate check and record entry (stub - gate always OPEN, record no-op).
+ */
+export function createRiskGuard() {
+    return {
+        checkGate(_address, _guardRails) {
+            return { gate: "OPEN" };
+        },
+        recordEntry(_address, _guardRails) {
+            // no-op
+        },
+    };
+}
+//# sourceMappingURL=risk-guard.js.map

package/dist/runtime/risk-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-guard.js","sourceRoot":"","sources":["../../src/runtime/risk-guard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,SAAS,CAAC,QAAgB,EAAE,WAAqC;YAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1B,CAAC;QACD,WAAW,CAAC,QAAgB,EAAE,WAAqC;YACjE,QAAQ;QACV,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime/run.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Programmatic entry: load trading strategy and start runtime. Returns handle with stop().
+ */
+import type { McpTransport } from "../senpi/types.js";
+import type { ScannerDataProviders } from "../scanners/engine/data-providers.js";
+export interface RunOptions {
+    fromPath?: boolean;
+    stateDir?: string;
+    mcpTransport?: McpTransport;
+    apiKey?: string;
+    scannerProviders?: ScannerDataProviders;
+}
+export interface RuntimeHandle {
+    stop(): Promise<void>;
+}
+/**
+ * Load trading strategy from path or content, create Runtime, start it, and return a handle with stop().
+ * Programmatic API used by the OpenClaw adapter and standalone CLI.
+ */
+export declare function run(strategyPathOrContent: string, options?: RunOptions): Promise<RuntimeHandle>;
+//# sourceMappingURL=run.d.ts.map

package/dist/runtime/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/runtime/run.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAKjF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAsB,GAAG,CACvB,qBAAqB,EAAE,MAAM,EAC7B,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,aAAa,CAAC,CAwBxB"}

package/dist/runtime/run.js

@@ -0,0 +1,35 @@
+/**
+ * Programmatic entry: load trading strategy and start runtime. Returns handle with stop().
+ */
+import { getDefaultStateDir } from "./default-state-dir.js";
+import { loadTradingStrategy } from "./load-trading-strategy.js";
+import { Runtime } from "./runtime.js";
+/**
+ * Load trading strategy from path or content, create Runtime, start it, and return a handle with stop().
+ * Programmatic API used by the OpenClaw adapter and standalone CLI.
+ */
+export async function run(strategyPathOrContent, options) {
+    const fromPath = options?.fromPath === true;
+    const config = await loadTradingStrategy(strategyPathOrContent, { fromPath });
+    const stateDir = (typeof options?.stateDir === "string" && options.stateDir.length > 0)
+        ? options.stateDir
+        : getDefaultStateDir();
+    const mcpTransport = options?.mcpTransport;
+    const apiKey = options?.apiKey;
+    if (!mcpTransport && !apiKey) {
+        throw new Error("run() requires mcpTransport or apiKey for full operation");
+    }
+    const runtime = new Runtime(config, {
+        stateDir,
+        mcpTransport,
+        apiKey,
+        scannerProviders: options?.scannerProviders,
+    });
+    await runtime.start();
+    return {
+        async stop() {
+            await runtime.stop();
+        },
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/runtime/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/runtime/run.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAcvC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,qBAA6B,EAC7B,OAAoB;IAEpB,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,qBAAqB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9E,MAAM,QAAQ,GACZ,CAAC,OAAO,OAAO,EAAE,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACpE,CAAC,CAAC,OAAO,CAAC,QAAQ;QAClB,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAC3B,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;IAC3C,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;IAC/B,IAAI,CAAC,YAAY,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE;QAClC,QAAQ;QACR,YAAY;QACZ,MAAM;QACN,gBAAgB,EAAE,OAAO,EAAE,gBAAgB;KAC5C,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACtB,OAAO;QACL,KAAK,CAAC,IAAI;YACR,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime/runtime.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Runtime: orchestrates trading strategy config, scanner module, actions, DSL, risk, health.
+ */
+import type { TradingStrategyConfig } from "./trading-strategy-config.js";
+import type { McpTransport } from "../senpi/types.js";
+import type { ScannerDataProviders } from "../scanners/engine/data-providers.js";
+export interface RuntimeOptions {
+    stateDir: string;
+    mcpTransport?: McpTransport;
+    apiKey?: string;
+    scannerProviders?: ScannerDataProviders;
+}
+export declare class Runtime {
+    private readonly config;
+    private readonly options;
+    private bus;
+    private hookSystem;
+    private stateManager;
+    private scannerModule;
+    private dslPlugin;
+    private senpi;
+    private started;
+    /** Serial signal processing: queue and consumer so only one signal is handled at a time. */
+    private signalQueue;
+    private signalQueueWait;
+    private signalConsumerStopped;
+    private signalConsumerDone;
+    private runActionsForSignal;
+    private strategiesMap;
+    /** Stored so we can call off() in stop() and avoid retaining Runtime via scanner EventEmitter. */
+    private onScannerRunComplete;
+    constructor(config: TradingStrategyConfig, options: RuntimeOptions);
+    start(): Promise<void>;
+    /**
+     * Single consumer: process one scanner:run:complete at a time so slot counts stay correct.
+     */
+    private runSignalConsumer;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAI1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AA4BjF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAOD,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,GAAG,CAAiB;IAC5B,OAAO,CAAC,UAAU,CAAuC;IACzD,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,aAAa,CAAwB;IAC7C,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,OAAO,CAAS;IAExB,4FAA4F;IAC5F,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,kBAAkB,CAA8B;IACxD,OAAO,CAAC,mBAAmB,CAAuC;IAClE,OAAO,CAAC,aAAa,CAA+B;IAEpD,kGAAkG;IAClG,OAAO,CAAC,oBAAoB,CAA0D;gBAE1E,MAAM,EAAE,qBAAqB,EAAE,OAAO,EAAE,cAAc;IAK5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyI5B;;OAEG;YACW,iBAAiB;IA2CzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA8B5B"}

package/dist/runtime/runtime.js

@@ -0,0 +1,251 @@
+/**
+ * Runtime: orchestrates trading strategy config, scanner module, actions, DSL, risk, health.
+ */
+import { createRuntimeBus } from "./bus.js";
+import { createHookSystem } from "./hook-system.js";
+import { SenpiClient } from "../senpi/client.js";
+import { createLlmDecision } from "../actions/llm-decision/index.js";
+import { StateManager } from "../state/index.js";
+import { createContextBuilder } from "../context/index.js";
+import { createRiskGuard } from "./risk-guard.js";
+import { createNotificationService } from "./notifications.js";
+import { mapStrategiesToConfig } from "./map-strategies.js";
+import { mapTradingStrategyExitToDslConfig } from "./map-exit-config.js";
+import { buildActionScanPayload } from "./build-action-scan-payload.js";
+import { createScannerModuleFromTradingStrategy } from "./create-scanner-module.js";
+import { createRuntimeContext } from "./create-runtime-context.js";
+import { createActions } from "./create-actions.js";
+import { ScannerRegistry } from "./scanner-registry.js";
+import { ActionRegistry } from "./action-registry.js";
+import { initRisk } from "../risk/index.js";
+import { initHealth } from "../health/index.js";
+import { DslPlugin as DslPluginClass } from "../dsl/plugin/index.js";
+import { HOOK_EVENT } from "../types/hooks.js";
+import { MaxLeverageCache } from "../leverage/max-leverage-cache.js";
+import { createLogger } from "../utils/logger.js";
+const logger = createLogger("[senpi-core][runtime]");
+export class Runtime {
+    config;
+    options;
+    bus;
+    hookSystem;
+    stateManager;
+    scannerModule;
+    dslPlugin = null;
+    senpi = null;
+    started = false;
+    /** Serial signal processing: queue and consumer so only one signal is handled at a time. */
+    signalQueue = [];
+    signalQueueWait = null;
+    signalConsumerStopped = false;
+    signalConsumerDone = null;
+    runActionsForSignal;
+    strategiesMap;
+    /** Stored so we can call off() in stop() and avoid retaining Runtime via scanner EventEmitter. */
+    onScannerRunComplete = null;
+    constructor(config, options) {
+        this.config = config;
+        this.options = options;
+    }
+    async start() {
+        if (this.started)
+            return;
+        logger.info("Runtime.start() entered", { configName: this.config.name });
+        const { stateDir, mcpTransport, apiKey, scannerProviders } = this.options;
+        if (!mcpTransport && !apiKey) {
+            throw new Error("Runtime requires mcpTransport or apiKey for full operation (positions, LLM)");
+        }
+        // Validation: every scanner type and action_type must be in registries
+        for (const sc of this.config.scanners ?? []) {
+            if (!ScannerRegistry.get(sc.type)) {
+                throw new Error(`Unknown scanner type: ${sc.type}`);
+            }
+        }
+        for (const ac of this.config.actions ?? []) {
+            if (!ActionRegistry.get(ac.action_type)) {
+                throw new Error(`Unknown action_type: ${ac.action_type}`);
+            }
+        }
+        this.bus = createRuntimeBus();
+        this.hookSystem = createHookSystem(this.bus);
+        this.stateManager = new StateManager(stateDir);
+        await this.stateManager.hydrate();
+        const senpi = mcpTransport
+            ? new SenpiClient(mcpTransport)
+            : new SenpiClient({ apiKey });
+        if (!mcpTransport) {
+            await senpi.connect();
+        }
+        this.senpi = senpi;
+        this.strategiesMap = mapStrategiesToConfig(this.config);
+        try {
+            const { reconcileStateWithBackend } = await import("./reconcile-state.js");
+            await reconcileStateWithBackend(this.stateManager, senpi, this.strategiesMap);
+        }
+        catch (err) {
+            logger.warn("reconcile after hydrate failed, continuing", { err });
+        }
+        const llmDecision = createLlmDecision({});
+        const contextBuilder = createContextBuilder();
+        const riskGuard = createRiskGuard();
+        const notifications = createNotificationService({
+            ...this.config.notifications,
+            mcpTransport: this.options.mcpTransport,
+        });
+        logger.info("Runtime.start() creating scanner module");
+        // Augment caller-supplied providers with StateManager-backed DSL state access
+        const augmentedProviders = {
+            ...scannerProviders,
+            getDslStatesForStrategy: scannerProviders?.getDslStatesForStrategy
+                ?? (async (address) => this.stateManager.listDslStates(address)),
+        };
+        this.scannerModule = createScannerModuleFromTradingStrategy(this.config, stateDir, augmentedProviders);
+        logger.info("Runtime.start() scanner module created, calling start()");
+        // Pre-load max leverage cache (non-blocking — log warning on failure)
+        const maxLeverageCache = new MaxLeverageCache(senpi);
+        try {
+            await maxLeverageCache.load();
+        }
+        catch (err) {
+            logger.warn("failed to pre-load max leverage cache, will retry on first use", { err });
+        }
+        // Build RuntimeContext once per trading strategy and reuse for all actions.
+        const runtimeContext = createRuntimeContext(this.strategiesMap, {
+            senpi,
+            hookSystem: this.hookSystem,
+            llmDecision,
+            contextBuilder,
+            riskGuard,
+            notifications,
+            stateManager: this.stateManager,
+            scannerModule: this.scannerModule,
+            maxLeverageCache,
+        });
+        const { runActionsForSignal } = createActions(this.config, {
+            bus: this.bus,
+            senpi,
+            stateManager: this.stateManager,
+            hookSystem: this.hookSystem,
+            llmDecision,
+            contextBuilder,
+            riskGuard,
+            notifications,
+            runtimeContext,
+        });
+        this.runActionsForSignal = runActionsForSignal;
+        const exitConfig = mapTradingStrategyExitToDslConfig(this.config.exit);
+        const hasDsl = exitConfig.dsl_presets && Object.keys(exitConfig.dsl_presets).length > 0;
+        if (hasDsl) {
+            this.dslPlugin = await DslPluginClass.create({
+                config: exitConfig,
+                bus: this.bus,
+                stateDir,
+                stateManager: this.stateManager,
+                senpiClient: senpi,
+            });
+        }
+        else {
+            this.dslPlugin = null;
+        }
+        initRisk(this.bus);
+        initHealth(this.bus);
+        this.onScannerRunComplete = (event) => {
+            this.signalQueue.push({ result: event.result });
+            if (this.signalQueueWait) {
+                const w = this.signalQueueWait;
+                this.signalQueueWait = null;
+                w();
+            }
+            // Forward scanner summary alerts (e.g. watchdog) to notification service
+            const alerts = event.result.summary?.alerts;
+            if (Array.isArray(alerts) && alerts.length > 0) {
+                const header = `[${event.result.scannerId}] ${alerts.length} alert(s):`;
+                const lines = alerts.map((a) => `  ${a.level ?? "ALERT"}: ${a.message ?? ""}`);
+                notifications.notify(`${header}\n${lines.join("\n")}`).catch(() => { });
+            }
+        };
+        this.scannerModule.on("scanner:run:complete", this.onScannerRunComplete);
+        this.signalConsumerDone = this.runSignalConsumer();
+        logger.info("Runtime.start() invoking scannerModule.start()");
+        await this.scannerModule.start();
+        logger.info("Runtime.start() scannerModule.start() returned");
+        this.started = true;
+    }
+    /**
+     * Single consumer: process one scanner:run:complete at a time so slot counts stay correct.
+     */
+    async runSignalConsumer() {
+        while (true) {
+            let item = this.signalQueue.shift();
+            while (item === undefined && !this.signalConsumerStopped) {
+                await new Promise((resolve) => {
+                    this.signalQueueWait = resolve;
+                });
+                item = this.signalQueue.shift();
+            }
+            if (this.signalConsumerStopped && !item)
+                break;
+            if (!item)
+                continue;
+            try {
+                const usedSlotsByStrategy = this.stateManager.getUsedSlotsByStrategy(Array.from(this.strategiesMap.keys()));
+                const payload = buildActionScanPayload(item.result, this.strategiesMap, {
+                    usedSlotsByStrategy,
+                    address: item.result.address,
+                });
+                const hookEvent = {
+                    type: HOOK_EVENT.ON_SIGNAL_DETECTED,
+                    tradingStrategyName: this.config.name,
+                    address: item.result.address,
+                    data: payload,
+                    timestamp: new Date().toISOString(),
+                };
+                this.bus.emit(HOOK_EVENT.ON_SIGNAL_DETECTED, hookEvent);
+                await this.runActionsForSignal(hookEvent);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                const stack = err instanceof Error ? err.stack : undefined;
+                console.error("[senpi-recipe] signal processing error", message, stack ?? "");
+                this.bus.emit("signal_processing_error", {
+                    error: err,
+                    address: item.result.address,
+                    scannerId: item.result.scannerId,
+                    timestamp: new Date().toISOString(),
+                });
+            }
+        }
+    }
+    async stop() {
+        if (!this.started)
+            return;
+        this.started = false;
+        this.signalConsumerStopped = true;
+        if (this.signalQueueWait) {
+            const w = this.signalQueueWait;
+            this.signalQueueWait = null;
+            w();
+        }
+        if (this.signalConsumerDone) {
+            await this.signalConsumerDone;
+            this.signalConsumerDone = null;
+        }
+        if (this.onScannerRunComplete != null) {
+            this.scannerModule.off("scanner:run:complete", this.onScannerRunComplete);
+            this.onScannerRunComplete = null;
+        }
+        await this.scannerModule.stop();
+        if (this.dslPlugin) {
+            this.dslPlugin.stop();
+            this.dslPlugin = null;
+        }
+        if (this.senpi) {
+            await this.senpi.disconnect();
+            this.senpi = null;
+        }
+        if (this.bus.removeAllListeners) {
+            this.bus.removeAllListeners();
+        }
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime/runtime.js.map

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

package/dist/runtime/scanner-registry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Scanner type registry: map type string to Scanner factory.
+ */
+import type { Scanner } from "../scanners/protocol/scanner.js";
+export type ScannerFactory = () => Scanner<any, any>;
+/** Registers one scanner factory under a runtime type alias. */
+declare function register(type: string, factory: ScannerFactory): void;
+/** Returns the scanner factory currently associated with one runtime type alias. */
+declare function get(type: string): ScannerFactory | undefined;
+/**
+ * Create a scanner factory for the given type, with YAML name as the runtime id.
+ * The returned factory builds a fresh scanner instance for each registration and
+ * shallow-merges any YAML-level config overrides onto the scanner's default config.
+ */
+declare function createScanner(type: string, yamlName: string, configOverrides?: unknown): ScannerFactory;
+export declare const ScannerRegistry: {
+    register: typeof register;
+    get: typeof get;
+    createScanner: typeof createScanner;
+};
+export {};
+//# sourceMappingURL=scanner-registry.d.ts.map

package/dist/runtime/scanner-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner-registry.d.ts","sourceRoot":"","sources":["../../src/runtime/scanner-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAW/D,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAIrD,gEAAgE;AAChE,iBAAS,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAE7D;AAED,oFAAoF;AACpF,iBAAS,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAErD;AAED;;;;GAIG;AACH,iBAAS,aAAa,CACpB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,OAAO,GACxB,cAAc,CAoBhB;AAuCD,eAAO,MAAM,eAAe;;;;CAI3B,CAAC"}

package/dist/runtime/scanner-registry.js

@@ -0,0 +1,83 @@
+/**
+ * Scanner type registry: map type string to Scanner factory.
+ */
+import { emergingMoversScanner } from "../scanners/implementations/emerging-movers.js";
+import { momentumScanner } from "../scanners/implementations/momentum.js";
+import { oiTrackerScanner } from "../scanners/implementations/oi-tracker.js";
+import { prescreenerScanner } from "../scanners/implementations/prescreener.js";
+import { liquidationWatchdogScanner } from "../scanners/implementations/liquidation-watchdog.js";
+import { marketRegimeScanner } from "../scanners/implementations/market-regime.js";
+import { smFlipScanner } from "../scanners/implementations/sm-flip.js";
+import { opportunityScanner } from "../scanners/implementations/opportunity.js";
+const registry = new Map();
+/** Registers one scanner factory under a runtime type alias. */
+function register(type, factory) {
+    registry.set(type, factory);
+}
+/** Returns the scanner factory currently associated with one runtime type alias. */
+function get(type) {
+    return registry.get(type);
+}
+/**
+ * Create a scanner factory for the given type, with YAML name as the runtime id.
+ * The returned factory builds a fresh scanner instance for each registration and
+ * shallow-merges any YAML-level config overrides onto the scanner's default config.
+ */
+function createScanner(type, yamlName, configOverrides) {
+    const factory = registry.get(type);
+    if (!factory) {
+        throw new Error(`Unknown scanner type: ${type}`);
+    }
+    return () => {
+        const scanner = factory();
+        const definition = {
+            ...scanner.definition,
+            id: yamlName,
+            defaultConfig: mergeConfigOverrides(scanner.definition.defaultConfig, configOverrides),
+        };
+        return {
+            ...scanner,
+            definition,
+        };
+    };
+}
+/**
+ * Applies runtime config overrides coming from trading strategy YAML registration.
+ * Object-shaped overrides are shallow-merged so omitted fields still inherit
+ * the scanner's built-in defaults.
+ */
+function mergeConfigOverrides(defaultConfig, overrides) {
+    if (overrides === undefined) {
+        return defaultConfig;
+    }
+    if (isRecord(defaultConfig) && isRecord(overrides)) {
+        return {
+            ...defaultConfig,
+            ...structuredClone(overrides),
+        };
+    }
+    return structuredClone(overrides);
+}
+/** Narrow runtime config overrides to plain object values before attempting a merge. */
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+register("emerging_movers", emergingMoversScanner);
+register("emerging-movers", emergingMoversScanner);
+register("momentum", momentumScanner);
+register("oi_tracker", oiTrackerScanner);
+register("oi-tracker", oiTrackerScanner);
+register("prescreener", prescreenerScanner);
+register("liquidation_watchdog", liquidationWatchdogScanner);
+register("liquidation-watchdog", liquidationWatchdogScanner);
+register("market_regime", marketRegimeScanner);
+register("market-regime", marketRegimeScanner);
+register("sm_flip", smFlipScanner);
+register("sm-flip", smFlipScanner);
+register("opportunity", opportunityScanner);
+export const ScannerRegistry = {
+    register,
+    get,
+    createScanner,
+};
+//# sourceMappingURL=scanner-registry.js.map

package/dist/runtime/scanner-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner-registry.js","sourceRoot":"","sources":["../../src/runtime/scanner-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,MAAM,qDAAqD,CAAC;AACjG,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAIhF,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEnD,gEAAgE;AAChE,SAAS,QAAQ,CAAC,IAAY,EAAE,OAAuB;IACrD,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED,oFAAoF;AACpF,SAAS,GAAG,CAAC,IAAY;IACvB,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CACpB,IAAY,EACZ,QAAgB,EAChB,eAAyB;IAEzB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,GAAG,EAAE;QACV,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAG;YACjB,GAAG,OAAO,CAAC,UAAU;YACrB,EAAE,EAAE,QAAqB;YACzB,aAAa,EAAE,oBAAoB,CACjC,OAAO,CAAC,UAAU,CAAC,aAAa,EAChC,eAAe,CAChB;SACF,CAAC;QACF,OAAO;YACL,GAAG,OAAO;YACV,UAAU;SACA,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,oBAAoB,CAAM,aAAkB,EAAE,SAAkB;IACvE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,IAAI,QAAQ,CAAC,aAAa,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACnD,OAAO;YACL,GAAG,aAAa;YAChB,GAAG,eAAe,CAAC,SAAS,CAAC;SACvB,CAAC;IACX,CAAC;IACD,OAAO,eAAe,CAAC,SAAS,CAAQ,CAAC;AAC3C,CAAC;AAED,wFAAwF;AACxF,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,QAAQ,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,CAAC;AACnD,QAAQ,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,CAAC;AACnD,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;AACtC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;AACzC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;AACzC,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;AAC5C,QAAQ,CAAC,sBAAsB,EAAE,0BAA0B,CAAC,CAAC;AAC7D,QAAQ,CAAC,sBAAsB,EAAE,0BAA0B,CAAC,CAAC;AAC7D,QAAQ,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC;AAC/C,QAAQ,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC;AAC/C,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AACnC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AACnC,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;AAE5C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ;IACR,GAAG;IACH,aAAa;CACd,CAAC"}