@nexus-cortex/core 4.26.0

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

@@ -0,0 +1,155 @@
+/**
+ * GenerateContent API Helper Adapter
+ * Phase 1.5: Week 2 - Independent Helper Middleware
+ *
+ * Handles helper model communication using Google's generateContent API pattern.
+ * Used for paid Gemini models (Pro, Flash, etc.) via @google/generative-ai SDK.
+ *
+ * API Pattern: 'generateContent' (@google/generative-ai package)
+ * - Different from 'google-genai' pattern (which uses @google/genai for FREE Gemma models)
+ * - Full-featured API with tools/functions, streaming, etc.
+ * - Used for production Gemini models
+ *
+ * ARCHITECTURE:
+ * - Self-contained: No dependency on main adapter system
+ * - Makes real API calls using @google/generative-ai SDK
+ * - Supports Gemini Pro, Gemini Flash, and other paid Gemini models
+ * - Handles large context windows (up to 2M tokens for some models)
+ */
+import { BaseHelperAdapter } from '../HelperMiddlewareAdapter.interface.js';
+/**
+ * Helper adapter for GenerateContent API pattern ('generateContent')
+ *
+ * Uses @google/generative-ai package for paid Gemini models.
+ *
+ * Supports: Gemini Pro, Gemini Flash, Gemini Ultra (when available)
+ * - gemini-2.0-flash-lite: Fast, cost-effective ($0.075/1M tokens)
+ * - gemini-1.5-pro: High-quality reasoning ($3.50/1M tokens)
+ * - gemini-1.5-flash: Balanced performance ($0.375/1M tokens)
+ */
+export class GenerateContentAPIHelperAdapter extends BaseHelperAdapter {
+    apiPattern = 'generateContent';
+    name = 'GenerateContentAPIHelperAdapter';
+    /**
+     * Compact conversation history via paid Gemini 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);
+        // Make real API call via Google Generative AI SDK
+        const response = await this.makeAPICall(helperConfig, prompt, 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 paid Gemini 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);
+        // Make real API call via Google Generative AI SDK
+        const response = await this.makeAPICall(helperConfig, prompt, 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 Google Generative AI
+     *
+     * CRITICAL: This makes REAL API calls, not mocks!
+     */
+    async makeAPICall(config, prompt, maxOutputTokens) {
+        // Get API key from environment
+        const apiKey = process.env[config.api.apiKeyEnvVar];
+        if (!apiKey) {
+            throw new Error(`GenerateContentAPIHelper: API key not found in environment variable: ${config.api.apiKeyEnvVar}`);
+        }
+        // Import Google Generative AI SDK dynamically
+        const { GoogleGenerativeAI } = await import('@google/generative-ai');
+        // Create client
+        const genAI = new GoogleGenerativeAI(apiKey);
+        // Get model
+        const model = genAI.getGenerativeModel({
+            model: config.id,
+            generationConfig: {
+                maxOutputTokens: Math.min(maxOutputTokens, config.limits.outputTokens),
+                temperature: 0.7
+            }
+        });
+        // Make API call
+        const result = await model.generateContent(prompt);
+        const response = result.response;
+        // Extract text
+        const text = response.text() || '';
+        // Extract token counts
+        // Note: TypeScript may not recognize usageMetadata, use type assertion
+        const responseData = response;
+        const inputTokens = responseData.usageMetadata?.promptTokenCount || this.estimateTokens(prompt);
+        const outputTokens = responseData.usageMetadata?.candidatesTokenCount || this.estimateTokens(text);
+        return {
+            text,
+            inputTokens,
+            outputTokens
+        };
+    }
+    /**
+     * Override calculateCost for Gemini model pricing
+     *
+     * Gemini pricing (as of 2024):
+     * - Flash models: ~$0.075-0.375 per 1M tokens
+     * - Pro models: ~$1.25-3.50 per 1M tokens
+     */
+    calculateCost(inputTokens, outputTokens, _modelConfig) {
+        // Gemini Flash pricing (most common helper model)
+        // Input: $0.075 / 1M tokens, Output: $0.30 / 1M tokens
+        const inputCostPer1M = 0.075;
+        const outputCostPer1M = 0.30;
+        const inputCost = (inputTokens / 1_000_000) * inputCostPer1M;
+        const outputCost = (outputTokens / 1_000_000) * outputCostPer1M;
+        return inputCost + outputCost;
+    }
+}
+//# sourceMappingURL=GenerateContentAPIHelperAdapter.js.map

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

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

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

