oh-my-claude-sisyphus 3.3.10 → 3.4.0

package/dist/hooks/ralph/verifier.js

@@ -0,0 +1,223 @@
+/**
+ * Ralph Verifier
+ *
+ * Adds architect verification to ralph completion claims.
+ * When ralph outputs a completion promise, instead of immediately
+ * accepting it, we trigger an architect verification phase.
+ *
+ * Flow:
+ * 1. Ralph outputs <promise>TASK_COMPLETE</promise>
+ * 2. System detects this and enters verification mode
+ * 3. Architect agent is invoked to verify the work
+ * 4. If architect approves -> truly complete
+ * 5. If architect finds flaws -> continue ralph with architect feedback
+ */
+import { existsSync, readFileSync, writeFileSync, unlinkSync, mkdirSync } from 'fs';
+import { join } from 'path';
+const DEFAULT_MAX_VERIFICATION_ATTEMPTS = 3;
+/**
+ * Get verification state file path
+ */
+function getVerificationStatePath(directory) {
+    return join(directory, '.omc', 'ralph-verification.json');
+}
+/**
+ * Read verification state
+ */
+export function readVerificationState(directory) {
+    const statePath = getVerificationStatePath(directory);
+    if (!existsSync(statePath)) {
+        return null;
+    }
+    try {
+        return JSON.parse(readFileSync(statePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write verification state
+ */
+export function writeVerificationState(directory, state) {
+    const statePath = getVerificationStatePath(directory);
+    const stateDir = join(directory, '.omc');
+    if (!existsSync(stateDir)) {
+        try {
+            mkdirSync(stateDir, { recursive: true });
+        }
+        catch {
+            return false;
+        }
+    }
+    try {
+        writeFileSync(statePath, JSON.stringify(state, null, 2));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Clear verification state
+ */
+export function clearVerificationState(directory) {
+    const statePath = getVerificationStatePath(directory);
+    if (existsSync(statePath)) {
+        try {
+            unlinkSync(statePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Start verification process
+ */
+export function startVerification(directory, completionClaim, originalTask) {
+    const state = {
+        pending: true,
+        completion_claim: completionClaim,
+        verification_attempts: 0,
+        max_verification_attempts: DEFAULT_MAX_VERIFICATION_ATTEMPTS,
+        requested_at: new Date().toISOString(),
+        original_task: originalTask
+    };
+    writeVerificationState(directory, state);
+    return state;
+}
+/**
+ * Record architect feedback
+ */
+export function recordArchitectFeedback(directory, approved, feedback) {
+    const state = readVerificationState(directory);
+    if (!state) {
+        return null;
+    }
+    state.verification_attempts += 1;
+    state.architect_approved = approved;
+    state.architect_feedback = feedback;
+    if (approved) {
+        // Clear state on approval
+        clearVerificationState(directory);
+        return { ...state, pending: false };
+    }
+    // Check if max attempts reached
+    if (state.verification_attempts >= state.max_verification_attempts) {
+        clearVerificationState(directory);
+        return { ...state, pending: false };
+    }
+    // Continue verification loop
+    writeVerificationState(directory, state);
+    return state;
+}
+/**
+ * Generate architect verification prompt
+ */
+export function getArchitectVerificationPrompt(state) {
+    return `<ralph-verification>
+
+[ARCHITECT VERIFICATION REQUIRED - Attempt ${state.verification_attempts + 1}/${state.max_verification_attempts}]
+
+The agent claims the task is complete. Before accepting, YOU MUST verify with Architect.
+
+**Original Task:**
+${state.original_task}
+
+**Completion Claim:**
+${state.completion_claim}
+
+${state.architect_feedback ? `**Previous Architect Feedback (rejected):**\n${state.architect_feedback}\n` : ''}
+
+## MANDATORY VERIFICATION STEPS
+
+1. **Spawn Architect Agent** for verification:
+   \`\`\`
+   Task(subagent_type="architect", prompt="Verify this task completion claim...")
+   \`\`\`
+
+2. **Architect must check:**
+   - Are ALL requirements from the original task met?
+   - Is the implementation complete, not partial?
+   - Are there any obvious bugs or issues?
+   - Does the code compile/run without errors?
+   - Are tests passing (if applicable)?
+
+3. **Based on Architect's response:**
+   - If APPROVED: Output \`<architect-approved>VERIFIED_COMPLETE</architect-approved>\`
+   - If REJECTED: Continue working on the identified issues
+
+DO NOT output the completion promise again until Architect approves.
+
+</ralph-verification>
+
+---
+
+`;
+}
+/**
+ * Generate continuation prompt after architect rejection
+ */
+export function getArchitectRejectionContinuationPrompt(state) {
+    return `<ralph-continuation-after-rejection>
+
+[ARCHITECT REJECTED - Continue Working]
+
+Architect found issues with your completion claim. You must address them.
+
+**Architect Feedback:**
+${state.architect_feedback}
+
+**Original Task:**
+${state.original_task}
+
+## INSTRUCTIONS
+
+1. Address ALL issues identified by Architect
+2. Do NOT claim completion again until issues are fixed
+3. When truly done, output the completion promise again
+4. Another Architect verification will be triggered
+
+Continue working now.
+
+</ralph-continuation-after-rejection>
+
+---
+
+`;
+}
+/**
+ * Check if text contains architect approval
+ */
+export function detectArchitectApproval(text) {
+    return /<architect-approved>.*?VERIFIED_COMPLETE.*?<\/architect-approved>/is.test(text);
+}
+/**
+ * Check if text contains architect rejection indicators
+ */
+export function detectArchitectRejection(text) {
+    // Look for explicit rejection patterns
+    const rejectionPatterns = [
+        /architect.*?(rejected|found issues|not complete|incomplete)/i,
+        /issues? (found|identified|detected)/i,
+        /not yet complete/i,
+        /missing.*?(implementation|feature|test)/i,
+        /bug.*?(found|detected|identified)/i,
+        /error.*?(found|detected|identified)/i
+    ];
+    for (const pattern of rejectionPatterns) {
+        if (pattern.test(text)) {
+            // Extract feedback (rough heuristic)
+            const feedbackMatch = text.match(/(?:architect|feedback|issue|problem|error|bug)[:\s]+([^.]+\.)/i);
+            return {
+                rejected: true,
+                feedback: feedbackMatch ? feedbackMatch[1] : 'Architect found issues with the implementation.'
+            };
+        }
+    }
+    return { rejected: false, feedback: '' };
+}
+//# sourceMappingURL=verifier.js.map

package/dist/hooks/ralph/verifier.js.map

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

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

@@ -0,0 +1,114 @@
+/**
+ * Unified Recovery Constants
+ *
+ * Constants, messages, and patterns for all recovery mechanisms.
+ */
+export declare const CLAUDE_CODE_STORAGE: string;
+export declare const MESSAGE_STORAGE: string;
+export declare const PART_STORAGE: string;
+/**
+ * Debug logging configuration
+ */
+export declare const DEBUG: boolean;
+export declare const DEBUG_FILE: string;
+/**
+ * Part type sets for categorization
+ */
+export declare const THINKING_TYPES: Set<string>;
+export declare const META_TYPES: Set<string>;
+export declare const CONTENT_TYPES: Set<string>;
+/**
+ * Placeholder text for empty content
+ */
+export declare const PLACEHOLDER_TEXT = "[user interrupted]";
+/**
+ * ============================================================================
+ * CONTEXT WINDOW LIMIT RECOVERY
+ * ============================================================================
+ */
+/**
+ * Recovery message when context window limit is hit
+ */
+export declare const CONTEXT_LIMIT_RECOVERY_MESSAGE = "CONTEXT WINDOW LIMIT REACHED - IMMEDIATE ACTION REQUIRED\n\nThe conversation has exceeded the model's context window limit. To continue working effectively, you must take one of these actions:\n\n1. SUMMARIZE THE CONVERSATION\n   - Use the /compact command if available\n   - Or provide a concise summary of what has been accomplished so far\n   - Include key decisions, code changes, and remaining tasks\n\n2. START A FRESH CONTEXT\n   - If summarization isn't sufficient, suggest starting a new session\n   - Provide a handoff message with essential context\n\n3. REDUCE OUTPUT SIZE\n   - When showing code, show only relevant portions\n   - Use file paths and line numbers instead of full code blocks\n   - Be more concise in explanations\n\nIMPORTANT: Do not attempt to continue without addressing this limit.\nThe API will reject further requests until the context is reduced.\n\nCurrent Status:\n- Context limit exceeded\n- Further API calls will fail until context is reduced\n- Action required before continuing\n";
+/**
+ * Short notification for context limit
+ */
+export declare const CONTEXT_LIMIT_SHORT_MESSAGE = "Context window limit reached. Please use /compact to summarize the conversation or start a new session.";
+/**
+ * Recovery message for non-empty content errors
+ */
+export declare const NON_EMPTY_CONTENT_RECOVERY_MESSAGE = "API ERROR: Non-empty content validation failed.\n\nThis error typically occurs when:\n- A message has empty text content\n- The conversation structure is invalid\n\nSuggested actions:\n1. Continue with a new message\n2. If the error persists, start a new session\n\nThe system will attempt automatic recovery.\n";
+/**
+ * Recovery message when truncation was applied
+ */
+export declare const TRUNCATION_APPLIED_MESSAGE = "CONTEXT OPTIMIZATION APPLIED\n\nSome tool outputs have been truncated to fit within the context window.\nThe conversation can now continue normally.\n\nIf you need to see the full output of a previous tool call, you can:\n- Re-run the specific command\n- Ask to see a particular file or section\n\nContinuing with the current task...\n";
+/**
+ * Message when recovery fails
+ */
+export declare const RECOVERY_FAILED_MESSAGE = "CONTEXT RECOVERY FAILED\n\nAll automatic recovery attempts have been exhausted.\nPlease start a new session to continue.\n\nBefore starting a new session:\n1. Note what has been accomplished\n2. Save any important code changes\n3. Document the current state of the task\n\nYou can copy this conversation summary to continue in a new session.\n";
+/**
+ * Patterns to extract token counts from error messages
+ */
+export declare const TOKEN_LIMIT_PATTERNS: RegExp[];
+/**
+ * Keywords indicating token limit errors
+ */
+export declare const TOKEN_LIMIT_KEYWORDS: string[];
+/**
+ * ============================================================================
+ * EDIT ERROR RECOVERY
+ * ============================================================================
+ */
+/**
+ * Known Edit tool error patterns that indicate the AI made a mistake
+ */
+export declare const EDIT_ERROR_PATTERNS: readonly ["oldString and newString must be different", "oldString not found", "oldString found multiple times", "old_string not found", "old_string and new_string must be different"];
+/**
+ * System reminder injected when Edit tool fails due to AI mistake
+ * Short, direct, and commanding - forces immediate corrective action
+ */
+export declare const EDIT_ERROR_REMINDER = "\n[EDIT ERROR - IMMEDIATE ACTION REQUIRED]\n\nYou made an Edit mistake. STOP and do this NOW:\n\n1. READ the file immediately to see its ACTUAL current state\n2. VERIFY what the content really looks like (your assumption was wrong)\n3. APOLOGIZE briefly to the user for the error\n4. CONTINUE with corrected action based on the real file content\n\nDO NOT attempt another edit until you've read and verified the file state.\n";
+/**
+ * ============================================================================
+ * SESSION RECOVERY
+ * ============================================================================
+ */
+/**
+ * Recovery messages for different error types
+ */
+export declare const RECOVERY_MESSAGES: {
+    readonly tool_result_missing: {
+        readonly title: "Tool Crash Recovery";
+        readonly message: "Injecting cancelled tool results...";
+    };
+    readonly thinking_block_order: {
+        readonly title: "Thinking Block Recovery";
+        readonly message: "Fixing message structure...";
+    };
+    readonly thinking_disabled_violation: {
+        readonly title: "Thinking Strip Recovery";
+        readonly message: "Stripping thinking blocks...";
+    };
+    readonly empty_content: {
+        readonly title: "Empty Content Recovery";
+        readonly message: "Adding placeholder content...";
+    };
+    readonly context_window_limit: {
+        readonly title: "Context Window Limit";
+        readonly message: "Context limit reached - recovery required";
+    };
+    readonly edit_error: {
+        readonly title: "Edit Error";
+        readonly message: "Edit operation failed - corrective action needed";
+    };
+};
+/**
+ * Recovery error patterns
+ */
+export declare const ERROR_PATTERNS: {
+    readonly tool_result_missing: readonly ["tool_use", "tool_result"];
+    readonly thinking_block_order: readonly ["thinking", "first block", "must start with", "preceeding", "final block", "cannot be thinking"];
+    readonly thinking_disabled_violation: readonly ["thinking is disabled", "cannot contain"];
+    readonly empty_content: readonly ["empty", "content", "message"];
+};
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/hooks/recovery/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,eAAO,MAAM,mBAAmB,QAA4B,CAAC;AAC7D,eAAO,MAAM,eAAe,QAAuC,CAAC;AACpE,eAAO,MAAM,YAAY,QAAoC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,KAAK,SAG0B,CAAC;AAE7C,eAAO,MAAM,UAAU,QAAuC,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,cAAc,aAA0D,CAAC;AACtF,eAAO,MAAM,UAAU,aAAyC,CAAC;AACjE,eAAO,MAAM,aAAa,aAAuD,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AAErD;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,8BAA8B,kgCAyB1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,4GAA4G,CAAC;AAErJ;;GAEG;AACH,eAAO,MAAM,kCAAkC,4TAW9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,oVAUtC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,4VAWnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,UAMhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,UAShC,CAAC;AAEF;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB,wLAMtB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,mBAAmB,8aAW/B,CAAC;AAEF;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;CAyBpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAYjB,CAAC"}

package/dist/hooks/recovery/constants.js

@@ -0,0 +1,227 @@
+/**
+ * Unified Recovery Constants
+ *
+ * Constants, messages, and patterns for all recovery mechanisms.
+ */
+import { join } from 'node:path';
+import { homedir, tmpdir } from 'node:os';
+/**
+ * Get the data directory for Claude Code storage
+ * Follows XDG Base Directory specification
+ */
+function getDataDir() {
+    return process.env.XDG_DATA_HOME ?? join(homedir(), '.local', 'share');
+}
+/**
+ * Get the Claude Code storage directory
+ */
+function getClaudeCodeStorageDir() {
+    return join(getDataDir(), 'claude-code', 'storage');
+}
+export const CLAUDE_CODE_STORAGE = getClaudeCodeStorageDir();
+export const MESSAGE_STORAGE = join(CLAUDE_CODE_STORAGE, 'message');
+export const PART_STORAGE = join(CLAUDE_CODE_STORAGE, 'part');
+/**
+ * Debug logging configuration
+ */
+export const DEBUG = process.env.RECOVERY_DEBUG === '1' ||
+    process.env.CONTEXT_LIMIT_RECOVERY_DEBUG === '1' ||
+    process.env.SESSION_RECOVERY_DEBUG === '1';
+export const DEBUG_FILE = join(tmpdir(), 'recovery-debug.log');
+/**
+ * Part type sets for categorization
+ */
+export const THINKING_TYPES = new Set(['thinking', 'redacted_thinking', 'reasoning']);
+export const META_TYPES = new Set(['step-start', 'step-finish']);
+export const CONTENT_TYPES = new Set(['text', 'tool', 'tool_use', 'tool_result']);
+/**
+ * Placeholder text for empty content
+ */
+export const PLACEHOLDER_TEXT = '[user interrupted]';
+/**
+ * ============================================================================
+ * CONTEXT WINDOW LIMIT RECOVERY
+ * ============================================================================
+ */
+/**
+ * Recovery message when context window limit is hit
+ */
+export const CONTEXT_LIMIT_RECOVERY_MESSAGE = `CONTEXT WINDOW LIMIT REACHED - IMMEDIATE ACTION REQUIRED
+
+The conversation has exceeded the model's context window limit. To continue working effectively, you must take one of these actions:
+
+1. SUMMARIZE THE CONVERSATION
+   - Use the /compact command if available
+   - Or provide a concise summary of what has been accomplished so far
+   - Include key decisions, code changes, and remaining tasks
+
+2. START A FRESH CONTEXT
+   - If summarization isn't sufficient, suggest starting a new session
+   - Provide a handoff message with essential context
+
+3. REDUCE OUTPUT SIZE
+   - When showing code, show only relevant portions
+   - Use file paths and line numbers instead of full code blocks
+   - Be more concise in explanations
+
+IMPORTANT: Do not attempt to continue without addressing this limit.
+The API will reject further requests until the context is reduced.
+
+Current Status:
+- Context limit exceeded
+- Further API calls will fail until context is reduced
+- Action required before continuing
+`;
+/**
+ * Short notification for context limit
+ */
+export const CONTEXT_LIMIT_SHORT_MESSAGE = `Context window limit reached. Please use /compact to summarize the conversation or start a new session.`;
+/**
+ * Recovery message for non-empty content errors
+ */
+export const NON_EMPTY_CONTENT_RECOVERY_MESSAGE = `API ERROR: Non-empty content validation failed.
+
+This error typically occurs when:
+- A message has empty text content
+- The conversation structure is invalid
+
+Suggested actions:
+1. Continue with a new message
+2. If the error persists, start a new session
+
+The system will attempt automatic recovery.
+`;
+/**
+ * Recovery message when truncation was applied
+ */
+export const TRUNCATION_APPLIED_MESSAGE = `CONTEXT OPTIMIZATION APPLIED
+
+Some tool outputs have been truncated to fit within the context window.
+The conversation can now continue normally.
+
+If you need to see the full output of a previous tool call, you can:
+- Re-run the specific command
+- Ask to see a particular file or section
+
+Continuing with the current task...
+`;
+/**
+ * Message when recovery fails
+ */
+export const RECOVERY_FAILED_MESSAGE = `CONTEXT RECOVERY FAILED
+
+All automatic recovery attempts have been exhausted.
+Please start a new session to continue.
+
+Before starting a new session:
+1. Note what has been accomplished
+2. Save any important code changes
+3. Document the current state of the task
+
+You can copy this conversation summary to continue in a new session.
+`;
+/**
+ * Patterns to extract token counts from error messages
+ */
+export const TOKEN_LIMIT_PATTERNS = [
+    /(\d+)\s*tokens?\s*>\s*(\d+)\s*maximum/i,
+    /prompt.*?(\d+).*?tokens.*?exceeds.*?(\d+)/i,
+    /(\d+).*?tokens.*?limit.*?(\d+)/i,
+    /context.*?length.*?(\d+).*?maximum.*?(\d+)/i,
+    /max.*?context.*?(\d+).*?but.*?(\d+)/i,
+];
+/**
+ * Keywords indicating token limit errors
+ */
+export const TOKEN_LIMIT_KEYWORDS = [
+    'prompt is too long',
+    'is too long',
+    'context_length_exceeded',
+    'max_tokens',
+    'token limit',
+    'context length',
+    'too many tokens',
+    'non-empty content',
+];
+/**
+ * ============================================================================
+ * EDIT ERROR RECOVERY
+ * ============================================================================
+ */
+/**
+ * Known Edit tool error patterns that indicate the AI made a mistake
+ */
+export const EDIT_ERROR_PATTERNS = [
+    'oldString and newString must be different',
+    'oldString not found',
+    'oldString found multiple times',
+    'old_string not found',
+    'old_string and new_string must be different',
+];
+/**
+ * System reminder injected when Edit tool fails due to AI mistake
+ * Short, direct, and commanding - forces immediate corrective action
+ */
+export const EDIT_ERROR_REMINDER = `
+[EDIT ERROR - IMMEDIATE ACTION REQUIRED]
+
+You made an Edit mistake. STOP and do this NOW:
+
+1. READ the file immediately to see its ACTUAL current state
+2. VERIFY what the content really looks like (your assumption was wrong)
+3. APOLOGIZE briefly to the user for the error
+4. CONTINUE with corrected action based on the real file content
+
+DO NOT attempt another edit until you've read and verified the file state.
+`;
+/**
+ * ============================================================================
+ * SESSION RECOVERY
+ * ============================================================================
+ */
+/**
+ * Recovery messages for different error types
+ */
+export const RECOVERY_MESSAGES = {
+    tool_result_missing: {
+        title: 'Tool Crash Recovery',
+        message: 'Injecting cancelled tool results...',
+    },
+    thinking_block_order: {
+        title: 'Thinking Block Recovery',
+        message: 'Fixing message structure...',
+    },
+    thinking_disabled_violation: {
+        title: 'Thinking Strip Recovery',
+        message: 'Stripping thinking blocks...',
+    },
+    empty_content: {
+        title: 'Empty Content Recovery',
+        message: 'Adding placeholder content...',
+    },
+    context_window_limit: {
+        title: 'Context Window Limit',
+        message: 'Context limit reached - recovery required',
+    },
+    edit_error: {
+        title: 'Edit Error',
+        message: 'Edit operation failed - corrective action needed',
+    },
+};
+/**
+ * Recovery error patterns
+ */
+export const ERROR_PATTERNS = {
+    tool_result_missing: ['tool_use', 'tool_result'],
+    thinking_block_order: [
+        'thinking',
+        'first block',
+        'must start with',
+        'preceeding',
+        'final block',
+        'cannot be thinking',
+    ],
+    thinking_disabled_violation: ['thinking is disabled', 'cannot contain'],
+    empty_content: ['empty', 'content', 'message'],
+};
+//# sourceMappingURL=constants.js.map

package/dist/hooks/recovery/constants.js.map

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

package/dist/hooks/recovery/context-window.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Context Window Limit Recovery
+ *
+ * Detects context window limit errors and injects recovery messages
+ * to help Claude recover gracefully.
+ */
+import type { ParsedTokenLimitError, RecoveryResult, RecoveryConfig } from './types.js';
+/**
+ * Parse an error to detect if it's a token limit error
+ */
+export declare function parseTokenLimitError(err: unknown): ParsedTokenLimitError | null;
+/**
+ * Check if text contains a context limit error
+ */
+export declare function containsTokenLimitError(text: string): boolean;
+/**
+ * Handle context window limit recovery
+ */
+export declare function handleContextWindowRecovery(sessionId: string, error: unknown, config?: RecoveryConfig): RecoveryResult;
+/**
+ * Check if text contains a context limit error
+ */
+export declare function detectContextLimitError(text: string): boolean;
+//# sourceMappingURL=context-window.d.ts.map

package/dist/hooks/recovery/context-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-window.d.ts","sourceRoot":"","sources":["../../../src/hooks/recovery/context-window.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,OAAO,KAAK,EACV,qBAAqB,EAGrB,cAAc,EACd,cAAc,EACf,MAAM,YAAY,CAAC;AAsFpB;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,OAAO,GACX,qBAAqB,GAAG,IAAI,CA8J9B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D;AAuFD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,cAAc,GACtB,cAAc,CAwBhB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D"}