@nexus-cortex/core 4.26.0

package/dist/models/configurators/GoogleConfigurator.js

@@ -0,0 +1,91 @@
+/**
+ * Google Gemini Model Configurator (GenerateContent API)
+ *
+ * Factory functions for creating Google Gemini model configurations using the GenerateContent API pattern.
+ * Handles Gemini 1.5, 2.0, and 2.5 families.
+ *
+ * Phase 1: Configurator Extraction
+ */
+export function createGeminiModelConfig(options) {
+    return {
+        id: options.id,
+        provider: 'google',
+        displayName: options.displayName,
+        family: options.family,
+        api: {
+            pattern: 'generateContent',
+            endpoint: 'https://generativelanguage.googleapis.com/v1beta/models',
+            apiKeyEnvVar: 'GEMINI_API_KEY',
+            authHeader: 'x-goog-api-key'
+        },
+        tools: {
+            supported: true,
+            adapter: 'GenerateContentAPIAdapter',
+            namingConvention: 'snake_case',
+            maxTools: 64,
+            parallelToolCalls: true
+        },
+        parameters: {
+            temperature: {
+                supported: true,
+                paramName: 'temperature',
+                min: 0.0,
+                max: 2.0,
+                path: 'generationConfig.temperature'
+            },
+            maxTokens: {
+                supported: true,
+                paramName: 'maxOutputTokens',
+                default: 8192,
+                min: 1,
+                max: options.outputTokens,
+                path: 'generationConfig.maxOutputTokens'
+            },
+            topP: {
+                supported: true,
+                paramName: 'topP',
+                default: 0.95,
+                min: 0.0,
+                max: 1.0,
+                path: 'generationConfig.topP'
+            },
+            topK: {
+                supported: true,
+                paramName: 'topK',
+                default: 40,
+                min: 1,
+                max: 100,
+                path: 'generationConfig.topK'
+            }
+        },
+        limits: {
+            contextWindow: options.contextWindow,
+            outputTokens: options.outputTokens,
+            requestsPerMinute: 2000,
+            tokensPerMinute: 4000000
+        },
+        streaming: {
+            supported: true,
+            format: 'json_stream'
+        },
+        reasoning: options.reasoning,
+        compaction: {
+            strategy: 'auto',
+            thresholdCalculation: {
+                method: 'percentage',
+                percentage: 0.8,
+                safetyMargin: 8000
+            },
+            behavior: {
+                preserveRecent: 10,
+                compactOlder: true,
+                useHelperModel: false
+            }
+        },
+        cost: {
+            inputPerMillion: options.inputCost,
+            outputPerMillion: options.outputCost
+        }
+    };
+}
+//# sourceMappingURL=GoogleConfigurator.js.map

package/dist/models/configurators/GoogleConfigurator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleConfigurator.js","sourceRoot":"","sources":["../../../src/models/configurators/GoogleConfigurator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoBH,MAAM,UAAU,uBAAuB,CAAC,OAA2B;IACjE,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;QAEtB,GAAG,EAAE;YACH,OAAO,EAAE,iBAAiB;YAC1B,QAAQ,EAAE,yDAAyD;YACnE,YAAY,EAAE,gBAAgB;YAC9B,UAAU,EAAE,gBAAgB;SAC7B;QAED,KAAK,EAAE;YACL,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,2BAA2B;YACpC,gBAAgB,EAAE,YAAY;YAC9B,QAAQ,EAAE,EAAE;YACZ,iBAAiB,EAAE,IAAI;SACxB;QAED,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,aAAa;gBACxB,GAAG,EAAE,GAAG;gBACR,GAAG,EAAE,GAAG;gBACR,IAAI,EAAE,8BAA8B;aACrC;YACD,SAAS,EAAE;gBACT,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,iBAAiB;gBAC5B,OAAO,EAAE,IAAI;gBACb,GAAG,EAAE,CAAC;gBACN,GAAG,EAAE,OAAO,CAAC,YAAY;gBACzB,IAAI,EAAE,kCAAkC;aACzC;YACD,IAAI,EAAE;gBACJ,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,MAAM;gBACjB,OAAO,EAAE,IAAI;gBACb,GAAG,EAAE,GAAG;gBACR,GAAG,EAAE,GAAG;gBACR,IAAI,EAAE,uBAAuB;aAC9B;YACD,IAAI,EAAE;gBACJ,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,MAAM;gBACjB,OAAO,EAAE,EAAE;gBACX,GAAG,EAAE,CAAC;gBACN,GAAG,EAAE,GAAG;gBACR,IAAI,EAAE,uBAAuB;aAC9B;SACF;QAED,MAAM,EAAE;YACN,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,iBAAiB,EAAE,IAAI;YACvB,eAAe,EAAE,OAAO;SACzB;QAED,SAAS,EAAE;YACT,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,aAAa;SACtB;QAED,SAAS,EAAE,OAAO,CAAC,SAAS;QAE5B,UAAU,EAAE;YACV,QAAQ,EAAE,MAAM;YAChB,oBAAoB,EAAE;gBACpB,MAAM,EAAE,YAAY;gBACpB,UAAU,EAAE,GAAG;gBACf,YAAY,EAAE,IAAI;aACnB;YACD,QAAQ,EAAE;gBACR,cAAc,EAAE,EAAE;gBAClB,YAAY,EAAE,IAAI;gBAClB,cAAc,EAAE,KAAK;aACtB;SACF;QAED,IAAI,EAAE;YACJ,eAAe,EAAE,OAAO,CAAC,SAAS;YAClC,gBAAgB,EAAE,OAAO,CAAC,UAAU;SACrC;KACF,CAAC;AACJ,CAAC"}

