@midscene/shared 1.9.7 → 1.9.8-beta-20260618014851.0

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

@@ -1,345 +0,0 @@
-"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__, {
-    CLI_ARGS_CONFIG: ()=>CLI_ARGS_CONFIG,
-    launchMCPServer: ()=>launchMCPServer,
-    BaseMCPServer: ()=>BaseMCPServer
-});
-const external_node_crypto_namespaceObject = require("node:crypto");
-const utils_namespaceObject = require("@midscene/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_error_formatter_js_namespaceObject = require("./error-formatter.js");
-const external_tool_defaults_js_namespaceObject = require("./tool-defaults.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 CLI_ARGS_CONFIG = {
-    mode: {
-        type: 'string',
-        default: 'stdio'
-    },
-    port: {
-        type: 'string',
-        default: '3000'
-    },
-    host: {
-        type: 'string',
-        default: 'localhost'
-    },
-    ...Object.fromEntries(external_tool_defaults_js_namespaceObject.TOOL_BEHAVIOR_FLAGS.map((flag)=>[
-            flag.cli,
-            {
-                type: 'boolean'
-            }
-        ]))
-};
-function launchMCPServer(server, args) {
-    server.setToolDefaults((0, external_tool_defaults_js_namespaceObject.resolveToolDefaults)((cli)=>true === args[cli]));
-    if ('http' === args.mode) return server.launchHttp({
-        port: Number.parseInt(args.port || '3000', 10),
-        host: args.host || 'localhost'
-    });
-    return server.launch();
-}
-const SESSION_TIMEOUT_MS = 1800000;
-const CLEANUP_INTERVAL_MS = 300000;
-const MAX_SESSIONS = 100;
-class BaseMCPServer {
-    setToolDefaults(toolDefaults) {
-        this.toolDefaults = (0, external_tool_defaults_js_namespaceObject.mergeToolDefaults)(this.toolDefaults, toolDefaults);
-    }
-    async initializeToolsManager() {
-        (0, utils_namespaceObject.setIsMcp)(true);
-        this.toolsManager = this.providedToolsManager || this.createToolsManager();
-        this.toolsManager.setToolDefaults?.(this.toolDefaults);
-        try {
-            await this.toolsManager.initTools();
-        } catch (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');
-        }
-        this.toolsManager.attachToServer(this.mcpServer);
-    }
-    async performCleanup() {
-        console.error(`${this.config.name} closing...`);
-        this.mcpServer.close();
-        await this.toolsManager?.destroy?.().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 {
-            await this.mcpServer.connect(transport);
-        } catch (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}`);
-        }
-        let isShuttingDown = false;
-        const cleanup = ()=>{
-            if (isShuttingDown) return;
-            isShuttingDown = true;
-            console.error(`${this.config.name} shutting down...`);
-            this.performCleanup().finally(()=>process.exit(0));
-        };
-        process.on('uncaughtException', (error)=>{
-            if ('EPIPE' === error.code || 'ERR_STREAM_DESTROYED' === error.code) return void cleanup();
-            console.error(`[${this.config.name}] Uncaught Exception:`, error);
-            console.error('Stack:', error.stack);
-        });
-        process.on('unhandledRejection', (reason)=>{
-            console.error(`[${this.config.name}] Unhandled Rejection:`, reason);
-            if (reason instanceof Error) console.error('Stack:', reason.stack);
-        });
-        process.stdin.on('close', cleanup);
-        process.stdin.on('end', cleanup);
-        process.stdout.on('error', cleanup);
-        process.once('SIGINT', cleanup);
-        process.once('SIGTERM', cleanup);
-        process.once('SIGHUP', cleanup);
-        return {
-            close: async ()=>{
-                this.performCleanup();
-            }
-        };
-    }
-    async launchHttp(options) {
-        if (!Number.isInteger(options.port) || options.port < 1 || options.port > 65535) throw new Error(`Invalid port number: ${options.port}. Port must be between 1 and 65535.`);
-        await this.initializeToolsManager();
-        const app = external_express_default()();
-        app.use(external_express_default().json({
-            limit: '10mb'
-        }));
-        const sessions = new Map();
-        app.all('/mcp', async (req, res)=>{
-            const startTime = Date.now();
-            const requestId = (0, external_node_crypto_namespaceObject.randomUUID)().substring(0, 8);
-            try {
-                const rawSessionId = req.headers['mcp-session-id'];
-                const sessionId = Array.isArray(rawSessionId) ? rawSessionId[0] : rawSessionId;
-                let session = sessionId ? sessions.get(sessionId) : void 0;
-                if (!session && 'POST' === req.method) {
-                    if (sessions.size >= MAX_SESSIONS) {
-                        console.error(`[${new Date().toISOString()}] [${requestId}] Session limit reached: ${sessions.size}/${MAX_SESSIONS}`);
-                        res.status(503).json({
-                            error: 'Too many active sessions',
-                            message: 'Server is at maximum capacity. Please try again later.'
-                        });
-                        return;
-                    }
-                    session = await this.createHttpSession(sessions);
-                    console.log(`[${new Date().toISOString()}] [${requestId}] New session created: ${session.transport.sessionId}`);
-                }
-                if (session) {
-                    session.lastAccessedAt = new Date();
-                    await session.transport.handleRequest(req, res, req.body);
-                    const duration = Date.now() - startTime;
-                    console.log(`[${new Date().toISOString()}] [${requestId}] Request completed in ${duration}ms`);
-                } else {
-                    console.error(`[${new Date().toISOString()}] [${requestId}] Invalid session or GET without session`);
-                    res.status(400).json({
-                        error: 'Invalid session or GET without session'
-                    });
-                }
-            } catch (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({
-                    error: 'Internal server error',
-                    message: 'Failed to process MCP request'
-                });
-            }
-        });
-        const host = options.host || 'localhost';
-        const server = app.listen(options.port, host, ()=>{
-            console.log(`${this.config.name} HTTP server listening on http://${host}:${options.port}/mcp`);
-        }).on('error', (error)=>{
-            if ('EADDRINUSE' === error.code) console.error(`ERROR: Port ${options.port} is already in use.\nPlease try a different port: --port=<number>\nExample: --mode=http --port=${options.port + 1}`);
-            else if ('EACCES' === error.code) console.error(`ERROR: Permission denied to bind to port ${options.port}.\nPorts below 1024 require root/admin privileges.\nPlease use a port above 1024 or run with elevated privileges.`);
-            else console.error(`ERROR: Failed to start HTTP server on ${host}:${options.port}\nReason: ${error.message}\nCode: ${error.code || 'unknown'}`);
-            process.exit(1);
-        });
-        const cleanupInterval = this.startSessionCleanup(sessions);
-        this.setupHttpShutdownHandlers(server, sessions, cleanupInterval);
-        return {
-            port: options.port,
-            host,
-            close: async ()=>{
-                clearInterval(cleanupInterval);
-                for (const session of sessions.values())try {
-                    await session.transport.close();
-                } catch (error) {
-                    const message = (0, external_error_formatter_js_namespaceObject.getErrorMessage)(error);
-                    console.error(`Failed to close session ${session.transport.sessionId}: ${message}`);
-                }
-                sessions.clear();
-                return new Promise((resolve)=>{
-                    server.close(async (err)=>{
-                        if (err) console.error('Error closing HTTP server:', err);
-                        await this.performCleanup();
-                        resolve();
-                    });
-                });
-            }
-        };
-    }
-    async createHttpSession(sessions) {
-        const transport = new streamableHttp_js_namespaceObject.StreamableHTTPServerTransport({
-            sessionIdGenerator: ()=>(0, external_node_crypto_namespaceObject.randomUUID)(),
-            onsessioninitialized: (sid)=>{
-                sessions.set(sid, {
-                    transport,
-                    createdAt: new Date(),
-                    lastAccessedAt: new Date()
-                });
-                console.log(`[${new Date().toISOString()}] Session ${sid} initialized (total: ${sessions.size})`);
-            }
-        });
-        transport.onclose = ()=>{
-            if (transport.sessionId) {
-                sessions.delete(transport.sessionId);
-                console.log(`[${new Date().toISOString()}] Session ${transport.sessionId} closed (remaining: ${sessions.size})`);
-            }
-        };
-        try {
-            await this.mcpServer.connect(transport);
-        } catch (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}`);
-        }
-        return {
-            transport,
-            createdAt: new Date(),
-            lastAccessedAt: new Date()
-        };
-    }
-    startSessionCleanup(sessions) {
-        return setInterval(()=>{
-            const now = Date.now();
-            for (const [sid, session] of sessions)if (now - session.lastAccessedAt.getTime() > SESSION_TIMEOUT_MS) try {
-                session.transport.close();
-                sessions.delete(sid);
-                console.log(`[${new Date().toISOString()}] Session ${sid} cleaned up due to inactivity (remaining: ${sessions.size})`);
-            } catch (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);
-            }
-        }, CLEANUP_INTERVAL_MS);
-    }
-    setupHttpShutdownHandlers(server, sessions, cleanupInterval) {
-        const cleanup = ()=>{
-            console.error(`${this.config.name} shutting down...`);
-            clearInterval(cleanupInterval);
-            for (const session of sessions.values())try {
-                session.transport.close();
-            } catch (error) {
-                const message = (0, external_error_formatter_js_namespaceObject.getErrorMessage)(error);
-                console.error(`Error closing session during shutdown: ${message}`);
-            }
-            sessions.clear();
-            try {
-                server.close(()=>{
-                    this.performCleanup().finally(()=>process.exit(0));
-                });
-                setTimeout(()=>{
-                    console.error('Forcefully shutting down after timeout');
-                    this.performCleanup().finally(()=>process.exit(1));
-                }, 5000);
-            } catch (error) {
-                const message = (0, external_error_formatter_js_namespaceObject.getErrorMessage)(error);
-                console.error(`Error closing HTTP server: ${message}`);
-                this.performCleanup().finally(()=>process.exit(1));
-            }
-        };
-        process.once('SIGINT', cleanup);
-        process.once('SIGTERM', cleanup);
-    }
-    getServer() {
-        return this.mcpServer;
-    }
-    getToolsManager() {
-        return this.toolsManager;
-    }
-    constructor(config, toolsManager){
-        _define_property(this, "mcpServer", void 0);
-        _define_property(this, "toolsManager", void 0);
-        _define_property(this, "config", void 0);
-        _define_property(this, "providedToolsManager", void 0);
-        _define_property(this, "toolDefaults", {});
-        this.config = config;
-        this.mcpServer = new mcp_js_namespaceObject.McpServer({
-            name: config.name,
-            version: config.version,
-            description: config.description
-        });
-        this.providedToolsManager = toolsManager;
-    }
-}
-exports.BaseMCPServer = __webpack_exports__.BaseMCPServer;
-exports.CLI_ARGS_CONFIG = __webpack_exports__.CLI_ARGS_CONFIG;
-exports.launchMCPServer = __webpack_exports__.launchMCPServer;
-for(var __rspack_i in __webpack_exports__)if (-1 === [
-    "BaseMCPServer",
-    "CLI_ARGS_CONFIG",
-    "launchMCPServer"
-].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
-Object.defineProperty(exports, '__esModule', {
-    value: true
-});

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

@@ -1,98 +0,0 @@
-"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 markerIndex = coreContent.indexOf(REPLACED_MARK);
-                const jsonStart = markerIndex + REPLACED_MARK.length;
-                let jsonEnd = jsonStart;
-                if ('"' === coreContent[jsonStart]) {
-                    jsonEnd = jsonStart + 1;
-                    while(jsonEnd < coreContent.length)if ('\\' === coreContent[jsonEnd]) jsonEnd += 2;
-                    else if ('"' === coreContent[jsonEnd]) {
-                        jsonEnd += 1;
-                        break;
-                    } else jsonEnd += 1;
-                }
-                const jsonString = coreContent.slice(jsonStart, jsonEnd);
-                if (!jsonString || jsonString.length < 10) return void console.warn('[inject-report-html] Failed to extract HTML from core');
-                const finalContent = `${REPLACED_MARK}${jsonString}`;
-                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/lib/mcp/launcher-helper.js

@@ -1,86 +0,0 @@
-"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__, {
-    createMCPServerLauncher: ()=>createMCPServerLauncher
-});
-function createMCPServerLauncher(config) {
-    const { agent, platformName, ToolsManagerClass, MCPServerClass } = config;
-    function validateAgent() {
-        const device = agent.interface;
-        if (!device) throw new Error(`Agent must have an 'interface' property that references the underlying device.
-Please ensure your agent instance is properly initialized with a device interface.
-Expected: agent.interface to be defined, but got: ${typeof device}
-Solution: Check that your agent constructor properly sets the interface property.`);
-    }
-    function createToolsManager() {
-        const toolsManager = new ToolsManagerClass();
-        toolsManager.agent = agent;
-        return toolsManager;
-    }
-    function logStartupInfo(mode, additionalInfo) {
-        const device = agent.interface;
-        console.log(`Starting Midscene ${platformName} MCP Server (${mode})...`);
-        console.log(`Agent: ${agent.constructor.name}`);
-        console.log(`Device: ${device.constructor.name}`);
-        if (additionalInfo?.port !== void 0) console.log(`Port: ${additionalInfo.port}`);
-        if (additionalInfo?.host) console.log(`Host: ${additionalInfo.host}`);
-    }
-    return {
-        async launch (options = {}) {
-            const { verbose = true } = options;
-            validateAgent();
-            if (verbose) logStartupInfo('stdio');
-            const toolsManager = createToolsManager();
-            const server = new MCPServerClass(toolsManager);
-            const result = await server.launch();
-            if (verbose) console.log(`${platformName} MCP Server started (stdio mode)`);
-            return result;
-        },
-        async launchHttp (options) {
-            const { port, host = 'localhost', verbose = true } = options;
-            validateAgent();
-            if (verbose) logStartupInfo('HTTP', {
-                port,
-                host
-            });
-            const toolsManager = createToolsManager();
-            const server = new MCPServerClass(toolsManager);
-            const result = await server.launchHttp({
-                port,
-                host
-            });
-            if (verbose) console.log(`${platformName} MCP Server started on http://${result.host}:${result.port}/mcp`);
-            return result;
-        }
-    };
-}
-exports.createMCPServerLauncher = __webpack_exports__.createMCPServerLauncher;
-for(var __rspack_i in __webpack_exports__)if (-1 === [
-    "createMCPServerLauncher"
-].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
-Object.defineProperty(exports, '__esModule', {
-    value: true
-});

package/dist/types/mcp/base-server.d.ts

@@ -1,106 +0,0 @@
-import type { ParseArgsConfig } from 'node:util';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { type ToolDefaults } from './tool-defaults';
-import type { IMidsceneTools } from './types';
-export interface BaseMCPServerConfig {
-    name: string;
-    version: string;
-    description: string;
-}
-export interface HttpLaunchOptions {
-    port: number;
-    host?: string;
-}
-export interface LaunchMCPServerResult {
-    /**
-     * The MCP server port (for HTTP mode)
-     */
-    port?: number;
-    /**
-     * The server host (for HTTP mode)
-     */
-    host?: string;
-    /**
-     * Function to gracefully shutdown the MCP server
-     */
-    close: () => Promise<void>;
-}
-/**
- * CLI argument configuration for MCP servers. Behavior flags (e.g.
- * `--deep-locate`) are generated from {@link TOOL_BEHAVIOR_FLAGS}, so adding a
- * new flag there exposes it here automatically.
- */
-export declare const CLI_ARGS_CONFIG: ParseArgsConfig['options'];
-export interface CLIArgs {
-    mode?: string;
-    port?: string;
-    host?: string;
-    /** Behavior flags such as `deep-locate` / `deep-think` (see TOOL_BEHAVIOR_FLAGS). */
-    [flag: string]: string | boolean | undefined;
-}
-/**
- * Launch an MCP server based on CLI arguments
- * Shared helper to reduce duplication across platform CLI entry points
- */
-export declare function launchMCPServer(server: BaseMCPServer, args: CLIArgs): Promise<LaunchMCPServerResult>;
-/**
- * Base MCP Server class with programmatic launch() API
- * Each platform extends this to provide their own tools manager
- */
-export declare abstract class BaseMCPServer {
-    protected mcpServer: McpServer;
-    protected toolsManager?: IMidsceneTools;
-    protected config: BaseMCPServerConfig;
-    protected providedToolsManager?: IMidsceneTools;
-    protected toolDefaults: ToolDefaults;
-    constructor(config: BaseMCPServerConfig, toolsManager?: IMidsceneTools);
-    /**
-     * Set the default options injected into generated tool calls (e.g. forced
-     * deep locate / deep think). Must be called before `launch()` /
-     * `launchHttp()` so they are applied to the tools manager before its tools
-     * are generated. Merges with any previously set defaults.
-     */
-    setToolDefaults(toolDefaults: ToolDefaults): void;
-    /**
-     * Platform-specific: create tools manager instance
-     * This is only called if no tools manager was provided in constructor
-     */
-    protected abstract createToolsManager(): IMidsceneTools;
-    /**
-     * Initialize tools manager and attach to MCP server
-     */
-    private initializeToolsManager;
-    /**
-     * Perform cleanup on shutdown
-     */
-    private performCleanup;
-    /**
-     * Initialize and launch the MCP server with stdio transport
-     */
-    launch(): Promise<LaunchMCPServerResult>;
-    /**
-     * Launch MCP server with HTTP transport
-     * Supports stateful sessions for web applications and service integration
-     */
-    launchHttp(options: HttpLaunchOptions): Promise<LaunchMCPServerResult>;
-    /**
-     * Create a new HTTP session with transport
-     */
-    private createHttpSession;
-    /**
-     * Start periodic session cleanup for inactive sessions
-     */
-    private startSessionCleanup;
-    /**
-     * Setup shutdown handlers for HTTP server
-     */
-    private setupHttpShutdownHandlers;
-    /**
-     * Get the underlying MCP server instance
-     */
-    getServer(): McpServer;
-    /**
-     * Get the tools manager instance
-     */
-    getToolsManager(): IMidsceneTools | undefined;
-}

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

@@ -1,18 +0,0 @@
-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 {};