@yemi33/minions 0.1.1744 → 0.1.1745

package/CHANGELOG.md

@@ -1,13 +1,15 @@
 # Changelog
 
-## 0.1.1744 (2026-05-06)
+## 0.1.1745 (2026-05-06)
+
+### Features
+- fix doc-chat failure bugs from Ripley investigation (#2103)
+
+## 0.1.1743 (2026-05-06)
 
 ### Fixes
 - isolate meeting tests off live MEETINGS_DIR (#2111)
 
-### Other
-- test(github): add unit tests for slug-backoff and verdict helpers (#2092)
-
 ## 0.1.1742 (2026-05-06)
 
 ### Fixes

package/dashboard/js/modal-qa.js

@@ -499,7 +499,7 @@ async function _processQaMessage(message, selection, opts) {
         selection: selection,
         filePath: capturedFilePath || null,
         model: window._lastStatus?.autoMode?.ccModel || undefined,
-        contentHash: capturedDocContext.content ? capturedDocContext.content.length + ':' + capturedDocContext.content.charCodeAt(0) + ':' + capturedDocContext.content.charCodeAt(capturedDocContext.content.length - 1) : undefined,
+        contentHash: capturedDocContext.content ? (function(s) { const m = Math.floor(s.length / 2); return s.length + ':' + s.charCodeAt(0) + ':' + s.charCodeAt(m) + ':' + s.charCodeAt(s.length - 1); })(capturedDocContext.content) : undefined,
       }),
     });
     let sessionDocContext = { ...capturedDocContext };
