@intentface/latch-channels 0.9.1

package/dist/telegram/stream.js

@@ -0,0 +1,185 @@
+import { TelegramApiError } from "./api.js";
+import { escapeHtml, gfmToTelegramHtml } from "./html.js";
+/**
+ * The streaming-edit engine: Telegram (unlike Slack) can edit a sent message,
+ * so the answer streams as progressive `editMessageText` calls on one message.
+ *
+ *   sendChatAction("typing") on start.
+ *   First text-delta → sendMessage; keep the message_id.
+ *   Buffer deltas; flush when ≥`minEditIntervalMs` since the last edit OR
+ *   ≥`minEditChars` new chars. On 429, honor `retry_after` and resume.
+ *   tool-start folds a status line into the draft; tool-end clears it.
+ *   At `maxChars` stop growing, append the truncation notice (one message,
+ *   never a spill-over second one), and keep draining events without editing.
+ *   finish/error → final flush (status line removed, error appended).
+ *
+ * Renders HTML (`parse_mode: "HTML"`); if Telegram rejects the entity parse
+ * (400), the same content is retried as plain text and the message stays
+ * plain for the rest of the turn.
+ */
+export const MAX_TELEGRAM_TEXT_CHARS = 4000;
+export const TELEGRAM_TEXT_TRUNCATION_NOTICE = "\n\n_Response truncated for Telegram. The full turn is available in Latch._";
+const defaultSleep = (ms) => new Promise((r) => setTimeout(r, ms));
+export async function renderTelegramStream(events, opts) {
+    const maxChars = opts.maxChars ?? MAX_TELEGRAM_TEXT_CHARS;
+    const notice = opts.truncationNotice ?? TELEGRAM_TEXT_TRUNCATION_NOTICE;
+    const minInterval = opts.minEditIntervalMs ?? 1500;
+    const minChars = opts.minEditChars ?? 500;
+    const now = opts.now ?? Date.now;
+    const sleep = opts.sleep ?? defaultSleep;
+    let text = "";
+    let truncated = false;
+    let statusLine = "";
+    let errorMessage;
+    let messageId;
+    let lastSent = "";
+    let lastFlushAt = 0;
+    let charsSinceFlush = 0;
+    let plainFallback = false;
+    function compose(final) {
+        let body = truncated ? text.slice(0, maxChars) + notice : text;
+        if (!final && statusLine)
+            body += `\n\n⏳ ${statusLine}`;
+        if (final && errorMessage)
+            body += `${body ? "\n\n" : ""}⚠️ ${errorMessage.slice(0, 500)}`;
+        return { html: gfmToTelegramHtml(body), plain: body };
+    }
+    async function send(content) {
+        const attempt = async () => {
+            const input = plainFallback
+                ? { chat_id: opts.chatId, text: content.plain }
+                : {
+                    chat_id: opts.chatId,
+                    text: content.html,
+                    parse_mode: "HTML",
+                    link_preview_options: { is_disabled: true },
+                };
+            if (messageId === undefined) {
+                messageId = (await opts.api.sendMessage(input)).messageId;
+            }
+            else {
+                await opts.api.editMessageText({ ...input, message_id: messageId });
+            }
+        };
+        try {
+            await attempt();
+        }
+        catch (e) {
+            if (e instanceof TelegramApiError && e.status === 429) {
+                await sleep((e.retryAfter ?? 3) * 1000);
+                await attempt();
+            }
+            else if (e instanceof TelegramApiError && e.status === 400 && !plainFallback) {
+                // Almost always an entity-parse failure on partial markdown → go plain.
+                plainFallback = true;
+                await attempt();
+            }
+            else {
+                throw e;
+            }
+        }
+    }
+    async function flush(final) {
+        const content = compose(final);
+        const key = plainFallback ? content.plain : content.html;
+        if (!key.trim() || key === lastSent)
+            return;
+        try {
+            await send(content);
+            lastSent = plainFallback ? content.plain : content.html;
+            lastFlushAt = now();
+            charsSinceFlush = 0;
+        }
+        catch (e) {
+            if (final)
+                throw e;
+            console.error("[telegram] stream flush failed (will retry on next flush):", e);
+        }
+    }
+    await opts.api.sendChatAction(opts.chatId, "typing");
+    for await (const ev of events) {
+        switch (ev.type) {
+            case "text-delta":
+                if (!truncated) {
+                    text += ev.text;
+                    charsSinceFlush += ev.text.length;
+                    if (text.length > maxChars)
+                        truncated = true;
+                }
+                else {
+                    text += ev.text; // keep accumulating for the caller; stop editing
+                    continue;
+                }
+                break;
+            case "tool-start":
+                statusLine = `Running ${ev.toolName}…`;
+                charsSinceFlush += minChars; // status changes flush on the next check
+                break;
+            case "tool-end":
+                statusLine = "";
+                charsSinceFlush += minChars;
+                break;
+            case "error":
+                errorMessage = ev.message;
+                continue;
+            default:
+                continue;
+        }
+        const due = now() - lastFlushAt >= minInterval || charsSinceFlush >= minChars;
+        // Create the message promptly on first content; then throttle edits.
+        if ((messageId === undefined && text.trim()) || (messageId !== undefined && due)) {
+            await flush(false);
+        }
+    }
+    statusLine = "";
+    await flush(true);
+    const result = { text };
+    if (errorMessage !== undefined)
+        result.errorMessage = errorMessage;
+    if (messageId !== undefined)
+        result.messageId = messageId;
+    return result;
+}
+/** Compose the approval-prompt text (HTML) for a tool awaiting approval. */
+export function approvalPromptHtml(toolName, input) {
+    let json;
+    try {
+        json = JSON.stringify(input, null, 2) ?? String(input);
+    }
+    catch {
+        json = String(input);
+    }
+    if (json.length > 2500)
+        json = `${json.slice(0, 2500)}\n… (truncated)`;
+    return `🔒 Approve <b>${escapeHtml(toolName)}</b>?\n\n<pre>${escapeHtml(json)}</pre>`;
+}
+/** Longest option label Telegram renders comfortably on a button. */
+const MAX_BUTTON_LABEL = 40;
+/** Button caption for an option — ticked marker for multi-select, length-capped. */
+export function optionButtonText(label, ticked) {
+    const short = label.length > MAX_BUTTON_LABEL ? `${label.slice(0, MAX_BUTTON_LABEL - 1)}…` : label;
+    return ticked === undefined ? short : `${ticked ? "✓ " : "　"}${short}`;
+}
+/**
+ * Compose one question of a questionnaire (HTML). Option *labels* go on the
+ * buttons; the descriptions only fit in the body, numbered so a typed "2" is an
+ * unambiguous answer.
+ */
+export function questionPromptHtml(question, index, total) {
+    const head = total > 1 ? `<b>Question ${index + 1} of ${total}</b>\n` : "";
+    const title = question.header
+        ? `<i>${escapeHtml(question.header)}</i>\n${escapeHtml(question.question)}`
+        : escapeHtml(question.question);
+    const opts = question.options
+        .map((o, i) => {
+        const desc = o.description ? ` — ${escapeHtml(o.description)}` : "";
+        return `${i + 1}. <b>${escapeHtml(o.label)}</b>${desc}`;
+    })
+        .join("\n");
+    return `${head}${title}\n\n${opts}`;
+}
+/** Collapse an answered question card to a one-line receipt. */
+export function answeredQuestionHtml(question, answer) {
+    return `✓ ${escapeHtml(question)}\n<b>${escapeHtml(answer)}</b>`;
+}
+//# sourceMappingURL=stream.js.map

