@senpi/trading-runtime 1.0.0

package/dist/runtime/map-exit-config.js

@@ -0,0 +1,89 @@
+/**
+ * Map trading strategy exit (dsl_presets or dsl) to DSL plugin ExitBlockConfig.
+ * Prefers exit.dsl_presets; falls back to exit.dsl. Passes engine and interval_seconds.
+ */
+function deriveMaxLossPct(preset) {
+    const n = preset.max_loss_pct;
+    if (typeof n === "number" && n > 0)
+        return n;
+    const phase1 = preset.phase1;
+    if (phase1 && typeof phase1.max_loss_pct === "number" && phase1.max_loss_pct > 0) {
+        return phase1.max_loss_pct;
+    }
+    const tiers = preset.tiers;
+    if (Array.isArray(tiers) && tiers.length > 0 && typeof tiers[0].lock_pct === "number") {
+        return Number(tiers[0].lock_pct);
+    }
+    return undefined;
+}
+function buildPreset(name, rawObj, source) {
+    const preset = {};
+    if (Array.isArray(rawObj.tiers)) {
+        preset.tiers = rawObj.tiers.map((t) => ({
+            trigger_pct: t.trigger_pct,
+            triggerPct: t.triggerPct,
+            lock_pct: t.lock_pct,
+            lockPct: t.lockPct,
+            breaches: t.breaches,
+            retrace: t.retrace,
+        }));
+    }
+    const maxLoss = deriveMaxLossPct(rawObj);
+    if (maxLoss == null || !(maxLoss > 0)) {
+        throw new Error(`exit.${source}.${name}: max_loss_pct is required or must be derivable from preset.max_loss_pct, preset.phase1.max_loss_pct, or preset.tiers[].lock_pct`);
+    }
+    preset.max_loss_pct = maxLoss;
+    if (rawObj.phase1 && typeof rawObj.phase1 === "object") {
+        const phase1 = rawObj.phase1;
+        preset.phase1 = {
+            consecutive_breaches_required: phase1.consecutive_breaches_required,
+            consecutiveBreachesRequired: phase1.consecutiveBreachesRequired,
+            max_loss_pct: phase1.max_loss_pct,
+        };
+    }
+    if (typeof rawObj.phase2_trigger_tier === "number") {
+        preset.phase2_trigger_tier = rawObj.phase2_trigger_tier;
+    }
+    if (rawObj.phase2 && typeof rawObj.phase2 === "object") {
+        const p2 = rawObj.phase2;
+        preset.phase2 = {
+            retrace_threshold: p2.retrace_threshold,
+            retraceThreshold: p2.retraceThreshold,
+            retrace_from_hw: p2.retrace_from_hw,
+            consecutive_breaches_required: p2.consecutive_breaches_required,
+            consecutiveBreachesRequired: p2.consecutiveBreachesRequired,
+            tiers: Array.isArray(p2.tiers) ? p2.tiers : undefined,
+        };
+        if (preset.phase2.retrace_from_hw != null && preset.phase2.retrace_threshold == null) {
+            preset.phase2.retrace_threshold = preset.phase2.retrace_from_hw;
+        }
+    }
+    return preset;
+}
+/**
+ * Adapt playbook exit to ExitBlockConfig for parseDslPluginConfig.
+ * Uses exit.dsl_presets if present, else exit.dsl. Passes exit.interval_seconds and exit.engine.
+ */
+export function mapTradingStrategyExitToDslConfig(exit) {
+    const presetsSource = exit?.dsl_presets ?? exit?.dsl;
+    const sourceKey = exit?.dsl_presets != null ? "dsl_presets" : "dsl";
+    if (!presetsSource || typeof presetsSource !== "object") {
+        return {
+            interval_seconds: exit?.interval_seconds ?? 30,
+            ...(exit?.engine != null && { engine: exit.engine }),
+            dsl_presets: {},
+        };
+    }
+    const dsl_presets = {};
+    for (const [name, raw] of Object.entries(presetsSource)) {
+        if (!raw || typeof raw !== "object")
+            continue;
+        dsl_presets[name] = buildPreset(name, raw, sourceKey);
+    }
+    return {
+        interval_seconds: exit?.interval_seconds ?? 30,
+        ...(exit?.engine != null && { engine: exit.engine }),
+        dsl_presets: dsl_presets,
+    };
+}
+//# sourceMappingURL=map-exit-config.js.map

package/dist/runtime/map-exit-config.js.map

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

