@senpi/runtime 1.0.95-dev.20260408174401

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,6 @@
+export * from './action.js';
+export * from './hooks.js';
+export * from './notification.js';
+export * from './scanner.js';
+export * from './strategy.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/types/notification.d.ts

@@ -0,0 +1,4 @@
+export interface NotificationService {
+    notify(message: string): Promise<void>;
+}
+//# sourceMappingURL=notification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../src/types/notification.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC"}

package/dist/types/notification.js

@@ -0,0 +1,3 @@
+// ─── Notification Service ────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=notification.js.map

package/dist/types/notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.js","sourceRoot":"","sources":["../../src/types/notification.ts"],"names":[],"mappings":"AAAA,gFAAgF"}

package/dist/types/runtime.d.ts

@@ -0,0 +1,18 @@
+import { SenpiClient } from "src/senpi/client.js";
+import { StrategyState } from "./strategy.js";
+import type { ContextBuilder } from "../context/types.js";
+import { HookSystem, LlmDecision, NotificationService, RiskGuard } from "src/actions/types.js";
+import type { ScannerRuntimeModule } from "../scanners/runtime-module.js";
+import type { MaxLeverageCache } from "../leverage/max-leverage-cache.js";
+export interface RuntimeContext {
+    senpi: SenpiClient;
+    hookSystem: HookSystem;
+    llmDecision: LlmDecision;
+    contextBuilder: ContextBuilder;
+    riskGuard: RiskGuard;
+    notifications: NotificationService;
+    strategyState: StrategyState;
+    scannerModule?: ScannerRuntimeModule;
+    maxLeverageCache: MaxLeverageCache;
+}
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/types/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC/F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,SAAS,CAAC;IACrB,aAAa,EAAE,mBAAmB,CAAC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,gBAAgB,EAAE,gBAAgB,CAAC;CACpC"}

package/dist/types/runtime.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime.js.map

package/dist/types/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/types/runtime.ts"],"names":[],"mappings":""}

package/dist/types/scanner.d.ts

@@ -0,0 +1,59 @@
+/** Identifier of a scanner definition/instance within a strategy runtime. */
+export type ScannerId = string;
+/** Strategy identifier: wallet address. */
+export type StrategyId = string;
+/** Execution outcome classification returned by the scanner engine. */
+export declare enum ScanStatus {
+    OK = "ok",
+    HEARTBEAT = "heartbeat",
+    SKIPPED = "skipped",
+    HALTED = "halted",
+    DISABLED = "disabled",
+    ERROR = "error"
+}
+/**
+ * Normalized scanner signal.
+ * Produced by scanners, then validated/enriched by the engine before persistence.
+ */
+export interface Signal {
+    /** Strategy (wallet address) that emitted this signal. */
+    address: string;
+    /** Scanner identifier that emitted this signal. */
+    scannerId: ScannerId;
+    /** Domain-specific signal type (for example MOMENTUM_BREAKOUT). */
+    signalType: string;
+    /** Asset symbol/name the signal refers to. */
+    asset: string;
+    /** Trade direction, or null for non-directional signals. */
+    direction: "LONG" | "SHORT" | null;
+    /** Confidence score normalized to [0, 1]. */
+    score: number;
+    /** Unix timestamp in milliseconds. */
+    timestamp: number;
+    /** Explainable boolean factors used in scoring/gating. */
+    factors: Record<string, boolean>;
+    /** Extra scanner-specific metadata for downstream consumers. */
+    meta: Record<string, unknown>;
+}
+/** Canonical persisted execution result produced by the engine. */
+export interface ScanResult {
+    /** Strategy (wallet address) this run belongs to. */
+    address: string;
+    /** Scanner executed in this run. */
+    scannerId: ScannerId;
+    /** Final run status after hooks and scanner execution. */
+    status: ScanStatus;
+    /** Result timestamp in unix milliseconds. */
+    timestamp: number;
+    /** Normalized output signals. */
+    signals: Signal[];
+    /** Count of signals passing actionability rules. */
+    actionableCount: number;
+    /** Number of evaluated candidates. */
+    scannedCount: number;
+    /** Optional explanation for non-OK status. */
+    reason?: string;
+    /** Aggregated run metrics/details. */
+    summary: Record<string, unknown>;
+}
+//# sourceMappingURL=scanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/types/scanner.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAC/B,2CAA2C;AAC3C,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAIhC,uEAAuE;AACvE,oBAAY,UAAU;IACpB,EAAE,OAAO;IACT,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,KAAK,UAAU;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,SAAS,EAAE,SAAS,CAAC;IACrB,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IACnC,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,SAAS,EAAE,SAAS,CAAC;IACrB,0DAA0D;IAC1D,MAAM,EAAE,UAAU,CAAC;IACnB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC"}

