@rubytech/create-maxy-code 0.1.571 → 0.1.573

package/payload/platform/plugins/telegram/mcp/dist/lib/menu-button.d.ts

@@ -0,0 +1,32 @@
+export interface MenuButtonRequest {
+    menu_button: {
+        type: "web_app";
+        text: string;
+        web_app: {
+            url: string;
+        };
+    };
+}
+/**
+ * The Bot API body for a `web_app` menu button.
+ *
+ * The bot id is stamped on here rather than trusted from the caller, exactly as
+ * `buildWebhookUrl` does: the field route resolves the account from it, so a
+ * caller who forgot it would produce a button that opens a page refusing every
+ * request with `no-bot`.
+ */
+export declare function buildMenuButtonRequest(p: {
+    publicOrigin: string;
+    botId: string;
+    text: string;
+}): MenuButtonRequest;
+/**
+ * Set the button. With no `chatId` it becomes the default for every private
+ * chat with the bot, which is what a whole roster wants; with one it is set for
+ * that chat alone.
+ */
+export declare function setChatMenuButton(botToken: string, request: MenuButtonRequest, chatId?: string): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=menu-button.d.ts.map

package/payload/platform/plugins/telegram/mcp/dist/lib/menu-button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-button.d.ts","sourceRoot":"","sources":["../../src/lib/menu-button.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CAC1E;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,iBAAiB,CAqBpB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ1C"}

package/payload/platform/plugins/telegram/mcp/dist/lib/menu-button.js

@@ -0,0 +1,56 @@
+/**
+ * Task 2502 — a permanent job-sheet button in the worker's chat.
+ *
+ * The Mini App needs an entry point. The assignment card that will carry a
+ * per-visit button is task 2510, and a chat menu button is independent of any
+ * card: it is there before the first job of the day and after the last one, and
+ * it is what makes the device storage probe runnable at all.
+ *
+ * The public origin is a parameter rather than a derivation. Nothing in this
+ * tree resolves an account's public host, and inventing a derivation here would
+ * be a second source of truth for it; `telegram-setup` takes its `webhookUrl`
+ * the same way.
+ */
+const TELEGRAM_API = "https://api.telegram.org";
+/**
+ * The Bot API body for a `web_app` menu button.
+ *
+ * The bot id is stamped on here rather than trusted from the caller, exactly as
+ * `buildWebhookUrl` does: the field route resolves the account from it, so a
+ * caller who forgot it would produce a button that opens a page refusing every
+ * request with `no-bot`.
+ */
+export function buildMenuButtonRequest(p) {
+    let origin;
+    try {
+        origin = new URL(p.publicOrigin);
+    }
+    catch {
+        throw new Error(`"${p.publicOrigin}" is not a URL. Give the account's public origin, for example https://acme.example.com.`);
+    }
+    if (origin.protocol !== "https:") {
+        // Telegram opens Mini Apps over https only. An http URL fails inside the
+        // webview with nothing on our side to say why.
+        throw new Error(`Telegram opens Mini Apps over https only; got "${p.publicOrigin}".`);
+    }
+    const url = new URL("/field", origin);
+    url.searchParams.set("bot", p.botId);
+    return {
+        menu_button: { type: "web_app", text: p.text, web_app: { url: url.toString() } },
+    };
+}
+/**
+ * Set the button. With no `chatId` it becomes the default for every private
+ * chat with the bot, which is what a whole roster wants; with one it is set for
+ * that chat alone.
+ */
+export async function setChatMenuButton(botToken, request, chatId) {
+    const res = await fetch(`${TELEGRAM_API}/bot${botToken}/setChatMenuButton`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ ...request, ...(chatId ? { chat_id: chatId } : {}) }),
+    });
+    const data = (await res.json());
+    return data.ok ? { ok: true } : { ok: false, error: data.description ?? "Unknown Telegram error" };
+}
+//# sourceMappingURL=menu-button.js.map

