@senpi/trading-recipe 1.0.21

package/dist/strategy/strategy-state.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 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 type { SenpiClient } from "../senpi/client.js";
+import type { StrategyConfig, StrategyState, ClearinghouseState, OpenPosition, PastTrade, OpenOrder, StrategyDetails } from "../types/strategy.js";
+import type { CreatePositionRequest, CreatePositionResult, EditPositionResult } from "../senpi/types.js";
+export declare class StrategyStateImpl implements StrategyState {
+    private senpi;
+    readonly address: string;
+    readonly config: StrategyConfig;
+    private _clearinghouse;
+    private _openOrders;
+    private _pastTrades;
+    private _details;
+    constructor(config: StrategyConfig, senpi: SenpiClient);
+    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>;
+}
+//# sourceMappingURL=strategy-state.d.ts.map

package/dist/strategy/strategy-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-state.d.ts","sourceRoot":"","sources":["../../src/strategy/strategy-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,SAAS,EACT,SAAS,EACT,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAMzG,qBAAa,iBAAkB,YAAW,aAAa;IAWnD,OAAO,CAAC,KAAK;IAVf,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAEhC,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,QAAQ,CAA8B;gBAG5C,MAAM,EAAE,cAAc,EACd,KAAK,EAAE,WAAW;IAQ5B,qBAAqB,IAAI,kBAAkB,GAAG,SAAS;IAIvD,gBAAgB,IAAI,YAAY,EAAE,GAAG,SAAS;IAI9C,aAAa,IAAI,SAAS,EAAE,GAAG,SAAS;IAIxC,aAAa,IAAI,SAAS,EAAE,GAAG,SAAS;IAIxC,iBAAiB,IAAI,MAAM;IAK3B,UAAU,IAAI,eAAe,GAAG,SAAS;IAIzC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO;IAQ9C,uBAAuB,IAAI,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAelE,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;IAWxI,eAAe,IAAI,OAAO,CAAC,SAAS,EAAE,GAAG,SAAS,CAAC;IAWnD,YAAY,IAAI,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAiBpD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAWxB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3E,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAI5E,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;CAG3H"}

package/dist/strategy/strategy-state.js

@@ -0,0 +1,185 @@
+/**
+ * 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;
+    }
+    hasOpenPosition(coin, dex) {
+        const positions = this._clearinghouse?.positions;
+        if (!positions)
+            return false;
+        return positions.some(p => p.coin === coin && (!dex || p.dex === dex));
+    }
+    // ── 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,215 @@
+/**
+ * DSL plugin types: config, state, events, DslTick result.
+ */
+export interface DslTier {
+    triggerPct: number;
+    /** Fixed ROE mode: % of (entry → HW) range to lock. Omit when using lockHwPct. */
+    lockPct?: number;
+    /** HW mode: % of highWaterRoe to lock as floor at this tier (0–100). Omit when using lockPct. */
+    lockHwPct?: 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 Phase1HardTimeout {
+    enabled: boolean;
+    intervalInMinutes: number;
+}
+export interface Phase1WeakPeakCut {
+    enabled: boolean;
+    intervalInMinutes: number;
+    /** ROE % threshold (absolute, e.g. 3.0 = 3%). */
+    minValue: number;
+}
+export interface Phase1DeadWeightCut {
+    enabled: boolean;
+    intervalInMinutes: number;
+}
+export interface DslPhase1Config {
+    retraceThreshold: number;
+    absoluteFloor: number;
+    consecutiveBreachesRequired: number;
+    hardTimeout?: Phase1HardTimeout;
+    weakPeakCut?: Phase1WeakPeakCut;
+    deadWeightCut?: Phase1DeadWeightCut;
+}
+export interface DslPhase2Config {
+    retraceFromHW: number;
+    consecutiveBreachesRequired: number;
+}
+/** Floor lock mode: fixedRoe (lockPct) or pctOfHighWater (lockHwPct). CamelCase per TypeScript convention. */
+export type DslLockMode = "fixedRoe" | "pctOfHighWater";
+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;
+    /** Floor lock mode: fixedRoe (lockPct) or pctOfHighWater (lockHwPct). Default pctOfHighWater. */
+    lockMode?: DslLockMode;
+    phase1HardTimeout?: Phase1HardTimeout;
+    phase1WeakPeakCut?: Phase1WeakPeakCut;
+    phase1DeadWeightCut?: Phase1DeadWeightCut;
+}
+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;
+    /** ROE % at high-water (computed every tick). */
+    highWaterRoe: number;
+    /** Lock mode for tier floors (from preset). */
+    lockMode: DslLockMode;
+    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;
+    /** ROE % at current price (computed every tick). */
+    currentROE: number;
+    /** Phase 2: hw * (1 - retrace/100). Phase 1: equals absoluteFloor. */
+    trailingFloor: number;
+    /** Price distance to effective floor (LONG: lastPrice - floorPrice; SHORT: floorPrice - lastPrice). */
+    distanceToFloor: number;
+    /** distanceToFloor / floorPrice * 100. */
+    distancePct: number;
+    /** Retrace from HW: LONG (hw-price)/hw*100; SHORT (price-hw)/hw*100. */
+    retracePct: number;
+    /** Minutes since createdAt. */
+    elapsedMinutes: number;
+    /** Effective consecutive breaches required (tier override or phase default). */
+    breachesRequired: number;
+    /** ROE % to next tier trigger; null at max tier. */
+    distanceToNextTierPct: number | null;
+    /** Tier floor as ROE %; 0 when no tier. */
+    lockedProfitPct: number;
+    /** ISO timestamp when current phase started. */
+    phaseSince: string;
+    /** ISO timestamp when current tier was entered; null until first tier. */
+    tierSince: 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;
+    /** True when floorPrice moved this tick (used by monitor for SL sync in HW mode). */
+    floorChanged?: boolean;
+    /** Set when action === "close" (e.g. phase1_timeout, weak_peak_cut). */
+    closeReason?: string;
+}
+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;
+    /** Present when tier uses HW mode (lockHwPct). */
+    lockHwPct?: 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":"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"}

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