@senpi/runtime 3.0.146 → 3.0.149

package/dist/cli/guide-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guide-commands.d.ts","sourceRoot":"","sources":["../../src/cli/guide-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA4dH,eAAO,MAAM,eAAe,QAgWpB,CAAC;AAIT,kFAAkF;AAClF,UAAU,gBAAgB;IACxB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACvD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC5C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC9D,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC;CACxF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,MAAM,GACd,IAAI,CA2CN"}
+{"version":3,"file":"guide-commands.d.ts","sourceRoot":"","sources":["../../src/cli/guide-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAsgBH,eAAO,MAAM,eAAe,QA0WpB,CAAC;AAIT,kFAAkF;AAClF,UAAU,gBAAgB;IACxB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACvD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC5C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC9D,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC;CACxF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,MAAM,GACd,IAAI,CAiDN"}

package/dist/cli/guide-commands.js

@@ -9,6 +9,7 @@
  * ScannerEngine exposes configSchema per scanner type. Relevant type is
  * ScannerRegistrationSummary in src/scanners/engine/engine.ts.
  */
+import { QUANT_SECTIONS } from "../quant/types.js";
 const CHANGELOG_URL = "https://github.com/Senpi-ai/senpi-trading-runtime/blob/main/CHANGELOG.md";
 // ── Reference text constants ────────────────────────────────────────────────
 const OVERVIEW_TEXT = (version) => `
@@ -26,6 +27,8 @@ Quick commands:
   senpi validate <pkg>    Prove a strategy runs before funding it (static → import → live)
   senpi deploy -p <pkg>   Take a proven package live: create+fund → install → observe it running
   senpi update <pkg>      Change a LIVE strategy's recipe in place — plans by default, --apply commits
+  senpi quant run <addr>  The quant desk on any Hyperliquid wallet — score, leaks, next steps (read-only)
+  senpi guide quant       Quant desk verbs, run ids, exit and refusal codes
   senpi scanner           Per-scanner health: runs, errors, liveness, "(no signals yet)" flag
   senpi events            Local domain-event log — the trade narrative
   senpi explain <asset>   Stitch one asset's position lifecycle from the event log
@@ -474,6 +477,43 @@ exit:
       tiers:
         - { trigger_pct: 1, lock_hw_pct: 50 }
 `.trim();
+/**
+ * `senpi guide quant` — the quant desk's verbs, the run-id line, exit and refusal codes.
+ *
+ * The quant-desk skill teaches the model these exact spellings, so this text is the in-shell copy
+ * of that contract: `[quant-desk] run <runId>` (the first stderr line of every started run), the
+ * exit classes, and which modes are refused `[E_QUANT_UNSUPPORTED]` in this release.
+ */
+const QUANT_TEXT = `
+senpi quant — the quant desk on any Hyperliquid wallet (read-only; it never trades)
+─────────────────────────────────────────────────────────────────────────────
+  openclaw senpi quant run <0x address>              full desk as Markdown (waits; 30–180 s)
+  openclaw senpi quant run <0x a> <0x b> --book      ONE desk over up to 25 wallets (a senpi user's strategy wallets)
+  openclaw senpi quant run <0x address> --other      someone else's book, analyst voice
+  openclaw senpi quant run <0x address> --section overview --section leaks
+  openclaw senpi quant run <0x address> --json       the desk document (doc_version 1) on stdout
+  openclaw senpi quant run <0x address> [--days N] [--mine|--other] [--no-wait]
+  openclaw senpi quant status [runId]                newest run when no id
+  openclaw senpi quant show <runId> [--section <name>…] [--json]   re-render a finished run, no recompute
+  openclaw senpi quant list                          the last 20 runs, newest first
+
+The first stderr line is "[quant-desk] run <runId>" (match the line by its \`[quant-desk] run \`
+prefix) — keep the id: 'show' re-renders any section from it, and show_widget's
+quant_desk_recommendations card takes it as run_id.
+
+Sections: ${QUANT_SECTIONS.join(", ")}
+One desk per wallet set at a time: a second run is refused [E_QUANT_IN_PROGRESS] naming the running
+id — poll 'quant status <id>', never start another. A finished desk for the same wallets, days and
+voice is served for 10 minutes (--fresh recomputes). A run is stopped after 240 s.
+
+Exit codes: 0 done · 2 refused (obey the [E_QUANT_*] message; do not retry) · 3 failed (the message
+says what to do) · 6 still running, or its state is unknown after the run line — poll
+'quant status <id>' · 1 transport/internal, only before a run id exists (nothing started).
+Refusals: E_QUANT_INVALID_REQUEST · E_QUANT_UNSUPPORTED (--deep, --find, --compare are not available
+through the runtime yet) · E_QUANT_IN_PROGRESS · E_QUANT_NO_ACTIVITY · E_QUANT_NOT_A_TRADER (a vault,
+or a book wider than the desk reads; --force only if the reader insists) · E_QUANT_NOT_FOUND ·
+E_QUANT_DOC_VERSION. Failures: E_QUANT_UPSTREAM · E_QUANT_TIMEOUT · E_QUANT_ENGINE_ERROR.
+`.trim();
 export const CHEATSHEET_TEXT = `
 Senpi Plugin Commands Cheatsheet
 ================================
@@ -560,6 +600,15 @@ senpi deploy — Take a strategy package live, end to end (the strategy lifecycl
                                        $0.00 — ask the USER to verify what actually landed before
                                        any money action
 
+senpi quant — The quant desk on any Hyperliquid wallet (read-only)
+  quant run <address…>                 Run and print the desk (waits). Prints "[quant-desk] run <id>" first
+    --days <n> · --other | --mine · --book · --fresh · --force · --section <name> (repeatable) · --json · --no-wait
+  quant status [runId]                 Status of a run (newest when omitted)
+  quant show <runId>                   Re-render a finished run (--section, --json); never recomputes
+  quant list                           Last 20 runs
+                                       Exit codes: 0 done · 2 refused · 3 failed · 6 running or state unknown · 1 error before a run exists.
+                                       See: senpi guide quant
+
 senpi runtime — Manage runtimes
   runtime delete [id]                  Remove a runtime
     --id <runtime_id>                    Delete by runtime ID
@@ -758,6 +807,7 @@ senpi guide — In-shell reference
   guide examples                       Print minimal strategy YAML
   guide schema                         Full YAML schema field reference
   guide version                        Plugin version and changelog URL
+  guide quant                          Quant desk verbs and codes
 
 Gateway Methods
 ---------------
@@ -853,6 +903,11 @@ export function registerGuideCommands(senpi, version) {
         .action(() => {
         process.stdout.write(DSL_TEXT + "\n");
     });
+    guide.command("quant")
+        .description("Quant desk: run, status, show, list; run ids; exit and refusal codes")
+        .action(() => {
+        process.stdout.write(QUANT_TEXT + "\n");
+    });
     guide.command("examples")
         .description("Print minimal strategy YAML to stdout")
         .action(() => {

package/dist/cli/guide-commands.js.map

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

package/dist/cli/quant-command.d.ts

@@ -0,0 +1,128 @@
+/**
+ * The slice of Commander this module registers against. Declared locally (like the other verb
+ * modules) so the file does not depend on OpenClaw's Commander instance type.
+ */
+interface CommanderCommand {
+    command(name: string): CommanderCommand;
+    description(text: string): CommanderCommand;
+    option(flags: string, description: string, parseArg?: unknown, defaultValue?: unknown): CommanderCommand;
+    argument(name: string, description: string): CommanderCommand;
+    action(handler: (...args: never[]) => void | Promise<void>): CommanderCommand;
+}
+/**
+ * Exit codes, fixed so a caller can branch once. Same classes as `deploy status`: 2 means obey the
+ * refusal (never retry it), 6 means poll `quant status`, 1 means the run's state is unknown.
+ */
+export declare const QUANT_EXIT: {
+    readonly ok: 0;
+    readonly error: 1;
+    readonly refused: 2;
+    readonly failed: 3;
+    readonly running: 6;
+};
+/** Poll interval while a run is in flight. */
+export declare const QUANT_POLL_MS = 2000;
+/** Per-call timeout for status polls (the `gateway call` default is 10 s, too tight under load). */
+export declare const QUANT_STATUS_TIMEOUT_MS = 15000;
+/** Per-call timeout for `get` (a Markdown re-render spawns Python). */
+export declare const QUANT_GET_TIMEOUT_MS = 30000;
+/**
+ * How long `run` waits before handing the reader the status command: the engine's 240 s cap plus
+ * slack. Deliberately BELOW the quant-desk skill's 300 s exec timeout, so the CLI's own exit-6
+ * message (with the status command) is what the reader sees — at 300 s the two tied and the exec
+ * harness could kill the CLI before it spoke.
+ */
+export declare const QUANT_WAIT_CAP_MS = 270000;
+/**
+ * Consecutive empty status-poll replies tolerated once a run id exists. One transport timeout or
+ * null reply mid-poll used to end the wait with exit 1, which the skill reads as "the desk did not
+ * run" — while the gateway job kept running. Two are re-polled; the third ends the wait with exit 6
+ * and the status command, because the run's state is unknown, not failed.
+ */
+export declare const QUANT_EMPTY_POLLS_TOLERATED = 2;
+/**
+ * What `callGatewayJson` hands back: the gateway's answer. `undefined` means the transport already
+ * reported the problem AND set the exit code (a refusal → 2, a transport failure → 1), so callers
+ * return without printing or touching the exit code.
+ */
+export type GatewayReply = {
+    ok?: boolean;
+    payload?: unknown;
+    error?: unknown;
+};
+/**
+ * The command's I/O, injected so routing and exit codes are testable without a CLI or a gateway.
+ * Production wiring lives in `registerSenpiCli` (`senpi-commands.ts`).
+ */
+export interface QuantCommandDeps {
+    /** One `openclaw gateway call`; `opts.timeoutMs` becomes `--timeout`. */
+    callGateway(method: string, params: Record<string, unknown>, opts?: {
+        timeoutMs?: number;
+    }): GatewayReply | undefined;
+    /** stdout — the desk, the document, or a status/list rendering. Must survive OpenClaw's --json diversion. */
+    out(text: string): void;
+    /** stderr — the run line, progress, refusals, next steps. */
+    err(line: string): void;
+    /** Sets `process.exitCode` in production. */
+    setExitCode(code: number): void;
+    /** Wait between polls. */
+    sleep(ms: number): Promise<void>;
+    /** Clock for the wait cap. */
+    now(): number;
+}
+/** `run` flags as Commander delivers them (`--no-wait` → `wait: false`). */
+export interface QuantRunFlags {
+    days?: string;
+    other?: boolean;
+    mine?: boolean;
+    book?: boolean;
+    fresh?: boolean;
+    force?: boolean;
+    section?: readonly string[];
+    json?: boolean;
+    wait?: boolean;
+    /**
+     * Declared only so it can be refused `[E_QUANT_UNSUPPORTED]` instead of Commander's generic error.
+     * The value is optional (`--deep [mode]`), so a bare `--deep` arrives as `true`.
+     */
+    deep?: string | boolean;
+    /** Declared only so it can be refused `[E_QUANT_UNSUPPORTED]`; bare `--find` arrives as `true`. */
+    find?: string | boolean;
+    /** Declared only so it can be refused `[E_QUANT_UNSUPPORTED]`. */
+    compare?: boolean;
+}
+/** `show` flags (`status` and `list` take only `json`). */
+export interface QuantReadFlags {
+    section?: readonly string[];
+    json?: boolean;
+}
+/**
+ * `senpi quant run <address…>`: validate locally, start the gateway job, print the run line, then
+ * (unless `--no-wait`) poll until settled and print the desk.
+ *
+ * Local refusals (unsupported mode, contradictory voice, no address, unknown section, bad days)
+ * happen before any gateway call. Address shape, book width and day bounds are the gateway's to
+ * judge — the CLI does not duplicate them.
+ */
+export declare function runQuantRun(deps: QuantCommandDeps, addresses: string[], flags: QuantRunFlags): Promise<void>;
+/** `senpi quant status [runId]` — no id = the newest run. Exit code follows the run's status. */
+export declare function runQuantStatus(deps: QuantCommandDeps, runId: string | undefined, flags: {
+    json?: boolean;
+}): Promise<void>;
+/** `senpi quant show <runId>` — re-render from the stored document, never recompute. */
+export declare function runQuantShow(deps: QuantCommandDeps, runId: string, flags: QuantReadFlags): Promise<void>;
+/**
+ * `senpi quant list` — the stored runs, newest first (normally the last 20; more while runs are in
+ * flight). One line per run: id, status, window, whose (+ "book"), wallets, finished-or-started.
+ */
+export declare function runQuantList(deps: QuantCommandDeps, flags: {
+    json?: boolean;
+}): Promise<void>;
+/**
+ * Register `senpi quant run|status|show|list`. `--deep/--find/--compare` are declared so they reach
+ * `runQuantRun` and are refused with `[E_QUANT_UNSUPPORTED]` naming what is supported, rather than
+ * dying on Commander's generic "unknown option".
+ */
+export declare function registerQuantCommands(senpi: CommanderCommand, deps: QuantCommandDeps): void;
+export {};
+//# sourceMappingURL=quant-command.d.ts.map

package/dist/cli/quant-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quant-command.d.ts","sourceRoot":"","sources":["../../src/cli/quant-command.ts"],"names":[],"mappings":"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"}

package/dist/cli/quant-command.js

@@ -0,0 +1,345 @@
+/**
+ * `openclaw senpi quant` — run | status | show | list.
+ *
+ * Thin, like `senpi update`: parse flags, call the gateway, render, set the exit code. No engine
+ * logic lives here — every verb is one or more `senpi.quant.*` gateway calls (see
+ * `src/quant/register.ts`), so the CLI can never disagree with what the gateway stored.
+ *
+ * `run` starts a gateway job and polls it (a desk takes 30–180 s and `gateway call` times out at
+ * 10 s by default), so the model's experience stays one command. Once the gateway has started (or
+ * served) a run, the FIRST stderr line is always `[quant-desk] run <id>` — in every mode, including
+ * `--section`, `--json`, `--no-wait` and a cached run (which adds a parenthesised suffix after the
+ * id). That line is a contract: the quant-desk skill prefix-matches `[quant-desk] run ` and reads
+ * the id as the next word, then hands it to `show` and to the recommendation card. A run refused
+ * before it starts (bad flags, bad address, `[E_QUANT_IN_PROGRESS]`) has no id, so its first
+ * stderr line is the bracketed refusal instead.
+ *
+ * Exit codes: 0 done · 2 refused (obey the [E_QUANT_*] message) · 3 failed · 6 still running, or its
+ * state is unknown after the run line (poll `quant status <id>`) · 1 transport/internal, only before
+ * a run id exists. --json output is exactly one document on stdout.
+ */
+import { isRefusalMessage } from "../deploy/taxonomy.js";
+import { QUANT_SECTIONS } from "../quant/types.js";
+/**
+ * Exit codes, fixed so a caller can branch once. Same classes as `deploy status`: 2 means obey the
+ * refusal (never retry it), 6 means poll `quant status`, 1 means the run's state is unknown.
+ */
+export const QUANT_EXIT = { ok: 0, error: 1, refused: 2, failed: 3, running: 6 };
+/** Poll interval while a run is in flight. */
+export const QUANT_POLL_MS = 2_000;
+/** Per-call timeout for status polls (the `gateway call` default is 10 s, too tight under load). */
+export const QUANT_STATUS_TIMEOUT_MS = 15_000;
+/** Per-call timeout for `get` (a Markdown re-render spawns Python). */
+export const QUANT_GET_TIMEOUT_MS = 30_000;
+/**
+ * How long `run` waits before handing the reader the status command: the engine's 240 s cap plus
+ * slack. Deliberately BELOW the quant-desk skill's 300 s exec timeout, so the CLI's own exit-6
+ * message (with the status command) is what the reader sees — at 300 s the two tied and the exec
+ * harness could kill the CLI before it spoke.
+ */
+export const QUANT_WAIT_CAP_MS = 270_000;
+/**
+ * Consecutive empty status-poll replies tolerated once a run id exists. One transport timeout or
+ * null reply mid-poll used to end the wait with exit 1, which the skill reads as "the desk did not
+ * run" — while the gateway job kept running. Two are re-polled; the third ends the wait with exit 6
+ * and the status command, because the run's state is unknown, not failed.
+ */
+export const QUANT_EMPTY_POLLS_TOLERATED = 2;
+/** Every supported spelling, quoted by the usage and `[E_QUANT_UNSUPPORTED]` refusals. */
+const SUPPORTED = "openclaw senpi quant run <address…> [--days N] [--other|--mine] [--book] [--fresh] [--force] [--section <name>…] [--json] [--no-wait] · " +
+    "quant status [runId] · quant show <runId> [--section <name>…] [--json] · quant list";
+/** `gateway call --json` prints the payload itself; tolerate a wrapped `{ok, payload}` too. */
+function payloadOf(reply) {
+    return (reply.payload ?? reply);
+}
+/** Map a run's status onto the exit-code classes. */
+function exitFor(status) {
+    return status === "done" ? QUANT_EXIT.ok : status === "running" ? QUANT_EXIT.running : status === "refused" ? QUANT_EXIT.refused : QUANT_EXIT.failed;
+}
+/** A refusal decided before any gateway call: one bracketed line, exit 2, nothing started. */
+function refuseLocally(deps, message) {
+    deps.err(message);
+    deps.setExitCode(QUANT_EXIT.refused);
+}
+/**
+ * A gateway `ok:false` that reached us as a value: bracketed code → refused (2); anything else →
+ * internal (1). The message is printed verbatim — re-run hints in it already carry the request's
+ * `--book/--other/--days`, so the CLI never rebuilds them.
+ */
+function reportGatewayError(deps, reply) {
+    const message = (reply.error ?? {}).message ?? "The gateway refused the request.";
+    deps.err(message);
+    deps.setExitCode(isRefusalMessage(message) ? QUANT_EXIT.refused : QUANT_EXIT.error);
+}
+/** Print a refused/failed run's message and, when it has one, its next step. Exit code is the caller's. */
+function reportRunError(deps, s) {
+    if (!s.error)
+        return;
+    deps.err(s.error.message);
+    if (s.error.what_to_do)
+        deps.err(`Next: ${s.error.what_to_do}`);
+}
+/**
+ * Validate `--section` names against the engine's `QUANT_SECTIONS`. Returns `undefined` (after
+ * refusing locally) on an unknown name, so a typo never starts a 3-minute run.
+ */
+function parseSections(deps, raw) {
+    const known = QUANT_SECTIONS;
+    const unknown = (raw ?? []).filter((s) => !known.includes(s));
+    if (unknown.length > 0) {
+        refuseLocally(deps, `[E_QUANT_INVALID_REQUEST] unknown section: ${unknown.join(", ")}. Sections: ${QUANT_SECTIONS.join(", ")}.`);
+        return undefined;
+    }
+    return (raw ?? []);
+}
+/**
+ * Fetch and print a finished run (Markdown, or the JSON document with `json`) from the stored
+ * record; never recomputes. A run that is not `done` reports its status and exits by it.
+ *
+ * @returns `"shown"` only when the desk (or document) was printed — callers gate follow-up hints on
+ * it, so a refused or failed `get` is never followed by "done — show it again". `"no-reply"` means
+ * the transport returned nothing (it already printed its text and set the exit code), so a caller
+ * that knows the run exists can re-classify it; `"reported"` means the outcome is fully reported.
+ */
+async function showRun(deps, runId, sections, json) {
+    const reply = deps.callGateway("senpi.quant.get", { runId, format: json ? "json" : "markdown", ...(sections.length > 0 ? { sections } : {}) }, { timeoutMs: QUANT_GET_TIMEOUT_MS });
+    if (!reply)
+        return "no-reply";
+    if (reply.ok === false) {
+        reportGatewayError(deps, reply);
+        return "reported";
+    }
+    const got = payloadOf(reply);
+    if (got.status !== "done") {
+        if (json)
+            deps.out(JSON.stringify(got, null, 2));
+        if (got.status === "running")
+            deps.err(`[quant-desk] run ${runId} is still running; poll it: openclaw senpi quant status ${runId}`);
+        reportRunError(deps, got);
+        deps.setExitCode(exitFor(got.status));
+        return "reported";
+    }
+    deps.out(json ? JSON.stringify(got.document ?? null, null, 2) : got.markdown ?? "");
+    deps.setExitCode(QUANT_EXIT.ok);
+    return "shown";
+}
+/**
+ * The run exists but its state could not be read: print `line` (which names the command to run
+ * next) and exit 6. Used wherever a
+ * reply went missing AFTER the run line was printed — exit 1 there would read as "the desk did not
+ * run" while the gateway job may well still be running (or already done).
+ */
+function reportStateUnknown(deps, line) {
+    deps.err(line);
+    deps.setExitCode(QUANT_EXIT.running);
+}
+/**
+ * Poll `senpi.quant.status` every `QUANT_POLL_MS` until the run leaves `running`, relaying each NEW
+ * progress line once to stderr. Returns the settled status, or `undefined` when this function has
+ * already reported the outcome (a bracketed gateway refusal → 2, the wait cap or
+ * `QUANT_EMPTY_POLLS_TOLERATED` + 1 consecutive empty replies → 6 with the status command). The wait
+ * cap is checked on every poll, empty or not, so no mix of empty and answered replies can stretch
+ * the wait past `QUANT_WAIT_CAP_MS` (plus the one poll in flight). The run itself is a gateway job,
+ * so giving up waiting never stops it.
+ *
+ * An "empty" reply is a null from the transport (timeout, dispatch failure — the transport has
+ * already printed its text and set exit 1, which a later answer overwrites) or an uncoded
+ * `ok:false`. A bracketed `ok:false` is an answer and is obeyed at once. A null that was in fact a
+ * gateway refusal (the transport cannot tell us) is re-polled too; after the third it reads exit 6,
+ * and the status command it names then prints the refusal with its own exit 2.
+ */
+async function pollUntilSettled(deps, runId) {
+    const deadline = deps.now() + QUANT_WAIT_CAP_MS;
+    let lastProgress;
+    let empty = 0;
+    for (;;) {
+        await deps.sleep(QUANT_POLL_MS);
+        const reply = deps.callGateway("senpi.quant.status", { runId }, { timeoutMs: QUANT_STATUS_TIMEOUT_MS });
+        if (reply?.ok === false && isRefusalMessage((reply.error ?? {}).message ?? "")) {
+            reportGatewayError(deps, reply);
+            return undefined;
+        }
+        if (!reply || reply.ok === false) {
+            if (reply)
+                deps.err((reply.error ?? {}).message ?? "The gateway gave no answer.");
+            empty += 1;
+            // The cap binds here too: without it, empty replies around the deadline re-poll past 270 s.
+            if (empty > QUANT_EMPTY_POLLS_TOLERATED || deps.now() >= deadline) {
+                reportStateUnknown(deps, `[quant-desk] run ${runId}: state unknown; the desk may still be running — its state: openclaw senpi quant status ${runId}`);
+                return undefined;
+            }
+            continue;
+        }
+        empty = 0;
+        const st = payloadOf(reply);
+        if (st.progress && st.progress !== lastProgress) {
+            deps.err(st.progress);
+            lastProgress = st.progress;
+        }
+        if (st.status !== "running")
+            return st;
+        if (deps.now() >= deadline) {
+            deps.err(`[quant-desk] run ${runId} is still running after ${QUANT_WAIT_CAP_MS / 1000}s; poll it: openclaw senpi quant status ${runId}`);
+            deps.setExitCode(QUANT_EXIT.running);
+            return undefined;
+        }
+    }
+}
+/**
+ * `senpi quant run <address…>`: validate locally, start the gateway job, print the run line, then
+ * (unless `--no-wait`) poll until settled and print the desk.
+ *
+ * Local refusals (unsupported mode, contradictory voice, no address, unknown section, bad days)
+ * happen before any gateway call. Address shape, book width and day bounds are the gateway's to
+ * judge — the CLI does not duplicate them.
+ */
+export async function runQuantRun(deps, addresses, flags) {
+    const unsupported = flags.deep !== undefined ? "--deep" : flags.find !== undefined ? "--find" : flags.compare ? "--compare" : undefined;
+    if (unsupported)
+        return refuseLocally(deps, `[E_QUANT_UNSUPPORTED] ${unsupported} is not available through the runtime yet. Supported: ${SUPPORTED}`);
+    if (flags.other && flags.mine)
+        return refuseLocally(deps, "[E_QUANT_INVALID_REQUEST] --other and --mine contradict each other; pass one. Nothing was started.");
+    if (addresses.length === 0)
+        return refuseLocally(deps, `[E_QUANT_INVALID_REQUEST] an address is required. Usage: ${SUPPORTED}`);
+    const sections = parseSections(deps, flags.section);
+    if (!sections)
+        return;
+    let days;
+    if (flags.days !== undefined) {
+        days = Number(flags.days);
+        if (!Number.isInteger(days))
+            return refuseLocally(deps, `[E_QUANT_INVALID_REQUEST] --days must be a whole number; got "${flags.days}". Nothing was started.`);
+    }
+    const started = deps.callGateway("senpi.quant.start", {
+        addresses,
+        ...(days !== undefined ? { days } : {}),
+        whose: flags.other ? "other" : "mine",
+        book: flags.book === true,
+        fresh: flags.fresh === true,
+        force: flags.force === true,
+    });
+    if (!started)
+        return;
+    if (started.ok === false)
+        return reportGatewayError(deps, started);
+    const s = payloadOf(started);
+    // The run line: first stderr line in every mode once a run exists (see the module JSDoc).
+    deps.err(`[quant-desk] run ${s.runId}${s.cached ? " (served from a run finished in the last 10 minutes; --fresh recomputes)" : ""}`);
+    if (flags.wait === false) {
+        deps.out(JSON.stringify({ runId: s.runId }));
+        deps.setExitCode(s.status === "done" ? QUANT_EXIT.ok : QUANT_EXIT.running);
+        return;
+    }
+    const final = s.status === "done" ? { runId: s.runId, status: "done" } : await pollUntilSettled(deps, s.runId);
+    if (!final)
+        return;
+    if (final.status !== "done") {
+        if (flags.json === true)
+            deps.out(JSON.stringify(final, null, 2));
+        reportRunError(deps, final);
+        deps.setExitCode(exitFor(final.status));
+        return;
+    }
+    const shown = await showRun(deps, s.runId, sections, flags.json === true);
+    if (shown === "no-reply") {
+        // The run finished; only the fetch of its desk went unanswered. Exit 1 would read as "the
+        // desk did not run" — exit 6 and the command that prints it instead.
+        reportStateUnknown(deps, `[quant-desk] run ${s.runId} finished but its desk could not be fetched — show it: openclaw senpi quant show ${s.runId}`);
+        return;
+    }
+    if (shown !== "shown")
+        return;
+    deps.err(`[quant-desk] run ${s.runId} done — any section again, without recomputing: openclaw senpi quant show ${s.runId} --section <name>`);
+}
+/** `senpi quant status [runId]` — no id = the newest run. Exit code follows the run's status. */
+export async function runQuantStatus(deps, runId, flags) {
+    const reply = deps.callGateway("senpi.quant.status", runId ? { runId } : {}, { timeoutMs: QUANT_STATUS_TIMEOUT_MS });
+    if (!reply)
+        return;
+    if (reply.ok === false)
+        return reportGatewayError(deps, reply);
+    const st = payloadOf(reply);
+    deps.setExitCode(exitFor(st.status));
+    if (flags.json)
+        return deps.out(JSON.stringify(st, null, 2));
+    deps.out(`run ${st.runId} · ${st.status} · started ${st.startedAt ?? "?"}${st.finishedAt ? ` · finished ${st.finishedAt}` : ""}`);
+    if (st.progress)
+        deps.out(`  ${st.progress}`);
+    if (st.status === "done")
+        deps.out(`  read it: openclaw senpi quant show ${st.runId}`);
+    if (st.status === "running")
+        deps.out(`  poll again in a few seconds: openclaw senpi quant status ${st.runId}`);
+    reportRunError(deps, st);
+}
+/** `senpi quant show <runId>` — re-render from the stored document, never recompute. */
+export async function runQuantShow(deps, runId, flags) {
+    const sections = parseSections(deps, flags.section);
+    if (!sections)
+        return;
+    await showRun(deps, runId, sections, flags.json === true);
+}
+/**
+ * `senpi quant list` — the stored runs, newest first (normally the last 20; more while runs are in
+ * flight). One line per run: id, status, window, whose (+ "book"), wallets, finished-or-started.
+ */
+export async function runQuantList(deps, flags) {
+    const reply = deps.callGateway("senpi.quant.list", {});
+    if (!reply)
+        return;
+    if (reply.ok === false)
+        return reportGatewayError(deps, reply);
+    const { runs } = payloadOf(reply);
+    deps.setExitCode(QUANT_EXIT.ok);
+    if (flags.json)
+        return deps.out(JSON.stringify({ runs }, null, 2));
+    if (runs.length === 0)
+        return deps.out("No quant runs yet. Start one: openclaw senpi quant run <0x address>");
+    for (const r of runs) {
+        deps.out(`${r.runId}  ${r.status.padEnd(8)}  ${r.days}d  ${r.whose}${r.book ? " book" : ""}  ${r.addresses.join(",")}  ${r.finishedAt ?? r.startedAt}`);
+    }
+}
+/**
+ * Register `senpi quant run|status|show|list`. `--deep/--find/--compare` are declared so they reach
+ * `runQuantRun` and are refused with `[E_QUANT_UNSUPPORTED]` naming what is supported, rather than
+ * dying on Commander's generic "unknown option".
+ */
+export function registerQuantCommands(senpi, deps) {
+    const collect = (value, prev = []) => [...prev, value];
+    const quant = senpi.command("quant").description("The quant desk on any Hyperliquid wallet — score, leaks, next steps (read-only). Exit codes: 0 done · 2 refused · 3 failed · 6 still running or state unknown (poll quant status) · 1 error before a run exists");
+    quant.command("run")
+        .description("Run the desk and print it (waits; 30–180 s). First stderr line: [quant-desk] run <runId>")
+        // Optional to Commander on purpose: a missing address must reach runQuantRun and be refused
+        // [E_QUANT_INVALID_REQUEST] (exit 2), not die on Commander's own un-coded error (exit 1).
+        .argument("[address...]", "One wallet, or several with --book (required)")
+        .option("--days <n>", "Window in days (default 90)")
+        .option("--other", "Someone else's book (analyst voice)")
+        .option("--mine", "The reader's own book (default)")
+        .option("--book", "Read several wallets as ONE book (a senpi user's strategy wallets)")
+        .option("--fresh", "Recompute even if the same desk finished in the last 10 minutes")
+        .option("--force", "Read a vault or a very wide book anyway (only when the reader insists)")
+        .option("--section <name>", `Print only these sections (repeatable): ${QUANT_SECTIONS.join(", ")}`, collect)
+        .option("--json", "Print the desk document (doc_version 1) as JSON on stdout")
+        .option("--no-wait", "Start and print {runId} without waiting (exit 6 while running)")
+        // Optional values: a bare trailing `--deep`/`--find` must still reach [E_QUANT_UNSUPPORTED]
+        // rather than die on Commander's un-coded "argument missing" (exit 1).
+        .option("--deep [mode]", "Not available through the runtime yet (refused)")
+        .option("--find [band]", "Not available through the runtime yet (refused)")
+        .option("--compare", "Not available through the runtime yet (refused)")
+        .action(async (addresses, flags) => runQuantRun(deps, addresses ?? [], flags));
+    quant.command("status")
+        .description("A run's status; the newest when no id is given")
+        .argument("[runId]", "Run id from `[quant-desk] run <id>`")
+        .option("--json", "Raw JSON")
+        .action(async (runId, flags) => runQuantStatus(deps, runId, flags));
+    quant.command("show")
+        .description("Re-render a finished run from the stored document (never recomputes)")
+        .argument("<runId>", "Run id")
+        .option("--section <name>", "Only these sections (repeatable)", collect)
+        .option("--json", "The stored document as JSON")
+        .action(async (runId, flags) => runQuantShow(deps, runId, flags));
+    quant.command("list")
+        .description("The last 20 runs, newest first")
+        .option("--json", "Raw JSON")
+        .action(async (flags) => runQuantList(deps, flags));
+}
+//# sourceMappingURL=quant-command.js.map

package/dist/cli/quant-command.js.map

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

package/dist/cli/senpi-commands.d.ts

@@ -10,6 +10,17 @@ import type { StoredEvent } from "../telemetry/event-store.js";
 export declare function registerSenpiCli(program: {
     command: (name: string, desc?: string) => CommanderCommand | unknown;
 }): void;
+/**
+ * argv for `openclaw gateway call`. Exported so the timeout wiring is testable without a
+ * subprocess. `--timeout` is the per-call gateway timeout (the CLI default is 10 s); omitting
+ * `timeoutMs` keeps the historical argv byte-for-byte, so every existing caller is unchanged.
+ *
+ * @param method Gateway method name, e.g. `senpi.quant.status`.
+ * @param params JSON-serialisable params, passed as one `--params` argv element (never via a shell).
+ * @param timeoutMs Optional per-call timeout in milliseconds, placed before `--params`.
+ * @returns argv to append after the OpenClaw entry script.
+ */
+export declare function gatewayCallArgs(method: string, params: Record<string, unknown>, timeoutMs?: number): string[];
 /**
  * Render the risk audit log as a tab-separated digest (newest entries last,
  * as returned). Each row: time, source, then `guardrail=result` per