@senpi/runtime 3.0.80 → 3.0.82

package/dist/widgets/tool.d.ts

@@ -0,0 +1,48 @@
+import type { WidgetRegistry } from "./registry.js";
+import type { WidgetLogger, WidgetPayload } from "./types.js";
+/**
+ * The plugin's single agent tool. The name is static — new widget types are
+ * new `widget_type` enum values, never new tools — so it is declared once in
+ * `openclaw.plugin.json` under `contracts.tools`.
+ */
+export declare const SHOW_WIDGET_TOOL_NAME = "show_widget";
+export interface ShowWidgetToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    details: WidgetPayload;
+}
+export interface ShowWidgetTool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    execute(toolCallId: string, params: unknown): Promise<ShowWidgetToolResult>;
+}
+export interface CreateShowWidgetToolOptions {
+    registry: WidgetRegistry;
+    logger?: WidgetLogger;
+    /** Ephemeral session id from the plugin tool factory context; logged only. */
+    sessionId?: string;
+}
+/**
+ * Tool description, generated from the enabled specs. Nothing else teaches the
+ * model about these cards, so this text carries the condition that should make
+ * it call the tool, not just the shape of the call.
+ */
+export declare function buildShowWidgetDescription(registry: WidgetRegistry): string;
+/**
+ * Declared JSON schema: one flat object, no unions at any depth.
+ *
+ * OpenClaw flattens top-level unions, Gemini flattens nested ones, and OpenAI
+ * strict mode rejects a schema containing one anywhere. `widget_type` is the
+ * only parameter, and it is required.
+ */
+export declare function buildShowWidgetParameters(registry: WidgetRegistry): Record<string, unknown>;
+/**
+ * Build the `show_widget` tool for one agent turn. `sessionId` comes from the
+ * plugin tool factory context and is used for logging only — nothing about the
+ * result depends on it.
+ */
+export declare function createShowWidgetTool(options: CreateShowWidgetToolOptions): ShowWidgetTool;
+//# sourceMappingURL=tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/widgets/tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAoB,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AAInD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAsB3E;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiB3F;AAmED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,cAAc,CAkCzF"}

package/dist/widgets/tool.js