package/dist/telegram/stream.js.map

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

package/dist/telegram/telegramChannel.d.ts

@@ -0,0 +1,136 @@
+import type { AskStateStore, AuthResult, ChannelRunOps, ChannelThreadStore, TranscribeAudio } from "../types.js";
+import { decodeApprovalData, decodeQuestionData, encodeApprovalData, type InboundMedia, type Surface } from "../kernel.js";
+import { type InlineKeyboardButton, type SendMessageInput, type TelegramApiOptions, type TelegramClient, type TelegramToken } from "./api.js";
+export interface TelegramUser {
+    telegramUserId: string;
+    username?: string;
+    /** In a private chat Telegram's chat_id IS the user id, but carry it as delivered. */
+    telegramChatId: string;
+}
+export interface TelegramChannelConfig<P> {
+    /** The agent this bot serves. */
+    agent: string;
+    /**
+     * Stable host-side bot id (the bot row's id). Used in chat ids
+     * (`telegram_<botRef>_<userId>`) and delivery keys — NOT the Telegram bot id,
+     * so rotating the actual bot token/account keeps conversations intact.
+     */
+    botRef: string;
+    /** Vault-backed in practice: `() => vault.get(principal, "telegram_bot_token:<id>")`. */
+    botToken: TelegramToken;
+    /** The `secret_token` registered with setWebhook (lazy-resolvable like the token). */
+    webhookSecret: string | (() => string | Promise<string>);
+    runtime: ChannelRunOps<P>;
+    /**
+     * Resolve the inbound Telegram user to a platform principal. Return
+     * `{ allowed: false, linkUrl }` to refuse and DM a signed setup link; the
+     * kernel stashes the message (see `stashPending`) to replay after linking.
+     */
+    authorizeUser: (user: TelegramUser) => Promise<AuthResult<P>>;
+    /** Persistent dedupe on `<botRef>:<chatId>:<userId>:<messageId>` (and `<botRef>:cb:<id>` for taps). */
+    seen?: (deliveryKey: string) => Promise<boolean>;
+    /** Host-backed one-turn-per-chat lease (see the kernel). */
+    claimTurn?: (chatId: string) => Promise<string | null>;
+    releaseTurn?: (chatId: string, token: string) => Promise<void>;
+    /** Stash the message that triggered a link prompt, to replay after linking. */
+    stashPending?: (input: TelegramUser & {
+        text: string;
+        media?: InboundMedia<TgFileRef>[];
+    }) => Promise<void>;
+    /** Build the platform authorize URL for a `connect_<name>` OAuth approval. */
+    authorizeUrl?: (connectionName: string, ctx: {
+        chatId: string;
+        telegramUserId: string;
+        approvalId: string;
+    }) => string;
+    /** Host speech-to-text for voice notes (see the kernel). */
+    transcribe?: TranscribeAudio;
+    /** Host storage for in-flight `askUser` questionnaires (see the kernel). */
+    askState?: AskStateStore;
+    /** Host storage for the thread epoch — what makes `/new` possible. */
+    thread?: ChannelThreadStore;
+    /** Keep a serverless function alive after the fast ACK (Vercel: `waitUntil`). */
+    waitUntil?: (p: Promise<unknown>) => void;
+    /** Test seam: base URL / fetch for the Bot API client. */
+    apiOptions?: TelegramApiOptions;
+}
+export interface TgFileRef {
+    file_id: string;
+    file_size?: number;
+    mime_type?: string;
+    file_name?: string;
+}
+/** Button payloads are the kernel's shared `lta:` / `ltq:` formats. */
+export declare const encodeApprovalCallback: typeof encodeApprovalData;
+export declare const decodeApprovalCallback: typeof decodeApprovalData;
+export declare const decodeQuestionCallback: typeof decodeQuestionData;
+/** Build the chat id for a (bot, Telegram user) at a thread epoch. */
+export declare function telegramChatId(botRef: string, telegramUserId: string, epoch?: number): string;
+/**
+ * The inverse of `telegramChatId`, or null when `id` isn't one of ours. Parsed
+ * right-to-left because only the trailing parts have a fixed shape (numeric
+ * user id, optional `_t<digits>`) — a botRef is host-chosen and may contain
+ * anything but a newline.
+ */
+export declare function parseTelegramChatId(id: string): {
+    botRef: string;
+    telegramUserId: string;
+    epoch: number;
+} | null;
+export declare function telegramSurface(api: TelegramClient, botRef: string): Surface<TelegramUser, TgFileRef>;
+export declare function telegramChannel<P>(config: TelegramChannelConfig<P>): {
+    handleRequest: (request: Request) => Promise<Response>;
+    /** Run one already-gated, already-leased message (scheduled delivery). */
+    runMessage: (ctx: {
+        telegramUserId: string;
+        telegramChatId: string;
+        text: string;
+        media?: InboundMedia<TgFileRef>[];
+        principal: P;
+    } & {
+        chatId?: string;
+    }) => Promise<void>;
+    /** Replay a stashed message under the turn lease (the post-link resume). */
+    replayMessage: (ctx: {
+        telegramUserId: string;
+        telegramChatId: string;
+        text: string;
+        media?: InboundMedia<TgFileRef>[];
+        principal: P;
+    }) => Promise<void>;
+    api: {
+        getMe(): Promise<import("./api.js").TelegramBotInfo>;
+        setWebhook(input: {
+            url: string;
+            secretToken: string;
+            dropPendingUpdates?: boolean;
+        }): Promise<void>;
+        deleteWebhook(): Promise<void>;
+        setMyCommands(commands: {
+            command: string;
+            description: string;
+        }[]): Promise<void>;
+        getWebhookInfo(): Promise<import("./api.js").TelegramWebhookInfo>;
+        sendMessage(input: SendMessageInput): Promise<{
+            messageId: number;
+        }>;
+        editMessageText(input: SendMessageInput & {
+            message_id: number;
+        }): Promise<void>;
+        editMessageReplyMarkup(input: {
+            chat_id: number | string;
+            message_id: number;
+            reply_markup?: {
+                inline_keyboard: InlineKeyboardButton[][];
+            };
+        }): Promise<void>;
+        sendChatAction(chatId: number | string, action?: string): Promise<void>;
+        answerCallbackQuery(callbackQueryId: string, text?: string): Promise<void>;
+        getFile(fileId: string): Promise<{
+            filePath?: string;
+            fileSize?: number;
+        }>;
+        downloadFile(filePath: string): Promise<Uint8Array>;
+    };
+};
+//# sourceMappingURL=telegramChannel.d.ts.map

