@spinabot/brigade 1.1.0 → 1.2.0

package/dist/agents/channels/telegram/inbound-extras.js

@@ -0,0 +1,231 @@
+/**
+ * Pure extractors that turn a grammY `Message` into the normalized fields
+ * Brigade's `InboundMessage` carries. No network, no side effects — every
+ * function here is deterministic over its `Message` argument so they're trivial
+ * to unit-test without a live bot.
+ *
+ * The text / mention / media-detection logic is ported nearly verbatim from
+ * the reference Telegram extension (`bot/body-helpers.ts` +
+ * `bot-handlers.media.ts`); only brand tokens and the IR-engine dependency were
+ * scrubbed. Brigade's CENTRAL inbound pipeline owns the actual ACL / mention /
+ * routing decision — these helpers only surface the raw signals it reads
+ * (`mentions`, `threadId`, `replyTo`, chat type).
+ */
+/**
+ * Reject control-byte payloads (a binary blob masquerading as text). Tab / LF /
+ * CR are allowed; any other C0 control char marks the run as non-text and it's
+ * dropped so the agent never ingests raw binary. Ported from the reference
+ * `isBinaryContent`.
+ */
+function isBinaryContent(text) {
+    for (let i = 0; i < text.length; i++) {
+        const code = text.charCodeAt(i);
+        if (code <= 0x1f && code !== 0x09 && code !== 0x0a && code !== 0x0d) {
+            return true;
+        }
+    }
+    return false;
+}
+/** Pick the message's text body (prefers `text`, falls back to media `caption`). */
+function resolveTextContent(text, caption) {
+    const raw = typeof text === "string" ? text : typeof caption === "string" ? caption : "";
+    return isBinaryContent(raw) ? "" : raw;
+}
+/**
+ * The text + entities a message carries. Caption-bearing media surfaces its
+ * caption (and `caption_entities`) as the text. Empty text means no entities.
+ */
+export function getTelegramTextParts(msg) {
+    const text = resolveTextContent(msg.text, msg.caption);
+    const entities = text ? (msg.entities ?? msg.caption_entities ?? []) : [];
+    return { text, entities };
+}
+/**
+ * Rewrite Telegram `text_link` entities (hyperlinked display text) back into
+ * markdown `[label](url)` so the agent sees the destination URL. Applied
+ * right-to-left so earlier offsets stay valid as we splice. Ported from the
+ * reference `expandTextLinks`.
+ */
+function expandTextLinks(text, entities) {
+    if (!text || !entities?.length)
+        return text;
+    const textLinks = entities
+        .filter((e) => e.type === "text_link" && Boolean(e.url))
+        .slice()
+        .sort((a, b) => b.offset - a.offset);
+    if (textLinks.length === 0)
+        return text;
+    let result = text;
+    for (const entity of textLinks) {
+        const linkText = text.slice(entity.offset, entity.offset + entity.length);
+        const markdown = `[${linkText}](${entity.url})`;
+        result = result.slice(0, entity.offset) + markdown + result.slice(entity.offset + entity.length);
+    }
+    return result;
+}
+/** Extract the agent-facing plain text (caption-aware + text_link-expanded). */
+export function extractTelegramText(msg) {
+    const { text, entities } = getTelegramTextParts(msg);
+    return expandTextLinks(text, entities).trim();
+}
+/** Telegram chat kind → Brigade chat type. private → direct; group/supergroup → group. */
+export function telegramChatType(msg) {
+    const type = msg.chat?.type;
+    return type === "group" || type === "supergroup" ? "group" : "direct";
+}
+/** Forum-topic / thread id as a string, when the message belongs to one. */
+export function telegramThreadId(msg) {
+    const id = msg.message_thread_id;
+    return typeof id === "number" ? String(id) : undefined;
+}
+/** Lowercase a value, treating non-strings as "". */
+function lower(value) {
+    return typeof value === "string" ? value.toLowerCase() : "";
+}
+/** Word-char test for standalone @mention boundary detection. */
+function isMentionWordChar(char) {
+    return char != null && /[a-z0-9_]/i.test(char);
+}
+/** True when `mention` appears in `text` not glued to another word char. */
+function hasStandaloneMention(text, mention) {
+    let startIndex = 0;
+    while (startIndex < text.length) {
+        const idx = text.indexOf(mention, startIndex);
+        if (idx === -1)
+            return false;
+        const prev = idx > 0 ? text[idx - 1] : undefined;
+        const next = text[idx + mention.length];
+        if (!isMentionWordChar(prev) && !isMentionWordChar(next))
+            return true;
+        startIndex = idx + 1;
+    }
+    return false;
+}
+/**
+ * Channel-native ids of accounts addressed in this message. Brigade's central
+ * group ACL treats a group message as "addressed to the bot" when the bot's
+ * own id appears in `mentions`; without this a group message never reaches the
+ * agent. So when the bot's own `@username` is mentioned (as a `mention` entity
+ * OR a standalone `@username` in the text), we surface the bot's NUMERIC id
+ * (passed in from getMe) — that's the stable handle the pipeline matches
+ * against the linked self id.
+ *
+ * Other users' `text_mention` entities (which carry a real `user.id`) are also
+ * surfaced so the pipeline can see who else was tagged. Plain `@username`
+ * mentions of OTHER users are NOT resolvable to a numeric id from the message
+ * alone (Telegram doesn't include their id), so they're dropped rather than
+ * minting a fake id.
+ *
+ * @param botUserId  the bot's own numeric id (from getMe) as a string, used as
+ *                   the surfaced id when the bot is @-mentioned.
+ * @param botUsername the bot's own @username (without `@`), lower-cased match.
+ */
+export function extractTelegramMentions(msg, botUsername, botUserId) {
+    const { text, entities } = getTelegramTextParts(msg);
+    const out = [];
+    const seen = new Set();
+    const push = (id) => {
+        if (!id || seen.has(id))
+            return;
+        seen.add(id);
+        out.push(id);
+    };
+    const botHandle = botUsername ? lower(`@${botUsername}`) : "";
+    let botMentioned = false;
+    // text_mention entities carry a concrete user → surface that user's id.
+    for (const ent of entities) {
+        if (ent.type === "text_mention") {
+            const uid = ent.user?.id;
+            if (typeof uid === "number") {
+                const idStr = String(uid);
+                if (botUserId && idStr === botUserId)
+                    botMentioned = true;
+                else
+                    push(idStr);
+            }
+            continue;
+        }
+        if (ent.type === "mention" && botHandle) {
+            const slice = lower(text.slice(ent.offset, ent.offset + ent.length));
+            if (slice === botHandle)
+                botMentioned = true;
+        }
+    }
+    // Standalone "@botusername" anywhere in the text also counts as addressing.
+    if (botHandle && hasStandaloneMention(lower(text), botHandle))
+        botMentioned = true;
+    // A reply to one of the bot's own messages is an implicit address.
+    if (botUserId && typeof msg.reply_to_message?.from?.id === "number" && String(msg.reply_to_message.from.id) === botUserId) {
+        botMentioned = true;
+    }
+    if (botMentioned && botUserId)
+        push(botUserId);
+    return out;
+}
+/** Reply-context (what message this inbound quotes), when it's a reply. */
+export function extractTelegramReplyContext(msg) {
+    const reply = msg.reply_to_message;
+    if (!reply)
+        return undefined;
+    const messageId = typeof reply.message_id === "number" ? String(reply.message_id) : undefined;
+    const from = typeof reply.from?.id === "number" ? String(reply.from.id) : undefined;
+    const quotedText = extractTelegramText(reply);
+    const body = quotedText ? quotedText.slice(0, 280) : undefined; // bound LLM context
+    if (!messageId && !from && !body)
+        return undefined;
+    return { messageId, from, body };
+}
+/* ───────────────────────── media detection (ported) ───────────────────────── */
+/**
+ * Cheap presence probe — does this message carry a downloadable media envelope?
+ * Walks the same fields as the downloader but never touches the network, so the
+ * connection layer can DEFER the actual download until AFTER the central access
+ * gate admits the sender (mirrors WhatsApp's deferred-media discipline). Ported
+ * from the reference `bot-handlers.media.ts` `hasInboundMedia`.
+ */
+export function hasInboundMedia(msg) {
+    return (Boolean(msg.media_group_id) ||
+        (Array.isArray(msg.photo) && msg.photo.length > 0) ||
+        Boolean(msg.video ?? msg.video_note ?? msg.document ?? msg.audio ?? msg.voice ?? msg.sticker));
+}
+/**
+ * The `file_id` of the primary downloadable attachment (largest photo size /
+ * the single video / document / etc.). Ported from the reference
+ * `resolveInboundMediaFileId`. Returns undefined for a text-only message.
+ */
+export function resolveInboundMediaFileId(msg) {
+    return (msg.sticker?.file_id ??
+        msg.photo?.[msg.photo.length - 1]?.file_id ??
+        msg.video?.file_id ??
+        msg.video_note?.file_id ??
+        msg.document?.file_id ??
+        msg.audio?.file_id ??
+        msg.voice?.file_id);
+}
+/** The Brigade media-kind of the primary attachment, for the `InboundMediaAttachment.kind`. */
+export function resolveInboundMediaKind(msg) {
+    if (msg.sticker)
+        return "sticker";
+    if (Array.isArray(msg.photo) && msg.photo.length > 0)
+        return "image";
+    if (msg.video || msg.video_note)
+        return "video";
+    if (msg.voice)
+        return "voice";
+    if (msg.audio)
+        return "audio";
+    if (msg.document)
+        return "document";
+    return undefined;
+}
+/** A short display name for the sender (`First Last` or `@username`). */
+export function buildTelegramSenderName(msg) {
+    const from = msg.from;
+    if (!from)
+        return undefined;
+    const full = [from.first_name, from.last_name].filter(Boolean).join(" ").trim();
+    if (full)
+        return full;
+    return from.username ? `@${from.username}` : undefined;
+}
+//# sourceMappingURL=inbound-extras.js.map

