@senpi/trading-runtime 1.0.0

package/dist/actions/llm-decision/shared.js.map

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

package/dist/actions/open-position/open-position.action.d.ts

@@ -0,0 +1,15 @@
+import type { Action, ActionConfig, ActionFactory, ActionManifest, ActionResult, HookEvent } from '../types.js';
+import { RuntimeContext } from 'src/types/runtime.js';
+export declare class OpenPositionAction implements Action {
+    private config;
+    private context;
+    readonly name: string;
+    readonly actionType: "OPEN_POSITION";
+    private decisionEngine;
+    constructor(config: ActionConfig, context: RuntimeContext);
+    handle(event: HookEvent): Promise<ActionResult>;
+    private parsePayload;
+}
+export declare const openPositionFactory: ActionFactory;
+export declare const openPositionManifest: ActionManifest;
+//# sourceMappingURL=open-position.action.d.ts.map

package/dist/actions/open-position/open-position.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-position.action.d.ts","sourceRoot":"","sources":["../../../src/actions/open-position/open-position.action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EAGZ,aAAa,EACb,cAAc,EACd,YAAY,EAEZ,SAAS,EAGV,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAmBtD,qBAAa,kBAAmB,YAAW,MAAM;IAO7C,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IAPjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAG,eAAe,CAAU;IAE/C,OAAO,CAAC,cAAc,CAAiB;gBAG7B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,cAAc;IAQ3B,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC;IAmRrD,OAAO,CAAC,YAAY;CAoBrB;AAID,eAAO,MAAM,mBAAmB,EAAE,aACO,CAAC;AAE1C,eAAO,MAAM,oBAAoB,EAAE,cAMlC,CAAC"}

package/dist/actions/open-position/open-position.action.js

