@senpi/runtime 1.0.95-dev.20260408174401

package/README.md

@@ -0,0 +1,155 @@
+# @senpi-ai/runtime
+
+[![npm version](https://img.shields.io/npm/v/@senpi-ai/runtime.svg)](https://www.npmjs.com/package/@senpi-ai/runtime)
+
+Event-driven automated trading plugin for OpenClaw. Orchestrates scanners, LLM-based trade decisions, and a DSL trailing stop-loss exit engine.
+
+## Prerequisites
+
+- **OpenClaw** >= 2026.2.0
+- **Node** >= 22
+- **Senpi API key** (for live trading)
+
+## Install
+
+```bash
+openclaw plugins install @senpi-ai/runtime
+```
+
+## Configure
+
+Add the plugin to your OpenClaw config (e.g. `~/.openclaw/openclaw.json` or via `openclaw config set`). Use the plugin **id** `@senpi-ai/runtime` as the key:
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "@senpi-ai/runtime": {
+        "enabled": true,
+        "config": {
+          "stateDir": "~/.openclaw/senpi-state",
+          "apiKey": "YOUR_SENPI_API_KEY"
+        }
+      }
+    }
+  }
+}
+```
+
+## Notifications
+
+- **Strategy-level:** Set `notifications.telegram_chat_id` in your strategy YAML to receive alerts (e.g. open/close, decision errors, scanner watchdog). The plugin sends messages via the OpenClaw gateway `message` tool (`action: send`, `target: telegram:<chatId>`).
+- **Lifecycle (plugin start/stop):** Set `SENPI_LIFECYCLE_TELEGRAM_CHAT_ID` in the **gateway** environment (e.g. in Docker: add to `docker-compose` and `.env`) to receive "Senpi started. Strategy running." when the plugin service starts and "Senpi shutting down." when it stops. Requires `OPENCLAW_GATEWAY_TOKEN` (and optionally `OPENCLAW_GATEWAY_URL`) in the same environment.
+
+## Auto-update
+
+Auto-update is **enabled by default** (opt-out). When a new minor or patch version is published to npm, the plugin will install it automatically and attempt to restart the OpenClaw gateway so the new code takes effect.
+
+- **Major versions** are never auto-installed. A Telegram notification is sent instead, asking you to review the changelog and update manually.
+- **Default mode:** `auto-apply` — the plugin polls every 6 hours, installs the update, and triggers a gateway restart.
+- **Gateway restart** requires `gateway.reload.mode` set to `restart` or `hybrid` in your OpenClaw config. If the mode is `hot` or `off`, or the config helpers are unavailable, the plugin will send a notification asking you to restart the gateway manually.
+
+To customise or disable auto-update, add an `autoUpdate` block to the plugin config:
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "runtime": {
+        "enabled": true,
+        "config": {
+          "autoUpdate": {
+            "mode": "notify-only",
+            "pollIntervalMinutes": 720
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+Set `"enabled": false` inside the `autoUpdate` block to disable it entirely.
+
+**Known limitation:** If the gateway cannot be restarted automatically (wrong reload mode or missing config access), runtimes that were stopped for the update remain stopped until you restart the gateway manually.
+
+## Quickstart
+
+1. Copy a minimal recipe template and set your wallet:
+   ```bash
+   cp $(openclaw plugins path @senpi-ai/runtime)/examples/strategies/minimal.yaml ~/my-recipe.yaml
+   # Edit my-recipe.yaml: replace ${WALLET_ADDRESS} or set WALLET_ADDRESS in env
+   ```
+
+2. Set environment variables (e.g. `.env`): `SENPI_API_KEY`, `WALLET_ADDRESS`.
+
+3. Load the recipe (hot-loads; no gateway restart):
+   ```bash
+   openclaw senpi runtime create -p ~/my-recipe.yaml
+   ```
+
+4. List recipes:
+   ```bash
+   openclaw senpi runtime list
+   ```
+
+5. Watch gateway logs for scanner runs and signal processing.
+
+## Strategy templates
+
+| File | Style | Scanners | Use case |
+|------|-------|----------|----------|
+| minimal.yaml | Watch-only | emerging_movers | Verify setup; no positions |
+| wolf.yaml | Aggressive | emerging_movers | Early entry on FIRST_JUMP |
+| viper.yaml | Moderate | prescreener + momentum | Candle-based breakouts |
+| fox.yaml | OI-driven | prescreener + oi_tracker | OI-driven entries |
+| dsl-showcase.yaml | DSL reference | emerging_movers | Annotated exit config |
+
+Templates live under `examples/strategies/` in the package. See [examples/strategies/README.md](examples/strategies/README.md).
+
+## CLI reference
+
+**Runtime recipes:**
+- `openclaw senpi runtime create -p <path>` — create from YAML file (hot-load)
+- `openclaw senpi runtime create -c "<yaml>"` — create from inline YAML
+- `openclaw senpi runtime list` — list installed runtimes
+- `openclaw senpi runtime delete <runtime_id>` — remove by id
+
+**In-shell reference:**
+- `openclaw senpi guide` — overview
+- `openclaw senpi guide scanners` — scanner types and config fields
+- `openclaw senpi guide actions` — action types and decision modes
+- `openclaw senpi guide dsl` — DSL two-phase exit engine
+- `openclaw senpi guide examples` — print minimal strategy YAML
+- `openclaw senpi guide schema` — full YAML schema
+- `openclaw senpi guide version` — plugin version and changelog URL
+
+## Guide skill
+
+Once published, the **@senpi-guide** skill on ClawHub provides the same reference in chat. Install with `clawhub install skills/senpi-guide/` (or from the ClawHub UI).
+
+## Install on an existing OpenClaw setup
+
+If you already have OpenClaw installed (local, VPS, or self-hosted), see [Installing on existing OpenClaw](docs/install/existing-openclaw.md) for the full install sequence, config stanza, and troubleshooting.
+
+## Docs
+
+- [Architecture](docs/runtime-docs/design/architecture.md)
+- [Skills YAML schema](docs/runtime-docs/design/skills-yaml-schema.md)
+- [Integration guide](docs/runtime-docs/integration-guide.md)
+- [Runtime API](docs/runtime-docs/runtime-api.md)
+
+## Changelog
+
+[CHANGELOG.md](CHANGELOG.md)
+
+## Development
+
+```bash
+npm run build            # install deps + compile TypeScript (excludes *.test.ts)
+npm run typecheck:tests  # typecheck all src including tests (no emit)
+npm test                 # unit + integration tests (no credentials required)
+npm run dev              # build + run
+```
+
+Pre-commit runs `npm run build`, `npm run typecheck:tests`, and `npm test`. See [CLAUDE.md](CLAUDE.md) and [docs/runtime-docs/](docs/runtime-docs/) for conventions and design.

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

@@ -0,0 +1,16 @@
+import type { Action, ActionConfig, ActionFactory, ActionManifest, ActionResult, HookEvent } from '../types.js';
+import type { RuntimeContext } from 'src/types/runtime.js';
+export declare class ClosePositionAction implements Action {
+    private config;
+    private context;
+    readonly name: string;
+    readonly actionType: "CLOSE_POSITION";
+    private decisionEngine;
+    constructor(config: ActionConfig, context: RuntimeContext);
+    handle(event: HookEvent): Promise<ActionResult>;
+    private normalizeSignals;
+    private handleSignals;
+}
+export declare const closePositionFactory: ActionFactory;
+export declare const closePositionManifest: ActionManifest;
+//# sourceMappingURL=close-position.action.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"close-position.action.d.ts","sourceRoot":"","sources":["../../../src/actions/close-position/close-position.action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,SAAS,EAEV,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAU3D,qBAAa,mBAAoB,YAAW,MAAM;IAO9C,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IAPjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAG,gBAAgB,CAAU;IAEhD,OAAO,CAAC,cAAc,CAAiB;gBAG7B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,cAAc;IAS3B,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC;IAwIrD,OAAO,CAAC,gBAAgB;YAQV,aAAa;CAqE5B;AAID,eAAO,MAAM,oBAAoB,EAAE,aACO,CAAC;AAE3C,eAAO,MAAM,qBAAqB,EAAE,cAMnC,CAAC"}

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

@@ -0,0 +1,220 @@
+import { DecisionEngine, LlmDecisionStrategy, NoDecisionStrategy, RuleDecisionStrategy } from '../decision-engine.js';
+import { HOOK_EVENT } from '../../types/hooks.js';
+import { interpolatePrompt } from '../../context/interpolate.js';
+import { formatDecisionErrorNotification } from '../../runtime/notifications.js';
+import { createLogger } from '../../utils/logger.js';
+const logger = createLogger('[actions][close-position]');
+// ─── Close Position Action ───────────────────────────────────────────────────
+export class ClosePositionAction {
+    config;
+    context;
+    name;
+    actionType = 'CLOSE_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 RuleDecisionStrategy());
+        this.decisionEngine.register(new NoDecisionStrategy());
+    }
+    async handle(event) {
+        logger.info('handling close position', event);
+        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?.signals?.length && !this.config.params?.asset) {
+            logger.error('no signal and no params.asset', { scanResult, params: this.config.params });
+            return {
+                success: false,
+                action_type: this.actionType,
+                summary: 'No signal and no asset in params',
+                error: 'no_signal_or_asset',
+            };
+        }
+        if (scanResult && scanResult.address !== address) {
+            return {
+                success: false,
+                action_type: this.actionType,
+                summary: 'Signal address does not match event address',
+                error: 'signal_address_mismatch',
+            };
+        }
+        const strategyState = this.context.strategyState;
+        if (strategyState.address !== address) {
+            return {
+                success: false,
+                action_type: this.actionType,
+                summary: 'Signal address does not match registered strategy',
+                error: 'strategy_address_mismatch',
+            };
+        }
+        // ── Static params path (bypasses decision engine) ──
+        if (this.config.decision_mode === 'none' && typeof this.config.params?.asset === 'string') {
+            const signals = [{
+                    asset: this.config.params.asset,
+                    reason: typeof this.config.params.reason === 'string' ? this.config.params.reason : 'manual_close',
+                    dex: typeof this.config.params.dex === 'string' ? this.config.params.dex : undefined,
+                    score: 1,
+                }];
+            return this.handleSignals(signals, address, event, strategyState);
+        }
+        // ── Decision engine path ──
+        const providerRequest = {
+            event,
+            address: event.address,
+            strategyState,
+            scannerModule: this.context.scannerModule,
+            readScannerContext: this.context.scannerModule
+                ? (address, scannerId) => this.context.scannerModule.getScannerContext(address, scannerId)
+                : undefined,
+        };
+        const contextData = this.config.context?.length
+            ? await this.context.contextBuilder.build(this.config.context, providerRequest)
+            : {};
+        const interpolatedPrompt = this.config.decision_prompt
+            ? interpolatePrompt(this.config.decision_prompt, {
+                ...contextData,
+                ...(this.config.params ?? {}),
+            })
+            : undefined;
+        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);
+            const notificationMessage = formatDecisionErrorNotification(message);
+            await this.context.notifications.notify(notificationMessage).catch(() => { });
+            return {
+                success: false,
+                action_type: this.actionType,
+                summary: `Decision failed: ${message}`,
+                error: message,
+            };
+        }
+        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 },
+            };
+        }
+        const minConfidence = this.config.min_confidence ?? 1;
+        if (decision.confidence < 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 },
+            };
+        }
+        // ── Unified signals path ──
+        const signals = this.normalizeSignals(decision.payload);
+        if (!signals.length) {
+            return {
+                success: false,
+                action_type: this.actionType,
+                summary: 'Invalid payload: no actionable signals',
+                error: 'invalid_payload',
+            };
+        }
+        return this.handleSignals(signals, address, event, strategyState);
+    }
+    normalizeSignals(payload) {
+        if (Array.isArray(payload.signals))
+            return payload.signals;
+        if (typeof payload.asset === 'string') {
+            return [{ asset: payload.asset, direction: payload.direction, reason: payload.reason, dex: payload.dex, score: 1 }];
+        }
+        return [];
+    }
+    async handleSignals(signals, address, event, strategyState) {
+        const results = [];
+        let closedCount = 0;
+        let failedCount = 0;
+        for (const signal of signals) {
+            const asset = signal.asset;
+            const signalDex = signal.dex;
+            const dexForHook = typeof signalDex === 'string' && signalDex.trim() !== '' ? signalDex.trim() : undefined;
+            const reason = signal.reason ?? signal.signalType ?? 'action_close';
+            if (!strategyState.hasOpenPosition(asset, dexForHook)) {
+                results.push({ asset, success: true, reason: 'no_open_position' });
+                continue;
+            }
+            if (this.config.decision_mode !== 'rule') {
+                const gate = this.context.riskGuard.checkGate(address);
+                if (gate.gate !== 'OPEN') {
+                    results.push({ asset, success: true, reason: `risk_gate_${gate.gate}` });
+                    continue;
+                }
+            }
+            try {
+                logger.info('closing position', { wallet: address, asset });
+                await this.context.senpi.closePosition(address, asset, { reason, dex: dexForHook });
+                await this.context.hookSystem.fire({
+                    type: HOOK_EVENT.ON_POSITION_CLOSED,
+                    runtimeName: event.runtimeName,
+                    address,
+                    data: {
+                        asset,
+                        wallet: address,
+                        reason: 'action_close',
+                        closeReason: reason,
+                        ...(dexForHook != null ? { dex: dexForHook } : {}),
+                    },
+                    timestamp: new Date().toISOString(),
+                });
+                const msg = `Closed ${asset} (${reason})`;
+                await this.context.notifications.notify(msg);
+                results.push({ asset, success: true, reason });
+                closedCount++;
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                logger.error('close failed', { asset, err: message });
+                results.push({ asset, success: false, reason, error: message });
+                failedCount++;
+            }
+        }
+        const skippedCount = results.length - closedCount - failedCount;
+        return {
+            success: closedCount > 0 || failedCount === 0,
+            action_type: this.actionType,
+            summary: `Close: ${closedCount} closed, ${failedCount} failed, ${skippedCount} skipped`,
+            data: { results, closedCount, failedCount, skippedCount },
+        };
+    }
+}
+// ─── Factory & Manifest ─────────────────────────────────────────────────────
+export const closePositionFactory = (config, context) => new ClosePositionAction(config, context);
+export const closePositionManifest = {
+    type: 'action/CLOSE_POSITION',
+    name: 'Close Position',
+    description: 'Closes an existing perpetual position via Senpi MCP',
+    eventsConsumed: [HOOK_EVENT.ON_SIGNAL_DETECTED],
+    eventsEmitted: [HOOK_EVENT.ON_POSITION_CLOSED],
+};
+//# sourceMappingURL=close-position.action.js.map

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

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

package/dist/actions/decision-engine.d.ts

@@ -0,0 +1,32 @@
+import type { ActionDecision, ActionType, DecisionMode, HookEvent, LlmDecision } from './types.js';
+export interface DecisionRequest {
+    prompt?: string;
+    context: Record<string, unknown>;
+    model?: string;
+    actionType: ActionType;
+    event: HookEvent;
+}
+export interface DecisionStrategy {
+    readonly mode: DecisionMode;
+    decide(request: DecisionRequest): Promise<ActionDecision>;
+}
+export declare class DecisionEngine {
+    private strategies;
+    register(strategy: DecisionStrategy): void;
+    decide(mode: DecisionMode, request: DecisionRequest): Promise<ActionDecision>;
+}
+export declare class LlmDecisionStrategy implements DecisionStrategy {
+    private llmDecision;
+    readonly mode: DecisionMode;
+    constructor(llmDecision: LlmDecision);
+    decide(request: DecisionRequest): Promise<ActionDecision>;
+}
+export declare class RuleDecisionStrategy implements DecisionStrategy {
+    readonly mode: DecisionMode;
+    decide(request: DecisionRequest): Promise<ActionDecision>;
+}
+export declare class NoDecisionStrategy implements DecisionStrategy {
+    readonly mode: DecisionMode;
+    decide(request: DecisionRequest): Promise<ActionDecision>;
+}
+//# sourceMappingURL=decision-engine.d.ts.map

package/dist/actions/decision-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-engine.d.ts","sourceRoot":"","sources":["../../src/actions/decision-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,YAAY,EACZ,SAAS,EACT,WAAW,EAGZ,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC3D;AAID,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAA6C;IAE/D,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAIpC,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAOpF;AAID,qBAAa,mBAAoB,YAAW,gBAAgB;IAG9C,OAAO,CAAC,WAAW;IAF/B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAS;gBAEhB,WAAW,EAAE,WAAW;IAEtC,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAmChE;AAID,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAU;IAE/B,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAuChE;AAID,qBAAa,kBAAmB,YAAW,gBAAgB;IACzD,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAU;IAE/B,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAShE"}

package/dist/actions/decision-engine.js

@@ -0,0 +1,103 @@
+// ─── Decision Engine ────────────────────────────────────────────────────────
+export class DecisionEngine {
+    strategies = new Map();
+    register(strategy) {
+        this.strategies.set(strategy.mode, strategy);
+    }
+    async decide(mode, request) {
+        const strategy = this.strategies.get(mode);
+        if (!strategy) {
+            throw new Error(`No decision strategy registered for mode: ${mode}`);
+        }
+        return strategy.decide(request);
+    }
+}
+// ─── LLM Decision Strategy ─────────────────────────────────────────────────
+export class LlmDecisionStrategy {
+    llmDecision;
+    mode = 'llm';
+    constructor(llmDecision) {
+        this.llmDecision = llmDecision;
+    }
+    async decide(request) {
+        if (!request.prompt) {
+            throw new Error('LLM decision mode requires a prompt');
+        }
+        const response = await this.llmDecision.decide({
+            prompt: request.prompt,
+            context: request.context,
+            model: request.model,
+        });
+        const decision = response.decision;
+        if (typeof decision.execute !== 'boolean') {
+            throw new Error('LLM decision missing required field: execute');
+        }
+        if (typeof decision.confidence !== 'number' ||
+            decision.confidence < 1 ||
+            decision.confidence > 10) {
+            throw new Error('LLM decision confidence must be a number between 1 and 10');
+        }
+        if (typeof decision.reasoning !== 'string') {
+            throw new Error('LLM decision missing required field: reasoning');
+        }
+        return {
+            execute: decision.execute,
+            actionType: decision.actionType ?? request.actionType,
+            confidence: decision.confidence,
+            reasoning: decision.reasoning,
+            payload: decision.payload ?? {},
+        };
+    }
+}
+// ─── Rule Decision Strategy ─────────────────────────────────────────────────
+export class RuleDecisionStrategy {
+    mode = 'rule';
+    async decide(request) {
+        const scanResult = request.event?.data?.scanResult;
+        const signals = (scanResult?.signals ?? []).filter((s) => s.asset && s.asset.length > 0);
+        if (signals.length === 0) {
+            return {
+                execute: false,
+                actionType: request.actionType,
+                confidence: 0,
+                reasoning: 'No actionable signals with asset',
+                payload: {},
+            };
+        }
+        const highestScore = Math.max(...signals.map((s) => s.score));
+        const confidence = Math.max(1, Math.min(10, Math.round(highestScore * 10)));
+        const assets = signals.map((s) => s.asset);
+        const first = signals[0];
+        return {
+            execute: true,
+            actionType: request.actionType,
+            confidence,
+            reasoning: `${signals.length} signal(s) for ${assets.join(', ')}`,
+            payload: {
+                signals: signals.map((s) => ({
+                    asset: s.asset,
+                    direction: s.direction,
+                    score: s.score,
+                    signalType: s.signalType,
+                    reason: s.meta?.reason ?? s.signalType,
+                    dex: s.meta?.dex,
+                    meta: s.meta,
+                })),
+            },
+        };
+    }
+}
+// ─── No Decision Strategy ───────────────────────────────────────────────────
+export class NoDecisionStrategy {
+    mode = 'none';
+    async decide(request) {
+        return {
+            execute: false,
+            actionType: request.actionType,
+            confidence: 10,
+            reasoning: 'No decision required',
+            payload: {},
+        };
+    }
+}
+//# sourceMappingURL=decision-engine.js.map

package/dist/actions/decision-engine.js.map

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

package/dist/actions/llm-decision/anthropic-llm-decision.d.ts

@@ -0,0 +1,12 @@
+import type { LlmDecision, LlmDecisionRequest, LlmDecisionResponse } from '../types.js';
+export interface AnthropicLlmDecisionOptions {
+    apiKey?: string;
+    defaultModel?: string;
+}
+export declare class AnthropicLlmDecision implements LlmDecision {
+    private readonly client;
+    private readonly defaultModel;
+    constructor(options?: AnthropicLlmDecisionOptions);
+    decide<T>(request: LlmDecisionRequest): Promise<LlmDecisionResponse<T>>;
+}
+//# sourceMappingURL=anthropic-llm-decision.d.ts.map

package/dist/actions/llm-decision/anthropic-llm-decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-llm-decision.d.ts","sourceRoot":"","sources":["../../../src/actions/llm-decision/anthropic-llm-decision.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGxF,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAKD,qBAAa,oBAAqB,YAAW,WAAW;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,OAAO,CAAC,EAAE,2BAA2B;IAM3C,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;CAgD9E"}

package/dist/actions/llm-decision/anthropic-llm-decision.js

@@ -0,0 +1,74 @@
+import Anthropic from '@anthropic-ai/sdk';
+import { ACTION_DECISION_SCHEMA, SYSTEM_PROMPT } from './shared.js';
+const DEFAULT_MODEL = 'claude-sonnet-4-20250514';
+const DEFAULT_MAX_TOKENS = 1024;
+export class AnthropicLlmDecision {
+    client;
+    defaultModel;
+    constructor(options) {
+        const apiKey = options?.apiKey?.replace(/\s+/g, '');
+        this.client = new Anthropic(apiKey ? { apiKey } : undefined);
+        this.defaultModel = options?.defaultModel ?? DEFAULT_MODEL;
+    }
+    async decide(request) {
+        const start = Date.now();
+        const userContent = `## Task\n${request.prompt}\n\n## Context\n${JSON.stringify(request.context, null, 2)}`;
+        let response;
+        try {
+            response = await this.client.messages.create({
+                model: request.model ?? this.defaultModel,
+                max_tokens: request.maxTokens ?? DEFAULT_MAX_TOKENS,
+                ...(request.temperature != null ? { temperature: request.temperature } : {}),
+                system: SYSTEM_PROMPT,
+                messages: [{ role: 'user', content: userContent }],
+                tools: [
+                    {
+                        name: 'trading_decision',
+                        description: 'Submit a structured trading decision',
+                        input_schema: ACTION_DECISION_SCHEMA,
+                    },
+                ],
+                tool_choice: { type: 'tool', name: 'trading_decision' },
+            });
+        }
+        catch (error) {
+            throw classifyAnthropicError(error);
+        }
+        const latencyMs = Date.now() - start;
+        const toolBlock = response.content.find((block) => block.type === 'tool_use');
+        if (!toolBlock) {
+            throw new Error('Anthropic response contained no tool_use block');
+        }
+        const decision = toolBlock.input;
+        const tokensUsed = response.usage.input_tokens + response.usage.output_tokens;
+        return {
+            decision,
+            rawResponse: JSON.stringify(response.content),
+            tokensUsed,
+            latencyMs,
+        };
+    }
+}
+// ─── Error classification ───────────────────────────────────────────────────
+function classifyAnthropicError(error) {
+    try {
+        if (Anthropic.APIConnectionError && error instanceof Anthropic.APIConnectionError) {
+            const cause = error.cause instanceof Error ? error.cause.message : String(error.cause ?? '');
+            return new Error(`Anthropic connection failed: ${cause || error.message}`);
+        }
+        if (Anthropic.AuthenticationError && error instanceof Anthropic.AuthenticationError) {
+            return new Error(`Anthropic authentication failed: ${error.message}`);
+        }
+        if (Anthropic.APIError && error instanceof Anthropic.APIError) {
+            return new Error(`Anthropic API error (${error.status}): ${error.message}`);
+        }
+    }
+    catch {
+        // instanceof can throw if the RHS is not a valid constructor; fall through
+    }
+    if (error instanceof Error) {
+        return error;
+    }
+    return new Error(String(error));
+}
+//# sourceMappingURL=anthropic-llm-decision.js.map