mcp-telegram-ask-claude 1.0.0

package/README.md

@@ -0,0 +1,135 @@
+# alpha-claude-telegram-ask-user
+
+> **Alpha / WIP** -- bugs expected. MCP bridge that lets Claude agents ask Telegram users questions via inline keyboards.
+
+Extracted from [ClaudeClaw](https://github.com/Febnyy/claudeclaw). No other open source project does this bridge: Claude Agent SDK `ask_user` tool -> Telegram inline keyboard -> promise resolves with user's answer.
+
+## How it works
+
+```
+Claude agent calls ask_user tool
+  -> MCP server sends Telegram message with inline keyboard
+  -> User taps a button (or types free text via ForceReply)
+  -> Bot callback_query handler resolves the promise
+  -> Claude agent receives the answer and continues
+```
+
+5-minute timeout built in. Double-tap protection. Multi-select support.
+
+## Install
+
+```bash
+npm install alpha-claude-telegram-ask-user
+# peer dep -- pick one:
+npm install grammy        # grammY adapter
+npm install telegraf      # Telegraf adapter
+```
+
+## Usage (grammY)
+
+```ts
+import { Bot } from 'grammy'
+import { query } from '@anthropic-ai/claude-agent-sdk'
+import {
+  createTelegramUiServer,
+  createGrammyAdapter,
+} from 'alpha-claude-telegram-ask-user'
+
+const bot = new Bot(process.env.TELEGRAM_BOT_TOKEN!)
+const chatId = process.env.TELEGRAM_CHAT_ID!
+
+const adapter = createGrammyAdapter(bot)
+const ui = createTelegramUiServer(adapter, chatId, { timeoutMs: 5 * 60_000 })
+
+// Hook into callback queries (button taps)
+bot.on('callback_query:data', async (ctx) => {
+  await ui.handleCallbackQuery(ctx.callbackQuery.data, ctx.callbackQuery.id)
+})
+
+// Hook into ForceReply (free text via "Autre")
+bot.on('message:text', async (ctx) => {
+  if (ctx.message.reply_to_message) {
+    await ui.handleForceReplyMessage(ctx.message.reply_to_message.message_id, ctx.message.text)
+  }
+})
+
+bot.start()
+
+// Attach MCP server to Claude queries
+const response = await query({
+  prompt: 'Ask the user what they prefer.',
+  options: {
+    model: 'claude-opus-4-5',
+    mcpServers: { 'telegram-ui': ui.server },
+  },
+})
+
+// Cleanup on exit
+process.on('SIGTERM', () => ui.destroy())
+```
+
+## Usage (Telegraf)
+
+```ts
+import { Telegraf } from 'telegraf'
+import { createTelegramUiServer, createTelegrafAdapter } from 'alpha-claude-telegram-ask-user'
+
+const bot = new Telegraf(process.env.TELEGRAM_BOT_TOKEN!)
+const adapter = createTelegrafAdapter(bot)
+const ui = createTelegramUiServer(adapter, chatId)
+
+bot.on('callback_query', async (ctx) => {
+  if ('data' in ctx.callbackQuery) {
+    await ui.handleCallbackQuery(ctx.callbackQuery.data, ctx.callbackQuery.id)
+  }
+})
+```
+
+## Custom store (Redis, SQLite, etc.)
+
+Inject your own store via the `store` option:
+
+```ts
+import type { QuestionStore, PendingQuestion } from 'alpha-claude-telegram-ask-user'
+
+class MyStore implements QuestionStore {
+  async set(id: string, q: PendingQuestion) { /* ... */ }
+  async get(id: string) { /* ... */ }
+  async delete(id: string) { /* ... */ }
+  async getExpired(now: number) { /* ... */ }
+}
+
+const ui = createTelegramUiServer(adapter, chatId, { store: new MyStore() })
+```
+
+See `examples/custom-store-example.ts` for a full SQLite implementation.
+
+## API
+
+### `createTelegramUiServer(adapter, chatId, options?)`
+
+Returns `{ server, handleCallbackQuery, handleForceReplyMessage, destroy }`.
+
+- `server` -- MCP server to pass to `query({ options: { mcpServers } })`
+- `handleCallbackQuery(data, callbackQueryId)` -- call from your bot's callback_query handler
+- `handleForceReplyMessage(replyToMessageId, text)` -- call from your bot's message handler
+- `destroy()` -- clears timers and in-flight state on shutdown
+
+### `createGrammyAdapter(bot)` / `createTelegrafAdapter(bot)`
+
+Wrap your bot instance into the framework-agnostic `TelegramAdapter`.
+
+### `InMemoryStore`
+
+Default store. No external dependencies.
+
+## Known issues (alpha)
+
+- One `createTelegramUiServer` instance per process (module-level resolver maps)
+- `ask_user` blocks the agent turn until the user responds (or timeout)
+- No built-in retry on Telegram API errors
+- ForceReply ("Autre") requires the user to explicitly reply to the bot message
+
+## License
+
+MIT

package/dist/adapters/grammy.d.ts

@@ -0,0 +1,4 @@
+import type { Bot, Context } from 'grammy';
+import type { TelegramAdapter } from '../types.js';
+export declare function createGrammyAdapter(bot: Bot<Context>): TelegramAdapter;
+//# sourceMappingURL=grammy.d.ts.map

package/dist/adapters/grammy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammy.d.ts","sourceRoot":"","sources":["../../src/adapters/grammy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,aAAa,CAAA;AAExE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,eAAe,CA6BtE"}

package/dist/adapters/grammy.js

@@ -0,0 +1,28 @@
+export function createGrammyAdapter(bot) {
+    return {
+        async sendMessage(chatId, text, keyboard) {
+            const reply_markup = keyboard ? { inline_keyboard: keyboard } : undefined;
+            const msg = await bot.api.sendMessage(chatId, text, { reply_markup });
+            return { messageId: msg.message_id };
+        },
+        async editMessage(chatId, messageId, text, keyboard) {
+            // Pass `{ inline_keyboard: [] }` (not `undefined`) to actively remove the keyboard.
+            // Passing `reply_markup: undefined` is dropped by JSON.stringify and Telegram
+            // preserves the existing keyboard -- which is NOT the desired behavior on resolve/timeout.
+            const reply_markup = keyboard
+                ? { inline_keyboard: keyboard }
+                : { inline_keyboard: [] };
+            await bot.api.editMessageText(chatId, messageId, text, { reply_markup });
+        },
+        async answerCallbackQuery(callbackQueryId, text) {
+            await bot.api.answerCallbackQuery(callbackQueryId, { text });
+        },
+        async sendForceReply(chatId, promptText) {
+            const msg = await bot.api.sendMessage(chatId, promptText, {
+                reply_markup: { force_reply: true, selective: true },
+            });
+            return { messageId: msg.message_id };
+        },
+    };
+}
+//# sourceMappingURL=grammy.js.map

package/dist/adapters/grammy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammy.js","sourceRoot":"","sources":["../../src/adapters/grammy.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,mBAAmB,CAAC,GAAiB;IACnD,OAAO;QACL,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACtC,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;YACzE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,CAAC,CAAA;YACrE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE,CAAA;QACtC,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ;YACjD,oFAAoF;YACpF,8EAA8E;YAC9E,2FAA2F;YAC3F,MAAM,YAAY,GAAG,QAAQ;gBAC3B,CAAC,CAAC,EAAE,eAAe,EAAE,QAAQ,EAAE;gBAC/B,CAAC,CAAC,EAAE,eAAe,EAAE,EAA0B,EAAE,CAAA;YACnD,MAAM,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,CAAC,CAAA;QAC1E,CAAC;QAED,KAAK,CAAC,mBAAmB,CAAC,eAAe,EAAE,IAAI;YAC7C,MAAM,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;QAC9D,CAAC;QAED,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,UAAU;YACrC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE;gBACxD,YAAY,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;aACrD,CAAC,CAAA;YACF,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE,CAAA;QACtC,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/adapters/telegraf.d.ts

@@ -0,0 +1,4 @@
+import type { Telegraf, Context } from 'telegraf';
+import type { TelegramAdapter } from '../types.js';
+export declare function createTelegrafAdapter(bot: Telegraf<Context>): TelegramAdapter;
+//# sourceMappingURL=telegraf.d.ts.map

package/dist/adapters/telegraf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegraf.d.ts","sourceRoot":"","sources":["../../src/adapters/telegraf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AACjD,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,aAAa,CAAA;AAExE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,eAAe,CA4B7E"}

package/dist/adapters/telegraf.js

@@ -0,0 +1,27 @@
+export function createTelegrafAdapter(bot) {
+    return {
+        async sendMessage(chatId, text, keyboard) {
+            const reply_markup = keyboard ? { inline_keyboard: keyboard } : undefined;
+            const msg = await bot.telegram.sendMessage(chatId, text, { reply_markup });
+            return { messageId: msg.message_id };
+        },
+        async editMessage(chatId, messageId, text, keyboard) {
+            // Same fix as grammY adapter: use `{ inline_keyboard: [] }` to remove keyboard.
+            // Telegraf v4 editMessageText signature: (chat_id, message_id, inline_message_id, text, extra?)
+            const reply_markup = keyboard
+                ? { inline_keyboard: keyboard }
+                : { inline_keyboard: [] };
+            await bot.telegram.editMessageText(chatId, messageId, undefined, text, { reply_markup });
+        },
+        async answerCallbackQuery(callbackQueryId, text) {
+            await bot.telegram.answerCbQuery(callbackQueryId, text);
+        },
+        async sendForceReply(chatId, promptText) {
+            const msg = await bot.telegram.sendMessage(chatId, promptText, {
+                reply_markup: { force_reply: true, selective: true },
+            });
+            return { messageId: msg.message_id };
+        },
+    };
+}
+//# sourceMappingURL=telegraf.js.map

package/dist/adapters/telegraf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegraf.js","sourceRoot":"","sources":["../../src/adapters/telegraf.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,qBAAqB,CAAC,GAAsB;IAC1D,OAAO;QACL,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACtC,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;YACzE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,CAAC,CAAA;YAC1E,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE,CAAA;QACtC,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ;YACjD,gFAAgF;YAChF,gGAAgG;YAChG,MAAM,YAAY,GAAG,QAAQ;gBAC3B,CAAC,CAAC,EAAE,eAAe,EAAE,QAAQ,EAAE;gBAC/B,CAAC,CAAC,EAAE,eAAe,EAAE,EAA0B,EAAE,CAAA;YACnD,MAAM,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,CAAC,CAAA;QAC1F,CAAC;QAED,KAAK,CAAC,mBAAmB,CAAC,eAAe,EAAE,IAAI;YAC7C,MAAM,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,eAAe,EAAE,IAAI,CAAC,CAAA;QACzD,CAAC;QAED,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,UAAU;YACrC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE;gBAC7D,YAAY,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;aACrD,CAAC,CAAA;YACF,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE,CAAA;QACtC,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { createTelegramUiServer } from './server.js';
+export { InMemoryStore } from './store.js';
+export { createGrammyAdapter } from './adapters/grammy.js';
+export { createTelegrafAdapter } from './adapters/telegraf.js';
+export { parseCallbackData, buildInlineKeyboard, formatQuestionText, generateShortId } from './keyboard.js';
+export type { TelegramAdapter, TelegramUiOptions, QuestionStore, QuestionOption, PendingQuestion, InlineButton, InlineKeyboardMarkup, CallbackAction, } from './types.js';
+export type { TelegramUiServer } from './server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAG3G,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,cAAc,GACf,MAAM,YAAY,CAAA;AAGnB,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+// Public API
+export { createTelegramUiServer } from './server.js';
+export { InMemoryStore } from './store.js';
+export { createGrammyAdapter } from './adapters/grammy.js';
+export { createTelegrafAdapter } from './adapters/telegraf.js';
+export { parseCallbackData, buildInlineKeyboard, formatQuestionText, generateShortId } from './keyboard.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA"}

package/dist/keyboard.d.ts

@@ -0,0 +1,6 @@
+import type { CallbackAction, InlineKeyboardMarkup, QuestionOption } from './types.js';
+export declare function generateShortId(): string;
+export declare function parseCallbackData(data: string): CallbackAction | null;
+export declare function buildInlineKeyboard(questionId: string, options: QuestionOption[], multiSelect: boolean, selected?: number[]): InlineKeyboardMarkup;
+export declare function formatQuestionText(question: string, header: string | undefined, options: QuestionOption[]): string;
+//# sourceMappingURL=keyboard.d.ts.map

package/dist/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../src/keyboard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAItF,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAmBrE;AAID,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EAAE,EACzB,WAAW,EAAE,OAAO,EACpB,QAAQ,GAAE,MAAM,EAAO,GACtB,oBAAoB,CA6BtB;AAID,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,cAAc,EAAE,GACxB,MAAM,CAMR"}

package/dist/keyboard.js

@@ -0,0 +1,65 @@
+import { randomBytes } from 'crypto';
+// -- Short ID generator ---------------------------------------------------
+export function generateShortId() {
+    return randomBytes(4).toString('hex'); // 8 hex chars
+}
+// -- Callback data parser -------------------------------------------------
+export function parseCallbackData(data) {
+    if (!data.startsWith('q:'))
+        return null;
+    const parts = data.split(':');
+    if (parts.length < 3)
+        return null;
+    const questionId = parts[1];
+    if (!questionId)
+        return null;
+    if (parts[2] === 'done')
+        return { questionId, action: 'done' };
+    if (parts[2] === 'other')
+        return { questionId, action: 'other' };
+    if (parts[2] === 't' && parts.length === 4) {
+        const index = parseInt(parts[3], 10);
+        if (isNaN(index))
+            return null;
+        return { questionId, action: 'toggle', index };
+    }
+    const index = parseInt(parts[2], 10);
+    if (isNaN(index))
+        return null;
+    return { questionId, action: 'select', index };
+}
+// -- Keyboard builder ----------------------------------------------------
+export function buildInlineKeyboard(questionId, options, multiSelect, selected = []) {
+    const rows = [];
+    let currentRow = [];
+    for (let i = 0; i < options.length; i++) {
+        const callbackData = multiSelect
+            ? `q:${questionId}:t:${i}`
+            : `q:${questionId}:${i}`;
+        const prefix = multiSelect && selected.includes(i) ? '-> ' : '';
+        currentRow.push({ text: `${prefix}${options[i].label}`, callback_data: callbackData });
+        // 2 buttons per row
+        if (currentRow.length === 2 || i === options.length - 1) {
+            rows.push(currentRow);
+            currentRow = [];
+        }
+    }
+    // Action row
+    const actionRow = [
+        { text: 'Autre', callback_data: `q:${questionId}:other` },
+    ];
+    if (multiSelect) {
+        actionRow.push({ text: 'Valider', callback_data: `q:${questionId}:done` });
+    }
+    rows.push(actionRow);
+    return rows;
+}
+// -- Question text formatter --------------------------------------------
+export function formatQuestionText(question, header, options) {
+    const headerLine = header ? `[${header}] ` : '';
+    const optionLines = options
+        .map((o, i) => `${i + 1}. ${o.label} -- ${o.description}`)
+        .join('\n');
+    return `${headerLine}${question}\n\n${optionLines}`;
+}
+//# sourceMappingURL=keyboard.js.map

package/dist/keyboard.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,14 @@
+import { createSdkMcpServer } from '@anthropic-ai/claude-agent-sdk';
+import type { TelegramAdapter, TelegramUiOptions } from './types.js';
+type McpServer = ReturnType<typeof createSdkMcpServer>;
+export interface TelegramUiServer {
+    server: McpServer;
+    handleCallbackQuery(callbackData: string, callbackQueryId: string): Promise<void>;
+    handleForceReplyMessage(replyToMessageId: number, answerText: string): Promise<boolean>;
+    destroy(): void;
+}
+export declare const pendingResolvers: Map<string, (answer: string) => void>;
+export declare const pendingForceReplies: Map<number, string>;
+export declare function createTelegramUiServer(adapter: TelegramAdapter, chatId: string, options?: TelegramUiOptions): TelegramUiServer;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAQ,MAAM,gCAAgC,CAAA;AAIzE,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAGlB,MAAM,YAAY,CAAA;AAGnB,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAGtD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,SAAS,CAAA;IACjB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjF,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACvF,OAAO,IAAI,IAAI,CAAA;CAChB;AAID,eAAO,MAAM,gBAAgB,uBAA4B,MAAM,KAAK,IAAI,CAAG,CAAA;AAC3E,eAAO,MAAM,mBAAmB,qBAA4B,CAAA;AAI5D,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CAgQlB"}

package/dist/server.js

@@ -0,0 +1,212 @@
+import { createSdkMcpServer, tool } from '@anthropic-ai/claude-agent-sdk';
+import { z } from 'zod';
+import { InMemoryStore } from './store.js';
+import { generateShortId, buildInlineKeyboard, formatQuestionText, parseCallbackData } from './keyboard.js';
+// -- Module-level singletons (one instance per process) -------------------
+export const pendingResolvers = new Map();
+export const pendingForceReplies = new Map(); // messageId -> questionId
+// -- Factory --------------------------------------------------------------
+export function createTelegramUiServer(adapter, chatId, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 300_000;
+    const store = options.store ?? new InMemoryStore();
+    // -- ask_user tool handler -------------------------------------------
+    async function handleAskUser(args) {
+        if (args.options.length < 2 || args.options.length > 4) {
+            return 'ask_user requires between 2 and 4 options.';
+        }
+        const questionId = generateShortId();
+        const multiSelect = args.multi_select ?? false;
+        const now = Math.floor(Date.now() / 1000);
+        const question = {
+            id: questionId,
+            chatId,
+            messageId: null,
+            question: args.question,
+            header: args.header ?? null,
+            options: args.options,
+            multiSelect,
+            selected: [],
+            answered: false,
+            createdAt: now,
+            expiresAt: now + Math.floor(timeoutMs / 1000),
+        };
+        await store.set(questionId, question);
+        const kb = buildInlineKeyboard(questionId, args.options, multiSelect);
+        const text = formatQuestionText(args.question, args.header, args.options);
+        let sentMessageId;
+        try {
+            const sent = await adapter.sendMessage(chatId, text, kb);
+            sentMessageId = sent.messageId;
+            const updated = { ...question, messageId: sentMessageId };
+            await store.set(questionId, updated);
+        }
+        catch {
+            await store.delete(questionId);
+            return 'Failed to reach user. Proceed with best judgment.';
+        }
+        // Wait for answer
+        const answer = await new Promise((resolve) => {
+            pendingResolvers.set(questionId, resolve);
+            setTimeout(async () => {
+                if (pendingResolvers.has(questionId)) {
+                    pendingResolvers.delete(questionId);
+                    const q = await store.get(questionId);
+                    if (q?.messageId) {
+                        adapter.editMessage(chatId, q.messageId, `${text}\n\n-- Question expiree`, { inline_keyboard: [] }).catch(() => { });
+                    }
+                    await store.delete(questionId);
+                    resolve('__timeout__');
+                }
+            }, timeoutMs);
+        });
+        pendingResolvers.delete(questionId);
+        if (answer === '__timeout__') {
+            const minutes = Math.round(timeoutMs / 60_000);
+            return `User did not respond within ${minutes} minutes. Proceed with best judgment.`;
+        }
+        return answer;
+    }
+    // -- MCP server -------------------------------------------------------
+    const server = createSdkMcpServer({
+        name: 'telegram-ui',
+        version: '1.0.0',
+        tools: [
+            tool('ask_user', 'Ask the Telegram user a question with clickable buttons. Returns their chosen option or custom text answer.', {
+                question: z.string().describe('The question to ask'),
+                options: z
+                    .array(z.object({ label: z.string(), description: z.string() }))
+                    .min(2)
+                    .max(4)
+                    .describe('2-4 options to choose from'),
+                header: z.string().optional().describe('Short label (max 12 chars)'),
+                multi_select: z.boolean().optional().default(false),
+            }, async (args) => {
+                const answer = await handleAskUser(args);
+                return { content: [{ type: 'text', text: answer }] };
+            }),
+        ],
+    });
+    // -- handleCallbackQuery ----------------------------------------------
+    async function handleCallbackQuery(callbackData, callbackQueryId) {
+        const action = parseCallbackData(callbackData);
+        if (!action)
+            return;
+        const q = await store.get(action.questionId);
+        if (!q) {
+            await adapter.answerCallbackQuery(callbackQueryId).catch(() => { });
+            return;
+        }
+        if (q.answered) {
+            await adapter.answerCallbackQuery(callbackQueryId).catch(() => { });
+            return;
+        }
+        const text = formatQuestionText(q.question, q.header ?? undefined, q.options);
+        if (action.action === 'select') {
+            const chosen = q.options[action.index];
+            if (!chosen) {
+                await adapter.answerCallbackQuery(callbackQueryId).catch(() => { });
+                return;
+            }
+            const updated = { ...q, answered: true };
+            await store.set(q.id, updated);
+            if (q.messageId) {
+                await adapter.editMessage(q.chatId, q.messageId, `${text}\n\n-> ${chosen.label}`).catch(() => { });
+            }
+            const resolver = pendingResolvers.get(q.id);
+            if (resolver) {
+                resolver(chosen.label);
+                pendingResolvers.delete(q.id);
+            }
+        }
+        else if (action.action === 'toggle') {
+            let selected = [...q.selected];
+            if (selected.includes(action.index)) {
+                selected = selected.filter(i => i !== action.index);
+            }
+            else {
+                selected.push(action.index);
+            }
+            const updated = { ...q, selected };
+            await store.set(q.id, updated);
+            const kb = buildInlineKeyboard(q.id, q.options, true, selected);
+            if (q.messageId) {
+                await adapter.editMessage(q.chatId, q.messageId, text, kb).catch(() => { });
+            }
+        }
+        else if (action.action === 'done') {
+            if (q.selected.length === 0) {
+                await adapter.answerCallbackQuery(callbackQueryId, 'Select at least one option').catch(() => { });
+                return;
+            }
+            const chosenLabels = q.selected.map(i => q.options[i]?.label).filter(Boolean);
+            const answer = chosenLabels.join(', ');
+            const updated = { ...q, answered: true };
+            await store.set(q.id, updated);
+            if (q.messageId) {
+                await adapter.editMessage(q.chatId, q.messageId, `${text}\n\n-> ${answer}`).catch(() => { });
+            }
+            const resolver = pendingResolvers.get(q.id);
+            if (resolver) {
+                resolver(answer);
+                pendingResolvers.delete(q.id);
+            }
+        }
+        else if (action.action === 'other') {
+            try {
+                const sent = await adapter.sendForceReply(q.chatId, 'Ecris ta reponse :');
+                pendingForceReplies.set(sent.messageId, q.id);
+            }
+            catch {
+                // ignore
+            }
+        }
+        await adapter.answerCallbackQuery(callbackQueryId).catch(() => { });
+    }
+    // -- handleForceReplyMessage ------------------------------------------
+    async function handleForceReplyMessage(replyToMessageId, answerText) {
+        const questionId = pendingForceReplies.get(replyToMessageId);
+        if (!questionId)
+            return false;
+        pendingForceReplies.delete(replyToMessageId);
+        const q = await store.get(questionId);
+        if (!q || q.answered)
+            return false;
+        const updated = { ...q, answered: true };
+        await store.set(q.id, updated);
+        if (q.messageId) {
+            const text = formatQuestionText(q.question, q.header ?? undefined, q.options);
+            await adapter.editMessage(q.chatId, q.messageId, `${text}\n\n-> ${answerText}`).catch(() => { });
+        }
+        const resolver = pendingResolvers.get(q.id);
+        if (resolver) {
+            resolver(answerText);
+            pendingResolvers.delete(q.id);
+        }
+        return true;
+    }
+    // -- Cleanup interval (safety net) ------------------------------------
+    const cleanupInterval = setInterval(async () => {
+        const now = Math.floor(Date.now() / 1000);
+        const expired = await store.getExpired(now);
+        for (const q of expired) {
+            const text = formatQuestionText(q.question, q.header ?? undefined, q.options);
+            if (q.messageId) {
+                await adapter.editMessage(q.chatId, q.messageId, `${text}\n\n-- Question expiree`).catch(() => { });
+            }
+            const resolver = pendingResolvers.get(q.id);
+            if (resolver) {
+                resolver('__timeout__');
+                pendingResolvers.delete(q.id);
+            }
+            await store.delete(q.id);
+        }
+    }, 60_000);
+    // -- destroy ----------------------------------------------------------
+    function destroy() {
+        clearInterval(cleanupInterval);
+        pendingResolvers.clear();
+        pendingForceReplies.clear();
+    }
+    return { server, handleCallbackQuery, handleForceReplyMessage, destroy };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,9 @@
+import type { PendingQuestion, QuestionStore } from './types.js';
+export declare class InMemoryStore implements QuestionStore {
+    private readonly map;
+    set(id: string, question: PendingQuestion): Promise<void>;
+    get(id: string): Promise<PendingQuestion | undefined>;
+    delete(id: string): Promise<void>;
+    getExpired(now: number): Promise<PendingQuestion[]>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEhE,qBAAa,aAAc,YAAW,aAAa;IACjD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqC;IAEnD,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAIrD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAS1D"}

package/dist/store.js

@@ -0,0 +1,22 @@
+export class InMemoryStore {
+    map = new Map();
+    async set(id, question) {
+        this.map.set(id, question);
+    }
+    async get(id) {
+        return this.map.get(id);
+    }
+    async delete(id) {
+        this.map.delete(id);
+    }
+    async getExpired(now) {
+        const result = [];
+        for (const q of this.map.values()) {
+            if (q.expiresAt < now && !q.answered) {
+                result.push(q);
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IACP,GAAG,GAAG,IAAI,GAAG,EAA2B,CAAA;IAEzD,KAAK,CAAC,GAAG,CAAC,EAAU,EAAE,QAAyB;QAC7C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;IAC5B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACzB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACrB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAW;QAC1B,MAAM,MAAM,GAAsB,EAAE,CAAA;QACpC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,CAAC,SAAS,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;gBACrC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAChB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,59 @@
+export interface InlineButton {
+    text: string;
+    callback_data: string;
+}
+/** Rows of buttons. Each row is an array of buttons. */
+export type InlineKeyboardMarkup = InlineButton[][];
+export interface TelegramAdapter {
+    sendMessage(chatId: string, text: string, keyboard?: InlineKeyboardMarkup): Promise<{
+        messageId: number;
+    }>;
+    editMessage(chatId: string, messageId: number, text: string, keyboard?: InlineKeyboardMarkup): Promise<void>;
+    answerCallbackQuery(callbackQueryId: string, text?: string): Promise<void>;
+    sendForceReply(chatId: string, promptText: string): Promise<{
+        messageId: number;
+    }>;
+}
+export interface QuestionOption {
+    label: string;
+    description: string;
+}
+export interface PendingQuestion {
+    id: string;
+    chatId: string;
+    messageId: number | null;
+    question: string;
+    header: string | null;
+    options: QuestionOption[];
+    multiSelect: boolean;
+    selected: number[];
+    answered: boolean;
+    createdAt: number;
+    expiresAt: number;
+}
+export type CallbackAction = {
+    questionId: string;
+    action: 'select';
+    index: number;
+} | {
+    questionId: string;
+    action: 'toggle';
+    index: number;
+} | {
+    questionId: string;
+    action: 'done';
+} | {
+    questionId: string;
+    action: 'other';
+};
+export interface QuestionStore {
+    set(id: string, question: PendingQuestion): Promise<void>;
+    get(id: string): Promise<PendingQuestion | undefined>;
+    delete(id: string): Promise<void>;
+    getExpired(now: number): Promise<PendingQuestion[]>;
+}
+export interface TelegramUiOptions {
+    timeoutMs?: number;
+    store?: QuestionStore;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,wDAAwD;AACxD,MAAM,MAAM,oBAAoB,GAAG,YAAY,EAAE,EAAE,CAAA;AAInD,MAAM,WAAW,eAAe;IAC9B,WAAW,CACT,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAEjC,WAAW,CACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAAA;IAEhB,mBAAmB,CACjB,eAAe,EAAE,MAAM,EACvB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAAA;IAEhB,cAAc,CACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAClC;AAID,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB;AAID,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,WAAW,EAAE,OAAO,CAAA;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAID,MAAM,MAAM,cAAc,GACtB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAA;AAI3C,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAA;IACrD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;CACpD;AAID,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,aAAa,CAAA;CACtB"}

package/dist/types.js

@@ -0,0 +1,7 @@
+// -- Framework-agnostic keyboard types ------------------------------------
+export {};
+// NOTE: TelegramUiServer is NOT defined here to avoid coupling types.ts to the SDK.
+// It is derived in server.ts via:
+//   export type TelegramUiServer = ReturnType<typeof createTelegramUiServer>
+// index.ts re-exports it from server.ts, not from types.ts.
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,4EAA4E;;AAoF5E,oFAAoF;AACpF,kCAAkC;AAClC,6EAA6E;AAC7E,4DAA4D"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "mcp-telegram-ask-claude",
+  "version": "1.0.0",
+  "description": "MCP bridge: Claude Agent SDK ask_user tool -> Telegram inline keyboards",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "dev": "tsc --watch"
+  },
+  "keywords": [
+    "claude",
+    "mcp",
+    "telegram",
+    "ask-user",
+    "inline-keyboard",
+    "grammy",
+    "telegraf"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.78",
+    "zod": "^4.0.0"
+  },
+  "peerDependencies": {
+    "grammy": ">=1.0.0",
+    "telegraf": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "grammy": {
+      "optional": true
+    },
+    "telegraf": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "grammy": "^1.41.1",
+    "telegraf": "^4.16.3",
+    "typescript": "^5.9.3",
+    "vitest": "^2.0.0"
+  }
+}