@a1hvdy/cc-openclaw 0.3.2

package/dist/src/channels/adapter.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Channel Adapter — generic interface for delivering session UX
+ * to chat channels (Telegram, Discord, Signal, etc.).
+ *
+ * Telegram is the first concrete implementation (src/channels/telegram/).
+ * Discord and Signal are deferred to v1.1 (Nice-to-Have).
+ *
+ * Each adapter:
+ *  - Renders live session cards (progress, tool calls, summaries)
+ *  - Receives inbound channel messages and forwards them as session inputs
+ *  - Sends session outputs back to the channel
+ *  - Provides idempotent register() to wire OpenClaw plugin lifecycle hooks
+ *
+ * AUDIT — B2 (PRP_v3 §11 vs reality, 2026-04-28):
+ *
+ * PRP_v3 §11.1 documents an event vocabulary (`session.created`,
+ * `session.turn.start`, `session.tool.start`, `plugin.heartbeat`, etc.)
+ * that does NOT exist in the actual codebase. Every `api.on()` call
+ * site in src/ uses the openclaw-claude-code hook-event vocabulary
+ * documented in `ChannelHookEvent` below. Likewise §11.2's
+ * `api.emit('session.result', ...)` is unimplemented — no `api.emit`
+ * call sites exist.
+ *
+ * Resolution: this audit treats the *code* as canonical and the spec
+ * as drifted. The `ChannelHookEvent` literal union captures the actual
+ * contract any future channel adapter must speak. The §11.x doc
+ * sections need a v3.1 revision to match — tracked as a docs-tier
+ * follow-up (Tier 3 §24), not a code-tier blocker.
+ */
+/**
+ * Canonical hook event vocabulary — every event name passed to `api.on()`
+ * across src/channels/, src/command-router/, and src/session-bootstrap/
+ * (verified by `rg "api\\.on\\(" src/`).
+ *
+ * This is the contract: any channel/handler that wants to subscribe to
+ * gateway events MUST use one of these names. Adding a new event name
+ * here without a corresponding gateway emitter is dead-code-typing.
+ */
+export type ChannelHookEvent = 'before_dispatch' | 'before_prompt_build' | 'before_model_resolve' | 'before_tool_call' | 'after_tool_call' | 'reply_dispatch' | 'message_sending';
+/** Hook handler signature — gateway passes (event, ctx?) positional args. */
+export type ChannelHookHandler = (...args: unknown[]) => unknown | Promise<unknown>;
+export interface PluginApi {
+    /**
+     * Subscribe to a gateway hook event.
+     *
+     * Accepts `ChannelHookEvent` for compile-time event-name checking, or
+     * `string` as an escape hatch for adapter-specific events not yet
+     * canonicalized into the union. Future tightening: drop the `| string`
+     * overload once all hook sites use the union.
+     */
+    on(event: ChannelHookEvent, handler: ChannelHookHandler): void;
+    on(event: string, handler: ChannelHookHandler): void;
+}
+/**
+ * Outbound message from session → channel.
+ */
+export interface ChannelMessage {
+    channel: string;
+    target: string;
+    text?: string;
+    buttons?: ChannelButton[];
+    metadata?: Record<string, unknown>;
+}
+export interface ChannelButton {
+    text: string;
+    callbackData?: string;
+    url?: string;
+}
+/**
+ * Inbound envelope from channel → session.
+ */
+export interface ChannelInbound {
+    channel: string;
+    fromUserId: string;
+    text: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Channel adapter contract. Each concrete adapter (e.g. Telegram) implements
+ * this interface so cc-openclaw can route session events to any wired channel.
+ */
+export interface ChannelAdapter {
+    /** Adapter identifier — must be unique across registered adapters. */
+    readonly id: string;
+    /**
+     * Idempotent registration of OpenClaw plugin lifecycle hooks.
+     * Multiple calls with the same api MUST NOT stack listeners.
+     */
+    register(api: PluginApi): void;
+    /** Send an outbound message to the channel. */
+    send(message: ChannelMessage): Promise<void>;
+    /** Update an existing live card in-place (rendering progress). */
+    updateCard?(target: string, message: ChannelMessage): Promise<void>;
+    /** Render a final completion summary to the channel. */
+    completionSummary?(target: string, summary: ChannelMessage): Promise<void>;
+}
+/**
+ * Helper to wire any ChannelAdapter via the plugin's main register() flow.
+ * Centralizes the per-adapter `register()` call so src/index.ts can
+ * iterate a list of adapters without coupling to each adapter's internals.
+ */
+export declare function registerChannelAdapter(api: PluginApi, adapter: ChannelAdapter): void;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/src/channels/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/channels/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GACxB,iBAAiB,GACjB,qBAAqB,GACrB,sBAAsB,GACtB,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,iBAAiB,CAAC;AAEtB,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,GAC5B,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAErD,MAAM,WAAW,SAAS;IACxB;;;;;;;OAOG;IACH,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC/D,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IAE/B,+CAA+C;IAC/C,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C,kEAAkE;IAClE,UAAU,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE,wDAAwD;IACxD,iBAAiB,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAEpF"}

package/dist/src/channels/adapter.js

@@ -0,0 +1,38 @@
+/**
+ * Channel Adapter — generic interface for delivering session UX
+ * to chat channels (Telegram, Discord, Signal, etc.).
+ *
+ * Telegram is the first concrete implementation (src/channels/telegram/).
+ * Discord and Signal are deferred to v1.1 (Nice-to-Have).
+ *
+ * Each adapter:
+ *  - Renders live session cards (progress, tool calls, summaries)
+ *  - Receives inbound channel messages and forwards them as session inputs
+ *  - Sends session outputs back to the channel
+ *  - Provides idempotent register() to wire OpenClaw plugin lifecycle hooks
+ *
+ * AUDIT — B2 (PRP_v3 §11 vs reality, 2026-04-28):
+ *
+ * PRP_v3 §11.1 documents an event vocabulary (`session.created`,
+ * `session.turn.start`, `session.tool.start`, `plugin.heartbeat`, etc.)
+ * that does NOT exist in the actual codebase. Every `api.on()` call
+ * site in src/ uses the openclaw-claude-code hook-event vocabulary
+ * documented in `ChannelHookEvent` below. Likewise §11.2's
+ * `api.emit('session.result', ...)` is unimplemented — no `api.emit`
+ * call sites exist.
+ *
+ * Resolution: this audit treats the *code* as canonical and the spec
+ * as drifted. The `ChannelHookEvent` literal union captures the actual
+ * contract any future channel adapter must speak. The §11.x doc
+ * sections need a v3.1 revision to match — tracked as a docs-tier
+ * follow-up (Tier 3 §24), not a code-tier blocker.
+ */
+/**
+ * Helper to wire any ChannelAdapter via the plugin's main register() flow.
+ * Centralizes the per-adapter `register()` call so src/index.ts can
+ * iterate a list of adapters without coupling to each adapter's internals.
+ */
+export function registerChannelAdapter(api, adapter) {
+    adapter.register(api);
+}
+//# sourceMappingURL=adapter.js.map

package/dist/src/channels/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/channels/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAwFH;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAc,EAAE,OAAuB;IAC5E,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC"}

package/dist/src/channels/telegram/completion-summary.d.ts

@@ -0,0 +1,22 @@
+/**
+ * telegram completion-summary — TypeScript port of savvy-claude-code/ux-bridge.js
+ *
+ * Handles reply_dispatch finalization for Savvy cards:
+ *   - Marks card done, generates next-steps, renders final state
+ *   - Auto-collapse after delay, TTL-delete collapsed card
+ *   - Completion reactions + auto-pin/unpin error cards
+ *   - Persists card summary to daily JSONL log
+ *   - Updates session history cache
+ *
+ * Source lines: 2077–2222 of ux-bridge.js
+ */
+export interface PluginApi {
+    on(event: string, handler: (...args: unknown[]) => unknown | Promise<unknown>): void;
+    logger?: Console;
+}
+/**
+ * Register the completion-summary plugin hook (reply_dispatch).
+ * Idempotent — subsequent calls are no-ops.
+ */
+export declare function register(api: PluginApi): void;
+//# sourceMappingURL=completion-summary.d.ts.map

package/dist/src/channels/telegram/completion-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-summary.d.ts","sourceRoot":"","sources":["../../../../src/channels/telegram/completion-summary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAqBH,MAAM,WAAW,SAAS;IACxB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACrF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAgBD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CA2J7C"}

package/dist/src/channels/telegram/completion-summary.js

@@ -0,0 +1,186 @@
+/**
+ * telegram completion-summary — TypeScript port of savvy-claude-code/ux-bridge.js
+ *
+ * Handles reply_dispatch finalization for Savvy cards:
+ *   - Marks card done, generates next-steps, renders final state
+ *   - Auto-collapse after delay, TTL-delete collapsed card
+ *   - Completion reactions + auto-pin/unpin error cards
+ *   - Persists card summary to daily JSONL log
+ *   - Updates session history cache
+ *
+ * Source lines: 2077–2222 of ux-bridge.js
+ */
+import { appendFileSync, mkdirSync } from 'node:fs';
+import { defaultRegisterGuard } from '../../lib/register-guard.js';
+import { telegramApi, _logger, } from './live-card.js';
+import { activeSavvyCards, activeSavvyChatIds, savvyQuotaFetcher, setSavvyQuotaFetcher, sessionHistoryCache, savvyButtons, renderSavvyCard, generateNextSteps, } from './tool-tracker.js';
+// ── Constants ─────────────────────────────────────────────────────────────
+const PLUGIN_TAG = '[cc-openclaw/telegram/completion-summary]';
+const SAVVY_LOG_DIR = '/home/a1xai/.openclaw/sessions/savvy-turns';
+const MAX_HISTORY_CACHE = 50;
+// Track last pinned error card per chat for auto-unpin on clean follow-up
+const lastPinnedErrorCard = new Map(); // chatId → messageId
+// ── Internal types ────────────────────────────────────────────────────────
+// (local alias — tool-tracker's SavvyCardState is not re-exported, use unknown cast)
+// ── register() ────────────────────────────────────────────────────────────
+/**
+ * Register the completion-summary plugin hook (reply_dispatch).
+ * Idempotent — subsequent calls are no-ops.
+ */
+export function register(api) {
+    const logger = api.logger || _logger;
+    defaultRegisterGuard.guard('channels/telegram/completion-summary', api, () => {
+        // ── reply_dispatch: finalize card when Savvy sends its reply ──────────
+        api.on('reply_dispatch', (event) => {
+            const ev = event;
+            const sk = ev.sessionKey;
+            if (!sk)
+                return;
+            const entry = activeSavvyCards.get(sk);
+            if (!entry)
+                return;
+            // Clean up bridge + stall timer
+            if (entry._bridgeCleanup) {
+                entry._bridgeCleanup();
+                entry._bridgeCleanup = null;
+            }
+            if (entry._stallTimer)
+                clearInterval(entry._stallTimer);
+            // If debounce timer never fired, skip card entirely (fast turn)
+            if (entry._initialTimer && !entry._initialSent) {
+                clearTimeout(entry._initialTimer);
+                if (entry._typingInterval) {
+                    clearInterval(entry._typingInterval);
+                    entry._typingInterval = null;
+                }
+                activeSavvyChatIds.delete(entry.chatId);
+                activeSavvyCards.delete(sk);
+                logger.info(`${PLUGIN_TAG} [savvy-card] Fast turn — skipped card for sessionKey=${sk}`);
+                return;
+            }
+            // Flush pending throttled edit — final render supersedes
+            if (entry._pendingEdit?.timer) {
+                clearTimeout(entry._pendingEdit.timer);
+                entry._pendingEdit = null;
+            }
+            entry._lastEditAt = 0;
+            if (entry._typingInterval) {
+                clearInterval(entry._typingInterval);
+                entry._typingInterval = null;
+            }
+            entry.state.markDone();
+            if (generateNextSteps) {
+                // TODO(P2): SavvyCardState type lives in tool-tracker — cast via unknown
+                const steps = generateNextSteps(entry.state.getState());
+                entry.state.setNextSteps(steps);
+            }
+            const finalState = entry.state.getState();
+            const _render = renderSavvyCard;
+            if (_render) {
+                const cardText = _render(finalState);
+                const markup = savvyButtons(finalState, sk, entry.chatId);
+                entry.queue.updateCard(cardText, markup);
+            }
+            activeSavvyChatIds.delete(entry.chatId);
+            activeSavvyCards.delete(sk);
+            if (savvyQuotaFetcher && activeSavvyCards.size === 0) {
+                savvyQuotaFetcher.stopPolling();
+                setSavvyQuotaFetcher(null);
+            }
+            // Auto-collapse after delay (skip error-heavy 🔴 cards)
+            if (!finalState.delegated && finalState.qualityScore?.emoji !== '🔴') {
+                const collapseDelay = finalState.qualityScore?.emoji === '🟡' ? 30000 : 20000;
+                const collapseQueue = entry.queue;
+                const collapseEntry = entry;
+                setTimeout(() => {
+                    const elapsedSec = Math.round((finalState.elapsedMs || 0) / 1000);
+                    const qualEmoji = finalState.qualityScore?.emoji || '✅';
+                    let collapsed;
+                    if (finalState.filesModified && finalState.filesModified.length > 0) {
+                        const fileList = finalState.filesModified.slice(0, 3).join(', ');
+                        const extra = finalState.filesModified.length > 3 ? ` \\+${finalState.filesModified.length - 3}` : '';
+                        collapsed = `${qualEmoji} *Savvy* — edited ${fileList}${extra} \\(${elapsedSec}s\\)`;
+                    }
+                    else {
+                        collapsed = `${qualEmoji} *Savvy* — ${finalState.toolCount} tools in ${elapsedSec}s`;
+                    }
+                    collapseQueue.updateCard(collapsed, { inline_keyboard: [] });
+                    setTimeout(() => {
+                        if (collapseQueue.cardMessageId) {
+                            telegramApi('deleteMessage', {
+                                chat_id: collapseEntry.chatId,
+                                message_id: collapseQueue.cardMessageId,
+                            }).catch(() => { });
+                        }
+                    }, 5 * 60 * 1000);
+                }, collapseDelay);
+            }
+            // Completion reaction on card
+            const cardMsgId = entry.queue.cardMessageId;
+            if (cardMsgId) {
+                const reactionEmoji = finalState.qualityScore?.emoji === '🔴' ? '😬'
+                    : finalState.qualityScore?.emoji === '🟡' ? '🤔'
+                        : '👍';
+                telegramApi('setMessageReaction', {
+                    chat_id: entry.chatId,
+                    message_id: cardMsgId,
+                    reaction: [{ type: 'emoji', emoji: reactionEmoji }],
+                }).catch(() => { });
+                if (finalState.qualityScore?.emoji === '🔴') {
+                    telegramApi('pinChatMessage', {
+                        chat_id: entry.chatId,
+                        message_id: cardMsgId,
+                        disable_notification: true,
+                    }).catch(() => { });
+                    lastPinnedErrorCard.set(entry.chatId, cardMsgId);
+                }
+            }
+            // Auto-unpin previous error card on clean follow-up
+            if (finalState.qualityScore?.emoji === '🟢') {
+                const pinnedId = lastPinnedErrorCard.get(entry.chatId);
+                if (pinnedId) {
+                    telegramApi('unpinChatMessage', {
+                        chat_id: entry.chatId,
+                        message_id: pinnedId,
+                    }).catch(() => { });
+                    lastPinnedErrorCard.delete(entry.chatId);
+                }
+            }
+            // Persist card summary to daily JSONL log
+            try {
+                const dayStr = new Date().toISOString().slice(0, 10);
+                mkdirSync(SAVVY_LOG_DIR, { recursive: true });
+                appendFileSync(`${SAVVY_LOG_DIR}/${dayStr}.jsonl`, JSON.stringify({
+                    ts: Date.now(),
+                    sessionKey: sk,
+                    chatId: entry.chatId,
+                    cardMessageId: cardMsgId || null,
+                    toolCount: finalState.toolCount,
+                    errorCount: finalState.errorCount,
+                    elapsedMs: finalState.elapsedMs,
+                    filesModified: finalState.filesModified,
+                    qualityScore: finalState.qualityScore,
+                    status: finalState.status,
+                }) + '\n');
+            }
+            catch (e) {
+                logger.warn(`${PLUGIN_TAG} Failed to persist Savvy card summary: ${e.message}`);
+            }
+            // Update session history cache for next card's badge
+            sessionHistoryCache.set(String(entry.chatId), {
+                toolCount: finalState.toolCount,
+                elapsedMs: finalState.elapsedMs,
+                qualityEmoji: finalState.qualityScore?.emoji || '✅',
+                ts: Date.now(),
+            });
+            if (sessionHistoryCache.size > MAX_HISTORY_CACHE) {
+                const oldest = sessionHistoryCache.keys().next().value;
+                if (oldest)
+                    sessionHistoryCache.delete(oldest);
+            }
+            logger.info(`${PLUGIN_TAG} [savvy-card] Done → finalized sessionKey=${sk}`);
+        });
+        logger.info(`${PLUGIN_TAG} completion-summary hooks registered (reply_dispatch)`);
+    }); // end defaultRegisterGuard.guard
+}
+//# sourceMappingURL=completion-summary.js.map

package/dist/src/channels/telegram/completion-summary.js.map

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

package/dist/src/channels/telegram/error-renderer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * error-renderer — send formatted errors to Telegram via the existing queue.
+ *
+ * Takes a FormattedError (from error-formatter) and dispatches it via the
+ * live-card's telegramApi, with per-code 1h dedup to avoid noise.
+ * Reads BOT_TOKEN and chat routing from the live-card module's shared state.
+ */
+import type { FormattedError, Severity } from '../../lib/error-formatter.js';
+/** Test-only reset. */
+export declare function _resetDedupForTests(): void;
+export interface RenderOptions {
+    /** Override chat ID (e.g. session-specific routing). */
+    chatId?: string;
+    /** Thread ID for Telegram topic groups. */
+    threadId?: string;
+    /** Skip dedup check — force send regardless of window. */
+    forceSend?: boolean;
+    /** Write to drift jsonl as well. Defaults to true for warning+ severity. */
+    writeJsonl?: boolean;
+}
+/**
+ * Send a FormattedError to Telegram.
+ *
+ * Returns true if the message was sent, false if deduped/silenced/no-token.
+ */
+export declare function renderError(formatted: FormattedError, opts?: RenderOptions): Promise<boolean>;
+/** Only send if severity is 'critical' or 'error'. */
+export declare function renderErrorIfSevere(formatted: FormattedError, opts?: RenderOptions): Promise<boolean>;
+export type { Severity };
+//# sourceMappingURL=error-renderer.d.ts.map

package/dist/src/channels/telegram/error-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-renderer.d.ts","sourceRoot":"","sources":["../../../../src/channels/telegram/error-renderer.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAa,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAkCxF,uBAAuB;AACvB,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AA6BD,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,cAAc,EACzB,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,OAAO,CAAC,CAqDlB;AAID,sDAAsD;AACtD,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,cAAc,EACzB,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAID,YAAY,EAAE,QAAQ,EAAE,CAAC"}

package/dist/src/channels/telegram/error-renderer.js

@@ -0,0 +1,133 @@
+// phase: 4 | pillar: 2 | agent: P2.B
+/**
+ * error-renderer — send formatted errors to Telegram via the existing queue.
+ *
+ * Takes a FormattedError (from error-formatter) and dispatches it via the
+ * live-card's telegramApi, with per-code 1h dedup to avoid noise.
+ * Reads BOT_TOKEN and chat routing from the live-card module's shared state.
+ */
+import { appendFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { telegramApi, BOT_TOKEN } from './live-card.js';
+// ─── Config ───────────────────────────────────────────────────────────────────
+/** Milliseconds between repeated Telegram alerts for the same error code. */
+function getDedupWindowMs() {
+    const v = process.env.OPENCLAW_CC_OPENCLAW_DRIFT_DEDUPE_WINDOW_MS;
+    const n = v !== undefined ? parseInt(v, 10) : NaN;
+    return Number.isFinite(n) && n > 0 ? n : 3_600_000; // default 1h
+}
+/** Path for drift/error jsonl log. */
+const DRIFT_JSONL_PATH = join(homedir(), '.openclaw', 'workspace', 'memory', 'cc-openclaw-drift.jsonl');
+// ─── Dedup state ─────────────────────────────────────────────────────────────
+/**
+ * Per-code last-sent timestamps for dedup. Module-level singleton so it
+ * persists across calls within a process lifetime.
+ */
+const _lastSentAt = new Map();
+/** Returns true if this code was sent within the dedup window. */
+function isDupe(code) {
+    const last = _lastSentAt.get(code);
+    if (last === undefined)
+        return false;
+    return Date.now() - last < getDedupWindowMs();
+}
+/** Mark a code as sent now. */
+function markSent(code) {
+    _lastSentAt.set(code, Date.now());
+}
+/** Test-only reset. */
+export function _resetDedupForTests() {
+    _lastSentAt.clear();
+}
+// ─── Chat ID resolution ───────────────────────────────────────────────────────
+/**
+ * Resolve the Telegram chat ID to send error alerts to.
+ * Prefers OPENCLAW_ERROR_CHAT_ID env var, falls back to
+ * OPENCLAW_ADMIN_CHAT_ID, falls back to null (silenced).
+ */
+function resolveErrorChatId() {
+    const v = process.env.OPENCLAW_ERROR_CHAT_ID || process.env.OPENCLAW_ADMIN_CHAT_ID;
+    return v && v.trim() ? v.trim() : null;
+}
+// ─── JSONL writer ─────────────────────────────────────────────────────────────
+function writeDriftJsonl(formatted) {
+    try {
+        const dir = join(homedir(), '.openclaw', 'workspace', 'memory');
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        appendFileSync(DRIFT_JSONL_PATH, JSON.stringify(formatted.jsonlRow) + '\n');
+    }
+    catch (err) {
+        // Must never crash the plugin — stderr only
+        process.stderr.write(`[cc-openclaw/error-renderer] jsonl write failed: ${err.message}\n`);
+    }
+}
+/**
+ * Send a FormattedError to Telegram.
+ *
+ * Returns true if the message was sent, false if deduped/silenced/no-token.
+ */
+export async function renderError(formatted, opts = {}) {
+    const { jsonlRow, telegramText } = formatted;
+    // Always write jsonl for warning/critical/error unless explicitly disabled
+    const shouldWriteJsonl = opts.writeJsonl !== false && jsonlRow.severity !== 'info';
+    if (shouldWriteJsonl) {
+        writeDriftJsonl(formatted);
+    }
+    // Check dedup
+    if (!opts.forceSend && isDupe(jsonlRow.code)) {
+        return false;
+    }
+    // Resolve destination
+    const chatId = opts.chatId ?? resolveErrorChatId();
+    if (!chatId)
+        return false;
+    // Require bot token
+    if (!BOT_TOKEN)
+        return false;
+    const params = {
+        chat_id: chatId,
+        text: telegramText,
+        parse_mode: 'MarkdownV2',
+    };
+    if (opts.threadId) {
+        params.message_thread_id = opts.threadId;
+    }
+    try {
+        const res = await telegramApi('sendMessage', params);
+        if (res.ok) {
+            markSent(jsonlRow.code);
+            return true;
+        }
+        // If MarkdownV2 fails (parse error), fall back to plain text
+        if (res.error_code === 400) {
+            const fallback = await telegramApi('sendMessage', {
+                chat_id: chatId,
+                text: `${jsonlRow.code}: ${jsonlRow.message} (${jsonlRow.ts.slice(0, 19)})`,
+                ...(opts.threadId ? { message_thread_id: opts.threadId } : {}),
+            });
+            if (fallback.ok) {
+                markSent(jsonlRow.code);
+                return true;
+            }
+        }
+        return false;
+    }
+    catch (err) {
+        process.stderr.write(`[cc-openclaw/error-renderer] send failed: ${err.message}\n`);
+        return false;
+    }
+}
+// ─── Severity-filtered convenience ───────────────────────────────────────────
+/** Only send if severity is 'critical' or 'error'. */
+export async function renderErrorIfSevere(formatted, opts = {}) {
+    const sev = formatted.jsonlRow.severity;
+    if (sev === 'info' || sev === 'warning') {
+        // Still write jsonl
+        writeDriftJsonl(formatted);
+        return false;
+    }
+    return renderError(formatted, opts);
+}
+//# sourceMappingURL=error-renderer.js.map

package/dist/src/channels/telegram/error-renderer.js.map

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

package/dist/src/channels/telegram/event-reducer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * telegram event-reducer — TypeScript port of savvy-claude-code/ux-bridge.js
+ *
+ * Central register() that wires all remaining api.on() hooks:
+ *   before_dispatch ×4  — /quota command, /sessions command, claude-local UX
+ *                         feed, callback_query routing
+ *   before_model_resolve — per-chat model override (F5)
+ *   before_tool_call    — Stage 4 gateway UX metadata injection
+ *   MiniMax usage tracking (before_dispatch)
+ *
+ * Depends on: live-card, tool-tracker, completion-summary, state-machine
+ * (all must be registered before or alongside this module).
+ *
+ * Source lines: 1042–1615 of ux-bridge.js
+ */
+export interface PluginApi {
+    on(event: string, handler: (...args: unknown[]) => unknown | Promise<unknown>): void;
+    logger?: Console;
+    config?: Record<string, unknown>;
+    runtime?: {
+        subagent?: {
+            run?(opts: Record<string, unknown>): Promise<{
+                runId?: string;
+            }>;
+        };
+    };
+}
+/**
+ * Register all event-reducer hooks (command dispatch, model override,
+ * callback routing, Stage 4 injection).
+ * Idempotent — subsequent calls are no-ops.
+ */
+export declare function register(api: PluginApi): void;
+//# sourceMappingURL=event-reducer.d.ts.map

package/dist/src/channels/telegram/event-reducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-reducer.d.ts","sourceRoot":"","sources":["../../../../src/channels/telegram/event-reducer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA4BH,MAAM,WAAW,SAAS;IACxB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACrF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE;YACT,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;gBAAE,KAAK,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SAClE,CAAC;KACH,CAAC;CACH;AA2CD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CA+hB7C"}