@senpi/runtime 1.0.95-dev.20260408174401

package/dist/runtime/load-runtime-config.js

@@ -0,0 +1,176 @@
+/**
+ * Load and validate trading recipe YAML. Resolves env vars and validates with Zod.
+ * SECURITY: Do not log the resolved config or pathOrContent; they may contain
+ * secrets substituted from environment variables.
+ */
+import { readFile } from "node:fs/promises";
+import { parse } from "yaml";
+import { ZodIssueCode } from "zod";
+import { DslConfigValidationError, parseDslPluginConfig } from "../dsl/config/index.js";
+import { runtimeConfigSchema } from "./runtime-schema.js";
+import { resolveEnvInObject } from "./env-resolve.js";
+import { mapRuntimeExitToDslConfig } from "./map-exit-config.js";
+import { CURRENT_RUNTIME_VERSION, SUPPORTED_RUNTIME_VERSIONS, extractMajorVersion } from "./runtime-version.js";
+/**
+ * Minimal valid YAML structure shown in validation errors so users can fix their file.
+ * Keep this in sync with runtimeConfigSchema (name + strategy with wallet).
+ */
+export const MINIMAL_RECIPE_YAML_SAMPLE = `# Required: name and a strategy with a wallet
+name: my-recipe
+# version: 1  # optional; defaults to current (1). Supports integer or semver string.
+strategy:
+  wallet: "your-wallet-address"
+  # optional: budget, slots, enabled, etc.
+
+# Optional: scanners, actions, exit. Run: openclaw senpi guide examples
+`;
+const HINTS = [
+    {
+        pathMatch: /\.context(\.|$)/,
+        messageMatch: /Expected object|Required|Invalid discriminator value|Invalid input/,
+        hint: "Each context entry must match one supported shape. Supported built-in types are signal, context, strategy, and asset-trend. Scanner-derived entries use scanner: '...' and must reference a scanner name from your scanners block; strategy and asset-trend entries use value: '...'.",
+    },
+    {
+        pathMatch: /^strategy\.wallet$|\.strategy\.wallet$/,
+        messageMatch: /Expected string|Required|min/,
+        hint: "strategy must have wallet as a string (e.g. wallet: \"0x...\" or wallet: \"your-address\").",
+    },
+    {
+        pathMatch: /\.scanners(\.\d+)?(\.|$)/,
+        messageMatch: /Expected array|Expected string|Required/,
+        hint: "In an action, scanners must be an array of scanner names from your scanners block (e.g. scanners: [emerging_movers]). Use the configured scanner name, not the built-in scanner type.",
+    },
+    {
+        pathMatch: /^scanners\.\d+/,
+        messageMatch: /Required|Expected/,
+        hint: "Each scanner must have 'name' and 'type'; 'interval' is optional (e.g. interval: 20s). Dependencies and action context entries reference the configured scanner name (for example market_regime), not the built-in scanner type or internal definition id.",
+    },
+    {
+        pathMatch: /^name$|^name\./,
+        messageMatch: /Required|Expected string/,
+        hint: "Top-level 'name' is required and must be a non-empty string (e.g. name: my-recipe).",
+    },
+    {
+        pathMatch: /^exit\.|\.exit\.|dsl_preset/,
+        messageMatch: /required|Expected|derivable/,
+        hint: "exit.dsl_preset (object): max_loss_pct in phase1 or preset root; tiers use lock_hw_pct. Run: openclaw senpi guide exit",
+    },
+    {
+        pathMatch: /^actions\.\d+\./,
+        messageMatch: /Required|Expected/,
+        hint: "Each action must have name, action_type (e.g. OPEN_POSITION), and for LLM decisions: decision_mode, decision_model, scanners, min_confidence. Scanner-derived context entries use 'scanner', not 'value'.",
+    },
+];
+/**
+ * Turn a path like ["actions", 0, "context", 0] into a readable label (e.g. "actions.0.context.0").
+ */
+function formatPath(path) {
+    if (path.length === 0)
+        return "root";
+    return path.join(".");
+}
+/**
+ * Return a clearer message for known validation paths; otherwise return the original.
+ */
+function clarifyMessage(issue) {
+    const path = issue.path;
+    const message = issue.message;
+    const pathStr = path.length > 0 ? path.join(".") : "root";
+    if (pathStr.endsWith(".type") &&
+        pathStr.includes(".context.") &&
+        issue.code === ZodIssueCode.invalid_union_discriminator) {
+        return "Unsupported action context type. Supported built-in types are 'signal', 'context', 'strategy', and 'asset-trend'. Scanner-derived entries use 'scanner' and reference a configured scanner name; strategy and asset-trend entries use 'value'.";
+    }
+    for (const { pathMatch, messageMatch, hint } of HINTS) {
+        if (pathMatch.test(pathStr) && messageMatch.test(message)) {
+            return `${message}. ${hint}`;
+        }
+    }
+    return message;
+}
+/**
+ * Format ZodError into a readable, path-based message and append a minimal YAML sample.
+ */
+function formatZodError(message, issues) {
+    if (issues.length === 0)
+        return message;
+    const lines = issues.map((i) => {
+        const pathLabel = formatPath(i.path);
+        const msg = clarifyMessage(i);
+        return `  • ${pathLabel}: ${msg}`;
+    });
+    const pathTip = "Tip: Paths use dot notation; a number is the 0-based index (e.g. strategy.wallet = wallet address, actions.0 = first action).";
+    return `${message}\n${lines.join("\n")}\n\n${pathTip}\n\nExample of required structure:\n${MINIMAL_RECIPE_YAML_SAMPLE}`;
+}
+/**
+ * Load trading recipe from a file path or YAML string.
+ * - If fromPath is true, pathOrContent is a file path.
+ * - Otherwise pathOrContent is the YAML string.
+ * After parse, env vars are resolved and the result is validated with the Zod schema.
+ * Throws with path-based error messages on validation failure.
+ */
+export async function loadRuntimeConfig(pathOrContent, options) {
+    const fromPath = options?.fromPath === true;
+    let raw;
+    try {
+        if (fromPath) {
+            const content = await readFile(pathOrContent, "utf-8");
+            raw = parse(content);
+        }
+        else {
+            raw = parse(pathOrContent);
+        }
+    }
+    catch (parseErr) {
+        const detail = parseErr instanceof Error ? parseErr.message : String(parseErr);
+        throw new Error(`Invalid YAML syntax. Please check indentation, colons, and quotes.\nDetails: ${detail}\n\nExample of valid structure:\n${MINIMAL_RECIPE_YAML_SAMPLE}`);
+    }
+    if (raw === null || raw === undefined || typeof raw !== "object") {
+        throw new Error("The YAML file must define an object (e.g. name and strategy at the top level).\n\nExample of required structure:\n" +
+            MINIMAL_RECIPE_YAML_SAMPLE);
+    }
+    const resolved = resolveEnvInObject(raw);
+    if ("strategies" in resolved) {
+        throw new Error("'strategies' (plural) is no longer supported. Use 'strategy' (singular) with a single wallet.\n" +
+            "See: openclaw senpi guide schema\n\n" +
+            "Example of required structure:\n" +
+            MINIMAL_RECIPE_YAML_SAMPLE);
+    }
+    const result = runtimeConfigSchema.safeParse(resolved);
+    if (result.success) {
+        const cfg = result.data;
+        const major = extractMajorVersion(cfg.version);
+        if (!SUPPORTED_RUNTIME_VERSIONS.includes(major)) {
+            throw new Error(`Unsupported version: ${cfg.version ?? "(none)"} (major: ${major}). Supported major versions: ${SUPPORTED_RUNTIME_VERSIONS.join(", ")}.\n` +
+                `Omit version to use the current default (${CURRENT_RUNTIME_VERSION}).`);
+        }
+        const exit = cfg.exit;
+        if (exit && typeof exit === "object") {
+            const dslPreset = exit.dsl_preset;
+            if (dslPreset != null &&
+                typeof dslPreset === "object" &&
+                !Array.isArray(dslPreset)) {
+                try {
+                    parseDslPluginConfig(mapRuntimeExitToDslConfig(exit));
+                }
+                catch (err) {
+                    const detail = err instanceof DslConfigValidationError
+                        ? err.issues.map((i) => `  • ${i.path}: ${i.message} (${i.code})`).join("\n")
+                        : err instanceof Error
+                            ? err.message
+                            : String(err);
+                    throw new Error(`exit / DSL preset validation failed:\n${detail}\n\nRun: openclaw senpi guide exit\n\nExample of required structure:\n${MINIMAL_RECIPE_YAML_SAMPLE}`);
+                }
+            }
+        }
+        return cfg;
+    }
+    const err = result.error;
+    const message = formatZodError("Trading recipe validation failed:", err.issues.map((issue) => ({
+        code: issue.code,
+        path: issue.path,
+        message: issue.message,
+    })));
+    throw new Error(message);
+}
+//# sourceMappingURL=load-runtime-config.js.map

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

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

