tg-claude 0.3.3 → 0.3.4

package/dist/setup/validators.d.ts

@@ -1,22 +0,0 @@
-/**
- * Validation functions for setup wizard inputs.
- * Return true for valid input, or a helpful error message string for invalid input.
- */
-/**
- * Validate a Telegram bot token format.
- * Tokens follow the pattern: {bot_id}:{token_part}
- * Example: 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ123456789
- *
- * @param value - The raw input string to validate
- * @returns true if valid, or an error message string if invalid
- */
-export declare function validateToken(value: string): boolean | string;
-/**
- * Validate a Telegram user ID.
- * User IDs are positive integers.
- *
- * @param value - The raw input string to validate
- * @returns true if valid, or an error message string if invalid
- */
-export declare function validateUserId(value: string): boolean | string;
-//# sourceMappingURL=validators.d.ts.map

package/dist/setup/validators.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/setup/validators.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAe7D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAmB9D"}

package/dist/setup/validators.js

@@ -1,47 +0,0 @@
-/**
- * Validation functions for setup wizard inputs.
- * Return true for valid input, or a helpful error message string for invalid input.
- */
-/**
- * Validate a Telegram bot token format.
- * Tokens follow the pattern: {bot_id}:{token_part}
- * Example: 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ123456789
- *
- * @param value - The raw input string to validate
- * @returns true if valid, or an error message string if invalid
- */
-export function validateToken(value) {
-    const trimmed = value.trim();
-    if (!trimmed) {
-        return 'Token is required';
-    }
-    // Telegram bot tokens: {5-16 digit bot_id}:A{34 alphanumeric/underscore/dash chars}
-    const tokenPattern = /^\d{5,16}:A[a-zA-Z0-9_-]{34}$/;
-    if (!tokenPattern.test(trimmed)) {
-        return 'Invalid token format. Should look like: 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ123456789';
-    }
-    return true;
-}
-/**
- * Validate a Telegram user ID.
- * User IDs are positive integers.
- *
- * @param value - The raw input string to validate
- * @returns true if valid, or an error message string if invalid
- */
-export function validateUserId(value) {
-    const trimmed = value.trim();
-    if (!trimmed) {
-        return 'User ID is required';
-    }
-    const parsed = parseInt(trimmed, 10);
-    if (isNaN(parsed) || parsed <= 0) {
-        return 'User ID must be a positive number. Get it from @userinfobot on Telegram.';
-    }
-    // Ensure no extra characters (e.g., "123abc" would parse to 123)
-    if (parsed.toString() !== trimmed) {
-        return 'User ID must contain only digits';
-    }
-    return true;
-}
-//# sourceMappingURL=validators.js.map

package/dist/setup/validators.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/setup/validators.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,oFAAoF;IACpF,MAAM,YAAY,GAAG,+BAA+B,CAAC;IAErD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,OAAO,uFAAuF,CAAC;IACjG,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAErC,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO,0EAA0E,CAAC;IACpF,CAAC;IAED,iEAAiE;IACjE,IAAI,MAAM,CAAC,QAAQ,EAAE,KAAK,OAAO,EAAE,CAAC;QAClC,OAAO,kCAAkC,CAAC;IAC5C,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/setup/wizard.d.ts

@@ -1,7 +0,0 @@
-/**
- * Interactive setup wizard for configuring Telegram bot credentials.
- * Guides the user through obtaining and entering their bot token and user ID.
- * Handles Ctrl+C gracefully without stack traces.
- */
-export declare function setupWizard(): Promise<void>;
-//# sourceMappingURL=wizard.d.ts.map

package/dist/setup/wizard.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../src/setup/wizard.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAuDjD"}

package/dist/setup/wizard.js

