@senpi/trading-runtime 1.0.0

package/dist/cli/guide-commands.js

@@ -0,0 +1,332 @@
+/**
+ * senpi guide subcommands — in-shell reference for @senpi/trading-runtime.
+ *
+ * All reference text is static string constants. This is intentional: the
+ * scanner registry does not expose configSchema or description metadata at
+ * runtime (ScannerEngine.list() only returns id/enabled/intervalSeconds).
+ *
+ * TODO: replace static strings with dynamic registry metadata once
+ * ScannerEngine exposes configSchema per scanner type. Relevant type is
+ * ScannerRegistrationSummary in src/scanners/engine/engine.ts.
+ */
+const CHANGELOG_URL = "https://github.com/Senpi-ai/senpi-trading-runtime/blob/main/CHANGELOG.md";
+// ── Reference text constants ────────────────────────────────────────────────
+const OVERVIEW_TEXT = (version) => `
+@senpi/trading-runtime v${version}
+
+Event-driven automated trading plugin for OpenClaw. Orchestrates scanners,
+LLM-based trade decisions, and a DSL trailing stop-loss exit engine.
+
+Flow:  Scanner → signal queue → Action (optional LLM) → position → DSL exit
+
+Quick commands:
+  senpi guide scanners    Scanner types and config fields
+  senpi guide actions     Action types and decision modes
+  senpi guide dsl         Two-phase exit engine reference
+  senpi guide examples    Print minimal strategy YAML
+  senpi guide schema      Full YAML schema field reference
+  senpi guide version     Plugin version and changelog URL
+
+Docs: docs/runtime-docs/
+`.trim();
+const SCANNERS_TEXT = `
+Scanner types
+─────────────────────────────────────────────────────────────────────────────
+
+emerging_movers
+  Watches the Senpi smart-money leaderboard for rank and contribution
+  movements. Stateful — compares each scan to stored history.
+  Typical interval: 20s–60s
+
+  Signal types (priority order):
+    FIRST_JUMP         (score 0.95)  10+ rank jump from deep, first appearance
+    CONTRIB_EXPLOSION  (score 0.90)  3x+ contribution spike in one scan
+    IMMEDIATE_MOVER    (score 0.85)  10+ rank jump, token was already tracked
+    NEW_ENTRY_DEEP     (score 0.80)  New entry landing directly in top 20
+    DEEP_CLIMBER       (score 0.60)  Moderate rank gain from a deep position
+
+  Config fields:
+    topN                      number   50    Track top N by SM contribution
+    minRankJump               number   5     Min rank improvement for DEEP_CLIMBER
+    minTopTradersGain         number   0.1   Min contribution threshold
+    minScansBeforeSignals     number   2     Warm-up scans before emitting signals
+    historyLimit              number   60    Max history entries per token
+    immediateJumpThreshold    number   10    Rank jump for IMMEDIATE_MOVER/FIRST_JUMP
+    deepClimbRankThreshold    number   25    Starting rank for deep-climb detection
+    contribExplosionMultiplier number  3.0   Ratio for CONTRIB_EXPLOSION
+    firstJumpMinPrevRank      number   30    Prev-rank floor for FIRST_JUMP
+
+──────────────────────────────────────────────────────────────────────────────
+
+momentum
+  Emits directional breakout signals based on candle price movement.
+  Works best paired with the prescreener scanner.
+  Typical interval: 1m
+
+  Signal types: MOMENTUM_BREAKOUT (LONG or SHORT)
+
+  Config fields:
+    timeframe           string   "1h"   Candle timeframe to analyze
+    minMovePct          number   1.5    Min price change % to emit a signal
+    maxCandidates       number   20     Max assets evaluated per scan
+    minDayVolume        number   1e6    Min 24h volume filter (fallback only)
+    minSignalScore      number   0.2    Min signal score threshold (0–1)
+    requirePrescreened  boolean  true   Only scan assets from the prescreener
+
+──────────────────────────────────────────────────────────────────────────────
+
+prescreener
+  Infrastructure scanner. Ranks liquid instruments by a composite
+  liquidity/momentum/OI score and publishes a shared artifact consumed
+  by momentum and oi_tracker. Add this scanner before those in your YAML.
+  Typical interval: 5m
+
+  Signal types: none (artifact producer only)
+
+  Config fields:
+    topN              number   30    Assets passed through to downstream scanners
+    minDayVolume      number   1e6   Min 24h notional volume
+    minLeverage       number   2     Min max-leverage (filters illiquid markets)
+    minOpenInterest   number   0     Min open interest
+
+──────────────────────────────────────────────────────────────────────────────
+
+oi_tracker
+  Infrastructure scanner. Samples open interest per instrument and writes
+  an oi-history artifact. Used by downstream scanners that need OI trend data.
+  Typical interval: 1m
+
+  Signal types: none (artifact producer only)
+
+  Config fields:
+    minDayVolume   number   1e6   Min 24h volume; instruments below are skipped
+    maxHistory     number   60    Max OI snapshots retained per instrument
+`.trim();
+const ACTIONS_TEXT = `
+Action types
+─────────────────────────────────────────────────────────────────────────────
+
+OPEN_POSITION
+  Opens a new position on Senpi. Checks slot availability before executing.
+
+  Required YAML fields:
+    action_type      OPEN_POSITION
+    decision_mode    llm | no_decision
+    scanners         list of scanner names that feed this action
+    min_confidence   0–10; signals below this score are skipped
+
+  Optional fields:
+    decision_model   Claude model id (required when decision_mode: llm)
+    context          list of context fields injected into the prompt
+                     currently supported: signal
+    decision_prompt  system prompt template; use {{signal}} for signal JSON
+
+Decision modes:
+  llm          Claude evaluates each signal. Prompt receives {{signal}} as JSON.
+               Claude must respond with:
+               {
+                 "execute": true | false,
+                 "actionType": "OPEN_POSITION",
+                 "confidence": 1–10,
+                 "reasoning": "one sentence",
+                 "payload": { "asset": "SOL", "direction": "LONG" | "SHORT" }
+               }
+               Trades are skipped when execute=false or confidence < min_confidence.
+
+  no_decision  Opens a position for every qualifying signal immediately.
+               No LLM call. Use with tight DSL stops to manage risk.
+`.trim();
+const DSL_TEXT = `
+DSL exit engine — two-phase trailing stop-loss
+─────────────────────────────────────────────────────────────────────────────
+
+The DSL monitors open positions on a configurable interval and closes them
+when price breaches the computed floor.
+
+exit:
+  engine: dsl
+  interval_seconds: 30          # how often the price monitor runs
+
+  dsl_presets:
+    <preset_name>:
+      phase1: ...
+      phase2_trigger_tier: 0
+      phase2: ...
+
+──────────────────────────────────────────────────────────────────────────────
+Phase 1 — Fixed floor
+  Active from entry until the tier at phase2_trigger_tier is crossed.
+  Floor = entry_price × (1 − max_loss_pct / 100)
+
+  phase1:
+    enabled: true
+    max_loss_pct: 3.0                   # exit if price drops 3% below entry
+    consecutive_breaches_required: 3    # ticks below floor before exit fires
+
+──────────────────────────────────────────────────────────────────────────────
+Phase 2 — Dynamic trailing floor (high-water mark retrace)
+  Replaces Phase 1 once the position gains enough. The floor tracks the
+  high-water mark and never moves down.
+
+  phase2_trigger_tier: 0     # 0 = phase2 starts when the first tier is hit
+
+  phase2:
+    enabled: true
+    retrace_threshold: 1.5          # default: exit if 1.5% below HWM
+    consecutive_breaches_required: 1
+
+    tiers:
+      # Each tier: trigger_pct = gain from entry that activates this tier
+      #            lock_pct    = floor locked at entry × (1 + lock_pct%)
+      #            retrace     = overrides retrace_threshold for this tier
+      - { trigger_pct: 10,  lock_pct: 5 }
+      - { trigger_pct: 20,  lock_pct: 14 }
+      - { trigger_pct: 30,  lock_pct: 22, retrace: 1.2 }
+      - { trigger_pct: 50,  lock_pct: 40, retrace: 1.0 }
+      - { trigger_pct: 75,  lock_pct: 60, retrace: 0.8 }
+      - { trigger_pct: 100, lock_pct: 80, retrace: 0.6 }
+
+──────────────────────────────────────────────────────────────────────────────
+State and events
+  Per-position state is persisted at {stateDir}/strategies/{id}/... as JSON.
+  Events emitted: dsl.created, dsl.tier_advanced, dsl.sl_updated,
+                  dsl.phase_changed, position.closed
+`.trim();
+const SCHEMA_TEXT = `
+YAML schema — top-level keys
+─────────────────────────────────────────────────────────────────────────────
+Key              Type     Req   Description
+name             string   Yes   Strategy name
+version          string   No    Version identifier
+description      string   No    Human-readable description
+strategies       object   Yes   Keyed strategy configs (non-empty)
+scanners         array    *     Scanner definitions (* required when actions
+                                  have OPEN_POSITION or a scanners list)
+actions          array    No    Action definitions
+exit             object   No    Exit / DSL block
+health           object   No    Health check config
+hooks            array    No    Hook definitions
+notifications    object   No    e.g. telegram_chat_id
+advanced         object   No    Extra options
+
+strategies.<name>
+  wallet          string   Yes  Wallet address; supports \${VAR} substitution
+  budget          number   No   Total budget
+  slots           number   No   Max concurrent positions
+  margin_per_slot number   No   Margin per slot
+  trading_risk    string   No   conservative | moderate | aggressive
+  enabled         boolean  No   Default true
+
+scanners[]
+  name      string  Yes  Unique name referenced in actions.scanners
+  type      string  Yes  emerging_movers | momentum | prescreener | oi_tracker
+  interval  string  Yes  e.g. "30s", "2m", "1h"
+  blocked_assets  array  No
+  config    object  No   Scanner-specific config (see: senpi guide scanners)
+  advanced  object  No
+
+actions[]
+  name             string        Yes
+  action_type      string        Yes  OPEN_POSITION
+  decision_mode    string        Yes  llm | no_decision
+  decision_model   string        No   Required when decision_mode: llm
+  scanners         string[]      No   Scanner names this action listens to
+  min_confidence   number        No   0–10
+  context          string[]      No   [signal]
+  decision_prompt  string        No   Prompt template with {{signal}}
+  params           object        No
+
+exit
+  engine              string  No  dsl
+  interval_seconds    number  No  Default 30
+  dsl_presets         object  No  Presets keyed by name (preferred)
+  dsl                 object  No  Legacy alias for dsl_presets
+
+Environment substitution: \${VAR} and \${VAR:-default} resolved at load time.
+`.trim();
+const MINIMAL_YAML = `
+name: minimal
+version: 1.0.0
+description: Watch-only strategy — logs signals, opens no positions.
+
+strategies:
+  watch-only:
+    wallet: "\${WALLET_ADDRESS}"
+    budget: "0"
+    slots: 1
+    margin_per_slot: 0
+    trading_risk: conservative
+    enabled: true
+
+scanners:
+  - name: emerging_movers
+    type: emerging_movers
+    interval: 60s
+    config:
+      topN: 20
+      minRankJump: 5
+      minScansBeforeSignals: 2
+
+actions:
+  - name: log_signals
+    action_type: OPEN_POSITION
+    decision_mode: no_decision
+    scanners: [emerging_movers]
+    min_confidence: 0
+
+exit:
+  engine: dsl
+  interval_seconds: 60
+  dsl_presets:
+    default:
+      phase1:
+        enabled: true
+        consecutive_breaches_required: 3
+        max_loss_pct: 5.0
+      phase2_trigger_tier: 0
+      phase2:
+        enabled: false
+`.trim();
+/**
+ * Register `senpi guide [subcommand]` on the senpi Commander subprogram.
+ * @param senpi  - the `senpi` Commander command object
+ * @param version - plugin version string (from src/version.ts)
+ */
+export function registerGuideCommands(senpi, version) {
+    const guide = senpi.command("guide")
+        .description("In-shell reference for @senpi/trading-runtime");
+    guide.action(() => {
+        process.stdout.write(OVERVIEW_TEXT(version) + "\n");
+    });
+    guide.command("scanners")
+        .description("Scanner types and config fields")
+        .action(() => {
+        process.stdout.write(SCANNERS_TEXT + "\n");
+    });
+    guide.command("actions")
+        .description("Action types and decision modes")
+        .action(() => {
+        process.stdout.write(ACTIONS_TEXT + "\n");
+    });
+    guide.command("dsl")
+        .description("DSL two-phase exit engine reference")
+        .action(() => {
+        process.stdout.write(DSL_TEXT + "\n");
+    });
+    guide.command("examples")
+        .description("Print minimal strategy YAML to stdout")
+        .action(() => {
+        process.stdout.write(MINIMAL_YAML + "\n");
+    });
+    guide.command("schema")
+        .description("Full YAML schema field reference")
+        .action(() => {
+        process.stdout.write(SCHEMA_TEXT + "\n");
+    });
+    guide.command("version")
+        .description("Plugin version and changelog URL")
+        .action(() => {
+        process.stdout.write(`@senpi/trading-runtime v${version}\n${CHANGELOG_URL}\n`);
+    });
+}
+//# sourceMappingURL=guide-commands.js.map

