polygram 0.5.0 → 0.5.2

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "polygram",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Telegram integration for Claude Code that preserves the OpenClaw per-chat session model. Migration target for OpenClaw users. Multi-bot, multi-chat, per-topic isolation; SQLite transcripts; inline-keyboard approvals. Bundles /polygram:status|logs|pair-code|approvals admin commands and a history skill.",
   "keywords": [
     "telegram",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polygram",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Telegram daemon for Claude Code that preserves the OpenClaw per-chat session model. Migration path for OpenClaw users moving to Claude Code.",
   "main": "lib/ipc-client.js",
   "bin": {

package/polygram.js

@@ -737,6 +737,62 @@ function buildApprovalKeyboard(approvalId, token) {
   };
 }
 
+// /model and /effort inline keyboard. `show` controls which row(s) appear:
+// 'model', 'effort', or 'all'. The current value gets a ✓ marker so the
+// user can see at a glance what's selected.
+const MODEL_OPTIONS = ['opus', 'sonnet', 'haiku'];
+const EFFORT_OPTIONS = ['low', 'medium', 'high', 'xhigh', 'max'];
+
+function buildConfigKeyboard(chatConfig, show = 'all') {
+  const rows = [];
+  if (show === 'model' || show === 'all') {
+    rows.push(MODEL_OPTIONS.map((m) => ({
+      text: m === chatConfig.model ? `✓ ${m}` : m,
+      callback_data: `cfg:model:${m}`,
+    })));
+  }
+  if (show === 'effort' || show === 'all') {
+    rows.push(EFFORT_OPTIONS.map((e) => ({
+      text: e === chatConfig.effort ? `✓ ${e}` : e,
+      callback_data: `cfg:effort:${e}`,
+    })));
+  }
+  return { inline_keyboard: rows };
+}
+
+// Card text shown above the inline keyboard. Includes plain-language
+// guidance on when to pick which model / effort, since most users
+// (especially in shared groups) don't know which option to tap.
+const MODEL_VERSIONS_DESC = { opus: 'claude-opus-4-6', sonnet: 'claude-sonnet-4-6', haiku: 'claude-haiku-4-5' };
+
+function formatConfigInfoText(chatConfig, show, sessionKey) {
+  const alive = pm.has(sessionKey) && !pm.get(sessionKey).closed;
+  const ver = MODEL_VERSIONS_DESC[chatConfig.model] || chatConfig.model;
+  const head = `Model: ${chatConfig.model} (${ver})\nEffort: ${chatConfig.effort}\nAgent: ${chatConfig.agent}\nProcess: ${alive ? 'warm' : 'cold'}\nSession: ${getClaudeSessionId(db, sessionKey)?.slice(0, 8) || 'new'}`;
+
+  const modelHelp = [
+    '',
+    '**Models**',
+    '🧠 **opus** — глубокий анализ, code refactor, сверка из 3+ источников. ~5× стоимость sonnet.',
+    '🤖 **sonnet** — дефолт. Большинство ops, code review, document summary.',
+    '⚡ **haiku** — простые быстрые задачи, классификация, lookup.',
+  ].join('\n');
+
+  const effortHelp = [
+    '',
+    '**Effort** — потолок «сколько Claude может думать». На простых вопросах он сам отвечает быстро, на сложных тратит больше токенов. Можно безопасно ставить выше — он не разгонится без нужды.',
+    '• **low** — fast replies, минимум reasoning. Casual chat, simple lookups.',
+    '• **medium** — balanced default. Подходит почти всем.',
+    '• **high** — сложные многошаговые задачи. Audit, debug, multi-source.',
+    '• **xhigh** / **max** — самые тяжёлые. Hard reasoning, edge cases.',
+  ].join('\n');
+
+  let body = head;
+  if (show === 'model' || show === 'all') body += '\n' + modelHelp;
+  if (show === 'effort' || show === 'all') body += '\n' + effortHelp;
+  return body;
+}
+
 function approvalCardText(row, opts = {}) {
   // No parse_mode is used on this card — tool_name/turn_id/tool_input
   // originate from the Claude subprocess and could contain Markdown special
@@ -927,6 +983,93 @@ async function handleApprovalCallback(ctx) {
   resolveApprovalWaiter(id, status);
 }
 
+// Handles taps on the /model and /effort inline keyboard buttons. Same
+// outcome as the text-typed `/model sonnet` flow: mutate chatConfig,
+// trigger graceful respawn, log config change, edit the message to show
+// the new ✓ marker.
+async function handleConfigCallback(ctx) {
+  const data = ctx.callbackQuery?.data || '';
+  const m = String(data).match(/^cfg:(model|effort):(\S+)$/);
+  if (!m) return;
+  const setting = m[1];
+  const value = m[2];
+
+  const chatId = String(ctx.callbackQuery.message?.chat?.id || '');
+  const chatConfig = config.chats[chatId];
+  if (!chatConfig) {
+    await ctx.answerCallbackQuery({ text: 'Chat not configured', show_alert: true }).catch(() => {});
+    return;
+  }
+  if (!config.bot?.allowConfigCommands) {
+    await ctx.answerCallbackQuery({ text: 'Config commands disabled', show_alert: true }).catch(() => {});
+    return;
+  }
+
+  const validValues = setting === 'model' ? MODEL_OPTIONS : EFFORT_OPTIONS;
+  if (!validValues.includes(value)) {
+    await ctx.answerCallbackQuery({ text: `Invalid ${setting}` }).catch(() => {});
+    return;
+  }
+
+  const oldValue = chatConfig[setting];
+  if (oldValue === value) {
+    await ctx.answerCallbackQuery({ text: `Already ${value}` }).catch(() => {});
+    return;
+  }
+
+  chatConfig[setting] = value;
+  const cmdUserId = ctx.callbackQuery.from?.id || null;
+  const cmdUser = ctx.callbackQuery.from?.first_name || ctx.callbackQuery.from?.username || null;
+  dbWrite(() => db.logConfigChange({
+    chat_id: chatId, thread_id: null, field: setting,
+    old_value: oldValue, new_value: value,
+    user: cmdUser, user_id: cmdUserId, source: 'inline-button',
+  }), `log ${setting} change`);
+
+  // Graceful respawn across all sessionKeys for this chat (matches the
+  // text-command flow in handleMessage).
+  const reason = setting === 'model' ? 'model-change' : 'effort-change';
+  const prefix = chatId;
+  let anyActive = false;
+  for (const key of pm.keys()) {
+    if (key === prefix || key.startsWith(prefix + ':')) {
+      const res = pm.requestRespawn(key, reason);
+      if (!res.killed) anyActive = true;
+    }
+  }
+
+  // Re-render the card with updated ✓ + the same help text shown initially.
+  // Detect original card type (model-only / effort-only / both) by counting
+  // rows in the existing reply_markup so the user sees the same layout
+  // they tapped into.
+  const existingRows = ctx.callbackQuery.message?.reply_markup?.inline_keyboard?.length || 0;
+  const showRow = existingRows >= 2 ? 'all' : setting;
+  // chatId works as a session-key proxy here for the warm-process check
+  // (isolateTopics chats might have multiple keys but for this card we
+  // just want a representative state).
+  const newInfo = formatConfigInfoText(chatConfig, showRow, chatId);
+  const newKeyboard = buildConfigKeyboard(chatConfig, showRow);
+  try {
+    // Pre-format the markdown→HTML ourselves so editMessageText can be
+    // called with the right parse_mode (the bot.api.editMessageText path
+    // bypasses tg() / applyFormatting in the chat-action approval card,
+    // but here we DO want HTML).
+    const { toTelegramHtml } = require('./lib/telegram-format');
+    const { text: html, parseMode } = toTelegramHtml(newInfo);
+    await ctx.editMessageText(html, {
+      reply_markup: newKeyboard,
+      ...(parseMode && { parse_mode: parseMode }),
+    });
+  } catch (err) {
+    console.error(`[${BOT_NAME}] config-card edit failed: ${err.message}`);
+  }
+
+  const ackText = anyActive
+    ? `${setting} → ${value} — switching when finished`
+    : `${setting} → ${value}`;
+  await ctx.answerCallbackQuery({ text: ackText }).catch(() => {});
+}
+
 function startApprovalSweeper(intervalMs = 30_000) {
   return setInterval(() => {
     let rows;
@@ -1006,15 +1149,20 @@ async function handleMessage(sessionKey, chatId, msg, bot) {
   const cmdUser = msg.from?.first_name || msg.from?.username || null;
   const cmdUserId = msg.from?.id || null;
 
-  const sendReply = (replyText, meta = {}) => tg(bot, 'sendMessage', {
-    chat_id: chatId, text: replyText, ...replyOpts(threadId),
-  }, { source: 'command-reply', botName: BOT_NAME, model: chatConfig.model, effort: chatConfig.effort, ...meta });
+  // sendReply accepts (text, meta?) with optional extra Telegram params
+  // pulled out via meta.params (kept separate so meta stays for DB tags).
+  const sendReply = (replyText, meta = {}) => {
+    const { params: extraParams = {}, ...metaTags } = meta;
+    return tg(bot, 'sendMessage', {
+      chat_id: chatId, text: replyText, ...replyOpts(threadId), ...extraParams,
+    }, { source: 'command-reply', botName: BOT_NAME, model: chatConfig.model, effort: chatConfig.effort, ...metaTags });
+  };
 
   if (botAllowsCommands && (text === '/model' || text === '/config' || text === '/effort')) {
-    const alive = pm.has(sessionKey) && !pm.get(sessionKey).closed;
-    const ver = MODEL_VERSIONS[chatConfig.model] || chatConfig.model;
-    const info = `Model: ${chatConfig.model} (${ver})\nEffort: ${chatConfig.effort}\nAgent: ${chatConfig.agent}\nProcess: ${alive ? 'warm' : 'cold'}\nSession: ${getClaudeSessionId(db, sessionKey)?.slice(0, 8) || 'new'}`;
-    await sendReply(info);
+    const show = text === '/effort' ? 'effort' : text === '/model' ? 'model' : 'all';
+    const info = formatConfigInfoText(chatConfig, show, sessionKey);
+    const reply_markup = buildConfigKeyboard(chatConfig, show);
+    await sendReply(info, { params: { reply_markup } });
     return;
   }
   // Helper: request respawn across ALL sessionKeys owned by this chat (one
@@ -1665,7 +1813,12 @@ function createBot(token) {
 
   bot.on('callback_query:data', async (ctx) => {
     try {
-      await handleApprovalCallback(ctx);
+      const data = ctx.callbackQuery?.data || '';
+      if (data.startsWith('cfg:')) {
+        await handleConfigCallback(ctx);
+      } else {
+        await handleApprovalCallback(ctx);
+      }
     } catch (err) {
       console.error(`[${BOT_NAME}] callback_query error: ${err.message}`);
     }