@midscene/shared 1.0.1-beta-20251208031856.0 → 1.0.1-beta-20251208070218.0

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

@@ -56,6 +56,15 @@ class BaseMCPServer {
         this.toolsManager?.closeBrowser?.().catch(console.error);
     }
     async launch() {
+        console.log = (...args)=>{
+            console.error('[LOG]', ...args);
+        };
+        console.info = (...args)=>{
+            console.error('[INFO]', ...args);
+        };
+        console.debug = (...args)=>{
+            console.error('[DEBUG]', ...args);
+        };
         await this.initializeToolsManager();
         const transport = new StdioServerTransport();
         try {

package/dist/es/mcp/index.mjs

@@ -2,3 +2,4 @@ export * from "./base-server.mjs";
 export * from "./base-tools.mjs";
 export * from "./tool-generator.mjs";
 export * from "./types.mjs";
+export * from "./inject-report-html-plugin.mjs";

package/dist/es/mcp/inject-report-html-plugin.mjs

@@ -0,0 +1,42 @@
+import node_fs from "node:fs";
+import node_path from "node:path";
+const MAGIC_STRING = 'REPLACE_ME_WITH_REPORT_HTML';
+const REPLACED_MARK = '/*REPORT_HTML_REPLACED*/';
+const REG_EXP_FOR_REPLACE = /\/\*REPORT_HTML_REPLACED\*\/.*/;
+function injectReportHtmlFromCore(packageDir) {
+    return {
+        name: 'inject-report-html-from-core',
+        setup (api) {
+            api.onAfterBuild(()=>{
+                const coreUtilsPath = node_path.resolve(packageDir, '..', 'core', 'dist', 'lib', 'utils.js');
+                if (!node_fs.existsSync(coreUtilsPath)) return void console.warn('[inject-report-html] @midscene/core dist not found, skipping');
+                const coreContent = node_fs.readFileSync(coreUtilsPath, 'utf-8');
+                if (!coreContent.includes(REPLACED_MARK)) return void console.warn('[inject-report-html] HTML not found in core dist. Ensure report builds first.');
+                const match = coreContent.match(/\/\*REPORT_HTML_REPLACED\*\/(".*?")/);
+                if (!match?.[1]) return void console.warn('[inject-report-html] Failed to extract HTML from core');
+                const finalContent = `${REPLACED_MARK}${match[1]}`;
+                const distDir = node_path.join(packageDir, 'dist');
+                if (!node_fs.existsSync(distDir)) return;
+                const jsFiles = node_fs.readdirSync(distDir).filter((f)=>f.endsWith('.js'));
+                let injectedCount = 0;
+                for (const file of jsFiles){
+                    const filePath = node_path.join(distDir, file);
+                    const content = node_fs.readFileSync(filePath, 'utf-8');
+                    if (content.includes(REPLACED_MARK)) {
+                        if (REG_EXP_FOR_REPLACE.test(content)) {
+                            node_fs.writeFileSync(filePath, content.replace(REG_EXP_FOR_REPLACE, ()=>finalContent));
+                            console.log(`[inject-report-html] Updated: ${file}`);
+                            injectedCount++;
+                        }
+                    } else if (content.includes(`'${MAGIC_STRING}'`)) {
+                        node_fs.writeFileSync(filePath, content.replace(`'${MAGIC_STRING}'`, ()=>finalContent));
+                        console.log(`[inject-report-html] Injected: ${file}`);
+                        injectedCount++;
+                    }
+                }
+                if (injectedCount > 0) console.log(`[inject-report-html] Completed: ${injectedCount} file(s)`);
+            });
+        }
+    };
+}
+export { injectReportHtmlFromCore };

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

@@ -86,6 +86,15 @@ class BaseMCPServer {
         this.toolsManager?.closeBrowser?.().catch(console.error);
     }
     async launch() {
+        console.log = (...args)=>{
+            console.error('[LOG]', ...args);
+        };
+        console.info = (...args)=>{
+            console.error('[INFO]', ...args);
+        };
+        console.debug = (...args)=>{
+            console.error('[DEBUG]', ...args);
+        };
         await this.initializeToolsManager();
         const transport = new stdio_js_namespaceObject.StdioServerTransport();
         try {

package/dist/lib/mcp/index.js

@@ -6,6 +6,9 @@ var __webpack_modules__ = {
     "./base-tools" (module) {
         module.exports = require("./base-tools.js");
     },
+    "./inject-report-html-plugin" (module) {
+        module.exports = require("./inject-report-html-plugin.js");
+    },
     "./tool-generator" (module) {
         module.exports = require("./tool-generator.js");
     },
@@ -72,6 +75,10 @@ var __webpack_exports__ = {};
     var __rspack_reexport = {};
     for(const __rspack_import_key in _types__rspack_import_3)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_types__rspack_import_3[__rspack_import_key];
     __webpack_require__.d(__webpack_exports__, __rspack_reexport);
+    var _inject_report_html_plugin__rspack_import_4 = __webpack_require__("./inject-report-html-plugin");
+    var __rspack_reexport = {};
+    for(const __rspack_import_key in _inject_report_html_plugin__rspack_import_4)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_inject_report_html_plugin__rspack_import_4[__rspack_import_key];
+    __webpack_require__.d(__webpack_exports__, __rspack_reexport);
 })();
 for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {

package/dist/lib/mcp/inject-report-html-plugin.js

@@ -0,0 +1,87 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __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__, {
+    injectReportHtmlFromCore: ()=>injectReportHtmlFromCore
+});
+const external_node_fs_namespaceObject = require("node:fs");
+var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
+const external_node_path_namespaceObject = require("node:path");
+var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
+const MAGIC_STRING = 'REPLACE_ME_WITH_REPORT_HTML';
+const REPLACED_MARK = '/*REPORT_HTML_REPLACED*/';
+const REG_EXP_FOR_REPLACE = /\/\*REPORT_HTML_REPLACED\*\/.*/;
+function injectReportHtmlFromCore(packageDir) {
+    return {
+        name: 'inject-report-html-from-core',
+        setup (api) {
+            api.onAfterBuild(()=>{
+                const coreUtilsPath = external_node_path_default().resolve(packageDir, '..', 'core', 'dist', 'lib', 'utils.js');
+                if (!external_node_fs_default().existsSync(coreUtilsPath)) return void console.warn('[inject-report-html] @midscene/core dist not found, skipping');
+                const coreContent = external_node_fs_default().readFileSync(coreUtilsPath, 'utf-8');
+                if (!coreContent.includes(REPLACED_MARK)) return void console.warn('[inject-report-html] HTML not found in core dist. Ensure report builds first.');
+                const match = coreContent.match(/\/\*REPORT_HTML_REPLACED\*\/(".*?")/);
+                if (!match?.[1]) return void console.warn('[inject-report-html] Failed to extract HTML from core');
+                const finalContent = `${REPLACED_MARK}${match[1]}`;
+                const distDir = external_node_path_default().join(packageDir, 'dist');
+                if (!external_node_fs_default().existsSync(distDir)) return;
+                const jsFiles = external_node_fs_default().readdirSync(distDir).filter((f)=>f.endsWith('.js'));
+                let injectedCount = 0;
+                for (const file of jsFiles){
+                    const filePath = external_node_path_default().join(distDir, file);
+                    const content = external_node_fs_default().readFileSync(filePath, 'utf-8');
+                    if (content.includes(REPLACED_MARK)) {
+                        if (REG_EXP_FOR_REPLACE.test(content)) {
+                            external_node_fs_default().writeFileSync(filePath, content.replace(REG_EXP_FOR_REPLACE, ()=>finalContent));
+                            console.log(`[inject-report-html] Updated: ${file}`);
+                            injectedCount++;
+                        }
+                    } else if (content.includes(`'${MAGIC_STRING}'`)) {
+                        external_node_fs_default().writeFileSync(filePath, content.replace(`'${MAGIC_STRING}'`, ()=>finalContent));
+                        console.log(`[inject-report-html] Injected: ${file}`);
+                        injectedCount++;
+                    }
+                }
+                if (injectedCount > 0) console.log(`[inject-report-html] Completed: ${injectedCount} file(s)`);
+            });
+        }
+    };
+}
+exports.injectReportHtmlFromCore = __webpack_exports__.injectReportHtmlFromCore;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "injectReportHtmlFromCore"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

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

@@ -2,3 +2,4 @@ export * from './base-server';
 export * from './base-tools';
 export * from './tool-generator';
 export * from './types';
+export * from './inject-report-html-plugin';

package/dist/types/mcp/inject-report-html-plugin.d.ts

@@ -0,0 +1,18 @@
+interface RslibPluginApi {
+    onAfterBuild: (callback: () => void) => void;
+}
+/**
+ * Rslib plugin to inject report HTML from @midscene/core dist into MCP bundle.
+ * This runs after build and reads the already-injected HTML from core.
+ *
+ * Prerequisites:
+ * - @midscene/report must be in devDependencies to ensure correct build order
+ * - @midscene/core dist must exist with injected HTML
+ *
+ * @param packageDir - The directory of the MCP package (use __dirname)
+ */
+export declare function injectReportHtmlFromCore(packageDir: string): {
+    name: string;
+    setup(api: RslibPluginApi): void;
+};
+export {};

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

@@ -61,12 +61,13 @@ export interface ToolDefinition<T = Record<string, unknown>> {
 }
 /**
  * Action space item definition
+ * Note: Intentionally no index signature to maintain compatibility with DeviceAction
  */
 export interface ActionSpaceItem {
     name: string;
     description?: string;
     args?: Record<string, unknown>;
-    [key: string]: unknown;
+    paramSchema?: z.ZodTypeAny;
 }
 /**
  * Base agent interface

package/package.json

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

package/src/mcp/base-server.ts

@@ -114,6 +114,19 @@ export abstract class BaseMCPServer {
    * Initialize and launch the MCP server with stdio transport
    */
   public async launch(): Promise<void> {
+    // Hijack stdout-based console methods to stderr for stdio mode
+    // This prevents them from breaking MCP JSON-RPC protocol on stdout
+    // Note: console.warn and console.error already output to stderr
+    console.log = (...args: unknown[]) => {
+      console.error('[LOG]', ...args);
+    };
+    console.info = (...args: unknown[]) => {
+      console.error('[INFO]', ...args);
+    };
+    console.debug = (...args: unknown[]) => {
+      console.error('[DEBUG]', ...args);
+    };
+
     await this.initializeToolsManager();
 
     const transport = new StdioServerTransport();

package/src/mcp/index.ts

@@ -2,3 +2,4 @@ export * from './base-server';
 export * from './base-tools';
 export * from './tool-generator';
 export * from './types';
+export * from './inject-report-html-plugin';

package/src/mcp/inject-report-html-plugin.ts

@@ -0,0 +1,98 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+const MAGIC_STRING = 'REPLACE_ME_WITH_REPORT_HTML';
+const REPLACED_MARK = '/*REPORT_HTML_REPLACED*/';
+const REG_EXP_FOR_REPLACE = /\/\*REPORT_HTML_REPLACED\*\/.*/;
+
+interface RslibPluginApi {
+  onAfterBuild: (callback: () => void) => void;
+}
+
+/**
+ * Rslib plugin to inject report HTML from @midscene/core dist into MCP bundle.
+ * This runs after build and reads the already-injected HTML from core.
+ *
+ * Prerequisites:
+ * - @midscene/report must be in devDependencies to ensure correct build order
+ * - @midscene/core dist must exist with injected HTML
+ *
+ * @param packageDir - The directory of the MCP package (use __dirname)
+ */
+export function injectReportHtmlFromCore(packageDir: string) {
+  return {
+    name: 'inject-report-html-from-core',
+    setup(api: RslibPluginApi) {
+      api.onAfterBuild(() => {
+        const coreUtilsPath = path.resolve(
+          packageDir,
+          '..',
+          'core',
+          'dist',
+          'lib',
+          'utils.js',
+        );
+
+        if (!fs.existsSync(coreUtilsPath)) {
+          console.warn(
+            '[inject-report-html] @midscene/core dist not found, skipping',
+          );
+          return;
+        }
+
+        const coreContent = fs.readFileSync(coreUtilsPath, 'utf-8');
+        if (!coreContent.includes(REPLACED_MARK)) {
+          console.warn(
+            '[inject-report-html] HTML not found in core dist. Ensure report builds first.',
+          );
+          return;
+        }
+
+        const match = coreContent.match(/\/\*REPORT_HTML_REPLACED\*\/(".*?")/);
+        if (!match?.[1]) {
+          console.warn('[inject-report-html] Failed to extract HTML from core');
+          return;
+        }
+
+        const finalContent = `${REPLACED_MARK}${match[1]}`;
+        const distDir = path.join(packageDir, 'dist');
+
+        if (!fs.existsSync(distDir)) return;
+
+        const jsFiles = fs
+          .readdirSync(distDir)
+          .filter((f) => f.endsWith('.js'));
+        let injectedCount = 0;
+
+        for (const file of jsFiles) {
+          const filePath = path.join(distDir, file);
+          const content = fs.readFileSync(filePath, 'utf-8');
+
+          if (content.includes(REPLACED_MARK)) {
+            if (REG_EXP_FOR_REPLACE.test(content)) {
+              fs.writeFileSync(
+                filePath,
+                content.replace(REG_EXP_FOR_REPLACE, () => finalContent),
+              );
+              console.log(`[inject-report-html] Updated: ${file}`);
+              injectedCount++;
+            }
+          } else if (content.includes(`'${MAGIC_STRING}'`)) {
+            fs.writeFileSync(
+              filePath,
+              content.replace(`'${MAGIC_STRING}'`, () => finalContent),
+            );
+            console.log(`[inject-report-html] Injected: ${file}`);
+            injectedCount++;
+          }
+        }
+
+        if (injectedCount > 0) {
+          console.log(
+            `[inject-report-html] Completed: ${injectedCount} file(s)`,
+          );
+        }
+      });
+    },
+  };
+}

package/src/mcp/types.ts

@@ -60,12 +60,13 @@ export interface ToolDefinition<T = Record<string, unknown>> {
 
 /**
  * Action space item definition
+ * Note: Intentionally no index signature to maintain compatibility with DeviceAction
  */
 export interface ActionSpaceItem {
   name: string;
   description?: string;
   args?: Record<string, unknown>;
-  [key: string]: unknown;
+  paramSchema?: z.ZodTypeAny;
 }
 
 /**