@nexus-cortex/core 4.26.0

package/dist/middleware/helpers/adapters/MessagesAPIHelperAdapter.js

@@ -0,0 +1,264 @@
+/**
+ * Messages API Helper Adapter
+ * Phase 1.5: Week 2 - Independent Helper Middleware
+ *
+ * Handles helper model communication using Messages API pattern (/v1/messages).
+ * Used by Anthropic (Claude) and XAI (Grok) models.
+ *
+ * ARCHITECTURE:
+ * - Self-contained: No dependency on main adapter system
+ * - Makes real API calls using fetch
+ * - Converts canonical format to Messages API format internally
+ * - Handles compaction and tool result summarization
+ */
+import { BaseHelperAdapter } from '../HelperMiddlewareAdapter.interface.js';
+import { anthropicCredentialService, CredentialError } from '../../../config/AnthropicCredentialService.js';
+/**
+ * Helper adapter for Messages API pattern
+ *
+ * Supports: Anthropic Claude, XAI Grok (any model using /v1/messages pattern)
+ */
+export class MessagesAPIHelperAdapter extends BaseHelperAdapter {
+    apiPattern = 'messages';
+    name = 'MessagesAPIHelperAdapter';
+    /**
+     * Compact conversation history via Messages API helper model
+     */
+    async compact(messages, helperConfig, targetTokens) {
+        const startTime = Date.now();
+        // Estimate original tokens
+        const originalText = this.extractTextContent(messages);
+        const originalTokens = this.estimateTokens(originalText);
+        // Check if content needs chunking (smart chunking based on model's context limit)
+        if (this.needsChunking(originalText, helperConfig, targetTokens)) {
+            const contentTokens = this.estimateTokens(originalText);
+            const contextInfo = this.getContextInfo(helperConfig);
+            console.log(` ⚠  Content too large (${contentTokens} tokens) for ${contextInfo}, using smart chunking...`);
+            return await this.compactWithChunking(messages, helperConfig, targetTokens, startTime);
+        }
+        // Create compaction prompt
+        const prompt = this.createCompactionPrompt(messages, targetTokens);
+        // Make real API call
+        const response = await this.makeAPICall(helperConfig, [{ role: 'user', content: prompt }], targetTokens);
+        // Extract summary from response
+        const summary = response.content[0]?.text || '';
+        const compressedTokens = response.usage.output_tokens;
+        const tokensSaved = originalTokens - compressedTokens;
+        // Create compacted messages (summary + keep most recent messages)
+        const recentCount = Math.min(5, messages.length);
+        const recentMessages = messages.slice(-recentCount);
+        const compactedMessages = [
+            {
+                role: 'system',
+                content: `[Compacted History]\n${summary}`
+            },
+            ...recentMessages
+        ];
+        const processingTime = Date.now() - startTime;
+        const cost = this.calculateCost(response.usage.input_tokens, response.usage.output_tokens, helperConfig);
+        return {
+            summary,
+            compactedMessages,
+            originalTokens,
+            compressedTokens,
+            tokensSaved,
+            helperModelId: helperConfig.id,
+            processingTime,
+            cost
+        };
+    }
+    /**
+     * Summarize tool result via Messages API helper model
+     */
+    async summarizeToolResult(toolResult, helperConfig, maxTokens) {
+        const startTime = Date.now();
+        // Estimate original tokens
+        const originalTokens = this.estimateTokens(toolResult);
+        // Create summarization prompt
+        const prompt = this.createToolSummaryPrompt(toolResult, maxTokens);
+        // Make real API call
+        const response = await this.makeAPICall(helperConfig, [{ role: 'user', content: prompt }], maxTokens);
+        // Extract summary from response
+        const summary = response.content[0]?.text || '';
+        const summaryTokens = response.usage.output_tokens;
+        const tokensSaved = originalTokens - summaryTokens;
+        const processingTime = Date.now() - startTime;
+        const cost = this.calculateCost(response.usage.input_tokens, response.usage.output_tokens, helperConfig);
+        return {
+            summary,
+            originalTokens,
+            summaryTokens,
+            tokensSaved,
+            helperModelId: helperConfig.id,
+            processingTime,
+            cost
+        };
+    }
+    /**
+     * Compact with chunking for large content
+     * Uses smart chunking from base adapter
+     */
+    async compactWithChunking(messages, helperConfig, targetTokens, startTime) {
+        const originalText = this.extractTextContent(messages);
+        const originalTokens = this.estimateTokens(originalText);
+        // Use base class smart chunking
+        const chunks = this.chunkContent(originalText, helperConfig, targetTokens);
+        const chunkSummaries = [];
+        console.log(` Processing ${chunks.length} chunks (smart chunking for ${this.getContextInfo(helperConfig)})...`);
+        // Compress each chunk
+        for (let i = 0; i < chunks.length; i++) {
+            const chunk = chunks[i];
+            if (!chunk)
+                continue;
+            console.log(` ⏳ Chunk ${i + 1}/${chunks.length} (${this.estimateTokens(chunk)} tokens)...`);
+            try {
+                const response = await this.makeAPICall(helperConfig, [{ role: 'user', content: `Summarize in ${Math.floor(targetTokens / chunks.length)} tokens:\n\n${chunk}` }], Math.floor(targetTokens / chunks.length));
+                chunkSummaries.push(response.content[0]?.text || '');
+            }
+            catch (error) {
+                console.warn(` ⚠  Chunk ${i + 1} failed: ${error.message}`);
+                chunkSummaries.push(`[Chunk ${i + 1} compression failed]`);
+            }
+        }
+        // Combine and potentially do final pass
+        const combinedSummary = chunkSummaries.join('\n\n---\n\n');
+        const combinedTokens = this.estimateTokens(combinedSummary);
+        if (combinedTokens > targetTokens) {
+            console.log(` Final compression pass (${combinedTokens} → ${targetTokens} tokens)...`);
+            const finalResponse = await this.makeAPICall(helperConfig, [{ role: 'user', content: `Combine these summaries into ${targetTokens} tokens:\n\n${combinedSummary}` }], targetTokens);
+            const finalSummary = finalResponse.content[0]?.text || '';
+            const compressedTokens = finalResponse.usage.output_tokens;
+            const recentCount = Math.min(5, messages.length);
+            const recentMessages = messages.slice(-recentCount);
+            const compactedMessages = [
+                { role: 'system', content: `[Compacted History]\n${finalSummary}` },
+                ...recentMessages
+            ];
+            const processingTime = Date.now() - startTime;
+            const cost = this.calculateCost(finalResponse.usage.input_tokens, compressedTokens, helperConfig);
+            return {
+                summary: finalSummary,
+                compactedMessages,
+                originalTokens,
+                compressedTokens,
+                tokensSaved: originalTokens - compressedTokens,
+                helperModelId: helperConfig.id,
+                processingTime,
+                cost
+            };
+        }
+        // Use combined summary
+        const recentCount = Math.min(5, messages.length);
+        const recentMessages = messages.slice(-recentCount);
+        const compactedMessages = [
+            { role: 'system', content: `[Compacted History]\n${combinedSummary}` },
+            ...recentMessages
+        ];
+        const processingTime = Date.now() - startTime;
+        const cost = this.calculateCost(originalTokens, combinedTokens, helperConfig);
+        return {
+            summary: combinedSummary,
+            compactedMessages,
+            originalTokens,
+            compressedTokens: combinedTokens,
+            tokensSaved: originalTokens - combinedTokens,
+            helperModelId: helperConfig.id,
+            processingTime,
+            cost
+        };
+    }
+    async generate(messages, helperConfig, maxTokens) {
+        const apiMessages = messages
+            .filter(m => m.role === 'user' || m.role === 'assistant')
+            .map(m => ({
+            role: m.role,
+            content: typeof m.content === 'string' ? m.content : m.content.map((b) => b.text || '').join('\n'),
+        }));
+        const response = await this.makeAPICall(helperConfig, apiMessages, maxTokens);
+        const content = response.content;
+        if (Array.isArray(content)) {
+            return content.filter((b) => b.type === 'text').map((b) => b.text).join('');
+        }
+        return typeof content === 'string' ? content : '';
+    }
+    /**
+     * Make real API call to Messages API endpoint
+     *
+     * CRITICAL: This makes REAL API calls, not mocks!
+     */
+    async makeAPICall(config, messages, maxTokens, systemPrompt) {
+        // Get authentication token and type (supports OAuth for Anthropic, API keys for others)
+        let apiKey;
+        let isOAuth = false;
+        if (config.provider === 'anthropic') {
+            // Use OAuth-aware credential service for Anthropic (Claude)
+            const authMethod = (process.env.ANTHROPIC_AUTH_METHOD || 'auto');
+            try {
+                const credential = anthropicCredentialService.loadCredential(authMethod);
+                apiKey = credential.token;
+                isOAuth = credential.type === 'oauth';
+                if (process.env.DEBUG === 'true') {
+                    console.log(`[MessagesAPIHelper] Using Anthropic credential: ${anthropicCredentialService.getCredentialSummary(credential)}`);
+                }
+            }
+            catch (error) {
+                if (error instanceof CredentialError) {
+                    throw new Error(`MessagesAPIHelper: Anthropic authentication failed: ${error.message}`);
+                }
+                throw error;
+            }
+        }
+        else {
+            // Direct env var access for non-Anthropic providers
+            const envKey = process.env[config.api.apiKeyEnvVar];
+            if (!envKey) {
+                throw new Error(`MessagesAPIHelper: API key not found in environment variable: ${config.api.apiKeyEnvVar}`);
+            }
+            apiKey = envKey;
+        }
+        // Get request URL (endpoint contains full URL)
+        const url = config.api.endpoint;
+        // Build headers
+        const headers = {
+            'Content-Type': 'application/json'
+        };
+        // Add authentication header (OAuth uses Authorization: Bearer, API keys use x-api-key)
+        if (config.provider === 'anthropic' && isOAuth) {
+            // OAuth: Use Authorization: Bearer
+            headers['Authorization'] = `Bearer ${apiKey}`;
+        }
+        else {
+            // API Key or non-Anthropic: Use configured auth header
+            const authPrefix = config.api.authPrefix ? `${config.api.authPrefix} ` : '';
+            headers[config.api.authHeader] = `${authPrefix}${apiKey}`;
+        }
+        // Add version header if specified
+        if (config.api.versionHeader) {
+            headers[config.api.versionHeader.name] = config.api.versionHeader.value;
+        }
+        // Build request body
+        const requestBody = {
+            model: config.id,
+            messages,
+            max_tokens: Math.min(maxTokens, config.limits.outputTokens),
+            temperature: 0.7
+        };
+        // Add system prompt if provided
+        if (systemPrompt) {
+            requestBody.system = systemPrompt;
+        }
+        // Make real API call
+        const response = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(requestBody)
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`MessagesAPIHelper: API call failed (${response.status}): ${errorText}`);
+        }
+        const data = await response.json();
+        return data;
+    }
+}
+//# sourceMappingURL=MessagesAPIHelperAdapter.js.map

