charness 0.0.0-stage → 3.1.0

package/dist/connectors/telegram/fileSendGateway.js

@@ -0,0 +1,221 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.telegramPostUploadResponseDeadlineMs = void 0;
+exports.createTelegramFileInput = createTelegramFileInput;
+exports.checkIsDocumentFileSendMediaGroup = checkIsDocumentFileSendMediaGroup;
+exports.createTelegramMediaGroup = createTelegramMediaGroup;
+exports.getTelegramMessageIds = getTelegramMessageIds;
+exports.createTelegramFileSendGateway = createTelegramFileSendGateway;
+const node_fs_1 = require("node:fs");
+const node_stream_1 = require("node:stream");
+const promises_1 = require("node:stream/promises");
+const abort_controller_1 = __importDefault(require("abort-controller"));
+const fileSendService_1 = require("../../utils/fileSendService");
+const utils_1 = require("../../utils");
+const sendErrorClassifier_1 = require("../../sendErrorClassifier");
+/** A stream may terminate without closing the descriptor retained by the service. */
+const descriptorStreamFs = {
+    read: node_fs_1.read,
+    close: (_fileDescriptor, callback) => callback(null),
+};
+/** Maximum wait for Telegram's response after every request-body stream ends. */
+exports.telegramPostUploadResponseDeadlineMs = 30_000;
+function startPostUploadResponseDeadline(callback, delayMs) {
+    const timer = setTimeout(callback, delayMs);
+    timer.unref?.();
+    return () => clearTimeout(timer);
+}
+/** Create the Telegraf-side controller; stream state decides whether to abort it. */
+function createTelegrafAbortBridge() {
+    const controller = new abort_controller_1.default();
+    return {
+        signal: controller.signal,
+        abort: () => controller.abort(),
+    };
+}
+/**
+ * Keep one attempt's streams alive only for its send callback. Terminal listeners
+ * are registered before the callback starts. Cancellation destroys unread streams
+ * and aborts the sender only while any request body remains unconsumed. Once every
+ * stream has ended, the callback owns the delivery outcome and must settle before
+ * cleanup completes or a retry can begin. A bounded response deadline starts only
+ * after every stream ends normally; expiry aborts the sender and awaits settlement.
+ */
+async function executeWithTerminalStreams(streams, signal, abortSender, startResponseDeadline, send) {
+    const terminalPromises = streams.map(async (stream) => {
+        try {
+            await (0, promises_1.finished)(stream, { cleanup: true });
+        }
+        catch {
+            // destroy() rejects finished(); settlement, not that expected error, owns this boundary.
+        }
+        return stream.readableEnded;
+    });
+    const destroyLiveStreams = () => {
+        for (const stream of streams) {
+            if (!stream.destroyed && !stream.readableEnded)
+                stream.destroy();
+        }
+    };
+    let handleAbort = null;
+    if (signal) {
+        handleAbort = () => {
+            if (streams.every((stream) => stream.readableEnded))
+                return;
+            destroyLiveStreams();
+            abortSender();
+        };
+        signal.addEventListener('abort', handleAbort, { once: true });
+        if (signal.aborted)
+            handleAbort();
+    }
+    let isSendSettled = false;
+    let responseDeadlineError = null;
+    let cancelResponseDeadline = () => { };
+    const responseDeadlineReady = Promise.all(terminalPromises).then((streamEndStates) => {
+        if (isSendSettled || !streamEndStates.every(Boolean))
+            return;
+        cancelResponseDeadline = startResponseDeadline(() => {
+            responseDeadlineError = new Error(`Telegram did not respond within ${exports.telegramPostUploadResponseDeadlineMs} ms after upload completed`);
+            abortSender();
+        }, exports.telegramPostUploadResponseDeadlineMs);
+    });
+    try {
+        return await send();
+    }
+    catch (error) {
+        if (responseDeadlineError) {
+            throw new fileSendService_1.FileSendDeliveryUnknownError(responseDeadlineError);
+        }
+        throw error;
+    }
+    finally {
+        isSendSettled = true;
+        cancelResponseDeadline();
+        if (signal && handleAbort)
+            signal.removeEventListener('abort', handleAbort);
+        destroyLiveStreams();
+        await Promise.all(terminalPromises);
+        await responseDeadlineReady;
+    }
+}
+/**
+ * Build a fresh retry input without transferring descriptor ownership. Non-empty
+ * snapshots use a positional stream capped at the validated end byte; an empty
+ * snapshot uses an in-memory empty Readable so later file growth stays invisible.
+ */
+function createTelegramFileInput(snapshot) {
+    return {
+        source: snapshot.sizeBytes === 0
+            ? node_stream_1.Readable.from(Buffer.alloc(0), { objectMode: false })
+            : (0, node_fs_1.createReadStream)('', {
+                fd: snapshot.fd,
+                autoClose: false,
+                fs: descriptorStreamFs,
+                start: 0,
+                end: snapshot.sizeBytes - 1,
+            }),
+        filename: snapshot.filename,
+    };
+}
+/** Narrow the project media union before constructing Telegraf's homogeneous arrays. */
+function checkIsDocumentFileSendMediaGroup(mediaGroup) {
+    return mediaGroup.kind === 'document';
+}
+/** Convert a project-owned descriptor group into fresh Telegraf inputs for one attempt. */
+function createTelegramMediaGroup(mediaGroup) {
+    if (checkIsDocumentFileSendMediaGroup(mediaGroup)) {
+        const media = mediaGroup.media.map((entry) => ({
+            type: 'document',
+            media: createTelegramFileInput(entry.media),
+            ...(entry.caption !== undefined ? { caption: entry.caption } : {}),
+        }));
+        return media;
+    }
+    const media = mediaGroup.media.map((entry) => {
+        const telegramInput = createTelegramFileInput(entry.media);
+        if (entry.type === 'photo') {
+            return {
+                type: 'photo',
+                media: telegramInput,
+                ...(entry.caption !== undefined ? { caption: entry.caption } : {}),
+            };
+        }
+        return {
+            type: 'video',
+            media: telegramInput,
+            ...(entry.caption !== undefined ? { caption: entry.caption } : {}),
+        };
+    });
+    return media;
+}
+/** Extract sent message ids in Telegram response order for `/clear` tracking. */
+function getTelegramMessageIds(sent) {
+    return Array.isArray(sent)
+        ? sent.map((message) => message.message_id)
+        : [sent.message_id];
+}
+/** Preserve retryable API errors/cancellation and mark only ambiguous initiated sends. */
+function throwTelegramDeliveryError(error, isDeliveryInitiated, isAbortForwarded, signal) {
+    if (error instanceof fileSendService_1.FileSendDeliveryUnknownError)
+        throw error;
+    if (isAbortForwarded && signal)
+        throw (0, utils_1.getAbortError)(signal);
+    if ((0, utils_1.checkIsAbortError)(error))
+        throw error;
+    if ((0, sendErrorClassifier_1.checkIsApiError)(error) || !isDeliveryInitiated)
+        throw error;
+    const cause = error instanceof Error
+        ? error
+        : new Error('Telegram delivery failed without an error response');
+    throw new fileSendService_1.FileSendDeliveryUnknownError(cause);
+}
+/**
+ * Build the production gateway so every invocation constructs fresh bounded
+ * inputs and no attempt settles until all of its streams are terminal.
+ */
+function createTelegramFileSendGateway(deps) {
+    const startResponseDeadline = deps.startPostUploadResponseDeadline
+        ?? startPostUploadResponseDeadline;
+    async function executeSingleSend(target, source, caption, send, signal) {
+        const input = createTelegramFileInput(source);
+        const telegrafAbort = createTelegrafAbortBridge();
+        let isDeliveryInitiated = false;
+        try {
+            const sent = await executeWithTerminalStreams([input.source], signal, telegrafAbort.abort, startResponseDeadline, async () => {
+                isDeliveryInitiated = true;
+                return send(target, input, caption, telegrafAbort.signal);
+            });
+            return { messageIds: getTelegramMessageIds(sent) };
+        }
+        catch (error) {
+            throwTelegramDeliveryError(error, isDeliveryInitiated, telegrafAbort.signal.aborted, signal);
+        }
+    }
+    return {
+        sendPhoto: (target, source, caption, signal) => executeSingleSend(target, source, caption, deps.sendPhoto, signal),
+        sendAnimation: (target, source, caption, signal) => executeSingleSend(target, source, caption, deps.sendAnimation, signal),
+        sendVideo: (target, source, caption, signal) => executeSingleSend(target, source, caption, deps.sendVideo, signal),
+        sendDocument: (target, source, caption, signal) => executeSingleSend(target, source, caption, deps.sendDocument, signal),
+        sendMediaGroup: async (target, mediaGroup, signal) => {
+            const telegramMediaGroup = createTelegramMediaGroup(mediaGroup);
+            const streams = telegramMediaGroup.map((entry) => entry.media.source);
+            const telegrafAbort = createTelegrafAbortBridge();
+            let isDeliveryInitiated = false;
+            try {
+                const sent = await executeWithTerminalStreams(streams, signal, telegrafAbort.abort, startResponseDeadline, async () => {
+                    isDeliveryInitiated = true;
+                    return deps.sendMediaGroup(target, telegramMediaGroup, telegrafAbort.signal);
+                });
+                return { messageIds: getTelegramMessageIds(sent) };
+            }
+            catch (error) {
+                throwTelegramDeliveryError(error, isDeliveryInitiated, telegrafAbort.signal.aborted, signal);
+            }
+        },
+    };
+}
+//# sourceMappingURL=fileSendGateway.js.map