package/dist/cli/guide-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-commands.js","sourceRoot":"","sources":["../../src/cli/guide-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,aAAa,GACjB,0EAA0E,CAAC;AAE7E,+EAA+E;AAE/E,MAAM,aAAa,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC;0BACjB,OAAO;;;;;;;;;;;;;;;;CAgBhC,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwErB,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCpB,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuDhB,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDnB,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CpB,CAAC,IAAI,EAAE,CAAC;AAYT;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAuB,EACvB,OAAe;IAEf,MAAM,KAAK,GAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAsB;SACvD,WAAW,CAAC,+CAA+C,CAAC,CAAC;IAEhE,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE;QAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,UAAU,CAAsB;SAC5C,WAAW,CAAC,iCAAiC,CAAC;SAC9C,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,SAAS,CAAsB;SAC3C,WAAW,CAAC,iCAAiC,CAAC;SAC9C,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,KAAK,CAAsB;SACvC,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,UAAU,CAAsB;SAC5C,WAAW,CAAC,uCAAuC,CAAC;SACpD,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAsB;SAC1C,WAAW,CAAC,kCAAkC,CAAC;SAC/C,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,SAAS,CAAsB;SAC3C,WAAW,CAAC,kCAAkC,CAAC;SAC/C,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,OAAO,KAAK,aAAa,IAAI,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/senpi-commands.d.ts