package/dist/middleware/helpers/adapters/MessagesAPIHelperAdapter.js.map

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

package/dist/middleware/helpers/adapters/ResponsesAPIHelperAdapter.d.ts

@@ -0,0 +1,64 @@
+/**
+ * ResponsesAPI Helper Adapter
+ * Phase 1.5: Week 2 - Independent Helper Middleware
+ *
+ * Handles helper model communication using OpenAI's Responses API pattern.
+ * Used for stateful conversation models (GPT-5 Codex, Codex Mini, etc.).
+ *
+ * API Pattern: 'responses' (/v1/responses endpoint)
+ * - Stateful conversation API with 30-day storage
+ * - Different from /v1/chat/completions (Chat Completions API)
+ * - Uses input items array with typed content blocks
+ * - Supports previous_response_id for conversation chaining
+ *
+ * ARCHITECTURE:
+ * - Self-contained: No dependency on main adapter system
+ * - Makes real API calls using OpenAI SDK (client.responses.create)
+ * - Supports GPT-5 Codex, Codex Mini, and future Responses API models
+ * - Handles stateful conversation continuity
+ */
+import { BaseHelperAdapter, type HelperCanonicalMessage, type CompactionResult, type ToolSummaryResult } from '../HelperMiddlewareAdapter.interface.js';
+import type { ModelConfig } from '../../../models/ModelConfig.interface.js';
+/**
+ * Helper adapter for ResponsesAPI pattern ('responses')
+ *
+ * Uses OpenAI SDK's client.responses.create() for stateful conversation API.
+ *
+ * Supports: GPT-5 Codex, Codex Mini, future Responses API models
+ * - gpt-5-codex: 400K context, advanced reasoning
+ * - codex-mini-latest: Optimized for code tasks
+ *
+ * Key Features:
+ * - 30-day response storage when store: true
+ * - Conversation chaining via previous_response_id
+ * - Uses max_output_tokens (not max_tokens)
+ */
+export declare class ResponsesAPIHelperAdapter extends BaseHelperAdapter {
+    readonly apiPattern = "responses";
+    readonly name = "ResponsesAPIHelperAdapter";
+    /**
+     * Compact conversation history via Responses API models
+     */
+    compact(messages: HelperCanonicalMessage[], helperConfig: ModelConfig, targetTokens: number): Promise<CompactionResult>;
+    /**
+     * Summarize tool result via Responses API models
+     */
+    summarizeToolResult(toolResult: string, helperConfig: ModelConfig, maxTokens: number): Promise<ToolSummaryResult>;
+    /**
+     * Make real API call to OpenAI Responses API
+     *
+     * CRITICAL: This makes REAL API calls via client.responses.create(), not mocks!
+     */
+    private makeAPICall;
+    /**
+     * Override calculateCost for Responses API models
+     *
+     * GPT-5 Codex pricing (estimated, may vary):
+     * - Input: ~$2.50 / 1M tokens
+     * - Output: ~$10.00 / 1M tokens
+     *
+     * Note: Actual pricing should come from ModelConfig in production
+     */
+    protected calculateCost(inputTokens: number, outputTokens: number, _modelConfig: ModelConfig): number;
+}
+//# sourceMappingURL=ResponsesAPIHelperAdapter.d.ts.map