package/dist/runtime/map-strategies-registration.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Map skills.strategies to StrategyRegistration[] with scannerOverrides (interval, config).
+ * One registration per strategy; id = wallet, name = strategy key.
+ */
+import type { StrategyRegistration } from "../scanners/types.js";
+import type { TradingStrategyConfig } from "./trading-strategy-schema.js";
+/**
+ * Convert skills.strategies to StrategyRegistration[] for the scanner runtime module.
+ * One entry per strategy; id is resolved wallet, name is strategy key (e.g. aggressive-momentum).
+ */
+export declare function mapStrategiesToScannerRegistration(config: TradingStrategyConfig): StrategyRegistration[];
+//# sourceMappingURL=map-strategies-registration.d.ts.map

package/dist/runtime/map-strategies-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-strategies-registration.d.ts","sourceRoot":"","sources":["../../src/runtime/map-strategies-registration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAyB1E;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,qBAAqB,GAAG,oBAAoB,EAAE,CAiBxG"}

package/dist/runtime/map-strategies-registration.js

@@ -0,0 +1,52 @@
+/**
+ * Map skills.strategies to StrategyRegistration[] with scannerOverrides (interval, config).
+ * One registration per strategy; id = wallet, name = strategy key.
+ */
+import { parseInterval } from "./parse-interval.js";
+function buildScannerOverrides(config) {
+    const scanners = config.scanners ?? [];
+    const overrides = {};
+    for (const sc of scanners) {
+        const entry = {};
+        if (sc.interval) {
+            try {
+                entry.intervalSeconds = parseInterval(sc.interval);
+            }
+            catch {
+                // leave unset if parse fails
+            }
+        }
+        if (sc.config !== undefined) {
+            entry.config = sc.config;
+        }
+        if (Object.keys(entry).length > 0) {
+            overrides[sc.name] = entry;
+        }
+    }
+    return Object.keys(overrides).length > 0 ? overrides : undefined;
+}
+/**
+ * Convert skills.strategies to StrategyRegistration[] for the scanner runtime module.
+ * One entry per strategy; id is resolved wallet, name is strategy key (e.g. aggressive-momentum).
+ */
+export function mapStrategiesToScannerRegistration(config) {
+    const strategies = config.strategies;
+    const registrations = [];
+    if (!strategies || typeof strategies !== "object")
+        return registrations;
+    const scannerOverrides = buildScannerOverrides(config);
+    for (const [strategyName, entry] of Object.entries(strategies)) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        const id = typeof entry.wallet === "string" ? entry.wallet.trim() : "";
+        if (!id)
+            continue;
+        registrations.push({
+            id,
+            name: strategyName,
+            scannerOverrides,
+        });
+    }
+    return registrations;
+}
+//# sourceMappingURL=map-strategies-registration.js.map

package/dist/runtime/map-strategies-registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-strategies-registration.js","sourceRoot":"","sources":["../../src/runtime/map-strategies-registration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,SAAS,qBAAqB,CAAC,MAA6B;IAC1D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IACvC,MAAM,SAAS,GAAmE,EAAE,CAAC;IACrF,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAmD,EAAE,CAAC;QACjE,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,KAAK,CAAC,eAAe,GAAG,aAAa,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;YACrD,CAAC;YAAC,MAAM,CAAC;gBACP,6BAA6B;YAC/B,CAAC;QACH,CAAC;QACD,IAAI,EAAE,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC5B,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;QAC3B,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kCAAkC,CAAC,MAA6B;IAC9E,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,MAAM,aAAa,GAA2B,EAAE,CAAC;IACjD,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC;IAExE,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACvD,KAAK,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/D,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QAClD,MAAM,EAAE,GAAG,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,IAAI,CAAC,EAAE;YAAE,SAAS;QAClB,aAAa,CAAC,IAAI,CAAC;YACjB,EAAE;YACF,IAAI,EAAE,YAAY;YAClB,gBAAgB;SACjB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * Map skills strategies (keyed record) to Map<address, StrategyConfig>.
+ * Address = wallet (env-resolved). Coerces budget and numeric fields from strings.
+ */
+import type { StrategyConfig } from "../types/strategy.js";
+import type { TradingStrategyConfig } from "./trading-strategy-schema.js";
+/**
+ * Convert skills.strategies to a Map of address (wallet) → StrategyConfig.
+ * One entry per strategy; key is resolved wallet so runtime/state stay per-wallet.
+ */
+export declare function mapStrategiesToConfig(config: TradingStrategyConfig): Map<string, StrategyConfig>;
+//# sourceMappingURL=map-strategies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"map-strategies.d.ts","sourceRoot":"","sources":["../../src/runtime/map-strategies.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAW1E;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAuBhG"}

package/dist/runtime/map-strategies.js

