@midscene/shared 1.9.5 → 1.9.6-beta-20260612050456.0

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.5";
+const getCurrentVersion = ()=>"1.9.6-beta-20260612050456.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/agent-behavior-init-args.mjs

@@ -0,0 +1,42 @@
+import { z } from "zod";
+const agentBehaviorInitArgShape = {
+    aiActContext: z.string().optional().describe('Background knowledge passed to aiAct. Default: no extra context.'),
+    aiActionContext: z.string().optional().describe('Deprecated alias for aiActContext. Default: no extra context.'),
+    replanningCycleLimit: z.number().int().nonnegative().optional().describe('Maximum number of replanning cycles for aiAct. Default: model adapter default.'),
+    waitAfterAction: z.number().nonnegative().optional().describe('Wait time in milliseconds after each action execution. Default: 300ms.'),
+    screenshotShrinkFactor: z.number().min(1).optional().describe('Screenshot shrink factor before sending images to AI. Default: 1; high values may reduce recognition quality, especially on mobile.')
+};
+function extractAgentBehaviorInitArgs(extracted) {
+    if (!extracted) return;
+    const agentOptions = {
+        ...'string' == typeof extracted.aiActContext ? {
+            aiActContext: extracted.aiActContext
+        } : {},
+        ...'string' == typeof extracted.aiActionContext ? {
+            aiActionContext: extracted.aiActionContext
+        } : {},
+        ...'number' == typeof extracted.replanningCycleLimit ? {
+            replanningCycleLimit: extracted.replanningCycleLimit
+        } : {},
+        ...'number' == typeof extracted.waitAfterAction ? {
+            waitAfterAction: extracted.waitAfterAction
+        } : {},
+        ...'number' == typeof extracted.screenshotShrinkFactor ? {
+            screenshotShrinkFactor: extracted.screenshotShrinkFactor
+        } : {}
+    };
+    return Object.keys(agentOptions).length > 0 ? agentOptions : void 0;
+}
+function stableJsonValue(value) {
+    if (Array.isArray(value)) return value.map(stableJsonValue);
+    if (value && 'object' == typeof value) return Object.fromEntries(Object.entries(value).sort(([left], [right])=>left.localeCompare(right)).map(([key, nestedValue])=>[
+            key,
+            stableJsonValue(nestedValue)
+        ]));
+    return value;
+}
+function getAgentInitArgsSignature(initArgs) {
+    if (!initArgs || 0 === Object.keys(initArgs).length) return;
+    return JSON.stringify(stableJsonValue(initArgs));
+}
+export { agentBehaviorInitArgShape, extractAgentBehaviorInitArgs, getAgentInitArgsSignature };

package/dist/es/mcp/index.mjs

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

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.5";
+const getCurrentVersion = ()=>"1.9.6-beta-20260612050456.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/agent-behavior-init-args.js