@@ -0,0 +1,140 @@
+import { WidgetValidationError } from "./errors.js";
+/**
+ * The plugin's single agent tool. The name is static — new widget types are
+ * new `widget_type` enum values, never new tools — so it is declared once in
+ * `openclaw.plugin.json` under `contracts.tools`.
+ */
+export const SHOW_WIDGET_TOOL_NAME = "show_widget";
+const WIDGET_TYPE_PARAM = "widget_type";
+/**
+ * Tool description, generated from the enabled specs. Nothing else teaches the
+ * model about these cards, so this text carries the condition that should make
+ * it call the tool, not just the shape of the call.
+ */
+export function buildShowWidgetDescription(registry) {
+    const widgets = registry.enabled();
+    if (widgets.length === 0) {
+        return "Render a Senpi UI card in the user's chat.\n\nNo widget types are enabled on this deployment.";
+    }
+    const lines = [
+        "Render a Senpi UI card in the user's chat. The card is live UI: its button runs the flow, so showing it is how the user acts.",
+        "",
+        "Call it yourself as part of your answer — the user does not have to ask for a card. Each type below states when to call it; the examples illustrate that rule, they are not a checklist to match.",
+        "",
+        `Pass ${WIDGET_TYPE_PARAM} and nothing else.`,
+        "",
+        "Widget types:",
+    ];
+    for (const widget of widgets) {
+        lines.push(`- ${widget.widgetType}: ${widget.description}`);
+        lines.push(`  when: ${widget.callWhen}`);
+        lines.push(`  not this card: ${widget.notFor}`);
+        lines.push("  for example:");
+        lines.push(...widget.examples.map((example) => `    - ${example}`));
+    }
+    return lines.join("\n");
+}
+/**
+ * Declared JSON schema: one flat object, no unions at any depth.
+ *
+ * OpenClaw flattens top-level unions, Gemini flattens nested ones, and OpenAI
+ * strict mode rejects a schema containing one anywhere. `widget_type` is the
+ * only parameter, and it is required.
+ */
+export function buildShowWidgetParameters(registry) {
+    const widgets = registry.enabled();
+    if (widgets.length === 0) {
+        throw new Error("show_widget has no enabled widget types; do not register the tool");
+    }
+    return {
+        type: "object",
+        properties: {
+            [WIDGET_TYPE_PARAM]: {
+                type: "string",
+                enum: widgets.map((w) => w.widgetType),
+                description: "Which card to render.",
+            },
+        },
+        required: [WIDGET_TYPE_PARAM],
+        additionalProperties: false,
+    };
+}
+function availableTypesSentence(registry) {
+    const types = registry.enabledTypes();
+    return types.length === 0
+        ? "No widget types are available."
+        : `Available widget types: ${types.join(", ")}.`;
+}
+/** Anything that is not a plain object carries no fields — treat it as empty. */
+function toArgs(params) {
+    return params && typeof params === "object" && !Array.isArray(params)
+        ? params
+        : {};
+}
+function resolveWidget(registry, args) {
+    const raw = args[WIDGET_TYPE_PARAM];
+    const available = availableTypesSentence(registry);
+    if (raw === undefined || raw === null) {
+        throw new WidgetValidationError(`show_widget failed: "${WIDGET_TYPE_PARAM}" is required. ${available}`, "(none)", [WIDGET_TYPE_PARAM]);
+    }
+    if (typeof raw !== "string") {
+        throw new WidgetValidationError(`show_widget failed: "${WIDGET_TYPE_PARAM}" must be a string. ${available}`, "(none)", [WIDGET_TYPE_PARAM]);
+    }
+    const widget = registry.get(raw);
+    if (!widget) {
+        throw new WidgetValidationError(`show_widget failed: unknown ${WIDGET_TYPE_PARAM} "${raw}". ${available}`, raw, [WIDGET_TYPE_PARAM]);
+    }
+    if (!widget.enabled) {
+        throw new WidgetValidationError(`show_widget failed: ${WIDGET_TYPE_PARAM} "${raw}" is not enabled on this deployment. ${available}`, raw, [WIDGET_TYPE_PARAM]);
+    }
+    return widget;
+}
+/**
+ * The tool takes one argument, so any other key is a field the model invented.
+ * Every one is named in a single message: the correction is the same for all of
+ * them, and the model can apply it in one retry.
+ */
+function rejectExtraFields(widget, args) {
+    const unexpected = Object.keys(args).filter((key) => key !== WIDGET_TYPE_PARAM);
+    if (unexpected.length === 0)
+        return;
+    throw new WidgetValidationError(`show_widget failed for ${WIDGET_TYPE_PARAM} "${widget.widgetType}": unexpected fields: ` +
+        `${unexpected.join(", ")}. show_widget takes ${WIDGET_TYPE_PARAM} only — drop them and call it again.`, widget.widgetType, unexpected);
+}
+/**
+ * Build the `show_widget` tool for one agent turn. `sessionId` comes from the
+ * plugin tool factory context and is used for logging only — nothing about the
+ * result depends on it.
+ */
+export function createShowWidgetTool(options) {
+    const { registry, logger, sessionId } = options;
+    const session = sessionId ?? "(unknown)";
+    return {
+        name: SHOW_WIDGET_TOOL_NAME,
+        description: buildShowWidgetDescription(registry),
+        parameters: buildShowWidgetParameters(registry),
+        async execute(_toolCallId, params) {
+            try {
+                const args = toArgs(params);
+                const widget = resolveWidget(registry, args);
+                rejectExtraFields(widget, args);
+                const result = await widget.handler();
+                logger?.info(`[senpi-widgets] widget shown | widget_type=${widget.widgetType} widget_version=${widget.widgetVersion} session=${session}`);
+                return {
+                    content: [{ type: "text", text: result.text }],
+                    details: result.payload,
+                };
+            }
+            catch (err) {
+                if (err instanceof WidgetValidationError) {
+                    logger?.warn(`[senpi-widgets] validation failed | widget_type=${err.widgetType} fields=${err.fields.join(",")} session=${session} | ${err.message}`);
+                }
+                else {
+                    logger?.error?.(`[senpi-widgets] unhandled failure | session=${session} | ${err instanceof Error ? err.message : String(err)}`);
+                }
+                throw err;
+            }
+        },
+    };
+}
+//# sourceMappingURL=tool.js.map

package/dist/widgets/tool.js.map

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

