@nexus-cortex/core 4.26.0

package/dist/conversation/ContextBudgetManager.js

@@ -0,0 +1,445 @@
+/**
+ * Context Budget Manager
+ *
+ * Manages dynamic context window budgeting for different model sizes.
+ * Replaces hardcoded 155K threshold with model-specific calculations.
+ *
+ * Phase 1.5: Week 3 Implementation
+ * Based on: CORTEX_V4_PHASE_1.5_ARCHITECTURE.md, Part 5
+ */
+import { isSystemMessage, isToolUseMessage, isToolResultMessage } from '../session/MessageTypes.js';
+import { TokenCounter } from '../utils/TokenCounter.js';
+/**
+ * Manages context window budgets across different models
+ */
+export class ContextBudgetManager {
+    static DEFAULT_TOOL_TOKENS = 2000;
+    static DEFAULT_SYSTEM_TOKENS = 1000;
+    static MIN_RECENT_MESSAGES = 5;
+    // Reserved for future use
+    // private static readonly TOKENS_PER_MESSAGE_ESTIMATE = 100;
+    // Optional model config for accurate token counting
+    modelConfig;
+    /**
+     * Calculate context budget for a given model
+     *
+     * @param modelConfig - Model configuration
+     * @param overrides - Optional overrides for actual token counts when available.
+     *   - actualToolTokens: Real token count from serialized tool schemas.
+     *     Tool definitions are NOT in messageHistory — they're passed separately to the API,
+     *     so we must reserve space for them. Default estimate (30/tool, cap 2000) is wildly
+     *     low for 29 tools with detailed schemas (~8-10K actual).
+     *   - actualSystemTokens: Explicit system message tokens. In this architecture, system
+     *     messages are embedded as <system-reminder> tags in user message content and are
+     *     already counted by estimateTotalTokens(messageHistory). Set to 0 to avoid
+     *     double-counting. Defaults to DEFAULT_SYSTEM_TOKENS for backwards compatibility.
+     */
+    calculateBudget(modelConfig, overrides) {
+        const total = modelConfig.limits.contextWindow;
+        const outputReserve = Math.min(modelConfig.limits.outputTokens, total * 0.5);
+        // For very small contexts, reduce reserves proportionally
+        const scaleFactor = total < 5000 ? (total / 5000) : 1.0;
+        // Use actual tool token count when available, fall back to estimate
+        const rawToolsReserve = overrides?.actualToolTokens !== undefined
+            ? overrides.actualToolTokens
+            : this.estimateToolTokens(modelConfig);
+        const toolsReserve = Math.floor(rawToolsReserve * scaleFactor);
+        // System messages are embedded in user message content (counted in history estimate).
+        // When caller passes actualSystemTokens: 0, we avoid double-counting.
+        const rawSystemReserve = overrides?.actualSystemTokens !== undefined
+            ? overrides.actualSystemTokens
+            : ContextBudgetManager.DEFAULT_SYSTEM_TOKENS;
+        const systemReserve = Math.floor(rawSystemReserve * scaleFactor);
+        const availableForHistory = Math.max(100, // Always reserve at least 100 tokens for history
+        total - outputReserve - toolsReserve - systemReserve);
+        return {
+            totalAvailable: total,
+            reservedForOutput: outputReserve,
+            reservedForTools: toolsReserve,
+            reservedForSystem: systemReserve,
+            availableForHistory,
+            metadata: {
+                modelId: modelConfig.id,
+                provider: modelConfig.provider,
+                calculatedAt: new Date().toISOString(),
+                strategy: modelConfig.compaction.thresholdCalculation.method
+            }
+        };
+    }
+    /**
+     * Select messages that fit within the budget
+     *
+     * @param messages - Messages to select from
+     * @param budget - Token budget
+     * @param options - Selection options
+     * @param modelConfig - Optional model config for accurate token counting
+     */
+    selectMessages(messages, budget, options = { strategy: 'sliding-window' }, modelConfig) {
+        // Store modelConfig for use in private methods
+        this.modelConfig = modelConfig;
+        try {
+            switch (options.strategy) {
+                case 'sliding-window':
+                    return this.selectSlidingWindow(messages, budget, options);
+                case 'preserve-critical':
+                    return this.selectPreserveCritical(messages, budget, options);
+                case 'compact-and-fit':
+                    return this.selectCompactAndFit(messages, budget, options);
+                default:
+                    return this.selectSlidingWindow(messages, budget, options);
+            }
+        }
+        finally {
+            // Clean up modelConfig reference
+            this.modelConfig = undefined;
+        }
+    }
+    /**
+     * Validate if model switch is possible with current history
+     */
+    validateModelSwitch(currentHistory, newModel) {
+        const currentTokens = this.estimateTotalTokens(currentHistory);
+        const newBudget = this.calculateBudget(newModel);
+        if (currentTokens <= newBudget.availableForHistory) {
+            return {
+                canSwitch: true,
+                currentTokens,
+                availableTokens: newBudget.availableForHistory
+            };
+        }
+        // Check if sliding window would work (try without min for better fit)
+        const recentMessages = this.selectSlidingWindow(currentHistory, newBudget.availableForHistory, { strategy: 'sliding-window' });
+        const recentTokens = this.estimateTotalTokens(recentMessages);
+        if (recentTokens <= newBudget.availableForHistory && recentMessages.length > 0) {
+            return {
+                canSwitch: true,
+                reason: 'Requires sliding window strategy',
+                currentTokens,
+                availableTokens: newBudget.availableForHistory,
+                suggestedStrategy: 'sliding-window',
+                estimatedTokensAfterStrategy: recentTokens
+            };
+        }
+        // Check if preserving critical would work
+        const criticalMessages = this.selectPreserveCritical(currentHistory, newBudget.availableForHistory, { strategy: 'preserve-critical' });
+        const criticalTokens = this.estimateTotalTokens(criticalMessages);
+        // Only allow if we have meaningful content (at least 5 messages)
+        if (criticalTokens <= newBudget.availableForHistory && criticalMessages.length >= 5) {
+            return {
+                canSwitch: true,
+                reason: 'Requires preserving only critical messages',
+                currentTokens,
+                availableTokens: newBudget.availableForHistory,
+                suggestedStrategy: 'preserve-critical',
+                estimatedTokensAfterStrategy: criticalTokens
+            };
+        }
+        // Would require compaction
+        return {
+            canSwitch: false,
+            reason: `History too large (${currentTokens} tokens) for new model (${newBudget.availableForHistory} available). Requires compaction.`,
+            currentTokens,
+            availableTokens: newBudget.availableForHistory,
+            suggestedStrategy: 'compact-and-fit'
+        };
+    }
+    /**
+     * Calculate dynamic compaction threshold for a model
+     */
+    getCompactionThreshold(modelConfig, overrides) {
+        const { thresholdCalculation } = modelConfig.compaction;
+        const budget = this.calculateBudget(modelConfig, overrides);
+        if (thresholdCalculation.method === 'percentage') {
+            // Clamp percentage between 0 and 1
+            let percentage = thresholdCalculation.percentage || 0.75;
+            percentage = Math.min(1.0, Math.max(0.0, percentage));
+            return Math.floor(budget.availableForHistory * percentage);
+        }
+        else {
+            // Absolute method
+            return Math.min(thresholdCalculation.absolute || 155000, budget.availableForHistory - thresholdCalculation.safetyMargin);
+        }
+    }
+    /**
+     * Check if compaction is needed
+     */
+    shouldCompact(currentTokens, modelConfig) {
+        if (modelConfig.compaction.strategy === 'off') {
+            return false;
+        }
+        const threshold = this.getCompactionThreshold(modelConfig);
+        return currentTokens >= threshold;
+    }
+    // Thinking block stripping was removed entirely — it mutates messageHistory,
+    // breaks prompt-cache prefix continuity across all providers, and causes model
+    // confusion. Context overflow is handled by compaction (helper-model summarization
+    // or sliding-window message removal), which drops whole messages.
+    // ============================================
+    // PRIVATE METHODS
+    // ============================================
+    /**
+     * Estimate tokens needed for tool definitions
+     */
+    estimateToolTokens(modelConfig) {
+        if (!modelConfig.tools.supported) {
+            return 0;
+        }
+        // More reasonable estimate: average of 30 tokens per tool, cap at reasonable max
+        const avgToolDefinitionTokens = 30;
+        const estimatedTokens = Math.min(modelConfig.tools.maxTools * avgToolDefinitionTokens, ContextBudgetManager.DEFAULT_TOOL_TOKENS);
+        // Never use more than 25% of context for tools
+        const maxToolTokens = Math.floor(modelConfig.limits.contextWindow * 0.25);
+        return Math.min(estimatedTokens, maxToolTokens);
+    }
+    /**
+     * Sliding window selection - keep most recent messages
+     */
+    selectSlidingWindow(messages, budget, options) {
+        if (budget <= 0) {
+            return [];
+        }
+        // R34: Group messages into atomic units. An assistant message with
+        // tool_use blocks and its consecutive tool_result user messages form
+        // one indivisible group — removing the assistant but keeping its tool
+        // results produces a structurally invalid conversation for chat/completions.
+        const groups = this.groupToolPairs(messages);
+        const minRecent = options.minRecentMessages || ContextBudgetManager.MIN_RECENT_MESSAGES;
+        const result = [];
+        let totalTokens = 0;
+        let msgCount = 0;
+        for (let g = groups.length - 1; g >= 0; g--) {
+            const group = groups[g];
+            let groupTokens = 0;
+            for (const msg of group) {
+                groupTokens += this.estimateMessageTokens(msg);
+            }
+            if (totalTokens + groupTokens <= budget || msgCount < minRecent) {
+                result.unshift(...group);
+                totalTokens += groupTokens;
+                msgCount += group.length;
+            }
+            else {
+                break;
+            }
+        }
+        // Safety net: strip any remaining orphaned tool_results at the front
+        // (can happen if minRecent forced inclusion of a partial group).
+        return this.stripLeadingOrphanedToolResults(result);
+    }
+    groupToolPairs(messages) {
+        const groups = [];
+        let i = 0;
+        while (i < messages.length) {
+            const msg = messages[i];
+            const content = msg.message?.content ?? msg.content;
+            const hasToolUse = Array.isArray(content) &&
+                content.some((b) => b && b.type === 'tool_use');
+            if (hasToolUse) {
+                const group = [msg];
+                let j = i + 1;
+                while (j < messages.length) {
+                    const next = messages[j];
+                    const nc = next.message?.content ?? next.content;
+                    const isToolResult = Array.isArray(nc) && nc.length > 0 &&
+                        nc.every((b) => b && b.type === 'tool_result');
+                    if (!isToolResult)
+                        break;
+                    group.push(next);
+                    j++;
+                }
+                groups.push(group);
+                i = j;
+            }
+            else {
+                groups.push([msg]);
+                i++;
+            }
+        }
+        return groups;
+    }
+    stripLeadingOrphanedToolResults(messages) {
+        let start = 0;
+        while (start < messages.length) {
+            const msg = messages[start];
+            const content = msg.message?.content ?? msg.content;
+            if (!Array.isArray(content))
+                break;
+            const isToolResult = content.length > 0 && content.every((b) => b && b.type === 'tool_result');
+            if (!isToolResult)
+                break;
+            start++;
+        }
+        return start === 0 ? messages : messages.slice(start);
+    }
+    /**
+     * Preserve critical messages + recent
+     */
+    selectPreserveCritical(messages, budget, options) {
+        const critical = this.identifyCriticalMessages(messages);
+        const criticalTokens = this.estimateTotalTokens(critical);
+        // If no critical messages, fall back to sliding window
+        if (critical.length === 0) {
+            return this.selectSlidingWindow(messages, budget, options);
+        }
+        if (criticalTokens >= budget) {
+            // Even critical messages exceed budget, take most recent critical
+            return this.selectSlidingWindow(critical, budget, options);
+        }
+        // Add recent messages to critical
+        const remainingBudget = budget - criticalTokens;
+        const nonCritical = messages.filter(m => !critical.includes(m));
+        const recentNonCritical = this.selectSlidingWindow(nonCritical, remainingBudget, options);
+        // Merge and sort by timestamp
+        return [...critical, ...recentNonCritical].sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+    }
+    /**
+     * Compact older messages and keep recent
+     *
+     * Strategy:
+     * 1. Keep most recent messages within budget (last ~20% of budget)
+     * 2. Identify older messages that need compaction
+     * 3. Return messages flagged for compaction (caller will trigger compaction)
+     *
+     * Note: This returns what WOULD be selected if compaction were applied.
+     * Actual compaction is triggered by CompactionManager when shouldCompact() is true.
+     */
+    selectCompactAndFit(messages, budget, options) {
+        if (budget <= 0 || messages.length === 0) {
+            return [];
+        }
+        // Reserve last 20% of budget for recent messages
+        const recentBudget = Math.floor(budget * 0.2);
+        const compactedBudget = budget - recentBudget;
+        // Get recent messages using sliding window
+        const recentMessages = this.selectSlidingWindow(messages, recentBudget, options);
+        // Find where recent messages start
+        const firstRecentMsg = recentMessages[0] ?? messages[messages.length - 1];
+        const firstRecentIndex = firstRecentMsg ? messages.indexOf(firstRecentMsg) : messages.length;
+        // Older messages (before recent) are candidates for compaction
+        const olderMessages = messages.slice(0, firstRecentIndex);
+        if (olderMessages.length === 0) {
+            // No old messages to compact, just return recent
+            return recentMessages;
+        }
+        // Calculate tokens in older messages
+        const olderTokens = this.estimateTotalTokens(olderMessages);
+        // If older messages fit in compacted budget, keep them
+        if (olderTokens <= compactedBudget) {
+            return messages; // Everything fits
+        }
+        // Mark that compaction is needed by including critical older messages
+        // Preserve critical messages from older section
+        const criticalOlder = this.identifyCriticalMessages(olderMessages);
+        // Combine critical older + recent messages
+        const result = [...criticalOlder, ...recentMessages].sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+        // Note: Compaction recommendation is signaled by returning fewer messages than requested
+        // Caller can detect this and trigger StoredCompaction
+        // Future enhancement: Add compactionRecommended flag to timeline metadata
+        return result;
+    }
+    /**
+     * Identify critical messages that should be preserved
+     */
+    identifyCriticalMessages(messages) {
+        const critical = [];
+        for (let i = 0; i < messages.length; i++) {
+            const message = messages[i];
+            if (!message)
+                continue;
+            // Tool use messages and their results must stay together
+            if (isToolUseMessage(message)) {
+                critical.push(message);
+                // Find corresponding tool result
+                const nextMessage = messages[i + 1];
+                if (nextMessage && isToolResultMessage(nextMessage)) {
+                    critical.push(nextMessage);
+                }
+            }
+            // System messages with important context
+            if (isSystemMessage(message)) {
+                // Check for checkpoint, compaction boundary, or file snapshot
+                if (message.content && (message.content.includes('checkpoint') ||
+                    message.content.includes('compact_boundary') ||
+                    message.content.includes('file-history-snapshot'))) {
+                    critical.push(message);
+                }
+            }
+            // Note: Future enhancement could add preserve flag to timeline metadata
+            // For now, we preserve based on message type and content
+        }
+        return critical;
+    }
+    /**
+     * Estimate token count for messages
+     */
+    estimateTotalTokens(messages) {
+        return messages.reduce((sum, msg) => sum + this.estimateMessageTokens(msg), 0);
+    }
+    /**
+     * R4 (parallel-bench): per-message token memo. estimateTotalTokens runs
+     * once per tool iteration; without this the tokenizer fires
+     * history-length × iteration-count times per turn. Messages are
+     * uuid-keyed and append-only (immutable once persisted), so a
+     * modelId+uuid key is sound. Messages without a uuid pass through
+     * uncached. Keyed by modelId because different models tokenize
+     * differently.
+     */
+    msgTokenCache = new Map();
+    /**
+     * Estimate tokens for a single message (memoized — see msgTokenCache).
+     */
+    estimateMessageTokens(message) {
+        const uuid = message.uuid;
+        const cacheable = typeof uuid === 'string' && uuid.length > 0;
+        const key = cacheable ? `${this.modelConfig?.id ?? ''}:${uuid}` : '';
+        if (cacheable) {
+            const hit = this.msgTokenCache.get(key);
+            if (hit !== undefined)
+                return hit;
+        }
+        const tokens = this.computeMessageTokens(message);
+        if (cacheable)
+            this.msgTokenCache.set(key, tokens);
+        return tokens;
+    }
+    /**
+     * Compute tokens for a single message (uncached).
+     * Uses TokenCounter when modelConfig is available, falls back to estimation
+     */
+    computeMessageTokens(message) {
+        // If we have modelConfig, use accurate tokenizer
+        if (this.modelConfig) {
+            try {
+                return TokenCounter.count(message, this.modelConfig).tokens;
+            }
+            catch (error) {
+                // Fall back to estimation if tokenizer fails
+                console.warn('TokenCounter failed, falling back to estimation:', error);
+            }
+        }
+        // Fallback: Simple estimation (~4 characters per token)
+        let charCount = 0;
+        // System messages have direct content
+        if (isSystemMessage(message)) {
+            charCount += message.content.length;
+        }
+        // Other message types have message.content
+        else if ('message' in message && message.message.content) {
+            if (typeof message.message.content === 'string') {
+                charCount += message.message.content.length;
+            }
+            else {
+                // Content is an array of blocks
+                charCount += JSON.stringify(message.message.content).length;
+            }
+        }
+        // Add overhead for message structure (uuid, timestamp, type)
+        charCount += JSON.stringify({
+            type: message.type,
+            timestamp: message.timestamp,
+            uuid: message.uuid
+        }).length;
+        return Math.ceil(charCount / 4);
+    }
+}
+//# sourceMappingURL=ContextBudgetManager.js.map