package/dist/middleware/helpers/adapters/ResponsesAPIHelperAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResponsesAPIHelperAdapter.d.ts","sourceRoot":"","sources":["../../../../src/middleware/helpers/adapters/ResponsesAPIHelperAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAc5E;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAA0B,SAAQ,iBAAiB;IAC9D,QAAQ,CAAC,UAAU,eAAe;IAClC,QAAQ,CAAC,IAAI,+BAA+B;IAE5C;;OAEG;IACG,OAAO,CACX,QAAQ,EAAE,sBAAsB,EAAE,EAClC,YAAY,EAAE,WAAW,EACzB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC;IAyD5B;;OAEG;IACG,mBAAmB,CACvB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,WAAW,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC;IA4C7B;;;;OAIG;YACW,WAAW;IAkEzB;;;;;;;;OAQG;IACH,SAAS,CAAC,aAAa,CACrB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,WAAW,GACxB,MAAM;CAUV"}

package/dist/middleware/helpers/adapters/ResponsesAPIHelperAdapter.js

@@ -0,0 +1,189 @@
+/**
+ * ResponsesAPI Helper Adapter
+ * Phase 1.5: Week 2 - Independent Helper Middleware
+ *
+ * Handles helper model communication using OpenAI's Responses API pattern.
+ * Used for stateful conversation models (GPT-5 Codex, Codex Mini, etc.).
+ *
+ * API Pattern: 'responses' (/v1/responses endpoint)
+ * - Stateful conversation API with 30-day storage
+ * - Different from /v1/chat/completions (Chat Completions API)
+ * - Uses input items array with typed content blocks
+ * - Supports previous_response_id for conversation chaining
+ *
+ * ARCHITECTURE:
+ * - Self-contained: No dependency on main adapter system
+ * - Makes real API calls using OpenAI SDK (client.responses.create)
+ * - Supports GPT-5 Codex, Codex Mini, and future Responses API models
+ * - Handles stateful conversation continuity
+ */
+import { BaseHelperAdapter } from '../HelperMiddlewareAdapter.interface.js';
+/**
+ * Helper adapter for ResponsesAPI pattern ('responses')
+ *
+ * Uses OpenAI SDK's client.responses.create() for stateful conversation API.
+ *
+ * Supports: GPT-5 Codex, Codex Mini, future Responses API models
+ * - gpt-5-codex: 400K context, advanced reasoning
+ * - codex-mini-latest: Optimized for code tasks
+ *
+ * Key Features:
+ * - 30-day response storage when store: true
+ * - Conversation chaining via previous_response_id
+ * - Uses max_output_tokens (not max_tokens)
+ */
+export class ResponsesAPIHelperAdapter extends BaseHelperAdapter {
+    apiPattern = 'responses';
+    name = 'ResponsesAPIHelperAdapter';
+    /**
+     * Compact conversation history via Responses API models
+     */
+    async compact(messages, helperConfig, targetTokens) {
+        const startTime = Date.now();
+        // Estimate original tokens
+        const originalText = this.extractTextContent(messages);
+        const originalTokens = this.estimateTokens(originalText);
+        // Create compaction prompt
+        const prompt = this.createCompactionPrompt(messages, targetTokens);
+        // Convert to Responses API format
+        const inputItems = [
+            {
+                type: 'message',
+                role: 'user',
+                content: [{ type: 'input_text', text: prompt }]
+            }
+        ];
+        // Make real API call via OpenAI Responses API
+        const response = await this.makeAPICall(helperConfig, inputItems, targetTokens);
+        // Extract summary from response
+        const summary = response.text;
+        const compressedTokens = response.outputTokens;
+        const tokensSaved = originalTokens - compressedTokens;
+        // Create compacted messages (summary + keep most recent messages)
+        const recentCount = Math.min(5, messages.length);
+        const recentMessages = messages.slice(-recentCount);
+        const compactedMessages = [
+            {
+                role: 'system',
+                content: `[Compacted History]\n${summary}`
+            },
+            ...recentMessages
+        ];
+        const processingTime = Date.now() - startTime;
+        const cost = this.calculateCost(response.inputTokens, response.outputTokens, helperConfig);
+        return {
+            summary,
+            compactedMessages,
+            originalTokens,
+            compressedTokens,
+            tokensSaved,
+            helperModelId: helperConfig.id,
+            processingTime,
+            cost
+        };
+    }
+    /**
+     * Summarize tool result via Responses API models
+     */
+    async summarizeToolResult(toolResult, helperConfig, maxTokens) {
+        const startTime = Date.now();
+        // Estimate original tokens
+        const originalTokens = this.estimateTokens(toolResult);
+        // Create summarization prompt
+        const prompt = this.createToolSummaryPrompt(toolResult, maxTokens);
+        // Convert to Responses API format
+        const inputItems = [
+            {
+                type: 'message',
+                role: 'user',
+                content: [{ type: 'input_text', text: prompt }]
+            }
+        ];
+        // Make real API call via OpenAI Responses API
+        const response = await this.makeAPICall(helperConfig, inputItems, maxTokens);
+        // Extract summary
+        const summary = response.text;
+        const summaryTokens = response.outputTokens;
+        const tokensSaved = originalTokens - summaryTokens;
+        const processingTime = Date.now() - startTime;
+        const cost = this.calculateCost(response.inputTokens, response.outputTokens, helperConfig);
+        return {
+            summary,
+            originalTokens,
+            summaryTokens,
+            tokensSaved,
+            helperModelId: helperConfig.id,
+            processingTime,
+            cost
+        };
+    }
+    /**
+     * Make real API call to OpenAI Responses API
+     *
+     * CRITICAL: This makes REAL API calls via client.responses.create(), not mocks!
+     */
+    async makeAPICall(config, inputItems, maxOutputTokens) {
+        // Get API key from environment
+        const apiKey = process.env[config.api.apiKeyEnvVar];
+        if (!apiKey) {
+            throw new Error(`ResponsesAPIHelper: API key not found in environment variable: ${config.api.apiKeyEnvVar}`);
+        }
+        // Import OpenAI SDK dynamically
+        const OpenAI = (await import('openai')).default;
+        // Create client
+        const client = new OpenAI({ apiKey });
+        // Make API call to /v1/responses endpoint
+        // NOTE: Uses max_output_tokens (not max_tokens!)
+        const response = await client.responses.create({
+            model: config.id,
+            input: inputItems,
+            max_output_tokens: Math.min(maxOutputTokens, config.limits.outputTokens),
+            // Note: We don't use store: true or previous_response_id for helper calls
+            // These are single-shot summarization requests, not ongoing conversations
+        });
+        // Extract text from output
+        let text = '';
+        if (response.output && response.output.length > 0) {
+            for (const item of response.output) {
+                if (item.type === 'message' && item.content) {
+                    for (const block of item.content) {
+                        if (block.type === 'output_text' && 'text' in block) {
+                            text += block.text;
+                        }
+                    }
+                }
+            }
+        }
+        // Use output_text if available (SDK convenience property)
+        if (!text && response.output_text) {
+            text = response.output_text;
+        }
+        // Estimate token counts (Responses API may not provide usage metadata)
+        const inputText = inputItems.map(item => item.content.map(c => c.text).join('')).join('');
+        const inputTokens = this.estimateTokens(inputText);
+        const outputTokens = this.estimateTokens(text);
+        return {
+            text,
+            inputTokens,
+            outputTokens
+        };
+    }
+    /**
+     * Override calculateCost for Responses API models
+     *
+     * GPT-5 Codex pricing (estimated, may vary):
+     * - Input: ~$2.50 / 1M tokens
+     * - Output: ~$10.00 / 1M tokens
+     *
+     * Note: Actual pricing should come from ModelConfig in production
+     */
+    calculateCost(inputTokens, outputTokens, _modelConfig) {
+        // Codex model pricing (conservative estimate)
+        const inputCostPer1M = 2.50;
+        const outputCostPer1M = 10.00;
+        const inputCost = (inputTokens / 1_000_000) * inputCostPer1M;
+        const outputCost = (outputTokens / 1_000_000) * outputCostPer1M;
+        return inputCost + outputCost;
+    }
+}
+//# sourceMappingURL=ResponsesAPIHelperAdapter.js.map

