@midscene/test 1.12.5 → 1.12.6-beta-20260909034232.0

package/dist/types/android/index.d.ts

@@ -89,12 +89,25 @@ declare interface NodeExecutionContextBase<TInput = unknown, TContext = unknown>
     context: TContext;
     /** Register resource cleanup for the current case attempt or document. */
     onTeardown(teardown: NodeScopeTeardown): void;
+    /** Attach report detail references to the current Step result. */
+    report: NodeReportCollector;
 }
 
 declare type NodeExecutionReturn<TData = unknown> = Promise<NodeResult<TData> | void> | NodeResult<TData> | void;
 
 declare type NodeInputSchema = z.ZodObject;
 
+/** Collects report references produced while the current Step is executing. */
+declare interface NodeReportCollector {
+    addTrace(trace: NodeReportTrace): void;
+}
+
+/** A stable reference from one test Step to report detail data. */
+declare interface NodeReportTrace {
+    type: 'midscene-execution';
+    executionId: string;
+}
+
 declare interface NodeResult<TData = unknown> {
     /** Human-readable summary for reports. */
     summary?: string;

package/dist/types/cli/index.d.ts

@@ -99,7 +99,13 @@ export declare interface LoadedTestProject<TContext = undefined> {
 
 export declare function loadTestProject<TContext = undefined>(configPath?: string): Promise<LoadedTestProject<TContext>>;
 
-declare type MidsceneUIAgent = CommonAgentTestRunnerApi;
+declare interface MidsceneExecutionRef {
+    id?: string;
+}
+
+declare type MidsceneUIAgent = CommonAgentTestRunnerApi & {
+    addDumpUpdateListener?(listener: (dump: string, execution?: MidsceneExecutionRef) => void): () => void;
+};
 
 declare interface NodeCaseContext extends CaseExecutionContext {
     readonly phase: CaseNodePhase;
@@ -144,6 +150,8 @@ declare interface NodeExecutionContextBase<TInput = unknown, TContext = unknown>
     context: TContext;
     /** Register resource cleanup for the current case attempt or document. */
     onTeardown(teardown: NodeScopeTeardown): void;
+    /** Attach report detail references to the current Step result. */
+    report: NodeReportCollector;
 }
 
 declare type NodeExecutionPhase = CaseNodePhase | DocumentNodePhase;
@@ -170,6 +178,17 @@ declare class NodeRegistry {
     definitions(): readonly NodeDefinition<any, any, any>[];
 }
 
+/** Collects report references produced while the current Step is executing. */
+declare interface NodeReportCollector {
+    addTrace(trace: NodeReportTrace): void;
+}
+
+/** A stable reference from one test Step to report detail data. */
+declare interface NodeReportTrace {
+    type: 'midscene-execution';
+    executionId: string;
+}
+
 declare interface NodeResult<TData = unknown> {
     /** Human-readable summary for reports. */
     summary?: string;
@@ -258,6 +277,9 @@ declare interface StepRunResult<TOutputData = unknown> {
     durationMs: number;
     output?: NodeResult<TOutputData>;
     error?: WorkflowError;
+    report?: {
+        traces: readonly NodeReportTrace[];
+    };
 }
 
 export declare interface TestExecutionProjectRunResult {
@@ -333,6 +355,8 @@ export declare interface TestProjectRunResult {
     resultDir: string;
     summaryPath: string;
     reportDir: string;
+    /** Absolute path to the unified Midscene Test HTML report. */
+    reportPath?: string;
     summary: TestProjectRunSummary;
     projects: readonly TestExecutionProjectRunResult[];
     cases: readonly TestProjectCaseRunResult[];

package/dist/types/harmony/index.d.ts

@@ -88,12 +88,25 @@ declare interface NodeExecutionContextBase<TInput = unknown, TContext = unknown>
     context: TContext;
     /** Register resource cleanup for the current case attempt or document. */
     onTeardown(teardown: NodeScopeTeardown): void;
+    /** Attach report detail references to the current Step result. */
+    report: NodeReportCollector;
 }
 
 declare type NodeExecutionReturn<TData = unknown> = Promise<NodeResult<TData> | void> | NodeResult<TData> | void;
 
 declare type NodeInputSchema = z.ZodObject;
 
+/** Collects report references produced while the current Step is executing. */
+declare interface NodeReportCollector {
+    addTrace(trace: NodeReportTrace): void;
+}
+
+/** A stable reference from one test Step to report detail data. */
+declare interface NodeReportTrace {
+    type: 'midscene-execution';
+    executionId: string;
+}
+
 declare interface NodeResult<TData = unknown> {
     /** Human-readable summary for reports. */
     summary?: string;

package/dist/types/index.d.ts

@@ -1,9 +1,16 @@
 import { CaseRunResult as CaseRunResult_2 } from './engine/types';
+import type { TestRunReportDump } from '@midscene/core';
+import type { TestRunReportError } from '@midscene/core';
+import type { TestRunReportSource } from '@midscene/core';
+import type { TestRunReportSourceIndex } from '@midscene/core';
+import type { TestRunReportValue } from '@midscene/core';
 import { WorkflowDocumentRunResult as WorkflowDocumentRunResult_2 } from './engine/types';
 import { z } from 'zod/v4';
 
 export declare type Awaitable<T> = T | Promise<T>;
 
+export declare function buildTestRunReportDump(result: TestProjectRunResult, index: TestRunReportSourceIndex): TestRunReportDump;
+
 export declare interface CaseDefinition<TStep = StepInput> {
     name: string;
     tags?: readonly string[];
@@ -102,6 +109,8 @@ export declare interface CollectedWorkflowDocument {
     cases: readonly CollectedCase[];
 }
 
+export declare function collectTestRunReportSources(result: TestProjectRunResult): TestRunReportSource[];
+
 export declare function collectWorkflowDocument(source: WorkflowDocumentSource, options: CollectWorkflowDocumentOptions): CollectedWorkflowDocument;
 
 export declare interface CollectWorkflowDocumentOptions {
@@ -222,6 +231,8 @@ declare interface NodeExecutionContextBase<TInput = unknown, TContext = unknown>
     context: TContext;
     /** Register resource cleanup for the current case attempt or document. */
     onTeardown(teardown: NodeScopeTeardown): void;
+    /** Attach report detail references to the current Step result. */
+    report: NodeReportCollector;
 }
 
 export declare class NodeExecutionError extends WorkflowError {
@@ -256,6 +267,17 @@ export declare class NodeRegistry {
     definitions(): readonly NodeDefinition<any, any, any>[];
 }
 
+/** Collects report references produced while the current Step is executing. */
+export declare interface NodeReportCollector {
+    addTrace(trace: NodeReportTrace): void;
+}
+
+/** A stable reference from one test Step to report detail data. */
+export declare interface NodeReportTrace {
+    type: 'midscene-execution';
+    executionId: string;
+}
+
 export declare interface NodeResult<TData = unknown> {
     /** Human-readable summary for reports. */
     summary?: string;
@@ -417,6 +439,13 @@ export declare interface RunWorkflowDocumentOptions<TContext = undefined> {
     createDocumentRunId?(document: CollectedWorkflowDocument): string;
 }
 
+export declare function sanitizeReportError(error: unknown): TestRunReportError;
+
+export declare function sanitizeReportText(value: string, maximumLength?: number): string;
+
+/** Convert arbitrary Node input/output to a bounded, JSON-safe display value. */
+export declare function sanitizeReportValue(value: unknown): TestRunReportValue;
+
 export declare type StepExecutionInfo = {
     scope: 'case';
     node: string;
@@ -453,6 +482,9 @@ export declare interface StepRunResult<TOutputData = unknown> {
     durationMs: number;
     output?: NodeResult<TOutputData>;
     error?: WorkflowError;
+    report?: {
+        traces: readonly NodeReportTrace[];
+    };
 }
 
 export declare type StepStartHandler = (info: StepExecutionInfo) => Awaitable<unknown>;
@@ -469,6 +501,23 @@ declare interface StringInputNodeDefinition {
     stringInputKey?: string | false;
 }
 
+declare interface TestExecutionProjectRunResult {
+    projectId: string;
+    name: string;
+    platform: TestPlatform;
+    status: 'success' | 'failed';
+    retry: number;
+    fileSelection: TestFileSelection;
+    tagSelection: Readonly<Required<TestTagSelection>>;
+    sourceCount: number;
+    selectedCaseCount: number;
+    filteredCaseCount: number;
+    lifecycle?: ProjectRuntimeResult;
+    cases: readonly TestProjectCaseRunResult[];
+    documents: readonly WorkflowDocumentRunResult[];
+    collectionErrors: readonly TestProjectCollectionError[];
+}
+
 declare interface TestFileSelection {
     include: readonly string[];
     exclude?: readonly string[];
@@ -476,6 +525,48 @@ declare interface TestFileSelection {
 
 declare type TestPlatform = 'web' | 'android' | 'ios' | 'harmony' | 'computer';
 
+declare type TestProjectCaseRunResult = CaseRunOutcome & {
+    documentId: string;
+};
+
+declare interface TestProjectCollectionError {
+    projectId: string;
+    projectName: string;
+    sourcePath: string;
+    error: WorkflowError;
+}
+
+declare interface TestProjectRunResult {
+    schemaVersion: 3;
+    runId: string;
+    startedAt: string;
+    endedAt: string;
+    durationMs: number;
+    status: 'success' | 'failed';
+    exitCode: 0 | 1;
+    resultDir: string;
+    summaryPath: string;
+    reportDir: string;
+    /** Absolute path to the unified Midscene Test HTML report. */
+    reportPath?: string;
+    summary: TestProjectRunSummary;
+    projects: readonly TestExecutionProjectRunResult[];
+    cases: readonly TestProjectCaseRunResult[];
+    documents: readonly WorkflowDocumentRunResult[];
+    collectionErrors: readonly TestProjectCollectionError[];
+}
+
+declare interface TestProjectRunSummary {
+    total: number;
+    passed: number;
+    failed: number;
+    notRun: number;
+    filtered: number;
+    collectionErrors: number;
+    documentFailures: number;
+    projectFailures: number;
+}
+
 declare interface TestTagSelection {
     include?: readonly string[];
     exclude?: readonly string[];

package/dist/types/ios/index.d.ts

@@ -90,12 +90,25 @@ declare interface NodeExecutionContextBase<TInput = unknown, TContext = unknown>
     context: TContext;
     /** Register resource cleanup for the current case attempt or document. */
     onTeardown(teardown: NodeScopeTeardown): void;
+    /** Attach report detail references to the current Step result. */
+    report: NodeReportCollector;
 }
 
 declare type NodeExecutionReturn<TData = unknown> = Promise<NodeResult<TData> | void> | NodeResult<TData> | void;
 
 declare type NodeInputSchema = z.ZodObject;
 
+/** Collects report references produced while the current Step is executing. */
+declare interface NodeReportCollector {
+    addTrace(trace: NodeReportTrace): void;
+}
+
+/** A stable reference from one test Step to report detail data. */
+declare interface NodeReportTrace {
+    type: 'midscene-execution';
+    executionId: string;
+}
+
 declare interface NodeResult<TData = unknown> {
     /** Human-readable summary for reports. */
     summary?: string;

package/dist/types/midscene/index.d.ts

@@ -90,7 +90,13 @@ export { insightOptionsInputSchema }
 
 export { locateOptionsInputSchema }
 
-export declare type MidsceneUIAgent = CommonAgentTestRunnerApi;
+export declare interface MidsceneExecutionRef {
+    id?: string;
+}
+
+export declare type MidsceneUIAgent = CommonAgentTestRunnerApi & {
+    addDumpUpdateListener?(listener: (dump: string, execution?: MidsceneExecutionRef) => void): () => void;
+};
 
 declare interface NodeCaseContext extends CaseExecutionContext {
     readonly phase: CaseNodePhase;
@@ -135,12 +141,25 @@ declare interface NodeExecutionContextBase<TInput = unknown, TContext = unknown>
     context: TContext;
     /** Register resource cleanup for the current case attempt or document. */
     onTeardown(teardown: NodeScopeTeardown): void;
+    /** Attach report detail references to the current Step result. */
+    report: NodeReportCollector;
 }
 
 declare type NodeExecutionReturn<TData = unknown> = Promise<NodeResult<TData> | void> | NodeResult<TData> | void;
 
 declare type NodeInputSchema = z.ZodObject;
 
+/** Collects report references produced while the current Step is executing. */
+declare interface NodeReportCollector {
+    addTrace(trace: NodeReportTrace): void;
+}
+
+/** A stable reference from one test Step to report detail data. */
+declare interface NodeReportTrace {
+    type: 'midscene-execution';
+    executionId: string;
+}
+
 declare interface NodeResult<TData = unknown> {
     /** Human-readable summary for reports. */
     summary?: string;

package/dist/types/playwright/index.d.ts

@@ -144,12 +144,25 @@ declare interface NodeExecutionContextBase<TInput = unknown, TContext = unknown>
     context: TContext;
     /** Register resource cleanup for the current case attempt or document. */
     onTeardown(teardown: NodeScopeTeardown): void;
+    /** Attach report detail references to the current Step result. */
+    report: NodeReportCollector;
 }
 
 declare type NodeExecutionReturn<TData = unknown> = Promise<NodeResult<TData> | void> | NodeResult<TData> | void;
 
 declare type NodeInputSchema = z.ZodObject;
 
+/** Collects report references produced while the current Step is executing. */
+declare interface NodeReportCollector {
+    addTrace(trace: NodeReportTrace): void;
+}
+
+/** A stable reference from one test Step to report detail data. */
+declare interface NodeReportTrace {
+    type: 'midscene-execution';
+    executionId: string;
+}
+
 declare interface NodeResult<TData = unknown> {
     /** Human-readable summary for reports. */
     summary?: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@midscene/test",
   "description": "Midscene Test: an extensible YAML testing framework and Node SDK.",
-  "version": "1.12.5",
+  "version": "1.12.6-beta-20260909034232.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/web-infra-dev/midscene.git",
@@ -63,7 +63,8 @@
     "tsx": "^4.19.2",
     "yargs": "17.7.2",
     "zod": "^3.25.1",
-    "@midscene/core": "1.12.5"
+    "@midscene/shared": "1.12.6-beta-20260909034232.0",
+    "@midscene/core": "1.12.6-beta-20260909034232.0"
   },
   "devDependencies": {
     "@rslib/core": "^0.18.3",
@@ -73,17 +74,17 @@
     "playwright": "^1.45.0",
     "typescript": "^5.8.3",
     "vitest": "3.0.5",
-    "@midscene/harmony": "1.12.5",
-    "@midscene/android": "1.12.5",
-    "@midscene/computer": "1.12.5",
-    "@midscene/web": "1.12.5",
-    "@midscene/ios": "1.12.5"
+    "@midscene/android": "1.12.6-beta-20260909034232.0",
+    "@midscene/computer": "1.12.6-beta-20260909034232.0",
+    "@midscene/harmony": "1.12.6-beta-20260909034232.0",
+    "@midscene/ios": "1.12.6-beta-20260909034232.0",
+    "@midscene/web": "1.12.6-beta-20260909034232.0"
   },
   "peerDependencies": {
     "playwright": "^1.45.0",
-    "@midscene/ios": "1.12.5",
-    "@midscene/harmony": "1.12.5",
-    "@midscene/android": "1.12.5"
+    "@midscene/android": "1.12.6-beta-20260909034232.0",
+    "@midscene/ios": "1.12.6-beta-20260909034232.0",
+    "@midscene/harmony": "1.12.6-beta-20260909034232.0"
   },
   "peerDependenciesMeta": {
     "@midscene/android": {