@midscene/core 1.12.10-beta-20260920031616.0 → 1.13.0

package/dist/es/yaml/test-runner-nodes.mjs

@@ -0,0 +1,147 @@
+import { assert } from "@midscene/shared/utils";
+import { z } from "zod/v4";
+import { commonAgentTestRunnerNodeDefinitions } from "../agent/test-runner-nodes.mjs";
+import { compileLegacyFlowItem } from "./test-runner-compat.mjs";
+const legacyFinalizeNodeDefinition = {
+    name: 'Finalize',
+    inputSchema: z.strictObject({}),
+    execute: ()=>void 0
+};
+const legacyRunAdbShellNodeDefinition = {
+    name: 'runAdbShell',
+    inputSchema: z.strictObject({
+        command: z.string(),
+        timeout: z.number()
+    }),
+    async execute (agent, input) {
+        const androidAgent = agent;
+        const command = input.command;
+        const timeout = input.timeout;
+        const value = androidAgent.runAdbShell ? await androidAgent.runAdbShell(command, {
+            timeout
+        }) : await androidAgent.callActionInActionSpace('RunAdbShell', {
+            command,
+            timeout
+        });
+        return void 0 === value ? void 0 : {
+            data: value
+        };
+    }
+};
+const legacyActionNodeDefinition = {
+    name: 'legacyAction',
+    inputSchema: z.strictObject({
+        flow: z.record(z.string(), z.unknown())
+    }),
+    async execute (agent, input, context) {
+        context.signal.throwIfAborted();
+        const actionSpace = await agent.getActionSpace();
+        context.signal.throwIfAborted();
+        const step = compileLegacyFlowItem(input.flow, actionSpace);
+        assert('legacyAction' !== step.node, `unknown flowItem in yaml: ${JSON.stringify(input.flow)}`);
+        const definition = legacyAgentTestRunnerNodeDefinitions.find((node)=>node.name === step.node);
+        assert(definition, `Unknown Agent Node: ${step.node}`);
+        const parsed = await definition.inputSchema.parseAsync(step.input);
+        context.signal.throwIfAborted();
+        return definition.execute(agent, parsed, context);
+    }
+};
+const legacyValidationErrorNodeDefinition = {
+    name: 'legacyValidationError',
+    inputSchema: z.strictObject({
+        message: z.string()
+    }),
+    execute (_agent, input) {
+        throw new Error(input.message);
+    }
+};
+const legacyPromptInputSchema = z.strictObject({
+    prompt: z.unknown(),
+    options: z.record(z.string(), z.unknown()).optional()
+});
+const legacyInputSchemas = new Map([
+    ...[
+        'aiAct',
+        'aiTap',
+        'aiLocate',
+        'aiQuery',
+        'aiNumber',
+        'aiString',
+        'aiBoolean',
+        'aiAsk',
+        'aiWaitFor',
+        'aiScroll'
+    ].map((name)=>[
+            name,
+            legacyPromptInputSchema
+        ]),
+    [
+        'aiAssert',
+        legacyPromptInputSchema.extend({
+            message: z.unknown()
+        })
+    ],
+    [
+        "javascript",
+        z.strictObject({
+            script: z.unknown()
+        })
+    ],
+    [
+        'runGherkinScenario',
+        z.strictObject({
+            scenario: z.unknown(),
+            options: z.record(z.string(), z.unknown()).optional()
+        })
+    ],
+    [
+        'sleep',
+        z.strictObject({
+            ms: z.number().positive()
+        })
+    ],
+    [
+        'action',
+        z.strictObject({
+            name: z.string(),
+            params: z.unknown()
+        })
+    ],
+    [
+        'recordToReport',
+        z.strictObject({
+            title: z.unknown(),
+            options: z.record(z.string(), z.unknown()).optional()
+        })
+    ]
+]);
+const sharedDefinitions = new Map(commonAgentTestRunnerNodeDefinitions.map((definition)=>[
+        definition.name,
+        definition
+    ]));
+const legacyAgentTestRunnerNodeDefinitions = [
+    ...Array.from(legacyInputSchemas, ([name, inputSchema])=>{
+        const definition = sharedDefinitions.get(name);
+        assert(definition, `Missing shared Agent Node for legacy YAML: ${name}`);
+        return {
+            ...definition,
+            inputSchema
+        };
+    }),
+    legacyFinalizeNodeDefinition,
+    legacyRunAdbShellNodeDefinition,
+    legacyActionNodeDefinition,
+    legacyValidationErrorNodeDefinition
+];
+const insightNodes = new Set([
+    'aiBoolean',
+    'aiNumber',
+    'aiString',
+    'aiAsk'
+]);
+function getLegacyYamlResultData(node, output) {
+    return insightNodes.has(node) ? output.data.value : output.data;
+}
+export { getLegacyYamlResultData, legacyAgentTestRunnerNodeDefinitions };
+
+//# sourceMappingURL=test-runner-nodes.mjs.map

package/dist/es/yaml/test-runner-nodes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml/test-runner-nodes.mjs","sources":["../../../src/yaml/test-runner-nodes.ts"],"sourcesContent":["import { assert } from '@midscene/shared/utils';\nimport { z } from 'zod/v4';\nimport {\n  type AgentTestRunnerNodeDefinition,\n  commonAgentTestRunnerNodeDefinitions,\n} from '../agent/test-runner-nodes';\nimport type { NodeResult } from '../test-runner/node/types';\nimport type { DeviceAction, MidsceneYamlFlowItem } from '../types';\nimport { compileLegacyFlowItem } from './test-runner-compat';\n\n/** Planning-only marker accepted by the old YAML grammar, not a native Test Node. */\nconst legacyFinalizeNodeDefinition: AgentTestRunnerNodeDefinition = {\n  name: 'Finalize',\n  inputSchema: z.strictObject({}),\n  execute: () => undefined,\n};\n\nconst legacyRunAdbShellNodeDefinition: AgentTestRunnerNodeDefinition = {\n  name: 'runAdbShell',\n  inputSchema: z.strictObject({ command: z.string(), timeout: z.number() }),\n  async execute(agent, input) {\n    const androidAgent = agent as {\n      runAdbShell?: (\n        command: string,\n        options: { timeout: number },\n      ) => Promise<unknown>;\n      callActionInActionSpace(\n        name: string,\n        params: Record<string, unknown>,\n      ): Promise<unknown>;\n    };\n    const command = input.command as string;\n    const timeout = input.timeout as number;\n    const value = androidAgent.runAdbShell\n      ? await androidAgent.runAdbShell(command, { timeout })\n      : await androidAgent.callActionInActionSpace('RunAdbShell', {\n          command,\n          timeout,\n        });\n    return value === undefined ? undefined : { data: value };\n  },\n};\n\n/** Only YAML hosts resolve shorthand; the shared Agent receives canonical params. */\nconst legacyActionNodeDefinition: AgentTestRunnerNodeDefinition = {\n  name: 'legacyAction',\n  inputSchema: z.strictObject({ flow: z.record(z.string(), z.unknown()) }),\n  async execute(agent, input, context) {\n    context.signal.throwIfAborted();\n    const actionSpace = await (\n      agent as {\n        getActionSpace(): Promise<DeviceAction[]>;\n      }\n    ).getActionSpace();\n    context.signal.throwIfAborted();\n    const step = compileLegacyFlowItem(\n      input.flow as MidsceneYamlFlowItem,\n      actionSpace,\n    );\n    assert(\n      step.node !== 'legacyAction',\n      `unknown flowItem in yaml: ${JSON.stringify(input.flow)}`,\n    );\n    const definition = legacyAgentTestRunnerNodeDefinitions.find(\n      (node) => node.name === step.node,\n    );\n    assert(definition, `Unknown Agent Node: ${step.node}`);\n    const parsed = await definition.inputSchema.parseAsync(step.input);\n    context.signal.throwIfAborted();\n    return definition.execute(agent, parsed, context);\n  },\n};\n\n/** Preserve the old task failure phase without adding native parser controls. */\nconst legacyValidationErrorNodeDefinition: AgentTestRunnerNodeDefinition = {\n  name: 'legacyValidationError',\n  inputSchema: z.strictObject({ message: z.string() }),\n  execute(_agent, input) {\n    throw new Error(input.message as string);\n  },\n};\n\n// The old player checked YAML grammar, then passed options through to Agent.\n// Validate only the compiled envelope here: native field whitelists, positive\n// wait durations and nonempty image arrays must not narrow the legacy grammar.\n// compileLegacyFlowItem preserves the old checks at their task execution phase;\n// Agent/ActionSpace remain responsible for validating the business parameters.\nconst legacyPromptInputSchema = z.strictObject({\n  prompt: z.unknown(),\n  options: z.record(z.string(), z.unknown()).optional(),\n});\nconst legacyInputSchemas = new Map<string, z.ZodObject>([\n  ...[\n    'aiAct',\n    'aiTap',\n    'aiLocate',\n    'aiQuery',\n    'aiNumber',\n    'aiString',\n    'aiBoolean',\n    'aiAsk',\n    'aiWaitFor',\n    'aiScroll',\n  ].map((name): [string, z.ZodObject] => [name, legacyPromptInputSchema]),\n  ['aiAssert', legacyPromptInputSchema.extend({ message: z.unknown() })],\n  ['javascript', z.strictObject({ script: z.unknown() })],\n  [\n    'runGherkinScenario',\n    z.strictObject({\n      scenario: z.unknown(),\n      options: z.record(z.string(), z.unknown()).optional(),\n    }),\n  ],\n  ['sleep', z.strictObject({ ms: z.number().positive() })],\n  ['action', z.strictObject({ name: z.string(), params: z.unknown() })],\n  [\n    'recordToReport',\n    z.strictObject({\n      title: z.unknown(),\n      options: z.record(z.string(), z.unknown()).optional(),\n    }),\n  ],\n]);\nconst sharedDefinitions = new Map(\n  commonAgentTestRunnerNodeDefinitions.map((definition) => [\n    definition.name,\n    definition,\n  ]),\n);\nexport const legacyAgentTestRunnerNodeDefinitions: readonly AgentTestRunnerNodeDefinition[] =\n  [\n    ...Array.from(legacyInputSchemas, ([name, inputSchema]) => {\n      const definition = sharedDefinitions.get(name);\n      assert(definition, `Missing shared Agent Node for legacy YAML: ${name}`);\n      return { ...definition, inputSchema };\n    }),\n    legacyFinalizeNodeDefinition,\n    legacyRunAdbShellNodeDefinition,\n    legacyActionNodeDefinition,\n    legacyValidationErrorNodeDefinition,\n  ];\n\nconst insightNodes = new Set(['aiBoolean', 'aiNumber', 'aiString', 'aiAsk']);\n\n/** Keep Test's { value } contract; only the legacy output view unwraps insights. */\nexport function getLegacyYamlResultData(\n  node: string,\n  output: NodeResult,\n): unknown {\n  return insightNodes.has(node)\n    ? (output.data as { value: unknown }).value\n    : output.data;\n}\n"],"names":["legacyFinalizeNodeDefinition","z","undefined","legacyRunAdbShellNodeDefinition","agent","input","androidAgent","command","timeout","value","legacyActionNodeDefinition","context","actionSpace","step","compileLegacyFlowItem","assert","JSON","definition","legacyAgentTestRunnerNodeDefinitions","node","parsed","legacyValidationErrorNodeDefinition","_agent","Error","legacyPromptInputSchema","legacyInputSchemas","Map","name","sharedDefinitions","commonAgentTestRunnerNodeDefinitions","Array","inputSchema","insightNodes","Set","getLegacyYamlResultData","output"],"mappings":"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"}

package/dist/es/yaml/utils.mjs

@@ -38,6 +38,13 @@ function resolveWebTarget(config) {
         }
     };
 }
