@midscene/test 1.12.4-beta-20260903111111.0 → 1.12.4

package/dist/es/android/index.mjs

@@ -1,3 +1,5 @@
+import { androidAgentTestRunnerNodeDefinitions, launchInputSchema, runAdbShellInputSchema, runAdbShellOptionsInputSchema, terminateInputSchema } from "@midscene/android/test-runner";
+import "@midscene/core/agent/test-runner";
 import { z } from "zod/v4";
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
@@ -29,7 +31,7 @@ class WorkflowError extends Error {
         this.details = options.details;
     }
 }
-class NodeDefinitionError extends WorkflowError {
+class errors_NodeDefinitionError extends WorkflowError {
     constructor(message, details){
         super(message, {
             code: 'NODE_DEFINITION_ERROR',
@@ -37,139 +39,81 @@ class 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 NodeDefinitionError(`Node "${node}" ${field} must be a non-empty string.`, {
+    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,
         field
     });
 };
 const validateInputSchema = (schema, node)=>{
     if (void 0 === schema) return;
-    if (!(schema instanceof z.ZodObject)) throw new NodeDefinitionError(`Node "${node}" inputSchema must be a Zod object schema.`, {
+    if (!(schema instanceof z.ZodObject)) throw new errors_NodeDefinitionError(`Node "${node}" inputSchema must be a Zod object schema.`, {
         node,
         field: 'inputSchema'
     });
-    if ('$' in schema.shape) throw new NodeDefinitionError(`Node "${node}" inputSchema must not declare "$" as an input property.`, {
+    if ('$' in schema.shape) throw new errors_NodeDefinitionError(`Node "${node}" inputSchema must not declare "$" as an input property.`, {
         node,
         field: 'inputSchema.$'
     });
 };
 const validateDefinition = (options)=>{
-    if (!options || 'object' != typeof options) throw new NodeDefinitionError('Node definition must be an object.');
-    if ('string' != typeof options.name || 0 === options.name.trim().length) throw new NodeDefinitionError('Node name must be a non-empty string.');
+    if (!options || 'object' != typeof options) throw new errors_NodeDefinitionError('Node definition must be an object.');
+    if ('string' != typeof options.name || 0 === options.name.trim().length) throw new errors_NodeDefinitionError('Node name must be a non-empty string.');
     validateOptionalText(options.title, 'title', options.name);
     validateOptionalText(options.description, "description", options.name);
+    if (void 0 !== options.stringInputKey && false !== options.stringInputKey && ('string' != typeof options.stringInputKey || 0 === options.stringInputKey.trim().length)) throw new errors_NodeDefinitionError(`Node "${options.name}" stringInputKey must be a non-empty string or false.`, {
+        node: options.name,
+        field: 'stringInputKey'
+    });
     validateInputSchema(options.inputSchema, options.name);
-    if ('function' != typeof options.execute) throw new NodeDefinitionError(`Node "${options.name}" must provide an execute function.`, {
+    if ('string' == typeof options.stringInputKey && options.inputSchema instanceof z.ZodObject && !(options.stringInputKey in options.inputSchema.shape)) throw new errors_NodeDefinitionError(`Node "${options.name}" stringInputKey must reference a field in inputSchema.`, {
+        node: options.name,
+        field: 'stringInputKey'
+    });
+    if ('function' != typeof options.execute) throw new errors_NodeDefinitionError(`Node "${options.name}" must provide an execute function.`, {
         node: options.name
     });
 };
-function defineNode(options) {
+function define_node_defineNode(options) {
     validateDefinition(options);
     return options;
 }
-const lifecycleInputSchema = (operation, description)=>z.strictObject({
-        prompt: z.string().regex(/\S/, 'prompt must contain a non-whitespace character').optional().describe(`String shorthand for the app to ${operation}.`),
-        uri: z.string().regex(/\S/, 'uri must contain a non-whitespace character').optional().describe(description)
-    }).superRefine((input, ctx)=>{
-        if (void 0 === input.prompt === (void 0 === input.uri)) ctx.addIssue({
-            code: 'custom',
-            message: 'exactly one of prompt and uri is required'
-        });
-    });
-const launchInputSchema = lifecycleInputSchema('launch', 'The app, URL, URI, package name, or bundle identifier to launch.');
-const terminateInputSchema = lifecycleInputSchema('terminate', 'The package name, bundle identifier, or app name to terminate.');
-const requireLifecycleMethod = (agent, method, agentName)=>{
-    if ('object' != typeof agent || null === agent || 'function' != typeof agent[method]) throw new NodeExecutionError(method, new TypeError(`getAgent() must return ${agentName} with ${method}().`));
-    return agent[method];
-};
-const createLaunchNode = (getAgent, agentName = 'an Agent')=>defineNode({
-        name: 'launch',
-        description: 'Launch an app, URL, or URI through the current Midscene Agent. This Node does not install or manage applications.',
-        inputSchema: launchInputSchema,
-        async execute (ctx) {
-            const uri = ctx.input.uri ?? ctx.input.prompt;
-            const agent = await getAgent(ctx);
-            const launch = requireLifecycleMethod(agent, 'launch', agentName);
-            await launch.call(agent, uri);
-            return {
-                summary: `Launched ${uri}`
-            };
-        }
-    });
-const createTerminateNode = (getAgent, agentName)=>defineNode({
-        name: 'terminate',
-        description: 'Terminate an application through the current Midscene Agent. This Node does not uninstall the application or clear its data.',
-        inputSchema: terminateInputSchema,
-        async execute (ctx) {
-            const uri = ctx.input.uri ?? ctx.input.prompt;
-            const agent = await getAgent(ctx);
-            const terminate = requireLifecycleMethod(agent, 'terminate', agentName);
-            await terminate.call(agent, uri);
-            return {
-                summary: `Terminated ${uri}`
-            };
-        }
-    });
-const createDeviceLifecycleNodes = (getAgent, agentName)=>[
-        createLaunchNode(getAgent, agentName),
-        createTerminateNode(getAgent, agentName)
-    ];
-const runAdbShellInputSchema = z.strictObject({
-    prompt: z.string().regex(/\S/).optional().describe('String shorthand for the ADB shell command.'),
-    command: z.string().regex(/\S/).optional().describe('The shell command, without an adb shell prefix.'),
-    timeoutMs: z.number().int().positive().optional().describe('ADB shell command timeout in milliseconds.')
-}).superRefine((input, ctx)=>{
-    if (void 0 === input.prompt === (void 0 === input.command)) ctx.addIssue({
-        code: 'custom',
-        message: 'exactly one of prompt and command is required'
-    });
+const nonBlankPrompt = (description)=>z.string().regex(/\S/, 'prompt must contain a non-whitespace character').describe(description);
+z.strictObject({
+    duration: z.number().positive().describe('How long to wait.'),
+    unit: z["enum"]([
+        'ms',
+        's',
+        'min'
+    ]).default('ms').describe('Duration unit: milliseconds, seconds, or minutes.')
 });
-function createAndroidNodes(options) {
-    if (!options || 'object' != typeof options) throw new NodeDefinitionError('createAndroidNodes() options must be an object.');
-    if ('function' != typeof options.getAgent) throw new NodeDefinitionError('createAndroidNodes() requires getAgent().');
-    return [
-        ...createDeviceLifecycleNodes(options.getAgent, 'an Android Agent'),
-        defineNode({
-            name: 'runAdbShell',
-            title: 'Run an ADB shell command',
-            description: 'Execute a shell command through the current Android Agent. Pass only the shell command, without the adb shell prefix.',
-            inputSchema: runAdbShellInputSchema,
+z.strictObject({
+    prompt: nonBlankPrompt('A self-contained task, including allowed tools and success conditions.')
+});
+const createAgentTestRunnerNodes = (definitions, getAgent)=>definitions.map((definition)=>define_node_defineNode({
+            name: definition.name,
+            ...void 0 === definition.title ? {} : {
+                title: definition.title
+            },
+            ...void 0 === definition.description ? {} : {
+                description: definition.description
+            },
+            ...void 0 === definition.stringInputKey ? {} : {
+                stringInputKey: definition.stringInputKey
+            },
+            inputSchema: definition.inputSchema,
             async execute (ctx) {
-                if (ctx.signal.aborted) throw ctx.signal.reason ?? new Error('runAdbShell aborted.');
-                const command = ctx.input.command ?? ctx.input.prompt;
-                if (/^\s*adb(?:\s|$)/i.test(command)) throw new NodeExecutionError('runAdbShell', new TypeError('command must not include an adb or adb shell prefix.'));
-                const agent = await options.getAgent(ctx);
-                if ('function' != typeof agent?.runAdbShell) throw new NodeExecutionError('runAdbShell', new TypeError('getAgent() must return an Android Agent with runAdbShell().'));
-                const stdout = await agent.runAdbShell(command, {
-                    ...void 0 === ctx.input.timeoutMs ? {} : {
-                        timeout: ctx.input.timeoutMs
-                    }
+                const agent = await getAgent(ctx);
+                return definition.execute(agent, ctx.input, {
+                    signal: ctx.signal
                 });
-                if ('string' != typeof stdout) throw new NodeExecutionError('runAdbShell', new TypeError('runAdbShell() must return stdout as a string.'));
-                return {
-                    summary: `Executed ADB shell command (${stdout.length} stdout characters)`,
-                    data: {
-                        stdout
-                    }
-                };
             }
-        })
-    ];
+        }));
+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().');
+    return createAgentTestRunnerNodes(androidAgentTestRunnerNodeDefinitions, options.getAgent);
 }
-export { createAndroidNodes, launchInputSchema, runAdbShellInputSchema, terminateInputSchema };
+export { createAndroidNodes, launchInputSchema, runAdbShellInputSchema, runAdbShellOptionsInputSchema, terminateInputSchema };
 
 //# sourceMappingURL=index.mjs.map

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/device/lifecycle.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  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  validateInputSchema(options.inputSchema, options.name);\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 { z } from 'zod/v4';\nimport type { Awaitable } from '../engine/types';\nimport { NodeExecutionError } from '../errors';\nimport { defineNode } from '../node/define-node';\nimport type { NodeDefinition, NodeExecutionContext } from '../node/types';\n\ntype NodeContext<TContext> = NodeExecutionContext<unknown, TContext>;\ntype AgentGetter<TContext> = (ctx: NodeContext<TContext>) => Awaitable<unknown>;\ntype LifecycleMethod = 'launch' | 'terminate';\n\n/** Device capabilities required by Android and iOS lifecycle Nodes. */\nexport interface DeviceLifecycleAgent {\n  launch(uri: string): Promise<void>;\n  terminate(uri: string): Promise<void>;\n}\n\nconst lifecycleInputSchema = (\n  operation: LifecycleMethod,\n  description: string,\n) =>\n  z\n    .strictObject({\n      prompt: z\n        .string()\n        .regex(/\\S/, 'prompt must contain a non-whitespace character')\n        .optional()\n        .describe(`String shorthand for the app to ${operation}.`),\n      uri: z\n        .string()\n        .regex(/\\S/, 'uri must contain a non-whitespace character')\n        .optional()\n        .describe(description),\n    })\n    .superRefine((input, ctx) => {\n      if ((input.prompt === undefined) === (input.uri === undefined)) {\n        ctx.addIssue({\n          code: 'custom',\n          message: 'exactly one of prompt and uri is required',\n        });\n      }\n    });\n\n/** Input schema for the device launch Node. */\nexport const launchInputSchema = lifecycleInputSchema(\n  'launch',\n  'The app, URL, URI, package name, or bundle identifier to launch.',\n);\n\n/** Input schema for the device terminate Node. */\nexport const terminateInputSchema = lifecycleInputSchema(\n  'terminate',\n  'The package name, bundle identifier, or app name to terminate.',\n);\n\nexport type LaunchNodeInput = z.infer<typeof launchInputSchema>;\nexport type TerminateNodeInput = z.infer<typeof terminateInputSchema>;\n\nconst requireLifecycleMethod = (\n  agent: unknown,\n  method: LifecycleMethod,\n  agentName: string,\n): DeviceLifecycleAgent[LifecycleMethod] => {\n  if (\n    typeof agent !== 'object' ||\n    agent === null ||\n    typeof (agent as Record<LifecycleMethod, unknown>)[method] !== 'function'\n  ) {\n    throw new NodeExecutionError(\n      method,\n      new TypeError(`getAgent() must return ${agentName} with ${method}().`),\n    );\n  }\n  return (agent as DeviceLifecycleAgent)[method];\n};\n\nexport const createLaunchNode = <TContext>(\n  getAgent: AgentGetter<TContext>,\n  agentName = 'an Agent',\n): NodeDefinition<any, any, TContext> =>\n  defineNode<typeof launchInputSchema, unknown, TContext>({\n    name: 'launch',\n    description:\n      'Launch an app, URL, or URI through the current Midscene Agent. This Node does not install or manage applications.',\n    inputSchema: launchInputSchema,\n    async execute(ctx) {\n      const uri = ctx.input.uri ?? ctx.input.prompt!;\n      const agent = await getAgent(ctx);\n      const launch = requireLifecycleMethod(agent, 'launch', agentName);\n      await launch.call(agent, uri);\n      return { summary: `Launched ${uri}` };\n    },\n  });\n\nconst createTerminateNode = <TContext>(\n  getAgent: AgentGetter<TContext>,\n  agentName: string,\n): NodeDefinition<any, any, TContext> =>\n  defineNode<typeof terminateInputSchema, unknown, TContext>({\n    name: 'terminate',\n    description:\n      'Terminate an application through the current Midscene Agent. This Node does not uninstall the application or clear its data.',\n    inputSchema: terminateInputSchema,\n    async execute(ctx) {\n      const uri = ctx.input.uri ?? ctx.input.prompt!;\n      const agent = await getAgent(ctx);\n      const terminate = requireLifecycleMethod(agent, 'terminate', agentName);\n      await terminate.call(agent, uri);\n      return { summary: `Terminated ${uri}` };\n    },\n  });\n\nexport const createDeviceLifecycleNodes = <TContext>(\n  getAgent: (ctx: NodeContext<TContext>) => Awaitable<DeviceLifecycleAgent>,\n  agentName: string,\n): readonly NodeDefinition<any, any, TContext>[] => [\n  createLaunchNode(getAgent, agentName),\n  createTerminateNode(getAgent, agentName),\n];\n","import { z } from 'zod/v4';\nimport {\n  type DeviceLifecycleAgent,\n  createDeviceLifecycleNodes,\n} from '../device/lifecycle';\nexport type {\n  LaunchNodeInput,\n  TerminateNodeInput,\n} from '../device/lifecycle';\nexport { launchInputSchema, terminateInputSchema } from '../device/lifecycle';\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\ntype NodeContext<TContext> = NodeExecutionContext<unknown, TContext>;\n\n/** Minimal Android Agent capability required by the preset Node. */\nexport interface AndroidRunnerAgent extends DeviceLifecycleAgent {\n  /** Execute a command in the connected Android device shell. */\n  runAdbShell(command: string, options?: { timeout?: number }): Promise<string>;\n}\n\n/** Dependencies used by the Android preset Nodes. */\nexport interface CreateAndroidNodesOptions<TContext> {\n  /** Return the Android Agent associated with the current workflow. */\n  getAgent(ctx: NodeContext<TContext>): Awaitable<AndroidRunnerAgent>;\n}\n\n/** Input schema for the Android runAdbShell Node. */\nexport const runAdbShellInputSchema = z\n  .strictObject({\n    prompt: z\n      .string()\n      .regex(/\\S/)\n      .optional()\n      .describe('String shorthand for the ADB shell command.'),\n    command: z\n      .string()\n      .regex(/\\S/)\n      .optional()\n      .describe('The shell command, without an adb shell prefix.'),\n    timeoutMs: z\n      .number()\n      .int()\n      .positive()\n      .optional()\n      .describe('ADB shell command timeout in milliseconds.'),\n  })\n  .superRefine((input, ctx) => {\n    if ((input.prompt === undefined) === (input.command === undefined)) {\n      ctx.addIssue({\n        code: 'custom',\n        message: 'exactly one of prompt and command is required',\n      });\n    }\n  });\n\n/** Validated input accepted by the Android runAdbShell Node. */\nexport type RunAdbShellNodeInput = z.infer<typeof runAdbShellInputSchema>;\n\n/** Create the P0 Android preset Nodes for an injected Android Agent. */\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 [\n    ...createDeviceLifecycleNodes(options.getAgent, 'an Android Agent'),\n    defineNode<typeof runAdbShellInputSchema, { stdout: string }, TContext>({\n      name: 'runAdbShell',\n      title: 'Run an ADB shell command',\n      description:\n        'Execute a shell command through the current Android Agent. Pass only the shell command, without the adb shell prefix.',\n      inputSchema: runAdbShellInputSchema,\n      async execute(ctx) {\n        if (ctx.signal.aborted) {\n          throw ctx.signal.reason ?? new Error('runAdbShell aborted.');\n        }\n        const command = ctx.input.command ?? ctx.input.prompt!;\n        if (/^\\s*adb(?:\\s|$)/i.test(command)) {\n          throw new NodeExecutionError(\n            'runAdbShell',\n            new TypeError(\n              'command must not include an adb or adb shell prefix.',\n            ),\n          );\n        }\n        const agent = await options.getAgent(ctx);\n        if (typeof agent?.runAdbShell !== 'function') {\n          throw new NodeExecutionError(\n            'runAdbShell',\n            new TypeError(\n              'getAgent() must return an Android Agent with runAdbShell().',\n            ),\n          );\n        }\n        const stdout = await agent.runAdbShell(command, {\n          ...(ctx.input.timeoutMs === undefined\n            ? {}\n            : { timeout: ctx.input.timeoutMs }),\n        });\n        if (typeof stdout !== 'string') {\n          throw new NodeExecutionError(\n            'runAdbShell',\n            new TypeError('runAdbShell() must return stdout as a string.'),\n          );\n        }\n        return {\n          summary: `Executed ADB shell command (${stdout.length} stdout characters)`,\n          data: { stdout },\n        };\n      },\n    }),\n  ];\n}\n"],"names":["WorkflowError","Error","undefined","message","options","NodeDefinitionError","details","NodeExecutionError","node","cause","causeMessage","String","validateOptionalText","value","field","validateInputSchema","schema","z","validateDefinition","defineNode","lifecycleInputSchema","operation","description","input","ctx","launchInputSchema","terminateInputSchema","requireLifecycleMethod","agent","method","agentName","TypeError","createLaunchNode","getAgent","uri","launch","createTerminateNode","terminate","createDeviceLifecycleNodes","runAdbShellInputSchema","createAndroidNodes","command","stdout"],"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 { z } from 'zod/v4';\nimport type { Awaitable } from '../engine/types';\nimport { NodeDefinitionError, NodeExecutionError } from '../errors';\nimport { defineNode } from '../node/define-node';\nimport type {\n  NodeDefinition,\n  NodeExecutionContext,\n  NodeResult,\n} 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 interface AgentExecutorInput<TContext> {\n  prompt: string;\n  context: TContext;\n  signal: AbortSignal;\n  execution:\n    | { scope: 'case'; runId: string }\n    | { scope: 'document'; runId: string };\n}\n\nexport interface AgentExecutor<TContext> {\n  // biome-ignore lint/suspicious/noConfusingVoidType: executors may perform side effects without returning a summary.\n  execute(input: AgentExecutorInput<TContext>): Awaitable<NodeResult | void>;\n}\n\nconst nonBlankPrompt = (description: string) =>\n  z\n    .string()\n    .regex(/\\S/, 'prompt must contain a non-whitespace character')\n    .describe(description);\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 const agentInputSchema = z.strictObject({\n  prompt: nonBlankPrompt(\n    'A self-contained task, including allowed tools and success conditions.',\n  ),\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>;\nexport type AgentNodeInput = z.infer<typeof agentInputSchema>;\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  agentExecutor?: AgentExecutor<TContext>;\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 Test Runner 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    defineNode<typeof agentInputSchema, unknown, TContext>({\n      name: 'agent',\n      description:\n        'Execute one self-contained natural-language task with an injected Agent executor.',\n      stringInputKey: 'prompt',\n      inputSchema: agentInputSchema,\n      async execute(ctx) {\n        if (!options.agentExecutor) {\n          throw new NodeExecutionError(\n            'agent',\n            new TypeError('createMidsceneNodes() requires an agentExecutor.'),\n          );\n        }\n        const execution =\n          ctx.scope === 'case'\n            ? { scope: 'case' as const, runId: ctx.case.runId }\n            : {\n                scope: 'document' as const,\n                runId: ctx.document.documentRunId,\n              };\n        const result = await options.agentExecutor.execute({\n          prompt: ctx.input.prompt,\n          context: ctx.context,\n          signal: ctx.signal,\n          execution,\n        });\n        return result ?? { summary: 'Agent task completed.' };\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","nonBlankPrompt","description","createAgentTestRunnerNodes","definitions","getAgent","definition","ctx","agent","createAndroidNodes","androidAgentTestRunnerNodeDefinitions"],"mappings":"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"}