package/dist/models/configurators/GoogleSDKConfigurator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Google Gemini Model Configurator (SDK-based - EXPERIMENTAL)
+ *
+ * Alternative configurator using @google/generative-ai SDK directly instead of REST API.
+ * This matches Google's official documentation examples more closely.
+ *
+ * Key differences from GoogleConfigurator:
+ * - Uses 'google-genai' pattern (SDK) instead of 'generateContent' (REST)
+ * - May have better performance and stability
+ * - Supports both GOOGLE_API_KEY and GEMINI_API_KEY
+ */
+import type { ModelConfig } from '../ModelConfig.interface.js';
+export interface GeminiSDKModelOptions {
+    id: string;
+    displayName: string;
+    family: string;
+    contextWindow: number;
+    outputTokens: number;
+    inputCost: number;
+    outputCost: number;
+    reasoning?: {
+        supported: boolean;
+        format?: 'reasoning_content' | 'thinking_block';
+        extractionMethod?: 'content_block' | 'separate_field';
+        pattern?: 'upfront' | 'interleaved';
+    };
+}
+export declare function createGeminiSDKModelConfig(options: GeminiSDKModelOptions): ModelConfig;
+//# sourceMappingURL=GoogleSDKConfigurator.d.ts.map

package/dist/models/configurators/GoogleSDKConfigurator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleSDKConfigurator.d.ts","sourceRoot":"","sources":["../../../src/models/configurators/GoogleSDKConfigurator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE;QACV,SAAS,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,mBAAmB,GAAG,gBAAgB,CAAC;QAChD,gBAAgB,CAAC,EAAE,eAAe,GAAG,gBAAgB,CAAC;QACtD,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;KACrC,CAAC;CACH;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,qBAAqB,GAAG,WAAW,CA0FtF"}

package/dist/models/configurators/GoogleSDKConfigurator.js

@@ -0,0 +1,95 @@
+/**
+ * Google Gemini Model Configurator (SDK-based - EXPERIMENTAL)
+ *
+ * Alternative configurator using @google/generative-ai SDK directly instead of REST API.
+ * This matches Google's official documentation examples more closely.
+ *
+ * Key differences from GoogleConfigurator:
+ * - Uses 'google-genai' pattern (SDK) instead of 'generateContent' (REST)
+ * - May have better performance and stability
+ * - Supports both GOOGLE_API_KEY and GEMINI_API_KEY
+ */
+export function createGeminiSDKModelConfig(options) {
+    return {
+        id: options.id,
+        provider: 'google',
+        displayName: `${options.displayName} (SDK)`,
+        family: options.family,
+        api: {
+            pattern: 'google-sdk', // New pattern for SDK-based approach
+            endpoint: 'https://generativelanguage.googleapis.com/v1beta/models',
+            // SDK checks both GEMINI_API_KEY and GOOGLE_API_KEY directly in APIClient
+            apiKeyEnvVar: 'GEMINI_API_KEY',
+            authHeader: 'x-goog-api-key'
+        },
+        tools: {
+            supported: true,
+            adapter: 'GenerateContentAPIAdapter', // Same tool format as REST API
+            namingConvention: 'snake_case',
+            maxTools: 64,
+            parallelToolCalls: true
+        },
+        parameters: {
+            temperature: {
+                supported: true,
+                paramName: 'temperature',
+                min: 0.0,
+                max: 2.0,
+                path: 'generationConfig.temperature'
+            },
+            maxTokens: {
+                supported: true,
+                paramName: 'maxOutputTokens',
+                default: 8192,
+                min: 1,
+                max: options.outputTokens,
+                path: 'generationConfig.maxOutputTokens'
+            },
+            topP: {
+                supported: true,
+                paramName: 'topP',
+                default: 0.95,
+                min: 0.0,
+                max: 1.0,
+                path: 'generationConfig.topP'
+            },
+            topK: {
+                supported: true,
+                paramName: 'topK',
+                default: 40,
+                min: 1,
+                max: 100,
+                path: 'generationConfig.topK'
+            }
+        },
+        limits: {
+            contextWindow: options.contextWindow,
+            outputTokens: options.outputTokens,
+            requestsPerMinute: 2000,
+            tokensPerMinute: 4000000
+        },
+        streaming: {
+            supported: true,
+            format: 'json_stream'
+        },
+        reasoning: options.reasoning,
+        compaction: {
+            strategy: 'auto',
+            thresholdCalculation: {
+                method: 'percentage',
+                percentage: 0.75,
+                safetyMargin: 8000
+            },
+            behavior: {
+                preserveRecent: 10,
+                compactOlder: true,
+                useHelperModel: true
+            }
+        },
+        cost: {
+            inputPerMillion: options.inputCost,
+            outputPerMillion: options.outputCost
+        }
+    };
+}
+//# sourceMappingURL=GoogleSDKConfigurator.js.map

