@midscene/shared 1.7.5-beta-20260421030751.0 → 1.7.5

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

@@ -33,10 +33,11 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    CLIError: ()=>CLIError,
-    parseCliArgs: ()=>parseCliArgs,
-    parseValue: ()=>parseValue,
+    CLIError: ()=>external_cli_error_js_namespaceObject.CLIError,
+    parseCliArgs: ()=>external_cli_args_js_namespaceObject.parseCliArgs,
+    parseValue: ()=>external_cli_args_js_namespaceObject.parseValue,
     runToolsCLI: ()=>runToolsCLI,
+    reportCLIError: ()=>external_cli_error_js_namespaceObject.reportCLIError,
     removePrefix: ()=>removePrefix
 });
 const external_node_fs_namespaceObject = require("node:fs");
@@ -45,44 +46,9 @@ 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");
-function _define_property(obj, key, value) {
-    if (key in obj) Object.defineProperty(obj, key, {
-        value: value,
-        enumerable: true,
-        configurable: true,
-        writable: true
-    });
-    else obj[key] = value;
-    return obj;
-}
+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');
-class CLIError extends Error {
-    constructor(message, exitCode = 1){
-        super(message), _define_property(this, "exitCode", void 0), this.exitCode = exitCode;
-    }
-}
-function parseValue(raw) {
-    if (raw.startsWith('{') || raw.startsWith('[')) try {
-        return JSON.parse(raw);
-    } catch  {}
-    if (/^-?\d+(\.\d+)?$/.test(raw)) return Number(raw);
-    return raw;
-}
-function parseCliArgs(args) {
-    const result = {};
-    for(let i = 0; i < args.length; i++){
-        const arg = args[i];
-        if (!arg.startsWith('--')) continue;
-        const body = arg.slice(2);
-        const eqIdx = body.indexOf('=');
-        if (eqIdx >= 0) result[body.slice(0, eqIdx)] = parseValue(body.slice(eqIdx + 1));
-        else if (args[i + 1] && !args[i + 1].startsWith('--')) {
-            i++;
-            result[body] = parseValue(args[i]);
-        } else result[body] = true;
-    }
-    return result;
-}
 function outputContentItem(item, isError) {
     switch(item.type){
         case 'text':
@@ -114,10 +80,13 @@ function printCommandHelp(scriptName, cmd) {
     console.log(def.description);
     const schemaEntries = Object.entries(def.schema);
     if (schemaEntries.length > 0) {
+        const optionWidth = Math.max(22, ...schemaEntries.map(([key])=>(0, external_cli_args_js_namespaceObject.getCliOptionDisplay)(key, def.cli?.options?.[key]).label.length));
         console.log('\nOptions:');
         for (const [key, zodType] of schemaEntries){
+            const { label, aliases } = (0, external_cli_args_js_namespaceObject.getCliOptionDisplay)(key, def.cli?.options?.[key]);
             const desc = zodType.description ?? '';
-            console.log(`  --${key.padEnd(20)} ${desc}`);
+            const aliasText = aliases.length > 0 ? ` (aliases: ${aliases.join(', ')})` : '';
+            console.log(`  ${label.padEnd(optionWidth)} ${desc}${aliasText}`);
         }
     }
 }
@@ -167,7 +136,7 @@ async function runToolsCLI(tools, scriptName, options) {
         return;
     }
     if ('--version' === commandName || '-v' === commandName || 'version' === commandName.toLowerCase()) {
-        if (!cliVersion) throw new CLIError('Failed to determine CLI version');
+        if (!cliVersion) throw new external_cli_error_js_namespaceObject.CLIError('Failed to determine CLI version');
         printVersion(scriptName, cliVersion);
         return;
     }
@@ -176,31 +145,35 @@ async function runToolsCLI(tools, scriptName, options) {
         debug('unknown command: %s', commandName);
         console.error(`Unknown command: ${commandName}`);
         printHelp(scriptName, commands, cliVersion);
-        throw new CLIError(`Unknown command: ${commandName}`);
+        throw new external_cli_error_js_namespaceObject.CLIError(`Unknown command: ${commandName}`);
     }
-    const parsedArgs = parseCliArgs(restArgs);
-    debug('command: %s, args: %s', match.name, JSON.stringify(parsedArgs));
+    const parsedArgs = (0, external_cli_args_js_namespaceObject.parseCliArgs)(restArgs);
     if (true === parsedArgs.help) {
         debug('showing command help for: %s', match.name);
         printCommandHelp(scriptName, match);
         return;
     }
+    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);
     debug('command %s completed, isError: %s', match.name, result.isError ?? false);
     outputResult(result);
     await tools.destroy();
-    if (result.isError) throw new CLIError('Command failed', 1);
+    if (result.isError) throw new external_cli_error_js_namespaceObject.CLIError('Command failed', 1);
 }
 exports.CLIError = __webpack_exports__.CLIError;
 exports.parseCliArgs = __webpack_exports__.parseCliArgs;
 exports.parseValue = __webpack_exports__.parseValue;
 exports.removePrefix = __webpack_exports__.removePrefix;
