@volter/twin-telegram 1.0.0

package/journeys/vendor-examples.verdict.json

@@ -0,0 +1,14 @@
+{
+  "judge": {
+    "agent": "Claude Code (Claude Agent SDK), model claude-opus-5-5",
+    "name": "Contributor 106"
+  },
+  "authors": [
+    "Contributor 173"
+  ],
+  "bar": "829132787d94a2d4",
+  "sha256": "fcd35e8064871b6b6b87c60ea7eb9a6bf92a1740269afa3aed217a10a2104ac5",
+  "judgedAt": "2026-10-02",
+  "plausible": true,
+  "rulings": []
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@volter/twin-telegram",
+  "version": "1.0.0",
+  "description": "The telegram twin (Protocol 3).",
+  "author": "Volter (https://github.com/volter-ai)",
+  "license": "Apache-2.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    }
+  },
+  "bin": {
+    "world-telegram": "dist/src/cli.js"
+  },
+  "files": [
+    "src",
+    "journeys",
+    "spec",
+    "README.md",
+    "!**/*.test.ts",
+    "dist",
+    "generated"
+  ],
+  "peerDependencies": {
+    "@volter/world-core": "^3.0.38"
+  },
+  "engines": {
+    "node": ">=22.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/volter-ai/twin-packs-p3.git",
+    "directory": "telegram"
+  }
+}

package/spec/SOURCE.md

