@a1hvdy/cc-openclaw 0.26.5 → 0.27.0

package/dist/src/channels/adapter.js

@@ -35,4 +35,3 @@
 export function registerChannelAdapter(api, adapter) {
     adapter.register(api);
 }
-//# sourceMappingURL=adapter.js.map

package/dist/src/channels/telegram-mirror/askuser.js

@@ -22,6 +22,7 @@
  */
 import { CallbackMap } from './callback-mapping.js';
 import { sendTg, editTg, telegramApi } from '../../lib/telegram-bot-api.js';
+import { escapeHtml } from '../../lib/html-render.js';
 /** Namespace prefix for callback_data so api.registerInteractiveHandler routes
  *  taps here. Matched at the first ':' by the gateway (must be [A-Za-z0-9._-]+). */
 export const ASKUSER_NS = 'ccmirror';
@@ -74,21 +75,34 @@ export function parseFirstQuestion(input) {
 function shortQid() {
     return Math.random().toString(36).slice(2, 8);
 }
+/**
+ * v0.27.0 M3 — render the question body as organized Telegram HTML (bold header,
+ * numbered options with italic descriptions). All dynamic text is HTML-escaped
+ * (the send path uses parse_mode HTML since M1, so a stray < in a question would
+ * otherwise break the message). Mirrors the CLI's clean option layout.
+ */
 function bodyText(s) {
-    const lines = [`❓ ${s.header}`, s.question];
-    // v0.26.4 polish — list options with their descriptions in the body (buttons
-    // only show the label, so descriptions would otherwise be lost).
+    const lines = [`❓ <b>${escapeHtml(s.header)}</b>`, escapeHtml(s.question)];
+    // List options with their descriptions in the body (buttons only show the
+    // label, so descriptions would otherwise be lost).
     const described = s.options.filter((o) => o.description);
     if (described.length > 0) {
         lines.push('');
         s.options.forEach((o, i) => {
-            lines.push(o.description ? `${i + 1}. ${o.label} — ${o.description}` : `${i + 1}. ${o.label}`);
+            const n = `<b>${i + 1}.</b>`;
+            lines.push(o.description
+                ? `${n} ${escapeHtml(o.label)} — <i>${escapeHtml(o.description)}</i>`
+                : `${n} ${escapeHtml(o.label)}`);
         });
     }
     if (s.multiSelect)
-        lines.push('', '(select one or more, then Submit)');
+        lines.push('', '<i>(select one or more, then Submit)</i>');
     return lines.join('\n');
 }
+/** v0.27.0 M3 — HTML-safe "you chose" confirmation shown after a tap. */
+function chosenText(s, chosen) {
+    return `❓ <b>${escapeHtml(s.header)}</b>\n${escapeHtml(s.question)}\n\n✓ You chose: <b>${escapeHtml(chosen)}</b>`;
+}
 /** Build the inline keyboard for a question. callback_data is
  *  `ccmirror:<CallbackMap id>` so the gateway routes taps to our handler. */
 function buildKeyboard(qid, s) {
@@ -216,7 +230,7 @@ export async function handleTap(ctx, api) {
     if (payload.kind === 'opt' && !s.multiSelect) {
         const label = s.options[payload.idx]?.label ?? '';
         await answerCb(ctx, `Selected: ${label}`);
-        await editQ(s, `❓ ${s.header}\n${s.question}\n\n✓ You chose: ${label}`);
+        await editQ(s, chosenText(s, label));
         injectAnswer(api, ctx, label);
         _questions.delete(payload.qid);
         return;
@@ -237,7 +251,7 @@ export async function handleTap(ctx, api) {
             return;
         }
         await answerCb(ctx, `Submitted ${labels.length}`);
-        await editQ(s, `❓ ${s.header}\n${s.question}\n\n✓ You chose: ${labels.join(', ')}`);
+        await editQ(s, chosenText(s, labels.join(', ')));
         injectAnswer(api, ctx, labels.join(', '));
         _questions.delete(payload.qid);
         return;
@@ -271,4 +285,3 @@ export function _resetAskUserForTests() {
 export function _pendingCount() {
     return _questions.size;
 }
-//# sourceMappingURL=askuser.js.map

package/dist/src/channels/telegram-mirror/burst-accumulator.js

@@ -127,4 +127,3 @@ export class BurstAccumulator {
         return session.pending.map((p) => p.text).join(this.separator);
     }
 }
-//# sourceMappingURL=burst-accumulator.js.map

package/dist/src/channels/telegram-mirror/callback-mapping.js

@@ -96,4 +96,3 @@ export class CallbackMap {
         return base36.padStart(this.idLength, '0').slice(0, this.idLength);
     }
 }
-//# sourceMappingURL=callback-mapping.js.map

package/dist/src/channels/telegram-mirror/card-renderer.js

@@ -14,6 +14,18 @@
  * Tests live at tests/channels/telegram-mirror/m2-render-pipeline.test.ts.
  */
 import { renderStatusLine, renderMeters, renderTodos } from './status-line.js';
+import { escapeHtml, code, pre, markdownToHtml } from '../../lib/html-render.js';
+// v0.27.0 M1 — the card renders as Telegram HTML (parse_mode: 'HTML'), not
+// MarkdownV2. HTML only needs `& < >` escaped (no per-char backslash litter)
+// and supports <pre><code class="language-…"> + <blockquote> for true
+// CLI-fidelity. escapeHtml / code() / markdownToHtml come from lib/html-render.
+/** Last path segment (basename) — keeps tool lines short and CLI-like, e.g.
+ *  "/home/a1/kris-kitchen/components/ShoppingList.tsx" → "ShoppingList.tsx". */
+function basename(p) {
+    const cleaned = p.replace(/\/+$/, '');
+    const idx = cleaned.lastIndexOf('/');
+    return idx >= 0 ? cleaned.slice(idx + 1) : cleaned;
+}
 /**
  * Glyph picked per tool-call status. Mirrors terminal "running / done /
  * errored" iconography that A1 already reads in the live Claude Code TUI.
@@ -28,25 +40,78 @@ function toolGlyph(tc) {
 /**
  * Render the input argument summary for a tool call. Kept tight — full
  * input is in the result; the mirror line is meant to read at a glance.
+ * Returns RAW (unescaped) text; the caller wraps it in a code span.
+ *
+ * v0.26.5: collapse embedded whitespace/newlines to single spaces (a
+ * multi-line Bash command used to spill across several card rows), prefer the
+ * basename for file paths (shorter + CLI-like), and truncate with a single "…".
  */
 function toolInputSummary(tc) {
     const input = tc.input;
     if (!input || typeof input !== 'object')
         return '';
-    // Prefer common single-field shapes used by Bash/Read/Edit/Write.
-    const single = typeof input.command === 'string'
+    // Prefer common single-field shapes used by Bash/Read/Edit/Write/Grep/Glob.
+    const raw = typeof input.command === 'string'
         ? input.command
         : typeof input.file_path === 'string'
-            ? input.file_path
+            ? basename(input.file_path)
             : typeof input.path === 'string'
-                ? input.path
-                : typeof input.url === 'string'
-                    ? input.url
-                    : '';
-    if (single) {
-        return single.length > 60 ? single.slice(0, 57) + '...' : single;
+                ? basename(input.path)
+                : typeof input.pattern === 'string'
+                    ? input.pattern
+                    : typeof input.url === 'string'
+                        ? input.url
+                        : '';
+    if (!raw)
+        return '';
+    const collapsed = raw.replace(/\s+/g, ' ').trim();
+    return collapsed.length > 48 ? collapsed.slice(0, 47) + '…' : collapsed;
+}
+/**
+ * v0.27.0 M2 — coerce a tool's RESULT payload to display text. Claude delivers
+ * tool_result content as a string OR an array of `{type:'text',text}` blocks
+ * (via the persistent-session user-message extraction). Returns trimmed text, or
+ * '' when there's nothing real to show (no-fake-data — never stringify objects).
+ */
+function toolResultText(tc) {
+    const r = tc.result;
+    if (r == null)
+        return '';
+    let s = '';
+    if (typeof r === 'string') {
+        s = r;
+    }
+    else if (Array.isArray(r)) {
+        s = r
+            .map((b) => {
+            if (typeof b === 'string')
+                return b;
+            if (b && typeof b === 'object' && typeof b.text === 'string') {
+                return b.text;
+            }
+            return '';
+        })
+            .join('');
+    }
+    return s.trim();
+}
+/**
+ * v0.27.0 M2 — truncate result text for the card: at most RESULT_MAX_LINES lines
+ * and RESULT_MAX_CHARS chars, with a trailing "…" when cut. Keeps the card
+ * readable (Telegram's 4096-char message cap) while still surfacing tool output
+ * the way the CLI shows it inline.
+ */
+const RESULT_MAX_LINES = 3;
+const RESULT_MAX_CHARS = 200;
+function truncateResult(s) {
+    const lines = s.split('\n');
+    let cut = lines.length > RESULT_MAX_LINES;
+    let out = lines.slice(0, RESULT_MAX_LINES).join('\n');
+    if (out.length > RESULT_MAX_CHARS) {
+        out = out.slice(0, RESULT_MAX_CHARS);
+        cut = true;
     }
-    return '';
+    return cut ? out.replace(/\s+$/, '') + '\n…' : out;
 }
 /**
  * Format one tool-call line for inclusion in the rendered card body.
@@ -87,8 +152,11 @@ export function toolIcon(name) {
 export function renderToolLine(tc) {
     const glyph = toolGlyph(tc);
     const icon = toolIcon(tc.name);
+    // Status glyph + emoji are HTML-safe; the tool name is HTML-escaped and the
+    // input detail rides in a <code> span (v0.27.0 M1 HTML styling).
+    const name = escapeHtml(tc.name);
     const summary = toolInputSummary(tc);
-    return summary ? `${glyph} ${icon} ${tc.name} · ${summary}` : `${glyph} ${icon} ${tc.name}`;
+    return summary ? `${glyph} ${icon} ${name} · ${code(summary)}` : `${glyph} ${icon} ${name}`;
 }
 /**
  * Render the thinking block (M6). Each line of the thinking text is
@@ -100,8 +168,14 @@ export function renderThinkingBlock(thinkingText) {
     const trimmed = thinkingText.trim();
     if (trimmed.length === 0)
         return '';
-    const lines = trimmed.split('\n');
-    return ['💭 Thinking', ...lines.map((l) => `> ${l}`)].join('\n');
+    // v0.27.0 M1 — Telegram HTML <blockquote> renders the reasoning as a single
+    // indented quote (terminal-style), distinct from the assistant text. Content
+    // is HTML-escaped; newlines are preserved inside the blockquote.
+    const body = trimmed
+        .split('\n')
+        .map((l) => escapeHtml(l))
+        .join('\n');
+    return `💭 Thinking\n<blockquote>${body}</blockquote>`;
 }
 /**
  * Render the full turn into a Telegram-safe message body. The mirror keeps
@@ -133,30 +207,46 @@ export function renderTurn(turn, meta) {
     // handler calls setCardMeta(), the status line appears on the next repaint.
     if (meta) {
         const status = renderStatusLine(turn, meta);
+        // v0.27.0 M1 — bold the status line (the card header) via HTML <b>. Content
+        // HTML-escaped first ( & < > only — model/version dots & brackets are safe).
         if (status)
-            lines.push(status);
+            lines.push(`<b>${escapeHtml(status)}</b>`);
         // v0.26.2 M2 — meter row (context % + quota % + reset). Same no-fake-data
-        // gating: omitted unless real values are present.
+        // gating: omitted unless real values are present. HTML-escaped for safety.
         const meters = renderMeters(meta);
         if (meters)
-            lines.push(meters);
+            lines.push(escapeHtml(meters));
         // v0.26.4 styling — divider between the status/telemetry block and the
-        // activity block (only when a status block was actually rendered).
+        // activity block (only when a status block was actually rendered). The
+        // heavy-bar glyph is not HTML-significant, so it needs no escaping.
         if (lines.length > 0)
             lines.push('━━━━━━━━━━━━');
     }
-    const header = turn.state === 'done' ? '✓ Done' : '▶ Working';
+    // Turn-status header. v0.27.0 M4 — a failed turn shows "❌ <reason>" so it
+    // never dies as an eternal "…"; reason is HTML-escaped (it's an error message).
+    const header = turn.state === 'failed'
+        ? `❌ ${escapeHtml(turn.failReason ?? 'Turn failed')}`
+        : turn.state === 'done'
+            ? '✓ Done'
+            : '▶ Working';
     lines.push(header);
     if (turn.toolCalls.length > 0) {
         for (const tc of turn.toolCalls) {
             lines.push(renderToolLine(tc));
+            // v0.27.0 M2 — surface the tool's RESULT as a truncated <pre><code> block
+            // under its line (CLI-style inline output), when there's real text.
+            const resultText = toolResultText(tc);
+            if (resultText)
+                lines.push(pre(truncateResult(resultText)));
         }
     }
     // v0.26.2 M4 — todo checklist (real data from the agent's TodoWrite calls).
+    // Escaped as a block (glyphs are safe; content + the "+N more" plus sign are
+    // not, so the whole block goes through the escaper).
     const todoBlock = renderTodos(meta);
     if (todoBlock) {
         lines.push('');
-        lines.push(todoBlock);
+        lines.push(escapeHtml(todoBlock));
     }
     // Defensive default — Turn.thinkingText is required by the interface, but
     // some test helpers and pre-M6 fixtures construct Turn-shaped objects
@@ -169,7 +259,10 @@ export function renderTurn(turn, meta) {
     const text = turn.assistantText.trim();
     if (text.length > 0) {
         lines.push('');
-        lines.push(text);
+        // v0.27.0 M1 — render the model's markdown as Telegram HTML with structure
+        // preserved (**bold**→<b>, `code`→<code>, ```bash fences→<pre><code
+        // class="language-bash">). HTML-escapes all remaining content (& < >).
+        lines.push(markdownToHtml(text));
     }
     return lines.join('\n');
 }
@@ -185,4 +278,3 @@ export function planRenderAction(turn, knownMessageId) {
     }
     return { type: 'edit', chatId: turn.chatId, text, messageId: knownMessageId };
 }
-//# sourceMappingURL=card-renderer.js.map

package/dist/src/channels/telegram-mirror/card-state.js

@@ -46,4 +46,3 @@ export const cardState = _g[CARD_STATE_KEY] ?? (_g[CARD_STATE_KEY] = new Map());
 export function cardStateDebug() {
     return `cards=${cardState.size}`;
 }
-//# sourceMappingURL=card-state.js.map

package/dist/src/channels/telegram-mirror/commands.js

@@ -386,4 +386,3 @@ export function dispatchCommand(parsed, ctxBase) {
         return undefined;
     return handler({ ...ctxBase, args: parsed.args });
 }
-//# sourceMappingURL=commands.js.map

package/dist/src/channels/telegram-mirror/compose-buffer.js

@@ -107,4 +107,3 @@ export class ComposeBuffer {
         return this.now() - session.startedAt > this.timeoutMs;
     }
 }
-//# sourceMappingURL=compose-buffer.js.map

package/dist/src/channels/telegram-mirror/cost-views.js

@@ -118,4 +118,3 @@ export function createStatusTeeQuotaReader(reader = readStatusTeeQuotaSnapshot)
         },
     };
 }
-//# sourceMappingURL=cost-views.js.map

package/dist/src/channels/telegram-mirror/failure/callback-data-overflow.js

@@ -27,4 +27,3 @@ export const handle = (ctx, info) => {
         },
     ];
 };
-//# sourceMappingURL=callback-data-overflow.js.map

package/dist/src/channels/telegram-mirror/failure/gateway-down.js

@@ -24,4 +24,3 @@ export const handle = (ctx, info) => {
     ];
     return actions;
 };
-//# sourceMappingURL=gateway-down.js.map

package/dist/src/channels/telegram-mirror/failure/in-flight-conflict.js

@@ -24,4 +24,3 @@ export const handle = (ctx, info) => {
         },
     ];
 };
-//# sourceMappingURL=in-flight-conflict.js.map

package/dist/src/channels/telegram-mirror/failure/index.js

@@ -32,4 +32,3 @@ export const FAILURE_MODULES = [
  * to fire a handler by name.
  */
 export const FAILURE_BY_MODE = Object.fromEntries(FAILURE_MODULES.map((m) => [m.META.mode, m]));
-//# sourceMappingURL=index.js.map

package/dist/src/channels/telegram-mirror/failure/model-5xx.js

@@ -21,4 +21,3 @@ export const handle = (ctx, info) => {
         },
     ];
 };
-//# sourceMappingURL=model-5xx.js.map

package/dist/src/channels/telegram-mirror/failure/network-blip.js

@@ -22,4 +22,3 @@ export const handle = (ctx, info) => {
         },
     ];
 };
