@nexus-cortex/core 4.26.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"MiniMaxConfigurator.d.ts","sourceRoot":"","sources":["../../../src/models/configurators/MiniMaxConfigurator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;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,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IAGzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,GAAG,WAAW,CA+ElF"}

package/dist/models/configurators/MiniMaxConfigurator.js

@@ -0,0 +1,103 @@
+/**
+ * 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
+ */
+/**
+ * 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 function createMiniMaxModelConfig(options) {
+    const supportsTools = options.supportsTools !== undefined ? options.supportsTools : true;
+    return {
+        id: options.id,
+        provider: 'minimax',
+        displayName: options.displayName,
+        family: options.family,
+        api: {
+            pattern: 'messages', // Anthropic-compatible Messages API
+            endpoint: 'https://api.minimaxi.com/v1/messages',
+            apiKeyEnvVar: 'MINIMAX_API_KEY',
+            authHeader: 'Authorization',
+            authPrefix: 'Bearer'
+        },
+        tools: {
+            supported: supportsTools,
+            adapter: 'MessagesAPIAdapter', // Same adapter as Claude
+            namingConvention: 'snake_case',
+            maxTools: supportsTools ? 64 : 0,
+            parallelToolCalls: supportsTools
+        },
+        parameters: {
+            temperature: {
+                supported: true,
+                paramName: 'temperature',
+                min: 0.0,
+                max: 1.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: options.requestsPerMinute || 60,
+            tokensPerMinute: options.tokensPerMinute || 120000
+        },
+        streaming: {
+            supported: true,
+            format: 'sse'
+        },
+        compaction: {
+            strategy: 'auto',
+            thresholdCalculation: {
+                method: 'percentage',
+                percentage: 0.8,
+                safetyMargin: 4000
+            },
+            behavior: {
+                preserveRecent: 10,
+                compactOlder: true,
+                useHelperModel: false // Use same model for compaction
+            }
+        },
+        cost: {
+            inputPerMillion: options.inputCost,
+            outputPerMillion: options.outputCost
+        }
+    };
+}
+//# sourceMappingURL=MiniMaxConfigurator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MiniMaxConfigurator.js","sourceRoot":"","sources":["../../../src/models/configurators/MiniMaxConfigurator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqBH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAA4B;IACnE,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;IAEzF,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,UAAU,EAAG,oCAAoC;YAC1D,QAAQ,EAAE,sCAAsC;YAChD,YAAY,EAAE,iBAAiB;YAC/B,UAAU,EAAE,eAAe;YAC3B,UAAU,EAAE,QAAQ;SACrB;QAED,KAAK,EAAE;YACL,SAAS,EAAE,aAAa;YACxB,OAAO,EAAE,oBAAoB,EAAG,yBAAyB;YACzD,gBAAgB,EAAE,YAAY;YAC9B,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAChC,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,OAAO,CAAC,iBAAiB,IAAI,EAAE;YAClD,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,MAAM;SACnD;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,gCAAgC;aACxD;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/MoonshotConfigurator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Moonshot AI Model Configurator
+ *
+ * Factory function for creating Moonshot AI model configurations.
+ * Moonshot (月之暗面) provides Kimi models optimized for Chinese language.
+ *
+ * API Docs: https://platform.moonshot.cn/docs
+ */
+import type { ModelConfig } from '../ModelConfig.interface.js';
+export interface MoonshotModelOptions {
+    id: string;
+    displayName: string;
+    family: string;
+    contextWindow: number;
+    outputTokens: number;
+    inputCost: number;
+    outputCost: number;
+    supportsTools?: boolean;
+}
+export declare function createMoonshotModelConfig(options: MoonshotModelOptions): ModelConfig;
+//# sourceMappingURL=MoonshotConfigurator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MoonshotConfigurator.d.ts","sourceRoot":"","sources":["../../../src/models/configurators/MoonshotConfigurator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,WAAW,oBAAoB;IACnC,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,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,oBAAoB,GAAG,WAAW,CA+EpF"}

