@xiuchang-midscene/shared 2.0.2

package/dist/es/env/global-config-manager.mjs

@@ -0,0 +1,94 @@
+import { initDebugConfig } from "./init-debug.mjs";
+import { ALL_ENV_KEYS, BOOLEAN_ENV_KEYS, GLOBAL_ENV_KEYS, MATCH_BY_POSITION, MODEL_ENV_KEYS, NUMBER_ENV_KEYS, STRING_ENV_KEYS } from "./types.mjs";
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+class GlobalConfigManager {
+    getAllEnvConfig() {
+        const envConfig = ALL_ENV_KEYS.reduce((p, name)=>{
+            p[name] = process.env[name];
+            return p;
+        }, Object.create(null));
+        if (!this.override) return envConfig;
+        {
+            const { newConfig, extendMode } = this.override;
+            if (extendMode) return {
+                ...envConfig,
+                ...newConfig
+            };
+            return {
+                ...newConfig
+            };
+        }
+    }
+    getEnvConfigValue(key) {
+        const allConfig = this.getAllEnvConfig();
+        if (key === MATCH_BY_POSITION) throw new Error('MATCH_BY_POSITION is discarded, use MIDSCENE_MODEL_FAMILY instead');
+        if (!STRING_ENV_KEYS.includes(key)) throw new Error(`getEnvConfigValue with key ${key} is not supported.`);
+        const value = allConfig[key];
+        this.keysHaveBeenRead[key] = true;
+        if ('string' == typeof value) return value.trim();
+        return value;
+    }
+    getEnvConfigInBoolean(key) {
+        const allConfig = this.getAllEnvConfig();
+        if (!BOOLEAN_ENV_KEYS.includes(key)) throw new Error(`getEnvConfigInBoolean with key ${key} is not supported`);
+        const value = allConfig[key];
+        this.keysHaveBeenRead[key] = true;
+        if (!value) return false;
+        if (/^(true|1)$/i.test(value)) return true;
+        if (/^(false|0)$/i.test(value)) return false;
+        return !!value.trim();
+    }
+    getEnvConfigValueAsNumber(key) {
+        if (!STRING_ENV_KEYS.includes(key) && !NUMBER_ENV_KEYS.includes(key)) throw new Error(`getEnvConfigValueAsNumber with key ${key} is not supported.`);
+        const allConfig = this.getAllEnvConfig();
+        const value = allConfig[key];
+        this.keysHaveBeenRead[key] = true;
+        if ('string' != typeof value) return;
+        const trimmed = value.trim();
+        if (!trimmed) return;
+        const numValue = Number(trimmed);
+        return Number.isNaN(numValue) ? void 0 : numValue;
+    }
+    registerModelConfigManager(globalModelConfigManager) {
+        this.globalModelConfigManager = globalModelConfigManager;
+    }
+    overrideAIConfig(newConfig, extendMode = false) {
+        for(const key in newConfig){
+            if (![
+                ...GLOBAL_ENV_KEYS,
+                ...MODEL_ENV_KEYS
+            ].includes(key)) throw new Error(`Failed to override AI config, invalid key: ${key}`);
+            const value = newConfig[key];
+            if ('string' != typeof value) throw new Error(`Failed to override AI config, value for key ${key} must be a string, but got with type ${typeof value}`);
+            if (this.keysHaveBeenRead[key]) console.warn(`Warning: try to override AI config with key ${key} ,but it has been read.`);
+        }
+        const savedNewConfig = extendMode ? {
+            ...this.override?.newConfig,
+            ...newConfig
+        } : newConfig;
+        this.override = {
+            newConfig: {
+                ...savedNewConfig
+            },
+            extendMode
+        };
+        if (!this.globalModelConfigManager) throw new Error('globalModelConfigManager is not registered, which should not happen');
+        this.globalModelConfigManager.clearModelConfigMap();
+    }
+    constructor(){
+        _define_property(this, "override", void 0);
+        _define_property(this, "keysHaveBeenRead", {});
+        _define_property(this, "globalModelConfigManager", void 0);
+        initDebugConfig();
+    }
+}
+export { GlobalConfigManager };

package/dist/es/env/global-config-manager.mjs.bak

