claudecode-omc 4.3.4

package/dist/hooks/recovery/context-window.js

@@ -0,0 +1,321 @@
+/**
+ * Context Window Limit Recovery
+ *
+ * Detects context window limit errors and injects recovery messages
+ * to help Claude recover gracefully.
+ */
+import * as fs from 'fs';
+import { TOKEN_LIMIT_PATTERNS, TOKEN_LIMIT_KEYWORDS, CONTEXT_LIMIT_RECOVERY_MESSAGE, CONTEXT_LIMIT_SHORT_MESSAGE, NON_EMPTY_CONTENT_RECOVERY_MESSAGE, RECOVERY_FAILED_MESSAGE, DEBUG, DEBUG_FILE, } from './constants.js';
+import { RETRY_CONFIG } from './types.js';
+function debugLog(...args) {
+    if (DEBUG) {
+        const msg = `[${new Date().toISOString()}] [context-window-recovery] ${args
+            .map((a) => typeof a === 'object' ? JSON.stringify(a, null, 2) : String(a))
+            .join(' ')}\n`;
+        fs.appendFileSync(DEBUG_FILE, msg);
+    }
+}
+const sessionStates = new Map();
+const STATE_TTL = 300_000; // 5 minutes
+/**
+ * Patterns indicating thinking block structure errors (NOT token limit)
+ */
+const THINKING_BLOCK_ERROR_PATTERNS = [
+    /thinking.*first block/i,
+    /first block.*thinking/i,
+    /must.*start.*thinking/i,
+    /thinking.*redacted_thinking/i,
+    /expected.*thinking.*found/i,
+    /thinking.*disabled.*cannot.*contain/i,
+];
+/**
+ * Check if error is a thinking block structure error
+ */
+function isThinkingBlockError(text) {
+    return THINKING_BLOCK_ERROR_PATTERNS.some((pattern) => pattern.test(text));
+}
+/**
+ * Check if text indicates a token limit error
+ */
+function isTokenLimitError(text) {
+    if (isThinkingBlockError(text)) {
+        return false;
+    }
+    const lower = text.toLowerCase();
+    return TOKEN_LIMIT_KEYWORDS.some((kw) => lower.includes(kw.toLowerCase()));
+}
+/**
+ * Extract token counts from error message
+ */
+function extractTokensFromMessage(message) {
+    for (const pattern of TOKEN_LIMIT_PATTERNS) {
+        const match = message.match(pattern);
+        if (match) {
+            const num1 = parseInt(match[1], 10);
+            const num2 = parseInt(match[2], 10);
+            return num1 > num2
+                ? { current: num1, max: num2 }
+                : { current: num2, max: num1 };
+        }
+    }
+    return null;
+}
+/**
+ * Extract message index from error text
+ */
+function extractMessageIndex(text) {
+    const match = text.match(/messages\.(\d+)/);
+    if (match) {
+        return parseInt(match[1], 10);
+    }
+    return undefined;
+}
+/**
+ * Parse an error to detect if it's a token limit error
+ */
+export function parseTokenLimitError(err) {
+    // Handle string errors
+    if (typeof err === 'string') {
+        if (err.toLowerCase().includes('non-empty content')) {
+            return {
+                currentTokens: 0,
+                maxTokens: 0,
+                errorType: 'non-empty content',
+                messageIndex: extractMessageIndex(err),
+            };
+        }
+        if (isTokenLimitError(err)) {
+            const tokens = extractTokensFromMessage(err);
+            return {
+                currentTokens: tokens?.current ?? 0,
+                maxTokens: tokens?.max ?? 0,
+                errorType: 'token_limit_exceeded_string',
+            };
+        }
+        return null;
+    }
+    // Handle non-object errors
+    if (!err || typeof err !== 'object')
+        return null;
+    const errObj = err;
+    // Collect all text sources from the error object
+    const textSources = [];
+    const dataObj = errObj.data;
+    const responseBody = dataObj?.responseBody;
+    const errorMessage = errObj.message;
+    const errorData = errObj.error;
+    const nestedError = errorData?.error;
+    if (typeof responseBody === 'string')
+        textSources.push(responseBody);
+    if (typeof errorMessage === 'string')
+        textSources.push(errorMessage);
+    if (typeof errorData?.message === 'string')
+        textSources.push(errorData.message);
+    if (typeof errObj.body === 'string')
+        textSources.push(errObj.body);
+    if (typeof errObj.details === 'string')
+        textSources.push(errObj.details);
+    if (typeof errObj.reason === 'string')
+        textSources.push(errObj.reason);
+    if (typeof errObj.description === 'string')
+        textSources.push(errObj.description);
+    if (typeof nestedError?.message === 'string')
+        textSources.push(nestedError.message);
+    if (typeof dataObj?.message === 'string')
+        textSources.push(dataObj.message);
+    if (typeof dataObj?.error === 'string')
+        textSources.push(dataObj.error);
+    // Try JSON stringification if no text sources found
+    if (textSources.length === 0) {
+        try {
+            const jsonStr = JSON.stringify(errObj);
+            if (isTokenLimitError(jsonStr)) {
+                textSources.push(jsonStr);
+            }
+        }
+        catch {
+            // Ignore JSON errors
+        }
+    }
+    const combinedText = textSources.join(' ');
+    if (!isTokenLimitError(combinedText))
+        return null;
+    // Try to parse structured response body
+    if (typeof responseBody === 'string') {
+        try {
+            const jsonPatterns = [
+                /data:\s*(\{[\s\S]*\})\s*$/m,
+                /(\{"type"\s*:\s*"error"[\s\S]*\})/,
+                /(\{[\s\S]*"error"[\s\S]*\})/,
+            ];
+            for (const pattern of jsonPatterns) {
+                const dataMatch = responseBody.match(pattern);
+                if (dataMatch) {
+                    try {
+                        const jsonData = JSON.parse(dataMatch[1]);
+                        const message = jsonData.error?.message || '';
+                        const tokens = extractTokensFromMessage(message);
+                        if (tokens) {
+                            return {
+                                currentTokens: tokens.current,
+                                maxTokens: tokens.max,
+                                requestId: jsonData.request_id,
+                                errorType: jsonData.error?.type || 'token_limit_exceeded',
+                            };
+                        }
+                    }
+                    catch {
+                        // Ignore parse errors
+                    }
+                }
+            }
+            // Check for Bedrock-style errors
+            const bedrockJson = JSON.parse(responseBody);
+            if (typeof bedrockJson.message === 'string' &&
+                isTokenLimitError(bedrockJson.message)) {
+                return {
+                    currentTokens: 0,
+                    maxTokens: 0,
+                    errorType: 'bedrock_input_too_long',
+                };
+            }
+        }
+        catch {
+            // Ignore parse errors
+        }
+    }
+    // Extract tokens from any text source
+    for (const text of textSources) {
+        const tokens = extractTokensFromMessage(text);
+        if (tokens) {
+            return {
+                currentTokens: tokens.current,
+                maxTokens: tokens.max,
+                errorType: 'token_limit_exceeded',
+            };
+        }
+    }
+    // Check for non-empty content error
+    if (combinedText.toLowerCase().includes('non-empty content')) {
+        return {
+            currentTokens: 0,
+            maxTokens: 0,
+            errorType: 'non-empty content',
+            messageIndex: extractMessageIndex(combinedText),
+        };
+    }
+    // Generic token limit error
+    if (isTokenLimitError(combinedText)) {
+        return {
+            currentTokens: 0,
+            maxTokens: 0,
+            errorType: 'token_limit_exceeded_unknown',
+        };
+    }
+    return null;
+}
+/**
+ * Check if text contains a context limit error
+ */
+export function containsTokenLimitError(text) {
+    return isTokenLimitError(text);
+}
+/**
+ * Get or create session state
+ */
+function getSessionState(sessionId) {
+    let state = sessionStates.get(sessionId);
+    const now = Date.now();
+    // Reset stale state
+    if (state && now - state.lastErrorTime > STATE_TTL) {
+        state = undefined;
+    }
+    if (!state) {
+        state = {
+            retryState: { attempt: 0, lastAttemptTime: 0 },
+            truncateState: { truncateAttempt: 0 },
+            lastErrorTime: now,
+            errorCount: 0,
+        };
+        sessionStates.set(sessionId, state);
+    }
+    return state;
+}
+/**
+ * Generate appropriate recovery message based on error and state
+ */
+function generateRecoveryMessage(parsed, state, config) {
+    // Use custom message if provided
+    if (config?.customMessages?.context_window_limit) {
+        return {
+            message: config.customMessages.context_window_limit,
+            errorType: parsed?.errorType,
+        };
+    }
+    // Handle non-empty content error
+    if (parsed?.errorType?.includes('non-empty content')) {
+        return {
+            message: NON_EMPTY_CONTENT_RECOVERY_MESSAGE,
+            errorType: 'non-empty content',
+        };
+    }
+    // Check retry limits
+    state.retryState.attempt++;
+    state.retryState.lastAttemptTime = Date.now();
+    if (state.retryState.attempt > RETRY_CONFIG.maxAttempts) {
+        return {
+            message: RECOVERY_FAILED_MESSAGE,
+            errorType: 'recovery_exhausted',
+        };
+    }
+    // Return detailed or short message based on config
+    if (config?.detailed !== false) {
+        let message = CONTEXT_LIMIT_RECOVERY_MESSAGE;
+        // Add token info if available
+        if (parsed?.currentTokens && parsed?.maxTokens) {
+            message += `\nToken Details:
+- Current: ${parsed.currentTokens.toLocaleString()} tokens
+- Maximum: ${parsed.maxTokens.toLocaleString()} tokens
+- Over limit by: ${(parsed.currentTokens - parsed.maxTokens).toLocaleString()} tokens
+`;
+        }
+        return {
+            message,
+            errorType: parsed?.errorType || 'token_limit_exceeded',
+        };
+    }
+    return {
+        message: CONTEXT_LIMIT_SHORT_MESSAGE,
+        errorType: parsed?.errorType || 'token_limit_exceeded',
+    };
+}
+/**
+ * Handle context window limit recovery
+ */
+export function handleContextWindowRecovery(sessionId, error, config) {
+    const parsed = parseTokenLimitError(error);
+    if (!parsed) {
+        return {
+            attempted: false,
+            success: false,
+        };
+    }
+    debugLog('detected token limit error', { sessionId, parsed });
+    const state = getSessionState(sessionId);
+    state.lastErrorTime = Date.now();
+    state.errorCount++;
+    const recovery = generateRecoveryMessage(parsed, state, config);
+    return {
+        attempted: true,
+        success: !!recovery.message,
+        message: recovery.message,
+        errorType: recovery.errorType,
+    };
+}
+/**
+ * Check if text contains a context limit error
+ */
+export function detectContextLimitError(text) {
+    return containsTokenLimitError(text);
+}
+//# sourceMappingURL=context-window.js.map