@@ -0,0 +1,22 @@
+/**
+ * OpenClaw CLI commands: openclaw senpi trading-strategy create | list | uninstallStrategy.
+ * create hot-loads via gateway RPC; list/uninstallStrategy operate on the registry.
+ */
+export type GetStateDir = () => string;
+/**
+ * Register senpi subcommands on the given Commander program.
+ * getStateDir: returns the plugin state dir (e.g. from config or default).
+ */
+export declare function registerSenpiCli(program: {
+    command: (name: string, desc?: string) => CommanderCommand | unknown;
+}, getStateDir: GetStateDir): void;
+/** Minimal Commander command type for subcommands and options. */
+interface CommanderCommand {
+    command(name: string, desc?: string): CommanderCommand;
+    description(desc: string): CommanderCommand;
+    option(flags: string, description?: string): CommanderCommand;
+    requiredOption(flags: string, description?: string): CommanderCommand;
+    action(fn: (opts: Record<string, unknown>) => void | Promise<void>): CommanderCommand;
+}
+export {};
+//# sourceMappingURL=senpi-commands.d.ts.map

package/dist/cli/senpi-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"senpi-commands.d.ts","sourceRoot":"","sources":["../../src/cli/senpi-commands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,MAAM,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE;IAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,gBAAgB,GAAG,OAAO,CAAA;CAAE,EACjF,WAAW,EAAE,WAAW,GACvB,IAAI,CA4HN;AAED,kEAAkE;AAClE,UAAU,gBAAgB;IACxB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACvD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC5C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC9D,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACtE,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC;CACvF"}

