@rubytech/create-maxy-code 0.1.579 → 0.1.580

package/payload/platform/plugins/telegram/mcp/dist/tools/schemas.js

@@ -0,0 +1,400 @@
+import { z } from "zod";
+/** The typed tool schemas, in their own module so they can be tested.
+ *
+ *  They cannot be tested through index.ts: that file runs
+ *  `await server.connect(transport)` at module top level, so importing it in a
+ *  test hangs (the hazard lib/secret-path.ts:9-12 already records). Task 2588's
+ *  central claim is that a malformed call is rejected HERE rather than by
+ *  Telegram's 400, and a claim with no test is not a claim.
+ *
+ *  Each `.describe()` is the model's only documentation for that field, so it
+ *  says what the field is FOR, not merely what type it is. */
+const BOT_ID = z
+    .string()
+    .describe("Which registered bot to act as (its numeric Telegram id, the token's colon-prefix). Never a raw token: the token is resolved from the account, so it never crosses this boundary. On a miss the error lists every bot registered here.");
+const CHAT_ID = z
+    .union([z.string(), z.number()])
+    .describe("Telegram chat ID, or an @username. Telegram documents both.");
+/** Inline keyboard rows, shared by every tool that can attach buttons. One
+ *  definition rather than one per shape: a button that behaved differently on
+ *  a poll than on a card would be a difference nobody intended. */
+const BUTTON_ROWS = z
+    .array(z.array(z.object({
+    text: z.string().describe("Button label"),
+    callbackData: z
+        .string()
+        .optional()
+        .describe("Data returned on press. Telegram caps this at 1-64 bytes and refuses longer with nothing in our logs to explain it, so put an id in it, not a sentence."),
+    url: z.string().optional().describe("URL opened in the device browser, leaving Telegram"),
+    webAppUrl: z
+        .string()
+        .optional()
+        .describe("HTTPS URL opened as a Telegram Mini App INSIDE the chat, rather than in the device browser as `url` does. Private chats between a user and the bot only."),
+})))
+    .describe("Inline keyboard rows");
+export const CARD_SHAPE = {
+    botId: BOT_ID,
+    chatId: CHAT_ID,
+    text: z.string().describe("Card text. HTML by default; see parseMode."),
+    key: z
+        .string()
+        .optional()
+        .describe('Your own idempotency key for this card, for example "job-4102". Scoped to this bot and chat. First call posts and remembers the message; later calls with the same key edit it in place instead of stacking a new card below it. Omit for a one-off message that never updates.'),
+    parseMode: z
+        .enum(["HTML", "Markdown", "MarkdownV2"])
+        .optional()
+        .describe("Parse mode (default: HTML)"),
+    buttons: BUTTON_ROWS.optional(),
+    disablePreview: z
+        .boolean()
+        .optional()
+        .describe("Suppress the link preview Telegram generates from a URL in the text"),
+    callbackQueryId: z
+        .string()
+        .optional()
+        .describe("Answer this button press, clearing Telegram's 15-second spinner. Answered AFTER the card is posted or edited, so an expired id cannot block the update."),
+    alert: z.boolean().optional().describe("With callbackQueryId: show a dialog instead of a toast"),
+};
+export const MEDIA_FETCH_SHAPE = {
+    botId: BOT_ID,
+    fileId: z.string().describe("Telegram file_id, as it appeared on the message"),
+    destDir: z
+        .string()
+        .optional()
+        .describe("Directory to save into. Defaults to /tmp/maxy-media, the same directory inbound attachments land in."),
+};
+export const THREAD_SHAPE = {
+    botId: BOT_ID,
+    chatId: CHAT_ID,
+    action: z
+        .enum(["create", "edit", "close", "reopen", "delete", "unpinAll"])
+        .describe("What to do. `create` needs `name`; every other action needs `messageThreadId`."),
+    name: z
+        .string()
+        .optional()
+        .describe("Topic title, 1-128 characters. Required for `create`; optional for `edit`, where omitting it keeps the current one."),
+    messageThreadId: z
+        .number()
+        .optional()
+        .describe("The topic's id, as `create` returned it. Required for every action except `create`."),
+    iconColor: z
+        .number()
+        .optional()
+        .describe("Topic icon colour, RGB. Telegram accepts only 7322096, 16766590, 13338331, 9367192, 16749490 or 16478047. `create` only."),
+    iconCustomEmojiId: z
+        .string()
+        .optional()
+        .describe("Custom emoji shown as the topic icon. getForumTopicIconStickers lists the allowed ones."),
+};
+/** Shared by ASK_SHAPE, MEDIA_SEND_SHAPE and CARD_SHAPE's siblings: the four
+ *  send-envelope options every Bot API send method takes. */
+const REPLY_TO = z
+    .number()
+    .optional()
+    .describe("Quote-reply to this message id. Omit for a normal message.");
+const MESSAGE_THREAD_ID = z
+    .number()
+    .optional()
+    .describe("Send into this forum topic. Forum supergroups, and private chats of bots with forum topic mode enabled, only.");
+const DISABLE_NOTIFICATION = z
+    .boolean()
+    .optional()
+    .describe("Deliver silently: the message arrives with no sound.");
+const PROTECT_CONTENT = z
+    .boolean()
+    .optional()
+    .describe("Stop the recipient forwarding or saving the message.");
+export const ASK_SHAPE = {
+    botId: BOT_ID,
+    chatId: CHAT_ID,
+    kind: z
+        .enum([
+        "poll",
+        "checklist",
+        "location",
+        "venue",
+        "contact",
+        "dice",
+        "stopPoll",
+        "editChecklist",
+        "editLiveLocation",
+        "stopLiveLocation",
+    ])
+        .describe("What to send or change. `poll` needs question+options; `checklist` and `editChecklist` need businessConnectionId+checklist; `location` and `editLiveLocation` need latitude+longitude; `venue` needs those plus title+address; `contact` needs phoneNumber+firstName; `dice` needs nothing; `stopPoll`, `editChecklist`, `editLiveLocation` and `stopLiveLocation` need messageId."),
+    question: z.string().describe("Poll question, 1-300 characters. `poll` only.").optional(),
+    options: z
+        .array(z.string())
+        .optional()
+        .describe("Poll answers, 1-12 of them, as plain strings. Telegram's InputPollOption objects are built from these for you. `poll` only."),
+    pollType: z
+        .enum(["regular", "quiz"])
+        .optional()
+        .describe("Poll type, default regular. A quiz needs correctOptionIds and can carry an explanation."),
+    isAnonymous: z
+        .boolean()
+        .optional()
+        .describe("Whether votes are anonymous. Telegram defaults this to true."),
+    allowsMultipleAnswers: z
+        .boolean()
+        .optional()
+        .describe("Let one voter pick several options. Not available on a quiz."),
+    correctOptionIds: z
+        .array(z.number())
+        .optional()
+        .describe("0-based indexes of the correct answers. Required when pollType is quiz."),
+    explanation: z
+        .string()
+        .optional()
+        .describe("Shown when a voter picks a wrong answer in a quiz, 0-200 characters. `poll` with pollType quiz only."),
+    openPeriod: z
+        .number()
+        .optional()
+        .describe("Seconds the poll stays open, 5-2628000. Telegram closes it automatically after."),
+    businessConnectionId: z
+        .string()
+        .optional()
+        .describe("The business connection the checklist is sent on behalf of. Telegram requires it for `checklist` and `editChecklist` and accepts it for nothing else here."),
+    checklist: z
+        .object({
+        title: z.string().describe("Checklist title, 1-255 characters"),
+        tasks: z
+            .array(z.object({
+            id: z
+                .number()
+                .describe("Your own id for this task, positive and unique within the checklist"),
+            text: z.string().describe("Task text, 1-100 characters"),
+        }))
+            .describe("1-30 tasks"),
+        othersCanAddTasks: z.boolean().optional().describe("Let other people add tasks"),
+        othersCanMarkTasksAsDone: z
+            .boolean()
+            .optional()
+            .describe("Let other people tick tasks off"),
+    })
+        .optional()
+        .describe("The checklist itself. Required for `checklist` and `editChecklist`."),
+    latitude: z
+        .number()
+        .optional()
+        .describe("Latitude. Required for `location`, `venue` and `editLiveLocation`."),
+    longitude: z
+        .number()
+        .optional()
+        .describe("Longitude. Required for `location`, `venue` and `editLiveLocation`."),
+    horizontalAccuracy: z
+        .number()
+        .optional()
+        .describe("Radius of uncertainty in metres, 0-1500."),
+    livePeriod: z
+        .number()
+        .optional()
+        .describe("Seconds the location keeps updating, 60-86400, or 2147483647 to keep it live indefinitely. Omit for a one-off pin. A live location is what editLiveLocation and stopLiveLocation act on later."),
+    heading: z.number().optional().describe("Direction of travel in degrees, 1-360. Live only."),
+    proximityAlertRadius: z
+        .number()
+        .optional()
+        .describe("Alert when another chat member comes within this many metres, 1-100000. Live only."),
+    title: z.string().optional().describe("Venue name. `venue` only."),
+    address: z.string().optional().describe("Venue street address. `venue` only."),
+    phoneNumber: z.string().optional().describe("Contact's phone number. `contact` only."),
+    firstName: z.string().optional().describe("Contact's first name. `contact` only."),
+    lastName: z.string().optional().describe("Contact's last name. `contact` only."),
+    emoji: z
+        .string()
+        .optional()
+        .describe("Which animated die to roll. Telegram accepts only its six dice emoji and defaults to the die. `dice` only."),
+    messageId: z
+        .number()
+        .optional()
+        .describe("The message to act on. Required for stopPoll, editChecklist, editLiveLocation and stopLiveLocation."),
+    buttons: BUTTON_ROWS.optional(),
+    replyToMessageId: REPLY_TO,
+    messageThreadId: MESSAGE_THREAD_ID,
+    disableNotification: DISABLE_NOTIFICATION,
+    protectContent: PROTECT_CONTENT,
+};
+const PARSE_MODE = z
+    .enum(["HTML", "Markdown", "MarkdownV2"])
+    .optional()
+    .describe("How to parse the caption. Telegram documents these three and no others.");
+export const MEDIA_SEND_SHAPE = {
+    botId: BOT_ID,
+    chatId: CHAT_ID,
+    kind: z
+        .enum([
+        "photo",
+        "document",
+        "video",
+        "audio",
+        "voice",
+        "animation",
+        "videoNote",
+        "group",
+        "editMedia",
+        "editCaption",
+    ])
+        .describe("What to send or change. The seven single-file kinds and `editMedia` need exactly one of fileId, url or filePath; `group` needs 2-10 items; `editCaption` needs no file at all. `editMedia` and `editCaption` need messageId."),
+    fileId: z
+        .string()
+        .optional()
+        .describe("A file Telegram already holds, as it appeared on an earlier message. Always cheaper than re-uploading the same bytes. Exactly one of fileId, url or filePath."),
+    url: z
+        .string()
+        .optional()
+        .describe("An https URL Telegram fetches the file from itself. Not supported for videoNote, which Telegram documents as file_id or upload only. Exactly one of fileId, url or filePath."),
+    filePath: z
+        .string()
+        .optional()
+        .describe("Absolute path to a local file, uploaded as multipart. Exactly one of fileId, url or filePath. Named explicitly rather than sniffed out of a string, because a caption can legitimately begin with a slash."),
+    items: z
+        .array(z.object({
+        type: z
+            .enum(["photo", "video", "document", "audio"])
+            .describe("What this item is. Telegram groups documents only with documents and audio only with audio; everything else can mix photos and videos."),
+        fileId: z.string().optional().describe("A file Telegram already holds"),
+        url: z.string().optional().describe("An https URL Telegram fetches itself"),
+        filePath: z
+            .string()
+            .optional()
+            .describe("Absolute local path; uploaded as its own part of the one multipart request"),
+        caption: z.string().optional().describe("This item's own caption"),
+    }))
+        .optional()
+        .describe("The album's 2-10 items. `group` only."),
+    mediaType: z
+        .enum(["photo", "video", "document", "audio", "animation"])
+        .optional()
+        .describe("What the replacement media is. Required for `editMedia`: Telegram's InputMedia object carries its own type, and unlike the single-file kinds the method name does not supply one."),
+    caption: z.string().optional().describe("Caption, 0-1024 characters."),
+    parseMode: PARSE_MODE,
+    showCaptionAboveMedia: z
+        .boolean()
+        .optional()
+        .describe("Put the caption above the media instead of below it."),
+    hasSpoiler: z.boolean().optional().describe("Cover the media with a spoiler animation."),
+    duration: z.number().optional().describe("Duration in seconds. Video, audio, voice, animation."),
+    width: z.number().optional().describe("Width in pixels. Video and animation."),
+    height: z.number().optional().describe("Height in pixels. Video and animation."),
+    length: z.number().optional().describe("Diameter of the round video. `videoNote` only."),
+    performer: z.string().optional().describe("Performer shown in the music player. `audio` only."),
+    title: z.string().optional().describe("Track name shown in the music player. `audio` only."),
+    supportsStreaming: z
+        .boolean()
+        .optional()
+        .describe("Mark an uploaded video as suitable for streaming. `video` only."),
+    messageId: z
+        .number()
+        .optional()
+        .describe("The message to edit. Required for `editMedia` and `editCaption`."),
+    buttons: BUTTON_ROWS.optional(),
+    replyToMessageId: REPLY_TO,
+    messageThreadId: MESSAGE_THREAD_ID,
+    disableNotification: DISABLE_NOTIFICATION,
+    protectContent: PROTECT_CONTENT,
+};
+const PRICES = z
+    .array(z.object({
+    label: z.string().describe("What this line of the price breakdown is called"),
+    amount: z
+        .number()
+        .describe("Price in the currency's smallest unit, as a whole number. US$1.45 is 145. A Telegram Stars price is the number of stars."),
+}))
+    .describe("The price breakdown: product price, tax, delivery and so on. A Telegram Stars invoice must carry exactly one item.");
+/** There is deliberately no `buttons` field here. Telegram requires the first
+ *  button of an invoice keyboard to be a Pay button, so a caller passing its own
+ *  rows gets a refusal or an invoice nobody can pay; omitting reply_markup
+ *  entirely gets the Pay button for free. */
+export const INVOICE_SHAPE = {
+    botId: BOT_ID,
+    action: z
+        .enum([
+        "send",
+        "link",
+        "answerShipping",
+        "answerPreCheckout",
+        "balance",
+        "transactions",
+        "refund",
+        "editSubscription",
+    ])
+        .describe("What to do. `send` posts an invoice into a chat and `link` returns a payable URL instead; both need title, description, payload, currency and prices, and `send` also needs chatId. `answerShipping` and `answerPreCheckout` reply to Telegram's checkout queries. `balance`, `transactions`, `refund` and `editSubscription` are the Telegram Stars controls."),
+    chatId: CHAT_ID.optional().describe("Where the invoice goes. Required for `send`; `link` has no chat, it returns a URL."),
+    title: z.string().optional().describe("Product name, 1-32 characters."),
+    description: z.string().optional().describe("Product description, 1-255 characters."),
+    payload: z
+        .string()
+        .optional()
+        .describe("Your own reference for this invoice, 1-128 bytes. Never shown to the payer; it comes back on the successful-payment update, which is how you match a payment to a job."),
+    providerToken: z
+        .string()
+        .optional()
+        .describe("Payment provider token from BotFather. Omit it, or pass an empty string, for payments in Telegram Stars."),
+    currency: z
+        .string()
+        .optional()
+        .describe("Three-letter ISO 4217 code, or XTR for Telegram Stars."),
+    prices: PRICES.optional(),
+    subscriptionPeriod: z
+        .number()
+        .optional()
+        .describe("Seconds between recurring charges. Telegram currently accepts only 2592000 (30 days), Stars only, and `link` only."),
+    maxTipAmount: z
+        .number()
+        .optional()
+        .describe("Largest tip accepted, in the currency's smallest unit."),
+    suggestedTipAmounts: z
+        .array(z.number())
+        .optional()
+        .describe("Up to four tip amounts, ascending, each below maxTipAmount."),
+    photoUrl: z.string().optional().describe("URL of a product photo shown on the invoice."),
+    needName: z.boolean().optional().describe("Ask the payer for their full name."),
+    needPhoneNumber: z.boolean().optional().describe("Ask the payer for their phone number."),
+    needEmail: z.boolean().optional().describe("Ask the payer for their email address."),
+    needShippingAddress: z
+        .boolean()
+        .optional()
+        .describe("Ask the payer for a shipping address. Ignored for Stars payments."),
+    isFlexible: z
+        .boolean()
+        .optional()
+        .describe("The final price depends on the shipping method chosen. Setting this is what makes Telegram send you a shipping query to answer."),
+    shippingQueryId: z
+        .string()
+        .optional()
+        .describe("The shipping query being answered. `answerShipping` only."),
+    preCheckoutQueryId: z
+        .string()
+        .optional()
+        .describe("The pre-checkout query being answered. `answerPreCheckout` only."),
+    ok: z
+        .boolean()
+        .optional()
+        .describe("Whether the order can proceed. Required for `answerShipping` and `answerPreCheckout`. False needs errorMessage, which Telegram shows the payer verbatim."),
+    shippingOptions: z
+        .array(z.object({
+        id: z.string().describe("Your own id for this shipping option"),
+        title: z.string().describe("What the payer sees, for example Next day"),
+        prices: PRICES,
+    }))
+        .optional()
+        .describe("The shipping options offered. Required when answering a shipping query with ok."),
+    errorMessage: z
+        .string()
+        .optional()
+        .describe("Why the order cannot proceed, in plain words. Telegram shows this to the payer, so write it for them."),
+    offset: z.number().optional().describe("Transactions to skip. `transactions` only."),
+    limit: z.number().optional().describe("Transactions to return, 1-100. `transactions` only."),
+    userId: z
+        .number()
+        .optional()
+        .describe("The payer's numeric Telegram id. `refund` and `editSubscription`."),
+    telegramPaymentChargeId: z
+        .string()
+        .optional()
+        .describe("Telegram's own id for the payment, as it arrived on the successful-payment update. `refund` and `editSubscription`."),
+    isCanceled: z
+        .boolean()
+        .optional()
+        .describe("True stops a Stars subscription renewing at the end of the current period; false re-enables one the bot cancelled earlier. Required for `editSubscription`."),
+};
+//# sourceMappingURL=schemas.js.map

