@rubytech/create-maxy-code 0.1.579 → 0.1.581

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

@@ -0,0 +1,232 @@
+import { callBotApi } from "../lib/bot-api.js";
+import { listRegisteredBots, resolveBotToken } from "../lib/account-token.js";
+const TAG = "[telegram-tools]";
+const TOOL = "telegram-invoice";
+/** 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 INVOICE_METHOD = Object.freeze({
+    send: "sendInvoice",
+    link: "createInvoiceLink",
+    answerShipping: "answerShippingQuery",
+    answerPreCheckout: "answerPreCheckoutQuery",
+    balance: "getMyStarBalance",
+    transactions: "getStarTransactions",
+    refund: "refundStarPayment",
+    editSubscription: "editUserStarSubscription",
+});
+/** The per-action required fields Zod cannot express in one flat shape, refused
+ *  BEFORE any network call.
+ *
+ *  `ok` and `isCanceled` are tested against undefined rather than falsiness:
+ *  false is a meaningful answer to both, and `!p.ok` would refuse the very call
+ *  that declines an order. */
+function missingField(p) {
+    switch (p.action) {
+        case "send":
+        case "link": {
+            if (p.action === "send" && p.chatId === undefined) {
+                return "send needs `chatId` (the chat the invoice is posted into). Use action `link` for a payable URL with no chat.";
+            }
+            if (!p.title)
+                return `${p.action} needs \`title\` (the product name, 1-32 characters).`;
+            if (!p.description) {
+                return `${p.action} needs \`description\` (the product description, 1-255 characters).`;
+            }
+            if (!p.payload) {
+                return `${p.action} needs \`payload\` (your own reference, 1-128 bytes, returned to you on payment).`;
+            }
+            if (!p.currency) {
+                return `${p.action} needs \`currency\` (a three-letter ISO 4217 code, or XTR for Telegram Stars).`;
+            }
+            if (!p.prices?.length) {
+                return `${p.action} needs \`prices\` (the price breakdown; exactly one item for Telegram Stars).`;
+            }
+            return null;
+        }
+        case "answerShipping":
+            if (!p.shippingQueryId)
+                return "answerShipping needs `shippingQueryId`.";
+            if (p.ok === undefined) {
+                return "answerShipping needs `ok`: true with `shippingOptions`, or false with `errorMessage`.";
+            }
+            if (p.ok && !p.shippingOptions?.length) {
+                return "answerShipping with ok true needs `shippingOptions`.";
+            }
+            if (!p.ok && !p.errorMessage) {
+                return "answerShipping with ok false needs `errorMessage`, which Telegram shows the payer.";
+            }
+            return null;
+        case "answerPreCheckout":
+            if (!p.preCheckoutQueryId)
+                return "answerPreCheckout needs `preCheckoutQueryId`.";
+            if (p.ok === undefined) {
+                return "answerPreCheckout needs `ok`: true to proceed, or false with `errorMessage`.";
+            }
+            if (!p.ok && !p.errorMessage) {
+                return "answerPreCheckout with ok false needs `errorMessage`, which Telegram shows the payer.";
+            }
+            return null;
+        case "balance":
+        case "transactions":
+            return null;
+        case "refund":
+        case "editSubscription": {
+            if (p.userId === undefined)
+                return `${p.action} needs \`userId\` (the payer's numeric id).`;
+            if (!p.telegramPaymentChargeId) {
+                return `${p.action} needs \`telegramPaymentChargeId\` (Telegram's own id for the payment).`;
+            }
+            if (p.action === "editSubscription" && p.isCanceled === undefined) {
+                return "editSubscription needs `isCanceled`: true stops the renewal, false re-enables it.";
+            }
+            return null;
+        }
+    }
+}
+/** The product fields sendInvoice and createInvoiceLink share. One definition,
+ *  because an invoice and its link describing different products would be a
+ *  difference nobody intended. */
+function productBody(p) {
+    return {
+        title: p.title,
+        description: p.description,
+        payload: p.payload,
+        ...(p.providerToken !== undefined ? { provider_token: p.providerToken } : {}),
+        currency: p.currency,
+        prices: p.prices,
+        ...(p.maxTipAmount !== undefined ? { max_tip_amount: p.maxTipAmount } : {}),
+        ...(p.suggestedTipAmounts !== undefined
+            ? { suggested_tip_amounts: p.suggestedTipAmounts }
+            : {}),
+        ...(p.photoUrl !== undefined ? { photo_url: p.photoUrl } : {}),
+        ...(p.needName !== undefined ? { need_name: p.needName } : {}),
+        ...(p.needPhoneNumber !== undefined ? { need_phone_number: p.needPhoneNumber } : {}),
+        ...(p.needEmail !== undefined ? { need_email: p.needEmail } : {}),
+        ...(p.needShippingAddress !== undefined
+            ? { need_shipping_address: p.needShippingAddress }
+            : {}),
+        ...(p.isFlexible !== undefined ? { is_flexible: p.isFlexible } : {}),
+    };
+}
+function bodyFor(p) {
+    switch (p.action) {
+        case "send":
+            return { chat_id: p.chatId, ...productBody(p) };
+        case "link":
+            return {
+                ...productBody(p),
+                ...(p.subscriptionPeriod !== undefined
+                    ? { subscription_period: p.subscriptionPeriod }
+                    : {}),
+            };
+        case "answerShipping":
+            return {
+                shipping_query_id: p.shippingQueryId,
+                ok: p.ok,
+                ...(p.shippingOptions !== undefined ? { shipping_options: p.shippingOptions } : {}),
+                ...(p.errorMessage !== undefined ? { error_message: p.errorMessage } : {}),
+            };
+        case "answerPreCheckout":
+            return {
+                pre_checkout_query_id: p.preCheckoutQueryId,
+                ok: p.ok,
+                ...(p.errorMessage !== undefined ? { error_message: p.errorMessage } : {}),
+            };
+        case "balance":
+            return {};
+        case "transactions":
+            return {
+                ...(p.offset !== undefined ? { offset: p.offset } : {}),
+                ...(p.limit !== undefined ? { limit: p.limit } : {}),
+            };
+        case "refund":
+            return { user_id: p.userId, telegram_payment_charge_id: p.telegramPaymentChargeId };
+        case "editSubscription":
+            return {
+                user_id: p.userId,
+                telegram_payment_charge_id: p.telegramPaymentChargeId,
+                is_canceled: p.isCanceled,
+            };
+    }
+}
+/** Invoices and invoice links, the two checkout answers, and the Telegram Stars
+ *  balance, transaction list, refund and subscription controls.
+ *
+ *  Task 2594: these eight methods were reachable only through telegram-api,
+ *  whose untyped params object gave the model no field names for any of them.
+ *
+ *  An invoice created and never paid is a business outcome, not a defect, so
+ *  op=invoice is one line and no alert. */
+export async function telegramInvoice(p, deps) {
+    const { callId, log } = deps;
+    if (!deps.accountId) {
+        log(`${TAG} op=no-account callId=${callId} tool=${TOOL}`);
+        return {
+            ok: false,
+            isError: true,
+            outcome: "none",
+            text: "telegram-invoice 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, outcome: "none", 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,
+            outcome: "none",
+            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 = INVOICE_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,
+            outcome: "none",
+            text: `telegram-invoice 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,
+            outcome: "none",
+            text: `Telegram refused ${method} (${envelope.error_code ?? "no code"}): ${envelope.description ?? "no description"}`,
+        };
+    }
+    const outcome = p.action === "send" ? "sent" : p.action === "link" ? "link" : "none";
+    if (outcome !== "none") {
+        log(`${TAG} op=invoice callId=${callId} outcome=${outcome}`);
+    }
+    return {
+        ok: true,
+        isError: false,
+        outcome,
+        text: JSON.stringify(envelope.result ?? true, null, 2),
+    };
+}
+//# sourceMappingURL=invoice.js.map

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

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

package/payload/platform/plugins/telegram/mcp/dist/tools/live-location.d.ts

@@ -0,0 +1,23 @@
+/** Task 2602 — read where a Telegram live share currently is.
+ *
+ *  Before this, a live share's position reached nothing readable: every ping
+ *  raised a turn that answered it once and forgot it, and the only other reader
+ *  was gated on a dispatch config most accounts do not have. Suppressing those
+ *  turns without this tool would have made the position less reachable than it
+ *  already was, so the two ship together.
+ */
+export interface LiveLocationToolParams {
+    botId: string;
+    senderId: string;
+}
+export interface LiveLocationToolContext {
+    platformRoot: string;
+    accountId: string | undefined;
+    now?: number;
+    log: (line: string) => void;
+}
+export declare function telegramLiveLocation(params: LiveLocationToolParams, ctx: LiveLocationToolContext): {
+    text: string;
+    isError?: boolean;
+};
+//# sourceMappingURL=live-location.d.ts.map

package/payload/platform/plugins/telegram/mcp/dist/tools/live-location.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-location.d.ts","sourceRoot":"","sources":["../../src/tools/live-location.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAID,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,uBAAuB,GAC3B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CA8CrC"}

package/payload/platform/plugins/telegram/mcp/dist/tools/live-location.js

@@ -0,0 +1,43 @@
+import { readLiveLocation, currentLiveLocationKeys, liveLocationKey, } from "../lib/live-location-store.js";
+const TAG = "[telegram-live-location]";
+export function telegramLiveLocation(params, ctx) {
+    const now = ctx.now ?? Date.now();
+    const { botId, senderId } = params;
+    if (!ctx.accountId) {
+        ctx.log(`${TAG} op=read botId=${botId} senderId=${senderId} outcome=no-account`);
+        return { text: "No account is resolved for this session, so no share can be read.", isError: true };
+    }
+    const out = readLiveLocation(ctx.platformRoot, ctx.accountId, botId, senderId, now);
+    ctx.log(`${TAG} op=read botId=${botId} senderId=${senderId} ` +
+        `ageMs=${out.ageMs ?? "none"} outcome=${out.outcome}`);
+    if (out.outcome === "expired") {
+        // Named, with the numbers behind the refusal. An expired fix is never
+        // reported as a position: answering an hours-old point as "where they are"
+        // is the failure this refusal exists to prevent.
+        return {
+            text: `The last position from ${senderId} is ${Math.round((out.ageMs ?? 0) / 1000)}s old, ` +
+                `past the share's own live_period. The share has ended, so there is no current position. ` +
+                `Ask them to share again if you need one.`,
+            isError: true,
+        };
+    }
+    if (out.outcome === "absent") {
+        const keys = currentLiveLocationKeys(ctx.platformRoot, ctx.accountId, now);
+        return {
+            text: `No live location is being shared by ${senderId} on bot ${botId}. ` +
+                (keys.length > 0
+                    ? `Shares currently active (botId:senderId): ${keys.join(", ")}.`
+                    : `No share is active on this account.`),
+            isError: true,
+        };
+    }
+    const rec = out.record;
+    const measuredAt = new Date(rec.at).toISOString();
+    const ageS = Math.round((out.ageMs ?? 0) / 1000);
+    return {
+        text: `${liveLocationKey(botId, senderId)} is at ${rec.lat},${rec.lon}.\n` +
+            `Measured ${measuredAt} (${ageS}s ago, by Telegram's own clock).\n` +
+            `The share runs for ${rec.livePeriodS}s from each update; after that this reads as ended.`,
+    };
+}
+//# sourceMappingURL=live-location.js.map

