@midscene/test 1.12.5 → 1.12.6-beta-20260909034232.0

package/dist/es/1~891.mjs

@@ -48,9 +48,7 @@ export const __webpack_modules__ = {
         function detectPackageManager(userAgent) {
             return userAgent?.startsWith('pnpm/') ? 'pnpm' : 'npm';
         }
-        var package_namespaceObject = {
-            rE: "1.12.5"
-        };
+        var package_namespaceObject = JSON.parse('{"rE":"1.12.6-beta-20260909034232.0"}');
         const createPlatforms = [
             'web',
             'android',

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

@@ -1 +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 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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"}
+{"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 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

@@ -1,5 +1,6 @@
 import { androidAgentTestRunnerNodeDefinitions, launchInputSchema, runAdbShellInputSchema, runAdbShellOptionsInputSchema, terminateInputSchema } from "@midscene/android/test-runner";
 import "@midscene/core/agent/test-runner";
+import { getDebug } from "@midscene/shared/logger";
 import { z } from "zod/v4";
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
@@ -39,6 +40,19 @@ class errors_NodeDefinitionError extends WorkflowError {
         });
     }
 }
+class NodeExecutionError extends WorkflowError {
+    constructor(node, cause){
+        const causeMessage = cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');
+        super(`Node "${node}" failed: ${causeMessage}`, {
+            code: 'NODE_EXECUTION_ERROR',
+            details: {
+                node
+            },
+            cause
+        }), _define_property(this, "node", void 0);
+        this.node = node;
+    }
+}
 const validateOptionalText = (value, field, node)=>{
     if (void 0 !== value && ('string' != typeof value || 0 === value.trim().length)) throw new errors_NodeDefinitionError(`Node "${node}" ${field} must be a non-empty string.`, {
         node,
@@ -86,7 +100,54 @@ z.strictObject({
         'min'
     ]).default('ms').describe('Duration unit: milliseconds, seconds, or minutes.')
 });
-const createAgentTestRunnerNodes = (definitions, getAgent)=>definitions.map((definition)=>define_node_defineNode({
+const createAgentTestRunnerNodes = (definitions, getAgent)=>{
+    const activeAgentCalls = new WeakMap();
+    const runAgentCall = async (node, ctx, agent, call, captureExecutions = true)=>{
+        const scopeId = 'case' === ctx.scope ? ctx.case.runId : ctx.document.documentRunId;
+        const activeCall = activeAgentCalls.get(agent);
+        if (activeCall) throw new NodeExecutionError(node, new Error(`The same Agent instance cannot execute overlapping Midscene Test Steps. Active scope: ${activeCall.scopeId} (${activeCall.node}); requested scope: ${scopeId} (${node}).`));
+        activeAgentCalls.set(agent, {
+            scopeId,
+            node
+        });
+        let removeListener;
+        let sawExecutionWithoutId = false;
+        const stopListening = ()=>{
+            const remove = removeListener;
+            removeListener = void 0;
+            remove?.();
+        };
+        const stopListeningOnAbort = ()=>stopListening();
+        try {
+            if (captureExecutions && agent.addDumpUpdateListener) {
+                removeListener = agent.addDumpUpdateListener((_dump, execution)=>{
+                    if (!execution) return;
+                    if (!execution.id) {
+                        sawExecutionWithoutId = true;
+                        return;
+                    }
+                    ctx.report.addTrace({
+                        type: 'midscene-execution',
+                        executionId: execution.id
+                    });
+                });
+                if (ctx.signal.aborted) stopListening();
+                else ctx.signal.addEventListener('abort', stopListeningOnAbort, {
+                    once: true
+                });
+            }
+            return await call();
+        } finally{
+            ctx.signal.removeEventListener('abort', stopListeningOnAbort);
+            try {
+                stopListening();
+            } finally{
+                activeAgentCalls.delete(agent);
+            }
+            if (sawExecutionWithoutId) warnReportTrace(`Skipped a report trace without a stable execution id for ${node} in scope ${scopeId}.`);
+        }
+    };
+    return definitions.map((definition)=>define_node_defineNode({
             name: definition.name,
             ...void 0 === definition.title ? {} : {
                 title: definition.title
@@ -100,11 +161,17 @@ const createAgentTestRunnerNodes = (definitions, getAgent)=>definitions.map((def
             inputSchema: definition.inputSchema,
             async execute (ctx) {
                 const agent = await getAgent(ctx);
-                return definition.execute(agent, ctx.input, {
-                    signal: ctx.signal
-                });
+                const call = async ()=>definition.execute(agent, ctx.input, {
+                        signal: ctx.signal
+                    });
+                if ('object' != typeof agent || null === agent) return call();
+                return runAgentCall(definition.name, ctx, agent, call);
             }
         }));
+};
+const warnReportTrace = getDebug('test-runner:report-trace', {
+    console: true
+});
 function createAndroidNodes(options) {
     if (!options || 'object' != typeof options) throw new errors_NodeDefinitionError('createAndroidNodes() options must be an object.');
     if ('function' != typeof options.getAgent) throw new errors_NodeDefinitionError('createAndroidNodes() requires getAgent().');

package/dist/es/android/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"android/index.mjs","sources":["../../../src/errors.ts","../../../src/node/define-node.ts","../../../src/midscene/index.ts","../../../src/android/index.ts"],"sourcesContent":["import type { z } from 'zod/v4';\n\nexport interface WorkflowErrorOptions {\n  code?: string;\n  details?: unknown;\n  cause?: unknown;\n}\n\nexport class WorkflowError extends Error {\n  readonly code: string;\n  readonly details?: unknown;\n\n  constructor(message: string, options: WorkflowErrorOptions = {}) {\n    super(message, { cause: options.cause });\n    this.name = new.target.name;\n    this.code = options.code ?? 'WORKFLOW_ERROR';\n    this.details = options.details;\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      ...(this.details === undefined ? {} : { details: this.details }),\n    };\n  }\n}\n\nexport class WorkflowParseError extends WorkflowError {\n  constructor(message: string, details?: unknown, cause?: unknown) {\n    super(message, { code: 'WORKFLOW_PARSE_ERROR', details, cause });\n  }\n}\n\nexport class NodeDefinitionError extends WorkflowError {\n  constructor(message: string, details?: unknown) {\n    super(message, { code: 'NODE_DEFINITION_ERROR', details });\n  }\n}\n\nexport class DuplicateNodeError extends WorkflowError {\n  readonly node: string;\n\n  constructor(node: string) {\n    super(`Node \"${node}\" is already registered.`, {\n      code: 'DUPLICATE_NODE',\n      details: { node },\n    });\n    this.node = node;\n  }\n}\n\nexport class NodeNotFoundError extends WorkflowError {\n  readonly node: string;\n\n  constructor(node: string) {\n    super(`Node \"${node}\" is not registered.`, {\n      code: 'NODE_NOT_FOUND',\n      details: { node },\n    });\n    this.node = node;\n  }\n}\n\nexport class NodeInputValidationError extends WorkflowError {\n  constructor(message: string, details?: unknown) {\n    super(message, { code: 'NODE_INPUT_VALIDATION_ERROR', details });\n  }\n\n  static fromZod(node: string, error: z.ZodError): NodeInputValidationError {\n    const issues = error.issues.map((issue) => ({\n      code: issue.code,\n      path: issue.path.map(String).join('.'),\n      message: issue.message,\n    }));\n    const firstIssue = issues[0];\n    const path = firstIssue?.path || '<root>';\n    const message = firstIssue?.message ?? 'invalid input';\n    return new NodeInputValidationError(\n      `Node \"${node}\" input validation failed at \"${path}\": ${message}`,\n      { node, issues },\n    );\n  }\n}\n\nexport class StepTimeoutError extends WorkflowError {\n  readonly timeoutMs: number;\n  readonly node?: string;\n\n  constructor(timeoutMs: number, node?: string) {\n    super(\n      node\n        ? `Node \"${node}\" timed out after ${timeoutMs}ms.`\n        : `Step timed out after ${timeoutMs}ms.`,\n      {\n        code: 'STEP_TIMEOUT',\n        details: { timeoutMs, ...(node === undefined ? {} : { node }) },\n      },\n    );\n    this.timeoutMs = timeoutMs;\n    this.node = node;\n  }\n}\n\nexport class NodeExecutionError extends WorkflowError {\n  readonly node: string;\n\n  constructor(node: string, cause: unknown) {\n    const causeMessage =\n      cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');\n    super(`Node \"${node}\" failed: ${causeMessage}`, {\n      code: 'NODE_EXECUTION_ERROR',\n      details: { node },\n      cause,\n    });\n    this.node = node;\n  }\n}\n\nexport class WorkflowLifecycleError extends WorkflowError {\n  constructor(message: string, details?: unknown) {\n    super(message, { code: 'WORKFLOW_LIFECYCLE_ERROR', details });\n  }\n}\n\nexport class ProjectSetupError extends WorkflowError {\n  constructor(cause: unknown, details: { projectName: string }) {\n    const causeMessage =\n      cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');\n    super(`Project \"${details.projectName}\" setup failed: ${causeMessage}`, {\n      code: 'PROJECT_SETUP_ERROR',\n      details,\n      cause,\n    });\n  }\n}\n\nexport class ProjectTeardownError extends WorkflowError {\n  constructor(\n    cause: unknown,\n    details: { projectName: string; registrationIndex: number },\n  ) {\n    const causeMessage =\n      cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');\n    super(`Project \"${details.projectName}\" teardown failed: ${causeMessage}`, {\n      code: 'PROJECT_TEARDOWN_ERROR',\n      details,\n      cause,\n    });\n  }\n}\n\nexport class NodeScopeTeardownError extends WorkflowError {\n  constructor(\n    cause: unknown,\n    details: {\n      scope: 'case' | 'document';\n      scopeId: string;\n      node: string;\n      registrationIndex: number;\n    },\n  ) {\n    const causeMessage =\n      cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');\n    super(\n      `${details.scope === 'case' ? 'Case attempt' : 'Workflow document'} node teardown failed for \"${details.node}\": ${causeMessage}`,\n      { code: 'NODE_SCOPE_TEARDOWN_ERROR', details, cause },\n    );\n  }\n}\n\nexport class FatalDeviceError extends WorkflowError {\n  constructor(message: string, cause?: unknown) {\n    super(message, { code: 'FATAL_DEVICE_ERROR', cause });\n  }\n}\n\nexport const isFatalDeviceError = (error: unknown): boolean => {\n  if (error instanceof FatalDeviceError) return true;\n  if (error instanceof WorkflowError && error.code === 'FATAL_DEVICE_ERROR') {\n    return true;\n  }\n  if (\n    error instanceof Error &&\n    /device offline|device not found|(?:adb|bdc|device) connection (?:was )?closed/i.test(\n      error.message,\n    )\n  ) {\n    return true;\n  }\n  return error instanceof Error && error.cause !== undefined\n    ? isFatalDeviceError(error.cause)\n    : false;\n};\n\nexport class CaseExecutionError extends WorkflowError {\n  readonly result: import('./engine/types').CaseRunResult;\n\n  constructor(result: import('./engine/types').CaseRunResult) {\n    super(`Case \"${result.name}\" failed.`, {\n      code: 'CASE_EXECUTION_FAILED',\n      details: { caseId: result.caseId, runId: result.runId },\n    });\n    this.result = result;\n  }\n}\n\nexport class WorkflowDocumentExecutionError extends WorkflowError {\n  readonly result: import('./engine/types').WorkflowDocumentRunResult;\n\n  constructor(result: import('./engine/types').WorkflowDocumentRunResult) {\n    super(`Workflow document \"${result.sourcePath}\" failed.`, {\n      code: 'WORKFLOW_DOCUMENT_EXECUTION_FAILED',\n      details: {\n        documentId: result.documentId,\n        documentRunId: result.documentRunId,\n      },\n    });\n    this.result = result;\n  }\n}\n\nexport function normalizeNodeExecutionError(\n  error: unknown,\n  node: string,\n): WorkflowError {\n  return error instanceof WorkflowError\n    ? error\n    : new NodeExecutionError(node, error);\n}\n","import { z } from 'zod/v4';\nimport { NodeDefinitionError } from '../errors';\nimport type {\n  DefineNodeOptions,\n  DefineNodeWithSchemaOptions,\n  NodeDefinition,\n  NodeDefinitionWithSchema,\n  NodeInputSchema,\n} from './types';\n\nconst validateOptionalText = (\n  value: unknown,\n  field: 'title' | 'description',\n  node: string,\n): void => {\n  if (\n    value !== undefined &&\n    (typeof value !== 'string' || value.trim().length === 0)\n  ) {\n    throw new NodeDefinitionError(\n      `Node \"${node}\" ${field} must be a non-empty string.`,\n      { node, field },\n    );\n  }\n};\n\nconst validateInputSchema = (schema: unknown, node: string): void => {\n  if (schema === undefined) return;\n  if (!(schema instanceof z.ZodObject)) {\n    throw new NodeDefinitionError(\n      `Node \"${node}\" inputSchema must be a Zod object schema.`,\n      { node, field: 'inputSchema' },\n    );\n  }\n  if ('$' in schema.shape) {\n    throw new NodeDefinitionError(\n      `Node \"${node}\" inputSchema must not declare \"$\" as an input property.`,\n      { node, field: 'inputSchema.$' },\n    );\n  }\n};\n\nconst validateDefinition = (options: {\n  name: string;\n  title?: unknown;\n  description?: unknown;\n  stringInputKey?: unknown;\n  inputSchema?: unknown;\n  execute: unknown;\n}): void => {\n  if (!options || typeof options !== 'object') {\n    throw new NodeDefinitionError('Node definition must be an object.');\n  }\n\n  if (typeof options.name !== 'string' || options.name.trim().length === 0) {\n    throw new NodeDefinitionError('Node name must be a non-empty string.');\n  }\n\n  validateOptionalText(options.title, 'title', options.name);\n  validateOptionalText(options.description, 'description', options.name);\n  if (\n    options.stringInputKey !== undefined &&\n    options.stringInputKey !== false &&\n    (typeof options.stringInputKey !== 'string' ||\n      options.stringInputKey.trim().length === 0)\n  ) {\n    throw new NodeDefinitionError(\n      `Node \"${options.name}\" stringInputKey must be a non-empty string or false.`,\n      { node: options.name, field: 'stringInputKey' },\n    );\n  }\n  validateInputSchema(options.inputSchema, options.name);\n\n  if (\n    typeof options.stringInputKey === 'string' &&\n    options.inputSchema instanceof z.ZodObject &&\n    !(options.stringInputKey in options.inputSchema.shape)\n  ) {\n    throw new NodeDefinitionError(\n      `Node \"${options.name}\" stringInputKey must reference a field in inputSchema.`,\n      { node: options.name, field: 'stringInputKey' },\n    );\n  }\n\n  if (typeof options.execute !== 'function') {\n    throw new NodeDefinitionError(\n      `Node \"${options.name}\" must provide an execute function.`,\n      { node: options.name },\n    );\n  }\n};\n\nexport function defineNode<\n  TSchema extends NodeInputSchema,\n  TData = unknown,\n  TContext = unknown,\n>(\n  options: DefineNodeWithSchemaOptions<TSchema, TData, TContext>,\n): NodeDefinitionWithSchema<TSchema, TData, TContext>;\n\nexport function defineNode<\n  TInput = unknown,\n  TData = unknown,\n  TContext = unknown,\n>(\n  options: DefineNodeOptions<TInput, TData, TContext>,\n): NodeDefinition<TInput, TData, TContext>;\n\nexport function defineNode(\n  options: DefineNodeOptions<any, any, any>,\n): NodeDefinition<any, any, any> {\n  validateDefinition(options);\n  return options;\n}\n","import {\n  type AgentTestRunnerNodeDefinition,\n  type AgentTestRunnerNodeProvider,\n  type CommonAgentTestRunnerApi,\n  aiActInputSchema,\n  aiActOptionsInputSchema,\n  aiAssertInputSchema,\n  aiAssertOptionsInputSchema,\n  aiTapInputSchema,\n  insightInputSchema,\n  insightOptionsInputSchema,\n  locateOptionsInputSchema,\n  promptImageInputSchema,\n  recordToReportInputSchema,\n  recordToReportOptionsInputSchema,\n  reportScreenshotInputSchema,\n  structuredUserPromptInputSchema,\n  userPromptInputSchema,\n} from '@midscene/core/agent/test-runner';\nimport { z } from 'zod/v4';\nimport type { Awaitable } from '../engine/types';\nimport { NodeDefinitionError } from '../errors';\nimport { defineNode } from '../node/define-node';\nimport type { NodeDefinition, NodeExecutionContext } from '../node/types';\n\nexport type MidsceneUIAgent = CommonAgentTestRunnerApi;\n\nexport {\n  aiActInputSchema,\n  aiActOptionsInputSchema,\n  aiAssertInputSchema,\n  aiAssertOptionsInputSchema,\n  aiTapInputSchema,\n  insightInputSchema,\n  insightOptionsInputSchema,\n  locateOptionsInputSchema,\n  promptImageInputSchema,\n  recordToReportInputSchema,\n  recordToReportOptionsInputSchema,\n  reportScreenshotInputSchema,\n  structuredUserPromptInputSchema,\n  userPromptInputSchema,\n};\n\nexport interface AgentProvider<TContext> {\n  getAgent(\n    runId: string,\n    ctx: NodeExecutionContext<unknown, TContext>,\n  ): Awaitable<MidsceneUIAgent>;\n  // biome-ignore lint/suspicious/noConfusingVoidType: providers without a report intentionally return void.\n  releaseAgent?(runId: string): Awaitable<AgentReleaseResult | void>;\n  dispose?(): Awaitable<void>;\n}\n\nexport interface AgentReleaseResult {\n  /** Absolute path to the finalized report for this Agent scope. */\n  reportPath?: string;\n}\n\nexport const waitInputSchema = z.strictObject({\n  duration: z.number().positive().describe('How long to wait.'),\n  unit: z\n    .enum(['ms', 's', 'min'])\n    .default('ms')\n    .describe('Duration unit: milliseconds, seconds, or minutes.'),\n});\n\nexport type AiActNodeInput = z.infer<typeof aiActInputSchema>;\nexport type AiAssertNodeInput = z.infer<typeof aiAssertInputSchema>;\nexport type AiTapNodeInput = z.infer<typeof aiTapInputSchema>;\nexport type InsightNodeInput = z.infer<typeof insightInputSchema>;\nexport type RecordToReportNodeInput = z.infer<typeof recordToReportInputSchema>;\nexport type WaitNodeInput = z.infer<typeof waitInputSchema>;\n\nexport interface CreateMidsceneNodesOptions<TContext> {\n  getAgent?(\n    ctx: NodeExecutionContext<unknown, TContext>,\n  ): Awaitable<MidsceneUIAgent>;\n  agentProvider?: AgentProvider<TContext>;\n  /** Agent class that declares the Agent-backed Nodes to register. */\n  agentClass: AgentTestRunnerNodeProvider;\n}\n\nconst waitFor = async (durationMs: number, signal: AbortSignal) => {\n  if (signal.aborted) {\n    throw signal.reason ?? new Error('Wait aborted.');\n  }\n  await new Promise<void>((resolve, reject) => {\n    const timeout = setTimeout(() => {\n      signal.removeEventListener('abort', abort);\n      resolve();\n    }, durationMs);\n    const abort = () => {\n      clearTimeout(timeout);\n      reject(signal.reason ?? new Error('Wait aborted.'));\n    };\n    signal.addEventListener('abort', abort, { once: true });\n  });\n};\n\n/** Adapt Agent-owned descriptions to executable Midscene Test Nodes. */\nexport const createAgentTestRunnerNodes = <TContext>(\n  definitions: readonly AgentTestRunnerNodeDefinition[],\n  getAgent: (\n    ctx: NodeExecutionContext<unknown, TContext>,\n  ) => Awaitable<unknown>,\n): readonly NodeDefinition<any, any, TContext>[] =>\n  definitions.map((definition) =>\n    defineNode({\n      name: definition.name,\n      ...(definition.title === undefined ? {} : { title: definition.title }),\n      ...(definition.description === undefined\n        ? {}\n        : { description: definition.description }),\n      ...(definition.stringInputKey === undefined\n        ? {}\n        : { stringInputKey: definition.stringInputKey }),\n      inputSchema: definition.inputSchema,\n      async execute(ctx) {\n        const agent = await getAgent(ctx);\n        return definition.execute(agent, ctx.input, {\n          signal: ctx.signal,\n        });\n      },\n    }),\n  );\n\nexport function createMidsceneNodes<TContext>(\n  options: CreateMidsceneNodesOptions<TContext>,\n): readonly NodeDefinition<any, any, TContext>[] {\n  if (!options || typeof options !== 'object') {\n    throw new NodeDefinitionError(\n      'createMidsceneNodes() options must be an object.',\n    );\n  }\n  if (\n    typeof options.agentProvider?.getAgent !== 'function' &&\n    typeof options.getAgent !== 'function'\n  ) {\n    throw new NodeDefinitionError(\n      'createMidsceneNodes() requires getAgent or agentProvider.getAgent.',\n    );\n  }\n  if (\n    !options.agentClass ||\n    typeof options.agentClass.getTestRunnerNodeDefinitions !== 'function'\n  ) {\n    throw new NodeDefinitionError(\n      'createMidsceneNodes() requires agentClass.getTestRunnerNodeDefinitions().',\n    );\n  }\n\n  const registeredAgentScopes = new Set<string>();\n  const getExecutionId = (ctx: NodeExecutionContext<unknown, TContext>) =>\n    ctx.scope === 'case' ? ctx.case.runId : ctx.document.documentRunId;\n  const getAgent = async (\n    ctx: NodeExecutionContext<unknown, TContext>,\n  ): Promise<MidsceneUIAgent> => {\n    if (!options.agentProvider) return options.getAgent!(ctx);\n    const runId = getExecutionId(ctx);\n    if (\n      options.agentProvider.releaseAgent &&\n      !registeredAgentScopes.has(runId)\n    ) {\n      registeredAgentScopes.add(runId);\n      ctx.onTeardown(async () => {\n        try {\n          const released = await options.agentProvider!.releaseAgent!(runId);\n          return released?.reportPath\n            ? { reportPaths: [released.reportPath] }\n            : undefined;\n        } finally {\n          registeredAgentScopes.delete(runId);\n        }\n      });\n    }\n    return options.agentProvider.getAgent(runId, ctx);\n  };\n\n  const agentDefinitions = options.agentClass.getTestRunnerNodeDefinitions();\n\n  return [\n    ...createAgentTestRunnerNodes(agentDefinitions, getAgent),\n    defineNode<typeof waitInputSchema, unknown, TContext>({\n      name: 'wait',\n      description: 'Wait for a fixed duration while honoring cancellation.',\n      stringInputKey: false,\n      inputSchema: waitInputSchema,\n      async execute(ctx) {\n        const multiplier =\n          ctx.input.unit === 'min'\n            ? 60_000\n            : ctx.input.unit === 's'\n              ? 1_000\n              : 1;\n        const durationMs = ctx.input.duration * multiplier;\n        await waitFor(durationMs, ctx.signal);\n        return { summary: `Waited ${durationMs}ms` };\n      },\n    }),\n  ];\n}\n","import type { AndroidAgent } from '@midscene/android';\nimport {\n  androidAgentTestRunnerNodeDefinitions,\n  launchInputSchema,\n  runAdbShellInputSchema,\n  runAdbShellOptionsInputSchema,\n  terminateInputSchema,\n} from '@midscene/android/test-runner';\nexport type {\n  LaunchNodeInput,\n  RunAdbShellNodeInput,\n  TerminateNodeInput,\n} from '@midscene/android/test-runner';\nimport type { Awaitable } from '../engine/types';\nimport { NodeDefinitionError } from '../errors';\nimport { createAgentTestRunnerNodes } from '../midscene';\nimport type { NodeDefinition, NodeExecutionContext } from '../node/types';\n\nexport {\n  launchInputSchema,\n  runAdbShellInputSchema,\n  runAdbShellOptionsInputSchema,\n  terminateInputSchema,\n};\n\nexport type AndroidRunnerAgent = Pick<\n  AndroidAgent,\n  'launch' | 'terminate' | 'runAdbShell' | 'back' | 'home' | 'recentApps'\n>;\n\nexport interface CreateAndroidNodesOptions<TContext> {\n  getAgent(\n    ctx: NodeExecutionContext<unknown, TContext>,\n  ): Awaitable<AndroidRunnerAgent>;\n}\n\nexport function createAndroidNodes<TContext>(\n  options: CreateAndroidNodesOptions<TContext>,\n): readonly NodeDefinition<any, any, TContext>[] {\n  if (!options || typeof options !== 'object') {\n    throw new NodeDefinitionError(\n      'createAndroidNodes() options must be an object.',\n    );\n  }\n  if (typeof options.getAgent !== 'function') {\n    throw new NodeDefinitionError('createAndroidNodes() requires getAgent().');\n  }\n\n  return createAgentTestRunnerNodes(\n    androidAgentTestRunnerNodeDefinitions,\n    options.getAgent,\n  );\n}\n"],"names":["WorkflowError","Error","undefined","message","options","NodeDefinitionError","details","validateOptionalText","value","field","node","validateInputSchema","schema","z","validateDefinition","defineNode","createAgentTestRunnerNodes","definitions","getAgent","definition","ctx","agent","createAndroidNodes","androidAgentTestRunnerNodeDefinitions"],"mappings":"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"}
+{"version":3,"file":"android/index.mjs","sources":["../../../src/errors.ts","../../../src/node/define-node.ts","../../../src/midscene/index.ts","../../../src/android/index.ts"],"sourcesContent":["import type { z } from 'zod/v4';\n\nexport interface WorkflowErrorOptions {\n  code?: string;\n  details?: unknown;\n  cause?: unknown;\n}\n\nexport class WorkflowError extends Error {\n  readonly code: string;\n  readonly details?: unknown;\n\n  constructor(message: string, options: WorkflowErrorOptions = {}) {\n    super(message, { cause: options.cause });\n    this.name = new.target.name;\n    this.code = options.code ?? 'WORKFLOW_ERROR';\n    this.details = options.details;\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      ...(this.details === undefined ? {} : { details: this.details }),\n    };\n  }\n}\n\nexport class WorkflowParseError extends WorkflowError {\n  constructor(message: string, details?: unknown, cause?: unknown) {\n    super(message, { code: 'WORKFLOW_PARSE_ERROR', details, cause });\n  }\n}\n\nexport class NodeDefinitionError extends WorkflowError {\n  constructor(message: string, details?: unknown) {\n    super(message, { code: 'NODE_DEFINITION_ERROR', details });\n  }\n}\n\nexport class DuplicateNodeError extends WorkflowError {\n  readonly node: string;\n\n  constructor(node: string) {\n    super(`Node \"${node}\" is already registered.`, {\n      code: 'DUPLICATE_NODE',\n      details: { node },\n    });\n    this.node = node;\n  }\n}\n\nexport class NodeNotFoundError extends WorkflowError {\n  readonly node: string;\n\n  constructor(node: string) {\n    super(`Node \"${node}\" is not registered.`, {\n      code: 'NODE_NOT_FOUND',\n      details: { node },\n    });\n    this.node = node;\n  }\n}\n\nexport class NodeInputValidationError extends WorkflowError {\n  constructor(message: string, details?: unknown) {\n    super(message, { code: 'NODE_INPUT_VALIDATION_ERROR', details });\n  }\n\n  static fromZod(node: string, error: z.ZodError): NodeInputValidationError {\n    const issues = error.issues.map((issue) => ({\n      code: issue.code,\n      path: issue.path.map(String).join('.'),\n      message: issue.message,\n    }));\n    const firstIssue = issues[0];\n    const path = firstIssue?.path || '<root>';\n    const message = firstIssue?.message ?? 'invalid input';\n    return new NodeInputValidationError(\n      `Node \"${node}\" input validation failed at \"${path}\": ${message}`,\n      { node, issues },\n    );\n  }\n}\n\nexport class StepTimeoutError extends WorkflowError {\n  readonly timeoutMs: number;\n  readonly node?: string;\n\n  constructor(timeoutMs: number, node?: string) {\n    super(\n      node\n        ? `Node \"${node}\" timed out after ${timeoutMs}ms.`\n        : `Step timed out after ${timeoutMs}ms.`,\n      {\n        code: 'STEP_TIMEOUT',\n        details: { timeoutMs, ...(node === undefined ? {} : { node }) },\n      },\n    );\n    this.timeoutMs = timeoutMs;\n    this.node = node;\n  }\n}\n\nexport class NodeExecutionError extends WorkflowError {\n  readonly node: string;\n\n  constructor(node: string, cause: unknown) {\n    const causeMessage =\n      cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');\n    super(`Node \"${node}\" failed: ${causeMessage}`, {\n      code: 'NODE_EXECUTION_ERROR',\n      details: { node },\n      cause,\n    });\n    this.node = node;\n  }\n}\n\nexport class WorkflowLifecycleError extends WorkflowError {\n  constructor(message: string, details?: unknown) {\n    super(message, { code: 'WORKFLOW_LIFECYCLE_ERROR', details });\n  }\n}\n\nexport class ProjectSetupError extends WorkflowError {\n  constructor(cause: unknown, details: { projectName: string }) {\n    const causeMessage =\n      cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');\n    super(`Project \"${details.projectName}\" setup failed: ${causeMessage}`, {\n      code: 'PROJECT_SETUP_ERROR',\n      details,\n      cause,\n    });\n  }\n}\n\nexport class ProjectTeardownError extends WorkflowError {\n  constructor(\n    cause: unknown,\n    details: { projectName: string; registrationIndex: number },\n  ) {\n    const causeMessage =\n      cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');\n    super(`Project \"${details.projectName}\" teardown failed: ${causeMessage}`, {\n      code: 'PROJECT_TEARDOWN_ERROR',\n      details,\n      cause,\n    });\n  }\n}\n\nexport class NodeScopeTeardownError extends WorkflowError {\n  constructor(\n    cause: unknown,\n    details: {\n      scope: 'case' | 'document';\n      scopeId: string;\n      node: string;\n      registrationIndex: number;\n    },\n  ) {\n    const causeMessage =\n      cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');\n    super(\n      `${details.scope === 'case' ? 'Case attempt' : 'Workflow document'} node teardown failed for \"${details.node}\": ${causeMessage}`,\n      { code: 'NODE_SCOPE_TEARDOWN_ERROR', details, cause },\n    );\n  }\n}\n\nexport class FatalDeviceError extends WorkflowError {\n  constructor(message: string, cause?: unknown) {\n    super(message, { code: 'FATAL_DEVICE_ERROR', cause });\n  }\n}\n\nexport const isFatalDeviceError = (error: unknown): boolean => {\n  if (error instanceof FatalDeviceError) return true;\n  if (error instanceof WorkflowError && error.code === 'FATAL_DEVICE_ERROR') {\n    return true;\n  }\n  if (\n    error instanceof Error &&\n    /device offline|device not found|(?:adb|bdc|device) connection (?:was )?closed/i.test(\n      error.message,\n    )\n  ) {\n    return true;\n  }\n  return error instanceof Error && error.cause !== undefined\n    ? isFatalDeviceError(error.cause)\n    : false;\n};\n\nexport class CaseExecutionError extends WorkflowError {\n  readonly result: import('./engine/types').CaseRunResult;\n\n  constructor(result: import('./engine/types').CaseRunResult) {\n    super(`Case \"${result.name}\" failed.`, {\n      code: 'CASE_EXECUTION_FAILED',\n      details: { caseId: result.caseId, runId: result.runId },\n    });\n    this.result = result;\n  }\n}\n\nexport class WorkflowDocumentExecutionError extends WorkflowError {\n  readonly result: import('./engine/types').WorkflowDocumentRunResult;\n\n  constructor(result: import('./engine/types').WorkflowDocumentRunResult) {\n    super(`Workflow document \"${result.sourcePath}\" failed.`, {\n      code: 'WORKFLOW_DOCUMENT_EXECUTION_FAILED',\n      details: {\n        documentId: result.documentId,\n        documentRunId: result.documentRunId,\n      },\n    });\n    this.result = result;\n  }\n}\n\nexport function normalizeNodeExecutionError(\n  error: unknown,\n  node: string,\n): WorkflowError {\n  return error instanceof WorkflowError\n    ? error\n    : new NodeExecutionError(node, error);\n}\n","import { z } from 'zod/v4';\nimport { NodeDefinitionError } from '../errors';\nimport type {\n  DefineNodeOptions,\n  DefineNodeWithSchemaOptions,\n  NodeDefinition,\n  NodeDefinitionWithSchema,\n  NodeInputSchema,\n} from './types';\n\nconst validateOptionalText = (\n  value: unknown,\n  field: 'title' | 'description',\n  node: string,\n): void => {\n  if (\n    value !== undefined &&\n    (typeof value !== 'string' || value.trim().length === 0)\n  ) {\n    throw new NodeDefinitionError(\n      `Node \"${node}\" ${field} must be a non-empty string.`,\n      { node, field },\n    );\n  }\n};\n\nconst validateInputSchema = (schema: unknown, node: string): void => {\n  if (schema === undefined) return;\n  if (!(schema instanceof z.ZodObject)) {\n    throw new NodeDefinitionError(\n      `Node \"${node}\" inputSchema must be a Zod object schema.`,\n      { node, field: 'inputSchema' },\n    );\n  }\n  if ('$' in schema.shape) {\n    throw new NodeDefinitionError(\n      `Node \"${node}\" inputSchema must not declare \"$\" as an input property.`,\n      { node, field: 'inputSchema.$' },\n    );\n  }\n};\n\nconst validateDefinition = (options: {\n  name: string;\n  title?: unknown;\n  description?: unknown;\n  stringInputKey?: unknown;\n  inputSchema?: unknown;\n  execute: unknown;\n}): void => {\n  if (!options || typeof options !== 'object') {\n    throw new NodeDefinitionError('Node definition must be an object.');\n  }\n\n  if (typeof options.name !== 'string' || options.name.trim().length === 0) {\n    throw new NodeDefinitionError('Node name must be a non-empty string.');\n  }\n\n  validateOptionalText(options.title, 'title', options.name);\n  validateOptionalText(options.description, 'description', options.name);\n  if (\n    options.stringInputKey !== undefined &&\n    options.stringInputKey !== false &&\n    (typeof options.stringInputKey !== 'string' ||\n      options.stringInputKey.trim().length === 0)\n  ) {\n    throw new NodeDefinitionError(\n      `Node \"${options.name}\" stringInputKey must be a non-empty string or false.`,\n      { node: options.name, field: 'stringInputKey' },\n    );\n  }\n  validateInputSchema(options.inputSchema, options.name);\n\n  if (\n    typeof options.stringInputKey === 'string' &&\n    options.inputSchema instanceof z.ZodObject &&\n    !(options.stringInputKey in options.inputSchema.shape)\n  ) {\n    throw new NodeDefinitionError(\n      `Node \"${options.name}\" stringInputKey must reference a field in inputSchema.`,\n      { node: options.name, field: 'stringInputKey' },\n    );\n  }\n\n  if (typeof options.execute !== 'function') {\n    throw new NodeDefinitionError(\n      `Node \"${options.name}\" must provide an execute function.`,\n      { node: options.name },\n    );\n  }\n};\n\nexport function defineNode<\n  TSchema extends NodeInputSchema,\n  TData = unknown,\n  TContext = unknown,\n>(\n  options: DefineNodeWithSchemaOptions<TSchema, TData, TContext>,\n): NodeDefinitionWithSchema<TSchema, TData, TContext>;\n\nexport function defineNode<\n  TInput = unknown,\n  TData = unknown,\n  TContext = unknown,\n>(\n  options: DefineNodeOptions<TInput, TData, TContext>,\n): NodeDefinition<TInput, TData, TContext>;\n\nexport function defineNode(\n  options: DefineNodeOptions<any, any, any>,\n): NodeDefinition<any, any, any> {\n  validateDefinition(options);\n  return options;\n}\n","import {\n  type AgentTestRunnerNodeDefinition,\n  type AgentTestRunnerNodeProvider,\n  type CommonAgentTestRunnerApi,\n  aiActInputSchema,\n  aiActOptionsInputSchema,\n  aiAssertInputSchema,\n  aiAssertOptionsInputSchema,\n  aiTapInputSchema,\n  insightInputSchema,\n  insightOptionsInputSchema,\n  locateOptionsInputSchema,\n  promptImageInputSchema,\n  recordToReportInputSchema,\n  recordToReportOptionsInputSchema,\n  reportScreenshotInputSchema,\n  structuredUserPromptInputSchema,\n  userPromptInputSchema,\n} from '@midscene/core/agent/test-runner';\nimport { getDebug } from '@midscene/shared/logger';\nimport { z } from 'zod/v4';\nimport type { Awaitable } from '../engine/types';\nimport { NodeDefinitionError, NodeExecutionError } from '../errors';\nimport { defineNode } from '../node/define-node';\nimport type { NodeDefinition, NodeExecutionContext } from '../node/types';\n\nexport type MidsceneUIAgent = CommonAgentTestRunnerApi & {\n  addDumpUpdateListener?(\n    listener: (dump: string, execution?: MidsceneExecutionRef) => void,\n  ): () => void;\n};\n\nexport {\n  aiActInputSchema,\n  aiActOptionsInputSchema,\n  aiAssertInputSchema,\n  aiAssertOptionsInputSchema,\n  aiTapInputSchema,\n  insightInputSchema,\n  insightOptionsInputSchema,\n  locateOptionsInputSchema,\n  promptImageInputSchema,\n  recordToReportInputSchema,\n  recordToReportOptionsInputSchema,\n  reportScreenshotInputSchema,\n  structuredUserPromptInputSchema,\n  userPromptInputSchema,\n};\n\nexport interface MidsceneExecutionRef {\n  id?: string;\n}\n\nexport interface AgentProvider<TContext> {\n  getAgent(\n    runId: string,\n    ctx: NodeExecutionContext<unknown, TContext>,\n  ): Awaitable<MidsceneUIAgent>;\n  // biome-ignore lint/suspicious/noConfusingVoidType: providers without a report intentionally return void.\n  releaseAgent?(runId: string): Awaitable<AgentReleaseResult | void>;\n  dispose?(): Awaitable<void>;\n}\n\nexport interface AgentReleaseResult {\n  /** Absolute path to the finalized report for this Agent scope. */\n  reportPath?: string;\n}\n\nexport const waitInputSchema = z.strictObject({\n  duration: z.number().positive().describe('How long to wait.'),\n  unit: z\n    .enum(['ms', 's', 'min'])\n    .default('ms')\n    .describe('Duration unit: milliseconds, seconds, or minutes.'),\n});\n\nexport type AiActNodeInput = z.infer<typeof aiActInputSchema>;\nexport type AiAssertNodeInput = z.infer<typeof aiAssertInputSchema>;\nexport type AiTapNodeInput = z.infer<typeof aiTapInputSchema>;\nexport type InsightNodeInput = z.infer<typeof insightInputSchema>;\nexport type RecordToReportNodeInput = z.infer<typeof recordToReportInputSchema>;\nexport type WaitNodeInput = z.infer<typeof waitInputSchema>;\n\nexport interface CreateMidsceneNodesOptions<TContext> {\n  getAgent?(\n    ctx: NodeExecutionContext<unknown, TContext>,\n  ): Awaitable<MidsceneUIAgent>;\n  agentProvider?: AgentProvider<TContext>;\n  /** Agent class that declares the Agent-backed Nodes to register. */\n  agentClass: AgentTestRunnerNodeProvider;\n}\n\nconst waitFor = async (durationMs: number, signal: AbortSignal) => {\n  if (signal.aborted) {\n    throw signal.reason ?? new Error('Wait aborted.');\n  }\n  await new Promise<void>((resolve, reject) => {\n    const timeout = setTimeout(() => {\n      signal.removeEventListener('abort', abort);\n      resolve();\n    }, durationMs);\n    const abort = () => {\n      clearTimeout(timeout);\n      reject(signal.reason ?? new Error('Wait aborted.'));\n    };\n    signal.addEventListener('abort', abort, { once: true });\n  });\n};\n\n/** Adapt Agent-owned descriptions to executable Midscene Test Nodes. */\nexport const createAgentTestRunnerNodes = <TContext>(\n  definitions: readonly AgentTestRunnerNodeDefinition[],\n  getAgent: (\n    ctx: NodeExecutionContext<unknown, TContext>,\n  ) => Awaitable<unknown>,\n): readonly NodeDefinition<any, any, TContext>[] => {\n  const activeAgentCalls = new WeakMap<\n    MidsceneUIAgent,\n    { scopeId: string; node: string }\n  >();\n  const runAgentCall = async <T>(\n    node: string,\n    ctx: NodeExecutionContext<unknown, TContext>,\n    agent: MidsceneUIAgent,\n    call: () => Promise<T>,\n    captureExecutions = true,\n  ): Promise<T> => {\n    const scopeId =\n      ctx.scope === 'case' ? ctx.case.runId : ctx.document.documentRunId;\n    const activeCall = activeAgentCalls.get(agent);\n    if (activeCall) {\n      throw new NodeExecutionError(\n        node,\n        new Error(\n          `The same Agent instance cannot execute overlapping Midscene Test Steps. Active scope: ${activeCall.scopeId} (${activeCall.node}); requested scope: ${scopeId} (${node}).`,\n        ),\n      );\n    }\n\n    activeAgentCalls.set(agent, { scopeId, node });\n    let removeListener: (() => void) | undefined;\n    let sawExecutionWithoutId = false;\n    const stopListening = () => {\n      const remove = removeListener;\n      removeListener = undefined;\n      remove?.();\n    };\n    const stopListeningOnAbort = () => stopListening();\n    try {\n      if (captureExecutions && agent.addDumpUpdateListener) {\n        removeListener = agent.addDumpUpdateListener((_dump, execution) => {\n          if (!execution) return;\n          if (!execution.id) {\n            sawExecutionWithoutId = true;\n            return;\n          }\n          ctx.report.addTrace({\n            type: 'midscene-execution',\n            executionId: execution.id,\n          });\n        });\n        if (ctx.signal.aborted) stopListening();\n        else {\n          ctx.signal.addEventListener('abort', stopListeningOnAbort, {\n            once: true,\n          });\n        }\n      }\n      return await call();\n    } finally {\n      ctx.signal.removeEventListener('abort', stopListeningOnAbort);\n      try {\n        stopListening();\n      } finally {\n        activeAgentCalls.delete(agent);\n      }\n      if (sawExecutionWithoutId) {\n        warnReportTrace(\n          `Skipped a report trace without a stable execution id for ${node} in scope ${scopeId}.`,\n        );\n      }\n    }\n  };\n\n  return definitions.map((definition) =>\n    defineNode({\n      name: definition.name,\n      ...(definition.title === undefined ? {} : { title: definition.title }),\n      ...(definition.description === undefined\n        ? {}\n        : { description: definition.description }),\n      ...(definition.stringInputKey === undefined\n        ? {}\n        : { stringInputKey: definition.stringInputKey }),\n      inputSchema: definition.inputSchema,\n      async execute(ctx) {\n        const agent = await getAgent(ctx);\n        const call = async () =>\n          definition.execute(agent, ctx.input, { signal: ctx.signal });\n        if (typeof agent !== 'object' || agent === null) return call();\n        return runAgentCall(\n          definition.name,\n          ctx,\n          agent as MidsceneUIAgent,\n          call,\n        );\n      },\n    }),\n  );\n};\n\nconst warnReportTrace = getDebug('test-runner:report-trace', {\n  console: true,\n});\n\nexport function createMidsceneNodes<TContext>(\n  options: CreateMidsceneNodesOptions<TContext>,\n): readonly NodeDefinition<any, any, TContext>[] {\n  if (!options || typeof options !== 'object') {\n    throw new NodeDefinitionError(\n      'createMidsceneNodes() options must be an object.',\n    );\n  }\n  if (\n    typeof options.agentProvider?.getAgent !== 'function' &&\n    typeof options.getAgent !== 'function'\n  ) {\n    throw new NodeDefinitionError(\n      'createMidsceneNodes() requires getAgent or agentProvider.getAgent.',\n    );\n  }\n  if (\n    !options.agentClass ||\n    typeof options.agentClass.getTestRunnerNodeDefinitions !== 'function'\n  ) {\n    throw new NodeDefinitionError(\n      'createMidsceneNodes() requires agentClass.getTestRunnerNodeDefinitions().',\n    );\n  }\n\n  const registeredAgentScopes = new Set<string>();\n  const getExecutionId = (ctx: NodeExecutionContext<unknown, TContext>) =>\n    ctx.scope === 'case' ? ctx.case.runId : ctx.document.documentRunId;\n  const getAgent = async (\n    ctx: NodeExecutionContext<unknown, TContext>,\n  ): Promise<MidsceneUIAgent> => {\n    if (!options.agentProvider) return options.getAgent!(ctx);\n    const runId = getExecutionId(ctx);\n    if (\n      options.agentProvider.releaseAgent &&\n      !registeredAgentScopes.has(runId)\n    ) {\n      registeredAgentScopes.add(runId);\n      ctx.onTeardown(async () => {\n        try {\n          const released = await options.agentProvider!.releaseAgent!(runId);\n          return released?.reportPath\n            ? { reportPaths: [released.reportPath] }\n            : undefined;\n        } finally {\n          registeredAgentScopes.delete(runId);\n        }\n      });\n    }\n    return options.agentProvider.getAgent(runId, ctx);\n  };\n\n  const agentDefinitions = options.agentClass.getTestRunnerNodeDefinitions();\n\n  return [\n    ...createAgentTestRunnerNodes(agentDefinitions, getAgent),\n    defineNode<typeof waitInputSchema, unknown, TContext>({\n      name: 'wait',\n      description: 'Wait for a fixed duration while honoring cancellation.',\n      stringInputKey: false,\n      inputSchema: waitInputSchema,\n      async execute(ctx) {\n        const multiplier =\n          ctx.input.unit === 'min'\n            ? 60_000\n            : ctx.input.unit === 's'\n              ? 1_000\n              : 1;\n        const durationMs = ctx.input.duration * multiplier;\n        await waitFor(durationMs, ctx.signal);\n        return { summary: `Waited ${durationMs}ms` };\n      },\n    }),\n  ];\n}\n","import type { AndroidAgent } from '@midscene/android';\nimport {\n  androidAgentTestRunnerNodeDefinitions,\n  launchInputSchema,\n  runAdbShellInputSchema,\n  runAdbShellOptionsInputSchema,\n  terminateInputSchema,\n} from '@midscene/android/test-runner';\nexport type {\n  LaunchNodeInput,\n  RunAdbShellNodeInput,\n  TerminateNodeInput,\n} from '@midscene/android/test-runner';\nimport type { Awaitable } from '../engine/types';\nimport { NodeDefinitionError } from '../errors';\nimport { createAgentTestRunnerNodes } from '../midscene';\nimport type { NodeDefinition, NodeExecutionContext } from '../node/types';\n\nexport {\n  launchInputSchema,\n  runAdbShellInputSchema,\n  runAdbShellOptionsInputSchema,\n  terminateInputSchema,\n};\n\nexport type AndroidRunnerAgent = Pick<\n  AndroidAgent,\n  'launch' | 'terminate' | 'runAdbShell' | 'back' | 'home' | 'recentApps'\n>;\n\nexport interface CreateAndroidNodesOptions<TContext> {\n  getAgent(\n    ctx: NodeExecutionContext<unknown, TContext>,\n  ): Awaitable<AndroidRunnerAgent>;\n}\n\nexport function createAndroidNodes<TContext>(\n  options: CreateAndroidNodesOptions<TContext>,\n): readonly NodeDefinition<any, any, TContext>[] {\n  if (!options || typeof options !== 'object') {\n    throw new NodeDefinitionError(\n      'createAndroidNodes() options must be an object.',\n    );\n  }\n  if (typeof options.getAgent !== 'function') {\n    throw new NodeDefinitionError('createAndroidNodes() requires getAgent().');\n  }\n\n  return createAgentTestRunnerNodes(\n    androidAgentTestRunnerNodeDefinitions,\n    options.getAgent,\n  );\n}\n"],"names":["WorkflowError","Error","undefined","message","options","NodeDefinitionError","details","NodeExecutionError","node","cause","causeMessage","String","validateOptionalText","value","field","validateInputSchema","schema","z","validateDefinition","defineNode","createAgentTestRunnerNodes","definitions","getAgent","activeAgentCalls","WeakMap","runAgentCall","ctx","agent","call","captureExecutions","scopeId","activeCall","removeListener","sawExecutionWithoutId","stopListening","remove","stopListeningOnAbort","_dump","execution","warnReportTrace","definition","getDebug","createAndroidNodes","androidAgentTestRunnerNodeDefinitions"],"mappings":"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"}