@senpi/runtime 3.0.146 → 3.0.149

package/dist/widgets/types.d.ts

@@ -2,10 +2,12 @@
  * Widget spec types.
  *
  * A widget spec is the single source for one `widget_type`: the text that
- * teaches the model when to reach for the card, and the handler that builds
- * the result. The `show_widget` descriptor (enum + description) is generated
- * from the spec list, so the two cannot drift.
+ * teaches the model when to reach for the card, the extra arguments it takes,
+ * and the handler that builds the result. The `show_widget` descriptor (enum,
+ * merged parameters, description) is generated from the spec list, so the two
+ * cannot drift.
  */
+import type { QuantRunReader } from "../quant/types.js";
 /** Rendered by the client. Always carries the three shared keys. */
 export interface WidgetPayload {
     readonly widget_type: string;
@@ -18,6 +20,14 @@ export interface WidgetResult {
     /** Short line for the agent — what happened and what not to do next. */
     readonly text: string;
 }
+/**
+ * Collaborators a handler may read, injected at registration. Optional so a deployment without a
+ * collaborator still registers the tool; a handler that needs one fails with a teaching error.
+ */
+export interface WidgetHandlerContext {
+    /** The quant desk's stored runs (`src/quant/registry.ts`), read-only. Absent when the desk failed to build. */
+    readonly quantRuns?: QuantRunReader;
+}
 export interface WidgetSpec {
     readonly widgetType: string;
     /** Bumped when the payload shape changes; the client falls back on unknown versions. */
@@ -37,8 +47,26 @@ export interface WidgetSpec {
     readonly notFor: string;
     /** Situations illustrating the condition. One line each, reproduced verbatim. */
     readonly examples: readonly string[];
-    /** Takes no arguments: `show_widget` accepts `widget_type` and nothing else. */
-    readonly handler: () => WidgetResult | Promise<WidgetResult>;
+    /** How the rendered card is acted on — one line in the description. Per type: not every card has a button. */
+    readonly affordance: string;
+    /** One line naming the fields beyond widget_type, reproduced in the description. Absent = widget_type only. */
+    readonly fields?: string;
+    /**
+     * JSON-schema properties beyond widget_type, merged into the ONE flat parameter object. Each name
+     * has one owner across all specs (checked at registry build) and none may be `widget_type`.
+     * Flat and union-free, like the rest of the schema (see `buildShowWidgetParameters`).
+     */
+    readonly extraParameters?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+    /**
+     * Builds the result. `args` has already passed the extra-field check for this type (only
+     * `widget_type` and this spec's `extraParameters` keys are present); the handler still validates
+     * their values, since the schema is advisory to the model and the handler is the real boundary.
+     *
+     * @param args The call's arguments, `widget_type` included.
+     * @param ctx Collaborators injected at registration; a handler needing an absent one throws a
+     *   teaching error (a `WidgetValidationError`) naming the fallback.
+     */
+    readonly handler: (args: Readonly<Record<string, unknown>>, ctx: WidgetHandlerContext) => WidgetResult | Promise<WidgetResult>;
 }
 /** A spec plus its resolved on/off state from plugin config. */
 export interface RegisteredWidget extends WidgetSpec {

package/dist/widgets/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/widgets/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wFAAwF;IACxF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC9D;AAED,gEAAgE;AAChE,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,mEAAmE;IACnE,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/widgets/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,+GAA+G;IAC/G,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;CACrC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wFAAwF;IACxF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,8GAA8G;IAC9G,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+GAA+G;IAC/G,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACvF;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,EAAE,CAChB,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACvC,GAAG,EAAE,oBAAoB,KACtB,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC3C;AAED,gEAAgE;AAChE,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,mEAAmE;IACnE,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClC"}

package/dist/widgets/types.js

@@ -2,9 +2,10 @@
  * Widget spec types.
  *
  * A widget spec is the single source for one `widget_type`: the text that
- * teaches the model when to reach for the card, and the handler that builds
- * the result. The `show_widget` descriptor (enum + description) is generated
- * from the spec list, so the two cannot drift.
+ * teaches the model when to reach for the card, the extra arguments it takes,
+ * and the handler that builds the result. The `show_widget` descriptor (enum,
+ * merged parameters, description) is generated from the spec list, so the two
+ * cannot drift.
  */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/widgets/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/widgets/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/widgets/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/widgets/widgets/fund-user-wallet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fund-user-wallet.d.ts","sourceRoot":"","sources":["../../../src/widgets/widgets/fund-user-wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK9C;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAE,UA6BhC,CAAC"}
+{"version":3,"file":"fund-user-wallet.d.ts","sourceRoot":"","sources":["../../../src/widgets/widgets/fund-user-wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK9C;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAE,UA8BhC,CAAC"}

package/dist/widgets/widgets/fund-user-wallet.js

@@ -15,6 +15,7 @@ export const fundUserWalletSpec = {
     description: "Opens Senpi's deposit flow for the user's OWN Senpi wallet, the one they deposit into from outside. " +
         "The card owns the address, the networks and the deposit copy — never write a deposit address, a QR code " +
         "or a network list in chat.",
+    affordance: "live UI: its button runs the flow, so showing it is how the user acts.",
     callWhen: "Call it whenever you want money to arrive in the user's own Senpi wallet, whether or not the user " +
         "mentions a deposit or a card.",
     notFor: "Funding, topping up or adding margin to a STRATEGY — a strategy is funded from the user's own wallet " +

package/dist/widgets/widgets/fund-user-wallet.js.map

@@ -1 +1 @@
-{"version":3,"file":"fund-user-wallet.js","sourceRoot":"","sources":["../../../src/widgets/widgets/fund-user-wallet.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG,kBAAkB,CAAC;AACvC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEzB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC5C,UAAU,EAAE,WAAW;IACvB,aAAa,EAAE,cAAc;IAC7B,WAAW,EACT,sGAAsG;QACtG,0GAA0G;QAC1G,4BAA4B;IAC9B,QAAQ,EACN,oGAAoG;QACpG,+BAA+B;IACjC,MAAM,EACJ,uGAAuG;QACvG,iEAAiE;IACnE,QAAQ,EAAE;QACR,kFAAkF;QAClF,sCAAsC;QACtC,2FAA2F;QAC3F,4FAA4F;KAC7F;IACD,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QACd,OAAO,EAAE;YACP,WAAW,EAAE,WAAW;YACxB,cAAc,EAAE,cAAc;YAC9B,MAAM,EAAE,OAAO;SAChB;QACD,IAAI,EACF,0DAA0D;YAC1D,wEAAwE;KAC3E,CAAC;CACH,CAAC"}
+{"version":3,"file":"fund-user-wallet.js","sourceRoot":"","sources":["../../../src/widgets/widgets/fund-user-wallet.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG,kBAAkB,CAAC;AACvC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEzB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC5C,UAAU,EAAE,WAAW;IACvB,aAAa,EAAE,cAAc;IAC7B,WAAW,EACT,sGAAsG;QACtG,0GAA0G;QAC1G,4BAA4B;IAC9B,UAAU,EAAE,wEAAwE;IACpF,QAAQ,EACN,oGAAoG;QACpG,+BAA+B;IACjC,MAAM,EACJ,uGAAuG;QACvG,iEAAiE;IACnE,QAAQ,EAAE;QACR,kFAAkF;QAClF,sCAAsC;QACtC,2FAA2F;QAC3F,4FAA4F;KAC7F;IACD,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QACd,OAAO,EAAE;YACP,WAAW,EAAE,WAAW;YACxB,cAAc,EAAE,cAAc;YAC9B,MAAM,EAAE,OAAO;SAChB;QACD,IAAI,EACF,0DAA0D;YAC1D,wEAAwE;KAC3E,CAAC;CACH,CAAC"}

package/dist/widgets/widgets/quant-desk-recommendations.d.ts

@@ -0,0 +1,52 @@
+import type { WidgetSpec } from "../types.js";
+import { type QuantCard, type QuantCardAction, type QuantStopLoss } from "../../quant/types.js";
+/** One call shows at most this many cards (the engine emits at most four today). */
+export declare const QUANT_WIDGET_MAX_ITEMS = 5;
+/**
+ * The engine's `render.usd()` in TypeScript: whole dollars, thousands separators, Python's
+ * half-even rounding, a leading minus for negatives. The number itself is the stored one — this
+ * only spells it the way the desk's own Markdown does, so the card text and the desk agree.
+ *
+ * `a - Math.floor(a)` is exact for a double, so `frac === 0.5` holds exactly when the stored value
+ * is a binary half — the same tie Python's `format(x, ",.0f")` rounds to even.
+ *
+ * @param x A finite USD amount (cards only ever carry finite `usd`).
+ * @returns e.g. `$1,234`, `-$13`.
+ */
+export declare function formatUsd(x: number): string;
+/**
+ * A stop loss price for the result text: five significant digits, no exponent (2461.6, 2.1353, 105000).
+ * The card carries the exact value; this only names it so the model can point at the right button.
+ */
+export declare function formatPx(x: number): string;
+/** The marker the skill keys on: text naming a Set stop loss button is the only proof one exists. */
+export declare const SET_STOP_LOSS_MARKER = "Set stop loss button:";
+/**
+ * Re-validate one stored stop loss before it can reach a client, projecting exactly the
+ * {@link QuantStopLoss} fields. Null — the stop loss is dropped, never repaired — when any invariant fails:
+ * a stop loss a client would sign has to be one the engine could have priced. The checks mirror
+ * `deep.card_stop_losses`, so an engine-built stop loss always passes.
+ *
+ * @param raw One element of a stored card's `action.stop_losses`.
+ * @returns The stop loss with a lowercased wallet, or null.
+ */
+export declare function parseQuantStopLoss(raw: unknown): QuantStopLoss | null;
+/**
+ * The action a card may show — the runtime's single enforcement of {@link ACTIONABLE_KINDS}.
+ * Undefined when the card's kind allows no action, the stored action is not the kind's allowed
+ * type, or no stop loss survives {@link parseQuantStopLoss}: a card never carries an empty action.
+ *
+ * @param card A stored card; its `action` is read as untrusted.
+ */
+export declare function cardAction(card: QuantCard): QuantCardAction | undefined;
+/**
+ * `quant_desk_recommendations` — a finished quant desk's next steps as cards.
+ *
+ * References in, payload out (spec D7): the model passes a run id and optional card ids, never a
+ * figure. The handler reads the stored run in-process and returns the engine's own cards in
+ * `details` (for the client) and in the text (history strips `details`; the model narrates from
+ * the text). v2: a card may carry an `action` — today only the protect card's `set_stop_loss`, enforced
+ * by `cardAction` against `ACTIONABLE_KINDS`; every other card's `cta` is text.
+ */
+export declare const quantDeskRecommendationsSpec: WidgetSpec;
+//# sourceMappingURL=quant-desk-recommendations.d.ts.map

package/dist/widgets/widgets/quant-desk-recommendations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quant-desk-recommendations.d.ts","sourceRoot":"","sources":["../../../src/widgets/widgets/quant-desk-recommendations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAsC,UAAU,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAML,KAAK,SAAS,EACd,KAAK,eAAe,EAIpB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAK9B,oFAAoF;AACpF,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAOxC;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAO3C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,qGAAqG;AACrG,eAAO,MAAM,oBAAoB,0BAA0B,CAAC;AAkB5D;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAiBrE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,GAAG,SAAS,CAQvE;AAqJD;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,EAAE,UAyB1C,CAAC"}

package/dist/widgets/widgets/quant-desk-recommendations.js

@@ -0,0 +1,278 @@
+import { WidgetValidationError } from "../errors.js";
+import { ACTIONABLE_KINDS, QUANT_ADDRESS_RE, QUANT_RUN_ID_RE, QuantRunLookupError, quantRunArgs, } from "../../quant/types.js";
+const WIDGET_TYPE = "quant_desk_recommendations";
+/** 2: cards may carry an allowlisted `action` (the protect card's `set_stop_loss`). Clients on v1 fall back. */
+const WIDGET_VERSION = 2;
+/** One call shows at most this many cards (the engine emits at most four today). */
+export const QUANT_WIDGET_MAX_ITEMS = 5;
+/** Throw the one expected failure of this type: a teaching error naming the fields at fault. */
+function fail(message, fields) {
+    throw new WidgetValidationError(`show_widget failed for widget_type "${WIDGET_TYPE}": ${message}`, WIDGET_TYPE, fields);
+}
+/**
+ * The engine's `render.usd()` in TypeScript: whole dollars, thousands separators, Python's
+ * half-even rounding, a leading minus for negatives. The number itself is the stored one — this
+ * only spells it the way the desk's own Markdown does, so the card text and the desk agree.
+ *
+ * `a - Math.floor(a)` is exact for a double, so `frac === 0.5` holds exactly when the stored value
+ * is a binary half — the same tie Python's `format(x, ",.0f")` rounds to even.
+ *
+ * @param x A finite USD amount (cards only ever carry finite `usd`).
+ * @returns e.g. `$1,234`, `-$13`.
+ */
+export function formatUsd(x) {
+    const a = Math.abs(x);
+    const floor = Math.floor(a);
+    const frac = a - floor;
+    const whole = frac > 0.5 || (frac === 0.5 && floor % 2 === 1) ? floor + 1 : floor;
+    const s = `$${whole.toLocaleString("en-US")}`;
+    return x < 0 ? `-${s}` : s;
+}
+/**
+ * A stop loss price for the result text: five significant digits, no exponent (2461.6, 2.1353, 105000).
+ * The card carries the exact value; this only names it so the model can point at the right button.
+ */
+export function formatPx(x) {
+    return String(Number(x.toPrecision(5)));
+}
+/** The marker the skill keys on: text naming a Set stop loss button is the only proof one exists. */
+export const SET_STOP_LOSS_MARKER = "Set stop loss button:";
+/**
+ * One card in the result text: its title, plus the stored figure and window when it has both, plus
+ * the stop losses its Set stop loss button carries. History strips `details`, so this text is the model's only
+ * view of the button — the skill tells the reader to use Set stop loss only when this line names one.
+ */
+function cardLine(card) {
+    const base = card.usd !== null && card.window !== null ? `${card.title} (~${formatUsd(card.usd)} / ${card.window})` : card.title;
+    if (!card.action)
+        return base;
+    return `${base} (${SET_STOP_LOSS_MARKER} ${card.action.stop_losses.map((s) => `${s.coin} @ ${formatPx(s.trigger_px)}`).join(", ")})`;
+}
+/** A finite number greater than zero. `"Infinity"` (the engine's strict-JSON spelling) is not one. */
+function isPositive(x) {
+    return typeof x === "number" && Number.isFinite(x) && x > 0;
+}
+/**
+ * Re-validate one stored stop loss before it can reach a client, projecting exactly the
+ * {@link QuantStopLoss} fields. Null — the stop loss is dropped, never repaired — when any invariant fails:
+ * a stop loss a client would sign has to be one the engine could have priced. The checks mirror
+ * `deep.card_stop_losses`, so an engine-built stop loss always passes.
+ *
+ * @param raw One element of a stored card's `action.stop_losses`.
+ * @returns The stop loss with a lowercased wallet, or null.
+ */
+export function parseQuantStopLoss(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const { coin, dex, side, size, entry, mark, liq_px: liqPx, trigger_px: triggerPx, trigger_pct: triggerPct, wallet } = raw;
+    if (typeof coin !== "string" || coin === "")
+        return null;
+    if (dex !== (coin.includes(":") ? coin.slice(0, coin.indexOf(":")) : ""))
+        return null;
+    if (side !== "long" && side !== "short")
+        return null;
+    if (!isPositive(size) || !isPositive(entry) || !isPositive(mark) || !isPositive(triggerPx) || !isPositive(triggerPct))
+        return null;
+    if (liqPx !== null && !isPositive(liqPx))
+        return null;
+    if (typeof wallet !== "string" || !QUANT_ADDRESS_RE.test(wallet))
+        return null;
+    const sgn = side === "long" ? 1 : -1;
+    if (sgn * (mark - triggerPx) <= 0)
+        return null; // a stop loss sits on the losing side of the mark
+    if (liqPx !== null && sgn * (triggerPx - liqPx) <= 0)
+        return null; // and triggers before liquidation
+    return {
+        coin, dex, side, size, entry, mark, liq_px: liqPx, trigger_px: triggerPx, trigger_pct: triggerPct,
+        wallet: wallet.toLowerCase(),
+    };
+}
+/**
+ * The action a card may show — the runtime's single enforcement of {@link ACTIONABLE_KINDS}.
+ * Undefined when the card's kind allows no action, the stored action is not the kind's allowed
+ * type, or no stop loss survives {@link parseQuantStopLoss}: a card never carries an empty action.
+ *
+ * @param card A stored card; its `action` is read as untrusted.
+ */
+export function cardAction(card) {
+    const allowed = ACTIONABLE_KINDS[card.kind];
+    const raw = card.action;
+    if (!allowed || !raw || typeof raw !== "object")
+        return undefined;
+    const { type, stop_losses: stopLosses } = raw;
+    if (type !== allowed || !Array.isArray(stopLosses))
+        return undefined;
+    const valid = stopLosses.map(parseQuantStopLoss).filter((s) => s !== null);
+    return valid.length > 0 ? { type: allowed, stop_losses: valid } : undefined;
+}
+/** The card exactly as the schema says, whatever else a stored card might carry; `action` only if allowed. */
+function project(c) {
+    const action = cardAction(c);
+    return { id: c.id, kind: c.kind, title: c.title, detail: c.detail, usd: c.usd, window: c.window, cta: c.cta, ...(action ? { action } : {}) };
+}
+/**
+ * The refusal for a run the desk knows but cannot show — its file is corrupt or gone while the
+ * index lists it, or it is `done` with no document. Mirrors `senpi.quant.get`'s answer
+ * (`src/quant/register.ts` `unreadableRun`): naming `quant list` here would loop the model between
+ * a list that shows the run and a card that cannot read it, so it names the exact re-run instead.
+ * `--fresh` so the re-run cannot be served from anything cached for the same request.
+ */
+function failUnreadable(runId, why, request) {
+    fail(`stored run ${runId} is unreadable (${why}); there are no cards to show for it. ` +
+        `Re-run the desk: openclaw senpi quant run ${quantRunArgs(request)} --fresh`, ["run_id"]);
+}
+/** `text` as a sentence: trimmed, with a closing period unless it already ends in punctuation. */
+function sentence(text) {
+    const t = text.trim();
+    return /[.!?]$/.test(t) ? t : `${t}.`;
+}
+/**
+ * The stored error of a failed/refused run, ready to sit between the refusal and (for a failed run
+ * only) the re-run:
+ * its message and, when present, its `what_to_do` — the engine's own advice (a lighter window,
+ * the own-wallet guidance) is worth more to the model than the bare re-run that follows it.
+ * Each part ends in exactly one period whatever the stored text ended with. Empty when the run
+ * stored no error.
+ */
+function storedErrorText(error) {
+    if (!error)
+        return "";
+    const parts = [error.message, error.what_to_do].filter((p) => typeof p === "string" && p.trim() !== "");
+    return parts.length > 0 ? `Its error: ${parts.map(sentence).join(" ")} ` : "";
+}
+/**
+ * Read one stored run through the injected reader, turning every miss into a teaching error:
+ * no reader → relay the next steps as text; another docVersion → the registry's own refusal;
+ * listed but unreadable → the exact re-run; unknown (incl. path-like ids, which the registry never
+ * resolves) → up to five recent ids and `quant list`.
+ */
+async function readRun(ctx, runId) {
+    const runs = ctx.quantRuns;
+    if (!runs)
+        fail("the quant desk is not available on this agent. Relay the desk's next-steps section as text instead.", ["run_id"]);
+    let record;
+    try {
+        record = await runs.get(runId);
+    }
+    catch (err) {
+        if (err instanceof QuantRunLookupError)
+            fail(`${err.error.message} ${err.error.what_to_do}`, ["run_id"]);
+        throw err;
+    }
+    if (record)
+        return record;
+    const rows = await runs.list();
+    const row = QUANT_RUN_ID_RE.test(runId) ? rows.find((r) => r.runId === runId) : undefined;
+    if (row)
+        failUnreadable(runId, "its file is missing or not valid JSON", row);
+    const recent = rows.slice(0, 5).map((r) => r.runId);
+    fail(`no quant run "${runId}" on this agent. ${recent.length > 0 ? `Recent runs: ${recent.join(", ")}.` : "No desk has been run yet."} ` +
+        `Use the id from the "[quant-desk] run <id>" line, or list them: openclaw senpi quant list`, ["run_id"]);
+}
+/**
+ * The cards to show, in the engine's order. No `items` → all of them (capped); otherwise at least
+ * one id (an empty list would answer "shown" for cards the user never saw), every id one of this
+ * run's, at most {@link QUANT_WIDGET_MAX_ITEMS} per call. The caller picks
+ * WHICH cards, never their order or their content.
+ */
+function selectCards(all, raw, runId) {
+    const ids = all.map((c) => c.id);
+    if (raw === undefined)
+        return all.slice(0, QUANT_WIDGET_MAX_ITEMS).map(project);
+    if (!Array.isArray(raw) || raw.some((x) => typeof x !== "string")) {
+        fail(`"items" must be a list of card ids from run ${runId}: ${ids.join(", ")}.`, ["items"]);
+    }
+    const wanted = raw;
+    if (wanted.length === 0) {
+        fail(`"items" must name at least one card id from run ${runId}: ${ids.join(", ")}; omit "items" to show them all.`, ["items"]);
+    }
+    if (wanted.length > QUANT_WIDGET_MAX_ITEMS) {
+        fail(`at most ${QUANT_WIDGET_MAX_ITEMS} cards per call; got ${wanted.length}. Pick the ones that matter and put the rest in text.`, ["items"]);
+    }
+    const unknown = wanted.filter((id) => !ids.includes(id));
+    if (unknown.length > 0)
+        fail(`unknown card id ${unknown.join(", ")}. Run ${runId} has: ${ids.join(", ")}.`, ["items"]);
+    return all.filter((c) => wanted.includes(c.id)).map(project);
+}
+/**
+ * Validate the references, read the stored run, and build the result from the engine's own cards.
+ * Nothing in the result is authored by the caller except the run id it echoes.
+ */
+async function handler(args, ctx) {
+    // Trimmed once and used everywhere, so a stray space never turns a real id into "no quant run".
+    const runId = typeof args.run_id === "string" ? args.run_id.trim() : "";
+    if (runId === "") {
+        fail('"run_id" is required — the id from the "[quant-desk] run <id>" line that openclaw senpi quant run prints.', ["run_id"]);
+    }
+    const record = await readRun(ctx, runId);
+    if (record.meta.status === "done" && !record.document)
+        failUnreadable(runId, "the stored run has no document", record.meta);
+    if (record.meta.status === "running") {
+        fail(`run ${runId} is running, not done — there are no cards to show yet. Check it: openclaw senpi quant status ${runId}`, ["run_id"]);
+    }
+    if (record.meta.status !== "done" || !record.document) {
+        // failed/refused are final: waiting will not produce cards, so never name status. Only a
+        // FAILED run (timeout, upstream, engine fault) earns the --fresh re-run; a REFUSED run
+        // (no activity, not a trader) would refuse again identically, so its stored message and
+        // what_to_do are the last words — they already say what would change the answer.
+        const head = `run ${runId} is ${record.meta.status}, not done — it has no cards to show. ` + storedErrorText(record.error);
+        fail(record.meta.status === "failed"
+            ? `${head}Re-run the desk: openclaw senpi quant run ${quantRunArgs(record.meta)} --fresh`
+            : head.trimEnd(), ["run_id"]);
+    }
+    const document = record.document;
+    const all = Array.isArray(document.cards) ? document.cards : [];
+    if (all.length === 0) {
+        const analyst = (record.meta.whose ?? document.whose) === "other";
+        fail(`run ${runId} has no recommendation cards` +
+            `${analyst ? ": an analyst read of someone else's book has no next steps for the reader" : ""}. ` +
+            `Relay its next section as text: openclaw senpi quant show ${runId} --section next`, ["run_id"]);
+    }
+    const cards = selectCards(all, args.items, runId);
+    const n = cards.length;
+    return {
+        payload: { widget_type: WIDGET_TYPE, widget_version: WIDGET_VERSION, status: "shown", run_id: runId, cards },
+        text: `${n} recommendation card${n === 1 ? "" : "s"} shown from run \`${runId}\`: ${cards.map(cardLine).join("; ")}. ` +
+            "The cards carry the titles, details and figures; add at most one framing sentence and do not restate them. " +
+            (cards.some((c) => c.action)
+                ? "The protect card's Set stop loss button places each listed stop loss from the reader's own wallet after they review and sign it: " +
+                    "point the reader to Set stop loss on that card, and describe no button on any other card. "
+                : "") +
+            "Answer follow-ups in text without calling show_widget again.",
+    };
+}
+/**
+ * `quant_desk_recommendations` — a finished quant desk's next steps as cards.
+ *
+ * References in, payload out (spec D7): the model passes a run id and optional card ids, never a
+ * figure. The handler reads the stored run in-process and returns the engine's own cards in
+ * `details` (for the client) and in the text (history strips `details`; the model narrates from
+ * the text). v2: a card may carry an `action` — today only the protect card's `set_stop_loss`, enforced
+ * by `cardAction` against `ACTIONABLE_KINDS`; every other card's `cta` is text.
+ */
+export const quantDeskRecommendationsSpec = {
+    widgetType: WIDGET_TYPE,
+    widgetVersion: WIDGET_VERSION,
+    description: "the desk's next steps as cards (protect first, biggest leak, keep the agents on), rendered from a finished quant run",
+    affordance: "the protect card has a Set stop loss button only when this result's text lists `Set stop loss button:` stop losses; no other card has a button, and `cta` is text",
+    fields: "run_id (from the `[quant-desk] run <id>` line), items (optional card ids)",
+    // Not "right after the run finished": the skill relays the desk in stages, and a card called
+    // after stage 1 would take the one-card-per-answer slot (turn-cap.ts) from the real closing card.
+    callWhen: "when closing a finished own-book desk, after its last section has been relayed, with the run id from the `[quant-desk] run <id>` line",
+    notFor: "any number you computed yourself; the funding card (`fund_user_wallet`); a run that is still running",
+    examples: [
+        "the desk you just ran finished and you are closing with its next steps",
+        "the reader asks what to do next about a desk that finished in this conversation",
+    ],
+    extraParameters: {
+        run_id: { type: "string", description: "quant_desk_recommendations only: the run id from the `[quant-desk] run <id>` line." },
+        items: {
+            type: "array",
+            items: { type: "string" },
+            maxItems: QUANT_WIDGET_MAX_ITEMS,
+            description: "quant_desk_recommendations only: card ids to show (default: all, in the desk's order).",
+        },
+    },
+    handler,
+};
+//# sourceMappingURL=quant-desk-recommendations.js.map

package/dist/widgets/widgets/quant-desk-recommendations.js.map

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

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "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": "3.0.146",
+  "version": "3.0.149",
   "commandAliases": [
     {
       "name": "senpi"
@@ -163,7 +163,17 @@
       },
       "widgets": {
         "type": "object",
-        "description": "Per-widget-type on/off switch for the show_widget agent tool, keyed by widget_type (e.g. { \"fund_user_wallet\": false }). Absent or true enables a widget type; only an explicit false disables it. Adding a widget type does not change this schema. With every type disabled the tool is not registered.",
+        "description": "Per-widget-type on/off switch for the show_widget agent tool, keyed by widget_type. Absent or true enables a widget type; only an explicit false disables it. With every type disabled the tool is not registered.",
+        "properties": {
+          "fund_user_wallet": {
+            "type": "boolean",
+            "description": "The deposit card for the user's own Senpi wallet."
+          },
+          "quant_desk_recommendations": {
+            "type": "boolean",
+            "description": "A finished quant desk's next steps as cards, read from the stored run by id. Off keeps the desk's next steps in text."
+          }
+        },
         "additionalProperties": {
           "type": "boolean"
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@senpi/runtime",
-  "version": "3.0.146",
+  "version": "3.0.149",
   "description": "Senpi runtime plugin for OpenClaw",
   "type": "module",
   "main": "dist/index.js",
@@ -13,8 +13,9 @@
   "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 && npm run copy:external-scanners && npm run copy:skills-manifest && npm run copy:approvals-manifest",
-    "copy:external-scanners": "node -e \"require('fs').rmSync('dist/scanners/external', { recursive: true, force: true }); require('fs').cpSync('src/scanners/external', 'dist/scanners/external', { recursive: true })\"",
+    "build": "npm i && tsc && npm run copy:external-scanners && npm run copy:quant-engine && npm run copy:skills-manifest && npm run copy:approvals-manifest",
+    "copy:quant-engine": "node -e \"const fs=require('fs');fs.rmSync('dist/quant/engine',{recursive:true,force:true});fs.cpSync('src/quant/engine','dist/quant/engine',{recursive:true,filter:(s)=>!s.includes('__pycache__')&&!s.endsWith('.pyc')})\"",
+    "copy:external-scanners": "node -e \"require('fs').rmSync('dist/scanners/external', { recursive: true, force: true }); require('fs').cpSync('src/scanners/external', 'dist/scanners/external', { recursive: true, filter: (s) => !s.includes('__pycache__') && !s.endsWith('.pyc') })\"",
     "copy:skills-manifest": "node -e \"require('fs').cpSync('src/skills-manager/skills-manifest.json', 'dist/skills-manager/skills-manifest.json')\"",
     "copy:approvals-manifest": "node -e \"require('fs').cpSync('src/approvals/tool-approvals-manifest.json', 'dist/approvals/tool-approvals-manifest.json')\"",
     "fixture:tick": "node scripts/generate-tick-fixture.mjs",