@@ -0,0 +1,46 @@
+/**
+ * Map skills strategies (keyed record) to Map<address, StrategyConfig>.
+ * Address = wallet (env-resolved). Coerces budget and numeric fields from strings.
+ */
+function coerceNumber(v) {
+    if (typeof v === "number" && Number.isFinite(v))
+        return v;
+    if (typeof v === "string") {
+        const n = Number(v);
+        if (Number.isFinite(n))
+            return n;
+    }
+    return 0;
+}
+/**
+ * Convert skills.strategies to a Map of address (wallet) → StrategyConfig.
+ * One entry per strategy; key is resolved wallet so runtime/state stay per-wallet.
+ */
+export function mapStrategiesToConfig(config) {
+    const map = new Map();
+    const strategies = config.strategies;
+    if (!strategies || typeof strategies !== "object")
+        return map;
+    for (const [_name, entry] of Object.entries(strategies)) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        const address = typeof entry.wallet === "string" ? entry.wallet.trim() : "";
+        if (!address)
+            continue;
+        const config = {
+            address,
+            budget: coerceNumber(entry.budget),
+            slots: coerceNumber(entry.slots) || 1,
+            tradingRisk: typeof entry.trading_risk === "string" ? entry.trading_risk : "",
+        };
+        if (typeof entry.margin_per_slot === "number" || (typeof entry.margin_per_slot === "string" && entry.margin_per_slot !== "")) {
+            config.marginPerSlot = coerceNumber(entry.margin_per_slot);
+        }
+        if (typeof entry.enabled === "boolean") {
+            config.enabled = entry.enabled;
+        }
+        map.set(address, config);
+    }
+    return map;
+}
+//# sourceMappingURL=map-strategies.js.map

package/dist/runtime/map-strategies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-strategies.js","sourceRoot":"","sources":["../../src/runtime/map-strategies.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,SAAS,YAAY,CAAC,CAAU;IAC9B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1D,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA6B;IACjE,MAAM,GAAG,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAC9D,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QAClD,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,MAAM,MAAM,GAAmB;YAC7B,OAAO;YACP,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC;YAClC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;YACrC,WAAW,EAAE,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE;SAC9E,CAAC;QACF,IAAI,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ,IAAI,CAAC,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ,IAAI,KAAK,CAAC,eAAe,KAAK,EAAE,CAAC,EAAE,CAAC;YAC7H,MAAM,CAAC,aAAa,GAAG,YAAY,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QACjC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/runtime/notifications.d.ts

@@ -0,0 +1,10 @@
+/**
+ * NotificationService: log and/or call notification API (stub logs only).
+ */
+import type { NotificationService } from "../types/notification.js";
+export interface NotificationServiceOptions {
+    telegram_chat_id?: string;
+    [key: string]: unknown;
+}
+export declare function createNotificationService(_options?: NotificationServiceOptions): NotificationService;
+//# sourceMappingURL=notifications.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/runtime/notifications.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,CAAC,EAAE,0BAA0B,GAAG,mBAAmB,CASpG"}

package/dist/runtime/notifications.js