+function resolveYamlOutputConfig(script) {
+    const target = resolveWebTarget(script)?.target ?? script.android ?? script.ios ?? script.harmony ?? script.computer;
+    return {
+        output: target?.output ?? script.config?.output,
+        unstableLogContent: target?.unstableLogContent ?? script.config?.unstableLogContent
+    };
+}
 function interpolateEnvVarRefs(value, keepUnresolvedRefs = false) {
     let result = '';
     let lastIndex = 0;
@@ -102,6 +109,9 @@ function interpolateYamlScriptEnvVars(content) {
     }).join('\n');
 }
 function parseYamlScript(content, filePath) {
+    return parseLegacyYamlScript(content, filePath);
+}
+function parseLegacyYamlScript(content, filePath, onConfig) {
     let processedContent = content;
     if (-1 !== content.indexOf('android') && content.match(/deviceId:\s*(\d+)/)) {
         let matchedDeviceId;
@@ -115,6 +125,7 @@ function parseYamlScript(content, filePath) {
     const obj = js_yaml.load(interpolatedContent, {
         schema: js_yaml.JSON_SCHEMA
     });
+    if (obj && 'object' == typeof obj && !Array.isArray(obj)) onConfig?.(obj);
     const pathTip = filePath ? `, failed to load ${filePath}` : '';
     resolveWebTarget(obj);
     assert(obj.tasks, `property "tasks" is required in yaml script ${pathTip}`);
@@ -178,6 +189,6 @@ function buildDetailedLocateParamAndRestParams(locatePrompt, opt, excludeKeys =
         restParams
     };
 }
-export { buildDetailedLocateParam, buildDetailedLocateParamAndRestParams, interpolateEnvVars, parseYamlScript, resolveWebTarget };
+export { buildDetailedLocateParam, buildDetailedLocateParamAndRestParams, interpolateEnvVars, parseLegacyYamlScript, parseYamlScript, resolveWebTarget, resolveYamlOutputConfig };
 
 //# sourceMappingURL=utils.mjs.map

package/dist/es/yaml/utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"yaml/utils.mjs","sources":["../../../src/yaml/utils.ts"],"sourcesContent":["import type { TMultimodalPrompt, TUserPrompt } from '@/common';\nimport type {\n  DetailedLocateParam,\n  LocateOption,\n  MidsceneYamlScript,\n  MidsceneYamlScriptWebEnv,\n} from '@/types';\nimport { getDebug } from '@midscene/shared/logger';\nimport { assert } from '@midscene/shared/utils';\nimport yaml from 'js-yaml';\nimport { buildLocatePromptWithContext } from '../agent/prompt-context';\n\nconst debugUtils = getDebug('yaml:utils');\n\nconst topLevelTasksPattern = /^tasks\\s*:/;\nconst topLevelYamlKeyPattern = /^[^\\s#][^:]*:/;\n\nexport type WebTargetSource = 'page' | 'browser' | 'web' | 'target';\n\nexport type ResolvedWebTarget = {\n  source: WebTargetSource;\n  target: Partial<MidsceneYamlScriptWebEnv> & { mode: 'page' | 'browser' };\n  mode: 'page' | 'browser';\n};\n\nexport type WebTargetConfig = Partial<\n  Record<WebTargetSource, Partial<MidsceneYamlScriptWebEnv>>\n>;\n\nconst webTargetSources: WebTargetSource[] = [\n  'page',\n  'browser',\n  'web',\n  'target',\n];\n\nexport function resolveWebTarget(\n  config: WebTargetConfig,\n): ResolvedWebTarget | undefined {\n  const entries = webTargetSources\n    .map((source) => [source, config[source]] as const)\n    .filter(\n      (\n        entry,\n      ): entry is readonly [\n        WebTargetSource,\n        Partial<MidsceneYamlScriptWebEnv>,\n      ] => typeof entry[1] !== 'undefined',\n    );\n\n  if (entries.length === 0) {\n    return undefined;\n  }\n\n  if (entries.length > 1) {\n    const specifiedTargets = entries.map(([source]) => source);\n    throw new Error(\n      `[midscene] Only one web target can be specified, but found multiple: ${specifiedTargets.join(\n        ', ',\n      )}. Please specify only one of: page, browser, web, or target.`,\n    );\n  }\n\n  const [source, target] = entries[0];\n  const explicitMode = target.mode;\n  if (\n    typeof explicitMode !== 'undefined' &&\n    explicitMode !== 'page' &&\n    explicitMode !== 'browser'\n  ) {\n    throw new Error(\n      `[midscene] web target mode must be either \"page\" or \"browser\", but got \"${explicitMode}\".`,\n    );\n  }\n\n  if (source === 'page' && explicitMode === 'browser') {\n    throw new Error(\n      '[midscene] page target cannot use mode: browser. Use browser: instead.',\n    );\n  }\n\n  if (source === 'browser' && explicitMode === 'page') {\n    throw new Error(\n      '[midscene] browser target cannot use mode: page. Use page: instead.',\n    );\n  }\n\n  const mode =\n    source === 'page'\n      ? 'page'\n      : source === 'browser'\n        ? 'browser'\n        : (explicitMode ?? 'page');\n\n  if (mode === 'page' && target.autoFollowNewPage) {\n    throw new Error(\n      '[midscene] autoFollowNewPage requires browser mode. Use browser: or web.mode: browser.',\n    );\n  }\n\n  if (\n    mode === 'browser' &&\n    typeof target.forceSameTabNavigation !== 'undefined'\n  ) {\n    throw new Error(\n      '[midscene] forceSameTabNavigation cannot be used in browser mode. Use page: or web.mode: page when same-tab navigation is required.',\n    );\n  }\n\n  return {\n    source,\n    mode,\n    target: {\n      ...target,\n      mode,\n    },\n  };\n}\n\nfunction interpolateEnvVarRefs(\n  value: string,\n  keepUnresolvedRefs = false,\n): string {\n  let result = '';\n  let lastIndex = 0;\n  let searchFrom = 0;\n\n  while (searchFrom < value.length) {\n    const start = value.indexOf('${', searchFrom);\n    if (start === -1) {\n      break;\n    }\n\n    const end = value.indexOf('}', start + 2);\n    if (end === -1) {\n      break;\n    }\n\n    const rawName = value.slice(start + 2, end);\n    if (!rawName) {\n      searchFrom = end + 1;\n      continue;\n    }\n\n    result += value.slice(lastIndex, start);\n    const envVar = rawName.trim();\n    const envValue = process.env[envVar];\n    if (envValue === undefined) {\n      if (keepUnresolvedRefs) {\n        result += value.slice(start, end + 1);\n      } else {\n        throw new Error(`Environment variable \"${envVar}\" is not defined`);\n      }\n    } else {\n      result += envValue;\n    }\n    lastIndex = end + 1;\n    searchFrom = end + 1;\n  }\n\n  return result + value.slice(lastIndex);\n}\n\nconst multimodalLocateOptionFieldMap: Record<keyof TMultimodalPrompt, true> = {\n  images: true,\n  convertHttpImage2Base64: true,\n};\n\nconst multimodalLocateOptionKeys = Object.keys(\n  multimodalLocateOptionFieldMap,\n) as Array<keyof TMultimodalPrompt>;\n\nfunction extractMultimodalPrompt(\n  opt?: LocateOption,\n): Partial<TMultimodalPrompt> | undefined {\n  if (typeof opt !== 'object' || opt === null) {\n    return undefined;\n  }\n\n  const entries = multimodalLocateOptionKeys\n    .map((key) => [key, opt[key]] as const)\n    .filter(([, value]) => value !== undefined);\n\n  return entries.length\n    ? (Object.fromEntries(entries) as Partial<TMultimodalPrompt>)\n    : undefined;\n}\n\nexport function interpolateEnvVars(content: string): string {\n  // Process line by line to skip commented lines\n  const lines = content.split('\\n');\n  const processedLines = lines.map((line) => {\n    // Check if the line is a YAML comment (starts with # after optional whitespace)\n    const trimmedLine = line.trimStart();\n    if (trimmedLine.startsWith('#')) {\n      // Skip interpolation for comment lines\n      return line;\n    }\n\n    // Process environment variables for non-comment lines\n    return interpolateEnvVarRefs(line);\n  });\n\n  return processedLines.join('\\n');\n}\n\nfunction interpolateYamlScriptEnvVars(content: string): string {\n  let inTopLevelTasksBlock = false;\n\n  return content\n    .split('\\n')\n    .map((line) => {\n      const trimmedLine = line.trimStart();\n      if (!trimmedLine || trimmedLine.startsWith('#')) {\n        return line;\n      }\n\n      const indentSize = line.length - trimmedLine.length;\n      if (indentSize === 0) {\n        if (topLevelTasksPattern.test(trimmedLine)) {\n          inTopLevelTasksBlock = true;\n          return line;\n        }\n\n        if (topLevelYamlKeyPattern.test(trimmedLine)) {\n          inTopLevelTasksBlock = false;\n        }\n      }\n\n      return interpolateEnvVarRefs(line, inTopLevelTasksBlock);\n    })\n    .join('\\n');\n}\n\nexport function parseYamlScript(\n  content: string,\n  filePath?: string,\n): MidsceneYamlScript {\n  let processedContent = content;\n  if (content.indexOf('android') !== -1 && content.match(/deviceId:\\s*(\\d+)/)) {\n    let matchedDeviceId;\n    processedContent = content.replace(\n      /deviceId:\\s*(\\d+)/g,\n      (match, deviceId) => {\n        matchedDeviceId = deviceId;\n        return `deviceId: '${deviceId}'`;\n      },\n    );\n    console.warn(\n      `please use string-style deviceId in yaml script, for example: deviceId: \"${matchedDeviceId}\"`,\n    );\n  }\n  const interpolatedContent = interpolateYamlScriptEnvVars(processedContent);\n  const obj = yaml.load(interpolatedContent, {\n    schema: yaml.JSON_SCHEMA,\n  }) as MidsceneYamlScript;\n\n  const pathTip = filePath ? `, failed to load ${filePath}` : '';\n  resolveWebTarget(obj);\n  assert(obj.tasks, `property \"tasks\" is required in yaml script ${pathTip}`);\n  assert(\n    Array.isArray(obj.tasks),\n    `property \"tasks\" must be an array in yaml script, but got ${obj.tasks}`,\n  );\n  return obj;\n}\n\nexport function buildDetailedLocateParam(\n  locatePrompt: TUserPrompt,\n  opt?: LocateOption,\n): DetailedLocateParam | undefined {\n  debugUtils('will call buildDetailedLocateParam', locatePrompt, opt);\n  // Normalize object-form TUserPrompt: when the object only contains a\n  // `prompt` string (no multimodal fields like `images`), unwrap it to\n  // avoid double nesting like { prompt: { prompt: '...' } }.\n  let normalizedLocatePrompt: TUserPrompt = locatePrompt;\n  if (\n    typeof locatePrompt === 'object' &&\n    locatePrompt !== null &&\n    'prompt' in locatePrompt\n  ) {\n    const { prompt: innerPrompt, ...rest } = locatePrompt;\n    const hasMultimodalFields = Object.keys(rest).length > 0;\n    normalizedLocatePrompt = hasMultimodalFields ? locatePrompt : innerPrompt;\n  }\n\n  let prompt = normalizedLocatePrompt || opt?.prompt || (opt as any)?.locate; // as a shortcut\n  let deepLocate = false;\n  let cacheable = true;\n  let xpath = undefined;\n\n  if (typeof opt === 'object' && opt !== null) {\n    // Backward-compatible: accept `deepThink` as a deprecated alias for `deepLocate`.\n    // All downstream code works on `deepLocate` only; the compatibility resolution\n    // is intentionally kept here at the entry point so it does not bleed through\n    // the rest of the call stack.\n    deepLocate = opt.deepLocate ?? opt.deepThink ?? false;\n    cacheable = opt.cacheable ?? true;\n    xpath = opt.xpath;\n    if (locatePrompt && opt.prompt && locatePrompt !== opt.prompt) {\n      console.warn(\n        'conflict prompt for item',\n        locatePrompt,\n        opt,\n        'maybe you put the prompt in the wrong place',\n      );\n    }\n    prompt = prompt || opt.prompt;\n  }\n\n  if (!prompt) {\n    debugUtils(\n      'no prompt, will return undefined in buildDetailedLocateParam',\n      opt,\n    );\n    return undefined;\n  }\n\n  const promptDisplay = typeof prompt === 'string' ? prompt : prompt.prompt;\n  const context = opt?.context?.trim() || undefined;\n  prompt = buildLocatePromptWithContext(prompt, opt?.context);\n\n  const multimodalPrompt = extractMultimodalPrompt(opt);\n  if (multimodalPrompt) {\n    prompt =\n      typeof prompt === 'string'\n        ? {\n            prompt,\n            ...multimodalPrompt,\n          }\n        : {\n            ...prompt,\n            ...multimodalPrompt,\n          };\n  }\n\n  return {\n    prompt,\n    ...(context ? { promptDisplay, context } : {}),\n    deepLocate,\n    cacheable,\n    xpath,\n  };\n}\n\nexport function buildDetailedLocateParamAndRestParams(\n  locatePrompt: TUserPrompt,\n  opt: LocateOption | undefined,\n  excludeKeys: string[] = [],\n): {\n  locateParam: DetailedLocateParam | undefined;\n  restParams: Record<string, any>;\n} {\n  const multimodalPrompt = extractMultimodalPrompt(opt);\n  const locateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n  // Extract all keys from opt except the ones already included in locateParam\n  const restParams: Record<string, any> = {};\n\n  if (typeof opt === 'object' && opt !== null) {\n    // Get all keys from opt\n    const allKeys = Object.keys(opt);\n\n    // `context` has already been merged into the locate prompt.\n    const locateParamKeys = Object.keys(locateParam || {});\n    const multimodalPromptKeys =\n      typeof locateParam?.prompt === 'object' && locateParam?.prompt !== null\n        ? Object.keys(multimodalPrompt || {})\n        : [];\n\n    // Extract all other keys\n    for (const key of allKeys) {\n      if (\n        !locateParamKeys.includes(key) &&\n        key !== 'context' &&\n        key !== 'deepThink' &&\n        !multimodalPromptKeys.includes(key) &&\n        !excludeKeys.includes(key) &&\n        key !== 'locate'\n      ) {\n        restParams[key] = opt[key as keyof LocateOption];\n      }\n    }\n  }\n\n  return {\n    locateParam,\n    restParams,\n  };\n}\n"],"names":["debugUtils","getDebug","topLevelTasksPattern","topLevelYamlKeyPattern","webTargetSources","resolveWebTarget","config","entries","source","entry","specifiedTargets","Error","target","explicitMode","mode","interpolateEnvVarRefs","value","keepUnresolvedRefs","result","lastIndex","searchFrom","start","end","rawName","envVar","envValue","process","undefined","multimodalLocateOptionFieldMap","multimodalLocateOptionKeys","Object","extractMultimodalPrompt","opt","key","interpolateEnvVars","content","lines","processedLines","line","trimmedLine","interpolateYamlScriptEnvVars","inTopLevelTasksBlock","indentSize","parseYamlScript","filePath","processedContent","matchedDeviceId","match","deviceId","console","interpolatedContent","obj","yaml","pathTip","assert","Array","buildDetailedLocateParam","locatePrompt","normalizedLocatePrompt","innerPrompt","rest","hasMultimodalFields","prompt","deepLocate","cacheable","xpath","promptDisplay","context","buildLocatePromptWithContext","multimodalPrompt","buildDetailedLocateParamAndRestParams","excludeKeys","locateParam","restParams","allKeys","locateParamKeys","multimodalPromptKeys"],"mappings":"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"}
+{"version":3,"file":"yaml/utils.mjs","sources":["../../../src/yaml/utils.ts"],"sourcesContent":["import type { TMultimodalPrompt, TUserPrompt } from '@/common';\nimport type {\n  DetailedLocateParam,\n  LocateOption,\n  MidsceneYamlScript,\n  MidsceneYamlScriptWebEnv,\n} from '@/types';\nimport { getDebug } from '@midscene/shared/logger';\nimport { assert } from '@midscene/shared/utils';\nimport yaml from 'js-yaml';\nimport { buildLocatePromptWithContext } from '../agent/prompt-context';\n\nconst debugUtils = getDebug('yaml:utils');\n\nconst topLevelTasksPattern = /^tasks\\s*:/;\nconst topLevelYamlKeyPattern = /^[^\\s#][^:]*:/;\n\nexport type WebTargetSource = 'page' | 'browser' | 'web' | 'target';\n\nexport type ResolvedWebTarget = {\n  source: WebTargetSource;\n  target: Partial<MidsceneYamlScriptWebEnv> & { mode: 'page' | 'browser' };\n  mode: 'page' | 'browser';\n};\n\nexport type WebTargetConfig = Partial<\n  Record<WebTargetSource, Partial<MidsceneYamlScriptWebEnv>>\n>;\n\nconst webTargetSources: WebTargetSource[] = [\n  'page',\n  'browser',\n  'web',\n  'target',\n];\n\nexport function resolveWebTarget(\n  config: WebTargetConfig,\n): ResolvedWebTarget | undefined {\n  const entries = webTargetSources\n    .map((source) => [source, config[source]] as const)\n    .filter(\n      (\n        entry,\n      ): entry is readonly [\n        WebTargetSource,\n        Partial<MidsceneYamlScriptWebEnv>,\n      ] => typeof entry[1] !== 'undefined',\n    );\n\n  if (entries.length === 0) {\n    return undefined;\n  }\n\n  if (entries.length > 1) {\n    const specifiedTargets = entries.map(([source]) => source);\n    throw new Error(\n      `[midscene] Only one web target can be specified, but found multiple: ${specifiedTargets.join(\n        ', ',\n      )}. Please specify only one of: page, browser, web, or target.`,\n    );\n  }\n\n  const [source, target] = entries[0];\n  const explicitMode = target.mode;\n  if (\n    typeof explicitMode !== 'undefined' &&\n    explicitMode !== 'page' &&\n    explicitMode !== 'browser'\n  ) {\n    throw new Error(\n      `[midscene] web target mode must be either \"page\" or \"browser\", but got \"${explicitMode}\".`,\n    );\n  }\n\n  if (source === 'page' && explicitMode === 'browser') {\n    throw new Error(\n      '[midscene] page target cannot use mode: browser. Use browser: instead.',\n    );\n  }\n\n  if (source === 'browser' && explicitMode === 'page') {\n    throw new Error(\n      '[midscene] browser target cannot use mode: page. Use page: instead.',\n    );\n  }\n\n  const mode =\n    source === 'page'\n      ? 'page'\n      : source === 'browser'\n        ? 'browser'\n        : (explicitMode ?? 'page');\n\n  if (mode === 'page' && target.autoFollowNewPage) {\n    throw new Error(\n      '[midscene] autoFollowNewPage requires browser mode. Use browser: or web.mode: browser.',\n    );\n  }\n\n  if (\n    mode === 'browser' &&\n    typeof target.forceSameTabNavigation !== 'undefined'\n  ) {\n    throw new Error(\n      '[midscene] forceSameTabNavigation cannot be used in browser mode. Use page: or web.mode: page when same-tab navigation is required.',\n    );\n  }\n\n  return {\n    source,\n    mode,\n    target: {\n      ...target,\n      mode,\n    },\n  };\n}\n\n/** Legacy output settings apply to every host, including native Test setup.\n * Target-local values keep their original priority; config supplies defaults.\n */\nexport function resolveYamlOutputConfig(\n  script: Omit<MidsceneYamlScript, 'tasks'>,\n): {\n  output?: string;\n  unstableLogContent?: boolean | string;\n} {\n  const target =\n    resolveWebTarget(script)?.target ??\n    script.android ??\n    script.ios ??\n    script.harmony ??\n    script.computer;\n  return {\n    output: target?.output ?? script.config?.output,\n    unstableLogContent:\n      target?.unstableLogContent ?? script.config?.unstableLogContent,\n  };\n}\n\nfunction interpolateEnvVarRefs(\n  value: string,\n  keepUnresolvedRefs = false,\n): string {\n  let result = '';\n  let lastIndex = 0;\n  let searchFrom = 0;\n\n  while (searchFrom < value.length) {\n    const start = value.indexOf('${', searchFrom);\n    if (start === -1) {\n      break;\n    }\n\n    const end = value.indexOf('}', start + 2);\n    if (end === -1) {\n      break;\n    }\n\n    const rawName = value.slice(start + 2, end);\n    if (!rawName) {\n      searchFrom = end + 1;\n      continue;\n    }\n\n    result += value.slice(lastIndex, start);\n    const envVar = rawName.trim();\n    const envValue = process.env[envVar];\n    if (envValue === undefined) {\n      if (keepUnresolvedRefs) {\n        result += value.slice(start, end + 1);\n      } else {\n        throw new Error(`Environment variable \"${envVar}\" is not defined`);\n      }\n    } else {\n      result += envValue;\n    }\n    lastIndex = end + 1;\n    searchFrom = end + 1;\n  }\n\n  return result + value.slice(lastIndex);\n}\n\nconst multimodalLocateOptionFieldMap: Record<keyof TMultimodalPrompt, true> = {\n  images: true,\n  convertHttpImage2Base64: true,\n};\n\nconst multimodalLocateOptionKeys = Object.keys(\n  multimodalLocateOptionFieldMap,\n) as Array<keyof TMultimodalPrompt>;\n\nfunction extractMultimodalPrompt(\n  opt?: LocateOption,\n): Partial<TMultimodalPrompt> | undefined {\n  if (typeof opt !== 'object' || opt === null) {\n    return undefined;\n  }\n\n  const entries = multimodalLocateOptionKeys\n    .map((key) => [key, opt[key]] as const)\n    .filter(([, value]) => value !== undefined);\n\n  return entries.length\n    ? (Object.fromEntries(entries) as Partial<TMultimodalPrompt>)\n    : undefined;\n}\n\nexport function interpolateEnvVars(content: string): string {\n  // Process line by line to skip commented lines\n  const lines = content.split('\\n');\n  const processedLines = lines.map((line) => {\n    // Check if the line is a YAML comment (starts with # after optional whitespace)\n    const trimmedLine = line.trimStart();\n    if (trimmedLine.startsWith('#')) {\n      // Skip interpolation for comment lines\n      return line;\n    }\n\n    // Process environment variables for non-comment lines\n    return interpolateEnvVarRefs(line);\n  });\n\n  return processedLines.join('\\n');\n}\n\nfunction interpolateYamlScriptEnvVars(content: string): string {\n  let inTopLevelTasksBlock = false;\n\n  return content\n    .split('\\n')\n    .map((line) => {\n      const trimmedLine = line.trimStart();\n      if (!trimmedLine || trimmedLine.startsWith('#')) {\n        return line;\n      }\n\n      const indentSize = line.length - trimmedLine.length;\n      if (indentSize === 0) {\n        if (topLevelTasksPattern.test(trimmedLine)) {\n          inTopLevelTasksBlock = true;\n          return line;\n        }\n\n        if (topLevelYamlKeyPattern.test(trimmedLine)) {\n          inTopLevelTasksBlock = false;\n        }\n      }\n\n      return interpolateEnvVarRefs(line, inTopLevelTasksBlock);\n    })\n    .join('\\n');\n}\n\nexport function parseYamlScript(\n  content: string,\n  filePath?: string,\n): MidsceneYamlScript {\n  return parseLegacyYamlScript(content, filePath);\n}\n\n/** Internal collection observer; the public parser keeps its original signature. */\nexport function parseLegacyYamlScript(\n  content: string,\n  filePath?: string,\n  onConfig?: (config: Omit<MidsceneYamlScript, 'tasks'>) => void,\n): MidsceneYamlScript {\n  let processedContent = content;\n  if (content.indexOf('android') !== -1 && content.match(/deviceId:\\s*(\\d+)/)) {\n    let matchedDeviceId;\n    processedContent = content.replace(\n      /deviceId:\\s*(\\d+)/g,\n      (match, deviceId) => {\n        matchedDeviceId = deviceId;\n        return `deviceId: '${deviceId}'`;\n      },\n    );\n    console.warn(\n      `please use string-style deviceId in yaml script, for example: deviceId: \"${matchedDeviceId}\"`,\n    );\n  }\n  const interpolatedContent = interpolateYamlScriptEnvVars(processedContent);\n  const obj = yaml.load(interpolatedContent, {\n    schema: yaml.JSON_SCHEMA,\n  }) as MidsceneYamlScript;\n\n  if (obj && typeof obj === 'object' && !Array.isArray(obj)) onConfig?.(obj);\n  const pathTip = filePath ? `, failed to load ${filePath}` : '';\n  resolveWebTarget(obj);\n  assert(obj.tasks, `property \"tasks\" is required in yaml script ${pathTip}`);\n  assert(\n    Array.isArray(obj.tasks),\n    `property \"tasks\" must be an array in yaml script, but got ${obj.tasks}`,\n  );\n  return obj;\n}\n\nexport function buildDetailedLocateParam(\n  locatePrompt: TUserPrompt,\n  opt?: LocateOption,\n): DetailedLocateParam | undefined {\n  debugUtils('will call buildDetailedLocateParam', locatePrompt, opt);\n  // Normalize object-form TUserPrompt: when the object only contains a\n  // `prompt` string (no multimodal fields like `images`), unwrap it to\n  // avoid double nesting like { prompt: { prompt: '...' } }.\n  let normalizedLocatePrompt: TUserPrompt = locatePrompt;\n  if (\n    typeof locatePrompt === 'object' &&\n    locatePrompt !== null &&\n    'prompt' in locatePrompt\n  ) {\n    const { prompt: innerPrompt, ...rest } = locatePrompt;\n    const hasMultimodalFields = Object.keys(rest).length > 0;\n    normalizedLocatePrompt = hasMultimodalFields ? locatePrompt : innerPrompt;\n  }\n\n  let prompt = normalizedLocatePrompt || opt?.prompt || (opt as any)?.locate; // as a shortcut\n  let deepLocate = false;\n  let cacheable = true;\n  let xpath = undefined;\n\n  if (typeof opt === 'object' && opt !== null) {\n    // Backward-compatible: accept `deepThink` as a deprecated alias for `deepLocate`.\n    // All downstream code works on `deepLocate` only; the compatibility resolution\n    // is intentionally kept here at the entry point so it does not bleed through\n    // the rest of the call stack.\n    deepLocate = opt.deepLocate ?? opt.deepThink ?? false;\n    cacheable = opt.cacheable ?? true;\n    xpath = opt.xpath;\n    if (locatePrompt && opt.prompt && locatePrompt !== opt.prompt) {\n      console.warn(\n        'conflict prompt for item',\n        locatePrompt,\n        opt,\n        'maybe you put the prompt in the wrong place',\n      );\n    }\n    prompt = prompt || opt.prompt;\n  }\n\n  if (!prompt) {\n    debugUtils(\n      'no prompt, will return undefined in buildDetailedLocateParam',\n      opt,\n    );\n    return undefined;\n  }\n\n  const promptDisplay = typeof prompt === 'string' ? prompt : prompt.prompt;\n  const context = opt?.context?.trim() || undefined;\n  prompt = buildLocatePromptWithContext(prompt, opt?.context);\n\n  const multimodalPrompt = extractMultimodalPrompt(opt);\n  if (multimodalPrompt) {\n    prompt =\n      typeof prompt === 'string'\n        ? {\n            prompt,\n            ...multimodalPrompt,\n          }\n        : {\n            ...prompt,\n            ...multimodalPrompt,\n          };\n  }\n\n  return {\n    prompt,\n    ...(context ? { promptDisplay, context } : {}),\n    deepLocate,\n    cacheable,\n    xpath,\n  };\n}\n\nexport function buildDetailedLocateParamAndRestParams(\n  locatePrompt: TUserPrompt,\n  opt: LocateOption | undefined,\n  excludeKeys: string[] = [],\n): {\n  locateParam: DetailedLocateParam | undefined;\n  restParams: Record<string, any>;\n} {\n  const multimodalPrompt = extractMultimodalPrompt(opt);\n  const locateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n  // Extract all keys from opt except the ones already included in locateParam\n  const restParams: Record<string, any> = {};\n\n  if (typeof opt === 'object' && opt !== null) {\n    // Get all keys from opt\n    const allKeys = Object.keys(opt);\n\n    // `context` has already been merged into the locate prompt.\n    const locateParamKeys = Object.keys(locateParam || {});\n    const multimodalPromptKeys =\n      typeof locateParam?.prompt === 'object' && locateParam?.prompt !== null\n        ? Object.keys(multimodalPrompt || {})\n        : [];\n\n    // Extract all other keys\n    for (const key of allKeys) {\n      if (\n        !locateParamKeys.includes(key) &&\n        key !== 'context' &&\n        key !== 'deepThink' &&\n        !multimodalPromptKeys.includes(key) &&\n        !excludeKeys.includes(key) &&\n        key !== 'locate'\n      ) {\n        restParams[key] = opt[key as keyof LocateOption];\n      }\n    }\n  }\n\n  return {\n    locateParam,\n    restParams,\n  };\n}\n"],"names":["debugUtils","getDebug","topLevelTasksPattern","topLevelYamlKeyPattern","webTargetSources","resolveWebTarget","config","entries","source","entry","specifiedTargets","Error","target","explicitMode","mode","resolveYamlOutputConfig","script","interpolateEnvVarRefs","value","keepUnresolvedRefs","result","lastIndex","searchFrom","start","end","rawName","envVar","envValue","process","undefined","multimodalLocateOptionFieldMap","multimodalLocateOptionKeys","Object","extractMultimodalPrompt","opt","key","interpolateEnvVars","content","lines","processedLines","line","trimmedLine","interpolateYamlScriptEnvVars","inTopLevelTasksBlock","indentSize","parseYamlScript","filePath","parseLegacyYamlScript","onConfig","processedContent","matchedDeviceId","match","deviceId","console","interpolatedContent","obj","yaml","Array","pathTip","assert","buildDetailedLocateParam","locatePrompt","normalizedLocatePrompt","innerPrompt","rest","hasMultimodalFields","prompt","deepLocate","cacheable","xpath","promptDisplay","context","buildLocatePromptWithContext","multimodalPrompt","buildDetailedLocateParamAndRestParams","excludeKeys","locateParam","restParams","allKeys","locateParamKeys","multimodalPromptKeys"],"mappings":";;;;AAYA,MAAMA,aAAaC,SAAS;AAE5B,MAAMC,uBAAuB;AAC7B,MAAMC,yBAAyB;AAc/B,MAAMC,mBAAsC;IAC1C;IACA;IACA;IACA;CACD;AAEM,SAASC,iBACdC,MAAuB;IAEvB,MAAMC,UAAUH,iBACb,GAAG,CAAC,CAACI,SAAW;YAACA;YAAQF,MAAM,CAACE,OAAO;SAAC,EACxC,MAAM,CACL,CACEC,QAIG,AAAoB,WAAbA,KAAK,CAAC,EAAE;IAGxB,IAAIF,AAAmB,MAAnBA,QAAQ,MAAM,EAChB;IAGF,IAAIA,QAAQ,MAAM,GAAG,GAAG;QACtB,MAAMG,mBAAmBH,QAAQ,GAAG,CAAC,CAAC,CAACC,OAAO,GAAKA;QACnD,MAAM,IAAIG,MACR,CAAC,qEAAqE,EAAED,iBAAiB,IAAI,CAC3F,MACA,4DAA4D,CAAC;IAEnE;IAEA,MAAM,CAACF,QAAQI,OAAO,GAAGL,OAAO,CAAC,EAAE;IACnC,MAAMM,eAAeD,OAAO,IAAI;IAChC,IACE,AAAwB,WAAjBC,gBACPA,AAAiB,WAAjBA,gBACAA,AAAiB,cAAjBA,cAEA,MAAM,IAAIF,MACR,CAAC,wEAAwE,EAAEE,aAAa,EAAE,CAAC;IAI/F,IAAIL,AAAW,WAAXA,UAAqBK,AAAiB,cAAjBA,cACvB,MAAM,IAAIF,MACR;IAIJ,IAAIH,AAAW,cAAXA,UAAwBK,AAAiB,WAAjBA,cAC1B,MAAM,IAAIF,MACR;IAIJ,MAAMG,OACJN,AAAW,WAAXA,SACI,SACAA,AAAW,cAAXA,SACE,YACCK,gBAAgB;IAEzB,IAAIC,AAAS,WAATA,QAAmBF,OAAO,iBAAiB,EAC7C,MAAM,IAAID,MACR;IAIJ,IACEG,AAAS,cAATA,QACA,AAAyC,WAAlCF,OAAO,sBAAsB,EAEpC,MAAM,IAAID,MACR;IAIJ,OAAO;QACLH;QACAM;QACA,QAAQ;YACN,GAAGF,MAAM;YACTE;QACF;IACF;AACF;AAKO,SAASC,wBACdC,MAAyC;IAKzC,MAAMJ,SACJP,iBAAiBW,SAAS,UAC1BA,OAAO,OAAO,IACdA,OAAO,GAAG,IACVA,OAAO,OAAO,IACdA,OAAO,QAAQ;IACjB,OAAO;QACL,QAAQJ,QAAQ,UAAUI,OAAO,MAAM,EAAE;QACzC,oBACEJ,QAAQ,sBAAsBI,OAAO,MAAM,EAAE;IACjD;AACF;AAEA,SAASC,sBACPC,KAAa,EACbC,qBAAqB,KAAK;IAE1B,IAAIC,SAAS;IACb,IAAIC,YAAY;IAChB,IAAIC,aAAa;IAEjB,MAAOA,aAAaJ,MAAM,MAAM,CAAE;QAChC,MAAMK,QAAQL,MAAM,OAAO,CAAC,MAAMI;QAClC,IAAIC,AAAU,OAAVA,OACF;QAGF,MAAMC,MAAMN,MAAM,OAAO,CAAC,KAAKK,QAAQ;QACvC,IAAIC,AAAQ,OAARA,KACF;QAGF,MAAMC,UAAUP,MAAM,KAAK,CAACK,QAAQ,GAAGC;QACvC,IAAI,CAACC,SAAS;YACZH,aAAaE,MAAM;YACnB;QACF;QAEAJ,UAAUF,MAAM,KAAK,CAACG,WAAWE;QACjC,MAAMG,SAASD,QAAQ,IAAI;QAC3B,MAAME,WAAWC,QAAQ,GAAG,CAACF,OAAO;QACpC,IAAIC,AAAaE,WAAbF,UACF,IAAIR,oBACFC,UAAUF,MAAM,KAAK,CAACK,OAAOC,MAAM;aAEnC,MAAM,IAAIb,MAAM,CAAC,sBAAsB,EAAEe,OAAO,gBAAgB,CAAC;aAGnEN,UAAUO;QAEZN,YAAYG,MAAM;QAClBF,aAAaE,MAAM;IACrB;IAEA,OAAOJ,SAASF,MAAM,KAAK,CAACG;AAC9B;AAEA,MAAMS,iCAAwE;IAC5E,QAAQ;IACR,yBAAyB;AAC3B;AAEA,MAAMC,6BAA6BC,OAAO,IAAI,CAC5CF;AAGF,SAASG,wBACPC,GAAkB;IAElB,IAAI,AAAe,YAAf,OAAOA,OAAoBA,AAAQ,SAARA,KAC7B;IAGF,MAAM3B,UAAUwB,2BACb,GAAG,CAAC,CAACI,MAAQ;YAACA;YAAKD,GAAG,CAACC,IAAI;SAAC,EAC5B,MAAM,CAAC,CAAC,GAAGjB,MAAM,GAAKA,AAAUW,WAAVX;IAEzB,OAAOX,QAAQ,MAAM,GAChByB,OAAO,WAAW,CAACzB,WACpBsB;AACN;AAEO,SAASO,mBAAmBC,OAAe;IAEhD,MAAMC,QAAQD,QAAQ,KAAK,CAAC;IAC5B,MAAME,iBAAiBD,MAAM,GAAG,CAAC,CAACE;QAEhC,MAAMC,cAAcD,KAAK,SAAS;QAClC,IAAIC,YAAY,UAAU,CAAC,MAEzB,OAAOD;QAIT,OAAOvB,sBAAsBuB;IAC/B;IAEA,OAAOD,eAAe,IAAI,CAAC;AAC7B;AAEA,SAASG,6BAA6BL,OAAe;IACnD,IAAIM,uBAAuB;IAE3B,OAAON,QACJ,KAAK,CAAC,MACN,GAAG,CAAC,CAACG;QACJ,MAAMC,cAAcD,KAAK,SAAS;QAClC,IAAI,CAACC,eAAeA,YAAY,UAAU,CAAC,MACzC,OAAOD;QAGT,MAAMI,aAAaJ,KAAK,MAAM,GAAGC,YAAY,MAAM;QACnD,IAAIG,AAAe,MAAfA,YAAkB;YACpB,IAAI1C,qBAAqB,IAAI,CAACuC,cAAc;gBAC1CE,uBAAuB;gBACvB,OAAOH;YACT;YAEA,IAAIrC,uBAAuB,IAAI,CAACsC,cAC9BE,uBAAuB;QAE3B;QAEA,OAAO1B,sBAAsBuB,MAAMG;IACrC,GACC,IAAI,CAAC;AACV;AAEO,SAASE,gBACdR,OAAe,EACfS,QAAiB;IAEjB,OAAOC,sBAAsBV,SAASS;AACxC;AAGO,SAASC,sBACdV,OAAe,EACfS,QAAiB,EACjBE,QAA8D;IAE9D,IAAIC,mBAAmBZ;IACvB,IAAIA,AAA+B,OAA/BA,QAAQ,OAAO,CAAC,cAAqBA,QAAQ,KAAK,CAAC,sBAAsB;QAC3E,IAAIa;QACJD,mBAAmBZ,QAAQ,OAAO,CAChC,sBACA,CAACc,OAAOC;YACNF,kBAAkBE;YAClB,OAAO,CAAC,WAAW,EAAEA,SAAS,CAAC,CAAC;QAClC;QAEFC,QAAQ,IAAI,CACV,CAAC,yEAAyE,EAAEH,gBAAgB,CAAC,CAAC;IAElG;IACA,MAAMI,sBAAsBZ,6BAA6BO;IACzD,MAAMM,MAAMC,QAAAA,IAAS,CAACF,qBAAqB;QACzC,QAAQE,QAAAA,WAAgB;IAC1B;IAEA,IAAID,OAAO,AAAe,YAAf,OAAOA,OAAoB,CAACE,MAAM,OAAO,CAACF,MAAMP,WAAWO;IACtE,MAAMG,UAAUZ,WAAW,CAAC,iBAAiB,EAAEA,UAAU,GAAG;IAC5DzC,iBAAiBkD;IACjBI,OAAOJ,IAAI,KAAK,EAAE,CAAC,4CAA4C,EAAEG,SAAS;IAC1EC,OACEF,MAAM,OAAO,CAACF,IAAI,KAAK,GACvB,CAAC,0DAA0D,EAAEA,IAAI,KAAK,EAAE;IAE1E,OAAOA;AACT;AAEO,SAASK,yBACdC,YAAyB,EACzB3B,GAAkB;IAElBlC,WAAW,sCAAsC6D,cAAc3B;IAI/D,IAAI4B,yBAAsCD;IAC1C,IACE,AAAwB,YAAxB,OAAOA,gBACPA,AAAiB,SAAjBA,gBACA,YAAYA,cACZ;QACA,MAAM,EAAE,QAAQE,WAAW,EAAE,GAAGC,MAAM,GAAGH;QACzC,MAAMI,sBAAsBjC,OAAO,IAAI,CAACgC,MAAM,MAAM,GAAG;QACvDF,yBAAyBG,sBAAsBJ,eAAeE;IAChE;IAEA,IAAIG,SAASJ,0BAA0B5B,KAAK,UAAWA,KAAa;IACpE,IAAIiC,aAAa;IACjB,IAAIC,YAAY;IAChB,IAAIC;IAEJ,IAAI,AAAe,YAAf,OAAOnC,OAAoBA,AAAQ,SAARA,KAAc;QAK3CiC,aAAajC,IAAI,UAAU,IAAIA,IAAI,SAAS,IAAI;QAChDkC,YAAYlC,IAAI,SAAS,IAAI;QAC7BmC,QAAQnC,IAAI,KAAK;QACjB,IAAI2B,gBAAgB3B,IAAI,MAAM,IAAI2B,iBAAiB3B,IAAI,MAAM,EAC3DmB,QAAQ,IAAI,CACV,4BACAQ,cACA3B,KACA;QAGJgC,SAASA,UAAUhC,IAAI,MAAM;IAC/B;IAEA,IAAI,CAACgC,QAAQ,YACXlE,WACE,gEACAkC;IAKJ,MAAMoC,gBAAgB,AAAkB,YAAlB,OAAOJ,SAAsBA,SAASA,OAAO,MAAM;IACzE,MAAMK,UAAUrC,KAAK,SAAS,UAAUL;IACxCqC,SAASM,6BAA6BN,QAAQhC,KAAK;IAEnD,MAAMuC,mBAAmBxC,wBAAwBC;IACjD,IAAIuC,kBACFP,SACE,AAAkB,YAAlB,OAAOA,SACH;QACEA;QACA,GAAGO,gBAAgB;IACrB,IACA;QACE,GAAGP,MAAM;QACT,GAAGO,gBAAgB;IACrB;IAGR,OAAO;QACLP;QACA,GAAIK,UAAU;YAAED;YAAeC;QAAQ,IAAI,CAAC,CAAC;QAC7CJ;QACAC;QACAC;IACF;AACF;AAEO,SAASK,sCACdb,YAAyB,EACzB3B,GAA6B,EAC7ByC,cAAwB,EAAE;IAK1B,MAAMF,mBAAmBxC,wBAAwBC;IACjD,MAAM0C,cAAchB,yBAAyBC,cAAc3B;IAG3D,MAAM2C,aAAkC,CAAC;IAEzC,IAAI,AAAe,YAAf,OAAO3C,OAAoBA,AAAQ,SAARA,KAAc;QAE3C,MAAM4C,UAAU9C,OAAO,IAAI,CAACE;QAG5B,MAAM6C,kBAAkB/C,OAAO,IAAI,CAAC4C,eAAe,CAAC;QACpD,MAAMI,uBACJ,AAA+B,YAA/B,OAAOJ,aAAa,UAAuBA,aAAa,WAAW,OAC/D5C,OAAO,IAAI,CAACyC,oBAAoB,CAAC,KACjC,EAAE;QAGR,KAAK,MAAMtC,OAAO2C,QAChB,IACE,CAACC,gBAAgB,QAAQ,CAAC5C,QAC1BA,AAAQ,cAARA,OACAA,AAAQ,gBAARA,OACA,CAAC6C,qBAAqB,QAAQ,CAAC7C,QAC/B,CAACwC,YAAY,QAAQ,CAACxC,QACtBA,AAAQ,aAARA,KAEA0C,UAAU,CAAC1C,IAAI,GAAGD,GAAG,CAACC,IAA0B;IAGtD;IAEA,OAAO;QACLyC;QACAC;IACF;AACF"}

package/dist/es/yaml-runtime.mjs

@@ -0,0 +1,7 @@
+import { enterYamlAction, enterYamlExecution, runInYamlExecutionContext } from "./yaml/execution-session.mjs";
+import { getLegacyYamlPlayerState } from "./yaml/player-state.mjs";
+import { isYamlReportEnabled } from "./yaml/report-policy.mjs";
+import { collectLegacyYamlDocument } from "./yaml/test-runner-compat.mjs";
+import { parseLegacyYamlScript } from "./yaml/utils.mjs";
+import { getLegacyYamlResultData, legacyAgentTestRunnerNodeDefinitions } from "./yaml/test-runner-nodes.mjs";
+export { collectLegacyYamlDocument, enterYamlAction, enterYamlExecution, getLegacyYamlPlayerState, getLegacyYamlResultData, isYamlReportEnabled, legacyAgentTestRunnerNodeDefinitions, parseLegacyYamlScript, runInYamlExecutionContext };

package/dist/es/yaml.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"yaml.mjs","sources":["../../src/yaml.ts"],"sourcesContent":["import type { TMultimodalPrompt, TUserPrompt } from './common';\nimport type {\n  AndroidDeviceOpt,\n  HarmonyDeviceOpt,\n  IOSDeviceOpt,\n} from './device';\nimport type { AgentOpt, LocateResultElement, Rect } from './types';\nimport type { UIContext } from './types';\n\nexport interface LocateOption extends Partial<TMultimodalPrompt> {\n  prompt?: TUserPrompt;\n  /**\n   * Additional facts, rules, or constraints for this AI call. It overrides\n   * the matching API context and `aiContexts.default`; `''` disables inherited\n   * user context for this call.\n   */\n  context?: string;\n  deepLocate?: boolean; // only available in vl model\n  /** @deprecated Use `deepLocate` instead. Kept for backward compatibility. */\n  deepThink?: boolean; // alias for deepLocate\n  cacheable?: boolean; // user can set this param to false to disable the cache for a single agent api\n  xpath?: string; // only available in web\n  uiContext?: UIContext;\n  fileChooserAccept?: string | string[]; // file path(s) to upload when tapping triggers a file chooser\n}\n\nexport interface ServiceExtractOption {\n  /**\n   * Additional facts, decision rules, constraints, or output requirements for\n   * this AI call. It overrides the matching API context and\n   * `aiContexts.default`; `''` disables inherited user context for this call.\n   */\n  context?: string;\n  domIncluded?: boolean | 'visible-only';\n  screenshotIncluded?: boolean;\n  [key: string]: unknown;\n}\n\nexport interface DetailedLocateParam\n  extends Omit<\n    LocateOption,\n    'context' | 'deepThink' | keyof TMultimodalPrompt\n  > {\n  prompt: TUserPrompt;\n  /** Original prompt text used for user-facing reports. */\n  promptDisplay?: string;\n  /** Per-call AI guidance recorded in user-facing reports. */\n  context?: string;\n}\n\nexport type ScrollType =\n  | 'singleAction'\n  | 'scrollToBottom'\n  | 'scrollToTop'\n  | 'scrollToRight'\n  | 'scrollToLeft'\n  // Legacy aliases kept for backward compatibility\n  | 'once'\n  | 'untilBottom'\n  | 'untilTop'\n  | 'untilRight'\n  | 'untilLeft';\n\nexport type ActionScrollParam = {\n  direction?: 'down' | 'up' | 'right' | 'left';\n  scrollType?: ScrollType;\n  distance?: number | null;\n  locate?: LocateResultElement;\n};\n\nexport type ScrollParam = Omit<ActionScrollParam, 'locate'>;\n\nexport interface MidsceneYamlScript {\n  // @deprecated\n  target?: MidsceneYamlScriptWebEnv;\n\n  page?: MidsceneYamlScriptWebEnv;\n  browser?: MidsceneYamlScriptWebEnv;\n  web?: MidsceneYamlScriptWebEnv;\n  android?: MidsceneYamlScriptAndroidEnv;\n  ios?: MidsceneYamlScriptIOSEnv;\n  harmony?: MidsceneYamlScriptHarmonyEnv;\n  computer?: MidsceneYamlScriptComputerEnv;\n\n  interface?: MidsceneYamlScriptEnvGeneralInterface;\n  config?: MidsceneYamlScriptConfig;\n  agent?: MidsceneYamlScriptAgentOpt;\n\n  tasks: MidsceneYamlTask[];\n}\n\nexport interface MidsceneYamlTask {\n  name: string;\n  flow: MidsceneYamlFlowItem[];\n  continueOnError?: boolean;\n}\n\n/**\n * Agent configuration options that can be specified in YAML scripts.\n *\n * This type includes serializable fields from AgentOpt, excluding non-serializable\n * fields like functions and complex objects. All fields are optional.\n *\n * @remarks\n * - testId is deprecated; prefer reportFileName and cache.id\n * - These settings apply to all platforms (Web, Android, iOS, Generic Interface)\n * - modelConfig is configured through environment variables, not in YAML\n *\n * @example\n * ```yaml\n * agent:\n *   reportFileName: \"checkout-report\"\n *   groupName: \"E2E Test Suite\"\n *   generateReport: true\n *   replanningCycleLimit: 30\n *   cache:\n *     id: \"checkout-cache\"\n *     strategy: \"read-write\"\n * ```\n */\nexport type MidsceneYamlScriptAgentOpt = Pick<\n  AgentOpt,\n  | 'testId' // deprecated, kept for backward compatibility\n  | 'groupName'\n  | 'groupDescription'\n  | 'generateReport'\n  | 'persistExecutionDump'\n  | 'autoPrintReportMsg'\n  | 'reportFileName'\n  | 'replanningCycleLimit'\n  | 'aiContexts'\n  | 'aiActContext'\n  | 'aiActionContext'\n  | 'cache'\n  | 'screenshotShrinkFactor'\n>;\n\nexport interface MidsceneYamlScriptConfig {\n  output?: string;\n  unstableLogContent?: boolean | string;\n}\n\nexport interface MidsceneYamlScriptEnvGeneralInterface {\n  // this will work as `const {...} = import('...'); const interface = new ...(param)`\n  module: string;\n  export?: string;\n  param?: Record<string, any>;\n}\n\nexport interface MidsceneYamlScriptWebEnv\n  extends MidsceneYamlScriptConfig,\n    MidsceneYamlScriptAgentOpt {\n  mode?: 'page' | 'browser';\n\n  // for web only\n  serve?: string;\n  url: string;\n\n  // puppeteer only\n  userAgent?: string;\n  acceptInsecureCerts?: boolean;\n  viewportWidth?: number;\n  viewportHeight?: number;\n  deviceScaleFactor?: number;\n  waitForNetworkIdle?: {\n    timeout?: number;\n    continueOnNetworkIdleError?: boolean; // should continue if failed to wait for network idle, true for default\n  };\n  cookie?: string;\n\n  /**\n   * Extra HTTP headers sent with every request (Puppeteer only, not supported\n   * in bridge mode). Useful when the server validates custom request headers.\n   *\n   * Header values must be strings. Quote values that YAML would otherwise parse\n   * as a boolean or number (e.g. `true`, `false`, `123`), such as `\"true\"`.\n   *\n   * @example\n   * ```yaml\n   * web:\n   *   url: https://example.com\n   *   extraHTTPHeaders:\n   *     X-Custom-Token: my-token\n   *     Accept-Language: en-US\n   * ```\n   */\n  extraHTTPHeaders?: Record<string, string>;\n\n  forceSameTabNavigation?: boolean; // if limit the new tab to the current page, true for default in yaml script\n  autoFollowNewPage?: boolean; // if use BrowserAgent to follow newly opened pages, false for default\n\n  /**\n   * Chrome download directory (Puppeteer only, not supported in bridge mode).\n   *\n   * Relative paths are resolved from the current working directory.\n   *\n   * @example\n   * ```yaml\n   * web:\n   *   url: https://example.com\n   *   downloadPath: ./downloads\n   * ```\n   */\n  downloadPath?: string;\n\n  /**\n   * Custom Chrome launch arguments (Puppeteer only, not supported in bridge mode).\n   *\n   * Allows passing custom command-line arguments to Chrome/Chromium when launching the browser.\n   * This is useful for testing scenarios that require specific browser configurations.\n   *\n   * ⚠️ Security Warning: Some arguments (e.g., --no-sandbox, --disable-web-security) may\n   * reduce browser security. Use only in controlled testing environments.\n   *\n   * @example\n   * ```yaml\n   * web:\n   *   url: https://example.com\n   *   chromeArgs:\n   *     - '--disable-features=ThirdPartyCookiePhaseout'\n   *     - '--disable-features=SameSiteByDefaultCookies'\n   *     - '--window-size=1920,1080'\n   * ```\n   */\n  chromeArgs?: string[];\n\n  // bridge mode config\n  bridgeMode?: false | 'newTabWithUrl' | 'currentTab';\n  closeNewTabsAfterDisconnect?: boolean;\n\n  /**\n   * CDP (Chrome DevTools Protocol) endpoint URL.\n   * When specified, connects to an existing Chrome browser via CDP instead of launching a new one.\n   *\n   * @example\n   * ```yaml\n   * web:\n   *   url: https://example.com\n   *   cdpEndpoint: ws://localhost:9222/devtools/browser/xxxx\n   * ```\n   */\n  cdpEndpoint?: string;\n}\n\nexport interface MidsceneYamlScriptAndroidEnv\n  extends MidsceneYamlScriptConfig,\n    Omit<AndroidDeviceOpt, 'customActions'> {\n  // The Android device ID to connect to, optional, will use the first device if not specified\n  deviceId?: string;\n\n  // The URL or app package to launch, optional, will use the current screen if not specified\n  launch?: string;\n}\n\nexport interface MidsceneYamlScriptIOSEnv\n  extends MidsceneYamlScriptConfig,\n    Omit<IOSDeviceOpt, 'customActions'> {\n  // The URL or app bundle ID to launch, optional, will use the current screen if not specified\n  launch?: string;\n}\n\nexport interface MidsceneYamlScriptHarmonyEnv\n  extends MidsceneYamlScriptConfig,\n    Omit<HarmonyDeviceOpt, 'customActions'> {\n  // The HarmonyOS device ID to connect to, optional, will use the first device if not specified\n  deviceId?: string;\n\n  // The bundle name, bundle/Ability target, or mapped app name to launch, optional,\n  // will use the current screen if not specified\n  launch?: string;\n\n  // Custom mapping of app names to bundle names or explicit bundle/Ability targets;\n  // user-provided mappings take precedence over defaults\n  appNameMapping?: Record<string, string>;\n}\n\nexport interface MidsceneYamlScriptComputerEnv\n  extends MidsceneYamlScriptConfig {\n  // The display ID to use, optional, will use the primary display if not specified\n  displayId?: string;\n}\n\nexport type MidsceneYamlScriptEnv =\n  | MidsceneYamlScriptWebEnv\n  | MidsceneYamlScriptAndroidEnv\n  | MidsceneYamlScriptIOSEnv\n  | MidsceneYamlScriptHarmonyEnv\n  | MidsceneYamlScriptComputerEnv;\n\n/** Target sections that can be supplied as batch-wide YAML overrides. */\nexport type MidsceneYamlTargetKey = Exclude<\n  keyof MidsceneYamlScript,\n  'config' | 'agent' | 'tasks'\n>;\n\nconst midsceneYamlTargetKeyMap = {\n  target: true,\n  page: true,\n  browser: true,\n  web: true,\n  android: true,\n  ios: true,\n  harmony: true,\n  computer: true,\n  interface: true,\n} as const satisfies Record<MidsceneYamlTargetKey, true>;\n\nexport const midsceneYamlTargetKeys = Object.keys(\n  midsceneYamlTargetKeyMap,\n) as MidsceneYamlTargetKey[];\n\n/**\n * Partial target settings applied to every script in a YAML batch.\n *\n * Batch settings are deep-merged over each script's target section, so every\n * nested target field is optional here even when a standalone script requires\n * it.\n */\nexport type MidsceneYamlTargetConfig = {\n  [Target in MidsceneYamlTargetKey]?: Partial<\n    NonNullable<MidsceneYamlScript[Target]>\n  >;\n};\n\nexport interface MidsceneYamlFlowItemAIAction {\n  // defined as aiAction for backward compatibility\n  aiAction?: TUserPrompt | null;\n  ai?: TUserPrompt | null; // this is the shortcut for aiAct\n  aiAct?: TUserPrompt | null;\n  instruction?: TUserPrompt;\n  aiActionProgressTips?: string[];\n  cacheable?: boolean;\n  [key: string]: unknown;\n}\n\nexport interface MidsceneYamlFlowItemAIAssert extends ServiceExtractOption {\n  aiAssert: string;\n  errorMessage?: string;\n  name?: string;\n}\n\nexport interface MidsceneYamlFlowItemAIWaitFor extends ServiceExtractOption {\n  aiWaitFor: string;\n  timeout?: number;\n}\n\nexport interface MidsceneYamlFlowItemRunGherkinScenario {\n  runGherkinScenario: string;\n}\n\nexport interface MidsceneYamlFlowItemEvaluateJavaScript {\n  javascript: string;\n  name?: string;\n}\n\nexport interface MidsceneYamlFlowItemSleep {\n  sleep: number;\n}\n\nexport interface MidsceneYamlFlowItemLogScreenshot {\n  logScreenshot?: string; // optional, the title of the screenshot\n  recordToReport?: string; // preferred key for record title\n  content?: string;\n}\n\nexport type MidsceneYamlFlowItem =\n  | MidsceneYamlFlowItemAIAction\n  | MidsceneYamlFlowItemAIAssert\n  | MidsceneYamlFlowItemAIWaitFor\n  | MidsceneYamlFlowItemRunGherkinScenario\n  | MidsceneYamlFlowItemEvaluateJavaScript\n  | MidsceneYamlFlowItemSleep\n  | MidsceneYamlFlowItemLogScreenshot;\n\nexport interface FreeFn {\n  name: string;\n  fn: () => void | Promise<void>;\n}\n\nexport interface ScriptPlayerTaskStatus extends MidsceneYamlTask {\n  status: ScriptPlayerStatusValue;\n  currentStep?: number;\n  totalSteps: number;\n  error?: Error;\n}\n\nexport type ScriptPlayerStatusValue = 'init' | 'running' | 'done' | 'error';\n\n// Index YAML file types for batch execution\nexport interface MidsceneYamlConfig extends MidsceneYamlTargetConfig {\n  /** @deprecated Use `web`, `page`, or `browser` instead. */\n  target?: Partial<MidsceneYamlScriptWebEnv>;\n  concurrent?: number;\n  continueOnError?: boolean;\n  /**\n   * Number of times to retry a failed yaml file before marking it as failed.\n   * A value of 2 means each failing case is re-executed up to 2 extra times\n   * (3 attempts in total). Only the cases that failed in the previous attempt\n   * are retried. Defaults to 0 (no retry).\n   */\n  retry?: number;\n  summary?: string;\n  /**\n   * Share one BrowserContext and Page across Puppeteer Web yaml files. This is\n   * not supported by bridge mode or non-Web targets.\n   */\n  shareBrowserContext?: boolean;\n  /**\n   * A setup yaml file that runs before the main `files`. A setup failure aborts\n   * the whole batch and the main files are marked as not executed. Puppeteer\n   * Web setup requires `shareBrowserContext: true` to pass browser state to the\n   * main files. Other targets run setup without browser-context sharing.\n   */\n  setup?: string;\n  files: string[];\n  headed?: boolean;\n  keepWindow?: boolean;\n  dotenvOverride?: boolean;\n  dotenvDebug?: boolean;\n}\n\nexport interface MidsceneYamlConfigOutput {\n  format?: 'json';\n  path?: string;\n}\n\nexport type MidsceneYamlConfigResultType =\n  | 'success'\n  | 'failed'\n  | 'partialFailed'\n  | 'notExecuted';\n\nexport interface MidsceneYamlConfigAttempt {\n  attempt: number;\n  success: boolean;\n  output?: string | null;\n  report?: string | null;\n  error?: string;\n  duration?: number;\n  resultType?: MidsceneYamlConfigResultType;\n}\n\nexport interface MidsceneYamlConfigResult {\n  file: string;\n  success: boolean;\n  executed: boolean;\n  output?: string | null;\n  report?: string | null;\n  retryReport?: string | null;\n  attempts?: MidsceneYamlConfigAttempt[];\n  error?: string;\n  duration?: number;\n  /**\n   * Type of result:\n   * - 'success': All tasks completed successfully\n   * - 'failed': Execution failed (player error)\n   * - 'partialFailed': Some tasks failed but execution continued (continueOnError)\n   * - 'notExecuted': Not executed due to previous failures\n   */\n  resultType?: MidsceneYamlConfigResultType;\n}\n"],"names":["midsceneYamlTargetKeyMap","midsceneYamlTargetKeys","Object"],"mappings":"AAuSA,MAAMA,2BAA2B;IAC/B,QAAQ;IACR,MAAM;IACN,SAAS;IACT,KAAK;IACL,SAAS;IACT,KAAK;IACL,SAAS;IACT,UAAU;IACV,WAAW;AACb;AAEO,MAAMC,yBAAyBC,OAAO,IAAI,CAC/CF"}
+{"version":3,"file":"yaml.mjs","sources":["../../src/yaml.ts"],"sourcesContent":["import type { TMultimodalPrompt, TUserPrompt } from './common';\nimport type {\n  AndroidDeviceOpt,\n  HarmonyDeviceOpt,\n  IOSDeviceOpt,\n} from './device';\nimport type { WorkflowExecutionRecord } from './test-runner/execution-record';\nimport type { AgentOpt, LocateResultElement, Rect } from './types';\nimport type { UIContext } from './types';\n\nexport interface LocateOption extends Partial<TMultimodalPrompt> {\n  prompt?: TUserPrompt;\n  /**\n   * Additional facts, rules, or constraints for this AI call. It overrides\n   * the matching API context and `aiContexts.default`; `''` disables inherited\n   * user context for this call.\n   */\n  context?: string;\n  deepLocate?: boolean; // only available in vl model\n  /** @deprecated Use `deepLocate` instead. Kept for backward compatibility. */\n  deepThink?: boolean; // alias for deepLocate\n  cacheable?: boolean; // user can set this param to false to disable the cache for a single agent api\n  xpath?: string; // only available in web\n  uiContext?: UIContext;\n  fileChooserAccept?: string | string[]; // file path(s) to upload when tapping triggers a file chooser\n}\n\nexport interface ServiceExtractOption {\n  /**\n   * Additional facts, decision rules, constraints, or output requirements for\n   * this AI call. It overrides the matching API context and\n   * `aiContexts.default`; `''` disables inherited user context for this call.\n   */\n  context?: string;\n  domIncluded?: boolean | 'visible-only';\n  screenshotIncluded?: boolean;\n  [key: string]: unknown;\n}\n\nexport interface DetailedLocateParam\n  extends Omit<\n    LocateOption,\n    'context' | 'deepThink' | keyof TMultimodalPrompt\n  > {\n  prompt: TUserPrompt;\n  /** Original prompt text used for user-facing reports. */\n  promptDisplay?: string;\n  /** Per-call AI guidance recorded in user-facing reports. */\n  context?: string;\n}\n\nexport type ScrollType =\n  | 'singleAction'\n  | 'scrollToBottom'\n  | 'scrollToTop'\n  | 'scrollToRight'\n  | 'scrollToLeft'\n  // Legacy aliases kept for backward compatibility\n  | 'once'\n  | 'untilBottom'\n  | 'untilTop'\n  | 'untilRight'\n  | 'untilLeft';\n\nexport type ActionScrollParam = {\n  direction?: 'down' | 'up' | 'right' | 'left';\n  scrollType?: ScrollType;\n  distance?: number | null;\n  locate?: LocateResultElement;\n};\n\nexport type ScrollParam = Omit<ActionScrollParam, 'locate'>;\n\nexport interface MidsceneYamlScript {\n  // @deprecated\n  target?: MidsceneYamlScriptWebEnv;\n\n  page?: MidsceneYamlScriptWebEnv;\n  browser?: MidsceneYamlScriptWebEnv;\n  web?: MidsceneYamlScriptWebEnv;\n  android?: MidsceneYamlScriptAndroidEnv;\n  ios?: MidsceneYamlScriptIOSEnv;\n  harmony?: MidsceneYamlScriptHarmonyEnv;\n  computer?: MidsceneYamlScriptComputerEnv;\n\n  interface?: MidsceneYamlScriptEnvGeneralInterface;\n  config?: MidsceneYamlScriptConfig;\n  agent?: MidsceneYamlScriptAgentOpt;\n\n  tasks: MidsceneYamlTask[];\n}\n\nexport interface MidsceneYamlTask {\n  name: string;\n  flow: MidsceneYamlFlowItem[];\n  continueOnError?: boolean;\n}\n\n/**\n * Agent configuration options that can be specified in YAML scripts.\n *\n * This type includes serializable fields from AgentOpt, excluding non-serializable\n * fields like functions and complex objects. All fields are optional.\n *\n * @remarks\n * - testId is deprecated; prefer reportFileName and cache.id\n * - These settings apply to all platforms (Web, Android, iOS, Generic Interface)\n * - modelConfig is configured through environment variables, not in YAML\n *\n * @example\n * ```yaml\n * agent:\n *   reportFileName: \"checkout-report\"\n *   groupName: \"E2E Test Suite\"\n *   generateReport: true\n *   replanningCycleLimit: 30\n *   cache:\n *     id: \"checkout-cache\"\n *     strategy: \"read-write\"\n * ```\n */\nexport type MidsceneYamlScriptAgentOpt = Pick<\n  AgentOpt,\n  | 'testId' // deprecated, kept for backward compatibility\n  | 'groupName'\n  | 'groupDescription'\n  | 'generateReport'\n  | 'outputFormat'\n  | 'persistExecutionDump'\n  | 'autoPrintReportMsg'\n  | 'reportFileName'\n  | 'replanningCycleLimit'\n  | 'aiContexts'\n  | 'aiActContext'\n  | 'aiActionContext'\n  | 'cache'\n  | 'screenshotShrinkFactor'\n>;\n\nexport interface MidsceneYamlScriptConfig {\n  output?: string;\n  unstableLogContent?: boolean | string;\n}\n\nexport interface MidsceneYamlScriptEnvGeneralInterface {\n  // this will work as `const {...} = import('...'); const interface = new ...(param)`\n  module: string;\n  export?: string;\n  param?: Record<string, any>;\n}\n\nexport interface MidsceneYamlScriptWebEnv\n  extends MidsceneYamlScriptConfig,\n    MidsceneYamlScriptAgentOpt {\n  mode?: 'page' | 'browser';\n\n  // for web only\n  serve?: string;\n  url: string;\n\n  // puppeteer only\n  userAgent?: string;\n  acceptInsecureCerts?: boolean;\n  viewportWidth?: number;\n  viewportHeight?: number;\n  deviceScaleFactor?: number;\n  waitForNetworkIdle?: {\n    timeout?: number;\n    continueOnNetworkIdleError?: boolean; // should continue if failed to wait for network idle, true for default\n  };\n  cookie?: string;\n\n  /**\n   * Extra HTTP headers sent with every request (Puppeteer only, not supported\n   * in bridge mode). Useful when the server validates custom request headers.\n   *\n   * Header values must be strings. Quote values that YAML would otherwise parse\n   * as a boolean or number (e.g. `true`, `false`, `123`), such as `\"true\"`.\n   *\n   * @example\n   * ```yaml\n   * web:\n   *   url: https://example.com\n   *   extraHTTPHeaders:\n   *     X-Custom-Token: my-token\n   *     Accept-Language: en-US\n   * ```\n   */\n  extraHTTPHeaders?: Record<string, string>;\n\n  forceSameTabNavigation?: boolean; // if limit the new tab to the current page, true for default in yaml script\n  autoFollowNewPage?: boolean; // if use BrowserAgent to follow newly opened pages, false for default\n\n  /**\n   * Chrome download directory (Puppeteer only, not supported in bridge mode).\n   *\n   * Relative paths are resolved from the current working directory.\n   *\n   * @example\n   * ```yaml\n   * web:\n   *   url: https://example.com\n   *   downloadPath: ./downloads\n   * ```\n   */\n  downloadPath?: string;\n\n  /**\n   * Custom Chrome launch arguments (Puppeteer only, not supported in bridge mode).\n   *\n   * Allows passing custom command-line arguments to Chrome/Chromium when launching the browser.\n   * This is useful for testing scenarios that require specific browser configurations.\n   *\n   * ⚠️ Security Warning: Some arguments (e.g., --no-sandbox, --disable-web-security) may\n   * reduce browser security. Use only in controlled testing environments.\n   *\n   * @example\n   * ```yaml\n   * web:\n   *   url: https://example.com\n   *   chromeArgs:\n   *     - '--disable-features=ThirdPartyCookiePhaseout'\n   *     - '--disable-features=SameSiteByDefaultCookies'\n   *     - '--window-size=1920,1080'\n   * ```\n   */\n  chromeArgs?: string[];\n\n  // bridge mode config\n  bridgeMode?: false | 'newTabWithUrl' | 'currentTab';\n  closeNewTabsAfterDisconnect?: boolean;\n\n  /**\n   * CDP (Chrome DevTools Protocol) endpoint URL.\n   * When specified, connects to an existing Chrome browser via CDP instead of launching a new one.\n   *\n   * @example\n   * ```yaml\n   * web:\n   *   url: https://example.com\n   *   cdpEndpoint: ws://localhost:9222/devtools/browser/xxxx\n   * ```\n   */\n  cdpEndpoint?: string;\n}\n\nexport interface MidsceneYamlScriptAndroidEnv\n  extends MidsceneYamlScriptConfig,\n    Omit<AndroidDeviceOpt, 'customActions'> {\n  // The Android device ID to connect to, optional, will use the first device if not specified\n  deviceId?: string;\n\n  // The URL or app package to launch, optional, will use the current screen if not specified\n  launch?: string;\n}\n\nexport interface MidsceneYamlScriptIOSEnv\n  extends MidsceneYamlScriptConfig,\n    Omit<IOSDeviceOpt, 'customActions'> {\n  // The URL or app bundle ID to launch, optional, will use the current screen if not specified\n  launch?: string;\n}\n\nexport interface MidsceneYamlScriptHarmonyEnv\n  extends MidsceneYamlScriptConfig,\n    Omit<HarmonyDeviceOpt, 'customActions'> {\n  // The HarmonyOS device ID to connect to, optional, will use the first device if not specified\n  deviceId?: string;\n\n  // The bundle name, bundle/Ability target, or mapped app name to launch, optional,\n  // will use the current screen if not specified\n  launch?: string;\n\n  // Custom mapping of app names to bundle names or explicit bundle/Ability targets;\n  // user-provided mappings take precedence over defaults\n  appNameMapping?: Record<string, string>;\n}\n\nexport interface MidsceneYamlScriptComputerEnv\n  extends MidsceneYamlScriptConfig {\n  // The display ID to use, optional, will use the primary display if not specified\n  displayId?: string;\n}\n\nexport type MidsceneYamlScriptEnv =\n  | MidsceneYamlScriptWebEnv\n  | MidsceneYamlScriptAndroidEnv\n  | MidsceneYamlScriptIOSEnv\n  | MidsceneYamlScriptHarmonyEnv\n  | MidsceneYamlScriptComputerEnv;\n\n/** Target sections that can be supplied as batch-wide YAML overrides. */\nexport type MidsceneYamlTargetKey = Exclude<\n  keyof MidsceneYamlScript,\n  'config' | 'agent' | 'tasks'\n>;\n\nconst midsceneYamlTargetKeyMap = {\n  target: true,\n  page: true,\n  browser: true,\n  web: true,\n  android: true,\n  ios: true,\n  harmony: true,\n  computer: true,\n  interface: true,\n} as const satisfies Record<MidsceneYamlTargetKey, true>;\n\nexport const midsceneYamlTargetKeys = Object.keys(\n  midsceneYamlTargetKeyMap,\n) as MidsceneYamlTargetKey[];\n\n/**\n * Partial target settings applied to every script in a YAML batch.\n *\n * Batch settings are deep-merged over each script's target section, so every\n * nested target field is optional here even when a standalone script requires\n * it.\n */\nexport type MidsceneYamlTargetConfig = {\n  [Target in MidsceneYamlTargetKey]?: Partial<\n    NonNullable<MidsceneYamlScript[Target]>\n  >;\n};\n\nexport interface MidsceneYamlFlowItemAIAction {\n  // defined as aiAction for backward compatibility\n  aiAction?: TUserPrompt | null;\n  ai?: TUserPrompt | null; // this is the shortcut for aiAct\n  aiAct?: TUserPrompt | null;\n  instruction?: TUserPrompt;\n  aiActionProgressTips?: string[];\n  cacheable?: boolean;\n  [key: string]: unknown;\n}\n\nexport interface MidsceneYamlFlowItemAIAssert extends ServiceExtractOption {\n  aiAssert: string;\n  errorMessage?: string;\n  name?: string;\n}\n\nexport interface MidsceneYamlFlowItemAIWaitFor extends ServiceExtractOption {\n  aiWaitFor: string;\n  timeout?: number;\n}\n\nexport interface MidsceneYamlFlowItemRunGherkinScenario {\n  runGherkinScenario: string;\n}\n\nexport interface MidsceneYamlFlowItemEvaluateJavaScript {\n  javascript: string;\n  name?: string;\n}\n\nexport interface MidsceneYamlFlowItemSleep {\n  sleep: number;\n}\n\nexport interface MidsceneYamlFlowItemLogScreenshot {\n  logScreenshot?: string; // optional, the title of the screenshot\n  recordToReport?: string; // preferred key for record title\n  content?: string;\n}\n\nexport type MidsceneYamlFlowItem =\n  | MidsceneYamlFlowItemAIAction\n  | MidsceneYamlFlowItemAIAssert\n  | MidsceneYamlFlowItemAIWaitFor\n  | MidsceneYamlFlowItemRunGherkinScenario\n  | MidsceneYamlFlowItemEvaluateJavaScript\n  | MidsceneYamlFlowItemSleep\n  | MidsceneYamlFlowItemLogScreenshot;\n\nexport interface FreeFn {\n  name: string;\n  fn: () => void | Promise<void>;\n}\n\nexport interface ScriptPlayerTaskStatus extends MidsceneYamlTask {\n  status: ScriptPlayerStatusValue;\n  currentStep?: number;\n  totalSteps: number;\n  error?: Error;\n}\n\nexport type ScriptPlayerStatusValue = 'init' | 'running' | 'done' | 'error';\n\n// Index YAML file types for batch execution\nexport interface MidsceneYamlConfig extends MidsceneYamlTargetConfig {\n  /** @deprecated Use `web`, `page`, or `browser` instead. */\n  target?: Partial<MidsceneYamlScriptWebEnv>;\n  concurrent?: number;\n  continueOnError?: boolean;\n  /**\n   * Number of times to retry the complete YAML file after an execution\n   * failure, including tasks that already passed. Defaults to 0 (no retry).\n   */\n  retry?: number;\n  summary?: string;\n  /**\n   * Share one BrowserContext across Puppeteer Web YAML files, with a separate\n   * Page per file. This is not supported by bridge mode or non-Web targets.\n   */\n  shareBrowserContext?: boolean;\n  /**\n   * A setup yaml file that runs before the main `files`. A setup failure aborts\n   * the whole batch and the main files are marked as not executed. Puppeteer\n   * Web setup requires `shareBrowserContext: true` to pass browser state to the\n   * main files. Other targets run setup without browser-context sharing.\n   */\n  setup?: string;\n  files: string[];\n  headed?: boolean;\n  keepWindow?: boolean;\n  dotenvOverride?: boolean;\n  dotenvDebug?: boolean;\n}\n\nexport interface MidsceneYamlConfigOutput {\n  format?: 'json';\n  path?: string;\n}\n\nexport type MidsceneYamlConfigResultType =\n  | 'success'\n  | 'failed'\n  | 'partialFailed'\n  | 'notExecuted';\n\nexport interface MidsceneYamlConfigAttempt {\n  attempt: number;\n  success: boolean;\n  output?: string | null;\n  report?: string | null;\n  error?: string;\n  duration?: number;\n  resultType?: MidsceneYamlConfigResultType;\n  /** Complete execution facts, persisted separately from the legacy summary. */\n  executionRecordPath?: string;\n  /** @internal Complete facts retained when the sidecar could not be published. */\n  executionRecordFallback?: WorkflowExecutionRecord;\n  /** @internal Infrastructure failures, separate from legacy execution status. */\n  publicationErrors?: readonly unknown[];\n  /** @internal Entry observation failed; action success remains unchanged. */\n  observerErrors?: readonly unknown[];\n  /** @internal Agent report generation or cleanup failed after execution. */\n  infrastructureErrors?: readonly unknown[];\n}\n\nexport interface MidsceneYamlConfigResult {\n  file: string;\n  success: boolean;\n  executed: boolean;\n  output?: string | null;\n  report?: string | null;\n  retryReport?: string | null;\n  attempts?: MidsceneYamlConfigAttempt[];\n  executionRecordPath?: string;\n  /** @internal Complete facts retained when the sidecar could not be published. */\n  executionRecordFallback?: WorkflowExecutionRecord;\n  /** @internal Infrastructure failures, separate from legacy execution status. */\n  publicationErrors?: readonly unknown[];\n  /** @internal Entry observation failed; action success remains unchanged. */\n  observerErrors?: readonly unknown[];\n  /** @internal Agent report generation or cleanup failed after execution. */\n  infrastructureErrors?: readonly unknown[];\n  error?: string;\n  duration?: number;\n  /**\n   * Type of result:\n   * - 'success': All tasks completed successfully\n   * - 'failed': Execution failed (player error)\n   * - 'partialFailed': Some tasks failed but execution continued (continueOnError)\n   * - 'notExecuted': Not executed due to previous failures\n   */\n  resultType?: MidsceneYamlConfigResultType;\n}\n"],"names":["midsceneYamlTargetKeyMap","midsceneYamlTargetKeys","Object"],"mappings":"AAySA,MAAMA,2BAA2B;IAC/B,QAAQ;IACR,MAAM;IACN,SAAS;IACT,KAAK;IACL,SAAS;IACT,KAAK;IACL,SAAS;IACT,UAAU;IACV,WAAW;AACb;AAEO,MAAMC,yBAAyBC,OAAO,IAAI,CAC/CF"}