-//# sourceMappingURL=network-blip.js.map

package/dist/src/channels/telegram-mirror/failure/pool-exhausted-fallback.js

@@ -21,4 +21,3 @@ export const handle = (ctx, info) => {
         },
     ];
 };
-//# sourceMappingURL=pool-exhausted-fallback.js.map

package/dist/src/channels/telegram-mirror/failure/rate-limit.js

@@ -23,4 +23,3 @@ export const handle = (ctx, info) => {
         },
     ];
 };
-//# sourceMappingURL=rate-limit.js.map

package/dist/src/channels/telegram-mirror/failure/returning-after-24h.js

@@ -30,4 +30,3 @@ export const handle = (ctx, info) => {
         },
     ];
 };
-//# sourceMappingURL=returning-after-24h.js.map

package/dist/src/channels/telegram-mirror/failure/types.js

@@ -6,4 +6,3 @@
  * shared types so the 8 handler modules stay tight (each ~30-50 lines).
  */
 export {};
-//# sourceMappingURL=types.js.map

package/dist/src/channels/telegram-mirror/inbound-handler.js

@@ -484,4 +484,3 @@ export function registerInboundHandler(api, state = createHandlerState()) {
     process.stderr.write(`${PLUGIN_TAG} subscribed to before_dispatch — ${MIRROR_COMMANDS.size} commands armed.\n`);
     return state;
 }