package/dist/models/configurators/GoogleSDKConfigurator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleSDKConfigurator.js","sourceRoot":"","sources":["../../../src/models/configurators/GoogleSDKConfigurator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAoBH,MAAM,UAAU,0BAA0B,CAAC,OAA8B;IACvE,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,QAAQ;QAC3C,MAAM,EAAE,OAAO,CAAC,MAAM;QAEtB,GAAG,EAAE;YACH,OAAO,EAAE,YAAY,EAAG,qCAAqC;YAC7D,QAAQ,EAAE,yDAAyD;YACnE,0EAA0E;YAC1E,YAAY,EAAE,gBAAgB;YAC9B,UAAU,EAAE,gBAAgB;SAC7B;QAED,KAAK,EAAE;YACL,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,2BAA2B,EAAG,+BAA+B;YACtE,gBAAgB,EAAE,YAAY;YAC9B,QAAQ,EAAE,EAAE;YACZ,iBAAiB,EAAE,IAAI;SACxB;QAED,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,aAAa;gBACxB,GAAG,EAAE,GAAG;gBACR,GAAG,EAAE,GAAG;gBACR,IAAI,EAAE,8BAA8B;aACrC;YACD,SAAS,EAAE;gBACT,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,iBAAiB;gBAC5B,OAAO,EAAE,IAAI;gBACb,GAAG,EAAE,CAAC;gBACN,GAAG,EAAE,OAAO,CAAC,YAAY;gBACzB,IAAI,EAAE,kCAAkC;aACzC;YACD,IAAI,EAAE;gBACJ,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,MAAM;gBACjB,OAAO,EAAE,IAAI;gBACb,GAAG,EAAE,GAAG;gBACR,GAAG,EAAE,GAAG;gBACR,IAAI,EAAE,uBAAuB;aAC9B;YACD,IAAI,EAAE;gBACJ,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,MAAM;gBACjB,OAAO,EAAE,EAAE;gBACX,GAAG,EAAE,CAAC;gBACN,GAAG,EAAE,GAAG;gBACR,IAAI,EAAE,uBAAuB;aAC9B;SACF;QAED,MAAM,EAAE;YACN,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,iBAAiB,EAAE,IAAI;YACvB,eAAe,EAAE,OAAO;SACzB;QAED,SAAS,EAAE;YACT,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,aAAa;SACtB;QAED,SAAS,EAAE,OAAO,CAAC,SAAS;QAE5B,UAAU,EAAE;YACV,QAAQ,EAAE,MAAM;YAChB,oBAAoB,EAAE;gBACpB,MAAM,EAAE,YAAY;gBACpB,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,IAAI;aACnB;YACD,QAAQ,EAAE;gBACR,cAAc,EAAE,EAAE;gBAClB,YAAY,EAAE,IAAI;gBAClB,cAAc,EAAE,IAAI;aACrB;SACF;QAED,IAAI,EAAE;YACJ,eAAe,EAAE,OAAO,CAAC,SAAS;YAClC,gBAAgB,EAAE,OAAO,CAAC,UAAU;SACrC;KACF,CAAC;AACJ,CAAC"}