@@ -0,0 +1,82 @@
+"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__, {
+    extractAgentBehaviorInitArgs: ()=>extractAgentBehaviorInitArgs,
+    agentBehaviorInitArgShape: ()=>agentBehaviorInitArgShape,
+    getAgentInitArgsSignature: ()=>getAgentInitArgsSignature
+});
+const external_zod_namespaceObject = require("zod");
+const agentBehaviorInitArgShape = {
+    aiActContext: external_zod_namespaceObject.z.string().optional().describe('Background knowledge passed to aiAct. Default: no extra context.'),
+    aiActionContext: external_zod_namespaceObject.z.string().optional().describe('Deprecated alias for aiActContext. Default: no extra context.'),
+    replanningCycleLimit: external_zod_namespaceObject.z.number().int().nonnegative().optional().describe('Maximum number of replanning cycles for aiAct. Default: model adapter default.'),
+    waitAfterAction: external_zod_namespaceObject.z.number().nonnegative().optional().describe('Wait time in milliseconds after each action execution. Default: 300ms.'),
+    screenshotShrinkFactor: external_zod_namespaceObject.z.number().min(1).optional().describe('Screenshot shrink factor before sending images to AI. Default: 1; high values may reduce recognition quality, especially on mobile.')
+};
+function extractAgentBehaviorInitArgs(extracted) {
+    if (!extracted) return;
+    const agentOptions = {
+        ...'string' == typeof extracted.aiActContext ? {
+            aiActContext: extracted.aiActContext
+        } : {},
+        ...'string' == typeof extracted.aiActionContext ? {
+            aiActionContext: extracted.aiActionContext
+        } : {},
+        ...'number' == typeof extracted.replanningCycleLimit ? {
+            replanningCycleLimit: extracted.replanningCycleLimit
+        } : {},
+        ...'number' == typeof extracted.waitAfterAction ? {
+            waitAfterAction: extracted.waitAfterAction
+        } : {},
+        ...'number' == typeof extracted.screenshotShrinkFactor ? {
+            screenshotShrinkFactor: extracted.screenshotShrinkFactor
+        } : {}
+    };
+    return Object.keys(agentOptions).length > 0 ? agentOptions : void 0;
+}
+function stableJsonValue(value) {
+    if (Array.isArray(value)) return value.map(stableJsonValue);
+    if (value && 'object' == typeof value) return Object.fromEntries(Object.entries(value).sort(([left], [right])=>left.localeCompare(right)).map(([key, nestedValue])=>[
+            key,
+            stableJsonValue(nestedValue)
+        ]));
+    return value;
+}
+function getAgentInitArgsSignature(initArgs) {
+    if (!initArgs || 0 === Object.keys(initArgs).length) return;
+    return JSON.stringify(stableJsonValue(initArgs));
+}
+exports.agentBehaviorInitArgShape = __webpack_exports__.agentBehaviorInitArgShape;
+exports.extractAgentBehaviorInitArgs = __webpack_exports__.extractAgentBehaviorInitArgs;
+exports.getAgentInitArgsSignature = __webpack_exports__.getAgentInitArgsSignature;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "agentBehaviorInitArgShape",
+    "extractAgentBehaviorInitArgs",
+    "getAgentInitArgsSignature"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/lib/mcp/index.js

@@ -1,5 +1,8 @@
 "use strict";
 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");
     },
@@ -86,33 +89,37 @@ var __webpack_exports__ = {};
     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 _agent_behavior_init_args__rspack_import_3 = __webpack_require__("./agent-behavior-init-args");
+    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];
+    __webpack_require__.d(__webpack_exports__, __rspack_reexport);
+    var _init_arg_utils__rspack_import_4 = __webpack_require__("./init-arg-utils");
     var __rspack_reexport = {};
-    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];
+    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];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _error_formatter__rspack_import_4 = __webpack_require__("./error-formatter");
+    var _error_formatter__rspack_import_5 = __webpack_require__("./error-formatter");
     var __rspack_reexport = {};
-    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];
+    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];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _tool_generator__rspack_import_5 = __webpack_require__("./tool-generator");
+    var _tool_generator__rspack_import_6 = __webpack_require__("./tool-generator");
     var __rspack_reexport = {};
-    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];
+    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];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _types__rspack_import_6 = __webpack_require__("./types");
+    var _types__rspack_import_7 = __webpack_require__("./types");
     var __rspack_reexport = {};
-    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];
+    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];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _inject_report_html_plugin__rspack_import_7 = __webpack_require__("./inject-report-html-plugin");
+    var _inject_report_html_plugin__rspack_import_8 = __webpack_require__("./inject-report-html-plugin");
     var __rspack_reexport = {};
-    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];
+    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];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _launcher_helper__rspack_import_8 = __webpack_require__("./launcher-helper");
+    var _launcher_helper__rspack_import_9 = __webpack_require__("./launcher-helper");
     var __rspack_reexport = {};
-    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];
+    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];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
-    var _chrome_path__rspack_import_9 = __webpack_require__("./chrome-path");
+    var _chrome_path__rspack_import_10 = __webpack_require__("./chrome-path");
     var __rspack_reexport = {};
-    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];
+    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];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
 })();
 for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];

package/dist/types/mcp/agent-behavior-init-args.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export interface AgentBehaviorInitArgs {
+    aiActContext?: string;
+    aiActionContext?: string;
+    replanningCycleLimit?: number;
+    waitAfterAction?: number;
+    screenshotShrinkFactor?: number;
+}
+export declare const agentBehaviorInitArgShape: {
+    aiActContext: z.ZodOptional<z.ZodString>;
+    aiActionContext: z.ZodOptional<z.ZodString>;
+    replanningCycleLimit: z.ZodOptional<z.ZodNumber>;
+    waitAfterAction: z.ZodOptional<z.ZodNumber>;
+    screenshotShrinkFactor: z.ZodOptional<z.ZodNumber>;
+};
+export declare function extractAgentBehaviorInitArgs(extracted: Partial<AgentBehaviorInitArgs> | undefined): AgentBehaviorInitArgs | undefined;
+export declare function getAgentInitArgsSignature(initArgs: object | undefined): string | undefined;

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