package/dist/agents/channels/telegram/inbound-extras.js.map

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

package/dist/agents/channels/telegram/index.d.ts

@@ -0,0 +1,14 @@
+/** Telegram channel — public surface. */
+export { createTelegramAdapter, deriveTopicName, TELEGRAM_CAPABILITIES, type CreateTelegramAdapterOptions, } from "./adapter.js";
+export { listTelegramAccountIds, resolveTelegramAccount, resolveTelegramBotToken, telegramAutoLabelTopics, telegramChannelEnabled, telegramThreadIdleTtlMs, telegramWebhookConfig, TELEGRAM_BOT_TOKEN_ENV_VAR, TELEGRAM_CHANNEL_ID, TELEGRAM_DEFAULT_ACCOUNT_ID, type ResolvedTelegramAccount, type TelegramWebhookConfig, } from "./account-config.js";
+export { resolveTelegramAllowedUpdates, type ResolveTelegramAllowedUpdatesOptions, type TelegramAllowedUpdate, } from "./allowed-updates.js";
+export { buildTelegramApprovalKeyboard, buildTelegramApprovalText, sanitizeTelegramCallbackData, TELEGRAM_CALLBACK_DATA_MAX_BYTES, type TelegramInlineKeyboardMarkup, } from "./approval-native.js";
+export { resolveTelegramApprover } from "./approval-authorize.js";
+export { buildTelegramCommandMenu, normalizeTelegramCommandName, type TelegramBotCommand, } from "./command-menu.js";
+export { connectTelegram, isTelegramGetUpdatesConflict, isTelegramUnauthorized, redactTelegramToken, telegramBackoffDelay, type ConnectTelegramArgs, type TelegramBotIdentity, type TelegramConnection, type TelegramPollSpec, type TgInboundMessage, } from "./connection.js";
+export { markdownToTelegramHtml, telegramHtmlIsEmpty } from "./format.js";
+export { createTelegramPlugin, type TelegramPluginDeps, type TelegramPluginHandle } from "./plugin.js";
+export { probeTelegram, type TelegramProbeResult, type TelegramProbeIdentity } from "./probe.js";
+export { buildTelegramWebhookRoute, hasValidTelegramWebhookSecret, safeEqualSecret, TELEGRAM_WEBHOOK_SECRET_HEADER, } from "./webhook.js";
+export { telegramModule } from "./module.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/telegram/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAEzC,OAAO,EACN,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,KAAK,4BAA4B,GACjC,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,6BAA6B,EAC7B,KAAK,oCAAoC,EACzC,KAAK,qBAAqB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,6BAA6B,EAC7B,yBAAyB,EACzB,4BAA4B,EAC5B,gCAAgC,EAChC,KAAK,4BAA4B,GACjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EACN,wBAAwB,EACxB,4BAA4B,EAC5B,KAAK,kBAAkB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,eAAe,EACf,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvG,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EACN,yBAAyB,EACzB,6BAA6B,EAC7B,eAAe,EACf,8BAA8B,GAC9B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/agents/channels/telegram/index.js