+exports.reportCLIError = __webpack_exports__.reportCLIError;
 exports.runToolsCLI = __webpack_exports__.runToolsCLI;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "CLIError",
     "parseCliArgs",
     "parseValue",
     "removePrefix",
+    "reportCLIError",
     "runToolsCLI"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {

package/dist/lib/cli/index.js

@@ -24,23 +24,28 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    CLIError: ()=>external_cli_runner_js_namespaceObject.CLIError,
-    parseCliArgs: ()=>external_cli_runner_js_namespaceObject.parseCliArgs,
-    parseValue: ()=>external_cli_runner_js_namespaceObject.parseValue,
+    CLIError: ()=>external_cli_error_js_namespaceObject.CLIError,
+    parseCliArgs: ()=>external_cli_args_js_namespaceObject.parseCliArgs,
+    parseValue: ()=>external_cli_args_js_namespaceObject.parseValue,
     runToolsCLI: ()=>external_cli_runner_js_namespaceObject.runToolsCLI,
+    reportCLIError: ()=>external_cli_error_js_namespaceObject.reportCLIError,
     removePrefix: ()=>external_cli_runner_js_namespaceObject.removePrefix
 });
+const external_cli_error_js_namespaceObject = require("./cli-error.js");
+const external_cli_args_js_namespaceObject = require("./cli-args.js");
 const external_cli_runner_js_namespaceObject = require("./cli-runner.js");
 exports.CLIError = __webpack_exports__.CLIError;
 exports.parseCliArgs = __webpack_exports__.parseCliArgs;
 exports.parseValue = __webpack_exports__.parseValue;
 exports.removePrefix = __webpack_exports__.removePrefix;
+exports.reportCLIError = __webpack_exports__.reportCLIError;
 exports.runToolsCLI = __webpack_exports__.runToolsCLI;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "CLIError",
     "parseCliArgs",
     "parseValue",
     "removePrefix",
