Add a Telegram adapter

DESCRIPTION

@@ -1,7 +1,7 @@
 Package: chat.api
 Type: Package
 Title: Transport-Agnostic Chat Contract for R Agents
-Version: 0.0.1.26
+Version: 0.0.1.27
 Date: 2026-09-07
 Authors@R: c(
     person("Troy", "Hernandez", role = c("aut", "cre"),
@@ -10,7 +10,8 @@ Authors@R: c(
     person("cornball.ai", role = "cph"))
 Description: A transport-agnostic contract for chat-room connectivity:
     connect, poll, and send against one interface, with adapters for
-    'Matrix', 'Slack', Internet Relay Chat (IRC), and other platforms
+    'Matrix', 'Slack', 'Telegram', Internet Relay Chat (IRC), and other
+    platforms
     supplied by optional packages. The contract is the union of the
     parameters found across the R chat-client ecosystem, with per-adapter
     capability flags for threads, markup dialects, encryption, and

NAMESPACE

@@ -36,23 +36,27 @@ export(chat_send)
 export(chat_set_identity)
 export(chat_set_state)
 export(chat_slack)
+export(chat_telegram)
 export(chat_typing)
 export(chat_whoami)
 
 S3method(chat_addressed,chat_irc)
 S3method(chat_addressed,chat_matrix)
 S3method(chat_addressed,chat_slack)
+S3method(chat_addressed,chat_telegram)
 S3method(chat_addressed,default)
 S3method(chat_capabilities,chat_irc)
 S3method(chat_capabilities,chat_loopback)
 S3method(chat_capabilities,chat_matrix)
 S3method(chat_capabilities,chat_slack)
+S3method(chat_capabilities,chat_telegram)
 S3method(chat_channel_create,chat_loopback)
 S3method(chat_channel_create,chat_matrix)
 S3method(chat_channel_create,chat_slack)
 S3method(chat_channel_create,default)
 S3method(chat_channel_info,chat_matrix)
 S3method(chat_channel_info,chat_slack)
+S3method(chat_channel_info,chat_telegram)
 S3method(chat_channel_info,default)
 S3method(chat_channels,chat_loopback)
 S3method(chat_channels,chat_matrix)
@@ -62,10 +66,12 @@ S3method(chat_disconnect,chat_irc)
 S3method(chat_disconnect,default)
 S3method(chat_download,chat_loopback)
 S3method(chat_download,chat_matrix)
+S3method(chat_download,chat_telegram)
 S3method(chat_download,default)
 S3method(chat_edit,chat_loopback)
 S3method(chat_edit,chat_matrix)
 S3method(chat_edit,chat_slack)
+S3method(chat_edit,chat_telegram)
 S3method(chat_edit,default)
 S3method(chat_get_state,chat_loopback)
 S3method(chat_get_state,chat_matrix)
@@ -79,6 +85,7 @@ S3method(chat_join,chat_slack)
 S3method(chat_join,default)
 S3method(chat_leave,chat_matrix)
 S3method(chat_leave,chat_slack)
+S3method(chat_leave,chat_telegram)
 S3method(chat_leave,default)
 S3method(chat_mark_read,chat_matrix)
 S3method(chat_mark_read,chat_slack)
@@ -92,32 +99,39 @@ S3method(chat_poll,chat_irc)
 S3method(chat_poll,chat_loopback)
 S3method(chat_poll,chat_matrix)
 S3method(chat_poll,chat_slack)
+S3method(chat_poll,chat_telegram)
 S3method(chat_react,chat_matrix)
 S3method(chat_react,chat_slack)
+S3method(chat_react,chat_telegram)
 S3method(chat_react,default)
 S3method(chat_relogin,chat_matrix)
 S3method(chat_relogin,default)
 S3method(chat_resolve,chat_irc)
 S3method(chat_resolve,chat_loopback)
 S3method(chat_resolve,chat_matrix)
 S3method(chat_resolve,chat_slack)
+S3method(chat_resolve,chat_telegram)
 S3method(chat_send,chat_irc)
 S3method(chat_send,chat_loopback)
 S3method(chat_send,chat_matrix)
 S3method(chat_send,chat_slack)
+S3method(chat_send,chat_telegram)
 S3method(chat_set_identity,chat_irc)
 S3method(chat_set_identity,chat_matrix)
 S3method(chat_set_identity,chat_slack)
+S3method(chat_set_identity,chat_telegram)
 S3method(chat_set_identity,default)
 S3method(chat_set_state,chat_loopback)
 S3method(chat_set_state,chat_matrix)
 S3method(chat_set_state,default)
 S3method(chat_typing,chat_matrix)
+S3method(chat_typing,chat_telegram)
 S3method(chat_typing,default)
 S3method(chat_whoami,chat_irc)
 S3method(chat_whoami,chat_loopback)
 S3method(chat_whoami,chat_matrix)
 S3method(chat_whoami,chat_slack)
+S3method(chat_whoami,chat_telegram)
 S3method(chat_whoami,default)
 S3method(print,chat_attachment)
 S3method(print,chat_config)

NEWS.md

@@ -1,3 +1,15 @@
+# chat.api 0.0.1.27
+
+* New Telegram adapter, chat_telegram(), over the Bot API with HTTP
+  delegated to the suggested httr package. getUpdates long polling is
+  the poll, with a single update offset as the cursor. Sends render
+  markdown to Telegram HTML and carry threads, replies, files, and
+  silent delivery; edits, emoji reactions and reaction events, typing,
+  chat info, leaving, identity, @username addressing, and attachment
+  fetch through getFile are wired. Capabilities report what the Bot
+  API lacks: history, member and chat lists, read markers, joining,
+  and creating.
+
 # chat.api 0.0.1.26
 
 * Slack gains chat_channel_create() and chat_leave(), posting