@@ -1,56 +0,0 @@
-import { input, confirm } from '@inquirer/prompts';
-import { validateToken, validateUserId } from './validators.js';
-import { readExistingEnv, writeEnvFile } from './envWriter.js';
-/**
- * Interactive setup wizard for configuring Telegram bot credentials.
- * Guides the user through obtaining and entering their bot token and user ID.
- * Handles Ctrl+C gracefully without stack traces.
- */
-export async function setupWizard() {
-    try {
-        // Header
-        console.log('\n=== tg-claude Setup Wizard ===\n');
-        console.log('This wizard will help you configure your Telegram bot credentials.');
-        console.log('You will need to create a bot and get your user ID.\n');
-        // Step 1: Bot token
-        console.log('STEP 1: Get your bot token from @BotFather\n');
-        console.log('  1. Open Telegram and search for @BotFather');
-        console.log('  2. Send /newbot and follow the prompts to create a bot');
-        console.log('  3. Copy the token that BotFather gives you\n');
-        const token = (await input({
-            message: 'Paste your bot token:',
-            validate: validateToken,
-        })).trim();
-        // Step 2: User ID
-        console.log('\nSTEP 2: Get your user ID from @userinfobot\n');
-        console.log('  1. Open Telegram and search for @userinfobot');
-        console.log('  2. Start the bot - it will show your numeric user ID\n');
-        const userId = (await input({
-            message: 'Enter your user ID:',
-            validate: validateUserId,
-        })).trim();
-        // Step 3: Confirm and write
-        const existingContent = readExistingEnv();
-        if (existingContent !== null) {
-            const shouldUpdate = await confirm({
-                message: 'A .env file already exists. Update Telegram settings?',
-                default: true,
-            });
-            if (!shouldUpdate) {
-                console.log('\nSetup cancelled.');
-                return;
-            }
-        }
-        writeEnvFile({ token, userId }, existingContent);
-        console.log('\n✓ Setup complete! Your credentials have been saved to .env');
-    }
-    catch (error) {
-        // Handle Ctrl+C gracefully
-        if (error instanceof Error && error.name === 'ExitPromptError') {
-            console.log('\n\nSetup cancelled.');
-            process.exit(0);
-        }
-        throw error;
-    }
-}
-//# sourceMappingURL=wizard.js.map

package/dist/setup/wizard.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wizard.js","sourceRoot":"","sources":["../../src/setup/wizard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,CAAC;QACH,SAAS;QACT,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC;QAClF,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;QAErE,oBAAoB;QACpB,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;QAE9D,MAAM,KAAK,GAAG,CAAC,MAAM,KAAK,CAAC;YACzB,OAAO,EAAE,uBAAuB;YAChC,QAAQ,EAAE,aAAa;SACxB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEX,kBAAkB;QAClB,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;QAExE,MAAM,MAAM,GAAG,CAAC,MAAM,KAAK,CAAC;YAC1B,OAAO,EAAE,qBAAqB;YAC9B,QAAQ,EAAE,cAAc;SACzB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEX,4BAA4B;QAC5B,MAAM,eAAe,GAAG,eAAe,EAAE,CAAC;QAE1C,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;YAC7B,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC;gBACjC,OAAO,EAAE,uDAAuD;gBAChE,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;gBAClC,OAAO;YACT,CAAC;QACH,CAAC;QAED,YAAY,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC;QAEjD,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;IAE9E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,2BAA2B;QAC3B,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/telegram/TelegramBot.d.ts