package/payload/platform/plugins/telegram/mcp/dist/tools/schemas.js.map

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

package/payload/platform/plugins/telegram/mcp/dist/tools/thread.d.ts

@@ -0,0 +1,38 @@
+export type ThreadAction = "create" | "edit" | "close" | "reopen" | "delete" | "unpinAll";
+/** Action to Bot API method. Verified against the live parameter tables on
+ *  2026-08-08. Exported so the census's owned-method map and this tool cannot
+ *  disagree about which methods the tool owns. */
+export declare const THREAD_METHOD: Readonly<Record<ThreadAction, string>>;
+export interface ThreadParams {
+    botId: string;
+    chatId: string | number;
+    action: ThreadAction;
+    name?: string;
+    messageThreadId?: number;
+    iconColor?: number;
+    iconCustomEmojiId?: string;
+}
+export interface ThreadDeps {
+    platformRoot: string;
+    accountId: string | undefined;
+    /** Per-invocation id threading one call's lines together. */
+    callId: string;
+    log: (line: string) => void;
+    fetchImpl?: typeof fetch;
+}
+export interface ThreadResult {
+    ok: boolean;
+    text: string;
+    isError: boolean;
+    messageThreadId?: number;
+}
+/** Forum topics, including the private-chat form.
+ *
+ *  Telegram documents createForumTopic as working "in a forum supergroup chat
+ *  or a private chat with a user", so one client chat can carry a thread per
+ *  job. The private-chat form needs forum topic mode enabled on the bot:
+ *  sendMessage's own `message_thread_id` is documented as "for forum
+ *  supergroups and private chats of bots with forum topic mode enabled only",
+ *  so a topic created without it is unaddressable. */
+export declare function telegramThread(p: ThreadParams, deps: ThreadDeps): Promise<ThreadResult>;
+//# sourceMappingURL=thread.d.ts.map