package/dist/telegram/telegramChannel.d.ts.map

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

package/dist/telegram/telegramChannel.js

@@ -0,0 +1,277 @@
+import { createTurnKernel, decodeApprovalData, decodeQuestionData, encodeApprovalData, } from "../kernel.js";
+import { assertCallbackData, telegramApi, TelegramApiError, } from "./api.js";
+import { verifyTelegramSecretToken } from "./verify.js";
+import { answeredQuestionHtml, approvalPromptHtml, htmlToPlain, optionButtonText, questionPromptHtml, } from "./format.js";
+import { escapeHtml, gfmToTelegramHtml } from "./html.js";
+/**
+ * One agent's Telegram bot. The host wires `handleRequest` to the bot's per-bot
+ * webhook route; we verify the secret token, ACK fast, and hand the parsed
+ * update to the turn kernel in the background. The answer posts once at
+ * finish (as HTML, plain on an entity-parse failure); "typing…" is the only
+ * progress signal.
+ *
+ * v1 scope: private chats (DMs) only — group messages are ignored by design.
+ *
+ * Everything below the parser is a {@link Surface}: how to send text, cards
+ * and links, how to edit or retire a card, how to download a file. The
+ * admission, questionnaire and command semantics live in the kernel.
+ */
+/** Telegram caps messages at 4096 chars; leave room for the split's trimming. */
+const MAX_TEXT_CHARS = 4000;
+/** Button payloads are the kernel's shared `lta:` / `ltq:` formats. */
+export const encodeApprovalCallback = encodeApprovalData;
+export const decodeApprovalCallback = decodeApprovalData;
+export const decodeQuestionCallback = decodeQuestionData;
+const ok = () => new Response(null, { status: 200 });
+/** The typed media attachments present on a message, largest photo size only. */
+function mediaRefs(msg) {
+    const out = [];
+    const photo = msg.photo?.[msg.photo.length - 1];
+    if (photo)
+        out.push({ ref: photo, mediaType: "image/jpeg", name: "photo.jpg" });
+    if (msg.document)
+        out.push({
+            ref: msg.document,
+            mediaType: msg.document.mime_type ?? "application/octet-stream",
+            name: msg.document.file_name ?? "document",
+        });
+    if (msg.voice)
+        out.push({ ref: msg.voice, mediaType: "audio/ogg", name: "voice.ogg" });
+    if (msg.audio)
+        out.push({ ref: msg.audio, mediaType: msg.audio.mime_type ?? "audio/mpeg", name: "audio" });
+    if (msg.video)
+        out.push({ ref: msg.video, mediaType: msg.video.mime_type ?? "video/mp4", name: "video.mp4" });
+    if (msg.video_note)
+        out.push({ ref: msg.video_note, mediaType: "video/mp4", name: "video-note.mp4" });
+    return out;
+}
+const userOf = (from, chatId) => ({
+    telegramUserId: String(from.id),
+    ...(from.username ? { username: from.username } : {}),
+    telegramChatId: String(chatId),
+});
+// ── The Telegram chat-id format ─────────────────────────────────────────────
+// `telegram_<botRef>_<telegramUserId>` for the original thread, `…_t<epoch>`
+// after `/new` bumps the epoch. Defined ONCE here and read back by
+// `parseTelegramChatId`, so nothing outside this file has to know the shape —
+// including the hosts that need to go the other way (a scheduled run resolving
+// which DM it belongs to). `_t<n>` can't collide with a numeric Telegram user
+// id and stays URL-safe: chat ids show up in `/chat/<chatId>` links.
+/** Build the chat id for a (bot, Telegram user) at a thread epoch. */
+export function telegramChatId(botRef, telegramUserId, epoch = 0) {
+    const base = `telegram_${botRef}_${telegramUserId}`;
+    return epoch > 0 ? `${base}_t${epoch}` : base;
+}
+/**
+ * The inverse of `telegramChatId`, or null when `id` isn't one of ours. Parsed
+ * right-to-left because only the trailing parts have a fixed shape (numeric
+ * user id, optional `_t<digits>`) — a botRef is host-chosen and may contain
+ * anything but a newline.
+ */
+export function parseTelegramChatId(id) {
+    const m = /^telegram_(.+)_(\d+)(?:_t(\d+))?$/.exec(id);
+    if (!m)
+        return null;
+    return { botRef: m[1], telegramUserId: m[2], epoch: m[3] ? Number(m[3]) : 0 };
+}
+// ── The surface ─────────────────────────────────────────────────────────────
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/** The inline keyboard for one question: one row per option, Done for multi. */
+function questionKeyboard(session, data) {
+    const q = session.questions[session.cursor];
+    const rows = q.options.map((o, i) => [
+        {
+            text: optionButtonText(o.label, q.multiSelect ? session.selected.includes(i) : undefined),
+            callback_data: assertCallbackData(data.pick(i)),
+        },
+    ]);
+    if (q.multiSelect)
+        rows.push([{ text: "✅ Done", callback_data: assertCallbackData(data.done) }]);
+    return rows;
+}
+export function telegramSurface(api, botRef) {
+    const chat = (u) => u.telegramChatId;
+    const ref = (r) => (r.messageId ? String(r.messageId) : undefined);
+    /**
+     * Send HTML; on 429 honour `retry_after` once; on 400 (almost always an
+     * entity-parse failure on model markdown) resend the plain twin.
+     */
+    async function sendHtml(u, html, plain, reply_markup) {
+        const base = {
+            chat_id: chat(u),
+            link_preview_options: { is_disabled: true },
+            ...(reply_markup ? { reply_markup } : {}),
+        };
+        const rich = { ...base, text: html, parse_mode: "HTML" };
+        try {
+            return ref(await api.sendMessage(rich));
+        }
+        catch (e) {
+            if (e instanceof TelegramApiError && e.status === 429) {
+                await sleep((e.retryAfter ?? 3) * 1000);
+                return ref(await api.sendMessage(rich));
+            }
+            if (e instanceof TelegramApiError && e.status === 400) {
+                return ref(await api.sendMessage({ ...base, text: plain }));
+            }
+            throw e;
+        }
+    }
+    return {
+        kind: "telegram",
+        maxTextChars: MAX_TEXT_CHARS,
+        chatId: (u, epoch) => telegramChatId(botRef, u.telegramUserId, epoch),
+        sendText: async (u, text, opts) => opts?.rich
+            ? sendHtml(u, gfmToTelegramHtml(text), text)
+            : ref(await api.sendMessage({ chat_id: chat(u), text })),
+        sendLink: async (u, body, label, url) => {
+            await sendHtml(u, escapeHtml(body), body, { inline_keyboard: [[{ text: label, url }]] });
+        },
+        sendApproval: (u, pa, data) => {
+            const html = approvalPromptHtml(pa.toolName, pa.input);
+            return sendHtml(u, html, htmlToPlain(html), {
+                inline_keyboard: [
+                    [
+                        { text: "✅ Approve", callback_data: assertCallbackData(data.approve) },
+                        { text: "🚫 Deny", callback_data: assertCallbackData(data.deny) },
+                    ],
+                ],
+            });
+        },
+        sendQuestion: (u, session, data) => {
+            const q = session.questions[session.cursor];
+            if (!q)
+                return Promise.resolve(undefined);
+            const html = questionPromptHtml(q, session.cursor, session.questions.length);
+            return sendHtml(u, html, htmlToPlain(html), data ? { inline_keyboard: questionKeyboard(session, data) } : undefined);
+        },
+        updateQuestion: (u, card, session, data) => api.editMessageReplyMarkup({
+            chat_id: chat(u),
+            message_id: Number(card),
+            reply_markup: { inline_keyboard: questionKeyboard(session, data) },
+        }),
+        answered: async (u, card, a) => {
+            if (card === undefined)
+                return;
+            await api.editMessageText({
+                chat_id: chat(u),
+                message_id: Number(card),
+                text: answeredQuestionHtml(a.question, a.answer),
+                parse_mode: "HTML",
+            });
+        },
+        settleCard: (u, card, text, opts) => api.editMessageText({
+            chat_id: chat(u),
+            message_id: Number(card),
+            text: opts?.rich ? gfmToTelegramHtml(text) : text,
+            ...(opts?.rich ? { parse_mode: "HTML" } : {}),
+        }),
+        retireCard: (u, card) => api.editMessageReplyMarkup({ chat_id: chat(u), message_id: Number(card) }),
+        typing: (u) => api.sendChatAction(chat(u)),
+        ack: (id, text) => api.answerCallbackQuery(id, text),
+        fetchMedia: async (m, maxBytes) => {
+            if ((m.ref.file_size ?? 0) > maxBytes)
+                return null;
+            const { filePath, fileSize } = await api.getFile(m.ref.file_id);
+            if (!filePath || (fileSize ?? 0) > maxBytes)
+                return null;
+            return { bytes: await api.downloadFile(filePath), mediaType: m.mediaType };
+        },
+    };
+}
+// ── The channel ─────────────────────────────────────────────────────────────
+export function telegramChannel(config) {
+    const api = telegramApi(config.botToken, config.apiOptions);
+    const defer = (p) => (config.waitUntil ? config.waitUntil(p) : p);
+    const kernel = createTurnKernel({
+        agent: config.agent,
+        botRef: config.botRef,
+        runtime: config.runtime,
+        authorizeUser: config.authorizeUser,
+        ...(config.seen ? { seen: config.seen } : {}),
+        ...(config.claimTurn ? { claimTurn: config.claimTurn } : {}),
+        ...(config.releaseTurn ? { releaseTurn: config.releaseTurn } : {}),
+        ...(config.transcribe ? { transcribe: config.transcribe } : {}),
+        ...(config.askState ? { askState: config.askState } : {}),
+        ...(config.thread ? { thread: config.thread } : {}),
+        ...(config.stashPending
+            ? {
+                stashPending: (i) => config.stashPending({ ...i.user, text: i.text, ...(i.media ? { media: i.media } : {}) }),
+            }
+            : {}),
+        ...(config.authorizeUrl
+            ? {
+                authorizeUrl: (name, ctx) => config.authorizeUrl(name, {
+                    chatId: ctx.chatId,
+                    telegramUserId: ctx.user.telegramUserId,
+                    approvalId: ctx.approvalId,
+                }),
+            }
+            : {}),
+    }, telegramSurface(api, config.botRef));
+    async function resolveWebhookSecret() {
+        return typeof config.webhookSecret === "function" ? config.webhookSecret() : config.webhookSecret;
+    }
+    /** A Telegram update → the kernel's inbound event, or null for updates we ignore. */
+    function parse(update) {
+        const cb = update.callback_query;
+        if (cb) {
+            // Same DM-only rule as messages: a tap on a card that somehow lives in a
+            // group would otherwise route every reply to that group's chat id.
+            if (cb.message && cb.message.chat.type !== "private")
+                return null;
+            return {
+                kind: "action",
+                user: userOf(cb.from, cb.message?.chat.id ?? cb.from.id),
+                data: cb.data ?? "",
+                deliveryKey: `${config.botRef}:cb:${cb.id}`,
+                ...(cb.message ? { card: String(cb.message.message_id) } : {}),
+                ackId: cb.id,
+            };
+        }
+        const msg = update.message;
+        if (!msg?.from || msg.from.is_bot)
+            return null;
+        if (msg.chat.type !== "private")
+            return null; // v1: DMs only, by design
+        const user = userOf(msg.from, msg.chat.id);
+        return {
+            kind: "message",
+            user,
+            text: (msg.text ?? msg.caption ?? "").trim(),
+            media: mediaRefs(msg),
+            deliveryKey: `${config.botRef}:${user.telegramChatId}:${user.telegramUserId}:${msg.message_id}`,
+        };
+    }
+    // ── The per-bot webhook entrypoint ──────────────────────────────────────────
+    async function handleRequest(request) {
+        const header = request.headers.get("x-telegram-bot-api-secret-token");
+        if (!verifyTelegramSecretToken(header, await resolveWebhookSecret())) {
+            return new Response("invalid secret token", { status: 401 });
+        }
+        let update;
+        try {
+            update = (await request.json());
+        }
+        catch {
+            return ok(); // malformed body — nothing to retry
+        }
+        const ev = parse(update);
+        if (ev)
+            defer(kernel.handleInbound(ev));
+        return ok();
+    }
+    const kernelCtx = ({ telegramUserId, telegramChatId, ...rest }) => ({
+        user: { telegramUserId, telegramChatId },
+        ...rest,
+    });
+    return {
+        handleRequest,
+        /** Run one already-gated, already-leased message (scheduled delivery). */
+        runMessage: (ctx) => kernel.runMessage(kernelCtx(ctx)),
+        /** Replay a stashed message under the turn lease (the post-link resume). */
+        replayMessage: (ctx) => kernel.replayMessage(kernelCtx(ctx)),
+        api,
+    };
+}
+//# sourceMappingURL=telegramChannel.js.map

package/dist/telegram/telegramChannel.js.map

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

package/dist/telegram/verify.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Verify Telegram's webhook secret: the `x-telegram-bot-api-secret-token`
+ * header must equal the `secret_token` we registered with `setWebhook`.
+ * Constant-time compare (length check first — `timingSafeEqual` requires it).
+ */
+export declare function verifyTelegramSecretToken(header: string | null, expected: string): boolean;
+//# sourceMappingURL=verify.d.ts.map

package/dist/telegram/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/telegram/verify.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAKT"}