@godscene/web 1.7.11

package/dist/lib/cli-options.js

@@ -0,0 +1,131 @@
+"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 ("u" > 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__, {
+    parseWebCliOptions: ()=>parseWebCliOptions
+});
+const cli_namespaceObject = require("@godscene/shared/cli");
+const viewport_js_namespaceObject = require("./common/viewport.js");
+const viewportWidthFlag = '--viewport-width';
+const viewportHeightFlag = '--viewport-height';
+function isLikelyCdpEndpoint(value) {
+    return !!value && /^(wss?):\/\//.test(value);
+}
+function parsePositiveIntegerOption(flag, rawValue) {
+    const value = Number(rawValue);
+    if (!Number.isInteger(value) || value <= 0) throw new cli_namespaceObject.CLIError(`Invalid value for "${flag}": expected a positive integer, got "${rawValue}".`);
+    return value;
+}
+function readRequiredOptionValue(args, index, flag) {
+    const currentArg = args[index];
+    const inlinePrefix = `${flag}=`;
+    if (currentArg.startsWith(inlinePrefix)) return {
+        value: currentArg.slice(inlinePrefix.length),
+        nextIndex: index
+    };
+    const nextArg = args[index + 1];
+    if (!nextArg || nextArg.startsWith('--')) throw new cli_namespaceObject.CLIError(`Option "${flag}" requires a value.`);
+    return {
+        value: nextArg,
+        nextIndex: index + 1
+    };
+}
+function readOptionalCdpEndpoint(args, index) {
+    const currentArg = args[index];
+    const inlinePrefix = '--cdp=';
+    if (currentArg.startsWith(inlinePrefix)) return {
+        value: currentArg.slice(inlinePrefix.length),
+        nextIndex: index
+    };
+    const nextArg = args[index + 1];
+    if (!isLikelyCdpEndpoint(nextArg)) return {
+        nextIndex: index
+    };
+    return {
+        value: nextArg,
+        nextIndex: index + 1
+    };
+}
+function parseWebCliOptions(rawArgs, env = process.env) {
+    const argv = [];
+    let isBridge = false;
+    let isCdp = false;
+    let viewportWidth;
+    let viewportHeight;
+    let cdpEndpoint;
+    for(let index = 0; index < rawArgs.length; index += 1){
+        const arg = rawArgs[index];
+        if ('--bridge' === arg) {
+            isBridge = true;
+            continue;
+        }
+        if ('--cdp' === arg || arg.startsWith('--cdp=')) {
+            isCdp = true;
+            const parsed = readOptionalCdpEndpoint(rawArgs, index);
+            cdpEndpoint = parsed.value ?? cdpEndpoint;
+            index = parsed.nextIndex;
+            continue;
+        }
+        if (arg === viewportWidthFlag || arg.startsWith(`${viewportWidthFlag}=`)) {
+            const parsed = readRequiredOptionValue(rawArgs, index, viewportWidthFlag);
+            viewportWidth = parsePositiveIntegerOption(viewportWidthFlag, parsed.value);
+            index = parsed.nextIndex;
+            continue;
+        }
+        if (arg === viewportHeightFlag || arg.startsWith(`${viewportHeightFlag}=`)) {
+            const parsed = readRequiredOptionValue(rawArgs, index, viewportHeightFlag);
+            viewportHeight = parsePositiveIntegerOption(viewportHeightFlag, parsed.value);
+            index = parsed.nextIndex;
+            continue;
+        }
+        argv.push(arg);
+    }
+    if (isBridge && isCdp) throw new cli_namespaceObject.CLIError('--bridge and --cdp are mutually exclusive. Please specify only one.');
+    const mode = isBridge ? 'bridge' : isCdp ? 'cdp' : 'puppeteer';
+    if ('puppeteer' !== mode) {
+        if (void 0 !== viewportWidth || void 0 !== viewportHeight) throw new cli_namespaceObject.CLIError('Viewport options are only supported in the default Puppeteer mode.');
+    }
+    if ('cdp' === mode) {
+        cdpEndpoint = cdpEndpoint ?? env.MIDSCENE_CDP_ENDPOINT;
+        if (!cdpEndpoint) throw new cli_namespaceObject.CLIError('CDP endpoint is required. Provide it as: --cdp <ws-endpoint> or set MIDSCENE_CDP_ENDPOINT environment variable.');
+    }
+    const hasViewportOverride = void 0 !== viewportWidth || void 0 !== viewportHeight;
+    return {
+        argv,
+        mode,
+        cdpEndpoint,
+        viewport: hasViewportOverride ? (0, viewport_js_namespaceObject.resolveViewportSize)({
+            width: viewportWidth,
+            height: viewportHeight
+        }, viewport_js_namespaceObject.defaultPuppeteerWindowViewportSize) : void 0
+    };
+}
+exports.parseWebCliOptions = __webpack_exports__.parseWebCliOptions;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "parseWebCliOptions"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/lib/cli.js

