@midscene/cli 1.12.10-beta-20260920072249.0 → 1.13.0

package/dist/lib/index.js

@@ -3014,7 +3014,6 @@ var __webpack_modules__ = {
         });
         var external_node_fs_ = __webpack_require__("node:fs");
         var external_node_path_ = __webpack_require__("node:path");
-        var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_);
         const external_node_crypto_namespaceObject = require("node:crypto");
         var core_ = __webpack_require__("@midscene/core");
         const common_namespaceObject = require("@midscene/shared/common");
@@ -3479,282 +3478,7 @@ var __webpack_modules__ = {
         }
         const external_puppeteer_namespaceObject = require("puppeteer");
         var external_puppeteer_default = /*#__PURE__*/ __webpack_require__.n(external_puppeteer_namespaceObject);
-        const external_http_server_namespaceObject = require("http-server");
-        const external_node_assert_namespaceObject = require("node:assert");
-        var external_node_assert_default = /*#__PURE__*/ __webpack_require__.n(external_node_assert_namespaceObject);
-        const agent_namespaceObject = require("@midscene/core/agent");
-        const utils_namespaceObject = require("@midscene/core/utils");
-        const bridge_mode_namespaceObject = require("@midscene/web/bridge-mode");
-        const debug = (0, logger_.getDebug)('create-yaml-player');
-        const cleanupWarning = (0, logger_.getDebug)('create-yaml-player', {
-            console: true
-        });
-        async function cleanupFailedPlayerSetup(freeFn) {
-            for (const cleanup of [
-                ...freeFn
-            ].reverse())try {
-                await cleanup.fn();
-            } catch (error) {
-                cleanupWarning(`failed to run ${cleanup.name} after YAML player setup failed`, error);
-            }
-        }
-        const launchServer = async (dir)=>new Promise((resolve)=>{
-                const server = (0, external_http_server_namespaceObject.createServer)({
-                    root: dir
-                });
-                server.listen(0, '127.0.0.1', ()=>{
-                    resolve(server);
-                });
-            });
-        function resolveReportFileName(yamlReportFileName, cliTestId, yamlTestId, fileName) {
-            if (void 0 !== yamlReportFileName) return yamlReportFileName;
-            const baseName = cliTestId ?? yamlTestId ?? fileName;
-            return (0, agent_namespaceObject.getReportFileName)(baseName);
-        }
-        function buildAgentOptions(yamlAgent, reportFileName, fileName) {
-            return {
-                ...yamlAgent || {},
-                cache: (0, utils_namespaceObject.processCacheConfig)(yamlAgent?.cache, fileName),
-                reportFileName
-            };
-        }
-        async function create_yaml_player_createYamlPlayer(file, script, options) {
-            const yamlScript = script || (0, yaml_.parseYamlScript)((0, external_node_fs_.readFileSync)(file, 'utf-8'), file);
-            const clonedYamlScript = structuredClone(yamlScript);
-            const fileName = (0, external_node_path_.basename)(file, (0, external_node_path_.extname)(file));
-            const preference = {
-                headed: options?.headed,
-                keepWindow: options?.keepWindow,
-                reportFileName: resolveReportFileName(clonedYamlScript.agent?.reportFileName, options?.testId, clonedYamlScript.agent?.testId, fileName)
-            };
-            const player = new yaml_.ScriptPlayer(clonedYamlScript, async ()=>{
-                const freeFn = [];
-                try {
-                    const resolvedWebTarget = (0, yaml_.resolveWebTarget)(clonedYamlScript);
-                    const webTarget = resolvedWebTarget?.target;
-                    const targetCount = [
-                        void 0 !== resolvedWebTarget,
-                        void 0 !== clonedYamlScript.android,
-                        void 0 !== clonedYamlScript.ios,
-                        void 0 !== clonedYamlScript.harmony,
-                        void 0 !== clonedYamlScript.computer,
-                        void 0 !== clonedYamlScript.interface
-                    ].filter(Boolean).length;
-                    if (targetCount > 1) {
-                        const specifiedTargets = [
-                            resolvedWebTarget?.source ?? null,
-                            void 0 !== clonedYamlScript.android ? 'android' : null,
-                            void 0 !== clonedYamlScript.ios ? 'ios' : null,
-                            void 0 !== clonedYamlScript.harmony ? 'harmony' : null,
-                            void 0 !== clonedYamlScript.computer ? 'computer' : null,
-                            void 0 !== clonedYamlScript.interface ? 'interface' : null
-                        ].filter(Boolean);
-                        throw new Error(`Only one target type can be specified, but found multiple: ${specifiedTargets.join(', ')}. Please specify only one of: page, browser, web, android, ios, harmony, computer, or interface.`);
-                    }
-                    if (void 0 !== webTarget) {
-                        if (resolvedWebTarget?.source === 'target') console.warn("target is deprecated, please use page or browser instead. See https://midscenejs.com/automate-with-scripts-in-yaml for more information. Sorry for the inconvenience.");
-                        let localServer;
-                        let urlToVisit;
-                        if (webTarget.serve) {
-                            external_node_assert_default()('string' == typeof webTarget.url, 'url is required in serve mode');
-                            localServer = await launchServer(webTarget.serve);
-                            const serverAddress = localServer.server.address();
-                            freeFn.push({
-                                name: 'local_server',
-                                fn: async ()=>{
-                                    if (!localServer) return;
-                                    await new Promise((resolve, reject)=>{
-                                        localServer?.server.close((error)=>{
-                                            if (error) reject(error);
-                                            else resolve();
-                                        });
-                                    });
-                                }
-                            });
-                            urlToVisit = webTarget.url.startsWith('/') ? `http://${serverAddress?.address}:${serverAddress?.port}${webTarget.url}` : `http://${serverAddress?.address}:${serverAddress?.port}/${webTarget.url}`;
-                            webTarget.url = urlToVisit;
-                        }
-                        if (webTarget.cdpEndpoint && webTarget.bridgeMode) throw new Error('cdpEndpoint and bridgeMode are mutually exclusive. Please specify only one.');
-                        if ('browser' === webTarget.mode && webTarget.bridgeMode) throw new Error('[midscene] browser mode does not support bridgeMode. Use page: or web.mode: page for bridge mode.');
-                        if (webTarget.cdpEndpoint) {
-                            const ownsCdpBrowser = !options?.browser;
-                            const cdpBrowser = options?.browser ?? await external_puppeteer_default().connect({
-                                browserWSEndpoint: webTarget.cdpEndpoint,
-                                defaultViewport: null,
-                                downloadBehavior: (0, puppeteer_agent_launcher_namespaceObject.buildDownloadBehavior)(webTarget.downloadPath)
-                            });
-                            if (webTarget.chromeArgs) console.warn('chromeArgs are not supported in CDP mode (browser is already running). They will be ignored.');
-                            let launchedAgent;
-                            try {
-                                launchedAgent = await (0, puppeteer_agent_launcher_namespaceObject.puppeteerAgentForTarget)(webTarget, {
-                                    ...preference,
-                                    ...buildAgentOptions(clonedYamlScript.agent, preference.reportFileName, fileName)
-                                }, cdpBrowser, options?.page, options?.browserContext);
-                            } catch (error) {
-                                if (ownsCdpBrowser) try {
-                                    cdpBrowser.disconnect();
-                                } catch (cleanupError) {
-                                    cleanupWarning('failed to disconnect the CDP browser after agent setup failed', cleanupError);
-                                }
-                                throw error;
-                            }
-                            const { agent, freeFn: newFreeFn } = launchedAgent;
-                            const cleanFreeFn = newFreeFn.filter((f)=>'puppeteer_browser' !== f.name);
-                            freeFn.push(...cleanFreeFn);
-                            if (ownsCdpBrowser) freeFn.push({
-                                name: 'cdp_browser_disconnect',
-                                fn: ()=>cdpBrowser.disconnect()
-                            });
-                            return {
-                                agent,
-                                freeFn
-                            };
-                        }
-                        if (!webTarget.bridgeMode) {
-                            const { agent, freeFn: newFreeFn } = await (0, puppeteer_agent_launcher_namespaceObject.puppeteerAgentForTarget)(webTarget, {
-                                ...preference,
-                                ...buildAgentOptions(clonedYamlScript.agent, preference.reportFileName, fileName)
-                            }, options?.browser, options?.page, options?.browserContext);
-                            freeFn.push(...newFreeFn);
-                            return {
-                                agent,
-                                freeFn
-                            };
-                        }
-                        external_node_assert_default()('newTabWithUrl' === webTarget.bridgeMode || 'currentTab' === webTarget.bridgeMode, `bridgeMode config value must be either "newTabWithUrl" or "currentTab", but got ${webTarget.bridgeMode}`);
-                        const bridgeUnsupportedKeys = [
-                            'userAgent',
-                            'viewportWidth',
-                            'viewportHeight',
-                            'deviceScaleFactor',
-                            'waitForNetworkIdle',
-                            'cookie',
-                            'extraHTTPHeaders',
-                            'downloadPath',
-                            'chromeArgs'
-                        ];
-                        const ignoredKeys = bridgeUnsupportedKeys.filter((key)=>null != webTarget[key]);
-                        if (ignoredKeys.length > 0) console.warn(`puppeteer options (${ignoredKeys.join(', ')}) are not supported in bridge mode. They will be ignored.`);
-                        const agent = new bridge_mode_namespaceObject.AgentOverChromeBridge({
-                            closeNewTabsAfterDisconnect: webTarget.closeNewTabsAfterDisconnect,
-                            closeConflictServer: true,
-                            ...buildAgentOptions(clonedYamlScript.agent, preference.reportFileName, fileName)
-                        });
-                        if ('newTabWithUrl' === webTarget.bridgeMode) await agent.connectNewTabWithUrl(webTarget.url);
-                        else {
-                            if (webTarget.url) console.warn('url will be ignored in bridge mode with "currentTab"');
-                            await agent.connectCurrentTab();
-                        }
-                        freeFn.push({
-                            name: 'destroy_agent_over_chrome_bridge',
-                            fn: ()=>agent.destroy()
-                        });
-                        return {
-                            agent,
-                            freeFn
-                        };
-                    }
-                    if (void 0 !== clonedYamlScript.android) {
-                        const androidTarget = clonedYamlScript.android;
-                        const { agentFromAdbDevice } = await import("@midscene/android");
-                        const agent = await agentFromAdbDevice(androidTarget?.deviceId, {
-                            ...androidTarget,
-                            ...buildAgentOptions(clonedYamlScript.agent, preference.reportFileName, fileName)
-                        });
-                        if (androidTarget?.launch) await agent.launch(androidTarget.launch);
-                        freeFn.push({
-                            name: 'destroy_android_agent',
-                            fn: ()=>agent.destroy()
-                        });
-                        return {
-                            agent,
-                            freeFn
-                        };
-                    }
-                    if (void 0 !== clonedYamlScript.ios) {
-                        const iosTarget = clonedYamlScript.ios;
-                        const { agentFromWebDriverAgent } = await import("@midscene/ios");
-                        const agent = await agentFromWebDriverAgent({
-                            ...iosTarget,
-                            ...buildAgentOptions(clonedYamlScript.agent, preference.reportFileName, fileName)
-                        });
-                        if (iosTarget?.launch) await agent.launch(iosTarget.launch);
-                        freeFn.push({
-                            name: 'destroy_ios_agent',
-                            fn: ()=>agent.destroy()
-                        });
-                        return {
-                            agent,
-                            freeFn
-                        };
-                    }
-                    if (void 0 !== clonedYamlScript.harmony) {
-                        const harmonyTarget = clonedYamlScript.harmony;
-                        const { agentFromHdcDevice } = await import("@midscene/harmony");
-                        const agent = await agentFromHdcDevice(harmonyTarget?.deviceId, {
-                            ...harmonyTarget,
-                            ...buildAgentOptions(clonedYamlScript.agent, preference.reportFileName, fileName)
-                        });
-                        if (harmonyTarget?.launch) await agent.launch(harmonyTarget.launch);
-                        freeFn.push({
-                            name: 'destroy_harmony_agent',
-                            fn: ()=>agent.destroy()
-                        });
-                        return {
-                            agent,
-                            freeFn
-                        };
-                    }
-                    if (void 0 !== clonedYamlScript.computer) {
-                        const computerTarget = clonedYamlScript.computer;
-                        const { agentForComputer } = await import("@midscene/computer");
-                        const agent = await agentForComputer({
-                            ...computerTarget,
-                            ...buildAgentOptions(clonedYamlScript.agent, preference.reportFileName, fileName)
-                        });
-                        freeFn.push({
-                            name: 'destroy_computer_agent',
-                            fn: ()=>agent.destroy()
-                        });
-                        return {
-                            agent,
-                            freeFn
-                        };
-                    }
-                    if (void 0 !== clonedYamlScript.interface) {
-                        const interfaceTarget = clonedYamlScript.interface;
-                        const moduleSpecifier = interfaceTarget.module;
-                        let finalModuleSpecifier;
-                        if (moduleSpecifier.startsWith('./') || moduleSpecifier.startsWith('../') || external_node_path_default().isAbsolute(moduleSpecifier)) {
-                            const resolvedPath = (0, external_node_path_.join)(process.cwd(), moduleSpecifier);
-                            finalModuleSpecifier = resolvedPath;
-                        } else finalModuleSpecifier = moduleSpecifier;
-                        debug('importing module config', interfaceTarget.module, 'with export config', interfaceTarget.export, 'final module specifier', finalModuleSpecifier);
-                        const importedModule = await import(finalModuleSpecifier);
-                        const DeviceClass = interfaceTarget.export ? importedModule[interfaceTarget.export] : importedModule.default || importedModule;
-                        debug('DeviceClass', DeviceClass, 'with param', interfaceTarget.param);
-                        const device = new DeviceClass(interfaceTarget.param || {});
-                        debug('creating agent from device', device);
-                        const agent = (0, agent_namespaceObject.createAgent)(device, buildAgentOptions(clonedYamlScript.agent, preference.reportFileName, fileName));
-                        freeFn.push({
-                            name: 'destroy_general_interface_agent',
-                            fn: ()=>{
-                                agent.destroy();
-                            }
-                        });
-                        return {
-                            agent,
-                            freeFn
-                        };
-                    }
-                    throw new Error('No valid interface configuration found in the yaml script, should be either "web", "android", "ios", "harmony", "computer", or "interface"');
-                } catch (error) {
-                    await cleanupFailedPlayerSetup(freeFn);
-                    throw error;
-                }
-            }, void 0, file);
-            return player;
-        }
+        const yaml_runtime_namespaceObject = require("@midscene/test/internal/yaml-runtime");
         var chalk_source = __webpack_require__("../../node_modules/.pnpm/chalk@4.1.2/node_modules/chalk/source/index.js");
         var source_default = /*#__PURE__*/ __webpack_require__.n(chalk_source);
         function resolveIsTTY(env = process.env, stdoutIsTTY = process.stdout.isTTY) {
@@ -4401,7 +4125,7 @@ var __webpack_modules__ = {
                 const createFilePlayerContext = async (context)=>{
                     const fileContext = {
                         file: context.file,
-                        player: await create_yaml_player_createYamlPlayer(context.file, context.executionConfig, context.options)
+                        player: await (0, yaml_runtime_namespaceObject.createYamlPlayer)(context.file, context.executionConfig, context.options)
                     };
                     fileContextsByCaseId.set(context.caseId, fileContext);
                     return fileContext;
@@ -4446,7 +4170,7 @@ var __webpack_modules__ = {
                                 if (attempt > 1) {
                                     if (context.executionConfig.agent?.reportFileName) attempts[attempts.length - 1] = execution_summary_preserveYamlAttemptReport(attempts[attempts.length - 1]);
                                     await beforeRetry?.();
-                                    allFileContext.player = await create_yaml_player_createYamlPlayer(context.file, context.executionConfig, context.options);
+                                    allFileContext.player = await (0, yaml_runtime_namespaceObject.createYamlPlayer)(context.file, context.executionConfig, context.options);
                                 }
                                 if (onProgress) reportProgressSnapshot(allFileContext, attempt, totalAttempts);
                                 else if (!isTTY) {
@@ -5069,7 +4793,9 @@ defineYamlBatchTest(test, testOptions);
         "use strict";
         var core_ = __webpack_require__("@midscene/core");
         const cli_namespaceObject = require("@midscene/shared/cli");
-        var package_namespaceObject = JSON.parse('{"rE":"1.12.10-beta-20260920072249.0"}');
+        var package_namespaceObject = {
+            rE: "1.13.0"
+        };
         var external_node_fs_ = __webpack_require__("node:fs");
         var external_node_fs_namespaceObject = /*#__PURE__*/ __webpack_require__.t(external_node_fs_, 2);
         var external_node_path_ = __webpack_require__("node:path");
@@ -10685,7 +10411,7 @@ defineYamlBatchTest(test, testOptions);
         const parseProcessArgs = async ()=>{
             const args = yargs(hideBin(process.argv)).parserConfiguration({
                 'dot-notation': true
-            }).usage(`Midscene.js helps you automate browser actions, assertions, and data extraction by AI. 
+            }).usage(`Midscene legacy YAML runner executes tasks/flow scripts with AI.
 Homepage: https://midscenejs.com
 Github: https://github.com/web-infra-dev/midscene
 
@@ -10704,7 +10430,7 @@ Usage:
                 },
                 config: {
                     type: 'string',
-                    description: 'Path to a configuration file. Options in this file are used as defaults.'
+                    description: 'Path to a legacy YAML batch configuration file. Options in this file are used as defaults.'
                 },
                 summary: {
                     type: 'string',
@@ -10746,7 +10472,7 @@ Usage:
                     type: 'boolean',
                     description: 'Whether to dismiss the HarmonyOS keyboard after text input'
                 }
-            }).version('version', 'Show version number', "1.12.10-beta-20260920072249.0").help().epilogue(`For complete list of configuration options, please visit:
+            }).version('version', 'Show version number', "1.13.0").help().epilogue(`For complete list of configuration options, please visit:
   • Web options: https://midscenejs.com/automate-with-scripts-in-yaml#the-web-part
   • Android options: https://midscenejs.com/automate-with-scripts-in-yaml#the-android-part
   • HarmonyOS options: https://midscenejs.com/automate-with-scripts-in-yaml#the-harmony-part
@@ -10757,7 +10483,9 @@ Examples:
   $0 script.yaml --android.device-id emulator-5554 --android.ime-strategy yadb-for-non-ascii
   $0 script.yaml --android.device-id emulator-5554 --android.screenshot-strategy always-yadb
   $0 script.yaml --harmony.device-id 127.0.0.1:5555
-  $0 script.yaml --ios.wda-port 8100 --ios.auto-dismiss-keyboard`).wrap(yargs().terminalWidth());
+  $0 script.yaml --ios.wda-port 8100 --ios.auto-dismiss-keyboard
+
+Native cases/steps Test projects use the midscene-test command.`).wrap(yargs().terminalWidth());
             const argv = await args.argv;
             debug('argv', argv);
             const transformedArgv = {
@@ -12868,6 +12596,7 @@ Examples:
                 throw new Error('Function yaml.' + from + " is removed in js-yaml 4. Use yaml." + to + ' instead, which is now safe by default.');
             };
         }
+        var JSON_SCHEMA = json;
         var load = loader.load;
         loader.loadAll;
         dumper.dump;
@@ -13170,6 +12899,42 @@ Examples:
             io.stderr(`Unknown midscene model command: ${action}\n\n${MODEL_COMMAND_USAGE}`);
             return 1;
         }
+        const test_runner_namespaceObject = require("@midscene/core/internal/test-runner");
+        const probeWorkflowFormat = (file)=>{
+            try {
+                const content = (0, external_node_fs_.readFileSync)(file, 'utf8').replace(/\$\{[^}\r\n]*\}/g, 'MIDSCENE_ENV');
+                return (0, test_runner_namespaceObject.classifyWorkflowDocumentFormat)(load(content, {
+                    schema: JSON_SCHEMA
+                }));
+            } catch  {
+                return 'unknown';
+            }
+        };
+        const assertLegacyBatchConfigPath = (configPath)=>{
+            if (![
+                '.yaml',
+                '.yml'
+            ].includes((0, external_node_path_.extname)(configPath).toLowerCase())) throw new Error(`midscene --config only accepts a legacy YAML batch config: ${configPath}. Run a native Test project config with \`midscene-test --config ${configPath}\`.`);
+        };
+        const assertLegacyWorkflowSelection = (files)=>{
+            const nativeFiles = [];
+            const mixedFiles = [];
+            for (const file of new Set(files.map((item)=>(0, external_node_path_.resolve)(item)))){
+                const format = probeWorkflowFormat(file);
+                if ('native' === format) nativeFiles.push(file);
+                else if ('mixed' === format) mixedFiles.push(file);
+            }
+            if (0 === nativeFiles.length && 0 === mixedFiles.length) return;
+            const details = [
+                ...nativeFiles.map((file)=>`- native cases/steps: ${file}`),
+                ...mixedFiles.map((file)=>`- mixed tasks/flow and cases/steps: ${file}`)
+            ];
+            throw new Error([
+                'midscene only runs legacy tasks/flow YAML.',
+                ...details,
+                'Run native files with `midscene-test`, and keep legacy and native formats in separate files and command invocations.'
+            ].join('\n'));
+        };
         Promise.resolve((async ()=>{
             const rawArgs = process.argv.slice(2);
             const [firstArg] = rawArgs;
@@ -13215,6 +12980,7 @@ Examples:
             };
             let config;
             if (configFile) {
+                assertLegacyBatchConfigPath(configFile);
                 config = await createConfig(configFile, configOptions);
                 console.log(`   Config file: ${configFile}`);
             } else if (cmdFiles && cmdFiles.length > 0) {
@@ -13233,6 +12999,12 @@ Examples:
                 console.error('Could not create a valid configuration.');
                 process.exit(1);
             }
+            assertLegacyWorkflowSelection([
+                ...config.setup ? [
+                    config.setup
+                ] : [],
+                ...config.files
+            ]);
             loadDotenvConfig({
                 dotenvDebug: config.dotenvDebug,
                 dotenvOverride: config.dotenvOverride,