@@ -0,0 +1,124 @@
+/**
+ * Google Gen API Helper Adapter
+ * Phase 1.5: Week 2 - Independent Helper Middleware
+ *
+ * Handles helper model communication using Google's 'google-genai' API pattern.
+ * Self-contained implementation for FREE Gemma 3 model access.
+ *
+ * API Pattern: 'google-genai' (@google/genai package)
+ * - Different from 'generateContent' pattern (which uses @google/generative-ai)
+ * - Simplified API for FREE Gemma models only
+ *
+ * ARCHITECTURE:
+ * - Self-contained: No external service dependencies
+ * - All Gemma-specific logic inlined (chunking, fallback, etc.)
+ * - Supports FREE Gemma models (gemma-3-27b-it, gemma-3-12b-it, etc.)
+ * - Handles 128K+ content via hierarchical chunking
+ * - $0 cost for all operations (100% cost savings)
+ */
+import { BaseHelperAdapter, type HelperCanonicalMessage, type CompactionResult, type ToolSummaryResult } from '../HelperMiddlewareAdapter.interface.js';
+import type { ModelConfig } from '../../../models/ModelConfig.interface.js';
+/**
+ * Helper adapter for Google Gen API pattern ('google-genai')
+ *
+ * Uses @google/genai package for FREE Gemma models.
+ * Different from GenerateContentAPIHelperAdapter which uses @google/generative-ai.
+ *
+ * Supports: FREE Gemma 3 models via Google GenAI API
+ * - gemma-3-27b-it: High quality (27B params)
+ * - gemma-3-12b-it: Balanced (12B params)
+ * - gemma-3-4b-it: Fast (4B params)
+ * - gemma-3-1b-it: Ultra-fast (1B params)
+ *
+ * CRITICAL: All Gemma models are FREE ($0 cost)
+ */
+export declare class GoogleGenAPIHelperAdapter extends BaseHelperAdapter {
+    readonly apiPattern = "google-genai";
+    readonly name = "GoogleGenAPIHelperAdapter";
+    private defaultModel;
+    private fallbackModel;
+    /**
+     * Compact conversation history via FREE Gemma models
+     *
+     * Automatically:
+     * - Chunks content > 128K tokens
+     * - Falls back between models if one unavailable
+     * - Returns $0 cost (100% free)
+     */
+    compact(messages: HelperCanonicalMessage[], helperConfig: ModelConfig, targetTokens: number): Promise<CompactionResult>;
+    /**
+     * Summarize tool result via FREE Gemma models
+     */
+    summarizeToolResult(toolResult: string, helperConfig: ModelConfig, maxTokens: number): Promise<ToolSummaryResult>;
+    /**
+     * Compact content using free Gemma models
+     * Automatically handles content based on model's context limit (dynamic chunking)
+     */
+    private compactContent;
+    /**
+     * Try generating content with a specific model
+     */
+    private tryModel;
+    /**
+     * Format response with token estimates
+     */
+    private formatResponse;
+    /**
+     * Handle large content via chunking strategy
+     * Split content into chunks, compress each, then combine
+     * Uses smart chunking from base adapter (adapts to model's context limit)
+     */
+    private compactLargeContent;
+    /**
+     * Get Google GenAI client
+     */
+    private getClient;
+    /**
+     * Override estimateTokens to use consistent heuristic
+     */
+    estimateTokens(content: string): number;
+    /**
+     * Override calculateCost to always return $0 for Gemma models
+     */
+    protected calculateCost(_inputTokens: number, _outputTokens: number, _modelConfig: ModelConfig): number;
+    /**
+     * Get list of supported Gemma models (via Google GenAI API)
+     */
+    static getSupportedModels(): string[];
+}
+/**
+ * Pricing information for documentation
+ */
+export declare const GEMMA_PRICING: {
+    readonly 'gemma-3-27b-it': {
+        readonly input: 0;
+        readonly output: 0;
+        readonly description: "High-quality free model for summarization (27B params)";
+    };
+    readonly 'gemma-3-12b-it': {
+        readonly input: 0;
+        readonly output: 0;
+        readonly description: "Balanced quality/speed free model (12B params)";
+    };
+    readonly 'gemma-3-4b-it': {
+        readonly input: 0;
+        readonly output: 0;
+        readonly description: "Fast free model for quick compaction (4B params)";
+    };
+    readonly 'gemma-3-1b-it': {
+        readonly input: 0;
+        readonly output: 0;
+        readonly description: "Ultra-fast free model for rapid compaction (1B params)";
+    };
+    readonly 'gemma-3n-e4b-it': {
+        readonly input: 0;
+        readonly output: 0;
+        readonly description: "Efficient 4B variant optimized for speed";
+    };
+    readonly 'gemma-3n-e2b-it': {
+        readonly input: 0;
+        readonly output: 0;
+        readonly description: "Efficient 2B variant ultra-fast";
+    };
+};
+//# sourceMappingURL=GoogleGenAPIHelperAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleGenAPIHelperAdapter.d.ts","sourceRoot":"","sources":["../../../../src/middleware/helpers/adapters/GoogleGenAPIHelperAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,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,kBAAkB;IACrC,QAAQ,CAAC,IAAI,+BAA+B;IAE5C,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,aAAa,CAAoB;IAEzC;;;;;;;OAOG;IACG,OAAO,CACX,QAAQ,EAAE,sBAAsB,EAAE,EAClC,YAAY,EAAE,WAAW,EACzB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC;IA4C5B;;OAEG;IACG,mBAAmB,CACvB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,WAAW,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC;IAkC7B;;;OAGG;YACW,cAAc;IAwC5B;;OAEG;YACW,QAAQ;IActB;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;;;OAIG;YACW,mBAAmB;IAuDjC;;OAEG;IACH,OAAO,CAAC,SAAS;IAajB;;OAEG;IACI,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI9C;;OAEG;IACH,SAAS,CAAC,aAAa,CACrB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,WAAW,GACxB,MAAM;IAIT;;OAEG;IACH,MAAM,CAAC,kBAAkB,IAAI,MAAM,EAAE;CAUtC;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BhB,CAAC"}

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