@@ -0,0 +1,94 @@
+import { initDebugConfig } from "./init-debug.mjs";
+import { ALL_ENV_KEYS, BOOLEAN_ENV_KEYS, GLOBAL_ENV_KEYS, MATCH_BY_POSITION, MODEL_ENV_KEYS, NUMBER_ENV_KEYS, STRING_ENV_KEYS } from "./types.mjs";
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+class GlobalConfigManager {
+    getAllEnvConfig() {
+        const envConfig = ALL_ENV_KEYS.reduce((p, name)=>{
+            p[name] = process.env[name];
+            return p;
+        }, Object.create(null));
+        if (!this.override) return envConfig;
+        {
+            const { newConfig, extendMode } = this.override;
+            if (extendMode) return {
+                ...envConfig,
+                ...newConfig
+            };
+            return {
+                ...newConfig
+            };
+        }
+    }
+    getEnvConfigValue(key) {
+        const allConfig = this.getAllEnvConfig();
+        if (key === MATCH_BY_POSITION) throw new Error('MATCH_BY_POSITION is discarded, use MIDSCENE_MODEL_FAMILY instead');
+        if (!STRING_ENV_KEYS.includes(key)) throw new Error(`getEnvConfigValue with key ${key} is not supported.`);
+        const value = allConfig[key];
+        this.keysHaveBeenRead[key] = true;
+        if ('string' == typeof value) return value.trim();
+        return value;
+    }
+    getEnvConfigInBoolean(key) {
+        const allConfig = this.getAllEnvConfig();
+        if (!BOOLEAN_ENV_KEYS.includes(key)) throw new Error(`getEnvConfigInBoolean with key ${key} is not supported`);
+        const value = allConfig[key];
+        this.keysHaveBeenRead[key] = true;
+        if (!value) return false;
+        if (/^(true|1)$/i.test(value)) return true;
+        if (/^(false|0)$/i.test(value)) return false;
+        return !!value.trim();
+    }
+    getEnvConfigValueAsNumber(key) {
+        if (!STRING_ENV_KEYS.includes(key) && !NUMBER_ENV_KEYS.includes(key)) throw new Error(`getEnvConfigValueAsNumber with key ${key} is not supported.`);
+        const allConfig = this.getAllEnvConfig();
+        const value = allConfig[key];
+        this.keysHaveBeenRead[key] = true;
+        if ('string' != typeof value) return;
+        const trimmed = value.trim();
+        if (!trimmed) return;
+        const numValue = Number(trimmed);
+        return Number.isNaN(numValue) ? void 0 : numValue;
+    }
+    registerModelConfigManager(globalModelConfigManager) {
+        this.globalModelConfigManager = globalModelConfigManager;
+    }
+    overrideAIConfig(newConfig, extendMode = false) {
+        for(const key in newConfig){
+            if (![
+                ...GLOBAL_ENV_KEYS,
+                ...MODEL_ENV_KEYS
+            ].includes(key)) throw new Error(`Failed to override AI config, invalid key: ${key}`);
+            const value = newConfig[key];
+            if ('string' != typeof value) throw new Error(`Failed to override AI config, value for key ${key} must be a string, but got with type ${typeof value}`);
+            if (this.keysHaveBeenRead[key]) console.warn(`Warning: try to override AI config with key ${key} ,but it has been read.`);
+        }
+        const savedNewConfig = extendMode ? {
+            ...this.override?.newConfig,
+            ...newConfig
+        } : newConfig;
+        this.override = {
+            newConfig: {
+                ...savedNewConfig
+            },
+            extendMode
+        };
+        if (!this.globalModelConfigManager) throw new Error('globalModelConfigManager is not registered, which should not happen');
+        this.globalModelConfigManager.clearModelConfigMap();
+    }
+    constructor(){
+        _define_property(this, "override", void 0);
+        _define_property(this, "keysHaveBeenRead", {});
+        _define_property(this, "globalModelConfigManager", void 0);
+        initDebugConfig();
+    }
+}
+export { GlobalConfigManager };

package/dist/es/env/helper.mjs

