@midscene/test 1.12.10-beta-20260920031616.0 → 1.13.0

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

@@ -1,22 +1,51 @@
+import { actionInputSchema } from '@midscene/core/agent/test';
+import { ActionNodeInput } from '@midscene/core/agent/test';
 import { AgentTestRunnerNodeDefinition } from '@midscene/core/agent/test';
 import { AgentTestRunnerNodeProvider } from '@midscene/core/agent/test';
 import { aiActInputSchema } from '@midscene/core/agent/test';
 import { aiActOptionsInputSchema } from '@midscene/core/agent/test';
 import { aiAssertInputSchema } from '@midscene/core/agent/test';
 import { aiAssertOptionsInputSchema } from '@midscene/core/agent/test';
+import { aiDragAndDropInputSchema } from '@midscene/core/agent/test';
+import { AiDragAndDropNodeInput } from '@midscene/core/agent/test';
+import { aiInputInputSchema } from '@midscene/core/agent/test';
+import { AiInputNodeInput } from '@midscene/core/agent/test';
+import { aiKeyboardPressInputSchema } from '@midscene/core/agent/test';
+import { AiKeyboardPressNodeInput } from '@midscene/core/agent/test';
+import { aiLongPressInputSchema } from '@midscene/core/agent/test';
+import { AiLongPressNodeInput } from '@midscene/core/agent/test';
+import { aiPinchInputSchema } from '@midscene/core/agent/test';
+import { AiPinchNodeInput } from '@midscene/core/agent/test';
+import { aiQueryInputSchema } from '@midscene/core/agent/test';
+import { AiQueryNodeInput } from '@midscene/core/agent/test';
+import { aiScrollInputSchema } from '@midscene/core/agent/test';
+import { AiScrollNodeInput } from '@midscene/core/agent/test';
 import { aiTapInputSchema } from '@midscene/core/agent/test';
+import { aiWaitForInputSchema } from '@midscene/core/agent/test';
+import { AiWaitForNodeInput } from '@midscene/core/agent/test';
+import { Awaitable } from '@midscene/core/internal/test-runner';
 import { CommonAgentTestRunnerApi } from '@midscene/core/agent/test';
+import type * as Core from '@midscene/core/internal/test-runner';
 import { insightInputSchema } from '@midscene/core/agent/test';
 import { insightOptionsInputSchema } from '@midscene/core/agent/test';
+import { javascriptInputSchema } from '@midscene/core/agent/test';
+import { JavascriptNodeInput } from '@midscene/core/agent/test';
 import { locateOptionsInputSchema } from '@midscene/core/agent/test';
 import { promptImageInputSchema } from '@midscene/core/agent/test';
 import { recordToReportInputSchema } from '@midscene/core/agent/test';
 import { recordToReportOptionsInputSchema } from '@midscene/core/agent/test';
 import { reportScreenshotInputSchema } from '@midscene/core/agent/test';
+import { runGherkinScenarioInputSchema } from '@midscene/core/agent/test';
+import { RunGherkinScenarioNodeInput } from '@midscene/core/agent/test';
 import { structuredUserPromptInputSchema } from '@midscene/core/agent/test';
 import { userPromptInputSchema } from '@midscene/core/agent/test';
+import { WorkflowReportSource } from '@midscene/core/internal/test-runner';
 import { z } from 'zod/v4';
 