package/dist/hooks/recovery/context-window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-window.js","sourceRoot":"","sources":["../../../src/hooks/recovery/context-window.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,8BAA8B,EAC9B,2BAA2B,EAC3B,kCAAkC,EAClC,uBAAuB,EACvB,KAAK,EACL,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS1C,SAAS,QAAQ,CAAC,GAAG,IAAe;IAClC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,+BAA+B,IAAI;aACxE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAC/D;aACA,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QACjB,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAYD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAwB,CAAC;AACtD,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,YAAY;AAEvC;;GAEG;AACH,MAAM,6BAA6B,GAAG;IACpC,wBAAwB;IACxB,wBAAwB;IACxB,wBAAwB;IACxB,8BAA8B;IAC9B,4BAA4B;IAC5B,sCAAsC;CACvC,CAAC;AAEF;;GAEG;AACH,SAAS,oBAAoB,CAAC,IAAY;IACxC,OAAO,6BAA6B,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,IAAY;IACrC,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB,CAC/B,OAAe;IAEf,KAAK,MAAM,OAAO,IAAI,oBAAoB,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpC,OAAO,IAAI,GAAG,IAAI;gBAChB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE;gBAC9B,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC5C,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAY;IAEZ,uBAAuB;IACvB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACpD,OAAO;gBACL,aAAa,EAAE,CAAC;gBAChB,SAAS,EAAE,CAAC;gBACZ,SAAS,EAAE,mBAAmB;gBAC9B,YAAY,EAAE,mBAAmB,CAAC,GAAG,CAAC;aACvC,CAAC;QACJ,CAAC;QACD,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;YAC7C,OAAO;gBACL,aAAa,EAAE,MAAM,EAAE,OAAO,IAAI,CAAC;gBACnC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;gBAC3B,SAAS,EAAE,6BAA6B;aACzC,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2BAA2B;IAC3B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAEjD,MAAM,MAAM,GAAG,GAA8B,CAAC;IAE9C,iDAAiD;IACjD,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,MAAM,OAAO,GAAG,MAAM,CAAC,IAA2C,CAAC;IACnE,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;IAC3C,MAAM,YAAY,GAAG,MAAM,CAAC,OAA6B,CAAC;IAC1D,MAAM,SAAS,GAAG,MAAM,CAAC,KAA4C,CAAC;IACtE,MAAM,WAAW,GAAG,SAAS,EAAE,KAA4C,CAAC;IAE5E,IAAI,OAAO,YAAY,KAAK,QAAQ;QAAE,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACrE,IAAI,OAAO,YAAY,KAAK,QAAQ;QAAE,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACrE,IAAI,OAAO,SAAS,EAAE,OAAO,KAAK,QAAQ;QACxC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,OAAiB,CAAC,CAAC;IAChD,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAc,CAAC,CAAC;IAC7E,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;QACpC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,OAAiB,CAAC,CAAC;IAC7C,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;QACnC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,MAAgB,CAAC,CAAC;IAC5C,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ;QACxC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,WAAqB,CAAC,CAAC;IACjD,IAAI,OAAO,WAAW,EAAE,OAAO,KAAK,QAAQ;QAC1C,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,OAAiB,CAAC,CAAC;IAClD,IAAI,OAAO,OAAO,EAAE,OAAO,KAAK,QAAQ;QACtC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,OAAiB,CAAC,CAAC;IAC9C,IAAI,OAAO,OAAO,EAAE,KAAK,KAAK,QAAQ;QACpC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,KAAe,CAAC,CAAC;IAE5C,oDAAoD;IACpD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACvC,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAElD,wCAAwC;IACxC,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrC,IAAI,CAAC;YAUH,MAAM,YAAY,GAAG;gBACnB,4BAA4B;gBAC5B,mCAAmC;gBACnC,6BAA6B;aAC9B,CAAC;YAEF,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;gBACnC,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC9C,IAAI,SAAS,EAAE,CAAC;oBACd,IAAI,CAAC;wBACH,MAAM,QAAQ,GAAuB,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;wBAC9D,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC;wBAC9C,MAAM,MAAM,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;wBAEjD,IAAI,MAAM,EAAE,CAAC;4BACX,OAAO;gCACL,aAAa,EAAE,MAAM,CAAC,OAAO;gCAC7B,SAAS,EAAE,MAAM,CAAC,GAAG;gCACrB,SAAS,EAAE,QAAQ,CAAC,UAAU;gCAC9B,SAAS,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,IAAI,sBAAsB;6BAC1D,CAAC;wBACJ,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,sBAAsB;oBACxB,CAAC;gBACH,CAAC;YACH,CAAC;YAED,iCAAiC;YACjC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAC7C,IACE,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ;gBACvC,iBAAiB,CAAC,WAAW,CAAC,OAAO,CAAC,EACtC,CAAC;gBACD,OAAO;oBACL,aAAa,EAAE,CAAC;oBAChB,SAAS,EAAE,CAAC;oBACZ,SAAS,EAAE,wBAAwB;iBACpC,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO;gBACL,aAAa,EAAE,MAAM,CAAC,OAAO;gBAC7B,SAAS,EAAE,MAAM,CAAC,GAAG;gBACrB,SAAS,EAAE,sBAAsB;aAClC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,IAAI,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC7D,OAAO;YACL,aAAa,EAAE,CAAC;YAChB,SAAS,EAAE,CAAC;YACZ,SAAS,EAAE,mBAAmB;YAC9B,YAAY,EAAE,mBAAmB,CAAC,YAAY,CAAC;SAChD,CAAC;IACJ,CAAC;IAED,4BAA4B;IAC5B,IAAI,iBAAiB,CAAC,YAAY,CAAC,EAAE,CAAC;QACpC,OAAO;YACL,aAAa,EAAE,CAAC;YAChB,SAAS,EAAE,CAAC;YACZ,SAAS,EAAE,8BAA8B;SAC1C,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,SAAiB;IACxC,IAAI,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,oBAAoB;IACpB,IAAI,KAAK,IAAI,GAAG,GAAG,KAAK,CAAC,aAAa,GAAG,SAAS,EAAE,CAAC;QACnD,KAAK,GAAG,SAAS,CAAC;IACpB,CAAC;IAED,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG;YACN,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE;YAC9C,aAAa,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE;YACrC,aAAa,EAAE,GAAG;YAClB,UAAU,EAAE,CAAC;SACd,CAAC;QACF,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAC9B,MAAoC,EACpC,KAAmB,EACnB,MAAuB;IAEvB,iCAAiC;IACjC,IAAI,MAAM,EAAE,cAAc,EAAE,oBAAoB,EAAE,CAAC;QACjD,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,cAAc,CAAC,oBAAoB;YACnD,SAAS,EAAE,MAAM,EAAE,SAAS;SAC7B,CAAC;IACJ,CAAC;IAED,iCAAiC;IACjC,IAAI,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACrD,OAAO;YACL,OAAO,EAAE,kCAAkC;YAC3C,SAAS,EAAE,mBAAmB;SAC/B,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IAC3B,KAAK,CAAC,UAAU,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE9C,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;QACxD,OAAO;YACL,OAAO,EAAE,uBAAuB;YAChC,SAAS,EAAE,oBAAoB;SAChC,CAAC;IACJ,CAAC;IAED,mDAAmD;IACnD,IAAI,MAAM,EAAE,QAAQ,KAAK,KAAK,EAAE,CAAC;QAC/B,IAAI,OAAO,GAAG,8BAA8B,CAAC;QAE7C,8BAA8B;QAC9B,IAAI,MAAM,EAAE,aAAa,IAAI,MAAM,EAAE,SAAS,EAAE,CAAC;YAC/C,OAAO,IAAI;aACJ,MAAM,CAAC,aAAa,CAAC,cAAc,EAAE;aACrC,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE;mBAC3B,CAAC,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE;CAC5E,CAAC;QACE,CAAC;QAED,OAAO;YACL,OAAO;YACP,SAAS,EAAE,MAAM,EAAE,SAAS,IAAI,sBAAsB;SACvD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,2BAA2B;QACpC,SAAS,EAAE,MAAM,EAAE,SAAS,IAAI,sBAAsB;KACvD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,SAAiB,EACjB,KAAc,EACd,MAAuB;IAEvB,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAE3C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,4BAA4B,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IAE9D,MAAM,KAAK,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IACzC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACjC,KAAK,CAAC,UAAU,EAAE,CAAC;IAEnB,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAEhE,OAAO;QACL,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO;QAC3B,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,SAAS,EAAE,QAAQ,CAAC,SAAS;KAC9B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/dist/hooks/recovery/edit-error.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Edit Error Recovery
+ *
+ * Detects Edit tool errors caused by AI mistakes and injects
+ * a recovery reminder to guide corrective action.
+ */
+import type { RecoveryResult } from './types.js';
+/**
+ * Check if an output contains an edit error pattern
+ */
+export declare function detectEditError(output: string): boolean;
+/**
+ * Inject the edit error recovery reminder into the output
+ */
+export declare function injectEditErrorRecovery(output: string): string;
+/**
+ * Handle edit error recovery
+ */
+export declare function handleEditErrorRecovery(toolName: string, output: string): RecoveryResult;
+/**
+ * Process edit tool output and inject recovery if needed.
+ */
+export declare function processEditOutput(toolName: string, output: string): string;
+//# sourceMappingURL=edit-error.d.ts.map

