@midscene/shared 1.12.6 → 1.12.7-beta-20260911033547.0

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

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { getKeyAliases } from "../key-alias-utils.mjs";
+import { getZodTypeName } from "../zod-schema-utils.mjs";
 import { CLIError } from "./cli-error.mjs";
 function parseValue(raw) {
     if (raw.startsWith('{') || raw.startsWith('[')) try {
@@ -8,20 +9,30 @@ function parseValue(raw) {
     if (/^-?\d+(\.\d+)?$/.test(raw)) return Number(raw);
     return raw;
 }
-function walkCliArgs(args, setArgValue) {
+function walkCliArgs(args, setArgValue, def) {
     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) setArgValue(body.slice(0, eqIdx), parseValue(body.slice(eqIdx + 1)));
-        else if (args[i + 1] && !args[i + 1].startsWith('--')) {
+        if (eqIdx >= 0) {
+            const key = body.slice(0, eqIdx);
+            setArgValue(key, parseValueForCliField(body.slice(eqIdx + 1), key, def));
+        } else if (args[i + 1] && !args[i + 1].startsWith('--')) {
             i++;
-            setArgValue(body, parseValue(args[i]));
+            setArgValue(body, parseValueForCliField(args[i], body, def));
         } else setArgValue(body, true);
     }
 }
-function parseCliArgs(args) {
+function findCliSchemaField(def, cliKey) {
+    for (const [schemaKey, field] of Object.entries(def.schema))if (getAcceptedCliOptionNames(schemaKey, def.cli?.options?.[schemaKey]).includes(cliKey)) return field;
+}
+function parseValueForCliField(raw, cliKey, def) {
+    const field = def ? findCliSchemaField(def, cliKey) : void 0;
+    if (field && 'string' === getZodTypeName(field)) return raw;
+    return parseValue(raw);
+}
+function parseCliArgs(args, def) {
     const result = {};
     walkCliArgs(args, (key, value)=>{
         const existing = result[key];
@@ -38,7 +49,7 @@ function parseCliArgs(args) {
             existing,
             value
         ];
-    });
+    }, def);
     return result;
 }
 function formatCliOptionName(name) {

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

@@ -155,7 +155,7 @@ async function runToolsCLI(tools, scriptName, options) {
     }
     const parsedArgs = {
         ...positionalArgs,
-        ...parseCliArgs(restArgs.slice(optionStartIndex))
+        ...parseCliArgs(restArgs.slice(optionStartIndex), match.def)
     };
     if (true === parsedArgs.help) {
         debug('showing command help for: %s', match.name);

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.12.6";
+const getCurrentVersion = ()=>"1.12.7-beta-20260911033547.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/lib/cli/cli-args.js

@@ -32,6 +32,7 @@ __webpack_require__.d(__webpack_exports__, {
 });
 const external_zod_namespaceObject = require("zod");
 const external_key_alias_utils_js_namespaceObject = require("../key-alias-utils.js");
+const external_zod_schema_utils_js_namespaceObject = require("../zod-schema-utils.js");
 const external_cli_error_js_namespaceObject = require("./cli-error.js");
 function parseValue(raw) {
     if (raw.startsWith('{') || raw.startsWith('[')) try {
@@ -40,20 +41,30 @@ function parseValue(raw) {
     if (/^-?\d+(\.\d+)?$/.test(raw)) return Number(raw);
     return raw;
 }
-function walkCliArgs(args, setArgValue) {
+function walkCliArgs(args, setArgValue, def) {
     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) setArgValue(body.slice(0, eqIdx), parseValue(body.slice(eqIdx + 1)));
-        else if (args[i + 1] && !args[i + 1].startsWith('--')) {
+        if (eqIdx >= 0) {
+            const key = body.slice(0, eqIdx);
+            setArgValue(key, parseValueForCliField(body.slice(eqIdx + 1), key, def));
+        } else if (args[i + 1] && !args[i + 1].startsWith('--')) {
             i++;
-            setArgValue(body, parseValue(args[i]));
+            setArgValue(body, parseValueForCliField(args[i], body, def));
         } else setArgValue(body, true);
     }
 }
-function parseCliArgs(args) {
+function findCliSchemaField(def, cliKey) {
+    for (const [schemaKey, field] of Object.entries(def.schema))if (getAcceptedCliOptionNames(schemaKey, def.cli?.options?.[schemaKey]).includes(cliKey)) return field;
+}
+function parseValueForCliField(raw, cliKey, def) {
+    const field = def ? findCliSchemaField(def, cliKey) : void 0;
+    if (field && 'string' === (0, external_zod_schema_utils_js_namespaceObject.getZodTypeName)(field)) return raw;
+    return parseValue(raw);
+}
+function parseCliArgs(args, def) {
     const result = {};
     walkCliArgs(args, (key, value)=>{
         const existing = result[key];
@@ -70,7 +81,7 @@ function parseCliArgs(args) {
             existing,
             value
         ];
-    });
+    }, def);
     return result;
 }
 function formatCliOptionName(name) {

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

@@ -198,7 +198,7 @@ async function runToolsCLI(tools, scriptName, options) {
     }
     const parsedArgs = {
         ...positionalArgs,
-        ...(0, external_cli_args_js_namespaceObject.parseCliArgs)(restArgs.slice(optionStartIndex))
+        ...(0, external_cli_args_js_namespaceObject.parseCliArgs)(restArgs.slice(optionStartIndex), match.def)
     };
     if (true === parsedArgs.help) {
         debug('showing command help for: %s', match.name);

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.12.6";
+const getCurrentVersion = ()=>"1.12.7-beta-20260911033547.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/types/cli/cli-args.d.ts

@@ -1,6 +1,6 @@
 import type { ToolCliOption, ToolDefinition } from '../agent-tools/types';
 export declare function parseValue(raw: string): unknown;
-export declare function parseCliArgs(args: string[]): Record<string, unknown>;
+export declare function parseCliArgs(args: string[], def?: ToolDefinition): Record<string, unknown>;
 export declare function getCliOptionDisplay(key: string, cliOption?: ToolCliOption): {
     label: string;
     aliases: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/shared",
-  "version": "1.12.6",
+  "version": "1.12.7-beta-20260911033547.0",
   "repository": "https://github.com/web-infra-dev/midscene",
   "homepage": "https://midscenejs.com/",
   "types": "./dist/types/index.d.ts",

package/src/cli/cli-args.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import type { ToolCliOption, ToolDefinition } from '../agent-tools/types';
 import { getKeyAliases } from '../key-alias-utils';
+import { getZodTypeName } from '../zod-schema-utils';
 import { CLIError } from './cli-error';
 
 export function parseValue(raw: string): unknown {
@@ -22,6 +23,7 @@ export function parseValue(raw: string): unknown {
 function walkCliArgs(
   args: string[],
   setArgValue: (key: string, value: unknown) => void,
+  def?: ToolDefinition,
 ): void {
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
@@ -31,34 +33,73 @@ function walkCliArgs(
     const eqIdx = body.indexOf('=');
 
     if (eqIdx >= 0) {
-      setArgValue(body.slice(0, eqIdx), parseValue(body.slice(eqIdx + 1)));
+      const key = body.slice(0, eqIdx);
+      setArgValue(key, parseValueForCliField(body.slice(eqIdx + 1), key, def));
     } else if (args[i + 1] && !args[i + 1].startsWith('--')) {
       i++;
-      setArgValue(body, parseValue(args[i]));
+      setArgValue(body, parseValueForCliField(args[i], body, def));
     } else {
       setArgValue(body, true);
     }
   }
 }
 
-export function parseCliArgs(args: string[]): Record<string, unknown> {
+function findCliSchemaField(
+  def: ToolDefinition,
+  cliKey: string,
+): z.ZodTypeAny | undefined {
+  for (const [schemaKey, field] of Object.entries(def.schema)) {
+    if (
+      getAcceptedCliOptionNames(
+        schemaKey,
+        def.cli?.options?.[schemaKey],
+      ).includes(cliKey)
+    ) {
+      return field;
+    }
+  }
+
+  return undefined;
+}
+
+function parseValueForCliField(
+  raw: string,
+  cliKey: string,
+  def?: ToolDefinition,
+): unknown {
+  const field = def ? findCliSchemaField(def, cliKey) : undefined;
+  if (field && getZodTypeName(field) === 'string') {
+    return raw;
+  }
+
+  return parseValue(raw);
+}
+
+export function parseCliArgs(
+  args: string[],
+  def?: ToolDefinition,
+): Record<string, unknown> {
   const result: Record<string, unknown> = {};
 
-  walkCliArgs(args, (key, value) => {
-    const existing = result[key];
-    if (existing === undefined) {
-      result[key] = value;
-      return;
-    }
+  walkCliArgs(
+    args,
+    (key, value) => {
+      const existing = result[key];
+      if (existing === undefined) {
+        result[key] = value;
+        return;
+      }
 
-    if (Array.isArray(existing)) {
-      existing.push(value);
-      result[key] = existing;
-      return;
-    }
+      if (Array.isArray(existing)) {
+        existing.push(value);
+        result[key] = existing;
+        return;
+      }
 
-    result[key] = [existing, value];
-  });
+      result[key] = [existing, value];
+    },
+    def,
+  );
 
   return result;
 }

package/src/cli/cli-runner.ts

@@ -295,7 +295,7 @@ export async function runToolsCLI(
   }
   const parsedArgs = {
     ...positionalArgs,
-    ...parseCliArgs(restArgs.slice(optionStartIndex)),
+    ...parseCliArgs(restArgs.slice(optionStartIndex), match.def),
   };
   if (parsedArgs.help === true) {
     debug('showing command help for: %s', match.name);