package/dist/middleware/helpers/adapters/ResponsesAPIHelperAdapter.js.map

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

package/dist/middleware/helpers/adapters/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Helper Middleware Adapters
+ * Phase 1.5: Week 2 - Independent Helper System
+ *
+ * Exports all helper adapters and provides default registration.
+ * Supports ALL 5 API patterns for comprehensive model coverage.
+ */
+import { MessagesAPIHelperAdapter } from './MessagesAPIHelperAdapter.js';
+import { ChatCompletionsAPIHelperAdapter } from './ChatCompletionsAPIHelperAdapter.js';
+import { GoogleGenAPIHelperAdapter } from './GoogleGenAPIHelperAdapter.js';
+import { GenerateContentAPIHelperAdapter } from './GenerateContentAPIHelperAdapter.js';
+import { ResponsesAPIHelperAdapter } from './ResponsesAPIHelperAdapter.js';
+import type { HelperModelMiddlewareRegistry } from '../HelperModelMiddlewareRegistry.js';
+export { MessagesAPIHelperAdapter, ChatCompletionsAPIHelperAdapter, GoogleGenAPIHelperAdapter, GenerateContentAPIHelperAdapter, ResponsesAPIHelperAdapter };
+/**
+ * Register default helper adapters
+ *
+ * This function registers ALL built-in helper adapters with the
+ * HelperModelMiddlewareRegistry. Call this during system initialization.
+ *
+ * Registered Adapters:
+ * 1. MessagesAPIHelperAdapter ('messages') - Anthropic Claude, XAI Grok
+ * 2. ChatCompletionsAPIHelperAdapter ('chat/completions') - OpenAI, DeepSeek, Groq
+ * 3. GoogleGenAPIHelperAdapter ('google-genai') - FREE Gemma models
+ * 4. GenerateContentAPIHelperAdapter ('generateContent') - Paid Gemini models
+ * 5. ResponsesAPIHelperAdapter ('responses') - OpenAI stateful API (GPT-5 Codex, etc.)
+ *
+ * @param registry - HelperModelMiddlewareRegistry instance
+ */
+export declare function registerDefaultHelperAdapters(registry: HelperModelMiddlewareRegistry): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/helpers/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/middleware/helpers/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAEzF,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,yBAAyB,EACzB,+BAA+B,EAC/B,yBAAyB,EAC1B,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,6BAA6B,GAAG,IAAI,CAW3F"}

