@daemux/telegram-adapter 1.0.0

package/dist/channel.js

@@ -0,0 +1,234 @@
+/**
+ * TelegramChannel - Main channel implementation
+ * Implements the EnhancedChannel interface for Telegram Bot API.
+ * Uses long polling, HTML formatting, and user allowlist enforcement.
+ */
+import { TelegramApi, TelegramApiError } from './api';
+import { sendMessage, sendPhoto, sendDocument, sendAudio, sendVideo, sendVoice, sendVideoNote, sendAnimation, } from './api-send';
+import { TelegramPoller } from './poller';
+import { markdownToTelegramHtml, chunkText, escapeHtml } from './format';
+import { convertTelegramMessage, isUserAllowed } from './channel-convert';
+const DEFAULT_MAX_FILE_SIZE = 20 * 1024 * 1024; // 20 MB
+const HTML_PARSE_ERROR_RE = /can't parse entities|parse entities|find end of the entity/i;
+// ---------------------------------------------------------------------------
+// TelegramChannel
+// ---------------------------------------------------------------------------
+export class TelegramChannel {
+    id = 'telegram';
+    type = 'telegram';
+    connected = false;
+    api = null;
+    poller = null;
+    config = null;
+    logger;
+    handlers = {
+        connected: [],
+        disconnected: [],
+        error: [],
+        message: [],
+    };
+    constructor(logger) {
+        this.logger = logger ?? {
+            info: (msg) => console.log(`[telegram] ${msg}`),
+            warn: (msg) => console.warn(`[telegram] ${msg}`),
+            error: (msg, err) => console.error(`[telegram] ${msg}`, err ?? ''),
+        };
+    }
+    /** Connect to Telegram by verifying the bot token and starting long polling. */
+    async connect(config) {
+        const channelConfig = validateConfig(config);
+        this.config = channelConfig;
+        this.api = new TelegramApi(channelConfig.botToken);
+        const me = await this.api.getMe();
+        this.logger.info(`Telegram bot connected: @${me.username} (id: ${me.id})`);
+        this.poller = new TelegramPoller({
+            api: this.api,
+            handler: (update) => this.handleUpdate(update),
+            pollTimeoutSec: channelConfig.pollTimeoutSec,
+        });
+        this.connected = true;
+        await this.emit('connected');
+        // Start polling in the background (non-blocking).
+        this.poller.start().catch((err) => {
+            this.emit('error', err instanceof Error ? err : new Error(String(err)));
+        });
+    }
+    /** Disconnect: stop polling and release resources. */
+    async disconnect() {
+        this.poller?.stop();
+        this.poller = null;
+        this.api = null;
+        this.connected = false;
+        await this.emit('disconnected', 'manual');
+    }
+    /** Send a text message, converting markdown to HTML if requested. */
+    async sendText(chatId, text, options) {
+        this.requireConnected();
+        const parseMode = options?.parseMode ?? 'text';
+        const formatted = this.formatText(text, parseMode);
+        const telegramParseMode = parseMode !== 'text' ? 'HTML' : undefined;
+        const chunks = chunkText(formatted);
+        let lastMessageId = '';
+        for (const chunk of chunks) {
+            lastMessageId = await this.sendSingleText(chatId, chunk, telegramParseMode, options);
+        }
+        return lastMessageId;
+    }
+    /** Send a media attachment (photo, video, audio, document, etc.). */
+    async sendMedia(chatId, attachment, options) {
+        this.requireConnected();
+        const replyTo = parseIntOrUndefined(options?.replyToId);
+        const msg = await this.routeMediaSend(chatId, attachment, replyTo);
+        return String(msg.message_id);
+    }
+    /** Download a file by its Telegram file_id. */
+    async downloadAttachment(fileId) {
+        this.requireConnected();
+        const fileInfo = await this.api.getFile(fileId);
+        if (!fileInfo.file_path) {
+            throw new Error('File path not available from Telegram');
+        }
+        const maxSize = this.config?.maxFileSize ?? DEFAULT_MAX_FILE_SIZE;
+        const data = await this.api.downloadFile(fileInfo.file_path, maxSize);
+        const fileName = fileInfo.file_path.split('/').pop();
+        return { data, fileName };
+    }
+    /** Register an event handler. Returns an unsubscribe function. */
+    on(event, handler) {
+        const list = this.handlers[event];
+        list.push(handler);
+        return () => {
+            const idx = list.indexOf(handler);
+            if (idx !== -1)
+                list.splice(idx, 1);
+        };
+    }
+    /** Register a handler compatible with the basic Channel.onMessage interface. */
+    onMessage(handler) {
+        this.handlers.message.push(handler);
+    }
+    /** Send a message via the basic Channel.send interface. */
+    async send(target, message, options) {
+        return this.sendText(target.channelId, message, {
+            parseMode: 'markdown',
+            replyToId: options?.replyToId,
+            threadId: target.threadId,
+        });
+    }
+    // -----------------------------------------------------------------------
+    // Internal: Update Processing
+    // -----------------------------------------------------------------------
+    async handleUpdate(update) {
+        const msg = update.message ?? update.edited_message;
+        if (!msg)
+            return;
+        if (!isUserAllowed(msg, this.config))
+            return;
+        const richMessage = convertTelegramMessage(msg);
+        await this.emit('message', richMessage);
+    }
+    // -----------------------------------------------------------------------
+    // Internal: Sending
+    // -----------------------------------------------------------------------
+    formatText(text, parseMode) {
+        if (parseMode === 'markdown')
+            return markdownToTelegramHtml(text);
+        return text;
+    }
+    async sendSingleText(chatId, text, parseMode, options) {
+        const replyTo = parseIntOrUndefined(options?.replyToId);
+        const threadId = parseIntOrUndefined(options?.threadId);
+        try {
+            const result = await sendMessage(this.api, chatId, text, {
+                parseMode,
+                replyToMessageId: replyTo,
+                messageThreadId: threadId,
+            });
+            return String(result.message_id);
+        }
+        catch (err) {
+            // If HTML parsing fails, fall back to plain text (matches openclaw pattern).
+            if (parseMode === 'HTML' && isHtmlParseError(err)) {
+                const result = await sendMessage(this.api, chatId, escapeHtml(text), {
+                    replyToMessageId: replyTo,
+                    messageThreadId: threadId,
+                });
+                return String(result.message_id);
+            }
+            throw err;
+        }
+    }
+    async routeMediaSend(chatId, attachment, replyTo) {
+        const opts = {
+            caption: attachment.caption,
+            parseMode: 'HTML',
+            fileName: attachment.fileName,
+            replyToMessageId: replyTo,
+        };
+        switch (attachment.type) {
+            case 'photo':
+                return sendPhoto(this.api, chatId, attachment.data, opts);
+            case 'voice':
+                return sendVoice(this.api, chatId, attachment.data, opts);
+            case 'audio':
+                return sendAudio(this.api, chatId, attachment.data, opts);
+            case 'video':
+                return sendVideo(this.api, chatId, attachment.data, opts);
+            case 'animation':
+                return sendAnimation(this.api, chatId, attachment.data, opts);
+            case 'video_note':
+                return sendVideoNote(this.api, chatId, attachment.data, { replyToMessageId: replyTo });
+            default:
+                return sendDocument(this.api, chatId, attachment.data, opts);
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Internal: Event Emission
+    // -----------------------------------------------------------------------
+    requireConnected() {
+        if (!this.api)
+            throw new Error('Telegram channel is not connected');
+    }
+    async emit(event, ...args) {
+        for (const handler of this.handlers[event]) {
+            try {
+                await handler(...args);
+            }
+            catch (err) {
+                this.logger.error(`Event handler error [${event}]`, err);
+            }
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function isHtmlParseError(err) {
+    if (err instanceof TelegramApiError) {
+        return HTML_PARSE_ERROR_RE.test(err.message);
+    }
+    return false;
+}
+function parseIntOrUndefined(value) {
+    if (value === undefined)
+        return undefined;
+    const n = parseInt(value, 10);
+    return Number.isFinite(n) ? n : undefined;
+}
+function validateConfig(config) {
+    if (!config.botToken || typeof config.botToken !== 'string') {
+        throw new Error('Telegram botToken is required');
+    }
+    if (config.allowedUserIds !== undefined) {
+        if (!Array.isArray(config.allowedUserIds)) {
+            throw new Error('allowedUserIds must be an array of numbers');
+        }
+        for (const id of config.allowedUserIds) {
+            if (typeof id !== 'number' || !Number.isFinite(id)) {
+                throw new Error('Each element in allowedUserIds must be a finite number');
+            }
+        }
+    }
+    return config;
+}
+//# sourceMappingURL=channel.js.map

package/dist/channel.js.map

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

package/dist/format.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Telegram HTML Formatter
+ * Converts markdown to Telegram-compatible HTML and handles text chunking.
+ * Uses HTML mode (not MarkdownV2) for simpler escaping and reliable rendering.
+ */
+import type { ChannelFormatter } from '@daemux/plugin-sdk';
+export declare function escapeHtml(text: string): string;
+export declare function markdownToTelegramHtml(markdown: string): string;
+export declare function chunkText(text: string, maxLength?: number): string[];
+/** Truncate text suitable for a media caption (max 1024 chars). */
+export declare function truncateCaption(text: string): string;
+export declare const telegramHtmlFormatter: ChannelFormatter;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAM3D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/C;AAUD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAqD/D;AASD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAA8B,GAAG,MAAM,EAAE,CAmBzF;AAmBD,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASpD;AAMD,eAAO,MAAM,qBAAqB,EAAE,gBAanC,CAAC"}

package/dist/format.js

@@ -0,0 +1,129 @@
+/**
+ * Telegram HTML Formatter
+ * Converts markdown to Telegram-compatible HTML and handles text chunking.
+ * Uses HTML mode (not MarkdownV2) for simpler escaping and reliable rendering.
+ */
+// ---------------------------------------------------------------------------
+// HTML Escaping
+// ---------------------------------------------------------------------------
+export function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}
+function escapeHtmlAttr(text) {
+    return escapeHtml(text).replace(/"/g, '&quot;');
+}
+// ---------------------------------------------------------------------------
+// Markdown to Telegram HTML conversion
+// ---------------------------------------------------------------------------
+export function markdownToTelegramHtml(markdown) {
+    if (!markdown)
+        return '';
+    let html = markdown;
+    // Extract and preserve code blocks before any other processing.
+    // This prevents formatting rules from being applied inside code.
+    const codeBlocks = [];
+    html = html.replace(/```(\w*)\n([\s\S]*?)```/g, (_match, lang, code) => {
+        const escaped = escapeHtml(code);
+        const langAttr = lang ? ` class="language-${escapeHtmlAttr(lang)}"` : '';
+        const placeholder = `\x00CB${codeBlocks.length}\x00`;
+        codeBlocks.push(`<pre><code${langAttr}>${escaped}</code></pre>`);
+        return placeholder;
+    });
+    // Extract and preserve inline code.
+    const inlineCodes = [];
+    html = html.replace(/`([^`]+)`/g, (_match, code) => {
+        const placeholder = `\x00IC${inlineCodes.length}\x00`;
+        inlineCodes.push(`<code>${escapeHtml(code)}</code>`);
+        return placeholder;
+    });
+    // Escape remaining HTML entities (not inside code).
+    html = escapeHtml(html);
+    // Bold: **text**
+    html = html.replace(/\*\*(.+?)\*\*/g, '<b>$1</b>');
+    // Italic: *text* (not preceded/followed by another *)
+    html = html.replace(/(?<!\*)\*(?!\*)(.+?)(?<!\*)\*(?!\*)/g, '<i>$1</i>');
+    // Strikethrough: ~~text~~
+    html = html.replace(/~~(.+?)~~/g, '<s>$1</s>');
+    // Links: [text](url)
+    html = html.replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_match, text, url) => `<a href="${escapeHtmlAttr(url)}">${text}</a>`);
+    // Restore inline code placeholders.
+    for (let i = 0; i < inlineCodes.length; i++) {
+        html = html.replace(`\x00IC${i}\x00`, inlineCodes[i]);
+    }
+    // Restore code block placeholders.
+    for (let i = 0; i < codeBlocks.length; i++) {
+        html = html.replace(`\x00CB${i}\x00`, codeBlocks[i]);
+    }
+    return html;
+}
+// ---------------------------------------------------------------------------
+// Text Chunking (Telegram has a 4096 char message limit)
+// ---------------------------------------------------------------------------
+const TELEGRAM_MAX_MESSAGE_LENGTH = 4096;
+const TELEGRAM_MAX_CAPTION_LENGTH = 1024;
+export function chunkText(text, maxLength = TELEGRAM_MAX_MESSAGE_LENGTH) {
+    if (!text)
+        return [''];
+    if (text.length <= maxLength)
+        return [text];
+    const chunks = [];
+    let remaining = text;
+    while (remaining.length > 0) {
+        if (remaining.length <= maxLength) {
+            chunks.push(remaining);
+            break;
+        }
+        let breakPoint = findBreakPoint(remaining, maxLength);
+        chunks.push(remaining.slice(0, breakPoint));
+        remaining = remaining.slice(breakPoint).trimStart();
+    }
+    return chunks;
+}
+function findBreakPoint(text, maxLength) {
+    // Prefer breaking at a blank line (paragraph boundary).
+    const doubleNewline = text.lastIndexOf('\n\n', maxLength);
+    if (doubleNewline > maxLength * 0.3)
+        return doubleNewline;
+    // Fall back to single newline.
+    const newline = text.lastIndexOf('\n', maxLength);
+    if (newline > maxLength * 0.3)
+        return newline;
+    // Fall back to space.
+    const space = text.lastIndexOf(' ', maxLength);
+    if (space > maxLength * 0.3)
+        return space;
+    // Hard break as last resort.
+    return maxLength;
+}
+/** Truncate text suitable for a media caption (max 1024 chars). */
+export function truncateCaption(text) {
+    if (text.length <= TELEGRAM_MAX_CAPTION_LENGTH)
+        return text;
+    const truncated = text.slice(0, TELEGRAM_MAX_CAPTION_LENGTH - 3);
+    const lastSpace = truncated.lastIndexOf(' ');
+    if (lastSpace > TELEGRAM_MAX_CAPTION_LENGTH * 0.5) {
+        return truncated.slice(0, lastSpace) + '...';
+    }
+    return truncated + '...';
+}
+// ---------------------------------------------------------------------------
+// Telegram HTML Formatter (implements ChannelFormatter)
+// ---------------------------------------------------------------------------
+export const telegramHtmlFormatter = {
+    bold: (text) => `<b>${escapeHtml(text)}</b>`,
+    italic: (text) => `<i>${escapeHtml(text)}</i>`,
+    strikethrough: (text) => `<s>${escapeHtml(text)}</s>`,
+    code: (text) => `<code>${escapeHtml(text)}</code>`,
+    codeBlock: (text, language) => {
+        const langAttr = language ? ` class="language-${escapeHtmlAttr(language)}"` : '';
+        return `<pre><code${langAttr}>${escapeHtml(text)}</code></pre>`;
+    },
+    link: (text, url) => `<a href="${escapeHtmlAttr(url)}">${escapeHtml(text)}</a>`,
+    escape: escapeHtml,
+    fromMarkdown: markdownToTelegramHtml,
+    chunk: chunkText,
+};
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Telegram Adapter Plugin Entry Point
+ * Registers the TelegramChannel with the daemux plugin system.
+ */
+import { TelegramChannel } from './channel';
+export { TelegramChannel } from './channel';
+export { TelegramApi, TelegramApiError } from './api';
+export { sendMessage, sendPhoto, sendDocument, sendAudio, sendVideo, sendVoice, sendVideoNote, sendSticker, sendAnimation, } from './api-send';
+export type { MediaSendOptions } from './api-send';
+export { TelegramPoller } from './poller';
+export { telegramHtmlFormatter, markdownToTelegramHtml, chunkText, escapeHtml } from './format';
+export { resolveMessageType, resolveFileId, resolveAttachment } from './message-resolver';
+export type { ResolvedAttachment } from './message-resolver';
+export type { ChannelFormatter, RichChannelMessage, ChannelAttachment, ChannelSendOptions } from '@daemux/plugin-sdk';
+export type { TelegramUser, TelegramChat, TelegramMessage, TelegramUpdate, TelegramChannelConfig, TelegramFileInfo, TelegramBotInfo, ChannelMessageType, } from './types';
+export declare const manifest: {
+    name: string;
+    version: string;
+    description: string;
+    author: string;
+};
+interface PluginAPI {
+    registerChannel(channel: {
+        id: string;
+        type: string;
+        connect(config: Record<string, unknown>): Promise<void>;
+        disconnect(): Promise<void>;
+        send(target: {
+            channelId: string;
+            userId?: string;
+            threadId?: string;
+        }, message: string, options?: {
+            attachments?: Array<{
+                type: string;
+                data: Buffer;
+                filename: string;
+            }>;
+            replyToId?: string;
+        }): Promise<string>;
+        onMessage(handler: (message: {
+            id: string;
+            channelId: string;
+            senderId: string;
+            content: string;
+            timestamp: number;
+            [key: string]: unknown;
+        }) => Promise<void>): void;
+    }): void;
+    log(level: string, message: string, data?: Record<string, unknown>): void;
+}
+/** Activate the plugin. Called by the daemux plugin loader. */
+export declare function activate(api: PluginAPI): Promise<void>;
+/** Deactivate the plugin. Called when the plugin is unloaded. */
+export declare function deactivate(): Promise<void>;
+/** Get the current channel instance (for programmatic access). */
+export declare function getChannel(): TelegramChannel | null;
+/** Default export for plugin loading (matches anthropic-provider pattern). */
+declare const _default: {
+    manifest: {
+        name: string;
+        version: string;
+        description: string;
+        author: string;
+    };
+    activate: typeof activate;
+    deactivate: typeof deactivate;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EACL,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAC1D,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,GACrD,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC1F,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACtH,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAMjB,eAAO,MAAM,QAAQ;;;;;CAKpB,CAAC;AAMF,UAAU,SAAS;IACjB,eAAe,CAAC,OAAO,EAAE;QACvB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACxD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CACF,MAAM,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,EACjE,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAC;gBAAC,QAAQ,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,GACtG,OAAO,CAAC,MAAM,CAAC,CAAC;QACnB,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE;YAC3B,EAAE,EAAE,MAAM,CAAC;YACX,SAAS,EAAE,MAAM,CAAC;YAClB,QAAQ,EAAE,MAAM,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC;YAChB,SAAS,EAAE,MAAM,CAAC;YAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;SACxB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;KAC5B,GAAG,IAAI,CAAC;IACT,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3E;AAQD,+DAA+D;AAC/D,wBAAsB,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAO5D;AAED,iEAAiE;AACjE,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAOhD;AAED,kEAAkE;AAClE,wBAAgB,UAAU,IAAI,eAAe,GAAG,IAAI,CAEnD;AAED,8EAA8E;;;;;;;;;;;AAC9E,wBAAkD"}

package/dist/index.js

@@ -0,0 +1,48 @@
+/**
+ * Telegram Adapter Plugin Entry Point
+ * Registers the TelegramChannel with the daemux plugin system.
+ */
+import { TelegramChannel } from './channel';
+// Re-export public API
+export { TelegramChannel } from './channel';
+export { TelegramApi, TelegramApiError } from './api';
+export { sendMessage, sendPhoto, sendDocument, sendAudio, sendVideo, sendVoice, sendVideoNote, sendSticker, sendAnimation, } from './api-send';
+export { TelegramPoller } from './poller';
+export { telegramHtmlFormatter, markdownToTelegramHtml, chunkText, escapeHtml } from './format';
+export { resolveMessageType, resolveFileId, resolveAttachment } from './message-resolver';
+// ---------------------------------------------------------------------------
+// Plugin Manifest
+// ---------------------------------------------------------------------------
+export const manifest = {
+    name: '@daemux/telegram-adapter',
+    version: '1.0.0',
+    description: 'Telegram Bot API channel adapter for daemux',
+    author: 'daemux',
+};
+// ---------------------------------------------------------------------------
+// Plugin Lifecycle
+// ---------------------------------------------------------------------------
+let channelInstance = null;
+/** Activate the plugin. Called by the daemux plugin loader. */
+export async function activate(api) {
+    api.log('info', 'Activating Telegram adapter plugin');
+    channelInstance = new TelegramChannel();
+    api.registerChannel(channelInstance);
+    api.log('info', 'Telegram channel registered successfully');
+}
+/** Deactivate the plugin. Called when the plugin is unloaded. */
+export async function deactivate() {
+    if (channelInstance) {
+        if (channelInstance.connected) {
+            await channelInstance.disconnect();
+        }
+        channelInstance = null;
+    }
+}
+/** Get the current channel instance (for programmatic access). */
+export function getChannel() {
+    return channelInstance;
+}
+/** Default export for plugin loading (matches anthropic-provider pattern). */
+export default { manifest, activate, deactivate };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,uBAAuB;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EACL,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAC1D,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,GACrD,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAc1F,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,0BAA0B;IAChC,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,6CAA6C;IAC1D,MAAM,EAAE,QAAQ;CACjB,CAAC;AA6BF,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,IAAI,eAAe,GAA2B,IAAI,CAAC;AAEnD,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAc;IAC3C,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,oCAAoC,CAAC,CAAC;IAEtD,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IACxC,GAAG,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;IAErC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,0CAA0C,CAAC,CAAC;AAC9D,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,eAAe,EAAE,CAAC;QACpB,IAAI,eAAe,CAAC,SAAS,EAAE,CAAC;YAC9B,MAAM,eAAe,CAAC,UAAU,EAAE,CAAC;QACrC,CAAC;QACD,eAAe,GAAG,IAAI,CAAC;IACzB,CAAC;AACH,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,UAAU;IACxB,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,8EAA8E;AAC9E,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC"}

package/dist/message-resolver.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Message Type & File ID Resolver
+ * Extracts message type and primary file ID from a Telegram message.
+ */
+import type { TelegramMessage, ChannelMessageType } from './types';
+export interface ResolvedAttachment {
+    type: ChannelMessageType;
+    fileId: string;
+    mimeType?: string;
+    fileName?: string;
+    fileSize?: number;
+    duration?: number;
+    width?: number;
+    height?: number;
+}
+/**
+ * Determine the message type from a Telegram message.
+ * Priority order matches Telegram's conventions: animation before video
+ * (since animations have both animation and document fields).
+ */
+export declare function resolveMessageType(msg: TelegramMessage): ChannelMessageType;
+/** Extract the primary file_id from a Telegram message, if it has a file attachment. */
+export declare function resolveFileId(msg: TelegramMessage): string | undefined;
+/** Extract all attachment metadata from a Telegram message. */
+export declare function resolveAttachment(msg: TelegramMessage): ResolvedAttachment | undefined;
+//# sourceMappingURL=message-resolver.d.ts.map

package/dist/message-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-resolver.d.ts","sourceRoot":"","sources":["../src/message-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAMnE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,kBAAkB,CAY3E;AAMD,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAYtE;AAMD,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,eAAe,GAAG,kBAAkB,GAAG,SAAS,CAyFtF"}