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

package/dist/composer/verbs/status.py

@@ -53,7 +53,7 @@ from typing import Optional
 from composer.authoring import emit
 
 from . import _box, _live
-from ._box import ListFn, runtime_running, wallet_match
+from ._box import ListFn, PositionsFn, runtime_running, wallet_match
 from ._live import (
     LiveState,
     SystemStateFn,
@@ -64,13 +64,17 @@ from ._live import (
 )
 from ._layout import (
     COMPOSER_DIR,
+    KIND_MANAGED,
+    KIND_MANUAL,
     LEGACY_STRATEGIES_DIR,
     archives_dir,
     canonical_graph_path,
     canonical_releases_dir,
     canonical_staged_dir,
+    canonical_wallet_json,
     is_canonical_graph,
     iter_release_dirs,
+    read_strategy_kind,
     resolve_wallet_json,
     runtime_state_dir,
 )
@@ -86,6 +90,10 @@ INSTALLABLE = "installable"
 INSTALLED_UNREGISTERED = "installed_unregistered"
 INSTALLED_STOPPED = "installed_stopped"
 INSTALLED_RUNNING = "installed_running"
+# J3: a MANUAL strategy — a funded wallet with NO graph/runtime, under the composer record system.
+# It has its own terminal-ish position (there is no lifecycle to advance): the sanctioned action is
+# to edit positions directly via MCP, or `composer close` to tear it down.
+MANUAL = "manual"
 
 # Honest liveness caveat appended to a running install (process-level ≠ functional liveness).
 LIVE_NOT_CHECKED = (
@@ -103,6 +111,7 @@ _NEXT = {
     INSTALLED_UNREGISTERED: ("composer install", "landed on the box but the runtime was never registered (interrupted install) — re-run `composer install` to finish it."),
     INSTALLED_STOPPED: ("composer install", "installed + registered but the runtime is NOT running — re-run `composer install`, or check `openclaw senpi runtime list`."),
     INSTALLED_RUNNING: ("(none)", "installed and running — observe the live tick (`openclaw senpi state -r <id>` for functional liveness)."),
+    MANUAL: ("(none)", "manual strategy — a wallet with NO runtime; edit positions directly via MCP (the sanctioned path for this kind), or `composer close` to tear it down and return funds."),
 }
 
 
@@ -185,6 +194,14 @@ class StatusResult:
     live: Optional[LiveState] = None
     sizing: dict = field(default_factory=dict)
     unmanaged_runtimes: list[str] = field(default_factory=list)
+    # J3: the strategy KIND predicate (managed = a graph strategy; manual = a wallet with no
+    # runtime). Carried in --json on every on-box status row so hooks/doctrine (J4/J5) get a
+    # machine-readable kind. The manual fields below are populated only for a MANUAL strategy.
+    kind: str = KIND_MANAGED
+    wallet: Optional[str] = None
+    strategy_id: Optional[str] = None           # the backend strategy-record pointer (manual)
+    manual_positions: Optional[list[dict]] = None   # None = not read; [] = read + flat
+    manual_positions_reason: str = ""           # why positions are unavailable (LOUD, never assumed)
 
     @property
     def next_verb(self) -> str:
@@ -199,6 +216,8 @@ class StatusResult:
         return next((i for i in self.installs if i.is_current), None)
 
     def to_json(self) -> dict:
+        if self.position == MANUAL:
+            return self._manual_to_json()
         out = {
             "verb": "status",
             "target": self.target,
@@ -225,6 +244,9 @@ class StatusResult:
             out["paths"] = self.paths
             if self.split_warning:
                 out["split_warning"] = self.split_warning
+            # J3 predicate: the kind rides on every ON-BOX status row (state root known) so hooks and
+            # doctrine (J4/J5) can branch on managed-vs-manual without re-deriving it.
+            out["kind"] = self.kind
         if self.unmanaged_runtimes:
             out["unmanaged_runtimes"] = self.unmanaged_runtimes
         if self.live is not None:
@@ -234,7 +256,32 @@ class StatusResult:
             out["live"] = live
         return out
 
+    def _manual_to_json(self) -> dict:
+        """The MANUAL-kind status shape (J3): a wallet + backend-record pointer, honest about the
+        absence of a runtime, and the wallet's open positions when the seam is wired."""
+        return {
+            "verb": "status",
+            "target": self.target,
+            "exists": True,
+            "position": MANUAL,
+            "kind": KIND_MANUAL,
+            "strategy": self.strategy,
+            "wallet": self.wallet,
+            "strategy_id": self.strategy_id,
+            "runtime": "none (manual by design — no runtime)",
+            "positions": {
+                "available": self.manual_positions is not None,
+                "reason": self.manual_positions_reason,
+                "positions": list(self.manual_positions or []),
+            },
+            "sanctioned_writes": "direct MCP position edits on this wallet",
+            "next_verb": self.next_verb,
+            "next": self.next_hint,
+        }
+
     def render(self) -> str:
+        if self.position == MANUAL:
+            return self._render_manual()
         lines = [f"status: {self.target}", f"  position   : {self.position}"]
         if self.exists:
             lines.append(f"  provenance : {self.provenance}")
@@ -280,6 +327,40 @@ class StatusResult:
         lines.append(f"  next       : {self.next_hint}")
         return "\n".join(lines) + "\n"
 
+    def _render_manual(self) -> str:
+        """The MANUAL-kind view (J3): render what IS true — wallet, backend-record pointer, an
+        honest 'no runtime — manual by design', and the wallet's open positions via the live seam.
+        There are NO protection lines: a manual strategy has no runtime/DSL, so direct MCP position
+        edits are the sanctioned path (stated plainly, never a false 'unprotected' alarm)."""
+        lines = [
+            f"status: {self.target}",
+            "  position   : manual",
+            "  kind       : manual (a wallet under the composer record system — NO graph/runtime)",
+            f"  wallet     : {self.wallet or 'unknown'}",
+        ]
+        if self.strategy_id:
+            lines.append(f"  record     : backend strategyId {self.strategy_id}")
+        lines.append("  runtime    : none — manual by design (no runtime is installed for a manual "
+                     "strategy)")
+        # positions from the live seam (the wallet's clearinghouse state) — LOUD when unavailable.
+        if self.manual_positions is None:
+            reason = self.manual_positions_reason or "no positions source wired"
+            lines.append(f"  positions  : not read ({reason})")
+        elif not self.manual_positions:
+            lines.append("  positions  : none open on this wallet")
+        else:
+            lines.append(f"  positions  : {len(self.manual_positions)} open on this wallet:")
+            for p in self.manual_positions:
+                asset = p.get("coin") or p.get("asset") or "?"
+                dex = p.get("dex")
+                book = f"@{dex}" if dex and dex != "main" else ""
+                sz = p.get("szi") if p.get("szi") is not None else p.get("size")
+                lines.append(f"    - {asset}{book} size={sz}")
+        lines.append("  writes     : direct MCP position edits on this wallet are the SANCTIONED "
+                     "path for a manual strategy (there is no runtime to route through).")
+        lines.append(f"  next       : {self.next_hint}")
+        return "\n".join(lines) + "\n"
+
     def _render_live(self) -> list[str]:
         """The H2 live block: scanners in strategy language, per-position protection in plain ROE,
         and the risk gates + sizing. Unavailable degrades LOUD (CMP259), never silent."""
@@ -595,12 +676,58 @@ def _attach_live(result: StatusResult, state_dir, list_fn: ListFn,
                                     runtime_id=ci.runtime_id)
 
 
+def _build_manual_status(label: str, strategy: str, state_dir: Path,
+                         positions_fn: Optional[PositionsFn]) -> StatusResult:
+    """The MANUAL-kind status result (J3): read wallet + backend-record pointer from wallet.json,
+    and — when the positions seam is wired — the wallet's open positions (the live truth for a
+    manual strategy, which has no runtime). Unavailable positions are LOUD (never assumed flat)."""
+    wj_path, _layout = resolve_wallet_json(str(state_dir), strategy)
+    wallet: Optional[str] = None
+    strategy_id: Optional[str] = None
+    if wj_path is not None:
+        try:
+            rec = json.loads(wj_path.read_text(encoding="utf-8"))
+            wallet = str(rec.get("wallet")) if rec.get("wallet") else None
+            strategy_id = rec.get("strategyId")
+        except (OSError, json.JSONDecodeError):
+            pass
+
+    r = StatusResult(target=label, position=MANUAL, exists=True, kind=KIND_MANUAL,
+                     strategy=strategy, wallet=wallet, strategy_id=strategy_id)
+
+    # positions via the existing clearinghouse seam (by wallet) — only when wired + a wallet is
+    # known. Default None => not read (LOUD), the composer never fans this per-wallet read out on its
+    # own; the rim / a test injects it.
+    if positions_fn is not None and wallet:
+        try:
+            res = positions_fn(wallet)
+        except Exception as e:  # noqa: BLE001 — a seam fault must not crash status
+            r.manual_positions = None
+            r.manual_positions_reason = f"positions read raised ({e})"
+        else:
+            if res.verified:
+                r.manual_positions = list(res.positions)
+            else:
+                r.manual_positions = None
+                r.manual_positions_reason = res.reason or "positions unverifiable"
+    elif not wallet:
+        r.manual_positions_reason = "no wallet recorded in wallet.json"
+    return r
+
+
 def run_status(target, out_dir=None, *, state_dir=None,
                list_fn: ListFn = _box.default_list_runtimes,
-               state_fn: SystemStateFn = _live.default_system_state) -> StatusResult:
+               state_fn: SystemStateFn = _live.default_system_state,
+               positions_fn: Optional[PositionsFn] = None) -> StatusResult:
     text, label, staged_dir, strategy = _resolve(target, out_dir, state_dir)
 
     if text is None:
+        # J3: a MANUAL strategy has NO graph (text is None) but a canonical wallet.json marked
+        # ``kind: manual``. Render its wallet-only view rather than the ABSENT "run `composer new`"
+        # (a manual strategy is legitimately graph-less). Needs the state root to find the marker.
+        if state_dir is not None and staged_dir is None \
+                and read_strategy_kind(state_dir, strategy) == KIND_MANUAL:
+            return _build_manual_status(label, strategy, Path(state_dir), positions_fn)
         # A bare strategy name / graph that does not exist yet, but the box has state for it: still
         # emit the install chain + path map so the operator can see what is on the box (G8b).
         if state_dir is not None and staged_dir is None:

package/dist/composer/verbs/update.py

@@ -437,7 +437,13 @@ def run_update(
             Location(),
         ), strategy=strategy, wallet=wallet)
 
-    # (2) FIND the runtime(s) bound to this wallet.
+    # (2) FIND the runtime(s) bound to this wallet. The discovery read may come from a rim-served
+    # snapshot (J9); the post-delete CONFIRM below must re-read FRESH — a snapshot predates the delete
+    # and would falsely see the just-deleted runtime as still live (CMP245). Only the PRODUCTION
+    # default seam is redirected to a fresh shell; an INJECTED seam (tests) serves both unchanged.
+    confirm_list_fn: ListFn = (
+        _box.list_runtimes_fresh if list_fn is _box.default_list_runtimes else list_fn
+    )
     runtimes = list_fn()
     matches = [r for r in runtimes if wallet_match(r.get("wallet"), wallet)]
 
@@ -585,9 +591,9 @@ def run_update(
                     Location(),
                 )],
                 message="old runtime delete failed; strategy unchanged.", **base_kw)
