@rubytech/create-maxy-code 0.1.579 → 0.1.581

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

@@ -0,0 +1,270 @@
+import { callBotApi } from "../lib/bot-api.js";
+import { listRegisteredBots, resolveBotToken } from "../lib/account-token.js";
+import { buildInlineKeyboard } from "../lib/telegram.js";
+const TAG = "[telegram-tools]";
+const TOOL = "telegram-ask";
+/** 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 const ASK_METHOD = Object.freeze({
+    poll: "sendPoll",
+    checklist: "sendChecklist",
+    location: "sendLocation",
+    venue: "sendVenue",
+    contact: "sendContact",
+    dice: "sendDice",
+    stopPoll: "stopPoll",
+    editChecklist: "editMessageChecklist",
+    editLiveLocation: "editMessageLiveLocation",
+    stopLiveLocation: "stopMessageLiveLocation",
+});
+/** The per-kind required fields Zod cannot express in one flat shape, refused
+ *  BEFORE any network call. Ten discriminated unions 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. */
+function missingField(p) {
+    switch (p.kind) {
+        case "poll":
+            if (!p.question)
+                return "poll needs `question` (the poll question, 1-300 characters).";
+            if (!p.options?.length)
+                return "poll needs `options` (1-12 answers, as plain strings).";
+            if (p.options.length > 12)
+                return "poll takes at most 12 `options`; Telegram refuses more.";
+            return null;
+        case "checklist":
+        case "editChecklist": {
+            if (!p.businessConnectionId) {
+                return `${p.kind} needs \`businessConnectionId\`: Telegram sends a checklist only on behalf of a connected business account.`;
+            }
+            if (!p.checklist)
+                return `${p.kind} needs \`checklist\` (its title and 1-30 tasks).`;
+            if (p.kind === "editChecklist" && p.messageId === undefined) {
+                return "editChecklist needs `messageId` (the checklist message to replace).";
+            }
+            return null;
+        }
+        case "location":
+            if (p.latitude === undefined || p.longitude === undefined) {
+                return "location needs `latitude` and `longitude`.";
+            }
+            return null;
+        case "venue":
+            if (p.latitude === undefined || p.longitude === undefined) {
+                return "venue needs `latitude` and `longitude`.";
+            }
+            if (!p.title)
+                return "venue needs `title` (the venue's name).";
+            if (!p.address)
+                return "venue needs `address` (the venue's street address).";
+            return null;
+        case "contact":
+            if (!p.phoneNumber)
+                return "contact needs `phoneNumber`.";
+            if (!p.firstName)
+                return "contact needs `firstName`.";
+            return null;
+        case "dice":
+            return null;
+        case "editLiveLocation":
+            if (p.messageId === undefined) {
+                return "editLiveLocation needs `messageId` (the live location message to move).";
+            }
+            if (p.latitude === undefined || p.longitude === undefined) {
+                return "editLiveLocation needs `latitude` and `longitude` (the new position).";
+            }
+            return null;
+        case "stopPoll":
+        case "stopLiveLocation":
+            if (p.messageId === undefined) {
+                return `${p.kind} needs \`messageId\` (the message to stop).`;
+            }
+            return null;
+    }
+}
+/** The checklist in Telegram's own snake_case. Kept out of bodyFor so the two
+ *  checklist kinds cannot drift apart. */
+function checklistBody(c) {
+    return {
+        title: c.title,
+        tasks: c.tasks,
+        ...(c.othersCanAddTasks !== undefined ? { others_can_add_tasks: c.othersCanAddTasks } : {}),
+        ...(c.othersCanMarkTasksAsDone !== undefined
+            ? { others_can_mark_tasks_as_done: c.othersCanMarkTasksAsDone }
+            : {}),
+    };
+}
+function kindBody(p) {
+    switch (p.kind) {
+        case "poll":
+            return {
+                question: p.question,
+                // Telegram takes InputPollOption objects; the tool takes plain strings,
+                // because an option is a string in every case this install has.
+                options: (p.options ?? []).map((text) => ({ text })),
+                ...(p.pollType !== undefined ? { type: p.pollType } : {}),
+                ...(p.isAnonymous !== undefined ? { is_anonymous: p.isAnonymous } : {}),
+                ...(p.allowsMultipleAnswers !== undefined
+                    ? { allows_multiple_answers: p.allowsMultipleAnswers }
+                    : {}),
+                ...(p.correctOptionIds !== undefined ? { correct_option_ids: p.correctOptionIds } : {}),
+                ...(p.explanation !== undefined ? { explanation: p.explanation } : {}),
+                ...(p.openPeriod !== undefined ? { open_period: p.openPeriod } : {}),
+            };
+        case "checklist":
+            return {
+                business_connection_id: p.businessConnectionId,
+                checklist: checklistBody(p.checklist),
+            };
+        case "editChecklist":
+            return {
+                business_connection_id: p.businessConnectionId,
+                message_id: p.messageId,
+                checklist: checklistBody(p.checklist),
+            };
+        case "location":
+            return {
+                latitude: p.latitude,
+                longitude: p.longitude,
+                ...(p.horizontalAccuracy !== undefined
+                    ? { horizontal_accuracy: p.horizontalAccuracy }
+                    : {}),
+                ...(p.livePeriod !== undefined ? { live_period: p.livePeriod } : {}),
+                ...(p.heading !== undefined ? { heading: p.heading } : {}),
+                ...(p.proximityAlertRadius !== undefined
+                    ? { proximity_alert_radius: p.proximityAlertRadius }
+                    : {}),
+            };
+        case "venue":
+            return {
+                latitude: p.latitude,
+                longitude: p.longitude,
+                title: p.title,
+                address: p.address,
+            };
+        case "contact":
+            return {
+                phone_number: p.phoneNumber,
+                first_name: p.firstName,
+                ...(p.lastName !== undefined ? { last_name: p.lastName } : {}),
+            };
+        case "dice":
+            return { ...(p.emoji !== undefined ? { emoji: p.emoji } : {}) };
+        case "editLiveLocation":
+            return {
+                message_id: p.messageId,
+                latitude: p.latitude,
+                longitude: p.longitude,
+                ...(p.livePeriod !== undefined ? { live_period: p.livePeriod } : {}),
+                ...(p.horizontalAccuracy !== undefined
+                    ? { horizontal_accuracy: p.horizontalAccuracy }
+                    : {}),
+                ...(p.heading !== undefined ? { heading: p.heading } : {}),
+                ...(p.proximityAlertRadius !== undefined
+                    ? { proximity_alert_radius: p.proximityAlertRadius }
+                    : {}),
+            };
+        case "stopPoll":
+        case "stopLiveLocation":
+            return { message_id: p.messageId };
+    }
+}
+/** The four kinds that edit or stop an existing message. Telegram documents
+ *  reply_markup on all of them and none of the send-envelope options, so those
+ *  are withheld here rather than sent to a method that has no field for them. */
+const EDIT_KINDS = new Set([
+    "stopPoll",
+    "editChecklist",
+    "editLiveLocation",
+    "stopLiveLocation",
+]);
+function bodyFor(p) {
+    const markup = p.buttons ? buildInlineKeyboard(p.buttons) : undefined;
+    const envelope = EDIT_KINDS.has(p.kind)
+        ? {}
+        : {
+            // sendChecklist is the one send method with no message_thread_id in its
+            // table, so it is excluded here too.
+            ...(p.messageThreadId !== undefined && p.kind !== "checklist"
+                ? { message_thread_id: p.messageThreadId }
+                : {}),
+            ...(p.disableNotification !== undefined
+                ? { disable_notification: p.disableNotification }
+                : {}),
+            ...(p.protectContent !== undefined ? { protect_content: p.protectContent } : {}),
+            ...(p.replyToMessageId !== undefined
+                ? { reply_parameters: { message_id: p.replyToMessageId } }
+                : {}),
+        };
+    return {
+        chat_id: p.chatId,
+        ...kindBody(p),
+        ...(markup ? { reply_markup: markup } : {}),
+        ...envelope,
+    };
+}
+/** Polls, checklists, locations, venues, contacts and dice, plus stopping a
+ *  poll and editing or stopping a live location.
+ *
+ *  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, so a
+ *  malformed call was caught by Telegram's 400 and nothing earlier.
+ *
+ *  Inline messages are not addressed. Telegram lets editMessageLiveLocation and
+ *  stopMessageLiveLocation target an inline_message_id instead of a chat, but
+ *  nothing on this install sends inline messages, so chatId stays required. */
+export async function telegramAsk(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-ask 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} kind=${p.kind} 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 = ASK_METHOD[p.kind];
+    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-ask 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"}`,
+        };
+    }
+    return { ok: true, isError: false, text: JSON.stringify(envelope.result ?? true, null, 2) };
+}
+//# sourceMappingURL=ask.js.map

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

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

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