package/dist/runtime/map-exit-config.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Map trading recipe exit to DSL plugin ExitBlockConfig (single exit.dsl_preset only).
+ */
+import type { ExitBlockConfig } from "../dsl/config/index.js";
+import type { RuntimeExit } from "./runtime-schema.js";
+/**
+ * Adapt playbook exit to ExitBlockConfig for parseDslPluginConfig.
+ * Only `exit.dsl_preset` is supported; passes exit.interval_seconds and exit.engine.
+ */
+export declare function mapRuntimeExitToDslConfig(exit: RuntimeExit | undefined): ExitBlockConfig;
+//# sourceMappingURL=map-exit-config.d.ts.map

package/dist/runtime/map-exit-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-exit-config.d.ts","sourceRoot":"","sources":["../../src/runtime/map-exit-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AA4FvD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,eAAe,CAoBxF"}

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

@@ -0,0 +1,86 @@
+/**
+ * Map trading recipe exit to DSL plugin ExitBlockConfig (single exit.dsl_preset only).
+ */
+import { validateRawExitBlockAndPresetsUnknownKeys } from "../dsl/config/unknown-keys.js";
+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;
+    }
+    return undefined;
+}
+function buildPreset(rawObj) {
+    const preset = {};
+    if (Array.isArray(rawObj.tiers)) {
+        preset.tiers = rawObj.tiers.map((t) => ({
+            trigger_pct: t.trigger_pct,
+            triggerPct: t.triggerPct,
+            lock_hw_pct: t.lock_hw_pct,
+            lockHwPct: t.lockHwPct,
+        }));
+    }
+    let maxLoss = deriveMaxLossPct(rawObj);
+    const phase1Raw = rawObj.phase1;
+    if ((maxLoss == null || !(maxLoss > 0)) && phase1Raw && phase1Raw.enabled === false) {
+        maxLoss = 1;
+    }
+    if (maxLoss == null || !(maxLoss > 0)) {
+        throw new Error("exit.dsl_preset: max_loss_pct is required or must be set in dsl_preset.max_loss_pct or dsl_preset.phase1.max_loss_pct. Run: openclaw senpi guide exit");
+    }
+    preset.max_loss_pct = maxLoss;
+    if (rawObj.phase1 && typeof rawObj.phase1 === "object") {
+        const phase1 = rawObj.phase1;
+        preset.phase1 = {
+            ...(typeof phase1.enabled === "boolean" ? { enabled: phase1.enabled } : {}),
+            consecutive_breaches_required: phase1.consecutive_breaches_required,
+            consecutiveBreachesRequired: phase1.consecutiveBreachesRequired,
+            max_loss_pct: phase1.max_loss_pct,
+            retrace_threshold: phase1.retrace_threshold,
+            retraceThreshold: phase1.retraceThreshold,
+        };
+    }
+    if (rawObj.phase2 && typeof rawObj.phase2 === "object") {
+        const p2 = rawObj.phase2;
+        preset.phase2 = {
+            ...(typeof p2.enabled === "boolean" ? { enabled: p2.enabled } : {}),
+            tiers: Array.isArray(p2.tiers) ? p2.tiers : undefined,
+        };
+    }
+    if (rawObj.hard_timeout && typeof rawObj.hard_timeout === "object") {
+        preset.hard_timeout = rawObj.hard_timeout;
+    }
+    if (rawObj.weak_peak_cut && typeof rawObj.weak_peak_cut === "object") {
+        preset.weak_peak_cut = rawObj.weak_peak_cut;
+    }
+    if (rawObj.dead_weight_cut && typeof rawObj.dead_weight_cut === "object") {
+        preset.dead_weight_cut = rawObj.dead_weight_cut;
+    }
+    return preset;
+}
+/**
+ * Adapt playbook exit to ExitBlockConfig for parseDslPluginConfig.
+ * Only `exit.dsl_preset` is supported; passes exit.interval_seconds and exit.engine.
+ */
+export function mapRuntimeExitToDslConfig(exit) {
+    if (exit != null && typeof exit === "object") {
+        validateRawExitBlockAndPresetsUnknownKeys(exit);
+    }
+    const rawExit = exit;
+    const dslPresetSingle = rawExit?.dsl_preset;
+    if (dslPresetSingle != null && typeof dslPresetSingle === "object" && !Array.isArray(dslPresetSingle)) {
+        const built = buildPreset(dslPresetSingle);
+        return {
+            interval_seconds: exit?.interval_seconds ?? 30,
+            ...(exit?.engine != null && { engine: exit.engine }),
+            dsl_preset: built,
+        };
+    }
+    return {
+        interval_seconds: exit?.interval_seconds ?? 30,
+        ...(exit?.engine != null && { engine: exit.engine }),
+    };
+}
+//# 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,14 @@
+/**
+ * Resolve recipe `strategy` to a single StrategyRegistration for the scanner module.
+ */
+import type { StrategyRegistration } from "../scanners/types.js";
+import type { RuntimeConfig } from "./runtime-schema.js";
+/**
+ * Resolve config.strategy to a single StrategyRegistration for the scanner runtime module.
+ * id is resolved wallet; name is the recipe name (config.name).
+ * Throws if wallet is missing.
+ */
+export declare function resolveStrategyRegistration(config: RuntimeConfig): StrategyRegistration;
+/** @deprecated Use resolveStrategyRegistration instead. */
+export declare function mapStrategiesToScannerRegistration(config: RuntimeConfig): 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;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAyBzD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,aAAa,GAAG,oBAAoB,CAMvF;AAED,2DAA2D;AAC3D,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,aAAa,GAAG,oBAAoB,EAAE,CAEhG"}

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

