@a1hvdy/cc-openclaw 0.10.4 → 0.11.0

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

@@ -0,0 +1,63 @@
+/**
+ * telegram/card-renderer.ts
+ *
+ * Telegram Bot API HTTP layer + stream-event bridge.
+ * Extracted from live-card.ts (lines 214–458) per Phase 5 decomposition.
+ *
+ * Exports: telegramApi, sendTg, editTg, bridgeEvent, StreamEvent, TranscriptEntry
+ */
+export declare function telegramApi(method: string, params: Record<string, unknown>): Promise<{
+    ok: boolean;
+    result?: {
+        message_id?: number;
+    };
+    error_code?: number;
+    description?: string;
+    parameters?: {
+        retry_after?: number;
+    };
+}>;
+/** Send a Telegram message. Tries MarkdownV2 first, falls back to plain text. */
+export declare function sendTg(chatId: string, text: string, threadId?: string, replyMarkup?: unknown, replyToMessageId?: number | null): Promise<{
+    ok: boolean;
+    result?: {
+        message_id?: number;
+    };
+}>;
+/** Edit a Telegram message. Tries MarkdownV2 first, falls back to plain text. */
+export declare function editTg(chatId: string, messageId: number, text: string, replyMarkup?: unknown): Promise<{
+    ok: boolean;
+}>;
+export interface StreamEvent {
+    type: string;
+    id?: string;
+    tool_use_id?: string;
+    parent_tool_use_id?: string;
+    parentToolUseId?: string;
+    tool?: {
+        name?: string;
+        input?: Record<string, unknown>;
+        parent_tool_use_id?: string;
+    };
+    tool_name?: string;
+    input?: Record<string, unknown>;
+    content?: unknown;
+    output?: unknown;
+    is_error?: boolean;
+    error?: unknown;
+    result?: string;
+}
+export interface TranscriptEntry {
+    kind: 'tool_call' | 'tool_result' | 'assistant';
+    ts: string;
+    name?: string;
+    input?: Record<string, unknown>;
+    toolUseId?: string;
+    parentToolUseId?: string;
+    toolName?: string;
+    content?: unknown;
+    isError?: boolean;
+    text?: string;
+    delta?: boolean;
+}
+export declare function bridgeEvent(event: StreamEvent): TranscriptEntry | null;

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