package/payload/platform/plugins/telegram/mcp/dist/tools/live-location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-location.js","sourceRoot":"","sources":["../../src/tools/live-location.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,GAChB,MAAM,+BAA+B,CAAC;AAsBvC,MAAM,GAAG,GAAG,0BAA0B,CAAC;AAEvC,MAAM,UAAU,oBAAoB,CAClC,MAA8B,EAC9B,GAA4B;IAE5B,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IAClC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IACnC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACnB,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,kBAAkB,KAAK,aAAa,QAAQ,qBAAqB,CAAC,CAAC;QACjF,OAAO,EAAE,IAAI,EAAE,mEAAmE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACtG,CAAC;IACD,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IACpF,GAAG,CAAC,GAAG,CACL,GAAG,GAAG,kBAAkB,KAAK,aAAa,QAAQ,GAAG;QACnD,SAAS,GAAG,CAAC,KAAK,IAAI,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,CACxD,CAAC;IAEF,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9B,sEAAsE;QACtE,2EAA2E;QAC3E,iDAAiD;QACjD,OAAO;YACL,IAAI,EACF,0BAA0B,QAAQ,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS;gBACrF,0FAA0F;gBAC1F,0CAA0C;YAC5C,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,uBAAuB,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC3E,OAAO;YACL,IAAI,EACF,uCAAuC,QAAQ,WAAW,KAAK,IAAI;gBACnE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;oBACd,CAAC,CAAC,6CAA6C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBACjE,CAAC,CAAC,qCAAqC,CAAC;YAC5C,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,GAAG,CAAC,MAAO,CAAC;IACxB,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACjD,OAAO;QACL,IAAI,EACF,GAAG,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,KAAK;YACpE,YAAY,UAAU,KAAK,IAAI,oCAAoC;YACnE,sBAAsB,GAAG,CAAC,WAAW,qDAAqD;KAC7F,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/telegram/mcp/dist/tools/media-fetch.d.ts