@@ -0,0 +1,44 @@
+/**
+ * Resolve recipe `strategy` to a single StrategyRegistration for the scanner module.
+ */
+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;
+}
+/**
+ * Resolve config.strategy to a single StrategyRegistration for the scanner runtime module.
+ * id is resolved wallet; name is the recipe name (config.name).
+ * Throws if wallet is missing.
+ */
+export function resolveStrategyRegistration(config) {
+    const entry = config.strategy;
+    const id = typeof entry.wallet === "string" ? entry.wallet.trim() : "";
+    if (!id)
+        throw new Error("strategy.wallet is required");
+    const scannerOverrides = buildScannerOverrides(config);
+    return { id, name: config.name, scannerOverrides };
+}
+/** @deprecated Use resolveStrategyRegistration instead. */
+export function mapStrategiesToScannerRegistration(config) {
+    return [resolveStrategyRegistration(config)];
+}
+//# 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;;GAEG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,SAAS,qBAAqB,CAAC,MAAqB;IAClD,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;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAqB;IAC/D,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC9B,MAAM,EAAE,GAAG,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACxD,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACvD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE,CAAC;AACrD,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,kCAAkC,CAAC,MAAqB;IACtE,OAAO,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/C,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * Resolve recipe `strategy` to a single StrategyConfig.
+ * Address = wallet (env-resolved). Coerces budget and numeric fields from strings.
+ */
+import type { StrategyConfig } from "../types/strategy.js";
+import type { RuntimeConfig } from "./runtime-schema.js";
+/**
+ * Resolve config.strategy to a single StrategyConfig.
+ * Throws if wallet is missing (schema already enforces this, but guards against runtime misuse).
+ */
+export declare function resolveStrategyConfig(recipeConfig: RuntimeConfig): StrategyConfig;
+/** @deprecated Use resolveStrategyConfig instead. */
+export declare function mapStrategiesToConfig(recipeConfig: RuntimeConfig): 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;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAazD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,aAAa,GAAG,cAAc,CAsCjF;AAED,qDAAqD;AACrD,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAG9F"}

