claude-telegram-bot 0.2.4 → 0.2.6

package/README.ko.md

@@ -92,7 +92,7 @@ claude-telegram-bot ~/botconfigs/myproj/config.json
 | `projectDir` | Claude가 작업할 폴더의 절대경로 |
 | `claudeBin` | `which claude` 결과 (절대경로 권장) |
 | `permissionMode` | `plan`(읽기·계획만) / `acceptEdits`(편집 자동 승인) / `bypassPermissions`(쉘 포함 전부 자동) |
-| `model` | 비우면 기본 모델. `opus`, `sonnet` 등 |
+| `model` | 비우면 기본 모델. `opus`, `sonnet` 등. 런타임에 `/model`로 전환 가능(state에 저장) |
 | `lang` | (선택) UI 언어. 비우면 사용자별 자동 판별(기본 영어, 텔레그램이 한국어면 한국어). `"en"`/`"ko"`로 고정 가능 |
 | `name` | (선택) `/help`에 표시되는 봇 이름. 여러 봇 구분용 |
 | `persona` | (선택) 역할 시스템 프롬프트. 페르소나 봇 정의용 |
@@ -110,7 +110,7 @@ claude-telegram-bot ~/botconfigs/myproj/config.json
    - `테스트 돌려보고 통과하면 커밋하고 push 해줘`
    - `api.ts 에 에러 핸들링 추가해줘`
 
-명령어: `/new`(맥락 초기화) · `/cron`(예약 작업 보기·추가·삭제) · `/restart`(문법 검사 후 재시작) · `/status`(봇 상태·버전) · `/id`(채팅 ID 확인) · `/help`(도움말)
+명령어: `/new`(맥락 초기화) · `/cron`(예약 작업 보기·추가·삭제) · `/restart`(문법 검사 후 재시작) · `/status`(봇 상태·버전) · `/model`(모델 보기·전환) · `/id`(채팅 ID 확인) · `/help`(도움말)
 
 > **`/restart`** 는 먼저 `bot.mjs` 에 `node --check` 를 돌려 **문법 오류가 있으면 재시작을 취소**합니다(잘못된 수정이 봇을 크래시 루프에 빠뜨리는 것 방지). 통과하면 프로세스를 종료하고, 다시 띄우는 건 프로세스 관리자에게 맡깁니다. [launchd 설정](#상시-실행-launchd)(`KeepAlive`)이면 바로 동작하고, 관리자 없이 `node bot.mjs` 로만 돌리면 그냥 멈춥니다. 재시작 후 대화 세션은 `state.json` 의 ID로 이어집니다.
 

package/README.md

@@ -154,7 +154,7 @@ auth layer.)
 - `run the solver tests and commit + push if they pass`
 - `add an edge case to solve-2nd-floor-edges.ts`
 