package/dist/models/configurators/MoonshotConfigurator.js

@@ -0,0 +1,81 @@
+/**
+ * Moonshot AI Model Configurator
+ *
+ * Factory function for creating Moonshot AI model configurations.
+ * Moonshot (月之暗面) provides Kimi models optimized for Chinese language.
+ *
+ * API Docs: https://platform.moonshot.cn/docs
+ */
+export function createMoonshotModelConfig(options) {
+    const supportsTools = options.supportsTools !== undefined ? options.supportsTools : true;
+    return {
+        id: options.id,
+        provider: 'moonshot',
+        displayName: options.displayName,
+        family: options.family,
+        api: {
+            pattern: 'chat/completions', // OpenAI-compatible API
+            endpoint: 'https://api.moonshot.cn/v1/chat/completions',
+            apiKeyEnvVar: 'MOONSHOT_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: 1.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: 60,
+            tokensPerMinute: 120000
+        },
+        streaming: {
+            supported: true,
+            format: 'sse'
+        },
+        compaction: {
+            strategy: 'auto',
+            thresholdCalculation: {
+                method: 'percentage',
+                percentage: 0.8,
+                safetyMargin: 4000
+            },
+            behavior: {
+                preserveRecent: 10,
+                compactOlder: true,
+                useHelperModel: false // Use same model for compaction
+            }
+        },
+        cost: {
+            inputPerMillion: options.inputCost,
+            outputPerMillion: options.outputCost
+        }
+    };
+}
+//# sourceMappingURL=MoonshotConfigurator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MoonshotConfigurator.js","sourceRoot":"","sources":["../../../src/models/configurators/MoonshotConfigurator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH,MAAM,UAAU,yBAAyB,CAAC,OAA6B;IACrE,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;IAEzF,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;QAEtB,GAAG,EAAE;YACH,OAAO,EAAE,kBAAkB,EAAG,wBAAwB;YACtD,QAAQ,EAAE,6CAA6C;YACvD,YAAY,EAAE,kBAAkB;YAChC,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,EAAE;YACrB,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,KAAK,CAAE,gCAAgC;aACxD;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/OpenAIConfigurator.d.ts

@@ -0,0 +1,52 @@
+/**
+ * OpenAI Model Configurator (Chat Completions API + dynamic Responses switch)
+ *
+ * Factory functions for creating OpenAI model configurations. Default transport
+ * is Chat Completions; cards may opt into Responses-API-by-default via the
+ * OPENAI_API_MODE env var (when set to 'responses' AND the card declares
+ * `supportsServerSideTools: true`).
+ *
+ * Regardless of static config, when ENABLE_SERVER_SIDE_TOOLS=true and a
+ * request contains a server-side tool, ServerSideToolDetection switches the
+ * specific call to /v1/responses (R20 — grok-4.1-fast pattern parity).
+ *
+ * Phase 1: Configurator Extraction; R20 (2026-05-13): Responses opt-in.
+ */
+import type { ModelConfig } from '../ModelConfig.interface.js';
+export interface OpenAIModelOptions {
+    id: string;
+    displayName: string;
+    family: string;
+    contextWindow: number;
+    outputTokens: number;
+    inputCost: number;
+    outputCost: number;
+    supportsTools?: boolean;
+    /**
+     * Parameter name for max tokens in API requests.
+     * - 'max_tokens' for older models (GPT-4, GPT-4o)
+     * - 'max_completion_tokens' for newer models (GPT-5 family)
+     * Defaults to 'max_tokens' for backwards compatibility.
+     */
+    maxTokensParamName?: 'max_tokens' | 'max_completion_tokens';
+    reasoning?: {
+        supported: boolean;
+        format?: 'reasoning_content' | 'thinking_block' | 'reasoning_item';
+        extractionMethod?: 'content_block' | 'separate_field' | 'output_item';
+        pattern?: 'upfront' | 'interleaved';
+    };
+    /**
+     * R20: Card-level opt-in to declare this model supports OpenAI's hosted
+     * server-side tools (web_search, code_interpreter, file_search,
+     * image_generation, mcp) via the Responses API. When set:
+     * - `serverSideTools` config is populated on the ModelConfig.
+     * - With ENABLE_SERVER_SIDE_TOOLS=true and a server-side tool in the
+     *   request, ServerSideToolDetection dynamically routes to /v1/responses.
+     * - With OPENAI_API_MODE=responses, the model's default transport becomes
+     *   Responses even without server-side tools in the request.
+     * Recommended for the GPT-5 family.
+     */
+    supportsServerSideTools?: boolean;
+}
+export declare function createOpenAIModelConfig(options: OpenAIModelOptions): ModelConfig;
+//# sourceMappingURL=OpenAIConfigurator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAIConfigurator.d.ts","sourceRoot":"","sources":["../../../src/models/configurators/OpenAIConfigurator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG/D,MAAM,WAAW,kBAAkB;IACjC,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,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,YAAY,GAAG,uBAAuB,CAAC;IAC5D,SAAS,CAAC,EAAE;QACV,SAAS,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,mBAAmB,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;QACnE,gBAAgB,CAAC,EAAE,eAAe,GAAG,gBAAgB,GAAG,aAAa,CAAC;QACtE,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;KACrC,CAAC;IACF;;;;;;;;;;OAUG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CA0HhF"}

