@nexus-cortex/core 4.26.0

package/dist/middleware/contracts/MiddlewareContracts.js

@@ -0,0 +1,12 @@
+/**
+ * Middleware Interface Contracts
+ *
+ * These interfaces define the contracts that all middleware components must implement.
+ * They are locked in on Day 1 of the parallel refactor and should NOT be changed
+ * after Wave 1 begins.
+ *
+ * @version 1.0.0
+ * @locked 2025-11-12
+ */
+export {};
+//# sourceMappingURL=MiddlewareContracts.js.map

package/dist/middleware/contracts/MiddlewareContracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MiddlewareContracts.js","sourceRoot":"","sources":["../../../src/middleware/contracts/MiddlewareContracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/middleware/helpers/HelperMiddlewareAdapter.interface.d.ts

@@ -0,0 +1,211 @@
+/**
+ * Helper Middleware Adapter Interface
+ * Phase 1.5: Week 2 - API Pattern-Based Helper System
+ *
+ * Independent helper middleware architecture that operates separately
+ * from the main adapter system. Each helper adapter is self-contained
+ * and handles its own API pattern communication.
+ */
+import type { ModelConfig } from '../../models/ModelConfig.interface.js';
+/**
+ * Canonical message format (lightweight subset for helpers)
+ * Helpers don't need full timeline/session metadata
+ */
+export interface HelperCanonicalMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string | Array<{
+        type: 'text' | 'tool_use' | 'tool_result';
+        text?: string;
+        toolUse?: any;
+        toolResult?: any;
+    }>;
+    timestamp?: string;
+}
+/**
+ * Compaction result from helper model
+ */
+export interface CompactionResult {
+    /** Summary/compacted content */
+    summary: string;
+    /** Compacted messages in canonical format */
+    compactedMessages: HelperCanonicalMessage[];
+    /** Original token count */
+    originalTokens: number;
+    /** Compressed token count */
+    compressedTokens: number;
+    /** Tokens saved */
+    tokensSaved: number;
+    /** Helper model used */
+    helperModelId: string;
+    /** Processing time in milliseconds */
+    processingTime: number;
+    /** Cost of helper model call */
+    cost: number;
+}
+/**
+ * Tool result summarization result
+ */
+export interface ToolSummaryResult {
+    /** Summarized content */
+    summary: string;
+    /** Original token count */
+    originalTokens: number;
+    /** Summary token count */
+    summaryTokens: number;
+    /** Tokens saved */
+    tokensSaved: number;
+    /** Helper model used */
+    helperModelId: string;
+    /** Processing time in milliseconds */
+    processingTime: number;
+    /** Cost of helper model call */
+    cost: number;
+}
+/**
+ * Base interface for all helper middleware adapters
+ *
+ * Each adapter is self-contained and handles communication with
+ * helper models using a specific API pattern (e.g., Messages API,
+ * Chat Completions API, etc.)
+ *
+ * IMPORTANT: This system is INDEPENDENT from the main adapter system.
+ * Helper adapters do not depend on or share code with main adapters.
+ */
+export interface HelperMiddlewareAdapter {
+    /** API pattern this adapter handles (e.g., 'messages', 'chat/completions') */
+    readonly apiPattern: string;
+    /** Human-readable name for this adapter */
+    readonly name: string;
+    /**
+     * Compact conversation history via helper model
+     *
+     * Takes a conversation history and compacts it to fit within a target
+     * token budget using the configured helper model.
+     *
+     * @param messages - Messages in canonical format to compact
+     * @param helperConfig - Helper model configuration (user-selected)
+     * @param targetTokens - Target token count after compaction
+     * @returns Compaction result with summary and metrics
+     */
+    compact(messages: HelperCanonicalMessage[], helperConfig: ModelConfig, targetTokens: number): Promise<CompactionResult>;
+    /**
+     * Summarize large tool result via helper model
+     *
+     * Takes a large tool result and summarizes it to fit within a maximum
+     * token budget using the configured helper model.
+     *
+     * @param toolResult - Tool result content to summarize
+     * @param helperConfig - Helper model configuration (user-selected)
+     * @param maxTokens - Maximum tokens for summary
+     * @returns Summary result with metrics
+     */
+    summarizeToolResult(toolResult: string, helperConfig: ModelConfig, maxTokens: number): Promise<ToolSummaryResult>;
+    /**
+     * Send messages directly to the helper model and return raw text.
+     * Unlike compact(), this does NOT wrap messages with a compaction prompt.
+     * Use for lightweight generation tasks (titles, summaries, predictions).
+     */
+    generate(messages: HelperCanonicalMessage[], helperConfig: ModelConfig, maxTokens: number): Promise<string>;
+    /**
+     * Check if this adapter supports a given model config
+     *
+     * @param modelConfig - Model configuration to check
+     * @returns True if this adapter can handle the model's API pattern
+     */
+    supportsModel(modelConfig: ModelConfig): boolean;
+    /**
+     * Estimate token count for content
+     *
+     * Provides rough token estimation for the helper model.
+     * Uses simple heuristic (chars / 4) unless overridden.
+     *
+     * @param content - Content to estimate tokens for
+     * @returns Estimated token count
+     */
+    estimateTokens(content: string): number;
+}
+/**
+ * Abstract base class for helper adapters
+ * Provides common functionality that all adapters can use
+ */
+export declare abstract class BaseHelperAdapter implements HelperMiddlewareAdapter {
+    abstract readonly apiPattern: string;
+    abstract readonly name: string;
+    abstract compact(messages: HelperCanonicalMessage[], helperConfig: ModelConfig, targetTokens: number): Promise<CompactionResult>;
+    abstract summarizeToolResult(toolResult: string, helperConfig: ModelConfig, maxTokens: number): Promise<ToolSummaryResult>;
+    generate(messages: HelperCanonicalMessage[], helperConfig: ModelConfig, maxTokens: number): Promise<string>;
+    supportsModel(modelConfig: ModelConfig): boolean;
+    estimateTokens(content: string): number;
+    /**
+     * Calculate cost for helper model call
+     *
+     * @param inputTokens - Input tokens used
+     * @param outputTokens - Output tokens generated
+     * @param modelConfig - Model configuration with pricing
+     * @returns Cost in dollars
+     */
+    protected calculateCost(inputTokens: number, outputTokens: number, _modelConfig: ModelConfig): number;
+    /**
+     * Extract text content from messages
+     *
+     * @param messages - Messages to extract from
+     * @returns Concatenated text content
+     */
+    protected extractTextContent(messages: HelperCanonicalMessage[]): string;
+    /**
+     * Create compaction prompt for helper model
+     *
+     * @param messages - Messages to compact
+     * @param targetTokens - Target token count
+     * @returns Prompt text for compaction
+     */
+    protected createCompactionPrompt(messages: HelperCanonicalMessage[], targetTokens: number): string;
+    /**
+     * Create tool result summarization prompt
+     *
+     * @param toolResult - Tool result to summarize
+     * @param maxTokens - Maximum tokens for summary
+     * @returns Prompt text for summarization
+     */
+    protected createToolSummaryPrompt(toolResult: string, maxTokens: number): string;
+    /**
+     * Calculate safe input limit for a model
+     *
+     * Dynamically calculates how much content can be safely sent to the helper model
+     * based on its context window, reserving space for prompts and outputs.
+     *
+     * @param helperConfig - Helper model configuration
+     * @param targetOutputTokens - Expected output size
+     * @returns Safe input token limit
+     */
+    protected calculateSafeInputLimit(helperConfig: ModelConfig, targetOutputTokens: number): number;
+    /**
+     * Check if content needs chunking
+     *
+     * @param content - Content to check
+     * @param helperConfig - Helper model configuration
+     * @param targetOutputTokens - Expected output size
+     * @returns True if content exceeds safe input limit
+     */
+    protected needsChunking(content: string, helperConfig: ModelConfig, targetOutputTokens: number): boolean;
+    /**
+     * Split content into chunks based on model's context limit
+     *
+     * Dynamically adjusts chunk size based on the helper model's capabilities.
+     * Attempts to split on natural boundaries (paragraphs, sentences).
+     *
+     * @param content - Content to chunk
+     * @param helperConfig - Helper model configuration
+     * @param targetOutputTokens - Expected output per chunk
+     * @returns Array of content chunks
+     */
+    protected chunkContent(content: string, helperConfig: ModelConfig, targetOutputTokens: number): string[];
+    /**
+     * Get model-specific context information for logging
+     *
+     * @param helperConfig - Helper model configuration
+     * @returns Context info string
+     */
+    protected getContextInfo(helperConfig: ModelConfig): string;
+}
+//# sourceMappingURL=HelperMiddlewareAdapter.interface.d.ts.map