+    "reportCLIError",
     "runToolsCLI"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {

package/dist/lib/constants/index.js

@@ -35,6 +35,7 @@ __webpack_require__.d(__webpack_exports__, {
     YAML_EXAMPLE_CODE: ()=>external_example_code_js_namespaceObject.YAML_EXAMPLE_CODE,
     CONTAINER_MINI_HEIGHT: ()=>CONTAINER_MINI_HEIGHT,
     SCRCPY_VIDEO_STREAM_TIMEOUT_MS: ()=>SCRCPY_VIDEO_STREAM_TIMEOUT_MS,
+    SCRCPY_ADB_CONNECT_TIMEOUT_MS: ()=>SCRCPY_ADB_CONNECT_TIMEOUT_MS,
     SCRCPY_START_TIMEOUT_MS: ()=>SCRCPY_START_TIMEOUT_MS,
     PLAYGROUND_SERVER_PORT: ()=>PLAYGROUND_SERVER_PORT,
     DEFAULT_WDA_PORT: ()=>DEFAULT_WDA_PORT,
@@ -60,10 +61,11 @@ var constants_NodeType = /*#__PURE__*/ function(NodeType) {
 }({});
 const PLAYGROUND_SERVER_PORT = 5800;
 const SCRCPY_SERVER_PORT = 5700;
+const SCRCPY_ADB_CONNECT_TIMEOUT_MS = 10000;
 const SCRCPY_PUSH_TIMEOUT_MS = 10000;
 const SCRCPY_START_TIMEOUT_MS = 15000;
 const SCRCPY_VIDEO_STREAM_TIMEOUT_MS = 15000;
-const SCRCPY_PREVIEW_METADATA_TIMEOUT_MS = SCRCPY_PUSH_TIMEOUT_MS + SCRCPY_START_TIMEOUT_MS + SCRCPY_VIDEO_STREAM_TIMEOUT_MS + 5000;
+const SCRCPY_PREVIEW_METADATA_TIMEOUT_MS = SCRCPY_ADB_CONNECT_TIMEOUT_MS + SCRCPY_PUSH_TIMEOUT_MS + SCRCPY_START_TIMEOUT_MS + SCRCPY_VIDEO_STREAM_TIMEOUT_MS + 5000;
 const WEBDRIVER_ELEMENT_ID_KEY = 'element-6066-11e4-a52e-4f735466cecf';
 const DEFAULT_WDA_PORT = 8100;
 const DEFAULT_WAIT_FOR_NAVIGATION_TIMEOUT = 5000;
@@ -78,6 +80,7 @@ exports.DEFAULT_WDA_PORT = __webpack_exports__.DEFAULT_WDA_PORT;
 exports.NodeType = __webpack_exports__.NodeType;
 exports.PLAYGROUND_SERVER_PORT = __webpack_exports__.PLAYGROUND_SERVER_PORT;
 exports.PLAYWRIGHT_EXAMPLE_CODE = __webpack_exports__.PLAYWRIGHT_EXAMPLE_CODE;
+exports.SCRCPY_ADB_CONNECT_TIMEOUT_MS = __webpack_exports__.SCRCPY_ADB_CONNECT_TIMEOUT_MS;
 exports.SCRCPY_PREVIEW_METADATA_TIMEOUT_MS = __webpack_exports__.SCRCPY_PREVIEW_METADATA_TIMEOUT_MS;
 exports.SCRCPY_PUSH_TIMEOUT_MS = __webpack_exports__.SCRCPY_PUSH_TIMEOUT_MS;
 exports.SCRCPY_SERVER_PORT = __webpack_exports__.SCRCPY_SERVER_PORT;
@@ -97,6 +100,7 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "NodeType",
     "PLAYGROUND_SERVER_PORT",
     "PLAYWRIGHT_EXAMPLE_CODE",
+    "SCRCPY_ADB_CONNECT_TIMEOUT_MS",
     "SCRCPY_PREVIEW_METADATA_TIMEOUT_MS",
     "SCRCPY_PUSH_TIMEOUT_MS",
     "SCRCPY_SERVER_PORT",

package/dist/lib/key-alias-utils.js

@@ -0,0 +1,62 @@
+"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__, {
+    camelToKebab: ()=>camelToKebab,
+    getKeyAliases: ()=>getKeyAliases,
+    isRecord: ()=>isRecord,
+    kebabToCamel: ()=>kebabToCamel
+});
+function kebabToCamel(str) {
+    return str.replace(/-([a-z])/g, (_, letter)=>letter.toUpperCase());
+}
+function camelToKebab(str) {
+    return str.replace(/[A-Z]/g, (letter)=>`-${letter.toLowerCase()}`).replace(/^-/, '');
+}
+function getKeyAliases(key) {
+    return [
+        ...new Set([
+            key,
+            kebabToCamel(key),
+            camelToKebab(key)
+        ])
+    ];
+}
+function isRecord(value) {
+    return 'object' == typeof value && null !== value && !Array.isArray(value);
+}
+exports.camelToKebab = __webpack_exports__.camelToKebab;
+exports.getKeyAliases = __webpack_exports__.getKeyAliases;
+exports.isRecord = __webpack_exports__.isRecord;
+exports.kebabToCamel = __webpack_exports__.kebabToCamel;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "camelToKebab",
+    "getKeyAliases",
+    "isRecord",
+    "kebabToCamel"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

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

@@ -28,6 +28,8 @@ __webpack_require__.d(__webpack_exports__, {
 });
 const img_namespaceObject = require("@midscene/shared/img");
 const logger_namespaceObject = require("@midscene/shared/logger");
+const external_key_alias_utils_js_namespaceObject = require("../key-alias-utils.js");
+const external_init_arg_utils_js_namespaceObject = require("./init-arg-utils.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, {
@@ -41,6 +43,47 @@ function _define_property(obj, key, value) {
 }
 const debug = (0, logger_namespaceObject.getDebug)('mcp:base-tools');
 class BaseMidsceneTools {
+    getInitArgKeys() {
+        return this.initArgSpec ? Object.keys(this.initArgSpec.shape) : [];
+    }
+    extractAgentInitParam(args) {
+        if (!this.initArgSpec) return;
+        const extracted = (0, external_init_arg_utils_js_namespaceObject.extractNamespacedArgs)(args, this.initArgSpec.namespace, this.getInitArgKeys());
+        if (this.initArgSpec.adapt) return this.initArgSpec.adapt(extracted);
+        return extracted;
+    }
+    sanitizeToolArgs(args) {
+        if (!this.initArgSpec) return args;
+        return (0, external_init_arg_utils_js_namespaceObject.sanitizeNamespacedArgs)(args, this.initArgSpec.namespace, this.getInitArgKeys());
+    }
+    getAgentInitArgSchema() {
+        if (!this.initArgSpec) return {};
+        return (0, external_init_arg_utils_js_namespaceObject.createNamespacedInitArgSchema)(this.initArgSpec.namespace, this.initArgSpec.shape);
+    }
+    getAgentInitArgCliMetadata() {
+        if (!this.initArgSpec?.cli) return;
+        const options = Object.fromEntries(this.getInitArgKeys().map((key)=>{
+            const canonicalKey = `${this.initArgSpec.namespace}.${key}`;
+            const preferredName = this.initArgSpec.cli?.preferredNames?.[key] ?? (this.initArgSpec.cli?.preferBareKeys ? (0, external_key_alias_utils_js_namespaceObject.camelToKebab)(key) : canonicalKey);
+            const acceptedNames = new Set([
+                preferredName,
+                ...this.initArgSpec.cli?.preferBareKeys ? (0, external_key_alias_utils_js_namespaceObject.getKeyAliases)(key) : (0, external_key_alias_utils_js_namespaceObject.getKeyAliases)(canonicalKey)
+            ]);
+            acceptedNames.delete(preferredName);
+            return [
+                canonicalKey,
+                {
+                    preferredName,
+                    aliases: [
+                        ...acceptedNames
+                    ]
+                }
+            ];
+        }));
+        return {
+            options
+        };
+    }
     preparePlatformTools() {
         return [];
     }
@@ -58,8 +101,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, ()=>this.ensureAgent());
-        const commonTools = (0, external_tool_generator_js_namespaceObject.generateCommonTools)(()=>this.ensureAgent());
+        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());
         this.toolDefinitions.push(...actionTools, ...commonTools);
         debug('Total tools prepared:', this.toolDefinitions.length);
     }