package/dist/connectors/telegram/fileSendGateway.js.map

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

package/dist/connectors/telegram/foreignKeyFallbacks.d.ts

@@ -0,0 +1,52 @@
+import { type Locale } from '../../i18n';
+import type { SessionKey } from '../../sessionKey';
+/**
+ * @description What the Telegram side of `bot.ts` does with a conversation of
+ * ANOTHER platform (Jira connector plan J2, D19). Every adapter event runs inside
+ * a locale lookup and may reach a Telegram send; both read the Telegram chat id,
+ * which throws for a foreign key — so without these a Jira session would throw on
+ * its first output. A foreign key gets the fallback locale, no group title, and
+ * every Telegram I/O primitive returns early.
+ */
+/** The per-chat locale settings `state.json` holds for Telegram chats. */
+export interface TelegramChatLocaleStore {
+    getChatLocaleOverride(chatId: number): Locale | null;
+    getChatTelegramLocale(chatId: number): Locale | null;
+}
+/**
+ * @description The locale a conversation's bot texts are written in: the chat's
+ * `/language` override, else the Telegram locale last seen there, else the
+ * default — which is also what a conversation of another platform gets.
+ */
+export declare function getTelegramConversationLocale(key: SessionKey, store: TelegramChatLocaleStore | null): Locale;
+/** Where the preamble's `group:` label comes from. */
+export interface PreambleGroupTitleSources {
+    getCachedGroupTitle(chatId: number): string | undefined;
+    checkIsDmKey(key: SessionKey): boolean;
+    getBotName(): string | undefined;
+}
+/**
+ * @description The `group:` label of the thread-context preamble: the cached
+ * supergroup title; for the owner's DM (a private chat has no title) the bot's
+ * own name; nothing for a conversation of another platform.
+ */
+export declare function getTelegramPreambleGroupTitle(key: SessionKey, sources: PreambleGroupTitleSources): string | undefined;
+/**
+ * @description Only the Telegram conversations of a list. The binding store is
+ * shared by every platform (a Jira issue binds its project folder too), while a
+ * Telegram listing or check over it reads each key's chat or topic id — which
+ * throws for a foreign key.
+ */
+export declare function getTelegramConversations<T extends {
+    key: SessionKey;
+}>(entries: readonly T[]): T[];
+/** What every Telegram refusal of a foreign conversation says — the primitive guard's skip and the send queue's error alike. */
+export declare const notTelegramChatPhrase = "is not a Telegram chat";
+/**
+ * @description A guard for the Telegram I/O primitives (send / edit / delete /
+ * typing / pin / pinned banner): `true` for a Telegram key, `false` for any
+ * other — the primitive then returns early. The skip is logged ONCE per
+ * primitive and conversation, since output arrives in many chunks.
+ */
+export declare function createTelegramPrimitiveGuard(warn?: (line: string) => void): (key: SessionKey, primitive: string) => boolean;
+//# sourceMappingURL=foreignKeyFallbacks.d.ts.map

