@senpi/trading-runtime 1.0.0

package/README.md

@@ -0,0 +1,117 @@
+# @senpi/trading-runtime
+
+[![npm version](https://img.shields.io/npm/v/@senpi/trading-runtime.svg)](https://www.npmjs.com/package/@senpi/trading-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/trading-runtime
+```
+
+## Configure
+
+Add the plugin to your OpenClaw config (e.g. `~/.openclaw/openclaw.json` or via `openclaw config set`). Use the plugin **id** `trading-runtime` as the key:
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "trading-runtime": {
+        "enabled": true,
+        "config": {
+          "stateDir": "~/.openclaw/senpi-state",
+          "apiKey": "YOUR_SENPI_API_KEY"
+        }
+      }
+    }
+  }
+}
+```
+
+## Quickstart
+
+1. Copy a minimal strategy template and set your wallet:
+   ```bash
+   cp $(openclaw plugins path @senpi/trading-runtime)/examples/strategies/minimal.yaml ~/my-strategy.yaml
+   # Edit my-strategy.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 strategy (hot-loads; no gateway restart):
+   ```bash
+   openclaw senpi trading-strategy create -p ~/my-strategy.yaml
+   ```
+
+4. List strategies:
+   ```bash
+   openclaw senpi trading-strategy 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
+
+**Trading strategies:**
+- `openclaw senpi trading-strategy create -p <path>` — create from YAML file (hot-load)
+- `openclaw senpi trading-strategy create -c "<yaml>"` — create from inline YAML
+- `openclaw senpi trading-strategy list` — list installed strategies
+- `openclaw senpi trading-strategy uninstallStrategy --strategy-id <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
+npm test        # unit + integration tests (no credentials required)
+npm run dev     # build + run
+```
+
+Pre-commit runs `npm run build && npm test`. See [CLAUDE.md](CLAUDE.md) and [docs/runtime-docs/](docs/runtime-docs/) for conventions and design.

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

@@ -0,0 +1,28 @@
+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 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,EACZ,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,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,65 @@
+// ─── 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 ?? {},
+        };
+    }
+}
+// ─── 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":"AAuBA,+EAA+E;AAE/E,MAAM,OAAO,cAAc;IACjB,UAAU,GAAG,IAAI,GAAG,EAAkC,CAAC;IAE/D,QAAQ,CAAC,QAA0B;QACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAkB,EAAE,OAAwB;QACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,6CAA6C,IAAI,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;CACF;AAED,8EAA8E;AAE9E,MAAM,OAAO,mBAAmB;IAGV;IAFX,IAAI,GAAiB,KAAK,CAAC;IAEpC,YAAoB,WAAwB;QAAxB,gBAAW,GAAX,WAAW,CAAa;IAAG,CAAC;IAEhD,KAAK,CAAC,MAAM,CAAC,OAAwB;QACnC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAiB;YAC7D,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAEnC,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QACD,IACE,OAAO,QAAQ,CAAC,UAAU,KAAK,QAAQ;YACvC,QAAQ,CAAC,UAAU,GAAG,CAAC;YACvB,QAAQ,CAAC,UAAU,GAAG,EAAE,EACxB,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC/E,CAAC;QACD,IAAI,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QAED,OAAO;YACL,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,UAAU,EAAE,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU;YACrD,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE;SAChC,CAAC;IACJ,CAAC;CACF;AAED,+EAA+E;AAE/E,MAAM,OAAO,kBAAkB;IACpB,IAAI,GAAiB,MAAM,CAAC;IAErC,KAAK,CAAC,MAAM,CAAC,OAAwB;QACnC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,sBAAsB;YACjC,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;CACF"}

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

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

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

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

@@ -0,0 +1,17 @@
+import type { LlmDecision } from '../types.js';
+export interface LlmDecisionOptions {
+    provider?: 'anthropic' | 'openclaw';
+    anthropicApiKey?: string;
+    defaultModel?: string;
+    gatewayUrl?: string;
+    gatewayToken?: string;
+}
+/**
+ * Create an LlmDecision client based on the given options.
+ *
+ * Auto-detection (when `provider` is omitted):
+ *   - ANTHROPIC_API_KEY env var set → AnthropicLlmDecision
+ *   - otherwise → OpenClawLlmDecision (uses HTTP gateway)
+ */
+export declare function createLlmDecision(options?: LlmDecisionOptions): LlmDecision;
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/actions/llm-decision/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAoB/E"}

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