@@ -0,0 +1,149 @@
+/**
+ * telegram/card-renderer.ts
+ *
+ * Telegram Bot API HTTP layer + stream-event bridge.
+ * Extracted from live-card.ts (lines 214–458) per Phase 5 decomposition.
+ *
+ * Exports: telegramApi, sendTg, editTg, bridgeEvent, StreamEvent, TranscriptEntry
+ */
+import { request as httpsRequest } from 'node:https';
+import { _logger } from './logger.js';
+import { BOT_TOKEN } from './live-card.js';
+const PLUGIN_TAG = '[cc-openclaw/telegram/live-card]';
+// ── Telegram Bot API ──────────────────────────────────────────────────────
+export function telegramApi(method, params) {
+    return new Promise((resolve, reject) => {
+        const body = JSON.stringify(params);
+        const options = {
+            hostname: 'api.telegram.org',
+            path: `/bot${BOT_TOKEN}/${method}`,
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(body),
+            },
+        };
+        const req = httpsRequest(options, (res) => {
+            let data = '';
+            res.on('data', (chunk) => (data += chunk));
+            res.on('end', () => {
+                try {
+                    resolve(JSON.parse(data));
+                }
+                catch {
+                    resolve({ ok: false, description: 'JSON parse error' });
+                }
+            });
+        });
+        req.on('error', (err) => reject(err));
+        req.setTimeout(10_000, () => {
+            req.destroy(new Error('Telegram API timeout'));
+        });
+        req.write(body);
+        req.end();
+    });
+}
+/** Send a Telegram message. Tries MarkdownV2 first, falls back to plain text. */
+export async function sendTg(chatId, text, threadId, replyMarkup, replyToMessageId) {
+    try {
+        const base = { chat_id: chatId, disable_web_page_preview: true };
+        if (threadId)
+            base.message_thread_id = Number(threadId);
+        if (replyMarkup)
+            base.reply_markup = replyMarkup;
+        if (replyToMessageId)
+            base.reply_to_message_id = Number(replyToMessageId);
+        const res = await telegramApi('sendMessage', {
+            ...base,
+            text,
+            parse_mode: 'MarkdownV2',
+        });
+        if (res.ok)
+            return res;
+        const plain = text.replace(/[_*[\]()~`>#+\-=|{}.!\\]/g, '');
+        return telegramApi('sendMessage', {
+            ...base,
+            text: plain || 'Session update',
+        });
+    }
+    catch {
+        return { ok: false };
+    }
+}
+/** Edit a Telegram message. Tries MarkdownV2 first, falls back to plain text. */
+export async function editTg(chatId, messageId, text, replyMarkup) {
+    try {
+        const params = {
+            chat_id: chatId,
+            message_id: messageId,
+            text,
+            parse_mode: 'MarkdownV2',
+            disable_web_page_preview: true,
+        };
+        if (replyMarkup)
+            params.reply_markup = replyMarkup;
+        const res = await telegramApi('editMessageText', params);
+        if (!res.ok && (res.error_code === 429 || res.description?.includes('Too Many Requests'))) {
+            const retryAfterSec = res.parameters?.retry_after || 5;
+            const waitMs = Math.min(retryAfterSec * 1000, 30000);
+            _logger.warn(`${PLUGIN_TAG} editTg 429 — waiting ${waitMs}ms`);
+            await new Promise(r => setTimeout(r, waitMs));
+            const retry = await telegramApi('editMessageText', params);
+            if (retry.ok)
+                return retry;
+        }
+        if (res.ok)
+            return res;
+        const plain = text.replace(/[_*[\]()~`>#+\-=|{}.!\\]/g, '');
+        const fallback = {
+            chat_id: chatId,
+            message_id: messageId,
+            text: plain || 'Session update',
+            disable_web_page_preview: true,
+        };
+        if (replyMarkup)
+            fallback.reply_markup = replyMarkup;
+        return telegramApi('editMessageText', fallback);
+    }
+    catch {
+        return { ok: false };
+    }
+}
+export function bridgeEvent(event) {
+    const ts = new Date().toISOString();
+    if (event.type === 'tool_use') {
+        const parentToolUseId = event.parent_tool_use_id ||
+            event.tool?.parent_tool_use_id ||
+            event.parentToolUseId ||
+            '';
+        return {
+            kind: 'tool_call',
+            ts,
+            name: event.tool?.name || 'Unknown',
+            input: event.tool?.input || {},
+            toolUseId: event.id || event.tool_use_id || '',
+            parentToolUseId,
+        };
+    }
+    if (event.type === 'tool_result') {
+        return {
+            kind: 'tool_result',
+            ts,
+            toolUseId: event.tool_use_id || event.id || '',
+            toolName: event.tool_name || event.tool?.name || undefined,
+            content: event.content || event.output || '',
+            isError: Boolean(event.is_error || event.error),
+            parentToolUseId: event.parent_tool_use_id || event.parentToolUseId || '',
+        };
+    }
+    if (event.type === 'text') {
+        return {
+            kind: 'assistant',
+            ts,
+            text: event.result || '',
+            delta: true,
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=card-renderer.js.map

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

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

package/dist/src/channels/telegram/insight-formatter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * insight-formatter — pure tip extraction from Savvy card state + TipsEngine.
+ *
+ * Extracted from tool-tracker.ts (Step 5 of Phase 5 v0.11.0 decomposition,
+ * PRPs/phase5-live-card-split.md).
+ *
+ * Two call sites in tool-tracker.ts duplicated the toolSummary build + getTip
+ * orchestration: `after_tool_call` (~L617-625) and `message_sending` (~L675-683).
+ * This module factors that pattern into one pure function.
+ *
+ * The TipsEngine is loaded by tool-tracker.ts (stays there — the `__require`
+ * indirection to the workspace path is wired up alongside the other lazy
+ * module loads inside register()). This file only consumes the TipsEngine
+ * instance via an interface, keeping it framework-agnostic and testable.
+ */
+/** Minimal shape this module needs from a SavvyCardState — type-safe without
+ *  importing tool-tracker's full SavvyCardState interface (avoids a cycle).
+ */
+export interface InsightCardState {
+    activityLog: string[];
+    elapsedMs: number;
+    [key: string]: unknown;
+}
+/** Minimal shape this module needs from a TipsEngine. */
+export interface TipsEngineLike {
+    getTip(ctx: unknown): unknown;
+}
+/**
+ * Build a tool-frequency summary from a SavvyCardState's activityLog and
+ * call TipsEngine.getTip. Returns whatever the engine returns (typically a
+ * `{ emoji, text }` shape or null; consumers pass it to `state.setTip(tip)`).
+ *
+ * Pure: no I/O, no logging, no Telegram side effects. Safe to unit-test
+ * with a TipsEngine double.
+ */
+export declare function extractInsightTip(state: InsightCardState, tipsEngine: TipsEngineLike): unknown;

package/dist/src/channels/telegram/insight-formatter.js

@@ -0,0 +1,36 @@
+/**
+ * insight-formatter — pure tip extraction from Savvy card state + TipsEngine.
+ *
+ * Extracted from tool-tracker.ts (Step 5 of Phase 5 v0.11.0 decomposition,
+ * PRPs/phase5-live-card-split.md).
+ *
+ * Two call sites in tool-tracker.ts duplicated the toolSummary build + getTip
+ * orchestration: `after_tool_call` (~L617-625) and `message_sending` (~L675-683).
+ * This module factors that pattern into one pure function.
+ *
+ * The TipsEngine is loaded by tool-tracker.ts (stays there — the `__require`
+ * indirection to the workspace path is wired up alongside the other lazy
+ * module loads inside register()). This file only consumes the TipsEngine
+ * instance via an interface, keeping it framework-agnostic and testable.
+ */
+/**
+ * Build a tool-frequency summary from a SavvyCardState's activityLog and
+ * call TipsEngine.getTip. Returns whatever the engine returns (typically a
+ * `{ emoji, text }` shape or null; consumers pass it to `state.setTip(tip)`).
+ *
+ * Pure: no I/O, no logging, no Telegram side effects. Safe to unit-test
+ * with a TipsEngine double.
+ */
+export function extractInsightTip(state, tipsEngine) {
+    const toolSummary = {};
+    for (const t of state.activityLog) {
+        const key = t === 'exec' ? 'execute' : t;
+        toolSummary[key] = (toolSummary[key] || 0) + 1;
+    }
+    return tipsEngine.getTip({
+        ...state,
+        toolSummary,
+        elapsedSec: Math.round(state.elapsedMs / 1000),
+    });
+}
+//# sourceMappingURL=insight-formatter.js.map

package/dist/src/channels/telegram/insight-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insight-formatter.js","sourceRoot":"","sources":["../../../../src/channels/telegram/insight-formatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgBH;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAuB,EACvB,UAA0B;IAE1B,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,CAAC;QACvB,GAAG,KAAK;QACR,WAAW;QACX,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC"}

package/dist/src/channels/telegram/live-card.d.ts

@@ -10,6 +10,7 @@
  *
  * Source lines: 1–930 of ux-bridge.js
  */
+import { TelegramMessageQueue } from './throttle-controller.js';
 export interface PluginApi {
     on(event: string, handler: (...args: unknown[]) => unknown | Promise<unknown>): void;
     logger?: Console;
@@ -69,17 +70,7 @@ export declare const delegatedCardStore: Map<string, {
     threadId: string | undefined;
 }>;
 export declare let latestQuotaState: QuotaState | null;
-/**
- * Shared cross-handler dedup. Any handler dispatching to Telegram should
- * (a) mark via `markDispatchedToTelegram(chatId, payload)` and (b) check via
- * `wasDispatchedToTelegram(chatId, payload)` to short-circuit duplicates.
- *
- * Used to bridge the gap between cc-openclaw's patched SessionManager.send
- * path and the gateway's native ACP message_sending path — both can fire
- * for the same agent reply, producing the doubled-greeting on /new.
- */
-export declare function markDispatchedToTelegram(chatId: string, payload: unknown): void;
-export declare function wasDispatchedToTelegram(chatId: string, payload: unknown): boolean;
+export { markDispatchedToTelegram, wasDispatchedToTelegram } from './throttle-controller.js';
 export interface QuotaState {
     sevenDay?: {
         usedPercent?: number;
@@ -140,84 +131,11 @@ interface CardState {
     startedAt?: number;
     [key: string]: unknown;
 }
-export declare function telegramApi(method: string, params: Record<string, unknown>): Promise<{
-    ok: boolean;
-    result?: {
-        message_id?: number;
-    };
-    error_code?: number;
-    description?: string;
-    parameters?: {
-        retry_after?: number;
-    };
-}>;
-/** Send a Telegram message. Tries MarkdownV2 first, falls back to plain text. */
-export declare function sendTg(chatId: string, text: string, threadId?: string, replyMarkup?: unknown, replyToMessageId?: number | null): Promise<{
-    ok: boolean;
-    result?: {
-        message_id?: number;
-    };
-}>;
-/** Edit a Telegram message. Tries MarkdownV2 first, falls back to plain text. */
-export declare function editTg(chatId: string, messageId: number, text: string, replyMarkup?: unknown): Promise<{
-    ok: boolean;
-}>;
-export declare class TelegramMessageQueue {
-    chatId: string;
-    threadId: string | undefined;
-    cardMessageId: number | null;
-    _replyToMessageId: number | null;
-    /**
-     * Sticky flag — set true the first time `sendMessage()` is called for this
-     * queue instance. Lets the fast-turn fallback in `applyPatch()` detect that
-     * a new message was already dispatched by the pipeline's `onNewMessage`
-     * callback and avoid double-firing. Bug context: 2026-04-29 doubled-greeting
-     * on `/new` was caused by both the pipeline AND the fallback emitting the
-     * same model output as separate Telegram messages.
-     */
-    messageSent: boolean;
-    private _cardChain;
-    private _msgChain;
-    constructor(chatId: string, threadId: string | undefined, existingCardMessageId: number | null, replyToMessageId?: number | null);
-    /** Send or edit the session card. */
-    updateCard(text: string, replyMarkup?: unknown): void;
-    /** Send a standalone message (error alert, completion summary). */
-    sendMessage(text: string): void;
-}
-interface StreamEvent {
-    type: string;
-    id?: string;
-    tool_use_id?: string;
-    parent_tool_use_id?: string;
-    parentToolUseId?: string;
-    tool?: {
-        name?: string;
-        input?: Record<string, unknown>;
-        parent_tool_use_id?: string;
-    };
-    tool_name?: string;
-    input?: Record<string, unknown>;
-    content?: unknown;
-    output?: unknown;
-    is_error?: boolean;
-    error?: unknown;
-    result?: string;
-}
-interface TranscriptEntry {
-    kind: 'tool_call' | 'tool_result' | 'assistant';
-    ts: string;
-    name?: string;
-    input?: Record<string, unknown>;
-    toolUseId?: string;
-    parentToolUseId?: string;
-    toolName?: string;
-    content?: unknown;
-    isError?: boolean;
-    text?: string;
-    delta?: boolean;
-}
-export declare function bridgeEvent(event: StreamEvent): TranscriptEntry | null;
-export declare let _logger: Console;
+export { telegramApi, sendTg, editTg } from './card-renderer.js';
+export { TelegramMessageQueue } from './throttle-controller.js';
+export { bridgeEvent } from './card-renderer.js';
+export type { StreamEvent, TranscriptEntry } from './card-renderer.js';
+export { _logger, setLogger } from './logger.js';
 export declare function loadUxModule(): Record<string, unknown>;
 export declare function applyPatch(): Promise<void>;
 export declare function cleanStaleStatusFiles(): void;
@@ -226,4 +144,3 @@ export declare function cleanStaleStatusFiles(): void;
  * Idempotent — subsequent calls are no-ops.
  */
 export declare function register(api: PluginApi): void;
-export {};