@@ -0,0 +1,51 @@
+# telegram spec — provenance
+
+- **Why this document:** Telegram publishes no machine-readable description of its Bot API. `openapi.json.gz` is written
+  from its reference page, https://core.telegram.org/bots/api, as Telegram serves it (fetched 2026-10-02, HTML,
+  860074 bytes, sha256 `9da688c4213864d7911fcf0f501d2d7a8c3bbc351b8b4325e85e509bcc9d969f`; the page's "Recent changes"
+  head it **Bot API 10.3**, August 24, 2026).
+- **How it was written:** mechanically from the page's HTML by `page-to-openapi.ts`, kept here
+  (`gunzip -c spec/bot-api.html.gz > page.html; bun spec/page-to-openapi.ts page.html openapi.json`, then `gzip -n -9`), from the bytes named above, kept here as `bot-api.html.gz`, every
+  section of methods and types it documents (Getting updates, Available types, Available methods, Updating messages,
+  Stickers, Rich messages, Inline mode, Payments, Telegram Passport, Games): 185 methods and 400 types.
+  - A method (an `h4` with a lower-case name and a Parameter/Type/Required/Description table) is
+    `POST /bot{token}/<method>` (the page's "https://api.telegram.org/bot<token>/METHOD_NAME"), its operationId the
+    method's name, its tag the page's section; its parameters a body taken as JSON, form or multipart, and the same
+    parameters again in the query string, none required there (the page's "four ways of passing parameters", the
+    first of them the URL query string: Postiz's node-telegram-bot-api sends a medium's chat_id and caption in the
+    query beside its multipart file), `Required: Yes` required in the body; its answer `{ ok: true, result }` with the result the
+    method's text says is returned (a linked type, "Array of", True, String or Integer; several, `oneOf`), and any
+    other answer the error envelope `{ ok: false, error_code, description, parameters? }` (Making requests).
+  - Every type a method's result names (by itself, as an array's items, or as one of several) is declared a resource
+    under its own name (`x-resourceId`): it is what the Bot API answers under `result` ("the result of the query can be
+    found in the 'result' field", Making requests). The page has no GET read for the spec IR to infer resources from
+    (every method is written as a POST), and without them the IR reads no answer through its envelope: with them, each
+    such operation answers its type under `answers.key: result`, which perform and refresh read.
+  - A type (an `h4` with a capitalized name) is an object of its Field/Type/Description table, a field whose description
+    begins "Optional." optional; one described as one of a list of types, a `oneOf` of them. A type cell reads Integer,
+    String, Boolean, True, Float, InputFile (binary), "Array of X" and "X or Y"; a string field whose description states
+    its values in quotes ("can be", "must be", "one of", "always") takes them as its `enum`.
+  - The file download getFile names, `GET /file/bot{token}/{file_path}`, is the operation `downloadFile`.
+  - Not carried: that every method is also asked by GET, and that method names are matched without case (the page's
+    Making requests); the document declares the POST under the documented name, and the twin's around.ts routes the
+    other forms to it.
+- **Version:** `10.3` (`info.version`); server `https://api.telegram.org`.
+- **SHA-256 of the uncompressed document:** `2517cfd1598ef743219d56788e772d88cc2420538a9d2688d5fd38d429cb023d`
+  (`openapi.json.gz` is it gzipped with no name or time, `gzip -n -9`).
+- **Corrections:** `patches.json` (RFC 6902, each with its reason and source): `reply_to_message_id` added to the
+  bodies and the query parameters of sendMessage, sendPhoto, sendVideo, sendDocument and sendMediaGroup. The page no longer lists it, but the Bot
+  API server still reads it when a request carries no `reply_parameters` (tdlib/telegram-bot-api, Client.cpp at
+  e3e9dd8), and node-telegram-bot-api 0.66.0, as Postiz calls it, sends it.
+- **Grouping:** `grouping.json` (`{ "by": "tag" }`): every path begins `/bot{token}/`, so an operation's family is the
+  page's section it is documented in.
+- **Other sources read:** the Bot API server's own source, which the page names ("Using a Local Bot API Server"),
+  tdlib/telegram-bot-api at e3e9dd8 (Client.cpp, Client.h, ClientManager.cpp, HttpConnection.cpp, Query.cpp), and the
+  TDLib it relays errors from, tdlib/td at 42e6a52 (td/telegram/MessageEntity.cpp, MessageContent.cpp,
+  MessagesManager.cpp), each read as raw files and cited where the page says nothing (the refusals' words, the token's
+  check, getUpdates' limits, the HTML parse mode); https://core.telegram.org/bots/features (BotFather, privacy mode)
+  and https://core.telegram.org/bots/faq (the limits), read with `twin-standard read-page`.
+- **Cited pages:** `sources.json`, check-sources' record of every page a `// source:` line cites.
+- **Read:** 2026-10-02; written again from
+  the same bytes with the query parameters, 2026-10-02, and again with
+  the answered types' `x-resourceId`, 2026-10-02; derived with
+  `bun scripts/derive-pack.ts telegram`, which writes `../src/generated/surface.gen.json`.

package/spec/doc-examples.json

@@ -0,0 +1,344 @@
+[
+  {
+    "title": "Making requests: getMe",
+    "source": "https://core.telegram.org/bots/api#making-requests",
+    "operation": "getMe",
+    "means": "All queries to the Telegram Bot API must be served over HTTPS and need to be presented in this form: https://api.telegram.org/bot<token>/METHOD_NAME. Like this for example: https://api.telegram.org/bot123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11/getMe We support GET and POST HTTP methods."
+  },
+  {
+    "title": "Making requests: methods are case-insensitive",
+    "source": "https://core.telegram.org/bots/api#making-requests",
+    "operation": "getMe",
+    "means": "All methods in the Bot API are case-insensitive."
+  },
+  {
+    "title": "HTML style",
+    "source": "https://core.telegram.org/bots/api#html-style",
+    "operation": "sendMessage",
+    "input": {
+      "text": "<b>bold</b>, <strong>bold</strong>\n<i>italic</i>, <em>italic</em>\n<u>underline</u>, <ins>underline</ins>\n<s>strikethrough</s>, <strike>strikethrough</strike>, <del>strikethrough</del>\n<span class=\"tg-spoiler\">spoiler</span>, <tg-spoiler>spoiler</tg-spoiler>\n<b>bold <i>italic bold <s>italic bold strikethrough <span class=\"tg-spoiler\">italic bold strikethrough spoiler</span></s> <u>underline italic bold</u></i> bold</b>\n<a href=\"http://www.example.com/\">inline URL</a>\n<a href=\"tg://user?id=123456789\">inline mention of a user</a>\n<tg-emoji emoji-id=\"5368324170671202286\">👍</tg-emoji>\n<tg-time unix=\"1647531900\" format=\"wDT\">22:45 tomorrow</tg-time>\n<tg-time unix=\"1647531900\" format=\"t\">22:45 tomorrow</tg-time>\n<tg-time unix=\"1647531900\" format=\"r\">22:45 tomorrow</tg-time>\n<tg-time unix=\"1647531900\">22:45 tomorrow</tg-time>\n<code>inline fixed-width code</code>\n<pre>pre-formatted fixed-width code block</pre>\n<pre><code class=\"language-python\">pre-formatted fixed-width code block written in the Python programming language</code></pre>\n<blockquote>Block quotation started\nBlock quotation continued\nThe last line of the block quotation</blockquote>\n<blockquote expandable>Expandable block quotation started\nExpandable block quotation continued\nExpandable block quotation continued\nHidden by default part of the block quotation started\nExpandable block quotation continued\nThe last line of the block quotation</blockquote>",
+      "parse_mode": "HTML"
+    },
+    "means": "To use this mode, pass HTML in the parse_mode field. The following tags are currently supported:"
+  },
+  {
+    "title": "HTML style: only the tags mentioned",
+    "source": "https://core.telegram.org/bots/api#html-style",
+    "operation": "sendMessage",
+    "status": 400,
+    "input": {
+      "text": "<p>Standup notes</p>",
+      "parse_mode": "HTML"
+    },
+    "means": "Only the tags mentioned above are currently supported."
+  },
+  {
+    "title": "HTML style: symbols outside a tag must be entities",
+    "source": "https://core.telegram.org/bots/api#html-style",
+    "operation": "sendMessage",
+    "status": 400,
+    "input": {
+      "text": "Ship if 2 < 3",
+      "parse_mode": "HTML"
+    },
+    "means": "All < , > and & symbols that are not a part of a tag or an HTML entity must be replaced with the corresponding HTML entities ( < with &lt; , > with &gt; and & with &amp; )."
+  },
+  {
+    "title": "HTML style: entities",
+    "source": "https://core.telegram.org/bots/api#html-style",
+    "operation": "sendMessage",
+    "input": {
+      "text": "Tide &amp; Co &#128640; &#x2764; &lt;3 &hearts;",
+      "parse_mode": "HTML"
+    },
+    "means": "All numerical HTML entities are supported. The API currently supports only the following named HTML entities: &lt; , &gt; , &amp; and &quot; ."
+  },
+  {
+    "title": "sendMessage: text over 4096 characters",
+    "source": "https://core.telegram.org/bots/api#sendmessage",
+    "operation": "sendMessage",
+    "status": 400,
+    "input": {
+      "text": "Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the standup. Notes from the st"
+    },
+    "means": "Text of the message to be sent, 1-4096 characters after entities parsing"
+  },
+  {
+    "title": "sendMessage: no text",
+    "source": "https://core.telegram.org/bots/api#sendmessage",
+    "operation": "sendMessage",
+    "status": 400,
+    "input": {
+      "text": ""
+    },
+    "means": "Text of the message to be sent, 1-4096 characters after entities parsing"
+  },
+  {
+    "title": "getUpdates: limit",
+    "source": "https://core.telegram.org/bots/api#getupdates",
+    "operation": "getUpdates",
+    "input": {
+      "limit": 1
+    },
+    "means": "Limits the number of updates to be retrieved. Values between 1-100 are accepted. Defaults to 100."
+  },
+  {
+    "title": "getUpdates: a negative offset",
+    "source": "https://core.telegram.org/bots/api#getupdates",
+    "operation": "getUpdates",
+    "input": {
+      "offset": -1
+    },
+    "means": "The negative offset can be specified to retrieve updates starting from -offset update from the end of the updates queue. All previous updates will be forgotten."
+  },
+  {
+    "title": "getUpdates: allowed_updates and the updates made before",
+    "source": "https://core.telegram.org/bots/api#getupdates",
+    "operation": "getUpdates",
+    "input": {
+      "allowed_updates": [
+        "channel_post"
+      ]
+    },
+    "means": "Please note that this parameter doesn't affect updates created before the call to getUpdates, so unwanted updates may be received for a short period of time."
+  },
+  {
+    "title": "deleteWebhook: drop pending updates",
+    "source": "https://core.telegram.org/bots/api#deletewebhook",
+    "operation": "deleteWebhook",
+    "input": {
+      "drop_pending_updates": true
+    },
+    "means": "Pass True to drop all pending updates"
+  },
+  {
+    "title": "sendChatAction: an action",
+    "source": "https://core.telegram.org/bots/api#sendchataction",
+    "operation": "sendChatAction",
+    "status": 400,
+    "input": {
+      "action": "thinking"
+    },
+    "means": "Type of action to broadcast. Choose one, depending on what the user is about to receive: typing for text messages , upload_photo for photos , record_video or upload_video for videos , record_voice or upload_voice for voice notes , upload_document for general files , choose_sticker for stickers , find_location for location data , record_video_note or upload_video_note for video notes ."
+  },
+  {
+    "title": "deleteMessage: an incoming message in a private chat",
+    "source": "https://core.telegram.org/bots/api#deletemessage",
+    "operation": "deleteMessage",
+    "means": "Bots can delete incoming messages in private chats."
+  },
+  {
+    "title": "deleteMessage: 48 hours",
+    "source": "https://core.telegram.org/bots/api#deletemessage",
+    "operation": "deleteMessage",
+    "status": 400,
+    "means": "A message can only be deleted if it was sent less than 48 hours ago."
+  },
+  {
+    "title": "deleteMessage: a channel's creation",
+    "source": "https://core.telegram.org/bots/api#deletemessage",
+    "operation": "deleteMessage",
+    "status": 400,
+    "input": {
+      "message_id": 1
+    },
+    "means": "Service messages about a supergroup, channel, or forum topic creation can't be deleted."
+  },
+  {
+    "title": "deleteMessage: an administrator of a group",
+    "source": "https://core.telegram.org/bots/api#deletemessage",
+    "operation": "deleteMessage",
+    "means": "If the bot is an administrator of a group, it can delete any message there."
+  },
+  {
+    "title": "deleteMessage: outgoing in a group",
+    "source": "https://core.telegram.org/bots/api#deletemessage",
+    "operation": "deleteMessage",
+    "means": "Bots can delete outgoing messages in private chats, groups, and supergroups."
+  },
+  {
+    "title": "sendMediaGroup: documents with their own type only",
+    "source": "https://core.telegram.org/bots/api#sendmediagroup",
+    "operation": "sendMediaGroup",
+    "status": 400,
+    "means": "Documents and audio files can be only grouped in an album with messages of the same type."
+  },
+  {
+    "title": "sendPhoto: width and height ratio",
+    "source": "https://core.telegram.org/bots/api#sendphoto",
+    "operation": "sendPhoto",
+    "status": 400,
+    "means": "The photo's width and height must not exceed 10000 in total. Width and height ratio must be at most 20."
+  },
+  {
+    "title": "sendPhoto: 10 MB",
+    "source": "https://core.telegram.org/bots/api#sendphoto",
+    "operation": "sendPhoto",
+    "status": 400,
+    "means": "The photo must be at most 10 MB in size."
+  },
+  {
+    "title": "sendVideo: 50 MB",
+    "source": "https://core.telegram.org/bots/api#sendvideo",
+    "operation": "sendVideo",
+    "status": 400,
+    "means": "Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future."
+  },
+  {
+    "title": "sendDocument: 50 MB",
+    "source": "https://core.telegram.org/bots/api#senddocument",
+    "operation": "sendDocument",
+    "status": 400,
+    "means": "Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future."
+  },
+  {
+    "title": "MarkdownV2 style",
+    "source": "https://core.telegram.org/bots/api#markdownv2-style",
+    "operation": "sendMessage",
+    "input": {
+      "text": "*bold \\*text*\n_italic \\*text_\n__underline__\n~strikethrough~\n||spoiler||\n*bold _italic bold ~italic bold strikethrough ||italic bold strikethrough spoiler||~ __underline italic bold___ bold*\n[inline URL](http://www.example.com/)\n[inline mention of a user](tg://user?id=123456789)\n![👍](tg://emoji?id=5368324170671202286)\n![22:45 tomorrow](tg://time?unix=1647531900&format=wDT)\n![22:45 tomorrow](tg://time?unix=1647531900&format=t)\n![22:45 tomorrow](tg://time?unix=1647531900&format=r)\n![22:45 tomorrow](tg://time?unix=1647531900)\n`inline fixed-width code`\n```\npre-formatted fixed-width code block\n```\n```python\npre-formatted fixed-width code block written in the Python programming language\n```\n>Block quotation started\n>Block quotation continued\n>Block quotation continued\n>Block quotation continued\n>The last line of the block quotation\n**>The expandable block quotation started right after the previous block quotation\n>It is separated from the previous block quotation by an empty bold entity\n>Expandable block quotation continued\n>Hidden by default part of the expandable block quotation started\n>Expandable block quotation continued\n>The last line of the expandable block quotation with the expandability mark||",
+      "parse_mode": "MarkdownV2"
+    },
+    "means": "To use this mode, pass MarkdownV2 in the parse_mode field. Use the following syntax in your message:"
+  },
+  {
+    "title": "Markdown style",
+    "source": "https://core.telegram.org/bots/api#markdown-style",
+    "operation": "sendMessage",
+    "input": {
+      "text": "*bold text*\n_italic text_\n[inline URL](http://www.example.com/)\n[inline mention of a user](tg://user?id=123456789)\n`inline fixed-width code`\n```\npre-formatted fixed-width code block\n```\n```python\npre-formatted fixed-width code block written in the Python programming language\n```",
+      "parse_mode": "Markdown"
+    },
+    "means": "This is a legacy mode, retained for backward compatibility. To use this mode, pass Markdown in the parse_mode field. Use the following syntax in your message:"
+  },
+  {
+    "title": "MarkdownV2 style: reserved characters",
+    "source": "https://core.telegram.org/bots/api#markdownv2-style",
+    "operation": "sendMessage",
+    "status": 400,
+    "input": {
+      "text": "Standup moved to 10.30",
+      "parse_mode": "MarkdownV2"
+    },
+    "means": "In all other places characters '_', '*', '[', ']', '(', ')', '~', '`', '>', '#', '+', '-', '=', '|', '{', '}', '.', '!' must be escaped with the preceding character '\\'."
+  },
+  {
+    "title": "MarkdownV2 style: italic and underline",
+    "source": "https://core.telegram.org/bots/api#markdownv2-style",
+    "operation": "sendMessage",
+    "input": {
+      "text": "___italic underline_**__",
+      "parse_mode": "MarkdownV2"
+    },
+    "means": "In case of ambiguity between italic and underline entities __ is always greedily treated from left to right as beginning or end of an underline entity, so instead of ___italic underline___ use ___italic underline_**__ , adding an empty bold entity as a separator."
+  },
+  {
+    "title": "MarkdownV2 style: the expandability mark",
+    "source": "https://core.telegram.org/bots/api#markdownv2-style",
+    "operation": "sendMessage",
+    "means": "The last line of the expandable block quotation with the expandability mark||"
+  },
+  {
+    "title": "Markdown style: escaping",
+    "source": "https://core.telegram.org/bots/api#markdown-style",
+    "operation": "sendMessage",
+    "input": {
+      "text": "_snake_\\__case_ and *2*\\**2=4*",
+      "parse_mode": "Markdown"
+    },
+    "means": "Escaping inside entities is not allowed, so entity must be closed first and reopened again: use _snake_\\__case_ for italic snake_case and *2*\\**2=4* for bold 2*2=4 ."
+  },
+  {
+    "title": "Formatting options: a mention by id",
+    "source": "https://core.telegram.org/bots/api#formatting-options",
+    "operation": "sendMessage",
+    "means": "Links tg://user?id=<user_id> can be used to mention a user by their identifier without using a username."
+  },
+  {
+    "title": "sendPhoto: a file Telegram cannot process as an image",
+    "source": "https://core.telegram.org/method/messages.sendMedia",
+    "operation": "sendPhoto",
+    "status": 400,
+    "means": "IMAGE_PROCESS_FAILED Failure while processing image."
+  },
+  {
+    "title": "sendMessage: a channel's username",
+    "source": "https://core.telegram.org/bots/api#sendmessage",
+    "operation": "sendMessage",
+    "input": {
+      "chat_id": "@rui_notes_news",
+      "text": "The notes channel is open."
+    },
+    "means": "Unique identifier for the target chat or username of the target bot, supergroup or channel in the format @username"
+  },
+  {
+    "title": "ReplyParameters: sent without the message replied to",
+    "source": "https://core.telegram.org/bots/api#replyparameters",
+    "operation": "sendMessage",
+    "input": {
+      "text": "Re: the printer shop",
+      "reply_parameters": {
+        "message_id": 999,
+        "allow_sending_without_reply": true
+      }
+    },
+    "means": "Pass True if the message should be sent even if the specified message to be replied to is not found."
+  },
+  {
+    "title": "sendPhoto: a file_id",
+    "source": "https://core.telegram.org/bots/api#sendphoto",
+    "operation": "sendPhoto",
+    "means": "Pass a file_id as String to send a photo that exists on the Telegram servers (recommended)"
+  },
+  {
+    "title": "sendPhoto: an HTTP URL",
+    "source": "https://core.telegram.org/bots/api#sendphoto",
+    "operation": "sendPhoto",
+    "input": {
+      "photo": "https://telegram.org/img/t_logo.png"
+    },
+    "means": "pass an HTTP URL as a String for Telegram to get a photo from the Internet"
+  },
+  {
+    "title": "Sending files: a file_id is one bot's",
+    "source": "https://core.telegram.org/bots/api#sending-files",
+    "operation": "sendPhoto",
+    "status": 400,
+    "means": "file_id is unique for each individual bot and can't be transferred from one bot to another."
+  },
+  {
+    "title": "Sending files: a file keeps its type",
+    "source": "https://core.telegram.org/bots/api#sending-files",
+    "operation": "sendDocument",
+    "status": 400,
+    "means": "It is not possible to change the file type when resending by file_id . I.e. a video can't be sent as a photo , a photo can't be sent as a document , etc."
+  },
+  {
+    "title": "ChatMemberAdministrator: posting in a channel",
+    "source": "https://core.telegram.org/bots/api#chatmemberadministrator",
+    "operation": "sendMessage",
+    "status": 400,
+    "means": "Optional . True , if the administrator can post messages in the channel, approve suggested posts, or access channel statistics; for channels only"
+  },
+  {
+    "title": "ChatMemberBanned: a banned bot",
+    "source": "https://core.telegram.org/bots/api#chatmemberbanned",
+    "operation": "getChat",
+    "status": 403,
+    "means": "Represents a chat member that was banned in the chat and can't return to the chat or view chat messages."
+  },
+  {
+    "title": "ChatMemberLeft: a bot not in a channel",
+    "source": "https://core.telegram.org/bots/api#chatmemberleft",
+    "operation": "sendMessage",
+    "status": 403,
+    "means": "Represents a chat member that isn't currently a member of the chat, but may join it themselves."
+  },
+  {
+    "title": "getFile: 20 MB",
+    "source": "https://core.telegram.org/bots/api#getfile",
+    "operation": "getFile",
+    "status": 400,
+    "means": "For the moment, bots can download files of up to 20MB in size."
+  }
+]

package/spec/grouping.json

@@ -0,0 +1 @@
+{ "by": "tag" }