@inetafrica/open-claudia 1.10.1 → 1.12.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## v1.12.0
+- Cursor Agent tool progress: Shell, Read, Edit, Write, Grep, Glob calls now show in real-time Telegram updates
+- Plan output surfaced to Telegram: when Cursor creates a plan (`--mode plan`), the full plan markdown and task list are sent to the user
+- Handles all Cursor tool_call event types with fallback for unknown tools
+
+## v1.11.0
+- Backend-aware plan mode: /plan passes `--mode plan` to Cursor Agent, `--permission-mode plan` to Claude
+- New /ask command: read-only Q&A mode (Cursor Agent only, `--mode ask`)
+- /effort and /budget now warn when on Cursor backend (unsupported flags)
+- Worktree flag (`--worktree`) wired into Cursor Agent args
+- buildCursorArgs now forwards plan/ask/worktree settings
+
 ## v1.10.0
 - Cursor Agent backend: switch between Claude Code and Cursor Agent CLI
 - New commands: /cursor, /claude, /backend with inline keyboard

package/README.md

@@ -126,7 +126,8 @@ When you select a project, the last conversation is automatically resumed. Tap "
 | `/model` | Switch model (opus / sonnet / haiku for Claude; any model flag for Cursor) |
 | `/effort` | Set effort level (low / medium / high / max) |
 | `/budget` | Set max spend for next task (e.g. `/budget 0.50`) — Claude only |
-| `/plan` | Toggle plan mode — Claude only |
+| `/plan` | Toggle plan mode — `--permission-mode plan` (Claude) / `--mode plan` (Cursor) |
+| `/ask` | Toggle ask mode — read-only Q&A, no edits (Cursor Agent only) |
 | `/compact` | Summarize conversation context |
 | `/worktree` | Toggle isolated git branch — Claude only |
 | `/mode` | Switch between direct and agent bot modes |
@@ -158,9 +159,10 @@ When you select a project, the last conversation is automatically resumed. Tap "
 | Session flag | `--resume <id>` | `--resume <id>` |
 | Auth | `claude auth` | `agent login` |
 | Plan mode | Yes (`--permission-mode plan`) | Yes (`--mode plan`) |
+| Ask mode | No | Yes (`--mode ask`) |
 | Budget control | Yes (`--max-budget-usd`) | No |
 | Effort levels | Yes | No |
-| Worktree | Yes | No |
+| Worktree | Yes (`--worktree`) | Yes (`--worktree`) |
 | Model switching | Yes | Yes |
 | Dangerously skip permissions | Yes | Yes (`--trust`) |
 

package/bot-agent.js

