@midscene/shared 1.8.5-beta-20260525033347.0 → 1.8.5

package/dist/es/cli/cli-args.mjs

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { getKeyAliases } from "../key-alias-utils.mjs";
+import { CLIError } from "./cli-error.mjs";
 function parseValue(raw) {
     if (raw.startsWith('{') || raw.startsWith('[')) try {
         return JSON.parse(raw);
@@ -23,7 +24,20 @@ function walkCliArgs(args, setArgValue) {
 function parseCliArgs(args) {
     const result = {};
     walkCliArgs(args, (key, value)=>{
-        result[key] = value;
+        const existing = result[key];
+        if (void 0 === existing) {
+            result[key] = value;
+            return;
+        }
+        if (Array.isArray(existing)) {
+            existing.push(value);
+            result[key] = existing;
+            return;
+        }
+        result[key] = [
+            existing,
+            value
+        ];
     });
     return result;
 }
@@ -92,4 +106,29 @@ function formatCliValidationError(scriptName, commandName, def, rawArgs) {
     const optionName = 'string' == typeof issue?.path[0] ? `--${issue.path[0]}` : 'CLI arguments';
     return `Invalid value for "${optionName}" in ${scriptName} ${commandName}: ${issue?.message ?? parsed.error.message}`;
 }
-export { formatCliValidationError, getCliOptionDisplay, parseCliArgs, parseValue };
+function canonicalizeCliArgKeys(scriptName, commandName, def, rawArgs) {
+    if (0 === Object.keys(def.schema).length) return rawArgs;
+    const result = {
+        ...rawArgs
+    };
+    for (const schemaKey of Object.keys(def.schema)){
+        const cliOption = def.cli?.options?.[schemaKey];
+        const acceptedSpellings = getAcceptedCliOptionNames(schemaKey, cliOption);
+        let chosenSpelling;
+        let chosenValue;
+        for (const spelling of acceptedSpellings)if (spelling !== schemaKey) {
+            if (spelling in result) {
+                if (void 0 !== chosenSpelling) throw new CLIError(`Conflicting CLI options "--${chosenSpelling}" and "--${spelling}" for ${scriptName} ${commandName}: both target "${schemaKey}". Use one spelling.`);
+                chosenSpelling = spelling;
+                chosenValue = result[spelling];
+            }
+        }
+        if (void 0 !== chosenSpelling) {
+            if (schemaKey in result && result[schemaKey] !== chosenValue) throw new CLIError(`Conflicting CLI options "--${schemaKey}" and "--${chosenSpelling}" for ${scriptName} ${commandName}: both target "${schemaKey}". Use one spelling.`);
+            result[schemaKey] = chosenValue;
+            delete result[chosenSpelling];
+        }
+    }
+    return result;
+}
+export { canonicalizeCliArgKeys, formatCliValidationError, getCliOptionDisplay, parseCliArgs, parseValue };

package/dist/es/cli/cli-runner.mjs

@@ -3,7 +3,7 @@ import { tmpdir } from "node:os";
 import { join } from "node:path";
 import dotenv from "dotenv";
 import { getDebug } from "../logger.mjs";
-import { formatCliValidationError, getCliOptionDisplay, parseCliArgs, parseValue } from "./cli-args.mjs";
+import { canonicalizeCliArgKeys, formatCliValidationError, getCliOptionDisplay, parseCliArgs, parseValue } from "./cli-args.mjs";
 import { CLIError, reportCLIError } from "./cli-error.mjs";
 const debug = getDebug('cli-runner');
 function outputContentItem(item, isError) {
@@ -112,8 +112,9 @@ async function runToolsCLI(tools, scriptName, options) {
     }
     const cliValidationError = formatCliValidationError(scriptName, match.name, match.def, parsedArgs);
     if (cliValidationError) throw new CLIError(cliValidationError);
-    debug('command: %s, args: %s', match.name, JSON.stringify(parsedArgs));
-    const result = await match.def.handler(parsedArgs);
+    const handlerArgs = canonicalizeCliArgKeys(scriptName, match.name, match.def, parsedArgs);
+    debug('command: %s, args: %s', match.name, JSON.stringify(handlerArgs));
+    const result = await match.def.handler(handlerArgs);
     debug('command %s completed, isError: %s', match.name, result.isError ?? false);
     outputResult(result);
     await tools.destroy();

package/dist/es/constants/example-code.mjs

@@ -5,7 +5,7 @@ const PLAYWRIGHT_EXAMPLE_CODE = `
 IMPORTANT: Follow these exact type signatures for AI functions:
 
 // Type signatures for AI functions:
-aiAct(prompt: string, options?: { cacheable?: boolean, deepThink?: 'unset' | true | false }): Promise<void>
+aiAct(prompt: string, options?: { cacheable?: boolean, deepThink?: 'unset' | true | false }): Promise<string | undefined>
 aiInput(text: string, locate: string, options?: { deepLocate?: boolean, xpath?: string, cacheable?: boolean }): Promise<void>
 aiTap(locate: string, options?: { deepLocate?: boolean, xpath?: string, cacheable?: boolean }): Promise<void>
 aiHover(locate: string, options?: { deepLocate?: boolean, xpath?: string, cacheable?: boolean }): Promise<void>

package/dist/es/env/constants.mjs

@@ -1,4 +1,4 @@
-import { MIDSCENE_INSIGHT_MODEL_API_KEY, MIDSCENE_INSIGHT_MODEL_BASE_URL, MIDSCENE_INSIGHT_MODEL_EXTRA_BODY_JSON, MIDSCENE_INSIGHT_MODEL_FAMILY, MIDSCENE_INSIGHT_MODEL_HTTP_PROXY, MIDSCENE_INSIGHT_MODEL_INIT_CONFIG_JSON, MIDSCENE_INSIGHT_MODEL_NAME, MIDSCENE_INSIGHT_MODEL_REASONING_BUDGET, MIDSCENE_INSIGHT_MODEL_REASONING_EFFORT, MIDSCENE_INSIGHT_MODEL_REASONING_ENABLED, MIDSCENE_INSIGHT_MODEL_RETRY_COUNT, MIDSCENE_INSIGHT_MODEL_RETRY_INTERVAL, MIDSCENE_INSIGHT_MODEL_SOCKS_PROXY, MIDSCENE_INSIGHT_MODEL_TEMPERATURE, MIDSCENE_INSIGHT_MODEL_TIMEOUT, MIDSCENE_MODEL_API_KEY, MIDSCENE_MODEL_BASE_URL, MIDSCENE_MODEL_EXTRA_BODY_JSON, MIDSCENE_MODEL_FAMILY, MIDSCENE_MODEL_HTTP_PROXY, MIDSCENE_MODEL_INIT_CONFIG_JSON, MIDSCENE_MODEL_NAME, MIDSCENE_MODEL_REASONING_BUDGET, MIDSCENE_MODEL_REASONING_EFFORT, MIDSCENE_MODEL_REASONING_ENABLED, MIDSCENE_MODEL_RETRY_COUNT, MIDSCENE_MODEL_RETRY_INTERVAL, MIDSCENE_MODEL_SOCKS_PROXY, MIDSCENE_MODEL_TEMPERATURE, MIDSCENE_MODEL_TIMEOUT, MIDSCENE_OPENAI_HTTP_PROXY, MIDSCENE_OPENAI_INIT_CONFIG_JSON, MIDSCENE_OPENAI_SOCKS_PROXY, MIDSCENE_PLANNING_MODEL_API_KEY, MIDSCENE_PLANNING_MODEL_BASE_URL, MIDSCENE_PLANNING_MODEL_EXTRA_BODY_JSON, MIDSCENE_PLANNING_MODEL_FAMILY, MIDSCENE_PLANNING_MODEL_HTTP_PROXY, MIDSCENE_PLANNING_MODEL_INIT_CONFIG_JSON, MIDSCENE_PLANNING_MODEL_NAME, MIDSCENE_PLANNING_MODEL_REASONING_BUDGET, MIDSCENE_PLANNING_MODEL_REASONING_EFFORT, MIDSCENE_PLANNING_MODEL_REASONING_ENABLED, MIDSCENE_PLANNING_MODEL_RETRY_COUNT, MIDSCENE_PLANNING_MODEL_RETRY_INTERVAL, MIDSCENE_PLANNING_MODEL_SOCKS_PROXY, MIDSCENE_PLANNING_MODEL_TEMPERATURE, MIDSCENE_PLANNING_MODEL_TIMEOUT, OPENAI_API_KEY, OPENAI_BASE_URL } from "./types.mjs";
+import { MIDSCENE_INSIGHT_MODEL_API_KEY, MIDSCENE_INSIGHT_MODEL_BASE_URL, MIDSCENE_INSIGHT_MODEL_EXTRA_BODY_JSON, MIDSCENE_INSIGHT_MODEL_FAMILY, MIDSCENE_INSIGHT_MODEL_HTTP_PROXY, MIDSCENE_INSIGHT_MODEL_INIT_CONFIG_JSON, MIDSCENE_INSIGHT_MODEL_MAX_TOKENS, MIDSCENE_INSIGHT_MODEL_NAME, MIDSCENE_INSIGHT_MODEL_REASONING_BUDGET, MIDSCENE_INSIGHT_MODEL_REASONING_EFFORT, MIDSCENE_INSIGHT_MODEL_REASONING_ENABLED, MIDSCENE_INSIGHT_MODEL_RETRY_COUNT, MIDSCENE_INSIGHT_MODEL_RETRY_INTERVAL, MIDSCENE_INSIGHT_MODEL_SOCKS_PROXY, MIDSCENE_INSIGHT_MODEL_TEMPERATURE, MIDSCENE_INSIGHT_MODEL_TIMEOUT, MIDSCENE_MODEL_API_KEY, MIDSCENE_MODEL_BASE_URL, MIDSCENE_MODEL_EXTRA_BODY_JSON, MIDSCENE_MODEL_FAMILY, MIDSCENE_MODEL_HTTP_PROXY, MIDSCENE_MODEL_INIT_CONFIG_JSON, MIDSCENE_MODEL_MAX_TOKENS, MIDSCENE_MODEL_NAME, MIDSCENE_MODEL_REASONING_BUDGET, MIDSCENE_MODEL_REASONING_EFFORT, MIDSCENE_MODEL_REASONING_ENABLED, MIDSCENE_MODEL_RETRY_COUNT, MIDSCENE_MODEL_RETRY_INTERVAL, MIDSCENE_MODEL_SOCKS_PROXY, MIDSCENE_MODEL_TEMPERATURE, MIDSCENE_MODEL_TIMEOUT, MIDSCENE_OPENAI_HTTP_PROXY, MIDSCENE_OPENAI_INIT_CONFIG_JSON, MIDSCENE_OPENAI_SOCKS_PROXY, MIDSCENE_PLANNING_MODEL_API_KEY, MIDSCENE_PLANNING_MODEL_BASE_URL, MIDSCENE_PLANNING_MODEL_EXTRA_BODY_JSON, MIDSCENE_PLANNING_MODEL_FAMILY, MIDSCENE_PLANNING_MODEL_HTTP_PROXY, MIDSCENE_PLANNING_MODEL_INIT_CONFIG_JSON, MIDSCENE_PLANNING_MODEL_MAX_TOKENS, MIDSCENE_PLANNING_MODEL_NAME, MIDSCENE_PLANNING_MODEL_REASONING_BUDGET, MIDSCENE_PLANNING_MODEL_REASONING_EFFORT, MIDSCENE_PLANNING_MODEL_REASONING_ENABLED, MIDSCENE_PLANNING_MODEL_RETRY_COUNT, MIDSCENE_PLANNING_MODEL_RETRY_INTERVAL, MIDSCENE_PLANNING_MODEL_SOCKS_PROXY, MIDSCENE_PLANNING_MODEL_TEMPERATURE, MIDSCENE_PLANNING_MODEL_TIMEOUT, OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_MAX_TOKENS } from "./types.mjs";
 const INSIGHT_MODEL_CONFIG_KEYS = {
     modelName: MIDSCENE_INSIGHT_MODEL_NAME,
     socksProxy: MIDSCENE_INSIGHT_MODEL_SOCKS_PROXY,
@@ -7,6 +7,7 @@ const INSIGHT_MODEL_CONFIG_KEYS = {
     openaiApiKey: MIDSCENE_INSIGHT_MODEL_API_KEY,
     openaiExtraConfig: MIDSCENE_INSIGHT_MODEL_INIT_CONFIG_JSON,
     extraBody: MIDSCENE_INSIGHT_MODEL_EXTRA_BODY_JSON,
+    maxTokens: MIDSCENE_INSIGHT_MODEL_MAX_TOKENS,
     modelFamily: MIDSCENE_INSIGHT_MODEL_FAMILY,
     timeout: MIDSCENE_INSIGHT_MODEL_TIMEOUT,
     temperature: MIDSCENE_INSIGHT_MODEL_TEMPERATURE,
@@ -24,6 +25,7 @@ const PLANNING_MODEL_CONFIG_KEYS = {
     openaiApiKey: MIDSCENE_PLANNING_MODEL_API_KEY,
     openaiExtraConfig: MIDSCENE_PLANNING_MODEL_INIT_CONFIG_JSON,
     extraBody: MIDSCENE_PLANNING_MODEL_EXTRA_BODY_JSON,
+    maxTokens: MIDSCENE_PLANNING_MODEL_MAX_TOKENS,
     modelFamily: MIDSCENE_PLANNING_MODEL_FAMILY,
     timeout: MIDSCENE_PLANNING_MODEL_TIMEOUT,
     temperature: MIDSCENE_PLANNING_MODEL_TEMPERATURE,
@@ -41,6 +43,7 @@ const DEFAULT_MODEL_CONFIG_KEYS = {
     openaiApiKey: MIDSCENE_MODEL_API_KEY,
     openaiExtraConfig: MIDSCENE_MODEL_INIT_CONFIG_JSON,
     extraBody: MIDSCENE_MODEL_EXTRA_BODY_JSON,
+    maxTokens: MIDSCENE_MODEL_MAX_TOKENS,
     modelFamily: MIDSCENE_MODEL_FAMILY,
     timeout: MIDSCENE_MODEL_TIMEOUT,
     temperature: MIDSCENE_MODEL_TEMPERATURE,
@@ -58,6 +61,7 @@ const DEFAULT_MODEL_CONFIG_KEYS_LEGACY = {
     openaiApiKey: OPENAI_API_KEY,
     openaiExtraConfig: MIDSCENE_OPENAI_INIT_CONFIG_JSON,
     extraBody: MIDSCENE_MODEL_EXTRA_BODY_JSON,
+    maxTokens: OPENAI_MAX_TOKENS,
     modelFamily: 'DEFAULT_MODEL_CONFIG_KEYS has no modelFamily key',
     timeout: MIDSCENE_MODEL_TIMEOUT,
     temperature: MIDSCENE_MODEL_TEMPERATURE,

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

@@ -1,11 +1,11 @@
 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 { 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, OPENAI_MAX_TOKENS, 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 MODEL_CONFIG_DOC_URL = 'https://midscenejs.com/model-common-config.html';
-const getCurrentVersion = ()=>"1.8.5-beta-20260525033347.0";
+const getCurrentVersion = ()=>"1.8.5";
 const getInvalidModelFamilyMessage = (modelFamily)=>`Invalid MIDSCENE_MODEL_FAMILY value: ${modelFamily}. Current version v${getCurrentVersion()} accepts the following model families: ${MODEL_FAMILY_VALUES.join(', ')}. You can also visit ${MODEL_CONFIG_DOC_URL} for the latest configuration information.`;
 const KEYS_MAP = {
     insight: INSIGHT_MODEL_CONFIG_KEYS,
@@ -65,6 +65,7 @@ const parseOpenaiSdkConfig = ({ keys, provider, useLegacyLogic = false })=>{
     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 legacyMaxTokens = useLegacyLogic ? provider[OPENAI_MAX_TOKENS] : void 0;
     const legacyModelFamily = useLegacyLogic ? legacyConfigToModelFamily(provider) : void 0;
     const modelFamilyRaw = provider[keys.modelFamily] || legacyModelFamily;
     const openaiApiKey = provider[keys.openaiApiKey] || legacyAPIKey;
@@ -76,6 +77,13 @@ const parseOpenaiSdkConfig = ({ keys, provider, useLegacyLogic = false })=>{
     const openaiExtraConfig = parseJson(keys.openaiExtraConfig, openaiExtraConfigStr || legacyOpenaiExtraConfig);
     const extraBodyStr = provider[keys.extraBody];
     const extraBody = parseJson(keys.extraBody, extraBodyStr);
+    const maxTokensStr = provider[keys.maxTokens] || legacyMaxTokens;
+    const maxTokens = (()=>{
+        const val = maxTokensStr?.trim();
+        if (!val) return;
+        const num = Number(val);
+        return Number.isFinite(num) ? num : void 0;
+    })();
     const temperature = provider[keys.temperature] ? Number(provider[keys.temperature]) : 0;
     const modelFamily = modelFamilyRaw;
     validateModelFamily(modelFamily);
@@ -88,6 +96,7 @@ const parseOpenaiSdkConfig = ({ keys, provider, useLegacyLogic = false })=>{
         openaiApiKey,
         openaiExtraConfig: normalizeOpenaiExtraConfig(openaiExtraConfig),
         extraBody,
+        maxTokens,
         modelFamily,
         uiTarsModelVersion,
         modelName: modelName,

package/dist/es/env/types.mjs

@@ -57,6 +57,7 @@ const MIDSCENE_INSIGHT_MODEL_BASE_URL = 'MIDSCENE_INSIGHT_MODEL_BASE_URL';
 const MIDSCENE_INSIGHT_MODEL_API_KEY = 'MIDSCENE_INSIGHT_MODEL_API_KEY';
 const MIDSCENE_INSIGHT_MODEL_INIT_CONFIG_JSON = 'MIDSCENE_INSIGHT_MODEL_INIT_CONFIG_JSON';
 const MIDSCENE_INSIGHT_MODEL_EXTRA_BODY_JSON = 'MIDSCENE_INSIGHT_MODEL_EXTRA_BODY_JSON';
+const MIDSCENE_INSIGHT_MODEL_MAX_TOKENS = 'MIDSCENE_INSIGHT_MODEL_MAX_TOKENS';
 const MIDSCENE_INSIGHT_MODEL_TIMEOUT = 'MIDSCENE_INSIGHT_MODEL_TIMEOUT';
 const MIDSCENE_INSIGHT_MODEL_TEMPERATURE = 'MIDSCENE_INSIGHT_MODEL_TEMPERATURE';
 const MIDSCENE_INSIGHT_MODEL_RETRY_COUNT = 'MIDSCENE_INSIGHT_MODEL_RETRY_COUNT';
@@ -72,6 +73,7 @@ const MIDSCENE_PLANNING_MODEL_BASE_URL = 'MIDSCENE_PLANNING_MODEL_BASE_URL';
 const MIDSCENE_PLANNING_MODEL_API_KEY = 'MIDSCENE_PLANNING_MODEL_API_KEY';
 const MIDSCENE_PLANNING_MODEL_INIT_CONFIG_JSON = 'MIDSCENE_PLANNING_MODEL_INIT_CONFIG_JSON';
 const MIDSCENE_PLANNING_MODEL_EXTRA_BODY_JSON = 'MIDSCENE_PLANNING_MODEL_EXTRA_BODY_JSON';
+const MIDSCENE_PLANNING_MODEL_MAX_TOKENS = 'MIDSCENE_PLANNING_MODEL_MAX_TOKENS';
 const MIDSCENE_PLANNING_MODEL_TIMEOUT = 'MIDSCENE_PLANNING_MODEL_TIMEOUT';
 const MIDSCENE_PLANNING_MODEL_TEMPERATURE = 'MIDSCENE_PLANNING_MODEL_TEMPERATURE';
 const MIDSCENE_PLANNING_MODEL_RETRY_COUNT = 'MIDSCENE_PLANNING_MODEL_RETRY_COUNT';
@@ -99,13 +101,10 @@ const BOOLEAN_ENV_KEYS = [
     MIDSCENE_REPORT_QUIET
 ];
 const NUMBER_ENV_KEYS = [
-    MIDSCENE_MODEL_MAX_TOKENS,
     MIDSCENE_CACHE_MAX_FILENAME_LENGTH,
     MIDSCENE_REPLANNING_CYCLE_LIMIT
 ];
 const STRING_ENV_KEYS = [
-    MIDSCENE_MODEL_MAX_TOKENS,
-    OPENAI_MAX_TOKENS,
     MIDSCENE_ADB_PATH,
     MIDSCENE_ADB_REMOTE_HOST,
     MIDSCENE_ADB_REMOTE_PORT,
@@ -131,6 +130,7 @@ const MODEL_ENV_KEYS = [
     MIDSCENE_MODEL_BASE_URL,
     MIDSCENE_MODEL_SOCKS_PROXY,
     MIDSCENE_MODEL_HTTP_PROXY,
+    MIDSCENE_MODEL_MAX_TOKENS,
     MIDSCENE_MODEL_TIMEOUT,
     MIDSCENE_MODEL_TEMPERATURE,
     MIDSCENE_MODEL_RETRY_COUNT,
@@ -146,6 +146,7 @@ const MODEL_ENV_KEYS = [
     MIDSCENE_USE_VL_MODEL,
     OPENAI_API_KEY,
     OPENAI_BASE_URL,
+    OPENAI_MAX_TOKENS,
     MIDSCENE_OPENAI_INIT_CONFIG_JSON,
     MIDSCENE_OPENAI_HTTP_PROXY,
     MIDSCENE_OPENAI_SOCKS_PROXY,
@@ -156,6 +157,7 @@ const MODEL_ENV_KEYS = [
     MIDSCENE_INSIGHT_MODEL_API_KEY,
     MIDSCENE_INSIGHT_MODEL_INIT_CONFIG_JSON,
     MIDSCENE_INSIGHT_MODEL_EXTRA_BODY_JSON,
+    MIDSCENE_INSIGHT_MODEL_MAX_TOKENS,
     MIDSCENE_INSIGHT_MODEL_TIMEOUT,
     MIDSCENE_INSIGHT_MODEL_TEMPERATURE,
     MIDSCENE_INSIGHT_MODEL_RETRY_COUNT,
@@ -171,6 +173,7 @@ const MODEL_ENV_KEYS = [
     MIDSCENE_PLANNING_MODEL_API_KEY,
     MIDSCENE_PLANNING_MODEL_INIT_CONFIG_JSON,
     MIDSCENE_PLANNING_MODEL_EXTRA_BODY_JSON,
+    MIDSCENE_PLANNING_MODEL_MAX_TOKENS,
     MIDSCENE_PLANNING_MODEL_TIMEOUT,
     MIDSCENE_PLANNING_MODEL_TEMPERATURE,
     MIDSCENE_PLANNING_MODEL_RETRY_COUNT,
@@ -210,4 +213,4 @@ var types_UITarsModelVersion = /*#__PURE__*/ function(UITarsModelVersion) {
     UITarsModelVersion["DOUBAO_1_5_20B"] = "doubao-1.5-20B";
     return UITarsModelVersion;
 }({});
-export { ALL_ENV_KEYS, BASIC_ENV_KEYS, BOOLEAN_ENV_KEYS, DOCKER_CONTAINER, GLOBAL_ENV_KEYS, MATCH_BY_POSITION, MIDSCENE_ADB_PATH, MIDSCENE_ADB_REMOTE_HOST, MIDSCENE_ADB_REMOTE_PORT, MIDSCENE_ANDROID_IME_STRATEGY, MIDSCENE_CACHE, MIDSCENE_CACHE_MAX_FILENAME_LENGTH, MIDSCENE_DANGEROUSLY_PRINT_ALL_CONFIG, MIDSCENE_DEBUG_MODE, MIDSCENE_DEBUG_MODEL_PROFILE, MIDSCENE_DEBUG_MODEL_RESPONSE, MIDSCENE_INSIGHT_MODEL_API_KEY, MIDSCENE_INSIGHT_MODEL_BASE_URL, MIDSCENE_INSIGHT_MODEL_EXTRA_BODY_JSON, MIDSCENE_INSIGHT_MODEL_FAMILY, MIDSCENE_INSIGHT_MODEL_HTTP_PROXY, MIDSCENE_INSIGHT_MODEL_INIT_CONFIG_JSON, MIDSCENE_INSIGHT_MODEL_NAME, MIDSCENE_INSIGHT_MODEL_REASONING_BUDGET, MIDSCENE_INSIGHT_MODEL_REASONING_EFFORT, MIDSCENE_INSIGHT_MODEL_REASONING_ENABLED, MIDSCENE_INSIGHT_MODEL_RETRY_COUNT, MIDSCENE_INSIGHT_MODEL_RETRY_INTERVAL, MIDSCENE_INSIGHT_MODEL_SOCKS_PROXY, MIDSCENE_INSIGHT_MODEL_TEMPERATURE, MIDSCENE_INSIGHT_MODEL_TIMEOUT, MIDSCENE_IOS_DEVICE_CLASS_OVERRIDE, MIDSCENE_IOS_DEVICE_UDID, MIDSCENE_IOS_SIMULATOR_UDID, MIDSCENE_LANGFUSE_DEBUG, MIDSCENE_LANGSMITH_DEBUG, MIDSCENE_MCP_ANDROID_MODE, MIDSCENE_MCP_CHROME_PATH, MIDSCENE_MCP_USE_PUPPETEER_MODE, MIDSCENE_MODEL_API_KEY, MIDSCENE_MODEL_BASE_URL, MIDSCENE_MODEL_EXTRA_BODY_JSON, MIDSCENE_MODEL_FAMILY, MIDSCENE_MODEL_HTTP_PROXY, MIDSCENE_MODEL_INIT_CONFIG_JSON, MIDSCENE_MODEL_MAX_TOKENS, MIDSCENE_MODEL_NAME, MIDSCENE_MODEL_REASONING_BUDGET, MIDSCENE_MODEL_REASONING_EFFORT, MIDSCENE_MODEL_REASONING_ENABLED, MIDSCENE_MODEL_RETRY_COUNT, MIDSCENE_MODEL_RETRY_INTERVAL, MIDSCENE_MODEL_SOCKS_PROXY, MIDSCENE_MODEL_TEMPERATURE, MIDSCENE_MODEL_TIMEOUT, MIDSCENE_OPENAI_HTTP_PROXY, MIDSCENE_OPENAI_INIT_CONFIG_JSON, MIDSCENE_OPENAI_SOCKS_PROXY, MIDSCENE_PLANNING_MODEL_API_KEY, MIDSCENE_PLANNING_MODEL_BASE_URL, MIDSCENE_PLANNING_MODEL_EXTRA_BODY_JSON, MIDSCENE_PLANNING_MODEL_FAMILY, MIDSCENE_PLANNING_MODEL_HTTP_PROXY, MIDSCENE_PLANNING_MODEL_INIT_CONFIG_JSON, MIDSCENE_PLANNING_MODEL_NAME, MIDSCENE_PLANNING_MODEL_REASONING_BUDGET, MIDSCENE_PLANNING_MODEL_REASONING_EFFORT, MIDSCENE_PLANNING_MODEL_REASONING_ENABLED, MIDSCENE_PLANNING_MODEL_RETRY_COUNT, MIDSCENE_PLANNING_MODEL_RETRY_INTERVAL, MIDSCENE_PLANNING_MODEL_SOCKS_PROXY, MIDSCENE_PLANNING_MODEL_TEMPERATURE, MIDSCENE_PLANNING_MODEL_TIMEOUT, MIDSCENE_PREFERRED_LANGUAGE, MIDSCENE_REPLANNING_CYCLE_LIMIT, MIDSCENE_REPORT_QUIET, MIDSCENE_REPORT_TAG_NAME, MIDSCENE_RUN_DIR, MIDSCENE_USE_DOUBAO_VISION, MIDSCENE_USE_GEMINI, MIDSCENE_USE_QWEN3_VL, MIDSCENE_USE_QWEN_VL, MIDSCENE_USE_VLM_UI_TARS, MIDSCENE_USE_VL_MODEL, MODEL_ENV_KEYS, MODEL_FAMILY_VALUES, NUMBER_ENV_KEYS, OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_MAX_TOKENS, STRING_ENV_KEYS, types_UITarsModelVersion as UITarsModelVersion, UNUSED_ENV_KEYS };
+export { ALL_ENV_KEYS, BASIC_ENV_KEYS, BOOLEAN_ENV_KEYS, DOCKER_CONTAINER, GLOBAL_ENV_KEYS, MATCH_BY_POSITION, MIDSCENE_ADB_PATH, MIDSCENE_ADB_REMOTE_HOST, MIDSCENE_ADB_REMOTE_PORT, MIDSCENE_ANDROID_IME_STRATEGY, MIDSCENE_CACHE, MIDSCENE_CACHE_MAX_FILENAME_LENGTH, MIDSCENE_DANGEROUSLY_PRINT_ALL_CONFIG, MIDSCENE_DEBUG_MODE, MIDSCENE_DEBUG_MODEL_PROFILE, MIDSCENE_DEBUG_MODEL_RESPONSE, MIDSCENE_INSIGHT_MODEL_API_KEY, MIDSCENE_INSIGHT_MODEL_BASE_URL, MIDSCENE_INSIGHT_MODEL_EXTRA_BODY_JSON, MIDSCENE_INSIGHT_MODEL_FAMILY, MIDSCENE_INSIGHT_MODEL_HTTP_PROXY, MIDSCENE_INSIGHT_MODEL_INIT_CONFIG_JSON, MIDSCENE_INSIGHT_MODEL_MAX_TOKENS, MIDSCENE_INSIGHT_MODEL_NAME, MIDSCENE_INSIGHT_MODEL_REASONING_BUDGET, MIDSCENE_INSIGHT_MODEL_REASONING_EFFORT, MIDSCENE_INSIGHT_MODEL_REASONING_ENABLED, MIDSCENE_INSIGHT_MODEL_RETRY_COUNT, MIDSCENE_INSIGHT_MODEL_RETRY_INTERVAL, MIDSCENE_INSIGHT_MODEL_SOCKS_PROXY, MIDSCENE_INSIGHT_MODEL_TEMPERATURE, MIDSCENE_INSIGHT_MODEL_TIMEOUT, MIDSCENE_IOS_DEVICE_CLASS_OVERRIDE, MIDSCENE_IOS_DEVICE_UDID, MIDSCENE_IOS_SIMULATOR_UDID, MIDSCENE_LANGFUSE_DEBUG, MIDSCENE_LANGSMITH_DEBUG, MIDSCENE_MCP_ANDROID_MODE, MIDSCENE_MCP_CHROME_PATH, MIDSCENE_MCP_USE_PUPPETEER_MODE, MIDSCENE_MODEL_API_KEY, MIDSCENE_MODEL_BASE_URL, MIDSCENE_MODEL_EXTRA_BODY_JSON, MIDSCENE_MODEL_FAMILY, MIDSCENE_MODEL_HTTP_PROXY, MIDSCENE_MODEL_INIT_CONFIG_JSON, MIDSCENE_MODEL_MAX_TOKENS, MIDSCENE_MODEL_NAME, MIDSCENE_MODEL_REASONING_BUDGET, MIDSCENE_MODEL_REASONING_EFFORT, MIDSCENE_MODEL_REASONING_ENABLED, MIDSCENE_MODEL_RETRY_COUNT, MIDSCENE_MODEL_RETRY_INTERVAL, MIDSCENE_MODEL_SOCKS_PROXY, MIDSCENE_MODEL_TEMPERATURE, MIDSCENE_MODEL_TIMEOUT, MIDSCENE_OPENAI_HTTP_PROXY, MIDSCENE_OPENAI_INIT_CONFIG_JSON, MIDSCENE_OPENAI_SOCKS_PROXY, MIDSCENE_PLANNING_MODEL_API_KEY, MIDSCENE_PLANNING_MODEL_BASE_URL, MIDSCENE_PLANNING_MODEL_EXTRA_BODY_JSON, MIDSCENE_PLANNING_MODEL_FAMILY, MIDSCENE_PLANNING_MODEL_HTTP_PROXY, MIDSCENE_PLANNING_MODEL_INIT_CONFIG_JSON, MIDSCENE_PLANNING_MODEL_MAX_TOKENS, MIDSCENE_PLANNING_MODEL_NAME, MIDSCENE_PLANNING_MODEL_REASONING_BUDGET, MIDSCENE_PLANNING_MODEL_REASONING_EFFORT, MIDSCENE_PLANNING_MODEL_REASONING_ENABLED, MIDSCENE_PLANNING_MODEL_RETRY_COUNT, MIDSCENE_PLANNING_MODEL_RETRY_INTERVAL, MIDSCENE_PLANNING_MODEL_SOCKS_PROXY, MIDSCENE_PLANNING_MODEL_TEMPERATURE, MIDSCENE_PLANNING_MODEL_TIMEOUT, MIDSCENE_PREFERRED_LANGUAGE, MIDSCENE_REPLANNING_CYCLE_LIMIT, MIDSCENE_REPORT_QUIET, MIDSCENE_REPORT_TAG_NAME, MIDSCENE_RUN_DIR, MIDSCENE_USE_DOUBAO_VISION, MIDSCENE_USE_GEMINI, MIDSCENE_USE_QWEN3_VL, MIDSCENE_USE_QWEN_VL, MIDSCENE_USE_VLM_UI_TARS, MIDSCENE_USE_VL_MODEL, MODEL_ENV_KEYS, MODEL_FAMILY_VALUES, NUMBER_ENV_KEYS, OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_MAX_TOKENS, STRING_ENV_KEYS, types_UITarsModelVersion as UITarsModelVersion, UNUSED_ENV_KEYS };

package/dist/es/mcp/tool-generator.mjs

@@ -2,6 +2,7 @@ import { parseBase64 } from "@midscene/shared/img";
 import { z } from "zod";
 import { getZodDescription, getZodTypeName, isMidsceneLocatorField, unwrapZodField } from "../zod-schema-utils.mjs";
 import { getErrorMessage } from "./error-formatter.mjs";
+import { composeUserPrompt, promptInputExtraSchema } from "./user-prompt.mjs";
 function describeActionForMCP(action) {
     const actionDesc = action.description || `Execute ${action.name} action`;
     if (!action.paramSchema) return `${action.name} action, ${actionDesc}`;
@@ -336,6 +337,9 @@ function generateCommonTools(getAgent, initArgSchema = {}, initArgCliMetadata) {
                     const agent = await getAgent(args);
                     const screenshot = await agent.page?.screenshotBase64();
                     if (!screenshot) return createErrorResult('Screenshot not available');
+                    await agent.recordToReport?.('take_screenshot', {
+                        screenshotBase64: screenshot
+                    });
                     const { mimeType, body } = parseBase64(screenshot);
                     return {
                         content: [
@@ -369,15 +373,7 @@ function generateCommonTools(getAgent, initArgSchema = {}, initArgCliMetadata) {
                     const result = await agent.aiAction(prompt, {
                         deepThink: false
                     });
-                    const screenshotResult = await captureScreenshotResult(agent, 'act');
-                    if (result) {
-                        const message = 'string' == typeof result ? result : JSON.stringify(result);
-                        screenshotResult.content.unshift({
-                            type: 'text',
-                            text: `Task finished, message: ${message}`
-                        });
-                    }
-                    return screenshotResult;
+                    return await captureScreenshotResult(agent, 'act', result);
                 } catch (error) {
                     const errorMessage = getErrorMessage(error);
                     console.error('Error executing act:', errorMessage);
@@ -390,6 +386,7 @@ function generateCommonTools(getAgent, initArgSchema = {}, initArgCliMetadata) {
             description: 'Assert a natural language statement against the current page/screen.',
             schema: {
                 prompt: z.string().describe('Natural language assertion to verify, e.g. "there is a login button visible"'),
+                ...promptInputExtraSchema,
                 ...initArgSchema
             },
             cli: mergeToolCliMetadata(void 0, initArgCliMetadata),
@@ -398,7 +395,13 @@ function generateCommonTools(getAgent, initArgSchema = {}, initArgCliMetadata) {
                 try {
                     const agent = await getAgent(args);
                     if (!agent.aiAssert) return createErrorResult('assert is not supported by this agent');
-                    await agent.aiAssert(prompt);
+                    const userPrompt = composeUserPrompt({
+                        prompt,
+                        image: args.image,
+                        imageName: args.imageName,
+                        convertHttpImage2Base64: args.convertHttpImage2Base64
+                    });
+                    await agent.aiAssert(userPrompt);
                     return {
                         content: [
                             {
@@ -416,4 +419,4 @@ function generateCommonTools(getAgent, initArgSchema = {}, initArgCliMetadata) {
         }
     ];
 }
-export { generateCommonTools, generateToolsFromActionSpace };
+export { composeUserPrompt, generateCommonTools, generateToolsFromActionSpace };

package/dist/es/mcp/user-prompt.mjs

@@ -0,0 +1,66 @@
+import { z } from "zod";
+function normalizeStringList(raw, fieldName) {
+    if (null == raw) return [];
+    if ('string' == typeof raw) {
+        const trimmed = raw.trim();
+        return trimmed ? [
+            trimmed
+        ] : [];
+    }
+    if (Array.isArray(raw)) return raw.map((item, index)=>{
+        if ('string' != typeof item) throw new Error(`${fieldName}[${index}]: expected a string.`);
+        return item.trim();
+    });
+    throw new Error(`${fieldName}: expected a string or string array, got ${typeof raw}.`);
+}
+function composeImages(input) {
+    const urls = normalizeStringList(input.image, 'image');
+    const names = normalizeStringList(input.imageName, 'imageName');
+    if (urls.length !== names.length) throw new Error(`image/imageName: expected the same number of --image and --image-name values, got ${urls.length} image(s) and ${names.length} image name(s).`);
+    return urls.map((url, index)=>({
+            name: names[index],
+            url
+        }));
+}
+function coerceBoolean(value) {
+    if (null == value) return;
+    if ('boolean' == typeof value) return value;
+    if ('string' == typeof value) {
+        const trimmed = value.trim();
+        if (!trimmed) return;
+        const v = trimmed.toLowerCase();
+        if ('true' === v || '1' === v) return true;
+        if ('false' === v || '0' === v) return false;
+        throw new Error(`convertHttpImage2Base64: expected "true", "false", "1", or "0"; got ${JSON.stringify(value)}.`);
+    }
+    throw new Error(`convertHttpImage2Base64: expected a boolean, got ${typeof value}.`);
+}
+function composeUserPrompt(input) {
+    const images = composeImages({
+        image: input.image,
+        imageName: input.imageName
+    });
+    const convertFlag = coerceBoolean(input.convertHttpImage2Base64);
+    if (0 === images.length && void 0 === convertFlag) return input.prompt;
+    const payload = {
+        prompt: input.prompt
+    };
+    if (images.length > 0) payload.images = images;
+    if (void 0 !== convertFlag) payload.convertHttpImage2Base64 = convertFlag;
+    return payload;
+}
+const promptInputExtraSchema = {
+    image: z.union([
+        z.string(),
+        z.array(z.string())
+    ]).optional().describe('Reference image URL/path. Repeat --image for multiple images.'),
+    imageName: z.union([
+        z.string(),
+        z.array(z.string())
+    ]).optional().describe('Reference image name. Repeat --image-name; must align with --image order.'),
+    convertHttpImage2Base64: z.union([
+        z.boolean(),
+        z.string()
+    ]).optional().describe('If true, convert http(s) image URLs to base64 before sending to the model.')
+};
+export { composeUserPrompt, promptInputExtraSchema };

package/dist/lib/cli/cli-args.js

@@ -24,13 +24,15 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
+    canonicalizeCliArgKeys: ()=>canonicalizeCliArgKeys,
     parseCliArgs: ()=>parseCliArgs,
-    parseValue: ()=>parseValue,
     formatCliValidationError: ()=>formatCliValidationError,
+    parseValue: ()=>parseValue,
     getCliOptionDisplay: ()=>getCliOptionDisplay
 });
 const external_zod_namespaceObject = require("zod");
 const external_key_alias_utils_js_namespaceObject = require("../key-alias-utils.js");
+const external_cli_error_js_namespaceObject = require("./cli-error.js");
 function parseValue(raw) {
     if (raw.startsWith('{') || raw.startsWith('[')) try {
         return JSON.parse(raw);
@@ -54,7 +56,20 @@ function walkCliArgs(args, setArgValue) {
 function parseCliArgs(args) {
     const result = {};
     walkCliArgs(args, (key, value)=>{
-        result[key] = value;
+        const existing = result[key];
+        if (void 0 === existing) {
+            result[key] = value;
+            return;
+        }
+        if (Array.isArray(existing)) {
+            existing.push(value);
+            result[key] = existing;
+            return;
+        }
+        result[key] = [
+            existing,
+            value
+        ];
     });
     return result;
 }
@@ -123,11 +138,38 @@ function formatCliValidationError(scriptName, commandName, def, rawArgs) {
     const optionName = 'string' == typeof issue?.path[0] ? `--${issue.path[0]}` : 'CLI arguments';
     return `Invalid value for "${optionName}" in ${scriptName} ${commandName}: ${issue?.message ?? parsed.error.message}`;
 }
+function canonicalizeCliArgKeys(scriptName, commandName, def, rawArgs) {
+    if (0 === Object.keys(def.schema).length) return rawArgs;
+    const result = {
+        ...rawArgs
+    };
+    for (const schemaKey of Object.keys(def.schema)){
+        const cliOption = def.cli?.options?.[schemaKey];
+        const acceptedSpellings = getAcceptedCliOptionNames(schemaKey, cliOption);
+        let chosenSpelling;
+        let chosenValue;
+        for (const spelling of acceptedSpellings)if (spelling !== schemaKey) {
+            if (spelling in result) {
+                if (void 0 !== chosenSpelling) throw new external_cli_error_js_namespaceObject.CLIError(`Conflicting CLI options "--${chosenSpelling}" and "--${spelling}" for ${scriptName} ${commandName}: both target "${schemaKey}". Use one spelling.`);
+                chosenSpelling = spelling;
+                chosenValue = result[spelling];
+            }
+        }
+        if (void 0 !== chosenSpelling) {
+            if (schemaKey in result && result[schemaKey] !== chosenValue) throw new external_cli_error_js_namespaceObject.CLIError(`Conflicting CLI options "--${schemaKey}" and "--${chosenSpelling}" for ${scriptName} ${commandName}: both target "${schemaKey}". Use one spelling.`);
+            result[schemaKey] = chosenValue;
+            delete result[chosenSpelling];
+        }
+    }
+    return result;
+}
+exports.canonicalizeCliArgKeys = __webpack_exports__.canonicalizeCliArgKeys;
 exports.formatCliValidationError = __webpack_exports__.formatCliValidationError;
 exports.getCliOptionDisplay = __webpack_exports__.getCliOptionDisplay;
 exports.parseCliArgs = __webpack_exports__.parseCliArgs;
 exports.parseValue = __webpack_exports__.parseValue;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "canonicalizeCliArgKeys",
     "formatCliValidationError",
     "getCliOptionDisplay",
     "parseCliArgs",

package/dist/lib/cli/cli-runner.js

@@ -155,8 +155,9 @@ async function runToolsCLI(tools, scriptName, options) {
     }
     const cliValidationError = (0, external_cli_args_js_namespaceObject.formatCliValidationError)(scriptName, match.name, match.def, parsedArgs);
     if (cliValidationError) throw new external_cli_error_js_namespaceObject.CLIError(cliValidationError);
-    debug('command: %s, args: %s', match.name, JSON.stringify(parsedArgs));
-    const result = await match.def.handler(parsedArgs);
+    const handlerArgs = (0, external_cli_args_js_namespaceObject.canonicalizeCliArgKeys)(scriptName, match.name, match.def, parsedArgs);
+    debug('command: %s, args: %s', match.name, JSON.stringify(handlerArgs));
+    const result = await match.def.handler(handlerArgs);
     debug('command %s completed, isError: %s', match.name, result.isError ?? false);
     outputResult(result);
     await tools.destroy();

package/dist/lib/constants/example-code.js

@@ -34,7 +34,7 @@ const PLAYWRIGHT_EXAMPLE_CODE = `
 IMPORTANT: Follow these exact type signatures for AI functions:
 
 // Type signatures for AI functions:
-aiAct(prompt: string, options?: { cacheable?: boolean, deepThink?: 'unset' | true | false }): Promise<void>
+aiAct(prompt: string, options?: { cacheable?: boolean, deepThink?: 'unset' | true | false }): Promise<string | undefined>
 aiInput(text: string, locate: string, options?: { deepLocate?: boolean, xpath?: string, cacheable?: boolean }): Promise<void>
 aiTap(locate: string, options?: { deepLocate?: boolean, xpath?: string, cacheable?: boolean }): Promise<void>
 aiHover(locate: string, options?: { deepLocate?: boolean, xpath?: string, cacheable?: boolean }): Promise<void>

package/dist/lib/env/constants.js

@@ -38,6 +38,7 @@ const INSIGHT_MODEL_CONFIG_KEYS = {
     openaiApiKey: external_types_js_namespaceObject.MIDSCENE_INSIGHT_MODEL_API_KEY,
     openaiExtraConfig: external_types_js_namespaceObject.MIDSCENE_INSIGHT_MODEL_INIT_CONFIG_JSON,
     extraBody: external_types_js_namespaceObject.MIDSCENE_INSIGHT_MODEL_EXTRA_BODY_JSON,
+    maxTokens: external_types_js_namespaceObject.MIDSCENE_INSIGHT_MODEL_MAX_TOKENS,
     modelFamily: external_types_js_namespaceObject.MIDSCENE_INSIGHT_MODEL_FAMILY,
     timeout: external_types_js_namespaceObject.MIDSCENE_INSIGHT_MODEL_TIMEOUT,
     temperature: external_types_js_namespaceObject.MIDSCENE_INSIGHT_MODEL_TEMPERATURE,
@@ -55,6 +56,7 @@ const PLANNING_MODEL_CONFIG_KEYS = {
     openaiApiKey: external_types_js_namespaceObject.MIDSCENE_PLANNING_MODEL_API_KEY,
     openaiExtraConfig: external_types_js_namespaceObject.MIDSCENE_PLANNING_MODEL_INIT_CONFIG_JSON,
     extraBody: external_types_js_namespaceObject.MIDSCENE_PLANNING_MODEL_EXTRA_BODY_JSON,
+    maxTokens: external_types_js_namespaceObject.MIDSCENE_PLANNING_MODEL_MAX_TOKENS,
     modelFamily: external_types_js_namespaceObject.MIDSCENE_PLANNING_MODEL_FAMILY,
     timeout: external_types_js_namespaceObject.MIDSCENE_PLANNING_MODEL_TIMEOUT,
     temperature: external_types_js_namespaceObject.MIDSCENE_PLANNING_MODEL_TEMPERATURE,
@@ -72,6 +74,7 @@ const DEFAULT_MODEL_CONFIG_KEYS = {
     openaiApiKey: external_types_js_namespaceObject.MIDSCENE_MODEL_API_KEY,
     openaiExtraConfig: external_types_js_namespaceObject.MIDSCENE_MODEL_INIT_CONFIG_JSON,
     extraBody: external_types_js_namespaceObject.MIDSCENE_MODEL_EXTRA_BODY_JSON,
+    maxTokens: external_types_js_namespaceObject.MIDSCENE_MODEL_MAX_TOKENS,
     modelFamily: external_types_js_namespaceObject.MIDSCENE_MODEL_FAMILY,
     timeout: external_types_js_namespaceObject.MIDSCENE_MODEL_TIMEOUT,
     temperature: external_types_js_namespaceObject.MIDSCENE_MODEL_TEMPERATURE,
@@ -89,6 +92,7 @@ const DEFAULT_MODEL_CONFIG_KEYS_LEGACY = {
     openaiApiKey: external_types_js_namespaceObject.OPENAI_API_KEY,
     openaiExtraConfig: external_types_js_namespaceObject.MIDSCENE_OPENAI_INIT_CONFIG_JSON,
     extraBody: external_types_js_namespaceObject.MIDSCENE_MODEL_EXTRA_BODY_JSON,
+    maxTokens: external_types_js_namespaceObject.OPENAI_MAX_TOKENS,
     modelFamily: 'DEFAULT_MODEL_CONFIG_KEYS has no modelFamily key',
     timeout: external_types_js_namespaceObject.MIDSCENE_MODEL_TIMEOUT,
     temperature: external_types_js_namespaceObject.MIDSCENE_MODEL_TEMPERATURE,

package/dist/lib/env/parse-model-config.js

@@ -37,7 +37,7 @@ const external_utils_js_namespaceObject = require("../utils.js");
 const external_helper_js_namespaceObject = require("./helper.js");
 const external_init_debug_js_namespaceObject = require("./init-debug.js");
 const MODEL_CONFIG_DOC_URL = 'https://midscenejs.com/model-common-config.html';
-const getCurrentVersion = ()=>"1.8.5-beta-20260525033347.0";
+const getCurrentVersion = ()=>"1.8.5";
 const getInvalidModelFamilyMessage = (modelFamily)=>`Invalid MIDSCENE_MODEL_FAMILY value: ${modelFamily}. Current version v${getCurrentVersion()} accepts the following model families: ${external_types_js_namespaceObject.MODEL_FAMILY_VALUES.join(', ')}. You can also visit ${MODEL_CONFIG_DOC_URL} for the latest configuration information.`;
 const KEYS_MAP = {
     insight: external_constants_js_namespaceObject.INSIGHT_MODEL_CONFIG_KEYS,
@@ -97,6 +97,7 @@ const parseOpenaiSdkConfig = ({ keys, provider, useLegacyLogic = false })=>{
     const legacySocksProxy = useLegacyLogic ? provider[external_types_js_namespaceObject.MIDSCENE_OPENAI_SOCKS_PROXY] : void 0;
     const legacyHttpProxy = useLegacyLogic ? provider[external_types_js_namespaceObject.MIDSCENE_OPENAI_HTTP_PROXY] : void 0;
     const legacyOpenaiExtraConfig = useLegacyLogic ? provider[external_types_js_namespaceObject.MIDSCENE_OPENAI_INIT_CONFIG_JSON] : void 0;
+    const legacyMaxTokens = useLegacyLogic ? provider[external_types_js_namespaceObject.OPENAI_MAX_TOKENS] : void 0;
     const legacyModelFamily = useLegacyLogic ? legacyConfigToModelFamily(provider) : void 0;
     const modelFamilyRaw = provider[keys.modelFamily] || legacyModelFamily;
     const openaiApiKey = provider[keys.openaiApiKey] || legacyAPIKey;
@@ -108,6 +109,13 @@ const parseOpenaiSdkConfig = ({ keys, provider, useLegacyLogic = false })=>{
     const openaiExtraConfig = (0, external_helper_js_namespaceObject.parseJson)(keys.openaiExtraConfig, openaiExtraConfigStr || legacyOpenaiExtraConfig);
     const extraBodyStr = provider[keys.extraBody];
     const extraBody = (0, external_helper_js_namespaceObject.parseJson)(keys.extraBody, extraBodyStr);
+    const maxTokensStr = provider[keys.maxTokens] || legacyMaxTokens;
+    const maxTokens = (()=>{
+        const val = maxTokensStr?.trim();
+        if (!val) return;
+        const num = Number(val);
+        return Number.isFinite(num) ? num : void 0;
+    })();
     const temperature = provider[keys.temperature] ? Number(provider[keys.temperature]) : 0;
     const modelFamily = modelFamilyRaw;
     validateModelFamily(modelFamily);
@@ -120,6 +128,7 @@ const parseOpenaiSdkConfig = ({ keys, provider, useLegacyLogic = false })=>{
         openaiApiKey,
         openaiExtraConfig: normalizeOpenaiExtraConfig(openaiExtraConfig),
         extraBody,
+        maxTokens,
         modelFamily,
         uiTarsModelVersion,
         modelName: modelName,