package/dist/hooks/recovery/edit-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-error.d.ts","sourceRoot":"","sources":["../../../src/hooks/recovery/edit-error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAKvD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,cAAc,CAqBhB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1E"}

package/dist/hooks/recovery/edit-error.js

@@ -0,0 +1,56 @@
+/**
+ * Edit Error Recovery
+ *
+ * Detects Edit tool errors caused by AI mistakes and injects
+ * a recovery reminder to guide corrective action.
+ */
+import { EDIT_ERROR_PATTERNS, EDIT_ERROR_REMINDER, } from './constants.js';
+/**
+ * Check if an output contains an edit error pattern
+ */
+export function detectEditError(output) {
+    const outputLower = output.toLowerCase();
+    return EDIT_ERROR_PATTERNS.some((pattern) => outputLower.includes(pattern.toLowerCase()));
+}
+/**
+ * Inject the edit error recovery reminder into the output
+ */
+export function injectEditErrorRecovery(output) {
+    if (detectEditError(output)) {
+        return output + EDIT_ERROR_REMINDER;
+    }
+    return output;
+}
+/**
+ * Handle edit error recovery
+ */
+export function handleEditErrorRecovery(toolName, output) {
+    if (toolName.toLowerCase() !== 'edit') {
+        return {
+            attempted: false,
+            success: false,
+        };
+    }
+    if (detectEditError(output)) {
+        return {
+            attempted: true,
+            success: true,
+            message: EDIT_ERROR_REMINDER,
+            errorType: 'edit_error',
+        };
+    }
+    return {
+        attempted: false,
+        success: false,
+    };
+}
+/**
+ * Process edit tool output and inject recovery if needed.
+ */
+export function processEditOutput(toolName, output) {
+    if (toolName.toLowerCase() !== 'edit') {
+        return output;
+    }
+    return injectEditErrorRecovery(output);
+}
+//# sourceMappingURL=edit-error.js.map