-Commands: `/new` (reset context / new session) · `/cron` (list / add / remove scheduled tasks) · `/restart` (syntax-check & restart the bot) · `/status` (bot status & version) · `/id` (show chat ID) · `/help`.
+Commands: `/new` (reset context / new session) · `/cron` (list / add / remove scheduled tasks) · `/restart` (syntax-check & restart the bot) · `/status` (bot status & version) · `/model` (view / switch the model) · `/id` (show chat ID) · `/help`.
 
 > **`/restart`** runs `node --check` on `bot.mjs` first and **aborts the restart if it has a syntax
 > error** (so a bad edit can't crash-loop the bot), then exits — relying on a process supervisor
@@ -184,7 +184,7 @@ Edit `config.json`:
 | `projectDir` | Absolute path to the working folder Claude runs in |
 | `claudeBin` | Output of `which claude` (absolute path recommended) |
 | `permissionMode` | `plan` / `acceptEdits` / `bypassPermissions` — see [Security](#security) |
-| `model` | Empty = default. Or `opus` / `sonnet`, etc. |
+| `model` | Empty = default. Or `opus` / `sonnet`, etc. Override at runtime with `/model` (persists in state). |
 | `lang` | (optional) UI language. Empty = auto-detect per user (English default, Korean for Korean Telegram clients). Force with `"en"` / `"ko"`. |
 | `name` | (optional) Bot name shown in `/help` — handy for telling multiple bots apart |
 | `persona` | (optional) Role system prompt — defines a persona (developer/planner/…). See below |

package/bot.mjs

@@ -129,6 +129,7 @@ const STR = {
       "• /cron — list tasks · /cron add <natural language> to add · /cron rm <id> to remove\n" +
       "• /restart — restart the bot (after a syntax check)\n" +
       "• /status — bot status & version\n" +
+      "• /model — view / switch the model\n" +
       "• /id — show this chat ID\n" +
       `\nWorking dir: ${cfg.projectDir}\nPermission mode: ${cfg.permissionMode}`,
     newSession: "🆕 Started a new conversation (previous context cleared).",
@@ -168,6 +169,12 @@ const STR = {
       `• Scheduled jobs: ${i.jobs}\n` +
       `• Project: ${i.projectDir}\n` +
       `• Permission: ${i.permissionMode}`,
+    modelStatus: (cur, list) =>
+      `🧠 Model: ${cur}\n` +
+      `Switch: ${list.map((x) => `/model ${x}`).join(" · ")} (or a full model id)\n` +
+      `/model default — clear the override`,
+    modelSet: (m) => `🧠 Model set to: ${m}`,
+    modelReset: (def) => `🧠 Model reset to default (${def}).`,
   },
   ko: {
     help: () =>
@@ -177,6 +184,7 @@ const STR = {
       "• /cron — 예약 작업 보기 · /cron add <자연어>로 추가 · /cron rm <번호>로 삭제\n" +
       "• /restart — 봇 재시작 (문법 검사 후 안전하게)\n" +
       "• /status — 봇 상태·버전 보기\n" +
+      "• /model — 모델 보기·전환\n" +
       "• /id — 이 채팅 ID 확인\n" +
       `\n작업 폴더: ${cfg.projectDir}\n권한 모드: ${cfg.permissionMode}`,
     newSession: "🆕 새 대화를 시작합니다 (이전 맥락 초기화).",
@@ -215,6 +223,12 @@ const STR = {
       `• 예약 작업: ${i.jobs}개\n` +
       `• 작업 폴더: ${i.projectDir}\n` +
       `• 권한 모드: ${i.permissionMode}`,
+    modelStatus: (cur, list) =>
+      `🧠 현재 모델: ${cur}\n` +
+      `전환: ${list.map((x) => `/model ${x}`).join(" · ")} (또는 전체 모델 ID)\n` +
+      `/model default — 오버라이드 해제`,
+    modelSet: (m) => `🧠 모델을 ${m} (으)로 설정했습니다.`,
+    modelReset: (def) => `🧠 모델을 기본값(${def})으로 되돌렸습니다.`,
   },
 };
 const t = (l, key, ...a) => {
@@ -222,6 +236,9 @@ const t = (l, key, ...a) => {
   return typeof v === "function" ? v(...a) : v;
 };
 
+// /model 에서 보여줄 추천 별칭(claude CLI 가 별칭·전체 모델 ID 모두 허용).
+const MODEL_SUGGESTIONS = ["opus", "sonnet", "haiku"];
+
 // /(슬래시) 자동완성 메뉴용 명령 목록 (언어별). setMyCommands 로 등록.
 const COMMANDS = {
   en: [
@@ -229,6 +246,7 @@ const COMMANDS = {
     { command: "cron", description: "List / add / remove scheduled tasks" },
     { command: "restart", description: "Restart the bot (after syntax check)" },
     { command: "status", description: "Bot status / version" },
+    { command: "model", description: "View / switch the model" },
     { command: "id", description: "Show this chat ID" },
     { command: "help", description: "Help" },
   ],
@@ -237,6 +255,7 @@ const COMMANDS = {
     { command: "cron", description: "예약 작업 보기·추가·삭제" },
     { command: "restart", description: "봇 재시작 (문법 검사 후)" },
     { command: "status", description: "봇 상태·버전 보기" },
+    { command: "model", description: "모델 보기·전환" },
     { command: "id", description: "이 채팅 ID 확인" },
     { command: "help", description: "도움말" },
   ],
@@ -260,7 +279,7 @@ function saveState(s) {
   }
 }
 migrateData(); // 루트 직하 → .claude-bot/ 1회 이주(있으면) 후 state 로드
-let state = loadState(); // { sessionId?, cron?: [{ id, cron, prompt, label? }], restartNotify? }
+let state = loadState(); // { sessionId?, cron?: [{ id, cron, prompt, label? }], restartNotify?, model? }
 
 // ── 텔레그램 헬퍼 ─────────────────────────────────────────────────────────
 async function tg(method, body) {
@@ -360,7 +379,7 @@ async function send(chatId, text) {
 }
 
 // ── Claude 실행 ───────────────────────────────────────────────────────────
-function runClaude(prompt, sessionId) {
+function runClaude(prompt, sessionId, opts = {}) {
   return new Promise((resolve) => {
     const args = [
       "-p",
@@ -370,13 +389,18 @@ function runClaude(prompt, sessionId) {
       "--permission-mode",
       cfg.permissionMode || "acceptEdits",
     ];
+    const model = state.model || cfg.model; // /model 로 바꾸면 state.model 우선
     const brevity =
       cfg.appendSystemPrompt ??
       "This reply is delivered over Telegram. Be concise — short paragraphs and lists, no filler intro/summary, avoid large tables. Reply in the user's language.";
-    // 페르소나(cfg.persona) + 간결 지침을 함께 주입 → 멀티 봇(역할별) 운영용
-    const appendSys = [cfg.persona, brevity].filter(Boolean).join("\n\n");
+    // opts.modelHint: 현재 모델을 주입 → 답변 끝에 상위 모델 권유 제안(판단은 Claude 본인)
+    const modelHint = opts.modelHint
+      ? `Current model: ${model || "claude (default)"}. Model tiers (low→high): haiku → sonnet → opus. If this question seems to require more capability than the current model, append one short line at the very end of your reply: 💡 \`/model sonnet\` (or \`/model opus\`) for a stronger answer. Omit the suggestion for simple questions.`
+      : null;
+    // 페르소나(cfg.persona) + 간결 지침 + 모델 힌트를 함께 주입 → 멀티 봇(역할별) 운영용
+    const appendSys = [cfg.persona, brevity, modelHint].filter(Boolean).join("\n\n");
     if (appendSys) args.push("--append-system-prompt", appendSys);
-    if (cfg.model) args.push("--model", cfg.model);
+    if (model) args.push("--model", model);
     if (sessionId) args.push("--resume", sessionId);
 
     const child = spawn(cfg.claudeBin || "claude", args, {
@@ -684,7 +708,7 @@ async function handle(msg) {
       t(l, "status", {
         version: VERSION,
         name: cfg.name || "claude-telegram-bot",
-        model: cfg.model || (l === "ko" ? "(기본값)" : "(default)"),
+        model: state.model || cfg.model || (l === "ko" ? "(기본값)" : "(default)"),
         hasSession: Boolean(state.sessionId),
         jobs: schedule.length,
         projectDir: cfg.projectDir,
@@ -693,6 +717,24 @@ async function handle(msg) {
     );
     return;
   }
+  if (text === "/model" || text.startsWith("/model ")) {
+    const arg = text.slice(6).trim();
+    if (!arg) {
+      const cur = state.model || cfg.model || (l === "ko" ? "(기본값)" : "(default)");
+      await send(chatId, t(l, "modelStatus", cur, MODEL_SUGGESTIONS));
+      return;
+    }
+    if (arg === "default" || arg === "reset") {
+      state.model = undefined;
+      saveState(state);
+      await send(chatId, t(l, "modelReset", cfg.model || (l === "ko" ? "기본값" : "default")));
+      return;
+    }
+    state.model = arg;
+    saveState(state);
+    await send(chatId, t(l, "modelSet", arg));
+    return;
+  }
   if (text === "/cron" || text.startsWith("/cron ")) {
     await handleCron(chatId, text.slice(5).trim(), l);
     return;
@@ -750,7 +792,7 @@ async function handle(msg) {
         await send(chatId, t(l, "attachFail", e.message));
       }
     }
-    const res = await runClaude(prompt, state.sessionId);
+    const res = await runClaude(prompt, state.sessionId, { modelHint: true });
     if (res.sessionId) {
       state.sessionId = res.sessionId;
       saveState(state);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-telegram-bot",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Drive Claude Code from Telegram — messages run headless `claude -p` in a project dir and replies come back to the chat. Zero dependencies.",
   "type": "module",
   "bin": {