@@ -0,0 +1,43 @@
+const maskKey = (key, maskChar = '*')=>{
+    if ('string' != typeof key || 0 === key.length) return key;
+    const prefixLen = 3;
+    const suffixLen = 3;
+    const keepLength = prefixLen + suffixLen;
+    if (key.length <= keepLength) return key;
+    const prefix = key.substring(0, prefixLen);
+    const suffix = key.substring(key.length - suffixLen);
+    const maskLength = key.length - keepLength;
+    const mask = maskChar.repeat(maskLength);
+    return `${prefix}${mask}${suffix}`;
+};
+const maskConfig = (config)=>Object.fromEntries(Object.entries(config).map(([key, value])=>{
+        if (!value) return [
+            key,
+            value
+        ];
+        if ('string' == typeof value && /key/i.test(key)) return [
+            key,
+            maskKey(value)
+        ];
+        if ('object' == typeof value) {
+            const valueStr = JSON.stringify(value);
+            if (/key/i.test(valueStr)) return [
+                key,
+                maskKey(valueStr)
+            ];
+        }
+        return [
+            key,
+            value
+        ];
+    }));
+const parseJson = (key, value)=>{
+    if (value) try {
+        return JSON.parse(value);
+    } catch (e) {
+        throw new Error(`Failed to parse ${key} as a JSON. ${e.message}`, {
+            cause: e
+        });
+    }
+};
+export { maskConfig, parseJson };

package/dist/es/env/helper.mjs.bak

@@ -0,0 +1,43 @@
+const maskKey = (key, maskChar = '*')=>{
+    if ('string' != typeof key || 0 === key.length) return key;
+    const prefixLen = 3;
+    const suffixLen = 3;
+    const keepLength = prefixLen + suffixLen;
+    if (key.length <= keepLength) return key;
+    const prefix = key.substring(0, prefixLen);
+    const suffix = key.substring(key.length - suffixLen);
+    const maskLength = key.length - keepLength;
+    const mask = maskChar.repeat(maskLength);
+    return `${prefix}${mask}${suffix}`;
+};
+const maskConfig = (config)=>Object.fromEntries(Object.entries(config).map(([key, value])=>{
+        if (!value) return [
+            key,
+            value
+        ];
+        if ('string' == typeof value && /key/i.test(key)) return [
+            key,
+            maskKey(value)
+        ];
+        if ('object' == typeof value) {
+            const valueStr = JSON.stringify(value);
+            if (/key/i.test(valueStr)) return [
+                key,
+                maskKey(valueStr)
+            ];
+        }
+        return [
+            key,
+            value
+        ];
+    }));
+const parseJson = (key, value)=>{
+    if (value) try {
+        return JSON.parse(value);
+    } catch (e) {
+        throw new Error(`Failed to parse ${key} as a JSON. ${e.message}`, {
+            cause: e
+        });
+    }
+};
+export { maskConfig, parseJson };

package/dist/es/env/index.mjs

@@ -0,0 +1,5 @@
+import { ModelConfigManager } from "./model-config-manager.mjs";
+import { GlobalConfigManager } from "./global-config-manager.mjs";
+export * from "./utils.mjs";
+export * from "./types.mjs";
+export { GlobalConfigManager, ModelConfigManager };

package/dist/es/env/index.mjs.bak

@@ -0,0 +1,5 @@
+import { ModelConfigManager } from "./model-config-manager.mjs";
+import { GlobalConfigManager } from "./global-config-manager.mjs";
+export * from "./utils.mjs";
+export * from "./types.mjs";
+export { GlobalConfigManager, ModelConfigManager };

package/dist/es/env/init-debug.mjs

@@ -0,0 +1,18 @@
+import { enableDebug } from "../logger.mjs";
+import { getBasicEnvValue } from "./basic.mjs";
+import { MIDSCENE_DEBUG_MODEL_PROFILE, MIDSCENE_DEBUG_MODEL_RESPONSE } from "./types.mjs";
+const initDebugConfig = ()=>{
+    const shouldPrintTiming = getBasicEnvValue(MIDSCENE_DEBUG_MODEL_PROFILE);
+    let debugConfig = '';
+    if (shouldPrintTiming) {
+        console.warn('MIDSCENE_DEBUG_MODEL_PROFILE is deprecated, use DEBUG=midscene:ai:profile instead');
+        debugConfig = 'ai:profile';
+    }
+    const shouldPrintModelResponse = getBasicEnvValue(MIDSCENE_DEBUG_MODEL_RESPONSE);
+    if (shouldPrintModelResponse) {
+        console.warn('MIDSCENE_DEBUG_MODEL_RESPONSE is deprecated, use DEBUG=midscene:ai:response instead');
+        debugConfig = debugConfig ? 'ai:*' : 'ai:call';
+    }
+    if (debugConfig) enableDebug(debugConfig);
+};
+export { initDebugConfig };