package/dist/middleware/helpers/HelperMiddlewareAdapter.interface.d.ts.map

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

package/dist/middleware/helpers/HelperMiddlewareAdapter.interface.js

@@ -0,0 +1,211 @@
+/**
+ * Helper Middleware Adapter Interface
+ * Phase 1.5: Week 2 - API Pattern-Based Helper System
+ *
+ * Independent helper middleware architecture that operates separately
+ * from the main adapter system. Each helper adapter is self-contained
+ * and handles its own API pattern communication.
+ */
+/**
+ * Abstract base class for helper adapters
+ * Provides common functionality that all adapters can use
+ */
+export class BaseHelperAdapter {
+    async generate(messages, helperConfig, maxTokens) {
+        const result = await this.compact(messages, helperConfig, maxTokens);
+        return result.summary;
+    }
+    supportsModel(modelConfig) {
+        return modelConfig.api.pattern === this.apiPattern;
+    }
+    estimateTokens(content) {
+        // Simple estimation: ~4 characters per token
+        return Math.ceil(content.length / 4);
+    }
+    /**
+     * Calculate cost for helper model call
+     *
+     * @param inputTokens - Input tokens used
+     * @param outputTokens - Output tokens generated
+     * @param modelConfig - Model configuration with pricing
+     * @returns Cost in dollars
+     */
+    calculateCost(inputTokens, outputTokens, _modelConfig) {
+        // Most helper models charge per 1M tokens
+        // Default rates (can be overridden per model in config)
+        const inputCostPer1M = 0.50; // $0.50 per 1M tokens (typical helper rate)
+        const outputCostPer1M = 1.50; // $1.50 per 1M tokens (typical helper rate)
+        const inputCost = (inputTokens / 1_000_000) * inputCostPer1M;
+        const outputCost = (outputTokens / 1_000_000) * outputCostPer1M;
+        return inputCost + outputCost;
+    }
+    /**
+     * Extract text content from messages
+     *
+     * @param messages - Messages to extract from
+     * @returns Concatenated text content
+     */
+    extractTextContent(messages) {
+        return messages
+            .map(msg => {
+            if (typeof msg.content === 'string') {
+                return msg.content;
+            }
+            return msg.content
+                .filter(block => block.type === 'text')
+                .map(block => block.text || '')
+                .join('\n');
+        })
+            .join('\n\n');
+    }
+    /**
+     * Create compaction prompt for helper model
+     *
+     * @param messages - Messages to compact
+     * @param targetTokens - Target token count
+     * @returns Prompt text for compaction
+     */
+    createCompactionPrompt(messages, targetTokens) {
+        const conversationText = this.extractTextContent(messages);
+        return `Summarize this conversation in ~${targetTokens} tokens. Structure your summary using these categories (skip empty ones):
+
+1. PRIMARY REQUEST: What the user is trying to accomplish and why.
+2. KEY TECHNICAL CONCEPTS: Important terms, patterns, or architectural decisions established.
+3. FILES AND CODE: Specific files read/modified, with key code sections or changes.
+4. ERRORS AND FIXES: Problems encountered and how they were resolved.
+5. DECISIONS MADE: Implementation choices, trade-offs accepted, approaches rejected.
+6. ALL USER MESSAGES: Preserve the user's exact instructions and preferences — never paraphrase away constraints.
+7. CURRENT STATE: What was just completed, what's in progress.
+8. PENDING WORK: Tasks remaining, blockers, next steps.
+
+CONVERSATION HISTORY:
+${conversationText}
+
+Preserve code snippets, file paths, and technical details verbatim. Target ~${targetTokens} tokens.
+
+SUMMARY:`;
+    }
+    /**
+     * Create tool result summarization prompt
+     *
+     * @param toolResult - Tool result to summarize
+     * @param maxTokens - Maximum tokens for summary
+     * @returns Prompt text for summarization
+     */
+    createToolSummaryPrompt(toolResult, maxTokens) {
+        return `Please summarize the following tool result in approximately ${maxTokens} tokens while preserving essential information:
+
+TOOL RESULT:
+${toolResult}
+
+INSTRUCTIONS:
+- Extract key information and findings
+- Preserve error messages if present
+- Include relevant data points
+- Omit verbose logs and redundant details
+- Target length: ~${maxTokens} tokens
+
+SUMMARY:`;
+    }
+    /**
+     * Calculate safe input limit for a model
+     *
+     * Dynamically calculates how much content can be safely sent to the helper model
+     * based on its context window, reserving space for prompts and outputs.
+     *
+     * @param helperConfig - Helper model configuration
+     * @param targetOutputTokens - Expected output size
+     * @returns Safe input token limit
+     */
+    calculateSafeInputLimit(helperConfig, targetOutputTokens) {
+        const contextWindow = helperConfig.limits?.contextWindow || 16000; // Default to smallest (GPT-3.5)
+        // Reserve space for:
+        // - Target output tokens
+        // - System prompt and instructions (~500 tokens)
+        // - Safety margin (10% of context)
+        const safetyMargin = Math.floor(contextWindow * 0.1);
+        const promptOverhead = 500;
+        return contextWindow - targetOutputTokens - promptOverhead - safetyMargin;
+    }
+    /**
+     * Check if content needs chunking
+     *
+     * @param content - Content to check
+     * @param helperConfig - Helper model configuration
+     * @param targetOutputTokens - Expected output size
+     * @returns True if content exceeds safe input limit
+     */
+    needsChunking(content, helperConfig, targetOutputTokens) {
+        const contentTokens = this.estimateTokens(content);
+        const safeLimit = this.calculateSafeInputLimit(helperConfig, targetOutputTokens);
+        return contentTokens > safeLimit;
+    }
+    /**
+     * Split content into chunks based on model's context limit
+     *
+     * Dynamically adjusts chunk size based on the helper model's capabilities.
+     * Attempts to split on natural boundaries (paragraphs, sentences).
+     *
+     * @param content - Content to chunk
+     * @param helperConfig - Helper model configuration
+     * @param targetOutputTokens - Expected output per chunk
+     * @returns Array of content chunks
+     */
+    chunkContent(content, helperConfig, targetOutputTokens) {
+        const safeLimit = this.calculateSafeInputLimit(helperConfig, targetOutputTokens);
+        const targetChunkSize = safeLimit * 4; // Convert tokens to ~chars (4 chars per token)
+        const chunks = [];
+        // Split on paragraph boundaries first
+        const paragraphs = content.split(/\n\n+/);
+        let currentChunk = '';
+        for (const para of paragraphs) {
+            // If single paragraph exceeds chunk size, split it further
+            if (para.length > targetChunkSize) {
+                if (currentChunk) {
+                    chunks.push(currentChunk.trim());
+                    currentChunk = '';
+                }
+                // Split large paragraph into sentences
+                const sentences = para.split(/\.\s+/);
+                for (const sentence of sentences) {
+                    if ((currentChunk + sentence).length > targetChunkSize && currentChunk) {
+                        chunks.push(currentChunk.trim());
+                        currentChunk = sentence + '. ';
+                    }
+                    else {
+                        currentChunk += sentence + '. ';
+                    }
+                }
+                continue;
+            }
+            // Add paragraph to current chunk if it fits
+            if ((currentChunk + para).length <= targetChunkSize) {
+                currentChunk += para + '\n\n';
+            }
+            else {
+                // Current chunk is full, start new one
+                if (currentChunk) {
+                    chunks.push(currentChunk.trim());
+                }
+                currentChunk = para + '\n\n';
+            }
+        }
+        // Add remaining content
+        if (currentChunk.trim()) {
+            chunks.push(currentChunk.trim());
+        }
+        return chunks.length > 0 ? chunks : [content]; // Fallback to single chunk
+    }
+    /**
+     * Get model-specific context information for logging
+     *
+     * @param helperConfig - Helper model configuration
+     * @returns Context info string
+     */
+    getContextInfo(helperConfig) {
+        const contextWindow = helperConfig.limits?.contextWindow || 0;
+        const contextSizeKB = Math.floor(contextWindow / 1000);
+        return `${helperConfig.id} (${contextSizeKB}K context)`;
+    }
+}
+//# sourceMappingURL=HelperMiddlewareAdapter.interface.js.map

