@senpi/runtime 1.0.95-dev.20260408174401

package/examples/yamls/sample-with-dsl-and-emerging-movers.yaml

@@ -0,0 +1,115 @@
+name: wolf #required - name of the trading-recipe
+version: 1.0.0 #required
+description: > #required
+  Autonomous aggressive multi-strategy trading. Enter early on emerging movers,
+  protect with tight DSL, cut dead weight fast, rotate into strength.
+
+# Optional: send run summaries and alerts to Telegram (requires OpenClaw channels.telegram configured)
+# notifications:
+#   telegram_chat_id: "123456789"
+
+# ── STRATEGY ──
+strategy: #required
+  wallet: "0x71ce3f0e27c178cbdcf01c4d068278034df75fbc"
+  budget: "100"
+  slots: 3
+  margin_per_slot: 150
+  trading_risk: aggressive
+  enabled: true
+
+# ── SCANNERS ──
+scanners: #required 
+  - name: emerging_movers #required 
+    type: emerging_movers #required 
+    interval: 20s #required 
+    blocked_assets: [] #optional
+    config: #Can be different for each scanner.
+      topN: 25
+      minRankJump: 5
+      minTopTradersGain: 0.1
+      minScansBeforeSignals: 2
+      historyLimit: 60
+
+actions: #required 
+  - name: wolf_entry #required 
+    action_type: OPEN_POSITION #required 
+    decision_mode: llm #required 
+    decision_model: claude-sonnet-4-6 #required 
+    scanners: [emerging_movers] #required 
+    min_confidence: 2 #required 
+    context: #optional
+      - type: signal
+        value: emerging_movers
+    decision_prompt: | #optional 
+      You evaluate emerging mover signals for the WOLF multi-strategy system.
+      WOLF enters early on first jumps — before the peak, not at it. Speed is edge.
+
+      SIGNAL DATA:
+      {{emerging_movers}}
+
+      SIGNAL PRIORITY (strict — act on highest priority first):
+      1. FIRST_JUMP: Jumped 10+ ranks from #25+ in one scan, wasn't in top 50 before.
+         ENTER IMMEDIATELY. 2 reasons is enough. vel > 0 is enough.
+      2. CONTRIB_EXPLOSION: 3x+ contribution spike from rank #20+. ENTER.
+         Never downgrade for erratic history.
+      3. IMMEDIATE_MOVER: 10+ rank jump from #25+ but not first jump.
+         ENTER if not erratic and not low velocity.
+      4. DEEP_CLIMBER: Steady climb from #30+, vel >= 0.03, 3+ reasons.
+         Route to conservative strategy if available.
+
+      ROUTING:
+      - FIRST_JUMP/CONTRIB_EXPLOSION → aggressive strategy
+      - DEEP_CLIMBER → conservative if available, else aggressive
+      - Never duplicate same asset within one strategy (cross-strategy OK)
+
+      ANTI-PATTERNS:
+      - Rank #1-10 for 2+ scans = SKIP
+      - 4+ reasons at rank #5 = SKIP
+      - Counter to BTC hourly trend = SKIP
+      - Burned asset today = SKIP
+
+      ROTATION (slots full + FIRST_JUMP):
+      - Weakest has negative ROE + SM conviction <= 1 → CUT, ENTER new
+      - Weakest is Tier 2+ or SM conviction 3+ → HOLD
+      - Positions younger than {{rotation_cooldown_minutes}}min → never rotate out
+
+      XYZ EQUITIES: Ignore trader count. Use reasons + rank velocity.
+
+      Respond with execute=true and actionType="OPEN_POSITION".
+      Put trade details in the payload object:
+      {
+        "execute": true,
+        "actionType": "OPEN_POSITION",
+        "confidence": 1-10,
+        "reasoning": "one sentence",
+        "payload": {
+          "signals": [
+            { "asset": "<coin_ticker>", "direction": "LONG" or "SHORT", "reason": "one sentence", "rotate_out": "<asset_to_cut>" }
+          ]
+        }
+      }
+      Set execute=false if no trade should be taken.
+
+# ── EXIT ──
+exit: #required
+  engine: dsl
+  interval_seconds: 30
+  dsl_preset:
+    phase1:
+      enabled: true
+      consecutive_breaches_required: 3
+      max_loss_pct: 3.0
+      retrace_threshold: 10
+    phase2:
+      enabled: true
+      tiers:
+        - { trigger_pct: 10,  lock_hw_pct: 50 }
+        - { trigger_pct: 20,  lock_hw_pct: 70 }
+        - { trigger_pct: 30,  lock_hw_pct: 73 }
+        - { trigger_pct: 50,  lock_hw_pct: 80 }
+        - { trigger_pct: 75,  lock_hw_pct: 85 }
+        - { trigger_pct: 100, lock_hw_pct: 90 }
+          
+# Send run summaries and alerts to this Telegram chat (requires OpenClaw channels.telegram configured)
+notifications:
+  telegram_chat_id: "6263059192"

