@midscene/test 1.12.5 → 1.12.6-beta-20260909034232.0

package/dist/es/ios/index.mjs

@@ -1,5 +1,6 @@
 import { iosAgentTestRunnerNodeDefinitions, launchInputSchema, runWdaRequestInputSchema, terminateInputSchema, wdaRequestInputSchema } from "@midscene/ios/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 createIOSNodes(options) {
     if (!options || 'object' != typeof options) throw new errors_NodeDefinitionError('createIOSNodes() options must be an object.');
     if ('function' != typeof options.getAgent) throw new errors_NodeDefinitionError('createIOSNodes() requires getAgent().');

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

@@ -1 +1 @@
-{"version":3,"file":"ios/index.mjs","sources":["../../../src/errors.ts","../../../src/node/define-node.ts","../../../src/midscene/index.ts","../../../src/ios/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 { IOSAgent } from '@midscene/ios';\nimport {\n  iosAgentTestRunnerNodeDefinitions,\n  launchInputSchema,\n  runWdaRequestInputSchema,\n  terminateInputSchema,\n  wdaRequestInputSchema,\n} from '@midscene/ios/test-runner';\nexport type {\n  LaunchNodeInput,\n  RunWdaRequestNodeInput,\n  TerminateNodeInput,\n  WDAHttpMethod,\n} from '@midscene/ios/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  runWdaRequestInputSchema,\n  terminateInputSchema,\n  wdaRequestInputSchema,\n};\n\nexport type IOSRunnerAgent = Pick<\n  IOSAgent,\n  'launch' | 'terminate' | 'runWdaRequest' | 'home' | 'appSwitcher'\n>;\n\nexport interface CreateIOSNodesOptions<TContext> {\n  getAgent(\n    ctx: NodeExecutionContext<unknown, TContext>,\n  ): Awaitable<IOSRunnerAgent>;\n}\n\nexport function createIOSNodes<TContext>(\n  options: CreateIOSNodesOptions<TContext>,\n): readonly NodeDefinition<any, any, TContext>[] {\n  if (!options || typeof options !== 'object') {\n    throw new NodeDefinitionError(\n      'createIOSNodes() options must be an object.',\n    );\n  }\n  if (typeof options.getAgent !== 'function') {\n    throw new NodeDefinitionError('createIOSNodes() requires getAgent().');\n  }\n\n  return createAgentTestRunnerNodes(\n    iosAgentTestRunnerNodeDefinitions,\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","createIOSNodes","iosAgentTestRunnerNodeDefinitions"],"mappings":"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"}
+{"version":3,"file":"ios/index.mjs","sources":["../../../src/errors.ts","../../../src/node/define-node.ts","../../../src/midscene/index.ts","../../../src/ios/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 { IOSAgent } from '@midscene/ios';\nimport {\n  iosAgentTestRunnerNodeDefinitions,\n  launchInputSchema,\n  runWdaRequestInputSchema,\n  terminateInputSchema,\n  wdaRequestInputSchema,\n} from '@midscene/ios/test-runner';\nexport type {\n  LaunchNodeInput,\n  RunWdaRequestNodeInput,\n  TerminateNodeInput,\n  WDAHttpMethod,\n} from '@midscene/ios/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  runWdaRequestInputSchema,\n  terminateInputSchema,\n  wdaRequestInputSchema,\n};\n\nexport type IOSRunnerAgent = Pick<\n  IOSAgent,\n  'launch' | 'terminate' | 'runWdaRequest' | 'home' | 'appSwitcher'\n>;\n\nexport interface CreateIOSNodesOptions<TContext> {\n  getAgent(\n    ctx: NodeExecutionContext<unknown, TContext>,\n  ): Awaitable<IOSRunnerAgent>;\n}\n\nexport function createIOSNodes<TContext>(\n  options: CreateIOSNodesOptions<TContext>,\n): readonly NodeDefinition<any, any, TContext>[] {\n  if (!options || typeof options !== 'object') {\n    throw new NodeDefinitionError(\n      'createIOSNodes() options must be an object.',\n    );\n  }\n  if (typeof options.getAgent !== 'function') {\n    throw new NodeDefinitionError('createIOSNodes() requires getAgent().');\n  }\n\n  return createAgentTestRunnerNodes(\n    iosAgentTestRunnerNodeDefinitions,\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","createIOSNodes","iosAgentTestRunnerNodeDefinitions"],"mappings":"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"}

