@nexus-cortex/core 4.26.0

package/dist/middleware/ErrorClassificationMiddleware.js

@@ -0,0 +1,225 @@
+/**
+ * Error Classification Middleware
+ *
+ * Provides error classification and retry eligibility determination for the orchestrator.
+ * Extracted from CortexOrchestrator.ts (lines 2197-2252) as part of the parallel
+ * refactor project.
+ *
+ * This component is standalone and can be used independently of the orchestrator.
+ *
+ * @version 1.0.0
+ * @author Agent 1 - Parallel Refactor Wave 1
+ */
+/**
+ * ErrorClassificationMiddleware
+ *
+ * Classifies errors into categories and determines whether they are retryable.
+ * Supports network errors, HTTP status codes, file system errors, permission errors,
+ * and abort errors.
+ *
+ * @example
+ * ```typescript
+ * const classifier = new ErrorClassificationMiddleware();
+ *
+ * const error = new Error('ECONNRESET');
+ * const classification = classifier.classify(error);
+ * console.log(classification.isRetryable); // true
+ * console.log(classification.errorType); // 'network'
+ * ```
+ */
+export class ErrorClassificationMiddleware {
+    /**
+     * Network error patterns that indicate transient connectivity issues
+     */
+    networkErrorPatterns = [
+        'econnreset',
+        'econnrefused',
+        'etimedout',
+        'enetunreach',
+        'ehostunreach',
+        'socket hang up',
+        'network error',
+        'fetch failed',
+    ];
+    /**
+     * HTTP status codes that are typically retryable
+     */
+    retryableStatusCodes = [408, 429, 500, 502, 503, 504];
+    /**
+     * File system error patterns that indicate temporary resource contention
+     */
+    temporaryFsErrorPatterns = ['ebusy', 'eagain'];
+    /**
+     * Permission and validation error patterns that are not retryable
+     */
+    nonRetryablePatterns = [
+        'permission denied',
+        'eacces',
+        'eperm',
+        'enoent', // File not found
+        'invalid',
+        'validation failed',
+        'unauthorized',
+        'forbidden',
+    ];
+    /**
+     * Classify an error and provide detailed information
+     *
+     * @param error - The error to classify
+     * @returns Complete error classification with type, retryability, and metadata
+     *
+     * @example
+     * ```typescript
+     * const error = new Error('ETIMEDOUT');
+     * const result = classifier.classify(error);
+     * // {
+     * //   isRetryable: true,
+     * //   errorType: 'network',
+     * //   message: 'ETIMEDOUT',
+     * //   metadata: { errorName: 'error' }
+     * // }
+     * ```
+     */
+    classify(error) {
+        const statusCode = error?.status || error?.statusCode;
+        // Determine error type
+        const errorType = this.getErrorType(error);
+        // Determine if retryable
+        const isRetryable = this.isRetryable(error);
+        // Build classification result
+        const classification = {
+            isRetryable,
+            errorType,
+            message: error?.message || String(error),
+            metadata: {
+                errorName: error?.name,
+            },
+        };
+        // Add status code if present
+        if (statusCode !== undefined) {
+            classification.statusCode = statusCode;
+            classification.metadata.statusCode = statusCode;
+        }
+        return classification;
+    }
+    /**
+     * Determine if an error is retryable
+     *
+     * @param error - The error to check
+     * @returns true if the error is transient and should be retried
+     *
+     * @example
+     * ```typescript
+     * const error = { status: 503 };
+     * classifier.isRetryable(error); // true
+     *
+     * const permError = new Error('EACCES');
+     * classifier.isRetryable(permError); // false
+     * ```
+     */
+    isRetryable(error) {
+        const errorMessage = this.normalizeString(error?.message);
+        const errorName = this.normalizeString(error?.name);
+        // R13 (parallel-bench): HTTP status code is AUTHORITATIVE. A 401 with
+        // "ECONNRESET" in the body is still an auth error — message patterns must
+        // not override it. Only fall back to pattern matching when there is no
+        // status code at all.
+        const statusCode = error?.status || error?.statusCode;
+        if (statusCode) {
+            return this.retryableStatusCodes.includes(statusCode) || statusCode >= 500;
+        }
+        // No status code → fall back to message-pattern matching.
+        // Network/connection errors - retryable
+        if (this.matchesPattern(errorMessage, errorName, this.networkErrorPatterns)) {
+            return true;
+        }
+        // Temporary file system errors - retryable
+        if (this.matchesPattern(errorMessage, errorName, this.temporaryFsErrorPatterns)) {
+            return true;
+        }
+        // Abort errors - NOT retryable (user/timeout initiated)
+        if (errorName === 'aborterror' || errorMessage.includes('abort')) {
+            return false;
+        }
+        // Permission/validation errors - NOT retryable
+        if (this.matchesPattern(errorMessage, errorName, this.nonRetryablePatterns)) {
+            return false;
+        }
+        // Default: don't retry unknown errors
+        return false;
+    }
+    /**
+     * Get the type of error
+     *
+     * @param error - The error to classify
+     * @returns The error type category
+     *
+     * @example
+     * ```typescript
+     * const error = new Error('ECONNRESET');
+     * classifier.getErrorType(error); // 'network'
+     *
+     * const permError = new Error('EACCES');
+     * classifier.getErrorType(permError); // 'permission'
+     * ```
+     */
+    getErrorType(error) {
+        const errorMessage = this.normalizeString(error?.message);
+        const errorName = this.normalizeString(error?.name);
+        // R13 (parallel-bench): status code is AUTHORITATIVE — a 429 with
+        // "invalid" in the body is rate_limit, not validation. Pattern matching
+        // only applies when there is no status code.
+        const statusCode = error?.status || error?.statusCode;
+        if (statusCode) {
+            if (statusCode === 429)
+                return 'rate_limit';
+            if (statusCode === 401 || statusCode === 403)
+                return 'permission';
+            if (statusCode >= 500)
+                return 'network';
+            if (statusCode >= 400)
+                return 'validation';
+        }
+        // Check for network errors
+        if (this.matchesPattern(errorMessage, errorName, this.networkErrorPatterns)) {
+            return 'network';
+        }
+        // Check for abort errors
+        if (errorName === 'aborterror' || errorMessage.includes('abort')) {
+            return 'abort';
+        }
+        // Check for permission errors
+        const permissionPatterns = ['permission denied', 'eacces', 'eperm', 'unauthorized', 'forbidden'];
+        if (this.matchesPattern(errorMessage, errorName, permissionPatterns)) {
+            return 'permission';
+        }
+        // Check for validation errors
+        const validationPatterns = ['invalid', 'validation failed', 'enoent'];
+        if (this.matchesPattern(errorMessage, errorName, validationPatterns)) {
+            return 'validation';
+        }
+        // Default to unknown
+        return 'unknown';
+    }
+    /**
+     * Normalize a string for case-insensitive comparison
+     *
+     * @param value - The string to normalize
+     * @returns Lowercase string or empty string if null/undefined
+     */
+    normalizeString(value) {
+        return value?.toLowerCase() || '';
+    }
+    /**
+     * Check if error message or name matches any of the given patterns
+     *
+     * @param errorMessage - Normalized error message
+     * @param errorName - Normalized error name
+     * @param patterns - Array of patterns to match against
+     * @returns true if any pattern matches
+     */
+    matchesPattern(errorMessage, errorName, patterns) {
+        return patterns.some(pattern => errorMessage.includes(pattern) || errorName.includes(pattern));
+    }
+}
+//# sourceMappingURL=ErrorClassificationMiddleware.js.map

