clementine-agent 1.18.24 → 1.18.25

package/dist/agent/assistant.js

@@ -5863,6 +5863,21 @@ You have a cost budget per message — not a hard turn limit. Work until the tas
                 }
                 logger.error({ err, jobName, phase }, `Unleashed task phase ${phase} error`);
                 appendProgress({ event: 'phase_error', phase, error: String(err), terminalReason });
+                if (isCreditBalanceError(err)) {
+                    markBackgroundCreditBlocked(err);
+                    appendProgress({ event: 'aborted', phase, reason: 'account_usage_limit' });
+                    writeStatus({
+                        jobName,
+                        status: 'error',
+                        phase,
+                        startedAt,
+                        finishedAt: new Date().toISOString(),
+                    });
+                    const message = (`Task "${jobName}" stopped because Claude account usage or billing is blocked: ${String(err).slice(0, 500)}. ` +
+                        'Background jobs have been paused so Clementine does not keep retrying against the same account limit.');
+                    logger.error({ jobName, phase }, 'Unleashed task aborted on Claude account usage limit');
+                    throw new UnleashedTaskFailedError(message, this._lastTerminalReason);
+                }
                 if (terminalReason === 'rapid_refill_breaker' || terminalReason === 'prompt_too_long') {
                     appendProgress({ event: 'aborted', phase, reason: terminalReason });
                     writeStatus({

package/dist/cli/dashboard.js

@@ -17625,18 +17625,27 @@ async function apiFetch(url, opts) {
     }
     // 401 means the dashboard was restarted and regenerated its token.
     // The page still in your browser has a stale one baked into <meta>,
-    // so every API call silently fails. Reload once to pick up the new
-    // HTML (and new token). Guard against reload loops with sessionStorage.
+    // so every API call silently fails. Reload to pick up the new HTML
+    // (and new token), but throttle by token so a tab cannot get stuck
+    // forever after one earlier restart.
     if (resp.status === 401) {
-      var key = '_dashReloadedOnce';
-      if (!sessionStorage.getItem(key)) {
-        sessionStorage.setItem(key, String(Date.now()));
+      var key = '_dashReloadedForToken:' + (_dashToken || 'missing').slice(0, 12);
+      var lastReload = Number(sessionStorage.getItem(key) || '0');
+      var now = Date.now();
+      if (!lastReload || now - lastReload > 5000) {
+        sessionStorage.setItem(key, String(now));
         console.warn('Dashboard token expired — reloading to refresh.');
         location.reload();
         // Let the reload kick in; return the 401 so any caller that
         // handles it sees a consistent result until the page unloads.
         return resp;
       }
+    } else if (resp.ok) {
+      try {
+        Object.keys(sessionStorage).forEach(function(k) {
+          if (k.indexOf('_dashReloadedForToken:') === 0) sessionStorage.removeItem(k);
+        });
+      } catch (_) { /* ignore */ }
     }
     return resp;
   }

package/dist/gateway/credit-guard.js

@@ -5,7 +5,7 @@ const CREDIT_BLOCK_FILE = path.join(BASE_DIR, 'cron', 'credit-block.json');
 const DEFAULT_BLOCK_MS = 6 * 60 * 60 * 1000;
 export function isCreditBalanceError(err) {
     const msg = String(err ?? '');
-    return /credit balance is too low|credit balance.*too low|insufficient credits?|billing.*credits?|account.*credits?.*low/i.test(msg);
+    return /credit balance is too low|credit balance.*too low|insufficient credits?|billing.*credits?|account.*credits?.*low|monthly usage limit|org'?s monthly usage limit|organization'?s monthly usage limit|hit your .*usage limit|usage limit.*(?:reached|exceeded|hit|active)|usage or credit limit|credit limit is active|spending limit|billing limit/i.test(msg);
 }
 export function getBackgroundCreditBlock(nowMs = Date.now()) {
     try {
@@ -41,6 +41,6 @@ export function markBackgroundCreditBlocked(err, nowMs = Date.now()) {
     return { block, created: true };
 }
 export function formatCreditBlock(block) {
-    return `Claude credit balance is too low. Background jobs are paused until ${block.until}.`;
+    return `Claude account usage or credit limit is active. Background jobs are paused until ${block.until}.`;
 }
 //# sourceMappingURL=credit-guard.js.map

package/dist/gateway/failure-diagnostics.js

@@ -16,6 +16,7 @@ import path from 'node:path';
 import pino from 'pino';
 import { AGENTS_DIR, BASE_DIR, CRON_FILE } from '../config.js';
 import { loadPromptOverrides, loadPromptOverridesForJob } from '../agent/prompt-overrides/loader.js';
+import { isCreditBalanceError } from './credit-guard.js';
 const logger = pino({ name: 'clementine.failure-diagnostics' });
 const CACHE_FILE = path.join(BASE_DIR, 'cron', 'failure-diagnostics.json');
 const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
@@ -297,6 +298,18 @@ export function diagnoseKnownFailurePattern(broken, jobDef, recentRuns, opts) {
         ...broken.lastErrors,
         recentRuns,
     ].join('\n').toLowerCase();
+    if (isCreditBalanceError(haystack)) {
+        return {
+            rootCause: 'Claude is blocked by an org usage or billing limit, so this is not a job-definition failure.',
+            confidence: 'high',
+            proposedFix: {
+                type: 'escalate_to_owner',
+                details: 'Keep background jobs paused until the Claude org usage limit resets or billing capacity is restored. Do not retry or auto-apply job fixes for this error.',
+            },
+            riskLevel: 'low',
+            generatedAt: new Date().toISOString(),
+        };
+    }
     if (/rapid_refill_breaker|autocompact.*thrash|context refilled|prompt is too long|prompt too long|context.?length|maximum context|input is too long/.test(haystack)) {
         if (hasContextOverflowPromptOverride(broken.jobName, broken.agentSlug, opts)) {
             return {

package/dist/gateway/job-health.d.ts

@@ -1,5 +1,5 @@
 import type { CronRunEntry } from '../types.js';
-export type JobHealthKind = 'healthy' | 'recovered' | 'partial' | 'context_overflow' | 'auth' | 'rate_limited' | 'tool_scope' | 'prompt_too_large' | 'failed' | 'unknown';
+export type JobHealthKind = 'healthy' | 'recovered' | 'partial' | 'context_overflow' | 'usage_blocked' | 'auth' | 'rate_limited' | 'tool_scope' | 'prompt_too_large' | 'failed' | 'unknown';
 export interface JobHealthStatus {
     status: JobHealthKind;
     jobName?: string;

package/dist/gateway/job-health.js

@@ -1,3 +1,4 @@
+import { isCreditBalanceError } from './credit-guard.js';
 function compactEvidence(...items) {
     const seen = new Set();
     const result = [];
@@ -21,6 +22,15 @@ export function classifyRunHealth(entry) {
         lastRunAt: entry.startedAt,
         terminalReason,
     };
+    if (isCreditBalanceError(blob)) {
+        return {
+            ...base,
+            status: 'usage_blocked',
+            evidence: compactEvidence(entry.error, entry.outputPreview, terminalReason ? `terminalReason=${terminalReason}` : undefined),
+            recommendedAction: 'Resolve the Claude org usage or billing limit, or switch this job to an available provider/model before retrying.',
+            requiresApproval: false,
+        };
+    }
     if (terminalReason === 'rapid_refill_breaker' || /rapid_refill_breaker|autocompact|context refilled|maximum context|context.?length/.test(blob)) {
         return {
             ...base,
@@ -112,6 +122,6 @@ export function classifyRunHealth(entry) {
 }
 export function isRunHealthFailure(entry) {
     const health = classifyRunHealth(entry);
-    return !['healthy', 'recovered', 'unknown'].includes(health.status);
+    return !['healthy', 'recovered', 'unknown', 'usage_blocked'].includes(health.status);
 }
 //# sourceMappingURL=job-health.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clementine-agent",
-  "version": "1.18.24",
+  "version": "1.18.25",
   "description": "Clementine — Personal AI Assistant (TypeScript)",
   "type": "module",
   "main": "dist/index.js",