package/dist/conversation/ContextBudgetManager.js.map

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

package/dist/conversation/StoredCompactionManager.d.ts

@@ -0,0 +1,208 @@
+/**
+ * Stored Compaction System
+ *
+ * Manages persistent storage of compaction records with timeline integration.
+ * Stores multi-level summaries and tracks helper model usage.
+ *
+ * Phase 1.5: Week 3 Implementation
+ * Based on: CORTEX_V4_PHASE_1.5_ARCHITECTURE.md, Part 6.3
+ */
+import type { Message } from '../session/MessageTypes.js';
+/**
+ * Compaction semantic metadata for search and retrieval
+ * (Renamed from CompactionMetadata to avoid collision with MessageTypes.CompactionMetadata)
+ */
+export interface CompactionSemanticMetadata {
+    /** Main topics discussed */
+    topics: string[];
+    /** Key decisions made */
+    decisions: string[];
+    /** Tools that were used */
+    toolsUsed: string[];
+    /** Files that were modified */
+    filesModified: string[];
+    /** Models involved in the conversation */
+    modelsInvolved: string[];
+    /** Key moments in the conversation */
+    keyMoments: Array<{
+        turn: number;
+        description: string;
+        importance: 'high' | 'medium' | 'low';
+    }>;
+}
+/**
+ * Multi-level summaries for different use cases
+ */
+export interface CompactionSummaries {
+    /** Very brief summary (100-200 tokens) for in-context use */
+    compressed: string;
+    /** Standard summary (500-1000 tokens) for retrieval */
+    standard: string;
+    /** Detailed summary (2000-3000 tokens) for on-demand access */
+    detailed: string;
+    /** Structured metadata for semantic search */
+    metadata: CompactionSemanticMetadata;
+}
+/**
+ * Timeline integration fields
+ */
+export interface TimelineReference {
+    /** Session ID this compaction belongs to */
+    sessionId: string;
+    /** Conversation ID within the session */
+    conversationId: string;
+    /** Timeline event ID that triggered this compaction */
+    eventId: string;
+    /** Range of turns that were compacted */
+    turnRange: {
+        start: number;
+        end: number;
+    };
+    /** Message ID that triggered compaction (if any) */
+    triggeredByMessageId?: string;
+}
+/**
+ * Compaction processing details
+ */
+export interface CompactionProcessing {
+    /** Helper model used for compaction */
+    helperModelId: string;
+    /** Provider of the helper model */
+    helperProvider: string;
+    /** Processing time in milliseconds */
+    processingTime: number;
+    /** Estimated cost in dollars */
+    cost: number;
+    /** Token usage */
+    tokens: {
+        input: number;
+        output: number;
+    };
+}
+/**
+ * Complete stored compaction record
+ */
+export interface StoredCompaction {
+    id: string;
+    type: 'auto' | 'manual' | 'helper-fallback';
+    timestamp: string;
+    timeline: TimelineReference;
+    compaction: {
+        originalTokens: number;
+        compressedTokens: number;
+        messageCount: number;
+        compressionRatio: number;
+    };
+    processing: CompactionProcessing;
+    summaries: CompactionSummaries;
+    originalMessagesRef: string;
+    status: 'active' | 'superseded' | 'archived';
+    version: number;
+}
+/**
+ * Options for creating a stored compaction
+ */
+export interface CreateCompactionOptions {
+    type: 'auto' | 'manual' | 'helper-fallback';
+    timeline: TimelineReference;
+    originalMessages: Message[];
+    summaries: CompactionSummaries;
+    processing: CompactionProcessing;
+}
+/**
+ * Options for querying stored compactions
+ */
+export interface CompactionQuery {
+    sessionId?: string;
+    conversationId?: string;
+    status?: 'active' | 'superseded' | 'archived';
+    type?: 'auto' | 'manual' | 'helper-fallback';
+    fromTimestamp?: string;
+    toTimestamp?: string;
+    limit?: number;
+}
+/**
+ * Manages storage and retrieval of compaction records
+ */
+export declare class StoredCompactionManager {
+    private static readonly COMPACTIONS_DIR;
+    private static readonly CURRENT_VERSION;
+    private baseDir;
+    constructor(workspaceRoot?: string);
+    /**
+     * Initialize storage directory structure
+     */
+    initialize(): Promise<void>;
+    /**
+     * Create and store a new compaction record
+     */
+    createCompaction(options: CreateCompactionOptions): Promise<StoredCompaction>;
+    /**
+     * Retrieve a compaction by ID
+     */
+    getCompaction(id: string): Promise<StoredCompaction | null>;
+    /**
+     * Query compactions based on criteria
+     */
+    queryCompactions(query: CompactionQuery): Promise<StoredCompaction[]>;
+    /**
+     * Get all compaction boundaries for a session
+     */
+    getCompactionBoundaries(sessionId: string): Promise<Array<{
+        id: string;
+        timestamp: string;
+        turnRange: {
+            start: number;
+            end: number;
+        };
+    }>>;
+    /**
+     * Update compaction status
+     */
+    updateStatus(id: string, status: 'active' | 'superseded' | 'archived'): Promise<void>;
+    /**
+     * Get original messages for a compaction
+     */
+    getOriginalMessages(compactionId: string): Promise<Message[]>;
+    /**
+     * Search compactions by content
+     */
+    searchCompactions(query: string, sessionId?: string): Promise<StoredCompaction[]>;
+    /**
+     * Get file path for a compaction
+     */
+    private getCompactionFilePath;
+    /**
+     * Store a compaction record
+     */
+    private storeCompaction;
+    /**
+     * Store original messages
+     */
+    private storeOriginalMessages;
+    /**
+     * Load session index
+     */
+    private loadSessionIndex;
+    /**
+     * Update session index
+     */
+    private updateSessionIndex;
+    /**
+     * Get all session IDs from index
+     */
+    private getAllSessionIds;
+    /**
+     * Check if compaction matches query
+     */
+    private matchesQuery;
+    /**
+     * Calculate token count for messages
+     */
+    private calculateTokens;
+    /**
+     * Estimate compressed token count
+     */
+    private estimateCompressedTokens;
+}
+//# sourceMappingURL=StoredCompactionManager.d.ts.map