@@ -0,0 +1,14 @@
+/** Telegram channel — public surface. */
+export { createTelegramAdapter, deriveTopicName, TELEGRAM_CAPABILITIES, } from "./adapter.js";
+export { listTelegramAccountIds, resolveTelegramAccount, resolveTelegramBotToken, telegramAutoLabelTopics, telegramChannelEnabled, telegramThreadIdleTtlMs, telegramWebhookConfig, TELEGRAM_BOT_TOKEN_ENV_VAR, TELEGRAM_CHANNEL_ID, TELEGRAM_DEFAULT_ACCOUNT_ID, } from "./account-config.js";
+export { resolveTelegramAllowedUpdates, } from "./allowed-updates.js";
+export { buildTelegramApprovalKeyboard, buildTelegramApprovalText, sanitizeTelegramCallbackData, TELEGRAM_CALLBACK_DATA_MAX_BYTES, } from "./approval-native.js";
+export { resolveTelegramApprover } from "./approval-authorize.js";
+export { buildTelegramCommandMenu, normalizeTelegramCommandName, } from "./command-menu.js";
+export { connectTelegram, isTelegramGetUpdatesConflict, isTelegramUnauthorized, redactTelegramToken, telegramBackoffDelay, } from "./connection.js";
+export { markdownToTelegramHtml, telegramHtmlIsEmpty } from "./format.js";
+export { createTelegramPlugin } from "./plugin.js";
+export { probeTelegram } from "./probe.js";
+export { buildTelegramWebhookRoute, hasValidTelegramWebhookSecret, safeEqualSecret, TELEGRAM_WEBHOOK_SECRET_HEADER, } from "./webhook.js";
+export { telegramModule } from "./module.js";
+//# sourceMappingURL=index.js.map