package/dist/lib/mcp/index.js

@@ -12,6 +12,9 @@ var __webpack_modules__ = {
     "./error-formatter" (module) {
         module.exports = require("./error-formatter.js");
     },
+    "./init-arg-utils" (module) {
+        module.exports = require("./init-arg-utils.js");
+    },
     "./inject-report-html-plugin" (module) {
         module.exports = require("./inject-report-html-plugin.js");
     },
@@ -76,29 +79,33 @@ 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 _error_formatter__rspack_import_2 = __webpack_require__("./error-formatter");
+    var _init_arg_utils__rspack_import_2 = __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];
+    __webpack_require__.d(__webpack_exports__, __rspack_reexport);
+    var _error_formatter__rspack_import_3 = __webpack_require__("./error-formatter");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _error_formatter__rspack_import_2)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_error_formatter__rspack_import_2[__rspack_import_key];
+    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];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _tool_generator__rspack_import_3 = __webpack_require__("./tool-generator");
+    var _tool_generator__rspack_import_4 = __webpack_require__("./tool-generator");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _tool_generator__rspack_import_3)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_tool_generator__rspack_import_3[__rspack_import_key];
+    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];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _types__rspack_import_4 = __webpack_require__("./types");
+    var _types__rspack_import_5 = __webpack_require__("./types");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _types__rspack_import_4)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_types__rspack_import_4[__rspack_import_key];
+    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];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _inject_report_html_plugin__rspack_import_5 = __webpack_require__("./inject-report-html-plugin");
+    var _inject_report_html_plugin__rspack_import_6 = __webpack_require__("./inject-report-html-plugin");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _inject_report_html_plugin__rspack_import_5)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_inject_report_html_plugin__rspack_import_5[__rspack_import_key];
+    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];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _launcher_helper__rspack_import_6 = __webpack_require__("./launcher-helper");
+    var _launcher_helper__rspack_import_7 = __webpack_require__("./launcher-helper");
     var __rspack_reexport = {};
-    for(const __rspack_import_key in _launcher_helper__rspack_import_6)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_launcher_helper__rspack_import_6[__rspack_import_key];
+    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];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _chrome_path__rspack_import_7 = __webpack_require__("./chrome-path");
+    var _chrome_path__rspack_import_8 = __webpack_require__("./chrome-path");
     var __rspack_reexport = {};
-    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];
+    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];
     __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/init-arg-utils.js