package/payload/platform/plugins/telegram/mcp/dist/tools/thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../src/tools/thread.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE1F;;kDAEkD;AAClD,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAO/D,CAAC;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAuCD;;;;;;;sDAOsD;AACtD,wBAAsB,cAAc,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAuE7F"}

package/payload/platform/plugins/telegram/mcp/dist/tools/thread.js

@@ -0,0 +1,120 @@
+import { callBotApi } from "../lib/bot-api.js";
+import { listRegisteredBots, resolveBotToken } from "../lib/account-token.js";
+const TAG = "[telegram-tools]";
+const TOOL = "telegram-thread";
+/** Action to Bot API method. Verified against the live parameter tables on
+ *  2026-08-08. Exported so the census's owned-method map and this tool cannot
+ *  disagree about which methods the tool owns. */
+export const THREAD_METHOD = Object.freeze({
+    create: "createForumTopic",
+    edit: "editForumTopic",
+    close: "closeForumTopic",
+    reopen: "reopenForumTopic",
+    delete: "deleteForumTopic",
+    unpinAll: "unpinAllForumTopicMessages",
+});
+/** The per-action required fields Zod cannot express in one flat shape: a
+ *  discriminated union across six actions would make every optional field
+ *  conditional in the tool schema, which is harder for the model to read than
+ *  one flat shape plus this check. Refused BEFORE any network call, which is
+ *  the whole point of Task 2588. */
+function missingField(p) {
+    if (p.action === "create") {
+        if (!p.name)
+            return "create needs `name` (the topic title, 1-128 characters).";
+        return null;
+    }
+    if (p.messageThreadId === undefined) {
+        return `${p.action} needs \`messageThreadId\` (the id createForumTopic returned).`;
+    }
+    return null;
+}
+function bodyFor(p) {
+    if (p.action === "create") {
+        return {
+            chat_id: p.chatId,
+            name: p.name,
+            ...(p.iconColor !== undefined ? { icon_color: p.iconColor } : {}),
+            ...(p.iconCustomEmojiId !== undefined ? { icon_custom_emoji_id: p.iconCustomEmojiId } : {}),
+        };
+    }
+    if (p.action === "edit") {
+        return {
+            chat_id: p.chatId,
+            message_thread_id: p.messageThreadId,
+            ...(p.name !== undefined ? { name: p.name } : {}),
+            ...(p.iconCustomEmojiId !== undefined ? { icon_custom_emoji_id: p.iconCustomEmojiId } : {}),
+        };
+    }
+    // close, reopen, delete, unpinAll take these two and nothing else.
+    return { chat_id: p.chatId, message_thread_id: p.messageThreadId };
+}
+/** Forum topics, including the private-chat form.
+ *
+ *  Telegram documents createForumTopic as working "in a forum supergroup chat
+ *  or a private chat with a user", so one client chat can carry a thread per
+ *  job. The private-chat form needs forum topic mode enabled on the bot:
+ *  sendMessage's own `message_thread_id` is documented as "for forum
+ *  supergroups and private chats of bots with forum topic mode enabled only",
+ *  so a topic created without it is unaddressable. */
+export async function telegramThread(p, deps) {
+    const { callId, log } = deps;
+    if (!deps.accountId) {
+        log(`${TAG} op=no-account callId=${callId} tool=${TOOL}`);
+        return {
+            ok: false,
+            isError: true,
+            text: "telegram-thread cannot execute: this MCP instance was launched without ACCOUNT_ID " +
+                "(plugin-system metadata-only mode).",
+        };
+    }
+    const missing = missingField(p);
+    if (missing) {
+        log(`${TAG} op=refused callId=${callId} tool=${TOOL} action=${p.action} reason=missing-field`);
+        return { ok: false, isError: true, text: missing };
+    }
+    const token = resolveBotToken(deps.platformRoot, deps.accountId, p.botId);
+    if (!token) {
+        const known = listRegisteredBots(deps.platformRoot, deps.accountId);
+        log(`${TAG} op=no-bot callId=${callId} tool=${TOOL} account=${deps.accountId} botId=${p.botId} registered=${known.length}`);
+        return {
+            ok: false,
+            isError: true,
+            text: known.length
+                ? `No bot "${p.botId}" is registered on this account. Registered: ${known
+                    .map((b) => `${b.id} (${b.role})`)
+                    .join(", ")}.`
+                : "No Telegram bot is registered on this account. Run the telegram:configure skill first.",
+        };
+    }
+    const method = THREAD_METHOD[p.action];
+    log(`${TAG} op=call tool=${TOOL} method=${method} callId=${callId} botId=${p.botId}`);
+    let envelope;
+    try {
+        envelope = await callBotApi(token, method, bodyFor(p), {
+            ...(deps.fetchImpl ? { fetchImpl: deps.fetchImpl } : {}),
+        });
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        log(`${TAG} op=error callId=${callId} tool=${TOOL} method=${method} reason="${reason}"`);
+        return { ok: false, isError: true, text: `telegram-thread could not reach Telegram: ${reason}` };
+    }
+    log(`${TAG} op=result callId=${callId} tool=${TOOL} method=${method} ok=${envelope.ok} ` +
+        `errorCode=${envelope.error_code ?? "-"} description="${envelope.description ?? ""}"`);
+    if (!envelope.ok) {
+        return {
+            ok: false,
+            isError: true,
+            text: `Telegram refused ${method} (${envelope.error_code ?? "no code"}): ${envelope.description ?? "no description"}`,
+        };
+    }
+    const id = envelope.result?.message_thread_id;
+    return {
+        ok: true,
+        isError: false,
+        text: JSON.stringify(envelope.result ?? true, null, 2),
+        ...(typeof id === "number" ? { messageThreadId: id } : {}),
+    };
+}
+//# sourceMappingURL=thread.js.map