@@ -0,0 +1,42 @@
+/** The directory the inbound path already uses
+ *  (platform/ui/app/lib/telegram/inbound/media.ts:20). A second media store
+ *  would be a second thing to clean up. */
+export declare const TELEGRAM_MEDIA_DIR = "/tmp/maxy-media";
+/** Every other Telegram call in this plugin is bounded: `callBotApi` defaults to
+ *  30s (bot-api.ts:41). The primitives take a signal but supply no default, so
+ *  without this the fetch is the one call here that can hang for ever. 45s
+ *  matches the inbound downloader (ui/app/lib/telegram/inbound/media.ts:37),
+ *  which is the closer analogue because this is a file transfer, not an API
+ *  round trip. One signal covers both hops, as it does there. */
+export declare const FETCH_TIMEOUT_MS = 45000;
+export interface MediaFetchParams {
+    botId: string;
+    fileId: string;
+    destDir?: string;
+}
+export interface MediaFetchDeps {
+    platformRoot: string;
+    accountId: string | undefined;
+    /** Per-invocation id threading one call's lines together. */
+    callId: string;
+    log: (line: string) => void;
+    fetchImpl?: typeof fetch;
+    /** Overrides FETCH_TIMEOUT_MS. Injected in tests. */
+    timeoutMs?: number;
+}
+export interface MediaFetchResult {
+    ok: boolean;
+    text: string;
+    isError: boolean;
+    path?: string;
+    bytes?: number;
+}
+/** Fetch one Telegram file by `file_id` and hand back a local path.
+ *
+ *  Task 2588: the inbound webhook downloads what arrives
+ *  (platform/ui/server/routes/telegram.ts:519), but nothing let an agent fetch a
+ *  `file_id` it learned about later. Names the file from the `file_id`, not
+ *  `file_unique_id`, which a bare `file_id` does not carry — so this tool cannot
+ *  use the channel layer's identity-stable name and does not pretend to. */
+export declare function telegramMediaFetch(p: MediaFetchParams, deps: MediaFetchDeps): Promise<MediaFetchResult>;
+//# sourceMappingURL=media-fetch.d.ts.map

