@rubytech/create-maxy-code 0.1.579 → 0.1.580

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

@@ -0,0 +1,134 @@
+import { callBotApi } from "../lib/bot-api.js";
+import { listRegisteredBots, resolveBotToken } from "../lib/account-token.js";
+import { buildInlineKeyboard } from "../lib/telegram.js";
+import { cardKey, readCardId, writeCardId } from "../lib/card-store.js";
+const TAG = "[telegram-tools]";
+const TOOL = "telegram-card";
+/** Telegram's answer when the new text and markup match the old. It is a no-op,
+ *  not a failure to retry, and an idempotent card re-post is the normal case
+ *  rather than an error. This is the ONE place this plugin does not relay
+ *  Telegram's verdict as an error. */
+const NOT_MODIFIED = "message is not modified";
+/** Post a card, or edit the one this key already names.
+ *
+ *  Absorbs sendMessage, editMessageText, editMessageReplyMarkup and
+ *  answerCallbackQuery behind one typed schema. Task 2588: the passthrough gave
+ *  the model no field names for any of them, so a malformed call was only
+ *  caught by Telegram's 400. */
+export async function telegramCard(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-card cannot execute: this MCP instance was launched without ACCOUNT_ID " +
+                "(plugin-system metadata-only mode). Per-account bot tokens require ACCOUNT_ID at spawn.",
+        };
+    }
+    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 markup = p.buttons ? buildInlineKeyboard(p.buttons) : undefined;
+    const stored = p.key
+        ? readCardId(deps.platformRoot, deps.accountId, cardKey(p.botId, p.chatId, p.key))
+        : null;
+    const common = {
+        chat_id: p.chatId,
+        text: p.text,
+        parse_mode: p.parseMode ?? "HTML",
+        ...(markup ? { reply_markup: markup } : {}),
+        ...(p.disablePreview ? { link_preview_options: { is_disabled: true } } : {}),
+    };
+    const method = stored === null ? "sendMessage" : "editMessageText";
+    const body = stored === null ? common : { ...common, message_id: stored };
+    log(`${TAG} op=call tool=${TOOL} method=${method} callId=${callId} botId=${p.botId}`);
+    let envelope;
+    try {
+        envelope = await callBotApi(token, method, body, {
+            ...(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-card could not reach Telegram: ${reason}`,
+        };
+    }
+    let outcome;
+    let sendError = null;
+    if (envelope.ok) {
+        outcome = stored === null ? "sent" : "edited";
+        const id = envelope.result?.message_id;
+        // An edit refreshes the entry's timestamp as well as a first post writing
+        // it. The store ages a key out after CARD_TTL_MS UNTOUCHED (card-store.ts);
+        // without this a card edited every day would still expire seven days after
+        // it was created, mid-life.
+        if (p.key) {
+            const toStore = stored === null ? (typeof id === "number" ? id : null) : stored;
+            if (toStore !== null) {
+                writeCardId(deps.platformRoot, deps.accountId, cardKey(p.botId, p.chatId, p.key), toStore);
+            }
+        }
+    }
+    else if ((envelope.description ?? "").includes(NOT_MODIFIED)) {
+        outcome = "unchanged";
+    }
+    else {
+        outcome = "none";
+        sendError = `Telegram refused ${method} (${envelope.error_code ?? "no code"}): ${envelope.description ?? "no description"}`;
+    }
+    log(`${TAG} op=result callId=${callId} tool=${TOOL} method=${method} ok=${envelope.ok || outcome === "unchanged"} ` +
+        `errorCode=${envelope.error_code ?? "-"} description="${envelope.description ?? ""}"`);
+    log(`${TAG} op=card callId=${callId} outcome=${outcome}`);
+    // AFTER the send, deliberately. Telegram refuses a callback id older than its
+    // window, and answering first would let a stale id block the card update,
+    // which is the caller's actual work. A failure here is reported, never
+    // swallowed and never retried.
+    let answerError = null;
+    if (p.callbackQueryId) {
+        log(`${TAG} op=call tool=${TOOL} method=answerCallbackQuery callId=${callId} botId=${p.botId}`);
+        try {
+            const ack = await callBotApi(token, "answerCallbackQuery", { callback_query_id: p.callbackQueryId, ...(p.alert ? { show_alert: true } : {}) }, { ...(deps.fetchImpl ? { fetchImpl: deps.fetchImpl } : {}) });
+            log(`${TAG} op=result callId=${callId} tool=${TOOL} method=answerCallbackQuery ok=${ack.ok}`);
+            if (!ack.ok) {
+                answerError = `Telegram refused answerCallbackQuery (${ack.error_code ?? "no code"}): ${ack.description ?? "no description"}`;
+            }
+        }
+        catch (err) {
+            answerError = `answerCallbackQuery could not reach Telegram: ${err instanceof Error ? err.message : String(err)}`;
+        }
+    }
+    if (sendError || answerError) {
+        return {
+            ok: false,
+            isError: true,
+            outcome,
+            text: [sendError, answerError].filter(Boolean).join(" "),
+        };
+    }
+    const said = outcome === "unchanged"
+        ? "Card unchanged: the new text and markup match what is already there."
+        : outcome === "edited"
+            ? `Card edited in place (message ${stored}).`
+            : `Card sent to ${p.chatId}.`;
+    return { ok: true, isError: false, outcome, text: said };
+}
+//# sourceMappingURL=card.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"card.js","sourceRoot":"","sources":["../../src/tools/card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyB,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAkC,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,GAAG,GAAG,kBAAkB,CAAC;AAC/B,MAAM,IAAI,GAAG,eAAe,CAAC;AA8B7B;;;sCAGsC;AACtC,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAE/C;;;;;gCAKgC;AAChC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,CAAa,EAAE,IAAc;IAC9D,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,OAAO,EAAE,MAAM;YACf,IAAI,EACF,kFAAkF;gBAClF,yFAAyF;SAC5F,CAAC;IACJ,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,OAAO,EAAE,MAAM;YACf,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,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG;QAClB,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;QAClF,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,CAAC,CAAC,MAAM;QACjB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,UAAU,EAAE,CAAC,CAAC,SAAS,IAAI,MAAM;QACjC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7E,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,iBAAiB,CAAC;IACnE,MAAM,IAAI,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAE1E,GAAG,CAAC,GAAG,GAAG,iBAAiB,IAAI,WAAW,MAAM,WAAW,MAAM,UAAU,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACtF,IAAI,QAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;YAC/C,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;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,2CAA2C,MAAM,EAAE;SAC1D,CAAC;IACJ,CAAC;IAED,IAAI,OAA8B,CAAC;IACnC,IAAI,SAAS,GAAkB,IAAI,CAAC;IAEpC,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;QAChB,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC9C,MAAM,EAAE,GAAI,QAAQ,CAAC,MAA8C,EAAE,UAAU,CAAC;QAChF,0EAA0E;QAC1E,4EAA4E;QAC5E,2EAA2E;QAC3E,4BAA4B;QAC5B,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;YACV,MAAM,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAChF,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,WAAW,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;YAC7F,CAAC;QACH,CAAC;IACH,CAAC;SAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/D,OAAO,GAAG,WAAW,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,MAAM,CAAC;QACjB,SAAS,GAAG,oBAAoB,MAAM,KAAK,QAAQ,CAAC,UAAU,IAAI,SAAS,MAAM,QAAQ,CAAC,WAAW,IAAI,gBAAgB,EAAE,CAAC;IAC9H,CAAC;IAED,GAAG,CACD,GAAG,GAAG,qBAAqB,MAAM,SAAS,IAAI,WAAW,MAAM,OAAO,QAAQ,CAAC,EAAE,IAAI,OAAO,KAAK,WAAW,GAAG;QAC7G,aAAa,QAAQ,CAAC,UAAU,IAAI,GAAG,iBAAiB,QAAQ,CAAC,WAAW,IAAI,EAAE,GAAG,CACxF,CAAC;IACF,GAAG,CAAC,GAAG,GAAG,mBAAmB,MAAM,YAAY,OAAO,EAAE,CAAC,CAAC;IAE1D,8EAA8E;IAC9E,0EAA0E;IAC1E,uEAAuE;IACvE,+BAA+B;IAC/B,IAAI,WAAW,GAAkB,IAAI,CAAC;IACtC,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;QACtB,GAAG,CAAC,GAAG,GAAG,iBAAiB,IAAI,sCAAsC,MAAM,UAAU,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAChG,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,UAAU,CAC1B,KAAK,EACL,qBAAqB,EACrB,EAAE,iBAAiB,EAAE,CAAC,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAClF,EAAE,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAC7D,CAAC;YACF,GAAG,CAAC,GAAG,GAAG,qBAAqB,MAAM,SAAS,IAAI,kCAAkC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9F,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,WAAW,GAAG,yCAAyC,GAAG,CAAC,UAAU,IAAI,SAAS,MAAM,GAAG,CAAC,WAAW,IAAI,gBAAgB,EAAE,CAAC;YAChI,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,GAAG,iDAAiD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACpH,CAAC;IACH,CAAC;IAED,IAAI,SAAS,IAAI,WAAW,EAAE,CAAC;QAC7B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,IAAI;YACb,OAAO;YACP,IAAI,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;SACzD,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GACR,OAAO,KAAK,WAAW;QACrB,CAAC,CAAC,sEAAsE;QACxE,CAAC,CAAC,OAAO,KAAK,QAAQ;YACpB,CAAC,CAAC,iCAAiC,MAAM,IAAI;YAC7C,CAAC,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC;IACpC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC3D,CAAC"}

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

@@ -0,0 +1,70 @@
+export type InvoiceAction = "send" | "link" | "answerShipping" | "answerPreCheckout" | "balance" | "transactions" | "refund" | "editSubscription";
+/** 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 INVOICE_METHOD: Readonly<Record<InvoiceAction, string>>;
+export interface LabeledPrice {
+    label: string;
+    amount: number;
+}
+export interface ShippingOptionInput {
+    id: string;
+    title: string;
+    prices: LabeledPrice[];
+}
+export interface InvoiceParams {
+    botId: string;
+    action: InvoiceAction;
+    chatId?: string | number;
+    title?: string;
+    description?: string;
+    payload?: string;
+    providerToken?: string;
+    currency?: string;
+    prices?: LabeledPrice[];
+    subscriptionPeriod?: number;
+    maxTipAmount?: number;
+    suggestedTipAmounts?: number[];
+    photoUrl?: string;
+    needName?: boolean;
+    needPhoneNumber?: boolean;
+    needEmail?: boolean;
+    needShippingAddress?: boolean;
+    isFlexible?: boolean;
+    shippingQueryId?: string;
+    preCheckoutQueryId?: string;
+    ok?: boolean;
+    shippingOptions?: ShippingOptionInput[];
+    errorMessage?: string;
+    offset?: number;
+    limit?: number;
+    userId?: number;
+    telegramPaymentChargeId?: string;
+    isCanceled?: boolean;
+}
+export interface InvoiceDeps {
+    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 InvoiceResult {
+    ok: boolean;
+    text: string;
+    isError: boolean;
+    /** What was created, for the op=invoice line. `none` covers the six actions
+     *  that create nothing, and any action Telegram refused. */
+    outcome: "sent" | "link" | "none";
+}
+/** 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 declare function telegramInvoice(p: InvoiceParams, deps: InvoiceDeps): Promise<InvoiceResult>;
+//# sourceMappingURL=invoice.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invoice.d.ts","sourceRoot":"","sources":["../../src/tools/invoice.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,MAAM,GACN,gBAAgB,GAChB,mBAAmB,GACnB,SAAS,GACT,cAAc,GACd,QAAQ,GACR,kBAAkB,CAAC;AAEvB;;kDAEkD;AAClD,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CASjE,CAAC;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,eAAe,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,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,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB;gEAC4D;IAC5D,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CACnC;AAwID;;;;;;;2CAO2C;AAC3C,wBAAsB,eAAe,CACnC,CAAC,EAAE,aAAa,EAChB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,aAAa,CAAC,CAoFxB"}

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/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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"}