@cats-inc/cats-platform 0.1.0

package/build/server/platform/transports/telegram/fanout.js

@@ -0,0 +1,86 @@
+import { buildTelegramBotTransportBindingId, } from '../../../shared/chatCoreIds.js';
+import { TELEGRAM_REPLY_LIMIT, chunkTelegramReply, } from './chunking.js';
+function normalizeText(value) {
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+export function formatTelegramFanoutText(message, origin) {
+    const body = normalizeText(message.body);
+    if (!body) {
+        return null;
+    }
+    if (origin === 'web' && message.senderKind === 'user') {
+        const senderName = normalizeText(message.senderName);
+        if (senderName) {
+            return `[${senderName}] ${body}`;
+        }
+    }
+    return body;
+}
+function sourceMatchesBinding(sourceTransportBindingId, binding) {
+    if (!sourceTransportBindingId) {
+        return false;
+    }
+    return sourceTransportBindingId === binding.id
+        || sourceTransportBindingId === buildTelegramBotTransportBindingId(binding.id);
+}
+function resolveLinkedConversation(relay, input) {
+    const linkedConversation = relay.resolveBinding({
+        roomId: input.channelId,
+        bindingId: input.binding.id,
+    });
+    if (linkedConversation) {
+        return linkedConversation;
+    }
+    // Auto-link only when there is exactly one unlinked conversation for this
+    // binding. If multiple unlinked conversations exist (bot used by more than
+    // one Telegram user), we cannot safely guess which one belongs to the owner,
+    // so we skip rather than risk leaking web-originated messages to a stranger.
+    const candidate = relay.findSoleUnlinkedConversation(input.binding.id);
+    if (!candidate) {
+        return null;
+    }
+    return relay.linkRoom({
+        conversationId: candidate.conversationId,
+        chatId: candidate.telegramChatId,
+        bindingId: input.binding.id,
+        roomId: input.channelId,
+    });
+}
+export function createTelegramFanoutDeliverer(options) {
+    return {
+        platform: 'telegram',
+        async deliver(input) {
+            if (sourceMatchesBinding(input.sourceTransportBindingId, input.binding)) {
+                return { status: 'skipped', reason: 'source_binding' };
+            }
+            const text = formatTelegramFanoutText(input.message, input.origin);
+            if (!text) {
+                return { status: 'skipped', reason: 'empty_text' };
+            }
+            const linkedConversation = resolveLinkedConversation(options.telegramRelay, input);
+            if (!linkedConversation) {
+                return { status: 'skipped', reason: 'unlinked_room' };
+            }
+            const context = await options.resolveContext(input.binding.id);
+            const selectedContext = {
+                ...context,
+                selectedBotBinding: input.binding,
+            };
+            for (const chunk of chunkTelegramReply(text, TELEGRAM_REPLY_LIMIT)) {
+                await options.telegramRelay.deliver({
+                    request: {
+                        operation: 'send',
+                        conversationId: linkedConversation.conversationId,
+                        chatId: linkedConversation.telegramChatId,
+                        text: chunk,
+                        disableLinkPreview: true,
+                    },
+                    context: selectedContext,
+                });
+            }
+            return { status: 'delivered' };
+        },
+    };
+}
+//# sourceMappingURL=fanout.js.map

package/build/server/platform/transports/telegram/fanout.js.map

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

package/build/server/platform/transports/telegram/http.d.ts

@@ -0,0 +1,22 @@
+import type { RequestOptions } from 'node:https';
+import type { ClientRequest, IncomingMessage } from 'node:http';
+type TelegramHeaderValue = string | number | boolean;
+type TelegramHeadersInit = Record<string, TelegramHeaderValue> | Array<[string, TelegramHeaderValue]>;
+type TelegramBodyInit = string | URLSearchParams | ArrayBuffer | ArrayBufferView;
+export interface TelegramFetchResponse {
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+    text(): Promise<string>;
+}
+export type TelegramFetch = (url: string, options?: {
+    method?: string;
+    headers?: TelegramHeadersInit;
+    body?: TelegramBodyInit | null;
+    signal?: AbortSignal | null;
+}) => Promise<TelegramFetchResponse>;
+type TelegramRequestImpl = (url: URL, options: RequestOptions, onResponse: (response: IncomingMessage) => void) => ClientRequest;
+export declare function createTelegramIpv4Fetch(requestImpl?: TelegramRequestImpl): TelegramFetch;
+export declare const telegramIpv4Fetch: TelegramFetch;
+export {};
+//# sourceMappingURL=http.d.ts.map

package/build/server/platform/transports/telegram/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../../../src/platform/transports/telegram/http.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEhE,KAAK,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACrD,KAAK,mBAAmB,GACpB,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GACnC,KAAK,CAAC,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC;AACzC,KAAK,gBAAgB,GAAG,MAAM,GAAG,eAAe,GAAG,WAAW,GAAG,eAAe,CAAC;AAEjF,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,MAAM,MAAM,aAAa,GAAG,CAC1B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,IAAI,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B,KACE,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAEpC,KAAK,mBAAmB,GAAG,CACzB,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,KAC5C,aAAa,CAAC;AAuDnB,wBAAgB,uBAAuB,CACrC,WAAW,GAAE,mBAAkC,GAC9C,aAAa,CA6Df;AAED,eAAO,MAAM,iBAAiB,eAA4B,CAAC"}

package/build/server/platform/transports/telegram/http.js

@@ -0,0 +1,97 @@
+import { request as httpsRequest } from 'node:https';
+function normalizeHeaders(headers) {
+    if (!headers) {
+        return {};
+    }
+    if (Array.isArray(headers)) {
+        return Object.fromEntries(headers.map(([key, value]) => [key, String(value)]));
+    }
+    return Object.fromEntries(Object.entries(headers).map(([key, value]) => [key, String(value)]));
+}
+function normalizeBody(body) {
+    if (body == null) {
+        return null;
+    }
+    if (typeof body === 'string') {
+        return Buffer.from(body);
+    }
+    if (body instanceof URLSearchParams) {
+        return Buffer.from(body.toString());
+    }
+    if (body instanceof ArrayBuffer) {
+        return Buffer.from(body);
+    }
+    if (ArrayBuffer.isView(body)) {
+        return Buffer.from(body.buffer, body.byteOffset, body.byteLength);
+    }
+    return Buffer.from(String(body));
+}
+function createTelegramResponse(status, body) {
+    return {
+        ok: status >= 200 && status < 300,
+        status,
+        async json() {
+            return JSON.parse(body);
+        },
+        async text() {
+            return body;
+        },
+    };
+}
+function createAbortError(reason) {
+    if (reason instanceof Error) {
+        return reason;
+    }
+    const error = new Error('The operation was aborted.');
+    error.name = 'AbortError';
+    return error;
+}
+export function createTelegramIpv4Fetch(requestImpl = httpsRequest) {
+    return async (url, options = {}) => {
+        const target = new URL(url);
+        const headers = normalizeHeaders(options.headers);
+        const body = normalizeBody(options.body);
+        if (body && !Object.keys(headers).some((key) => key.toLowerCase() === 'content-length')) {
+            headers['content-length'] = String(body.byteLength);
+        }
+        return await new Promise((resolve, reject) => {
+            const request = requestImpl(target, {
+                method: options.method ?? 'GET',
+                headers,
+                family: 4,
+                servername: target.hostname,
+            }, (response) => {
+                const chunks = [];
+                response.on('data', (chunk) => {
+                    chunks.push(typeof chunk === 'string' ? Buffer.from(chunk) : chunk);
+                });
+                response.on('end', () => {
+                    resolve(createTelegramResponse(response.statusCode ?? 500, Buffer.concat(chunks).toString('utf8')));
+                });
+            });
+            const signal = options.signal ?? null;
+            const abortListener = () => {
+                request.destroy(createAbortError(signal?.reason));
+            };
+            if (signal?.aborted) {
+                request.destroy(createAbortError(signal.reason));
+                reject(createAbortError(signal.reason));
+                return;
+            }
+            signal?.addEventListener('abort', abortListener, { once: true });
+            request.on('error', (error) => {
+                signal?.removeEventListener('abort', abortListener);
+                reject(error);
+            });
+            request.on('close', () => {
+                signal?.removeEventListener('abort', abortListener);
+            });
+            if (body) {
+                request.write(body);
+            }
+            request.end();
+        });
+    };
+}
+export const telegramIpv4Fetch = createTelegramIpv4Fetch();
+//# sourceMappingURL=http.js.map

package/build/server/platform/transports/telegram/http.js.map

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

package/build/server/platform/transports/telegram/mapping.d.ts

@@ -0,0 +1,28 @@
+import type { TelegramConversationBinding, TelegramNormalizedMessageSummary, TelegramRoomRoutingSeam } from './contracts.js';
+import type { TelegramRelayStore } from './store/index.js';
+export declare const TELEGRAM_ROOM_ROUTING_PLACEHOLDER_NOTE: string;
+export declare const TELEGRAM_ROOM_ROUTING_LINKED_NOTE_PREFIX = "Telegram inbox is linked to the current Cats Chat room";
+export declare function describeTelegramRoomRouting(binding: Pick<TelegramConversationBinding, 'roomRoutingStatus' | 'linkedRoomId'> | null): TelegramRoomRoutingSeam;
+export interface TelegramConversationMappingResult {
+    binding: TelegramConversationBinding;
+    created: boolean;
+    roomRouting: TelegramRoomRoutingSeam;
+}
+export interface TelegramConversationMapper {
+    describeRoomRouting(bindingId?: string | null): TelegramRoomRoutingSeam;
+    getBindingCount(): number;
+    listBindings(): TelegramConversationBinding[];
+    resolveChatConversation(input: {
+        chatId: string;
+        acceptedAt: string;
+        bindingId?: string | null;
+        botName?: string | null;
+        chatType: string;
+        chatTitle: string | null;
+        chatUsername: string | null;
+        messageId: string | null;
+        messageSummary: TelegramNormalizedMessageSummary | null;
+    }): TelegramConversationMappingResult;
+}
+export declare function createTelegramConversationMapper(store: TelegramRelayStore): TelegramConversationMapper;
+//# sourceMappingURL=mapping.d.ts.map

package/build/server/platform/transports/telegram/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../../../../src/platform/transports/telegram/mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,gCAAgC,EAChC,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,eAAO,MAAM,sCAAsC,QAEO,CAAC;AAE3D,eAAO,MAAM,wCAAwC,2DACK,CAAC;AAE3D,wBAAgB,2BAA2B,CACzC,OAAO,EACH,IAAI,CAAC,2BAA2B,EAAE,mBAAmB,GAAG,cAAc,CAAC,GACvE,IAAI,GACP,uBAAuB,CAgBzB;AAkBD,MAAM,WAAW,iCAAiC;IAChD,OAAO,EAAE,2BAA2B,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,uBAAuB,CAAC;CACtC;AAED,MAAM,WAAW,0BAA0B;IACzC,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,uBAAuB,CAAC;IACxE,eAAe,IAAI,MAAM,CAAC;IAC1B,YAAY,IAAI,2BAA2B,EAAE,CAAC;IAC9C,uBAAuB,CAAC,KAAK,EAAE;QAC7B,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,cAAc,EAAE,gCAAgC,GAAG,IAAI,CAAC;KACzD,GAAG,iCAAiC,CAAC;CACvC;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,kBAAkB,GACxB,0BAA0B,CA2F5B"}

package/build/server/platform/transports/telegram/mapping.js

@@ -0,0 +1,96 @@
+export const TELEGRAM_ROOM_ROUTING_PLACEHOLDER_NOTE = 'Telegram ingress is durably mapped to transport inbox conversations. ' +
+    'Room continuation and creation policy remains pending.';
+export const TELEGRAM_ROOM_ROUTING_LINKED_NOTE_PREFIX = 'Telegram inbox is linked to the current Cats Chat room';
+export function describeTelegramRoomRouting(binding) {
+    if (binding?.roomRoutingStatus === 'linked_room' && binding.linkedRoomId) {
+        return {
+            transportConversationMode: 'direct_message',
+            roomRoutingStatus: 'linked_room',
+            linkedRoomId: binding.linkedRoomId,
+            note: `${TELEGRAM_ROOM_ROUTING_LINKED_NOTE_PREFIX} ${binding.linkedRoomId}.`,
+        };
+    }
+    return {
+        transportConversationMode: 'direct_message',
+        roomRoutingStatus: 'placeholder',
+        linkedRoomId: binding?.linkedRoomId ?? null,
+        note: TELEGRAM_ROOM_ROUTING_PLACEHOLDER_NOTE,
+    };
+}
+function createPlaceholderConversationId(chatId) {
+    return `telegram:${chatId}`;
+}
+function createScopedConversationId(chatId, bindingId) {
+    const normalizedBindingId = typeof bindingId === 'string' && bindingId.trim().length > 0
+        ? bindingId.trim()
+        : null;
+    return normalizedBindingId
+        ? `telegram:${normalizedBindingId}:${chatId}`
+        : createPlaceholderConversationId(chatId);
+}
+export function createTelegramConversationMapper(store) {
+    function findLatestBinding(bindingId) {
+        const normalizedBindingId = typeof bindingId === 'string' && bindingId.trim().length > 0
+            ? bindingId.trim()
+            : null;
+        return store
+            .listBindings()
+            .find((binding) => (normalizedBindingId ? binding.bindingId === normalizedBindingId : true))
+            ?? null;
+    }
+    return {
+        describeRoomRouting(bindingId) {
+            return describeTelegramRoomRouting(findLatestBinding(bindingId));
+        },
+        getBindingCount() {
+            return store.listBindings().length;
+        },
+        listBindings() {
+            return store.listBindings();
+        },
+        resolveChatConversation({ chatId, acceptedAt, bindingId, botName, chatType, chatTitle, chatUsername, messageId, messageSummary, }) {
+            const existingBinding = store.getBinding(chatId, bindingId);
+            const binding = existingBinding
+                ? {
+                    ...existingBinding,
+                    bindingId: bindingId ?? existingBinding.bindingId,
+                    botName: botName ?? existingBinding.botName,
+                    telegramChatType: chatType || existingBinding.telegramChatType,
+                    telegramChatTitle: chatTitle,
+                    telegramChatUsername: chatUsername,
+                    lastInboundMessageId: messageId,
+                    lastInboundAt: acceptedAt,
+                    lastInboundTextPreview: messageSummary?.textPreview ?? null,
+                    lastInboundAttachmentKinds: messageSummary?.attachmentKinds ?? [],
+                    updatedAt: acceptedAt,
+                }
+                : {
+                    telegramChatId: chatId,
+                    conversationId: createScopedConversationId(chatId, bindingId),
+                    bindingId: bindingId ?? null,
+                    botName: botName ?? null,
+                    transportConversationMode: 'direct_message',
+                    roomRoutingStatus: 'placeholder',
+                    linkedRoomId: null,
+                    telegramChatType: chatType,
+                    telegramChatTitle: chatTitle,
+                    telegramChatUsername: chatUsername,
+                    lastInboundMessageId: messageId,
+                    lastInboundAt: acceptedAt,
+                    lastInboundTextPreview: messageSummary?.textPreview ?? null,
+                    lastInboundAttachmentKinds: messageSummary?.attachmentKinds ?? [],
+                    lastOutboundMessageId: null,
+                    lastOutboundAt: null,
+                    createdAt: acceptedAt,
+                    updatedAt: acceptedAt,
+                };
+            store.upsertBinding(binding);
+            return {
+                binding,
+                created: existingBinding === null,
+                roomRouting: describeTelegramRoomRouting(binding),
+            };
+        },
+    };
+}
+//# sourceMappingURL=mapping.js.map

package/build/server/platform/transports/telegram/mapping.js.map

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

package/build/server/platform/transports/telegram/normalization.d.ts

@@ -0,0 +1,7 @@
+import type { TelegramMessagePayload, TelegramNormalizedAttachment, TelegramNormalizedMessageSummary } from './contracts.js';
+export declare function normalizeTelegramAttachments(message: TelegramMessagePayload): TelegramNormalizedAttachment[];
+export declare function normalizeTelegramMessageSummary(message: TelegramMessagePayload, options?: {
+    isEdited?: boolean;
+}): TelegramNormalizedMessageSummary;
+export declare function normalizeTelegramDeliveryTextPreview(text: string | null | undefined): string | null;
+//# sourceMappingURL=normalization.d.ts.map

package/build/server/platform/transports/telegram/normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalization.d.ts","sourceRoot":"","sources":["../../../../../src/platform/transports/telegram/normalization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAQV,sBAAsB,EACtB,4BAA4B,EAC5B,gCAAgC,EAMjC,MAAM,gBAAgB,CAAC;AAkKxB,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,sBAAsB,GAC9B,4BAA4B,EAAE,CAoChC;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,sBAAsB,EAC/B,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,gCAAgC,CAoBlC;AAED,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAEnG"}

package/build/server/platform/transports/telegram/normalization.js

@@ -0,0 +1,172 @@
+const MESSAGE_PREVIEW_LIMIT = 160;
+function normalizeTextPreview(rawText) {
+    if (!rawText) {
+        return null;
+    }
+    const collapsed = rawText.replace(/\s+/gu, ' ').trim();
+    if (!collapsed) {
+        return null;
+    }
+    if (collapsed.length <= MESSAGE_PREVIEW_LIMIT) {
+        return collapsed;
+    }
+    return `${collapsed.slice(0, MESSAGE_PREVIEW_LIMIT - 1)}…`;
+}
+function readString(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value : null;
+}
+function readNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+function createBaseAttachment(kind, payload) {
+    return {
+        kind,
+        fileId: readString(payload?.file_id),
+        fileUniqueId: readString(payload?.file_unique_id),
+        fileName: null,
+        mimeType: readString(payload?.mime_type),
+        sizeBytes: readNumber(payload?.file_size),
+        width: null,
+        height: null,
+        durationSeconds: null,
+        latitude: null,
+        longitude: null,
+        phoneNumber: null,
+        displayName: null,
+    };
+}
+function normalizePhotoAttachment(payload) {
+    return {
+        ...createBaseAttachment('photo', payload),
+        width: readNumber(payload?.width),
+        height: readNumber(payload?.height),
+    };
+}
+function normalizeDocumentAttachment(kind, payload) {
+    const richPayload = payload;
+    return {
+        ...createBaseAttachment(kind, payload),
+        fileName: readString(richPayload?.file_name),
+        width: readNumber(richPayload?.width),
+        height: readNumber(richPayload?.height),
+        durationSeconds: readNumber(richPayload?.duration),
+    };
+}
+function normalizeVoiceAttachment(payload) {
+    return {
+        ...createBaseAttachment('voice', payload),
+        durationSeconds: readNumber(payload?.duration),
+    };
+}
+function normalizeVideoNoteAttachment(payload) {
+    return {
+        ...createBaseAttachment('video_note', payload),
+        width: readNumber(payload?.length),
+        height: readNumber(payload?.length),
+        durationSeconds: readNumber(payload?.duration),
+    };
+}
+function normalizeStickerAttachment(payload) {
+    const emoji = readString(payload?.emoji);
+    return {
+        ...createBaseAttachment('sticker', payload),
+        width: readNumber(payload?.width),
+        height: readNumber(payload?.height),
+        displayName: emoji,
+    };
+}
+function normalizeLocationAttachment(payload) {
+    return {
+        kind: 'location',
+        fileId: null,
+        fileUniqueId: null,
+        fileName: null,
+        mimeType: null,
+        sizeBytes: null,
+        width: null,
+        height: null,
+        durationSeconds: null,
+        latitude: readNumber(payload?.latitude),
+        longitude: readNumber(payload?.longitude),
+        phoneNumber: null,
+        displayName: null,
+    };
+}
+function normalizeContactAttachment(payload) {
+    const firstName = readString(payload?.first_name);
+    const lastName = readString(payload?.last_name);
+    const displayName = [firstName, lastName].filter(Boolean).join(' ').trim();
+    return {
+        kind: 'contact',
+        fileId: null,
+        fileUniqueId: readString(payload?.user_id),
+        fileName: null,
+        mimeType: null,
+        sizeBytes: null,
+        width: null,
+        height: null,
+        durationSeconds: null,
+        latitude: null,
+        longitude: null,
+        phoneNumber: readString(payload?.phone_number),
+        displayName: displayName || null,
+    };
+}
+export function normalizeTelegramAttachments(message) {
+    const attachments = [];
+    if (Array.isArray(message.photo) && message.photo.length > 0) {
+        const largestPhoto = message.photo[message.photo.length - 1];
+        attachments.push(normalizePhotoAttachment(largestPhoto));
+    }
+    if (message.document) {
+        attachments.push(normalizeDocumentAttachment('document', message.document));
+    }
+    if (message.audio) {
+        attachments.push(normalizeDocumentAttachment('audio', message.audio));
+    }
+    if (message.voice) {
+        attachments.push(normalizeVoiceAttachment(message.voice));
+    }
+    if (message.video) {
+        attachments.push(normalizeDocumentAttachment('video', message.video));
+    }
+    if (message.video_note) {
+        attachments.push(normalizeVideoNoteAttachment(message.video_note));
+    }
+    if (message.animation) {
+        attachments.push(normalizeDocumentAttachment('animation', message.animation));
+    }
+    if (message.sticker) {
+        attachments.push(normalizeStickerAttachment(message.sticker));
+    }
+    if (message.location) {
+        attachments.push(normalizeLocationAttachment(message.location));
+    }
+    if (message.contact) {
+        attachments.push(normalizeContactAttachment(message.contact));
+    }
+    return attachments;
+}
+export function normalizeTelegramMessageSummary(message, options = {}) {
+    const senderDisplayName = [
+        readString(message.from?.first_name),
+        readString(message.from?.last_name),
+    ].filter(Boolean).join(' ').trim() || null;
+    const attachments = normalizeTelegramAttachments(message);
+    return {
+        isEdited: options.isEdited ?? false,
+        senderId: message.from?.id != null ? String(message.from.id) : null,
+        senderDisplayName,
+        senderUsername: readString(message.from?.username),
+        textPreview: normalizeTextPreview(readString(message.text) ?? readString(message.caption)),
+        attachmentCount: attachments.length,
+        attachmentKinds: attachments.map((attachment) => attachment.kind),
+        replyToMessageId: typeof message.reply_to_message?.message_id === 'number'
+            ? String(message.reply_to_message.message_id)
+            : null,
+    };
+}
+export function normalizeTelegramDeliveryTextPreview(text) {
+    return normalizeTextPreview(typeof text === 'string' ? text : null);
+}
+//# sourceMappingURL=normalization.js.map

package/build/server/platform/transports/telegram/normalization.js.map

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

package/build/server/platform/transports/telegram/polling.d.ts

@@ -0,0 +1,50 @@
+import type { RuntimeClient } from '../../runtime/client.js';
+import type { CatsMemoryService } from '../../memory/index.js';
+import { type TelegramFetch } from './http.js';
+import { type TelegramRoomBridge, type TelegramWebhookBridgeResult } from './bridge.js';
+import type { TelegramPollingStatus, TelegramRelayContext, TelegramWebhookUpdate } from './contracts.js';
+import type { TelegramRelay } from './relay/index.js';
+export interface TelegramPollingSupervisor {
+    startPolling(input: StartPollingInput): Promise<void>;
+    stopPolling(bindingId: string): void;
+    stopAll(): void;
+    reconnect(input: StartPollingInput): Promise<void>;
+    reconcilePolling(input: ReconcilePollingInput): Promise<void>;
+    getPollingStatus(bindingId: string): TelegramPollingStatus | null;
+    getAllPollingStatuses(): TelegramPollingStatus[];
+}
+export type TelegramPollingBridgeResultHandler = (result: TelegramWebhookBridgeResult) => void;
+export interface StartPollingInput {
+    bindingId: string;
+    botToken: string;
+    context: TelegramRelayContext;
+    refreshContext?: () => Promise<TelegramRelayContext>;
+    roomBridge: TelegramRoomBridge;
+    memoryService: CatsMemoryService;
+    runtimeClient: RuntimeClient;
+    telegramRelay: TelegramRelay;
+    onBridgeResult?: TelegramPollingBridgeResultHandler;
+}
+export interface ReconcilePollingInput {
+    bindings: Array<{
+        bindingId: string;
+        botToken: string;
+        inboundMode: 'polling' | 'webhook';
+    }>;
+    context: TelegramRelayContext;
+    refreshContext?: () => Promise<TelegramRelayContext>;
+    roomBridge: TelegramRoomBridge;
+    memoryService: CatsMemoryService;
+    runtimeClient: RuntimeClient;
+    telegramRelay: TelegramRelay;
+    onBridgeResult?: TelegramPollingBridgeResultHandler;
+}
+export declare function telegramDeleteWebhook(botToken: string, fetchImpl?: TelegramFetch): Promise<boolean>;
+export declare function telegramGetUpdates(botToken: string, offset: number | null, timeout: number, signal: AbortSignal, fetchImpl?: TelegramFetch): Promise<TelegramWebhookUpdate[]>;
+export interface TelegramPollingSupervisorOptions {
+    now?: () => Date;
+    fetchImpl?: TelegramFetch;
+    pollingTimeout?: number;
+}
+export declare function createTelegramPollingSupervisor(options?: TelegramPollingSupervisorOptions): TelegramPollingSupervisor;
+//# sourceMappingURL=polling.d.ts.map

package/build/server/platform/transports/telegram/polling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../../../../../src/platform/transports/telegram/polling.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EACjC,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAEV,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,WAAW,yBAAyB;IACxC,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,OAAO,IAAI,IAAI,CAAC;IAChB,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAAC;IAClE,qBAAqB,IAAI,qBAAqB,EAAE,CAAC;CAClD;AAED,MAAM,MAAM,kCAAkC,GAAG,CAAC,MAAM,EAAE,2BAA2B,KAAK,IAAI,CAAC;AAE/F,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACrD,UAAU,EAAE,kBAAkB,CAAC;IAC/B,aAAa,EAAE,iBAAiB,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,CAAC,EAAE,kCAAkC,CAAC;CACrD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,SAAS,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;IAC7F,OAAO,EAAE,oBAAoB,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACrD,UAAU,EAAE,kBAAkB,CAAC;IAC/B,aAAa,EAAE,iBAAiB,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,CAAC,EAAE,kCAAkC,CAAC;CACrD;AAsDD,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,aAAiC,GAC3C,OAAO,CAAC,OAAO,CAAC,CAclB;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,EACnB,SAAS,GAAE,aAAiC,GAC3C,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAwBlC;AAED,MAAM,WAAW,gCAAgC;IAC/C,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,gCAAqC,GAC7C,yBAAyB,CAkO3B"}