package/dist/middleware/helpers/adapters/index.js

@@ -0,0 +1,40 @@
+/**
+ * Helper Middleware Adapters
+ * Phase 1.5: Week 2 - Independent Helper System
+ *
+ * Exports all helper adapters and provides default registration.
+ * Supports ALL 5 API patterns for comprehensive model coverage.
+ */
+import { MessagesAPIHelperAdapter } from './MessagesAPIHelperAdapter.js';
+import { ChatCompletionsAPIHelperAdapter } from './ChatCompletionsAPIHelperAdapter.js';
+import { GoogleGenAPIHelperAdapter } from './GoogleGenAPIHelperAdapter.js';
+import { GenerateContentAPIHelperAdapter } from './GenerateContentAPIHelperAdapter.js';
+import { ResponsesAPIHelperAdapter } from './ResponsesAPIHelperAdapter.js';
+export { MessagesAPIHelperAdapter, ChatCompletionsAPIHelperAdapter, GoogleGenAPIHelperAdapter, GenerateContentAPIHelperAdapter, ResponsesAPIHelperAdapter };
+/**
+ * Register default helper adapters
+ *
+ * This function registers ALL built-in helper adapters with the
+ * HelperModelMiddlewareRegistry. Call this during system initialization.
+ *
+ * Registered Adapters:
+ * 1. MessagesAPIHelperAdapter ('messages') - Anthropic Claude, XAI Grok
+ * 2. ChatCompletionsAPIHelperAdapter ('chat/completions') - OpenAI, DeepSeek, Groq
+ * 3. GoogleGenAPIHelperAdapter ('google-genai') - FREE Gemma models
+ * 4. GenerateContentAPIHelperAdapter ('generateContent') - Paid Gemini models
+ * 5. ResponsesAPIHelperAdapter ('responses') - OpenAI stateful API (GPT-5 Codex, etc.)
+ *
+ * @param registry - HelperModelMiddlewareRegistry instance
+ */
+export function registerDefaultHelperAdapters(registry) {
+    // Register all 5 adapters
+    registry.register(new MessagesAPIHelperAdapter());
+    registry.register(new ChatCompletionsAPIHelperAdapter());
+    registry.register(new GoogleGenAPIHelperAdapter());
+    registry.register(new GenerateContentAPIHelperAdapter());
+    registry.register(new ResponsesAPIHelperAdapter());
+    if (process.env.DEBUG === 'true') {
+        console.log('[OK] Registered 5 helper adapters (messages, chat/completions, google-genai, generateContent, responses)');
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/middleware/helpers/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/middleware/helpers/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAG3E,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,yBAAyB,EACzB,+BAA+B,EAC/B,yBAAyB,EAC1B,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,6BAA6B,CAAC,QAAuC;IACnF,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,CAAC,IAAI,wBAAwB,EAAE,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,IAAI,+BAA+B,EAAE,CAAC,CAAC;IACzD,QAAQ,CAAC,QAAQ,CAAC,IAAI,yBAAyB,EAAE,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,IAAI,+BAA+B,EAAE,CAAC,CAAC;IACzD,QAAQ,CAAC,QAAQ,CAAC,IAAI,yBAAyB,EAAE,CAAC,CAAC;IAEnD,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,0GAA0G,CAAC,CAAC;IAC1H,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Helper Model Middleware System
+ * Phase 1.5: Week 2 - Independent Helper Architecture
+ *
+ * Central exports for the independent helper middleware system.
+ */
+export * from './HelperMiddlewareAdapter.interface.js';
+export * from './HelperModelMiddlewareRegistry.js';
+export * from './adapters/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/middleware/helpers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,wCAAwC,CAAC;AAGvD,cAAc,oCAAoC,CAAC;AAGnD,cAAc,qBAAqB,CAAC"}