-//# sourceMappingURL=inbound-handler.js.map

package/dist/src/channels/telegram-mirror/index.js

@@ -89,4 +89,3 @@ export function register(api) {
         }
     });
 }
-//# sourceMappingURL=index.js.map

package/dist/src/channels/telegram-mirror/plan-attachment.js

@@ -135,4 +135,3 @@ export class RejectFeedbackTracker {
 export function formatApprovePayload(planId) {
     return `<plan approved: ${planId}>`;
 }
-//# sourceMappingURL=plan-attachment.js.map

package/dist/src/channels/telegram-mirror/quota-reader.js

@@ -26,4 +26,3 @@ export const stubQuotaReader = {
         };
     },
 };
-//# sourceMappingURL=quota-reader.js.map

package/dist/src/channels/telegram-mirror/sessions-keyboard.js

@@ -110,4 +110,3 @@ export function assertCallbackDataBudget(keyboard) {
         }
     }
 }
-//# sourceMappingURL=sessions-keyboard.js.map

package/dist/src/channels/telegram-mirror/soak-log.js

@@ -133,4 +133,3 @@ export class SoakLogger {
         return out;
     }
 }
-//# sourceMappingURL=soak-log.js.map

package/dist/src/channels/telegram-mirror/state-machine.d.ts