package/dist/middleware/helpers/HelperMiddlewareAdapter.interface.js.map

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

package/dist/middleware/helpers/HelperModelMiddlewareRegistry.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Helper Model Middleware Registry
+ * Phase 1.5: Week 2 - API Pattern-Based Helper System
+ *
+ * Central registry for managing helper middleware adapters.
+ * Independent from main adapter system - operates as self-contained unit.
+ */
+import type { HelperMiddlewareAdapter } from './HelperMiddlewareAdapter.interface.js';
+import type { ModelConfig } from '../../models/ModelConfig.interface.js';
+/**
+ * Registry for helper middleware adapters
+ *
+ * Manages registration and retrieval of helper adapters based on
+ * API patterns. Each adapter is self-contained and handles communication
+ * with helper models using a specific API pattern.
+ *
+ * ARCHITECTURE NOTE:
+ * This registry is INDEPENDENT from AdapterRegistry (main adapter system).
+ * Helper adapters do not depend on or share code with main adapters.
+ */
+export declare class HelperModelMiddlewareRegistry {
+    private adapters;
+    private static instance;
+    constructor();
+    /**
+     * Get singleton instance
+     *
+     * @returns Singleton registry instance
+     */
+    static getInstance(): HelperModelMiddlewareRegistry;
+    /**
+     * Reset singleton instance (useful for testing)
+     */
+    static resetInstance(): void;
+    /**
+     * Register a helper adapter
+     *
+     * @param adapter - Helper adapter to register
+     * @param force - If true, allows overwriting existing adapter
+     */
+    register(adapter: HelperMiddlewareAdapter, force?: boolean): void;
+    /**
+     * Get helper adapter for a specific API pattern
+     *
+     * @param apiPattern - API pattern (e.g., 'messages', 'chat/completions')
+     * @returns Helper adapter for the pattern
+     * @throws Error if no adapter found for pattern
+     */
+    getAdapter(apiPattern: string): HelperMiddlewareAdapter;
+    /**
+     * Get helper adapter for a model configuration
+     *
+     * Selects the appropriate helper adapter based on the helper model's
+     * API pattern.
+     *
+     * @param helperConfig - Helper model configuration
+     * @returns Helper adapter that can handle this model
+     * @throws Error if no adapter found for model's API pattern
+     */
+    getAdapterForModel(helperConfig: ModelConfig): HelperMiddlewareAdapter;
+    /**
+     * Check if an adapter exists for an API pattern
+     *
+     * @param apiPattern - API pattern to check
+     * @returns True if adapter exists
+     */
+    hasAdapter(apiPattern: string): boolean;
+    /**
+     * Get all registered API patterns
+     *
+     * @returns Array of registered API patterns
+     */
+    getRegisteredPatterns(): string[];
+    /**
+     * Get all registered adapters
+     *
+     * @returns Array of all registered helper adapters
+     */
+    getAllAdapters(): HelperMiddlewareAdapter[];
+    /**
+     * Unregister an adapter
+     *
+     * @param apiPattern - API pattern of adapter to remove
+     * @returns True if adapter was removed
+     */
+    unregister(apiPattern: string): boolean;
+    /**
+     * Clear all registered adapters
+     */
+    clear(): void;
+    /**
+     * Get registry statistics
+     *
+     * @returns Statistics about registered adapters
+     */
+    getStats(): {
+        totalAdapters: number;
+        patterns: string[];
+        adapterNames: string[];
+    };
+}
+/**
+ * Default singleton instance for convenience
+ */
+export declare const helperRegistry: HelperModelMiddlewareRegistry;
+//# sourceMappingURL=HelperModelMiddlewareRegistry.d.ts.map

package/dist/middleware/helpers/HelperModelMiddlewareRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelperModelMiddlewareRegistry.d.ts","sourceRoot":"","sources":["../../../src/middleware/helpers/HelperModelMiddlewareRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEzE;;;;;;;;;;GAUG;AACH,qBAAa,6BAA6B;IACxC,OAAO,CAAC,QAAQ,CAAmD;IACnE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA8C;;IAOrE;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,6BAA6B;IAOnD;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,uBAAuB,EAAE,KAAK,GAAE,OAAe,GAAG,IAAI;IAiBxE;;;;;;OAMG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,uBAAuB;IAavD;;;;;;;;;OASG;IACH,kBAAkB,CAAC,YAAY,EAAE,WAAW,GAAG,uBAAuB;IAKtE;;;;;OAKG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIvC;;;;OAIG;IACH,qBAAqB,IAAI,MAAM,EAAE;IAIjC;;;;OAIG;IACH,cAAc,IAAI,uBAAuB,EAAE;IAI3C;;;;;OAKG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,QAAQ,IAAI;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB;CAQF;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,+BAA8C,CAAC"}