+export { actionInputSchema }
+
+export { ActionNodeInput }
+
 export declare interface AgentProvider<TContext> {
     getAgent(runId: string, execution: NodeExecutionContext<unknown, TContext>): Awaitable<MidsceneUIAgent>;
     releaseAgent?(runId: string): Awaitable<AgentReleaseResult | void>;
@@ -40,26 +69,44 @@ export declare type AiAssertNodeInput = z.infer<typeof aiAssertInputSchema>;
 
 export { aiAssertOptionsInputSchema }
 
+export { aiDragAndDropInputSchema }
+
+export { AiDragAndDropNodeInput }
+
+export { aiInputInputSchema }
+
+export { AiInputNodeInput }
+
+export { aiKeyboardPressInputSchema }
+
+export { AiKeyboardPressNodeInput }
+
+export { aiLongPressInputSchema }
+
+export { AiLongPressNodeInput }
+
+export { aiPinchInputSchema }
+
+export { AiPinchNodeInput }
+
+export { aiQueryInputSchema }
+
+export { AiQueryNodeInput }
+
+export { aiScrollInputSchema }
+
+export { AiScrollNodeInput }
+
 export { aiTapInputSchema }
 
 export declare type AiTapNodeInput = z.infer<typeof aiTapInputSchema>;
 
-declare type Awaitable<T> = T | Promise<T>;
-
-declare interface CaseExecutionContext {
-    readonly caseId: string;
-    readonly runId: string;
-    readonly projectName: string;
-    readonly attemptIndex: number;
-    readonly name: string;
-    readonly sourcePath: string;
-    readonly caseIndex: number;
-}
+export { aiWaitForInputSchema }
 
-declare type CaseNodePhase = 'beforeEach' | 'steps' | 'afterEach';
+export { AiWaitForNodeInput }
 
 /** Adapt Agent-owned descriptions to executable Midscene Test Nodes. */
-export declare const createAgentTestRunnerNodes: <TContext>(definitions: readonly AgentTestRunnerNodeDefinition[], getAgent: (execution: NodeExecutionContext<unknown, TContext>) => Awaitable<unknown>) => readonly NodeDefinition<any, any, TContext>[];
+export declare const createAgentTestRunnerNodes: <TContext>(definitions: readonly AgentTestRunnerNodeDefinition[], getAgent: (ctx: NodeExecutionContext<unknown, TContext>) => Awaitable<unknown>) => readonly NodeDefinition<any, any, TContext>[];
 
 export declare function createMidsceneNodes<TContext>(options: CreateMidsceneNodesOptions<TContext>): readonly NodeDefinition<any, any, TContext>[];
 
@@ -70,17 +117,9 @@ export declare interface CreateMidsceneNodesOptions<TContext> {
     agentClass: AgentTestRunnerNodeProvider;
 }
 
-declare interface DefineNodeOptions<TInput = unknown, TData = unknown, TContext = unknown> {
-    name: string;
-    title?: string;
-    description?: string;
-    /** Object field populated by string shorthand. Omit or set false to disable it. */
-    stringInputKey?: string | false;
-    inputSchema?: NodeInputSchema;
-    execute(execution: NodeExecutionContext<TInput, TContext>): NodeExecutionReturn<TData>;
-}
-
-declare type DocumentNodePhase = 'beforeAll' | 'afterAll';
+declare type DefineNodeOptions<TInput = unknown, TData = unknown, TContext = unknown> = Omit<Core.DefineNodeOptions<TInput, TData, TContext>, 'execute'> & {
+    execute(ctx: NodeExecutionContext<TInput, TContext>): Core.NodeExecutionReturn<TData>;
+};
 
 export { insightInputSchema }
 
@@ -88,6 +127,10 @@ export declare type InsightNodeInput = z.infer<typeof insightInputSchema>;
 
 export { insightOptionsInputSchema }
 
+export { javascriptInputSchema }
+
+export { JavascriptNodeInput }
+
 export { locateOptionsInputSchema }
 
 export declare interface MidsceneExecutionRef {
@@ -95,89 +138,28 @@ export declare interface MidsceneExecutionRef {
 }
 
 export declare type MidsceneUIAgent = CommonAgentTestRunnerApi & {
+    _prepareForTestRunner?(): void;
+    _createReportSource?(scopeId: string): Promise<WorkflowReportSource | undefined>;
+    flushReport?(): Promise<string | undefined>;
     addDumpUpdateListener?(listener: (dump: string, execution?: MidsceneExecutionRef) => void): () => void;
 };
 
-declare interface NodeCaseContext extends CaseExecutionContext {
-    readonly phase: CaseNodePhase;
-    readonly stepIndex: number;
-}
-
-declare interface NodeDefinition<TInput = unknown, TData = unknown, TContext = unknown> extends DefineNodeOptions<TInput, TData, TContext> {
-}
-
-declare interface NodeDocumentContext {
-    readonly documentId: string;
-    readonly documentRunId: string;
-    readonly projectId: string;
-    readonly projectName: string;
-    readonly sourcePath: string;
-    readonly phase: DocumentNodePhase;
-    readonly stepIndex: number;
-}
-
-declare type NodeExecutionContext<TInput = unknown, TContext = unknown> = NodeExecutionContextBase<TInput, TContext> & ({
-    /** The node is running for one case. */
-    scope: 'case';
-    /** Identity and phase information for the case being executed. */
-    case: NodeCaseContext;
-    document?: never;
-} | {
-    /** The node is running for the workflow document. */
-    scope: 'document';
-    /** Identity and phase information for the document being executed. */
-    document: NodeDocumentContext;
-    case?: never;
-});
-
-declare interface NodeExecutionContextBase<TInput = unknown, TContext = unknown> {
-    /** The validated node input without `$`. */
-    input: TInput;
-    /** The normalized engine metadata for this step. */
+declare type NativeNodeContext<T> = T extends unknown ? Omit<T, '$' | 'onTeardown'> & {
     $: Readonly<NormalizedStepMeta>;
-    /** The timeout and cancellation signal for this step. */
-    signal: AbortSignal;
-    /** Resources shared by the current workflow document. */
-    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;
-}
+} : never;
 
-declare type NodeExecutionReturn<TData = unknown> = Promise<NodeResult<TData> | void> | NodeResult<TData> | void;
+declare type NodeDefinition<TInput = unknown, TData = unknown, TContext = unknown> = DefineNodeOptions<TInput, TData, TContext>;
 
-declare type NodeInputSchema = z.ZodObject;
+declare type NodeExecutionContext<TInput = unknown, TContext = unknown> = NativeNodeContext<Core.NodeExecutionContext<TInput, TContext>>;
 
-/** Collects report references produced while the current Step is executing. */
-declare interface NodeReportCollector {
-    addTrace(trace: NodeReportTrace): void;
-}
+declare type NodeScopeTeardown = () => Core.Awaitable<NodeScopeTeardownOutput>;
 
-/** A stable reference from one test Step to report detail data. */
-declare interface NodeReportTrace {
-    type: 'midscene-execution';
-    executionId: string;
-}
+declare type NodeScopeTeardownOutput = NodeScopeTeardownResult | void;
 
-declare interface NodeResult<TData = unknown> {
-    /** Human-readable summary for reports. */
-    summary?: string;
-    /** Structured data included in the step result. */
-    data?: TData;
-}
+declare type NodeScopeTeardownResult = Omit<Core.NodeScopeTeardownResult, 'reportSources'>;
 
-declare type NodeScopeTeardown = () => Awaitable<NodeScopeTeardownResult | void>;
-
-declare interface NodeScopeTeardownResult {
-    /** Absolute paths to Midscene reports produced by this execution scope. */
-    reportPaths?: readonly string[];
-}
-
-declare interface NormalizedStepMeta {
-    timeoutMs?: number;
-    continueOnError: boolean;
-}
+declare type NormalizedStepMeta = Omit<Core.NormalizedStepMeta, 'captureResult' | 'resultName'>;
 
 export { promptImageInputSchema }
 
@@ -189,6 +171,10 @@ export { recordToReportOptionsInputSchema }
 
 export { reportScreenshotInputSchema }
 
+export { runGherkinScenarioInputSchema }
+
+export { RunGherkinScenarioNodeInput }
+
 export { structuredUserPromptInputSchema }
 
 export { userPromptInputSchema }

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

@@ -0,0 +1,52 @@
+import type { Agent } from '@midscene/core/agent';
+import type { FreeFn } from '@midscene/core';
+import type { MidsceneYamlScript } from '@midscene/core';
+import type { MidsceneYamlScriptEnv } from '@midscene/core';
+import { ScriptPlayer } from '@midscene/core/yaml';
+import type { Server } from 'node:http';
+
+/** Launch any YAML-supported platform for a native Test setup or another host. */
+export declare function createYamlAgent(file: string, script: YamlAgentConfig, options?: CreateYamlPlayerOptions, reportFileName?: string): Promise<{
+    agent: Agent;
+    freeFn: FreeFn[];
+}>;
+
+export declare function createYamlPlayer(file: string, script?: MidsceneYamlScript, options?: CreateYamlPlayerOptions): Promise<ScriptPlayer<MidsceneYamlScriptEnv>>;
+
+export declare interface CreateYamlPlayerOptions {
+    /** Borrow an existing Agent; its owner remains responsible for teardown. */
+    agent?: Agent;
+    headed?: boolean;
+    keepWindow?: boolean;
+    /** Puppeteer handles. Platform-specific types are optional for other hosts. */
+    browser?: object;
+    page?: object;
+    browserContext?: object;
+    testId?: string;
+}
+
+export declare interface DotenvLoadOptions {
+    dotenvOverride?: boolean;
+    dotenvDebug?: boolean;
+    cwd?: string;
+    log?: (message: string) => void;
+}
+
+export declare const launchServer: (dir: string) => Promise<YamlStaticServer>;
+
+export declare function loadDotenvConfig(options?: DotenvLoadOptions): void;
+
+export declare interface SingleYamlExecutionResult {
+    success: boolean;
+    file: string;
+    player: ScriptPlayer<MidsceneYamlScriptEnv>;
+}
+
+export declare type YamlAgentConfig = Omit<MidsceneYamlScript, 'tasks'>;
+
+export declare interface YamlStaticServer {
+    server: Server;
+    listen(port: number, host: string, callback: () => void): void;
+}
+
+export { }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@midscene/test",
   "description": "Midscene Test: an extensible YAML testing framework and Node SDK.",
-  "version": "1.12.10-beta-20260920031616.0",
+  "version": "1.13.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/web-infra-dev/midscene.git",
@@ -29,6 +29,11 @@
       "types": "./dist/types/midscene/index.d.ts",
       "import": "./dist/es/midscene/index.mjs",
       "require": "./dist/lib/midscene/index.js"
+    },
+    "./internal/yaml-runtime": {
+      "types": "./dist/types/runtime/index.d.ts",
+      "import": "./dist/es/runtime/index.mjs",
+      "require": "./dist/lib/runtime/index.js"
     }
   },
   "files": [
@@ -37,28 +42,66 @@
   ],
   "dependencies": {
     "@inquirer/prompts": "^7.8.6",
+    "dotenv": "^16.4.5",
     "execa": "9.3.0",
+    "glob": "11.0.0",
+    "http-server": "14.1.1",
     "js-yaml": "4.1.0",
+    "lodash.merge": "4.6.2",
     "tinyglobby": "0.2.15",
     "tsx": "^4.19.2",
     "yargs": "17.7.2",
     "zod": "^3.25.1",
-    "@midscene/core": "1.12.10-beta-20260920031616.0",
-    "@midscene/shared": "1.12.10-beta-20260920031616.0"
+    "@midscene/core": "1.13.0",
+    "@midscene/shared": "1.13.0"
   },
   "devDependencies": {
     "@rslib/core": "^0.18.3",
     "@types/js-yaml": "4.0.9",
+    "@types/lodash.merge": "4.6.9",
     "@types/node": "^18.0.0",
     "@types/yargs": "17.0.32",
     "playwright": "^1.45.0",
+    "puppeteer": "24.6.0",
     "typescript": "^5.8.3",
     "vitest": "3.0.5",
-    "@midscene/android": "1.12.10-beta-20260920031616.0",
-    "@midscene/computer": "1.12.10-beta-20260920031616.0",
-    "@midscene/harmony": "1.12.10-beta-20260920031616.0",
-    "@midscene/ios": "1.12.10-beta-20260920031616.0",
-    "@midscene/web": "1.12.10-beta-20260920031616.0"
+    "@midscene/computer": "1.13.0",
+    "@midscene/harmony": "1.13.0",
+    "@midscene/ios": "1.13.0",
+    "@midscene/android": "1.13.0",
+    "@midscene/web": "1.13.0"
+  },
+  "peerDependencies": {
+    "playwright": "^1.45.0",
+    "puppeteer": "24.6.0",
+    "@midscene/android": "1.13.0",
+    "@midscene/harmony": "1.13.0",
+    "@midscene/computer": "1.13.0",
+    "@midscene/ios": "1.13.0",
+    "@midscene/web": "1.13.0"
+  },
+  "peerDependenciesMeta": {
+    "@midscene/android": {
+      "optional": true
+    },
+    "@midscene/harmony": {
+      "optional": true
+    },
+    "@midscene/ios": {
+      "optional": true
+    },
+    "playwright": {
+      "optional": true
+    },
+    "@midscene/computer": {
+      "optional": true
+    },
+    "@midscene/web": {
+      "optional": true
+    },
+    "puppeteer": {
+      "optional": true
+    }
   },
   "engines": {
     "node": "^20.19.0 || ^22.12.0 || >=24.0.0"