@@ -178,6 +178,7 @@ bot.setMyCommands([
   { command: "effort", description: "Set effort level" },
   { command: "budget", description: "Set max spend for next task" },
   { command: "plan", description: "Toggle plan mode" },
+  { command: "ask", description: "Toggle ask mode (Cursor only)" },
   { command: "sessions", description: "List conversations for this project" },
   { command: "compact", description: "Summarize conversation context" },
   { command: "continue", description: "Resume last conversation" },
@@ -696,6 +697,9 @@ function buildCursorArgs(prompt, opts = {}) {
   if (opts.continueSession) args.push("--continue");
   else if (cursorSessionId && !opts.fresh) args.push("--resume", cursorSessionId);
   if (settings.model) args.push("--model", settings.model);
+  if (settings.permissionMode === "plan") args.push("--mode", "plan");
+  else if (settings.permissionMode === "ask") args.push("--mode", "ask");
+  if (settings.worktree) args.push("--worktree");
   args.push(prompt);
   return args;
 }
@@ -841,7 +845,6 @@ async function runClaude(prompt, cwd, replyToMsgId, opts = {}) {
           else if (block.type === "tool_use") {
             currentTool = block.name;
             toolUses.push(block.name);
-            // Extract useful detail from tool input
             const input = block.input || {};
             if (block.name === "Bash" && input.command) currentToolDetail = input.command.slice(0, 80);
             else if (block.name === "Read" && input.file_path) currentToolDetail = input.file_path.split("/").slice(-2).join("/");
@@ -853,6 +856,48 @@ async function runClaude(prompt, cwd, replyToMsgId, opts = {}) {
           }
         }
       }
+      // Cursor Agent tool_call events (different format from Claude's tool_use blocks)
+      if (evt.type === "tool_call" && evt.subtype === "started" && evt.tool_call) {
+        const tc = evt.tool_call;
+        if (tc.shellToolCall) {
+          const a = tc.shellToolCall.args || {};
+          currentTool = "Shell"; toolUses.push("Shell");
+          currentToolDetail = (a.description || a.command || "").slice(0, 80);
+        } else if (tc.readToolCall) {
+          currentTool = "Read"; toolUses.push("Read");
+          currentToolDetail = (tc.readToolCall.args?.path || "").split("/").slice(-2).join("/");
+        } else if (tc.editToolCall) {
+          currentTool = "Edit"; toolUses.push("Edit");
+          currentToolDetail = (tc.editToolCall.args?.filePath || "").split("/").slice(-2).join("/");
+        } else if (tc.writeToolCall) {
+          currentTool = "Write"; toolUses.push("Write");
+          currentToolDetail = (tc.writeToolCall.args?.filePath || "").split("/").slice(-2).join("/");
+        } else if (tc.grepToolCall) {
+          currentTool = "Grep"; toolUses.push("Grep");
+          currentToolDetail = (tc.grepToolCall.args?.pattern || "").slice(0, 40);
+        } else if (tc.globToolCall) {
+          currentTool = "Glob"; toolUses.push("Glob");
+          currentToolDetail = (tc.globToolCall.args?.globPattern || "").slice(0, 40);
+        } else if (tc.createPlanToolCall) {
+          currentTool = "Plan"; toolUses.push("Plan");
+          const plan = tc.createPlanToolCall.args || {};
+          let planText = "";
+          if (plan.name) planText += `**${plan.name}**\n\n`;
+          if (plan.plan) planText += plan.plan + "\n";
+          if (plan.todos && plan.todos.length) {
+            planText += "\n**Tasks:**\n";
+            for (const todo of plan.todos) {
+              planText += `• ${todo.content || todo.id}\n`;
+            }
+          }
+          if (planText) assistantText = planText;
+          currentToolDetail = plan.name || "creating plan";
+        } else {
+          const toolKey = Object.keys(tc)[0] || "unknown";
+          currentTool = toolKey.replace("ToolCall", ""); toolUses.push(currentTool);
+          currentToolDetail = "";
+        }
+      }
       if (evt.type === "result" && evt.session_id) {
         if (settings.backend === "cursor") { cursorSessionId = evt.session_id; }
         else { lastSessionId = evt.session_id; }
@@ -1126,23 +1171,46 @@ bot.onText(/\/model (.+)/, (msg, match) => { if (!isAuthorized(msg)) return; set
 
 bot.onText(/\/effort$/, (msg) => {
   if (!isAuthorized(msg)) return;
+  if (settings.backend === "cursor") return send("Effort levels are not supported on Cursor Agent.\nSwitch to Claude with /claude to use this.");
   send(`Effort: ${settings.effort || "default"}`, { keyboard: { inline_keyboard: [
     [{ text: "Low", callback_data: "e:low" }, { text: "Med", callback_data: "e:medium" }, { text: "High", callback_data: "e:high" }, { text: "Max", callback_data: "e:max" }],
     [{ text: "Default", callback_data: "e:default" }],
   ] } });
 });
-bot.onText(/\/effort (.+)/, (msg, match) => { if (!isAuthorized(msg)) return; const e = match[1].trim().toLowerCase(); settings.effort = ["low","medium","high","max"].includes(e) ? e : null; send(`Effort: ${settings.effort || "default"}`); });
+bot.onText(/\/effort (.+)/, (msg, match) => {
+  if (!isAuthorized(msg)) return;
+  if (settings.backend === "cursor") return send("Effort levels are not supported on Cursor Agent.");
+  const e = match[1].trim().toLowerCase(); settings.effort = ["low","medium","high","max"].includes(e) ? e : null; send(`Effort: ${settings.effort || "default"}`);
+});
 
 bot.onText(/\/budget$/, (msg) => {
   if (!isAuthorized(msg)) return;
+  if (settings.backend === "cursor") return send("Budget limits are not supported on Cursor Agent.\nSwitch to Claude with /claude to use this.");
   send(`Budget: ${settings.budget ? "$" + settings.budget : "none"}`, { keyboard: { inline_keyboard: [
     [{ text: "$1", callback_data: "b:1" }, { text: "$5", callback_data: "b:5" }, { text: "$10", callback_data: "b:10" }, { text: "$25", callback_data: "b:25" }],
     [{ text: "No limit", callback_data: "b:none" }],
   ] } });
 });
-bot.onText(/\/budget (.+)/, (msg, match) => { if (!isAuthorized(msg)) return; const v = parseFloat(match[1].replace("$","")); settings.budget = v > 0 ? v : null; send(`Budget: ${settings.budget ? "$"+settings.budget : "none"}`); });
+bot.onText(/\/budget (.+)/, (msg, match) => {
+  if (!isAuthorized(msg)) return;
+  if (settings.backend === "cursor") return send("Budget limits are not supported on Cursor Agent.");
+  const v = parseFloat(match[1].replace("$","")); settings.budget = v > 0 ? v : null; send(`Budget: ${settings.budget ? "$"+settings.budget : "none"}`);
+});
 
-bot.onText(/\/plan$/, (msg) => { if (!isAuthorized(msg)) return; const p = settings.permissionMode === "plan"; settings.permissionMode = p ? null : "plan"; send(p ? "Plan mode off." : "Plan mode on."); });
+bot.onText(/\/plan$/, (msg) => {
+  if (!isAuthorized(msg)) return;
+  const p = settings.permissionMode === "plan";
+  settings.permissionMode = p ? null : "plan";
+  const label = settings.backend === "cursor" ? "read-only planning, no edits" : "plan permission mode";
+  send(p ? "Plan mode off." : `Plan mode on (${label}).`);
+});
+bot.onText(/\/ask$/, (msg) => {
+  if (!isAuthorized(msg)) return;
+  if (settings.backend !== "cursor") return send("Ask mode is only available on Cursor Agent.\nUse /cursor to switch.");
+  const a = settings.permissionMode === "ask";
+  settings.permissionMode = a ? null : "ask";
+  send(a ? "Ask mode off." : "Ask mode on (read-only Q&A, no edits).");
+});
 bot.onText(/\/compact/, async (msg) => { if (!isAuthorized(msg)) return; if (!requireSession(msg)) return; if (!getActiveSessionId()) return send("No conversation."); await runClaude("Summarize: key decisions, code state, next steps.", currentSession.dir, msg.message_id); });
 bot.onText(/\/continue$/, async (msg) => { if (!isAuthorized(msg)) return; if (!requireSession(msg)) return; await runClaude("continue where we left off", currentSession.dir, msg.message_id, { continueSession: true }); });
 bot.onText(/\/worktree$/, (msg) => { if (!isAuthorized(msg)) return; settings.worktree = !settings.worktree; send(settings.worktree ? "Worktree on." : "Worktree off."); });

package/bot.js

@@ -236,6 +236,7 @@ bot.setMyCommands([
   { command: "effort", description: "Set effort level" },
   { command: "budget", description: "Set max spend for next task" },
   { command: "plan", description: "Toggle plan mode" },
+  { command: "ask", description: "Toggle ask mode (Cursor only)" },
   { command: "sessions", description: "List conversations for this project" },
   { command: "compact", description: "Summarize conversation context" },
   { command: "continue", description: "Resume last conversation" },
@@ -757,6 +758,9 @@ function buildCursorArgs(prompt, opts = {}) {
   if (opts.continueSession) args.push("--continue");
   else if (cursorSessionId && !opts.fresh) args.push("--resume", cursorSessionId);
   if (settings.model) args.push("--model", settings.model);
+  if (settings.permissionMode === "plan") args.push("--mode", "plan");
+  else if (settings.permissionMode === "ask") args.push("--mode", "ask");
+  if (settings.worktree) args.push("--worktree");
   args.push(prompt);
   return args;
 }
@@ -857,7 +861,6 @@ async function runClaude(prompt, cwd, replyToMsgId, opts = {}) {
           else if (block.type === "tool_use") {
             currentTool = block.name;
             toolUses.push(block.name);
-            // Extract useful detail from tool input
             const input = block.input || {};
             if (block.name === "Bash" && input.command) currentToolDetail = input.command.slice(0, 80);
             else if (block.name === "Read" && input.file_path) currentToolDetail = input.file_path.split("/").slice(-2).join("/");
@@ -869,6 +872,48 @@ async function runClaude(prompt, cwd, replyToMsgId, opts = {}) {
           }
         }
       }
+      // Cursor Agent tool_call events (different format from Claude's tool_use blocks)
+      if (evt.type === "tool_call" && evt.subtype === "started" && evt.tool_call) {
+        const tc = evt.tool_call;
+        if (tc.shellToolCall) {
+          const a = tc.shellToolCall.args || {};
+          currentTool = "Shell"; toolUses.push("Shell");
+          currentToolDetail = (a.description || a.command || "").slice(0, 80);
+        } else if (tc.readToolCall) {
+          currentTool = "Read"; toolUses.push("Read");
+          currentToolDetail = (tc.readToolCall.args?.path || "").split("/").slice(-2).join("/");
+        } else if (tc.editToolCall) {
+          currentTool = "Edit"; toolUses.push("Edit");
+          currentToolDetail = (tc.editToolCall.args?.filePath || "").split("/").slice(-2).join("/");
+        } else if (tc.writeToolCall) {
+          currentTool = "Write"; toolUses.push("Write");
+          currentToolDetail = (tc.writeToolCall.args?.filePath || "").split("/").slice(-2).join("/");
+        } else if (tc.grepToolCall) {
+          currentTool = "Grep"; toolUses.push("Grep");
+          currentToolDetail = (tc.grepToolCall.args?.pattern || "").slice(0, 40);
+        } else if (tc.globToolCall) {
+          currentTool = "Glob"; toolUses.push("Glob");
+          currentToolDetail = (tc.globToolCall.args?.globPattern || "").slice(0, 40);
+        } else if (tc.createPlanToolCall) {
+          currentTool = "Plan"; toolUses.push("Plan");
+          const plan = tc.createPlanToolCall.args || {};
+          let planText = "";
+          if (plan.name) planText += `**${plan.name}**\n\n`;
+          if (plan.plan) planText += plan.plan + "\n";
+          if (plan.todos && plan.todos.length) {
+            planText += "\n**Tasks:**\n";
+            for (const todo of plan.todos) {
+              planText += `• ${todo.content || todo.id}\n`;
+            }
+          }
+          if (planText) assistantText = planText;
+          currentToolDetail = plan.name || "creating plan";
+        } else {
+          const toolKey = Object.keys(tc)[0] || "unknown";
+          currentTool = toolKey.replace("ToolCall", ""); toolUses.push(currentTool);
+          currentToolDetail = "";
+        }
+      }
       if (evt.type === "result" && evt.session_id) {
         if (settings.backend === "cursor") { cursorSessionId = evt.session_id; }
         else { lastSessionId = evt.session_id; }
@@ -1169,23 +1214,47 @@ bot.onText(/\/model (.+)/, (msg, match) => { if (!isAuthorized(msg)) return; set
 
 bot.onText(/\/effort$/, (msg) => {
   if (!isAuthorized(msg)) return;
+  if (settings.backend === "cursor") return send("Effort levels are not supported on Cursor Agent.\nSwitch to Claude with /claude to use this.");
   send(`Effort: ${settings.effort || "default"}`, { keyboard: { inline_keyboard: [
     [{ text: "Low", callback_data: "e:low" }, { text: "Med", callback_data: "e:medium" }, { text: "High", callback_data: "e:high" }, { text: "Max", callback_data: "e:max" }],
     [{ text: "Default", callback_data: "e:default" }],
   ] } });
 });
-bot.onText(/\/effort (.+)/, (msg, match) => { if (!isAuthorized(msg)) return; const e = match[1].trim().toLowerCase(); settings.effort = ["low","medium","high","max"].includes(e) ? e : null; send(`Effort: ${settings.effort || "default"}`); });
+bot.onText(/\/effort (.+)/, (msg, match) => {
+  if (!isAuthorized(msg)) return;
+  if (settings.backend === "cursor") return send("Effort levels are not supported on Cursor Agent.");
+  const e = match[1].trim().toLowerCase(); settings.effort = ["low","medium","high","max"].includes(e) ? e : null; send(`Effort: ${settings.effort || "default"}`);
+});
 
 bot.onText(/\/budget$/, (msg) => {
   if (!isAuthorized(msg)) return;
+  if (settings.backend === "cursor") return send("Budget limits are not supported on Cursor Agent.\nSwitch to Claude with /claude to use this.");
   send(`Budget: ${settings.budget ? "$" + settings.budget : "none"}`, { keyboard: { inline_keyboard: [
     [{ text: "$1", callback_data: "b:1" }, { text: "$5", callback_data: "b:5" }, { text: "$10", callback_data: "b:10" }, { text: "$25", callback_data: "b:25" }],
     [{ text: "No limit", callback_data: "b:none" }],
   ] } });
 });
-bot.onText(/\/budget (.+)/, (msg, match) => { if (!isAuthorized(msg)) return; const v = parseFloat(match[1].replace("$","")); settings.budget = v > 0 ? v : null; send(`Budget: ${settings.budget ? "$"+settings.budget : "none"}`); });
+bot.onText(/\/budget (.+)/, (msg, match) => {
+  if (!isAuthorized(msg)) return;
+  if (settings.backend === "cursor") return send("Budget limits are not supported on Cursor Agent.");
+  const v = parseFloat(match[1].replace("$","")); settings.budget = v > 0 ? v : null; send(`Budget: ${settings.budget ? "$"+settings.budget : "none"}`);
+});
 
-bot.onText(/\/plan$/, (msg) => { if (!isAuthorized(msg)) return; const p = settings.permissionMode === "plan"; settings.permissionMode = p ? null : "plan"; send(p ? "Plan mode off." : "Plan mode on."); });
+bot.onText(/\/plan$/, (msg) => {
+  if (!isAuthorized(msg)) return;
+  const p = settings.permissionMode === "plan";
+  settings.permissionMode = p ? null : "plan";
+  const label = settings.backend === "cursor" ? "read-only planning, no edits" : "plan permission mode";
+  if (p) cursorSessionId = null; // reset session so next message doesn't resume plan-mode session
+  send(p ? "Plan mode off (session reset)." : `Plan mode on (${label}).`);
+});
+bot.onText(/\/ask$/, (msg) => {
+  if (!isAuthorized(msg)) return;
+  if (settings.backend !== "cursor") return send("Ask mode is only available on Cursor Agent.\nUse /cursor to switch.");
+  const a = settings.permissionMode === "ask";
+  settings.permissionMode = a ? null : "ask";
+  send(a ? "Ask mode off." : "Ask mode on (read-only Q&A, no edits).");
+});
 bot.onText(/\/compact/, async (msg) => { if (!isAuthorized(msg)) return; if (!requireSession(msg)) return; if (!getActiveSessionId()) return send("No conversation."); await runClaude("Summarize: key decisions, code state, next steps.", currentSession.dir, msg.message_id); });
 bot.onText(/\/continue$/, async (msg) => { if (!isAuthorized(msg)) return; if (!requireSession(msg)) return; await runClaude("continue where we left off", currentSession.dir, msg.message_id, { continueSession: true }); });
 bot.onText(/\/worktree$/, (msg) => { if (!isAuthorized(msg)) return; settings.worktree = !settings.worktree; send(settings.worktree ? "Worktree on." : "Worktree off."); });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inetafrica/open-claudia",
-  "version": "1.10.1",
+  "version": "1.12.1",
   "description": "Your always-on AI coding assistant — Claude Code via Telegram",
   "main": "bot.js",
   "bin": {