package/dist/cli/senpi-commands.js

@@ -0,0 +1,138 @@
+/**
+ * OpenClaw CLI commands: openclaw senpi trading-strategy create | list | uninstallStrategy.
+ * create hot-loads via gateway RPC; list/uninstallStrategy operate on the registry.
+ */
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+import { registerGuideCommands } from "./guide-commands.js";
+import { VERSION } from "../version.js";
+import { loadTradingStrategy } from "../runtime/load-trading-strategy.js";
+import { readRegistry, writeRegistry, validateEntry, hasId, deriveIdFromPath, deriveIdForContent, sanitizeId, } from "../runtime/strategy-registry.js";
+/**
+ * Register senpi subcommands on the given Commander program.
+ * getStateDir: returns the plugin state dir (e.g. from config or default).
+ */
+export function registerSenpiCli(program, getStateDir) {
+    const senpi = program.command("senpi");
+    senpi.description("Senpi trading runtime: trading-strategy create, list, uninstallStrategy");
+    const tradingStrategy = senpi.command("trading-strategy");
+    tradingStrategy.description("Manage trading strategies");
+    tradingStrategy
+        .command("create")
+        .description("Create and hot-load a strategy from a YAML file or inline content (no gateway restart)")
+        .option("-p, --path <path>", "Path to trading strategy YAML file")
+        .option("-c, --content <content>", "Inline YAML content")
+        .option("--strategy-id <id>", "Strategy id (default: derived from path or content-N)")
+        .option("--state-dir <dir>", "Override state directory (default: from config or ~/.openclaw/senpi-state)")
+        .action(async (opts) => {
+        const stateDir = opts.stateDir ?? getStateDir();
+        const hasPath = typeof opts.path === "string" && opts.path.length > 0;
+        const hasContent = typeof opts.content === "string";
+        if (hasPath && hasContent) {
+            console.error("Error: provide exactly one of --path or --content");
+            process.exitCode = 1;
+            return;
+        }
+        if (!hasPath && !hasContent) {
+            console.error("Error: provide --path or --content");
+            process.exitCode = 1;
+            return;
+        }
+        const registry = await readRegistry(stateDir);
+        let id;
+        if (typeof opts.strategyId === "string" && opts.strategyId.length > 0) {
+            id = sanitizeId(opts.strategyId);
+            if (id.length === 0)
+                id = "strategy";
+            if (hasId(registry, id)) {
+                console.error(`Error: id '${id}' already exists`);
+                process.exitCode = 1;
+                return;
+            }
+        }
+        else {
+            id =
+                hasPath
+                    ? deriveIdFromPath(opts.path, registry.strategies.map((s) => s.id))
+                    : deriveIdForContent(registry.strategies.map((s) => s.id));
+        }
+        const tradingStrategyYamlPath = hasPath ? path.resolve(process.cwd(), opts.path) : undefined;
+        const tradingStrategyYamlContent = hasContent ? opts.content : undefined;
+        const entry = hasPath
+            ? { id, tradingStrategyYamlPath: opts.path }
+            : { id, tradingStrategyYamlContent: opts.content };
+        const valid = validateEntry(entry);
+        if (!valid.ok) {
+            console.error("Error:", valid.error);
+            process.exitCode = 1;
+            return;
+        }
+        const pathOrContent = hasPath ? tradingStrategyYamlPath : tradingStrategyYamlContent;
+        try {
+            await loadTradingStrategy(pathOrContent, { fromPath: hasPath });
+        }
+        catch (err) {
+            console.error(err instanceof Error ? err.message : String(err));
+            process.exitCode = 1;
+            return;
+        }
+        const params = tradingStrategyYamlPath
+            ? { tradingStrategyYamlPath, id }
+            : { tradingStrategyYamlContent: tradingStrategyYamlContent, id };
+        const result = spawnSync(process.argv[0], [process.argv[1], "gateway", "call", "senpi.installStrategy", "--params", JSON.stringify(params)], {
+            stdio: "inherit",
+            cwd: process.cwd(),
+        });
+        if (result.status === 0) {
+            process.exitCode = 0;
+            return;
+        }
+        const fallbackRegistry = await readRegistry(stateDir);
+        if (!hasId(fallbackRegistry, id)) {
+            fallbackRegistry.strategies.push(entry);
+            await writeRegistry(stateDir, fallbackRegistry);
+            console.error("Gateway unreachable. Strategy added to registry. Start or restart the gateway to load it.");
+        }
+        process.exitCode = result.status ?? 1;
+    });
+    tradingStrategy
+        .command("uninstallStrategy")
+        .description("Remove a strategy by id")
+        .option("--strategy-id <id>", "Strategy id to remove")
+        .option("--state-dir <dir>", "Override state directory")
+        .action(async (opts) => {
+        if (typeof opts.strategyId !== "string" || opts.strategyId.length === 0) {
+            console.error("Error: --strategy-id is required");
+            process.exitCode = 1;
+            return;
+        }
+        const stateDir = opts.stateDir ?? getStateDir();
+        const registry = await readRegistry(stateDir);
+        const next = registry.strategies.filter((e) => e.id !== opts.strategyId);
+        if (next.length === registry.strategies.length) {
+            console.log(`No strategy with id '${opts.strategyId}' in registry.`);
+            return;
+        }
+        await writeRegistry(stateDir, { ...registry, strategies: next });
+        console.log(`Strategy '${opts.strategyId}' removed from registry. Restart the gateway or call senpi.uninstallStrategy RPC to stop it.`);
+    });
+    tradingStrategy
+        .command("list")
+        .description("List installed strategies")
+        .option("--state-dir <dir>", "Override state directory")
+        .action(async (opts) => {
+        const stateDir = opts.stateDir ?? getStateDir();
+        const registry = await readRegistry(stateDir);
+        if (registry.strategies.length === 0) {
+            console.log("No strategies installed.");
+            return;
+        }
+        console.log("id\t\tsource");
+        for (const e of registry.strategies) {
+            const source = e.tradingStrategyYamlPath ?? "(inline)";
+            console.log(`${e.id}\t\t${source}`);
+        }
+    });
+    registerGuideCommands(senpi, VERSION);
+}
+//# sourceMappingURL=senpi-commands.js.map

