@senpi/trading-runtime 1.0.0

package/dist/strategy/strategy-state.js

@@ -0,0 +1,179 @@
+/**
+ * StrategyStateImpl — live, lazy-loading domain object backed by SenpiClient MCP calls.
+ *
+ * Design: fetch*() always hit MCP and update internal state.
+ *         get*() sync getters return whatever was last fetched.
+ *         The caller decides when freshness matters.
+ */
+import { isRecord, asNumber, asString } from "../utils/response.js";
+import { createLogger } from "../utils/logger.js";
+const logger = createLogger("[strategy][state]");
+export class StrategyStateImpl {
+    senpi;
+    address;
+    config;
+    _clearinghouse;
+    _openOrders;
+    _pastTrades;
+    _details;
+    constructor(config, senpi) {
+        this.senpi = senpi;
+        this.address = config.address;
+        this.config = config;
+    }
+    // ── Sync getters ──────────────────────────────────────────────────────────
+    getClearinghouseState() {
+        return this._clearinghouse;
+    }
+    getOpenPositions() {
+        return this._clearinghouse?.positions;
+    }
+    getPastTrades() {
+        return this._pastTrades;
+    }
+    getOpenOrders() {
+        return this._openOrders;
+    }
+    getAvailableSlots() {
+        const openCount = this._clearinghouse?.positions.length ?? 0;
+        return Math.max(0, this.config.slots - openCount);
+    }
+    getDetails() {
+        return this._details;
+    }
+    // ── Async fetchers ────────────────────────────────────────────────────────
+    async fetchClearinghouseState() {
+        try {
+            const raw = await this.senpi.getClearingHouseState(this.address);
+            if (!raw) {
+                this._clearinghouse = undefined;
+                return undefined;
+            }
+            this._clearinghouse = parseClearinghouseState(raw);
+            return this._clearinghouse;
+        }
+        catch (err) {
+            logger.error("fetchClearinghouseState failed", { address: this.address, err });
+            return this._clearinghouse;
+        }
+    }
+    async fetchPastTrades(opts) {
+        try {
+            const entries = await this.senpi.getTraderHistory(this.address, opts);
+            this._pastTrades = entries;
+            return this._pastTrades;
+        }
+        catch (err) {
+            logger.error("fetchPastTrades failed", { address: this.address, err });
+            return this._pastTrades;
+        }
+    }
+    async fetchOpenOrders() {
+        try {
+            const entries = await this.senpi.getOpenOrders(this.address);
+            this._openOrders = entries;
+            return this._openOrders;
+        }
+        catch (err) {
+            logger.error("fetchOpenOrders failed", { address: this.address, err });
+            return this._openOrders;
+        }
+    }
+    async fetchDetails() {
+        try {
+            const result = await this.senpi.getStrategy(this.address);
+            if (!result) {
+                this._details = undefined;
+                return undefined;
+            }
+            this._details = result;
+            return this._details;
+        }
+        catch (err) {
+            logger.error("fetchDetails failed", { address: this.address, err });
+            return this._details;
+        }
+    }
+    // ── Convenience ───────────────────────────────────────────────────────────
+    async refresh() {
+        await Promise.all([
+            this.fetchClearinghouseState(),
+            this.fetchPastTrades(),
+            this.fetchOpenOrders(),
+            this.fetchDetails(),
+        ]);
+    }
+    // ── Position/Order management ─────────────────────────────────────────────
+    async cancelOrder(orderId) {
+        return this.senpi.cancelOrder(this.address, orderId);
+    }
+    async closePosition(coin, reason, dex) {
+        return this.senpi.closePosition(this.address, coin, { reason, dex });
+    }
+    async createPosition(params) {
+        return this.senpi.createPosition(params);
+    }
+    async editPosition(payload) {
+        return this.senpi.editPosition(this.address, payload);
+    }
+}
+// ─── Clearinghouse response parsing ──────────────────────────────────────────
+/**
+ * Parse the raw clearinghouse state response into a structured ClearinghouseState.
+ * Response shape: { main: { assetPositions, crossMarginSummary, withdrawable }, xyz: { ... } }
+ */
+function parseClearinghouseState(raw) {
+    let accountValue = 0;
+    let totalMarginUsed = 0;
+    let totalUnrealizedPnl = 0;
+    let totalNtlPos = 0;
+    let withdrawable = 0;
+    const positions = [];
+    for (const [dexKey, dexVal] of Object.entries(raw)) {
+        if (!isRecord(dexVal))
+            continue;
+        const dexObj = dexVal;
+        // Account summary from crossMarginSummary
+        const summary = dexObj.crossMarginSummary;
+        if (isRecord(summary)) {
+            const s = summary;
+            accountValue += asNumber(s.accountValue) ?? 0;
+            totalMarginUsed += asNumber(s.totalMarginUsed) ?? 0;
+            totalUnrealizedPnl += asNumber(s.totalUnrealizedPnl) ?? 0;
+            totalNtlPos += asNumber(s.totalNtlPos) ?? 0;
+        }
+        withdrawable += asNumber(dexObj.withdrawable) ?? 0;
+        // Positions from assetPositions
+        const assetPositions = dexObj.assetPositions;
+        if (!Array.isArray(assetPositions))
+            continue;
+        for (const item of assetPositions) {
+            if (!isRecord(item))
+                continue;
+            const pos = isRecord(item.position) ? item.position : item;
+            const szi = asNumber(pos.szi) ?? 0;
+            if (szi === 0)
+                continue;
+            const coin = asString(pos.coin) ?? "";
+            const entryPx = asNumber(pos.entryPx) ?? 0;
+            let leverage = asNumber(pos.leverage);
+            if (leverage == null && isRecord(pos.leverage)) {
+                leverage = asNumber(pos.leverage.value);
+            }
+            leverage = leverage ?? 0;
+            positions.push({
+                coin,
+                dex: dexKey,
+                szi,
+                entryPx,
+                leverage,
+                unrealizedPnl: asNumber(pos.unrealizedPnl) ?? 0,
+                marginUsed: asNumber(pos.marginUsed) ?? 0,
+                liquidationPx: asNumber(pos.liquidationPx) ?? null,
+                returnOnEquity: asNumber(pos.returnOnEquity) ?? 0,
+            });
+        }
+    }
+    return { accountValue, totalMarginUsed, totalUnrealizedPnl, totalNtlPos, withdrawable, positions };
+}
+//# sourceMappingURL=strategy-state.js.map

