@senpi/trading-runtime 1.0.0

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;AA2BjF,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;IA0H5B;;OAEG;YACW,iBAAiB;IAmDzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAmC5B"}

package/dist/runtime/runtime.js

@@ -0,0 +1,249 @@
+/**
+ * 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 { 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 });
+        logger.debug("Runtime.start() begin", { 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
+        logger.debug("Runtime.start() validating scanners and actions");
+        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);
+        logger.debug("Runtime.start() bus and hookSystem created");
+        this.stateManager = new StateManager(stateDir);
+        await this.stateManager.hydrate();
+        logger.debug("Runtime.start() stateManager hydrated", { stateDir });
+        const senpi = mcpTransport
+            ? new SenpiClient(mcpTransport)
+            : new SenpiClient({ apiKey });
+        if (!mcpTransport) {
+            await senpi.connect();
+        }
+        this.senpi = senpi;
+        logger.debug("Runtime.start() senpi client ready");
+        this.strategiesMap = mapStrategiesToConfig(this.config);
+        try {
+            const { reconcileStateWithBackend } = await import("./reconcile-state.js");
+            await reconcileStateWithBackend(this.stateManager, senpi, this.strategiesMap);
+            logger.debug("Runtime.start() reconcile with backend done");
+        }
+        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);
+        logger.info("Runtime.start() creating scanner module");
+        this.scannerModule = createScannerModuleFromTradingStrategy(this.config, stateDir, scannerProviders);
+        logger.info("Runtime.start() scanner module created, calling start()");
+        // 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,
+        });
+        const { runActionsForSignal } = createActions(this.config, {
+            bus: this.bus,
+            senpi,
+            stateManager: this.stateManager,
+            hookSystem: this.hookSystem,
+            llmDecision,
+            contextBuilder,
+            riskGuard,
+            notifications,
+            runtimeContext,
+        });
+        this.runActionsForSignal = runActionsForSignal;
+        logger.debug("Runtime.start() actions and runActionsForSignal ready");
+        const exitConfig = mapTradingStrategyExitToDslConfig(this.config.exit);
+        const hasDsl = exitConfig.dsl_presets && Object.keys(exitConfig.dsl_presets).length > 0;
+        if (hasDsl) {
+            logger.debug("Runtime.start() creating DSL plugin");
+            this.dslPlugin = await DslPluginClass.create({
+                config: exitConfig,
+                bus: this.bus,
+                stateDir,
+                stateManager: this.stateManager,
+                senpiClient: senpi,
+            });
+        }
+        else {
+            this.dslPlugin = null;
+        }
+        logger.debug("Runtime.start() DSL plugin ready", { hasDsl });
+        initRisk(this.bus);
+        initHealth(this.bus);
+        logger.debug("Runtime.start() risk and health inited");
+        this.onScannerRunComplete = (event) => {
+            this.signalQueue.push({ result: event.result });
+            if (this.signalQueueWait) {
+                const w = this.signalQueueWait;
+                this.signalQueueWait = null;
+                w();
+            }
+        };
+        this.scannerModule.on("scanner:run:complete", this.onScannerRunComplete);
+        logger.debug("Runtime.start() scanner:run:complete listener attached");
+        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;
+        logger.debug("Runtime.start() complete", { configName: this.config.name });
+    }
+    /**
+     * 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;
+            logger.debug("signal consumer: processing scan result", {
+                scannerId: item.result.scannerId,
+                address: item.result.address,
+                signalsCount: item.result.signals?.length ?? 0,
+            });
+            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);
+                logger.debug("signal consumer: running actions for signal");
+                await this.runActionsForSignal(hookEvent);
+                logger.debug("signal consumer: actions completed");
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                const stack = err instanceof Error ? err.stack : undefined;
+                console.error("[senpi-runtime] 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;
+        logger.debug("Runtime.stop() begin", { configName: this.config.name });
+        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;
+        }
+        logger.debug("Runtime.stop() stopping scanner module");
+        await this.scannerModule.stop();
+        if (this.dslPlugin) {
+            this.dslPlugin.stop();
+            this.dslPlugin = null;
+            logger.debug("Runtime.stop() DSL plugin stopped");
+        }
+        if (this.senpi) {
+            await this.senpi.disconnect();
+            this.senpi = null;
+            logger.debug("Runtime.stop() senpi disconnected");
+        }
+        if (this.bus.removeAllListeners) {
+            this.bus.removeAllListeners();
+        }
+        logger.debug("Runtime.stop() complete");
+    }
+}
+//# 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;AAO/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;AAgCD,eAAO,MAAM,eAAe;;;;CAI3B,CAAC"}

package/dist/runtime/scanner-registry.js

@@ -0,0 +1,72 @@
+/**
+ * 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";
+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);
+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;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;AAE5C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ;IACR,GAAG;IACH,aAAa;CACd,CAAC"}

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

@@ -0,0 +1,49 @@
+/**
+ * Internal registry of installed strategies (installed_strategies.json).
+ * Source of truth for what the plugin should run; read on boot, updated by CLI/RPC install/uninstall.
+ */
+export declare const REGISTRY_FILENAME = "installed_strategies.json";
+export interface InstalledStrategyEntry {
+    id: string;
+    tradingStrategyYamlPath?: string;
+    tradingStrategyYamlContent?: string;
+}
+export interface InstalledStrategiesRegistry {
+    version: number;
+    strategies: InstalledStrategyEntry[];
+}
+/**
+ * Sanitize a string for use as registry id: replace non-alphanumeric with underscore, truncate.
+ */
+export declare function sanitizeId(candidate: string): string;
+/**
+ * Derive default id from file path (basename without extension).
+ */
+export declare function deriveIdFromPath(filePath: string, existingIds: string[]): string;
+/**
+ * Derive default id for content-only entry: content-0, content-1, ...
+ */
+export declare function deriveIdForContent(existingIds: string[]): string;
+/**
+ * Read the installed strategies registry from stateDir.
+ * Missing or invalid file returns { version: 1, strategies: [] }.
+ */
+export declare function readRegistry(stateDir: string): Promise<InstalledStrategiesRegistry>;
+/**
+ * Write the registry atomically (temp file then rename).
+ */
+export declare function writeRegistry(stateDir: string, data: InstalledStrategiesRegistry): Promise<void>;
+/**
+ * Validate that an entry has exactly one of tradingStrategyYamlPath or tradingStrategyYamlContent and id is safe.
+ */
+export declare function validateEntry(entry: InstalledStrategyEntry): {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Check if an id is already present in the registry.
+ */
+export declare function hasId(registry: InstalledStrategiesRegistry, id: string): boolean;
+//# sourceMappingURL=strategy-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-registry.d.ts","sourceRoot":"","sources":["../../src/runtime/strategy-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,eAAO,MAAM,iBAAiB,8BAA8B,CAAC;AAE7D,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,sBAAsB,EAAE,CAAC;CACtC;AAwBD;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAYhF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAShE;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAuCzF;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,sBAAsB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAOxG;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,2BAA2B,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAEhF"}

package/dist/runtime/strategy-registry.js

@@ -0,0 +1,150 @@
+/**
+ * Internal registry of installed strategies (installed_strategies.json).
+ * Source of truth for what the plugin should run; read on boot, updated by CLI/RPC install/uninstall.
+ */
+import { readFile, writeFile, rename, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { createLogger } from "../utils/logger.js";
+const logger = createLogger("[senpi-core][strategy-registry]");
+export const REGISTRY_FILENAME = "installed_strategies.json";
+const CURRENT_VERSION = 1;
+/** Filesystem-safe id: alphanumeric, hyphen, underscore only. */
+const ID_SAFE_REGEX = /^[a-zA-Z0-9_-]+$/;
+const ID_MAX_LENGTH = 64;
+function isEntryValid(entry) {
+    if (!entry || typeof entry !== "object")
+        return false;
+    const e = entry;
+    if (typeof e.id !== "string" || e.id.length === 0)
+        return false;
+    const hasPath = typeof e.tradingStrategyYamlPath === "string" && e.tradingStrategyYamlPath.length > 0;
+    const hasContent = typeof e.tradingStrategyYamlContent === "string";
+    if (hasPath && hasContent)
+        return false;
+    if (!hasPath && !hasContent)
+        return false;
+    return true;
+}
+function isIdSafe(id) {
+    if (id.length === 0 || id.length > ID_MAX_LENGTH)
+        return false;
+    return ID_SAFE_REGEX.test(id);
+}
+/**
+ * Sanitize a string for use as registry id: replace non-alphanumeric with underscore, truncate.
+ */
+export function sanitizeId(candidate) {
+    let out = candidate.replace(/[^a-zA-Z0-9_-]/g, "_").replace(/_+/g, "_");
+    if (out.startsWith("_"))
+        out = out.slice(1);
+    if (out.length > ID_MAX_LENGTH)
+        out = out.slice(0, ID_MAX_LENGTH);
+    return out || "strategy";
+}
+/**
+ * Derive default id from file path (basename without extension).
+ */
+export function deriveIdFromPath(filePath, existingIds) {
+    const base = filePath.split(/[/\\]/).pop() ?? "";
+    const withoutExt = base.replace(/\.(yaml|yml)$/i, "").trim();
+    let id = sanitizeId(withoutExt || "strategy");
+    if (!id)
+        id = "strategy";
+    let candidate = id;
+    let index = 0;
+    while (existingIds.includes(candidate)) {
+        index += 1;
+        candidate = `${id}-${index}`;
+    }
+    return candidate;
+}
+/**
+ * Derive default id for content-only entry: content-0, content-1, ...
+ */
+export function deriveIdForContent(existingIds) {
+    const max = existingIds
+        .filter((i) => i.startsWith("content-"))
+        .map((i) => {
+        const n = parseInt(i.replace("content-", ""), 10);
+        return Number.isFinite(n) ? n : -1;
+    })
+        .reduce((a, b) => Math.max(a, b), -1);
+    return `content-${max + 1}`;
+}
+/**
+ * Read the installed strategies registry from stateDir.
+ * Missing or invalid file returns { version: 1, strategies: [] }.
+ */
+export async function readRegistry(stateDir) {
+    const path = join(stateDir, REGISTRY_FILENAME);
+    try {
+        const raw = await readFile(path, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object") {
+            logger.warn("strategy registry invalid shape", { path });
+            return { version: CURRENT_VERSION, strategies: [] };
+        }
+        const obj = parsed;
+        const strategies = Array.isArray(obj.strategies) ? obj.strategies : [];
+        const valid = [];
+        for (let i = 0; i < strategies.length; i++) {
+            if (!isEntryValid(strategies[i])) {
+                logger.warn("strategy registry skip invalid entry", { path, index: i });
+                continue;
+            }
+            const rawEntry = strategies[i];
+            const entry = {
+                id: rawEntry.id,
+                tradingStrategyYamlPath: typeof rawEntry.tradingStrategyYamlPath === "string" ? rawEntry.tradingStrategyYamlPath : undefined,
+                tradingStrategyYamlContent: typeof rawEntry.tradingStrategyYamlContent === "string" ? rawEntry.tradingStrategyYamlContent : undefined,
+            };
+            if (!isIdSafe(entry.id)) {
+                logger.warn("strategy registry skip unsafe id", { path, id: entry.id });
+                continue;
+            }
+            valid.push(entry);
+        }
+        return {
+            version: typeof obj.version === "number" ? obj.version : CURRENT_VERSION,
+            strategies: valid,
+        };
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "ENOENT")
+            return { version: CURRENT_VERSION, strategies: [] };
+        logger.warn("strategy registry read failed", { path, err });
+        return { version: CURRENT_VERSION, strategies: [] };
+    }
+}
+/**
+ * Write the registry atomically (temp file then rename).
+ */
+export async function writeRegistry(stateDir, data) {
+    await mkdir(stateDir, { recursive: true });
+    const path = join(stateDir, REGISTRY_FILENAME);
+    const tmpPath = `${path}.tmp.${Date.now()}`;
+    await writeFile(tmpPath, JSON.stringify(data, null, 2), "utf-8");
+    await rename(tmpPath, path);
+}
+/**
+ * Validate that an entry has exactly one of tradingStrategyYamlPath or tradingStrategyYamlContent and id is safe.
+ */
+export function validateEntry(entry) {
+    if (!isIdSafe(entry.id))
+        return { ok: false, error: "id must be filesystem-safe (alphanumeric, hyphen, underscore)" };
+    const hasPath = typeof entry.tradingStrategyYamlPath === "string" && entry.tradingStrategyYamlPath.length > 0;
+    const hasContent = typeof entry.tradingStrategyYamlContent === "string";
+    if (hasPath && hasContent)
+        return { ok: false, error: "provide exactly one of tradingStrategyYamlPath or tradingStrategyYamlContent" };
+    if (!hasPath && !hasContent)
+        return { ok: false, error: "provide tradingStrategyYamlPath or tradingStrategyYamlContent" };
+    return { ok: true };
+}
+/**
+ * Check if an id is already present in the registry.
+ */
+export function hasId(registry, id) {
+    return registry.strategies.some((e) => e.id === id);
+}
+//# sourceMappingURL=strategy-registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-registry.js","sourceRoot":"","sources":["../../src/runtime/strategy-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,GAAG,YAAY,CAAC,iCAAiC,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,2BAA2B,CAAC;AAa7D,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,iEAAiE;AACjE,MAAM,aAAa,GAAG,kBAAkB,CAAC;AACzC,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,uBAAuB,KAAK,QAAQ,IAAI,CAAC,CAAC,uBAAuB,CAAC,MAAM,GAAG,CAAC,CAAC;IACtG,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,0BAA0B,KAAK,QAAQ,CAAC;IACpE,IAAI,OAAO,IAAI,UAAU;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,QAAQ,CAAC,EAAU;IAC1B,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,aAAa;QAAE,OAAO,KAAK,CAAC;IAC/D,OAAO,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC1C,IAAI,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACxE,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,GAAG,CAAC,MAAM,GAAG,aAAa;QAAE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;IAClE,OAAO,GAAG,IAAI,UAAU,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,WAAqB;IACtE,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IACjD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,IAAI,EAAE,GAAG,UAAU,CAAC,UAAU,IAAI,UAAU,CAAC,CAAC;IAC9C,IAAI,CAAC,EAAE;QAAE,EAAE,GAAG,UAAU,CAAC;IACzB,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,KAAK,IAAI,CAAC,CAAC;QACX,SAAS,GAAG,GAAG,EAAE,IAAI,KAAK,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAqB;IACtD,MAAM,GAAG,GAAG,WAAW;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;SACvC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAClD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,WAAW,GAAG,GAAG,CAAC,EAAE,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YACzD,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QACtD,CAAC;QACD,MAAM,GAAG,GAAG,MAAqD,CAAC;QAClE,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,MAAM,KAAK,GAA6B,EAAE,CAAC;QAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;gBACxE,SAAS;YACX,CAAC;YACD,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAA4B,CAAC;YAC1D,MAAM,KAAK,GAA2B;gBACpC,EAAE,EAAE,QAAQ,CAAC,EAAY;gBACzB,uBAAuB,EAAE,OAAO,QAAQ,CAAC,uBAAuB,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAAC,SAAS;gBAC5H,0BAA0B,EAAE,OAAO,QAAQ,CAAC,0BAA0B,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC,CAAC,SAAS;aACtI,CAAC;YACF,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;gBACxE,SAAS;YACX,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;QACD,OAAO;YACL,OAAO,EAAE,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;YACxE,UAAU,EAAE,KAAK;SAClB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,IAAI,GAAI,GAA6B,EAAE,IAAI,CAAC;QAClD,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAC3E,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5D,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IACtD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,IAAiC;IAEjC,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,GAAG,IAAI,QAAQ,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IAC5C,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACjE,MAAM,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAA6B;IACzD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,+DAA+D,EAAE,CAAC;IACtH,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,uBAAuB,KAAK,QAAQ,IAAI,KAAK,CAAC,uBAAuB,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9G,MAAM,UAAU,GAAG,OAAO,KAAK,CAAC,0BAA0B,KAAK,QAAQ,CAAC;IACxE,IAAI,OAAO,IAAI,UAAU;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,8EAA8E,EAAE,CAAC;IACvI,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,+DAA+D,EAAE,CAAC;IAC1H,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,QAAqC,EAAE,EAAU;IACrE,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACtD,CAAC"}

package/dist/runtime/trading-strategy-config.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-export trading strategy config types from the Zod schema.
+ */
+export type { TradingStrategyConfig, TradingStrategyStrategy, TradingStrategyScanner, TradingStrategyAction, TradingStrategyExit, } from "./trading-strategy-schema.js";
+export { tradingStrategyConfigSchema } from "./trading-strategy-schema.js";
+//# sourceMappingURL=trading-strategy-config.d.ts.map

package/dist/runtime/trading-strategy-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trading-strategy-config.d.ts","sourceRoot":"","sources":["../../src/runtime/trading-strategy-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/runtime/trading-strategy-config.js

@@ -0,0 +1,5 @@
+/**
+ * Re-export trading strategy config types from the Zod schema.
+ */
+export { tradingStrategyConfigSchema } from "./trading-strategy-schema.js";
+//# sourceMappingURL=trading-strategy-config.js.map

package/dist/runtime/trading-strategy-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trading-strategy-config.js","sourceRoot":"","sources":["../../src/runtime/trading-strategy-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC"}