@@ -0,0 +1,78 @@
+"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__, {
+    createNamespacedInitArgSchema: ()=>createNamespacedInitArgSchema,
+    extractNamespacedArgs: ()=>extractNamespacedArgs,
+    sanitizeNamespacedArgs: ()=>sanitizeNamespacedArgs
+});
+const external_key_alias_utils_js_namespaceObject = require("../key-alias-utils.js");
+function readAliasedValue(args, key) {
+    for (const alias of (0, external_key_alias_utils_js_namespaceObject.getKeyAliases)(key))if (alias in args) return args[alias];
+}
+function readNamespacedArg(args, namespace, key) {
+    const namespacedArgs = readAliasedValue(args, namespace);
+    if ((0, external_key_alias_utils_js_namespaceObject.isRecord)(namespacedArgs)) {
+        const nestedValue = readAliasedValue(namespacedArgs, key);
+        if (void 0 !== nestedValue) return nestedValue;
+    }
+    const dottedValue = readAliasedValue(args, `${namespace}.${key}`);
+    if (void 0 !== dottedValue) return dottedValue;
+    const directValue = readAliasedValue(args, key);
+    if (void 0 !== directValue) return directValue;
+}
+function extractNamespacedArgs(args, namespace, keys) {
+    const extracted = {};
+    for (const key of keys){
+        const value = readNamespacedArg(args, namespace, key);
+        if (void 0 !== value) extracted[key] = value;
+    }
+    return Object.keys(extracted).length > 0 ? extracted : void 0;
+}
+function sanitizeNamespacedArgs(args, namespace, keys) {
+    const excludedKeys = new Set((0, external_key_alias_utils_js_namespaceObject.getKeyAliases)(namespace));
+    for (const key of keys){
+        for (const alias of (0, external_key_alias_utils_js_namespaceObject.getKeyAliases)(key))excludedKeys.add(alias);
+        for (const alias of (0, external_key_alias_utils_js_namespaceObject.getKeyAliases)(`${namespace}.${key}`))excludedKeys.add(alias);
+    }
+    return Object.fromEntries(Object.entries(args).filter(([key])=>!excludedKeys.has(key)));
+}
+function createNamespacedInitArgSchema(namespace, shape) {
+    return Object.fromEntries(Object.entries(shape).map(([key, value])=>[
+            `${namespace}.${key}`,
+            value
+        ]));
+}
+exports.createNamespacedInitArgSchema = __webpack_exports__.createNamespacedInitArgSchema;
+exports.extractNamespacedArgs = __webpack_exports__.extractNamespacedArgs;
+exports.sanitizeNamespacedArgs = __webpack_exports__.sanitizeNamespacedArgs;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "createNamespacedInitArgSchema",
+    "extractNamespacedArgs",
+    "sanitizeNamespacedArgs"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/lib/mcp/tool-generator.js

@@ -306,17 +306,30 @@ async function captureFailureResult(agent, actionName, errorMessage) {
         };
     }
 }