@@ -1,6 +1,7 @@
 export * from './base-server';
 export * from './base-tools';
 export * from './tool-defaults';
+export * from './agent-behavior-init-args';
 export * from './init-arg-utils';
 export * from './error-formatter';
 export * from './tool-generator';

package/package.json

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

package/src/mcp/agent-behavior-init-args.ts

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+
+export interface AgentBehaviorInitArgs {
+  aiActContext?: string;
+  aiActionContext?: string;
+  replanningCycleLimit?: number;
+  waitAfterAction?: number;
+  screenshotShrinkFactor?: number;
+}
+
+export const agentBehaviorInitArgShape = {
+  aiActContext: z
+    .string()
+    .optional()
+    .describe(
+      'Background knowledge passed to aiAct. Default: no extra context.',
+    ),
+  aiActionContext: z
+    .string()
+    .optional()
+    .describe('Deprecated alias for aiActContext. Default: no extra context.'),
+  replanningCycleLimit: z
+    .number()
+    .int()
+    .nonnegative()
+    .optional()
+    .describe(
+      'Maximum number of replanning cycles for aiAct. Default: model adapter default.',
+    ),
+  waitAfterAction: z
+    .number()
+    .nonnegative()
+    .optional()
+    .describe(
+      'Wait time in milliseconds after each action execution. Default: 300ms.',
+    ),
+  screenshotShrinkFactor: z
+    .number()
+    .min(1)
+    .optional()
+    .describe(
+      'Screenshot shrink factor before sending images to AI. Default: 1; high values may reduce recognition quality, especially on mobile.',
+    ),
+} satisfies Record<keyof AgentBehaviorInitArgs, z.ZodTypeAny>;
+
+export function extractAgentBehaviorInitArgs(
+  extracted: Partial<AgentBehaviorInitArgs> | undefined,
+): AgentBehaviorInitArgs | undefined {
+  if (!extracted) {
+    return undefined;
+  }
+
+  const agentOptions: AgentBehaviorInitArgs = {
+    ...(typeof extracted.aiActContext === 'string'
+      ? { aiActContext: extracted.aiActContext }
+      : {}),
+    ...(typeof extracted.aiActionContext === 'string'
+      ? { aiActionContext: extracted.aiActionContext }
+      : {}),
+    ...(typeof extracted.replanningCycleLimit === 'number'
+      ? { replanningCycleLimit: extracted.replanningCycleLimit }
+      : {}),
+    ...(typeof extracted.waitAfterAction === 'number'
+      ? { waitAfterAction: extracted.waitAfterAction }
+      : {}),
+    ...(typeof extracted.screenshotShrinkFactor === 'number'
+      ? { screenshotShrinkFactor: extracted.screenshotShrinkFactor }
+      : {}),
+  };
+
+  return Object.keys(agentOptions).length > 0 ? agentOptions : undefined;
+}
+
+function stableJsonValue(value: unknown): unknown {
+  if (Array.isArray(value)) {
+    return value.map(stableJsonValue);
+  }
+
+  if (value && typeof value === 'object') {
+    return Object.fromEntries(
+      Object.entries(value as Record<string, unknown>)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([key, nestedValue]) => [key, stableJsonValue(nestedValue)]),
+    );
+  }
+
+  return value;
+}
+
+export function getAgentInitArgsSignature(
+  initArgs: object | undefined,
+): string | undefined {
+  if (!initArgs || Object.keys(initArgs).length === 0) {
+    return undefined;
+  }
+
+  return JSON.stringify(stableJsonValue(initArgs));
+}

package/src/mcp/index.ts

@@ -1,6 +1,7 @@
 export * from './base-server';
 export * from './base-tools';
 export * from './tool-defaults';
+export * from './agent-behavior-init-args';
 export * from './init-arg-utils';
 export * from './error-formatter';
 export * from './tool-generator';