package/dist/connectors/telegram/foreignKeyFallbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foreignKeyFallbacks.d.ts","sourceRoot":"","sources":["../../../src/connectors/telegram/foreignKeyFallbacks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI/D;;;;;;;GAOG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACrD,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACtD;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,uBAAuB,GAAG,IAAI,GAAG,MAAM,CAI5G;AAED,sDAAsD;AACtD,MAAM,WAAW,yBAAyB;IACxC,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACxD,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC;IACvC,UAAU,IAAI,MAAM,GAAG,SAAS,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,yBAAyB,GAAG,MAAM,GAAG,SAAS,CAKrH;AAKD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,UAAU,CAAA;CAAE,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAElG;AAED,gIAAgI;AAChI,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAK9D;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAmB,GAC1C,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAYjD"}

package/dist/connectors/telegram/foreignKeyFallbacks.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.notTelegramChatPhrase = void 0;
+exports.getTelegramConversationLocale = getTelegramConversationLocale;
+exports.getTelegramPreambleGroupTitle = getTelegramPreambleGroupTitle;
+exports.getTelegramConversations = getTelegramConversations;
+exports.createTelegramPrimitiveGuard = createTelegramPrimitiveGuard;
+const i18n_1 = require("../../i18n");
+const connectorSet_1 = require("../../platform/connectorSet");
+const sessionKeyCodec_1 = require("./sessionKeyCodec");
+/**
+ * @description The locale a conversation's bot texts are written in: the chat's
+ * `/language` override, else the Telegram locale last seen there, else the
+ * default — which is also what a conversation of another platform gets.
+ */
+function getTelegramConversationLocale(key, store) {
+    if (!store || !(0, sessionKeyCodec_1.checkIsTelegramKey)(key))
+        return i18n_1.defaultLocale;
+    const chatId = (0, sessionKeyCodec_1.getTelegramChatId)(key);
+    return store.getChatLocaleOverride(chatId) ?? store.getChatTelegramLocale(chatId) ?? i18n_1.defaultLocale;
+}
+/**
+ * @description The `group:` label of the thread-context preamble: the cached
+ * supergroup title; for the owner's DM (a private chat has no title) the bot's
+ * own name; nothing for a conversation of another platform.
+ */
+function getTelegramPreambleGroupTitle(key, sources) {
+    if (!(0, sessionKeyCodec_1.checkIsTelegramKey)(key))
+        return undefined;
+    const cached = sources.getCachedGroupTitle((0, sessionKeyCodec_1.getTelegramChatId)(key));
+    if (cached)
+        return cached;
+    return sources.checkIsDmKey(key) ? sources.getBotName() : undefined;
+}
+/** The platform set {@link getTelegramConversations} keeps. */
+const telegramPlatforms = (0, connectorSet_1.getServedPlatforms)(['telegram']);
+/**
+ * @description Only the Telegram conversations of a list. The binding store is
+ * shared by every platform (a Jira issue binds its project folder too), while a
+ * Telegram listing or check over it reads each key's chat or topic id — which
+ * throws for a foreign key.
+ */
+function getTelegramConversations(entries) {
+    return (0, connectorSet_1.getServedConversations)(entries, telegramPlatforms);
+}
+/** What every Telegram refusal of a foreign conversation says — the primitive guard's skip and the send queue's error alike. */
+exports.notTelegramChatPhrase = 'is not a Telegram chat';
+/** Distinct (primitive, conversation) pairs remembered before the memory starts over. */
+const reportedPrimitiveSkipsMaxSize = 1000;
+/**
+ * @description A guard for the Telegram I/O primitives (send / edit / delete /
+ * typing / pin / pinned banner): `true` for a Telegram key, `false` for any
+ * other — the primitive then returns early. The skip is logged ONCE per
+ * primitive and conversation, since output arrives in many chunks.
+ */
+function createTelegramPrimitiveGuard(warn = console.warn) {
+    const reported = new Set();
+    return (key, primitive) => {
+        if ((0, sessionKeyCodec_1.checkIsTelegramKey)(key))
+            return true;
+        const reportKey = [primitive, key.platform, key.space, key.thread].join('|');
+        if (!reported.has(reportKey)) {
+            if (reported.size >= reportedPrimitiveSkipsMaxSize)
+                reported.clear();
+            reported.add(reportKey);
+            warn(`[telegram] ${primitive} skipped: ${key.platform} conversation ${key.space}/${key.thread} ${exports.notTelegramChatPhrase}`);
+        }
+        return false;
+    };
+}
+//# sourceMappingURL=foreignKeyFallbacks.js.map