-        # CONFIRM gone (mirror close.py's invariant confirm).
+        # CONFIRM gone (mirror close.py's invariant confirm) — FRESH read, never a rim snapshot (J9).
         if any(wallet_match(r.get("wallet"), wallet) and r.get("name") == old_runtime_id
-               for r in list_fn()):
+               for r in confirm_list_fn()):
             return UpdateResult(
                 target=target, verdict=FAILED,
                 errors=[TeachingError(

package/dist/index.d.ts

@@ -11,6 +11,7 @@
  *   that reason. Keeping every export in a single file (this one) avoids
  *   the loader's relative-import path entirely.
  */
+import { type GatewayToolDefinition } from "./cli/senpi-strategy-tool.js";
 import type { RuntimeSystemState } from "./health/index.js";
 import type { SenpiEventBus } from "./dsl/events/index.js";
 import type { IntakeContext } from "./runtime-api/intake/intake-context.js";
@@ -131,13 +132,14 @@ interface PluginApi {
     }) => void, opts?: {
         commands: string[];
     }): void;
+    registerTool?(tool: GatewayToolDefinition): void;
     registerGatewayMethod(name: string, handler: (ctx: {
         respond: (ok: boolean, value: unknown) => void;
         params?: Record<string, unknown>;
     }) => void | Promise<void>, opts?: {
         scope?: OperatorScope;
     }): void;
-    on(hookName: string, handler: (...args: unknown[]) => void | Promise<void>, opts?: {
+    on(hookName: string, handler: (...args: unknown[]) => unknown, opts?: {
         priority?: number;
     }): void;
 }

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA4BH,OAAO,KAAK,EAAuB,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAOjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AA+B3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAM5E,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAIjD;AAGD,OAAO,EACL,OAAO,EACP,SAAS,EACT,SAAS,EACT,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,MAAM,IAAI,SAAS,EACnB,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,QAAQ,EACR,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C,OAAO,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxE,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,4BAA4B,EAC5B,8BAA8B,EAC9B,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,SAAS,EACT,mBAAmB,EACnB,MAAM,EACN,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,YAAY,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,MAAM,EACN,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAC/G,kDAAkD;AAClD,OAAO,EAAE,mBAAmB,IAAI,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAC3F,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEtF,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,mDAAmD,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,cAAc,EACd,SAAS,EACT,YAAY,EACZ,WAAW,EACX,aAAa,EACb,QAAQ,EACR,UAAU,EACV,qBAAqB,EACrB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,UAAU,IAAI,iBAAiB,EAC/B,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,YAAY,EACZ,aAAa,EACb,UAAU,EACV,QAAQ,EACR,SAAS,EACT,iBAAiB,IAAI,wBAAwB,EAC7C,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,kCAAkC,EAClC,eAAe,EACf,OAAO,IAAI,cAAc,EACzB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACrB,8BAA8B,EAC9B,sBAAsB,EACtB,YAAY,EACZ,4BAA4B,EAC5B,2BAA2B,EAC3B,+BAA+B,EAC/B,0BAA0B,EAC1B,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,IAAI,2BAA2B,GACpD,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,YAAY,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,wIAAwI;AACxI,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,aAAa,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB;;;;;;;WAOG;QACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC9B;;;;;;WAMG;QACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB;;;;;;WAMG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAKnH,CAAC;CACH;AAID,UAAU,YAAY;IACpB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/C;AAED;;;;;;;;;GASG;AACH,KAAK,aAAa,GACd,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,oBAAoB,GACpB,kBAAkB,GAClB,uBAAuB,CAAC;AAE5B,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE;QACP,KAAK,EAAE;YACL,eAAe,IAAI,MAAM,CAAC;SAC3B,CAAC;QACF,MAAM,CAAC,EAAE;YACP,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;YAC/B,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;SACjD,CAAC;KACH,CAAC;IACF,eAAe,CAAC,OAAO,EAAE;QACvB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,CAAC,GAAG,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3D,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC5D,GAAG,IAAI,CAAC;IACT,WAAW,CACT,EAAE,EAAE,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE;YAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAA;SAAE,CAAA;KAAE,KAAK,IAAI,EACrF,IAAI,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,GAC5B,IAAI,CAAC;IACR,qBAAqB,CACnB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAC5H,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,aAAa,CAAA;KAAE,GAC/B,IAAI,CAAC;IACR,EAAE,CACA,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACrD,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,IAAI,CAAC;CACT;AAyID;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAKvE;AAED;;;GAGG;AACH,QAAA,MAAM,kBAAkB;;;;;;qBAUP,OAAO;;kBAQR,SAAS;CAkgDxB,CAAC;AA2FF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,aAAa,GAAG,SAAS,GAChC,kBAAkB,CAyCpB;AA0FD,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -17,6 +17,7 @@ import { SenpiClient } from "./senpi/client.js";
 import { AuditQueryError } from "./runtime/audit-query.types.js";
 import { buildRuntimeStateDir, archiveStateDir } from "./runtime/state-layout.js";
 import { registerSenpiCli } from "./cli/senpi-commands.js";
+import { createSenpiStrategyTool } from "./cli/senpi-strategy-tool.js";
 import { readSenpiCliStore, resolveSenpiApiKeyFromStore, resolveSenpiBaseStateDir, resolveTelegramChatIdFromStore, } from "./cli/senpi-cli-config.js";
 import { getDefaultStateDir } from "./runtime/default-state-dir.js";
 import { createNotificationService } from "./runtime/notifications.js";
@@ -34,6 +35,7 @@ import { VERSION } from "./version.js";
 import { resolvePackageName } from "./runtime/auto-update/resolve-package-name.js";
 import { runOpenClawPluginsUpdate } from "./runtime/auto-update/run-update-command.js";
 import { registerSpanHooks } from "./telemetry/spans/index.js";
+import { registerComposerWriteAnnotationHook } from "./runtime/composer-managed-write.js";
 import { initDefaultPiiRedactor } from "./telemetry/spans/redact-pii.js";
 import { initOtelSdk, shutdownOtelSdk } from "./telemetry/otel-sdk.js";
 import { getLogLevel, getLogLevelSource, parseLogLevel, setErrorNotifier, setLogLevel, } from "./utils/logger.js";
@@ -318,6 +320,19 @@ const senpiRuntimePlugin = {
                 err: err instanceof Error ? err.message : String(err),
             });
         }