package/dist/hooks/recovery/edit-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-error.js","sourceRoot":"","sources":["../../../src/hooks/recovery/edit-error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAGxB;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAC1C,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAC5C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,GAAG,mBAAmB,CAAC;IACtC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAgB,EAChB,MAAc;IAEd,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;QACtC,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,mBAAmB;YAC5B,SAAS,EAAE,YAAY;SACxB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,MAAc;IAChE,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/dist/hooks/recovery/index.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Unified Recovery Module
+ *
+ * Consolidates all recovery mechanisms into a single, coordinated system.
+ * Handles context window limits, edit errors, and session recovery.
+ *
+ * Recovery Priority (checked in order):
+ * 1. Context Window Limit - Most critical, blocks all progress
+ * 2. Edit Errors - Immediate user feedback needed
+ * 3. Session Recovery - Structural errors that need fixing
+ */
+export type { RecoveryErrorType, RecoveryResult, RecoveryConfig, ParsedTokenLimitError, RetryState, TruncateState, MessageData, StoredMessageMeta, StoredPart, StoredTextPart, StoredToolPart, StoredReasoningPart, } from './types.js';
+export { RETRY_CONFIG, TRUNCATE_CONFIG } from './types.js';
+export { CONTEXT_LIMIT_RECOVERY_MESSAGE, CONTEXT_LIMIT_SHORT_MESSAGE, NON_EMPTY_CONTENT_RECOVERY_MESSAGE, TRUNCATION_APPLIED_MESSAGE, RECOVERY_FAILED_MESSAGE, TOKEN_LIMIT_PATTERNS, TOKEN_LIMIT_KEYWORDS, EDIT_ERROR_PATTERNS, EDIT_ERROR_REMINDER, RECOVERY_MESSAGES, PLACEHOLDER_TEXT, } from './constants.js';
+export { readMessages, readParts, findEmptyMessages, findMessagesWithThinkingBlocks, findMessagesWithOrphanThinking, injectTextPart, prependThinkingPart, stripThinkingParts, replaceEmptyTextParts, } from './storage.js';
+export { handleContextWindowRecovery, detectContextLimitError, parseTokenLimitError, containsTokenLimitError, } from './context-window.js';
+export { handleEditErrorRecovery, detectEditError, processEditOutput, } from './edit-error.js';
+export { handleSessionRecovery, detectErrorType as detectSessionErrorType, isRecoverableError, } from './session-recovery.js';
+import type { RecoveryResult, RecoveryConfig, MessageData } from './types.js';
+/**
+ * Unified recovery handler
+ *
+ * Attempts recovery in priority order:
+ * 1. Context Window Limit (most critical)
+ * 2. Session Recovery (structural errors)
+ * 3. Edit Errors (handled during tool execution)
+ *
+ * @param input Recovery input
+ * @returns Recovery result
+ */
+export declare function handleRecovery(input: {
+    sessionId: string;
+    error?: unknown;
+    toolName?: string;
+    toolOutput?: string;
+    message?: MessageData;
+    config?: RecoveryConfig;
+}): Promise<RecoveryResult>;
+/**
+ * Detect if an error is recoverable
+ *
+ * Checks all recovery mechanisms to see if the error can be handled.
+ */
+export declare function detectRecoverableError(error: unknown): {
+    recoverable: boolean;
+    type?: string;
+};
+/**
+ * Detect if output contains an edit error
+ */
+export declare function detectEditErrorInOutput(output: string): boolean;
+/**
+ * Create unified recovery hook for Claude Code
+ *
+ * This hook provides a single entry point for all recovery mechanisms.
+ */
+export declare function createRecoveryHook(config?: RecoveryConfig): {
+    /**
+     * Check for errors during tool execution or message processing
+     */
+    onError: (input: {
+        session_id: string;
+        error: unknown;
+        message?: MessageData;
+    }) => Promise<RecoveryResult>;
+    /**
+     * Post-tool execution hook for edit error recovery
+     */
+    afterToolExecute: (input: {
+        tool: string;
+        output: string;
+        sessionId: string;
+    }) => {
+        output: string;
+        recovery?: RecoveryResult;
+    };
+    /**
+     * Check if an error is recoverable
+     */
+    isRecoverable: (error: unknown) => boolean;
+    /**
+     * Get recovery type for an error
+     */
+    getRecoveryType: (error: unknown) => string | undefined;
+};
+/**
+ * Parse context limit error for detailed information
+ */
+export declare function parseContextLimitError(error: unknown): import("./types.js").ParsedTokenLimitError | null;
+/**
+ * Detect if text contains a context limit error
+ */
+export declare function detectContextLimitErrorInText(text: string): boolean;
+/**
+ * Detect if text contains an edit error
+ */
+export declare function detectEditErrorInText(text: string): boolean;
+/**
+ * Check if session error is recoverable
+ */
+export declare function isSessionRecoverable(error: unknown): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/recovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/recovery/index.ts"],"names":[],"mappings":"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"}