@@ -0,0 +1,54 @@
+"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);
+})();
+var __webpack_exports__ = {};
+const external_node_fs_namespaceObject = require("node:fs");
+const external_node_path_namespaceObject = require("node:path");
+const core_namespaceObject = require("@godscene/core");
+const cli_namespaceObject = require("@godscene/shared/cli");
+const external_dotenv_namespaceObject = require("dotenv");
+var external_dotenv_default = /*#__PURE__*/ __webpack_require__.n(external_dotenv_namespaceObject);
+const external_cli_options_js_namespaceObject = require("./cli-options.js");
+const external_mcp_tools_js_namespaceObject = require("./mcp-tools.js");
+const external_mcp_tools_cdp_js_namespaceObject = require("./mcp-tools-cdp.js");
+const external_mcp_tools_puppeteer_js_namespaceObject = require("./mcp-tools-puppeteer.js");
+const envFile = (0, external_node_path_namespaceObject.join)(process.cwd(), '.env');
+if ((0, external_node_fs_namespaceObject.existsSync)(envFile)) external_dotenv_default().config({
+    path: envFile
+});
+Promise.resolve().then(()=>{
+    const parsedOptions = (0, external_cli_options_js_namespaceObject.parseWebCliOptions)(process.argv.slice(2));
+    let tools;
+    tools = 'bridge' === parsedOptions.mode ? new external_mcp_tools_js_namespaceObject.WebMidsceneTools() : 'cdp' === parsedOptions.mode ? new external_mcp_tools_cdp_js_namespaceObject.WebCdpMidsceneTools(parsedOptions.cdpEndpoint) : new external_mcp_tools_puppeteer_js_namespaceObject.WebPuppeteerMidsceneTools(parsedOptions.viewport);
+    return (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-web', {
+        stripPrefix: 'web_',
+        argv: parsedOptions.argv,
+        version: "1.7.10",
+        extraCommands: (0, core_namespaceObject.createReportCliCommands)()
+    });
+}).catch((e)=>{
+    process.exit((0, cli_namespaceObject.reportCLIError)(e));
+});
+for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/lib/common/cache-helper.js

@@ -0,0 +1,66 @@
+"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 ("u" > 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__, {
+    judgeOrderSensitive: ()=>judgeOrderSensitive,
+    sanitizeXpaths: ()=>sanitizeXpaths,
+    buildRectFromElementInfo: ()=>buildRectFromElementInfo
+});
+const ai_model_namespaceObject = require("@godscene/core/ai-model");
+const sanitizeXpaths = (xpaths)=>{
+    if (!Array.isArray(xpaths)) return [];
+    return xpaths.filter((xpath)=>'string' == typeof xpath && xpath.length > 0);
+};
+async function judgeOrderSensitive(options, debug) {
+    if (!options?.targetDescription || !options?.modelConfig) return false;
+    try {
+        const judgeResult = await (0, ai_model_namespaceObject.AiJudgeOrderSensitive)(options.targetDescription, ai_model_namespaceObject.callAIWithObjectResponse, options.modelConfig);
+        debug("judged isOrderSensitive=%s for description: %s", judgeResult.isOrderSensitive, options.targetDescription);
+        return judgeResult.isOrderSensitive;
+    } catch (error) {
+        debug('Failed to judge isOrderSensitive: %O', error);
+        return false;
+    }
+}
+function buildRectFromElementInfo(elementInfo) {
+    const matchedRect = {
+        left: elementInfo.rect.left,
+        top: elementInfo.rect.top,
+        width: elementInfo.rect.width,
+        height: elementInfo.rect.height
+    };
+    return matchedRect;
+}
+exports.buildRectFromElementInfo = __webpack_exports__.buildRectFromElementInfo;
+exports.judgeOrderSensitive = __webpack_exports__.judgeOrderSensitive;
+exports.sanitizeXpaths = __webpack_exports__.sanitizeXpaths;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "buildRectFromElementInfo",
+    "judgeOrderSensitive",
+    "sanitizeXpaths"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/lib/common/viewport.js