package/dist/cli/senpi-commands.js.map

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

package/dist/constants/dsl/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Centralized constants for the DSL feature.
+ */
+export declare const COMPONENT_TYPE_EXIT_DSL: "exit/dsl";
+/** DSL subscribes to the same hook event names as the rest of the runtime. */
+export declare const EVENTS: {
+    readonly POSITION_OPENED: "on_position_opened";
+    readonly POSITION_CLOSED: "on_position_closed";
+    readonly POSITION_FLIPPED: "on_position_flipped";
+};
+export declare const DSL_EVENTS: {
+    readonly CREATED: "dsl.created";
+    readonly PHASE_CHANGED: "dsl.phase_changed";
+    readonly TIER_ADVANCED: "dsl.tier_advanced";
+    readonly SL_UPDATED: "dsl.sl_updated";
+    readonly CLOSED: "dsl.closed";
+    readonly CLOSE_PENDING: "dsl.close_pending";
+    readonly SETTINGS_UPDATED: "dsl.settings_updated";
+};
+export declare const DEFAULT_STATE_DIR = ".dsl-state";
+export declare const DSL_STATE_VERSION = 2;
+/** Close reasons for DSL state (closeReason) and position.closed (reason). */
+export declare const CLOSE_REASON: {
+    readonly MANUAL_CLOSE: "manual_close";
+    readonly CLOSED_EXTERNALLY: "closed_externally";
+    readonly SL_HIT: "sl_hit";
+    readonly DSL_BREACH: "dsl_breach";
+    readonly FLIPPED: "flipped";
+    readonly CLOSE_POSITION_FAILED: "close_position_failed";
+};
+export type CloseReason = (typeof CLOSE_REASON)[keyof typeof CLOSE_REASON];
+export declare const MIN_INTERVAL_SECONDS = 5;
+export declare const DEFAULT_INTERVAL_MS = 30000;
+export declare const MAX_CONSECUTIVE_CLOSE_FAILURES = 3;
+export declare const MCP_TOOL_PREFIX = "senpi.";
+export declare const PHASE1_DEFAULT_BREACHES = 3;
+export declare const PHASE2_DEFAULT_BREACHES = 1;
+export declare const PRICE_DECIMALS = 4;
+//# sourceMappingURL=index.d.ts.map