@@ -38,7 +38,7 @@ export interface StreamEvent {
     error?: unknown;
     result?: string;
 }
-export type TurnState = 'working' | 'done';
+export type TurnState = 'working' | 'done' | 'failed';
 export interface ToolCallRecord {
     /** Tool name (e.g. "Bash", "Read", "Edit"). */
     name: string;
@@ -58,8 +58,11 @@ export interface Turn {
     state: TurnState;
     /** Monotonic timestamp (Date.now()) when the turn started. */
     startedAt: number;
-    /** Set when the turn transitions to 'done'. */
+    /** Set when the turn transitions to 'done' or 'failed'. */
     endedAt?: number;
+    /** Set when the turn transitions to 'failed' (M4) — a short failure reason
+     *  surfaced on the card so a turn never dies as an eternal "…". */
+    failReason?: string;
     /** Tool calls observed during the turn, in arrival order. */
     toolCalls: ToolCallRecord[];
     /** Accumulated assistant text (concatenation of text events). */
@@ -90,6 +93,13 @@ export declare class TurnStateMachine {
      * endedAt. Returns the finalized turn, or undefined if no turn was active.
      */
     end(chatId: string, now?: number): Turn | undefined;
+    /**
+     * Fail the active turn for chatId (M4). Transitions state to 'failed', stamps
+     * endedAt, and records a short reason so renderTurn can show "❌ <reason>"
+     * instead of leaving the card frozen at "…". Returns the failed turn, or
+     * undefined if no turn was active.
+     */
+    fail(chatId: string, reason: string, now?: number): Turn | undefined;
     /**
      * Returns the active or most-recently-ended turn for chatId.
      */

package/dist/src/channels/telegram-mirror/state-machine.js

@@ -52,10 +52,30 @@ export class TurnStateMachine {
         if (turn.state !== 'working')
             return turn;
         if (event.type === 'tool_use') {
+            const id = event.id ?? event.tool_use_id ?? '';
+            // Dedup by tool-use id. claude.exe emits each tool_use TWICE — once at
+            // `content_block_start` with empty input, then again in the aggregate
+            // `assistant` message with the fully-assembled input. Both fires carry
+            // the same block id. Without this guard the card shows every tool twice
+            // (a bare line + a detailed line), doubles the 🔧 count, and the
+            // tool_result `.find()` below resolves only the FIRST record so the
+            // detailed line never flips … → ✓. Merge the richer payload into the
+            // existing record instead of pushing a duplicate.
+            if (id) {
+                const existing = turn.toolCalls.find((tc) => tc.toolUseId === id);
+                if (existing) {
+                    const incoming = event.tool?.input;
+                    if (incoming && Object.keys(incoming).length > 0)
+                        existing.input = incoming;
+                    if (existing.name === 'Unknown' && event.tool?.name)
+                        existing.name = event.tool.name;
+                    return turn;
+                }
+            }
             turn.toolCalls.push({
                 name: event.tool?.name ?? 'Unknown',
                 input: event.tool?.input ?? {},
-                toolUseId: event.id ?? event.tool_use_id ?? '',
+                toolUseId: id,
             });
             return turn;
         }
@@ -100,6 +120,21 @@ export class TurnStateMachine {
         turn.endedAt = now;
         return turn;
     }
+    /**
+     * Fail the active turn for chatId (M4). Transitions state to 'failed', stamps
+     * endedAt, and records a short reason so renderTurn can show "❌ <reason>"
+     * instead of leaving the card frozen at "…". Returns the failed turn, or
+     * undefined if no turn was active.
+     */
+    fail(chatId, reason, now = Date.now()) {
+        const turn = this.turns.get(chatId);
+        if (!turn)
+            return undefined;
+        turn.state = 'failed';
+        turn.failReason = reason;
+        turn.endedAt = now;
+        return turn;
+    }
     /**
      * Returns the active or most-recently-ended turn for chatId.
      */
@@ -114,4 +149,3 @@ export class TurnStateMachine {
         this.turns.delete(chatId);
     }
 }
-//# sourceMappingURL=state-machine.js.map

package/dist/src/channels/telegram-mirror/status-line.js

@@ -165,4 +165,3 @@ export function renderTodos(meta) {
         lines.push(`  +${todos.length - TODO_MAX} more`);
     return lines.join('\n');
 }
-//# sourceMappingURL=status-line.js.map

package/dist/src/channels/telegram-mirror/sync-commands.js

@@ -48,4 +48,3 @@ export async function syncMyCommands(opts) {
 export function _resetSyncedForTests() {
     synced = false;
 }
-//# sourceMappingURL=sync-commands.js.map

package/dist/src/channels/telegram-mirror/threshold-watcher.js

@@ -74,4 +74,3 @@ export class ThresholdWatcher {
         return this.thresholds;
     }
 }
-//# sourceMappingURL=threshold-watcher.js.map

package/dist/src/channels/telegram-mirror/turn-bridge.d.ts

@@ -80,6 +80,23 @@ export declare function pushAssistantText(text: string): void;
  * finalizes ALL active cards (one at a time in practice).
  */
 export declare function finalizeActiveCards(): Promise<void>;
+/**
+ * Map a caught error to a short, user-readable card reason (v0.27.0 M4). Keeps
+ * the "❌ <reason>" header concise and classifies the common cc-openclaw-side
+ * failures (its own watchdog kill / dead subprocess / timeout) rather than
+ * dumping a raw stack.
+ */
+export declare function classifyFailure(err: unknown): string;
+/**
+ * Fail every active card (v0.27.0 M4). Called from the openai-compat handlers'
+ * catch path when cc-openclaw's OWN turn errors — its subprocess died, its
+ * stalled-session watchdog SIGTERMed it, or the model call threw/timed out. The
+ * card flips to "❌ <reason>" instead of being left as an eternal "…" (or worse,
+ * finalized to a misleading "✓ Done"). Scoped to cc-openclaw's own vantage; the
+ * gateway's recovery=none stalls that never throw here are out of M4's reach.
+ * Best-effort: a fail-render failure must not mask the original error.
+ */
+export declare function failActiveCards(reason: string): Promise<void>;
 /**
  * Test-only — reset module-level repaint state. Card state lives in
  * card-state.ts so import that and clear directly if your test needs it.