@@ -0,0 +1,276 @@
+/**
+ * Google Gen API Helper Adapter
+ * Phase 1.5: Week 2 - Independent Helper Middleware
+ *
+ * Handles helper model communication using Google's 'google-genai' API pattern.
+ * Self-contained implementation for FREE Gemma 3 model access.
+ *
+ * API Pattern: 'google-genai' (@google/genai package)
+ * - Different from 'generateContent' pattern (which uses @google/generative-ai)
+ * - Simplified API for FREE Gemma models only
+ *
+ * ARCHITECTURE:
+ * - Self-contained: No external service dependencies
+ * - All Gemma-specific logic inlined (chunking, fallback, etc.)
+ * - Supports FREE Gemma models (gemma-3-27b-it, gemma-3-12b-it, etc.)
+ * - Handles 128K+ content via hierarchical chunking
+ * - $0 cost for all operations (100% cost savings)
+ */
+import { GoogleGenAI } from '@google/genai';
+import { BaseHelperAdapter } from '../HelperMiddlewareAdapter.interface.js';
+/**
+ * Helper adapter for Google Gen API pattern ('google-genai')
+ *
+ * Uses @google/genai package for FREE Gemma models.
+ * Different from GenerateContentAPIHelperAdapter which uses @google/generative-ai.
+ *
+ * Supports: FREE Gemma 3 models via Google GenAI API
+ * - gemma-3-27b-it: High quality (27B params)
+ * - gemma-3-12b-it: Balanced (12B params)
+ * - gemma-3-4b-it: Fast (4B params)
+ * - gemma-3-1b-it: Ultra-fast (1B params)
+ *
+ * CRITICAL: All Gemma models are FREE ($0 cost)
+ */
+export class GoogleGenAPIHelperAdapter extends BaseHelperAdapter {
+    apiPattern = 'google-genai';
+    name = 'GoogleGenAPIHelperAdapter';
+    defaultModel = 'gemma-3-27b-it';
+    fallbackModel = 'gemma-3-12b-it';
+    /**
+     * Compact conversation history via FREE Gemma models
+     *
+     * Automatically:
+     * - Chunks content > 128K tokens
+     * - Falls back between models if one unavailable
+     * - Returns $0 cost (100% free)
+     */
+    async compact(messages, helperConfig, targetTokens) {
+        const startTime = Date.now();
+        // Estimate original tokens
+        const originalText = this.extractTextContent(messages);
+        const originalTokens = this.estimateTokens(originalText);
+        // Compact content using Gemma
+        const response = await this.compactContent(originalText, helperConfig, targetTokens);
+        // Extract summary and calculate savings
+        const summary = response.summary;
+        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;
+        return {
+            summary,
+            compactedMessages,
+            originalTokens,
+            compressedTokens,
+            tokensSaved,
+            helperModelId: response.model, // Actual model used (may differ if fallback occurred)
+            processingTime,
+            cost: 0 // Gemma models are FREE!
+        };
+    }
+    /**
+     * Summarize tool result via FREE Gemma models
+     */
+    async summarizeToolResult(toolResult, helperConfig, maxTokens) {
+        const startTime = Date.now();
+        // Estimate original tokens
+        const originalTokens = this.estimateTokens(toolResult);
+        // Create summarization prompt
+        const prompt = `Summarize the following tool result in ${maxTokens} tokens or less, preserving essential information:\n\n${toolResult}`;
+        // Compact via Gemma
+        const response = await this.compactContent(prompt, helperConfig, maxTokens);
+        // Extract summary
+        const summary = response.summary;
+        const summaryTokens = response.outputTokens;
+        const tokensSaved = originalTokens - summaryTokens;
+        const processingTime = Date.now() - startTime;
+        return {
+            summary,
+            originalTokens,
+            summaryTokens,
+            tokensSaved,
+            helperModelId: response.model,
+            processingTime,
+            cost: 0 // Gemma models are FREE!
+        };
+    }
+    /**
+     * Compact content using free Gemma models
+     * Automatically handles content based on model's context limit (dynamic chunking)
+     */
+    async compactContent(content, helperConfig, maxTokens) {
+        const modelToUse = helperConfig.id || this.defaultModel;
+        const startTime = Date.now();
+        // Check if content needs chunking (uses model's actual context window)
+        if (this.needsChunking(content, helperConfig, maxTokens)) {
+            const contentTokens = this.estimateTokens(content);
+            const contextInfo = this.getContextInfo(helperConfig);
+            console.log(` ⚠  Content too large (${contentTokens} tokens) for ${contextInfo}, using smart chunking...`);
+            return await this.compactLargeContent(content, helperConfig, modelToUse, maxTokens, startTime);
+        }
+        // Get API client
+        const client = this.getClient(helperConfig);
+        try {
+            // Try primary model
+            const response = await this.tryModel(client, modelToUse, content, maxTokens);
+            return this.formatResponse(response, modelToUse, startTime, content);
+        }
+        catch (error) {
+            // If model not found, try fallback
+            if (error.message?.includes('404') || error.message?.includes('not found')) {
+                console.log(` Gemma model ${modelToUse} not available, trying ${this.fallbackModel}...`);
+                const response = await this.tryModel(client, this.fallbackModel, content, maxTokens);
+                return this.formatResponse(response, this.fallbackModel, startTime, content);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Try generating content with a specific model
+     */
+    async tryModel(client, model, content, maxTokens) {
+        const response = await client.models.generateContent({
+            model,
+            contents: `Summarize the following conversation history in ${maxTokens} tokens or less, preserving key topics and decisions:\n\n${content}`,
+        });
+        return response.text || '';
+    }
+    /**
+     * Format response with token estimates
+     */
+    formatResponse(summary, model, startTime, originalContent) {
+        const processingTime = Date.now() - startTime;
+        // Estimate tokens (4 chars per token heuristic)
+        const inputTokens = Math.floor(originalContent.length / 4);
+        const outputTokens = Math.floor(summary.length / 4);
+        return {
+            summary,
+            model,
+            processingTime,
+            inputTokens,
+            outputTokens,
+            cost: 0, // Gemma models are FREE!
+        };
+    }
+    /**
+     * Handle large content via chunking strategy
+     * Split content into chunks, compress each, then combine
+     * Uses smart chunking from base adapter (adapts to model's context limit)
+     */
+    async compactLargeContent(content, helperConfig, model, maxTokens, startTime) {
+        // Use base class smart chunking (dynamically calculates based on model config)
+        const chunks = this.chunkContent(content, helperConfig, maxTokens);
+        const chunkSummaries = [];
+        const client = this.getClient(helperConfig);
+        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 chunkSummary = await this.tryModel(client, model, chunk, Math.floor(maxTokens / chunks.length) // Distribute token budget
+                );
+                chunkSummaries.push(chunkSummary);
+            }
+            catch (error) {
+                console.warn(` ⚠  Chunk ${i + 1} failed: ${error.message}`);
+                // Include error marker in summary
+                chunkSummaries.push(`[Chunk ${i + 1} compression failed]`);
+            }
+        }
+        // Combine chunk summaries
+        const combinedSummary = chunkSummaries.join('\n\n---\n\n');
+        // If combined is still too large, do one final pass
+        const combinedTokens = this.estimateTokens(combinedSummary);
+        if (combinedTokens > maxTokens) {
+            console.log(` Final compression pass (${combinedTokens} → ${maxTokens} tokens)...`);
+            const finalSummary = await this.tryModel(client, model, `Combine and summarize these section summaries into ${maxTokens} tokens:\n\n${combinedSummary}`, maxTokens);
+            return this.formatResponse(finalSummary, model, startTime, content);
+        }
+        return this.formatResponse(combinedSummary, model, startTime, content);
+    }
+    /**
+     * Get Google GenAI client
+     */
+    getClient(config) {
+        // Get API key from environment
+        const apiKey = process.env[config.api.apiKeyEnvVar];
+        if (!apiKey) {
+            throw new Error(`GoogleGenAPIHelper: API key not found in environment variable: ${config.api.apiKeyEnvVar}`);
+        }
+        return new GoogleGenAI({ apiKey });
+    }
+    /**
+     * Override estimateTokens to use consistent heuristic
+     */
+    estimateTokens(content) {
+        return Math.ceil(content.length / 4);
+    }
+    /**
+     * Override calculateCost to always return $0 for Gemma models
+     */
+    calculateCost(_inputTokens, _outputTokens, _modelConfig) {
+        return 0; // Gemma models are 100% FREE
+    }
+    /**
+     * Get list of supported Gemma models (via Google GenAI API)
+     */
+    static getSupportedModels() {
+        return [
+            'gemma-3-27b-it', // High quality (27B params)
+            'gemma-3-12b-it', // Balanced (12B params)
+            'gemma-3-4b-it', // Fast (4B params)
+            'gemma-3-1b-it', // Ultra-fast (1B params)
+            'gemma-3n-e4b-it', // Efficient 4B variant
+            'gemma-3n-e2b-it', // Efficient 2B variant
+        ];
+    }
+}
+/**
+ * Pricing information for documentation
+ */
+export const GEMMA_PRICING = {
+    'gemma-3-27b-it': {
+        input: 0, // FREE
+        output: 0, // FREE
+        description: 'High-quality free model for summarization (27B params)',
+    },
+    'gemma-3-12b-it': {
+        input: 0, // FREE
+        output: 0, // FREE
+        description: 'Balanced quality/speed free model (12B params)',
+    },
+    'gemma-3-4b-it': {
+        input: 0, // FREE
+        output: 0, // FREE
+        description: 'Fast free model for quick compaction (4B params)',
+    },
+    'gemma-3-1b-it': {
+        input: 0, // FREE
+        output: 0, // FREE
+        description: 'Ultra-fast free model for rapid compaction (1B params)',
+    },
+    'gemma-3n-e4b-it': {
+        input: 0, // FREE
+        output: 0, // FREE
+        description: 'Efficient 4B variant optimized for speed',
+    },
+    'gemma-3n-e2b-it': {
+        input: 0, // FREE
+        output: 0, // FREE
+        description: 'Efficient 2B variant ultra-fast',
+    },
+};
+//# sourceMappingURL=GoogleGenAPIHelperAdapter.js.map

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

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

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

@@ -0,0 +1,71 @@
+/**
+ * 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, type HelperCanonicalMessage, type CompactionResult, type ToolSummaryResult } from '../HelperMiddlewareAdapter.interface.js';
+import type { ModelConfig } from '../../../models/ModelConfig.interface.js';
+/**
+ * Messages API format (simplified for helper use)
+ */
+interface MessagesAPIMessage {
+    role: 'user' | 'assistant';
+    content: string | Array<{
+        type: 'text';
+        text: string;
+    }>;
+}
+interface MessagesAPIResponse {
+    id: string;
+    type: 'message';
+    role: 'assistant';
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    model: string;
+    stop_reason: string;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+}
+/**
+ * Helper adapter for Messages API pattern
+ *
+ * Supports: Anthropic Claude, XAI Grok (any model using /v1/messages pattern)
+ */
+export declare class MessagesAPIHelperAdapter extends BaseHelperAdapter {
+    readonly apiPattern = "messages";
+    readonly name = "MessagesAPIHelperAdapter";
+    /**
+     * Compact conversation history via Messages API helper model
+     */
+    compact(messages: HelperCanonicalMessage[], helperConfig: ModelConfig, targetTokens: number): Promise<CompactionResult>;
+    /**
+     * Summarize tool result via Messages API helper model
+     */
+    summarizeToolResult(toolResult: string, helperConfig: ModelConfig, maxTokens: number): Promise<ToolSummaryResult>;
+    /**
+     * Compact with chunking for large content
+     * Uses smart chunking from base adapter
+     */
+    private compactWithChunking;
+    generate(messages: HelperCanonicalMessage[], helperConfig: ModelConfig, maxTokens: number): Promise<string>;
+    /**
+     * Make real API call to Messages API endpoint
+     *
+     * CRITICAL: This makes REAL API calls, not mocks!
+     */
+    protected makeAPICall(config: ModelConfig, messages: MessagesAPIMessage[], maxTokens: number, systemPrompt?: string): Promise<MessagesAPIResponse>;
+}
+export {};
+//# sourceMappingURL=MessagesAPIHelperAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MessagesAPIHelperAdapter.d.ts","sourceRoot":"","sources":["../../../../src/middleware/helpers/adapters/MessagesAPIHelperAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;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;AAO5E;;GAEG;AACH,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ;AAUD,UAAU,mBAAmB;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;;;GAIG;AACH,qBAAa,wBAAyB,SAAQ,iBAAiB;IAC7D,QAAQ,CAAC,UAAU,cAAc;IACjC,QAAQ,CAAC,IAAI,8BAA8B;IAE3C;;OAEG;IACG,OAAO,CACX,QAAQ,EAAE,sBAAsB,EAAE,EAClC,YAAY,EAAE,WAAW,EACzB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC;IA6D5B;;OAEG;IACG,mBAAmB,CACvB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,WAAW,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC;IAuC7B;;;OAGG;YACW,mBAAmB;IAgG3B,QAAQ,CACZ,QAAQ,EAAE,sBAAsB,EAAE,EAClC,YAAY,EAAE,WAAW,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC;IAelB;;;;OAIG;cACa,WAAW,CACzB,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,kBAAkB,EAAE,EAC9B,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,CAAC;CAwFhC"}