@intentface/latch-channels 0.9.1

package/dist/telegram/api.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Minimal Telegram Bot API client — just the methods a channel (and its host's
+ * admin surface) needs. JSON POSTs to `api.telegram.org/bot<token>/<method>`,
+ * `{ok, result, description}` unwrap, 10s timeout per call. No SDK.
+ */
+export type TelegramToken = string | (() => string | Promise<string>);
+/** A failed Bot API call. `retryAfter` (seconds) is set on 429s. */
+export declare class TelegramApiError extends Error {
+    readonly status: number;
+    readonly retryAfter?: number;
+    constructor(method: string, status: number, description?: string, retryAfter?: number);
+}
+export interface TelegramApiOptions {
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+}
+export interface TelegramBotInfo {
+    id: number;
+    username: string;
+    firstName: string;
+}
+export interface TelegramWebhookInfo {
+    url: string;
+    pendingUpdateCount: number;
+    lastErrorMessage?: string;
+    lastErrorDate?: number;
+}
+/** An inline-keyboard button: either a callback button or a URL link button. */
+export type InlineKeyboardButton = {
+    text: string;
+    callback_data: string;
+} | {
+    text: string;
+    url: string;
+};
+export interface SendMessageInput {
+    chat_id: number | string;
+    text: string;
+    parse_mode?: "HTML";
+    reply_markup?: {
+        inline_keyboard: InlineKeyboardButton[][];
+    };
+    link_preview_options?: {
+        is_disabled: boolean;
+    };
+}
+/** Telegram's hard cap on `callback_data`. Over it, sendMessage 400s. */
+export declare const MAX_CALLBACK_DATA_BYTES = 64;
+/**
+ * Guard a `callback_data` payload against Telegram's 64-byte cap. Encoders call
+ * this so an over-long payload fails loudly at the call site instead of as an
+ * opaque 400 from an unrelated `sendMessage`.
+ */
+export declare function assertCallbackData(data: string): string;
+/** A bot-scoped client bound to one (possibly lazily resolved) token. */
+export declare function telegramApi(token: TelegramToken, opts?: TelegramApiOptions): {
+    /** Validate the token and return the bot's identity. */
+    getMe(): Promise<TelegramBotInfo>;
+    /** Point Telegram's webhook at `url`, guarded by `secretToken`. */
+    setWebhook(input: {
+        url: string;
+        secretToken: string;
+        dropPendingUpdates?: boolean;
+    }): Promise<void>;
+    deleteWebhook(): Promise<void>;
+    /**
+     * Publish the bot's command list — what Telegram shows in the "/" menu and
+     * autocompletes. Cosmetic: the commands work either way, but nothing else
+     * makes them discoverable. Call it whenever the webhook is (re-)registered.
+     */
+    setMyCommands(commands: {
+        command: string;
+        description: string;
+    }[]): Promise<void>;
+    getWebhookInfo(): Promise<TelegramWebhookInfo>;
+    /** Send a message; returns the new message id (cards are edited later by it). */
+    sendMessage(input: SendMessageInput): Promise<{
+        messageId: number;
+    }>;
+    /** Edit a previously sent message in place (the streaming primitive). */
+    editMessageText(input: SendMessageInput & {
+        message_id: number;
+    }): Promise<void>;
+    /**
+     * Swap (or remove) just a message's inline keyboard. Used to re-tick
+     * multi-select options and to retire stale buttons — cheaper than
+     * `editMessageText` and it can't trip the "message is not modified" 400.
+     */
+    editMessageReplyMarkup(input: {
+        chat_id: number | string;
+        message_id: number;
+        reply_markup?: {
+            inline_keyboard: InlineKeyboardButton[][];
+        };
+    }): Promise<void>;
+    /** Show "typing…" in the chat (auto-expires after ~5s or the next message). */
+    sendChatAction(chatId: number | string, action?: string): Promise<void>;
+    /** Ack a callback query (stops the client-side spinner on the button). */
+    answerCallbackQuery(callbackQueryId: string, text?: string): Promise<void>;
+    /** Resolve a file_id to its download path + size. */
+    getFile(fileId: string): Promise<{
+        filePath?: string;
+        fileSize?: number;
+    }>;
+    /** Download a file previously resolved via `getFile`. */
+    downloadFile(filePath: string): Promise<Uint8Array>;
+};
+export type TelegramClient = ReturnType<typeof telegramApi>;
+//# sourceMappingURL=api.d.ts.map

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

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