package/dist/constants/dsl/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/constants/dsl/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,eAAO,MAAM,uBAAuB,EAAG,UAAmB,CAAC;AAE3D,8EAA8E;AAC9E,eAAO,MAAM,MAAM;;;;CAIT,CAAC;AAEX,eAAO,MAAM,UAAU;;;;;;;;CAQb,CAAC;AAEX,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAC9C,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,8EAA8E;AAC9E,eAAO,MAAM,YAAY;;;;;;;CAOf,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAC3E,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAC1C,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,eAAe,WAAW,CAAC;AACxC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,cAAc,IAAI,CAAC"}

package/dist/constants/dsl/index.js

@@ -0,0 +1,39 @@
+/**
+ * Centralized constants for the DSL feature.
+ */
+import { HOOK_EVENT } from "../../types/hooks.js";
+export const COMPONENT_TYPE_EXIT_DSL = "exit/dsl";
+/** DSL subscribes to the same hook event names as the rest of the runtime. */
+export const EVENTS = {
+    POSITION_OPENED: HOOK_EVENT.ON_POSITION_OPENED,
+    POSITION_CLOSED: HOOK_EVENT.ON_POSITION_CLOSED,
+    POSITION_FLIPPED: HOOK_EVENT.ON_POSITION_FLIPPED,
+};
+export const DSL_EVENTS = {
+    CREATED: "dsl.created",
+    PHASE_CHANGED: "dsl.phase_changed",
+    TIER_ADVANCED: "dsl.tier_advanced",
+    SL_UPDATED: "dsl.sl_updated",
+    CLOSED: "dsl.closed",
+    CLOSE_PENDING: "dsl.close_pending",
+    SETTINGS_UPDATED: "dsl.settings_updated",
+};
+export const DEFAULT_STATE_DIR = ".dsl-state";
+export const DSL_STATE_VERSION = 2;
+/** Close reasons for DSL state (closeReason) and position.closed (reason). */
+export const CLOSE_REASON = {
+    MANUAL_CLOSE: "manual_close",
+    CLOSED_EXTERNALLY: "closed_externally",
+    SL_HIT: "sl_hit",
+    DSL_BREACH: "dsl_breach",
+    FLIPPED: "flipped",
+    CLOSE_POSITION_FAILED: "close_position_failed",
+};
+export const MIN_INTERVAL_SECONDS = 5;
+export const DEFAULT_INTERVAL_MS = 30_000;
+export const MAX_CONSECUTIVE_CLOSE_FAILURES = 3;
+export const MCP_TOOL_PREFIX = "senpi.";
+export const PHASE1_DEFAULT_BREACHES = 3;
+export const PHASE2_DEFAULT_BREACHES = 1;
+export const PRICE_DECIMALS = 4;
+//# sourceMappingURL=index.js.map