package/dist/models/configurators/HuggingFaceConfigurator.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Hugging Face Model Configurator
+ *
+ * Factory function for creating Hugging Face Inference API model configurations.
+ * Supports serverless inference API and dedicated inference endpoints.
+ *
+ * API Docs: https://huggingface.co/docs/api-inference/index
+ */
+import type { ModelConfig } from '../ModelConfig.interface.js';
+export interface HuggingFaceModelOptions {
+    id: string;
+    displayName: string;
+    family: string;
+    contextWindow: number;
+    outputTokens: number;
+    inputCost?: number;
+    outputCost?: number;
+    supportsTools?: boolean;
+    /**
+     * Hugging Face model ID (e.g., 'meta-llama/Meta-Llama-3-8B-Instruct')
+     * If not provided, uses the 'id' field
+     */
+    huggingFaceModelId?: string;
+    /**
+     * For dedicated inference endpoints (optional)
+     * Format: https://[endpoint-id].us-east-1.aws.endpoints.huggingface.cloud
+     */
+    customEndpoint?: string;
+}
+export declare function createHuggingFaceModelConfig(options: HuggingFaceModelOptions): ModelConfig;
+//# sourceMappingURL=HuggingFaceConfigurator.d.ts.map

package/dist/models/configurators/HuggingFaceConfigurator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HuggingFaceConfigurator.d.ts","sourceRoot":"","sources":["../../../src/models/configurators/HuggingFaceConfigurator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,uBAAuB,GAAG,WAAW,CAoF1F"}

package/dist/models/configurators/HuggingFaceConfigurator.js

@@ -0,0 +1,85 @@
+/**
+ * Hugging Face Model Configurator
+ *
+ * Factory function for creating Hugging Face Inference API model configurations.
+ * Supports serverless inference API and dedicated inference endpoints.
+ *
+ * API Docs: https://huggingface.co/docs/api-inference/index
+ */
+export function createHuggingFaceModelConfig(options) {
+    const supportsTools = options.supportsTools !== undefined ? options.supportsTools : false;
+    const modelId = options.huggingFaceModelId || options.id;
+    // Use custom endpoint if provided, otherwise use serverless inference API
+    const endpoint = options.customEndpoint ||
+        `https://api-inference.huggingface.co/models/${modelId}`;
+    return {
+        id: options.id,
+        provider: 'huggingface',
+        displayName: options.displayName,
+        family: options.family,
+        api: {
+            pattern: 'chat/completions', // Hugging Face uses OpenAI-compatible format
+            endpoint: endpoint,
+            apiKeyEnvVar: 'HUGGINGFACE_API_KEY',
+            authHeader: 'Authorization',
+            authPrefix: 'Bearer'
+        },
+        tools: {
+            supported: supportsTools,
+            adapter: 'ChatCompletionsAPIAdapter',
+            namingConvention: 'snake_case',
+            maxTools: supportsTools ? 128 : 0,
+            parallelToolCalls: supportsTools
+        },
+        parameters: {
+            temperature: {
+                supported: true,
+                paramName: 'temperature',
+                min: 0.0,
+                max: 2.0
+            },
+            maxTokens: {
+                supported: true,
+                paramName: 'max_tokens',
+                default: 2048,
+                min: 1,
+                max: options.outputTokens
+            },
+            topP: {
+                supported: true,
+                paramName: 'top_p',
+                default: 0.95,
+                min: 0.0,
+                max: 1.0
+            }
+        },
+        limits: {
+            contextWindow: options.contextWindow,
+            outputTokens: options.outputTokens,
+            requestsPerMinute: 100, // Serverless API limits
+            tokensPerMinute: 100000 // Varies by tier
+        },
+        streaming: {
+            supported: true,
+            format: 'sse'
+        },
+        compaction: {
+            strategy: 'auto',
+            thresholdCalculation: {
+                method: 'percentage',
+                percentage: 0.8,
+                safetyMargin: 4000
+            },
+            behavior: {
+                preserveRecent: 10,
+                compactOlder: true,
+                useHelperModel: false
+            }
+        },
+        cost: {
+            inputPerMillion: options.inputCost || 0.0, // Serverless is free (rate-limited)
+            outputPerMillion: options.outputCost || 0.0
+        }
+    };
+}
+//# sourceMappingURL=HuggingFaceConfigurator.js.map