@@ -521,6 +521,12 @@ async function _processQaMessage(message, selection, opts) {
     async function _qaHandleStreamEvent(evt) {
       if (!evt || !evt.type) return;
       if (evt.type === 'heartbeat') return;
+      if (evt.type === 'progress') {
+        // Backend is retrying (attempt 2 or 3) — reset stall watchdog so the next
+        // attempt gets its own full stall window instead of sharing the first attempt's.
+        _resetQaStreamWatchdog();
+        return;
+      }
       if (evt.type === 'chunk') {
         _resetQaStreamWatchdog();
         streamedText = evt.text || '';

package/dashboard.js

@@ -2377,7 +2377,7 @@ async function ccCall(message, { store = 'cc', sessionKey, extraContext, label =
   return result;
 }
 
-async function ccCallStreaming(message, { store = 'cc', sessionKey, extraContext, label = 'command-center', timeout = CC_CALL_TIMEOUT_MS, maxTurns, allowedTools = 'Bash,Read,Write,Edit,Glob,Grep,WebFetch,WebSearch', skipStatePreamble = false, model, onAbortReady, onChunk, onToolUse, systemPrompt = CC_STATIC_SYSTEM_PROMPT } = {}) {
+async function ccCallStreaming(message, { store = 'cc', sessionKey, extraContext, label = 'command-center', timeout = CC_CALL_TIMEOUT_MS, maxTurns, allowedTools = 'Bash,Read,Write,Edit,Glob,Grep,WebFetch,WebSearch', skipStatePreamble = false, model, onAbortReady, onChunk, onToolUse, onRetry, systemPrompt = CC_STATIC_SYSTEM_PROMPT } = {}) {
   if (!maxTurns) maxTurns = CONFIG.engine?.ccMaxTurns || shared.ENGINE_DEFAULTS.ccMaxTurns;
   if (!model) model = CONFIG.engine?.ccModel || shared.ENGINE_DEFAULTS.ccModel;
   const ccEffort = CONFIG.engine?.ccEffort || shared.ENGINE_DEFAULTS.ccEffort;
@@ -2430,6 +2430,7 @@ async function ccCallStreaming(message, { store = 'cc', sessionKey, extraContext
     }
   }
 
+  if (onRetry) onRetry(2);
   const freshPrompt = buildPrompt();
   const p2 = llm.callLLMStreaming(freshPrompt, systemPrompt, {
     timeout, label, model, maxTurns, allowedTools, effort: ccEffort, direct: true,
@@ -2450,6 +2451,7 @@ async function ccCallStreaming(message, { store = 'cc', sessionKey, extraContext
   if (maxTurns <= 1) return result;
   console.log(`[${label}] Fresh call also failed (code=${result.code}, empty=${!result.text}), retrying once more...`);
   await new Promise(r => setTimeout(r, 2000));
+  if (onRetry) onRetry(3);
   const p3 = llm.callLLMStreaming(freshPrompt, systemPrompt, {
     timeout, label, model, maxTurns, allowedTools, effort: ccEffort, direct: true,
     engineConfig: CONFIG.engine,
@@ -2467,10 +2469,13 @@ async function ccCallStreaming(message, { store = 'cc', sessionKey, extraContext
   return result;
 }
 
-// Lightweight content fingerprint — same algorithm used browser-side (no crypto needed)
+// Lightweight content fingerprint — same algorithm used browser-side (no crypto needed).
+// Uses length + first + middle + last char codes. Collisions on same-length strings with
+// identical first/middle/last chars are rare enough for a staleness check (not a security hash).
 function contentFingerprint(str) {
   if (!str) return '';
-  return str.length + ':' + str.charCodeAt(0) + ':' + str.charCodeAt(str.length - 1);
+  const mid = Math.floor(str.length / 2);
+  return str.length + ':' + str.charCodeAt(0) + ':' + str.charCodeAt(mid) + ':' + str.charCodeAt(str.length - 1);
 }
 
 function _parseDocChatResultText(text, { allowActions = false } = {}) {
@@ -2524,6 +2529,17 @@ function _formatDocChatContext({ document, title, filePath, selection, canEdit,
   return context;
 }
 
+// Map errorClass codes from the runtime adapter to actionable user-facing messages.
+// sessionPreserved=true means ccCall preserved the session — user can retry immediately.
+function _docChatErrorMessage(errorClass, sessionPreserved = false) {
+  if (errorClass === 'auth-failure') return 'Claude authentication failed — run `claude auth` or check your API key, then try again.';
+  if (errorClass === 'context-limit') return 'Session context is too long. Click "Clear" to start a fresh conversation.';
+  if (errorClass === 'budget-exceeded') return 'API budget exceeded — check your Claude account spending limit.';
+  if (errorClass === 'crash') return 'Claude runtime crashed unexpectedly. Try again.';
+  if (sessionPreserved) return 'Temporary connection issue — your conversation is intact, send your message again.';
+  return 'Failed to process request. Try again.';
+}
+
 // Build the doc-chat extraContext for a single ccCall pass — refreshed on retry
 // so a fresh-session retry includes the full document instead of relying on the
 // dead session's prior turn for context.
@@ -2555,14 +2571,14 @@ async function _retryDocChatAfterResumeFailure({ result, initialPass, freshSessi
 }
 
 // Build the {error} envelope returned to the dashboard when doc-chat ultimately
-// fails. Keeps the polite user-facing message but exposes the runtime's real
-// stderr / exit code / errorClass so the UI can render the cause and so future
-// failures are debuggable from logs.
-function _docChatFailureResponse(label, filePath, result) {
+// fails. Surfaces an actionable user-facing message (via _docChatErrorMessage)
+// plus the runtime's real stderr / exit code / errorClass so the UI can render
+// the cause and so future failures are debuggable from logs.
+function _docChatFailureResponse(label, filePath, result, sessionPreserved = false) {
   const stderrTail = (result.stderr || '').slice(-2048);
-  console.error(`[${label}] Failed: code=${result.code}, empty=${!result.text}, filePath=${filePath}, errorClass=${result.errorClass || 'null'}, stderr=${stderrTail.slice(0, 200)}`);
+  console.error(`[${label}] Failed: code=${result.code}, errorClass=${result.errorClass || 'null'}, sessionPreserved=${sessionPreserved}, empty=${!result.text}, filePath=${filePath}, stderr=${stderrTail.slice(0, 200)}`);
   return {
-    answer: 'Failed to process request. Try again.',
+    answer: _docChatErrorMessage(result.errorClass, sessionPreserved),
     content: null,
     actions: [],
     error: {
@@ -2574,6 +2590,7 @@ function _docChatFailureResponse(label, filePath, result) {
   };
 }
 
+
 // Doc-specific wrapper — adds document context, parses ---DOCUMENT---
 async function ccDocCall({ message, document, title, filePath, selection, canEdit, isJson, model, freshSession, onAbortReady }) {
   const sessionKey = filePath || title;
@@ -2628,13 +2645,14 @@ async function ccDocCall({ message, document, title, filePath, selection, canEdi
   }
 
   if (result.code !== 0 || !result.text) {
-    return _docChatFailureResponse('doc-chat', filePath, result);
+    const sessionPreserved = !!(resolveSession('doc', sessionKey)?.sessionId);
+    return _docChatFailureResponse('doc-chat', filePath, result, sessionPreserved);
   }
 
   return _parseDocChatResultText(result.text, { allowActions });
 }
 
-async function ccDocCallStreaming({ message, document, title, filePath, selection, canEdit, isJson, model, freshSession, onAbortReady, onChunk, onToolUse }) {
+async function ccDocCallStreaming({ message, document, title, filePath, selection, canEdit, isJson, model, freshSession, onAbortReady, onChunk, onToolUse, onRetry }) {
   const sessionKey = filePath || title;
   const docSlice = document.slice(0, 20000);
 
@@ -2660,6 +2678,7 @@ async function ccDocCallStreaming({ message, document, title, filePath, selectio
       onAbortReady,
       onChunk: (text) => { if (onChunk) onChunk(_docChatDisplayText(text, { allowActions })); },
       onToolUse,
+      onRetry,
     });
   };
 
@@ -2682,7 +2701,8 @@ async function ccDocCallStreaming({ message, document, title, filePath, selectio
   }
 
   if (result.code !== 0 || !result.text) {
-    return _docChatFailureResponse('doc-chat-stream', filePath, result);
+    const sessionPreserved = !!(resolveSession('doc', sessionKey)?.sessionId);
+    return _docChatFailureResponse('doc-chat-stream', filePath, result, sessionPreserved);
   }
 
   return _parseDocChatResultText(result.text, { allowActions });
@@ -4903,6 +4923,7 @@ What would you like to discuss or change? When you're happy, say "approve" and I
           onAbortReady: (abort) => { _docAbort = abort; },
           onChunk: (text) => { writeDocEvent({ type: 'chunk', text }); },
           onToolUse: (name, input) => { writeDocEvent({ type: 'tool', name, input: _lightToolInput(input) }); },
+          onRetry: (attempt) => { writeDocEvent({ type: 'progress', attempt }); },
         });
         const actionResults = await executeDocChatActions(actions);
         const donePayload = (extra = {}) => ({

package/engine/copilot-models.json

@@ -1,5 +1,5 @@
 {
   "runtime": "copilot",
   "models": null,
-  "cachedAt": "2026-05-06T01:39:28.821Z"
+  "cachedAt": "2026-05-06T02:33:28.238Z"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yemi33/minions",
-  "version": "0.1.1744",
+  "version": "0.1.1745",
   "description": "Multi-agent AI dev team that runs from ~/.minions/ — five autonomous agents share a single engine, dashboard, and knowledge base",
   "bin": {
     "minions": "bin/minions.js"