package/dist/agents/channels/telegram/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/agents/channels/telegram/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAEzC,OAAO,EACN,qBAAqB,EACrB,eAAe,EACf,qBAAqB,GAErB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,GAG3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,6BAA6B,GAG7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,6BAA6B,EAC7B,yBAAyB,EACzB,4BAA4B,EAC5B,gCAAgC,GAEhC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EACN,wBAAwB,EACxB,4BAA4B,GAE5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,eAAe,EACf,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,GAMpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAsD,MAAM,aAAa,CAAC;AACvG,OAAO,EAAE,aAAa,EAAwD,MAAM,YAAY,CAAC;AACjG,OAAO,EACN,yBAAyB,EACzB,6BAA6B,EAC7B,eAAe,EACf,8BAA8B,GAC9B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/agents/channels/telegram/media.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Telegram media helpers — inbound download + outbound InputFile construction.
+ *
+ * INBOUND: Telegram doesn't push file bytes; it pushes a `file_id`. To get the
+ * bytes we call `getFile(file_id)` (returns a short-lived `file_path`) then
+ * download `https://api.telegram.org/file/bot<token>/<file_path>`. Bytes are
+ * saved under `~/.brigade/channels/telegram/media/<YYYY-MM-DD>/<fileUid>.<ext>`
+ * so the agent can `read` the attachment by path. In convex mode the cache
+ * relocates to the OS cache dir (never under ~/.brigade, to respect the
+ * strict-zero guard).
+ *
+ * OUTBOUND: `buildTelegramInputFile` wraps a local path / Buffer in grammY's
+ * `InputFile`, after running it through Brigade's outbound media-path guard so
+ * a prompt-injected "send ~/.ssh/id_rsa" can't exfiltrate a secret.
+ *
+ * grammY is lazy-imported (only `InputFile` is needed, and only on the outbound
+ * path) so a non-Telegram boot never pays for the dependency.
+ */
+import { type InboundMediaAttachment, type OutboundMedia } from "../sdk.js";
+/**
+ * Telegram Bot API download cap is 20 MB; keep a defensive ceiling slightly
+ * under it. Anything larger is skipped (the message still reaches the agent
+ * without the attachment).
+ */
+declare const MAX_BYTES: number;
+/** The grammY surface the downloader needs — kept minimal + injectable for tests. */
+export interface TelegramBotFileApi {
+    /** Resolve a file_id to a downloadable `file_path` (grammY `bot.api.getFile`). */
+    getFile(fileId: string): Promise<{
+        file_path?: string;
+        file_unique_id?: string;
+        file_size?: number;
+    }>;
+}
+export interface DownloadTelegramMediaArgs {
+    /** The grammY file API (`bot.api`). */
+    bot: TelegramBotFileApi;
+    /** The attachment's `file_id` (from `resolveInboundMediaFileId`). */
+    fileId: string;
+    /** Brigade media kind — drives the default extension + the returned `kind`. */
+    kind: InboundMediaAttachment["kind"];
+    /** The Bot API token — needed to build the file download URL. NEVER logged. */
+    token: string;
+    /** Optional caption to carry through to the attachment. */
+    caption?: string;
+    /** Optional original filename (documents). */
+    fileName?: string;
+    /** Injectable fetch (defaults to global fetch) — lets tests stub the download. */
+    fetchImpl?: typeof fetch;
+    /** Logger so a failed download logs without crashing the inbound flow. */
+    log?: (msg: string, meta?: Record<string, unknown>) => void;
+}
+/**
+ * Download one inbound attachment to disk and return its normalized descriptor,
+ * or `null` when the file couldn't be fetched (too big / network error / no
+ * path). Never throws — a download glitch must not break message delivery.
+ */
+export declare function downloadTelegramMedia(args: DownloadTelegramMediaArgs): Promise<InboundMediaAttachment | null>;
+/**
+ * Wrap a local file path (or Buffer) in grammY's `InputFile` for an outbound
+ * send, after running the path through Brigade's outbound media-path guard.
+ * Throws a clear operator-facing error when the guard refuses the path (the
+ * `send_media` tool surfaces it). grammY is lazy-imported so this file never
+ * forces the dependency at module load.
+ */
+export declare function buildTelegramInputFile(media: OutboundMedia): Promise<unknown>;
+export { MAX_BYTES as TELEGRAM_MEDIA_MAX_BYTES };
+//# sourceMappingURL=media.d.ts.map