@@ -0,0 +1,34 @@
+import { type InlineKeyboardButtonInput } from "../lib/telegram.js";
+export interface CardParams {
+    botId: string;
+    chatId: string | number;
+    text: string;
+    key?: string;
+    parseMode?: "HTML" | "Markdown" | "MarkdownV2";
+    buttons?: InlineKeyboardButtonInput[][];
+    disablePreview?: boolean;
+    callbackQueryId?: string;
+    alert?: boolean;
+}
+export interface CardDeps {
+    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 CardResult {
+    ok: boolean;
+    text: string;
+    isError: boolean;
+    outcome: "sent" | "edited" | "unchanged" | "none";
+}
+/** 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 declare function telegramCard(p: CardParams, deps: CardDeps): Promise<CardResult>;
+//# sourceMappingURL=card.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../src/tools/card.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAMzF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;IAC/C,OAAO,CAAC,EAAE,yBAAyB,EAAE,EAAE,CAAC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,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,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;CACnD;AAQD;;;;;gCAKgC;AAChC,wBAAsB,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CA4IrF"}

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

@@ -0,0 +1,140 @@
+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 ?? ""}"`);
+    // Task 2604 — flattened across rows: two buttons in one row and two across two
+    // rows are the same two choices, and the census asks whether the person was
+    // given choices at all. This is the numerator of
+    // `[telegram-card-census] cardsWithButtons=`; without it the clause telling the
+    // agent to prefer buttons has no signal and not offering one is a non-event.
+    const buttonCount = (p.buttons ?? []).reduce((n, row) => n + row.length, 0);
+    log(`${TAG} op=card callId=${callId} outcome=${outcome} buttons=${buttonCount}`);
+    // 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":"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"}

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