package/dist/constants/dsl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/constants/dsl/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAmB,CAAC;AAE3D,8EAA8E;AAC9E,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,eAAe,EAAE,UAAU,CAAC,kBAAkB;IAC9C,eAAe,EAAE,UAAU,CAAC,kBAAkB;IAC9C,gBAAgB,EAAE,UAAU,CAAC,mBAAmB;CACxC,CAAC;AAEX,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,aAAa;IACtB,aAAa,EAAE,mBAAmB;IAClC,aAAa,EAAE,mBAAmB;IAClC,UAAU,EAAE,gBAAgB;IAC5B,MAAM,EAAE,YAAY;IACpB,aAAa,EAAE,mBAAmB;IAClC,gBAAgB,EAAE,sBAAsB;CAChC,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAC9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAEnC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,YAAY,EAAE,cAAc;IAC5B,iBAAiB,EAAE,mBAAmB;IACtC,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,SAAS;IAClB,qBAAqB,EAAE,uBAAuB;CACtC,CAAC;AAGX,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAC1C,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC;AAChD,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC;AACxC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AACzC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC"}

package/dist/context/context-builder.d.ts

@@ -0,0 +1,14 @@
+/**
+ * RuntimeContextBuilder: resolves context variables for LLM decision prompts.
+ *
+ * Each context type (e.g. "signal", "strategy") is backed by a ContextProvider
+ * that knows how to extract/compute its data from the event and runtime state.
+ */
+import type { ContextBuilder as IContextBuilder, ContextEntry, ContextProvider, ContextProviderRequest } from "./types.js";
+export declare class RuntimeContextBuilder implements IContextBuilder {
+    private providers;
+    register(provider: ContextProvider): void;
+    build(entries: ContextEntry[], request: ContextProviderRequest): Promise<Record<string, unknown>>;
+}
+export declare function createContextBuilder(): RuntimeContextBuilder;
+//# sourceMappingURL=context-builder.d.ts.map