package/dist/models/configurators/OpenAIConfigurator.js

@@ -0,0 +1,128 @@
+/**
+ * OpenAI Model Configurator (Chat Completions API + dynamic Responses switch)
+ *
+ * Factory functions for creating OpenAI model configurations. Default transport
+ * is Chat Completions; cards may opt into Responses-API-by-default via the
+ * OPENAI_API_MODE env var (when set to 'responses' AND the card declares
+ * `supportsServerSideTools: true`).
+ *
+ * Regardless of static config, when ENABLE_SERVER_SIDE_TOOLS=true and a
+ * request contains a server-side tool, ServerSideToolDetection switches the
+ * specific call to /v1/responses (R20 — grok-4.1-fast pattern parity).
+ *
+ * Phase 1: Configurator Extraction; R20 (2026-05-13): Responses opt-in.
+ */
+import { DEFAULT_SETTINGS } from '../../config/SettingsSchema.js';
+export function createOpenAIModelConfig(options) {
+    const supportsTools = options.supportsTools !== undefined ? options.supportsTools : true;
+    // Default to 'max_tokens' for backwards compatibility with older models
+    const maxTokensParamName = options.maxTokensParamName || 'max_tokens';
+    // R20: OPENAI_API_MODE env can globally promote opt-in cards to use the
+    // Responses API as their default transport. Cards must opt in via
+    // `supportsServerSideTools: true` to be eligible — otherwise the env flag
+    // is a no-op (e.g. older GPT-4o cards stay on chat/completions).
+    const apiMode = process.env.OPENAI_API_MODE || DEFAULT_SETTINGS.OPENAI_API_MODE;
+    const useResponsesAPI = options.supportsServerSideTools === true && apiMode === 'responses';
+    return {
+        id: options.id,
+        provider: 'openai',
+        displayName: options.displayName,
+        family: options.family,
+        api: {
+            pattern: useResponsesAPI ? 'responses' : 'chat/completions',
+            endpoint: useResponsesAPI
+                ? 'https://api.openai.com/v1/responses'
+                : 'https://api.openai.com/v1/chat/completions',
+            apiKeyEnvVar: 'OPENAI_API_KEY',
+            authHeader: 'Authorization',
+            authPrefix: 'Bearer'
+        },
+        tools: {
+            supported: supportsTools,
+            // R20: adapter follows the transport. ServerSideToolDetection swaps the
+            // adapter at request time when it dynamically switches endpoints.
+            adapter: useResponsesAPI ? 'ResponsesAPIAdapter' : 'ChatCompletionsAPIAdapter',
+            namingConvention: 'snake_case',
+            maxTools: supportsTools ? 128 : 0,
+            parallelToolCalls: supportsTools
+        },
+        // R20: declare server-side tool support so ServerSideToolDetection can
+        // route to /v1/responses dynamically when ENABLE_SERVER_SIDE_TOOLS=true
+        // and a hosted tool is present in the request.
+        ...(options.supportsServerSideTools && {
+            serverSideTools: {
+                supported: true,
+                supportedEndpoints: ['responses'],
+                availableTools: [
+                    'web_search',
+                    'web_search_preview',
+                    'code_interpreter',
+                    'file_search',
+                    'image_generation',
+                    'computer_use_preview',
+                    'mcp',
+                ],
+                metadata: {
+                    supportsCitations: true,
+                    supportsToolUsage: true,
+                    supportsReasoningTokens: true,
+                },
+            },
+        }),
+        parameters: {
+            temperature: {
+                supported: true,
+                paramName: 'temperature',
+                min: 0.0,
+                max: 2.0
+            },
+            maxTokens: {
+                supported: true,
+                // R20: Responses API uses max_output_tokens, not max_completion_tokens.
+                // When this card's static default is Responses, switch the param name.
+                // Dynamic switches (per-call) are handled by GatewayTranslationLayer.
+                paramName: useResponsesAPI ? 'max_output_tokens' : maxTokensParamName,
+                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: 500,
+            tokensPerMinute: 150000
+        },
+        streaming: {
+            supported: true,
+            format: 'sse'
+        },
+        compaction: {
+            strategy: 'auto',
+            thresholdCalculation: {
+                method: 'percentage',
+                percentage: 0.8,
+                safetyMargin: 4000
+            },
+            behavior: {
+                preserveRecent: 10,
+                compactOlder: true,
+                useHelperModel: supportsTools,
+                helperModelId: supportsTools ? 'gpt-4o-mini' : undefined
+            }
+        },
+        cost: {
+            inputPerMillion: options.inputCost,
+            outputPerMillion: options.outputCost
+        },
+        reasoning: options.reasoning
+    };
+}
+//# sourceMappingURL=OpenAIConfigurator.js.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * OpenAI Responses API Model Configurator
+ *
+ * Factory functions for creating OpenAI model configurations using the Responses API pattern.
+ * Handles GPT-5 Codex and other models with server-side tool execution.
+ *
+ * Phase 1: Configurator Extraction
+ */
+import type { ModelConfig } from '../ModelConfig.interface.js';
+export interface OpenAIResponsesModelOptions {
+    id: string;
+    displayName: string;
+    family: string;
+    contextWindow: number;
+    outputTokens: number;
+    inputCost: number;
+    outputCost: number;
+    supportsTools?: boolean;
+    /** Enable reasoning modality for visible thinking traces */
+    supportsReasoning?: boolean;
+}
+export declare function createOpenAIResponsesModelConfig(options: OpenAIResponsesModelOptions): ModelConfig;
+//# sourceMappingURL=OpenAIResponsesConfigurator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAIResponsesConfigurator.d.ts","sourceRoot":"","sources":["../../../src/models/configurators/OpenAIResponsesConfigurator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,WAAW,2BAA2B;IAC1C,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,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,2BAA2B,GAAG,WAAW,CAiHlG"}

package/dist/models/configurators/OpenAIResponsesConfigurator.js

@@ -0,0 +1,113 @@
+/**
+ * OpenAI Responses API Model Configurator
+ *
+ * Factory functions for creating OpenAI model configurations using the Responses API pattern.
+ * Handles GPT-5 Codex and other models with server-side tool execution.
+ *
+ * Phase 1: Configurator Extraction
+ */
+export function createOpenAIResponsesModelConfig(options) {
+    const supportsTools = options.supportsTools !== undefined ? options.supportsTools : true;
+    const supportsReasoning = options.supportsReasoning || false;
+    return {
+        id: options.id,
+        provider: 'openai',
+        displayName: options.displayName,
+        family: options.family,
+        api: {
+            pattern: 'responses',
+            endpoint: 'https://api.openai.com/v1/responses',
+            apiKeyEnvVar: 'OPENAI_API_KEY',
+            authHeader: 'Authorization',
+            authPrefix: 'Bearer'
+        },
+        tools: {
+            supported: supportsTools,
+            adapter: 'ResponsesAPIAdapter',
+            namingConvention: 'snake_case',
+            maxTools: supportsTools ? 128 : 0,
+            parallelToolCalls: supportsTools
+        },
+        // R20: cards built with this configurator are statically on /v1/responses;
+        // expose the same hosted-tools surface that the dynamic-switch GPT-5 cards
+        // get so ServerSideToolDetection treats them consistently.
+        serverSideTools: {
+            supported: true,
+            supportedEndpoints: ['responses'],
+            availableTools: [
+                'web_search',
+                'web_search_preview',
+                'code_interpreter',
+                'file_search',
+                'image_generation',
+                'computer_use_preview',
+                'mcp',
+            ],
+            metadata: {
+                supportsCitations: true,
+                supportsToolUsage: true,
+                supportsReasoningTokens: true,
+            },
+        },
+        parameters: {
+            temperature: {
+                supported: true,
+                paramName: 'temperature',
+                min: 0.0,
+                max: 2.0
+            },
+            maxTokens: {
+                supported: true,
+                paramName: 'max_output_tokens', // Responses API uses max_output_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: 500,
+            tokensPerMinute: 150000
+        },
+        streaming: {
+            supported: true,
+            format: 'sse'
+        },
+        // Add reasoning config if supported (uses Responses API modalities)
+        ...(supportsReasoning && {
+            reasoning: {
+                supported: true,
+                format: 'reasoning_item', // Responses API returns reasoning items
+                extractionMethod: 'output_item', // Extract from output array
+                pattern: 'upfront' // Reasoning comes before the response
+            }
+        }),
+        compaction: {
+            strategy: 'auto',
+            thresholdCalculation: {
+                method: 'percentage',
+                percentage: 0.8,
+                safetyMargin: 4000
+            },
+            behavior: {
+                preserveRecent: 10,
+                compactOlder: true,
+                useHelperModel: supportsTools,
+                helperModelId: supportsTools ? 'gpt-4o-mini' : undefined
+            }
+        },
+        cost: {
+            inputPerMillion: options.inputCost,
+            outputPerMillion: options.outputCost
+        }
+    };
+}
+//# sourceMappingURL=OpenAIResponsesConfigurator.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * Qwen Model Configurator (Alibaba Cloud)
+ *
+ * Factory function for creating Alibaba Qwen (通义千问) model configurations.
+ * Supports both DashScope API and Hugging Face deployments.
+ *
+ * API Docs: https://help.aliyun.com/zh/dashscope/
+ */
+import type { ModelConfig } from '../ModelConfig.interface.js';
+export interface QwenModelOptions {
+    id: string;
+    displayName: string;
+    family: string;
+    contextWindow: number;
+    outputTokens: number;
+    inputCost: number;
+    outputCost: number;
+    supportsTools?: boolean;
+    supportsVision?: boolean;
+    /**
+     * Use Hugging Face endpoint instead of DashScope
+     */
+    useHuggingFace?: boolean;
+}
+export declare function createQwenModelConfig(options: QwenModelOptions): ModelConfig;
+//# sourceMappingURL=QwenConfigurator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QwenConfigurator.d.ts","sourceRoot":"","sources":["../../../src/models/configurators/QwenConfigurator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,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,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,WAAW,CAuF5E"}