package/payload/platform/plugins/telegram/mcp/dist/tools/media-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-fetch.d.ts","sourceRoot":"","sources":["../../src/tools/media-fetch.ts"],"names":[],"mappings":"AAaA;;2CAE2C;AAC3C,eAAO,MAAM,kBAAkB,oBAAoB,CAAC;AAEpD;;;;;iEAKiE;AACjE,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,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;IACzB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;4EAM4E;AAC5E,wBAAsB,kBAAkB,CACtC,CAAC,EAAE,gBAAgB,EACnB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAkF3B"}

package/payload/platform/plugins/telegram/mcp/dist/tools/media-fetch.js

@@ -0,0 +1,92 @@
+import { join } from "node:path";
+import { resolveTelegramFile, downloadTelegramFile, extensionFor, pathSafe, } from "../../../../../lib/telegram-media/dist/index.js";
+import { listRegisteredBots, resolveBotToken } from "../lib/account-token.js";
+const TAG = "[telegram-tools]";
+const MEDIA_TAG = "[telegram-media-census]";
+const TOOL = "telegram-media-fetch";
+/** The directory the inbound path already uses
+ *  (platform/ui/app/lib/telegram/inbound/media.ts:20). A second media store
+ *  would be a second thing to clean up. */
+export const TELEGRAM_MEDIA_DIR = "/tmp/maxy-media";
+/** Every other Telegram call in this plugin is bounded: `callBotApi` defaults to
+ *  30s (bot-api.ts:41). The primitives take a signal but supply no default, so
+ *  without this the fetch is the one call here that can hang for ever. 45s
+ *  matches the inbound downloader (ui/app/lib/telegram/inbound/media.ts:37),
+ *  which is the closer analogue because this is a file transfer, not an API
+ *  round trip. One signal covers both hops, as it does there. */
+export const FETCH_TIMEOUT_MS = 45_000;
+/** Fetch one Telegram file by `file_id` and hand back a local path.
+ *
+ *  Task 2588: the inbound webhook downloads what arrives
+ *  (platform/ui/server/routes/telegram.ts:519), but nothing let an agent fetch a
+ *  `file_id` it learned about later. Names the file from the `file_id`, not
+ *  `file_unique_id`, which a bare `file_id` does not carry — so this tool cannot
+ *  use the channel layer's identity-stable name and does not pretend to. */
+export async function telegramMediaFetch(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-media-fetch cannot execute: this MCP instance was launched without " +
+                "ACCOUNT_ID (plugin-system metadata-only mode).",
+        };
+    }
+    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 dir = p.destDir ?? TELEGRAM_MEDIA_DIR;
+    // One signal for both hops: the ceiling is on the whole fetch.
+    const signal = AbortSignal.timeout(deps.timeoutMs ?? FETCH_TIMEOUT_MS);
+    log(`${TAG} op=call tool=${TOOL} method=getFile callId=${callId} botId=${p.botId}`);
+    const meta = await resolveTelegramFile({
+        token,
+        fileId: p.fileId,
+        signal,
+        ...(deps.fetchImpl ? { fetchImpl: deps.fetchImpl } : {}),
+    });
+    if (!meta.ok) {
+        log(`${TAG} op=result callId=${callId} tool=${TOOL} method=getFile ok=false description="${meta.failure}"`);
+        return {
+            ok: false,
+            isError: true,
+            text: `Telegram would not resolve that file_id: ${meta.failure}`,
+        };
+    }
+    const path = join(dir, `tg-${pathSafe(p.botId)}-${pathSafe(p.fileId)}.${extensionFor(meta.filePath, undefined)}`);
+    const got = await downloadTelegramFile({
+        token,
+        filePath: meta.filePath,
+        destPath: path,
+        signal,
+        ...(deps.fetchImpl ? { fetchImpl: deps.fetchImpl } : {}),
+    });
+    if (!got.ok) {
+        log(`${TAG} op=result callId=${callId} tool=${TOOL} method=getFile ok=false description="${got.failure}"`);
+        return { ok: false, isError: true, text: `That file did not download: ${got.failure}` };
+    }
+    log(`${TAG} op=result callId=${callId} tool=${TOOL} method=getFile ok=true`);
+    // The measured post-condition, one line per fetch. `files` rising while
+    // conversations end is the leak signature.
+    log(`${MEDIA_TAG} files=1 bytes=${got.bytes} path=${path}`);
+    return {
+        ok: true,
+        isError: false,
+        text: `Saved to ${path} (${got.bytes} bytes).`,
+        path,
+        bytes: got.bytes,
+    };
+}
+//# sourceMappingURL=media-fetch.js.map