@@ -0,0 +1,88 @@
+"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 ("u" > 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__, {
+    defaultViewportSize: ()=>defaultViewportSize,
+    defaultStaticPageViewportSize: ()=>defaultStaticPageViewportSize,
+    defaultViewportWidth: ()=>defaultViewportWidth,
+    resolveViewportSize: ()=>resolveViewportSize,
+    resolveWebViewportSize: ()=>resolveWebViewportSize,
+    defaultPuppeteerWindowViewportSize: ()=>defaultPuppeteerWindowViewportSize,
+    defaultViewportHeight: ()=>defaultViewportHeight
+});
+const utils_namespaceObject = require("@godscene/shared/utils");
+const defaultViewportWidth = 1440;
+const defaultViewportHeight = 800;
+const defaultViewportSize = {
+    width: defaultViewportWidth,
+    height: defaultViewportHeight
+};
+const defaultPuppeteerWindowViewportSize = {
+    width: defaultViewportWidth,
+    height: defaultViewportHeight
+};
+const defaultStaticPageViewportSize = {
+    width: defaultViewportWidth,
+    height: defaultViewportHeight
+};
+function parseViewportDimension(rawValue, name) {
+    const parsedValue = 'number' == typeof rawValue ? rawValue : Number(rawValue);
+    (0, utils_namespaceObject.assert)(Number.isInteger(parsedValue), `${name} must be a positive integer, but got ${rawValue}`);
+    (0, utils_namespaceObject.assert)(parsedValue > 0, `${name} must be greater than 0, but got ${rawValue}`);
+    return parsedValue;
+}
+function resolveViewportSize(viewport, fallback = defaultViewportSize) {
+    const width = viewport?.width === void 0 || null === viewport.width ? fallback.width : parseViewportDimension(viewport.width, 'viewportWidth');
+    const height = viewport?.height === void 0 || null === viewport.height ? fallback.height : parseViewportDimension(viewport.height, 'viewportHeight');
+    return {
+        width,
+        height
+    };
+}
+function resolveWebViewportSize(viewport, fallback = defaultViewportSize) {
+    return resolveViewportSize({
+        width: viewport?.viewportWidth,
+        height: viewport?.viewportHeight
+    }, fallback);
+}
+exports.defaultPuppeteerWindowViewportSize = __webpack_exports__.defaultPuppeteerWindowViewportSize;
+exports.defaultStaticPageViewportSize = __webpack_exports__.defaultStaticPageViewportSize;
+exports.defaultViewportHeight = __webpack_exports__.defaultViewportHeight;
+exports.defaultViewportSize = __webpack_exports__.defaultViewportSize;
+exports.defaultViewportWidth = __webpack_exports__.defaultViewportWidth;
+exports.resolveViewportSize = __webpack_exports__.resolveViewportSize;
+exports.resolveWebViewportSize = __webpack_exports__.resolveWebViewportSize;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "defaultPuppeteerWindowViewportSize",
+    "defaultStaticPageViewportSize",
+    "defaultViewportHeight",
+    "defaultViewportSize",
+    "defaultViewportWidth",
+    "resolveViewportSize",
+    "resolveWebViewportSize"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/lib/index.js