package/dist/types/scanner.js

@@ -0,0 +1,13 @@
+// ─── Identifiers ────────────────────────────────────────────────────────────
+// ─── Scanner Execution Types ─────────────────────────────────────────────────
+/** Execution outcome classification returned by the scanner engine. */
+export var ScanStatus;
+(function (ScanStatus) {
+    ScanStatus["OK"] = "ok";
+    ScanStatus["HEARTBEAT"] = "heartbeat";
+    ScanStatus["SKIPPED"] = "skipped";
+    ScanStatus["HALTED"] = "halted";
+    ScanStatus["DISABLED"] = "disabled";
+    ScanStatus["ERROR"] = "error";
+})(ScanStatus || (ScanStatus = {}));
+//# sourceMappingURL=scanner.js.map

package/dist/types/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../../src/types/scanner.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAO/E,gFAAgF;AAEhF,uEAAuE;AACvE,MAAM,CAAN,IAAY,UAOX;AAPD,WAAY,UAAU;IACpB,uBAAS,CAAA;IACT,qCAAuB,CAAA;IACvB,iCAAmB,CAAA;IACnB,+BAAiB,CAAA;IACjB,mCAAqB,CAAA;IACrB,6BAAe,CAAA;AACjB,CAAC,EAPW,UAAU,KAAV,UAAU,QAOrB"}

package/dist/types/strategy.d.ts