@@ -0,0 +1,29 @@
+import { AnthropicLlmDecision } from './anthropic-llm-decision.js';
+import { OpenClawLlmDecision } from './openclaw-llm-decision.js';
+/**
+ * Create an LlmDecision client based on the given options.
+ *
+ * Auto-detection (when `provider` is omitted):
+ *   - ANTHROPIC_API_KEY env var set → AnthropicLlmDecision
+ *   - otherwise → OpenClawLlmDecision (uses HTTP gateway)
+ */
+export function createLlmDecision(options = {}) {
+    const provider = options.provider ??
+        (options.anthropicApiKey || process.env.ANTHROPIC_API_KEY ? 'anthropic' : 'openclaw');
+    switch (provider) {
+        case 'anthropic':
+            return new AnthropicLlmDecision({
+                apiKey: options.anthropicApiKey,
+                defaultModel: options.defaultModel,
+            });
+        case 'openclaw':
+            return new OpenClawLlmDecision({
+                gatewayUrl: options.gatewayUrl,
+                gatewayToken: options.gatewayToken,
+                defaultModel: options.defaultModel,
+            });
+        default:
+            throw new Error(`Unknown LlmDecision provider: ${provider}`);
+    }
+}
+//# sourceMappingURL=factory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/actions/llm-decision/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAUjE;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAA8B,EAAE;IAChE,MAAM,QAAQ,GACZ,OAAO,CAAC,QAAQ;QAChB,CAAC,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAExF,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW;YACd,OAAO,IAAI,oBAAoB,CAAC;gBAC9B,MAAM,EAAE,OAAO,CAAC,eAAe;gBAC/B,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC,CAAC;QACL,KAAK,UAAU;YACb,OAAO,IAAI,mBAAmB,CAAC;gBAC7B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC,CAAC;QACL;YACE,MAAM,IAAI,KAAK,CAAC,iCAAiC,QAAkB,EAAE,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,8 @@
+export { OpenClawLlmDecision } from './openclaw-llm-decision.js';
+export type { OpenClawLlmDecisionOptions } from './openclaw-llm-decision.js';
+export { AnthropicLlmDecision } from './anthropic-llm-decision.js';
+export type { AnthropicLlmDecisionOptions } from './anthropic-llm-decision.js';
+export { createLlmDecision } from './factory.js';
+export type { LlmDecisionOptions } from './factory.js';
+export { ACTION_DECISION_SCHEMA, SYSTEM_PROMPT, extractDecision, unwrapEnvelope, isRecord, } from './shared.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/actions/llm-decision/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAE7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAE/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,cAAc,EACd,QAAQ,GACT,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,5 @@
+export { OpenClawLlmDecision } from './openclaw-llm-decision.js';
+export { AnthropicLlmDecision } from './anthropic-llm-decision.js';
+export { createLlmDecision } from './factory.js';
+export { ACTION_DECISION_SCHEMA, SYSTEM_PROMPT, extractDecision, unwrapEnvelope, isRecord, } from './shared.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/llm-decision/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,cAAc,EACd,QAAQ,GACT,MAAM,aAAa,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-llm-decision.d.ts","sourceRoot":"","sources":["../../../src/actions/llm-decision/openclaw-llm-decision.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAMxF,MAAM,WAAW,0BAA0B;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;gBAE3B,OAAO,CAAC,EAAE,0BAA0B;IAM1C,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;CAkD9E"}

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