package/dist/models/configurators/HuggingFaceConfigurator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HuggingFaceConfigurator.js","sourceRoot":"","sources":["../../../src/models/configurators/HuggingFaceConfigurator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2BH,MAAM,UAAU,4BAA4B,CAAC,OAAgC;IAC3E,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1F,MAAM,OAAO,GAAG,OAAO,CAAC,kBAAkB,IAAI,OAAO,CAAC,EAAE,CAAC;IAEzD,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc;QACvB,+CAA+C,OAAO,EAAE,CAAC;IAEzE,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,QAAQ,EAAE,aAAa;QACvB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;QAEtB,GAAG,EAAE;YACH,OAAO,EAAE,kBAAkB,EAAG,6CAA6C;YAC3E,QAAQ,EAAE,QAAQ;YAClB,YAAY,EAAE,qBAAqB;YACnC,UAAU,EAAE,eAAe;YAC3B,UAAU,EAAE,QAAQ;SACrB;QAED,KAAK,EAAE;YACL,SAAS,EAAE,aAAa;YACxB,OAAO,EAAE,2BAA2B;YACpC,gBAAgB,EAAE,YAAY;YAC9B,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACjC,iBAAiB,EAAE,aAAa;SACjC;QAED,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,aAAa;gBACxB,GAAG,EAAE,GAAG;gBACR,GAAG,EAAE,GAAG;aACT;YACD,SAAS,EAAE;gBACT,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,YAAY;gBACvB,OAAO,EAAE,IAAI;gBACb,GAAG,EAAE,CAAC;gBACN,GAAG,EAAE,OAAO,CAAC,YAAY;aAC1B;YACD,IAAI,EAAE;gBACJ,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,OAAO;gBAClB,OAAO,EAAE,IAAI;gBACb,GAAG,EAAE,GAAG;gBACR,GAAG,EAAE,GAAG;aACT;SACF;QAED,MAAM,EAAE;YACN,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,iBAAiB,EAAE,GAAG,EAAK,wBAAwB;YACnD,eAAe,EAAE,MAAM,CAAI,iBAAiB;SAC7C;QAED,SAAS,EAAE;YACT,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,KAAK;SACd;QAED,UAAU,EAAE;YACV,QAAQ,EAAE,MAAM;YAChB,oBAAoB,EAAE;gBACpB,MAAM,EAAE,YAAY;gBACpB,UAAU,EAAE,GAAG;gBACf,YAAY,EAAE,IAAI;aACnB;YACD,QAAQ,EAAE;gBACR,cAAc,EAAE,EAAE;gBAClB,YAAY,EAAE,IAAI;gBAClB,cAAc,EAAE,KAAK;aACtB;SACF;QAED,IAAI,EAAE;YACJ,eAAe,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG,EAAI,oCAAoC;YACjF,gBAAgB,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG;SAC5C;KACF,CAAC;AACJ,CAAC"}