package/dist/strategy/strategy-state.js.map

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

package/dist/types/action.d.ts

@@ -0,0 +1,15 @@
+export interface StateManager {
+    get<T>(key: string): T | undefined;
+    set(key: string, value: unknown): void;
+    /** Keys in the returned record are strategy addresses (wallet). */
+    getUsedSlotsByStrategy(addresses: string[]): Record<string, number>;
+}
+export interface GateCheckResult {
+    gate: 'OPEN' | 'COOLDOWN' | 'CLOSED';
+    reason?: string;
+}
+export interface RiskGuard {
+    checkGate(address: string, guardRails?: Record<string, unknown>): GateCheckResult;
+    recordEntry(address: string, guardRails?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=action.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/types/action.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,mEAAmE;IACnE,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAAC;IAClF,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1E"}

package/dist/types/action.js

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

package/dist/types/action.js.map

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

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

@@ -0,0 +1,156 @@
+/**
+ * DSL plugin types: config, state, events, DslTick result.
+ */
+export interface DslTier {
+    triggerPct: number;
+    lockPct: number;
+    /** Consecutive breaches required (global default can be overridden per tier). */
+    breaches: number;
+    /** Phase 2 only: % retrace from high-water for floor at this tier (overrides global phase2 retrace). */
+    retraceFromHW?: number;
+}
+export interface DslPhase1Config {
+    retraceThreshold: number;
+    absoluteFloor: number;
+    consecutiveBreachesRequired: number;
+}
+export interface DslPhase2Config {
+    retraceFromHW: number;
+    consecutiveBreachesRequired: number;
+}
+export interface DslPresetConfig {
+    tiers: DslTier[];
+    maxLossPct: number;
+    /** Tier index at which phase 2 starts (default 0). */
+    phase2TriggerTier?: number;
+    /** Phase 2 floor as % retrace from high-water (default derived from first tier). */
+    phase2RetraceFromHW?: number;
+    /** Phase 1 consecutive breaches required (default from constants). */
+    phase1BreachesRequired?: number;
+    /** Phase 2 consecutive breaches required (default from constants). */
+    phase2BreachesRequired?: number;
+}
+export interface DslPluginConfig {
+    intervalMs: number;
+    preset: string;
+    presets: Record<string, DslPresetConfig>;
+}
+export interface DslState {
+    version: number;
+    asset: string;
+    address: string;
+    direction: "LONG" | "SHORT";
+    entryPrice: number;
+    size: number;
+    leverage: number;
+    wallet: string;
+    dex: string;
+    highWaterPrice: number;
+    hwTimestamp: string;
+    phase: 1 | 2;
+    currentBreachCount: number;
+    currentTierIndex: number | null;
+    tierFloorPrice: number;
+    floorPrice: number;
+    tiers: DslTier[];
+    phase1: DslPhase1Config;
+    phase2: DslPhase2Config;
+    phase2TriggerTier: number;
+    slOrderId: number | null;
+    lastSyncedFloorPrice: number | null;
+    slOrderIdUpdatedAt: string | null;
+    lastSlSyncError: string | null;
+    pendingClose: boolean;
+    active: boolean;
+    createdAt: string;
+    lastCheck: string;
+    lastPrice: number;
+    consecutiveFetchFailures: number;
+    tickCount: number;
+    peakROE: number;
+    lastError: string | null;
+    lastErrorAt: string | null;
+    closedAt: string | null;
+    closeReason: string | null;
+}
+export type DslTickAction = "none" | "close";
+export interface DslTickResult {
+    tierChanged: boolean;
+    phaseChanged: boolean;
+    action: DslTickAction;
+    newFloorPrice?: number;
+    newTierIndex?: number;
+    newPhase?: 1 | 2;
+    state: DslState;
+}
+export interface PositionOpenedEvent {
+    address: string;
+    wallet: string;
+    dex: string;
+    preset?: string;
+    coin: string;
+    szi: string;
+    entryPx: string;
+    leverage: number;
+}
+export interface PositionClosedEvent {
+    address: string;
+    asset: string;
+    wallet: string;
+}
+export interface PositionFlippedEvent {
+    address: string;
+    asset: string;
+    wallet: string;
+    dex: string;
+    coin: string;
+    szi: string;
+    entryPx: string;
+    leverage: number;
+}
+export interface DslCreatedEvent {
+    address: string;
+    asset: string;
+    preset: string;
+    tiers: DslTier[];
+    floorPrice: number;
+    timestamp: string;
+}
+export interface DslPhaseChangedEvent {
+    address: string;
+    asset: string;
+    phase: 1 | 2;
+    tierIndex: number;
+    timestamp: string;
+}
+export interface DslTierAdvancedEvent {
+    address: string;
+    asset: string;
+    tier: number;
+    lockPct: number;
+    triggerPct: number;
+    newFloorPrice: number;
+    timestamp: string;
+}
+export interface DslSlUpdatedEvent {
+    address: string;
+    asset: string;
+    newSLPrice: number;
+    slOrderId: number;
+    timestamp: string;
+}
+export interface DslClosedEvent {
+    address: string;
+    asset: string;
+    reason: "sl_hit" | "manual_close" | "dsl_breach" | "strategy_close" | "error";
+    closeReason: string;
+    timestamp: string;
+}
+export interface DslSettingsUpdatedEvent {
+    address: string;
+    asset?: string;
+    updated?: string[];
+    timestamp: string;
+}
+export type { EditPositionResult } from "../../senpi/types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/dsl/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,OAAO;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,wGAAwG;IACxG,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oFAAoF;IACpF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sEAAsE;IACtE,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sEAAsE;IACtE,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IACb,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB,EAAE,MAAM,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,cAAc,GAAG,YAAY,GAAG,gBAAgB,GAAG,OAAO,CAAC;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/types/dsl/index.js

@@ -0,0 +1,5 @@
+/**
+ * DSL plugin types: config, state, events, DslTick result.
+ */
+export {};
+//# sourceMappingURL=index.js.map

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

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

package/dist/types/event-bus.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Event bus contract (matches @senpi/playbook).
+ * Shared by runtime and DSL so runtime does not depend on DSL internals.
+ */
+export interface SenpiEventBus {
+    emit(eventName: string, payload?: unknown): void;
+    on(eventName: string, handler: (payload?: unknown) => void): void;
+    /** Remove all listeners. Call on shutdown to prevent zombie handlers. */
+    removeAllListeners?(): void;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/types/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/types/event-bus.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACjD,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAClE,yEAAyE;IACzE,kBAAkB,CAAC,IAAI,IAAI,CAAC;CAC7B"}

package/dist/types/event-bus.js

@@ -0,0 +1,6 @@
+/**
+ * Event bus contract (matches @senpi/playbook).
+ * Shared by runtime and DSL so runtime does not depend on DSL internals.
+ */
+export {};
+//# sourceMappingURL=event-bus.js.map

package/dist/types/event-bus.js.map

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

package/dist/types/hooks.d.ts

@@ -0,0 +1,27 @@
+/** Canonical hook event name constants. Use these instead of string literals. */
+export declare const HOOK_EVENT: {
+    readonly ON_SIGNAL_DETECTED: "on_signal_detected";
+    readonly ON_POSITION_OPENED: "on_position_opened";
+    readonly ON_POSITION_CLOSED: "on_position_closed";
+    readonly ON_POSITION_FLIPPED: "on_position_flipped";
+    readonly ON_TIER_CHANGED: "on_tier_changed";
+    readonly ON_DAILY_LIMIT_HIT: "on_daily_limit_hit";
+    readonly ON_DRAWDOWN_CAP_HIT: "on_drawdown_cap_hit";
+    readonly ON_CONSECUTIVE_LOSSES: "on_consecutive_losses";
+    readonly ON_POSITION_AT_RISK: "on_position_at_risk";
+    readonly ON_SCHEDULE: "on_schedule";
+};
+export type HookEventType = (typeof HOOK_EVENT)[keyof typeof HOOK_EVENT] | string;
+/** Strategy identifier in events is the wallet address (platform id). */
+export interface HookEvent {
+    type: HookEventType;
+    tradingStrategyName: string;
+    address: string;
+    data: Record<string, unknown>;
+    timestamp: string;
+}
+export interface HookSystem {
+    fire(event: HookEvent): Promise<void>;
+    on(eventType: HookEventType, handler: (event: HookEvent) => Promise<void>): void;
+}
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/types/hooks.ts"],"names":[],"mappings":"AAEA,iFAAiF;AACjF,eAAO,MAAM,UAAU;;;;;;;;;;;CAWb,CAAC;AAEX,MAAM,MAAM,aAAa,GACrB,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,GAC5C,MAAM,CAAC;AAEX,yEAAyE;AACzE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAClF"}

package/dist/types/hooks.js

@@ -0,0 +1,15 @@
+// ─── Hook Event System ──────────────────────────────────────────────────────
+/** Canonical hook event name constants. Use these instead of string literals. */
+export const HOOK_EVENT = {
+    ON_SIGNAL_DETECTED: "on_signal_detected",
+    ON_POSITION_OPENED: "on_position_opened",
+    ON_POSITION_CLOSED: "on_position_closed",
+    ON_POSITION_FLIPPED: "on_position_flipped",
+    ON_TIER_CHANGED: "on_tier_changed",
+    ON_DAILY_LIMIT_HIT: "on_daily_limit_hit",
+    ON_DRAWDOWN_CAP_HIT: "on_drawdown_cap_hit",
+    ON_CONSECUTIVE_LOSSES: "on_consecutive_losses",
+    ON_POSITION_AT_RISK: "on_position_at_risk",
+    ON_SCHEDULE: "on_schedule",
+};
+//# sourceMappingURL=hooks.js.map

package/dist/types/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/types/hooks.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,iFAAiF;AACjF,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,kBAAkB,EAAE,oBAAoB;IACxC,kBAAkB,EAAE,oBAAoB;IACxC,kBAAkB,EAAE,oBAAoB;IACxC,mBAAmB,EAAE,qBAAqB;IAC1C,eAAe,EAAE,iBAAiB;IAClC,kBAAkB,EAAE,oBAAoB;IACxC,mBAAmB,EAAE,qBAAqB;IAC1C,qBAAqB,EAAE,uBAAuB;IAC9C,mBAAmB,EAAE,qBAAqB;IAC1C,WAAW,EAAE,aAAa;CAClB,CAAC"}

package/dist/types/index.d.ts

@@ -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.d.ts.map

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,16 @@
+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";
+export interface RuntimeContext {
+    senpi: SenpiClient;
+    hookSystem: HookSystem;
+    llmDecision: LlmDecision;
+    contextBuilder: ContextBuilder;
+    riskGuard: RiskGuard;
+    notifications: NotificationService;
+    strategyStates: Map<string, StrategyState>;
+    scannerModule?: ScannerRuntimeModule;
+}
+//# 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;AAEzE,MAAM,WAAW,cAAc;IAC9B,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,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC3C,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC"}

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"}