@@ -0,0 +1,302 @@
+import { DecisionEngine, LlmDecisionStrategy, NoDecisionStrategy } from '../decision-engine.js';
+import { HOOK_EVENT } from '../../types/hooks.js';
+import { interpolatePrompt } from '../../context/interpolate.js';
+import { createLogger } from '../../utils/logger.js';
+const logger = createLogger("[actions][open-position]");
+// ─── Open Position Action ───────────────────────────────────────────────────
+export class OpenPositionAction {
+    config;
+    context;
+    name;
+    actionType = 'OPEN_POSITION';
+    decisionEngine;
+    constructor(config, context) {
+        this.config = config;
+        this.context = context;
+        this.name = config.name;
+        this.decisionEngine = new DecisionEngine();
+        this.decisionEngine.register(new LlmDecisionStrategy(context.llmDecision));
+        this.decisionEngine.register(new NoDecisionStrategy());
+    }
+    async handle(event) {
+        logger.info('handling open position', event);
+        //check event type is on_signal_detected
+        if (event.type !== HOOK_EVENT.ON_SIGNAL_DETECTED) {
+            return {
+                success: false,
+                action_type: this.actionType,
+                summary: 'Invalid event type',
+                error: 'invalid_event_type',
+            };
+        }
+        const address = event.address;
+        const scanResult = event.data.scanResult;
+        if (!scanResult || !scanResult.signals || scanResult.signals.length === 0) {
+            logger.error('no signal', scanResult);
+            return {
+                success: false,
+                action_type: this.actionType,
+                summary: 'No signal',
+                error: 'no_signal',
+            };
+        }
+        if (scanResult.address !== address) {
+            return {
+                success: false,
+                action_type: this.actionType,
+                summary: 'Signal address does not match event address',
+                error: 'signal_address_mismatch',
+            };
+        }
+        //get strategy state
+        const strategyState = this.context.strategyStates.get(address);
+        if (!strategyState) {
+            return {
+                success: false,
+                action_type: this.actionType,
+                summary: 'Unknown strategy',
+                error: 'unknown_strategy',
+            };
+        }
+        // Early exit: no signals
+        if (!strategyState.getAvailableSlots?.()) {
+            return {
+                success: true,
+                action_type: this.actionType,
+                summary: 'No slots available',
+                skipped: true,
+                skipReason: 'no_slots',
+            };
+        }
+        logger.info('building context');
+        // Build context
+        const providerRequest = {
+            event,
+            address: event.address,
+            strategyState,
+            scannerModule: this.context.scannerModule,
+        };
+        const contextData = this.config.context?.length
+            ? await this.context.contextBuilder.build(this.config.context, providerRequest)
+            : {};
+        logger.info('context data', contextData);
+        // Interpolate prompt template with resolved context + action params
+        const interpolatedPrompt = this.config.decision_prompt
+            ? interpolatePrompt(this.config.decision_prompt, {
+                ...contextData,
+                ...(this.config.params ?? {}),
+            })
+            : undefined;
+        // Get decision
+        let decision;
+        try {
+            decision = await this.decisionEngine.decide(this.config.decision_mode, {
+                prompt: interpolatedPrompt,
+                context: { ...contextData, scanResult },
+                model: this.config.decision_model,
+                actionType: this.actionType,
+                event,
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error('decision error', message);
+            return {
+                success: false,
+                action_type: this.actionType,
+                summary: `Decision failed: ${message}`,
+                error: message,
+            };
+        }
+        logger.info('decision', decision);
+        // Check decision
+        if (!decision.execute) {
+            logger.info('decision no execute', decision);
+            return {
+                success: true,
+                action_type: this.actionType,
+                summary: `Decision: no execute — ${decision.reasoning}`,
+                skipped: true,
+                skipReason: 'decision_no_execute',
+                data: { confidence: decision.confidence, reasoning: decision.reasoning },
+            };
+        }
+        // Check confidence threshold
+        const minConfidence = this.config.min_confidence ?? 1;
+        if (decision.confidence < minConfidence) {
+            logger.info('confidence below threshold', { confidence: decision.confidence, threshold: minConfidence });
+            return {
+                success: true,
+                action_type: this.actionType,
+                summary: `Confidence ${decision.confidence} below threshold ${minConfidence}`,
+                skipped: true,
+                skipReason: 'below_confidence',
+                data: { confidence: decision.confidence, threshold: minConfidence },
+            };
+        }
+        // Parse payload
+        const payload = this.parsePayload(decision.payload, event.address);
+        logger.info('payload', payload);
+        if (!payload) {
+            return {
+                success: false,
+                action_type: this.actionType,
+                summary: 'Invalid decision payload: missing strategy, asset, or direction',
+                error: 'invalid_payload',
+            };
+        }
+        // Resolve strategy from payload (validates the LLM's choice exists)
+        const strategy = this.context.strategyStates.get(payload.strategy);
+        logger.info('strategy', strategy);
+        if (!strategy) {
+            return {
+                success: false,
+                action_type: this.actionType,
+                summary: `Unknown strategy: ${payload.strategy}`,
+                error: 'unknown_strategy',
+            };
+        }
+        // Only the strategy that produced the scan can spend its budget
+        if (payload.strategy !== event.address) {
+            return {
+                success: true,
+                action_type: this.actionType,
+                summary: `Decision payload strategy "${payload.strategy}" must match scan address "${event.address}"`,
+                skipped: true,
+                skipReason: 'strategy_mismatch',
+                data: { payloadStrategy: payload.strategy, eventAddress: event.address },
+            };
+        }
+        logger.info('risk guard check');
+        // Risk guard check
+        const gate = this.context.riskGuard.checkGate(event.address);
+        if (gate.gate !== 'OPEN') {
+            return {
+                success: true,
+                action_type: this.actionType,
+                summary: `Risk gate ${gate.gate}: ${gate.reason ?? 'blocked'}`,
+                skipped: true,
+                skipReason: 'risk_gate',
+                data: { gate: gate.gate, reason: gate.reason },
+            };
+        }
+        logger.info('risk guard passed');
+        const leverage = strategy.config.defaultLeverage ?? 2; //todo fix dynamic leverage
+        logger.info('leverage', leverage);
+        const marginAmount = strategy.config.marginPerSlot ?? strategy.config.budget / strategy.config.slots;
+        logger.info('margin amount', marginAmount);
+        // Create position via Senpi client
+        try {
+            logger.info('creating position');
+            const result = await this.context.senpi.createPosition({
+                strategyWalletAddress: strategy.config.address,
+                orders: [
+                    {
+                        coin: payload.asset,
+                        direction: payload.direction,
+                        leverage,
+                        marginAmount,
+                        orderType: 'MARKET', //todo fix
+                    },
+                ],
+                reason: decision.reasoning,
+            });
+            if (!result.success) {
+                logger.error('position creation failed', result);
+                const orderErrors = result.orders
+                    .filter((o) => o.error)
+                    .map((o) => `${o.coin}: ${o.error}`)
+                    .join('; ');
+                const detail = result.error || orderErrors || 'unknown error';
+                return {
+                    success: false,
+                    action_type: this.actionType,
+                    summary: `Failed to open ${payload.direction} ${payload.asset}: ${detail}`,
+                    error: 'position_open_failed',
+                    data: {
+                        asset: payload.asset,
+                        direction: payload.direction,
+                        address: payload.strategy,
+                        detail,
+                    },
+                };
+            }
+            logger.info('position created', result);
+            const filledOrder = result.orders[0];
+            const entryPrice = filledOrder?.entryPrice ?? 0;
+            const size = filledOrder?.size ?? 0;
+            // Fire hook
+            await this.context.hookSystem.fire({
+                type: HOOK_EVENT.ON_POSITION_OPENED,
+                tradingStrategyName: event.tradingStrategyName,
+                address: payload.strategy,
+                data: {
+                    asset: payload.asset,
+                    direction: payload.direction,
+                    entryPrice,
+                    size,
+                    leverage,
+                    reasoning: decision.reasoning,
+                    orderId: filledOrder?.orderId,
+                },
+                timestamp: new Date().toISOString(),
+            });
+            logger.info('hook fired');
+            // Send notification
+            const summary = `Opened ${payload.direction} ${payload.asset} @ ${entryPrice}`;
+            await this.context.notifications.notify(summary);
+            return {
+                success: true,
+                action_type: this.actionType,
+                summary,
+                data: {
+                    asset: payload.asset,
+                    direction: payload.direction,
+                    entryPrice,
+                    size,
+                    leverage,
+                    address: payload.strategy,
+                    reasoning: decision.reasoning,
+                    orderId: filledOrder?.orderId,
+                },
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                success: false,
+                action_type: this.actionType,
+                summary: `Error opening position: ${message}`,
+                error: message,
+            };
+        }
+    }
+    parsePayload(payload, fallbackStrategy) {
+        const { strategy: rawStrategy, asset, direction, rotate_out } = payload;
+        const strategy = typeof rawStrategy === 'string' ? rawStrategy : fallbackStrategy;
+        if (typeof asset !== 'string') {
+            console.error('Invalid asset', asset);
+            return null;
+        }
+        if (direction !== 'LONG' && direction !== 'SHORT') {
+            console.error('Invalid direction', direction);
+            return null;
+        }
+        return {
+            strategy,
+            asset,
+            direction,
+            rotate_out: typeof rotate_out === 'string' ? rotate_out : undefined,
+        };
+    }
+}
+// ─── Factory & Manifest ─────────────────────────────────────────────────────
+export const openPositionFactory = (config, context) => new OpenPositionAction(config, context);
+export const openPositionManifest = {
+    type: 'action/OPEN_POSITION',
+    name: 'Open Position',
+    description: 'Opens a new perpetual position via Senpi MCP',
+    eventsConsumed: [HOOK_EVENT.ON_SIGNAL_DETECTED],
+    eventsEmitted: [HOOK_EVENT.ON_POSITION_OPENED],
+};
+//# sourceMappingURL=open-position.action.js.map

package/dist/actions/open-position/open-position.action.js.map

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

package/dist/actions/types.d.ts

@@ -0,0 +1,123 @@
+export type { HookEventType, HookEvent, HookSystem } from '../types/hooks.js';
+export type { NotificationService } from '../types/notification.js';
+export type { StrategyConfig, } from '../types/strategy.js';
+export type { StateManager, GateCheckResult, RiskGuard, } from '../types/action.js';
+export type { Signal, ScanResult } from '../types/scanner.js';
+export { ScanStatus } from '../types/scanner.js';
+import type { Signal, ScanResult } from '../types/scanner.js';
+/** Per-strategy slot counts for action payload. */
+export interface StrategySlots {
+    total: number;
+    used: number;
+    available: number;
+}
+/** Action-specific enrichment wrapper around a scanner ScanResult. */
+export interface ActionScanPayload {
+    scanResult: ScanResult;
+    /** Sorted signals (e.g. scanResult.signals) for actions to consider. */
+    topPicks?: Signal[];
+    /** Per-strategy total/used/available slots. Keys are addresses. */
+    strategySlots?: Record<string, StrategySlots>;
+    /** True when the emitting strategy (or any, if no address filter) has available slots. */
+    anySlotsAvailable?: boolean;
+    /** Sum of available slots (for emitting strategy when address set, else all). */
+    totalAvailableSlots?: number;
+    /** Number of scans in history (optional). */
+    scansInHistory?: number;
+}
+export interface LlmDecisionRequest {
+    prompt: string;
+    context: Record<string, unknown>;
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+export interface LlmDecisionResponse<T = unknown> {
+    decision: T;
+    rawResponse: string;
+    tokensUsed: number;
+    latencyMs: number;
+}
+export interface LlmDecision {
+    decide<T>(request: LlmDecisionRequest): Promise<LlmDecisionResponse<T>>;
+}
+import type { HookEvent, HookSystem } from '../types/hooks.js';
+import type { NotificationService } from '../types/notification.js';
+import type { StrategyConfig } from '../types/strategy.js';
+import type { RuntimeContext } from '../types/runtime.js';
+import type { RiskGuard, StateManager } from '../types/action.js';
+import type { SenpiClient } from '../senpi/client.js';
+import type { ContextBuilder } from '../context/types.js';
+export type ActionType = 'OPEN_POSITION' | 'CLOSE_POSITION' | 'EMERGENCY_CLOSE_ALL' | string;
+export type DecisionMode = 'llm' | 'script' | 'agent' | 'none';
+export interface ActionConfig {
+    name: string;
+    action_type: ActionType;
+    decision_mode: DecisionMode;
+    decision_model?: string;
+    scanners?: string[];
+    min_confidence?: number;
+    context?: import('../context/types.js').ContextEntry[];
+    decision_prompt?: string;
+    params?: Record<string, unknown>;
+}
+export interface ActionContext {
+    senpi: SenpiClient;
+    stateManager: StateManager;
+    hookSystem: HookSystem;
+    llmDecision: LlmDecision;
+    contextBuilder: ContextBuilder;
+    riskGuard: RiskGuard;
+    notifications: NotificationService;
+    strategies: Map<string, StrategyConfig>;
+    playbook: {
+        tradingStrategyName: string;
+        version: string;
+    };
+    maxLeverageData: Record<string, number>;
+}
+/**
+ * Base decision output from the decision layer.
+ * Enforced fields are common to ALL actions.
+ * Action-specific fields go in `payload` — each action defines its own shape.
+ */
+export interface ActionDecision {
+    execute: boolean;
+    actionType: ActionType;
+    confidence: number;
+    reasoning: string;
+    payload: Record<string, unknown>;
+}
+export interface ActionResult {
+    success: boolean;
+    action_type: ActionType;
+    summary: string;
+    data?: Record<string, unknown>;
+    skipped?: boolean;
+    skipReason?: string;
+    error?: string;
+}
+/**
+ * Core Action contract. Every action implementation must satisfy this.
+ *
+ * Actions are event-driven: instantiated once, receive events via handle(),
+ * return results. They do NOT subscribe themselves to events — the orchestrator
+ * (future) handles wiring.
+ *
+ * Lifecycle: create (factory) -> start() -> handle() [repeated] -> stop()
+ */
+export interface Action {
+    readonly name: string;
+    readonly actionType: ActionType;
+    handle(event: HookEvent): Promise<ActionResult>;
+}
+export type ActionFactory = (config: ActionConfig, context: RuntimeContext) => Action;
+export interface ActionManifest {
+    type: string;
+    name: string;
+    description?: string;
+    eventsConsumed: string[];
+    eventsEmitted: string[];
+    configSchema?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/actions/types.js

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

package/dist/actions/types.js.map

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

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

@@ -0,0 +1,26 @@
+/**
+ * senpi guide subcommands — in-shell reference for @senpi/trading-runtime.
+ *
+ * All reference text is static string constants. This is intentional: the
+ * scanner registry does not expose configSchema or description metadata at
+ * runtime (ScannerEngine.list() only returns id/enabled/intervalSeconds).
+ *
+ * TODO: replace static strings with dynamic registry metadata once
+ * ScannerEngine exposes configSchema per scanner type. Relevant type is
+ * ScannerRegistrationSummary in src/scanners/engine/engine.ts.
+ */
+/** Minimal Commander command type — mirrors the interface in senpi-commands.ts */
+interface CommanderCommand {
+    command(name: string, desc?: string): CommanderCommand;
+    description(desc: string): CommanderCommand;
+    option(flags: string, description?: string): CommanderCommand;
+    action(fn: (opts?: Record<string, unknown>) => void | Promise<void>): CommanderCommand;
+}
+/**
+ * Register `senpi guide [subcommand]` on the senpi Commander subprogram.
+ * @param senpi  - the `senpi` Commander command object
+ * @param version - plugin version string (from src/version.ts)
+ */
+export declare function registerGuideCommands(senpi: CommanderCommand, version: string): void;
+export {};
+//# sourceMappingURL=guide-commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guide-commands.d.ts","sourceRoot":"","sources":["../../src/cli/guide-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAmSH,kFAAkF;AAClF,UAAU,gBAAgB;IACxB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACvD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC5C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC9D,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC;CACxF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,MAAM,GACd,IAAI,CA2CN"}