@@ -0,0 +1,58 @@
+import { ACTION_DECISION_SCHEMA, SYSTEM_PROMPT, extractDecision } from './shared.js';
+import { createLogger } from '../../utils/logger.js';
+const logger = createLogger('[llm-decision][openclaw]');
+export class OpenClawLlmDecision {
+    gatewayUrl;
+    gatewayToken;
+    defaultModel;
+    constructor(options) {
+        this.gatewayUrl = options?.gatewayUrl ?? 'http://127.0.0.1:18789';
+        this.gatewayToken = options?.gatewayToken;
+        this.defaultModel = options?.defaultModel;
+    }
+    async decide(request) {
+        const start = Date.now();
+        const token = this.gatewayToken ?? process.env.OPENCLAW_GATEWAY_TOKEN;
+        if (!token) {
+            throw new Error('OpenClaw gateway token not configured (set OPENCLAW_GATEWAY_TOKEN)');
+        }
+        const args = {
+            prompt: `${SYSTEM_PROMPT}\n\n## Task\n${request.prompt}`,
+            input: request.context,
+            schema: ACTION_DECISION_SCHEMA,
+        };
+        const model = request.model ?? this.defaultModel;
+        if (model)
+            args.model = model;
+        if (request.maxTokens != null)
+            args.maxTokens = request.maxTokens;
+        if (request.temperature != null)
+            args.temperature = request.temperature;
+        const res = await fetch(`${this.gatewayUrl}/tools/invoke`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${token}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ tool: 'llm-task', args }),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`OpenClaw gateway error (${res.status}): ${text}`);
+        }
+        const body = await res.json();
+        if (!body.ok) {
+            throw new Error(`OpenClaw gateway rejected request: ${body.error ?? JSON.stringify(body)}`);
+        }
+        const latencyMs = Date.now() - start;
+        logger.debug('llm-task raw result', { keys: body.result && typeof body.result === 'object' ? Object.keys(body.result) : typeof body.result });
+        const parsed = extractDecision(body.result);
+        return {
+            decision: parsed.decision,
+            rawResponse: JSON.stringify(body.result),
+            tokensUsed: parsed.tokensUsed,
+            latencyMs,
+        };
+    }
+}
+//# sourceMappingURL=openclaw-llm-decision.js.map

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

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

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

@@ -0,0 +1,41 @@
+export { isRecord, unwrapEnvelope } from "../../utils/response.js";
+export declare const ACTION_DECISION_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly execute: {
+            readonly type: "boolean";
+        };
+        readonly confidence: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 10;
+        };
+        readonly reasoning: {
+            readonly type: "string";
+        };
+        readonly actionType: {
+            readonly type: "string";
+        };
+        readonly payload: {
+            readonly type: "object";
+        };
+    };
+    readonly required: readonly ["execute", "confidence", "reasoning"];
+};
+export declare const SYSTEM_PROMPT = "You are a trading decision engine. Analyze the provided context and decide whether to execute the requested trading action.\n\nRespond with a JSON object:\n- execute (boolean): whether the action should proceed\n- confidence (integer 1\u201310): how confident you are\n- reasoning (string): concise explanation of your decision\n- actionType (string): the action type being evaluated\n- payload (object): action-specific fields as described in the prompt";
+/**
+ * Extract a decision object from the llm-task response.
+ *
+ * Handles multiple response shapes the gateway may return:
+ *   1. `{ json: { execute, ... }, usage }` — structured output (preferred)
+ *   2. `{ execute, confidence, ... }` — decision at top level
+ *   3. `{ details: { json: { execute, ... } }, content }` — gateway /tools/invoke
+ *   4. `{ content: [{ type:"text", text:"{ ... }" }] }` — text fallback in content array
+ *   5. `{ text: "{ ... }", usage }` — flat text fallback with embedded JSON
+ *   6. `{ result: { ... }, usage }` — result-wrapped variant
+ */
+export declare function extractDecision<T>(raw: unknown): {
+    decision: T;
+    tokensUsed: number;
+};
+//# sourceMappingURL=shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/actions/llm-decision/shared.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEnE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;CAUzB,CAAC;AAEX,eAAO,MAAM,aAAa,2cAO4C,CAAC;AA8BvE;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG;IAAE,QAAQ,EAAE,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CA8DpF"}

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

