@midscene/test 1.12.4-beta-20260903111111.0 → 1.12.4

package/dist/lib/harmony/index.js

@@ -0,0 +1,188 @@
+"use strict";
+var __webpack_modules__ = {
+    "./src/errors.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        __webpack_require__.d(__webpack_exports__, {
+            ww: ()=>NodeDefinitionError
+        });
+        function _define_property(obj, key, value) {
+            if (key in obj) Object.defineProperty(obj, key, {
+                value: value,
+                enumerable: true,
+                configurable: true,
+                writable: true
+            });
+            else obj[key] = value;
+            return obj;
+        }
+        class WorkflowError extends Error {
+            toJSON() {
+                return {
+                    name: this.name,
+                    message: this.message,
+                    code: this.code,
+                    ...void 0 === this.details ? {} : {
+                        details: this.details
+                    }
+                };
+            }
+            constructor(message, options = {}){
+                super(message, {
+                    cause: options.cause
+                }), _define_property(this, "code", void 0), _define_property(this, "details", void 0);
+                this.name = new.target.name;
+                this.code = options.code ?? 'WORKFLOW_ERROR';
+                this.details = options.details;
+            }
+        }
+        class NodeDefinitionError extends WorkflowError {
+            constructor(message, details){
+                super(message, {
+                    code: 'NODE_DEFINITION_ERROR',
+                    details
+                });
+            }
+        }
+    },
+    "./src/midscene/index.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        __webpack_require__.d(__webpack_exports__, {
+            createAgentTestRunnerNodes: ()=>createAgentTestRunnerNodes
+        });
+        require("@midscene/core/agent/test-runner");
+        const v4_namespaceObject = require("zod/v4");
+        var errors = __webpack_require__("./src/errors.ts");
+        const validateOptionalText = (value, field, node)=>{
+            if (void 0 !== value && ('string' != typeof value || 0 === value.trim().length)) throw new errors.ww(`Node "${node}" ${field} must be a non-empty string.`, {
+                node,
+                field
+            });
+        };
+        const validateInputSchema = (schema, node)=>{
+            if (void 0 === schema) return;
+            if (!(schema instanceof v4_namespaceObject.z.ZodObject)) throw new errors.ww(`Node "${node}" inputSchema must be a Zod object schema.`, {
+                node,
+                field: 'inputSchema'
+            });
+            if ('$' in schema.shape) throw new errors.ww(`Node "${node}" inputSchema must not declare "$" as an input property.`, {
+                node,
+                field: 'inputSchema.$'
+            });
+        };
+        const validateDefinition = (options)=>{
+            if (!options || 'object' != typeof options) throw new errors.ww('Node definition must be an object.');
+            if ('string' != typeof options.name || 0 === options.name.trim().length) throw new errors.ww('Node name must be a non-empty string.');
+            validateOptionalText(options.title, 'title', options.name);
+            validateOptionalText(options.description, "description", options.name);
+            if (void 0 !== options.stringInputKey && false !== options.stringInputKey && ('string' != typeof options.stringInputKey || 0 === options.stringInputKey.trim().length)) throw new errors.ww(`Node "${options.name}" stringInputKey must be a non-empty string or false.`, {
+                node: options.name,
+                field: 'stringInputKey'
+            });
+            validateInputSchema(options.inputSchema, options.name);
+            if ('string' == typeof options.stringInputKey && options.inputSchema instanceof v4_namespaceObject.z.ZodObject && !(options.stringInputKey in options.inputSchema.shape)) throw new errors.ww(`Node "${options.name}" stringInputKey must reference a field in inputSchema.`, {
+                node: options.name,
+                field: 'stringInputKey'
+            });
+            if ('function' != typeof options.execute) throw new errors.ww(`Node "${options.name}" must provide an execute function.`, {
+                node: options.name
+            });
+        };
+        function define_node_defineNode(options) {
+            validateDefinition(options);
+            return options;
+        }
+        const nonBlankPrompt = (description)=>v4_namespaceObject.z.string().regex(/\S/, 'prompt must contain a non-whitespace character').describe(description);
+        v4_namespaceObject.z.strictObject({
+            duration: v4_namespaceObject.z.number().positive().describe('How long to wait.'),
+            unit: v4_namespaceObject.z["enum"]([
+                'ms',
+                's',
+                'min'
+            ]).default('ms').describe('Duration unit: milliseconds, seconds, or minutes.')
+        });
+        v4_namespaceObject.z.strictObject({
+            prompt: nonBlankPrompt('A self-contained task, including allowed tools and success conditions.')
+        });
+        const createAgentTestRunnerNodes = (definitions, getAgent)=>definitions.map((definition)=>define_node_defineNode({
+                    name: definition.name,
+                    ...void 0 === definition.title ? {} : {
+                        title: definition.title
+                    },
+                    ...void 0 === definition.description ? {} : {
+                        description: definition.description
+                    },
+                    ...void 0 === definition.stringInputKey ? {} : {
+                        stringInputKey: definition.stringInputKey
+                    },
+                    inputSchema: definition.inputSchema,
+                    async execute (ctx) {
+                        const agent = await getAgent(ctx);
+                        return definition.execute(agent, ctx.input, {
+                            signal: ctx.signal
+                        });
+                    }
+                }));
+    }
+};
+var __webpack_module_cache__ = {};
+function __webpack_require__(moduleId) {
+    var cachedModule = __webpack_module_cache__[moduleId];
+    if (void 0 !== cachedModule) return cachedModule.exports;
+    var module = __webpack_module_cache__[moduleId] = {
+        exports: {}
+    };
+    __webpack_modules__[moduleId](module, module.exports, __webpack_require__);
+    return module.exports;
+}
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+(()=>{
+    __webpack_require__.r(__webpack_exports__);
+    __webpack_require__.d(__webpack_exports__, {
+        runHdcShellInputSchema: ()=>test_runner_namespaceObject.runHdcShellInputSchema,
+        createHarmonyNodes: ()=>createHarmonyNodes,
+        terminateInputSchema: ()=>test_runner_namespaceObject.terminateInputSchema,
+        launchInputSchema: ()=>test_runner_namespaceObject.launchInputSchema
+    });
+    const test_runner_namespaceObject = require("@midscene/harmony/test-runner");
+    var errors = __webpack_require__("./src/errors.ts");
+    var midscene = __webpack_require__("./src/midscene/index.ts");
+    function createHarmonyNodes(options) {
+        if (!options || 'object' != typeof options) throw new errors.ww('createHarmonyNodes() options must be an object.');
+        if ('function' != typeof options.getAgent) throw new errors.ww('createHarmonyNodes() requires getAgent().');
+        return (0, midscene.createAgentTestRunnerNodes)(test_runner_namespaceObject.harmonyAgentTestRunnerNodeDefinitions, options.getAgent);
+    }
+})();
+exports.createHarmonyNodes = __webpack_exports__.createHarmonyNodes;
+exports.launchInputSchema = __webpack_exports__.launchInputSchema;
+exports.runHdcShellInputSchema = __webpack_exports__.runHdcShellInputSchema;
+exports.terminateInputSchema = __webpack_exports__.terminateInputSchema;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "createHarmonyNodes",
+    "launchInputSchema",
+    "runHdcShellInputSchema",
+    "terminateInputSchema"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});
+
+//# sourceMappingURL=index.js.map