package/dist/lib/agent/agent.js

@@ -41,10 +41,15 @@ const service_caller_index_js_namespaceObject = require("../ai-model/service-cal
 const external_constants_js_namespaceObject = require("../constants.js");
 const external_js_yaml_namespaceObject = require("js-yaml");
 var external_js_yaml_default = /*#__PURE__*/ __webpack_require__.n(external_js_yaml_namespaceObject);
+const html_utils_js_namespaceObject = require("../dump/html-utils.js");
 const external_screenshot_item_js_namespaceObject = require("../screenshot-item.js");
 const external_service_index_js_namespaceObject = require("../service/index.js");
 var external_service_index_js_default = /*#__PURE__*/ __webpack_require__.n(external_service_index_js_namespaceObject);
+const resource_operations_js_namespaceObject = require("../test-runner/engine/resource-operations.js");
+const agent_report_js_namespaceObject = require("../test-runner/reporting/agent-report.js");
+const execution_record_js_namespaceObject = require("../test-runner/reporting/execution-record.js");
 const external_types_js_namespaceObject = require("../types.js");
+const execution_session_js_namespaceObject = require("../yaml/execution-session.js");
 const external_report_generator_js_namespaceObject = require("../report-generator.js");
 const external_utils_js_namespaceObject = require("../utils.js");
 const external_yaml_index_js_namespaceObject = require("../yaml/index.js");
@@ -101,6 +106,60 @@ class Agent {
     static getTestRunnerNodeDefinitions() {
         return external_test_runner_nodes_js_namespaceObject.commonAgentTestRunnerNodeDefinitions;
     }
+    _prepareForTestRunner() {
+        this.reportGenerator.enableSourceSnapshots?.();
+    }
+    async _createReportSource(scopeId) {
+        return this.reportGenerator.createSourceSnapshot?.(scopeId);
+    }
+    async _writeYamlExecutionReport(record) {
+        const existingIndex = this.yamlExecutionRecords.findIndex((entry)=>entry.runId === record.runId);
+        const recordIndex = existingIndex < 0 ? this.yamlExecutionRecords.length : existingIndex;
+        this.yamlExecutionRecords[recordIndex] = record;
+        try {
+            const path = await this.reportGenerator.writeRunnerReport?.(this.buildYamlReportInput(), this.yamlReportScopeId, this.getReportMeta());
+            this.reportFile = path ?? this.reportFile;
+            return path;
+        } catch (error) {
+            this.yamlExecutionRecords[recordIndex] = Object.freeze({
+                ...record,
+                status: 'failed',
+                reportError: error
+            });
+            throw error;
+        }
+    }
+    buildYamlReportInput() {
+        const scopedRecords = this.yamlExecutionRecords.map((entry)=>({
+                ...entry,
+                ...entry.execution ? {
+                    execution: {
+                        document: {
+                            ...entry.execution.document,
+                            reportScopeId: this.yamlReportScopeId
+                        },
+                        cases: entry.execution.cases.map((outcome)=>({
+                                ...outcome,
+                                ...outcome.run ? {
+                                    run: {
+                                        ...outcome.run,
+                                        reportScopeId: this.yamlReportScopeId
+                                    }
+                                } : {},
+                                ...outcome.attempts ? {
+                                    attempts: outcome.attempts.map((attempt)=>({
+                                            ...attempt,
+                                            reportScopeId: this.yamlReportScopeId
+                                        }))
+                                } : {}
+                            }))
+                    }
+                } : {}
+            }));
+        return (0, execution_record_js_namespaceObject.executionRecordsToReportInput)(scopedRecords, {
+            runId: this.yamlReportScopeId
+        });
+    }
     get onDumpUpdate() {
         return this.dumpUpdateListeners[0];
     }
@@ -287,7 +346,21 @@ class Agent {
     }
     reportHTMLString(opt) {
         if (external_constants_js_namespaceObject.IS_REPORT_BUILD) return '';
-        return (0, external_utils_js_namespaceObject.reportHTMLContent)(this.dumpDataString(opt));
+        const dumpString = this.dumpDataString(opt);
+        if (!this.yamlExecutionRecords.length) return (0, external_utils_js_namespaceObject.reportHTMLContent)(dumpString);
+        const reportId = this.yamlReportScopeId;
+        const runnerDump = (0, agent_report_js_namespaceObject.buildAgentTestRunReportDump)(this.buildYamlReportInput(), this.dump, {
+            reportId,
+            scopeId: this.yamlReportScopeId,
+            sourcePath: this.reportFile ?? '<inline-agent-report>'
+        });
+        return `${(0, external_utils_js_namespaceObject.reportHTMLContent)({
+            dumpString,
+            attributes: {
+                'data-group-id': reportId,
+                'data-report-id': reportId
+            }
+        })}\n${(0, html_utils_js_namespaceObject.generateTestRunReportScriptTag)(runnerDump)}`;
     }
     writeOutActionDumps(executionDump) {
         const exec = executionDump || this.lastExecutionDump;
@@ -297,6 +370,11 @@ class Agent {
         }
         this.reportFile = this.reportGenerator.getReportPath();
     }
+    async flushReport() {
+        this.writeOutActionDumps();
+        await this.reportGenerator.flush();
+        return this.lastExecutionDump ? this.reportFile ?? void 0 : void 0;
+    }
     getReportMeta() {
         return {
             groupName: this.dump.groupName,
@@ -316,9 +394,12 @@ class Agent {
     }
     async callActionInActionSpace(type, opt) {
         debug('callActionInActionSpace', type, ',', opt);
+        const clonedActionParam = opt && 'object' == typeof opt && !Array.isArray(opt) ? {
+            ...opt
+        } : opt || {};
         const actionPlan = {
             type: type,
-            param: opt || {},
+            param: clonedActionParam,
             thought: ''
         };
         debug('actionPlan', actionPlan);
@@ -482,7 +563,7 @@ class Agent {
             const cachePrompt = (0, external_prompt_context_js_namespaceObject.buildPromptWithContext)(taskPrompt, aiActContext);
             const effort = (()=>{
                 const resolvedEffort = opt?.effort ?? (opt?.deepThink === true ? 'deepThink' : 'balance');
-                if (opt?.effort !== void 0) warn('The "effort" option is experimental and not yet open for public use. Do not use it. When both "effort" and "deepThink" are provided, "effort" takes precedence.');
+                if (opt?.effort !== void 0 && void 0 !== opt.deepThink) warn('When both "effort" and "deepThink" are provided, "effort" takes precedence.');
                 if ('fast' === resolvedEffort && 'custom' === planningModel.adapter.planning.kind) throw new Error(`The "fast" aiAct effort is not supported with custom planning adapters (modelFamily: ${planningModel.config.modelFamily ?? 'unknown'}).`);
                 if ('deepThink' === resolvedEffort && 'custom' === planningModel.adapter.planning.kind) {
                     warn(`The "deepThink" aiAct effort is not supported with custom planning adapters (modelFamily: ${planningModel.config.modelFamily ?? 'unknown'}). It will be ignored.`);
@@ -505,9 +586,20 @@ class Agent {
                 try {
                     await this.taskExecutor.loadYamlFlowAsPlanning(taskPrompt, yaml, internalReportDisplay);
                     debug('matched cache, will call .runYaml to run the action');
-                    await this.runYaml(yaml);
+                    await (0, execution_session_js_namespaceObject.runInYamlExecutionContext)(async ()=>{
+                        const replay = (0, execution_session_js_namespaceObject.enterYamlExecution)(this);
+                        const leaveAction = abortSignal ? (0, execution_session_js_namespaceObject.enterYamlAction)(this, abortSignal) : void 0;
+                        try {
+                            await this.runYaml(yaml);
+                        } finally{
+                            leaveAction?.();
+                            replay.finish();
+                        }
+                    });
                     return;
                 } catch (error) {
+                    if (error instanceof execution_session_js_namespaceObject.YamlExecutionOwnershipError) throw error;
+                    abortSignal?.throwIfAborted();
                     cachedYamlFailed = true;
                     warn(`cached aiAct plan failed, will replan and disable the stale cache: ${error instanceof Error ? error.message : String(error)}`);
                 }
@@ -635,6 +727,7 @@ class Agent {
         return this.aiAct(...args);
     }
     async runYaml(yamlScriptContent) {
+        if (this.destroyed) throw new Error('Cannot run YAML using a destroyed Agent.');
         const script = (0, external_yaml_index_js_namespaceObject.parseYamlScript)(yamlScriptContent, 'yaml');
         const player = new external_yaml_index_js_namespaceObject.ScriptPlayer(script, async ()=>({
                 agent: this,
@@ -686,6 +779,7 @@ class Agent {
     async destroy() {
         if (this.destroyed) return;
         this.destroyed = true;
+        await (0, resource_operations_js_namespaceObject.waitForResourceIdle)(this);
         for (const observer of this.ownedObservers)try {
             await observer.dispose();
         } catch (error) {
@@ -705,8 +799,9 @@ class Agent {
         this.resetDump();
         if (interfaceDestroyError) throw interfaceDestroyError;
     }
-    async sleep(ms) {
-        await this.taskExecutor.sleep(ms);
+    async sleep(ms, options) {
+        options?.abortSignal?.throwIfAborted();
+        await this.taskExecutor.sleep(ms, options?.abortSignal);
     }
     async recordToReport(title, opt) {
         const now = Date.now();
@@ -870,6 +965,8 @@ class Agent {
         _define_property(this, "dump", void 0);
         _define_property(this, "reportFile", void 0);
         _define_property(this, "reportFileName", void 0);
+        _define_property(this, "yamlReportScopeId", (0, utils_namespaceObject.uuid)());
+        _define_property(this, "yamlExecutionRecords", []);
         _define_property(this, "taskExecutor", void 0);
         _define_property(this, "opts", void 0);
         _define_property(this, "dryMode", false);