@@ -0,0 +1,106 @@
+import type { CreatePositionRequest, CreatePositionResult, EditPositionResult } from "../senpi/types.js";
+export type TradingRisk = 'conservative' | 'moderate' | 'aggressive';
+/** Strategy configuration. Address is the strategy identifier (platform id). */
+export interface StrategyConfig {
+    address: string;
+    budget: number;
+    slots: number;
+    tradingRisk: TradingRisk;
+    marginPerSlot?: number;
+    defaultLeverage?: number;
+    leverageMultipliers?: Partial<Record<TradingRisk, number>>;
+    dailyLossLimit?: number;
+    dsl?: Record<string, unknown>;
+    guardRails?: Record<string, unknown>;
+    enabled?: boolean;
+}
+/** Account-level + position data from strategy_get_clearinghouse_state (single MCP call). */
+export interface ClearinghouseState {
+    accountValue: number;
+    totalMarginUsed: number;
+    totalUnrealizedPnl: number;
+    totalNtlPos: number;
+    withdrawable: number;
+    positions: OpenPosition[];
+    /** Minimum `time` (ms epoch) across all dex entries in the API response. Indicates data freshness. */
+    time: number;
+}
+export interface OpenPosition {
+    coin: string;
+    dex: string;
+    szi: number;
+    entryPx: number;
+    leverage: number;
+    leverageType: "cross" | "isolated";
+    unrealizedPnl: number;
+    marginUsed: number;
+    liquidationPx: number | null;
+    returnOnEquity: number;
+}
+export interface PastTrade {
+    coin: string;
+    direction: 'LONG' | 'SHORT';
+    entryPx: number;
+    closePx: number;
+    szi: number;
+    realizedPnl: number;
+    closedTime: number;
+    openTime: number;
+    totalFees: number;
+}
+export interface OpenOrder {
+    orderId: number;
+    coin: string;
+    side: 'BUY' | 'SELL';
+    size: number;
+    price: number;
+    orderType: string;
+    status: string;
+    timestamp: number;
+}
+export interface StrategyDetails {
+    strategyId: string;
+    name: string;
+    status: string;
+    traderAddress: string;
+    initialBudget: number;
+    totalPnl: number;
+    pnlPercentage: number;
+    createdAt: string;
+}
+/** Runtime strategy state. Address is the strategy identifier and equals config.address. */
+export interface StrategyState {
+    readonly address: string;
+    readonly config: StrategyConfig;
+    getClearinghouseState(): ClearinghouseState | undefined;
+    getOpenPositions(): OpenPosition[] | undefined;
+    getPastTrades(): PastTrade[] | undefined;
+    getOpenOrders(): OpenOrder[] | undefined;
+    getAvailableSlots(): number;
+    getDetails(): StrategyDetails | undefined;
+    hasOpenPosition(coin: string, dex?: string): boolean;
+    fetchClearinghouseState(): Promise<ClearinghouseState | undefined>;
+    fetchPastTrades(opts?: {
+        limit?: number;
+        offset?: number;
+        sort_by?: string;
+        sort_direction?: string;
+    }): Promise<PastTrade[] | undefined>;
+    fetchOpenOrders(): Promise<OpenOrder[] | undefined>;
+    fetchDetails(): Promise<StrategyDetails | undefined>;
+    refresh(): Promise<void>;
+    cancelOrder(orderId: number): Promise<unknown>;
+    closePosition(coin: string, reason: string, dex?: string): Promise<unknown>;
+    createPosition(params: CreatePositionRequest): Promise<CreatePositionResult>;
+    editPosition(payload: {
+        coin: string;
+        dex?: string;
+        stopLoss?: {
+            triggerPx: number;
+        };
+    }): Promise<EditPositionResult>;
+    getOrderStatus(orderId: number): Promise<{
+        filled?: boolean;
+    } | null>;
+}
+//# sourceMappingURL=strategy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../src/types/strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAIzG,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,UAAU,GAAG,YAAY,CAAC;AAErE,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAID,6FAA6F;AAC7F,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,sGAAsG;IACtG,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,GAAG,UAAU,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,4FAA4F;AAC5F,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAGhC,qBAAqB,IAAI,kBAAkB,GAAG,SAAS,CAAC;IACxD,gBAAgB,IAAI,YAAY,EAAE,GAAG,SAAS,CAAC;IAC/C,aAAa,IAAI,SAAS,EAAE,GAAG,SAAS,CAAC;IACzC,aAAa,IAAI,SAAS,EAAE,GAAG,SAAS,CAAC;IACzC,iBAAiB,IAAI,MAAM,CAAC;IAC5B,UAAU,IAAI,eAAe,GAAG,SAAS,CAAC;IAC1C,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAGrD,uBAAuB,IAAI,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC;IACnE,eAAe,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,EAAE,GAAG,SAAS,CAAC,CAAC;IACzI,eAAe,IAAI,OAAO,CAAC,SAAS,EAAE,GAAG,SAAS,CAAC,CAAC;IACpD,YAAY,IAAI,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;IAGrD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAGzB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC7E,YAAY,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;CACvE"}

package/dist/types/strategy.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=strategy.js.map

package/dist/types/strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.js","sourceRoot":"","sources":["../../src/types/strategy.ts"],"names":[],"mappings":""}

package/dist/utils/clearing-house-staleness.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Extracts the minimum `time` (ms epoch) across all dex entries in a raw
+ * clearingHouse API response.
+ *
+ * The MCP response is keyed by venue (e.g. `{ main: { …, time }, xyz: { …, time } }`).
+ * Each dex entry carries its own `time` from the Hyperliquid clearinghouseState
+ * API, indicating how fresh the data is.
+ *
+ * We take the **minimum** as a defensive measure: if any dex returned stale
+ * data the entire response is conservatively marked with the oldest timestamp,
+ * so downstream staleness checks can discard the whole response.
+ *
+ * Returns `0` when no valid time is found (e.g. response shape is unexpected
+ * or the upstream stops providing timestamps).
+ */
+export declare function extractMinClearingHouseTime(raw: Record<string, unknown>): number;
+/**
+ * Stateful guard that detects stale clearingHouse API responses by comparing
+ * the response timestamp against the most recent known-fresh timestamp for
+ * the same key (wallet address).
+ *
+ * The Hyperliquid clearinghouseState API occasionally returns a response
+ * whose timestamp is **older** than a previously observed one. Processing
+ * such stale data causes downstream consumers to misinterpret disappeared
+ * positions as closes and reappearing positions as new opens.
+ *
+ * Usage:
+ * ```ts
+ * const guard = createClearingHouseStalenessGuard();
+ * if (guard.isStale(address, responseTime)) { return null; }
+ * ```
+ *
+ * When either `responseTime` or the stored last time is `0` (unavailable),
+ * the check is skipped so callers degrade gracefully if the upstream stops
+ * providing timestamps.
+ */
+export declare function createClearingHouseStalenessGuard(): {
+    /**
+     * Returns `true` if `responseTime` is stale (older than the last
+     * accepted time for `key`). Also updates internal tracking when the
+     * response is fresh.
+     */
+    isStale(key: string, responseTime: number): boolean;
+    /** Returns the last accepted time for a key, or `0` if never seen. */
+    getLastTime(key: string): number;
+};
+//# sourceMappingURL=clearing-house-staleness.d.ts.map

