@midscene/test 1.12.4 → 1.12.5-beta-20260907092148.0

package/dist/es/1~891.mjs

@@ -0,0 +1,430 @@
+import { confirm as prompts_confirm, input, select as prompts_select } from "@inquirer/prompts";
+import { execa } from "execa";
+import yargs from "yargs/yargs";
+export const __rspack_esm_id = "891";
+export const __rspack_esm_ids = [
+    "891"
+];
+export const __webpack_modules__ = {
+    "./src/cli/create-command.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        __webpack_require__.d(__webpack_exports__, {
+            runCreateCommand: ()=>runCreateCommand
+        });
+        var external_node_fs_ = __webpack_require__("node:fs");
+        var external_node_path_ = __webpack_require__("node:path");
+        const createPackageManagers = [
+            'npm',
+            'pnpm'
+        ];
+        const packageManagerCommands = {
+            npm: {
+                install: [
+                    'install',
+                    '--workspaces=false'
+                ],
+                describe: [
+                    'exec',
+                    '--no',
+                    '--workspaces=false',
+                    '--',
+                    'midscene-test',
+                    'nodes'
+                ],
+                installChromium: 'npm exec -- playwright install chromium'
+            },
+            pnpm: {
+                install: [
+                    'install',
+                    '--ignore-workspace'
+                ],
+                describe: [
+                    'exec',
+                    'midscene-test',
+                    'nodes'
+                ],
+                installChromium: 'pnpm exec playwright install chromium'
+            }
+        };
+        function detectPackageManager(userAgent) {
+            return userAgent?.startsWith('pnpm/') ? 'pnpm' : 'npm';
+        }
+        var package_namespaceObject = JSON.parse('{"rE":"1.12.5-beta-20260907092148.0"}');
+        const createPlatforms = [
+            'web',
+            'android',
+            'ios',
+            'harmony',
+            'computer'
+        ];
+        const createPlatformLabels = {
+            web: 'Web (Playwright)',
+            android: 'Android',
+            ios: 'iOS',
+            harmony: 'HarmonyOS',
+            computer: 'Desktop (Computer)'
+        };
+        function parseNodePackageSpec(spec) {
+            const match = /^(?:(@[a-z0-9][a-z0-9._-]*)\/)?([a-z0-9][a-z0-9._-]*)(?:@([a-zA-Z0-9^~*>=<|. +_-]+))?$/.exec(spec);
+            if (!match || void 0 !== match[3] && !match[3].trim()) throw new Error(`Invalid Node package "${spec}". Use an npm package name with an optional version, such as @acme/test-nodes@1.2.0.`);
+            return {
+                name: `${match[1] ? `${match[1]}/` : ''}${match[2]}`,
+                version: match[3] ?? 'latest'
+            };
+        }
+        const platformImports = {
+            web: `import { PlaywrightAgent } from '@midscene/web/playwright/agent';
+import { createPlaywrightNodes } from '@midscene/test/playwright';
+import { chromium, type Page } from 'playwright';`,
+            android: "import { AndroidAgent, agentFromAdbDevice } from '@midscene/android';",
+            ios: "import { IOSAgent, agentFromWebDriverAgent } from '@midscene/ios';",
+            harmony: "import { HarmonyAgent, agentFromHdcDevice } from '@midscene/harmony';",
+            computer: "import { ComputerAgent, agentForComputer } from '@midscene/computer';"
+        };
+        const agentClasses = {
+            web: 'PlaywrightAgent',
+            android: 'AndroidAgent',
+            ios: 'IOSAgent',
+            harmony: 'HarmonyAgent',
+            computer: 'ComputerAgent'
+        };
+        const platformSetup = {
+            web: `    const browser = await chromium.launch({ headless: env.HEADLESS !== 'false' });
+    onTeardown(() => browser.close());
+    const page = await browser.newPage();
+    const context: ProjectContext = { page };
+    onTeardown(async () => { await context.agent?.destroy(); });
+    return context;`,
+            android: `    const agent = await agentFromAdbDevice(env.ANDROID_DEVICE_ID || undefined);
+    onTeardown(() => agent.destroy());
+    return { agent };`,
+            ios: `    const port = Number(env.WDA_PORT || 8100);
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+      throw new Error('WDA_PORT must be an integer between 1 and 65535.');
+    }
+    const agent = await agentFromWebDriverAgent({
+      wdaHost: env.WDA_HOST || 'localhost',
+      wdaPort: port,
+    });
+    onTeardown(() => agent.destroy());
+    return { agent };`,
+            harmony: `    const agent = await agentFromHdcDevice(env.HARMONY_DEVICE_ID || undefined);
+    onTeardown(() => agent.destroy());
+    return { agent };`,
+            computer: `    const agent = await agentForComputer({
+      displayId: env.COMPUTER_DISPLAY_ID || undefined,
+    });
+    onTeardown(() => agent.destroy());
+    return { agent };`
+        };
+        const platformEnv = {
+            web: 'HEADLESS=true\n',
+            android: '# Optional: choose a device from adb devices.\nANDROID_DEVICE_ID=\n',
+            ios: 'WDA_HOST=localhost\nWDA_PORT=8100\n',
+            harmony: '# Optional: choose a device from hdc list targets.\nHARMONY_DEVICE_ID=\n',
+            computer: '# Optional: select a display; leave empty for the default display.\nCOMPUTER_DISPLAY_ID=\n# Enable Xvfb on headless Linux after installing its dependencies.\nMIDSCENE_COMPUTER_HEADLESS_LINUX=false\n'
+        };
+        const platformInstructions = {
+            android: 'Connect an Android device and verify it with `adb devices`. Set ANDROID_DEVICE_ID to select a device.',
+            ios: 'Start WebDriverAgent and set WDA_HOST and WDA_PORT for your iOS device.',
+            harmony: 'Connect a HarmonyOS device and verify it with `hdc list targets`. Set HARMONY_DEVICE_ID to select a device. Set HDC_HOME if hdc is not on PATH.',
+            computer: 'Prepare the local desktop using the [desktop setup guide](https://midscenejs.com/platforms/desktop.html), including system dependencies and permissions. Set COMPUTER_DISPLAY_ID to select a display. For headless Linux, install Xvfb and enable MIDSCENE_COMPUTER_HEADLESS_LINUX.'
+        };
+        function createProjectFiles(name, platform, packages, packageManager) {
+            const instructions = 'web' === platform ? `Install Chromium before the first test: \`${packageManagerCommands[packageManager].installChromium}\`.` : platformInstructions[platform];
+            const agentClass = agentClasses[platform];
+            const imports = packages.map((pkg, index)=>`import { createMidsceneTestNodes as createPackageNodes${index} } from ${JSON.stringify(pkg.name)};`).join('\n');
+            const extraNodes = packages.map((_, index)=>`    ...createPackageNodes${index}<ProjectContext>({ platform: '${platform}', getAgent }),`).join('\n');
+            const config = `import { fileURLToPath } from 'node:url';
+import { config as loadEnv } from 'dotenv';
+import type { NodeExecutionContext } from '@midscene/test';
+import { defineProjectSetup, defineTestProject } from '@midscene/test/config';
+import { createMidsceneNodes } from '@midscene/test/midscene';
+${platformImports[platform]}
+${imports}
+
+loadEnv({ path: fileURLToPath(new URL('.env', import.meta.url)) });
+
+interface ProjectContext {
+${'web' === platform ? '  page: Page;\n  agent?: PlaywrightAgent;' : `  agent: ${agentClass};`}
+}
+
+const getAgent = ({ context }: NodeExecutionContext<unknown, ProjectContext>) => {
+${'web' === platform ? '  context.agent ??= new PlaywrightAgent(context.page);' : ''}
+  return context.agent;
+};
+
+const setup = defineProjectSetup<ProjectContext>({
+  name: '${platform}',
+  platform: '${platform}',
+  async setup({ env, onTeardown }) {
+${platformSetup[platform]}
+  },
+});
+
+export default defineTestProject<ProjectContext>({
+  projects: [{
+    name: '${platform}',
+    platform: '${platform}',
+    setup,
+    files: { include: ['cases/**/*.{yaml,yml}'] },
+  }],
+  nodes: [
+    ...createMidsceneNodes<ProjectContext>({ agentClass: ${agentClass}, getAgent }),
+${'web' === platform ? '    ...createPlaywrightNodes<ProjectContext>({ getPage: ({ context }) => context.page }),' : ''}
+${extraNodes}
+  ],
+});
+`;
+            const dependencies = {
+                '@midscene/test': package_namespaceObject.rE,
+                [`@midscene/${platform}`]: package_namespaceObject.rE,
+                '@types/node': '^20.0.0',
+                dotenv: '^16.4.5',
+                typescript: '^5.8.3',
+                ...'web' === platform ? {
+                    playwright: '^1.45.0'
+                } : {}
+            };
+            for (const pkg of packages){
+                if (Object.hasOwn(dependencies, pkg.name)) throw new Error(`Node package "${pkg.name}" conflicts with a generated project dependency.`);
+                dependencies[pkg.name] = pkg.version;
+            }
+            const env = platformEnv[platform];
+            return {
+                'package.json': `${JSON.stringify({
+                    name,
+                    private: true,
+                    type: 'module',
+                    scripts: {
+                        test: 'midscene-test',
+                        nodes: 'midscene-test nodes',
+                        postinstall: 'midscene-test nodes'
+                    },
+                    engines: {
+                        node: '^20.19.0 || ^22.12.0 || >=24.0.0'
+                    },
+                    devDependencies: dependencies
+                }, null, 2)}\n`,
+                'midscene.config.ts': config,
+                'tsconfig.json': `${JSON.stringify({
+                    compilerOptions: {
+                        target: 'ES2022',
+                        module: 'ESNext',
+                        moduleResolution: 'Bundler',
+                        strict: true,
+                        noEmit: true,
+                        skipLibCheck: true,
+                        types: [
+                            'node'
+                        ]
+                    },
+                    include: [
+                        'midscene.config.ts'
+                    ]
+                }, null, 2)}\n`,
+                'cases/example.yaml': 'web' === platform ? 'cases:\n  - name: Open example.com\n    steps:\n      - gotoUrl: https://example.com\n      - aiAssert: The page displays the heading Example Domain\n' : 'computer' === platform ? 'cases:\n  - name: Inspect the desktop\n    steps:\n      - aiAsk: Describe the current desktop\n' : 'cases:\n  - name: Inspect the home screen\n    steps:\n      - home: {}\n      - aiAsk: Describe the current screen\n',
+                '.env.example': `# Copy this file to .env and configure your model before running tests.\n# See https://midscenejs.com/model-config.html\nMIDSCENE_MODEL_BASE_URL=\nMIDSCENE_MODEL_API_KEY=\nMIDSCENE_MODEL_NAME=\nMIDSCENE_MODEL_FAMILY=\n\n${env}`,
+                '.gitignore': 'node_modules/\n.env\nmidscene_run/\n',
+                'README.md': `# ${name}\n\nA Midscene Test Runner project for ${platform}.\n\nIf you skipped installation during creation, run \`${packageManager} ${packageManagerCommands[packageManager].install.join(' ')}\`. The \`postinstall\` script automatically generates \`midscene-node-reference.md\` after each dependency installation. If lifecycle scripts are disabled, run \`${packageManager} run nodes\` manually.\n\nCopy \`.env.example\` to \`.env\` and fill in your [model configuration](https://midscenejs.com/model-config.html).\n\n${instructions}\n\nRun tests with \`${packageManager} test\`. Read \`midscene-node-reference.md\` for the available Nodes and their inputs.\n\nAfter changing Node registrations in \`midscene.config.ts\`, run \`${packageManager} run nodes\` to refresh the reference. This loads the configuration without connecting to a device or running tests. Extension factories must only acquire runtime resources inside Node execution.\n\n${packages.length ? `Node packages: ${packages.map((pkg)=>`\`${pkg.name}\``).join(', ')}. Their \`createMidsceneTestNodes\` factories are imported in the configuration.\n\n` : ''}Reports are written to \`midscene_run/report/\`.\n`
+            };
+        }
+        const createParser = ()=>yargs().scriptName('midscene-test create').usage('Usage: $0 [directory] [options]').parserConfiguration({
+                'parse-positional-numbers': false,
+                'greedy-arrays': false,
+                'camel-case-expansion': false,
+                'boolean-negation': false
+            }).option('platform', {
+                type: 'string',
+                choices: createPlatforms,
+                requiresArg: true,
+                description: 'Platform preset (prompt if omitted)'
+            }).option('with', {
+                type: 'array',
+                string: true,
+                nargs: 1,
+                requiresArg: true,
+                description: 'npm Node package, optionally versioned (repeatable)'
+            }).option('package-manager', {
+                type: 'string',
+                choices: createPackageManagers,
+                requiresArg: true,
+                description: 'Package manager (prompt if omitted; detect without prompts, falling back to npm)'
+            }).option('yes', {
+                type: 'boolean',
+                alias: 'y',
+                default: false,
+                description: 'Disable prompts and install dependencies; directory and platform must be supplied'
+            }).option('skip-install', {
+                type: 'boolean',
+                default: false,
+                description: 'Create files without installing dependencies or generating midscene-node-reference.md'
+            }).demandCommand(0, 1, '', 'Only one project directory is allowed.').example('$0', 'Choose a directory and platform interactively').example('$0 my-tests --platform web', 'Create a Web project').example('$0 . --platform android --with @acme/test-nodes@1.2.0', 'Include a Node package').epilogue("Optionally installs dependencies with the selected package manager. The generated postinstall script creates midscene-node-reference.md after installation.\nNode packages must export a synchronous createMidsceneTestNodes(options) factory.\nExisting files are never overwritten. Setup and tests are not run during creation.").help('help').alias('help', 'h').version(false).strict().exitProcess(false).showHelpOnFail(false).fail((message, error)=>{
+                throw error ?? new Error(message);
+            }).wrap(100);
+        function parseCreateArgs(args, onOutput) {
+            const values = createParser().parseSync(args, {}, (error, _argv, output)=>{
+                if (error) throw error;
+                if (output) onOutput?.(output);
+            });
+            const directory = void 0 === values._[0] ? void 0 : String(values._[0]);
+            if (void 0 !== directory && !directory.trim()) throw new Error('Project directory must not be empty.');
+            const packages = (values.with ?? []).map(parseNodePackageSpec);
+            const seen = new Set();
+            for (const pkg of packages){
+                if (seen.has(pkg.name)) throw new Error(`Node package "${pkg.name}" was specified more than once.`);
+                seen.add(pkg.name);
+            }
+            return {
+                directory,
+                platform: values.platform,
+                packageManager: values['package-manager'],
+                packages,
+                yes: values.yes ?? false,
+                skipInstall: values['skip-install'] ?? false,
+                help: true === values.help
+            };
+        }
+        const promptDirectory = ()=>input({
+                message: 'Project directory:',
+                default: 'my-tests',
+                validate: (value)=>value.trim().length > 0 || 'Project directory must not be empty.'
+            });
+        const selectPlatform = ()=>prompts_select({
+                message: 'Select a platform:',
+                choices: createPlatforms.map((platform)=>({
+                        name: createPlatformLabels[platform],
+                        value: platform
+                    }))
+            });
+        const selectPackageManager = (defaultValue)=>prompts_select({
+                message: 'Select a package manager:',
+                choices: createPackageManagers.map((value)=>({
+                        name: value,
+                        value
+                    })),
+                default: defaultValue
+            });
+        const runPackageManager = async (packageManager, args, cwd, captureOutput = false)=>{
+            const result = await execa(packageManager, args, {
+                cwd,
+                stdin: 'inherit',
+                stdout: captureOutput ? 'pipe' : 'inherit',
+                stderr: 'inherit',
+                stripFinalNewline: false
+            });
+            return result.stdout ?? '';
+        };
+        const statIfPresent = (path)=>{
+            try {
+                return (0, external_node_fs_.lstatSync)(path);
+            } catch (error) {
+                if ('ENOENT' === error.code) return;
+                throw error;
+            }
+        };
+        function checkDestinations(root, filenames) {
+            const conflicts = [];
+            for (const filename of filenames){
+                const path = (0, external_node_path_.resolve)(root, filename);
+                if (statIfPresent(path)) conflicts.push(path);
+                let parent = (0, external_node_path_.dirname)(path);
+                while(true){
+                    const stat = statIfPresent(parent);
+                    if (stat && !stat.isDirectory()) conflicts.push(parent);
+                    if (parent === root || parent === (0, external_node_path_.dirname)(parent)) break;
+                    parent = (0, external_node_path_.dirname)(parent);
+                }
+            }
+            if (conflicts.length) throw new Error(`Cannot create project; these paths already exist or are not directories:\n${[
+                ...new Set(conflicts)
+            ].join('\n')}\nChoose another directory or move the conflicting files.`);
+        }
+        async function runCreateCommand(args, io, overrides = {}) {
+            const options = parseCreateArgs(args, (message)=>io.log(message));
+            if (options.help) return;
+            const services = {
+                cwd: process.cwd(),
+                interactive: Boolean(process.stdin.isTTY && process.stdout.isTTY),
+                userAgent: process.env.npm_config_user_agent,
+                promptDirectory,
+                selectPlatform,
+                selectPackageManager,
+                confirmInstall: ()=>prompts_confirm({
+                        message: 'Install dependencies and generate midscene-node-reference.md now?',
+                        default: true
+                    }),
+                runPackageManager,
+                ...overrides
+            };
+            if ((!options.directory || !options.platform) && (options.yes || !services.interactive)) throw new Error('Project directory and --platform are required without prompts. Example: midscene-test create my-tests --platform web');
+            let directory;
+            let platform;
+            let packageManager;
+            try {
+                directory = options.directory ?? (await services.promptDirectory()).trim();
+                platform = options.platform ?? await services.selectPlatform();
+                const defaultPackageManager = detectPackageManager(services.userAgent);
+                packageManager = options.packageManager ?? (services.interactive && !options.yes ? await services.selectPackageManager(defaultPackageManager) : defaultPackageManager);
+            } catch (error) {
+                if (error instanceof Error && [
+                    'ExitPromptError',
+                    'AbortPromptError'
+                ].includes(error.name)) throw new Error('Project creation cancelled.');
+                throw error;
+            }
+            const root = (0, external_node_path_.resolve)(services.cwd, directory);
+            const name = (0, external_node_path_.basename)(root).toLowerCase().replace(/[^a-z0-9._-]/g, '-').replace(/^[._-]+/, '') || 'midscene-tests';
+            const commands = packageManagerCommands[packageManager];
+            const files = createProjectFiles(name, platform, options.packages, packageManager);
+            checkDestinations(root, [
+                ...Object.keys(files),
+                'midscene-node-reference.md',
+                'pnpm-lock.yaml',
+                'package-lock.json',
+                'npm-shrinkwrap.json'
+            ]);
+            for (const [filename, content] of Object.entries(files)){
+                const path = (0, external_node_path_.resolve)(root, filename);
+                (0, external_node_fs_.mkdirSync)((0, external_node_path_.dirname)(path), {
+                    recursive: true
+                });
+                (0, external_node_fs_.writeFileSync)(path, content, {
+                    flag: 'wx'
+                });
+            }
+            io.log(`Created ${platform} project files in ${root}`);
+            let install = !options.skipInstall;
+            if (install && services.interactive && !options.yes) try {
+                install = await services.confirmInstall();
+            } catch (error) {
+                if (error instanceof Error && [
+                    'ExitPromptError',
+                    'AbortPromptError'
+                ].includes(error.name)) throw new Error(`Project creation cancelled. Project files are preserved in ${root}.\nIn that directory, run ${packageManager} ${commands.install.join(' ')} to install dependencies and generate midscene-node-reference.md.`);
+                throw error;
+            }
+            if (!install) return void io.log(`Project files ready: ${root}\nNext: run ${packageManager} ${commands.install.join(' ')} in the project directory. The postinstall script will generate midscene-node-reference.md.\nThen follow README.md to configure your model and run tests.`);
+            io.log(`Installing dependencies with ${packageManager}...`);
+            try {
+                await services.runPackageManager(packageManager, commands.install, root);
+            } catch (error) {
+                throw new Error(`Dependency installation or postinstall Node reference generation failed. Project files are preserved in ${root}.\nIn that directory, run ${packageManager} ${commands.install.join(' ')}, then ${packageManager} run nodes if lifecycle scripts are disabled.\nIf postinstall failed, check midscene.config.ts and the Node package factories, then run ${packageManager} run nodes.\n${error instanceof Error ? error.message : String(error)}`);
+            }
+            try {
+                const referencePath = (0, external_node_path_.resolve)(root, 'midscene-node-reference.md');
+                const generatedByPostinstall = Boolean(statIfPresent(referencePath));
+                if (!generatedByPostinstall) {
+                    io.log('Generating Node reference...');
+                    await services.runPackageManager(packageManager, commands.describe, root);
+                }
+                const markdown = (0, external_node_fs_.readFileSync)(referencePath, 'utf8');
+                if (!markdown.startsWith('<!-- Generated by `midscene-test nodes`.')) throw new Error('nodes did not generate a valid Node reference.');
+            } catch (error) {
+                throw new Error(`Node reference generation failed. Project files are preserved in ${root}.\nCheck that each Node package exports createMidsceneTestNodes(options), returns a Node array synchronously, and does not register duplicate names.\nFix midscene.config.ts, then run ${packageManager} run nodes in the project directory.\n${error instanceof Error ? error.message : String(error)}`);
+            }
+            io.log(`Project ready: ${root}\nNode reference: ${(0, external_node_path_.resolve)(root, 'midscene-node-reference.md')}\nNext: copy .env.example to .env and configure your model.${'web' === platform ? `\nInstall Chromium: ${commands.installChromium}` : 'computer' === platform ? '\nPrepare desktop dependencies and permissions as described in README.md.' : '\nConfigure your device connection in .env.'}\nRun tests from the project directory: ${packageManager} test`);
+        }
+    }
+};
+
+//# sourceMappingURL=1~891.mjs.map