package/dist/widgets/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 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.
+ */
+/** Rendered by the client. Always carries the three shared keys. */
+export interface WidgetPayload {
+    readonly widget_type: string;
+    readonly widget_version: number;
+    readonly status: string;
+    readonly [key: string]: unknown;
+}
+export interface WidgetResult {
+    readonly payload: WidgetPayload;
+    /** Short line for the agent — what happened and what not to do next. */
+    readonly text: string;
+}
+export interface WidgetSpec {
+    readonly widgetType: string;
+    /** Bumped when the payload shape changes; the client falls back on unknown versions. */
+    readonly widgetVersion: number;
+    /** What the card does. Reproduced verbatim in the tool description. */
+    readonly description: string;
+    /**
+     * The condition that makes the model call the tool, stated as an intent it
+     * already has rather than a box to tick. Reproduced verbatim.
+     */
+    readonly callWhen: string;
+    /**
+     * The nearest thing this card is not, and the tool that owns it. One line,
+     * reproduced verbatim — a card can be mistaken for a neighbouring flow long
+     * before it is mistaken for an unrelated one.
+     */
+    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>;
+}
+/** A spec plus its resolved on/off state from plugin config. */
+export interface RegisteredWidget extends WidgetSpec {
+    readonly enabled: boolean;
+}
+export interface WidgetLogger {
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    /** Unhandled failures only; every expected rejection is a WARN. */
+    error?(...args: unknown[]): void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

package/dist/widgets/types.js

@@ -0,0 +1,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.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/widgets/types.js.map

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

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

@@ -0,0 +1,12 @@
+import type { WidgetSpec } from "../types.js";
+/**
+ * `fund_user_wallet` — a card that opens the client's existing deposit modal
+ * for the user's own Senpi (Privy self-custody) wallet.
+ *
+ * It takes no input: the modal resolves the wallet address and the networks
+ * from the user's own session, so no amount, address or wallet id travels
+ * through the chat. Showing the card authorizes nothing, so there is no
+ * request id, no TTL and no lifecycle.
+ */
+export declare const fundUserWalletSpec: WidgetSpec;
+//# sourceMappingURL=fund-user-wallet.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,38 @@
+const WIDGET_TYPE = "fund_user_wallet";
+const WIDGET_VERSION = 1;
+/**
+ * `fund_user_wallet` — a card that opens the client's existing deposit modal
+ * for the user's own Senpi (Privy self-custody) wallet.
+ *
+ * It takes no input: the modal resolves the wallet address and the networks
+ * from the user's own session, so no amount, address or wallet id travels
+ * through the chat. Showing the card authorizes nothing, so there is no
+ * request id, no TTL and no lifecycle.
+ */
+export const fundUserWalletSpec = {
+    widgetType: WIDGET_TYPE,
+    widgetVersion: WIDGET_VERSION,
+    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.",
+    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 " +
+        "by the strategy_top_up tool, never by depositing to an address.",
+    examples: [
+        "the user asks how to deposit into Senpi, or how to add funds to their own wallet",
+        "the user's own Senpi wallet is empty",
+        "that wallet has some balance, but not enough for the trade or position the user asked for",
+        "you are about to tell the user they need more money in their own wallet before you can act",
+    ],
+    handler: () => ({
+        payload: {
+            widget_type: WIDGET_TYPE,
+            widget_version: WIDGET_VERSION,
+            status: "shown",
+        },
+        text: "Funding card shown. The user can deposit from the card. " +
+            "Do not show it again in this turn; answer follow-up questions in text.",
+    }),
+};
+//# sourceMappingURL=fund-user-wallet.js.map

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

@@ -0,0 +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"}

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.80",
+  "version": "3.0.82",
   "commandAliases": [
     {
       "name": "senpi"
@@ -14,6 +14,11 @@
       "senpi"
     ]
   },
+  "contracts": {
+    "tools": [
+      "show_widget"
+    ]
+  },
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -156,6 +161,13 @@
           }
         }
       },
+      "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.",
+        "additionalProperties": {
+          "type": "boolean"
+        }
+      },
       "api": {
         "type": "object",
         "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@senpi/runtime",
-  "version": "3.0.80",
+  "version": "3.0.82",
   "description": "Senpi runtime plugin for OpenClaw",
   "type": "module",
   "main": "dist/index.js",