agent-messenger 2.12.0 → 2.12.2

package/dist/src/platforms/telegrambot/types.d.ts

@@ -0,0 +1,256 @@
+import { z } from 'zod';
+export interface TelegramBotEntry {
+    bot_id: string;
+    bot_name: string;
+    token: string;
+}
+export interface TelegramBotConfig {
+    current: {
+        bot_id: string;
+    } | null;
+    bots: Record<string, TelegramBotEntry>;
+}
+export interface TelegramBotCredentials {
+    token: string;
+    bot_id: string;
+    bot_name: string;
+}
+export declare class TelegramBotError extends Error {
+    code: string;
+    constructor(message: string, code: string);
+}
+export interface TelegramBotUser {
+    id: number;
+    is_bot: boolean;
+    first_name: string;
+    last_name?: string;
+    username?: string;
+    language_code?: string;
+    is_premium?: boolean;
+    can_join_groups?: boolean;
+    can_read_all_group_messages?: boolean;
+    supports_inline_queries?: boolean;
+}
+export interface TelegramChat {
+    id: number;
+    type: 'private' | 'group' | 'supergroup' | 'channel';
+    title?: string;
+    username?: string;
+    first_name?: string;
+    last_name?: string;
+    is_forum?: boolean;
+}
+export interface TelegramChatFullInfo extends TelegramChat {
+    bio?: string;
+    description?: string;
+    invite_link?: string;
+    pinned_message?: TelegramMessage;
+    permissions?: Record<string, boolean>;
+    member_count?: number;
+}
+export interface TelegramChatMember {
+    user: TelegramBotUser;
+    status: 'creator' | 'administrator' | 'member' | 'restricted' | 'left' | 'kicked';
+    is_anonymous?: boolean;
+    custom_title?: string;
+    until_date?: number;
+}
+export interface TelegramMessageEntity {
+    type: string;
+    offset: number;
+    length: number;
+    url?: string;
+    user?: TelegramBotUser;
+    language?: string;
+    custom_emoji_id?: string;
+}
+export interface TelegramPhotoSize {
+    file_id: string;
+    file_unique_id: string;
+    width: number;
+    height: number;
+    file_size?: number;
+}
+export interface TelegramDocument {
+    file_id: string;
+    file_unique_id: string;
+    thumbnail?: TelegramPhotoSize;
+    file_name?: string;
+    mime_type?: string;
+    file_size?: number;
+}
+export interface TelegramMessage {
+    message_id: number;
+    message_thread_id?: number;
+    date: number;
+    chat: TelegramChat;
+    from?: TelegramBotUser;
+    sender_chat?: TelegramChat;
+    text?: string;
+    caption?: string;
+    entities?: TelegramMessageEntity[];
+    caption_entities?: TelegramMessageEntity[];
+    reply_to_message?: TelegramMessage;
+    edit_date?: number;
+    photo?: TelegramPhotoSize[];
+    document?: TelegramDocument;
+    is_topic_message?: boolean;
+}
+export interface TelegramReactionType {
+    type: 'emoji' | 'custom_emoji' | 'paid';
+    emoji?: string;
+    custom_emoji_id?: string;
+}
+export interface TelegramCallbackQuery {
+    id: string;
+    from: TelegramBotUser;
+    message?: TelegramMessage;
+    inline_message_id?: string;
+    chat_instance: string;
+    data?: string;
+    game_short_name?: string;
+}
+export interface TelegramInlineQuery {
+    id: string;
+    from: TelegramBotUser;
+    query: string;
+    offset: string;
+    chat_type?: string;
+}
+export interface TelegramChatMemberUpdated {
+    chat: TelegramChat;
+    from: TelegramBotUser;
+    date: number;
+    old_chat_member: TelegramChatMember;
+    new_chat_member: TelegramChatMember;
+}
+export interface TelegramUpdate {
+    update_id: number;
+    message?: TelegramMessage;
+    edited_message?: TelegramMessage;
+    channel_post?: TelegramMessage;
+    edited_channel_post?: TelegramMessage;
+    inline_query?: TelegramInlineQuery;
+    chosen_inline_result?: Record<string, unknown>;
+    callback_query?: TelegramCallbackQuery;
+    shipping_query?: Record<string, unknown>;
+    pre_checkout_query?: Record<string, unknown>;
+    poll?: Record<string, unknown>;
+    poll_answer?: Record<string, unknown>;
+    my_chat_member?: TelegramChatMemberUpdated;
+    chat_member?: TelegramChatMemberUpdated;
+    chat_join_request?: Record<string, unknown>;
+    message_reaction?: Record<string, unknown>;
+    message_reaction_count?: Record<string, unknown>;
+}
+export declare const TelegramBotEntrySchema: z.ZodObject<{
+    bot_id: z.ZodString;
+    bot_name: z.ZodString;
+    token: z.ZodString;
+}, z.core.$strip>;
+export declare const TelegramBotConfigSchema: z.ZodObject<{
+    current: z.ZodNullable<z.ZodObject<{
+        bot_id: z.ZodString;
+    }, z.core.$strip>>;
+    bots: z.ZodRecord<z.ZodString, z.ZodObject<{
+        bot_id: z.ZodString;
+        bot_name: z.ZodString;
+        token: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const TelegramBotCredentialsSchema: z.ZodObject<{
+    token: z.ZodString;
+    bot_id: z.ZodString;
+    bot_name: z.ZodString;
+}, z.core.$strip>;
+export declare const TelegramBotUserSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    is_bot: z.ZodBoolean;
+    first_name: z.ZodString;
+    last_name: z.ZodOptional<z.ZodString>;
+    username: z.ZodOptional<z.ZodString>;
+    language_code: z.ZodOptional<z.ZodString>;
+    is_premium: z.ZodOptional<z.ZodBoolean>;
+    can_join_groups: z.ZodOptional<z.ZodBoolean>;
+    can_read_all_group_messages: z.ZodOptional<z.ZodBoolean>;
+    supports_inline_queries: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>;
+export declare const TelegramChatSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    type: z.ZodEnum<{
+        channel: "channel";
+        group: "group";
+        private: "private";
+        supergroup: "supergroup";
+    }>;
+    title: z.ZodOptional<z.ZodString>;
+    username: z.ZodOptional<z.ZodString>;
+    first_name: z.ZodOptional<z.ZodString>;
+    last_name: z.ZodOptional<z.ZodString>;
+    is_forum: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>;
+export declare const TelegramMessageEntitySchema: z.ZodObject<{
+    type: z.ZodString;
+    offset: z.ZodNumber;
+    length: z.ZodNumber;
+    url: z.ZodOptional<z.ZodString>;
+    user: z.ZodOptional<z.ZodObject<{
+        id: z.ZodNumber;
+        is_bot: z.ZodBoolean;
+        first_name: z.ZodString;
+        last_name: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        language_code: z.ZodOptional<z.ZodString>;
+        is_premium: z.ZodOptional<z.ZodBoolean>;
+        can_join_groups: z.ZodOptional<z.ZodBoolean>;
+        can_read_all_group_messages: z.ZodOptional<z.ZodBoolean>;
+        supports_inline_queries: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>>;
+    language: z.ZodOptional<z.ZodString>;
+    custom_emoji_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const TelegramPhotoSizeSchema: z.ZodObject<{
+    file_id: z.ZodString;
+    file_unique_id: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    file_size: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const TelegramDocumentSchema: z.ZodObject<{
+    file_id: z.ZodString;
+    file_unique_id: z.ZodString;
+    thumbnail: z.ZodOptional<z.ZodObject<{
+        file_id: z.ZodString;
+        file_unique_id: z.ZodString;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        file_size: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    file_name: z.ZodOptional<z.ZodString>;
+    mime_type: z.ZodOptional<z.ZodString>;
+    file_size: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const TelegramMessageSchema: z.ZodType<TelegramMessage>;
+export interface TelegramBotListenerOptions {
+    timeoutSeconds?: number;
+    limit?: number;
+    allowedUpdates?: string[];
+    dropPendingUpdates?: boolean;
+}
+export interface TelegramBotListenerEventMap {
+    message: [event: TelegramMessage];
+    edited_message: [event: TelegramMessage];
+    channel_post: [event: TelegramMessage];
+    edited_channel_post: [event: TelegramMessage];
+    callback_query: [event: TelegramCallbackQuery];
+    inline_query: [event: TelegramInlineQuery];
+    my_chat_member: [event: TelegramChatMemberUpdated];
+    chat_member: [event: TelegramChatMemberUpdated];
+    telegram_update: [event: TelegramUpdate];
+    connected: [info: {
+        user: TelegramBotUser;
+    }];
+    disconnected: [];
+    error: [error: Error];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/platforms/telegrambot/types.d.ts.map

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

package/dist/src/platforms/telegrambot/types.js

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+export class TelegramBotError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = 'TelegramBotError';
+        this.code = code;
+    }
+}
+export const TelegramBotEntrySchema = z.object({
+    bot_id: z.string(),
+    bot_name: z.string(),
+    token: z.string(),
+});
+export const TelegramBotConfigSchema = z.object({
+    current: z
+        .object({
+        bot_id: z.string(),
+    })
+        .nullable(),
+    bots: z.record(z.string(), TelegramBotEntrySchema),
+});
+export const TelegramBotCredentialsSchema = z.object({
+    token: z.string(),
+    bot_id: z.string(),
+    bot_name: z.string(),
+});
+export const TelegramBotUserSchema = z
+    .object({
+    id: z.number(),
+    is_bot: z.boolean(),
+    first_name: z.string(),
+    last_name: z.string().optional(),
+    username: z.string().optional(),
+    language_code: z.string().optional(),
+    is_premium: z.boolean().optional(),
+    can_join_groups: z.boolean().optional(),
+    can_read_all_group_messages: z.boolean().optional(),
+    supports_inline_queries: z.boolean().optional(),
+})
+    .passthrough();
+export const TelegramChatSchema = z
+    .object({
+    id: z.number(),
+    type: z.enum(['private', 'group', 'supergroup', 'channel']),
+    title: z.string().optional(),
+    username: z.string().optional(),
+    first_name: z.string().optional(),
+    last_name: z.string().optional(),
+    is_forum: z.boolean().optional(),
+})
+    .passthrough();
+export const TelegramMessageEntitySchema = z.object({
+    type: z.string(),
+    offset: z.number(),
+    length: z.number(),
+    url: z.string().optional(),
+    user: TelegramBotUserSchema.optional(),
+    language: z.string().optional(),
+    custom_emoji_id: z.string().optional(),
+});
+export const TelegramPhotoSizeSchema = z.object({
+    file_id: z.string(),
+    file_unique_id: z.string(),
+    width: z.number(),
+    height: z.number(),
+    file_size: z.number().optional(),
+});
+export const TelegramDocumentSchema = z.object({
+    file_id: z.string(),
+    file_unique_id: z.string(),
+    thumbnail: TelegramPhotoSizeSchema.optional(),
+    file_name: z.string().optional(),
+    mime_type: z.string().optional(),
+    file_size: z.number().optional(),
+});
+export const TelegramMessageSchema = z
+    .object({
+    message_id: z.number(),
+    message_thread_id: z.number().optional(),
+    date: z.number(),
+    chat: TelegramChatSchema,
+    from: TelegramBotUserSchema.optional(),
+    sender_chat: TelegramChatSchema.optional(),
+    text: z.string().optional(),
+    caption: z.string().optional(),
+    entities: z.array(TelegramMessageEntitySchema).optional(),
+    caption_entities: z.array(TelegramMessageEntitySchema).optional(),
+    reply_to_message: z.lazy(() => TelegramMessageSchema).optional(),
+    edit_date: z.number().optional(),
+    photo: z.array(TelegramPhotoSizeSchema).optional(),
+    document: TelegramDocumentSchema.optional(),
+    is_topic_message: z.boolean().optional(),
+})
+    .passthrough();
+//# sourceMappingURL=types.js.map

package/dist/src/platforms/telegrambot/types.js.map

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

package/docs/content/docs/cli/meta.json

@@ -8,6 +8,7 @@
     "teams",
     "webex",
     "telegram",
+    "telegrambot",
     "whatsapp",
     "whatsappbot",
     "line",

package/docs/content/docs/cli/telegrambot.mdx

@@ -0,0 +1,149 @@
+---
+title: Telegram Bot
+description: Complete reference for the agent-telegrambot CLI.
+---
+
+> **Tip**: After `npm install -g agent-messenger`, `agent-telegrambot` is available directly. For one-off execution without a global install you can use `npm exec --package agent-messenger agent-telegrambot ...`, `pnpm dlx --package agent-messenger agent-telegrambot ...`, `yarn dlx agent-messenger agent-telegrambot ...`, or `bunx --package agent-messenger agent-telegrambot ...`.
+
+## Overview
+
+`agent-telegrambot` wraps Telegram's official [HTTP Bot API](https://core.telegram.org/bots/api). It uses bot tokens issued by [@BotFather](https://t.me/BotFather) and is designed for server-side and CI/CD integrations.
+
+For acting as a real user account (not a bot), use [`agent-telegram`](./telegram) instead.
+
+## Requirements
+
+- A bot token from [@BotFather](https://t.me/BotFather)
+- Node.js 18+ or Bun runtime
+
+## Quick Start
+
+```bash
+# Set your bot token (validates against Telegram)
+agent-telegrambot auth set 123456789:ABC-DEF1234...
+
+# Verify auth
+agent-telegrambot whoami
+
+# Send a message
+agent-telegrambot message send @channelname "Hello"
+
+# Get chat info
+agent-telegrambot chat info @channelname
+```
+
+## Authentication
+
+```bash
+# Set bot token
+agent-telegrambot auth set <token>
+
+# Set with custom bot identifier
+agent-telegrambot auth set <token> --bot deploy
+
+# Check auth status
+agent-telegrambot auth status
+
+# List stored bots
+agent-telegrambot auth list
+
+# Switch active bot
+agent-telegrambot auth use <bot-id>
+
+# Remove a stored bot
+agent-telegrambot auth remove <bot-id>
+
+# Clear all credentials
+agent-telegrambot auth clear
+```
+
+Credentials are stored in `~/.config/agent-messenger/telegrambot-credentials.json` (0600 permissions).
+
+## Commands
+
+### Messages
+
+```bash
+# Send a text message
+agent-telegrambot message send <chat> <text>
+
+# Format with Markdown or HTML
+agent-telegrambot message send <chat> "<b>Bold</b>" --parse-mode HTML
+
+# Reply to a specific message
+agent-telegrambot message send <chat> "Reply" --reply-to 12345
+
+# Send silently
+agent-telegrambot message send <chat> "..." --silent
+
+# Forum topic
+agent-telegrambot message send <chat> "..." --thread-id 5
+
+# Edit a message
+agent-telegrambot message update <chat> <message-id> <new-text>
+
+# Delete a message
+agent-telegrambot message delete <chat> <message-id> --force
+
+# Forward a message
+agent-telegrambot message forward <to-chat> <from-chat> <message-id>
+
+# Upload a document
+agent-telegrambot message upload <chat> ./file.pdf --caption "Report"
+```
+
+### Chats
+
+```bash
+# Get chat info (title, type, description, member count)
+agent-telegrambot chat info <chat>
+
+# Get a specific member's status
+agent-telegrambot chat member <chat> <user-id>
+```
+
+### Reactions
+
+```bash
+# Set a reaction (replaces existing)
+agent-telegrambot reaction set <chat> <message-id> 👍
+
+# Big animation
+agent-telegrambot reaction set <chat> <message-id> 👍 --big
+
+# Clear reactions
+agent-telegrambot reaction clear <chat> <message-id>
+```
+
+### Whoami
+
+```bash
+agent-telegrambot whoami
+agent-telegrambot whoami --bot <bot-id>
+```
+
+## Chat IDs
+
+The `<chat>` argument accepts:
+
+- **Numeric ID**: `123456789` (user), `-1001234567890` (supergroup/channel)
+- **@username**: `@channelname` (public chats only)
+- **Plain username**: `channelname` (auto-prefixed with `@`)
+
+## Global Options
+
+| Option       | Description                           |
+| ------------ | ------------------------------------- |
+| `--pretty`   | Human-readable output instead of JSON |
+| `--bot <id>` | Use a specific bot for this command   |
+
+## Real-Time Events
+
+The CLI does not expose real-time events, but the SDK does — via long-polling. See the [SDK reference](../sdk/telegrambot) for `TelegramBotListener`.
+
+## Common Errors
+
+- `Unauthorized` — Invalid or revoked token. Generate a new one via @BotFather.
+- `Forbidden` — User hasn't `/start`ed the bot, bot was kicked, or bot lacks permissions.
+- `Bad Request: chat not found` — Wrong chat ID or bot isn't in the chat.
+- `Conflict` — Another polling instance (or webhook) is active for this bot.

package/docs/content/docs/index.mdx

@@ -33,14 +33,14 @@ No app creation. No admin approval. No waiting.
 
 ## Key Features
 
-| Feature             | Description                                                                                                                                                          |
-| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **Auto-extraction** | Pulls tokens from desktop apps automatically                                                                                                                         |
-| **Multi-platform**  | Slack, Discord, Microsoft Teams, Telegram, WhatsApp, LINE, Instagram, KakaoTalk, and Channel Talk (beta)                                                             |
-| **Multi-workspace** | Switch between workspaces/servers easily                                                                                                                             |
-| **JSON output**     | Machine-readable by default, `--pretty` for humans                                                                                                                   |
-| **Comprehensive**   | Messages, channels, users, reactions, files                                                                                                                          |
-| **Bot support**     | [`agent-slackbot`](/docs/cli/slackbot), [`agent-discordbot`](/docs/cli/discordbot), and [`agent-channeltalkbot`](/docs/cli/channeltalkbot) for server-side and CI/CD |
+| Feature             | Description                                                                                                                                                                                                        |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| **Auto-extraction** | Pulls tokens from desktop apps automatically                                                                                                                                                                       |
+| **Multi-platform**  | Slack, Discord, Microsoft Teams, Telegram, WhatsApp, LINE, Instagram, KakaoTalk, and Channel Talk (beta)                                                                                                           |
+| **Multi-workspace** | Switch between workspaces/servers easily                                                                                                                                                                           |
+| **JSON output**     | Machine-readable by default, `--pretty` for humans                                                                                                                                                                 |
+| **Comprehensive**   | Messages, channels, users, reactions, files                                                                                                                                                                        |
+| **Bot support**     | [`agent-slackbot`](/docs/cli/slackbot), [`agent-discordbot`](/docs/cli/discordbot), [`agent-telegrambot`](/docs/cli/telegrambot), and [`agent-channeltalkbot`](/docs/cli/channeltalkbot) for server-side and CI/CD |
 
 ## Why Not MCP?
 
@@ -81,7 +81,7 @@ OAuth is better when you need:
 - **Multi-user applications** - Many users authenticating separately
 - **Granular permissions** - Fine-tuned access control
 
-For these use cases, Agent Messenger also supports bot tokens via [`agent-slackbot`](/docs/cli/slackbot), [`agent-discordbot`](/docs/cli/discordbot), and [`agent-channeltalkbot`](/docs/cli/channeltalkbot).
+For these use cases, Agent Messenger also supports bot tokens via [`agent-slackbot`](/docs/cli/slackbot), [`agent-discordbot`](/docs/cli/discordbot), [`agent-telegrambot`](/docs/cli/telegrambot), and [`agent-channeltalkbot`](/docs/cli/channeltalkbot).
 
 ## Design Principles
 
@@ -114,6 +114,7 @@ Tokens stay on your machine. Nothing is sent to external servers. Your credentia
 - [Discord Bot](/docs/cli/discordbot) - Bot token integration for server-side and CI/CD
 - [Teams](/docs/cli/teams) - Full Teams command reference
 - [Telegram](/docs/cli/telegram) - TDLib setup and Telegram command reference
+- [Telegram Bot](/docs/cli/telegrambot) - Bot token integration for server-side and CI/CD
 - [WhatsApp](/docs/cli/whatsapp) - Full WhatsApp command reference
 - [WhatsApp Bot](/docs/cli/whatsappbot) - Cloud API integration for WhatsApp Business
 - [LINE](/docs/cli/line) - Full LINE command reference

package/docs/content/docs/quick-start.mdx

@@ -31,6 +31,7 @@ This installs these CLI tools:
 - `agent-discordbot` — Discord Bot CLI (bot token, for server-side/CI/CD)
 - `agent-teams` — Microsoft Teams CLI
 - `agent-telegram` — Telegram CLI (user account via TDLib)
+- `agent-telegrambot` — Telegram Bot CLI (bot token, for server-side/CI/CD)
 - `agent-whatsapp` — WhatsApp CLI (user account via Baileys, pairing code auth)
 - `agent-whatsappbot` — WhatsApp Bot CLI (Cloud API, for server-side/CI/CD)
 - `agent-line` — LINE CLI (QR code login, Thrift protocol)
@@ -123,6 +124,7 @@ agent-slack workspace current
 - [Discord Bot Reference](/docs/cli/discordbot) - Bot token for server-side/CI/CD
 - [Teams Reference](/docs/cli/teams) - Full command reference
 - [Telegram Reference](/docs/cli/telegram) - TDLib setup and command reference
+- [Telegram Bot Reference](/docs/cli/telegrambot) - Bot token for server-side/CI/CD
 - [WhatsApp Reference](/docs/cli/whatsapp) - Full command reference
 - [WhatsApp Bot Reference](/docs/cli/whatsappbot) - Cloud API for WhatsApp Business
 - [KakaoTalk Reference](/docs/cli/kakaotalk) - Full command reference

package/docs/content/docs/sdk/meta.json

@@ -7,6 +7,7 @@
     "discordbot",
     "teams",
     "webex",
+    "telegrambot",
     "whatsapp",
     "whatsappbot",
     "line",