package/dist/es/env/init-debug.mjs.bak

@@ -0,0 +1,18 @@
+import { enableDebug } from "../logger.mjs";
+import { getBasicEnvValue } from "./basic.mjs";
+import { MIDSCENE_DEBUG_MODEL_PROFILE, MIDSCENE_DEBUG_MODEL_RESPONSE } from "./types.mjs";
+const initDebugConfig = ()=>{
+    const shouldPrintTiming = getBasicEnvValue(MIDSCENE_DEBUG_MODEL_PROFILE);
+    let debugConfig = '';
+    if (shouldPrintTiming) {
+        console.warn('MIDSCENE_DEBUG_MODEL_PROFILE is deprecated, use DEBUG=midscene:ai:profile instead');
+        debugConfig = 'ai:profile';
+    }
+    const shouldPrintModelResponse = getBasicEnvValue(MIDSCENE_DEBUG_MODEL_RESPONSE);
+    if (shouldPrintModelResponse) {
+        console.warn('MIDSCENE_DEBUG_MODEL_RESPONSE is deprecated, use DEBUG=midscene:ai:response instead');
+        debugConfig = debugConfig ? 'ai:*' : 'ai:call';
+    }
+    if (debugConfig) enableDebug(debugConfig);
+};
+export { initDebugConfig };

package/dist/es/env/model-config-manager.mjs

@@ -0,0 +1,79 @@
+import { decideModelConfigFromIntentConfig } from "./parse-model-config.mjs";
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+class ModelConfigManager {
+    initialize() {
+        if (this.isInitialized) return;
+        let configMap;
+        if (this.modelConfig) {
+            this.isolatedMode = true;
+            configMap = this.normalizeModelConfig(this.modelConfig);
+        } else configMap = this.globalConfigManager?.getAllEnvConfig() || {};
+        const defaultConfig = decideModelConfigFromIntentConfig('default', configMap);
+        if (!defaultConfig) throw new Error('Model configuration is incomplete: model name (MIDSCENE_MODEL_NAME) is required. See https://midscenejs.com/model-strategy.html');
+        const insightConfig = decideModelConfigFromIntentConfig('insight', configMap);
+        const planningConfig = decideModelConfigFromIntentConfig('planning', configMap);
+        this.modelConfigMap = {
+            default: {
+                ...defaultConfig,
+                createOpenAIClient: this.createOpenAIClientFn
+            },
+            insight: {
+                ...insightConfig || defaultConfig,
+                createOpenAIClient: this.createOpenAIClientFn
+            },
+            planning: {
+                ...planningConfig || defaultConfig,
+                createOpenAIClient: this.createOpenAIClientFn
+            }
+        };
+        this.isInitialized = true;
+    }
+    normalizeModelConfig(config) {
+        return Object.entries(config).reduce((acc, [key, value])=>{
+            if (null == value) return acc;
+            acc[key] = String(value);
+            return acc;
+        }, Object.create(null));
+    }
+    clearModelConfigMap() {
+        if (this.isolatedMode) throw new Error('ModelConfigManager work in isolated mode, so clearModelConfigMap should not be called');
+        this.isInitialized = false;
+    }
+    getModelConfig(intent) {
+        if (!this.isInitialized) this.initialize();
+        if (!this.modelConfigMap) throw new Error('modelConfigMap is not initialized, which should not happen');
+        return this.modelConfigMap[intent];
+    }
+    getUploadTestServerUrl() {
+        const { openaiExtraConfig } = this.getModelConfig('default');
+        const serverUrl = openaiExtraConfig?.REPORT_SERVER_URL;
+        return serverUrl;
+    }
+    registerGlobalConfigManager(globalConfigManager) {
+        this.globalConfigManager = globalConfigManager;
+    }
+    throwErrorIfNonVLModel() {
+        const modelConfig = this.getModelConfig('default');
+        if (!modelConfig.modelFamily) throw new Error('MIDSCENE_MODEL_FAMILY is not set to a visual language model (VL model), the element localization can not be achieved. Check your model configuration. See https://midscenejs.com/model-strategy.html');
+    }
+    constructor(modelConfig, createOpenAIClientFn){
+        _define_property(this, "modelConfigMap", void 0);
+        _define_property(this, "isInitialized", false);
+        _define_property(this, "isolatedMode", false);
+        _define_property(this, "globalConfigManager", void 0);
+        _define_property(this, "modelConfig", void 0);
+        _define_property(this, "createOpenAIClientFn", void 0);
+        this.modelConfig = modelConfig;
+        this.createOpenAIClientFn = createOpenAIClientFn;
+    }
+}
+export { ModelConfigManager };