package/dist/models/configurators/LocalModelConfigurator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Local Model Configurator
+ *
+ * Factory function for creating local model configurations.
+ * Supports LMStudio, Ollama, LocalAI, and any OpenAI-compatible local server.
+ *
+ * Features:
+ * - Custom endpoint configuration (default: http://localhost:1234)
+ * - Optional API key (many local servers don't require auth)
+ * - Zero cost (local inference)
+ * - OpenAI-compatible API pattern
+ */
+import type { ModelConfig } from '../ModelConfig.interface.js';
+export interface LocalModelOptions {
+    id: string;
+    displayName: string;
+    family: string;
+    contextWindow: number;
+    outputTokens: number;
+    /** Local server endpoint (e.g., http://localhost:1234/v1) */
+    endpoint?: string;
+    /** API key environment variable (optional, many local servers don't need auth) */
+    apiKeyEnvVar?: string;
+    /** Whether the model supports tool calling */
+    supportsTools?: boolean;
+    /** Custom provider name (default: 'local') */
+    provider?: string;
+}
+export declare function createLocalModelConfig(options: LocalModelOptions): ModelConfig;
+//# sourceMappingURL=LocalModelConfigurator.d.ts.map

package/dist/models/configurators/LocalModelConfigurator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalModelConfigurator.d.ts","sourceRoot":"","sources":["../../../src/models/configurators/LocalModelConfigurator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IAErB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,WAAW,CAkF9E"}

package/dist/models/configurators/LocalModelConfigurator.js

@@ -0,0 +1,88 @@
+/**
+ * Local Model Configurator
+ *
+ * Factory function for creating local model configurations.
+ * Supports LMStudio, Ollama, LocalAI, and any OpenAI-compatible local server.
+ *
+ * Features:
+ * - Custom endpoint configuration (default: http://localhost:1234)
+ * - Optional API key (many local servers don't require auth)
+ * - Zero cost (local inference)
+ * - OpenAI-compatible API pattern
+ */
+export function createLocalModelConfig(options) {
+    const endpoint = options.endpoint || 'http://localhost:1234/v1/chat/completions';
+    const apiKeyEnvVar = options.apiKeyEnvVar || 'LOCAL_MODEL_API_KEY';
+    const supportsTools = options.supportsTools !== undefined ? options.supportsTools : true;
+    const provider = options.provider || 'local';
+    return {
+        id: options.id,
+        provider: provider,
+        displayName: options.displayName,
+        family: options.family,
+        api: {
+            pattern: 'chat/completions',
+            endpoint: endpoint,
+            apiKeyEnvVar: apiKeyEnvVar,
+            authHeader: 'Authorization',
+            authPrefix: 'Bearer'
+        },
+        tools: {
+            supported: supportsTools,
+            adapter: 'ChatCompletionsAPIAdapter',
+            namingConvention: 'snake_case',
+            maxTools: supportsTools ? 128 : 0,
+            parallelToolCalls: supportsTools
+        },
+        parameters: {
+            temperature: {
+                supported: true,
+                paramName: 'temperature',
+                min: 0.0,
+                max: 2.0
+            },
+            maxTokens: {
+                supported: true,
+                paramName: 'max_tokens',
+                default: 4096,
+                min: 1,
+                max: options.outputTokens
+            },
+            topP: {
+                supported: true,
+                paramName: 'top_p',
+                default: 1.0,
+                min: 0.0,
+                max: 1.0
+            }
+        },
+        limits: {
+            contextWindow: options.contextWindow,
+            outputTokens: options.outputTokens,
+            requestsPerMinute: 1000, // No rate limits for local
+            tokensPerMinute: 1000000 // No rate limits for local
+        },
+        streaming: {
+            supported: true,
+            format: 'sse'
+        },
+        compaction: {
+            strategy: 'auto',
+            thresholdCalculation: {
+                method: 'percentage',
+                percentage: 0.8,
+                safetyMargin: 4000
+            },
+            behavior: {
+                preserveRecent: 10,
+                compactOlder: true,
+                useHelperModel: false // Don't use helper for local models
+            }
+        },
+        cost: {
+            inputPerMillion: 0.0, // FREE - local inference
+            outputPerMillion: 0.0 // FREE - local inference
+        }
+    };
+}
+//# sourceMappingURL=LocalModelConfigurator.js.map

package/dist/models/configurators/LocalModelConfigurator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalModelConfigurator.js","sourceRoot":"","sources":["../../../src/models/configurators/LocalModelConfigurator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAwBH,MAAM,UAAU,sBAAsB,CAAC,OAA0B;IAC/D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,2CAA2C,CAAC;IACjF,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,qBAAqB,CAAC;IACnE,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;IACzF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC;IAE7C,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;QAEtB,GAAG,EAAE;YACH,OAAO,EAAE,kBAAkB;YAC3B,QAAQ,EAAE,QAAQ;YAClB,YAAY,EAAE,YAAY;YAC1B,UAAU,EAAE,eAAe;YAC3B,UAAU,EAAE,QAAQ;SACrB;QAED,KAAK,EAAE;YACL,SAAS,EAAE,aAAa;YACxB,OAAO,EAAE,2BAA2B;YACpC,gBAAgB,EAAE,YAAY;YAC9B,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACjC,iBAAiB,EAAE,aAAa;SACjC;QAED,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,aAAa;gBACxB,GAAG,EAAE,GAAG;gBACR,GAAG,EAAE,GAAG;aACT;YACD,SAAS,EAAE;gBACT,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,YAAY;gBACvB,OAAO,EAAE,IAAI;gBACb,GAAG,EAAE,CAAC;gBACN,GAAG,EAAE,OAAO,CAAC,YAAY;aAC1B;YACD,IAAI,EAAE;gBACJ,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,OAAO;gBAClB,OAAO,EAAE,GAAG;gBACZ,GAAG,EAAE,GAAG;gBACR,GAAG,EAAE,GAAG;aACT;SACF;QAED,MAAM,EAAE;YACN,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,iBAAiB,EAAE,IAAI,EAAG,2BAA2B;YACrD,eAAe,EAAE,OAAO,CAAE,2BAA2B;SACtD;QAED,SAAS,EAAE;YACT,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,KAAK;SACd;QAED,UAAU,EAAE;YACV,QAAQ,EAAE,MAAM;YAChB,oBAAoB,EAAE;gBACpB,MAAM,EAAE,YAAY;gBACpB,UAAU,EAAE,GAAG;gBACf,YAAY,EAAE,IAAI;aACnB;YACD,QAAQ,EAAE;gBACR,cAAc,EAAE,EAAE;gBAClB,YAAY,EAAE,IAAI;gBAClB,cAAc,EAAE,KAAK,CAAE,oCAAoC;aAC5D;SACF;QAED,IAAI,EAAE;YACJ,eAAe,EAAE,GAAG,EAAI,yBAAyB;YACjD,gBAAgB,EAAE,GAAG,CAAG,yBAAyB;SAClD;KACF,CAAC;AACJ,CAAC"}

package/dist/models/configurators/MercuryConfigurator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Mercury (Inception Labs) Model Configurator
+ *
+ * Factory for Inception Labs Mercury models — diffusion LLMs (dLLM) served over
+ * an OpenAI-compatible Chat Completions API. Verified against the live model
+ * list at https://api.inceptionlabs.ai/v1/models (2026-06-07).
+ *
+ * Notes vs the DeepSeek template this is based on:
+ * - NO `top_p`: the API advertises only `temperature` and `stop` as supported
+ *   sampling parameters, so we don't send top_p.
+ * - NO reasoning config: diffusion refinement is internal, there is no
+ *   thinking/reasoning channel to extract.
+ * - Tools ARE supported (features: tools, json_mode, structured_outputs).
+ */
+import type { ModelConfig } from '../ModelConfig.interface.js';
+export interface MercuryModelOptions {
+    id: string;
+    displayName: string;
+    family: string;
+    contextWindow: number;
+    outputTokens: number;
+    inputCost: number;
+    outputCost: number;
+    cachedInputCost?: number;
+}
+export declare function createMercuryModelConfig(options: MercuryModelOptions): ModelConfig;
+//# sourceMappingURL=MercuryConfigurator.d.ts.map

package/dist/models/configurators/MercuryConfigurator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MercuryConfigurator.d.ts","sourceRoot":"","sources":["../../../src/models/configurators/MercuryConfigurator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,GAAG,WAAW,CAmFlF"}

package/dist/models/configurators/MercuryConfigurator.js

@@ -0,0 +1,91 @@
+/**
+ * Mercury (Inception Labs) Model Configurator
+ *
+ * Factory for Inception Labs Mercury models — diffusion LLMs (dLLM) served over
+ * an OpenAI-compatible Chat Completions API. Verified against the live model
+ * list at https://api.inceptionlabs.ai/v1/models (2026-06-07).
+ *
+ * Notes vs the DeepSeek template this is based on:
+ * - NO `top_p`: the API advertises only `temperature` and `stop` as supported
+ *   sampling parameters, so we don't send top_p.
+ * - NO reasoning config: diffusion refinement is internal, there is no
+ *   thinking/reasoning channel to extract.
+ * - Tools ARE supported (features: tools, json_mode, structured_outputs).
+ */
+export function createMercuryModelConfig(options) {
+    return {
+        id: options.id,
+        provider: 'mercury',
+        displayName: options.displayName,
+        family: options.family,
+        api: {
+            pattern: 'chat/completions',
+            endpoint: 'https://api.inceptionlabs.ai/v1/chat/completions',
+            apiKeyEnvVar: 'INCEPTION_API_KEY',
+            authHeader: 'Authorization',
+            authPrefix: 'Bearer'
+        },
+        tools: {
+            supported: true,
+            adapter: 'ChatCompletionsAPIAdapter',
+            namingConvention: 'snake_case',
+            maxTools: 128,
+            parallelToolCalls: true
+        },
+        parameters: {
+            temperature: {
+                supported: true,
+                paramName: 'temperature',
+                min: 0.0,
+                max: 2.0
+            },
+            maxTokens: {
+                supported: true,
+                paramName: 'max_tokens',
+                default: 4096,
+                min: 1,
+                max: options.outputTokens
+            },
+            // Inception advertises only `temperature` + `stop` as supported sampling
+            // params, so top_p is marked unsupported (the harness passes through only
+            // caller-provided params, so this is metadata, not an injected default).
+            topP: {
+                supported: false,
+                paramName: 'top_p',
+                default: 1.0,
+                min: 0.0,
+                max: 1.0
+            }
+        },
+        limits: {
+            contextWindow: options.contextWindow,
+            outputTokens: options.outputTokens,
+            requestsPerMinute: 500,
+            tokensPerMinute: 500000
+        },
+        streaming: {
+            supported: true,
+            format: 'sse'
+        },
+        compaction: {
+            strategy: 'auto',
+            thresholdCalculation: {
+                method: 'percentage',
+                percentage: 0.8,
+                safetyMargin: 4000
+            },
+            behavior: {
+                preserveRecent: 10,
+                compactOlder: true,
+                useHelperModel: true
+            }
+        },
+        cost: {
+            inputPerMillion: options.inputCost,
+            outputPerMillion: options.outputCost,
+            ...(options.cachedInputCost !== undefined && { cachedInputPerMillion: options.cachedInputCost })
+        }
+        // No reasoning: Mercury is a diffusion model — refinement is internal.
+    };
+}
+//# sourceMappingURL=MercuryConfigurator.js.map

package/dist/models/configurators/MercuryConfigurator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MercuryConfigurator.js","sourceRoot":"","sources":["../../../src/models/configurators/MercuryConfigurator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,MAAM,UAAU,wBAAwB,CAAC,OAA4B;IACnE,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;QAEtB,GAAG,EAAE;YACH,OAAO,EAAE,kBAAkB;YAC3B,QAAQ,EAAE,kDAAkD;YAC5D,YAAY,EAAE,mBAAmB;YACjC,UAAU,EAAE,eAAe;YAC3B,UAAU,EAAE,QAAQ;SACrB;QAED,KAAK,EAAE;YACL,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,2BAA2B;YACpC,gBAAgB,EAAE,YAAY;YAC9B,QAAQ,EAAE,GAAG;YACb,iBAAiB,EAAE,IAAI;SACxB;QAED,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,aAAa;gBACxB,GAAG,EAAE,GAAG;gBACR,GAAG,EAAE,GAAG;aACT;YACD,SAAS,EAAE;gBACT,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,YAAY;gBACvB,OAAO,EAAE,IAAI;gBACb,GAAG,EAAE,CAAC;gBACN,GAAG,EAAE,OAAO,CAAC,YAAY;aAC1B;YACD,yEAAyE;YACzE,0EAA0E;YAC1E,yEAAyE;YACzE,IAAI,EAAE;gBACJ,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,OAAO;gBAClB,OAAO,EAAE,GAAG;gBACZ,GAAG,EAAE,GAAG;gBACR,GAAG,EAAE,GAAG;aACT;SACF;QAED,MAAM,EAAE;YACN,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,iBAAiB,EAAE,GAAG;YACtB,eAAe,EAAE,MAAM;SACxB;QAED,SAAS,EAAE;YACT,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,KAAK;SACd;QAED,UAAU,EAAE;YACV,QAAQ,EAAE,MAAM;YAChB,oBAAoB,EAAE;gBACpB,MAAM,EAAE,YAAY;gBACpB,UAAU,EAAE,GAAG;gBACf,YAAY,EAAE,IAAI;aACnB;YACD,QAAQ,EAAE;gBACR,cAAc,EAAE,EAAE;gBAClB,YAAY,EAAE,IAAI;gBAClB,cAAc,EAAE,IAAI;aACrB;SACF;QAED,IAAI,EAAE;YACJ,eAAe,EAAE,OAAO,CAAC,SAAS;YAClC,gBAAgB,EAAE,OAAO,CAAC,UAAU;YACpC,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,EAAE,qBAAqB,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;SACjG;QAED,uEAAuE;KACxE,CAAC;AACJ,CAAC"}

package/dist/models/configurators/MiniMaxConfigurator.d.ts

@@ -0,0 +1,47 @@
+/**
+ * MiniMax Model Configurator
+ *
+ * Factory function for creating MiniMax model configurations.
+ * MiniMax uses Anthropic-compatible Messages API pattern.
+ *
+ * API Docs: https://platform.minimaxi.com/document/Announcement?key=66701cf306509505e38e5fe8
+ */
+import type { ModelConfig } from '../ModelConfig.interface.js';
+export interface MiniMaxModelOptions {
+    id: string;
+    displayName: string;
+    family: string;
+    contextWindow: number;
+    outputTokens: number;
+    inputCost: number;
+    outputCost: number;
+    supportsTools?: boolean;
+    supportsVision?: boolean;
+    helperModelId?: string;
+    requestsPerMinute?: number;
+    tokensPerMinute?: number;
+}
+/**
+ * Create a MiniMax model configuration
+ *
+ * Generates a complete ModelConfig object for MiniMax models using the Messages API pattern
+ * (Anthropic-compatible).
+ *
+ * @param options - MiniMax model options
+ * @returns Complete ModelConfig object
+ *
+ * @example
+ * ```typescript
+ * const minimaxM2 = createMiniMaxModelConfig({
+ *   id: 'MiniMax-M2',
+ *   displayName: 'MiniMax M2',
+ *   family: 'minimax-m2',
+ *   contextWindow: 1024000,
+ *   outputTokens: 8192,
+ *   inputCost: 0.42,
+ *   outputCost: 1.40
+ * });
+ * ```
+ */
+export declare function createMiniMaxModelConfig(options: MiniMaxModelOptions): ModelConfig;
+//# sourceMappingURL=MiniMaxConfigurator.d.ts.map