@inetafrica/open-claudia 1.14.0 → 1.14.1

package/bot-agent.js

@@ -830,6 +830,66 @@ function preflightClaudeAuthMessage() {
 }
 
 
+function isClaudeUsageLimitText(text) {
+  const lower = String(text || "").toLowerCase();
+  return lower.includes("usage limit") ||
+    lower.includes("you've hit your usage limit") ||
+    lower.includes("you have hit your usage limit") ||
+    lower.includes("spend limit") ||
+    lower.includes("monthly cycle") ||
+    lower.includes("rate limit") && lower.includes("model");
+}
+
+function claudeUsageLimitMessage(details = "") {
+  return [
+    "Claude ran, but the selected model is unavailable/limited right now.",
+    details ? `\nDetails:\n${redactSensitive(details)}` : "",
+    "",
+    "Try from Telegram:",
+    "1. /model sonnet",
+    "2. Then send your message again",
+    "",
+    "If you specifically need Opus, wait for the usage window to reset or increase the spend/usage limit."
+  ].filter(Boolean).join("\n");
+}
+
+function runClaudeAuthStatusDiagnostic() {
+  try {
+    const output = execSync(`"${CLAUDE_PATH}" auth status`, {
+      cwd: process.env.HOME || require("os").homedir(),
+      env: claudeSubprocessEnv(),
+      encoding: "utf8",
+      timeout: 10000,
+      stdio: ["ignore", "pipe", "pipe"],
+    });
+    return output.trim();
+  } catch (e) {
+    return `${e.stdout || ""}\n${e.stderr || ""}\n${e.message || ""}`.trim();
+  }
+}
+
+function claudeEmptyFailureMessage(code, stderrText = "") {
+  const stderr = redactSensitive(String(stderrText || "").trim());
+  if (isClaudeUsageLimitText(stderr)) return claudeUsageLimitMessage(stderr.slice(-1200));
+  if (isClaudeAuthErrorText(stderr)) return claudeAuthRecoveryMessage(stderr.slice(-1200));
+
+  const authStatus = runClaudeAuthStatusDiagnostic();
+  if (isClaudeAuthErrorText(authStatus)) return claudeAuthRecoveryMessage(authStatus.slice(-1200));
+  if (isClaudeUsageLimitText(authStatus)) return claudeUsageLimitMessage(authStatus.slice(-1200));
+
+  return [
+    `Claude exited with code ${code} but produced no assistant output.`,
+    stderr ? `\nStderr:\n${stderr.slice(-1200)}` : "\nStderr: (empty)",
+    authStatus ? `\nAuth status:\n${redactSensitive(authStatus).slice(-1200)}` : "",
+    "",
+    "Useful next steps:",
+    "• /auth_status — verify Claude auth",
+    "• /model sonnet — switch away from Opus if usage-limited",
+    "• /setup_token — create a launchd-safe OAuth token if Keychain is the issue"
+  ].filter(Boolean).join("\n");
+}
+
+
 function summarizeClaudeAuthStatus(output, exitCode, tokenInfo) {
   const text = String(output || "");
   const lower = text.toLowerCase();
@@ -1172,6 +1232,11 @@ async function runClaude(prompt, cwd, replyToMsgId, opts = {}) {
       return;
     }
     try {
+      if (code !== 0 && code !== null && !assistantText.trim()) {
+        await send(claudeEmptyFailureMessage(code, stderrBuffer), { replyTo: replyToMsgId });
+        return;
+      }
+
       const finalText = redactSensitive(assistantText || "(no output)");
       const chunks = splitMessage(finalText);
       const firstChunk = chunks[0];

package/bot.js

@@ -892,6 +892,66 @@ function preflightClaudeAuthMessage() {
 }
 
 
+function isClaudeUsageLimitText(text) {
+  const lower = String(text || "").toLowerCase();
+  return lower.includes("usage limit") ||
+    lower.includes("you've hit your usage limit") ||
+    lower.includes("you have hit your usage limit") ||
+    lower.includes("spend limit") ||
+    lower.includes("monthly cycle") ||
+    lower.includes("rate limit") && lower.includes("model");
+}
+
+function claudeUsageLimitMessage(details = "") {
+  return [
+    "Claude ran, but the selected model is unavailable/limited right now.",
+    details ? `\nDetails:\n${redactSensitive(details)}` : "",
+    "",
+    "Try from Telegram:",
+    "1. /model sonnet",
+    "2. Then send your message again",
+    "",
+    "If you specifically need Opus, wait for the usage window to reset or increase the spend/usage limit."
+  ].filter(Boolean).join("\n");
+}
+
+function runClaudeAuthStatusDiagnostic() {
+  try {
+    const output = execSync(`"${CLAUDE_PATH}" auth status`, {
+      cwd: process.env.HOME || require("os").homedir(),
+      env: claudeSubprocessEnv(),
+      encoding: "utf8",
+      timeout: 10000,
+      stdio: ["ignore", "pipe", "pipe"],
+    });
+    return output.trim();
+  } catch (e) {
+    return `${e.stdout || ""}\n${e.stderr || ""}\n${e.message || ""}`.trim();
+  }
+}
+
+function claudeEmptyFailureMessage(code, stderrText = "") {
+  const stderr = redactSensitive(String(stderrText || "").trim());
+  if (isClaudeUsageLimitText(stderr)) return claudeUsageLimitMessage(stderr.slice(-1200));
+  if (isClaudeAuthErrorText(stderr)) return claudeAuthRecoveryMessage(stderr.slice(-1200));
+
+  const authStatus = runClaudeAuthStatusDiagnostic();
+  if (isClaudeAuthErrorText(authStatus)) return claudeAuthRecoveryMessage(authStatus.slice(-1200));
+  if (isClaudeUsageLimitText(authStatus)) return claudeUsageLimitMessage(authStatus.slice(-1200));
+
+  return [
+    `Claude exited with code ${code} but produced no assistant output.`,
+    stderr ? `\nStderr:\n${stderr.slice(-1200)}` : "\nStderr: (empty)",
+    authStatus ? `\nAuth status:\n${redactSensitive(authStatus).slice(-1200)}` : "",
+    "",
+    "Useful next steps:",
+    "• /auth_status — verify Claude auth",
+    "• /model sonnet — switch away from Opus if usage-limited",
+    "• /setup_token — create a launchd-safe OAuth token if Keychain is the issue"
+  ].filter(Boolean).join("\n");
+}
+
+
 function summarizeClaudeAuthStatus(output, exitCode, tokenInfo) {
   const text = String(output || "");
   const lower = text.toLowerCase();
@@ -1193,6 +1253,11 @@ async function runClaude(prompt, cwd, replyToMsgId, opts = {}) {
     }
 
     try {
+      if (code !== 0 && code !== null && !assistantText.trim()) {
+        await send(claudeEmptyFailureMessage(code, stderrBuffer), { replyTo: replyToMsgId });
+        return;
+      }
+
       const finalText = redactSensitive(assistantText || "(no output)");
       const chunks = splitMessage(finalText);
       const firstChunk = chunks[0];

package/package.json

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