package/dist/runtime/map-strategies.js

@@ -0,0 +1,64 @@
+/**
+ * Resolve recipe `strategy` to a single StrategyConfig.
+ * Address = wallet (env-resolved). Coerces budget and numeric fields from strings.
+ */
+const VALID_TRADING_RISKS = ['conservative', 'moderate', 'aggressive'];
+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;
+}
+/**
+ * Resolve config.strategy to a single StrategyConfig.
+ * Throws if wallet is missing (schema already enforces this, but guards against runtime misuse).
+ */
+export function resolveStrategyConfig(recipeConfig) {
+    const entry = recipeConfig.strategy;
+    const address = typeof entry.wallet === "string" ? entry.wallet.trim() : "";
+    if (!address) {
+        throw new Error("strategy.wallet is required");
+    }
+    const rawRisk = typeof entry.trading_risk === "string" ? entry.trading_risk : "";
+    const tradingRisk = VALID_TRADING_RISKS.includes(rawRisk)
+        ? rawRisk
+        : 'moderate';
+    const strategyConfig = {
+        address,
+        budget: coerceNumber(entry.budget),
+        slots: coerceNumber(entry.slots) || 1,
+        tradingRisk,
+    };
+    if (typeof entry.margin_per_slot === "number" || (typeof entry.margin_per_slot === "string" && entry.margin_per_slot !== "")) {
+        strategyConfig.marginPerSlot = coerceNumber(entry.margin_per_slot);
+    }
+    if (typeof entry.default_leverage === "number") {
+        strategyConfig.defaultLeverage = entry.default_leverage;
+    }
+    if (entry.leverage_multipliers != null && typeof entry.leverage_multipliers === "object") {
+        const lm = entry.leverage_multipliers;
+        const multipliers = {};
+        for (const key of VALID_TRADING_RISKS) {
+            if (typeof lm[key] === "number") {
+                multipliers[key] = lm[key];
+            }
+        }
+        if (Object.keys(multipliers).length > 0) {
+            strategyConfig.leverageMultipliers = multipliers;
+        }
+    }
+    if (typeof entry.enabled === "boolean") {
+        strategyConfig.enabled = entry.enabled;
+    }
+    return strategyConfig;
+}
+/** @deprecated Use resolveStrategyConfig instead. */
+export function mapStrategiesToConfig(recipeConfig) {
+    const config = resolveStrategyConfig(recipeConfig);
+    return new Map([[config.address, config]]);
+}
+//# 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":"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"}