package/dist/lib/harmony/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harmony/index.js","sources":["../../../src/errors.ts","../../../src/node/define-node.ts","../../../src/midscene/index.ts","webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../../src/harmony/index.ts"],"sourcesContent":["import type { z } from 'zod/v4';\n\nexport interface WorkflowErrorOptions {\n  code?: string;\n  details?: unknown;\n  cause?: unknown;\n}\n\nexport class WorkflowError extends Error {\n  readonly code: string;\n  readonly details?: unknown;\n\n  constructor(message: string, options: WorkflowErrorOptions = {}) {\n    super(message, { cause: options.cause });\n    this.name = new.target.name;\n    this.code = options.code ?? 'WORKFLOW_ERROR';\n    this.details = options.details;\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      ...(this.details === undefined ? {} : { details: this.details }),\n    };\n  }\n}\n\nexport class WorkflowParseError extends WorkflowError {\n  constructor(message: string, details?: unknown, cause?: unknown) {\n    super(message, { code: 'WORKFLOW_PARSE_ERROR', details, cause });\n  }\n}\n\nexport class NodeDefinitionError extends WorkflowError {\n  constructor(message: string, details?: unknown) {\n    super(message, { code: 'NODE_DEFINITION_ERROR', details });\n  }\n}\n\nexport class DuplicateNodeError extends WorkflowError {\n  readonly node: string;\n\n  constructor(node: string) {\n    super(`Node \"${node}\" is already registered.`, {\n      code: 'DUPLICATE_NODE',\n      details: { node },\n    });\n    this.node = node;\n  }\n}\n\nexport class NodeNotFoundError extends WorkflowError {\n  readonly node: string;\n\n  constructor(node: string) {\n    super(`Node \"${node}\" is not registered.`, {\n      code: 'NODE_NOT_FOUND',\n      details: { node },\n    });\n    this.node = node;\n  }\n}\n\nexport class NodeInputValidationError extends WorkflowError {\n  constructor(message: string, details?: unknown) {\n    super(message, { code: 'NODE_INPUT_VALIDATION_ERROR', details });\n  }\n\n  static fromZod(node: string, error: z.ZodError): NodeInputValidationError {\n    const issues = error.issues.map((issue) => ({\n      code: issue.code,\n      path: issue.path.map(String).join('.'),\n      message: issue.message,\n    }));\n    const firstIssue = issues[0];\n    const path = firstIssue?.path || '<root>';\n    const message = firstIssue?.message ?? 'invalid input';\n    return new NodeInputValidationError(\n      `Node \"${node}\" input validation failed at \"${path}\": ${message}`,\n      { node, issues },\n    );\n  }\n}\n\nexport class StepTimeoutError extends WorkflowError {\n  readonly timeoutMs: number;\n  readonly node?: string;\n\n  constructor(timeoutMs: number, node?: string) {\n    super(\n      node\n        ? `Node \"${node}\" timed out after ${timeoutMs}ms.`\n        : `Step timed out after ${timeoutMs}ms.`,\n      {\n        code: 'STEP_TIMEOUT',\n        details: { timeoutMs, ...(node === undefined ? {} : { node }) },\n      },\n    );\n    this.timeoutMs = timeoutMs;\n    this.node = node;\n  }\n}\n\nexport class NodeExecutionError extends WorkflowError {\n  readonly node: string;\n\n  constructor(node: string, cause: unknown) {\n    const causeMessage =\n      cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');\n    super(`Node \"${node}\" failed: ${causeMessage}`, {\n      code: 'NODE_EXECUTION_ERROR',\n      details: { node },\n      cause,\n    });\n    this.node = node;\n  }\n}\n\nexport class WorkflowLifecycleError extends WorkflowError {\n  constructor(message: string, details?: unknown) {\n    super(message, { code: 'WORKFLOW_LIFECYCLE_ERROR', details });\n  }\n}\n\nexport class ProjectSetupError extends WorkflowError {\n  constructor(cause: unknown, details: { projectName: string }) {\n    const causeMessage =\n      cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');\n    super(`Project \"${details.projectName}\" setup failed: ${causeMessage}`, {\n      code: 'PROJECT_SETUP_ERROR',\n      details,\n      cause,\n    });\n  }\n}\n\nexport class ProjectTeardownError extends WorkflowError {\n  constructor(\n    cause: unknown,\n    details: { projectName: string; registrationIndex: number },\n  ) {\n    const causeMessage =\n      cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');\n    super(`Project \"${details.projectName}\" teardown failed: ${causeMessage}`, {\n      code: 'PROJECT_TEARDOWN_ERROR',\n      details,\n      cause,\n    });\n  }\n}\n\nexport class NodeScopeTeardownError extends WorkflowError {\n  constructor(\n    cause: unknown,\n    details: {\n      scope: 'case' | 'document';\n      scopeId: string;\n      node: string;\n      registrationIndex: number;\n    },\n  ) {\n    const causeMessage =\n      cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');\n    super(\n      `${details.scope === 'case' ? 'Case attempt' : 'Workflow document'} node teardown failed for \"${details.node}\": ${causeMessage}`,\n      { code: 'NODE_SCOPE_TEARDOWN_ERROR', details, cause },\n    );\n  }\n}\n\nexport class FatalDeviceError extends WorkflowError {\n  constructor(message: string, cause?: unknown) {\n    super(message, { code: 'FATAL_DEVICE_ERROR', cause });\n  }\n}\n\nexport const isFatalDeviceError = (error: unknown): boolean => {\n  if (error instanceof FatalDeviceError) return true;\n  if (error instanceof WorkflowError && error.code === 'FATAL_DEVICE_ERROR') {\n    return true;\n  }\n  if (\n    error instanceof Error &&\n    /device offline|device not found|(?:adb|bdc|device) connection (?:was )?closed/i.test(\n      error.message,\n    )\n  ) {\n    return true;\n  }\n  return error instanceof Error && error.cause !== undefined\n    ? isFatalDeviceError(error.cause)\n    : false;\n};\n\nexport class CaseExecutionError extends WorkflowError {\n  readonly result: import('./engine/types').CaseRunResult;\n\n  constructor(result: import('./engine/types').CaseRunResult) {\n    super(`Case \"${result.name}\" failed.`, {\n      code: 'CASE_EXECUTION_FAILED',\n      details: { caseId: result.caseId, runId: result.runId },\n    });\n    this.result = result;\n  }\n}\n\nexport class WorkflowDocumentExecutionError extends WorkflowError {\n  readonly result: import('./engine/types').WorkflowDocumentRunResult;\n\n  constructor(result: import('./engine/types').WorkflowDocumentRunResult) {\n    super(`Workflow document \"${result.sourcePath}\" failed.`, {\n      code: 'WORKFLOW_DOCUMENT_EXECUTION_FAILED',\n      details: {\n        documentId: result.documentId,\n        documentRunId: result.documentRunId,\n      },\n    });\n    this.result = result;\n  }\n}\n\nexport function normalizeNodeExecutionError(\n  error: unknown,\n  node: string,\n): WorkflowError {\n  return error instanceof WorkflowError\n    ? error\n    : new NodeExecutionError(node, error);\n}\n","import { z } from 'zod/v4';\nimport { NodeDefinitionError } from '../errors';\nimport type {\n  DefineNodeOptions,\n  DefineNodeWithSchemaOptions,\n  NodeDefinition,\n  NodeDefinitionWithSchema,\n  NodeInputSchema,\n} from './types';\n\nconst validateOptionalText = (\n  value: unknown,\n  field: 'title' | 'description',\n  node: string,\n): void => {\n  if (\n    value !== undefined &&\n    (typeof value !== 'string' || value.trim().length === 0)\n  ) {\n    throw new NodeDefinitionError(\n      `Node \"${node}\" ${field} must be a non-empty string.`,\n      { node, field },\n    );\n  }\n};\n\nconst validateInputSchema = (schema: unknown, node: string): void => {\n  if (schema === undefined) return;\n  if (!(schema instanceof z.ZodObject)) {\n    throw new NodeDefinitionError(\n      `Node \"${node}\" inputSchema must be a Zod object schema.`,\n      { node, field: 'inputSchema' },\n    );\n  }\n  if ('$' in schema.shape) {\n    throw new NodeDefinitionError(\n      `Node \"${node}\" inputSchema must not declare \"$\" as an input property.`,\n      { node, field: 'inputSchema.$' },\n    );\n  }\n};\n\nconst validateDefinition = (options: {\n  name: string;\n  title?: unknown;\n  description?: unknown;\n  stringInputKey?: unknown;\n  inputSchema?: unknown;\n  execute: unknown;\n}): void => {\n  if (!options || typeof options !== 'object') {\n    throw new NodeDefinitionError('Node definition must be an object.');\n  }\n\n  if (typeof options.name !== 'string' || options.name.trim().length === 0) {\n    throw new NodeDefinitionError('Node name must be a non-empty string.');\n  }\n\n  validateOptionalText(options.title, 'title', options.name);\n  validateOptionalText(options.description, 'description', options.name);\n  if (\n    options.stringInputKey !== undefined &&\n    options.stringInputKey !== false &&\n    (typeof options.stringInputKey !== 'string' ||\n      options.stringInputKey.trim().length === 0)\n  ) {\n    throw new NodeDefinitionError(\n      `Node \"${options.name}\" stringInputKey must be a non-empty string or false.`,\n      { node: options.name, field: 'stringInputKey' },\n    );\n  }\n  validateInputSchema(options.inputSchema, options.name);\n\n  if (\n    typeof options.stringInputKey === 'string' &&\n    options.inputSchema instanceof z.ZodObject &&\n    !(options.stringInputKey in options.inputSchema.shape)\n  ) {\n    throw new NodeDefinitionError(\n      `Node \"${options.name}\" stringInputKey must reference a field in inputSchema.`,\n      { node: options.name, field: 'stringInputKey' },\n    );\n  }\n\n  if (typeof options.execute !== 'function') {\n    throw new NodeDefinitionError(\n      `Node \"${options.name}\" must provide an execute function.`,\n      { node: options.name },\n    );\n  }\n};\n\nexport function defineNode<\n  TSchema extends NodeInputSchema,\n  TData = unknown,\n  TContext = unknown,\n>(\n  options: DefineNodeWithSchemaOptions<TSchema, TData, TContext>,\n): NodeDefinitionWithSchema<TSchema, TData, TContext>;\n\nexport function defineNode<\n  TInput = unknown,\n  TData = unknown,\n  TContext = unknown,\n>(\n  options: DefineNodeOptions<TInput, TData, TContext>,\n): NodeDefinition<TInput, TData, TContext>;\n\nexport function defineNode(\n  options: DefineNodeOptions<any, any, any>,\n): NodeDefinition<any, any, any> {\n  validateDefinition(options);\n  return options;\n}\n","import {\n  type AgentTestRunnerNodeDefinition,\n  type AgentTestRunnerNodeProvider,\n  type CommonAgentTestRunnerApi,\n  aiActInputSchema,\n  aiActOptionsInputSchema,\n  aiAssertInputSchema,\n  aiAssertOptionsInputSchema,\n  aiTapInputSchema,\n  insightInputSchema,\n  insightOptionsInputSchema,\n  locateOptionsInputSchema,\n  promptImageInputSchema,\n  recordToReportInputSchema,\n  recordToReportOptionsInputSchema,\n  reportScreenshotInputSchema,\n  structuredUserPromptInputSchema,\n  userPromptInputSchema,\n} from '@midscene/core/agent/test-runner';\nimport { z } from 'zod/v4';\nimport type { Awaitable } from '../engine/types';\nimport { NodeDefinitionError, NodeExecutionError } from '../errors';\nimport { defineNode } from '../node/define-node';\nimport type {\n  NodeDefinition,\n  NodeExecutionContext,\n  NodeResult,\n} from '../node/types';\n\nexport type MidsceneUIAgent = CommonAgentTestRunnerApi;\n\nexport {\n  aiActInputSchema,\n  aiActOptionsInputSchema,\n  aiAssertInputSchema,\n  aiAssertOptionsInputSchema,\n  aiTapInputSchema,\n  insightInputSchema,\n  insightOptionsInputSchema,\n  locateOptionsInputSchema,\n  promptImageInputSchema,\n  recordToReportInputSchema,\n  recordToReportOptionsInputSchema,\n  reportScreenshotInputSchema,\n  structuredUserPromptInputSchema,\n  userPromptInputSchema,\n};\n\nexport interface AgentProvider<TContext> {\n  getAgent(\n    runId: string,\n    ctx: NodeExecutionContext<unknown, TContext>,\n  ): Awaitable<MidsceneUIAgent>;\n  // biome-ignore lint/suspicious/noConfusingVoidType: providers without a report intentionally return void.\n  releaseAgent?(runId: string): Awaitable<AgentReleaseResult | void>;\n  dispose?(): Awaitable<void>;\n}\n\nexport interface AgentReleaseResult {\n  /** Absolute path to the finalized report for this Agent scope. */\n  reportPath?: string;\n}\n\nexport interface AgentExecutorInput<TContext> {\n  prompt: string;\n  context: TContext;\n  signal: AbortSignal;\n  execution:\n    | { scope: 'case'; runId: string }\n    | { scope: 'document'; runId: string };\n}\n\nexport interface AgentExecutor<TContext> {\n  // biome-ignore lint/suspicious/noConfusingVoidType: executors may perform side effects without returning a summary.\n  execute(input: AgentExecutorInput<TContext>): Awaitable<NodeResult | void>;\n}\n\nconst nonBlankPrompt = (description: string) =>\n  z\n    .string()\n    .regex(/\\S/, 'prompt must contain a non-whitespace character')\n    .describe(description);\n\nexport const waitInputSchema = z.strictObject({\n  duration: z.number().positive().describe('How long to wait.'),\n  unit: z\n    .enum(['ms', 's', 'min'])\n    .default('ms')\n    .describe('Duration unit: milliseconds, seconds, or minutes.'),\n});\n\nexport const agentInputSchema = z.strictObject({\n  prompt: nonBlankPrompt(\n    'A self-contained task, including allowed tools and success conditions.',\n  ),\n});\n\nexport type AiActNodeInput = z.infer<typeof aiActInputSchema>;\nexport type AiAssertNodeInput = z.infer<typeof aiAssertInputSchema>;\nexport type AiTapNodeInput = z.infer<typeof aiTapInputSchema>;\nexport type InsightNodeInput = z.infer<typeof insightInputSchema>;\nexport type RecordToReportNodeInput = z.infer<typeof recordToReportInputSchema>;\nexport type WaitNodeInput = z.infer<typeof waitInputSchema>;\nexport type AgentNodeInput = z.infer<typeof agentInputSchema>;\n\nexport interface CreateMidsceneNodesOptions<TContext> {\n  getAgent?(\n    ctx: NodeExecutionContext<unknown, TContext>,\n  ): Awaitable<MidsceneUIAgent>;\n  agentProvider?: AgentProvider<TContext>;\n  /** Agent class that declares the Agent-backed Nodes to register. */\n  agentClass: AgentTestRunnerNodeProvider;\n  agentExecutor?: AgentExecutor<TContext>;\n}\n\nconst waitFor = async (durationMs: number, signal: AbortSignal) => {\n  if (signal.aborted) {\n    throw signal.reason ?? new Error('Wait aborted.');\n  }\n  await new Promise<void>((resolve, reject) => {\n    const timeout = setTimeout(() => {\n      signal.removeEventListener('abort', abort);\n      resolve();\n    }, durationMs);\n    const abort = () => {\n      clearTimeout(timeout);\n      reject(signal.reason ?? new Error('Wait aborted.'));\n    };\n    signal.addEventListener('abort', abort, { once: true });\n  });\n};\n\n/** Adapt Agent-owned descriptions to executable Test Runner Nodes. */\nexport const createAgentTestRunnerNodes = <TContext>(\n  definitions: readonly AgentTestRunnerNodeDefinition[],\n  getAgent: (\n    ctx: NodeExecutionContext<unknown, TContext>,\n  ) => Awaitable<unknown>,\n): readonly NodeDefinition<any, any, TContext>[] =>\n  definitions.map((definition) =>\n    defineNode({\n      name: definition.name,\n      ...(definition.title === undefined ? {} : { title: definition.title }),\n      ...(definition.description === undefined\n        ? {}\n        : { description: definition.description }),\n      ...(definition.stringInputKey === undefined\n        ? {}\n        : { stringInputKey: definition.stringInputKey }),\n      inputSchema: definition.inputSchema,\n      async execute(ctx) {\n        const agent = await getAgent(ctx);\n        return definition.execute(agent, ctx.input, {\n          signal: ctx.signal,\n        });\n      },\n    }),\n  );\n\nexport function createMidsceneNodes<TContext>(\n  options: CreateMidsceneNodesOptions<TContext>,\n): readonly NodeDefinition<any, any, TContext>[] {\n  if (!options || typeof options !== 'object') {\n    throw new NodeDefinitionError(\n      'createMidsceneNodes() options must be an object.',\n    );\n  }\n  if (\n    typeof options.agentProvider?.getAgent !== 'function' &&\n    typeof options.getAgent !== 'function'\n  ) {\n    throw new NodeDefinitionError(\n      'createMidsceneNodes() requires getAgent or agentProvider.getAgent.',\n    );\n  }\n  if (\n    !options.agentClass ||\n    typeof options.agentClass.getTestRunnerNodeDefinitions !== 'function'\n  ) {\n    throw new NodeDefinitionError(\n      'createMidsceneNodes() requires agentClass.getTestRunnerNodeDefinitions().',\n    );\n  }\n\n  const registeredAgentScopes = new Set<string>();\n  const getExecutionId = (ctx: NodeExecutionContext<unknown, TContext>) =>\n    ctx.scope === 'case' ? ctx.case.runId : ctx.document.documentRunId;\n  const getAgent = async (\n    ctx: NodeExecutionContext<unknown, TContext>,\n  ): Promise<MidsceneUIAgent> => {\n    if (!options.agentProvider) return options.getAgent!(ctx);\n    const runId = getExecutionId(ctx);\n    if (\n      options.agentProvider.releaseAgent &&\n      !registeredAgentScopes.has(runId)\n    ) {\n      registeredAgentScopes.add(runId);\n      ctx.onTeardown(async () => {\n        try {\n          const released = await options.agentProvider!.releaseAgent!(runId);\n          return released?.reportPath\n            ? { reportPaths: [released.reportPath] }\n            : undefined;\n        } finally {\n          registeredAgentScopes.delete(runId);\n        }\n      });\n    }\n    return options.agentProvider.getAgent(runId, ctx);\n  };\n\n  const agentDefinitions = options.agentClass.getTestRunnerNodeDefinitions();\n\n  return [\n    ...createAgentTestRunnerNodes(agentDefinitions, getAgent),\n    defineNode<typeof waitInputSchema, unknown, TContext>({\n      name: 'wait',\n      description: 'Wait for a fixed duration while honoring cancellation.',\n      stringInputKey: false,\n      inputSchema: waitInputSchema,\n      async execute(ctx) {\n        const multiplier =\n          ctx.input.unit === 'min'\n            ? 60_000\n            : ctx.input.unit === 's'\n              ? 1_000\n              : 1;\n        const durationMs = ctx.input.duration * multiplier;\n        await waitFor(durationMs, ctx.signal);\n        return { summary: `Waited ${durationMs}ms` };\n      },\n    }),\n    defineNode<typeof agentInputSchema, unknown, TContext>({\n      name: 'agent',\n      description:\n        'Execute one self-contained natural-language task with an injected Agent executor.',\n      stringInputKey: 'prompt',\n      inputSchema: agentInputSchema,\n      async execute(ctx) {\n        if (!options.agentExecutor) {\n          throw new NodeExecutionError(\n            'agent',\n            new TypeError('createMidsceneNodes() requires an agentExecutor.'),\n          );\n        }\n        const execution =\n          ctx.scope === 'case'\n            ? { scope: 'case' as const, runId: ctx.case.runId }\n            : {\n                scope: 'document' as const,\n                runId: ctx.document.documentRunId,\n              };\n        const result = await options.agentExecutor.execute({\n          prompt: ctx.input.prompt,\n          context: ctx.context,\n          signal: ctx.signal,\n          execution,\n        });\n        return result ?? { summary: 'Agent task completed.' };\n      },\n    }),\n  ];\n}\n","__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import type { HarmonyAgent } from '@midscene/harmony';\nimport {\n  harmonyAgentTestRunnerNodeDefinitions,\n  launchInputSchema,\n  runHdcShellInputSchema,\n  terminateInputSchema,\n} from '@midscene/harmony/test-runner';\nexport type {\n  LaunchNodeInput,\n  RunHdcShellNodeInput,\n  TerminateNodeInput,\n} from '@midscene/harmony/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 { launchInputSchema, runHdcShellInputSchema, terminateInputSchema };\n\nexport type HarmonyRunnerAgent = Pick<\n  HarmonyAgent,\n  'launch' | 'terminate' | 'runHdcShell' | 'back' | 'home' | 'recentApps'\n>;\n\nexport interface CreateHarmonyNodesOptions<TContext> {\n  getAgent(\n    ctx: NodeExecutionContext<unknown, TContext>,\n  ): Awaitable<HarmonyRunnerAgent>;\n}\n\nexport function createHarmonyNodes<TContext>(\n  options: CreateHarmonyNodesOptions<TContext>,\n): readonly NodeDefinition<any, any, TContext>[] {\n  if (!options || typeof options !== 'object') {\n    throw new NodeDefinitionError(\n      'createHarmonyNodes() options must be an object.',\n    );\n  }\n  if (typeof options.getAgent !== 'function') {\n    throw new NodeDefinitionError('createHarmonyNodes() requires getAgent().');\n  }\n\n  return createAgentTestRunnerNodes(\n    harmonyAgentTestRunnerNodeDefinitions,\n    options.getAgent,\n  );\n}\n"],"names":["WorkflowError","Error","undefined","message","options","NodeDefinitionError","details","validateOptionalText","value","field","node","validateInputSchema","schema","z","validateDefinition","defineNode","nonBlankPrompt","description","createAgentTestRunnerNodes","definitions","getAgent","definition","ctx","agent","__webpack_require__","key","Object","obj","prop","Symbol","createHarmonyNodes","harmonyAgentTestRunnerNodeDefinitions"],"mappings":"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"}

package/dist/lib/index.js

@@ -27,14 +27,12 @@ __webpack_require__.d(__webpack_exports__, {
     NodeInputValidationError: ()=>NodeInputValidationError,
     createCaseRunner: ()=>createCaseRunner,
     isFatalDeviceError: ()=>isFatalDeviceError,
-    normalizeSteps: ()=>normalizeSteps,
-    toHistoryEntry: ()=>toHistoryEntry,
+    collectWorkflowDocument: ()=>collectWorkflowDocument,
     FatalDeviceError: ()=>FatalDeviceError,
     runWorkflowDocument: ()=>runWorkflowDocument,
     defineNode: ()=>defineNode,
     z: ()=>v4_namespaceObject.z,
     createProjectRuntime: ()=>createProjectRuntime,
-    createHistory: ()=>createHistory,
     createWorkflowDocumentId: ()=>createWorkflowDocumentId,
     NodeDefinitionError: ()=>NodeDefinitionError,
     normalizeNodeExecutionError: ()=>normalizeNodeExecutionError,
@@ -48,8 +46,6 @@ __webpack_require__.d(__webpack_exports__, {
     NodeRegistry: ()=>NodeRegistry,
     CaseRunner: ()=>CaseRunner,
     StepTimeoutError: ()=>StepTimeoutError,
-    assertJsonSerializable: ()=>assertJsonSerializable,
-    validateCommonNodeInput: ()=>validateCommonNodeInput,
     WorkflowParseError: ()=>WorkflowParseError,
     NodeScopeTeardownError: ()=>NodeScopeTeardownError,
     WorkflowDocumentExecutionError: ()=>WorkflowDocumentExecutionError,
@@ -58,7 +54,7 @@ __webpack_require__.d(__webpack_exports__, {
     resolveWorkflowVariables: ()=>resolveWorkflowVariables,
     createCaseId: ()=>createCaseId,
     createDocumentRuntime: ()=>createDocumentRuntime,
-    collectWorkflowDocument: ()=>collectWorkflowDocument
+    normalizeSteps: ()=>normalizeSteps
 });
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
@@ -296,13 +292,7 @@ function normalizeMeta(value, index) {
         continueOnError: continueOnError ?? false
     };
 }
-function validateCommonNodeInput(input, index) {
-    if (void 0 !== input.prompt && 'string' != typeof input.prompt) throw new WorkflowParseError(`${formatStep(index)} "prompt" must be a string.`, {
-        index,
-        prompt: input.prompt
-    });
-}
-function normalizeStep(value, index = 0) {
+function normalizeStep(value, index = 0, resolveNode) {
     if (!isMapping(value)) throw new WorkflowParseError(`${formatStep(index)} must be a mapping.`, {
         index
     });
@@ -315,30 +305,37 @@ function normalizeStep(value, index = 0) {
     if (0 === node.trim().length) throw new WorkflowParseError(`${formatStep(index)} node name must not be empty.`, {
         index
     });
-    if ('string' == typeof rawValue) return {
-        node,
-        input: {
-            prompt: rawValue
-        },
-        meta: {
-            continueOnError: false
-        }
-    };
+    if ('string' == typeof rawValue) {
+        const resolvedNode = resolveNode?.(node);
+        const stringInputKey = resolvedNode ? resolvedNode.stringInputKey : 'prompt';
+        if (false === stringInputKey || void 0 === stringInputKey) throw new WorkflowParseError(`${formatStep(index)} node "${node}" does not accept string shorthand.`, {
+            index,
+            node
+        });
+        return {
+            node,
+            input: {
+                [stringInputKey]: rawValue
+            },
+            meta: {
+                continueOnError: false
+            }
+        };
+    }
     if (!isMapping(rawValue)) throw new WorkflowParseError(`${formatStep(index)} value must be a string shorthand or a mapping.`, {
         index,
         node
     });
     const { $: rawMeta, ...input } = rawValue;
-    validateCommonNodeInput(input, index);
     return {
         node,
         input,
         meta: normalizeMeta(rawMeta, index)
     };
 }
-function normalizeSteps(steps) {
+function normalizeSteps(steps, resolveNode) {
     if (!Array.isArray(steps)) throw new WorkflowParseError('Steps must be an array.');
-    return steps.map((step, index)=>normalizeStep(step, index));
+    return steps.map((step, index)=>normalizeStep(step, index, resolveNode));
 }
 const v4_namespaceObject = require("zod/v4");
 const validateOptionalText = (value, field, node)=>{
@@ -363,7 +360,15 @@ const validateDefinition = (options)=>{
     if ('string' != typeof options.name || 0 === options.name.trim().length) throw new NodeDefinitionError('Node name must be a non-empty string.');
     validateOptionalText(options.title, 'title', options.name);
     validateOptionalText(options.description, "description", options.name);
+    if (void 0 !== options.stringInputKey && false !== options.stringInputKey && ('string' != typeof options.stringInputKey || 0 === options.stringInputKey.trim().length)) throw new NodeDefinitionError(`Node "${options.name}" stringInputKey must be a non-empty string or false.`, {
+        node: options.name,
+        field: 'stringInputKey'
+    });
     validateInputSchema(options.inputSchema, options.name);
+    if ('string' == typeof options.stringInputKey && options.inputSchema instanceof v4_namespaceObject.z.ZodObject && !(options.stringInputKey in options.inputSchema.shape)) throw new NodeDefinitionError(`Node "${options.name}" stringInputKey must reference a field in inputSchema.`, {
+        node: options.name,
+        field: 'stringInputKey'
+    });
     if ('function' != typeof options.execute) throw new NodeDefinitionError(`Node "${options.name}" must provide an execute function.`, {
         node: options.name
     });
@@ -451,45 +456,6 @@ const assertJsonSerializable = (value, label, node)=>{
         throw new NodeExecutionError(node, error);
     }
 };
-const cloneAndFreezeJson = (value)=>{
-    if (Array.isArray(value)) return Object.freeze(value.map(cloneAndFreezeJson));
-    if ('object' == typeof value && null !== value) return Object.freeze(Object.fromEntries(Object.entries(value).map(([key, child])=>[
-            key,
-            cloneAndFreezeJson(child)
-        ])));
-    return value;
-};
-const toHistoryEntry = (result, scope)=>{
-    assertJsonSerializable(result.input, 'input', result.node);
-    if (result.output?.data !== void 0) assertJsonSerializable(result.output.data, 'output.data', result.node);
-    return Object.freeze({
-        scope,
-        phase: result.phase,
-        stepIndex: result.stepIndex,
-        node: result.node,
-        input: cloneAndFreezeJson(result.input),
-        ...'string' == typeof result.input?.prompt ? {
-            intent: result.input.prompt
-        } : {},
-        status: 'success' === result.status ? 'passed' : 'failed',
-        ...result.output?.summary === void 0 ? {} : {
-            summary: result.output.summary
-        },
-        ...result.output?.data === void 0 ? {} : {
-            data: cloneAndFreezeJson(result.output.data)
-        },
-        ...result.error ? {
-            error: Object.freeze({
-                name: result.error.name,
-                message: result.error.message
-            })
-        } : {}
-    });
-};
-const createHistory = (prefix, results, scope)=>Object.freeze([
-        ...prefix,
-        ...results.map((result)=>toHistoryEntry(result, scope))
-    ]);
 function validateNodeOutput(output, node) {
     if (void 0 === output) return;
     if ('object' != typeof output || null === output || Array.isArray(output)) throw new NodeExecutionError(node, new TypeError('Node output must be an object or undefined.'));
@@ -511,7 +477,6 @@ function createStepResultBase(step, startedAt, phase, stepIndex) {
     };
 }
 async function executeNode(step, execute, phase, stepIndex, options) {
-    validateCommonNodeInput(step.input, stepIndex);
     const startedAt = new Date();
     const abortController = new AbortController();
     const parentSignal = options.parentSignal;
@@ -595,7 +560,6 @@ async function executeStep(step, node, target, context, execution = {}) {
             $: step.meta,
             signal,
             context,
-            history: execution.history ?? Object.freeze([]),
             onTeardown: (teardown)=>{
                 if (!execution.onTeardown) throw new NodeExecutionError(step.node, new Error('The current execution scope cannot register teardown.'));
                 execution.onTeardown(step.node, teardown);
@@ -644,7 +608,6 @@ async function runCollectedCase(collectedCase, options) {
     const beforeEach = [];
     const steps = [];
     const afterEach = [];
-    const completedNodes = [];
     const teardownStack = [];
     let acceptingTeardowns = true;
     const onTeardown = (node, teardown)=>{
@@ -673,13 +636,7 @@ async function runCollectedCase(collectedCase, options) {
                 sourcePath: collectedCase.sourcePath,
                 caseIndex: collectedCase.caseIndex,
                 phase,
-                stepIndex,
-                completedSteps: Object.freeze([
-                    ...steps
-                ]),
-                completedNodes: Object.freeze([
-                    ...completedNodes
-                ])
+                stepIndex
             };
             const stepInfo = {
                 scope: 'case',
@@ -692,14 +649,12 @@ async function runCollectedCase(collectedCase, options) {
                 scope: 'case',
                 case: caseContext
             }, options.context, {
-                history: createHistory(options.documentHistory ?? [], completedNodes, 'case'),
                 signal,
                 defaultTimeoutMs: options.defaultTimeoutMs,
                 onTeardown
             });
             await options.onStepResult?.(stepInfo, result);
             results.push(result);
-            completedNodes.push(result);
             if ('failed' === result.status && !result.continuedAfterError) break;
         }
     };
@@ -739,7 +694,7 @@ async function runCollectedCase(collectedCase, options) {
         name: collectedCase.definition.name,
         sourcePath: collectedCase.sourcePath,
         caseIndex: collectedCase.caseIndex,
-        status: completedNodes.some((step)=>'failed' === step.status) || teardownErrors.length > 0 ? 'failed' : 'success',
+        status: beforeEach.some((step)=>'failed' === step.status) || steps.some((step)=>'failed' === step.status) || afterEach.some((step)=>'failed' === step.status) || teardownErrors.length > 0 ? 'failed' : 'success',
         beforeEach,
         steps,
         afterEach,
@@ -782,7 +737,7 @@ class CaseRunner {
             definition: {
                 name: input.name ?? 'case',
                 tags: input.tags ?? [],
-                steps: normalizeSteps(input.steps)
+                steps: normalizeSteps(input.steps, (name)=>this.registry.get(name))
             }
         };
         const result = await runCollectedCase(collectedCase, {
@@ -809,7 +764,6 @@ function createDocumentRuntime(document, options) {
     const startedAt = new Date();
     const beforeAll = [];
     const afterAll = [];
-    const completedNodes = [];
     const nodes = {
         beforeAll: document.lifecycle.beforeAll.map((step)=>options.resolveNode(step.node)),
         afterAll: document.lifecycle.afterAll.map((step)=>options.resolveNode(step.node))
@@ -840,7 +794,7 @@ function createDocumentRuntime(document, options) {
             projectId: document.projectId,
             projectName: project.name,
             sourcePath: document.sourcePath,
-            status: completedNodes.some((step)=>'failed' === step.status) || teardownErrors.length > 0 ? 'failed' : 'success',
+            status: beforeAll.some((step)=>'failed' === step.status) || afterAll.some((step)=>'failed' === step.status) || teardownErrors.length > 0 ? 'failed' : 'success',
             startedAt: startedAt.toISOString(),
             endedAt: endedAt.toISOString(),
             durationMs: Math.max(0, endedAt.getTime() - startedAt.getTime()),
@@ -869,10 +823,7 @@ function createDocumentRuntime(document, options) {
                 projectName: project.name,
                 sourcePath: document.sourcePath,
                 phase,
-                stepIndex,
-                completedNodes: Object.freeze([
-                    ...completedNodes
-                ])
+                stepIndex
             };
             const stepInfo = {
                 scope: 'document',
@@ -885,7 +836,6 @@ function createDocumentRuntime(document, options) {
                 scope: 'document',
                 document: documentContext
             }, context, {
-                history: createHistory([], completedNodes, 'document'),
                 signal: executionSignal,
                 defaultTimeoutMs: options.defaultTimeoutMs,
                 onTeardown (node, teardown) {
@@ -908,7 +858,6 @@ function createDocumentRuntime(document, options) {
             });
             await options.onStepResult?.(stepInfo, result);
             results.push(result);
-            completedNodes.push(result);
             if ('failed' === result.status && !result.continuedAfterError) break;
         }
     };
@@ -916,9 +865,6 @@ function createDocumentRuntime(document, options) {
         get context () {
             return context;
         },
-        get history () {
-            return createHistory([], completedNodes, 'document');
-        },
         get canRunCases () {
             return started && !signal.aborted && !beforeAll.some((step)=>'failed' === step.status);
         },
@@ -1013,7 +959,6 @@ async function runWorkflowDocument(document, options) {
                     context: runtime.context,
                     projectName,
                     attemptIndex,
-                    documentHistory: runtime.history,
                     signal: options.signal,
                     defaultTimeoutMs: options.defaultTimeoutMs,
                     onStepStart: options.onStepStart,
@@ -1276,7 +1221,7 @@ function collectWorkflowDocument(source, options) {
         if (!Array.isArray(value)) throw new WorkflowParseError(`Workflow document ${phase} must be an array.`, {
             phase
         });
-        return normalizeSteps(value).map((normalized, stepIndex)=>{
+        return normalizeSteps(value, options.resolveNode).map((normalized, stepIndex)=>{
             const resolved = options.resolveNode(normalized.node);
             if (!resolved) throw new WorkflowParseError(`Workflow document ${phase} step ${stepIndex + 1} references unknown node "${normalized.node}".`, {
                 phase,
@@ -1312,7 +1257,7 @@ function collectWorkflowDocument(source, options) {
         if (!Array.isArray(tags) || tags.some((tag)=>'string' != typeof tag || 0 === tag.trim().length)) throw new WorkflowParseError(`Case ${caseIndex + 1} tags must be an array of non-empty strings.`, {
             caseIndex
         });
-        const steps = normalizeSteps(definition.steps).map((normalized, stepIndex)=>{
+        const steps = normalizeSteps(definition.steps, options.resolveNode).map((normalized, stepIndex)=>{
             if (!options.resolveNode(normalized.node)) throw new WorkflowParseError(`Case ${caseIndex + 1} step ${stepIndex + 1} references unknown node "${normalized.node}".`, {
                 caseIndex,
                 stepIndex,
@@ -1362,12 +1307,10 @@ exports.WorkflowDocumentExecutionError = __webpack_exports__.WorkflowDocumentExe
 exports.WorkflowError = __webpack_exports__.WorkflowError;
 exports.WorkflowLifecycleError = __webpack_exports__.WorkflowLifecycleError;
 exports.WorkflowParseError = __webpack_exports__.WorkflowParseError;
-exports.assertJsonSerializable = __webpack_exports__.assertJsonSerializable;
 exports.collectWorkflowDocument = __webpack_exports__.collectWorkflowDocument;
 exports.createCaseId = __webpack_exports__.createCaseId;
 exports.createCaseRunner = __webpack_exports__.createCaseRunner;
 exports.createDocumentRuntime = __webpack_exports__.createDocumentRuntime;
-exports.createHistory = __webpack_exports__.createHistory;
 exports.createProjectRuntime = __webpack_exports__.createProjectRuntime;
 exports.createWorkflowDocumentId = __webpack_exports__.createWorkflowDocumentId;
 exports.defineNode = __webpack_exports__.defineNode;
@@ -1377,8 +1320,6 @@ exports.normalizeStep = __webpack_exports__.normalizeStep;
 exports.normalizeSteps = __webpack_exports__.normalizeSteps;
 exports.resolveWorkflowVariables = __webpack_exports__.resolveWorkflowVariables;
 exports.runWorkflowDocument = __webpack_exports__.runWorkflowDocument;
-exports.toHistoryEntry = __webpack_exports__.toHistoryEntry;
-exports.validateCommonNodeInput = __webpack_exports__.validateCommonNodeInput;
 exports.z = __webpack_exports__.z;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "CaseExecutionError",
@@ -1398,12 +1339,10 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "WorkflowError",
     "WorkflowLifecycleError",
     "WorkflowParseError",
-    "assertJsonSerializable",
     "collectWorkflowDocument",
     "createCaseId",
     "createCaseRunner",
     "createDocumentRuntime",
-    "createHistory",
     "createProjectRuntime",
     "createWorkflowDocumentId",
     "defineNode",
@@ -1413,8 +1352,6 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "normalizeSteps",
     "resolveWorkflowVariables",
     "runWorkflowDocument",
-    "toHistoryEntry",
-    "validateCommonNodeInput",
     "z"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {