@midscene/shared 1.9.1 → 1.9.2-beta-20260605084246.0

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

@@ -3,6 +3,7 @@ import { tmpdir } from "node:os";
 import { join } from "node:path";
 import dotenv from "dotenv";
 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');
@@ -62,8 +63,10 @@ function printHelp(scriptName, commands, version) {
     console.log(`\nRun "${scriptName} <command> --help" for more info.`);
 }
 async function runToolsCLI(tools, scriptName, options) {
-    const rawArgs = options?.argv ?? process.argv.slice(2);
-    debug('CLI invoked: %s %s', scriptName, rawArgs.join(' '));
+    const inputArgs = options?.argv ?? process.argv.slice(2);
+    debug('CLI invoked: %s %s', scriptName, inputArgs.join(' '));
+    const { rawArgs, toolDefaults } = stripBehaviorFlags(inputArgs);
+    if (Object.keys(toolDefaults).length > 0) tools.setToolDefaults?.(toolDefaults);
     const envFile = join(process.cwd(), '.env');
     if (existsSync(envFile)) dotenv.config({
         path: envFile

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.1";
+const getCurrentVersion = ()=>"1.9.2-beta-20260605084246.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/mcp/base-server.mjs

@@ -5,6 +5,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import express from "express";
 import { getErrorMessage } from "./error-formatter.mjs";
+import { TOOL_BEHAVIOR_FLAGS, mergeToolDefaults, resolveToolDefaults } from "./tool-defaults.mjs";
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -27,9 +28,16 @@ const CLI_ARGS_CONFIG = {
     host: {
         type: 'string',
         default: 'localhost'
-    }
+    },
+    ...Object.fromEntries(TOOL_BEHAVIOR_FLAGS.map((flag)=>[
+            flag.cli,
+            {
+                type: 'boolean'
+            }
+        ]))
 };
 function launchMCPServer(server, args) {
+    server.setToolDefaults(resolveToolDefaults((cli)=>true === args[cli]));
     if ('http' === args.mode) return server.launchHttp({
         port: Number.parseInt(args.port || '3000', 10),
         host: args.host || 'localhost'
@@ -40,9 +48,13 @@ const SESSION_TIMEOUT_MS = 1800000;
 const CLEANUP_INTERVAL_MS = 300000;
 const MAX_SESSIONS = 100;
 class BaseMCPServer {
+    setToolDefaults(toolDefaults) {
+        this.toolDefaults = mergeToolDefaults(this.toolDefaults, toolDefaults);
+    }
     async initializeToolsManager() {
         setIsMcp(true);
         this.toolsManager = this.providedToolsManager || this.createToolsManager();
+        this.toolsManager.setToolDefaults?.(this.toolDefaults);
         try {
             await this.toolsManager.initTools();
         } catch (error) {
@@ -270,6 +282,7 @@ class BaseMCPServer {
         _define_property(this, "toolsManager", void 0);
         _define_property(this, "config", void 0);
         _define_property(this, "providedToolsManager", void 0);
+        _define_property(this, "toolDefaults", {});
         this.config = config;
         this.mcpServer = new McpServer({
             name: config.name,

package/dist/es/mcp/base-tools.mjs

@@ -3,6 +3,7 @@ import { getDebug } from "@midscene/shared/logger";
 import { camelToKebab, getKeyAliases } from "../key-alias-utils.mjs";
 import { generateCliReportSession, readCliReportSession, writeCliReportSession } from "./cli-report-session.mjs";
 import { createNamespacedInitArgSchema, extractNamespacedArgs, sanitizeNamespacedArgs } from "./init-arg-utils.mjs";
+import { mergeToolDefaults } from "./tool-defaults.mjs";
 import { generateCommonTools, generateToolsFromActionSpace } from "./tool-generator.mjs";
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
@@ -98,8 +99,8 @@ class BaseMidsceneTools {
             await tempDevice.destroy?.();
             debug('Action space from temporary device:', actionSpace.map((a)=>a.name).join(', '));
         }
-        const actionTools = generateToolsFromActionSpace(actionSpace, (args = {})=>this.ensureAgent(this.extractAgentInitParam(args)), (args = {})=>this.sanitizeToolArgs(args), this.getAgentInitArgSchema(), this.getAgentInitArgCliMetadata());
-        const commonTools = generateCommonTools((args = {})=>this.ensureAgent(this.extractAgentInitParam(args)), this.getAgentInitArgSchema(), this.getAgentInitArgCliMetadata());
+        const actionTools = generateToolsFromActionSpace(actionSpace, (args = {})=>this.ensureAgent(this.extractAgentInitParam(args)), (args = {})=>this.sanitizeToolArgs(args), this.getAgentInitArgSchema(), this.getAgentInitArgCliMetadata(), this.toolDefaults);
+        const commonTools = generateCommonTools((args = {})=>this.ensureAgent(this.extractAgentInitParam(args)), this.getAgentInitArgSchema(), this.getAgentInitArgCliMetadata(), this.toolDefaults);
         this.toolDefinitions.push(...actionTools, ...commonTools);
         debug('Total tools prepared:', this.toolDefinitions.length);
     }
@@ -118,6 +119,9 @@ class BaseMidsceneTools {
     setAgent(agent) {
         this.agent = agent;
     }
+    setToolDefaults(toolDefaults) {
+        this.toolDefaults = mergeToolDefaults(this.toolDefaults, toolDefaults);
+    }
     buildScreenshotContent(screenshot) {
         const { mimeType, body } = parseBase64(screenshot);
         return [
@@ -154,6 +158,7 @@ class BaseMidsceneTools {
         _define_property(this, "mcpServer", void 0);
         _define_property(this, "agent", void 0);
         _define_property(this, "toolDefinitions", []);
+        _define_property(this, "toolDefaults", {});
     }
 }
 export { BaseMidsceneTools };

package/dist/es/mcp/index.mjs

@@ -1,5 +1,6 @@
 export * from "./base-server.mjs";
 export * from "./base-tools.mjs";
+export * from "./tool-defaults.mjs";
 export * from "./init-arg-utils.mjs";
 export * from "./error-formatter.mjs";
 export * from "./tool-generator.mjs";

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

@@ -0,0 +1,54 @@
+const TOOL_BEHAVIOR_FLAGS = [
+    {
+        cli: 'deep-locate',
+        description: 'Force deep locate for every locating operation (better precision for small/ambiguous targets, a bit slower).',
+        defaults: {
+            locate: {
+                deepLocate: true
+            },
+            act: {
+                deepLocate: true
+            }
+        }
+    },
+    {
+        cli: 'deep-think',
+        description: 'Plan the act tool with deep thinking (richer context and sub-goal decomposition, a bit slower).',
+        defaults: {
+            act: {
+                deepThink: true
+            }
+        }
+    }
+];
+function mergeToolDefaults(a, b) {
+    const locate = {
+        ...a.locate,
+        ...b.locate
+    };
+    const act = {
+        ...a.act,
+        ...b.act
+    };
+    const result = {};
+    if (Object.keys(locate).length > 0) result.locate = locate;
+    if (Object.keys(act).length > 0) result.act = act;
+    return result;
+}
+function resolveToolDefaults(isEnabled) {
+    return TOOL_BEHAVIOR_FLAGS.reduce((acc, flag)=>isEnabled(flag.cli) ? mergeToolDefaults(acc, flag.defaults) : acc, {});
+}
+function stripBehaviorFlags(argv) {
+    const enabled = new Set();
+    const rawArgs = [];
+    for (const arg of argv){
+        const flag = TOOL_BEHAVIOR_FLAGS.find((f)=>arg === `--${f.cli}`);
+        if (flag) enabled.add(flag.cli);
+        else rawArgs.push(arg);
+    }
+    return {
+        rawArgs,
+        toolDefaults: resolveToolDefaults((cli)=>enabled.has(cli))
+    };
+}
+export { TOOL_BEHAVIOR_FLAGS, mergeToolDefaults, resolveToolDefaults, stripBehaviorFlags };

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

@@ -135,6 +135,34 @@ function normalizeActionArgs(args, paramSchema) {
         ];
     }));
 }
+function mergeLocateDefaults(locate, defaults) {
+    let merged;
+    for (const [key, value] of Object.entries(defaults))if (void 0 === locate[key]) {
+        if ('deepLocate' !== key || void 0 === locate.deepThink) {
+            merged = merged ?? {
+                ...locate
+            };
+            merged[key] = value;
+        }
+    }
+    return merged ?? locate;
+}
+function applyLocateDefaults(args, paramSchema, locateDefaults) {
+    if (!paramSchema || 0 === Object.keys(locateDefaults).length) return args;
+    const shape = getZodObjectShape(paramSchema);
+    if (!shape) return args;
+    return Object.fromEntries(Object.entries(args).map(([key, value])=>{
+        const fieldSchema = shape[key];
+        if (fieldSchema && isMidsceneLocatorField(fieldSchema) && isRecord(value)) return [
+            key,
+            mergeLocateDefaults(value, locateDefaults)
+        ];
+        return [
+            key,
+            value
+        ];
+    }));
+}
 function serializeArgsToDescription(args) {
     try {
         return Object.entries(args).map(([key, value])=>{
@@ -290,7 +318,7 @@ function mergeToolCliMetadata(base, extra) {
         options
     } : void 0;
 }
-function generateToolsFromActionSpace(actionSpace, getAgent, sanitizeArgs = (args)=>args, initArgSchema = {}, initArgCliMetadata) {
+function generateToolsFromActionSpace(actionSpace, getAgent, sanitizeArgs = (args)=>args, initArgSchema = {}, initArgCliMetadata, toolDefaults = {}) {
     return actionSpace.map((action)=>{
         const schema = {
             ...extractActionSchema(action.paramSchema, action.name),
@@ -304,7 +332,8 @@ function generateToolsFromActionSpace(actionSpace, getAgent, sanitizeArgs = (arg
             handler: async (args)=>{
                 try {
                     const agent = await getAgent(args);
-                    const normalizedArgs = normalizeActionArgs(sanitizeArgs(args), action.paramSchema);
+                    let normalizedArgs = normalizeActionArgs(sanitizeArgs(args), action.paramSchema);
+                    if (toolDefaults.locate) normalizedArgs = applyLocateDefaults(normalizedArgs, action.paramSchema, toolDefaults.locate);
                     let actionResult;
                     try {
                         actionResult = await executeAction(agent, action.name, normalizedArgs);
@@ -323,7 +352,7 @@ function generateToolsFromActionSpace(actionSpace, getAgent, sanitizeArgs = (arg
         };
     });
 }
-function generateCommonTools(getAgent, initArgSchema = {}, initArgCliMetadata) {
+function generateCommonTools(getAgent, initArgSchema = {}, initArgCliMetadata, toolDefaults = {}) {
     return [
         {
             name: 'take_screenshot',
@@ -362,6 +391,8 @@ function generateCommonTools(getAgent, initArgSchema = {}, initArgCliMetadata) {
             description: 'Execute a natural language action. The AI will plan and perform multi-step operations in a single invocation, useful for transient UI interactions (e.g., Spotlight, dropdown menus) that disappear between separate commands.',
             schema: {
                 prompt: z.string().describe('Natural language description of the action to perform, e.g. "press Command+Space, type Safari, press Enter"'),
+                deepLocate: z.boolean().optional().describe('Use deep locate for every element this action targets. Improves precision for small or ambiguous targets at the cost of speed. Defaults to the server --deep-locate setting.'),
+                deepThink: z.boolean().optional().describe('Plan this action with deep thinking (richer context and sub-goal decomposition). Helps with complex multi-step instructions at the cost of speed. Defaults to the server --deep-think setting.'),
                 ...initArgSchema
             },
             cli: mergeToolCliMetadata(void 0, initArgCliMetadata),
@@ -370,9 +401,13 @@ function generateCommonTools(getAgent, initArgSchema = {}, initArgCliMetadata) {
                 try {
                     const agent = await getAgent(args);
                     if (!agent.aiAction) return createErrorResult('act is not supported by this agent');
-                    const result = await agent.aiAction(prompt, {
-                        deepThink: false
-                    });
+                    const actOptions = {
+                        deepThink: false,
+                        ...toolDefaults.act
+                    };
+                    if (void 0 !== args.deepLocate) actOptions.deepLocate = args.deepLocate;
+                    if (void 0 !== args.deepThink) actOptions.deepThink = args.deepThink;
+                    const result = await agent.aiAction(prompt, actOptions);
                     return await captureScreenshotResult(agent, 'act', result);
                 } catch (error) {
                     const errorMessage = getErrorMessage(error);
@@ -386,12 +421,14 @@ 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"'),
+                message: z.string().optional().describe('Custom error message to throw when the assertion fails, e.g. "the login button should be visible".'),
                 ...promptInputExtraSchema,
                 ...initArgSchema
             },
             cli: mergeToolCliMetadata(void 0, initArgCliMetadata),
             handler: async (args = {})=>{
                 const prompt = args.prompt;
+                const message = args.message;
                 try {
                     const agent = await getAgent(args);
                     if (!agent.aiAssert) return createErrorResult('assert is not supported by this agent');
@@ -401,7 +438,7 @@ function generateCommonTools(getAgent, initArgSchema = {}, initArgCliMetadata) {
                         imageName: args.imageName,
                         convertHttpImage2Base64: args.convertHttpImage2Base64
                     });
-                    await agent.aiAssert(userPrompt);
+                    await agent.aiAssert(userPrompt, message);
                     return {
                         content: [
                             {

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

@@ -46,6 +46,7 @@ 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 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');
@@ -105,8 +106,10 @@ function printHelp(scriptName, commands, version) {
     console.log(`\nRun "${scriptName} <command> --help" for more info.`);
 }
 async function runToolsCLI(tools, scriptName, options) {
-    const rawArgs = options?.argv ?? process.argv.slice(2);
-    debug('CLI invoked: %s %s', scriptName, rawArgs.join(' '));
+    const inputArgs = options?.argv ?? process.argv.slice(2);
+    debug('CLI invoked: %s %s', scriptName, inputArgs.join(' '));
+    const { rawArgs, toolDefaults } = (0, tool_defaults_js_namespaceObject.stripBehaviorFlags)(inputArgs);
+    if (Object.keys(toolDefaults).length > 0) tools.setToolDefaults?.(toolDefaults);
     const envFile = (0, external_node_path_namespaceObject.join)(process.cwd(), '.env');
     if ((0, external_node_fs_namespaceObject.existsSync)(envFile)) external_dotenv_default().config({
         path: envFile

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.1";
+const getCurrentVersion = ()=>"1.9.2-beta-20260605084246.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/mcp/base-server.js

@@ -45,6 +45,7 @@ const streamableHttp_js_namespaceObject = require("@modelcontextprotocol/sdk/ser
 const external_express_namespaceObject = require("express");
 var external_express_default = /*#__PURE__*/ __webpack_require__.n(external_express_namespaceObject);
 const external_error_formatter_js_namespaceObject = require("./error-formatter.js");
+const external_tool_defaults_js_namespaceObject = require("./tool-defaults.js");
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -67,9 +68,16 @@ const CLI_ARGS_CONFIG = {
     host: {
         type: 'string',
         default: 'localhost'
-    }
+    },
+    ...Object.fromEntries(external_tool_defaults_js_namespaceObject.TOOL_BEHAVIOR_FLAGS.map((flag)=>[
+            flag.cli,
+            {
+                type: 'boolean'
+            }
+        ]))
 };
 function launchMCPServer(server, args) {
+    server.setToolDefaults((0, external_tool_defaults_js_namespaceObject.resolveToolDefaults)((cli)=>true === args[cli]));
     if ('http' === args.mode) return server.launchHttp({
         port: Number.parseInt(args.port || '3000', 10),
         host: args.host || 'localhost'
@@ -80,9 +88,13 @@ const SESSION_TIMEOUT_MS = 1800000;
 const CLEANUP_INTERVAL_MS = 300000;
 const MAX_SESSIONS = 100;
 class BaseMCPServer {
+    setToolDefaults(toolDefaults) {
+        this.toolDefaults = (0, external_tool_defaults_js_namespaceObject.mergeToolDefaults)(this.toolDefaults, toolDefaults);
+    }
     async initializeToolsManager() {
         (0, utils_namespaceObject.setIsMcp)(true);
         this.toolsManager = this.providedToolsManager || this.createToolsManager();
+        this.toolsManager.setToolDefaults?.(this.toolDefaults);
         try {
             await this.toolsManager.initTools();
         } catch (error) {
@@ -310,6 +322,7 @@ class BaseMCPServer {
         _define_property(this, "toolsManager", void 0);
         _define_property(this, "config", void 0);
         _define_property(this, "providedToolsManager", void 0);
+        _define_property(this, "toolDefaults", {});
         this.config = config;
         this.mcpServer = new mcp_js_namespaceObject.McpServer({
             name: config.name,

package/dist/lib/mcp/base-tools.js

@@ -31,6 +31,7 @@ const logger_namespaceObject = require("@midscene/shared/logger");
 const external_key_alias_utils_js_namespaceObject = require("../key-alias-utils.js");
 const external_cli_report_session_js_namespaceObject = require("./cli-report-session.js");
 const external_init_arg_utils_js_namespaceObject = require("./init-arg-utils.js");
+const external_tool_defaults_js_namespaceObject = require("./tool-defaults.js");
 const external_tool_generator_js_namespaceObject = require("./tool-generator.js");
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
@@ -126,8 +127,8 @@ class BaseMidsceneTools {
             await tempDevice.destroy?.();
             debug('Action space from temporary device:', actionSpace.map((a)=>a.name).join(', '));
         }
-        const actionTools = (0, external_tool_generator_js_namespaceObject.generateToolsFromActionSpace)(actionSpace, (args = {})=>this.ensureAgent(this.extractAgentInitParam(args)), (args = {})=>this.sanitizeToolArgs(args), this.getAgentInitArgSchema(), this.getAgentInitArgCliMetadata());
-        const commonTools = (0, external_tool_generator_js_namespaceObject.generateCommonTools)((args = {})=>this.ensureAgent(this.extractAgentInitParam(args)), this.getAgentInitArgSchema(), this.getAgentInitArgCliMetadata());
+        const actionTools = (0, external_tool_generator_js_namespaceObject.generateToolsFromActionSpace)(actionSpace, (args = {})=>this.ensureAgent(this.extractAgentInitParam(args)), (args = {})=>this.sanitizeToolArgs(args), this.getAgentInitArgSchema(), this.getAgentInitArgCliMetadata(), this.toolDefaults);
+        const commonTools = (0, external_tool_generator_js_namespaceObject.generateCommonTools)((args = {})=>this.ensureAgent(this.extractAgentInitParam(args)), this.getAgentInitArgSchema(), this.getAgentInitArgCliMetadata(), this.toolDefaults);
         this.toolDefinitions.push(...actionTools, ...commonTools);
         debug('Total tools prepared:', this.toolDefinitions.length);
     }
@@ -146,6 +147,9 @@ class BaseMidsceneTools {
     setAgent(agent) {
         this.agent = agent;
     }
+    setToolDefaults(toolDefaults) {
+        this.toolDefaults = (0, external_tool_defaults_js_namespaceObject.mergeToolDefaults)(this.toolDefaults, toolDefaults);
+    }
     buildScreenshotContent(screenshot) {
         const { mimeType, body } = (0, img_namespaceObject.parseBase64)(screenshot);
         return [
@@ -182,6 +186,7 @@ class BaseMidsceneTools {
         _define_property(this, "mcpServer", void 0);
         _define_property(this, "agent", void 0);
         _define_property(this, "toolDefinitions", []);
+        _define_property(this, "toolDefaults", {});
     }
 }
 exports.BaseMidsceneTools = __webpack_exports__.BaseMidsceneTools;

package/dist/lib/mcp/index.js

@@ -21,6 +21,9 @@ var __webpack_modules__ = {
     "./launcher-helper" (module) {
         module.exports = require("./launcher-helper.js");
     },
+    "./tool-defaults" (module) {
+        module.exports = require("./tool-defaults.js");
+    },
     "./tool-generator" (module) {
         module.exports = require("./tool-generator.js");
     },
@@ -79,33 +82,37 @@ var __webpack_exports__ = {};
     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 _init_arg_utils__rspack_import_2 = __webpack_require__("./init-arg-utils");
+    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 _init_arg_utils__rspack_import_3 = __webpack_require__("./init-arg-utils");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _init_arg_utils__rspack_import_2)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_init_arg_utils__rspack_import_2[__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 _error_formatter__rspack_import_3 = __webpack_require__("./error-formatter");
+    var _error_formatter__rspack_import_4 = __webpack_require__("./error-formatter");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _error_formatter__rspack_import_3)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_error_formatter__rspack_import_3[__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 _tool_generator__rspack_import_4 = __webpack_require__("./tool-generator");
+    var _tool_generator__rspack_import_5 = __webpack_require__("./tool-generator");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _tool_generator__rspack_import_4)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_tool_generator__rspack_import_4[__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 _types__rspack_import_5 = __webpack_require__("./types");
+    var _types__rspack_import_6 = __webpack_require__("./types");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _types__rspack_import_5)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_types__rspack_import_5[__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 _inject_report_html_plugin__rspack_import_6 = __webpack_require__("./inject-report-html-plugin");
+    var _inject_report_html_plugin__rspack_import_7 = __webpack_require__("./inject-report-html-plugin");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _inject_report_html_plugin__rspack_import_6)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_inject_report_html_plugin__rspack_import_6[__rspack_import_key];
+    for(const __rspack_import_key in _inject_report_html_plugin__rspack_import_7)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_inject_report_html_plugin__rspack_import_7[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _launcher_helper__rspack_import_7 = __webpack_require__("./launcher-helper");
+    var _launcher_helper__rspack_import_8 = __webpack_require__("./launcher-helper");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _launcher_helper__rspack_import_7)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_launcher_helper__rspack_import_7[__rspack_import_key];
+    for(const __rspack_import_key in _launcher_helper__rspack_import_8)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_launcher_helper__rspack_import_8[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _chrome_path__rspack_import_8 = __webpack_require__("./chrome-path");
+    var _chrome_path__rspack_import_9 = __webpack_require__("./chrome-path");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _chrome_path__rspack_import_8)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_chrome_path__rspack_import_8[__rspack_import_key];
+    for(const __rspack_import_key in _chrome_path__rspack_import_9)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_chrome_path__rspack_import_9[__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/tool-defaults.js

@@ -0,0 +1,97 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    TOOL_BEHAVIOR_FLAGS: ()=>TOOL_BEHAVIOR_FLAGS,
+    mergeToolDefaults: ()=>mergeToolDefaults,
+    resolveToolDefaults: ()=>resolveToolDefaults,
+    stripBehaviorFlags: ()=>stripBehaviorFlags
+});
+const TOOL_BEHAVIOR_FLAGS = [
+    {
+        cli: 'deep-locate',
+        description: 'Force deep locate for every locating operation (better precision for small/ambiguous targets, a bit slower).',
+        defaults: {
+            locate: {
+                deepLocate: true
+            },
+            act: {
+                deepLocate: true
+            }
+        }
+    },
+    {
+        cli: 'deep-think',
+        description: 'Plan the act tool with deep thinking (richer context and sub-goal decomposition, a bit slower).',
+        defaults: {
+            act: {
+                deepThink: true
+            }
+        }
+    }
+];
+function mergeToolDefaults(a, b) {
+    const locate = {
+        ...a.locate,
+        ...b.locate
+    };
+    const act = {
+        ...a.act,
+        ...b.act
+    };
+    const result = {};
+    if (Object.keys(locate).length > 0) result.locate = locate;
+    if (Object.keys(act).length > 0) result.act = act;
+    return result;
+}
+function resolveToolDefaults(isEnabled) {
+    return TOOL_BEHAVIOR_FLAGS.reduce((acc, flag)=>isEnabled(flag.cli) ? mergeToolDefaults(acc, flag.defaults) : acc, {});
+}
+function stripBehaviorFlags(argv) {
+    const enabled = new Set();
+    const rawArgs = [];
+    for (const arg of argv){
+        const flag = TOOL_BEHAVIOR_FLAGS.find((f)=>arg === `--${f.cli}`);
+        if (flag) enabled.add(flag.cli);
+        else rawArgs.push(arg);
+    }
+    return {
+        rawArgs,
+        toolDefaults: resolveToolDefaults((cli)=>enabled.has(cli))
+    };
+}
+exports.TOOL_BEHAVIOR_FLAGS = __webpack_exports__.TOOL_BEHAVIOR_FLAGS;
+exports.mergeToolDefaults = __webpack_exports__.mergeToolDefaults;
+exports.resolveToolDefaults = __webpack_exports__.resolveToolDefaults;
+exports.stripBehaviorFlags = __webpack_exports__.stripBehaviorFlags;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "TOOL_BEHAVIOR_FLAGS",
+    "mergeToolDefaults",
+    "resolveToolDefaults",
+    "stripBehaviorFlags"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});