codexmate 0.0.32 → 0.0.34

package/lib/cli-models-utils.js

@@ -1,440 +1,440 @@
-const crypto = require('crypto');
-const { joinApiUrl, normalizeBaseUrl } = require('./cli-utils');
-
-const BIGMODEL_CLAUDE_COMPAT_MODELS = Object.freeze([
-    'glm-3-turbo',
-    'glm-4',
-    'glm-4-0520',
-    'glm-4-plus',
-    'glm-4-air',
-    'glm-4-airx',
-    'glm-4-flash',
-    'glm-4-flashx',
-    'glm-4v',
-    'glm-4v-flash',
-    'glm-4v-plus',
-    'glm-4v-plus-0111',
-    'glm-4.5',
-    'glm-4.5-air',
-    'glm-4.5v',
-    'glm-4.6',
-    'glm-4.6v',
-    'glm-4.7',
-    'glm-4.7-flash',
-    'glm-4.7-flashx',
-    'glm-5',
-    'glm-5-turbo',
-    'glm-5.1',
-    'glm-5v',
-    'glm-5v-turbo',
-    'glm-z1',
-    'glm-z1-air',
-    'glm-coding'
-]);
-
-const ANTHROPIC_CLAUDE_MODELS = Object.freeze([
-    'claude-opus-4-6',
-    'claude-opus-4-1',
-    'claude-opus-4',
-    'claude-sonnet-4-6',
-    'claude-sonnet-4-5',
-    'claude-sonnet-4',
-    'claude-haiku-4-5',
-    'claude-3-7-sonnet',
-    'claude-3-5-sonnet',
-    'claude-3-5-haiku',
-    'claude-3-opus',
-    'claude-3-sonnet',
-    'claude-3-haiku'
-]);
-
-const DEEPSEEK_CLAUDE_COMPAT_MODELS = Object.freeze([
-    'DeepSeek-V3.2',
-    'DeepSeek-V3',
-    'DeepSeek-R1',
-    'deepseek-chat'
-]);
-
-const QWEN_CLAUDE_COMPAT_MODELS = Object.freeze([
-    'qwen3-coder',
-    'qwen-max',
-    'qwen-plus',
-    'qwen-turbo'
-]);
-
-const MODELSCOPE_CLAUDE_COMPAT_MODELS = Object.freeze([
-    'ZhipuAI/GLM-5'
-]);
-
-function normalizeModelCatalogId(value) {
-    return typeof value === 'string' ? value.trim().toLowerCase() : '';
-}
-
-function hasPathSegment(baseUrl, segment) {
-    const normalized = normalizeBaseUrl(baseUrl);
-    if (!normalized) return false;
-    try {
-        const parsed = new URL(normalized);
-        const pathname = String(parsed.pathname || '').toLowerCase();
-        const escaped = String(segment || '').replace(/[.*+?^${}()|[\]\\]/g, '\\$&').toLowerCase();
-        return new RegExp(`(^|/)${escaped}(/|$)`).test(pathname);
-    } catch (_) {
-        return false;
-    }
-}
-
-function getBaseUrlHost(baseUrl) {
-    const normalized = normalizeBaseUrl(baseUrl);
-    if (!normalized) return '';
-    try {
-        const parsed = new URL(normalized);
-        return String(parsed.hostname || '').toLowerCase();
-    } catch (_) {
-        return '';
-    }
-}
-
-function isHostOrSubdomain(host, domain) {
-    return host === domain || host.endsWith(`.${domain}`);
-}
-
-function isBigModelClaudeCompatibleBaseUrl(baseUrl) {
-    const host = getBaseUrlHost(baseUrl);
-    return isHostOrSubdomain(host, 'bigmodel.cn') && hasPathSegment(baseUrl, 'anthropic');
-}
-
-function isAnthropicBaseUrl(baseUrl) {
-    const host = getBaseUrlHost(baseUrl);
-    return isHostOrSubdomain(host, 'anthropic.com');
-}
-
-function isDeepSeekClaudeCompatibleBaseUrl(baseUrl) {
-    const host = getBaseUrlHost(baseUrl);
-    return isHostOrSubdomain(host, 'deepseek.com') && hasPathSegment(baseUrl, 'anthropic');
-}
-
-function isQwenClaudeCompatibleBaseUrl(baseUrl) {
-    const host = getBaseUrlHost(baseUrl);
-    return isHostOrSubdomain(host, 'dashscope.aliyuncs.com') && hasPathSegment(baseUrl, 'anthropic');
-}
-
-function isZaiClaudeCompatibleBaseUrl(baseUrl) {
-    const host = getBaseUrlHost(baseUrl);
-    return isHostOrSubdomain(host, 'z.ai') && hasPathSegment(baseUrl, 'anthropic');
-}
-
-function isModelScopeBaseUrl(baseUrl) {
-    const host = getBaseUrlHost(baseUrl);
-    return isHostOrSubdomain(host, 'modelscope.cn');
-}
-
-function getSupplementalModelsForBaseUrl(baseUrl) {
-    if (isBigModelClaudeCompatibleBaseUrl(baseUrl)) {
-        return [...BIGMODEL_CLAUDE_COMPAT_MODELS];
-    }
-    if (isAnthropicBaseUrl(baseUrl)) {
-        return [...ANTHROPIC_CLAUDE_MODELS];
-    }
-    if (isDeepSeekClaudeCompatibleBaseUrl(baseUrl)) {
-        return [...DEEPSEEK_CLAUDE_COMPAT_MODELS];
-    }
-    if (isQwenClaudeCompatibleBaseUrl(baseUrl)) {
-        return [...QWEN_CLAUDE_COMPAT_MODELS];
-    }
-    if (isZaiClaudeCompatibleBaseUrl(baseUrl)) {
-        return [...BIGMODEL_CLAUDE_COMPAT_MODELS];
-    }
-    if (isModelScopeBaseUrl(baseUrl)) {
-        return [...MODELSCOPE_CLAUDE_COMPAT_MODELS];
-    }
-    return [];
-}
-
-function mergeModelCatalog(remoteModels = [], supplementalModels = []) {
-    const merged = [];
-    const seen = new Set();
-    const push = (value) => {
-        if (typeof value !== 'string') return;
-        const trimmed = value.trim();
-        if (!trimmed) return;
-        const normalized = normalizeModelCatalogId(trimmed);
-        if (!normalized || seen.has(normalized)) return;
-        seen.add(normalized);
-        merged.push(trimmed);
-    };
-
-    for (const item of remoteModels) push(item);
-    for (const item of supplementalModels) push(item);
-    return merged;
-}
-
-function extractModelNames(payload) {
-    if (!payload || typeof payload !== 'object') return [];
-    const data = Array.isArray(payload.data)
-        ? payload.data
-        : (Array.isArray(payload.models) ? payload.models : []);
-    const names = [];
-    for (const item of data) {
-        if (typeof item === 'string') {
-            if (item.trim()) names.push(item.trim());
-            continue;
-        }
-        if (!item || typeof item !== 'object') continue;
-        const name = item.id || item.name || item.model || '';
-        if (typeof name === 'string' && name.trim()) {
-            names.push(name.trim());
-        }
-    }
-    return Array.from(new Set(names));
-}
-
-function hasModelsListPayload(payload) {
-    if (!payload || typeof payload !== 'object') return false;
-    return Array.isArray(payload.data) || Array.isArray(payload.models);
-}
-
-function extractModelIds(payload) {
-    const ids = [];
-    const pushValue = (value) => {
-        if (typeof value === 'string' && value.trim()) {
-            ids.push(value.trim());
-        }
-    };
-
-    if (!payload) return ids;
-
-    if (Array.isArray(payload)) {
-        for (const item of payload) {
-            if (item && typeof item === 'object') {
-                pushValue(item.id);
-                pushValue(item.model);
-                pushValue(item.name);
-            } else {
-                pushValue(item);
-            }
-        }
-        return ids;
-    }
-
-    if (Array.isArray(payload.data)) {
-        for (const item of payload.data) {
-            if (item && typeof item === 'object') {
-                pushValue(item.id);
-                pushValue(item.model);
-                pushValue(item.name);
-            } else {
-                pushValue(item);
-            }
-        }
-    }
-
-    if (Array.isArray(payload.models)) {
-        for (const item of payload.models) {
-            if (item && typeof item === 'object') {
-                pushValue(item.id);
-                pushValue(item.model);
-                pushValue(item.name);
-            } else {
-                pushValue(item);
-            }
-        }
-    }
-
-    return ids;
-}
-
-function normalizeWireApi(value) {
-    const raw = typeof value === 'string' ? value.trim().toLowerCase() : '';
-    if (!raw) return 'responses';
-    return raw.replace(/[\s\-\/]/g, '_');
-}
-
-function buildApiProbeUrlCandidates(baseUrl, pathSuffix) {
-    const normalized = normalizeBaseUrl(baseUrl);
-    if (!normalized) return [];
-
-    const safeSuffix = String(pathSuffix || '').replace(/^\/+/g, '');
-    if (!safeSuffix) return [normalized];
-
-    const candidates = [];
-    const pushUnique = (value) => {
-        if (value && !candidates.includes(value)) {
-            candidates.push(value);
-        }
-    };
-
-    let pathname = '';
-    try {
-        pathname = new URL(normalized).pathname.replace(/\/+$/g, '');
-    } catch (e) {
-        pathname = '';
-    }
-
-    const directUrl = `${normalized}/${safeSuffix}`;
-    const versionedUrl = joinApiUrl(normalized, safeSuffix);
-    if (/\/v\d+$/i.test(pathname)) {
-        pushUnique(directUrl);
-        return candidates;
-    }
-
-    if (!pathname || pathname === '/') {
-        pushUnique(versionedUrl);
-        pushUnique(directUrl);
-        return candidates;
-    }
-
-    pushUnique(directUrl);
-    pushUnique(versionedUrl);
-    return candidates;
-}
-
-function buildModelsProbeUrl(baseUrl) {
-    return buildApiProbeUrlCandidates(baseUrl, 'models')[0] || '';
-}
-
-function buildModelProbeSpecs(provider, modelName, baseUrl) {
-    const model = typeof modelName === 'string' ? modelName.trim() : '';
-    if (!model) return [];
-
-    const wireApi = normalizeWireApi(provider && provider.wire_api);
-    let pathSuffix = 'responses';
-    let body = {
-        model,
-        input: 'ping',
-        max_output_tokens: 1
-    };
-
-    if (wireApi === 'chat_completions' || wireApi === 'chat') {
-        pathSuffix = 'chat/completions';
-        body = {
-            model,
-            messages: [{ role: 'user', content: 'ping' }],
-            max_tokens: 1,
-            temperature: 0
-        };
-    } else if (wireApi === 'completions') {
-        pathSuffix = 'completions';
-        body = {
-            model,
-            prompt: 'ping',
-            max_tokens: 1,
-            temperature: 0
-        };
-    }
-
-    return buildApiProbeUrlCandidates(baseUrl, pathSuffix).map((url) => ({
-        url,
-        body
-    }));
-}
-
-function buildModelProbeSpec(provider, modelName, baseUrl) {
-    return buildModelProbeSpecs(provider, modelName, baseUrl)[0] || null;
-}
-
-function collectStructuredText(content, pieces) {
-    if (typeof content === 'string') {
-        const text = content.trim();
-        if (text) pieces.push(text);
-        return;
-    }
-    if (Array.isArray(content)) {
-        for (const item of content) {
-            collectStructuredText(item, pieces);
-        }
-        return;
-    }
-    if (!content || typeof content !== 'object') {
-        return;
-    }
-
-    if (typeof content.output_text === 'string' && content.output_text.trim()) {
-        pieces.push(content.output_text.trim());
-    }
-    if (typeof content.text === 'string' && content.text.trim()) {
-        pieces.push(content.text.trim());
-    }
-    if (typeof content.content === 'string' && content.content.trim()) {
-        pieces.push(content.content.trim());
-    }
-
-    if (Array.isArray(content.content)) {
-        collectStructuredText(content.content, pieces);
-    }
-    if (content.message) {
-        collectStructuredText(content.message, pieces);
-    }
-}
-
-function extractModelResponseText(payload) {
-    if (!payload || typeof payload !== 'object') {
-        return '';
-    }
-
-    if (typeof payload.output_text === 'string' && payload.output_text.trim()) {
-        return payload.output_text.trim();
-    }
-
-    const pieces = [];
-
-    if (Array.isArray(payload.output)) {
-        for (const item of payload.output) {
-            collectStructuredText(item, pieces);
-        }
-    }
-
-    if (Array.isArray(payload.choices)) {
-        for (const choice of payload.choices) {
-            if (!choice || typeof choice !== 'object') continue;
-            if (typeof choice.text === 'string' && choice.text.trim()) {
-                pieces.push(choice.text.trim());
-            }
-            if (choice.message) {
-                collectStructuredText(choice.message, pieces);
-            }
-        }
-    }
-
-    if (payload.message) {
-        collectStructuredText(payload.message, pieces);
-    }
-    if (payload.content) {
-        collectStructuredText(payload.content, pieces);
-    }
-    if (typeof payload.text === 'string' && payload.text.trim()) {
-        pieces.push(payload.text.trim());
-    }
-
-    return Array.from(new Set(pieces)).join('\n\n').trim();
-}
-
-function hashModelsCacheValue(value) {
-    if (!value) return '';
-    try {
-        return crypto.createHash('sha256').update(String(value)).digest('hex');
-    } catch (e) {
-        return '';
-    }
-}
-
-function buildModelsCacheKey(baseUrl, apiKey) {
-    const normalizedUrl = normalizeBaseUrl(baseUrl);
-    const apiKeyHash = hashModelsCacheValue(apiKey);
-    return `${normalizedUrl}|${apiKeyHash}`;
-}
-
-module.exports = {
-    extractModelNames,
-    hasModelsListPayload,
-    extractModelIds,
-    normalizeWireApi,
-    buildApiProbeUrlCandidates,
-    buildModelsProbeUrl,
-    buildModelProbeSpecs,
-    buildModelProbeSpec,
-    extractModelResponseText,
-    hashModelsCacheValue,
-    buildModelsCacheKey,
-    getSupplementalModelsForBaseUrl,
-    mergeModelCatalog
-};
+const crypto = require('crypto');
+const { joinApiUrl, normalizeBaseUrl } = require('./cli-utils');
+
+const BIGMODEL_CLAUDE_COMPAT_MODELS = Object.freeze([
+    'glm-3-turbo',
+    'glm-4',
+    'glm-4-0520',
+    'glm-4-plus',
+    'glm-4-air',
+    'glm-4-airx',
+    'glm-4-flash',
+    'glm-4-flashx',
+    'glm-4v',
+    'glm-4v-flash',
+    'glm-4v-plus',
+    'glm-4v-plus-0111',
+    'glm-4.5',
+    'glm-4.5-air',
+    'glm-4.5v',
+    'glm-4.6',
+    'glm-4.6v',
+    'glm-4.7',
+    'glm-4.7-flash',
+    'glm-4.7-flashx',
+    'glm-5',
+    'glm-5-turbo',
+    'glm-5.1',
+    'glm-5v',
+    'glm-5v-turbo',
+    'glm-z1',
+    'glm-z1-air',
+    'glm-coding'
+]);
+
+const ANTHROPIC_CLAUDE_MODELS = Object.freeze([
+    'claude-opus-4-6',
+    'claude-opus-4-1',
+    'claude-opus-4',
+    'claude-sonnet-4-6',
+    'claude-sonnet-4-5',
+    'claude-sonnet-4',
+    'claude-haiku-4-5',
+    'claude-3-7-sonnet',
+    'claude-3-5-sonnet',
+    'claude-3-5-haiku',
+    'claude-3-opus',
+    'claude-3-sonnet',
+    'claude-3-haiku'
+]);
+
+const DEEPSEEK_CLAUDE_COMPAT_MODELS = Object.freeze([
+    'DeepSeek-V3.2',
+    'DeepSeek-V3',
+    'DeepSeek-R1',
+    'deepseek-chat'
+]);
+
+const QWEN_CLAUDE_COMPAT_MODELS = Object.freeze([
+    'qwen3-coder',
+    'qwen-max',
+    'qwen-plus',
+    'qwen-turbo'
+]);
+
+const MODELSCOPE_CLAUDE_COMPAT_MODELS = Object.freeze([
+    'ZhipuAI/GLM-5'
+]);
+
+function normalizeModelCatalogId(value) {
+    return typeof value === 'string' ? value.trim().toLowerCase() : '';
+}
+
+function hasPathSegment(baseUrl, segment) {
+    const normalized = normalizeBaseUrl(baseUrl);
+    if (!normalized) return false;
+    try {
+        const parsed = new URL(normalized);
+        const pathname = String(parsed.pathname || '').toLowerCase();
+        const escaped = String(segment || '').replace(/[.*+?^${}()|[\]\\]/g, '\\$&').toLowerCase();
+        return new RegExp(`(^|/)${escaped}(/|$)`).test(pathname);
+    } catch (_) {
+        return false;
+    }
+}
+
+function getBaseUrlHost(baseUrl) {
+    const normalized = normalizeBaseUrl(baseUrl);
+    if (!normalized) return '';
+    try {
+        const parsed = new URL(normalized);
+        return String(parsed.hostname || '').toLowerCase();
+    } catch (_) {
+        return '';
+    }
+}
+
+function isHostOrSubdomain(host, domain) {
+    return host === domain || host.endsWith(`.${domain}`);
+}
+
+function isBigModelClaudeCompatibleBaseUrl(baseUrl) {
+    const host = getBaseUrlHost(baseUrl);
+    return isHostOrSubdomain(host, 'bigmodel.cn') && hasPathSegment(baseUrl, 'anthropic');
+}
+
+function isAnthropicBaseUrl(baseUrl) {
+    const host = getBaseUrlHost(baseUrl);
+    return isHostOrSubdomain(host, 'anthropic.com');
+}
+
+function isDeepSeekClaudeCompatibleBaseUrl(baseUrl) {
+    const host = getBaseUrlHost(baseUrl);
+    return isHostOrSubdomain(host, 'deepseek.com') && hasPathSegment(baseUrl, 'anthropic');
+}
+
+function isQwenClaudeCompatibleBaseUrl(baseUrl) {
+    const host = getBaseUrlHost(baseUrl);
+    return isHostOrSubdomain(host, 'dashscope.aliyuncs.com') && hasPathSegment(baseUrl, 'anthropic');
+}
+
+function isZaiClaudeCompatibleBaseUrl(baseUrl) {
+    const host = getBaseUrlHost(baseUrl);
+    return isHostOrSubdomain(host, 'z.ai') && hasPathSegment(baseUrl, 'anthropic');
+}
+
+function isModelScopeBaseUrl(baseUrl) {
+    const host = getBaseUrlHost(baseUrl);
+    return isHostOrSubdomain(host, 'modelscope.cn');
+}
+
+function getSupplementalModelsForBaseUrl(baseUrl) {
+    if (isBigModelClaudeCompatibleBaseUrl(baseUrl)) {
+        return [...BIGMODEL_CLAUDE_COMPAT_MODELS];
+    }
+    if (isAnthropicBaseUrl(baseUrl)) {
+        return [...ANTHROPIC_CLAUDE_MODELS];
+    }
+    if (isDeepSeekClaudeCompatibleBaseUrl(baseUrl)) {
+        return [...DEEPSEEK_CLAUDE_COMPAT_MODELS];
+    }
+    if (isQwenClaudeCompatibleBaseUrl(baseUrl)) {
+        return [...QWEN_CLAUDE_COMPAT_MODELS];
+    }
+    if (isZaiClaudeCompatibleBaseUrl(baseUrl)) {
+        return [...BIGMODEL_CLAUDE_COMPAT_MODELS];
+    }
+    if (isModelScopeBaseUrl(baseUrl)) {
+        return [...MODELSCOPE_CLAUDE_COMPAT_MODELS];
+    }
+    return [];
+}
+
+function mergeModelCatalog(remoteModels = [], supplementalModels = []) {
+    const merged = [];
+    const seen = new Set();
+    const push = (value) => {
+        if (typeof value !== 'string') return;
+        const trimmed = value.trim();
+        if (!trimmed) return;
+        const normalized = normalizeModelCatalogId(trimmed);
+        if (!normalized || seen.has(normalized)) return;
+        seen.add(normalized);
+        merged.push(trimmed);
+    };
+
+    for (const item of remoteModels) push(item);
+    for (const item of supplementalModels) push(item);
+    return merged;
+}
+
+function extractModelNames(payload) {
+    if (!payload || typeof payload !== 'object') return [];
+    const data = Array.isArray(payload.data)
+        ? payload.data
+        : (Array.isArray(payload.models) ? payload.models : []);
+    const names = [];
+    for (const item of data) {
+        if (typeof item === 'string') {
+            if (item.trim()) names.push(item.trim());
+            continue;
+        }
+        if (!item || typeof item !== 'object') continue;
+        const name = item.id || item.name || item.model || '';
+        if (typeof name === 'string' && name.trim()) {
+            names.push(name.trim());
+        }
+    }
+    return Array.from(new Set(names));
+}
+
+function hasModelsListPayload(payload) {
+    if (!payload || typeof payload !== 'object') return false;
+    return Array.isArray(payload.data) || Array.isArray(payload.models);
+}
+
+function extractModelIds(payload) {
+    const ids = [];
+    const pushValue = (value) => {
+        if (typeof value === 'string' && value.trim()) {
+            ids.push(value.trim());
+        }
+    };
+
+    if (!payload) return ids;
+
+    if (Array.isArray(payload)) {
+        for (const item of payload) {
+            if (item && typeof item === 'object') {
+                pushValue(item.id);
+                pushValue(item.model);
+                pushValue(item.name);
+            } else {
+                pushValue(item);
+            }
+        }
+        return ids;
+    }
+
+    if (Array.isArray(payload.data)) {
+        for (const item of payload.data) {
+            if (item && typeof item === 'object') {
+                pushValue(item.id);
+                pushValue(item.model);
+                pushValue(item.name);
+            } else {
+                pushValue(item);
+            }
+        }
+    }
+
+    if (Array.isArray(payload.models)) {
+        for (const item of payload.models) {
+            if (item && typeof item === 'object') {
+                pushValue(item.id);
+                pushValue(item.model);
+                pushValue(item.name);
+            } else {
+                pushValue(item);
+            }
+        }
+    }
+
+    return ids;
+}
+
+function normalizeWireApi(value) {
+    const raw = typeof value === 'string' ? value.trim().toLowerCase() : '';
+    if (!raw) return 'responses';
+    return raw.replace(/[\s\-\/]/g, '_');
+}
+
+function buildApiProbeUrlCandidates(baseUrl, pathSuffix) {
+    const normalized = normalizeBaseUrl(baseUrl);
+    if (!normalized) return [];
+
+    const safeSuffix = String(pathSuffix || '').replace(/^\/+/g, '');
+    if (!safeSuffix) return [normalized];
+
+    const candidates = [];
+    const pushUnique = (value) => {
+        if (value && !candidates.includes(value)) {
+            candidates.push(value);
+        }
+    };
+
+    let pathname = '';
+    try {
+        pathname = new URL(normalized).pathname.replace(/\/+$/g, '');
+    } catch (e) {
+        pathname = '';
+    }
+
+    const directUrl = `${normalized}/${safeSuffix}`;
+    const versionedUrl = joinApiUrl(normalized, safeSuffix);
+    if (/\/v\d+$/i.test(pathname)) {
+        pushUnique(directUrl);
+        return candidates;
+    }
+
+    if (!pathname || pathname === '/') {
+        pushUnique(versionedUrl);
+        pushUnique(directUrl);
+        return candidates;
+    }
+
+    pushUnique(directUrl);
+    pushUnique(versionedUrl);
+    return candidates;
+}
+
+function buildModelsProbeUrl(baseUrl) {
+    return buildApiProbeUrlCandidates(baseUrl, 'models')[0] || '';
+}
+
+function buildModelProbeSpecs(provider, modelName, baseUrl) {
+    const model = typeof modelName === 'string' ? modelName.trim() : '';
+    if (!model) return [];
+
+    const wireApi = normalizeWireApi(provider && provider.wire_api);
+    let pathSuffix = 'responses';
+    let body = {
+        model,
+        input: 'ping',
+        max_output_tokens: 1
+    };
+
+    if (wireApi === 'chat_completions' || wireApi === 'chat') {
+        pathSuffix = 'chat/completions';
+        body = {
+            model,
+            messages: [{ role: 'user', content: 'ping' }],
+            max_tokens: 1,
+            temperature: 0
+        };
+    } else if (wireApi === 'completions') {
+        pathSuffix = 'completions';
+        body = {
+            model,
+            prompt: 'ping',
+            max_tokens: 1,
+            temperature: 0
+        };
+    }
+
+    return buildApiProbeUrlCandidates(baseUrl, pathSuffix).map((url) => ({
+        url,
+        body
+    }));
+}
+
+function buildModelProbeSpec(provider, modelName, baseUrl) {
+    return buildModelProbeSpecs(provider, modelName, baseUrl)[0] || null;
+}
+
+function collectStructuredText(content, pieces) {
+    if (typeof content === 'string') {
+        const text = content.trim();
+        if (text) pieces.push(text);
+        return;
+    }
+    if (Array.isArray(content)) {
+        for (const item of content) {
+            collectStructuredText(item, pieces);
+        }
+        return;
+    }
+    if (!content || typeof content !== 'object') {
+        return;
+    }
+
+    if (typeof content.output_text === 'string' && content.output_text.trim()) {
+        pieces.push(content.output_text.trim());
+    }
+    if (typeof content.text === 'string' && content.text.trim()) {
+        pieces.push(content.text.trim());
+    }
+    if (typeof content.content === 'string' && content.content.trim()) {
+        pieces.push(content.content.trim());
+    }
+
+    if (Array.isArray(content.content)) {
+        collectStructuredText(content.content, pieces);
+    }
+    if (content.message) {
+        collectStructuredText(content.message, pieces);
+    }
+}
+
+function extractModelResponseText(payload) {
+    if (!payload || typeof payload !== 'object') {
+        return '';
+    }
+
+    if (typeof payload.output_text === 'string' && payload.output_text.trim()) {
+        return payload.output_text.trim();
+    }
+
+    const pieces = [];
+
+    if (Array.isArray(payload.output)) {
+        for (const item of payload.output) {
+            collectStructuredText(item, pieces);
+        }
+    }
+
+    if (Array.isArray(payload.choices)) {
+        for (const choice of payload.choices) {
+            if (!choice || typeof choice !== 'object') continue;
+            if (typeof choice.text === 'string' && choice.text.trim()) {
+                pieces.push(choice.text.trim());
+            }
+            if (choice.message) {
+                collectStructuredText(choice.message, pieces);
+            }
+        }
+    }
+
+    if (payload.message) {
+        collectStructuredText(payload.message, pieces);
+    }
+    if (payload.content) {
+        collectStructuredText(payload.content, pieces);
+    }
+    if (typeof payload.text === 'string' && payload.text.trim()) {
+        pieces.push(payload.text.trim());
+    }
+
+    return Array.from(new Set(pieces)).join('\n\n').trim();
+}
+
+function hashModelsCacheValue(value) {
+    if (!value) return '';
+    try {
+        return crypto.createHash('sha256').update(String(value)).digest('hex');
+    } catch (e) {
+        return '';
+    }
+}
+
+function buildModelsCacheKey(baseUrl, apiKey) {
+    const normalizedUrl = normalizeBaseUrl(baseUrl);
+    const apiKeyHash = hashModelsCacheValue(apiKey);
+    return `${normalizedUrl}|${apiKeyHash}`;
+}
+
+module.exports = {
+    extractModelNames,
+    hasModelsListPayload,
+    extractModelIds,
+    normalizeWireApi,
+    buildApiProbeUrlCandidates,
+    buildModelsProbeUrl,
+    buildModelProbeSpecs,
+    buildModelProbeSpec,
+    extractModelResponseText,
+    hashModelsCacheValue,
+    buildModelsCacheKey,
+    getSupplementalModelsForBaseUrl,
+    mergeModelCatalog
+};