@midscene/shared 1.9.8-beta-20260618091332.0 → 1.10.0

package/dist/es/{mcp → agent-tools}/base-tools.mjs

@@ -15,7 +15,7 @@ function _define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
-const debug = getDebug('mcp:base-tools');
+const debug = getDebug('agent-tools:base-tools');
 class BaseMidsceneTools {
     getInitArgKeys() {
         return this.initArgSpec ? Object.keys(this.initArgSpec.shape) : [];
@@ -104,12 +104,6 @@ class BaseMidsceneTools {
         this.toolDefinitions.push(...actionTools, ...commonTools);
         debug('Total tools prepared:', this.toolDefinitions.length);
     }
-    attachToServer(server) {
-        this.mcpServer = server;
-        if (0 === this.toolDefinitions.length) debug('Warning: No tools to register. Tools may be initialized lazily.');
-        for (const toolDef of this.toolDefinitions)this.mcpServer.tool(toolDef.name, toolDef.description, toolDef.schema, toolDef.handler);
-        debug('Registered', this.toolDefinitions.length, 'tools');
-    }
     async destroy() {
         await this.agent?.destroy?.();
     }
@@ -155,7 +149,6 @@ class BaseMidsceneTools {
         };
     }
     constructor(){
-        _define_property(this, "mcpServer", void 0);
         _define_property(this, "agent", void 0);
         _define_property(this, "toolDefinitions", []);
         _define_property(this, "toolDefaults", {});

package/dist/es/{mcp → agent-tools}/chrome-path.mjs

@@ -1,5 +1,10 @@
 import { existsSync } from "node:fs";
-import { MIDSCENE_MCP_CHROME_PATH, globalConfigManager } from "../env/index.mjs";
+import { MIDSCENE_CHROME_PATH, MIDSCENE_MCP_CHROME_PATH, globalConfigManager } from "../env/index.mjs";
+import { getDebug } from "../logger.mjs";
+const warnChromePath = getDebug('agent-tools:chrome-path', {
+    console: true
+});
+let hasWarnedLegacyChromePath = false;
 function getSystemChromePath() {
     const platform = process.platform;
     const chromePaths = {
@@ -26,10 +31,16 @@ function getSystemChromePath() {
     return paths.find((p)=>existsSync(p));
 }
 function resolveChromePath() {
-    const envPath = globalConfigManager.getEnvConfigValue(MIDSCENE_MCP_CHROME_PATH);
+    const primaryEnvPath = globalConfigManager.getEnvConfigValue(MIDSCENE_CHROME_PATH);
+    const legacyEnvPath = globalConfigManager.getEnvConfigValue(MIDSCENE_MCP_CHROME_PATH);
+    const envPath = primaryEnvPath || legacyEnvPath;
+    if (!primaryEnvPath && legacyEnvPath && !hasWarnedLegacyChromePath) {
+        warnChromePath('MIDSCENE_MCP_CHROME_PATH is deprecated. Use MIDSCENE_CHROME_PATH instead.');
+        hasWarnedLegacyChromePath = true;
+    }
     if (envPath && 'auto' !== envPath && existsSync(envPath)) return envPath;
     const systemPath = getSystemChromePath();
     if (systemPath) return systemPath;
-    throw new Error('Chrome not found. Install Google Chrome or set MIDSCENE_MCP_CHROME_PATH environment variable.');
+    throw new Error('Chrome not found. Install Google Chrome or set MIDSCENE_CHROME_PATH environment variable.');
 }
 export { getSystemChromePath, resolveChromePath };

package/dist/es/{mcp → agent-tools}/index.mjs

@@ -1,4 +1,3 @@
-export * from "./base-server.mjs";
 export * from "./base-tools.mjs";
 export * from "./tool-defaults.mjs";
 export * from "./agent-behavior-init-args.mjs";
@@ -6,6 +5,4 @@ export * from "./init-arg-utils.mjs";
 export * from "./error-formatter.mjs";
 export * from "./tool-generator.mjs";
 export * from "./types.mjs";
-export * from "./inject-report-html-plugin.mjs";
-export * from "./launcher-helper.mjs";
 export * from "./chrome-path.mjs";

package/dist/es/{mcp → agent-tools}/tool-generator.mjs

@@ -3,7 +3,7 @@ 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) {
+function describeActionForTool(action) {
     const actionDesc = action.description || `Execute ${action.name} action`;
     if (!action.paramSchema) return `${action.name} action, ${actionDesc}`;
     const shape = getZodObjectShape(action.paramSchema);
@@ -75,7 +75,7 @@ function extractActionSchema(paramSchema, actionName) {
     const shape = getZodObjectShape(paramSchema);
     if (!shape) {
         const typeName = paramSchema?._def?.typeName ?? 'unknown';
-        throw new Error(`Action "${actionName}" declared a non-object paramSchema (${typeName}). CLI and MCP tool schemas must be a ZodObject (e.g. z.object({ uri: z.string() })) or undefined. Wrap primitive fields in an object schema.`);
+        throw new Error(`Action "${actionName}" declared a non-object paramSchema (${typeName}). CLI tool schemas must be a ZodObject (e.g. z.object({ uri: z.string() })) or undefined. Wrap primitive fields in an object schema.`);
     }
     return Object.fromEntries(Object.entries(shape).map(([key, value])=>transformSchemaField(key, value)));
 }
@@ -327,7 +327,7 @@ function generateToolsFromActionSpace(actionSpace, getAgent, sanitizeArgs = (arg
         };
         return {
             name: action.name,
-            description: describeActionForMCP(action),
+            description: describeActionForTool(action),
             schema,
             cli: initArgCliMetadata,
             handler: async (args)=>{

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

@@ -2,8 +2,8 @@ import { existsSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import dotenv from "dotenv";
+import { stripBehaviorFlags } from "../agent-tools/tool-defaults.mjs";
 import { getDebug } from "../logger.mjs";
-import { stripBehaviorFlags } from "../mcp/tool-defaults.mjs";
 import { canonicalizeCliArgKeys, formatCliValidationError, getCliOptionDisplay, parseCliArgs, parseValue } from "./cli-args.mjs";
 import { CLIError, reportCLIError } from "./cli-error.mjs";
 const debug = getDebug('cli-runner');

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

@@ -5,7 +5,7 @@ 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.9.8-beta-20260618091332.0";
+const getCurrentVersion = ()=>"1.10.0";
 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,

package/dist/es/env/types.mjs

@@ -5,9 +5,8 @@ const MIDSCENE_DEBUG_MODEL_PROFILE = 'MIDSCENE_DEBUG_MODEL_PROFILE';
 const MIDSCENE_DEBUG_MODEL_RESPONSE = 'MIDSCENE_DEBUG_MODEL_RESPONSE';
 const MIDSCENE_DANGEROUSLY_PRINT_ALL_CONFIG = 'MIDSCENE_DANGEROUSLY_PRINT_ALL_CONFIG';
 const MIDSCENE_DEBUG_MODE = 'MIDSCENE_DEBUG_MODE';
-const MIDSCENE_MCP_USE_PUPPETEER_MODE = 'MIDSCENE_MCP_USE_PUPPETEER_MODE';
+const MIDSCENE_CHROME_PATH = 'MIDSCENE_CHROME_PATH';
 const MIDSCENE_MCP_CHROME_PATH = 'MIDSCENE_MCP_CHROME_PATH';
-const MIDSCENE_MCP_ANDROID_MODE = 'MIDSCENE_MCP_ANDROID_MODE';
 const DOCKER_CONTAINER = 'DOCKER_CONTAINER';
 const MIDSCENE_LANGSMITH_DEBUG = 'MIDSCENE_LANGSMITH_DEBUG';
 const MIDSCENE_LANGFUSE_DEBUG = 'MIDSCENE_LANGFUSE_DEBUG';
@@ -90,8 +89,6 @@ const BASIC_ENV_KEYS = [
 ];
 const BOOLEAN_ENV_KEYS = [
     MIDSCENE_CACHE,
-    MIDSCENE_MCP_USE_PUPPETEER_MODE,
-    MIDSCENE_MCP_ANDROID_MODE,
     MIDSCENE_LANGSMITH_DEBUG,
     MIDSCENE_LANGFUSE_DEBUG,
     MIDSCENE_REPORT_QUIET
@@ -110,6 +107,7 @@ const STRING_ENV_KEYS = [
     MIDSCENE_REPORT_TAG_NAME,
     MIDSCENE_PREFERRED_LANGUAGE,
     MATCH_BY_POSITION,
+    MIDSCENE_CHROME_PATH,
     MIDSCENE_MCP_CHROME_PATH,
     DOCKER_CONTAINER
 ];
@@ -208,4 +206,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_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, 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_CHROME_PATH, 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_CHROME_PATH, 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, 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, STRING_ENV_KEYS, types_UITarsModelVersion as UITarsModelVersion, UNUSED_ENV_KEYS };

package/dist/es/utils.mjs

@@ -34,12 +34,8 @@ function generateHashId(rect, content = '') {
 function assert(condition, message) {
     if (!condition) throw new Error(message || 'Assertion failed');
 }
-let isMcp = false;
-function setIsMcp(value) {
-    isMcp = value;
-}
 function logMsg(...message) {
-    if (!isMcp) console.log(...message);
+    console.log(...message);
 }
 async function repeat(times, fn) {
     for(let i = 0; i < times; i++)await fn(i);
@@ -69,4 +65,4 @@ function mergeAndNormalizeAppNameMapping(defaultMapping, userMapping) {
     if (userMapping) for (const [key, value] of Object.entries(userMapping))result[normalizeForComparison(key)] = value;
     return result;
 }
-export { antiEscapeScriptTag, assert, escapeScriptTag, generateHashId, ifInBrowser, ifInNode, ifInWorker, isPlainObject, logMsg, mergeAndNormalizeAppNameMapping, normalizeForComparison, repeat, replaceIllegalPathCharsAndSpace, setIsMcp, uuid };
+export { antiEscapeScriptTag, assert, escapeScriptTag, generateHashId, ifInBrowser, ifInNode, ifInWorker, isPlainObject, logMsg, mergeAndNormalizeAppNameMapping, normalizeForComparison, repeat, replaceIllegalPathCharsAndSpace, uuid };

package/dist/lib/{mcp → agent-tools}/base-tools.js

@@ -43,7 +43,7 @@ function _define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
-const debug = (0, logger_namespaceObject.getDebug)('mcp:base-tools');
+const debug = (0, logger_namespaceObject.getDebug)('agent-tools:base-tools');
 class BaseMidsceneTools {
     getInitArgKeys() {
         return this.initArgSpec ? Object.keys(this.initArgSpec.shape) : [];
@@ -132,12 +132,6 @@ class BaseMidsceneTools {
         this.toolDefinitions.push(...actionTools, ...commonTools);
         debug('Total tools prepared:', this.toolDefinitions.length);
     }
-    attachToServer(server) {
-        this.mcpServer = server;
-        if (0 === this.toolDefinitions.length) debug('Warning: No tools to register. Tools may be initialized lazily.');
-        for (const toolDef of this.toolDefinitions)this.mcpServer.tool(toolDef.name, toolDef.description, toolDef.schema, toolDef.handler);
-        debug('Registered', this.toolDefinitions.length, 'tools');
-    }
     async destroy() {
         await this.agent?.destroy?.();
     }
@@ -183,7 +177,6 @@ class BaseMidsceneTools {
         };
     }
     constructor(){
-        _define_property(this, "mcpServer", void 0);
         _define_property(this, "agent", void 0);
         _define_property(this, "toolDefinitions", []);
         _define_property(this, "toolDefaults", {});

package/dist/lib/{mcp → agent-tools}/chrome-path.js

@@ -29,6 +29,11 @@ __webpack_require__.d(__webpack_exports__, {
 });
 const external_node_fs_namespaceObject = require("node:fs");
 const index_js_namespaceObject = require("../env/index.js");
+const external_logger_js_namespaceObject = require("../logger.js");
+const warnChromePath = (0, external_logger_js_namespaceObject.getDebug)('agent-tools:chrome-path', {
+    console: true
+});
+let hasWarnedLegacyChromePath = false;
 function getSystemChromePath() {
     const platform = process.platform;
     const chromePaths = {
@@ -55,11 +60,17 @@ function getSystemChromePath() {
     return paths.find((p)=>(0, external_node_fs_namespaceObject.existsSync)(p));
 }
 function resolveChromePath() {
-    const envPath = index_js_namespaceObject.globalConfigManager.getEnvConfigValue(index_js_namespaceObject.MIDSCENE_MCP_CHROME_PATH);
+    const primaryEnvPath = index_js_namespaceObject.globalConfigManager.getEnvConfigValue(index_js_namespaceObject.MIDSCENE_CHROME_PATH);
+    const legacyEnvPath = index_js_namespaceObject.globalConfigManager.getEnvConfigValue(index_js_namespaceObject.MIDSCENE_MCP_CHROME_PATH);
+    const envPath = primaryEnvPath || legacyEnvPath;
+    if (!primaryEnvPath && legacyEnvPath && !hasWarnedLegacyChromePath) {
+        warnChromePath('MIDSCENE_MCP_CHROME_PATH is deprecated. Use MIDSCENE_CHROME_PATH instead.');
+        hasWarnedLegacyChromePath = true;
+    }
     if (envPath && 'auto' !== envPath && (0, external_node_fs_namespaceObject.existsSync)(envPath)) return envPath;
     const systemPath = getSystemChromePath();
     if (systemPath) return systemPath;
-    throw new Error('Chrome not found. Install Google Chrome or set MIDSCENE_MCP_CHROME_PATH environment variable.');
+    throw new Error('Chrome not found. Install Google Chrome or set MIDSCENE_CHROME_PATH environment variable.');
 }
 exports.getSystemChromePath = __webpack_exports__.getSystemChromePath;
 exports.resolveChromePath = __webpack_exports__.resolveChromePath;

package/dist/lib/{mcp → agent-tools}/index.js

@@ -3,9 +3,6 @@ var __webpack_modules__ = {
     "./agent-behavior-init-args" (module) {
         module.exports = require("./agent-behavior-init-args.js");
     },
-    "./base-server" (module) {
-        module.exports = require("./base-server.js");
-    },
     "./base-tools" (module) {
         module.exports = require("./base-tools.js");
     },
@@ -18,12 +15,6 @@ var __webpack_modules__ = {
     "./init-arg-utils" (module) {
         module.exports = require("./init-arg-utils.js");
     },
-    "./inject-report-html-plugin" (module) {
-        module.exports = require("./inject-report-html-plugin.js");
-    },
-    "./launcher-helper" (module) {
-        module.exports = require("./launcher-helper.js");
-    },
     "./tool-defaults" (module) {
         module.exports = require("./tool-defaults.js");
     },
@@ -77,49 +68,37 @@ function __webpack_require__(moduleId) {
 var __webpack_exports__ = {};
 (()=>{
     __webpack_require__.r(__webpack_exports__);
-    var _base_server__rspack_import_0 = __webpack_require__("./base-server");
-    var __rspack_reexport = {};
-    for(const __rspack_import_key in _base_server__rspack_import_0)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_base_server__rspack_import_0[__rspack_import_key];
-    __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _base_tools__rspack_import_1 = __webpack_require__("./base-tools");
-    var __rspack_reexport = {};
-    for(const __rspack_import_key in _base_tools__rspack_import_1)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_base_tools__rspack_import_1[__rspack_import_key];
-    __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _tool_defaults__rspack_import_2 = __webpack_require__("./tool-defaults");
-    var __rspack_reexport = {};
-    for(const __rspack_import_key in _tool_defaults__rspack_import_2)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_tool_defaults__rspack_import_2[__rspack_import_key];
-    __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _agent_behavior_init_args__rspack_import_3 = __webpack_require__("./agent-behavior-init-args");
+    var _base_tools__rspack_import_0 = __webpack_require__("./base-tools");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _agent_behavior_init_args__rspack_import_3)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_agent_behavior_init_args__rspack_import_3[__rspack_import_key];
+    for(const __rspack_import_key in _base_tools__rspack_import_0)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_base_tools__rspack_import_0[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _init_arg_utils__rspack_import_4 = __webpack_require__("./init-arg-utils");
+    var _tool_defaults__rspack_import_1 = __webpack_require__("./tool-defaults");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _init_arg_utils__rspack_import_4)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_init_arg_utils__rspack_import_4[__rspack_import_key];
+    for(const __rspack_import_key in _tool_defaults__rspack_import_1)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_tool_defaults__rspack_import_1[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _error_formatter__rspack_import_5 = __webpack_require__("./error-formatter");
+    var _agent_behavior_init_args__rspack_import_2 = __webpack_require__("./agent-behavior-init-args");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _error_formatter__rspack_import_5)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_error_formatter__rspack_import_5[__rspack_import_key];
+    for(const __rspack_import_key in _agent_behavior_init_args__rspack_import_2)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_agent_behavior_init_args__rspack_import_2[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _tool_generator__rspack_import_6 = __webpack_require__("./tool-generator");
+    var _init_arg_utils__rspack_import_3 = __webpack_require__("./init-arg-utils");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _tool_generator__rspack_import_6)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_tool_generator__rspack_import_6[__rspack_import_key];
+    for(const __rspack_import_key in _init_arg_utils__rspack_import_3)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_init_arg_utils__rspack_import_3[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _types__rspack_import_7 = __webpack_require__("./types");
+    var _error_formatter__rspack_import_4 = __webpack_require__("./error-formatter");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _types__rspack_import_7)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_types__rspack_import_7[__rspack_import_key];
+    for(const __rspack_import_key in _error_formatter__rspack_import_4)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_error_formatter__rspack_import_4[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _inject_report_html_plugin__rspack_import_8 = __webpack_require__("./inject-report-html-plugin");
+    var _tool_generator__rspack_import_5 = __webpack_require__("./tool-generator");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _inject_report_html_plugin__rspack_import_8)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_inject_report_html_plugin__rspack_import_8[__rspack_import_key];
+    for(const __rspack_import_key in _tool_generator__rspack_import_5)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_tool_generator__rspack_import_5[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _launcher_helper__rspack_import_9 = __webpack_require__("./launcher-helper");
+    var _types__rspack_import_6 = __webpack_require__("./types");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _launcher_helper__rspack_import_9)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_launcher_helper__rspack_import_9[__rspack_import_key];
+    for(const __rspack_import_key in _types__rspack_import_6)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_types__rspack_import_6[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _chrome_path__rspack_import_10 = __webpack_require__("./chrome-path");
+    var _chrome_path__rspack_import_7 = __webpack_require__("./chrome-path");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _chrome_path__rspack_import_10)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_chrome_path__rspack_import_10[__rspack_import_key];
+    for(const __rspack_import_key in _chrome_path__rspack_import_7)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_chrome_path__rspack_import_7[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
 })();
 for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];

package/dist/lib/{mcp → agent-tools}/tool-generator.js

@@ -33,7 +33,7 @@ const external_zod_namespaceObject = require("zod");
 const external_zod_schema_utils_js_namespaceObject = require("../zod-schema-utils.js");
 const external_error_formatter_js_namespaceObject = require("./error-formatter.js");
 const external_user_prompt_js_namespaceObject = require("./user-prompt.js");
-function describeActionForMCP(action) {
+function describeActionForTool(action) {
     const actionDesc = action.description || `Execute ${action.name} action`;
     if (!action.paramSchema) return `${action.name} action, ${actionDesc}`;
     const shape = getZodObjectShape(action.paramSchema);
@@ -105,7 +105,7 @@ function extractActionSchema(paramSchema, actionName) {
     const shape = getZodObjectShape(paramSchema);
     if (!shape) {
         const typeName = paramSchema?._def?.typeName ?? 'unknown';
-        throw new Error(`Action "${actionName}" declared a non-object paramSchema (${typeName}). CLI and MCP tool schemas must be a ZodObject (e.g. z.object({ uri: z.string() })) or undefined. Wrap primitive fields in an object schema.`);
+        throw new Error(`Action "${actionName}" declared a non-object paramSchema (${typeName}). CLI tool schemas must be a ZodObject (e.g. z.object({ uri: z.string() })) or undefined. Wrap primitive fields in an object schema.`);
     }
     return Object.fromEntries(Object.entries(shape).map(([key, value])=>transformSchemaField(key, value)));
 }
@@ -357,7 +357,7 @@ function generateToolsFromActionSpace(actionSpace, getAgent, sanitizeArgs = (arg
         };
         return {
             name: action.name,
-            description: describeActionForMCP(action),
+            description: describeActionForTool(action),
             schema,
             cli: initArgCliMetadata,
             handler: async (args)=>{

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

@@ -45,8 +45,8 @@ const external_node_os_namespaceObject = require("node:os");
 const external_node_path_namespaceObject = require("node:path");
 const external_dotenv_namespaceObject = require("dotenv");
 var external_dotenv_default = /*#__PURE__*/ __webpack_require__.n(external_dotenv_namespaceObject);
+const tool_defaults_js_namespaceObject = require("../agent-tools/tool-defaults.js");
 const external_logger_js_namespaceObject = require("../logger.js");
-const tool_defaults_js_namespaceObject = require("../mcp/tool-defaults.js");
 const external_cli_args_js_namespaceObject = require("./cli-args.js");
 const external_cli_error_js_namespaceObject = require("./cli-error.js");
 const debug = (0, external_logger_js_namespaceObject.getDebug)('cli-runner');

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.9.8-beta-20260618091332.0";
+const getCurrentVersion = ()=>"1.10.0";
 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,

package/dist/lib/env/types.js

@@ -36,6 +36,7 @@ __webpack_require__.d(__webpack_exports__, {
     MIDSCENE_ANDROID_IME_STRATEGY: ()=>MIDSCENE_ANDROID_IME_STRATEGY,
     MIDSCENE_CACHE: ()=>MIDSCENE_CACHE,
     MIDSCENE_CACHE_MAX_FILENAME_LENGTH: ()=>MIDSCENE_CACHE_MAX_FILENAME_LENGTH,
+    MIDSCENE_CHROME_PATH: ()=>MIDSCENE_CHROME_PATH,
     MIDSCENE_DANGEROUSLY_PRINT_ALL_CONFIG: ()=>MIDSCENE_DANGEROUSLY_PRINT_ALL_CONFIG,
     MIDSCENE_DEBUG_MODE: ()=>MIDSCENE_DEBUG_MODE,
     MIDSCENE_DEBUG_MODEL_PROFILE: ()=>MIDSCENE_DEBUG_MODEL_PROFILE,
@@ -60,9 +61,7 @@ __webpack_require__.d(__webpack_exports__, {
     MIDSCENE_IOS_SIMULATOR_UDID: ()=>MIDSCENE_IOS_SIMULATOR_UDID,
     MIDSCENE_LANGFUSE_DEBUG: ()=>MIDSCENE_LANGFUSE_DEBUG,
     MIDSCENE_LANGSMITH_DEBUG: ()=>MIDSCENE_LANGSMITH_DEBUG,
-    MIDSCENE_MCP_ANDROID_MODE: ()=>MIDSCENE_MCP_ANDROID_MODE,
     MIDSCENE_MCP_CHROME_PATH: ()=>MIDSCENE_MCP_CHROME_PATH,
-    MIDSCENE_MCP_USE_PUPPETEER_MODE: ()=>MIDSCENE_MCP_USE_PUPPETEER_MODE,
     MIDSCENE_MODEL_API_KEY: ()=>MIDSCENE_MODEL_API_KEY,
     MIDSCENE_MODEL_BASE_URL: ()=>MIDSCENE_MODEL_BASE_URL,
     MIDSCENE_MODEL_EXTRA_BODY_JSON: ()=>MIDSCENE_MODEL_EXTRA_BODY_JSON,
@@ -123,9 +122,8 @@ const MIDSCENE_DEBUG_MODEL_PROFILE = 'MIDSCENE_DEBUG_MODEL_PROFILE';
 const MIDSCENE_DEBUG_MODEL_RESPONSE = 'MIDSCENE_DEBUG_MODEL_RESPONSE';
 const MIDSCENE_DANGEROUSLY_PRINT_ALL_CONFIG = 'MIDSCENE_DANGEROUSLY_PRINT_ALL_CONFIG';
 const MIDSCENE_DEBUG_MODE = 'MIDSCENE_DEBUG_MODE';
-const MIDSCENE_MCP_USE_PUPPETEER_MODE = 'MIDSCENE_MCP_USE_PUPPETEER_MODE';
+const MIDSCENE_CHROME_PATH = 'MIDSCENE_CHROME_PATH';
 const MIDSCENE_MCP_CHROME_PATH = 'MIDSCENE_MCP_CHROME_PATH';
-const MIDSCENE_MCP_ANDROID_MODE = 'MIDSCENE_MCP_ANDROID_MODE';
 const DOCKER_CONTAINER = 'DOCKER_CONTAINER';
 const MIDSCENE_LANGSMITH_DEBUG = 'MIDSCENE_LANGSMITH_DEBUG';
 const MIDSCENE_LANGFUSE_DEBUG = 'MIDSCENE_LANGFUSE_DEBUG';
@@ -208,8 +206,6 @@ const BASIC_ENV_KEYS = [
 ];
 const BOOLEAN_ENV_KEYS = [
     MIDSCENE_CACHE,
-    MIDSCENE_MCP_USE_PUPPETEER_MODE,
-    MIDSCENE_MCP_ANDROID_MODE,
     MIDSCENE_LANGSMITH_DEBUG,
     MIDSCENE_LANGFUSE_DEBUG,
     MIDSCENE_REPORT_QUIET
@@ -228,6 +224,7 @@ const STRING_ENV_KEYS = [
     MIDSCENE_REPORT_TAG_NAME,
     MIDSCENE_PREFERRED_LANGUAGE,
     MATCH_BY_POSITION,
+    MIDSCENE_CHROME_PATH,
     MIDSCENE_MCP_CHROME_PATH,
     DOCKER_CONTAINER
 ];
@@ -338,6 +335,7 @@ exports.MIDSCENE_ADB_REMOTE_PORT = __webpack_exports__.MIDSCENE_ADB_REMOTE_PORT;
 exports.MIDSCENE_ANDROID_IME_STRATEGY = __webpack_exports__.MIDSCENE_ANDROID_IME_STRATEGY;
 exports.MIDSCENE_CACHE = __webpack_exports__.MIDSCENE_CACHE;
 exports.MIDSCENE_CACHE_MAX_FILENAME_LENGTH = __webpack_exports__.MIDSCENE_CACHE_MAX_FILENAME_LENGTH;
+exports.MIDSCENE_CHROME_PATH = __webpack_exports__.MIDSCENE_CHROME_PATH;
 exports.MIDSCENE_DANGEROUSLY_PRINT_ALL_CONFIG = __webpack_exports__.MIDSCENE_DANGEROUSLY_PRINT_ALL_CONFIG;
 exports.MIDSCENE_DEBUG_MODE = __webpack_exports__.MIDSCENE_DEBUG_MODE;
 exports.MIDSCENE_DEBUG_MODEL_PROFILE = __webpack_exports__.MIDSCENE_DEBUG_MODEL_PROFILE;
@@ -362,9 +360,7 @@ exports.MIDSCENE_IOS_DEVICE_UDID = __webpack_exports__.MIDSCENE_IOS_DEVICE_UDID;
 exports.MIDSCENE_IOS_SIMULATOR_UDID = __webpack_exports__.MIDSCENE_IOS_SIMULATOR_UDID;
 exports.MIDSCENE_LANGFUSE_DEBUG = __webpack_exports__.MIDSCENE_LANGFUSE_DEBUG;
 exports.MIDSCENE_LANGSMITH_DEBUG = __webpack_exports__.MIDSCENE_LANGSMITH_DEBUG;
-exports.MIDSCENE_MCP_ANDROID_MODE = __webpack_exports__.MIDSCENE_MCP_ANDROID_MODE;
 exports.MIDSCENE_MCP_CHROME_PATH = __webpack_exports__.MIDSCENE_MCP_CHROME_PATH;
-exports.MIDSCENE_MCP_USE_PUPPETEER_MODE = __webpack_exports__.MIDSCENE_MCP_USE_PUPPETEER_MODE;
 exports.MIDSCENE_MODEL_API_KEY = __webpack_exports__.MIDSCENE_MODEL_API_KEY;
 exports.MIDSCENE_MODEL_BASE_URL = __webpack_exports__.MIDSCENE_MODEL_BASE_URL;
 exports.MIDSCENE_MODEL_EXTRA_BODY_JSON = __webpack_exports__.MIDSCENE_MODEL_EXTRA_BODY_JSON;
@@ -430,6 +426,7 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "MIDSCENE_ANDROID_IME_STRATEGY",
     "MIDSCENE_CACHE",
     "MIDSCENE_CACHE_MAX_FILENAME_LENGTH",
+    "MIDSCENE_CHROME_PATH",
     "MIDSCENE_DANGEROUSLY_PRINT_ALL_CONFIG",
     "MIDSCENE_DEBUG_MODE",
     "MIDSCENE_DEBUG_MODEL_PROFILE",
@@ -454,9 +451,7 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "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",

package/dist/lib/utils.js

@@ -24,20 +24,19 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    uuid: ()=>uuid,
-    isPlainObject: ()=>isPlainObject,
-    ifInBrowser: ()=>ifInBrowser,
-    repeat: ()=>repeat,
-    mergeAndNormalizeAppNameMapping: ()=>mergeAndNormalizeAppNameMapping,
-    ifInNode: ()=>ifInNode,
-    assert: ()=>assert,
     escapeScriptTag: ()=>escapeScriptTag,
     logMsg: ()=>logMsg,
+    isPlainObject: ()=>isPlainObject,
     replaceIllegalPathCharsAndSpace: ()=>replaceIllegalPathCharsAndSpace,
+    uuid: ()=>uuid,
+    ifInBrowser: ()=>ifInBrowser,
     generateHashId: ()=>generateHashId,
     normalizeForComparison: ()=>normalizeForComparison,
+    mergeAndNormalizeAppNameMapping: ()=>mergeAndNormalizeAppNameMapping,
+    ifInNode: ()=>ifInNode,
     ifInWorker: ()=>ifInWorker,
-    setIsMcp: ()=>setIsMcp,
+    repeat: ()=>repeat,
+    assert: ()=>assert,
     antiEscapeScriptTag: ()=>antiEscapeScriptTag
 });
 const external_js_sha256_namespaceObject = require("js-sha256");
@@ -76,12 +75,8 @@ function generateHashId(rect, content = '') {
 function assert(condition, message) {
     if (!condition) throw new Error(message || 'Assertion failed');
 }
-let isMcp = false;
-function setIsMcp(value) {
-    isMcp = value;
-}
 function logMsg(...message) {
-    if (!isMcp) console.log(...message);
+    console.log(...message);
 }
 async function repeat(times, fn) {
     for(let i = 0; i < times; i++)await fn(i);
@@ -124,7 +119,6 @@ exports.mergeAndNormalizeAppNameMapping = __webpack_exports__.mergeAndNormalizeA
 exports.normalizeForComparison = __webpack_exports__.normalizeForComparison;
 exports.repeat = __webpack_exports__.repeat;
 exports.replaceIllegalPathCharsAndSpace = __webpack_exports__.replaceIllegalPathCharsAndSpace;
-exports.setIsMcp = __webpack_exports__.setIsMcp;
 exports.uuid = __webpack_exports__.uuid;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "antiEscapeScriptTag",
@@ -140,7 +134,6 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "normalizeForComparison",
     "repeat",
     "replaceIllegalPathCharsAndSpace",
-    "setIsMcp",
     "uuid"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {

package/dist/types/{mcp → agent-tools}/base-tools.d.ts

@@ -1,4 +1,3 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { z } from 'zod';
 import { type CliReportSession } from './cli-report-session';
 import { type ToolDefaults } from './tool-defaults';
@@ -11,11 +10,11 @@ import type { BaseAgent, BaseDevice, IMidsceneTools, ToolCliMetadata, ToolDefini
 export interface InitArgSpec<TInitParam> {
     /** Arg namespace, e.g. `android`, `ios`. */
     namespace: string;
-    /** Zod shape describing the init args. Field names drive the MCP schema. */
+    /** Zod shape describing the init args. Field names drive the tool schema. */
     shape: Record<string, z.ZodTypeAny>;
     /**
      * Optional CLI presentation hints. These affect `--help` output for
-     * single-platform CLIs but do not alter MCP/YAML protocol keys.
+     * single-platform CLIs but do not alter YAML protocol keys.
      */
     cli?: {
         /** Prefer bare `--device-id`-style options in platform CLI help output. */
@@ -30,24 +29,23 @@ export interface InitArgSpec<TInitParam> {
     adapt?: (extracted: Record<string, unknown> | undefined) => TInitParam | undefined;
 }
 /**
- * Base class for platform-specific MCP tools.
+ * Base class for platform-specific Midscene tools.
  * @typeParam TAgent - Platform-specific agent type.
  * @typeParam TInitParam - Platform-specific init parameter consumed by
  *   `ensureAgent`. Defaults to `undefined` for platforms that take no args.
  */
 export declare abstract class BaseMidsceneTools<TAgent extends BaseAgent = BaseAgent, TInitParam = unknown> implements IMidsceneTools {
-    protected mcpServer?: McpServer;
     protected agent?: TAgent;
     protected toolDefinitions: ToolDefinition[];
     /**
      * Default options injected into every generated tool call (e.g. forced deep
-     * locate / deep think). Set from server/CLI behavior flags before
+     * locate / deep think). Set from startup/CLI behavior flags before
      * `initTools()` so they are baked into the generated tool handlers.
      * See https://github.com/web-infra-dev/midscene/issues/2446.
      */
     protected toolDefaults: ToolDefaults;
     /**
-     * Declarative init-arg spec. Subclasses that accept CLI/MCP init args should
+     * Declarative init-arg spec. Subclasses that accept CLI init args should
      * set this once and get `extractAgentInitParam` / `sanitizeToolArgs` /
      * `getAgentInitArgSchema` auto-implemented.
      *
@@ -66,7 +64,7 @@ export declare abstract class BaseMidsceneTools<TAgent extends BaseAgent = BaseA
     protected abstract ensureAgent(initParam?: TInitParam): Promise<TAgent>;
     private getInitArgKeys;
     /**
-     * Extract a platform-specific agent init parameter from CLI/MCP tool args.
+     * Extract a platform-specific agent init parameter from CLI tool args.
      */
     protected extractAgentInitParam(args: Record<string, unknown>): TInitParam | undefined;
     /**
@@ -82,7 +80,7 @@ export declare abstract class BaseMidsceneTools<TAgent extends BaseAgent = BaseA
      * show ergonomic bare flags while the underlying schema stays namespaced.
      * When `preferBareKeys` is enabled, single-platform CLIs only accept the
      * bare spellings; namespaced dotted spellings remain available through the
-     * MCP/YAML schema instead of the platform CLI surface.
+     * YAML schema instead of the platform CLI surface.
      */
     protected getAgentInitArgCliMetadata(): ToolCliMetadata | undefined;
     /**
@@ -109,10 +107,6 @@ export declare abstract class BaseMidsceneTools<TAgent extends BaseAgent = BaseA
      * 2. Create temporary device instance to read actionSpace (always succeeds)
      */
     initTools(): Promise<void>;
-    /**
-     * Attach to MCP server and register all tools
-     */
-    attachToServer(server: McpServer): void;
     /**
      * Cleanup method - destroy agent and release resources
      */

package/dist/types/{mcp → agent-tools}/index.d.ts

@@ -1,4 +1,3 @@
-export * from './base-server';
 export * from './base-tools';
 export * from './tool-defaults';
 export * from './agent-behavior-init-args';
@@ -6,6 +5,4 @@ export * from './init-arg-utils';
 export * from './error-formatter';
 export * from './tool-generator';
 export * from './types';
-export * from './inject-report-html-plugin';
-export * from './launcher-helper';
 export * from './chrome-path';

package/dist/types/{mcp → agent-tools}/init-arg-utils.d.ts

@@ -3,11 +3,11 @@ import type { ToolSchema } from './types';
 export declare function extractNamespacedArgs<TFieldName extends string, TArgs extends Record<string, unknown> = Record<string, unknown>>(args: Record<string, unknown>, namespace: string, keys: readonly TFieldName[]): TArgs | undefined;
 export declare function sanitizeNamespacedArgs(args: Record<string, unknown>, namespace: string, keys: readonly string[]): Record<string, unknown>;
 /**
- * Build a flat MCP tool schema whose keys are dotted `"<namespace>.<field>"`.
+ * Build a flat tool schema whose keys are dotted `"<namespace>.<field>"`.
  *
  * We intentionally stay flat (rather than `{ namespace: z.object({...}) }`) so
- * that CLI (`--android.device-id`), MCP clients, and `--help` output all share
- * the same spelling. `readNamespacedArg` understands all three input shapes:
+ * that CLI (`--android.device-id`) and `--help` output share the same spelling.
+ * `readNamespacedArg` understands all three input shapes:
  * nested namespace object, dotted flat key, and bare key fallback.
  */
 export declare function createNamespacedInitArgSchema(namespace: string, shape: Record<string, z.ZodTypeAny>): ToolSchema;