@inetafrica/open-claudia 1.14.8 → 1.15.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## v1.14.9
+- Fix `/upgrade`: `latest` was const-scoped to the version-check try
+  block, so the install step ran with `latest` undefined and threw
+  `ReferenceError: latest is not defined`. Hoist the variable and fall
+  back to npm's `latest` dist-tag if `npm view` fails. Regression
+  introduced in 745c6cf — broke v1.14.7 and v1.14.8 upgrades.
+
 ## v1.14.8
 - Fix: `/stop` and the 6h hard-timeout now walk the full descendant
   process tree, not just the Claude CLI's process group. Background

package/bot.js

@@ -274,6 +274,7 @@ bot.setMyCommands([
   { command: "ask", description: "Toggle ask mode (Cursor only)" },
   { command: "sessions", description: "List conversations for this project" },
   { command: "compact", description: "Summarize conversation context" },
+  { command: "usage", description: "Show token usage & cost for this session" },
   { command: "continue", description: "Resume last conversation" },
   { command: "worktree", description: "Toggle isolated git branch" },
   { command: "cron", description: "Manage scheduled tasks" },
@@ -325,6 +326,7 @@ function saveState() {
     lastSessionId,
     cursorSessionId,
     settings,
+    sessionUsage,
   };
   try { fs.writeFileSync(STATE_FILE, JSON.stringify(data)); } catch (e) {}
 }
@@ -402,6 +404,20 @@ let pendingClaudeAuthLabel = null;
 let isFirstMessage = !lastSessionId; // Track if this is first message in session
 let lastInputWasVoice = false; // Reply with voice when input was voice
 
+// Per-session usage tracking (resets on /end or new session)
+let sessionUsage = savedState.sessionUsage || {
+  turns: 0,
+  inputTokens: 0,
+  outputTokens: 0,
+  cacheReadTokens: 0,
+  cacheCreationTokens: 0,
+  costUsd: 0,
+  lastInputTokens: 0, // Last turn's input tokens (for compact suggestion)
+};
+function resetSessionUsage() {
+  sessionUsage = { turns: 0, inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheCreationTokens: 0, costUsd: 0, lastInputTokens: 0 };
+}
+
 let settings = savedState.settings || {
   model: null, effort: null, budget: null, permissionMode: null, worktree: false, backend: "claude",
 };
@@ -1324,6 +1340,17 @@ async function runClaude(prompt, cwd, replyToMsgId, opts = {}) {
       if (evt.type === "result" && evt.session_id) {
         if (settings.backend === "cursor") { cursorSessionId = evt.session_id; }
         else { lastSessionId = evt.session_id; }
+        if (evt.usage) {
+          sessionUsage.turns += 1;
+          sessionUsage.inputTokens += evt.usage.input_tokens || 0;
+          sessionUsage.outputTokens += evt.usage.output_tokens || 0;
+          sessionUsage.cacheReadTokens += evt.usage.cache_read_input_tokens || 0;
+          sessionUsage.cacheCreationTokens += evt.usage.cache_creation_input_tokens || 0;
+          sessionUsage.lastInputTokens = (evt.usage.input_tokens || 0) +
+            (evt.usage.cache_read_input_tokens || 0) +
+            (evt.usage.cache_creation_input_tokens || 0);
+        }
+        if (typeof evt.total_cost_usd === "number") sessionUsage.costUsd += evt.total_cost_usd;
         saveState();
       }
       if (evt.type === "result" && evt.result) assistantText = evt.result;
@@ -1384,6 +1411,15 @@ async function runClaude(prompt, cwd, replyToMsgId, opts = {}) {
         const voicePath = textToVoice(finalText);
         if (voicePath) await sendVoice(voicePath);
       }
+
+      // Suggest /compact when context gets large (once per threshold crossing)
+      const ctx = sessionUsage.lastInputTokens;
+      if (ctx > 150000 && !sessionUsage.warnedHighContext) {
+        sessionUsage.warnedHighContext = true;
+        await send(`Heads up: context is ${(ctx / 1000).toFixed(0)}k tokens. Use /compact to summarize or /end for a fresh start — keeps cost down.`);
+      } else if (ctx < 80000 && sessionUsage.warnedHighContext) {
+        sessionUsage.warnedHighContext = false;
+      }
     } catch (e) {
       console.error("Final message delivery failed:", e.message);
       await send("Task completed but failed to deliver the response. Send /continue to see the result.");
@@ -1548,9 +1584,12 @@ bot.onText(/\/upgrade$/, async (msg) => {
   // Change to HOME first — npm install -g replaces the package directory
   // which can delete the cwd out from under the running process
   try { process.chdir(process.env.HOME || require("os").homedir()); } catch (e) { /* already gone */ }
-  // Check if there's actually a newer version
+  // Check if there's actually a newer version. `latest` is hoisted so
+  // the install step below can reference it; if `npm view` fails we
+  // fall back to npm's `latest` dist-tag.
+  let latest = null;
   try {
-    const latest = execSync("npm view @inetafrica/open-claudia version", {
+    latest = execSync("npm view @inetafrica/open-claudia version", {
       encoding: "utf-8", timeout: 15000,
       env: { ...process.env, PATH: FULL_PATH, HOME: process.env.HOME || require("os").homedir() },
     }).trim();
@@ -1562,8 +1601,9 @@ bot.onText(/\/upgrade$/, async (msg) => {
   } catch (e) {
     await send("Upgrading...");
   }
+  const installTarget = latest || "latest";
   try {
-    execSync(`npm install -g @inetafrica/open-claudia@${latest} 2>&1`, {
+    execSync(`npm install -g @inetafrica/open-claudia@${installTarget} 2>&1`, {
       encoding: "utf-8", timeout: 120000,
       cwd: process.env.HOME || require("os").homedir(),
       env: { ...process.env, PATH: FULL_PATH, HOME: process.env.HOME || require("os").homedir() },
@@ -1756,12 +1796,28 @@ bot.onText(/\/status/, (msg) => {
 bot.onText(/\/end/, (msg) => {
   if (!isAuthorized(msg)) return;
   if (currentSession) {
-    const n = currentSession.name; currentSession = null; lastSessionId = null; messageQueue = []; resetSettings();
+    const n = currentSession.name; currentSession = null; lastSessionId = null; messageQueue = []; resetSettings(); resetSessionUsage();
     saveState();
     send(`Ended: ${n}`, { keyboard: { inline_keyboard: [[{ text: "New session", callback_data: "show:projects" }]] } });
   } else send("No session.");
 });
 
+bot.onText(/\/usage$/, (msg) => {
+  if (!isAuthorized(msg)) return;
+  const u = sessionUsage;
+  if (u.turns === 0) return send("No usage yet in this session.");
+  const fmt = (n) => n >= 1000 ? (n / 1000).toFixed(1) + "k" : String(n);
+  const lines = [
+    `*Session usage* (${u.turns} turn${u.turns === 1 ? "" : "s"})`,
+    `Input: ${fmt(u.inputTokens)} · Output: ${fmt(u.outputTokens)}`,
+    `Cache read: ${fmt(u.cacheReadTokens)} · Cache write: ${fmt(u.cacheCreationTokens)}`,
+    `Cost: $${u.costUsd.toFixed(4)}`,
+    `Last turn context: ${fmt(u.lastInputTokens)}`,
+  ];
+  if (u.lastInputTokens > 100000) lines.push("\nTip: context is large. Use /compact to summarize, or /end for a clean slate.");
+  send(lines.join("\n"), { parseMode: "Markdown" });
+});
+
 bot.onText(/\/soul$/, async (msg) => {
   if (!isAuthorized(msg)) return;
   const soul = loadSoul();
@@ -1961,13 +2017,13 @@ bot.on("callback_query", async (q) => {
     const sessions = loadSessions();
     // Don't delete history, just start fresh
     currentSession = { name: proj === "__workspace__" ? "Workspace" : proj, dir: proj === "__workspace__" ? WORKSPACE : path.join(WORKSPACE, proj) };
-    lastSessionId = null; isFirstMessage = true; messageQueue = []; resetSettings();
+    lastSessionId = null; isFirstMessage = true; messageQueue = []; resetSettings(); resetSessionUsage();
     saveState();
     await send(`Session: ${currentSession.name}\nNew conversation\n\nSend text, voice, or images.\n\n/sessions — switch conversation\n/session — switch project`);
     return;
   }
   if (d === "a:continue") { if (currentSession) await runClaude("continue", currentSession.dir); else send("No session."); return; }
-  if (d === "a:end") { if (currentSession) { const n = currentSession.name; currentSession = null; lastSessionId = null; messageQueue = []; resetSettings(); saveState(); await send(`Ended: ${n}`, { keyboard: { inline_keyboard: [[{ text: "New", callback_data: "show:projects" }]] } }); } return; }
+  if (d === "a:end") { if (currentSession) { const n = currentSession.name; currentSession = null; lastSessionId = null; messageQueue = []; resetSettings(); resetSessionUsage(); saveState(); await send(`Ended: ${n}`, { keyboard: { inline_keyboard: [[{ text: "New", callback_data: "show:projects" }]] } }); } return; }
   if (d.startsWith("m:")) { settings.model = d.slice(2) === "default" ? null : d.slice(2); await send(`Model: ${settings.model || "default"}`); return; }
   if (d.startsWith("e:")) { const e = d.slice(2); settings.effort = e === "default" ? null : e; await send(`Effort: ${settings.effort || "default"}`); return; }
   if (d.startsWith("b:")) { const b = d.slice(2); settings.budget = b === "none" ? null : parseFloat(b); await send(`Budget: ${settings.budget ? "$"+settings.budget : "none"}`); return; }

package/package.json

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