@aiscene/shared 8.0.2 → 8.0.4

package/dist/lib/env/utils.js

@@ -27,7 +27,6 @@ __webpack_require__.d(__webpack_exports__, {
     overrideAIConfig: ()=>overrideAIConfig,
     globalModelConfigManager: ()=>globalModelConfigManager,
     getPreferredLanguage: ()=>getPreferredLanguage,
-    getCurrentTime: ()=>getCurrentTime,
     globalConfigManager: ()=>globalConfigManager
 });
 const external_global_config_manager_js_namespaceObject = require("./global-config-manager.js");
@@ -37,14 +36,6 @@ const globalModelConfigManager = new external_model_config_manager_js_namespaceO
 const globalConfigManager = new external_global_config_manager_js_namespaceObject.GlobalConfigManager();
 globalConfigManager.registerModelConfigManager(globalModelConfigManager);
 globalModelConfigManager.registerGlobalConfigManager(globalConfigManager);
-async function getCurrentTime(device, useDeviceTimestamp) {
-    if (useDeviceTimestamp && device?.getTimestamp) try {
-        return await device.getTimestamp();
-    } catch (error) {
-        console.warn(`Failed to get device time, falling back to system time: ${error}`);
-    }
-    return Date.now();
-}
 const getPreferredLanguage = ()=>{
     const prefer = globalConfigManager.getEnvConfigValue(external_types_js_namespaceObject.MIDSCENE_PREFERRED_LANGUAGE);
     if (prefer) return prefer;
@@ -55,13 +46,11 @@ const getPreferredLanguage = ()=>{
 const overrideAIConfig = (newConfig, extendMode = false)=>{
     globalConfigManager.overrideAIConfig(newConfig, extendMode);
 };
-exports.getCurrentTime = __webpack_exports__.getCurrentTime;
 exports.getPreferredLanguage = __webpack_exports__.getPreferredLanguage;
 exports.globalConfigManager = __webpack_exports__.globalConfigManager;
 exports.globalModelConfigManager = __webpack_exports__.globalModelConfigManager;
 exports.overrideAIConfig = __webpack_exports__.overrideAIConfig;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
-    "getCurrentTime",
     "getPreferredLanguage",
     "globalConfigManager",
     "globalModelConfigManager",

package/dist/lib/extractor/index.js

@@ -24,6 +24,7 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
+    generateElementByPoint: ()=>external_dom_util_js_namespaceObject.generateElementByPoint,
     getNodeInfoByXpath: ()=>external_locator_js_namespaceObject.getNodeInfoByXpath,
     getXpathsById: ()=>external_locator_js_namespaceObject.getXpathsById,
     trimAttributes: ()=>external_tree_js_namespaceObject.trimAttributes,
@@ -45,6 +46,7 @@ const external_web_extractor_js_namespaceObject = require("./web-extractor.js");
 const external_locator_js_namespaceObject = require("./locator.js");
 const external_dom_util_js_namespaceObject = require("./dom-util.js");
 exports.descriptionOfTree = __webpack_exports__.descriptionOfTree;
+exports.generateElementByPoint = __webpack_exports__.generateElementByPoint;
 exports.generateElementByRect = __webpack_exports__.generateElementByRect;
 exports.getElementInfoByXpath = __webpack_exports__.getElementInfoByXpath;
 exports.getElementXpath = __webpack_exports__.getElementXpath;
@@ -61,6 +63,7 @@ exports.webExtractNodeTreeAsString = __webpack_exports__.webExtractNodeTreeAsStr
 exports.webExtractTextWithPosition = __webpack_exports__.webExtractTextWithPosition;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "descriptionOfTree",
+    "generateElementByPoint",
     "generateElementByRect",
     "getElementInfoByXpath",
     "getElementXpath",

package/dist/lib/img/index.js

@@ -31,6 +31,7 @@ __webpack_require__.d(__webpack_exports__, {
     resizeImgBase64: ()=>external_transform_js_namespaceObject.resizeImgBase64,
     saveBase64Image: ()=>external_transform_js_namespaceObject.saveBase64Image,
     isValidImageBuffer: ()=>external_info_js_namespaceObject.isValidImageBuffer,
+    validateScreenshotBuffer: ()=>external_info_js_namespaceObject.validateScreenshotBuffer,
     preProcessImageUrl: ()=>external_transform_js_namespaceObject.preProcessImageUrl,
     annotateRects: ()=>external_box_select_js_namespaceObject.annotateRects,
     compositeElementInfoImg: ()=>external_box_select_js_namespaceObject.compositeElementInfoImg,
@@ -65,6 +66,7 @@ exports.resizeAndConvertImgBuffer = __webpack_exports__.resizeAndConvertImgBuffe
 exports.resizeImgBase64 = __webpack_exports__.resizeImgBase64;
 exports.saveBase64Image = __webpack_exports__.saveBase64Image;
 exports.scaleImage = __webpack_exports__.scaleImage;
+exports.validateScreenshotBuffer = __webpack_exports__.validateScreenshotBuffer;
 exports.zoomForGPT4o = __webpack_exports__.zoomForGPT4o;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "annotateRects",
@@ -85,6 +87,7 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "resizeImgBase64",
     "saveBase64Image",
     "scaleImage",
+    "validateScreenshotBuffer",
     "zoomForGPT4o"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {

package/dist/lib/img/info.js

@@ -33,8 +33,10 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    isValidPNGImageBuffer: ()=>isValidPNGImageBuffer,
+    encodedImageInfoOfBuffer: ()=>encodedImageInfoOfBuffer,
     isValidImageBuffer: ()=>isValidImageBuffer,
+    isValidPNGImageBuffer: ()=>isValidPNGImageBuffer,
+    validateScreenshotBuffer: ()=>validateScreenshotBuffer,
     imageInfoOfBase64: ()=>imageInfoOfBase64,
     isValidJPEGImageBuffer: ()=>isValidJPEGImageBuffer
 });
@@ -42,28 +44,63 @@ const external_node_assert_namespaceObject = require("node:assert");
 var external_node_assert_default = /*#__PURE__*/ __webpack_require__.n(external_node_assert_namespaceObject);
 const external_get_photon_js_namespaceObject = require("./get-photon.js");
 var external_get_photon_js_default = /*#__PURE__*/ __webpack_require__.n(external_get_photon_js_namespaceObject);
-async function imageInfoOfBase64(imageBase64) {
-    if (!imageBase64 || 'string' != typeof imageBase64) throw new Error('Invalid image base64: data is empty or not a string');
-    const base64Data = imageBase64.replace(/^data:image\/\w+;base64,/, '');
-    if (!base64Data || 0 === base64Data.length) throw new Error('Invalid image base64: no data after stripping prefix');
-    if (!/^[A-Za-z0-9+/]*={0,2}$/.test(base64Data)) throw new Error('Invalid image base64: contains invalid characters');
-    if (base64Data.length < 4) throw new Error(`Invalid image base64: data too short (${base64Data.length} characters)`);
-    try {
-        const { PhotonImage } = await external_get_photon_js_default()();
-        const result = PhotonImage.new_from_base64(base64Data);
-        const image = result instanceof Promise ? await result : result;
-        const width = image.get_width();
-        const height = image.get_height();
-        image.free();
+const isJpegStartOfFrameMarker = (marker)=>marker >= 0xc0 && marker <= 0xcf && 0xc4 !== marker && 0xc8 !== marker && 0xcc !== marker;
+function jpegInfoFromBuffer(imageBuffer) {
+    let offset = 2;
+    while(offset < imageBuffer.length){
+        if (0xff !== imageBuffer[offset]) {
+            offset += 1;
+            continue;
+        }
+        while(offset < imageBuffer.length && 0xff === imageBuffer[offset])offset += 1;
+        if (offset >= imageBuffer.length) break;
+        const marker = imageBuffer[offset];
+        offset += 1;
+        if (0xd9 === marker || 0xda === marker) break;
+        if (0x01 === marker || 0xd8 === marker || marker >= 0xd0 && marker <= 0xd7) continue;
+        if (offset + 2 > imageBuffer.length) break;
+        const segmentLength = imageBuffer.readUInt16BE(offset);
+        if (segmentLength < 2 || offset + segmentLength > imageBuffer.length) break;
+        if (isJpegStartOfFrameMarker(marker)) {
+            if (segmentLength < 7) break;
+            const height = imageBuffer.readUInt16BE(offset + 3);
+            const width = imageBuffer.readUInt16BE(offset + 5);
+            external_node_assert_default()(width && height, 'Invalid image: cannot get width or height');
+            return {
+                width,
+                height
+            };
+        }
+        offset += segmentLength;
+    }
+    throw new Error('Invalid image: cannot get JPEG width or height');
+}
+function encodedImageInfoOfBuffer(imageBuffer) {
+    if (isValidPNGImageBuffer(imageBuffer)) {
+        const width = imageBuffer.readUInt32BE(16);
+        const height = imageBuffer.readUInt32BE(20);
         external_node_assert_default()(width && height, 'Invalid image: cannot get width or height');
         return {
             width,
             height
         };
-    } catch (error) {
-        if (error instanceof Error && error.message.includes('unreachable')) throw new Error(`Failed to decode image: invalid or corrupted image data. Original error: ${error.message}`);
-        throw error;
     }
+    if (isValidJPEGImageBuffer(imageBuffer)) return jpegInfoFromBuffer(imageBuffer);
+    throw new Error('Invalid image: unsupported format');
+}
+async function imageInfoOfBase64(imageBase64) {
+    const { PhotonImage } = await external_get_photon_js_default()();
+    const base64Data = imageBase64.replace(/^data:image\/\w+;base64,/, '');
+    const result = PhotonImage.new_from_base64(base64Data);
+    const image = result instanceof Promise ? await result : result;
+    const width = image.get_width();
+    const height = image.get_height();
+    image.free();
+    external_node_assert_default()(width && height, 'Invalid image: cannot get width or height');
+    return {
+        width,
+        height
+    };
 }
 function isValidPNGImageBuffer(buffer) {
     if (!buffer || buffer.length < 8) return false;
@@ -77,15 +114,25 @@ function isValidJPEGImageBuffer(buffer) {
 function isValidImageBuffer(buffer) {
     return isValidPNGImageBuffer(buffer) || isValidJPEGImageBuffer(buffer);
 }
+function validateScreenshotBuffer(screenshotBuffer, { label, minBufferSize = 0 }) {
+    const bufferSize = screenshotBuffer?.length ?? 0;
+    if (!screenshotBuffer || 0 === bufferSize) throw new Error(`${label} validation failed: buffer size ${bufferSize} bytes`);
+    if (!isValidImageBuffer(screenshotBuffer)) throw new Error(`${label} buffer has invalid image format`);
+    if (minBufferSize > 0 && bufferSize < minBufferSize) throw new Error(`${label} validation failed: buffer size ${bufferSize} bytes (minimum: ${minBufferSize})`);
+}
+exports.encodedImageInfoOfBuffer = __webpack_exports__.encodedImageInfoOfBuffer;
 exports.imageInfoOfBase64 = __webpack_exports__.imageInfoOfBase64;
 exports.isValidImageBuffer = __webpack_exports__.isValidImageBuffer;
 exports.isValidJPEGImageBuffer = __webpack_exports__.isValidJPEGImageBuffer;
 exports.isValidPNGImageBuffer = __webpack_exports__.isValidPNGImageBuffer;
+exports.validateScreenshotBuffer = __webpack_exports__.validateScreenshotBuffer;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "encodedImageInfoOfBuffer",
     "imageInfoOfBase64",
     "isValidImageBuffer",
     "isValidJPEGImageBuffer",
-    "isValidPNGImageBuffer"
+    "isValidPNGImageBuffer",
+    "validateScreenshotBuffer"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true

package/dist/lib/img/photon-loader.js

@@ -0,0 +1,38 @@
+"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__, {
+    loadPhotonModule: ()=>loadPhotonModule
+});
+async function loadPhotonModule() {
+    return import("@silvia-odwyer/photon");
+}
+exports.loadPhotonModule = __webpack_exports__.loadPhotonModule;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "loadPhotonModule"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

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-server.js

@@ -38,12 +38,13 @@ __webpack_require__.d(__webpack_exports__, {
     BaseMCPServer: ()=>BaseMCPServer
 });
 const external_node_crypto_namespaceObject = require("node:crypto");
+const utils_namespaceObject = require("@aiscene/shared/utils");
 const mcp_js_namespaceObject = require("@modelcontextprotocol/sdk/server/mcp.js");
 const stdio_js_namespaceObject = require("@modelcontextprotocol/sdk/server/stdio.js");
 const streamableHttp_js_namespaceObject = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
 const external_express_namespaceObject = require("express");
 var external_express_default = /*#__PURE__*/ __webpack_require__.n(external_express_namespaceObject);
-const external_utils_js_namespaceObject = require("../utils.js");
+const external_error_formatter_js_namespaceObject = require("./error-formatter.js");
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -80,12 +81,12 @@ const CLEANUP_INTERVAL_MS = 300000;
 const MAX_SESSIONS = 100;
 class BaseMCPServer {
     async initializeToolsManager() {
-        (0, external_utils_js_namespaceObject.setIsMcp)(true);
+        (0, utils_namespaceObject.setIsMcp)(true);
         this.toolsManager = this.providedToolsManager || this.createToolsManager();
         try {
             await this.toolsManager.initTools();
         } catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
+            const message = (0, external_error_formatter_js_namespaceObject.getErrorMessage)(error);
             console.error(`Failed to initialize tools: ${message}`);
             console.error('Tools will be initialized on first use');
         }
@@ -111,7 +112,7 @@ class BaseMCPServer {
         try {
             await this.mcpServer.connect(transport);
         } catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
+            const message = (0, external_error_formatter_js_namespaceObject.getErrorMessage)(error);
             console.error(`Failed to connect MCP stdio transport: ${message}`);
             throw new Error(`Failed to initialize MCP stdio transport: ${message}`);
         }
@@ -182,7 +183,7 @@ class BaseMCPServer {
                     });
                 }
             } catch (error) {
-                const message = error instanceof Error ? error.message : String(error);
+                const message = (0, external_error_formatter_js_namespaceObject.getErrorMessage)(error);
                 const duration = Date.now() - startTime;
                 console.error(`[${new Date().toISOString()}] [${requestId}] MCP request error after ${duration}ms: ${message}`);
                 if (!res.headersSent) res.status(500).json({
@@ -210,7 +211,7 @@ class BaseMCPServer {
                 for (const session of sessions.values())try {
                     await session.transport.close();
                 } catch (error) {
-                    const message = error instanceof Error ? error.message : String(error);
+                    const message = (0, external_error_formatter_js_namespaceObject.getErrorMessage)(error);
                     console.error(`Failed to close session ${session.transport.sessionId}: ${message}`);
                 }
                 sessions.clear();
@@ -245,7 +246,7 @@ class BaseMCPServer {
         try {
             await this.mcpServer.connect(transport);
         } catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
+            const message = (0, external_error_formatter_js_namespaceObject.getErrorMessage)(error);
             console.error(`[${new Date().toISOString()}] Failed to connect MCP transport: ${message}`);
             if (transport.sessionId) sessions.delete(transport.sessionId);
             throw new Error(`Failed to initialize MCP session: ${message}`);
@@ -264,7 +265,7 @@ class BaseMCPServer {
                 sessions.delete(sid);
                 console.log(`[${new Date().toISOString()}] Session ${sid} cleaned up due to inactivity (remaining: ${sessions.size})`);
             } catch (error) {
-                const message = error instanceof Error ? error.message : String(error);
+                const message = (0, external_error_formatter_js_namespaceObject.getErrorMessage)(error);
                 console.error(`[${new Date().toISOString()}] Failed to close session ${sid} during cleanup: ${message}`);
                 sessions.delete(sid);
             }
@@ -277,7 +278,7 @@ class BaseMCPServer {
             for (const session of sessions.values())try {
                 session.transport.close();
             } catch (error) {
-                const message = error instanceof Error ? error.message : String(error);
+                const message = (0, external_error_formatter_js_namespaceObject.getErrorMessage)(error);
                 console.error(`Error closing session during shutdown: ${message}`);
             }
             sessions.clear();
@@ -290,7 +291,7 @@ class BaseMCPServer {
                     this.performCleanup().finally(()=>process.exit(1));
                 }, 5000);
             } catch (error) {
-                const message = error instanceof Error ? error.message : String(error);
+                const message = (0, external_error_formatter_js_namespaceObject.getErrorMessage)(error);
                 console.error(`Error closing HTTP server: ${message}`);
                 this.performCleanup().finally(()=>process.exit(1));
             }

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

@@ -26,8 +26,11 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     BaseMidsceneTools: ()=>BaseMidsceneTools
 });
-const index_js_namespaceObject = require("../img/index.js");
-const external_logger_js_namespaceObject = require("../logger.js");
+const img_namespaceObject = require("@aiscene/shared/img");
+const logger_namespaceObject = require("@aiscene/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_generator_js_namespaceObject = require("./tool-generator.js");
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
@@ -39,11 +42,76 @@ function _define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
-const debug = (0, external_logger_js_namespaceObject.getDebug)('mcp:base-tools');
+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 [];
     }
+    getCliReportSessionName() {}
+    createNewCliReportSession(targetIdentity) {
+        const sessionName = this.getCliReportSessionName();
+        if (!sessionName) return;
+        return (0, external_cli_report_session_js_namespaceObject.generateCliReportSession)(sessionName, targetIdentity);
+    }
+    commitCliReportSession(session) {
+        if (session) (0, external_cli_report_session_js_namespaceObject.writeCliReportSession)(session);
+    }
+    readCliReportFileName() {
+        const sessionName = this.getCliReportSessionName();
+        if (!sessionName) return;
+        return (0, external_cli_report_session_js_namespaceObject.readCliReportSession)(sessionName)?.reportFileName;
+    }
+    readCliReportAgentOptions() {
+        const reportFileName = this.readCliReportFileName();
+        if (!reportFileName) return;
+        return {
+            reportFileName,
+            reportAttributes: {
+                'data-group-id': reportFileName
+            }
+        };
+    }
     async initTools() {
         this.toolDefinitions = [];
         const platformTools = this.preparePlatformTools();
@@ -58,8 +126,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);
     }
@@ -79,7 +147,7 @@ class BaseMidsceneTools {
         this.agent = agent;
     }
     buildScreenshotContent(screenshot) {
-        const { mimeType, body } = (0, index_js_namespaceObject.parseBase64)(screenshot);
+        const { mimeType, body } = (0, img_namespaceObject.parseBase64)(screenshot);
         return [
             {
                 type: 'image',

package/dist/lib/mcp/cli-report-session.js

@@ -0,0 +1,121 @@
+"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__, {
+    createCliReportSession: ()=>createCliReportSession,
+    generateCliReportSession: ()=>generateCliReportSession,
+    readCliReportSession: ()=>readCliReportSession,
+    writeCliReportSession: ()=>writeCliReportSession
+});
+const external_node_fs_namespaceObject = require("node:fs");
+const external_node_path_namespaceObject = require("node:path");
+const external_common_js_namespaceObject = require("../common.js");
+const sessionDirName = 'cli-report-session';
+function sanitizeSessionName(sessionName) {
+    return sessionName.replace(/[^a-zA-Z0-9._-]/g, '_') || 'default';
+}
+function sanitizeFileSegment(segment) {
+    const sanitized = segment.replace(/[^a-zA-Z0-9._-]/g, '_') || 'unknown';
+    return sanitized.slice(0, 80);
+}
+function ensureHtmlFileName(reportFileName) {
+    return reportFileName.endsWith('.html') ? reportFileName : `${reportFileName}.html`;
+}
+function formatDateForFileName(date) {
+    const pad = (value)=>String(value).padStart(2, '0');
+    const day = [
+        date.getFullYear(),
+        pad(date.getMonth() + 1),
+        pad(date.getDate())
+    ].join('-');
+    const time = [
+        pad(date.getHours()),
+        pad(date.getMinutes()),
+        pad(date.getSeconds())
+    ].join('-');
+    return `${day}_${time}`;
+}
+function randomId() {
+    return Math.random().toString(36).slice(2, 10);
+}
+function getCliReportSessionDir() {
+    const dir = (0, external_node_path_namespaceObject.join)((0, external_common_js_namespaceObject.getMidsceneRunBaseDir)(), sessionDirName);
+    if (!(0, external_node_fs_namespaceObject.existsSync)(dir)) (0, external_node_fs_namespaceObject.mkdirSync)(dir, {
+        recursive: true
+    });
+    return dir;
+}
+function getCliReportSessionPath(sessionName) {
+    return (0, external_node_path_namespaceObject.join)(getCliReportSessionDir(), `${sanitizeSessionName(sessionName)}.json`);
+}
+function generateCliReportSession(sessionName, targetIdentity) {
+    const identitySegment = targetIdentity ? `-${sanitizeFileSegment(targetIdentity)}` : '';
+    const reportFileName = `${sanitizeSessionName(sessionName)}${identitySegment}-${formatDateForFileName(new Date())}-${randomId()}`;
+    const reportPath = (0, external_node_path_namespaceObject.join)((0, external_common_js_namespaceObject.getMidsceneRunSubDir)('report'), ensureHtmlFileName(reportFileName));
+    const session = {
+        version: 1,
+        sessionName,
+        ...targetIdentity ? {
+            targetIdentity
+        } : {},
+        reportFileName,
+        reportPath,
+        createdAt: Date.now()
+    };
+    return session;
+}
+function writeCliReportSession(session) {
+    (0, external_node_fs_namespaceObject.writeFileSync)(getCliReportSessionPath(session.sessionName), JSON.stringify(session, null, 2), 'utf-8');
+}
+function createCliReportSession(sessionName, targetIdentity) {
+    const session = generateCliReportSession(sessionName, targetIdentity);
+    writeCliReportSession(session);
+    return session;
+}
+function readCliReportSession(sessionName) {
+    const sessionPath = getCliReportSessionPath(sessionName);
+    if (!(0, external_node_fs_namespaceObject.existsSync)(sessionPath)) return;
+    try {
+        const raw = (0, external_node_fs_namespaceObject.readFileSync)(sessionPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (1 !== parsed.version || parsed.sessionName !== sessionName || 'string' != typeof parsed.reportFileName || !parsed.reportFileName.trim() || /[\\/]/.test(parsed.reportFileName)) return;
+        return parsed;
+    } catch  {
+        return;
+    }
+}
+exports.createCliReportSession = __webpack_exports__.createCliReportSession;
+exports.generateCliReportSession = __webpack_exports__.generateCliReportSession;
+exports.readCliReportSession = __webpack_exports__.readCliReportSession;
+exports.writeCliReportSession = __webpack_exports__.writeCliReportSession;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "createCliReportSession",
+    "generateCliReportSession",
+    "readCliReportSession",
+    "writeCliReportSession"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});