package/dist/es/midscene/index.mjs

@@ -1,4 +1,5 @@
 import { aiActInputSchema, aiActOptionsInputSchema, aiAssertInputSchema, aiAssertOptionsInputSchema, aiTapInputSchema, insightInputSchema, insightOptionsInputSchema, locateOptionsInputSchema, promptImageInputSchema, recordToReportInputSchema, recordToReportOptionsInputSchema, reportScreenshotInputSchema, structuredUserPromptInputSchema, userPromptInputSchema } from "@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, {
@@ -38,6 +39,19 @@ 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.`, {
         node,
@@ -101,7 +115,54 @@ const waitFor = async (durationMs, signal)=>{
         });
     });
 };
-const createAgentTestRunnerNodes = (definitions, getAgent)=>definitions.map((definition)=>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)=>defineNode({
             name: definition.name,
             ...void 0 === definition.title ? {} : {
                 title: definition.title
@@ -115,11 +176,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 createMidsceneNodes(options) {
     if (!options || 'object' != typeof options) throw new NodeDefinitionError('createMidsceneNodes() options must be an object.');
     if ('function' != typeof options.agentProvider?.getAgent && 'function' != typeof options.getAgent) throw new NodeDefinitionError('createMidsceneNodes() requires getAgent or agentProvider.getAgent.');

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

@@ -1 +1 @@
-{"version":3,"file":"midscene/index.mjs","sources":["../../../src/errors.ts","../../../src/node/define-node.ts","../../../src/midscene/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"],"names":["WorkflowError","Error","undefined","message","options","NodeDefinitionError","details","validateOptionalText","value","field","node","validateInputSchema","schema","z","validateDefinition","defineNode","waitInputSchema","waitFor","durationMs","signal","Promise","resolve","reject","timeout","setTimeout","abort","clearTimeout","createAgentTestRunnerNodes","definitions","getAgent","definition","ctx","agent","createMidsceneNodes","registeredAgentScopes","Set","getExecutionId","runId","released","agentDefinitions","multiplier"],"mappings":"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"}
+{"version":3,"file":"midscene/index.mjs","sources":["../../../src/errors.ts","../../../src/node/define-node.ts","../../../src/midscene/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"],"names":["WorkflowError","Error","undefined","message","options","NodeDefinitionError","details","NodeExecutionError","node","cause","causeMessage","String","validateOptionalText","value","field","validateInputSchema","schema","z","validateDefinition","defineNode","waitInputSchema","waitFor","durationMs","signal","Promise","resolve","reject","timeout","setTimeout","abort","clearTimeout","createAgentTestRunnerNodes","definitions","getAgent","activeAgentCalls","WeakMap","runAgentCall","ctx","agent","call","captureExecutions","scopeId","activeCall","removeListener","sawExecutionWithoutId","stopListening","remove","stopListeningOnAbort","_dump","execution","warnReportTrace","definition","getDebug","createMidsceneNodes","registeredAgentScopes","Set","getExecutionId","runId","released","agentDefinitions","multiplier"],"mappings":";;;;;;;;;;;;;AAQO,MAAMA,sBAAsBC;IAWjC,SAAkC;QAChC,OAAO;YACL,MAAM,IAAI,CAAC,IAAI;YACf,SAAS,IAAI,CAAC,OAAO;YACrB,MAAM,IAAI,CAAC,IAAI;YACf,GAAI,AAAiBC,WAAjB,IAAI,CAAC,OAAO,GAAiB,CAAC,IAAI;gBAAE,SAAS,IAAI,CAAC,OAAO;YAAC,CAAC;QACjE;IACF;IAdA,YAAYC,OAAe,EAAEC,UAAgC,CAAC,CAAC,CAAE;QAC/D,KAAK,CAACD,SAAS;YAAE,OAAOC,QAAQ,KAAK;QAAC,IAJxC,uBAAS,QAAT,SACA,uBAAS,WAAT;QAIE,IAAI,CAAC,IAAI,GAAG,WAAW,IAAI;QAC3B,IAAI,CAAC,IAAI,GAAGA,QAAQ,IAAI,IAAI;QAC5B,IAAI,CAAC,OAAO,GAAGA,QAAQ,OAAO;IAChC;AAUF;AAQO,MAAMC,4BAA4BL;IACvC,YAAYG,OAAe,EAAEG,OAAiB,CAAE;QAC9C,KAAK,CAACH,SAAS;YAAE,MAAM;YAAyBG;QAAQ;IAC1D;AACF;AAkEO,MAAMC,2BAA2BP;IAGtC,YAAYQ,IAAY,EAAEC,KAAc,CAAE;QACxC,MAAMC,eACJD,iBAAiBR,QAAQQ,MAAM,OAAO,GAAGE,OAAOF,SAAS;QAC3D,KAAK,CAAC,CAAC,MAAM,EAAED,KAAK,UAAU,EAAEE,cAAc,EAAE;YAC9C,MAAM;YACN,SAAS;gBAAEF;YAAK;YAChBC;QACF,IATF,uBAAS,QAAT;QAUE,IAAI,CAAC,IAAI,GAAGD;IACd;AACF;AC5GA,MAAMI,uBAAuB,CAC3BC,OACAC,OACAN;IAEA,IACEK,AAAUX,WAAVW,SACC,CAAiB,YAAjB,OAAOA,SAAsBA,AAAwB,MAAxBA,MAAM,IAAI,GAAG,MAAM,AAAK,GAEtD,MAAM,IAAIR,oBACR,CAAC,MAAM,EAAEG,KAAK,EAAE,EAAEM,MAAM,4BAA4B,CAAC,EACrD;QAAEN;QAAMM;IAAM;AAGpB;AAEA,MAAMC,sBAAsB,CAACC,QAAiBR;IAC5C,IAAIQ,AAAWd,WAAXc,QAAsB;IAC1B,IAAI,CAAEA,CAAAA,kBAAkBC,EAAE,SAAQ,GAChC,MAAM,IAAIZ,oBACR,CAAC,MAAM,EAAEG,KAAK,0CAA0C,CAAC,EACzD;QAAEA;QAAM,OAAO;IAAc;IAGjC,IAAI,OAAOQ,OAAO,KAAK,EACrB,MAAM,IAAIX,oBACR,CAAC,MAAM,EAAEG,KAAK,wDAAwD,CAAC,EACvE;QAAEA;QAAM,OAAO;IAAgB;AAGrC;AAEA,MAAMU,qBAAqB,CAACd;IAQ1B,IAAI,CAACA,WAAW,AAAmB,YAAnB,OAAOA,SACrB,MAAM,IAAIC,oBAAoB;IAGhC,IAAI,AAAwB,YAAxB,OAAOD,QAAQ,IAAI,IAAiBA,AAA+B,MAA/BA,QAAQ,IAAI,CAAC,IAAI,GAAG,MAAM,EAChE,MAAM,IAAIC,oBAAoB;IAGhCO,qBAAqBR,QAAQ,KAAK,EAAE,SAASA,QAAQ,IAAI;IACzDQ,qBAAqBR,QAAQ,WAAW,EAAE,eAAeA,QAAQ,IAAI;IACrE,IACEA,AAA2BF,WAA3BE,QAAQ,cAAc,IACtBA,AAA2B,UAA3BA,QAAQ,cAAc,IACrB,CAAkC,YAAlC,OAAOA,QAAQ,cAAc,IAC5BA,AAAyC,MAAzCA,QAAQ,cAAc,CAAC,IAAI,GAAG,MAAM,AAAK,GAE3C,MAAM,IAAIC,oBACR,CAAC,MAAM,EAAED,QAAQ,IAAI,CAAC,qDAAqD,CAAC,EAC5E;QAAE,MAAMA,QAAQ,IAAI;QAAE,OAAO;IAAiB;IAGlDW,oBAAoBX,QAAQ,WAAW,EAAEA,QAAQ,IAAI;IAErD,IACE,AAAkC,YAAlC,OAAOA,QAAQ,cAAc,IAC7BA,QAAQ,WAAW,YAAYa,EAAE,SAAS,IAC1C,CAAEb,CAAAA,QAAQ,cAAc,IAAIA,QAAQ,WAAW,CAAC,KAAI,GAEpD,MAAM,IAAIC,oBACR,CAAC,MAAM,EAAED,QAAQ,IAAI,CAAC,uDAAuD,CAAC,EAC9E;QAAE,MAAMA,QAAQ,IAAI;QAAE,OAAO;IAAiB;IAIlD,IAAI,AAA2B,cAA3B,OAAOA,QAAQ,OAAO,EACxB,MAAM,IAAIC,oBACR,CAAC,MAAM,EAAED,QAAQ,IAAI,CAAC,mCAAmC,CAAC,EAC1D;QAAE,MAAMA,QAAQ,IAAI;IAAC;AAG3B;AAkBO,SAASe,WACdf,OAAyC;IAEzCc,mBAAmBd;IACnB,OAAOA;AACT;AC7CO,MAAMgB,kBAAkBH,EAAE,YAAY,CAAC;IAC5C,UAAUA,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACzC,MAAMA,CAAC,CAADA,OACC,CAAC;QAAC;QAAM;QAAK;KAAM,EACvB,OAAO,CAAC,MACR,QAAQ,CAAC;AACd;AAkBA,MAAMI,UAAU,OAAOC,YAAoBC;IACzC,IAAIA,OAAO,OAAO,EAChB,MAAMA,OAAO,MAAM,IAAI,IAAItB,MAAM;IAEnC,MAAM,IAAIuB,QAAc,CAACC,SAASC;QAChC,MAAMC,UAAUC,WAAW;YACzBL,OAAO,mBAAmB,CAAC,SAASM;YACpCJ;QACF,GAAGH;QACH,MAAMO,QAAQ;YACZC,aAAaH;YACbD,OAAOH,OAAO,MAAM,IAAI,IAAItB,MAAM;QACpC;QACAsB,OAAO,gBAAgB,CAAC,SAASM,OAAO;YAAE,MAAM;QAAK;IACvD;AACF;AAGO,MAAME,6BAA6B,CACxCC,aACAC;IAIA,MAAMC,mBAAmB,IAAIC;IAI7B,MAAMC,eAAe,OACnB5B,MACA6B,KACAC,OACAC,MACAC,oBAAoB,IAAI;QAExB,MAAMC,UACJJ,AAAc,WAAdA,IAAI,KAAK,GAAcA,IAAI,IAAI,CAAC,KAAK,GAAGA,IAAI,QAAQ,CAAC,aAAa;QACpE,MAAMK,aAAaR,iBAAiB,GAAG,CAACI;QACxC,IAAII,YACF,MAAM,IAAInC,mBACRC,MACA,IAAIP,MACF,CAAC,sFAAsF,EAAEyC,WAAW,OAAO,CAAC,EAAE,EAAEA,WAAW,IAAI,CAAC,oBAAoB,EAAED,QAAQ,EAAE,EAAEjC,KAAK,EAAE,CAAC;QAKhL0B,iBAAiB,GAAG,CAACI,OAAO;YAAEG;YAASjC;QAAK;QAC5C,IAAImC;QACJ,IAAIC,wBAAwB;QAC5B,MAAMC,gBAAgB;YACpB,MAAMC,SAASH;YACfA,iBAAiBzC;YACjB4C;QACF;QACA,MAAMC,uBAAuB,IAAMF;QACnC,IAAI;YACF,IAAIL,qBAAqBF,MAAM,qBAAqB,EAAE;gBACpDK,iBAAiBL,MAAM,qBAAqB,CAAC,CAACU,OAAOC;oBACnD,IAAI,CAACA,WAAW;oBAChB,IAAI,CAACA,UAAU,EAAE,EAAE;wBACjBL,wBAAwB;wBACxB;oBACF;oBACAP,IAAI,MAAM,CAAC,QAAQ,CAAC;wBAClB,MAAM;wBACN,aAAaY,UAAU,EAAE;oBAC3B;gBACF;gBACA,IAAIZ,IAAI,MAAM,CAAC,OAAO,EAAEQ;qBAEtBR,IAAI,MAAM,CAAC,gBAAgB,CAAC,SAASU,sBAAsB;oBACzD,MAAM;gBACR;YAEJ;YACA,OAAO,MAAMR;QACf,SAAU;YACRF,IAAI,MAAM,CAAC,mBAAmB,CAAC,SAASU;YACxC,IAAI;gBACFF;YACF,SAAU;gBACRX,iBAAiB,MAAM,CAACI;YAC1B;YACA,IAAIM,uBACFM,gBACE,CAAC,yDAAyD,EAAE1C,KAAK,UAAU,EAAEiC,QAAQ,CAAC,CAAC;QAG7F;IACF;IAEA,OAAOT,YAAY,GAAG,CAAC,CAACmB,aACtBhC,WAAW;YACT,MAAMgC,WAAW,IAAI;YACrB,GAAIA,AAAqBjD,WAArBiD,WAAW,KAAK,GAAiB,CAAC,IAAI;gBAAE,OAAOA,WAAW,KAAK;YAAC,CAAC;YACrE,GAAIA,AAA2BjD,WAA3BiD,WAAW,WAAW,GACtB,CAAC,IACD;gBAAE,aAAaA,WAAW,WAAW;YAAC,CAAC;YAC3C,GAAIA,AAA8BjD,WAA9BiD,WAAW,cAAc,GACzB,CAAC,IACD;gBAAE,gBAAgBA,WAAW,cAAc;YAAC,CAAC;YACjD,aAAaA,WAAW,WAAW;YACnC,MAAM,SAAQd,GAAG;gBACf,MAAMC,QAAQ,MAAML,SAASI;gBAC7B,MAAME,OAAO,UACXY,WAAW,OAAO,CAACb,OAAOD,IAAI,KAAK,EAAE;wBAAE,QAAQA,IAAI,MAAM;oBAAC;gBAC5D,IAAI,AAAiB,YAAjB,OAAOC,SAAsBA,AAAU,SAAVA,OAAgB,OAAOC;gBACxD,OAAOH,aACLe,WAAW,IAAI,EACfd,KACAC,OACAC;YAEJ;QACF;AAEJ;AAEA,MAAMW,kBAAkBE,SAAS,4BAA4B;IAC3D,SAAS;AACX;AAEO,SAASC,oBACdjD,OAA6C;IAE7C,IAAI,CAACA,WAAW,AAAmB,YAAnB,OAAOA,SACrB,MAAM,IAAIC,oBACR;IAGJ,IACE,AAA2C,cAA3C,OAAOD,QAAQ,aAAa,EAAE,YAC9B,AAA4B,cAA5B,OAAOA,QAAQ,QAAQ,EAEvB,MAAM,IAAIC,oBACR;IAGJ,IACE,CAACD,QAAQ,UAAU,IACnB,AAA2D,cAA3D,OAAOA,QAAQ,UAAU,CAAC,4BAA4B,EAEtD,MAAM,IAAIC,oBACR;IAIJ,MAAMiD,wBAAwB,IAAIC;IAClC,MAAMC,iBAAiB,CAACnB,MACtBA,AAAc,WAAdA,IAAI,KAAK,GAAcA,IAAI,IAAI,CAAC,KAAK,GAAGA,IAAI,QAAQ,CAAC,aAAa;IACpE,MAAMJ,WAAW,OACfI;QAEA,IAAI,CAACjC,QAAQ,aAAa,EAAE,OAAOA,QAAQ,QAAQ,CAAEiC;QACrD,MAAMoB,QAAQD,eAAenB;QAC7B,IACEjC,QAAQ,aAAa,CAAC,YAAY,IAClC,CAACkD,sBAAsB,GAAG,CAACG,QAC3B;YACAH,sBAAsB,GAAG,CAACG;YAC1BpB,IAAI,UAAU,CAAC;gBACb,IAAI;oBACF,MAAMqB,WAAW,MAAMtD,QAAQ,aAAa,CAAE,YAAY,CAAEqD;oBAC5D,OAAOC,UAAU,aACb;wBAAE,aAAa;4BAACA,SAAS,UAAU;yBAAC;oBAAC,IACrCxD;gBACN,SAAU;oBACRoD,sBAAsB,MAAM,CAACG;gBAC/B;YACF;QACF;QACA,OAAOrD,QAAQ,aAAa,CAAC,QAAQ,CAACqD,OAAOpB;IAC/C;IAEA,MAAMsB,mBAAmBvD,QAAQ,UAAU,CAAC,4BAA4B;IAExE,OAAO;WACF2B,2BAA2B4B,kBAAkB1B;QAChDd,WAAsD;YACpD,MAAM;YACN,aAAa;YACb,gBAAgB;YAChB,aAAaC;YACb,MAAM,SAAQiB,GAAG;gBACf,MAAMuB,aACJvB,AAAmB,UAAnBA,IAAI,KAAK,CAAC,IAAI,GACV,QACAA,AAAmB,QAAnBA,IAAI,KAAK,CAAC,IAAI,GACZ,OACA;gBACR,MAAMf,aAAae,IAAI,KAAK,CAAC,QAAQ,GAAGuB;gBACxC,MAAMvC,QAAQC,YAAYe,IAAI,MAAM;gBACpC,OAAO;oBAAE,SAAS,CAAC,OAAO,EAAEf,WAAW,EAAE,CAAC;gBAAC;YAC7C;QACF;KACD;AACH"}