@senpi/runtime 1.0.95-dev.20260408174401

package/dist/scanners/types.d.ts

@@ -0,0 +1,115 @@
+export type { ScannerId, StrategyId, Signal, ScanResult, } from '../types/scanner.js';
+export { ScanStatus } from '../types/scanner.js';
+import type { ScannerId, StrategyId, Signal } from '../types/scanner.js';
+/** Market snapshot values associated with an instrument. */
+export interface InstrumentContext {
+    markPx: number;
+    prevDayPx: number;
+    midPx: number;
+    dayNtlVlm: number;
+    openInterest: number;
+    funding: number;
+    [key: string]: unknown;
+}
+/** Tradable instrument used as scanner candidate input. */
+export interface Instrument {
+    name: string;
+    isDelisted: boolean;
+    maxLeverage: number;
+    context: InstrumentContext;
+}
+/** Single OHLCV candle point. */
+export interface Candle {
+    timestamp: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+}
+/** Candles indexed by timeframe label (for example 1h, 4h). */
+export interface CandleResult {
+    candles: Record<string, Candle[]>;
+    /** Optional provider-side error message when data is incomplete/unavailable. */
+    error?: string;
+}
+/** Columnar candle representation used by indicator functions. */
+export interface ParsedCandles {
+    open: number[];
+    high: number[];
+    low: number[];
+    close: number[];
+    volume: number[];
+}
+/** Open-interest sample used by OI history and related scanners. */
+export interface OiSnapshot {
+    oi: number;
+    price: number;
+    timestamp: number;
+}
+/** Simplified market row from SM/top-trader sources. */
+export interface SmMarket {
+    token: string;
+    dex?: string;
+    direction: string;
+    pctOfTopTradersGain: number;
+    traderCount: number;
+    tokenPriceChangePct4h: number;
+    [key: string]: unknown;
+}
+/** Common candidate shape scanners iterate over after prefiltering. */
+export interface Candidate {
+    name: string;
+    context: InstrumentContext;
+    maxLeverage: number;
+}
+/** Raw scanner execution payload before engine wraps into a ScanResult. */
+export interface ScannerScanOutput {
+    /** Scan timestamp in unix milliseconds. */
+    timestamp: number;
+    /** Signals produced by the scanner in this run. */
+    signals: Signal[];
+    /** Number of candidates evaluated by scanner logic. */
+    scannedCount: number;
+    /** Optional status/reason message for heartbeat/skips. */
+    reason?: string;
+    /** Scanner-defined execution summary values. */
+    summary: Record<string, unknown>;
+}
+/** Strategy-scoped shared artifact channels between scanners. */
+export type SharedArtifactKey = string;
+/** Lightweight shared artifact wrapper with freshness timestamp. */
+export interface ArtifactEnvelope<T> {
+    /** Last update time in unix milliseconds. */
+    updatedAt: number;
+    /** Artifact payload. */
+    data: T;
+}
+/**
+ * Strategy registration bootstrap metadata.
+ * A given scanner id is expected to have one runtime instance per strategy.
+ */
+export interface StrategyRegistration {
+    id: StrategyId;
+    name: string;
+    wallet?: string;
+    defaultEnabledScanners?: ScannerId[];
+    scannerOverrides?: Record<ScannerId, {
+        intervalSeconds?: number;
+        config?: unknown;
+    }>;
+}
+/** Options for reading a scanner history window. */
+export interface ReadHistoryOptions {
+    /** Maximum number of recent history entries to return. */
+    limit?: number;
+}
+/** Cross-scanner signal query filters for read APIs/tools. */
+export interface ReadSignalsFilter {
+    address?: string;
+    scannerId?: ScannerId;
+    minScore?: number;
+    asset?: string;
+    limit?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/scanners/types.d.ts.map

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

package/dist/scanners/types.js

@@ -0,0 +1,3 @@
+// ─── Re-export shared types used by the scanner system ──────────────────────
+export { ScanStatus } from '../types/scanner.js';
+//# sourceMappingURL=types.js.map

package/dist/scanners/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/scanners/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAS/E,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/scripts/run-dsl-standalone-live.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Standalone DSL runner — LIVE: real MCP (prices, editPosition, getOrderStatus, closePosition).
+ * You open positions manually; this script registers them with the DSL and runs the monitor.
+ *
+ * Required in .env or env (for testing live flow):
+ *   SENPI_API_KEY
+ *   DSL_POSITION_WALLET   wallet holding the positions
+ *   DSL_POSITION_ASSETS   comma- or space-separated tickers, e.g. "SOL,BTC" or "SOL BTC ETH"
+ *   (legacy: DSL_POSITION_COIN for a single asset only)
+ *   DSL_STATE_DIR         directory for persisted DSL state
+ *
+ * Optional: DSL_POSITION_ADDRESS (defaults to DSL_POSITION_WALLET — strategy id used for state paths).
+ * Size, entry, and leverage come from one strategy_get_clearinghouse_state call per run. Set DSL_POSITION_DEX (e.g. "xyz")
+ * to disambiguate if the same coin exists on multiple DEXes. Optional overrides (single asset only):
+ *   DSL_POSITION_SZI, DSL_POSITION_ENTRY_PX — skip clearing house for that one row
+ * Optional: DSL_POSITION_LEVERAGE (with overrides), DSL_PRESET (default "default")
+ *
+ * Optional for testing close / flip / size change (simulates hooks; no exchange call for these emits):
+ *   --close-after N emits on_position_closed for every registered asset after N seconds
+ *   --flip-after N requires exactly one asset; set DSL_NEW_COIN (same market as the open leg, e.g. xyz:BASE or BASE with DSL_POSITION_DEX).
+ *     At emit time, clearing house must already show the **new** direction/size (flip on the venue before the timer fires). DSL_NEW_SZI / DSL_NEW_ENTRY_PX / DSL_NEW_LEVERAGE are optional (auto-read when omitted).
+ *   --increase-after N: optionally set DSL_INCREASE_SZI / DSL_INCREASE_ENTRY_PX / DSL_INCREASE_LEVERAGE.
+ *     If omitted, values are auto-read from live clearing house at emit time. With multiple tracked positions,
+ *     set DSL_INCREASE_ASSET to the ticker (matches clearing-house coin, case-insensitive).
+ *   --decrease-after N: optionally set DSL_DECREASE_SZI / DSL_DECREASE_ENTRY_PX / DSL_DECREASE_LEVERAGE.
+ *     If omitted, values are auto-read from live clearing house at emit time. With multiple positions,
+ *     set DSL_DECREASE_ASSET.
+ *   (Increase/decrease use bus event names on_position_increased / on_position_decreased, same as HookSystem.fire.)
+ *
+ * Optional — DSL Telegram notifications (same behavior as runtime DslPlugin):
+ *   - Recipe (--config): top-level `notifications.telegram_chat_id` (and optional `dsl_lifecycle: false`,
+ *     `dsl_notify_sl_updates: true`). Gateway auth uses OPENCLAW_GATEWAY_TOKEN in the environment unless
+ *     you set optional `gateway_token` in YAML.
+ *   - Or env chat id if the recipe has no telegram_chat_id: DSL_TELEGRAM_CHAT_ID or TELEGRAM_CHAT_ID
+ *   - Without a resolvable chat id (or with dsl_lifecycle: false), only console bus logs run (see below).
+ *   Bus listeners always print DSL_EVENTS to stdout for debugging.
+ *
+ * Usage (after build):
+ *   npm run run:dsl:live
+ *   node dist/scripts/run-dsl-standalone-live.js --seconds 3600
+ *   node dist/scripts/run-dsl-standalone-live.js --config examples/strategies/dsl-showcase.yaml
+ *   node dist/scripts/run-dsl-standalone-live.js --seconds 120 --close-after 30   # emit position.closed for each asset
+ *   node dist/scripts/run-dsl-standalone-live.js --seconds 120 --flip-after 30    # single asset + DSL_NEW_*
+ *   node dist/scripts/run-dsl-standalone-live.js --seconds 300 --increase-after 60   # single asset + DSL_INCREASE_*
+ *   node dist/scripts/run-dsl-standalone-live.js --seconds 300 --decrease-after 90   # single asset + DSL_DECREASE_*
+ */
+import "dotenv/config";
+//# sourceMappingURL=run-dsl-standalone-live.d.ts.map

package/dist/scripts/run-dsl-standalone-live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-dsl-standalone-live.d.ts","sourceRoot":"","sources":["../../src/scripts/run-dsl-standalone-live.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,OAAO,eAAe,CAAC"}