@senpi/runtime 3.0.9-dev.feat-strategy-compos.20260721003344 → 3.0.9-dev.feat-strategy-compos.20260722213012

package/dist/runtime/composer-managed-write.js

@@ -0,0 +1,369 @@
+/**
+ * J4 — composer-managed position-write annotation (the "side door points at the
+ * front door").
+ *
+ * FIELD INCIDENT: an agent on the reduced tool surface edited live DSL
+ * protection via the backend MCP tool `ratchet_stop_edit`. The edit took, but
+ * (a) the strategy record (graph `spec.protection`) now silently disagrees with
+ * live state, and (b) the backend edit reset high-water state (a backend defect,
+ * out of scope here). Position-level MCP edits are a legitimate stopgap, but they
+ * must POINT back at the sanctioned strategy-wide path:
+ *   edit `spec.protection` in the graph → `composer check` → `composer update`.
+ *
+ * MECHANISM: OpenClaw exposes a plugin hook API (`api.on(hookName, handler)`).
+ * The write result is annotated with two hooks working together, because no
+ * single hook has both the params (which carry the wallet) and a writable
+ * result:
+ *   - `before_tool_call`  — has `params`; we capture the affected wallet keyed
+ *                            by `toolCallId` into a small bounded map.
+ *   - `tool_result_persist` — has the `ToolResultMessage` and returns
+ *                            `{ message }` to replace what is persisted to the
+ *                            transcript (and thus read back by the model). We
+ *                            APPEND a short pointer note to the result text.
+ *   (`after_tool_call` is observational only — its return value is discarded by
+ *    the host `runVoidHook`, so it cannot annotate a result.)
+ *
+ * INVERSE-J1 RULE — a pointer feature may never damage the data path. Every
+ * handler is wrapped so any internal error logs a warning and passes the result
+ * through UNTOUCHED. The annotation is additive only: it never replaces,
+ * truncates, blocks, or errors the tool call.
+ */
+import { readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { createLogger } from "../utils/logger.js";
+import { REGISTRY_FILENAME } from "./strategy-registry.js";
+const logger = createLogger("[senpi-core][composer-managed-write]");
+// ─── Tool inventory ─────────────────────────────────────────────────────────
+/**
+ * TypeScript mirror of the canonical `MUTATION_TOOLS` frozenset in
+ * `src/scanners/external/scaffold/senpi_mcp.py` (the producer write-boundary —
+ * the single authored source that enumerates every money/state-mutating senpi
+ * MCP tool). Kept in lockstep with that source; read tools are intentionally
+ * absent. Reused here so the write-tool surface is defined in exactly one place
+ * conceptually rather than hand-listed per feature.
+ */
+export const MUTATION_TOOLS = new Set([
+    "create_position",
+    "close_position",
+    "edit_position",
+    "cancel_order",
+    "send_usdc",
+    "transfer_spot_to_perps",
+    "strategy_create",
+    "strategy_create_custom_strategy",
+    "strategy_close",
+    "strategy_close_positions",
+    "strategy_update",
+    "strategy_pause",
+    "strategy_top_up",
+    "strategy_withdraw_funds",
+    "strategy_bridge_funds_from_hyperliquid_to_evm",
+    "ratchet_stop_add",
+    "ratchet_stop_edit",
+    "ratchet_stop_delete",
+    "user_claim_referral_rewards",
+]);
+/**
+ * The subset of `MUTATION_TOOLS` this annotation targets: position / protection
+ * / strategy-config writes whose effect DESYNCS the composer graph record
+ * (`spec.*`) from live state. Excludes pure fund-movement / referral tools
+ * (`send_usdc`, `transfer_spot_to_perps`, `strategy_top_up`,
+ * `strategy_withdraw_funds`, `strategy_bridge_funds_from_hyperliquid_to_evm`,
+ * `user_claim_referral_rewards`) — those move money but do not make the strategy
+ * record disagree with live trading behaviour, so the pointer note would not fit.
+ */
+export const POSITION_WRITE_TOOLS = new Set([
+    // ratchet-stop / DSL protection engine — THE incident family.
+    "ratchet_stop_add",
+    "ratchet_stop_edit",
+    "ratchet_stop_delete",
+    // position lifecycle + exchange-side protection edits.
+    "create_position",
+    "close_position",
+    "edit_position",
+    "cancel_order",
+    // strategy config / lifecycle that overrides what the graph spec owns.
+    "strategy_update",
+    "strategy_pause",
+    "strategy_close",
+    "strategy_close_positions",
+]);
+/**
+ * Normalize a tool name as seen at the hook layer to its bare senpi name.
+ * Consolidated MCP surfaces prefix names with the server id joined by `__`
+ * (e.g. `senpi__ratchet_stop_edit`, `mcp__senpi__edit_position`). Bare senpi
+ * tool names never contain `__` (they use single underscores), so taking the
+ * segment after the LAST `__` yields the bare name and is a no-op for bare input.
+ */
+export function bareToolName(toolName) {
+    const idx = toolName.lastIndexOf("__");
+    return idx >= 0 ? toolName.slice(idx + 2) : toolName;
+}
+/** True when the (possibly prefixed) tool name is a targeted position-write. */
+export function isPositionWriteTool(toolName) {
+    return POSITION_WRITE_TOOLS.has(bareToolName(toolName));
+}
+// ─── Wallet extraction ────────────────────────────────────────────────────────
+/**
+ * Candidate param keys that carry the affected wallet across the write-tool
+ * family. `strategyWalletAddress` is the dominant shape (ratchet_stop_*,
+ * create_position, edit_position, strategy_*); the rest are defensive aliases.
+ */
+const WALLET_PARAM_KEYS = [
+    "strategyWalletAddress",
+    "strategy_wallet_address",
+    "walletAddress",
+    "wallet_address",
+    "wallet",
+    "address",
+    "account",
+    "traderAddress",
+];
+/** Lowercase + trim an address for case-insensitive comparison (EVM 0x addrs). */
+export function normalizeWallet(wallet) {
+    return typeof wallet === "string" ? wallet.trim().toLowerCase() : "";
+}
+/** Best-effort extraction of the affected wallet from tool-call params. */
+export function extractWalletFromParams(params) {
+    if (!params || typeof params !== "object")
+        return "";
+    const obj = params;
+    for (const key of WALLET_PARAM_KEYS) {
+        const v = obj[key];
+        if (typeof v === "string" && v.trim().length > 0)
+            return v.trim();
+    }
+    return "";
+}
+/** `<id>-<wallet>` state-dir names where wallet is an EVM 0x address. */
+const RUNTIME_STATE_DIR_PATTERN = /^(.+)-(0x[0-9a-fA-F]{40})$/;
+/**
+ * Build a {@link WalletManagementView} from the plugin's explicit baseStateDir.
+ * Synchronous (the persist hook is synchronous) and gated by the caller behind a
+ * tool-name match, so the small file/dir reads only happen on matched writes.
+ * Fully defensive: any read/parse failure yields an empty (unmanaged) view.
+ */
+export function loadWalletManagementView(baseStateDir) {
+    const managedWallets = new Set();
+    const strategyNameByWallet = new Map();
+    // (1) installed_runtimes.json — the authoritative record of installed runtimes.
+    try {
+        const raw = readFileSync(join(baseStateDir, REGISTRY_FILENAME), "utf-8");
+        const parsed = JSON.parse(raw);
+        const runtimes = Array.isArray(parsed?.runtimes) ? parsed.runtimes : [];
+        for (const entry of runtimes) {
+            if (!entry || typeof entry !== "object")
+                continue;
+            const e = entry;
+            const w = normalizeWallet(e.wallet);
+            if (!w)
+                continue;
+            managedWallets.add(w);
+            if (typeof e.id === "string" && e.id.length > 0 && !strategyNameByWallet.has(w)) {
+                strategyNameByWallet.set(w, e.id);
+            }
+        }
+    }
+    catch {
+        // absent / unreadable / corrupt registry → contributes no managed wallets.
+    }
+    // (2) Composer canonical layout: per-runtime state dirs `<id>-<wallet>`.
+    try {
+        for (const name of readdirSync(baseStateDir)) {
+            const m = RUNTIME_STATE_DIR_PATTERN.exec(name);
+            if (!m)
+                continue;
+            const w = normalizeWallet(m[2]);
+            if (!w)
+                continue;
+            managedWallets.add(w);
+            if (!strategyNameByWallet.has(w))
+                strategyNameByWallet.set(w, m[1]);
+        }
+    }
+    catch {
+        // baseStateDir unreadable → skip the dir-scan signal.
+    }
+    // (3) Composer strategy records: `<baseStateDir>/composer/<strategy>/wallet.json`. Covers
+    // funded-but-not-installed managed wallets AND manual-kind wallets (J3: an optional
+    // `"kind": "manual"` marker inside wallet.json; absence = managed).
+    const manualWallets = new Set();
+    try {
+        const composerDir = join(baseStateDir, "composer");
+        for (const strategy of readdirSync(composerDir)) {
+            try {
+                const raw = readFileSync(join(composerDir, strategy, "wallet.json"), "utf-8");
+                const rec = JSON.parse(raw);
+                const w = normalizeWallet(rec.wallet);
+                if (!w)
+                    continue;
+                managedWallets.add(w);
+                if (!strategyNameByWallet.has(w))
+                    strategyNameByWallet.set(w, strategy);
+                if (typeof rec.kind === "string" && rec.kind.trim().toLowerCase() === "manual") {
+                    manualWallets.add(w);
+                }
+            }
+            catch {
+                // no wallet.json / unreadable / corrupt → contributes nothing for this strategy.
+            }
+        }
+    }
+    catch {
+        // no composer dir → skip the record-scan signal.
+    }
+    return {
+        managedWallets,
+        strategyNameByWallet,
+        isManualWallet: (w) => manualWallets.has(w),
+    };
+}
+/**
+ * The wallet-management predicate seam.
+ *
+ * Returns:
+ *   - `false`     — not composer-managed (no annotation).
+ *   - `"manual"`  — composer-managed but a sanctioned manual-kind wallet
+ *                   (no annotation once J3's detector is wired).
+ *   - `true`      — composer-managed, non-manual (annotate).
+ */
+export function walletIsComposerManaged(wallet, view) {
+    const key = normalizeWallet(wallet);
+    if (!key || !view.managedWallets.has(key))
+        return false;
+    if (view.isManualWallet(key))
+        return "manual";
+    return true;
+}
+// ─── Annotation ────────────────────────────────────────────────────────────────
+/**
+ * Backend teardown tools get their own note: the sanctioned teardown is
+ * `composer close` with its runtime-delete-FIRST invariant — a raw backend
+ * strategy_close beside a live runtime strands it (the field-proven failure
+ * this pointer exists to prevent).
+ */
+const TEARDOWN_TOOLS = new Set([
+    "strategy_close",
+    "strategy_close_positions",
+]);
+/** Build the pointer note appended to a matched managed-wallet write result. */
+export function buildAnnotation(strategyName, bareTool) {
+    if (bareTool !== undefined && TEARDOWN_TOOLS.has(bareTool)) {
+        return (`This wallet is composer-managed (strategy: ${strategyName}). ` +
+            `The sanctioned teardown is \`composer close ${strategyName}\` — it deletes ` +
+            `the runtime FIRST, then closes the backend strategy. A raw backend ` +
+            `strategy_close beside a live runtime STRANDS the runtime (it keeps ` +
+            `scanning and can reopen positions). If this call already ran, run ` +
+            `\`composer status ${strategyName}\` now and follow its recovery text.`);
+    }
+    return (`This wallet is composer-managed (strategy: ${strategyName}). ` +
+        `This edit changed the LIVE position only — the strategy record still ` +
+        `carries the old values and the next position will use them. ` +
+        `Strategy-wide path: edit spec.protection in the graph → composer check → ` +
+        `composer update. (Backend note: ratchet edits reset high-water state today.)`);
+}
+/**
+ * Return a copy of `message` with the annotation appended as a new trailing text
+ * block. Never mutates the input; never replaces or truncates existing content.
+ * Returns `undefined` when the message is not an annotatable tool-result shape
+ * (caller then passes the original through untouched).
+ */
+export function appendAnnotation(message, annotation) {
+    if (!message || typeof message !== "object")
+        return undefined;
+    const msg = message;
+    if (msg.role !== "toolResult")
+        return undefined;
+    if (!Array.isArray(msg.content))
+        return undefined;
+    const note = { type: "text", text: `\n\n${annotation}` };
+    return { ...message, content: [...msg.content, note] };
+}
+/** Cap on in-flight toolCallId→wallet correlations, so a persist that never */
+/** fires cannot grow the map without bound. */
+const MAX_PENDING = 512;
+/**
+ * Register the composer-managed write annotation hooks. Idempotent per api
+ * instance from the caller's perspective (registers exactly two handlers).
+ */
+export function registerComposerWriteAnnotationHook(opts) {
+    const { api, baseStateDir } = opts;
+    const log = opts.logger ?? logger;
+    const loadView = opts.loadView ?? loadWalletManagementView;
+    // Correlate the affected wallet (only available in params) with the result
+    // (only available at persist). Keyed by toolCallId.
+    const pendingWalletByCallId = new Map();
+    const rememberWallet = (toolCallId, wallet) => {
+        if (pendingWalletByCallId.size >= MAX_PENDING) {
+            // Evict oldest insertion to stay bounded (Map preserves insertion order).
+            const oldest = pendingWalletByCallId.keys().next().value;
+            if (oldest !== undefined)
+                pendingWalletByCallId.delete(oldest);
+        }
+        pendingWalletByCallId.set(toolCallId, wallet);
+    };
+    // (1) Capture the wallet from params for matched writes.
+    api.on("before_tool_call", (event) => {
+        try {
+            const ev = (event ?? {});
+            const toolName = typeof ev.toolName === "string" ? ev.toolName : "";
+            const toolCallId = typeof ev.toolCallId === "string" ? ev.toolCallId : "";
+            if (!toolName || !toolCallId)
+                return;
+            if (!isPositionWriteTool(toolName))
+                return;
+            const wallet = extractWalletFromParams(ev.params);
+            if (!wallet)
+                return;
+            rememberWallet(toolCallId, wallet);
+        }
+        catch (err) {
+            log.warn("[composer-managed-write] before_tool_call capture failed (ignored)", {
+                err: err instanceof Error ? err.message : String(err),
+            });
+        }
+    });
+    // (2) Annotate the persisted result for a matched managed-wallet write.
+    api.on("tool_result_persist", (event) => {
+        try {
+            const ev = (event ?? {});
+            const message = ev.message;
+            const msgObj = (message ?? {});
+            const toolName = (typeof ev.toolName === "string" && ev.toolName) ||
+                (typeof msgObj.toolName === "string" && msgObj.toolName) ||
+                "";
+            const toolCallId = (typeof ev.toolCallId === "string" && ev.toolCallId) ||
+                (typeof msgObj.toolCallId === "string" && msgObj.toolCallId) ||
+                "";
+            // Not a targeted write → pass through untouched (zero behavior change).
+            if (!toolName || !isPositionWriteTool(toolName))
+                return;
+            const wallet = toolCallId ? pendingWalletByCallId.get(toolCallId) ?? "" : "";
+            if (toolCallId)
+                pendingWalletByCallId.delete(toolCallId);
+            if (!wallet)
+                return; // no wallet correlated → cannot judge; pass through.
+            const view = loadView(baseStateDir);
+            const managed = walletIsComposerManaged(wallet, view);
+            if (managed !== true)
+                return; // unmanaged or manual-kind → no annotation.
+            const name = view.strategyNameByWallet.get(normalizeWallet(wallet)) ?? wallet;
+            const annotated = appendAnnotation(message, buildAnnotation(name, bareToolName(toolName)));
+            if (annotated === undefined)
+                return; // non-annotatable shape → pass through.
+            log.debug?.("[composer-managed-write] annotated managed-wallet write", {
+                toolName: bareToolName(toolName),
+                strategy: name,
+            });
+            return { message: annotated };
+        }
+        catch (err) {
+            // INVERSE-J1: never damage the data path. Pass the result through untouched.
+            log.warn("[composer-managed-write] tool_result_persist annotation failed (ignored)", {
+                err: err instanceof Error ? err.message : String(err),
+            });
+            return;
+        }
+    });
+}
+//# sourceMappingURL=composer-managed-write.js.map

package/dist/runtime/composer-managed-write.js.map

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

package/openclaw.plugin.json

@@ -14,6 +14,11 @@
       "senpi"
     ]
   },
+  "contracts": {
+    "tools": [
+      "senpi_strategy"
+    ]
+  },
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@senpi/runtime",
-  "version": "3.0.9-dev.feat-strategy-compos.20260721003344",
+  "version": "3.0.9-dev.feat-strategy-compos.20260722213012",
   "description": "Senpi runtime plugin for OpenClaw",
   "type": "module",
   "main": "dist/index.js",
@@ -44,6 +44,7 @@
     "@sinclair/typebox": "^0.34.0",
     "async-retry": "^1.3.3",
     "bip39": "^3.1.0",
+    "commander": "^14.0.0",
     "dotenv": "^16.4.5",
     "fastify": "^5.8.5",
     "mcporter": "^0.7.3",