claude-telegram-mirror 0.1.0

package/README.md

@@ -0,0 +1,331 @@
+# Claude Code Telegram Mirror
+
+Bidirectional communication between Claude Code CLI and Telegram. Control your Claude Code sessions from your phone.
+
+**Supported platforms:** Linux, macOS
+
+## Quick Install
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/robertelee78/claude-telegram-mirror/master/scripts/install.sh | bash
+```
+
+Or download and review first:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/robertelee78/claude-telegram-mirror/master/scripts/install.sh -o install.sh
+less install.sh  # Review the script
+bash install.sh
+```
+
+The interactive installer will guide you through:
+1. Checking prerequisites (node, npm, git, tmux, jq, nc)
+2. Creating a Telegram bot via @BotFather
+3. Setting up a supergroup with Topics
+4. Verifying bot permissions
+5. Installing hooks and the system service
+
+### Other Scripts
+
+```bash
+# Diagnose issues
+~/.local/share/claude-telegram-mirror/scripts/doctor.sh
+
+# Uninstall completely
+~/.local/share/claude-telegram-mirror/scripts/uninstall.sh
+```
+
+## Manual Setup (for developers)
+
+<details>
+<summary>Click to expand manual installation steps</summary>
+
+For developers who want to work on the source code:
+
+```bash
+# 1. Clone and build
+git clone https://github.com/robertelee78/claude-telegram-mirror.git
+cd claude-telegram-mirror && npm install && npm run build
+
+# 2. Create a Telegram bot via @BotFather, get the token
+
+# 3. Create a supergroup with Topics enabled, add your bot as admin
+
+# 4. Get your chat ID
+./scripts/get-chat-id.sh YOUR_BOT_TOKEN
+
+# 5. Configure environment
+cat > ~/.telegram-env << 'EOF'
+export TELEGRAM_BOT_TOKEN="your-token-here"
+export TELEGRAM_CHAT_ID="-100your-chat-id"
+export TELEGRAM_MIRROR=true
+EOF
+
+# 6. Install hooks
+node dist/cli.js install-hooks                    # Global install
+# OR for projects with custom .claude/settings.json:
+cd /path/to/project && node dist/cli.js install-hooks --project
+
+# 7. Start daemon (choose one)
+node dist/cli.js start                            # Foreground (for testing)
+node dist/cli.js service install && \
+node dist/cli.js service start                    # As system service (recommended)
+```
+
+**Note:** When using the Quick Install method, use `ctm` instead of `node dist/cli.js`.
+
+</details>
+
+## Features
+
+- **CLI → Telegram**: Mirror Claude's responses, tool usage, and notifications
+- **Telegram → CLI**: Send prompts from Telegram directly to Claude Code
+- **Session Threading**: Each Claude session gets its own Forum Topic
+- **Multi-System Support**: Run separate daemons on multiple machines
+- **Compaction Notifications**: Get notified when Claude summarizes context
+
+## Architecture
+
+```
+┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
+│   Claude Code   │────▶│  Bridge Daemon  │────▶│    Telegram     │
+│      CLI        │◀────│                 │◀────│      Bot        │
+└─────────────────┘     └─────────────────┘     └─────────────────┘
+        │                       │
+        │ hooks                 │ Unix socket
+        ▼                       ▼
+┌─────────────────┐     ┌─────────────────┐
+│  telegram-hook  │────▶│  Socket Server  │
+│     (bash)      │     │                 │
+└─────────────────┘     └─────────────────┘
+```
+
+**Flow:**
+1. Claude Code hooks capture events (prompts, responses, tool use)
+2. Hook script sends JSON to bridge daemon via Unix socket
+3. Bridge forwards messages to Telegram Forum Topic
+4. Telegram replies are injected into CLI via `tmux send-keys`
+
+## Multi-System Architecture
+
+When running Claude Code on multiple machines, each system needs its own bot to avoid Telegram API conflicts (error 409: only one polling connection per bot token is allowed).
+
+**The model:**
+- **One daemon per host** - Each machine runs its own bridge daemon
+- **One bot per daemon** - Each daemon uses a unique Telegram bot
+- **Multiple sessions per host** - One daemon handles all Claude sessions on that machine
+- **Shared supergroup** - All bots post to the same Telegram supergroup
+
+### Setup for Multiple Systems
+
+1. **Create one bot per system** via [@BotFather](https://t.me/botfather)
+   - System A: `@claude_mirror_system_a_bot`
+   - System B: `@claude_mirror_system_b_bot`
+
+2. **Add all bots to the same supergroup** with admin permissions
+
+3. **Configure each system** with its own bot token:
+   ```bash
+   # On System A (~/.telegram-env)
+   export TELEGRAM_BOT_TOKEN="token-for-system-a-bot"
+   export TELEGRAM_CHAT_ID="-100shared-group-id"
+
+   # On System B (~/.telegram-env)
+   export TELEGRAM_BOT_TOKEN="token-for-system-b-bot"
+   export TELEGRAM_CHAT_ID="-100shared-group-id"  # Same group!
+   ```
+
+4. **Each daemon creates topics for its sessions** - Messages route correctly because each daemon only processes topics it created.
+
+## Prerequisites
+
+- Node.js 18+
+- Claude Code CLI
+- tmux (for bidirectional communication)
+- jq (JSON processing)
+- nc (netcat, for socket communication)
+- Telegram account
+
+## Telegram Setup
+
+### 1. Create a Bot
+
+1. Message [@BotFather](https://t.me/botfather) → `/newbot`
+2. Choose name and username (must end in `bot`)
+3. Save the API token
+
+### 2. Create Supergroup with Topics
+
+1. Create a new group in Telegram
+2. Add your bot to the group
+3. Group Settings → Enable **Topics**
+
+### 3. Make Bot an Admin
+
+1. Group Settings → Administrators → Add your bot
+2. Enable: **Manage Topics**, **Post Messages**
+
+### 4. Get Chat ID
+
+1. Send any message in the group
+2. Run the helper script:
+   ```bash
+   ./scripts/get-chat-id.sh YOUR_BOT_TOKEN
+   ```
+   Or manually: `https://api.telegram.org/botYOUR_TOKEN/getUpdates`
+3. Copy the chat ID (supergroups start with `-100`)
+
+### 5. Disable Privacy Mode
+
+1. [@BotFather](https://t.me/botfather) → `/mybots` → Select bot
+2. Bot Settings → Group Privacy → **Turn off**
+
+## Configuration
+
+### Environment Variables
+
+Create `~/.telegram-env`:
+
+```bash
+export TELEGRAM_BOT_TOKEN="123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
+export TELEGRAM_CHAT_ID="-1001234567890"
+export TELEGRAM_MIRROR=true
+# Optional:
+# export TELEGRAM_MIRROR_VERBOSE=true
+# export TELEGRAM_BRIDGE_SOCKET=~/.config/claude-telegram-mirror/bridge.sock
+```
+
+Source in your shell profile (`~/.bashrc` or `~/.zshrc`):
+
+```bash
+[[ -f ~/.telegram-env ]] && source ~/.telegram-env
+```
+
+### Test Connection
+
+```bash
+ctm config --test
+# ✅ Bot connected: @your_bot_username
+# ✅ Test message sent to chat
+```
+
+## Usage
+
+### Start the Bridge
+
+```bash
+# Foreground (for testing)
+ctm start
+
+# As system service (recommended for production)
+ctm service install    # Install systemd/launchd service
+ctm service start      # Start the service
+```
+
+### Run Claude in tmux
+
+```bash
+tmux new -s claude
+claude
+# Bridge auto-detects tmux session
+```
+
+### CLI Commands
+
+```bash
+# Daemon control
+ctm start              # Start daemon in foreground
+ctm status             # Show status
+ctm config --test      # Test connection
+
+# Hook management
+ctm install-hooks      # Install global hooks
+ctm install-hooks -p   # Install to current project's .claude/
+ctm uninstall-hooks    # Remove hooks
+ctm hooks              # Show hook status
+
+# Service management (systemd on Linux, launchd on macOS)
+ctm service install    # Install as system service
+ctm service uninstall  # Remove system service
+ctm service start      # Start service
+ctm service stop       # Stop service
+ctm service restart    # Restart service
+ctm service status     # Show service status
+```
+
+**Note:** The `ctm` command is installed to `~/.local/bin/` by the installer. If you cloned the repo manually, use `node dist/cli.js` instead.
+
+## Project-Level Hooks
+
+If your project has `.claude/settings.json` with custom hooks, global hooks are ignored. Install hooks to the project:
+
+```bash
+cd /path/to/your/project
+ctm install-hooks --project
+# or shorthand:
+ctm install-hooks -p
+```
+
+The installer will prompt you to set up project-level hooks during installation. You can also add them later to any project.
+
+## How Messages Flow
+
+| Direction | Event | Display |
+|-----------|-------|---------|
+| CLI → Telegram | User types | 👤 User (cli): ... |
+| CLI → Telegram | Tool starts | 🔧 Running: Bash |
+| CLI → Telegram | Claude responds | 🤖 Claude: ... |
+| CLI → Telegram | Session starts | New Forum Topic created |
+| CLI → Telegram | Context compacting | ⏳ Notification sent |
+| Telegram → CLI | User sends message | Injected via tmux |
+
+## Technical Details
+
+- **Session storage**: SQLite at `~/.config/claude-telegram-mirror/sessions.db`
+- **Socket path**: `~/.config/claude-telegram-mirror/bridge.sock`
+- **Response extraction**: Reads Claude's transcript `.jsonl` on Stop event
+- **Deduplication**: Telegram-originated messages tracked to prevent echo
+- **Topic routing**: Each daemon only processes topics it created (multi-bot safe)
+- **Compaction alerts**: PreCompact hook sends notification before context summarization
+
+## Troubleshooting
+
+**Hooks not firing?**
+- Check if project has local `.claude/settings.json` overriding globals
+- Run `ctm install-hooks -p` from project directory
+- Restart Claude Code after installing hooks
+
+**409 Conflict error?**
+- Only one polling connection per bot token is allowed
+- If running multiple systems, each needs its own bot (see Multi-System Architecture)
+- Kill duplicate daemons: `pkill -f "claude-telegram-mirror"`
+
+**Bridge not receiving events?**
+- Check socket: `ls -la ~/.config/claude-telegram-mirror/bridge.sock`
+- Enable debug: `export TELEGRAM_HOOK_DEBUG=1` then retry
+- Check debug log: `cat ~/.config/claude-telegram-mirror/hook-debug.log`
+
+**tmux injection not working?**
+- Verify tmux session: `tmux list-sessions`
+- Check daemon logs for "Session tmux target stored"
+
+**Messages going to wrong topic?**
+- Clear session DB: `rm ~/.config/claude-telegram-mirror/sessions.db`
+
+**Service not starting (Linux)?**
+- Check status: `systemctl --user status claude-telegram-mirror`
+- View logs: `journalctl --user -u claude-telegram-mirror -f`
+- Enable linger: `loginctl enable-linger $USER`
+
+**Service not starting (macOS)?**
+- Check status: `launchctl list | grep claude`
+- View logs: `cat ~/Library/Logs/claude-telegram-mirror.*.log`
+- Check permissions: Ensure Terminal has Accessibility access
+
+## License
+
+MIT
+
+## Credits
+
+Built as part of the claude-mobile project for remote Claude Code interaction.

package/dist/bot/commands.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Bot Command Handlers
+ * Implements all Telegram bot commands
+ */
+import { Bot, Context, SessionFlavor, InlineKeyboard } from 'grammy';
+interface SessionData {
+    attachedSessionId: string | null;
+    muted: boolean;
+    lastActivity: number;
+}
+type BotContext = Context & SessionFlavor<SessionData>;
+export interface BridgeCallbacks {
+    getActiveSessions(): Promise<Array<{
+        id: string;
+        startedAt: Date;
+        projectDir?: string;
+    }>>;
+    abortSession(sessionId: string): Promise<boolean>;
+    sendToSession(sessionId: string, text: string): Promise<boolean>;
+}
+/**
+ * Register all bot commands
+ */
+export declare function registerCommands(bot: Bot<BotContext>, bridge?: BridgeCallbacks): void;
+/**
+ * Create approval keyboard
+ */
+export declare function createApprovalKeyboard(approvalId: string): InlineKeyboard;
+/**
+ * Register approval handlers
+ */
+export declare function registerApprovalHandlers(bot: Bot<BotContext>, onApproval: (approvalId: string, action: 'approve' | 'reject' | 'abort') => Promise<void>): void;
+/**
+ * Register tool details handler
+ */
+export declare function registerToolDetailsHandler(bot: Bot<BotContext>, getToolDetails: (toolUseId: string) => {
+    tool: string;
+    input: unknown;
+} | undefined): void;
+export default registerCommands;
+//# sourceMappingURL=commands.d.ts.map

package/dist/bot/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/bot/commands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AASrE,UAAU,WAAW;IACnB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,KAAK,UAAU,GAAG,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;AAGvD,MAAM,WAAW,eAAe;IAC9B,iBAAiB,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,IAAI,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC1F,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC,EACpB,MAAM,CAAC,EAAE,eAAe,GACvB,IAAI,CA2NN;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAMzE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC,EACpB,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GACxF,IAAI,CA4BN;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC,EACpB,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,GAClF,IAAI,CA+BN;AAED,eAAe,gBAAgB,CAAC"}

package/dist/bot/commands.js

@@ -0,0 +1,231 @@
+/**
+ * Bot Command Handlers
+ * Implements all Telegram bot commands
+ */
+import { InlineKeyboard } from 'grammy';
+import { formatHelp, formatStatus, formatToolDetails } from './formatting.js';
+import logger from '../utils/logger.js';
+/**
+ * Register all bot commands
+ */
+export function registerCommands(bot, bridge) {
+    // /start - Welcome message
+    bot.command('start', async (ctx) => {
+        await ctx.reply('👋 *Claude Code Mirror Bot*\n\n' +
+            'I mirror your Claude Code sessions to Telegram, allowing you to:\n' +
+            '• Monitor agent progress from your phone\n' +
+            '• Send responses and commands remotely\n' +
+            '• Approve/reject actions via buttons\n\n' +
+            'Use /help to see all available commands.', { parse_mode: 'Markdown' });
+        logger.info('User started bot');
+    });
+    // /help - Show commands
+    bot.command('help', async (ctx) => {
+        await ctx.reply(formatHelp(), { parse_mode: 'Markdown' });
+    });
+    // /status - Current session status
+    bot.command('status', async (ctx) => {
+        const session = ctx.session;
+        const hasSession = !!session?.attachedSessionId;
+        await ctx.reply(formatStatus(hasSession, session?.attachedSessionId || undefined, session?.muted), { parse_mode: 'Markdown' });
+    });
+    // /sessions - List active sessions
+    bot.command('sessions', async (ctx) => {
+        if (!bridge) {
+            await ctx.reply('⚠️ Bridge not connected. No session info available.');
+            return;
+        }
+        try {
+            const sessions = await bridge.getActiveSessions();
+            if (sessions.length === 0) {
+                await ctx.reply('📭 No active sessions.');
+                return;
+            }
+            let message = '📋 *Active Sessions:*\n\n';
+            sessions.forEach((s, idx) => {
+                const age = Math.floor((Date.now() - s.startedAt.getTime()) / 60000);
+                message += `${idx + 1}. \`${s.id}\`\n`;
+                message += `   Started: ${age}m ago\n`;
+                if (s.projectDir) {
+                    message += `   Project: \`${s.projectDir}\`\n`;
+                }
+                message += '\n';
+            });
+            message += '_Use /attach <id> to attach to a session_';
+            await ctx.reply(message, { parse_mode: 'Markdown' });
+        }
+        catch (error) {
+            logger.error('Failed to get sessions', { error });
+            await ctx.reply('❌ Failed to fetch sessions.');
+        }
+    });
+    // /attach <id> - Attach to session
+    bot.command('attach', async (ctx) => {
+        const sessionId = ctx.match?.trim();
+        if (!sessionId) {
+            await ctx.reply('⚠️ Please provide a session ID.\n\n' +
+                'Usage: `/attach <session-id>`\n\n' +
+                'Use /sessions to see available sessions.', { parse_mode: 'Markdown' });
+            return;
+        }
+        ctx.session.attachedSessionId = sessionId;
+        ctx.session.muted = false;
+        await ctx.reply(`✅ Attached to session \`${sessionId}\`\n\n` +
+            'You will now receive updates from this session.\n' +
+            'Reply with text to send input.', { parse_mode: 'Markdown' });
+        logger.info('Attached to session', { sessionId });
+    });
+    // /detach - Detach from session
+    bot.command('detach', async (ctx) => {
+        const currentSession = ctx.session.attachedSessionId;
+        if (!currentSession) {
+            await ctx.reply('ℹ️ You are not attached to any session.');
+            return;
+        }
+        ctx.session.attachedSessionId = null;
+        await ctx.reply(`🔌 Detached from session \`${currentSession}\`\n\n` +
+            'You will no longer receive updates.', { parse_mode: 'Markdown' });
+        logger.info('Detached from session', { sessionId: currentSession });
+    });
+    // /mute - Mute notifications
+    bot.command('mute', async (ctx) => {
+        if (ctx.session.muted) {
+            await ctx.reply('🔇 Notifications already muted.');
+            return;
+        }
+        ctx.session.muted = true;
+        await ctx.reply('🔇 Notifications muted.\n\n' +
+            'Use /unmute to resume.', { parse_mode: 'Markdown' });
+        logger.info('Notifications muted');
+    });
+    // /unmute - Resume notifications
+    bot.command('unmute', async (ctx) => {
+        if (!ctx.session.muted) {
+            await ctx.reply('🔔 Notifications already active.');
+            return;
+        }
+        ctx.session.muted = false;
+        await ctx.reply('🔔 Notifications resumed.');
+        logger.info('Notifications unmuted');
+    });
+    // /abort - Abort current session
+    bot.command('abort', async (ctx) => {
+        const sessionId = ctx.session.attachedSessionId;
+        if (!sessionId) {
+            await ctx.reply('⚠️ No session attached. Use /attach first.');
+            return;
+        }
+        // Show confirmation
+        const keyboard = new InlineKeyboard()
+            .text('🛑 Yes, abort', `confirm_abort:${sessionId}`)
+            .text('❌ Cancel', 'cancel_abort');
+        await ctx.reply(`⚠️ *Abort Session?*\n\n` +
+            `This will terminate session \`${sessionId}\`.\n\n` +
+            'Are you sure?', {
+            parse_mode: 'Markdown',
+            reply_markup: keyboard
+        });
+    });
+    // Handle abort confirmation
+    bot.callbackQuery(/^confirm_abort:(.+)$/, async (ctx) => {
+        const sessionId = ctx.match[1];
+        if (bridge) {
+            try {
+                const success = await bridge.abortSession(sessionId);
+                if (success) {
+                    ctx.session.attachedSessionId = null;
+                    await ctx.editMessageText(`🛑 Session \`${sessionId}\` aborted.`, { parse_mode: 'Markdown' });
+                }
+                else {
+                    await ctx.editMessageText('❌ Failed to abort session.');
+                }
+            }
+            catch (error) {
+                logger.error('Failed to abort session', { sessionId, error });
+                await ctx.editMessageText('❌ Error aborting session.');
+            }
+        }
+        else {
+            ctx.session.attachedSessionId = null;
+            await ctx.editMessageText(`🛑 Detached from session \`${sessionId}\`.\n\n` +
+                '_(Bridge not connected - session may still be running)_', { parse_mode: 'Markdown' });
+        }
+        await ctx.answerCallbackQuery();
+    });
+    // Handle abort cancellation
+    bot.callbackQuery('cancel_abort', async (ctx) => {
+        await ctx.editMessageText('✅ Abort cancelled.');
+        await ctx.answerCallbackQuery();
+    });
+    // /ping - Simple health check
+    bot.command('ping', async (ctx) => {
+        const start = Date.now();
+        const msg = await ctx.reply('🏓 Pong!');
+        const latency = Date.now() - start;
+        await ctx.api.editMessageText(ctx.chat.id, msg.message_id, `🏓 Pong! _${latency}ms_`, { parse_mode: 'Markdown' });
+    });
+}
+/**
+ * Create approval keyboard
+ */
+export function createApprovalKeyboard(approvalId) {
+    return new InlineKeyboard()
+        .text('✅ Approve', `approve:${approvalId}`)
+        .text('❌ Reject', `reject:${approvalId}`)
+        .row()
+        .text('🛑 Abort Session', `abort:${approvalId}`);
+}
+/**
+ * Register approval handlers
+ */
+export function registerApprovalHandlers(bot, onApproval) {
+    bot.callbackQuery(/^(approve|reject|abort):(.+)$/, async (ctx) => {
+        const action = ctx.match[1];
+        const approvalId = ctx.match[2];
+        try {
+            await onApproval(approvalId, action);
+            // Update message to show decision
+            const actionText = {
+                approve: '✅ Approved',
+                reject: '❌ Rejected',
+                abort: '🛑 Session Aborted'
+            }[action];
+            const originalText = ctx.callbackQuery.message?.text || '';
+            await ctx.editMessageText(`${originalText}\n\n*Decision:* ${actionText}`, { parse_mode: 'Markdown' });
+            await ctx.answerCallbackQuery({ text: `${actionText}!` });
+        }
+        catch (error) {
+            logger.error('Failed to process approval', { approvalId, action, error });
+            await ctx.answerCallbackQuery({ text: 'Error processing response' });
+        }
+    });
+}
+/**
+ * Register tool details handler
+ */
+export function registerToolDetailsHandler(bot, getToolDetails) {
+    bot.callbackQuery(/^tooldetails:(.+)$/, async (ctx) => {
+        const toolUseId = ctx.match[1];
+        try {
+            const details = getToolDetails(toolUseId);
+            if (!details) {
+                await ctx.answerCallbackQuery({ text: 'Details expired (5 min cache)', show_alert: true });
+                return;
+            }
+            // Format the tool details nicely for mobile
+            const formattedDetails = formatToolDetails(details.tool, details.input);
+            // Reply with full details (don't edit original - keep it clean)
+            await ctx.reply(formattedDetails, {
+                parse_mode: 'Markdown',
+                reply_parameters: { message_id: ctx.callbackQuery.message?.message_id || 0 }
+            });
+            await ctx.answerCallbackQuery();
+        }
+        catch (error) {
+            logger.error('Failed to show tool details', { toolUseId, error });
+            await ctx.answerCallbackQuery({ text: 'Error loading details' });
+        }
+    });
+}
+export default registerCommands;
+//# sourceMappingURL=commands.js.map

package/dist/bot/commands.js.map

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

package/dist/bot/formatting.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Message Formatting Utilities
+ * Formats Claude Code output for Telegram display
+ */
+/**
+ * Strip ANSI escape codes from text
+ */
+export declare function stripAnsi(text: string): string;
+/**
+ * Escape special characters for MarkdownV2
+ * Note: Don't escape inside code blocks
+ */
+export declare function escapeMarkdownV2(text: string): string;
+/**
+ * Format agent response for Telegram
+ */
+export declare function formatAgentResponse(content: string): string;
+/**
+ * Format tool execution for Telegram
+ */
+export declare function formatToolExecution(tool: string, input: unknown, output: unknown, verbose?: boolean): string;
+/**
+ * Format approval request for Telegram
+ */
+export declare function formatApprovalRequest(prompt: string): string;
+/**
+ * Format error message for Telegram
+ */
+export declare function formatError(error: Error | string): string;
+/**
+ * Format session start notification
+ */
+export declare function formatSessionStart(sessionId: string, projectDir?: string, hostname?: string): string;
+/**
+ * Format session end notification
+ */
+export declare function formatSessionEnd(sessionId: string, duration?: number): string;
+/**
+ * Format status message
+ */
+export declare function formatStatus(isActive: boolean, sessionId?: string, muted?: boolean): string;
+/**
+ * Format help message
+ */
+export declare function formatHelp(): string;
+/**
+ * Format a message and chunk if necessary
+ */
+export declare function formatAndChunk(content: string, maxLength?: number): string[];
+/**
+ * Detect code language from content (best effort)
+ */
+export declare function detectLanguage(content: string): string;
+/**
+ * Wrap content in code block with language detection
+ */
+export declare function wrapInCodeBlock(content: string, language?: string): string;
+/**
+ * Format tool details for mobile-friendly Telegram display
+ */
+export declare function formatToolDetails(tool: string, input: unknown): string;
+//# sourceMappingURL=formatting.d.ts.map