package/payload/platform/plugins/telegram/mcp/dist/tools/thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.js","sourceRoot":"","sources":["../../src/tools/thread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyB,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE9E,MAAM,GAAG,GAAG,kBAAkB,CAAC;AAC/B,MAAM,IAAI,GAAG,iBAAiB,CAAC;AAI/B;;kDAEkD;AAClD,MAAM,CAAC,MAAM,aAAa,GAA2C,MAAM,CAAC,MAAM,CAAC;IACjF,MAAM,EAAE,kBAAkB;IAC1B,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,iBAAiB;IACxB,MAAM,EAAE,kBAAkB;IAC1B,MAAM,EAAE,kBAAkB;IAC1B,QAAQ,EAAE,4BAA4B;CACvC,CAAC,CAAC;AA4BH;;;;oCAIoC;AACpC,SAAS,YAAY,CAAC,CAAe;IACnC,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1B,IAAI,CAAC,CAAC,CAAC,IAAI;YAAE,OAAO,0DAA0D,CAAC;QAC/E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,GAAG,CAAC,CAAC,MAAM,gEAAgE,CAAC;IACrF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,OAAO,CAAC,CAAe;IAC9B,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO;YACL,OAAO,EAAE,CAAC,CAAC,MAAM;YACjB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,GAAG,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,GAAG,CAAC,CAAC,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5F,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QACxB,OAAO;YACL,OAAO,EAAE,CAAC,CAAC,MAAM;YACjB,iBAAiB,EAAE,CAAC,CAAC,eAAe;YACpC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,CAAC,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5F,CAAC;IACJ,CAAC;IACD,mEAAmE;IACnE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC,eAAe,EAAE,CAAC;AACrE,CAAC;AAED;;;;;;;sDAOsD;AACtD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,CAAe,EAAE,IAAgB;IACpE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE7B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACpB,GAAG,CAAC,GAAG,GAAG,yBAAyB,MAAM,SAAS,IAAI,EAAE,CAAC,CAAC;QAC1D,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,IAAI;YACb,IAAI,EACF,oFAAoF;gBACpF,qCAAqC;SACxC,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,OAAO,EAAE,CAAC;QACZ,GAAG,CAAC,GAAG,GAAG,sBAAsB,MAAM,SAAS,IAAI,WAAW,CAAC,CAAC,MAAM,uBAAuB,CAAC,CAAC;QAC/F,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACpE,GAAG,CACD,GAAG,GAAG,qBAAqB,MAAM,SAAS,IAAI,YAAY,IAAI,CAAC,SAAS,UAAU,CAAC,CAAC,KAAK,eAAe,KAAK,CAAC,MAAM,EAAE,CACvH,CAAC;QACF,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,KAAK,CAAC,MAAM;gBAChB,CAAC,CAAC,WAAW,CAAC,CAAC,KAAK,gDAAgD,KAAK;qBACpE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC;qBACjC,IAAI,CAAC,IAAI,CAAC,GAAG;gBAClB,CAAC,CAAC,wFAAwF;SAC7F,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACvC,GAAG,CAAC,GAAG,GAAG,iBAAiB,IAAI,WAAW,MAAM,WAAW,MAAM,UAAU,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAEtF,IAAI,QAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE;YACrD,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChE,GAAG,CAAC,GAAG,GAAG,oBAAoB,MAAM,SAAS,IAAI,WAAW,MAAM,YAAY,MAAM,GAAG,CAAC,CAAC;QACzF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,6CAA6C,MAAM,EAAE,EAAE,CAAC;IACnG,CAAC;IAED,GAAG,CACD,GAAG,GAAG,qBAAqB,MAAM,SAAS,IAAI,WAAW,MAAM,OAAO,QAAQ,CAAC,EAAE,GAAG;QAClF,aAAa,QAAQ,CAAC,UAAU,IAAI,GAAG,iBAAiB,QAAQ,CAAC,WAAW,IAAI,EAAE,GAAG,CACxF,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,oBAAoB,MAAM,KAAK,QAAQ,CAAC,UAAU,IAAI,SAAS,MAAM,QAAQ,CAAC,WAAW,IAAI,gBAAgB,EAAE;SACtH,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,GAAI,QAAQ,CAAC,MAAqD,EAAE,iBAAiB,CAAC;IAC9F,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,GAAG,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3D,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/telegram/mcp/vitest.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    environment: "node",
+    // Scoped to src, matching whatsapp/mcp and nine other plugin MCPs. Without
+    // it vitest also collects dist/__tests__/*.test.js, which `tsc -p` emits
+    // because this plugin's tsconfig includes src/__tests__: every test then
+    // runs twice, and a stale compiled copy can pass while the source it was
+    // built from fails.
+    include: ["src/**/__tests__/**/*.test.ts"],
+    testTimeout: 10_000,
+  },
+});