package/dist/es/env/model-config-manager.mjs.bak

@@ -0,0 +1,79 @@
+import { decideModelConfigFromIntentConfig } from "./parse-model-config.mjs";
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+class ModelConfigManager {
+    initialize() {
+        if (this.isInitialized) return;
+        let configMap;
+        if (this.modelConfig) {
+            this.isolatedMode = true;
+            configMap = this.normalizeModelConfig(this.modelConfig);
+        } else configMap = this.globalConfigManager?.getAllEnvConfig() || {};
+        const defaultConfig = decideModelConfigFromIntentConfig('default', configMap);
+        if (!defaultConfig) throw new Error('Model configuration is incomplete: model name (MIDSCENE_MODEL_NAME) is required. See https://midscenejs.com/model-strategy.html');
+        const insightConfig = decideModelConfigFromIntentConfig('insight', configMap);
+        const planningConfig = decideModelConfigFromIntentConfig('planning', configMap);
+        this.modelConfigMap = {
+            default: {
+                ...defaultConfig,
+                createOpenAIClient: this.createOpenAIClientFn
+            },
+            insight: {
+                ...insightConfig || defaultConfig,
+                createOpenAIClient: this.createOpenAIClientFn
+            },
+            planning: {
+                ...planningConfig || defaultConfig,
+                createOpenAIClient: this.createOpenAIClientFn
+            }
+        };
+        this.isInitialized = true;
+    }
+    normalizeModelConfig(config) {
+        return Object.entries(config).reduce((acc, [key, value])=>{
+            if (null == value) return acc;
+            acc[key] = String(value);
+            return acc;
+        }, Object.create(null));
+    }
+    clearModelConfigMap() {
+        if (this.isolatedMode) throw new Error('ModelConfigManager work in isolated mode, so clearModelConfigMap should not be called');
+        this.isInitialized = false;
+    }
+    getModelConfig(intent) {
+        if (!this.isInitialized) this.initialize();
+        if (!this.modelConfigMap) throw new Error('modelConfigMap is not initialized, which should not happen');
+        return this.modelConfigMap[intent];
+    }
+    getUploadTestServerUrl() {
+        const { openaiExtraConfig } = this.getModelConfig('default');
+        const serverUrl = openaiExtraConfig?.REPORT_SERVER_URL;
+        return serverUrl;
+    }
+    registerGlobalConfigManager(globalConfigManager) {
+        this.globalConfigManager = globalConfigManager;
+    }
+    throwErrorIfNonVLModel() {
+        const modelConfig = this.getModelConfig('default');
+        if (!modelConfig.modelFamily) throw new Error('MIDSCENE_MODEL_FAMILY is not set to a visual language model (VL model), the element localization can not be achieved. Check your model configuration. See https://midscenejs.com/model-strategy.html');
+    }
+    constructor(modelConfig, createOpenAIClientFn){
+        _define_property(this, "modelConfigMap", void 0);
+        _define_property(this, "isInitialized", false);
+        _define_property(this, "isolatedMode", false);
+        _define_property(this, "globalConfigManager", void 0);
+        _define_property(this, "modelConfig", void 0);
+        _define_property(this, "createOpenAIClientFn", void 0);
+        this.modelConfig = modelConfig;
+        this.createOpenAIClientFn = createOpenAIClientFn;
+    }
+}
+export { ModelConfigManager };

package/dist/es/env/parse-model-config.mjs