package/dist/agents/channels/telegram/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/telegram/media.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAUH,OAAO,EAEN,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,MAAM,WAAW,CAAC;AAInB;;;;GAIG;AACH,QAAA,MAAM,SAAS,QAAmB,CAAC;AAKnC,qFAAqF;AACrF,MAAM,WAAW,kBAAkB;IAClC,kFAAkF;IAClF,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtG;AAuCD,MAAM,WAAW,yBAAyB;IACzC,uCAAuC;IACvC,GAAG,EAAE,kBAAkB,CAAC;IACxB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACrC,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAC5D;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CA8CnH;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CASnF;AAED,OAAO,EAAE,SAAS,IAAI,wBAAwB,EAAE,CAAC"}

package/dist/agents/channels/telegram/media.js

@@ -0,0 +1,143 @@
+/**
+ * Telegram media helpers — inbound download + outbound InputFile construction.
+ *
+ * INBOUND: Telegram doesn't push file bytes; it pushes a `file_id`. To get the
+ * bytes we call `getFile(file_id)` (returns a short-lived `file_path`) then
+ * download `https://api.telegram.org/file/bot<token>/<file_path>`. Bytes are
+ * saved under `~/.brigade/channels/telegram/media/<YYYY-MM-DD>/<fileUid>.<ext>`
+ * so the agent can `read` the attachment by path. In convex mode the cache
+ * relocates to the OS cache dir (never under ~/.brigade, to respect the
+ * strict-zero guard).
+ *
+ * OUTBOUND: `buildTelegramInputFile` wraps a local path / Buffer in grammY's
+ * `InputFile`, after running it through Brigade's outbound media-path guard so
+ * a prompt-injected "send ~/.ssh/id_rsa" can't exfiltrate a secret.
+ *
+ * grammY is lazy-imported (only `InputFile` is needed, and only on the outbound
+ * path) so a non-Telegram boot never pays for the dependency.
+ */
+import { mkdirSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { resolveChannelStateDir, resolveOsCacheDir } from "../../../config/paths.js";
+import { tryGetRuntimeContext } from "../../../storage/runtime-context.js";
+// Channel SDK barrel — the outbound-media exfil guard + the OutboundMedia type
+// All contract types come from the channel SDK barrel so the channel is built
+// entirely on `../sdk.js`.
+import { validateOutboundMediaPath, } from "../sdk.js";
+const CHANNEL_ID = "telegram";
+/**
+ * Telegram Bot API download cap is 20 MB; keep a defensive ceiling slightly
+ * under it. Anything larger is skipped (the message still reaches the agent
+ * without the attachment).
+ */
+const MAX_BYTES = 20 * 1024 * 1024;
+/** Public Telegram Bot API base (file downloads hang off `/file/bot<token>/…`). */
+const TELEGRAM_API_BASE = "https://api.telegram.org";
+/** YYYY-MM-DD (UTC) bucket — stable filename grouping for grep / review. */
+function dayBucket() {
+    const d = new Date();
+    const pad = (x) => String(x).padStart(2, "0");
+    return `${d.getUTCFullYear()}-${pad(d.getUTCMonth() + 1)}-${pad(d.getUTCDate())}`;
+}
+/** Derive a file extension from a Telegram `file_path` (it usually has one). */
+function extFromFilePath(filePath, kind) {
+    if (filePath) {
+        const ext = path.extname(filePath).replace(/^\./, "").toLowerCase();
+        if (ext && /^[a-z0-9]+$/.test(ext))
+            return ext;
+    }
+    // Sensible default by kind when the path carried none.
+    switch (kind) {
+        case "image":
+            return "jpg";
+        case "video":
+            return "mp4";
+        case "voice":
+            return "ogg";
+        case "audio":
+            return "mp3";
+        case "sticker":
+            return "webp";
+        default:
+            return "bin";
+    }
+}
+/** Where downloaded media lands — OS cache in convex mode, channel-state dir otherwise. */
+function mediaBaseDir() {
+    return tryGetRuntimeContext()?.mode === "convex"
+        ? path.join(resolveOsCacheDir(), "channels", CHANNEL_ID)
+        : resolveChannelStateDir(CHANNEL_ID);
+}
+/**
+ * Download one inbound attachment to disk and return its normalized descriptor,
+ * or `null` when the file couldn't be fetched (too big / network error / no
+ * path). Never throws — a download glitch must not break message delivery.
+ */
+export async function downloadTelegramMedia(args) {
+    const { bot, fileId, kind, token, log } = args;
+    const doFetch = args.fetchImpl ?? fetch;
+    try {
+        const file = await bot.getFile(fileId);
+        const filePath = file?.file_path;
+        if (!filePath) {
+            log?.("telegram media skipped — getFile returned no file_path", { kind });
+            return null;
+        }
+        if (typeof file.file_size === "number" && file.file_size > MAX_BYTES) {
+            log?.("telegram media skipped — exceeds size cap", { kind, bytes: file.file_size, cap: MAX_BYTES });
+            return null;
+        }
+        const url = `${TELEGRAM_API_BASE}/file/bot${token}/${filePath}`;
+        const res = await doFetch(url);
+        if (!res.ok) {
+            log?.("telegram media download failed", { kind, status: res.status });
+            return null;
+        }
+        const buf = Buffer.from(await res.arrayBuffer());
+        if (buf.length === 0)
+            return null;
+        if (buf.length > MAX_BYTES) {
+            log?.("telegram media skipped — exceeds size cap", { kind, bytes: buf.length, cap: MAX_BYTES });
+            return null;
+        }
+        const dir = path.join(mediaBaseDir(), "media", dayBucket());
+        mkdirSync(dir, { recursive: true });
+        // file_unique_id is stable across re-deliveries; use it as the filename so
+        // the same media resolves idempotently. Fall back to file_id.
+        const baseName = (file.file_unique_id || fileId).replace(/[^A-Za-z0-9_-]/g, "_");
+        const dest = path.join(dir, `${baseName}.${extFromFilePath(filePath, kind)}`);
+        writeFileSync(dest, buf, { mode: 0o600 });
+        return {
+            kind,
+            path: dest,
+            fileName: args.fileName,
+            caption: args.caption,
+        };
+    }
+    catch (err) {
+        log?.("telegram media download failed", {
+            kind,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return null;
+    }
+}
+/**
+ * Wrap a local file path (or Buffer) in grammY's `InputFile` for an outbound
+ * send, after running the path through Brigade's outbound media-path guard.
+ * Throws a clear operator-facing error when the guard refuses the path (the
+ * `send_media` tool surfaces it). grammY is lazy-imported so this file never
+ * forces the dependency at module load.
+ */
+export async function buildTelegramInputFile(media) {
+    const verdict = validateOutboundMediaPath(media.path);
+    if (!verdict.ok) {
+        throw new Error(`Telegram: ${verdict.reason ?? "refusing to attach this file"}`);
+    }
+    const { InputFile } = await import("grammy");
+    // A local filesystem path — grammY streams it from disk. A filename override
+    // (documents) is honoured when provided.
+    return new InputFile(media.path, media.fileName);
+}
+export { MAX_BYTES as TELEGRAM_MEDIA_MAX_BYTES };
+//# sourceMappingURL=media.js.map

package/dist/agents/channels/telegram/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../../../src/agents/channels/telegram/media.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,+EAA+E;AAC/E,8EAA8E;AAC9E,2BAA2B;AAC3B,OAAO,EACN,yBAAyB,GAGzB,MAAM,WAAW,CAAC;AAEnB,MAAM,UAAU,GAAG,UAAU,CAAC;AAE9B;;;;GAIG;AACH,MAAM,SAAS,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEnC,mFAAmF;AACnF,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAQrD,4EAA4E;AAC5E,SAAS,SAAS;IACjB,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,GAAG,CAAC,CAAC,cAAc,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;AACnF,CAAC;AAED,gFAAgF;AAChF,SAAS,eAAe,CAAC,QAA4B,EAAE,IAAoC;IAC1F,IAAI,QAAQ,EAAE,CAAC;QACd,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACpE,IAAI,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;IAChD,CAAC;IACD,uDAAuD;IACvD,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,OAAO;YACX,OAAO,KAAK,CAAC;QACd,KAAK,OAAO;YACX,OAAO,KAAK,CAAC;QACd,KAAK,OAAO;YACX,OAAO,KAAK,CAAC;QACd,KAAK,OAAO;YACX,OAAO,KAAK,CAAC;QACd,KAAK,SAAS;YACb,OAAO,MAAM,CAAC;QACf;YACC,OAAO,KAAK,CAAC;IACf,CAAC;AACF,CAAC;AAED,2FAA2F;AAC3F,SAAS,YAAY;IACpB,OAAO,oBAAoB,EAAE,EAAE,IAAI,KAAK,QAAQ;QAC/C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC;QACxD,CAAC,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC;AACvC,CAAC;AAqBD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAA+B;IAC1E,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;IACxC,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,IAAI,EAAE,SAAS,CAAC;QACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,GAAG,EAAE,CAAC,wDAAwD,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1E,OAAO,IAAI,CAAC;QACb,CAAC;QACD,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,GAAG,SAAS,EAAE,CAAC;YACtE,GAAG,EAAE,CAAC,2CAA2C,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;YACpG,OAAO,IAAI,CAAC;QACb,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,iBAAiB,YAAY,KAAK,IAAI,QAAQ,EAAE,CAAC;QAChE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACb,GAAG,EAAE,CAAC,gCAAgC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YACtE,OAAO,IAAI,CAAC;QACb,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACjD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,IAAI,GAAG,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YAC5B,GAAG,EAAE,CAAC,2CAA2C,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;YAChG,OAAO,IAAI,CAAC;QACb,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5D,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,2EAA2E;QAC3E,8DAA8D;QAC9D,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,MAAM,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;QACjF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,IAAI,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9E,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1C,OAAO;YACN,IAAI;YACJ,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;SACrB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,GAAG,EAAE,CAAC,gCAAgC,EAAE;YACvC,IAAI;YACJ,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACvD,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,KAAoB;IAChE,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,aAAa,OAAO,CAAC,MAAM,IAAI,8BAA8B,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7C,6EAA6E;IAC7E,yCAAyC;IACzC,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED,OAAO,EAAE,SAAS,IAAI,wBAAwB,EAAE,CAAC"}

package/dist/agents/channels/telegram/module.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Telegram extension module.
+ *
+ * Registers the Telegram channel adapter through the seam. The loader gates it
+ * by the usual extension config (`extensions.disabled` / `entries`), and the
+ * adapter itself only starts when `channels.telegram.enabled` is true AND a bot
+ * token resolves — so bundling this module is inert until the operator opts in.
+ *
+ * In WEBHOOK transport mode (`channels.telegram.mode: "webhook"`) the module
+ * ALSO registers a gateway HTTP route that receives Telegram's update POSTs and
+ * feeds them into the started adapter (after verifying the secret-token header).
+ * Polling mode (the default) registers no HTTP surface.
+ */
+export declare const telegramModule: import("../sdk.js").BrigadeModule;
+//# sourceMappingURL=module.d.ts.map

package/dist/agents/channels/telegram/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/telegram/module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,eAAO,MAAM,cAAc,mCAmBzB,CAAC"}

package/dist/agents/channels/telegram/module.js

@@ -0,0 +1,36 @@
+/**
+ * Telegram extension module.
+ *
+ * Registers the Telegram channel adapter through the seam. The loader gates it
+ * by the usual extension config (`extensions.disabled` / `entries`), and the
+ * adapter itself only starts when `channels.telegram.enabled` is true AND a bot
+ * token resolves — so bundling this module is inert until the operator opts in.
+ *
+ * In WEBHOOK transport mode (`channels.telegram.mode: "webhook"`) the module
+ * ALSO registers a gateway HTTP route that receives Telegram's update POSTs and
+ * feeds them into the started adapter (after verifying the secret-token header).
+ * Polling mode (the default) registers no HTTP surface.
+ */
+import { defineModule } from "../sdk.js";
+import { telegramWebhookConfig } from "./account-config.js";
+import { createTelegramAdapter } from "./adapter.js";
+import { buildTelegramWebhookRoute } from "./webhook.js";
+export const telegramModule = defineModule({
+    id: "telegram",
+    register(b) {
+        const adapter = createTelegramAdapter();
+        b.channel(adapter);
+        // Webhook transport: register the inbound gateway route. The route resolves
+        // the SAME started adapter to feed updates into. Gated on config so a
+        // polling (default) install exposes no inbound HTTP surface.
+        const transport = telegramWebhookConfig(b.config);
+        if (transport.mode === "webhook") {
+            b.httpRoute(buildTelegramWebhookRoute({
+                path: transport.path,
+                secretToken: transport.secretToken,
+                resolveSink: () => adapter,
+            }));
+        }
+    },
+});
+//# sourceMappingURL=module.js.map

package/dist/agents/channels/telegram/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../../src/agents/channels/telegram/module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAwB,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;IAC1C,EAAE,EAAE,UAAU;IACd,QAAQ,CAAC,CAAC;QACT,MAAM,OAAO,GAAG,qBAAqB,EAAqB,CAAC;QAC3D,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnB,4EAA4E;QAC5E,sEAAsE;QACtE,6DAA6D;QAC7D,MAAM,SAAS,GAAG,qBAAqB,CAAC,CAAC,CAAC,MAAe,CAAC,CAAC;QAC3D,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAClC,CAAC,CAAC,SAAS,CACV,yBAAyB,CAAC;gBACzB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,WAAW,EAAE,SAAS,CAAC,WAAW;gBAClC,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO;aAC1B,CAAC,CACF,CAAC;QACH,CAAC;IACF,CAAC;CACD,CAAC,CAAC"}