package/dist/telegram/api.js

@@ -0,0 +1,170 @@
+/**
+ * Minimal Telegram Bot API client — just the methods a channel (and its host's
+ * admin surface) needs. JSON POSTs to `api.telegram.org/bot<token>/<method>`,
+ * `{ok, result, description}` unwrap, 10s timeout per call. No SDK.
+ */
+const DEFAULT_BASE_URL = "https://api.telegram.org";
+const DEFAULT_TIMEOUT_MS = 10_000;
+/** A failed Bot API call. `retryAfter` (seconds) is set on 429s. */
+export class TelegramApiError extends Error {
+    status;
+    retryAfter;
+    constructor(method, status, description, retryAfter) {
+        super(`telegram:${method} failed: ${description ?? `HTTP ${status}`}`);
+        this.name = "TelegramApiError";
+        this.status = status;
+        if (retryAfter !== undefined)
+            this.retryAfter = retryAfter;
+    }
+}
+/** Telegram's hard cap on `callback_data`. Over it, sendMessage 400s. */
+export const MAX_CALLBACK_DATA_BYTES = 64;
+/**
+ * Guard a `callback_data` payload against Telegram's 64-byte cap. Encoders call
+ * this so an over-long payload fails loudly at the call site instead of as an
+ * opaque 400 from an unrelated `sendMessage`.
+ */
+export function assertCallbackData(data) {
+    const bytes = new TextEncoder().encode(data).length;
+    if (bytes > MAX_CALLBACK_DATA_BYTES) {
+        throw new Error(`callback_data too long (${bytes} > ${MAX_CALLBACK_DATA_BYTES}): ${data}`);
+    }
+    return data;
+}
+function asObject(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+/** A bot-scoped client bound to one (possibly lazily resolved) token. */
+export function telegramApi(token, opts = {}) {
+    const base = opts.baseUrl ?? DEFAULT_BASE_URL;
+    const fetchImpl = opts.fetchImpl ?? fetch;
+    async function resolveToken() {
+        return typeof token === "function" ? token() : token;
+    }
+    async function call(method, body) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), opts.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+        try {
+            const res = await fetchImpl(`${base}/bot${await resolveToken()}/${method}`, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            const payload = (await res.json().catch(() => null));
+            if (!payload?.ok) {
+                throw new TelegramApiError(method, res.status, payload?.description, payload?.parameters?.retry_after);
+            }
+            return payload.result;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    return {
+        /** Validate the token and return the bot's identity. */
+        async getMe() {
+            const r = asObject(await call("getMe", {}));
+            if (typeof r.id !== "number" || typeof r.username !== "string") {
+                throw new Error("Telegram getMe returned an unexpected result.");
+            }
+            return {
+                id: r.id,
+                username: r.username,
+                firstName: typeof r.first_name === "string" ? r.first_name : "",
+            };
+        },
+        /** Point Telegram's webhook at `url`, guarded by `secretToken`. */
+        async setWebhook(input) {
+            const r = await call("setWebhook", {
+                url: input.url,
+                secret_token: input.secretToken,
+                allowed_updates: ["message", "callback_query"],
+                ...(input.dropPendingUpdates ? { drop_pending_updates: true } : {}),
+            });
+            if (r !== true)
+                throw new Error("Telegram setWebhook returned an unexpected result.");
+        },
+        async deleteWebhook() {
+            await call("deleteWebhook", {});
+        },
+        /**
+         * Publish the bot's command list — what Telegram shows in the "/" menu and
+         * autocompletes. Cosmetic: the commands work either way, but nothing else
+         * makes them discoverable. Call it whenever the webhook is (re-)registered.
+         */
+        async setMyCommands(commands) {
+            await call("setMyCommands", { commands });
+        },
+        async getWebhookInfo() {
+            const r = asObject(await call("getWebhookInfo", {}));
+            return {
+                url: typeof r.url === "string" ? r.url : "",
+                pendingUpdateCount: typeof r.pending_update_count === "number" ? r.pending_update_count : 0,
+                ...(typeof r.last_error_message === "string"
+                    ? { lastErrorMessage: r.last_error_message }
+                    : {}),
+                ...(typeof r.last_error_date === "number" ? { lastErrorDate: r.last_error_date } : {}),
+            };
+        },
+        /** Send a message; returns the new message id (cards are edited later by it). */
+        async sendMessage(input) {
+            const r = asObject(await call("sendMessage", { ...input }));
+            return { messageId: typeof r.message_id === "number" ? r.message_id : 0 };
+        },
+        /** Edit a previously sent message in place (the streaming primitive). */
+        async editMessageText(input) {
+            await call("editMessageText", { ...input });
+        },
+        /**
+         * Swap (or remove) just a message's inline keyboard. Used to re-tick
+         * multi-select options and to retire stale buttons — cheaper than
+         * `editMessageText` and it can't trip the "message is not modified" 400.
+         */
+        async editMessageReplyMarkup(input) {
+            await call("editMessageReplyMarkup", { ...input });
+        },
+        /** Show "typing…" in the chat (auto-expires after ~5s or the next message). */
+        async sendChatAction(chatId, action = "typing") {
+            await call("sendChatAction", { chat_id: chatId, action }).catch(() => {
+                /* cosmetic — never fail a turn over it */
+            });
+        },
+        /** Ack a callback query (stops the client-side spinner on the button). */
+        async answerCallbackQuery(callbackQueryId, text) {
+            await call("answerCallbackQuery", {
+                callback_query_id: callbackQueryId,
+                ...(text ? { text } : {}),
+            }).catch(() => {
+                /* best-effort — the approval still resolves */
+            });
+        },
+        /** Resolve a file_id to its download path + size. */
+        async getFile(fileId) {
+            const r = asObject(await call("getFile", { file_id: fileId }));
+            return {
+                ...(typeof r.file_path === "string" ? { filePath: r.file_path } : {}),
+                ...(typeof r.file_size === "number" ? { fileSize: r.file_size } : {}),
+            };
+        },
+        /** Download a file previously resolved via `getFile`. */
+        async downloadFile(filePath) {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), opts.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+            try {
+                const res = await fetchImpl(`${base}/file/bot${await resolveToken()}/${filePath}`, {
+                    signal: controller.signal,
+                });
+                if (!res.ok)
+                    throw new Error(`telegram file download failed: HTTP ${res.status}`);
+                return new Uint8Array(await res.arrayBuffer());
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        },
+    };
+}
+//# sourceMappingURL=api.js.map

package/dist/telegram/api.js.map

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

package/dist/telegram/format.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Telegram HTML for the cards the kernel asks the surface to post — approval
+ * prompts, questionnaire questions and their answered receipts.
+ */
+/** Compose the approval-prompt text (HTML) for a tool awaiting approval. */
+export declare function approvalPromptHtml(toolName: string, input: unknown): string;
+/** Button caption for an option — ticked marker for multi-select, length-capped. */
+export declare function optionButtonText(label: string, ticked?: boolean): string;
+/**
+ * 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 declare function questionPromptHtml(question: {
+    question: string;
+    header?: string;
+    options: {
+        label: string;
+        description: string;
+    }[];
+}, index: number, total: number): string;
+/** Collapse an answered question card to a one-line receipt. */
+export declare function answeredQuestionHtml(question: string, answer: string): string;
+/** Plain-text twin of a Telegram HTML card, for the entity-parse fallback. */
+export declare function htmlToPlain(html: string): string;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/telegram/format.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAS3E;AAKD,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAIxE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,EAClG,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,MAAM,CAYR;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhD"}

package/dist/telegram/format.js

@@ -0,0 +1,56 @@
+import { escapeHtml } from "./html.js";
+/**
+ * Telegram HTML for the cards the kernel asks the surface to post — approval
+ * prompts, questionnaire questions and their answered receipts.
+ */
+/** 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>`;
+}
+/** Plain-text twin of a Telegram HTML card, for the entity-parse fallback. */
+export function htmlToPlain(html) {
+    return html
+        .replace(/<[^>]+>/g, "")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&amp;/g, "&");
+}
+//# sourceMappingURL=format.js.map

package/dist/telegram/format.js.map

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

package/dist/telegram/html.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Best-effort GFM → Telegram HTML (parse_mode: "HTML"), same modest scope as
+ * the Slack adapter's `toMrkdwn`: bold, italic, strike, inline code, code
+ * fences, links. HTML is deliberately chosen over MarkdownV2 — MarkdownV2
+ * requires escaping 18 characters and partially streamed markdown breaks its
+ * parser, while unknown tags in HTML just error one edit (we then retry the
+ * edit as plain text).
+ */
+export declare function escapeHtml(text: string): string;
+export declare function gfmToTelegramHtml(gfm: string): string;
+//# sourceMappingURL=html.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/telegram/html.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAiBD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAYrD"}

package/dist/telegram/html.js

@@ -0,0 +1,35 @@
+/**
+ * Best-effort GFM → Telegram HTML (parse_mode: "HTML"), same modest scope as
+ * the Slack adapter's `toMrkdwn`: bold, italic, strike, inline code, code
+ * fences, links. HTML is deliberately chosen over MarkdownV2 — MarkdownV2
+ * requires escaping 18 characters and partially streamed markdown breaks its
+ * parser, while unknown tags in HTML just error one edit (we then retry the
+ * edit as plain text).
+ */
+export function escapeHtml(text) {
+    return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+/** Inline formatting on an already-escaped, fence-free segment. */
+function inline(escaped) {
+    return (escaped
+        // inline code first so its contents are not re-formatted
+        .replace(/`([^`\n]+)`/g, "<code>$1</code>")
+        .replace(/\*\*(.+?)\*\*/g, "<b>$1</b>")
+        .replace(/__(.+?)__/g, "<b>$1</b>")
+        .replace(/~~(.+?)~~/g, "<s>$1</s>")
+        // _italic_ only at word boundaries, so snake_case survives
+        .replace(/(^|[\s(])_([^_\n]+)_(?=$|[\s).,!?:;])/gm, "$1<i>$2</i>")
+        .replace(/\[([^\]]+)\]\((https?:\/\/[^)\s]+)\)/g, '<a href="$2">$1</a>'));
+}
+export function gfmToTelegramHtml(gfm) {
+    // Code fences become <pre>; everything else gets inline formatting. The
+    // language tag on the opening fence line is stripped inside the code segment
+    // (splitting on the bare fence keeps the closing fence's newline in prose).
+    const parts = gfm.split("```");
+    return parts
+        .map((part, i) => i % 2 === 1
+        ? `<pre>${escapeHtml(part.replace(/^[\w+-]*\n/, "").replace(/\n$/, ""))}</pre>`
+        : inline(escapeHtml(part)))
+        .join("");
+}
+//# sourceMappingURL=html.js.map

package/dist/telegram/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../src/telegram/html.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACjF,CAAC;AAED,mEAAmE;AACnE,SAAS,MAAM,CAAC,OAAe;IAC7B,OAAO,CACL,OAAO;QACL,yDAAyD;SACxD,OAAO,CAAC,cAAc,EAAE,iBAAiB,CAAC;SAC1C,OAAO,CAAC,gBAAgB,EAAE,WAAW,CAAC;SACtC,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC;SAClC,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC;QACnC,2DAA2D;SAC1D,OAAO,CAAC,yCAAyC,EAAE,aAAa,CAAC;SACjE,OAAO,CAAC,uCAAuC,EAAE,qBAAqB,CAAC,CAC3E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,wEAAwE;IACxE,6EAA6E;IAC7E,4EAA4E;IAC5E,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CACf,CAAC,GAAG,CAAC,KAAK,CAAC;QACT,CAAC,CAAC,QAAQ,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ;QAC/E,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAC7B;SACA,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

package/dist/telegram/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @intentface/latch-channels/telegram
+ *
+ * Bring a Latch agent to Telegram DMs: per-bot webhook handling (secret-token
+ * verified), the answer posted once at finish as HTML, inline-keyboard
+ * approvals and questionnaires, and media → multimodal file parts. A Surface
+ * over the turn kernel — identity, credentials and dedupe are injected by the
+ * host.
+ */
+export { telegramApi, TelegramApiError, type TelegramApiOptions, type TelegramBotInfo, type TelegramClient, type TelegramToken, type TelegramWebhookInfo, type InlineKeyboardButton, } from "./api.js";
+export { verifyTelegramSecretToken } from "./verify.js";
+export { escapeHtml, gfmToTelegramHtml } from "./html.js";
+export { approvalPromptHtml, questionPromptHtml, answeredQuestionHtml } from "./format.js";
+export { telegramChannel, telegramSurface, telegramChatId, parseTelegramChatId, encodeApprovalCallback, decodeApprovalCallback, type TelegramChannelConfig, type TelegramUser, type TgFileRef, } from "./telegramChannel.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telegram/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EACL,eAAe,EACf,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,SAAS,GACf,MAAM,sBAAsB,CAAC"}

package/dist/telegram/index.js

@@ -0,0 +1,15 @@
+/**
+ * @intentface/latch-channels/telegram
+ *
+ * Bring a Latch agent to Telegram DMs: per-bot webhook handling (secret-token
+ * verified), the answer posted once at finish as HTML, inline-keyboard
+ * approvals and questionnaires, and media → multimodal file parts. A Surface
+ * over the turn kernel — identity, credentials and dedupe are injected by the
+ * host.
+ */
+export { telegramApi, TelegramApiError, } from "./api.js";
+export { verifyTelegramSecretToken } from "./verify.js";
+export { escapeHtml, gfmToTelegramHtml } from "./html.js";
+export { approvalPromptHtml, questionPromptHtml, answeredQuestionHtml } from "./format.js";
+export { telegramChannel, telegramSurface, telegramChatId, parseTelegramChatId, encodeApprovalCallback, decodeApprovalCallback, } from "./telegramChannel.js";
+//# sourceMappingURL=index.js.map

package/dist/telegram/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telegram/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EACL,WAAW,EACX,gBAAgB,GAOjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EACL,eAAe,EACf,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,GAIvB,MAAM,sBAAsB,CAAC"}

package/dist/telegram/stream.d.ts

@@ -0,0 +1,59 @@
+import type { RenderEvent } from "../types.js";
+import { type TelegramClient } from "./api.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 declare const MAX_TELEGRAM_TEXT_CHARS = 4000;
+export declare const TELEGRAM_TEXT_TRUNCATION_NOTICE = "\n\n_Response truncated for Telegram. The full turn is available in Latch._";
+export interface TelegramStreamOptions {
+    api: Pick<TelegramClient, "sendMessage" | "editMessageText" | "sendChatAction">;
+    chatId: number | string;
+    maxChars?: number;
+    truncationNotice?: string;
+    minEditIntervalMs?: number;
+    minEditChars?: number;
+    /** Injectable clock/sleep for tests. */
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+}
+export interface TelegramStreamResult {
+    /** The full accumulated answer text (pre-truncation). */
+    text: string;
+    errorMessage?: string;
+    messageId?: number;
+}
+export declare function renderTelegramStream(events: AsyncIterable<RenderEvent>, opts: TelegramStreamOptions): Promise<TelegramStreamResult>;
+/** Compose the approval-prompt text (HTML) for a tool awaiting approval. */
+export declare function approvalPromptHtml(toolName: string, input: unknown): string;
+/** Button caption for an option — ticked marker for multi-select, length-capped. */
+export declare function optionButtonText(label: string, ticked?: boolean): string;
+/**
+ * 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 declare function questionPromptHtml(question: {
+    question: string;
+    header?: string;
+    options: {
+        label: string;
+        description: string;
+    }[];
+}, index: number, total: number): string;
+/** Collapse an answered question card to a one-line receipt. */
+export declare function answeredQuestionHtml(question: string, answer: string): string;
+//# sourceMappingURL=stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/telegram/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAGjE;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAC5C,eAAO,MAAM,+BAA+B,gFACmC,CAAC;AAEhF,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,aAAa,GAAG,iBAAiB,GAAG,gBAAgB,CAAC,CAAC;IAChF,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,EAClC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,oBAAoB,CAAC,CAiH/B;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAS3E;AAKD,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAIxE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,EAClG,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,MAAM,CAYR;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7E"}