@@ -0,0 +1,66 @@
+"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 ("u" > 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__, {
+    PlaywrightAiFixture: ()=>index_js_namespaceObject.PlaywrightAiFixture,
+    StaticPageAgent: ()=>external_static_index_js_namespaceObject.StaticPageAgent,
+    PlaywrightAgent: ()=>index_js_namespaceObject.PlaywrightAgent,
+    PuppeteerAgent: ()=>external_puppeteer_index_js_namespaceObject.PuppeteerAgent,
+    StaticPage: ()=>external_static_index_js_namespaceObject.StaticPage,
+    PageAgent: ()=>agent_namespaceObject.Agent,
+    webPlaygroundPlatform: ()=>external_platform_js_namespaceObject.webPlaygroundPlatform,
+    WebCdpMidsceneTools: ()=>external_mcp_tools_cdp_js_namespaceObject.WebCdpMidsceneTools,
+    WebMidsceneTools: ()=>external_mcp_tools_js_namespaceObject.WebMidsceneTools
+});
+const index_js_namespaceObject = require("./playwright/index.js");
+const agent_namespaceObject = require("@godscene/core/agent");
+const external_puppeteer_index_js_namespaceObject = require("./puppeteer/index.js");
+const external_static_index_js_namespaceObject = require("./static/index.js");
+const external_mcp_tools_js_namespaceObject = require("./mcp-tools.js");
+const external_platform_js_namespaceObject = require("./platform.js");
+const external_mcp_tools_cdp_js_namespaceObject = require("./mcp-tools-cdp.js");
+exports.PageAgent = __webpack_exports__.PageAgent;
+exports.PlaywrightAgent = __webpack_exports__.PlaywrightAgent;
+exports.PlaywrightAiFixture = __webpack_exports__.PlaywrightAiFixture;
+exports.PuppeteerAgent = __webpack_exports__.PuppeteerAgent;
+exports.StaticPage = __webpack_exports__.StaticPage;
+exports.StaticPageAgent = __webpack_exports__.StaticPageAgent;
+exports.WebCdpMidsceneTools = __webpack_exports__.WebCdpMidsceneTools;
+exports.WebMidsceneTools = __webpack_exports__.WebMidsceneTools;
+exports.webPlaygroundPlatform = __webpack_exports__.webPlaygroundPlatform;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "PageAgent",
+    "PlaywrightAgent",
+    "PlaywrightAiFixture",
+    "PuppeteerAgent",
+    "StaticPage",
+    "StaticPageAgent",
+    "WebCdpMidsceneTools",
+    "WebMidsceneTools",
+    "webPlaygroundPlatform"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/lib/mcp-server.js

@@ -0,0 +1,73 @@
+"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 ("u" > 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__, {
+    mcpKitForAgent: ()=>mcpKitForAgent,
+    mcpServerForAgent: ()=>mcpServerForAgent,
+    WebMCPServer: ()=>WebMCPServer
+});
+const mcp_namespaceObject = require("@godscene/shared/mcp");
+const external_mcp_tools_js_namespaceObject = require("./mcp-tools.js");
+class WebMCPServer extends mcp_namespaceObject.BaseMCPServer {
+    createToolsManager() {
+        return new external_mcp_tools_js_namespaceObject.WebMidsceneTools();
+    }
+    constructor(toolsManager){
+        super({
+            name: '@godscene/web-bridge-mcp',
+            version: "1.7.10",
+            description: 'Control the browser using natural language commands'
+        }, toolsManager);
+    }
+}
+function mcpServerForAgent(agent) {
+    return (0, mcp_namespaceObject.createMCPServerLauncher)({
+        agent,
+        platformName: 'Web',
+        ToolsManagerClass: external_mcp_tools_js_namespaceObject.WebMidsceneTools,
+        MCPServerClass: WebMCPServer
+    });
+}
+async function mcpKitForAgent(agent) {
+    const toolsManager = new external_mcp_tools_js_namespaceObject.WebMidsceneTools();
+    const webAgent = agent;
+    toolsManager.setAgent(webAgent);
+    await toolsManager.initTools();
+    return {
+        description: 'Midscene Bridge MCP Server: Control the browser using natural language commands for navigation, clicking, input, hovering, screenshots waitFor, and achieving goals.',
+        tools: toolsManager.getToolDefinitions()
+    };
+}
+exports.WebMCPServer = __webpack_exports__.WebMCPServer;
+exports.mcpKitForAgent = __webpack_exports__.mcpKitForAgent;
+exports.mcpServerForAgent = __webpack_exports__.mcpServerForAgent;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "WebMCPServer",
+    "mcpKitForAgent",
+    "mcpServerForAgent"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});