package/dist/context/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../src/context/context-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,IAAI,eAAe,EACjC,YAAY,EACZ,eAAe,EACf,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAQpB,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,OAAO,CAAC,SAAS,CAAsC;IAEvD,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAInC,KAAK,CACT,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAUpC;AAID,wBAAgB,oBAAoB,IAAI,qBAAqB,CAO5D"}

package/dist/context/context-builder.js

@@ -0,0 +1,36 @@
+/**
+ * RuntimeContextBuilder: resolves context variables for LLM decision prompts.
+ *
+ * Each context type (e.g. "signal", "strategy") is backed by a ContextProvider
+ * that knows how to extract/compute its data from the event and runtime state.
+ */
+import { signalProvider } from "./providers/signal.provider.js";
+import { strategyProvider } from "./providers/strategy.provider.js";
+import { regimeProvider } from "./providers/regime.provider.js";
+import { assetTrendProvider } from "./providers/asset-trend.provider.js";
+// ─── RuntimeContextBuilder ──────────────────────────────────────────────────
+export class RuntimeContextBuilder {
+    providers = new Map();
+    register(provider) {
+        this.providers.set(provider.type, provider);
+    }
+    async build(entries, request) {
+        const results = await Promise.all(entries.map(async (entry) => {
+            const provider = this.providers.get(entry.type);
+            if (!provider)
+                return [entry.value, null];
+            return [entry.value, await provider.resolve(request, entry)];
+        }));
+        return Object.fromEntries(results);
+    }
+}
+// ─── Factory ────────────────────────────────────────────────────────────────
+export function createContextBuilder() {
+    const builder = new RuntimeContextBuilder();
+    builder.register(signalProvider);
+    builder.register(strategyProvider);
+    builder.register(regimeProvider);
+    builder.register(assetTrendProvider);
+    return builder;
+}
+//# sourceMappingURL=context-builder.js.map