im-hub-pro 0.2.29

package/dist/plugins/messengers/telegram/telegram-adapter.d.ts

@@ -0,0 +1,62 @@
+import type { MessengerAdapter, MessageContext, ButtonCallback, ApprovalCardPrompt, ApprovalCardOutcome } from '../../../core/types.js';
+export declare class TelegramAdapter implements MessengerAdapter {
+    readonly name = "telegram";
+    private bot;
+    private config;
+    private messageHandler?;
+    private buttonHandler?;
+    private isRunning;
+    private typingIntervals;
+    private watchdogTimer?;
+    private consecutivePingFailures;
+    private static readonly WATCHDOG_INTERVAL_MS;
+    private static readonly WATCHDOG_FAILURE_THRESHOLD;
+    private mediaCleanupTimer?;
+    private static readonly MEDIA_CLEANUP_INTERVAL_MS;
+    start(): Promise<void>;
+    /** Run media cleanup once now (so a long-running im-hub doesn't accumulate
+     *  files indefinitely when restarts are infrequent) and then hourly. The
+     *  hourly cadence matches the typical 7-day TTL with plenty of slack. */
+    private startMediaCleanup;
+    private runPollingLoop;
+    private startWatchdog;
+    stop(): Promise<void>;
+    onMessage(handler: (ctx: MessageContext) => Promise<void>): void;
+    /**
+     * Download a TG photo / image-document, save it under MEDIA_ROOT, and surface
+     * the result to messageHandler as a Message whose `text` includes the
+     * caption (if any) plus a "[图片附件：/path/x.jpg]" marker — claude-code
+     * picks that up and uses Read to view it.
+     *
+     * On download failure we still call messageHandler with a "[图片下载失败]"
+     * marker so the user's interaction isn't silently dropped — they can resend
+     * or be told what went wrong.
+     */
+    private handleMediaUpload;
+    /**
+     * Download a TG voice / audio message, transcribe it via whichever provider
+     * is configured (OpenAI Whisper or whisper.cpp), and surface the transcript
+     * to messageHandler as Message.text. The downloaded audio file path is
+     * also included so the agent can reference it (e.g. send it back, replay).
+     *
+     * Failures are surfaced as text markers, not silent drops:
+     *   - download failure → "[语音附件下载失败：…]"
+     *   - no provider configured → "[语音附件未转写：未配置 OPENAI_API_KEY 或 IMHUB_WHISPERCPP_BIN]"
+     *   - transcribe error → "[语音转写失败（${provider}）：…]"
+     *
+     * Since transcription can take 5-30s on a slow CPU + whisper.cpp medium,
+     * we fire-and-forget the entire operation so grammy's update queue keeps
+     * draining for other chats. Within this chat, ordering is still serialized
+     * by grammy.
+     */
+    private handleVoiceUpload;
+    sendMessage(threadId: string, text: string): Promise<void>;
+    onButtonCallback(handler: (cb: ButtonCallback) => Promise<void>): void;
+    sendApprovalCard(threadId: string, prompt: ApprovalCardPrompt): Promise<{
+        messageId: string;
+    }>;
+    editApprovalCard(threadId: string, messageId: string, outcome: ApprovalCardOutcome): Promise<void>;
+    sendTyping(threadId: string, isTyping: boolean): Promise<void>;
+}
+export declare const telegramAdapter: TelegramAdapter;
+//# sourceMappingURL=telegram-adapter.d.ts.map

package/dist/plugins/messengers/telegram/telegram-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-adapter.d.ts","sourceRoot":"","sources":["../../../../src/plugins/messengers/telegram/telegram-adapter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EAEd,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,wBAAwB,CAAA;AAe/B,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,QAAQ,CAAC,IAAI,cAAa;IAC1B,OAAO,CAAC,GAAG,CAAmB;IAC9B,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,cAAc,CAAC,CAAwC;IAC/D,OAAO,CAAC,aAAa,CAAC,CAAuC;IAC7D,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,eAAe,CAAoD;IAK3E,OAAO,CAAC,aAAa,CAAC,CAAgC;IACtD,OAAO,CAAC,uBAAuB,CAAI;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,0BAA0B,CAAI;IACtD,OAAO,CAAC,iBAAiB,CAAC,CAAgC;IAC1D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAiB;IAE5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiM5B;;6EAEyE;IACzE,OAAO,CAAC,iBAAiB;YAYX,cAAc;IAmD5B,OAAO,CAAC,aAAa;IA6Bf,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B3B,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIhE;;;;;;;;;OASG;YACW,iBAAiB;IAuD/B;;;;;;;;;;;;;;;OAeG;YACW,iBAAiB;IA4EzB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAahE,gBAAgB,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIhE,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAW3B,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC;IAsBV,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAuCrE;AA8ED,eAAO,MAAM,eAAe,iBAAwB,CAAA"}