-function generateToolsFromActionSpace(actionSpace, getAgent) {
+function mergeToolCliMetadata(base, extra) {
+    const options = {
+        ...base?.options ?? {},
+        ...extra?.options ?? {}
+    };
+    return Object.keys(options).length > 0 ? {
+        options
+    } : void 0;
+}
+function generateToolsFromActionSpace(actionSpace, getAgent, sanitizeArgs = (args)=>args, initArgSchema = {}, initArgCliMetadata) {
     return actionSpace.map((action)=>{
-        const schema = extractActionSchema(action.paramSchema);
+        const schema = {
+            ...extractActionSchema(action.paramSchema),
+            ...initArgSchema
+        };
         return {
             name: action.name,
             description: describeActionForMCP(action),
             schema,
+            cli: initArgCliMetadata,
             handler: async (args)=>{
                 try {
-                    const agent = await getAgent();
-                    const normalizedArgs = normalizeActionArgs(args, action.paramSchema);
+                    const agent = await getAgent(args);
+                    const normalizedArgs = normalizeActionArgs(sanitizeArgs(args), action.paramSchema);
                     let actionResult;
                     try {
                         actionResult = await executeAction(agent, action.name, normalizedArgs);
@@ -335,15 +348,18 @@ function generateToolsFromActionSpace(actionSpace, getAgent) {
         };
     });
 }
-function generateCommonTools(getAgent) {
+function generateCommonTools(getAgent, initArgSchema = {}, initArgCliMetadata) {
     return [
         {
             name: 'take_screenshot',
             description: 'Capture screenshot of current page/screen',
-            schema: {},
-            handler: async ()=>{
+            schema: {
+                ...initArgSchema
+            },
+            cli: initArgCliMetadata,
+            handler: async (args = {})=>{
                 try {
-                    const agent = await getAgent();
+                    const agent = await getAgent(args);
                     const screenshot = await agent.page?.screenshotBase64();
                     if (!screenshot) return createErrorResult('Screenshot not available');
                     const { mimeType, body } = (0, img_namespaceObject.parseBase64)(screenshot);
@@ -367,12 +383,14 @@ function generateCommonTools(getAgent) {
             name: 'act',
             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: external_zod_namespaceObject.z.string().describe('Natural language description of the action to perform, e.g. "press Command+Space, type Safari, press Enter"')
+                prompt: external_zod_namespaceObject.z.string().describe('Natural language description of the action to perform, e.g. "press Command+Space, type Safari, press Enter"'),
+                ...initArgSchema
             },
-            handler: async (args)=>{
+            cli: mergeToolCliMetadata(void 0, initArgCliMetadata),
+            handler: async (args = {})=>{
                 const prompt = args.prompt;
                 try {
-                    const agent = await getAgent();
+                    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

package/dist/types/cli/cli-args.d.ts

@@ -0,0 +1,8 @@
+import type { ToolCliOption, ToolDefinition } from '../mcp/types';
+export declare function parseValue(raw: string): unknown;
+export declare function parseCliArgs(args: string[]): Record<string, unknown>;
+export declare function getCliOptionDisplay(key: string, cliOption?: ToolCliOption): {
+    label: string;
+    aliases: string[];
+};
+export declare function formatCliValidationError(scriptName: string, commandName: string, def: ToolDefinition, rawArgs: Record<string, unknown>): string | undefined;

package/dist/types/cli/cli-error.d.ts

@@ -0,0 +1,5 @@
+export declare class CLIError extends Error {
+    exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+export declare function reportCLIError(error: unknown, log?: (message?: unknown, ...optionalParams: unknown[]) => void): number;

package/dist/types/cli/cli-runner.d.ts

@@ -12,11 +12,8 @@ export interface CLIRunnerOptions {
     version?: string;
     extraCommands?: CLIExtraCommand[];
 }
-export declare class CLIError extends Error {
-    exitCode: number;
-    constructor(message: string, exitCode?: number);
-}
-export declare function parseValue(raw: string): unknown;
-export declare function parseCliArgs(args: string[]): Record<string, unknown>;
+export { parseCliArgs, parseValue } from './cli-args';
+export { CLIError, reportCLIError } from './cli-error';
 export declare function removePrefix(name: string, prefix?: string): string;
-export declare function runToolsCLI(tools: BaseMidsceneTools, scriptName: string, options?: CLIRunnerOptions): Promise<void>;
+type AnyMidsceneTools = BaseMidsceneTools<any, any>;
+export declare function runToolsCLI(tools: AnyMidsceneTools, scriptName: string, options?: CLIRunnerOptions): Promise<void>;

package/dist/types/cli/index.d.ts

@@ -1,2 +1,4 @@
-export { runToolsCLI, CLIError, parseValue, parseCliArgs, removePrefix, } from './cli-runner';
+export { CLIError, reportCLIError } from './cli-error';
+export { parseCliArgs, parseValue } from './cli-args';
+export { runToolsCLI, removePrefix } from './cli-runner';
 export type { CLIRunnerOptions, CLIExtraCommand } from './cli-runner';

package/dist/types/constants/index.d.ts

@@ -13,6 +13,7 @@ export declare enum NodeType {
 }
 export declare const PLAYGROUND_SERVER_PORT = 5800;
 export declare const SCRCPY_SERVER_PORT = 5700;
+export declare const SCRCPY_ADB_CONNECT_TIMEOUT_MS = 10000;
 export declare const SCRCPY_PUSH_TIMEOUT_MS = 10000;
 export declare const SCRCPY_START_TIMEOUT_MS = 15000;
 export declare const SCRCPY_VIDEO_STREAM_TIMEOUT_MS = 15000;

package/dist/types/key-alias-utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Internal-only helpers for CLI/MCP argument key aliasing.
+ * Not re-exported from the package entry point — keep consumers within
+ * `cli/` and `mcp/`.
+ */
+export declare function kebabToCamel(str: string): string;
+export declare function camelToKebab(str: string): string;
+export declare function getKeyAliases(key: string): string[];
+export declare function isRecord(value: unknown): value is Record<string, unknown>;