package/dist/utils/clearing-house-staleness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clearing-house-staleness.d.ts","sourceRoot":"","sources":["../../src/utils/clearing-house-staleness.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAUhF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iCAAiC;IAI7C;;;;OAIG;iBACU,MAAM,gBAAgB,MAAM,GAAG,OAAO;IAcnD,sEAAsE;qBACrD,MAAM,GAAG,MAAM;EAInC"}

package/dist/utils/clearing-house-staleness.js

@@ -0,0 +1,73 @@
+import { isRecord, asNumber } from "./response.js";
+/**
+ * Extracts the minimum `time` (ms epoch) across all dex entries in a raw
+ * clearingHouse API response.
+ *
+ * The MCP response is keyed by venue (e.g. `{ main: { …, time }, xyz: { …, time } }`).
+ * Each dex entry carries its own `time` from the Hyperliquid clearinghouseState
+ * API, indicating how fresh the data is.
+ *
+ * We take the **minimum** as a defensive measure: if any dex returned stale
+ * data the entire response is conservatively marked with the oldest timestamp,
+ * so downstream staleness checks can discard the whole response.
+ *
+ * Returns `0` when no valid time is found (e.g. response shape is unexpected
+ * or the upstream stops providing timestamps).
+ */
+export function extractMinClearingHouseTime(raw) {
+    let min = Infinity;
+    for (const value of Object.values(raw)) {
+        if (!isRecord(value))
+            continue;
+        const t = asNumber(value.time);
+        if (t != null && Number.isFinite(t) && t > 0) {
+            min = Math.min(min, t);
+        }
+    }
+    return Number.isFinite(min) ? min : 0;
+}
+/**
+ * Stateful guard that detects stale clearingHouse API responses by comparing
+ * the response timestamp against the most recent known-fresh timestamp for
+ * the same key (wallet address).
+ *
+ * The Hyperliquid clearinghouseState API occasionally returns a response
+ * whose timestamp is **older** than a previously observed one. Processing
+ * such stale data causes downstream consumers to misinterpret disappeared
+ * positions as closes and reappearing positions as new opens.
+ *
+ * Usage:
+ * ```ts
+ * const guard = createClearingHouseStalenessGuard();
+ * if (guard.isStale(address, responseTime)) { return null; }
+ * ```
+ *
+ * When either `responseTime` or the stored last time is `0` (unavailable),
+ * the check is skipped so callers degrade gracefully if the upstream stops
+ * providing timestamps.
+ */
+export function createClearingHouseStalenessGuard() {
+    const lastTimeByKey = new Map();
+    return {
+        /**
+         * Returns `true` if `responseTime` is stale (older than the last
+         * accepted time for `key`). Also updates internal tracking when the
+         * response is fresh.
+         */
+        isStale(key, responseTime) {
+            const lastTime = lastTimeByKey.get(key) ?? 0;
+            if (responseTime > 0 && lastTime > 0 && responseTime < lastTime) {
+                return true;
+            }
+            if (responseTime > 0) {
+                lastTimeByKey.set(key, responseTime);
+            }
+            return false;
+        },
+        /** Returns the last accepted time for a key, or `0` if never seen. */
+        getLastTime(key) {
+            return lastTimeByKey.get(key) ?? 0;
+        },
+    };
+}
+//# sourceMappingURL=clearing-house-staleness.js.map

package/dist/utils/clearing-house-staleness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clearing-house-staleness.js","sourceRoot":"","sources":["../../src/utils/clearing-house-staleness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEnD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,2BAA2B,CAAC,GAA4B;IACtE,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAC/B,MAAM,CAAC,GAAG,QAAQ,CAAE,KAAiC,CAAC,IAAI,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,iCAAiC;IAC/C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEhD,OAAO;QACL;;;;WAIG;QACH,OAAO,CAAC,GAAW,EAAE,YAAoB;YACvC,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAE7C,IAAI,YAAY,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,YAAY,GAAG,QAAQ,EAAE,CAAC;gBAChE,OAAO,IAAI,CAAC;YACd,CAAC;YAED,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;gBACrB,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YACvC,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC;QAED,sEAAsE;QACtE,WAAW,CAAC,GAAW;YACrB,OAAO,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/logger/dsl.d.ts

