@assemblyline-agents/telegram 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenEve contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,19 @@
+# @assemblyline-agents/telegram
+
+Official Assembly Line Telegram channel plugin.
+
+It exports `defineTelegramChannel(options)`, which ingests Telegram bot webhook updates and delivers agent replies through the Telegram Bot API, plus `defineTelegramConnection` for direct API access and channel tools for richer interactions. A bundled skill under `skills/` teaches agents Telegram-specific behavior.
+
+## Install
+
+```sh
+npm install @assemblyline-agents/telegram
+```
+
+## Part of Assembly Line
+
+This package is part of [Assembly Line](https://github.com/jasonbadeaux/openeve), a vendor-neutral, filesystem-first framework for durable AI agents. See the developer documentation in [docs/developers/](https://github.com/jasonbadeaux/openeve/tree/main/docs/developers) for setup, agent authoring, and deployment guides.
+
+## License
+
+MIT

package/dist/inbound.d.ts

@@ -0,0 +1,8 @@
+import type { JsonObject } from "@assemblyline-agents/core";
+export declare function telegramUpdateFromPayload(payload: JsonObject): {
+    type: string;
+    payload: JsonObject;
+} | undefined;
+export declare function telegramText(payload: JsonObject): string;
+export declare function telegramAttachments(payload: JsonObject, sourceId: string): JsonObject[];
+//# sourceMappingURL=inbound.d.ts.map

package/dist/inbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../src/inbound.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,2BAA2B,CAAC;AAGvE,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,GAAG,SAAS,CAMhH;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAIxD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CASvF"}

package/dist/inbound.js

@@ -0,0 +1,88 @@
+import { numberValue, recordValue, safeJson, stringValue } from "./util.js";
+export function telegramUpdateFromPayload(payload) {
+    for (const type of ["message", "edited_message", "callback_query", "channel_post", "business_message"]) {
+        const value = recordValue(payload[type]);
+        if (value)
+            return { type, payload: value };
+    }
+    return undefined;
+}
+export function telegramText(payload) {
+    const direct = stringValue(payload.text) ?? stringValue(payload.caption) ?? stringValue(payload.data);
+    const nested = recordValue(payload.message);
+    return direct ?? stringValue(nested?.text) ?? stringValue(nested?.caption) ?? "";
+}
+export function telegramAttachments(payload, sourceId) {
+    const attachments = [];
+    for (const key of ["photo", "document", "video", "audio", "voice", "sticker"]) {
+        const value = payload[key];
+        if (!value)
+            continue;
+        const info = telegramAttachmentInfo(key, value, sourceId);
+        attachments.push(info);
+    }
+    return attachments;
+}
+function telegramAttachmentInfo(kind, value, sourceId) {
+    const record = Array.isArray(value)
+        ? value.map(recordValue).filter(Boolean).at(-1)
+        : recordValue(value);
+    const fileId = stringValue(record?.file_id);
+    const filename = stringValue(record?.file_name) || telegramDefaultFilename(kind, sourceId, record);
+    const mimeType = stringValue(record?.mime_type) || telegramDefaultMimeType(kind, filename);
+    const attachment = {
+        provider: "telegram",
+        sourceId,
+        kind,
+        metadata: safeJson(value),
+        mimeType,
+        contentType: mimeType,
+        name: filename,
+        filename
+    };
+    if (fileId) {
+        attachment.id = fileId;
+        attachment.fileId = fileId;
+        attachment.telegramFileId = fileId;
+        attachment.remote = { provider: "telegram", auth: "telegram", trusted: true, fileId };
+    }
+    const size = numberValue(record?.file_size);
+    if (size !== undefined)
+        attachment.size = size;
+    return attachment;
+}
+function telegramDefaultFilename(kind, sourceId, record) {
+    if (kind === "photo")
+        return `telegram-photo-${sourceId}.jpg`;
+    if (kind === "voice")
+        return `telegram-voice-${sourceId}.ogg`;
+    if (kind === "sticker")
+        return `telegram-sticker-${sourceId}.webp`;
+    if (kind === "video")
+        return `telegram-video-${sourceId}.mp4`;
+    if (kind === "audio") {
+        const title = stringValue(record?.title);
+        return title ? `${title}.mp3` : `telegram-audio-${sourceId}.mp3`;
+    }
+    return `telegram-file-${sourceId}`;
+}
+function telegramDefaultMimeType(kind, filename) {
+    if (kind === "photo")
+        return "image/jpeg";
+    if (kind === "voice")
+        return "audio/ogg";
+    if (kind === "sticker")
+        return "image/webp";
+    if (kind === "video")
+        return "video/mp4";
+    if (kind === "audio")
+        return "audio/mpeg";
+    if (filename.endsWith(".md"))
+        return "text/markdown";
+    if (filename.endsWith(".txt"))
+        return "text/plain";
+    if (filename.endsWith(".zip"))
+        return "application/zip";
+    return "application/octet-stream";
+}
+//# sourceMappingURL=inbound.js.map

package/dist/inbound.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import { type ChannelDefinition, type JsonObject, type McpPluginConnectionOptions } from "@assemblyline-agents/core";
+import { type ChannelAttachmentRequest, type ChannelContext, type ChannelDelivery, type ChannelHttpRequest, type ChannelHttpResult, type ChannelTurn, type ChannelTurnLifecycle } from "@assemblyline-agents/runtime";
+export { defineTelegramCallbackAnswerTool, defineTelegramInlineKeyboardTool, defineTelegramMediaTool, telegramContextFromToolContext, telegramDestinationFromToolContext, type TelegramToolOptions } from "./tools.js";
+export type { TelegramDestination } from "./util.js";
+export declare const TELEGRAM_REQUIRED_ENV: readonly ["TELEGRAM_BOT_TOKEN"];
+export declare const TELEGRAM_OPTIONAL_ENV: readonly ["TELEGRAM_WEBHOOK_SECRET"];
+/** Production ingress-auth requirement (any-of groups): the webhook secret token. */
+export declare const TELEGRAM_INGRESS_SECRET_ENV: string[][];
+export type TelegramConnectionOptions = McpPluginConnectionOptions;
+export declare function defineTelegramConnection(options: TelegramConnectionOptions): import("@assemblyline-agents/core").McpHttpClientConnectionDefinition;
+export declare const openevePlugin: import("@assemblyline-agents/core").PluginModule;
+export interface TelegramChannelOptions {
+    route?: string;
+    description?: string;
+    methods?: string[];
+    connection?: string;
+    parseMode?: "MarkdownV2" | "HTML";
+    disableWebPagePreview?: boolean;
+    replyToMessage?: boolean;
+    allowedUpdates?: string[];
+    metadata?: JsonObject;
+}
+export declare function defineTelegramChannel(options?: TelegramChannelOptions): ChannelDefinition;
+/**
+ * Resolve a Telegram turn attachment (a Bot API `file_id`) into a download
+ * request through `getFile`. The runtime only calls this for turns this
+ * Telegram channel produced.
+ */
+export declare function resolveAttachment(attachment: JsonObject, ctx: ChannelContext): Promise<ChannelAttachmentRequest | undefined>;
+export declare function normalizeHttp(request: ChannelHttpRequest, ctx: ChannelContext): ChannelHttpResult;
+export declare function startTurn(turn: ChannelTurn, ctx: ChannelContext): ChannelTurnLifecycle;
+export declare function augmentContext(turn: ChannelTurn, ctx: ChannelContext): Promise<{
+    recentHistory?: string[];
+    channelContext?: JsonObject;
+} | void>;
+export declare function send(delivery: ChannelDelivery, ctx: ChannelContext): Promise<JsonObject>;
+export declare function setTelegramWebhook(ctx: Pick<ChannelContext, "env" | "fetch">, url: string, secretToken?: string): Promise<JsonObject>;
+export declare function deleteTelegramWebhook(ctx: Pick<ChannelContext, "env" | "fetch">): Promise<JsonObject>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoF,KAAK,iBAAiB,EAAE,KAAK,UAAU,EAAkB,KAAK,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvN,OAAO,EAAoG,KAAK,wBAAwB,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,KAAK,oBAAoB,EAA+C,MAAM,8BAA8B,CAAC;AAKrW,OAAO,EAAE,gCAAgC,EAAE,gCAAgC,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,kCAAkC,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACvN,YAAY,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAErD,eAAO,MAAM,qBAAqB,iCAAkC,CAAC;AACrE,eAAO,MAAM,qBAAqB,sCAAuC,CAAC;AAC1E,qFAAqF;AACrF,eAAO,MAAM,2BAA2B,EAAE,MAAM,EAAE,EAAkC,CAAC;AAErF,MAAM,MAAM,yBAAyB,GAAG,0BAA0B,CAAC;AACnE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,yEAE1E;AACD,eAAO,MAAM,aAAa,kDAA8D,CAAC;AAOzF,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAClC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,iBAAiB,CA2B7F;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC,CAiBlI;AAmBD,wBAAgB,aAAa,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,cAAc,GAAG,iBAAiB,CAkEjG;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,cAAc,GAAG,oBAAoB,CA0BtF;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC;IAAE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,CAAC,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAAC,CAqC3E;AAED,wBAAsB,IAAI,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAoB9F;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAM3I;AAED,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAE3G"}

package/dist/index.js

@@ -0,0 +1,318 @@
+import { connectionPluginMetadata, defineChannel, defineMcpPluginConnection, definePlugin } from "@assemblyline-agents/core";
+import { attachmentFetchTimeoutMs, attachmentTrustedForProvider, constantTimeSecretEqual, fetchWithPolicy } from "@assemblyline-agents/runtime";
+import { telegramAttachments, telegramText, telegramUpdateFromPayload } from "./inbound.js";
+import { sendTelegramMedia } from "./tools.js";
+import { attachmentSummary, compactJsonObject, numberValue, recordValue, safeJson, stringOrNumber, stringValue, telegramApi, telegramDestinationFromDelivery, telegramDestinationFromTurn, truncate } from "./util.js";
+export { defineTelegramCallbackAnswerTool, defineTelegramInlineKeyboardTool, defineTelegramMediaTool, telegramContextFromToolContext, telegramDestinationFromToolContext } from "./tools.js";
+export const TELEGRAM_REQUIRED_ENV = ["TELEGRAM_BOT_TOKEN"];
+export const TELEGRAM_OPTIONAL_ENV = ["TELEGRAM_WEBHOOK_SECRET"];
+/** Production ingress-auth requirement (any-of groups): the webhook secret token. */
+export const TELEGRAM_INGRESS_SECRET_ENV = [["TELEGRAM_WEBHOOK_SECRET"]];
+const TELEGRAM_CONNECTION_PLUGIN = connectionPluginMetadata("telegram");
+export function defineTelegramConnection(options) {
+    return defineMcpPluginConnection(TELEGRAM_CONNECTION_PLUGIN, options);
+}
+export const openevePlugin = definePlugin({ connections: [TELEGRAM_CONNECTION_PLUGIN] });
+const TELEGRAM_TYPING_REFRESH_MS = 4_000;
+const TELEGRAM_RECENT_HISTORY_LIMIT = 20;
+const TELEGRAM_RECENT_ACTIVITY_HOURS = 24;
+const TELEGRAM_RECENT_ACTIVITY_LIMIT = 3;
+const TELEGRAM_SUMMARY_MAX_CHARS = 240;
+export function defineTelegramChannel(options = {}) {
+    const definition = {
+        description: options.description ?? "Receive Telegram Bot API webhooks and deliver replies through sendMessage.",
+        transport: "http",
+        route: options.route ?? "/telegram/events",
+        methods: options.methods ?? ["POST"],
+        metadata: {
+            provider: "telegram",
+            telegram: compactJsonObject({
+                parseMode: options.parseMode,
+                disableWebPagePreview: options.disableWebPagePreview,
+                replyToMessage: options.replyToMessage,
+                allowedUpdates: options.allowedUpdates
+            }),
+            ...(options.metadata ?? {})
+        }
+    };
+    if (options.connection)
+        definition.connection = options.connection;
+    definition.ingress = { requiredSecretEnv: TELEGRAM_INGRESS_SECRET_ENV };
+    return Object.assign(defineChannel(definition), {
+        normalizeHttp,
+        startTurn,
+        augmentContext,
+        send,
+        resolveAttachment,
+        ingressAuth: { requiredSecretEnv: TELEGRAM_INGRESS_SECRET_ENV }
+    });
+}
+/**
+ * Resolve a Telegram turn attachment (a Bot API `file_id`) into a download
+ * request through `getFile`. The runtime only calls this for turns this
+ * Telegram channel produced.
+ */
+export async function resolveAttachment(attachment, ctx) {
+    const fileId = telegramFileIdFromAttachment(attachment);
+    if (!fileId)
+        return undefined;
+    const token = ctx.env.TELEGRAM_BOT_TOKEN;
+    if (!token)
+        return undefined;
+    const infoUrl = `https://api.telegram.org/bot${encodeURIComponent(token)}/getFile?file_id=${encodeURIComponent(fileId)}`;
+    const response = await fetchWithPolicy(ctx.fetch, infoUrl, {}, { timeoutMs: attachmentFetchTimeoutMs(ctx.env) });
+    const payload = recordValue(await response.json().catch(() => ({})));
+    if (!response.ok || payload?.ok !== true) {
+        throw new Error(`Telegram file lookup failed: ${response.status}`);
+    }
+    const filePath = stringValue(recordValue(payload.result)?.file_path);
+    if (!filePath)
+        throw new Error("Telegram file lookup did not return file_path.");
+    return {
+        url: `https://api.telegram.org/file/bot${encodeURIComponent(token)}/${filePath}`,
+        headers: {}
+    };
+}
+function telegramFileIdFromAttachment(attachment) {
+    if (!attachmentTrustedForProvider(attachment, "telegram"))
+        return undefined;
+    const direct = stringValue(attachment.telegramFileId) ?? stringValue(attachment.fileId);
+    const provider = stringValue(attachment.provider)?.toLowerCase();
+    const remoteProvider = stringValue(attachment.remoteProvider)?.toLowerCase();
+    if (direct && (provider === "telegram" || remoteProvider === "telegram"))
+        return direct;
+    const remote = recordValue(attachment.remote) ?? recordValue(attachment.download);
+    const remoteFileId = stringValue(remote?.fileId);
+    if (remoteFileId && (stringValue(remote?.provider)?.toLowerCase() === "telegram" || stringValue(remote?.auth)?.toLowerCase() === "telegram"))
+        return remoteFileId;
+    const metadata = attachment.metadata;
+    if (Array.isArray(metadata)) {
+        const record = metadata.map(recordValue).filter((value) => Boolean(value)).at(-1);
+        return stringValue(record?.file_id);
+    }
+    return stringValue(recordValue(metadata)?.file_id);
+}
+export function normalizeHttp(request, ctx) {
+    const expectedSecret = ctx.env.TELEGRAM_WEBHOOK_SECRET?.trim();
+    if (expectedSecret) {
+        const actualSecret = request.headers["x-telegram-bot-api-secret-token"];
+        if (!actualSecret || !constantTimeSecretEqual(actualSecret, expectedSecret)) {
+            return { kind: "response", status: 401, body: { ok: false, error: "invalid_telegram_secret" } };
+        }
+    }
+    const updateId = numberValue(request.body.update_id);
+    if (updateId === undefined)
+        return { kind: "response", status: 400, body: { ok: false, error: "missing_update_id" } };
+    const update = telegramUpdateFromPayload(request.body);
+    if (!update) {
+        return { kind: "ignored", status: 200, body: { ok: true, ignored: true, reason: "unsupported_update", updateId } };
+    }
+    const chat = recordValue(update.payload.chat) ?? recordValue(recordValue(update.payload.message)?.chat);
+    const from = recordValue(update.payload.from) ?? recordValue(recordValue(update.payload.message)?.from);
+    const messageId = numberValue(update.payload.message_id) ?? numberValue(recordValue(update.payload.message)?.message_id);
+    const chatId = stringOrNumber(chat?.id);
+    const userId = stringOrNumber(from?.id);
+    if (!chatId)
+        return { kind: "ignored", status: 200, body: { ok: true, ignored: true, reason: "missing_chat_id", updateId } };
+    const threadId = numberValue(update.payload.message_thread_id) ?? numberValue(recordValue(update.payload.message)?.message_thread_id);
+    const conversationId = threadId === undefined
+        ? `telegram:chat:${chatId}`
+        : `telegram:chat:${chatId}:thread:${threadId}`;
+    const text = telegramText(update.payload);
+    const attachments = telegramAttachments(update.payload, String(updateId));
+    const turn = {
+        eventId: String(updateId),
+        channel: ctx.channel.name,
+        conversationId,
+        message: text || attachmentSummary(attachments) || "Telegram update",
+        attachments,
+        delivery: compactJsonObject({
+            provider: "telegram",
+            chatId,
+            messageId,
+            threadId,
+            callbackQueryId: stringValue(update.payload.id)
+        }),
+        metadata: {
+            provider: "telegram",
+            telegram: compactJsonObject({
+                updateId,
+                updateType: update.type,
+                chatId,
+                userId,
+                messageId,
+                threadId,
+                raw: safeJson(update.payload)
+            })
+        }
+    };
+    if (userId)
+        turn.userId = userId;
+    return {
+        kind: "accepted",
+        status: 200,
+        body: { ok: true, accepted: true, provider: "telegram" },
+        idempotencyKey: String(updateId),
+        idempotencyScope: `channel:${ctx.channel.name}:telegram`,
+        turn
+    };
+}
+export function startTurn(turn, ctx) {
+    const destination = telegramDestinationFromTurn(turn);
+    if (!destination.chatId)
+        return {};
+    let stopped = false;
+    const controller = new AbortController();
+    const sendTyping = () => telegramApi(ctx, "sendChatAction", compactJsonObject({
+        chat_id: destination.chatId,
+        message_thread_id: destination.threadId,
+        action: "typing"
+    })).catch(() => undefined);
+    void sendTyping();
+    const loop = (async () => {
+        while (!controller.signal.aborted) {
+            await sleep(TELEGRAM_TYPING_REFRESH_MS, controller.signal).catch(() => undefined);
+            if (!controller.signal.aborted)
+                await sendTyping();
+        }
+    })();
+    return {
+        async stop() {
+            if (stopped)
+                return { provider: "telegram", typing: "already-stopped" };
+            stopped = true;
+            controller.abort();
+            await loop.catch(() => undefined);
+            return { provider: "telegram", typing: "stopped" };
+        }
+    };
+}
+export async function augmentContext(turn, ctx) {
+    const recentHistory = (await ctx.state.listRecentMessages(turn.conversationId, TELEGRAM_RECENT_HISTORY_LIMIT)).map(messageHistoryLine);
+    const since = new Date(Date.now() - TELEGRAM_RECENT_ACTIVITY_HOURS * 60 * 60 * 1000).toISOString();
+    const relatedConversations = turn.userId && ctx.state.listRecentConversationsBySubject
+        ? await ctx.state.listRecentConversationsBySubject({
+            channel: turn.channel,
+            subject: turn.userId,
+            since,
+            limit: TELEGRAM_RECENT_ACTIVITY_LIMIT,
+            excludeId: turn.conversationId
+        })
+        : [];
+    const related = await Promise.all(relatedConversations.map((conversation) => summarizeConversation(ctx, conversation)));
+    const telegram = recordValue(turn.metadata?.telegram);
+    return {
+        recentHistory,
+        channelContext: compactJsonObject({
+            provider: "telegram",
+            chatId: stringValue(telegram?.chatId),
+            userId: stringValue(telegram?.userId),
+            messageId: numberValue(telegram?.messageId),
+            threadId: numberValue(telegram?.threadId),
+            updateType: stringValue(telegram?.updateType),
+            currentConversation: {
+                id: turn.conversationId,
+                userId: turn.userId ?? null,
+                eventId: turn.eventId
+            },
+            relatedConversations: related,
+            contextPolicy: {
+                source: "openeve_state",
+                maxRelatedConversations: TELEGRAM_RECENT_ACTIVITY_LIMIT,
+                maxAgeHours: TELEGRAM_RECENT_ACTIVITY_HOURS,
+                note: "Related Telegram context is bounded to this user's recent OpenEve conversations and contains summaries, not Telegram-wide chat history."
+            }
+        })
+    };
+}
+export async function send(delivery, ctx) {
+    const destination = telegramDestinationFromDelivery(delivery);
+    const chatId = destination.chatId;
+    if (!chatId)
+        throw new Error("Telegram delivery requires chatId.");
+    const media = recordValue(delivery.payload.media) ?? recordValue(recordValue(delivery.payload.delivery)?.media);
+    if (media)
+        return sendTelegramMedia(ctx, destination, media, delivery);
+    const body = compactJsonObject({
+        chat_id: chatId,
+        text: delivery.response.trim() || "Done.",
+        disable_web_page_preview: telegramDisableWebPagePreview(ctx),
+        reply_markup: recordValue(delivery.payload.replyMarkup) ?? recordValue(delivery.payload.reply_markup)
+    });
+    const parseMode = telegramParseMode(ctx, delivery.payload);
+    if (parseMode)
+        body.parse_mode = parseMode;
+    const threadId = destination.threadId;
+    if (threadId !== undefined)
+        body.message_thread_id = threadId;
+    const replyTo = telegramShouldReply(ctx, delivery.payload) ? destination.messageId : undefined;
+    if (replyTo !== undefined)
+        body.reply_parameters = { message_id: replyTo };
+    const response = await telegramApi(ctx, "sendMessage", body);
+    return { provider: "telegram", message: safeJson(response) };
+}
+export async function setTelegramWebhook(ctx, url, secretToken) {
+    const body = { url };
+    if (secretToken)
+        body.secret_token = secretToken;
+    const allowedUpdates = ctx.env.TELEGRAM_ALLOWED_UPDATES?.split(",").map((item) => item.trim()).filter(Boolean);
+    if (allowedUpdates?.length)
+        body.allowed_updates = allowedUpdates;
+    return telegramApi(ctx, "setWebhook", body);
+}
+export async function deleteTelegramWebhook(ctx) {
+    return telegramApi(ctx, "deleteWebhook", {});
+}
+function telegramParseMode(ctx, payload) {
+    return stringValue(payload.parseMode) ??
+        stringValue(payload.parse_mode) ??
+        stringValue(recordValue(ctx.channel.metadata?.telegram)?.parseMode) ??
+        ctx.env.TELEGRAM_PARSE_MODE;
+}
+function telegramDisableWebPagePreview(ctx) {
+    const configured = recordValue(ctx.channel.metadata?.telegram)?.disableWebPagePreview;
+    if (typeof configured === "boolean")
+        return configured;
+    return ctx.env.TELEGRAM_DISABLE_WEB_PAGE_PREVIEW === "1" || ctx.env.TELEGRAM_DISABLE_WEB_PAGE_PREVIEW === "true";
+}
+function telegramShouldReply(ctx, payload) {
+    const explicit = payload.replyToMessage ?? payload.reply_to_message;
+    if (typeof explicit === "boolean")
+        return explicit;
+    const configured = recordValue(ctx.channel.metadata?.telegram)?.replyToMessage;
+    if (typeof configured === "boolean")
+        return configured;
+    return true;
+}
+async function summarizeConversation(ctx, conversation) {
+    const messages = await ctx.state.listRecentMessages(conversation.id, 8);
+    const latestUser = latestText(messages, "user");
+    const latestAssistant = latestText(messages, "assistant");
+    return compactJsonObject({
+        conversationId: conversation.id,
+        updatedAt: conversation.updatedAt,
+        latestUser,
+        latestAssistant
+    });
+}
+function latestText(messages, role) {
+    const message = [...messages].reverse().find((candidate) => candidate.role === role);
+    const text = typeof message?.content.text === "string" ? message.content.text : undefined;
+    return text ? truncate(text, TELEGRAM_SUMMARY_MAX_CHARS) : undefined;
+}
+function messageHistoryLine(message) {
+    const text = typeof message.content.text === "string" ? message.content.text : JSON.stringify(message.content);
+    return `${message.role}: ${text}`;
+}
+function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        const timeout = setTimeout(resolve, ms);
+        if (signal) {
+            signal.addEventListener("abort", () => {
+                clearTimeout(timeout);
+                resolve();
+            }, { once: true });
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,14 @@
+import { type ApprovalPolicy, type JsonObject, type ToolDefinition, type ToolExecutionContext } from "@assemblyline-agents/core";
+import type { ChannelContext, ChannelDelivery } from "@assemblyline-agents/runtime";
+import { type TelegramDestination } from "./util.js";
+export interface TelegramToolOptions {
+    description?: string;
+    needsApproval?: boolean | ApprovalPolicy;
+}
+export declare function telegramDestinationFromToolContext(ctx: ToolExecutionContext): TelegramDestination;
+export declare function telegramContextFromToolContext(ctx: ToolExecutionContext): Pick<ChannelContext, "env" | "fetch">;
+export declare function defineTelegramInlineKeyboardTool(options?: TelegramToolOptions): ToolDefinition;
+export declare function defineTelegramCallbackAnswerTool(options?: TelegramToolOptions): ToolDefinition;
+export declare function defineTelegramMediaTool(options?: TelegramToolOptions): ToolDefinition;
+export declare function sendTelegramMedia(ctx: Pick<ChannelContext, "env" | "fetch">, destination: TelegramDestination, media: JsonObject, delivery: Pick<ChannelDelivery, "response">): Promise<JsonObject>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC7I,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAe,MAAM,8BAA8B,CAAC;AACjG,OAAO,EAAyF,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAE5I,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;CAC1C;AAED,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,oBAAoB,GAAG,mBAAmB,CAIjG;AAED,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,oBAAoB,GAAG,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,OAAO,CAAC,CAI/G;AAED,wBAAgB,gCAAgC,CAAC,OAAO,GAAE,mBAAwB,GAAG,cAAc,CA+ClG;AAED,wBAAgB,gCAAgC,CAAC,OAAO,GAAE,mBAAwB,GAAG,cAAc,CAwBlG;AAED,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,mBAAwB,GAAG,cAAc,CA6BzF;AAQD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,OAAO,CAAC,EAC1C,WAAW,EAAE,mBAAmB,EAChC,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,GAC1C,OAAO,CAAC,UAAU,CAAC,CAiBrB"}

package/dist/tools.js

@@ -0,0 +1,169 @@
+import { defineTool } from "@assemblyline-agents/core";
+import { compactJsonObject, recordValue, stringValue, telegramApi, telegramDestinationFromTurn } from "./util.js";
+export function telegramDestinationFromToolContext(ctx) {
+    const turn = ctx.channel?.turn;
+    if (!turn)
+        throw new Error("Telegram tools require a Telegram channel turn in context.");
+    return telegramDestinationFromTurn(turn);
+}
+export function telegramContextFromToolContext(ctx) {
+    const channel = ctx.channel;
+    if (!channel)
+        throw new Error("Telegram tools require a channel-scoped run.");
+    return { env: channel.env, fetch: channel.fetch ?? fetch };
+}
+export function defineTelegramInlineKeyboardTool(options = {}) {
+    return withToolDefaults(defineTool({
+        description: "Send a Telegram message with an inline keyboard in the current conversation.",
+        sideEffect: "external",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                text: { type: "string", description: "Message text to send with the inline keyboard." },
+                buttons: {
+                    type: "array",
+                    description: "Rows of inline keyboard buttons.",
+                    items: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            additionalProperties: false,
+                            properties: {
+                                text: { type: "string" },
+                                callbackData: { type: "string" },
+                                url: { type: "string" }
+                            },
+                            required: ["text"]
+                        }
+                    }
+                }
+            },
+            required: ["text", "buttons"]
+        },
+        async execute(input, ctx) {
+            const request = input;
+            const transport = telegramContextFromToolContext(ctx);
+            const destination = telegramDestinationFromToolContext(ctx);
+            if (!destination.chatId)
+                throw new Error("Telegram inline keyboard requires a chatId.");
+            const inlineKeyboard = request.buttons.map((row) => row.map((button) => compactJsonObject({
+                text: button.text,
+                callback_data: button.callbackData,
+                url: button.url
+            })));
+            return telegramApi(transport, "sendMessage", compactJsonObject({
+                chat_id: destination.chatId,
+                message_thread_id: destination.threadId,
+                text: request.text,
+                reply_markup: { inline_keyboard: inlineKeyboard }
+            }));
+        }
+    }), options);
+}
+export function defineTelegramCallbackAnswerTool(options = {}) {
+    return withToolDefaults(defineTool({
+        description: "Answer the current Telegram callback query.",
+        sideEffect: "external",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                text: { type: "string", description: "Short callback answer text." },
+                showAlert: { type: "boolean", description: "Whether Telegram should show the answer as an alert." }
+            }
+        },
+        async execute(input, ctx) {
+            const request = input;
+            const transport = telegramContextFromToolContext(ctx);
+            const destination = telegramDestinationFromToolContext(ctx);
+            if (!destination.callbackQueryId)
+                throw new Error("Telegram callback answer requires callbackQueryId.");
+            return telegramApi(transport, "answerCallbackQuery", compactJsonObject({
+                callback_query_id: destination.callbackQueryId,
+                text: request.text,
+                show_alert: request.showAlert
+            }));
+        }
+    }), options);
+}
+export function defineTelegramMediaTool(options = {}) {
+    return withToolDefaults(defineTool({
+        description: "Send Telegram media to the current conversation.",
+        sideEffect: "external",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                kind: { type: "string", enum: ["photo", "document", "audio", "video", "voice"] },
+                mediaUrl: { type: "string", description: "Telegram-readable URL or file id." },
+                caption: { type: "string" }
+            },
+            required: ["kind", "mediaUrl"]
+        },
+        async execute(input, ctx) {
+            const request = input;
+            const transport = telegramContextFromToolContext(ctx);
+            const destination = telegramDestinationFromToolContext(ctx);
+            const delivery = {
+                id: ctx.idempotencyKey(`telegram:media:${request.kind}:${request.mediaUrl}`),
+                runId: "",
+                channel: "telegram",
+                response: request.caption ?? "",
+                payload: { media: request },
+                idempotencyKey: ctx.idempotencyKey(`telegram:media:${request.kind}:${request.mediaUrl}`)
+            };
+            return sendTelegramMedia(transport, destination, compactJsonObject({ kind: request.kind, mediaUrl: request.mediaUrl, caption: request.caption }), delivery);
+        }
+    }), options);
+}
+function withToolDefaults(definition, options) {
+    if (options.description)
+        definition.description = options.description;
+    if (options.needsApproval !== undefined)
+        definition.needsApproval = options.needsApproval;
+    return definition;
+}
+export async function sendTelegramMedia(ctx, destination, media, delivery) {
+    if (!destination.chatId)
+        throw new Error("Telegram media delivery requires chatId.");
+    const kind = stringValue(media.kind) ?? "document";
+    const method = telegramMediaMethod(kind);
+    const mediaField = telegramMediaField(kind);
+    const mediaUrl = stringValue(media.mediaUrl) ?? stringValue(media.url) ?? stringValue(media.fileId);
+    if (!mediaUrl)
+        throw new Error("Telegram media delivery requires mediaUrl or fileId.");
+    const caption = stringValue(media.caption) ?? (delivery.response.trim() || undefined);
+    const body = compactJsonObject({
+        chat_id: destination.chatId,
+        message_thread_id: destination.threadId,
+        [mediaField]: mediaUrl,
+        caption,
+        reply_parameters: destination.messageId !== undefined ? { message_id: destination.messageId } : undefined,
+        reply_markup: recordValue(media.replyMarkup) ?? recordValue(media.reply_markup)
+    });
+    return telegramApi(ctx, method, body);
+}
+function telegramMediaMethod(kind) {
+    if (kind === "photo")
+        return "sendPhoto";
+    if (kind === "audio")
+        return "sendAudio";
+    if (kind === "video")
+        return "sendVideo";
+    if (kind === "voice")
+        return "sendVoice";
+    return "sendDocument";
+}
+function telegramMediaField(kind) {
+    if (kind === "photo")
+        return "photo";
+    if (kind === "audio")
+        return "audio";
+    if (kind === "video")
+        return "video";
+    if (kind === "voice")
+        return "voice";
+    return "document";
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/util.d.ts

@@ -0,0 +1,20 @@
+import type { JsonObject, JsonValue } from "@assemblyline-agents/core";
+import { type ChannelContext, type ChannelDelivery, type ChannelTurn } from "@assemblyline-agents/runtime";
+export interface TelegramDestination {
+    chatId?: string;
+    messageId?: number;
+    threadId?: number;
+    callbackQueryId?: string;
+}
+export declare function telegramDestinationFromDelivery(delivery: ChannelDelivery): TelegramDestination;
+export declare function telegramDestinationFromTurn(turn: ChannelTurn): TelegramDestination;
+export declare function telegramApi(ctx: Pick<ChannelContext, "env" | "fetch">, method: string, body: JsonObject): Promise<JsonObject>;
+export declare function attachmentSummary(attachments: JsonObject[]): string;
+export declare function truncate(value: string, maxChars: number): string;
+export declare function stringValue(value: unknown): string | undefined;
+export declare function numberValue(value: unknown): number | undefined;
+export declare function stringOrNumber(value: unknown): string | undefined;
+export declare function recordValue(value: unknown): JsonObject | undefined;
+export declare function compactJsonObject(input: Record<string, unknown>): JsonObject;
+export declare function safeJson(value: unknown): JsonValue;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAmB,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE5H,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,eAAe,GAAG,mBAAmB,CAG9F;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,WAAW,GAAG,mBAAmB,CAElF;AAeD,wBAAsB,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAcnI;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAGnE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE9D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE9D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIjE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAElE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAM5E;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CASlD"}

package/dist/util.js

@@ -0,0 +1,100 @@
+import { fetchWithPolicy } from "@assemblyline-agents/runtime";
+export function telegramDestinationFromDelivery(delivery) {
+    const target = recordValue(delivery.turn?.delivery) ?? recordValue(delivery.payload.delivery);
+    return telegramDestinationFromRecord(target);
+}
+export function telegramDestinationFromTurn(turn) {
+    return telegramDestinationFromRecord(recordValue(turn.delivery));
+}
+function telegramDestinationFromRecord(target) {
+    const destination = {};
+    const chatId = stringValue(target?.chatId);
+    const messageId = numberValue(target?.messageId);
+    const threadId = numberValue(target?.threadId);
+    const callbackQueryId = stringValue(target?.callbackQueryId);
+    if (chatId)
+        destination.chatId = chatId;
+    if (messageId !== undefined)
+        destination.messageId = messageId;
+    if (threadId !== undefined)
+        destination.threadId = threadId;
+    if (callbackQueryId)
+        destination.callbackQueryId = callbackQueryId;
+    return destination;
+}
+export async function telegramApi(ctx, method, body) {
+    const token = ctx.env.TELEGRAM_BOT_TOKEN;
+    if (!token)
+        throw new Error("Telegram Bot API requires TELEGRAM_BOT_TOKEN.");
+    // Telegram flood control sends 429 with both a Retry-After header and `parameters.retry_after` in the
+    // JSON body. fetchWithPolicy retries before the body is readable, so we honor the header (same value)
+    // and keep body parsing below for error messages on the final response.
+    const response = await fetchWithPolicy(ctx.fetch, `https://api.telegram.org/bot${encodeURIComponent(token)}/${method}`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(body)
+    });
+    const parsed = await parseJson(response);
+    if (!response.ok)
+        throw new Error(`Telegram ${method} failed: ${response.status} ${JSON.stringify(parsed)}`);
+    return safeJson(parsed);
+}
+export function attachmentSummary(attachments) {
+    if (attachments.length === 0)
+        return "";
+    return attachments.map((attachment) => `[${String(attachment.kind ?? "attachment")}]`).join(" ");
+}
+export function truncate(value, maxChars) {
+    if (value.length <= maxChars)
+        return value;
+    return `${value.slice(0, Math.max(0, maxChars - 1))}...`;
+}
+export function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+export function numberValue(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+export function stringOrNumber(value) {
+    if (typeof value === "string" && value.length > 0)
+        return value;
+    if (typeof value === "number" && Number.isFinite(value))
+        return String(value);
+    return undefined;
+}
+export function recordValue(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value)) ? value : undefined;
+}
+export function compactJsonObject(input) {
+    const out = {};
+    for (const [key, value] of Object.entries(input)) {
+        if (value !== undefined)
+            out[key] = safeJson(value);
+    }
+    return out;
+}
+export function safeJson(value) {
+    if (value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean")
+        return value;
+    if (Array.isArray(value))
+        return value.map(safeJson);
+    if (value && typeof value === "object") {
+        const out = {};
+        for (const [key, child] of Object.entries(value))
+            out[key] = safeJson(child);
+        return out;
+    }
+    return null;
+}
+async function parseJson(response) {
+    const text = await response.text();
+    if (!text)
+        return {};
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return { text };
+    }
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@assemblyline-agents/telegram",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@assemblyline-agents/core": "0.1.0",
+    "@assemblyline-agents/runtime": "0.1.0"
+  },
+  "description": "Official OpenEve Telegram channel plugin.",
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jasonbadeaux/openeve.git",
+    "directory": "packages/telegram"
+  },
+  "bugs": {
+    "url": "https://github.com/jasonbadeaux/openeve/issues"
+  },
+  "homepage": "https://github.com/jasonbadeaux/openeve#readme",
+  "author": "OpenEve contributors",
+  "keywords": [
+    "openeve",
+    "ai",
+    "agents",
+    "telegram",
+    "channel",
+    "chatbot",
+    "plugin"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/skills/telegram/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: telegram
+description: Use a configured Telegram MCP bridge for read-only account and message context.
+---
+# Telegram
+Use bounded chat and date filters. Avoid repeating sensitive message content outside the requested task.
+
+The deployment owner configures the Telegram session and `TELEGRAM_MCP_URL`; Assembly Line does not enroll or host an MTProto session. This plugin exposes read-classified tools only.