package/dist/es/1~891.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"1~891.mjs","sources":["../../src/cli/create-package-manager.ts","../../src/cli/create-template.ts","../../src/cli/create-command.ts"],"sourcesContent":["export const createPackageManagers = ['npm', 'pnpm'] as const;\nexport type CreatePackageManager = (typeof createPackageManagers)[number];\n\nexport const packageManagerCommands: Record<\n  CreatePackageManager,\n  { install: string[]; describe: string[]; installChromium: string }\n> = {\n  npm: {\n    install: ['install', '--workspaces=false'],\n    describe: [\n      'exec',\n      '--no',\n      '--workspaces=false',\n      '--',\n      'midscene-test',\n      'nodes',\n    ],\n    installChromium: 'npm exec -- playwright install chromium',\n  },\n  pnpm: {\n    install: ['install', '--ignore-workspace'],\n    describe: ['exec', 'midscene-test', 'nodes'],\n    installChromium: 'pnpm exec playwright install chromium',\n  },\n};\n\nexport function detectPackageManager(userAgent?: string): CreatePackageManager {\n  return userAgent?.startsWith('pnpm/') ? 'pnpm' : 'npm';\n}\n","import { version } from '../../package.json';\nimport {\n  type CreatePackageManager,\n  packageManagerCommands,\n} from './create-package-manager';\n\nexport const createPlatforms = [\n  'web',\n  'android',\n  'ios',\n  'harmony',\n  'computer',\n] as const;\nexport type CreatePlatform = (typeof createPlatforms)[number];\n\nexport const createPlatformLabels: Record<CreatePlatform, string> = {\n  web: 'Web (Playwright)',\n  android: 'Android',\n  ios: 'iOS',\n  harmony: 'HarmonyOS',\n  computer: 'Desktop (Computer)',\n};\n\nexport interface NodePackageSpec {\n  name: string;\n  version: string;\n}\n\n/** Registry packages only: keep the install spec separate from the import name. */\nexport function parseNodePackageSpec(spec: string): NodePackageSpec {\n  const match =\n    /^(?:(@[a-z0-9][a-z0-9._-]*)\\/)?([a-z0-9][a-z0-9._-]*)(?:@([a-zA-Z0-9^~*>=<|. +_-]+))?$/.exec(\n      spec,\n    );\n  if (!match || (match[3] !== undefined && !match[3].trim())) {\n    throw new Error(\n      `Invalid Node package \"${spec}\". Use an npm package name with an optional version, such as @acme/test-nodes@1.2.0.`,\n    );\n  }\n  return {\n    name: `${match[1] ? `${match[1]}/` : ''}${match[2]}`,\n    version: match[3] ?? 'latest',\n  };\n}\n\nconst platformImports: Record<CreatePlatform, string> = {\n  web: `import { PlaywrightAgent } from '@midscene/web/playwright/agent';\nimport { createPlaywrightNodes } from '@midscene/test/playwright';\nimport { chromium, type Page } from 'playwright';`,\n  android: `import { AndroidAgent, agentFromAdbDevice } from '@midscene/android';`,\n  ios: `import { IOSAgent, agentFromWebDriverAgent } from '@midscene/ios';`,\n  harmony: `import { HarmonyAgent, agentFromHdcDevice } from '@midscene/harmony';`,\n  computer: `import { ComputerAgent, agentForComputer } from '@midscene/computer';`,\n};\n\nconst agentClasses: Record<CreatePlatform, string> = {\n  web: 'PlaywrightAgent',\n  android: 'AndroidAgent',\n  ios: 'IOSAgent',\n  harmony: 'HarmonyAgent',\n  computer: 'ComputerAgent',\n};\n\nconst platformSetup: Record<CreatePlatform, string> = {\n  web: `    const browser = await chromium.launch({ headless: env.HEADLESS !== 'false' });\n    onTeardown(() => browser.close());\n    const page = await browser.newPage();\n    const context: ProjectContext = { page };\n    onTeardown(async () => { await context.agent?.destroy(); });\n    return context;`,\n  android: `    const agent = await agentFromAdbDevice(env.ANDROID_DEVICE_ID || undefined);\n    onTeardown(() => agent.destroy());\n    return { agent };`,\n  ios: `    const port = Number(env.WDA_PORT || 8100);\n    if (!Number.isInteger(port) || port < 1 || port > 65535) {\n      throw new Error('WDA_PORT must be an integer between 1 and 65535.');\n    }\n    const agent = await agentFromWebDriverAgent({\n      wdaHost: env.WDA_HOST || 'localhost',\n      wdaPort: port,\n    });\n    onTeardown(() => agent.destroy());\n    return { agent };`,\n  harmony: `    const agent = await agentFromHdcDevice(env.HARMONY_DEVICE_ID || undefined);\n    onTeardown(() => agent.destroy());\n    return { agent };`,\n  computer: `    const agent = await agentForComputer({\n      displayId: env.COMPUTER_DISPLAY_ID || undefined,\n    });\n    onTeardown(() => agent.destroy());\n    return { agent };`,\n};\n\nconst platformEnv: Record<CreatePlatform, string> = {\n  web: 'HEADLESS=true\\n',\n  android:\n    '# Optional: choose a device from adb devices.\\nANDROID_DEVICE_ID=\\n',\n  ios: 'WDA_HOST=localhost\\nWDA_PORT=8100\\n',\n  harmony:\n    '# Optional: choose a device from hdc list targets.\\nHARMONY_DEVICE_ID=\\n',\n  computer:\n    '# Optional: select a display; leave empty for the default display.\\nCOMPUTER_DISPLAY_ID=\\n# Enable Xvfb on headless Linux after installing its dependencies.\\nMIDSCENE_COMPUTER_HEADLESS_LINUX=false\\n',\n};\n\nconst platformInstructions: Record<Exclude<CreatePlatform, 'web'>, string> = {\n  android:\n    'Connect an Android device and verify it with `adb devices`. Set ANDROID_DEVICE_ID to select a device.',\n  ios: 'Start WebDriverAgent and set WDA_HOST and WDA_PORT for your iOS device.',\n  harmony:\n    'Connect a HarmonyOS device and verify it with `hdc list targets`. Set HARMONY_DEVICE_ID to select a device. Set HDC_HOME if hdc is not on PATH.',\n  computer:\n    'Prepare the local desktop using the [desktop setup guide](https://midscenejs.com/platforms/desktop.html), including system dependencies and permissions. Set COMPUTER_DISPLAY_ID to select a display. For headless Linux, install Xvfb and enable MIDSCENE_COMPUTER_HEADLESS_LINUX.',\n};\n\nexport function createProjectFiles(\n  name: string,\n  platform: CreatePlatform,\n  packages: readonly NodePackageSpec[],\n  packageManager: CreatePackageManager,\n): Record<string, string> {\n  const instructions =\n    platform === 'web'\n      ? `Install Chromium before the first test: \\`${packageManagerCommands[packageManager].installChromium}\\`.`\n      : platformInstructions[platform];\n  const agentClass = agentClasses[platform];\n  const imports = packages\n    .map(\n      (pkg, index) =>\n        `import { createMidsceneTestNodes as createPackageNodes${index} } from ${JSON.stringify(pkg.name)};`,\n    )\n    .join('\\n');\n  const extraNodes = packages\n    .map(\n      (_, index) =>\n        `    ...createPackageNodes${index}<ProjectContext>({ platform: '${platform}', getAgent }),`,\n    )\n    .join('\\n');\n  const config = `import { fileURLToPath } from 'node:url';\nimport { config as loadEnv } from 'dotenv';\nimport type { NodeExecutionContext } from '@midscene/test';\nimport { defineProjectSetup, defineTestProject } from '@midscene/test/config';\nimport { createMidsceneNodes } from '@midscene/test/midscene';\n${platformImports[platform]}\n${imports}\n\nloadEnv({ path: fileURLToPath(new URL('.env', import.meta.url)) });\n\ninterface ProjectContext {\n${platform === 'web' ? '  page: Page;\\n  agent?: PlaywrightAgent;' : `  agent: ${agentClass};`}\n}\n\nconst getAgent = ({ context }: NodeExecutionContext<unknown, ProjectContext>) => {\n${platform === 'web' ? '  context.agent ??= new PlaywrightAgent(context.page);' : ''}\n  return context.agent;\n};\n\nconst setup = defineProjectSetup<ProjectContext>({\n  name: '${platform}',\n  platform: '${platform}',\n  async setup({ env, onTeardown }) {\n${platformSetup[platform]}\n  },\n});\n\nexport default defineTestProject<ProjectContext>({\n  projects: [{\n    name: '${platform}',\n    platform: '${platform}',\n    setup,\n    files: { include: ['cases/**/*.{yaml,yml}'] },\n  }],\n  nodes: [\n    ...createMidsceneNodes<ProjectContext>({ agentClass: ${agentClass}, getAgent }),\n${platform === 'web' ? '    ...createPlaywrightNodes<ProjectContext>({ getPage: ({ context }) => context.page }),' : ''}\n${extraNodes}\n  ],\n});\n`;\n  const dependencies: Record<string, string> = {\n    '@midscene/test': version,\n    [`@midscene/${platform}`]: version,\n    '@types/node': '^20.0.0',\n    dotenv: '^16.4.5',\n    typescript: '^5.8.3',\n    ...(platform === 'web' ? { playwright: '^1.45.0' } : {}),\n  };\n  for (const pkg of packages) {\n    if (Object.hasOwn(dependencies, pkg.name)) {\n      throw new Error(\n        `Node package \"${pkg.name}\" conflicts with a generated project dependency.`,\n      );\n    }\n    dependencies[pkg.name] = pkg.version;\n  }\n  const env = platformEnv[platform];\n  return {\n    'package.json': `${JSON.stringify(\n      {\n        name,\n        private: true,\n        type: 'module',\n        scripts: {\n          test: 'midscene-test',\n          nodes: 'midscene-test nodes',\n          postinstall: 'midscene-test nodes',\n        },\n        engines: { node: '^20.19.0 || ^22.12.0 || >=24.0.0' },\n        devDependencies: dependencies,\n      },\n      null,\n      2,\n    )}\\n`,\n    'midscene.config.ts': config,\n    'tsconfig.json': `${JSON.stringify(\n      {\n        compilerOptions: {\n          target: 'ES2022',\n          module: 'ESNext',\n          moduleResolution: 'Bundler',\n          strict: true,\n          noEmit: true,\n          skipLibCheck: true,\n          types: ['node'],\n        },\n        include: ['midscene.config.ts'],\n      },\n      null,\n      2,\n    )}\\n`,\n    'cases/example.yaml':\n      platform === 'web'\n        ? 'cases:\\n  - name: Open example.com\\n    steps:\\n      - gotoUrl: https://example.com\\n      - aiAssert: The page displays the heading Example Domain\\n'\n        : platform === 'computer'\n          ? 'cases:\\n  - name: Inspect the desktop\\n    steps:\\n      - aiAsk: Describe the current desktop\\n'\n          : 'cases:\\n  - name: Inspect the home screen\\n    steps:\\n      - home: {}\\n      - aiAsk: Describe the current screen\\n',\n    '.env.example': `# Copy this file to .env and configure your model before running tests.\\n# See https://midscenejs.com/model-config.html\\nMIDSCENE_MODEL_BASE_URL=\\nMIDSCENE_MODEL_API_KEY=\\nMIDSCENE_MODEL_NAME=\\nMIDSCENE_MODEL_FAMILY=\\n\\n${env}`,\n    '.gitignore': 'node_modules/\\n.env\\nmidscene_run/\\n',\n    'README.md': `# ${name}\\n\\nA Midscene Test Runner project for ${platform}.\\n\\nIf you skipped installation during creation, run \\`${packageManager} ${packageManagerCommands[packageManager].install.join(' ')}\\`. The \\`postinstall\\` script automatically generates \\`midscene-node-reference.md\\` after each dependency installation. If lifecycle scripts are disabled, run \\`${packageManager} run nodes\\` manually.\\n\\nCopy \\`.env.example\\` to \\`.env\\` and fill in your [model configuration](https://midscenejs.com/model-config.html).\\n\\n${instructions}\\n\\nRun tests with \\`${packageManager} test\\`. Read \\`midscene-node-reference.md\\` for the available Nodes and their inputs.\\n\\nAfter changing Node registrations in \\`midscene.config.ts\\`, run \\`${packageManager} run nodes\\` to refresh the reference. This loads the configuration without connecting to a device or running tests. Extension factories must only acquire runtime resources inside Node execution.\\n\\n${packages.length ? `Node packages: ${packages.map((pkg) => `\\`${pkg.name}\\``).join(', ')}. Their \\`createMidsceneTestNodes\\` factories are imported in the configuration.\\n\\n` : ''}Reports are written to \\`midscene_run/report/\\`.\\n`,\n  };\n}\n","import { lstatSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { basename, dirname, resolve } from 'node:path';\nimport { confirm, input, select } from '@inquirer/prompts';\nimport { execa } from 'execa';\nimport yargs from 'yargs/yargs';\nimport {\n  type CreatePackageManager,\n  createPackageManagers,\n  detectPackageManager,\n  packageManagerCommands,\n} from './create-package-manager';\nimport {\n  type CreatePlatform,\n  type NodePackageSpec,\n  createPlatformLabels,\n  createPlatforms,\n  createProjectFiles,\n  parseNodePackageSpec,\n} from './create-template';\nimport type { TestCliIO } from './test-command';\n\nconst createParser = () =>\n  yargs()\n    .scriptName('midscene-test create')\n    .usage('Usage: $0 [directory] [options]')\n    .parserConfiguration({\n      'parse-positional-numbers': false,\n      'greedy-arrays': false,\n      'camel-case-expansion': false,\n      'boolean-negation': false,\n    })\n    .option('platform', {\n      type: 'string',\n      choices: createPlatforms,\n      requiresArg: true,\n      description: 'Platform preset (prompt if omitted)',\n    })\n    .option('with', {\n      type: 'array',\n      string: true,\n      nargs: 1,\n      requiresArg: true,\n      description: 'npm Node package, optionally versioned (repeatable)',\n    })\n    .option('package-manager', {\n      type: 'string',\n      choices: createPackageManagers,\n      requiresArg: true,\n      description:\n        'Package manager (prompt if omitted; detect without prompts, falling back to npm)',\n    })\n    .option('yes', {\n      type: 'boolean',\n      alias: 'y',\n      default: false,\n      description:\n        'Disable prompts and install dependencies; directory and platform must be supplied',\n    })\n    .option('skip-install', {\n      type: 'boolean',\n      default: false,\n      description:\n        'Create files without installing dependencies or generating midscene-node-reference.md',\n    })\n    .demandCommand(0, 1, '', 'Only one project directory is allowed.')\n    .example('$0', 'Choose a directory and platform interactively')\n    .example('$0 my-tests --platform web', 'Create a Web project')\n    .example(\n      '$0 . --platform android --with @acme/test-nodes@1.2.0',\n      'Include a Node package',\n    )\n    .epilogue(\n      'Optionally installs dependencies with the selected package manager. The generated postinstall script creates midscene-node-reference.md after installation.\\nNode packages must export a synchronous createMidsceneTestNodes(options) factory.\\nExisting files are never overwritten. Setup and tests are not run during creation.',\n    )\n    .help('help')\n    .alias('help', 'h')\n    .version(false)\n    .strict()\n    .exitProcess(false)\n    .showHelpOnFail(false)\n    .fail((message, error) => {\n      throw error ?? new Error(message);\n    })\n    .wrap(100);\n\nexport interface CreateOptions {\n  directory?: string;\n  platform?: CreatePlatform;\n  packageManager?: CreatePackageManager;\n  packages: NodePackageSpec[];\n  yes: boolean;\n  skipInstall: boolean;\n  help: boolean;\n}\n\nexport function parseCreateArgs(\n  args: string[],\n  onOutput?: (message: string) => void,\n): CreateOptions {\n  const values = createParser().parseSync(args, {}, (error, _argv, output) => {\n    if (error) throw error;\n    if (output) onOutput?.(output);\n  });\n  const directory = values._[0] === undefined ? undefined : String(values._[0]);\n  if (directory !== undefined && !directory.trim()) {\n    throw new Error('Project directory must not be empty.');\n  }\n  const packages = (values.with ?? []).map(parseNodePackageSpec);\n  const seen = new Set<string>();\n  for (const pkg of packages) {\n    if (seen.has(pkg.name)) {\n      throw new Error(\n        `Node package \"${pkg.name}\" was specified more than once.`,\n      );\n    }\n    seen.add(pkg.name);\n  }\n  return {\n    directory,\n    platform: values.platform,\n    packageManager: values['package-manager'],\n    packages,\n    yes: values.yes ?? false,\n    skipInstall: values['skip-install'] ?? false,\n    help: values.help === true,\n  };\n}\n\nexport interface CreateServices {\n  cwd: string;\n  interactive: boolean;\n  userAgent: string | undefined;\n  promptDirectory(): Promise<string>;\n  selectPlatform(): Promise<CreatePlatform>;\n  selectPackageManager(\n    defaultValue: CreatePackageManager,\n  ): Promise<CreatePackageManager>;\n  confirmInstall(): Promise<boolean>;\n  runPackageManager(\n    packageManager: CreatePackageManager,\n    args: string[],\n    cwd: string,\n    captureOutput?: boolean,\n  ): Promise<string>;\n}\n\nconst promptDirectory = () =>\n  input({\n    message: 'Project directory:',\n    default: 'my-tests',\n    validate: (value) =>\n      value.trim().length > 0 || 'Project directory must not be empty.',\n  });\n\nconst selectPlatform = () =>\n  select<CreatePlatform>({\n    message: 'Select a platform:',\n    choices: createPlatforms.map((platform) => ({\n      name: createPlatformLabels[platform],\n      value: platform,\n    })),\n  });\n\nconst selectPackageManager: CreateServices['selectPackageManager'] = (\n  defaultValue,\n) =>\n  select<CreatePackageManager>({\n    message: 'Select a package manager:',\n    choices: createPackageManagers.map((value) => ({ name: value, value })),\n    default: defaultValue,\n  });\n\nconst runPackageManager: CreateServices['runPackageManager'] = async (\n  packageManager,\n  args,\n  cwd,\n  captureOutput = false,\n) => {\n  const result = await execa(packageManager, args, {\n    cwd,\n    stdin: 'inherit',\n    stdout: captureOutput ? 'pipe' : 'inherit',\n    stderr: 'inherit',\n    stripFinalNewline: false,\n  });\n  return result.stdout ?? '';\n};\n\nconst statIfPresent = (path: string) => {\n  try {\n    return lstatSync(path);\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') return undefined;\n    throw error;\n  }\n};\n\n/** Check every destination before writing anything, including dangling links. */\nfunction checkDestinations(root: string, filenames: string[]): void {\n  const conflicts: string[] = [];\n  for (const filename of filenames) {\n    const path = resolve(root, filename);\n    if (statIfPresent(path)) conflicts.push(path);\n    let parent = dirname(path);\n    while (true) {\n      const stat = statIfPresent(parent);\n      if (stat && !stat.isDirectory()) conflicts.push(parent);\n      if (parent === root || parent === dirname(parent)) break;\n      parent = dirname(parent);\n    }\n  }\n  if (conflicts.length) {\n    throw new Error(\n      `Cannot create project; these paths already exist or are not directories:\\n${[...new Set(conflicts)].join('\\n')}\\nChoose another directory or move the conflicting files.`,\n    );\n  }\n}\n\nexport async function runCreateCommand(\n  args: string[],\n  io: TestCliIO,\n  overrides: Partial<CreateServices> = {},\n): Promise<void> {\n  const options = parseCreateArgs(args, (message) => io.log(message));\n  if (options.help) return;\n  const services: CreateServices = {\n    cwd: process.cwd(),\n    interactive: Boolean(process.stdin.isTTY && process.stdout.isTTY),\n    userAgent: process.env.npm_config_user_agent,\n    promptDirectory,\n    selectPlatform,\n    selectPackageManager,\n    confirmInstall: () =>\n      confirm({\n        message:\n          'Install dependencies and generate midscene-node-reference.md now?',\n        default: true,\n      }),\n    runPackageManager,\n    ...overrides,\n  };\n  if (\n    (!options.directory || !options.platform) &&\n    (options.yes || !services.interactive)\n  ) {\n    throw new Error(\n      'Project directory and --platform are required without prompts. Example: midscene-test create my-tests --platform web',\n    );\n  }\n  let directory: string;\n  let platform: CreatePlatform;\n  let packageManager: CreatePackageManager;\n  try {\n    directory = options.directory ?? (await services.promptDirectory()).trim();\n    platform = options.platform ?? (await services.selectPlatform());\n    const defaultPackageManager = detectPackageManager(services.userAgent);\n    packageManager =\n      options.packageManager ??\n      (services.interactive && !options.yes\n        ? await services.selectPackageManager(defaultPackageManager)\n        : defaultPackageManager);\n  } catch (error) {\n    if (\n      error instanceof Error &&\n      ['ExitPromptError', 'AbortPromptError'].includes(error.name)\n    ) {\n      throw new Error('Project creation cancelled.');\n    }\n    throw error;\n  }\n  const root = resolve(services.cwd, directory);\n  const name =\n    basename(root)\n      .toLowerCase()\n      .replace(/[^a-z0-9._-]/g, '-')\n      .replace(/^[._-]+/, '') || 'midscene-tests';\n  const commands = packageManagerCommands[packageManager];\n  const files = createProjectFiles(\n    name,\n    platform,\n    options.packages,\n    packageManager,\n  );\n  checkDestinations(root, [\n    ...Object.keys(files),\n    'midscene-node-reference.md',\n    'pnpm-lock.yaml',\n    'package-lock.json',\n    'npm-shrinkwrap.json',\n  ]);\n  for (const [filename, content] of Object.entries(files)) {\n    const path = resolve(root, filename);\n    mkdirSync(dirname(path), { recursive: true });\n    writeFileSync(path, content, { flag: 'wx' });\n  }\n  io.log(`Created ${platform} project files in ${root}`);\n  let install = !options.skipInstall;\n  if (install && services.interactive && !options.yes) {\n    try {\n      install = await services.confirmInstall();\n    } catch (error) {\n      if (\n        error instanceof Error &&\n        ['ExitPromptError', 'AbortPromptError'].includes(error.name)\n      ) {\n        throw new Error(\n          `Project creation cancelled. Project files are preserved in ${root}.\\nIn that directory, run ${packageManager} ${commands.install.join(' ')} to install dependencies and generate midscene-node-reference.md.`,\n        );\n      }\n      throw error;\n    }\n  }\n  if (!install) {\n    io.log(\n      `Project files ready: ${root}\\nNext: run ${packageManager} ${commands.install.join(' ')} in the project directory. The postinstall script will generate midscene-node-reference.md.\\nThen follow README.md to configure your model and run tests.`,\n    );\n    return;\n  }\n  io.log(`Installing dependencies with ${packageManager}...`);\n  try {\n    await services.runPackageManager(packageManager, commands.install, root);\n  } catch (error) {\n    throw new Error(\n      `Dependency installation or postinstall Node reference generation failed. Project files are preserved in ${root}.\\nIn that directory, run ${packageManager} ${commands.install.join(' ')}, then ${packageManager} run nodes if lifecycle scripts are disabled.\\nIf postinstall failed, check midscene.config.ts and the Node package factories, then run ${packageManager} run nodes.\\n${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  try {\n    const referencePath = resolve(root, 'midscene-node-reference.md');\n    const generatedByPostinstall = Boolean(statIfPresent(referencePath));\n    // Fall back to explicit generation if lifecycle scripts were disabled.\n    if (!generatedByPostinstall) {\n      io.log('Generating Node reference...');\n      await services.runPackageManager(packageManager, commands.describe, root);\n    }\n    const markdown = readFileSync(referencePath, 'utf8');\n    if (!markdown.startsWith('<!-- Generated by `midscene-test nodes`.')) {\n      throw new Error('nodes did not generate a valid Node reference.');\n    }\n  } catch (error) {\n    throw new Error(\n      `Node reference generation failed. Project files are preserved in ${root}.\\nCheck that each Node package exports createMidsceneTestNodes(options), returns a Node array synchronously, and does not register duplicate names.\\nFix midscene.config.ts, then run ${packageManager} run nodes in the project directory.\\n${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  io.log(\n    `Project ready: ${root}\\nNode reference: ${resolve(root, 'midscene-node-reference.md')}\\nNext: copy .env.example to .env and configure your model.${platform === 'web' ? `\\nInstall Chromium: ${commands.installChromium}` : platform === 'computer' ? '\\nPrepare desktop dependencies and permissions as described in README.md.' : '\\nConfigure your device connection in .env.'}\\nRun tests from the project directory: ${packageManager} test`,\n  );\n}\n"],"names":["createPackageManagers","packageManagerCommands","detectPackageManager","userAgent","createPlatforms","createPlatformLabels","parseNodePackageSpec","spec","match","undefined","Error","platformImports","agentClasses","platformSetup","platformEnv","platformInstructions","createProjectFiles","name","platform","packages","packageManager","instructions","agentClass","imports","pkg","index","JSON","extraNodes","_","config","dependencies","version","Object","env","createParser","yargs","message","error","parseCreateArgs","args","onOutput","values","_argv","output","directory","String","seen","Set","promptDirectory","input","value","selectPlatform","select","selectPackageManager","defaultValue","runPackageManager","cwd","captureOutput","result","execa","statIfPresent","path","lstatSync","checkDestinations","root","filenames","conflicts","filename","resolve","parent","dirname","stat","runCreateCommand","io","overrides","options","services","process","Boolean","confirm","defaultPackageManager","basename","commands","files","content","mkdirSync","writeFileSync","install","referencePath","generatedByPostinstall","markdown","readFileSync"],"mappings":"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"}

package/dist/es/android/index.mjs

@@ -78,7 +78,6 @@ function define_node_defineNode(options) {
     validateDefinition(options);
     return options;
 }
-const nonBlankPrompt = (description)=>z.string().regex(/\S/, 'prompt must contain a non-whitespace character').describe(description);
 z.strictObject({
     duration: z.number().positive().describe('How long to wait.'),
     unit: z["enum"]([
@@ -87,9 +86,6 @@ z.strictObject({
         'min'
     ]).default('ms').describe('Duration unit: milliseconds, seconds, or minutes.')
 });
-z.strictObject({
-    prompt: nonBlankPrompt('A self-contained task, including allowed tools and success conditions.')
-});
 const createAgentTestRunnerNodes = (definitions, getAgent)=>definitions.map((definition)=>define_node_defineNode({
             name: definition.name,
             ...void 0 === definition.title ? {} : {