package/dist/connectors/telegram/foreignKeyFallbacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foreignKeyFallbacks.js","sourceRoot":"","sources":["../../../src/connectors/telegram/foreignKeyFallbacks.ts"],"names":[],"mappings":";;;AAyBA,sEAIC;AAcD,sEAKC;AAWD,4DAEC;AAcD,oEAcC;AAzFD,qCAAwD;AAExD,8DAAyF;AACzF,uDAA0E;AAiB1E;;;;GAIG;AACH,SAAgB,6BAA6B,CAAC,GAAe,EAAE,KAAqC;IAClG,IAAI,CAAC,KAAK,IAAI,CAAC,IAAA,oCAAkB,EAAC,GAAG,CAAC;QAAE,OAAO,oBAAa,CAAC;IAC7D,MAAM,MAAM,GAAG,IAAA,mCAAiB,EAAC,GAAG,CAAC,CAAC;IACtC,OAAO,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAAC,IAAI,oBAAa,CAAC;AACrG,CAAC;AASD;;;;GAIG;AACH,SAAgB,6BAA6B,CAAC,GAAe,EAAE,OAAkC;IAC/F,IAAI,CAAC,IAAA,oCAAkB,EAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,IAAA,mCAAiB,EAAC,GAAG,CAAC,CAAC,CAAC;IACnE,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,OAAO,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACtE,CAAC;AAED,+DAA+D;AAC/D,MAAM,iBAAiB,GAA4B,IAAA,iCAAkB,EAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AAEpF;;;;;GAKG;AACH,SAAgB,wBAAwB,CAAgC,OAAqB;IAC3F,OAAO,IAAA,qCAAsB,EAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;AAC5D,CAAC;AAED,gIAAgI;AACnH,QAAA,qBAAqB,GAAG,wBAAwB,CAAC;AAE9D,yFAAyF;AACzF,MAAM,6BAA6B,GAAG,IAAI,CAAC;AAE3C;;;;;GAKG;AACH,SAAgB,4BAA4B,CAC1C,OAA+B,OAAO,CAAC,IAAI;IAE3C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE;QACxB,IAAI,IAAA,oCAAkB,EAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,MAAM,SAAS,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7E,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,IAAI,QAAQ,CAAC,IAAI,IAAI,6BAA6B;gBAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;YACrE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACxB,IAAI,CAAC,cAAc,SAAS,aAAa,GAAG,CAAC,QAAQ,iBAAiB,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,6BAAqB,EAAE,CAAC,CAAC;QAC5H,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}