@@ -0,0 +1,132 @@
+import { DEFAULT_MODEL_CONFIG_KEYS, INSIGHT_MODEL_CONFIG_KEYS, PLANNING_MODEL_CONFIG_KEYS } from "./constants.mjs";
+import { MIDSCENE_OPENAI_HTTP_PROXY, MIDSCENE_OPENAI_INIT_CONFIG_JSON, MIDSCENE_OPENAI_SOCKS_PROXY, MIDSCENE_USE_DOUBAO_VISION, MIDSCENE_USE_GEMINI, MIDSCENE_USE_QWEN3_VL, MIDSCENE_USE_QWEN_VL, MIDSCENE_USE_VLM_UI_TARS, MODEL_FAMILY_VALUES, OPENAI_API_KEY, OPENAI_BASE_URL, UITarsModelVersion } from "./types.mjs";
+import { getDebug } from "../logger.mjs";
+import { assert } from "../utils.mjs";
+import { maskConfig, parseJson } from "./helper.mjs";
+import { initDebugConfig } from "./init-debug.mjs";
+const KEYS_MAP = {
+    insight: INSIGHT_MODEL_CONFIG_KEYS,
+    planning: PLANNING_MODEL_CONFIG_KEYS,
+    default: DEFAULT_MODEL_CONFIG_KEYS
+};
+const getUITarsModelVersion = (modelFamily)=>{
+    if ('vlm-ui-tars' === modelFamily) return UITarsModelVersion.V1_0;
+    if ('vlm-ui-tars-doubao' === modelFamily || 'vlm-ui-tars-doubao-1.5' === modelFamily) return UITarsModelVersion.DOUBAO_1_5_20B;
+};
+const validateModelFamily = (modelFamily)=>{
+    if (modelFamily && !MODEL_FAMILY_VALUES.includes(modelFamily)) throw new Error(`Invalid MIDSCENE_MODEL_FAMILY value: ${modelFamily}`);
+};
+const legacyConfigToModelFamily = (provider)=>{
+    const isDoubao = provider[MIDSCENE_USE_DOUBAO_VISION];
+    const isQwen = provider[MIDSCENE_USE_QWEN_VL];
+    const isQwen3 = provider[MIDSCENE_USE_QWEN3_VL];
+    const isUiTars = provider[MIDSCENE_USE_VLM_UI_TARS];
+    const isGemini = provider[MIDSCENE_USE_GEMINI];
+    const enabledModes = [
+        isDoubao && MIDSCENE_USE_DOUBAO_VISION,
+        isQwen && MIDSCENE_USE_QWEN_VL,
+        isQwen3 && MIDSCENE_USE_QWEN3_VL,
+        isUiTars && MIDSCENE_USE_VLM_UI_TARS,
+        isGemini && MIDSCENE_USE_GEMINI
+    ].filter(Boolean);
+    if (enabledModes.length > 1) throw new Error(`Only one vision mode can be enabled at a time. Currently enabled modes: ${enabledModes.join(', ')}. Please disable all but one mode.`);
+    if (isQwen3) return 'qwen3-vl';
+    if (isQwen) return 'qwen2.5-vl';
+    if (isDoubao) return 'doubao-vision';
+    if (isGemini) return 'gemini';
+    if (isUiTars) if ('1' === isUiTars) return 'vlm-ui-tars';
+    else if ('DOUBAO' === isUiTars || 'DOUBAO-1.5' === isUiTars) return 'vlm-ui-tars-doubao-1.5';
+    else return 'vlm-ui-tars-doubao';
+};
+const getModelDescription = (modelFamily, uiTarsModelVersion)=>{
+    if (uiTarsModelVersion) return `UI-TARS=${uiTarsModelVersion}`;
+    if (modelFamily) return `${modelFamily} mode`;
+    return '';
+};
+const parseOpenaiSdkConfig = ({ keys, provider, useLegacyLogic = false })=>{
+    initDebugConfig();
+    const debugLog = getDebug('ai:config');
+    debugLog('enter parseOpenaiSdkConfig with keys:', keys);
+    const legacyAPIKey = useLegacyLogic ? provider[OPENAI_API_KEY] : void 0;
+    const legacyBaseURL = useLegacyLogic ? provider[OPENAI_BASE_URL] : void 0;
+    const legacySocksProxy = useLegacyLogic ? provider[MIDSCENE_OPENAI_SOCKS_PROXY] : void 0;
+    const legacyHttpProxy = useLegacyLogic ? provider[MIDSCENE_OPENAI_HTTP_PROXY] : void 0;
+    const legacyOpenaiExtraConfig = useLegacyLogic ? provider[MIDSCENE_OPENAI_INIT_CONFIG_JSON] : void 0;
+    const legacyModelFamily = useLegacyLogic ? legacyConfigToModelFamily(provider) : void 0;
+    const modelFamilyRaw = provider[keys.modelFamily] || legacyModelFamily;
+    const openaiApiKey = provider[keys.openaiApiKey] || legacyAPIKey;
+    const openaiBaseURL = provider[keys.openaiBaseURL] || legacyBaseURL;
+    const socksProxy = provider[keys.socksProxy] || legacySocksProxy;
+    const httpProxy = provider[keys.httpProxy] || legacyHttpProxy;
+    const modelName = provider[keys.modelName];
+    const openaiExtraConfigStr = provider[keys.openaiExtraConfig];
+    const openaiExtraConfig = parseJson(keys.openaiExtraConfig, openaiExtraConfigStr || legacyOpenaiExtraConfig);
+    const extraBodyStr = provider[keys.extraBody];
+    const extraBody = parseJson(keys.extraBody, extraBodyStr);
+    const temperature = provider[keys.temperature] ? Number(provider[keys.temperature]) : 0;
+    const modelFamily = modelFamilyRaw;
+    validateModelFamily(modelFamily);
+    const uiTarsModelVersion = getUITarsModelVersion(modelFamily);
+    const modelDescription = getModelDescription(modelFamily, uiTarsModelVersion);
+    return {
+        socksProxy,
+        httpProxy,
+        openaiBaseURL,
+        openaiApiKey,
+        openaiExtraConfig,
+        extraBody,
+        modelFamily,
+        uiTarsModelVersion,
+        modelName: modelName,
+        modelDescription,
+        intent: '-',
+        timeout: provider[keys.timeout] ? Number(provider[keys.timeout]) : void 0,
+        temperature,
+        retryCount: (()=>{
+            if (!provider[keys.retryCount]) return 1;
+            const val = Number(provider[keys.retryCount]);
+            if (!Number.isFinite(val)) return 1;
+            if (val < 0) throw new Error(`${keys.retryCount} must be non-negative, got ${val}`);
+            return val;
+        })(),
+        retryInterval: (()=>{
+            if (!provider[keys.retryInterval]) return 2000;
+            const val = Number(provider[keys.retryInterval]);
+            if (!Number.isFinite(val)) return 2000;
+            if (val < 0) throw new Error(`${keys.retryInterval} must be non-negative, got ${val}`);
+            return val;
+        })(),
+        reasoningEffort: provider[keys.reasoningEffort]?.trim() || void 0,
+        reasoningEnabled: (()=>{
+            const val = provider[keys.reasoningEnabled]?.trim()?.toLowerCase();
+            if ('true' === val || '1' === val) return true;
+            if ('false' === val || '0' === val) return false;
+        })(),
+        reasoningBudget: (()=>{
+            const val = provider[keys.reasoningBudget]?.trim();
+            if (!val) return;
+            const num = Number(val);
+            return Number.isFinite(num) ? num : void 0;
+        })()
+    };
+};
+const decideModelConfigFromIntentConfig = (intent, configMap)=>{
+    const debugLog = getDebug('ai:config');
+    debugLog('will decideModelConfig base on agent.modelConfig()', intent, maskConfig(configMap));
+    const keysForFn = KEYS_MAP[intent];
+    const modelName = configMap[keysForFn.modelName];
+    if (!modelName) return void debugLog('no modelName found for intent', intent);
+    const finalResult = parseOpenaiSdkConfig({
+        keys: keysForFn,
+        provider: configMap,
+        useLegacyLogic: 'default' === intent
+    });
+    finalResult.intent = intent;
+    debugLog('decideModelConfig result by agent.modelConfig() with intent', intent, maskConfig({
+        ...finalResult
+    }));
+    assert(finalResult.openaiBaseURL, `failed to get base URL of model (intent=${intent}). See https://midscenejs.com/model-strategy`);
+    if (!finalResult.modelName) console.warn(`modelName is not set for intent ${intent}, this may cause unexpected behavior. See https://midscenejs.com/model-strategy`);
+    return finalResult;
+};
+export { decideModelConfigFromIntentConfig, getUITarsModelVersion, legacyConfigToModelFamily, parseOpenaiSdkConfig, validateModelFamily };