package/dist/runtime/notifications.d.ts

@@ -0,0 +1,19 @@
+import type { McpTransport } from "../senpi/types.js";
+import type { NotificationService } from "../types/notification.js";
+export interface NotificationServiceOptions {
+    telegram_chat_id?: string;
+    mcpTransport?: McpTransport;
+    gateway_url?: string;
+    gateway_token?: string;
+    [key: string]: unknown;
+}
+export declare function formatDecisionErrorNotification(rawMessage: string): string;
+/**
+ * IMPORTANT: Do NOT use logger.error(...) anywhere inside this service.
+ * NotificationService is itself the Telegram delivery path for error notifications.
+ * Using logger.error here would trigger the error notifier hook recursively,
+ * which is blocked by the reentrancy guard (causing the notification to be silently dropped)
+ * or could cause unexpected feedback loops in future. Use logger.warn for all failure paths.
+ */
+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,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAKpE,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAO1E;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,mBAAmB,CAyEnG"}

package/dist/runtime/notifications.js

@@ -0,0 +1,88 @@
+import { createLogger } from "../utils/logger.js";
+const logger = createLogger("[senpi-core][notifications]");
+export function formatDecisionErrorNotification(rawMessage) {
+    const s = rawMessage;
+    if (/OpenClaw gateway error \(404\)/.test(s))
+        return "Senpi: OpenClaw gateway returned 404. Endpoint missing.";
+    if (/OpenClaw gateway error \(401\)|OpenClaw gateway error \(403\)/.test(s))
+        return "Senpi: OpenClaw gateway rejected (auth). Check OPENCLAW_GATEWAY_TOKEN.";
+    if (/OpenClaw gateway error \(5\d\d\)/.test(s))
+        return "Senpi: OpenClaw gateway error (5xx). Try again later.";
+    if (/gateway token not configured|OPENCLAW_GATEWAY_TOKEN/.test(s))
+        return "Senpi: OpenClaw gateway token not configured. Set OPENCLAW_GATEWAY_TOKEN.";
+    return `Senpi: Trading decision failed — ${s}`;
+}
+/**
+ * IMPORTANT: Do NOT use logger.error(...) anywhere inside this service.
+ * NotificationService is itself the Telegram delivery path for error notifications.
+ * Using logger.error here would trigger the error notifier hook recursively,
+ * which is blocked by the reentrancy guard (causing the notification to be silently dropped)
+ * or could cause unexpected feedback loops in future. Use logger.warn for all failure paths.
+ */
+export function createNotificationService(options) {
+    const chatId = typeof options?.telegram_chat_id === "string" ? options.telegram_chat_id.trim() : undefined;
+    const mcpTransport = options?.mcpTransport;
+    const gatewayUrl = options?.gateway_url || process.env.OPENCLAW_GATEWAY_URL || "http://127.0.0.1:18789";
+    const gatewayToken = options?.gateway_token || process.env.OPENCLAW_GATEWAY_TOKEN;
+    if (chatId) {
+        logger.info(`Notifications enabled for ${chatId}; routing via OpenClaw /tools/invoke`);
+    }
+    return {
+        async notify(message) {
+            if (typeof message !== "string" || message.length === 0)
+                return;
+            const preview = message.length > 120 ? message.slice(0, 120) + "…" : message;
+            logger.info("Notification service invoked", { messagePreview: preview });
+            if (!chatId) {
+                logger.warn("Notification not sent: no telegram_chat_id in runtime config.");
+                return;
+            }
+            // 1. Prefer MCP transport if host injects it in the future
+            if (mcpTransport) {
+                try {
+                    await mcpTransport("send_telegram_notification", { target: `telegram:${chatId}`, message });
+                    return;
+                }
+                catch (err) {
+                    logger.warn(`MCP transport failed: ${err instanceof Error ? err.message : String(err)}. Falling back to Gateway HTTP.`);
+                }
+            }
+            // 2. HTTP Gateway Tool Invocation (Matches your LLM Engine)
+            if (gatewayToken) {
+                try {
+                    const baseUrl = gatewayUrl.endsWith("/") ? gatewayUrl.slice(0, -1) : gatewayUrl;
+                    const res = await fetch(`${baseUrl}/tools/invoke`, {
+                        method: "POST",
+                        headers: {
+                            "Content-Type": "application/json",
+                            "Authorization": `Bearer ${gatewayToken}`
+                        },
+                        body: JSON.stringify({
+                            tool: "message",
+                            args: {
+                                action: "send",
+                                target: `telegram:${chatId}`,
+                                message: message,
+                            },
+                        })
+                    });
+                    if (!res.ok) {
+                        const errText = await res.text().catch(() => "No response body");
+                        throw new Error(`HTTP ${res.status}: ${errText}`);
+                    }
+                    const body = await res.json();
+                    if (!body.ok) {
+                        throw new Error(`Gateway rejected message tool: ${body.error ?? JSON.stringify(body)}`);
+                    }
+                    return;
+                }
+                catch (err) {
+                    logger.warn(`Gateway tool invocation failed: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                return;
+            }
+            logger.warn("Notification dropped: Missing OPENCLAW_GATEWAY_TOKEN in environment.");
+        },
+    };
+}
+//# 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":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,GAAG,YAAY,CAAC,6BAA6B,CAAC,CAAC;AAU3D,MAAM,UAAU,+BAA+B,CAAC,UAAkB;IAChE,MAAM,CAAC,GAAG,UAAU,CAAC;IACrB,IAAI,gCAAgC,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,yDAAyD,CAAC;IAC/G,IAAI,+DAA+D,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,wEAAwE,CAAC;IAC7J,IAAI,kCAAkC,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,uDAAuD,CAAC;IAC/G,IAAI,qDAAqD,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,2EAA2E,CAAC;IACtJ,OAAO,oCAAoC,CAAC,EAAE,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAoC;IAC5E,MAAM,MAAM,GAAG,OAAO,OAAO,EAAE,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3G,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;IAC3C,MAAM,UAAU,GAAG,OAAO,EAAE,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,wBAAwB,CAAC;IACxG,MAAM,YAAY,GAAG,OAAO,EAAE,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAElF,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,IAAI,CAAC,6BAA6B,MAAM,sCAAsC,CAAC,CAAC;IACzF,CAAC;IAED,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,OAAe;YAC1B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAEhE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;YAC7E,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC;YAEzE,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;gBAC7E,OAAO;YACT,CAAC;YAED,2DAA2D;YAC3D,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,CAAC;oBACH,MAAM,YAAY,CAAC,4BAA4B,EAAE,EAAE,MAAM,EAAE,YAAY,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;oBAC5F,OAAO;gBACT,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,IAAI,CAAC,yBAAyB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;gBAC1H,CAAC;YACH,CAAC;YAED,4DAA4D;YAC5D,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;oBAEhF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,eAAe,EAAE;wBACjD,MAAM,EAAE,MAAM;wBACd,OAAO,EAAE;4BACP,cAAc,EAAE,kBAAkB;4BAClC,eAAe,EAAE,UAAU,YAAY,EAAE;yBAC1C;wBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,IAAI,EAAE,SAAS;4BACf,IAAI,EAAE;gCACJ,MAAM,EAAE,MAAM;gCACd,MAAM,EAAE,YAAY,MAAM,EAAE;gCAC5B,OAAO,EAAE,OAAO;6BACjB;yBACF,CAAC;qBACH,CAAC,CAAC;oBAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;wBACZ,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,CAAC;wBACjE,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;oBACpD,CAAC;oBAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAuD,CAAC;oBACnF,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;wBACb,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAC1F,CAAC;oBAED,OAAO;gBACT,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,IAAI,CAAC,mCAAmC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACrG,CAAC;gBACD,OAAO;YACT,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;QACtF,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/recipe-version.d.ts

@@ -0,0 +1,3 @@
+/** @deprecated Import from ./runtime-version.ts instead. */
+export { CURRENT_RUNTIME_VERSION as CURRENT_RECIPE_VERSION, SUPPORTED_RUNTIME_VERSIONS as SUPPORTED_RECIPE_VERSIONS, extractMajorVersion, } from "./runtime-version.js";
+//# sourceMappingURL=recipe-version.d.ts.map