package/payload/platform/plugins/telegram/mcp/dist/lib/menu-button.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-button.js","sourceRoot":"","sources":["../../src/lib/menu-button.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAMhD;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,CAItC;IACC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,IAAI,CAAC,CAAC,YAAY,yFAAyF,CAC5G,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,yEAAyE;QACzE,+CAA+C;QAC/C,MAAM,IAAI,KAAK,CACb,kDAAkD,CAAC,CAAC,YAAY,IAAI,CACrE,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACtC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO;QACL,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE;KACjF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAgB,EAChB,OAA0B,EAC1B,MAAe;IAEf,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,YAAY,OAAO,QAAQ,oBAAoB,EAAE;QAC1E,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;KAC7E,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA0C,CAAC;IACzE,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,IAAI,wBAAwB,EAAE,CAAC;AACrG,CAAC"}

package/payload/platform/plugins/telegram/mcp/dist/lib/telegram.d.ts

@@ -7,10 +7,36 @@ export interface TelegramSendOptions {
 export interface TelegramInlineKeyboard {
     inline_keyboard: Array<Array<{
         text: string;
+        /** Bot API: "Data to be sent in a callback query to the bot when the button
+         *  is pressed, UTF-8 1-64 bytes." Longer data is refused by Telegram with
+         *  nothing in our own logs to explain it. Task 2501 receives the press. */
         callback_data?: string;
+        /** Opens the device browser, leaving Telegram. */
         url?: string;
+        /** Task 2501 — opens a Mini App INSIDE Telegram, which `url` does not. Bot
+         *  API: "Available only in private chats between a user and the bot. Not
+         *  supported for messages sent on behalf of a Telegram Business account." */
+        web_app?: {
+            url: string;
+        };
     }>>;
 }
+/** The agent-facing button shape. Camel-cased because it crosses the MCP tool
+ *  boundary, where the Bot API's snake_case would leak an external wire format
+ *  into a tool schema. */
+export interface InlineKeyboardButtonInput {
+    text: string;
+    callbackData?: string;
+    url?: string;
+    webAppUrl?: string;
+}
+/** Task 2501 — the agent-facing shape mapped to the Bot API's. Extracted from the
+ *  telegram-message tool so the mapping is testable without an account
+ *  environment: `webAppUrl` becoming `web_app` and NOT `url` is the whole point
+ *  of the field, and a regression there silently sends the person to the device
+ *  browser instead of the Mini App. Each key is omitted when the caller did not
+ *  set it, so a button carries exactly one type. */
+export declare function buildInlineKeyboard(rows: InlineKeyboardButtonInput[][]): TelegramInlineKeyboard;
 export declare function sendMessage(botToken: string, options: TelegramSendOptions): Promise<{
     ok: boolean;
     messageId?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/lib/telegram.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;IAC/C,WAAW,CAAC,EAAE,sBAAsB,CAAC;CACtC;AAED,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,KAAK,CACpB,KAAK,CAAC;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC,CACH,CAAC;CACH;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAyB9D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmC3D;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,CAAC,CAWtD"}
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/lib/telegram.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;IAC/C,WAAW,CAAC,EAAE,sBAAsB,CAAC;CACtC;AAED,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,KAAK,CACpB,KAAK,CAAC;QACJ,IAAI,EAAE,MAAM,CAAC;QACb;;mFAE2E;QAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,kDAAkD;QAClD,GAAG,CAAC,EAAE,MAAM,CAAC;QACb;;qFAE6E;QAC7E,OAAO,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3B,CAAC,CACH,CAAC;CACH;AAED;;0BAE0B;AAC1B,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;oDAKoD;AACpD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,yBAAyB,EAAE,EAAE,GAClC,sBAAsB,CAWxB;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAyB9D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmC3D;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,CAAC,CAWtD"}

package/payload/platform/plugins/telegram/mcp/dist/lib/telegram.js

@@ -2,6 +2,22 @@ import { randomBytes } from "node:crypto";
 import { writeFileSync, mkdirSync } from "node:fs";
 import { dirname } from "node:path";
 const TELEGRAM_API = "https://api.telegram.org";
+/** Task 2501 — the agent-facing shape mapped to the Bot API's. Extracted from the
+ *  telegram-message tool so the mapping is testable without an account
+ *  environment: `webAppUrl` becoming `web_app` and NOT `url` is the whole point
+ *  of the field, and a regression there silently sends the person to the device
+ *  browser instead of the Mini App. Each key is omitted when the caller did not
+ *  set it, so a button carries exactly one type. */
+export function buildInlineKeyboard(rows) {
+    return {
+        inline_keyboard: rows.map((row) => row.map((btn) => ({
+            text: btn.text,
+            ...(btn.callbackData !== undefined ? { callback_data: btn.callbackData } : {}),
+            ...(btn.url !== undefined ? { url: btn.url } : {}),
+            ...(btn.webAppUrl !== undefined ? { web_app: { url: btn.webAppUrl } } : {}),
+        }))),
+    };
+}
 export async function sendMessage(botToken, options) {
     const res = await fetch(`${TELEGRAM_API}/bot${botToken}/sendMessage`, {
         method: "POST",

package/payload/platform/plugins/telegram/mcp/dist/lib/telegram.js.map

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

package/payload/platform/plugins/telegram/mcp/dist/tools/api-census.d.ts

@@ -0,0 +1,16 @@
+export interface CensusDeps {
+    log: (line: string) => void;
+    fetchImpl?: typeof fetch;
+}
+export interface CensusResult {
+    text: string;
+    isError: boolean;
+}
+/** The network half, for a scheduled routine rather than for boot.
+ *
+ *  This is the standing check for a failure that emits no event: a method
+ *  Telegram renames or removes stays in the shipped list and 404s per call,
+ *  and nothing anywhere says so until somebody calls it. Reconciling the
+ *  shipped list against the live page needs no call and no reproduction. */
+export declare function telegramApiCensus(deps: CensusDeps): Promise<CensusResult>;
+//# sourceMappingURL=api-census.d.ts.map

package/payload/platform/plugins/telegram/mcp/dist/tools/api-census.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-census.d.ts","sourceRoot":"","sources":["../../src/tools/api-census.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;4EAK4E;AAC5E,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CA2B/E"}

package/payload/platform/plugins/telegram/mcp/dist/tools/api-census.js

@@ -0,0 +1,34 @@
+import { CENSUS_TAG, diffMethods, extractMethodNames } from "../lib/api-census.js";
+import { API_VERSION, BOT_API_METHODS } from "../lib/api-methods.js";
+const BOT_API_DOC = "https://core.telegram.org/bots/api";
+/** The network half, for a scheduled routine rather than for boot.
+ *
+ *  This is the standing check for a failure that emits no event: a method
+ *  Telegram renames or removes stays in the shipped list and 404s per call,
+ *  and nothing anywhere says so until somebody calls it. Reconciling the
+ *  shipped list against the live page needs no call and no reproduction. */
+export async function telegramApiCensus(deps) {
+    const doFetch = deps.fetchImpl ?? fetch;
+    let html;
+    try {
+        const res = await doFetch(BOT_API_DOC);
+        html = await res.text();
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        deps.log(`${CENSUS_TAG} op=error reason="${reason}"`);
+        return { text: `Could not read ${BOT_API_DOC}: ${reason}`, isError: true };
+    }
+    const live = extractMethodNames(html);
+    const { missing, added } = diffMethods(live);
+    const line = `${CENSUS_TAG} apiVersion=${API_VERSION} methods=${live.length} shipped=${BOT_API_METHODS.length} ` +
+        `missing=${missing.join(",")} added=${added.join(",")}`;
+    deps.log(line);
+    const verdict = missing.length === 0 && added.length === 0
+        ? "No drift: the shipped method list matches the live Bot API page."
+        : `Drift found. Missing (shipped here, gone from the page): ${missing.join(", ") || "none"}. ` +
+            `Added (on the page, absent here): ${added.join(", ") || "none"}. ` +
+            `Regenerate lib/api-methods.ts and skills/build/references/methods.md together; the parity test holds them level.`;
+    return { text: `${line}\n\n${verdict}`, isError: false };
+}
+//# sourceMappingURL=api-census.js.map

package/payload/platform/plugins/telegram/mcp/dist/tools/api-census.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-census.js","sourceRoot":"","sources":["../../src/tools/api-census.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAErE,MAAM,WAAW,GAAG,oCAAoC,CAAC;AAYzD;;;;;4EAK4E;AAC5E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAgB;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;IACxC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;QACvC,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC1B,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,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,qBAAqB,MAAM,GAAG,CAAC,CAAC;QACtD,OAAO,EAAE,IAAI,EAAE,kBAAkB,WAAW,KAAK,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7E,CAAC;IAED,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,IAAI,GACR,GAAG,UAAU,eAAe,WAAW,YAAY,IAAI,CAAC,MAAM,YAAY,eAAe,CAAC,MAAM,GAAG;QACnG,WAAW,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IAC1D,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEf,MAAM,OAAO,GACX,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QACxC,CAAC,CAAC,kEAAkE;QACpE,CAAC,CAAC,4DAA4D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,IAAI;YAC5F,qCAAqC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,IAAI;YACnE,kHAAkH,CAAC;IAEzH,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,OAAO,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC3D,CAAC"}

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

@@ -0,0 +1,26 @@
+export interface ApiParams {
+    botId: string;
+    method: string;
+    params?: Record<string, unknown>;
+    files?: Record<string, string>;
+    timeoutMs?: number;
+}
+export interface ApiDeps {
+    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 ApiResult {
+    ok: boolean;
+    text: string;
+    isError: boolean;
+}
+/** One tool for all 185 Bot API methods. Resolution order is: no account, then
+ *  the refusal list, then the bot's token, then the call itself. Each stop
+ *  emits its own `op=` line, so a failure is diagnosable from logs without
+ *  reproducing it. */
+export declare function telegramApi(p: ApiParams, deps: ApiDeps): Promise<ApiResult>;
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/tools/api.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,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,SAAS;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;sBAGsB;AACtB,wBAAsB,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CA0EjF"}

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

@@ -0,0 +1,80 @@
+import { checkMethod } from "../lib/api-guard.js";
+import { callBotApi } from "../lib/bot-api.js";
+import { listRegisteredBots, resolveBotToken } from "../lib/account-token.js";
+const TAG = "[telegram-api]";
+/** One tool for all 185 Bot API methods. Resolution order is: no account, then
+ *  the refusal list, then the bot's token, then the call itself. Each stop
+ *  emits its own `op=` line, so a failure is diagnosable from logs without
+ *  reproducing it. */
+export async function telegramApi(p, deps) {
+    const { callId, log } = deps;
+    if (!deps.accountId) {
+        log(`${TAG} op=no-account callId=${callId} method=${p.method}`);
+        return {
+            ok: false,
+            isError: true,
+            text: "telegram-api 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 verdict = checkMethod(p.method);
+    if (!verdict.allowed) {
+        log(`${TAG} op=refused callId=${callId} method=${p.method} reason=${verdict.reason}`);
+        return {
+            ok: false,
+            isError: true,
+            text: `telegram-api will not call ${p.method}: ${refusalProse(verdict.reason)} ` +
+                `That capability belongs to ${verdict.owner}.`,
+        };
+    }
+    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} 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 fileCount = p.files ? Object.keys(p.files).length : 0;
+    log(`${TAG} op=call callId=${callId} method=${p.method} listed=${verdict.listed} files=${fileCount}`);
+    let envelope;
+    try {
+        envelope = await callBotApi(token, p.method, p.params ?? {}, {
+            ...(p.files ? { files: p.files } : {}),
+            ...(p.timeoutMs ? { timeoutMs: p.timeoutMs } : {}),
+            ...(deps.fetchImpl ? { fetchImpl: deps.fetchImpl } : {}),
+        });
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        log(`${TAG} op=error callId=${callId} method=${p.method} reason="${reason}"`);
+        return { ok: false, isError: true, text: `telegram-api could not reach Telegram: ${reason}` };
+    }
+    if (!envelope.ok) {
+        log(`${TAG} op=result callId=${callId} method=${p.method} ok=false errorCode=${envelope.error_code ?? "-"} description="${envelope.description ?? ""}"`);
+        return {
+            ok: false,
+            isError: true,
+            text: `Telegram refused ${p.method} (${envelope.error_code ?? "no code"}): ${envelope.description ?? "no description"}`,
+        };
+    }
+    log(`${TAG} op=result callId=${callId} method=${p.method} ok=true`);
+    return { ok: true, isError: false, text: JSON.stringify(envelope.result ?? true, null, 2) };
+}
+function refusalProse(reason) {
+    switch (reason) {
+        case "owned-by-webhook-register":
+            return "webhook state is registered on the maxy edge-admitted path and stamped with the bot id, so a raw call here would silently repoint or stop every inbound message.";
+        case "mutually-exclusive-with-webhook":
+            return "getUpdates and webhooks are Telegram's two mutually exclusive ways of receiving updates, and it will not work while a webhook is set.";
+        default:
+            return "it moves the bot off the cloud Bot API server.";
+    }
+}
+//# sourceMappingURL=api.js.map

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

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

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

@@ -1,3 +1,4 @@
+import { type InlineKeyboardButtonInput } from "../lib/telegram.js";
 interface MessageParams {
     channel: "telegram";
     /** Task 2368 — which registered bot to send as. An account holds N bots, each
@@ -7,11 +8,7 @@ interface MessageParams {
     chatId: string | number;
     text: string;
     parseMode?: "HTML" | "Markdown" | "MarkdownV2";
-    inlineKeyboard?: Array<Array<{
-        text: string;
-        callbackData?: string;
-        url?: string;
-    }>>;
+    inlineKeyboard?: InlineKeyboardButtonInput[][];
 }
 interface MessageResult {
     sent: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/tools/message.ts"],"names":[],"mappings":"AAGA,UAAU,aAAa;IACrB,OAAO,EAAE,UAAU,CAAC;IACpB;;0CAEsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;IAC/C,cAAc,CAAC,EAAE,KAAK,CACpB,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAC7D,CAAC;CACH;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAiD3E"}
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/tools/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,yBAAyB,EAC/B,MAAM,oBAAoB,CAAC;AAG5B,UAAU,aAAa;IACrB,OAAO,EAAE,UAAU,CAAC;IACpB;;0CAEsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;IAC/C,cAAc,CAAC,EAAE,yBAAyB,EAAE,EAAE,CAAC;CAChD;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAwC3E"}

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

@@ -1,4 +1,4 @@
-import { sendMessage } from "../lib/telegram.js";
+import { sendMessage, buildInlineKeyboard, } from "../lib/telegram.js";
 import { resolveBotToken, listRegisteredBots } from "../lib/account-token.js";
 export async function message(params) {
     const platformRoot = process.env.PLATFORM_ROOT;
@@ -21,16 +21,9 @@ export async function message(params) {
             error: `No Telegram bot "${params.botId}" is registered on this account. ${known}`,
         };
     }
-    let replyMarkup;
-    if (params.inlineKeyboard) {
-        replyMarkup = {
-            inline_keyboard: params.inlineKeyboard.map((row) => row.map((btn) => ({
-                text: btn.text,
-                callback_data: btn.callbackData,
-                url: btn.url,
-            }))),
-        };
-    }
+    const replyMarkup = params.inlineKeyboard
+        ? buildInlineKeyboard(params.inlineKeyboard)
+        : undefined;
     const result = await sendMessage(botToken, {
         chatId: params.chatId,
         text: params.text,

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

@@ -1 +1 @@
-{"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/tools/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA+B,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAuB9E,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAqB;IACjD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IACzC,MAAM,QAAQ,GACZ,YAAY,IAAI,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5F,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,6EAA6E;QAC7E,2EAA2E;QAC3E,8EAA8E;QAC9E,8EAA8E;QAC9E,8EAA8E;QAC9E,0BAA0B;QAC1B,MAAM,UAAU,GAAG,YAAY,IAAI,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChG,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,KAAK,CAAC;YACnC,CAAC,CAAC,6EAA6E;YAC/E,CAAC,CAAC,mCAAmC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAClI,OAAO;YACL,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,oBAAoB,MAAM,CAAC,KAAK,oCAAoC,KAAK,EAAE;SACnF,CAAC;IACJ,CAAC;IAED,IAAI,WAA+C,CAAC;IACpD,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,WAAW,GAAG;YACZ,eAAe,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACjD,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAChB,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,aAAa,EAAE,GAAG,CAAC,YAAY;gBAC/B,GAAG,EAAE,GAAG,CAAC,GAAG;aACb,CAAC,CAAC,CACJ;SACF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE;QACzC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW;KACZ,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,EAAE;QACf,OAAO,EAAE,UAAU;QACnB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/tools/message.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,mBAAmB,GAGpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAqB9E,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAqB;IACjD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IACzC,MAAM,QAAQ,GACZ,YAAY,IAAI,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5F,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,6EAA6E;QAC7E,2EAA2E;QAC3E,8EAA8E;QAC9E,8EAA8E;QAC9E,8EAA8E;QAC9E,0BAA0B;QAC1B,MAAM,UAAU,GAAG,YAAY,IAAI,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChG,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,KAAK,CAAC;YACnC,CAAC,CAAC,6EAA6E;YAC/E,CAAC,CAAC,mCAAmC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAClI,OAAO;YACL,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,oBAAoB,MAAM,CAAC,KAAK,oCAAoC,KAAK,EAAE;SACnF,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAuC,MAAM,CAAC,cAAc;QAC3E,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,cAAc,CAAC;QAC5C,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE;QACzC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW;KACZ,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,EAAE;QACf,OAAO,EAAE,UAAU;QACnB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;AACJ,CAAC"}

package/payload/platform/plugins/telegram/skills/build/SKILL.md

@@ -0,0 +1,110 @@
+---
+name: build
+description: Build your own Telegram functionality on this install — cards with buttons, editing a card in place, answering a button press, opening a Mini App inside the chat, uploading files, and reaching any of the 185 Bot API methods through telegram-api. Use when the operator wants Telegram to do something the four named tools do not already do.
+---
+
+# Build a Telegram surface
+
+The bot is already connected (that is the `telegram:configure` skill). This skill is about what you
+build on top of it.
+
+## When to activate
+
+The operator wants Telegram to do something specific: a menu of buttons, a status card that updates
+itself, a form, a photo upload, a pinned message, a poll, a Mini App. Also activate when they ask
+"can Telegram do X" — the answer is in `references/methods.md` (all 185 method names by section),
+and this skill says how to call it.
+
+## What you have
+
+Four named tools for the common paths, and one passthrough for everything else.
+
+| Tool | Use it for |
+|---|---|
+| `mcp__telegram__message` | Sending text, with an optional inline keyboard |
+| `mcp__telegram__message-history` | Reading what arrived |
+| `mcp__telegram__telegram-webhook-register` | Registering a bot's webhook. The only sanctioned path |
+| `mcp__telegram__telegram-menu-button` | The permanent Mini App button in a bot's chats |
+| `mcp__telegram__telegram-api` | **Any** Bot API method by name |
+| `mcp__telegram__telegram-api-census` | Checking the shipped method list against the live API |
+
+`telegram-api` takes `botId` (never a token), `method`, `params`, and optionally `files` and
+`timeoutMs`. Field names inside `params` are Telegram's own snake_case.
+
+## The five methods it will not call
+
+Each refusal names the tool that owns the capability instead.
+
+| Method | Why | Use instead |
+|---|---|---|
+| `setWebhook`, `deleteWebhook` | Webhook state is registered on the one path the maxy edge admits, stamped with the bot id. A raw call silently repoints or stops every inbound message | `telegram-webhook-register` |
+| `getUpdates` | Telegram's two ways of receiving updates are mutually exclusive, and this one does not work while a webhook is set | The webhook already delivers inbound |
+| `logOut`, `close` | Both move the bot off the cloud Bot API server | Nothing. Do not do this |
+
+## Five things people actually build
+
+### 1. A card with buttons
+
+Use `message` with `inlineKeyboard`. `callbackData` is what comes back on a press, capped by
+Telegram at 1 to 64 bytes; longer data is refused with nothing in our logs to explain it. Put an id
+in it, not a sentence.
+
+```
+message channel=telegram botId=<id> chatId=<chat> text="Job 4102, Ladywell Prospect"
+  inlineKeyboard=[[{text:"Accept", callbackData:"j4102:accept"},
+                   {text:"On site", callbackData:"j4102:onsite"}]]
+```
+
+### 2. Changing that card in place
+
+A second `message` posts a new card and leaves the stale one above it. Editing keeps one card:
+
+```
+telegram-api botId=<id> method=editMessageText
+  params={chat_id:<chat>, message_id:<id of the card>, text:"Job 4102 — on site",
+          reply_markup:{inline_keyboard:[[{text:"Complete", callback_data:"j4102:done"}]]}}
+```
+
+Telegram answers `ok:false` with `Bad Request: message is not modified` when the new text and markup
+are identical to the old. That is not an error to retry; it means the edit was a no-op.
+
+### 3. Answering the press
+
+A press spins Telegram's own progress indicator for 15 seconds unless the bot answers. On this
+install the inbound route already answers every press, including refusals, so you do not normally
+call this yourself. When you build a surface that answers out of band, the method is
+`answerCallbackQuery` with the `callback_query_id`, and `show_alert:true` turns the toast into a
+dialog.
+
+### 4. A Mini App inside the chat
+
+A `url` button sends the person out to the device browser, where Telegram passes no identity at all.
+A `web_app` button opens the page inside Telegram and hands it `initData`. Use `webAppUrl` on a
+`message` button, or `telegram-menu-button` for a permanent one.
+
+Verify `initData` server-side before trusting a single field of it: the `hash` parameter is an
+HMAC-SHA-256 of the data-check-string, keyed by the HMAC-SHA-256 of the bot token with the constant
+`WebAppData`. Check `auth_date` too, or a captured `initData` replays for ever. The worked
+implementation on this install is the field sheet's route; read it rather than writing a second one.
+
+### 5. Sending a file
+
+`params` carries a `file_id` or an https URL as a plain string. A local file goes in `files`, which
+switches the request to multipart:
+
+```
+telegram-api botId=<id> method=sendPhoto
+  params={chat_id:<chat>, caption:"Before"} files={photo:"/abs/path/before.jpg"}
+```
+
+A `file_id` Telegram gave you earlier is always cheaper than re-uploading the same bytes.
+
+## Reading the method list
+
+`references/methods.md` carries all 185 names grouped as Telegram documents them: Getting updates,
+Available methods, Updating messages, Stickers, Rich messages, Inline mode, Payments, Telegram
+Passport, Games. Parameter names for a given method are in Telegram's own documentation; this list
+is what exists, not what each one takes.
+
+A method absent from that list is still relayed, so a method Telegram adds after this list was taken
+works without waiting for a release here. `telegram-api-census` is what reports the gap.