@@ -1,163 +0,0 @@
-/**
- * TelegramBot class wrapping grammY Bot with composition pattern.
- * Implements AUTH-01 whitelist authentication for single-user access.
- */
-import type { NotificationPayload } from './types.js';
-import type { TelegramConfig } from './types.js';
-/**
- * Handler for inline button callback responses.
- * @param sessionId - The session that receives the response
- * @param optionIndex - The selected option index (1-based)
- */
-export type CallbackHandler = (sessionId: string, optionIndex: number) => void;
-/**
- * Handler for freeform text message responses.
- * @param sessionId - The session that receives the response
- * @param text - The user's text input
- */
-export type TextMessageHandler = (sessionId: string, text: string) => void;
-/**
- * Options for TelegramBot initialization.
- * Extends TelegramConfig to allow future options.
- */
-export interface TelegramBotOptions extends TelegramConfig {
-}
-/**
- * TelegramBot wraps grammY Bot with composition pattern.
- * Provides single-user authentication and graceful lifecycle management.
- *
- * @example
- * ```typescript
- * const bot = new TelegramBot({
- *   token: process.env.TELEGRAM_BOT_TOKEN,
- *   allowedUserId: Number(process.env.TELEGRAM_USER_ID),
- * });
- * await bot.start();
- * ```
- */
-export declare class TelegramBot {
-    private readonly bot;
-    private readonly allowedUserId;
-    private started;
-    private readonly sessionChatMap;
-    onCallback: CallbackHandler | null;
-    onTextMessage: TextMessageHandler | null;
-    private awaitingSession;
-    private readonly multiSelectState;
-    constructor(options: TelegramBotOptions);
-    /**
-     * Set up bot middleware and command handlers.
-     */
-    private setupMiddleware;
-    /**
-     * Set up error handler for Telegram API and network errors.
-     */
-    private setupErrorHandler;
-    /**
-     * Handle single-select button click (existing behavior, refactored)
-     */
-    private handleSingleSelect;
-    /**
-     * Handle multi-select toggle button click
-     */
-    private handleToggle;
-    /**
-     * Handle multi-select submit button click
-     */
-    private handleSubmit;
-    /**
-     * Build multi-select keyboard with checkmarks for selected options
-     */
-    private buildMultiSelectKeyboard;
-    /**
-     * Start the bot with long polling.
-     * Safe to call multiple times (idempotent).
-     */
-    /**
-     * Register bot commands for Telegram autocomplete menu.
-     * Only basic bot commands are registered. GSD commands are typed manually
-     * as /gsd:command-name since they often need arguments.
-     */
-    setupBotCommands(): Promise<void>;
-    start(): Promise<void>;
-    /**
-     * Stop the bot gracefully.
-     * Safe to call multiple times (idempotent).
-     */
-    stop(): void;
-    /**
-     * Check if the bot is currently running.
-     */
-    get isStarted(): boolean;
-    /**
-     * Get the chat ID for the single whitelisted user.
-     * For private chats, chat_id equals user_id.
-     */
-    get chatId(): number;
-    /**
-     * Expose bot.api for proactive messaging.
-     * Used by higher layers to send notifications.
-     */
-    get api(): import("grammy").Api<import("grammy").RawApi>;
-    /**
-     * Register a session for notifications.
-     * Maps session to the whitelisted user's chat.
-     */
-    registerSession(sessionId: string): void;
-    /**
-     * Unregister a session.
-     */
-    unregisterSession(sessionId: string): void;
-    /**
-     * Check if a session is registered.
-     */
-    hasSession(sessionId: string): boolean;
-    /**
-     * Send a prompt notification to Telegram with inline keyboard.
-     * @param payload - The notification payload with question and options
-     * @returns Message ID if sent, undefined if session not registered
-     */
-    sendNotification(payload: NotificationPayload): Promise<number | undefined>;
-    /**
-     * Truncate button text for Telegram inline keyboards.
-     * Extracts label (before " - ") and truncates to max length.
-     * Telegram buttons have ~40-50 char visible width.
-     */
-    private truncateButtonText;
-    /**
-     * Escape HTML special characters for Telegram HTML parse mode.
-     */
-    escapeHtml(text: string): string;
-    /**
-     * Send a completion notification to Telegram.
-     * Handles long messages by splitting into multiple messages.
-     * @param payload - The completion payload with summary
-     * @returns Message ID of last message if sent, undefined if session not registered
-     */
-    sendCompletionNotification(payload: {
-        sessionId: string;
-        summary: string;
-        duration?: number;
-    }): Promise<number | undefined>;
-    /**
-     * Split a long message into chunks at natural break points.
-     */
-    private splitMessage;
-    /**
-     * Mark a session as awaiting user input.
-     * Called when a prompt notification is sent.
-     */
-    setAwaitingInput(sessionId: string): void;
-    /**
-     * Clear the awaiting input state.
-     * Called when response is received or session ends.
-     */
-    clearAwaitingInput(): void;
-    /**
-     * Handle GSD skill commands.
-     * Routes to Claude as text input (not as Telegram bot commands).
-     * Handles cold-start scenario where no session is awaiting.
-     */
-    private handleGsdCommand;
-}
-//# sourceMappingURL=TelegramBot.d.ts.map

package/dist/telegram/TelegramBot.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TelegramBot.d.ts","sourceRoot":"","sources":["../../src/telegram/TelegramBot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AASjD;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;AAE/E;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;CAEzD;AAYD;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,OAAO,CAAS;IAIxB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAG5D,UAAU,EAAE,eAAe,GAAG,IAAI,CAAQ;IAC1C,aAAa,EAAE,kBAAkB,GAAG,IAAI,CAAQ;IAGhD,OAAO,CAAC,eAAe,CAAuB;IAG9C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuC;gBAE5D,OAAO,EAAE,kBAAkB;IAOvC;;OAEG;IACH,OAAO,CAAC,eAAe;IAsJvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;YAEW,kBAAkB;IAiChC;;OAEG;YAEW,YAAY;IA2C1B;;OAEG;YAEW,YAAY;IAgD1B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAuBhC;;;OAGG;IACH;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAcjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB5B;;;OAGG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;OAGG;IACH,IAAI,GAAG,kDAEN;IAED;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKxC;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK1C;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItC;;;;OAIG;IACG,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA8EjF;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAOhC;;;;;OAKG;IACG,0BAA0B,CAAC,OAAO,EAAE;QACxC,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAkE/B;;OAEG;IACH,OAAO,CAAC,YAAY;IA0BpB;;;OAGG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKzC;;;OAGG;IACH,kBAAkB,IAAI,IAAI;IAO1B;;;;OAIG;YACW,gBAAgB;CAmB/B"}