+        // J4 — composer-managed position-write annotation. Point the "side door"
+        // (direct backend MCP position/protection edits) back at the sanctioned
+        // record path (graph spec.protection → composer check → composer update).
+        // Pointer-only: annotates the result, never blocks or damages the data path.
+        try {
+            registerComposerWriteAnnotationHook({ api, baseStateDir });
+            pluginLogger.info("[senpi-runtime] composer-managed write annotation hooks registered");
+        }
+        catch (err) {
+            pluginLogger.warn("[senpi-runtime] failed to register composer-managed write annotation hooks", {
+                err: err instanceof Error ? err.message : String(err),
+            });
+        }
         const runtimeHandles = new Map();
         let apiHandle;
         // Supervised scanner state — module-scoped so stop() can reach them.
@@ -714,6 +729,13 @@ const senpiRuntimePlugin = {
             pluginLogger.info("[senpi-runtime] CLI registrar callback invoked — attaching senpi subcommands to program");
             registerSenpiCli(ctx.program, baseStateDir);
         }, { commands: ["senpi"] });
+        if (typeof api.registerTool === "function") {
+            pluginLogger.info("[senpi-runtime] registering senpi_strategy gateway tool");
+            api.registerTool(createSenpiStrategyTool(baseStateDir));
+        }
+        else {
+            pluginLogger.warn("[senpi-runtime] api.registerTool unavailable on this openclaw version — senpi_strategy gateway tool NOT registered; strategy routing falls back to the exec CLI");
+        }
         /** Gateway respond accepts (ok, payload?, error?) with error as { code, message }; plugin SDK types may omit the third arg. */
         api.registerGatewayMethod("senpi.installRuntime", async (ctx) => {
             const { params } = ctx;