@@ -0,0 +1,117 @@
+// ─── Constants & helpers shared by all LlmDecision implementations ──────────
+import { isRecord, unwrapEnvelope } from "../../utils/response.js";
+export { isRecord, unwrapEnvelope } from "../../utils/response.js";
+export const ACTION_DECISION_SCHEMA = {
+    type: 'object',
+    properties: {
+        execute: { type: 'boolean' },
+        confidence: { type: 'integer', minimum: 1, maximum: 10 },
+        reasoning: { type: 'string' },
+        actionType: { type: 'string' },
+        payload: { type: 'object' },
+    },
+    required: ['execute', 'confidence', 'reasoning'],
+};
+export const SYSTEM_PROMPT = `You are a trading decision engine. Analyze the provided context and decide whether to execute the requested trading action.
+
+Respond with a JSON object:
+- execute (boolean): whether the action should proceed
+- confidence (integer 1–10): how confident you are
+- reasoning (string): concise explanation of your decision
+- actionType (string): the action type being evaluated
+- payload (object): action-specific fields as described in the prompt`;
+// ─── Response parsing ───────────────────────────────────────────────────────
+/**
+ * Try to parse a JSON string into a record. Returns null on failure.
+ */
+function tryParseJson(text) {
+    try {
+        const parsed = JSON.parse(text);
+        return isRecord(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Extract the first text block's content from an OpenClaw `content` array.
+ * Shape: `[{ type: "text", text: "..." }, ...]`
+ */
+function extractContentText(content) {
+    if (!Array.isArray(content))
+        return null;
+    for (const block of content) {
+        if (isRecord(block) && block.type === 'text' && typeof block.text === 'string') {
+            return block.text;
+        }
+    }
+    return null;
+}
+/**
+ * Extract a decision object from the llm-task response.
+ *
+ * Handles multiple response shapes the gateway may return:
+ *   1. `{ json: { execute, ... }, usage }` — structured output (preferred)
+ *   2. `{ execute, confidence, ... }` — decision at top level
+ *   3. `{ details: { json: { execute, ... } }, content }` — gateway /tools/invoke
+ *   4. `{ content: [{ type:"text", text:"{ ... }" }] }` — text fallback in content array
+ *   5. `{ text: "{ ... }", usage }` — flat text fallback with embedded JSON
+ *   6. `{ result: { ... }, usage }` — result-wrapped variant
+ */
+export function extractDecision(raw) {
+    const data = unwrapEnvelope(raw);
+    if (!isRecord(data)) {
+        throw new Error('Invalid llm-task response: expected an object');
+    }
+    let decision;
+    // 1. { json: { ... } }
+    if ('json' in data && isRecord(data.json)) {
+        decision = data.json;
+    }
+    // 2. flat decision with execute at top level
+    else if ('execute' in data) {
+        decision = data;
+    }
+    // 3. { details: { json: { ... } }, content: [...] } — gateway /tools/invoke shape
+    else if ('details' in data && isRecord(data.details) && 'json' in data.details && isRecord(data.details.json)) {
+        decision = data.details.json;
+    }
+    // 4. { content: [{ type: "text", text: "{ ... }" }] } — parse JSON from content text block
+    else if ('content' in data) {
+        const text = extractContentText(data.content);
+        if (text) {
+            const parsed = tryParseJson(text);
+            if (parsed && 'execute' in parsed) {
+                decision = parsed;
+            }
+        }
+    }
+    // 5. { text: "{ ... }" } — flat text field with embedded JSON
+    else if ('text' in data && typeof data.text === 'string') {
+        const parsed = tryParseJson(data.text);
+        if (parsed && 'execute' in parsed) {
+            decision = parsed;
+        }
+    }
+    // 6. { result: { ... } }
+    else if ('result' in data && isRecord(data.result)) {
+        if ('execute' in data.result) {
+            decision = data.result;
+        }
+        else if ('json' in data.result && isRecord(data.result.json)) {
+            decision = data.result.json;
+        }
+    }
+    if (!decision) {
+        const keys = Object.keys(data).join(', ');
+        throw new Error(`Invalid llm-task response: no decision object found (keys: ${keys})`);
+    }
+    let tokensUsed = 0;
+    if (isRecord(data.usage)) {
+        const input = typeof data.usage.inputTokens === 'number' ? data.usage.inputTokens : 0;
+        const output = typeof data.usage.outputTokens === 'number' ? data.usage.outputTokens : 0;
+        tokensUsed = input + output;
+    }
+    return { decision: decision, tokensUsed };
+}
+//# sourceMappingURL=shared.js.map