@@ -0,0 +1,8 @@
+/**
+ * DSL logger instance. DSL code imports from here.
+ */
+import { type LogLevel } from "../logger.js";
+export type { LogLevel };
+export { setLogLevel } from "../logger.js";
+export declare const logger: import("../logger.js").Logger;
+//# sourceMappingURL=dsl.d.ts.map

package/dist/utils/logger/dsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl.d.ts","sourceRoot":"","sources":["../../../src/utils/logger/dsl.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE3D,YAAY,EAAE,QAAQ,EAAE,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,eAAO,MAAM,MAAM,+BAAoC,CAAC"}

package/dist/utils/logger/dsl.js

@@ -0,0 +1,7 @@
+/**
+ * DSL logger instance. DSL code imports from here.
+ */
+import { createLogger } from "../logger.js";
+export { setLogLevel } from "../logger.js";
+export const logger = createLogger("[senpi-core][dsl]");
+//# sourceMappingURL=dsl.js.map

package/dist/utils/logger/dsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl.js","sourceRoot":"","sources":["../../../src/utils/logger/dsl.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAiB,MAAM,cAAc,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared structured logger factory. Components create a logger with a namespace.
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export declare function setLogLevel(level: LogLevel): void;
+export interface ErrorNotificationPayload {
+    namespace: string;
+    level: "error";
+    message: string;
+    meta?: unknown;
+    timestamp: string;
+}
+export type ErrorNotifier = (payload: ErrorNotificationPayload) => void | Promise<void>;
+export declare function setErrorNotifier(notifier: ErrorNotifier | null): void;
+export declare function clearErrorNotifier(): void;
+export interface Logger {
+    debug(message: string, meta?: unknown): void;
+    info(message: string, meta?: unknown): void;
+    warn(message: string, meta?: unknown): void;
+    error(message: string, meta?: unknown): void;
+}
+export declare function createLogger(namespace: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAa3D,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,wBAAwB,KAC9B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAErE;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAMD,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9C;AAkBD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA8CtD"}

package/dist/utils/logger.js

@@ -0,0 +1,97 @@
+/**
+ * Shared structured logger factory. Components create a logger with a namespace.
+ */
+const levelOrder = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+let minLevel = "info";
+let errorNotifier = null;
+let notifyingError = false;
+export function setLogLevel(level) {
+    minLevel = level;
+}
+export function setErrorNotifier(notifier) {
+    errorNotifier = notifier;
+}
+export function clearErrorNotifier() {
+    errorNotifier = null;
+}
+function shouldLog(level) {
+    return levelOrder[level] >= levelOrder[minLevel];
+}
+function dispatchErrorNotification(payload) {
+    const notifier = errorNotifier;
+    if (notifier == null || notifyingError)
+        return;
+    void (async () => {
+        notifyingError = true;
+        try {
+            await notifier(payload);
+        }
+        catch {
+            // Intentionally swallow notifier failures to keep error logging safe.
+        }
+        finally {
+            notifyingError = false;
+        }
+    })();
+}
+export function createLogger(namespace) {
+    return {
+        debug(message, meta) {
+            if (!shouldLog("debug"))
+                return;
+            const prefix = `${namespace} [debug]`;
+            if (meta !== undefined) {
+                console.log(prefix, message, meta);
+            }
+            else {
+                console.log(prefix, message);
+            }
+        },
+        info(message, meta) {
+            if (!shouldLog("info"))
+                return;
+            const prefix = `${namespace} [info]`;
+            if (meta !== undefined) {
+                console.log(prefix, message, meta);
+            }
+            else {
+                console.log(prefix, message);
+            }
+        },
+        warn(message, meta) {
+            if (!shouldLog("warn"))
+                return;
+            const prefix = `${namespace} [warn]`;
+            if (meta !== undefined) {
+                console.warn(prefix, message, meta);
+            }
+            else {
+                console.warn(prefix, message);
+            }
+        },
+        error(message, meta) {
+            if (!shouldLog("error"))
+                return;
+            const prefix = `${namespace} [error]`;
+            if (meta !== undefined) {
+                console.error(prefix, message, meta);
+            }
+            else {
+                console.error(prefix, message);
+            }
+            dispatchErrorNotification({
+                namespace,
+                level: "error",
+                message,
+                meta,
+                timestamp: new Date().toISOString(),
+            });
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/perp-coin.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Perp symbol helpers for DSL state (base coin + dex bucket) vs Senpi wire format.
+ */
+/**
+ * Map clearing-house bucket keys to DSL / reconcile dex (main book → empty string).
+ * Matches `SenpiClient.listOpenPositions` / `openPositionsFromClearingHouseState` in the Senpi client.
+ */
+export declare function reconcileDexFromClearingHouseKey(dexKey: string): string;
+/** DSL state and reconcile: base symbol + dex (no `xyz:` prefix on coin). */
+export declare function normalizeDslCoinDex(coin: string, dex: string): {
+    coin: string;
+    dex: string;
+};
+/**
+ * Wire format for Senpi order/close/edit when on the xyz book (`xyz:BASE`).
+ * Main book returns plain `BTC`, etc.
+ */
+export declare function canonicalPerpCoin(coin: string, dex: string): string;
+//# sourceMappingURL=perp-coin.d.ts.map

package/dist/utils/perp-coin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perp-coin.d.ts","sourceRoot":"","sources":["../../src/utils/perp-coin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOvE;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAS5F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGnE"}

package/dist/utils/perp-coin.js

@@ -0,0 +1,40 @@
+/**
+ * Perp symbol helpers for DSL state (base coin + dex bucket) vs Senpi wire format.
+ */
+/**
+ * Map clearing-house bucket keys to DSL / reconcile dex (main book → empty string).
+ * Matches `SenpiClient.listOpenPositions` / `openPositionsFromClearingHouseState` in the Senpi client.
+ */
+export function reconcileDexFromClearingHouseKey(dexKey) {
+    const k = dexKey.trim();
+    if (k === "")
+        return "";
+    const lower = k.toLowerCase();
+    if (lower === "main")
+        return "";
+    if (lower === "xyz")
+        return "xyz";
+    return k;
+}
+/** DSL state and reconcile: base symbol + dex (no `xyz:` prefix on coin). */
+export function normalizeDslCoinDex(coin, dex) {
+    let c = coin.trim();
+    let d = (dex ?? "").trim();
+    if (d.toLowerCase() === "main")
+        d = "";
+    if (c.startsWith("xyz:")) {
+        c = c.slice(4);
+        if (!d)
+            d = "xyz";
+    }
+    return { coin: c, dex: d };
+}
+/**
+ * Wire format for Senpi order/close/edit when on the xyz book (`xyz:BASE`).
+ * Main book returns plain `BTC`, etc.
+ */
+export function canonicalPerpCoin(coin, dex) {
+    const { coin: base, dex: d } = normalizeDslCoinDex(coin, dex);
+    return d === "xyz" ? `xyz:${base}` : base;
+}
+//# sourceMappingURL=perp-coin.js.map

package/dist/utils/perp-coin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perp-coin.js","sourceRoot":"","sources":["../../src/utils/perp-coin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAAC,MAAc;IAC7D,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACxB,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IAChC,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAClC,OAAO,CAAC,CAAC;AACX,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,GAAW;IAC3D,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACpB,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM;QAAE,CAAC,GAAG,EAAE,CAAC;IACvC,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACf,IAAI,CAAC,CAAC;YAAE,CAAC,GAAG,KAAK,CAAC;IACpB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,GAAW;IACzD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,mBAAmB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9D,OAAO,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC"}

package/dist/utils/response.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared response helpers: envelope unwrapping and type coercion.
+ * Used by senpi client, LLM decision, and scanner adapters.
+ */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/**
+ * Unwraps `{ success, data }` envelopes when present.
+ * When inner data is a record, preserves top-level success/error/message on it so callers do not lose them.
+ * Non-envelope payloads are returned unchanged.
+ */
+export declare function unwrapEnvelope<T>(input: unknown): T | unknown;
+export declare function asString(value: unknown): string | null;
+export declare function asNumber(value: unknown): number | null;
+//# sourceMappingURL=response.d.ts.map