package/openclaw.plugin.json

@@ -0,0 +1,67 @@
+{
+  "id": "runtime",
+  "name": "Senpi Runtime",
+  "description": "Senpi runtime plugin for OpenClaw. Orchestrates scanners, LLM-based trade decisions, and a DSL trailing stop-loss exit engine.",
+  "version": "1.0.95",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "stateDir": {
+        "type": "string",
+        "description": "Directory for plugin and strategy state (default: ~/.openclaw/senpi-state)"
+      },
+      "apiKey": {
+        "type": "string",
+        "description": "API key when mcpTransport is not provided by the gateway"
+      },
+      "autoUpdate": {
+        "type": "object",
+        "description": "Auto-update configuration. Enabled with auto-apply by default (opt-out). Omit this block entirely to use defaults.",
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "description": "Enable or disable auto-update polling (default: true)"
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "auto-apply",
+              "notify-only"
+            ],
+            "description": "auto-apply installs updates automatically; notify-only sends a Telegram notification (default: auto-apply)"
+          },
+          "pollIntervalMinutes": {
+            "type": "number",
+            "description": "Minutes between version checks (default: 60, range: 1-1440)"
+          },
+          "startupDelaySeconds": {
+            "type": "number",
+            "description": "Seconds to wait after plugin start before the first version check (default: 30, range: 5-900)"
+          },
+          "allowPatch": {
+            "type": "boolean",
+            "description": "Allow automatic patch version updates (default: true)"
+          },
+          "allowMinor": {
+            "type": "boolean",
+            "description": "Allow automatic minor version updates (default: true)"
+          },
+          "failureBackoffMinutes": {
+            "type": "number",
+            "description": "Minutes to wait after a failed check before retrying (default: 2, range: 1-1440)"
+          },
+          "maxBackoffMinutes": {
+            "type": "number",
+            "description": "Maximum backoff ceiling in minutes (default: 30, range: 1-10080)"
+          },
+          "lastRestartTrigger": {
+            "type": "string",
+            "description": "Internal: timestamp written by the auto-updater to trigger gateway restart via config reload. Do not set manually."
+          }
+        }
+      }
+    }
+  },
+  "uiHints": {}
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@senpi/runtime",
+  "version": "1.0.95-dev.20260408174401",
+  "description": "Senpi runtime plugin for OpenClaw",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/",
+    "openclaw.plugin.json",
+    "examples/"
+  ],
+  "scripts": {
+    "setup:hooks": "sh -c 'git rev-parse --git-dir >/dev/null 2>&1 && git config core.hooksPath .githooks || true'",
+    "prepare": "npm run setup:hooks",
+    "build": "npm i && tsc",
+    "typecheck:tests": "tsc -p tsconfig.tests.json --noEmit",
+    "start": "node dist/index.js",
+    "debug": "npm run build && node dist/debug.js",
+    "dev": "npm run build && node dist/index.js",
+    "watch": "tsc --watch",
+    "test": "vitest run",
+    "run:dsl:mock": "node dist/scripts/run-dsl-standalone-mock.js",
+    "run:dsl:live": "node dist/scripts/run-dsl-standalone-live.js",
+    "test:coverage": "vitest run --coverage"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "dotenv": "^16.4.5",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0",
+    "mcporter": "^0.7.3",
+    "yaml": "^2.8.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.2.0"
+  },
+  "devDependencies": {
+    "@sinclair/typebox": "^0.34.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "openclaw": {
+    "type": "extension",
+    "extensions": [
+      "./dist/index.js"
+    ]
+  }
+}