@@ -0,0 +1,14 @@
+/**
+ * NotificationService: log and/or call notification API (stub logs only).
+ */
+export function createNotificationService(_options) {
+    return {
+        async notify(message) {
+            // Stub: log only; extend to call Telegram etc. when config present
+            if (typeof message === "string" && message.length > 0) {
+                console.log("[Notification]", message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=notifications.js.map

package/dist/runtime/notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../../src/runtime/notifications.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,MAAM,UAAU,yBAAyB,CAAC,QAAqC;IAC7E,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,OAAe;YAC1B,mEAAmE;YACnE,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtD,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime/parse-interval.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Parse interval strings (e.g. "500ms", "30s", "3m", "1h") to seconds.
+ */
+/**
+ * Parse an interval string to seconds.
+ * Supports: Nms, Ns, Nm, Nh (e.g. "500ms" → 0.5, "30s" → 30, "3m" → 180, "1h" → 3600).
+ * Returns the value in seconds (fractional for ms).
+ * @throws if the string does not match the expected format
+ */
+export declare function parseInterval(s: string): number;
+//# sourceMappingURL=parse-interval.d.ts.map

package/dist/runtime/parse-interval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-interval.d.ts","sourceRoot":"","sources":["../../src/runtime/parse-interval.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAyB/C"}

package/dist/runtime/parse-interval.js

@@ -0,0 +1,35 @@
+/**
+ * Parse interval strings (e.g. "500ms", "30s", "3m", "1h") to seconds.
+ */
+const INTERVAL_REGEX = /^(\d+(?:\.\d+)?)\s*(ms|s|m|h)$/i;
+/**
+ * Parse an interval string to seconds.
+ * Supports: Nms, Ns, Nm, Nh (e.g. "500ms" → 0.5, "30s" → 30, "3m" → 180, "1h" → 3600).
+ * Returns the value in seconds (fractional for ms).
+ * @throws if the string does not match the expected format
+ */
+export function parseInterval(s) {
+    const trimmed = String(s).trim();
+    const match = trimmed.match(INTERVAL_REGEX);
+    if (!match) {
+        throw new Error(`Invalid interval "${s}": expected format like 500ms, 30s, 3m, 1h`);
+    }
+    const value = Number(match[1]);
+    const unit = match[2].toLowerCase();
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`Invalid interval "${s}": value must be a positive number`);
+    }
+    switch (unit) {
+        case "ms":
+            return value / 1000;
+        case "s":
+            return value;
+        case "m":
+            return value * 60;
+        case "h":
+            return value * 3600;
+        default:
+            throw new Error(`Invalid interval unit "${unit}" in "${s}"`);
+    }
+}
+//# sourceMappingURL=parse-interval.js.map

package/dist/runtime/parse-interval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-interval.js","sourceRoot":"","sources":["../../src/runtime/parse-interval.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,cAAc,GAAG,iCAAiC,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS;IACrC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,qBAAqB,CAAC,4CAA4C,CACnE,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,oCAAoC,CAAC,CAAC;IAC9E,CAAC;IACD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,IAAI;YACP,OAAO,KAAK,GAAG,IAAI,CAAC;QACtB,KAAK,GAAG;YACN,OAAO,KAAK,CAAC;QACf,KAAK,GAAG;YACN,OAAO,KAAK,GAAG,EAAE,CAAC;QACpB,KAAK,GAAG;YACN,OAAO,KAAK,GAAG,IAAI,CAAC;QACtB;YACE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/runtime/reconcile-state.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 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 type { StateManager } from "../state/index.js";
+import type { SenpiClient } from "../senpi/client.js";
+import type { StrategyConfig } from "../types/strategy.js";
+import type { SenpiEventBus } from "../types/event-bus.js";
+export interface ReconcileOptions {
+    /** If provided, emit POSITION_CLOSED when a position is archived (e.g. from DSL monitor). */
+    bus?: SenpiEventBus;
+}
+/**
+ * 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 declare function reconcileStateWithBackend(stateManager: StateManager, senpi: SenpiClient, addressesOrStrategiesMap: string[] | Map<string, StrategyConfig>, options?: ReconcileOptions): Promise<void>;
+//# sourceMappingURL=reconcile-state.d.ts.map

package/dist/runtime/reconcile-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-state.d.ts","sourceRoot":"","sources":["../../src/runtime/reconcile-state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AA8B3D,MAAM,WAAW,gBAAgB;IAC/B,6FAA6F;IAC7F,GAAG,CAAC,EAAE,aAAa,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,WAAW,EAClB,wBAAwB,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EAChE,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC,CA0Ef"}

package/dist/runtime/reconcile-state.js

@@ -0,0 +1,114 @@
+/**
+ * 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;
+    logger.debug("reconcile begin", { addresses, count: addresses.length });
+    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 });
+        }
+    }
+    logger.debug("reconcile complete", { dslKeysChecked: dslKeys.length });
+}
+//# 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;AAQjF,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,CA8BxB"}

package/dist/runtime/run.js

@@ -0,0 +1,43 @@
+/**
+ * Programmatic entry: load trading strategy and start runtime. Returns handle with stop().
+ */
+import { createLogger } from "../utils/logger.js";
+import { getDefaultStateDir } from "./default-state-dir.js";
+import { loadTradingStrategy } from "./load-trading-strategy.js";
+import { Runtime } from "./runtime.js";
+const logger = createLogger("[senpi-core][run]");
+/**
+ * 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) {
+    logger.debug("run() begin", { fromPath: options?.fromPath, hasStateDir: !!options?.stateDir });
+    const fromPath = options?.fromPath === true;
+    const config = await loadTradingStrategy(strategyPathOrContent, { fromPath });
+    logger.debug("run() trading strategy loaded", { name: config.name, scannersCount: config.scanners?.length ?? 0, actionsCount: config.actions?.length ?? 0 });
+    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,
+    });
+    logger.debug("run() runtime created, starting", { stateDir });
+    await runtime.start();
+    logger.debug("run() runtime started, returning handle");
+    return {
+        async stop() {
+            logger.debug("run() handle.stop() called");
+            await runtime.stop();
+            logger.debug("run() handle.stop() complete");
+        },
+    };
+}
+//# 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,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,MAAM,GAAG,YAAY,CAAC,mBAAmB,CAAC,CAAC;AAcjD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,qBAA6B,EAC7B,OAAoB;IAEpB,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/F,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,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7J,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,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9D,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACtB,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACxD,OAAO;QACL,KAAK,CAAC,IAAI;YACR,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAC3C,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC/C,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