package/payload/platform/plugins/telegram/mcp/dist/tools/media-fetch.js.map

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

package/payload/platform/plugins/telegram/mcp/dist/tools/media-send.d.ts

@@ -0,0 +1,76 @@
+import { type InlineKeyboardButtonInput } from "../lib/telegram.js";
+export type MediaKind = "photo" | "document" | "video" | "audio" | "voice" | "animation" | "videoNote" | "group" | "editMedia" | "editCaption";
+/** Kind 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 MEDIA_SEND_METHOD: Readonly<Record<MediaKind, string>>;
+export type MediaRoute = "file-id" | "url" | "multipart";
+export interface MediaItem {
+    type: "photo" | "video" | "document" | "audio";
+    fileId?: string;
+    url?: string;
+    filePath?: string;
+    caption?: string;
+}
+export interface MediaSendParams {
+    botId: string;
+    chatId: string | number;
+    kind: MediaKind;
+    fileId?: string;
+    url?: string;
+    filePath?: string;
+    items?: MediaItem[];
+    mediaType?: "photo" | "video" | "document" | "audio" | "animation";
+    caption?: string;
+    parseMode?: "HTML" | "Markdown" | "MarkdownV2";
+    showCaptionAboveMedia?: boolean;
+    hasSpoiler?: boolean;
+    duration?: number;
+    width?: number;
+    height?: number;
+    length?: number;
+    performer?: string;
+    title?: string;
+    supportsStreaming?: boolean;
+    messageId?: number;
+    buttons?: InlineKeyboardButtonInput[][];
+    replyToMessageId?: number;
+    messageThreadId?: number;
+    disableNotification?: boolean;
+    protectContent?: boolean;
+}
+export interface MediaSendDeps {
+    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 MediaSendResult {
+    ok: boolean;
+    text: string;
+    isError: boolean;
+    /** Which of Telegram's three documented ways of naming a file was used.
+     *  `mixed` is an album whose items chose different ways and carried no local
+     *  file; `none` is editCaption, which carries no file at all. */
+    route: MediaRoute | "mixed" | "none";
+}
+export interface MediaRequest {
+    body: Record<string, unknown>;
+    /** Bot API field name to absolute local path. Its presence is what switches
+     *  callBotApi to multipart. */
+    files: Record<string, string> | undefined;
+    route: MediaRoute | "mixed" | "none";
+}
+/** Photos, documents, video, audio, voice notes, animations, video notes and
+ *  albums, plus editing a message's media or its caption.
+ *
+ *  Task 2594: these ten methods were reachable only through telegram-api, whose
+ *  untyped params object gave the model no field names for any of them.
+ *
+ *  A group's route is `multipart` when any item is a local file and `file-id`
+ *  otherwise, because one album is one request: a batch with a single local
+ *  photo in it goes up as multipart in its entirety. */
+export declare function telegramMediaSend(p: MediaSendParams, deps: MediaSendDeps): Promise<MediaSendResult>;
+//# sourceMappingURL=media-send.d.ts.map

package/payload/platform/plugins/telegram/mcp/dist/tools/media-send.d.ts.map

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