package/dist/connectors/telegram/inbound.d.ts

@@ -0,0 +1,131 @@
+/**
+ * @description The Telegram connector's inbound half — everything that turns a
+ * raw Telegram update into the core's platform-neutral {@link InboundEvent},
+ * plus the membership vocabulary the access policy used to import from telegraf
+ * directly.
+ *
+ * Nothing here decides policy. It translates: Telegram's nine `ChatMember`
+ * statuses become one `hasElevatedRights` boolean, its six media fields become
+ * five {@link AttachmentKind}s, and its `/name@bot args` syntax becomes an
+ * {@link InboundCommand} the neutral router can dispatch.
+ */
+import type { ChatMember, Message } from 'telegraf/typings/core/types/typegram';
+import type { SessionKey } from '../../sessionKey';
+import type { ConnectorInbound, InboundCommand, InboundEvent, NormalizedAttachment, PlatformMember } from '../../platform/inbound';
+import { type TelegramFileMeta } from './fileIntake';
+/**
+ * @description The two facts about THIS bot that inbound normalization needs:
+ * the username, to tell `/cmd@thisbot` from a command aimed at another bot in
+ * the same group, and the user id, to attribute a quoted reply to the assistant
+ * rather than to a person.
+ */
+export interface TelegramBotIdentity {
+    username?: string;
+    userId?: number;
+}
+/**
+ * @description Reduce a `getChatAdministrators` response to the core's neutral
+ * member shape. Bots are kept but flagged, so the policy's "real person" rule
+ * stays in the policy instead of being silently pre-applied here.
+ */
+export declare function getPlatformMembers(members: ChatMember[]): PlatformMember[];
+/**
+ * @description Should a `chat_member` status transition invalidate the cached
+ * admin set? Only transitions that TOUCH elevated status matter — someone was
+ * or becomes creator/administrator (promotion, demotion, an admin leaving).
+ * Joins/leaves of regular members can't change the admin set, so they must not
+ * trigger a `getChatAdministrators` refetch.
+ *
+ * Lives in the connector because the decision is expressed entirely in
+ * Telegram's status vocabulary.
+ */
+export declare function checkShouldInvalidateAdminCache(oldStatus: ChatMember['status'], newStatus: ChatMember['status']): boolean;
+/**
+ * @description Normalize a message's media into the core's attachment shape.
+ *
+ * Voice is handled separately from {@link getTelegramFileMeta} because the bot
+ * routes it to transcription rather than file intake — but the core still needs
+ * to see that the message CARRIED something, so it is normalized here.
+ */
+export declare function getNormalizedAttachments(message: Message): NormalizedAttachment[];
+/**
+ * @description Recognise Telegram's command syntax in a text message.
+ *
+ * Deliberately mirrors telegraf's own `Composer.command` matching rule so
+ * routing commands through the neutral router cannot change which messages
+ * count as commands:
+ *
+ *   - the message's FIRST entity must be a `bot_command` at offset 0;
+ *   - `/name@someone` only counts when `someone` is this bot (case-insensitive),
+ *     so a command addressed to another bot in the same group falls through;
+ *   - everything after the command token is the argument remainder.
+ *
+ * Returns `null` when the message is not a command — the caller then treats it
+ * as plain text.
+ */
+export declare function getTelegramCommand(message: Message.TextMessage, identity: TelegramBotIdentity): InboundCommand | null;
+/**
+ * @description Finds the bot's saved copy of a file sent to the conversation
+ * earlier (the file intake keeps it under `DATA_DIR`), or `undefined` once it is
+ * gone or was never taken in.
+ */
+export type SavedFileFinder = (meta: TelegramFileMeta) => string | undefined;
+/**
+ * @description The agent-facing reply-quote block for a message the bot forwards
+ * as a prompt — a typed text, a voice note whose transcript becomes one, or a
+ * file whose announcement does — or `undefined` when there is nothing to fold in
+ * (no reply, the topic root, a service message, nothing quotable). One reader for
+ * all of them, so a spoken reply or a file sent as a reply carries exactly the
+ * block a typed reply to the same message does. A reply TO a file names that
+ * file, with the path `findSavedFile` returns for it.
+ */
+export declare function getTelegramReplyQuoteBlock(message: Message, identity: TelegramBotIdentity, findSavedFile?: SavedFileFinder): string | undefined;
+/**
+ * @description Turn one Telegram message into the core's {@link InboundEvent}.
+ *
+ * `key` is passed in rather than derived here because resolving it needs the
+ * surface configuration (owner id, served group, chat mode) that lives in the
+ * bot's routing layer, not in this translation step.
+ *
+ * `raw` overrides what lands on the event's connector-private escape hatch. It
+ * exists because the not-yet-relocated command handlers still read Telegram
+ * fields off the telegraf CONTEXT rather than off the bare message; once they
+ * move into this directory the override goes away and `raw` is the message.
+ */
+export declare function getInboundEvent(message: Message, key: SessionKey, identity: TelegramBotIdentity, raw?: unknown): InboundEvent;
+/**
+ * @description What the Telegram connector needs from the bot to serve the
+ * inbound side. Injected so this module never imports `bot.ts` (which would be
+ * a cycle) and so the connector is testable without Telegraf.
+ */
+export interface TelegramInboundDeps {
+    /** `bot.telegram.getChatAdministrators` for one chat id. */
+    listAdministrators: (chatId: number) => Promise<ChatMember[]>;
+    /**
+     * `bot.botInfo` reduced to the two facts normalization needs. Read lazily:
+     * `botInfo` is only populated once telegraf has called `getMe` at launch,
+     * which happens after this connector is constructed.
+     */
+    getIdentity: () => TelegramBotIdentity;
+}
+/**
+ * @description The Telegram connector's inbound side.
+ *
+ * {@link deliver} is the connector-facing entry: the telegraf handlers call it
+ * with a raw message and the resolved key, it normalizes, and the core's
+ * registered handler receives a platform-neutral {@link InboundEvent}.
+ *
+ * `start` / `stop` arm and disarm that delivery. They deliberately do NOT own
+ * the long-polling transport yet: `bot.launch` still lives in the bot's startup
+ * sequence alongside the rest of the telegraf wiring, and moves in behind this
+ * interface when that wiring relocates into this directory.
+ */
+export interface TelegramConnectorInbound extends ConnectorInbound {
+    /**
+     * Normalize one Telegram message and hand it to the registered core handler.
+     * `raw` overrides the event's escape hatch — see {@link getInboundEvent}.
+     */
+    deliver(message: Message, key: SessionKey, raw?: unknown): Promise<void>;
+}
+export declare function createTelegramConnectorInbound(deps: TelegramInboundDeps): TelegramConnectorInbound;
+//# sourceMappingURL=inbound.d.ts.map

package/dist/connectors/telegram/inbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../../../src/connectors/telegram/inbound.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAQ,MAAM,sCAAsC,CAAC;AACtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAEV,gBAAgB,EAEhB,cAAc,EACd,YAAY,EAGZ,oBAAoB,EACpB,cAAc,EACf,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAA8C,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AA2BjG;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,cAAc,EAAE,CAO1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,EAC/B,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,GAC9B,OAAO,CAET;AAgBD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,oBAAoB,EAAE,CAyBjF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,CAAC,WAAW,EAC5B,QAAQ,EAAE,mBAAmB,GAC5B,cAAc,GAAG,IAAI,CASvB;AAOD;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,gBAAgB,KAAK,MAAM,GAAG,SAAS,CAAC;AA+D7E;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,mBAAmB,EAC7B,aAAa,CAAC,EAAE,eAAe,GAC9B,MAAM,GAAG,SAAS,CAEpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,mBAAmB,EAC7B,GAAG,GAAE,OAAiB,GACrB,YAAY,CAcd;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9D;;;;OAIG;IACH,WAAW,EAAE,MAAM,mBAAmB,CAAC;CACxC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAChE;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E;AAED,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,mBAAmB,GACxB,wBAAwB,CAkC1B"}