package/dist/middleware/ErrorClassificationMiddleware.js.map

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

package/dist/middleware/HelperModelMiddleware.d.ts

@@ -0,0 +1,337 @@
+/**
+ * Helper Model Middleware
+ * Based on: CORTEX_V4_PHASE_1.5_ARCHITECTURE.md Part 6
+ *
+ * Two-Tier Token Economy:
+ * - Expensive models (Claude, GPT-4) for actual work
+ * - Cheap helper models (Haiku, GPT-3.5, Flash) for context management
+ *
+ * Features:
+ * - Automatic fallback on context rejection
+ * - Transparent processing (helper does work, returns to main)
+ * - Cost tracking (60-80% savings on context operations)
+ *
+ * Week 2 Integration:
+ * - Uses independent helper middleware adapter system
+ * - Real API calls via pattern-based adapters
+ * - Supports Messages API, Chat Completions API, Google GenAI API
+ */
+import { ModelConfig, ModelRegistry } from '../models/ModelConfig.interface.js';
+import { StoredCompactionManager } from '../conversation/StoredCompactionManager.js';
+import { SessionTimeline } from '../session/SessionTimeline.js';
+import type { Message } from '../session/MessageTypes.js';
+/**
+ * Context Limit Error
+ *
+ * Represents an error when a model rejects a request due to context window limits
+ */
+export interface ContextLimitError extends Error {
+    type: 'context_limit';
+    provider: string;
+    modelId: string;
+    requestedTokens?: number;
+    maxTokens?: number;
+    details?: any;
+}
+/**
+ * Context Rejection Analysis
+ */
+export interface RejectionAnalysis {
+    reason: 'history_too_large' | 'tool_results_too_large' | 'combined_overflow';
+    historyTokens: number;
+    toolResultTokens: number;
+    totalTokens: number;
+    maxTokens: number;
+    excessTokens: number;
+}
+/**
+ * Model Request (generic)
+ */
+export interface ModelRequest {
+    messages: any[];
+    tools?: any[];
+    parameters?: Record<string, any>;
+    systemPrompt?: string;
+}
+/**
+ * Model Response (generic)
+ */
+export interface ModelResponse {
+    content: string | any[];
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+    stopReason?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Helper Model Registry
+ *
+ * Maps main model providers to their appropriate helper models
+ */
+export declare const HELPER_MODEL_REGISTRY: Record<string, string>;
+/**
+ * Compaction Request
+ */
+export interface CompactionRequest {
+    messages: any[];
+    targetTokenCount: number;
+    preserveRecent?: number;
+}
+/**
+ * Compaction Result
+ */
+export interface CompactionResult {
+    compactedMessages: any[];
+    summary: string;
+    originalTokens: number;
+    compressedTokens: number;
+    tokensSaved: number;
+    helperModelId: string;
+    processingTime: number;
+    cost: number;
+}
+/**
+ * Cost Tracking
+ */
+export interface CostTracking {
+    helperModelCalls: number;
+    helperTokensProcessed: number;
+    helperCost: number;
+    mainModelCalls: number;
+    mainTokensProcessed: number;
+    mainCost: number;
+    totalCost: number;
+    savings: number;
+    savingsPercentage: number;
+}
+/**
+ * Helper Model Middleware
+ *
+ * Automatically handles context rejections by routing to cheaper helper models
+ */
+export declare class HelperModelMiddleware {
+    private costTracking;
+    private helperAdapterRegistry;
+    private compactionManager?;
+    private timeline?;
+    private modelRegistry?;
+    constructor(options?: {
+        compactionManager?: StoredCompactionManager;
+        timeline?: SessionTimeline;
+        modelRegistry?: ModelRegistry;
+    });
+    /**
+     * Handle context rejection with automatic fallback
+     *
+     * Main entry point for context limit errors
+     */
+    handleContextRejection(originalRequest: ModelRequest, rejectionError: ContextLimitError, mainModel: ModelConfig): Promise<ModelResponse>;
+    /**
+     * Handle history overflow
+     *
+     * Strategy: Compact conversation history via helper model
+     */
+    private handleHistoryOverflow;
+    /**
+     * Handle tool result overflow
+     *
+     * Strategy: Summarize large tool results via helper model
+     */
+    private handleToolResultOverflow;
+    /**
+     * Handle combined overflow
+     *
+     * Strategy: Compact history AND summarize tool results
+     */
+    private handleCombinedOverflow;
+    /**
+     * Compact conversation history using helper model
+     *
+     * Week 2 Integration: Uses real API calls via helper middleware adapters
+     */
+    private compactHistoryViaHelper;
+    /**
+     * Select helper model based on main model provider
+     */
+    selectHelperModel(provider: string): string;
+    /**
+     * Get ModelConfig for a helper/mentorship model by ID
+     *
+     * Priority:
+     * 1. Main model registry (allows ANY model including premium models for mentorship)
+     * 2. Fallback to hardcoded cheap helper models (for backward compatibility)
+     */
+    private static _helperConfigsCache;
+    /**
+     * R11 (Opus finding): the helper-config dictionary was rebuilt as an
+     * object literal on every getHelperModelConfig call. Hoisted to a
+     * memoized static — built once, same reference across calls.
+     */
+    static getHelperConfigsCached(): Record<string, Partial<ModelConfig>>;
+    private getHelperModelConfig;
+    /**
+     * Analyze context rejection to determine cause
+     */
+    analyzeRejection(request: ModelRequest, _error: ContextLimitError, model: ModelConfig): RejectionAnalysis;
+    /**
+     * Calculate available history budget for a model
+     */
+    private calculateHistoryBudget;
+    /**
+     * Check if error is a context limit error using provider-specific detection
+     */
+    isContextLimitError(error: any, provider?: string): error is ContextLimitError;
+    /**
+     * Track helper model usage for cost analysis
+     */
+    private trackHelperModelUsage;
+    /**
+     * Track main model usage
+     */
+    trackMainModelUsage(tokens: number, cost: number): void;
+    /**
+     * Get cost tracking statistics
+     */
+    getCostTracking(): CostTracking;
+    /**
+     * Reset cost tracking
+     */
+    resetCostTracking(): void;
+    /**
+     * Extract topics from summary text
+     * Simple heuristic: look for key phrases and noun phrases
+     */
+    private extractTopics;
+    /**
+     * Extract tool names from messages
+     */
+    private extractTools;
+    /**
+     * Generate error guidance using helper model
+     *
+     * Reactive Mentorship: Phase 1 - Error-Triggered Mentorship
+     *
+     * Analyzes tool errors and provides strategic guidance for recovery
+     */
+    generateErrorGuidance(context: {
+        toolName: string;
+        toolUseId: string;
+        error: string | object;
+        recentHistory: Message[];
+        helperModelId?: string;
+    }): Promise<string>;
+    /**
+     * Generate a concise session title from the first user message.
+     * Fire-and-forget on turn 0 — result is saved to session metadata.
+     */
+    generateSessionTitle(firstUserMessage: string, helperModelId?: string): Promise<string>;
+    /**
+     * Generate a turn summary and predict the user's next action.
+     * Called post-turn when TURN_SUMMARY_PREDICTION=true.
+     */
+    generateTurnSummaryAndPrediction(context: {
+        lastAssistantText: string;
+        lastUserText: string;
+        toolsUsed: string[];
+        helperModelId?: string;
+    }): Promise<{
+        summary: string;
+        prediction: string;
+    }>;
+    /**
+     * Generate keyword-based guidance using helper model
+     *
+     * Reactive Mentorship: Phase 1 - Keyword-Triggered Mentorship
+     *
+     * Handles @ultrathink, @analyze, @rethink keyword requests
+     */
+    generateKeywordGuidance(context: {
+        keyword: string;
+        recentHistory: Message[];
+        helperModelId?: string;
+    }): Promise<string>;
+    /**
+     * Format recent history for mentorship context
+     */
+    private formatRecentHistory;
+    /**
+     * Extract text content from a message
+     */
+    private extractTextContent;
+    /**
+     * Build keyword-specific prompt
+     */
+    private buildKeywordPrompt;
+    /**
+     * Extract thinking content from response
+     */
+    private extractThinkingContent;
+    /**
+     * Generate periodic review guidance (Phase 2)
+     * Triggered every N turns for strategic check-in
+     */
+    generatePeriodicReview(context: {
+        turnNumber: number;
+        recentHistory: Message[];
+        includeStrategicAdvice: boolean;
+        helperModelId?: string;
+    }): Promise<string>;
+    /**
+     * Build strategic review prompt (comprehensive)
+     */
+    private buildStrategicReviewPrompt;
+    /**
+     * Build summary review prompt (lightweight)
+     */
+    private buildSummaryReviewPrompt;
+    /**
+     * Generate pattern detection guidance (Phase 2)
+     * Triggered when repeated error patterns are detected
+     */
+    generatePatternDetectionGuidance(context: {
+        errorPattern: string;
+        occurrences: number;
+        recentHistory: Message[];
+        helperModelId?: string;
+    }): Promise<string>;
+    /**
+     * Generate interleaved thinking assistance (Phase 2)
+     * Provides reasoning guidance for non-reasoning models
+     */
+    generateInterleavedThinking(context: {
+        userMessage: string;
+        recentHistory: Message[];
+        helperModelId?: string;
+    }): Promise<string>;
+    /**
+     * Generate interleaved continuation thinking (between tool iterations)
+     * Short, subtle inner monologue — not a full structured analysis.
+     * Reflects on what just happened and suggests next step.
+     */
+    generateInterleavedContinuationThinking(context: {
+        userMessage: string;
+        toolResults: Array<{
+            toolName: string;
+            isError: boolean;
+            summary: string;
+        }>;
+        iterationNumber: number;
+        recentHistory: Message[];
+        helperModelId?: string;
+    }): Promise<string>;
+    /**
+     * Generate Active Discovery guidance (Phase 2)
+     * Encourages thorough file reading and evidence-based analysis
+     * Works for ALL models (reasoning and non-reasoning)
+     */
+    generateActiveDiscoveryGuidance(context: {
+        userMessage: string;
+        recentHistory: Message[];
+        filesRead: string[];
+        helperModelId?: string;
+    }): Promise<string>;
+}
+//# sourceMappingURL=HelperModelMiddleware.d.ts.map

package/dist/middleware/HelperModelMiddleware.d.ts.map

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