@donggui/core 1.5.9 → 1.5.11

package/dist/es/agent/agent.mjs

@@ -601,7 +601,8 @@ class Agent {
                 id,
                 enabled: !isWriteOnly,
                 readOnly: isReadOnly,
-                writeOnly: isWriteOnly
+                writeOnly: isWriteOnly,
+                cacheAdapter: cacheConfig.cacheAdapter
             };
         }
         return null;
@@ -664,7 +665,7 @@ class Agent {
         this.onTaskStartTip = this.opts.onTaskStartTip;
         this.service = new service(async ()=>this.getUIContext());
         const cacheConfigObj = this.processCacheConfig(opts || {});
-        if (cacheConfigObj) this.taskCache = new TaskCache(cacheConfigObj.id, cacheConfigObj.enabled, void 0, {
+        if (cacheConfigObj) this.taskCache = new TaskCache(cacheConfigObj.id, cacheConfigObj.enabled, cacheConfigObj.cacheAdapter, {
             readOnly: cacheConfigObj.readOnly,
             writeOnly: cacheConfigObj.writeOnly
         });

package/dist/es/agent/agent.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"agent/agent.mjs","sources":["../../../src/agent/agent.ts"],"sourcesContent":["import type { TUserPrompt } from '../ai-model/index';\nimport { ScreenshotItem } from '../screenshot-item';\nimport Service from '../service/index';\n// Import types and values directly from their source files to avoid circular dependency\n// DO NOT import from '../index' as it creates a circular dependency:\n// index.ts -> agent/index.ts -> agent/agent.ts -> index.ts\nimport {\n  type ActionParam,\n  type ActionReturn,\n  type AgentAssertOpt,\n  type AgentDescribeElementAtPointResult,\n  type AgentOpt,\n  type AgentWaitForOpt,\n  type CacheConfig,\n  type DeepThinkOption,\n  type DeviceAction,\n  ExecutionDump,\n  type ExecutionRecorderItem,\n  type ExecutionTask,\n  type ExecutionTaskLog,\n  GroupedActionDump,\n  type LocateOption,\n  type LocateResultElement,\n  type LocateValidatorResult,\n  type LocatorValidatorOption,\n  type OnTaskStartTip,\n  type PlanningAction,\n  type Rect,\n  type ScrollParam,\n  type ServiceAction,\n  type ServiceExtractOption,\n  type ServiceExtractParam,\n  type UIContext,\n} from '../types';\nimport type { MidsceneYamlScript } from '../yaml';\nexport type TestStatus =\n  | 'passed'\n  | 'failed'\n  | 'timedOut'\n  | 'skipped'\n  | 'interrupted';\nimport { isAutoGLM, isUITars } from '@/ai-model/auto-glm/util';\nimport yaml from 'js-yaml';\n\nimport type { IReportGenerator } from '@/report-generator';\nimport { ReportGenerator } from '@/report-generator';\nimport { getVersion, processCacheConfig, reportHTMLContent } from '@/utils';\nimport {\n  ScriptPlayer,\n  buildDetailedLocateParam,\n  parseYamlScript,\n} from '../yaml/index';\n\nimport { existsSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport type { AbstractInterface } from '@/device';\nimport type { TaskRunner } from '@/task-runner';\nimport {\n  type IModelConfig,\n  MIDSCENE_REPLANNING_CYCLE_LIMIT,\n  ModelConfigManager,\n  globalConfigManager,\n  globalModelConfigManager,\n} from '@midscene/shared/env';\nimport { getDebug } from '@midscene/shared/logger';\nimport { assert, ifInBrowser, uuid } from '@midscene/shared/utils';\nimport { defineActionSleep } from '../device';\nimport { TaskCache } from './task-cache';\nimport {\n  TaskExecutionError,\n  TaskExecutor,\n  locatePlanForLocate,\n  withFileChooser,\n} from './tasks';\nimport { locateParamStr, paramStr, taskTitleStr, typeStr } from './ui-utils';\nimport { commonContextParser, getReportFileName, parsePrompt } from './utils';\n\nconst debug = getDebug('agent');\n\nconst distanceOfTwoPoints = (p1: [number, number], p2: [number, number]) => {\n  const [x1, y1] = p1;\n  const [x2, y2] = p2;\n  return Math.round(Math.sqrt((x1 - x2) ** 2 + (y1 - y2) ** 2));\n};\n\nconst includedInRect = (point: [number, number], rect: Rect) => {\n  const [x, y] = point;\n  const { left, top, width, height } = rect;\n  return x >= left && x <= left + width && y >= top && y <= top + height;\n};\n\nconst defaultServiceExtractOption: ServiceExtractOption = {\n  domIncluded: false,\n  screenshotIncluded: true,\n};\n\ntype CacheStrategy = NonNullable<CacheConfig['strategy']>;\n\nconst CACHE_STRATEGIES: readonly CacheStrategy[] = [\n  'read-only',\n  'read-write',\n  'write-only',\n];\n\nconst isValidCacheStrategy = (strategy: string): strategy is CacheStrategy =>\n  CACHE_STRATEGIES.some((value) => value === strategy);\n\nconst CACHE_STRATEGY_VALUES = CACHE_STRATEGIES.map(\n  (value) => `\"${value}\"`,\n).join(', ');\n\nconst legacyScrollTypeMap = {\n  once: 'singleAction',\n  untilBottom: 'scrollToBottom',\n  untilTop: 'scrollToTop',\n  untilRight: 'scrollToRight',\n  untilLeft: 'scrollToLeft',\n} as const;\n\ntype LegacyScrollType = keyof typeof legacyScrollTypeMap;\n\nconst normalizeScrollType = (\n  scrollType: ScrollParam['scrollType'] | LegacyScrollType | undefined,\n): ScrollParam['scrollType'] | undefined => {\n  if (!scrollType) {\n    return scrollType;\n  }\n\n  if (scrollType in legacyScrollTypeMap) {\n    return legacyScrollTypeMap[scrollType as LegacyScrollType];\n  }\n\n  return scrollType as ScrollParam['scrollType'];\n};\n\nconst defaultReplanningCycleLimit = 20;\nconst defaultVlmUiTarsReplanningCycleLimit = 40;\nconst defaultAutoGlmReplanningCycleLimit = 100;\n\nexport type AiActOptions = {\n  cacheable?: boolean;\n  fileChooserAccept?: string | string[];\n  deepThink?: DeepThinkOption;\n  deepLocate?: boolean;\n  abortSignal?: AbortSignal;\n};\n\nexport class Agent<\n  InterfaceType extends AbstractInterface = AbstractInterface,\n> {\n  interface: InterfaceType;\n\n  service: Service;\n\n  dump: GroupedActionDump;\n\n  reportFile?: string | null;\n\n  reportFileName?: string;\n\n  taskExecutor: TaskExecutor;\n\n  opts: AgentOpt;\n\n  /**\n   * If true, the agent will not perform any actions\n   */\n  dryMode = false;\n\n  onTaskStartTip?: OnTaskStartTip;\n\n  taskCache?: TaskCache;\n\n  private dumpUpdateListeners: Array<\n    (dump: string, executionDump?: ExecutionDump) => void\n  > = [];\n\n  get onDumpUpdate():\n    | ((dump: string, executionDump?: ExecutionDump) => void)\n    | undefined {\n    return this.dumpUpdateListeners[0];\n  }\n\n  set onDumpUpdate(callback:\n    | ((dump: string, executionDump?: ExecutionDump) => void)\n    | undefined) {\n    // Clear existing listeners\n    this.dumpUpdateListeners = [];\n    // Add callback to array if provided\n    if (callback) {\n      this.dumpUpdateListeners.push(callback);\n    }\n  }\n\n  destroyed = false;\n\n  modelConfigManager: ModelConfigManager;\n\n  /**\n   * Frozen page context for consistent AI operations\n   */\n  private frozenUIContext?: UIContext;\n\n  private get aiActContext(): string | undefined {\n    return this.opts.aiActContext ?? this.opts.aiActionContext;\n  }\n\n  /**\n   * Flag to track if VL model warning has been shown\n   */\n  private hasWarnedNonVLModel = false;\n\n  private executionDumpIndexByRunner = new WeakMap<TaskRunner, number>();\n\n  private fullActionSpace: DeviceAction[];\n\n  private reportGenerator: IReportGenerator;\n\n  // @deprecated use .interface instead\n  get page() {\n    return this.interface;\n  }\n\n  /**\n   * Ensures VL model warning is shown once when needed\n   */\n  private ensureVLModelWarning() {\n    if (\n      !this.hasWarnedNonVLModel &&\n      this.interface.interfaceType !== 'puppeteer' &&\n      this.interface.interfaceType !== 'playwright' &&\n      this.interface.interfaceType !== 'static' &&\n      this.interface.interfaceType !== 'chrome-extension-proxy' &&\n      this.interface.interfaceType !== 'page-over-chrome-extension-bridge'\n    ) {\n      this.modelConfigManager.throwErrorIfNonVLModel();\n      this.hasWarnedNonVLModel = true;\n    }\n  }\n\n  private resolveReplanningCycleLimit(\n    modelConfigForPlanning: IModelConfig,\n  ): number {\n    if (this.opts.replanningCycleLimit !== undefined) {\n      return this.opts.replanningCycleLimit;\n    }\n\n    return isUITars(modelConfigForPlanning.modelFamily)\n      ? defaultVlmUiTarsReplanningCycleLimit\n      : isAutoGLM(modelConfigForPlanning.modelFamily)\n        ? defaultAutoGlmReplanningCycleLimit\n        : defaultReplanningCycleLimit;\n  }\n\n  constructor(interfaceInstance: InterfaceType, opts?: AgentOpt) {\n    this.interface = interfaceInstance;\n\n    const envReplanningCycleLimit =\n      globalConfigManager.getEnvConfigValueAsNumber(\n        MIDSCENE_REPLANNING_CYCLE_LIMIT,\n      );\n\n    this.opts = Object.assign(\n      {\n        generateReport: true,\n        autoPrintReportMsg: true,\n        groupName: 'Midscene Report',\n        groupDescription: '',\n      },\n      opts || {},\n      opts?.replanningCycleLimit === undefined &&\n        envReplanningCycleLimit !== undefined &&\n        !Number.isNaN(envReplanningCycleLimit)\n        ? { replanningCycleLimit: envReplanningCycleLimit }\n        : {},\n    );\n\n    const resolvedAiActContext =\n      this.opts.aiActContext ?? this.opts.aiActionContext;\n    if (resolvedAiActContext !== undefined) {\n      this.opts.aiActContext = resolvedAiActContext;\n      this.opts.aiActionContext ??= resolvedAiActContext;\n    }\n\n    if (\n      opts?.modelConfig &&\n      (typeof opts?.modelConfig !== 'object' || Array.isArray(opts.modelConfig))\n    ) {\n      throw new Error(\n        `opts.modelConfig must be a plain object map of env keys to values, but got ${typeof opts?.modelConfig}`,\n      );\n    }\n    // Create ModelConfigManager if modelConfig or createOpenAIClient is provided\n    // Otherwise, use the global config manager\n    const hasCustomConfig = opts?.modelConfig || opts?.createOpenAIClient;\n    this.modelConfigManager = hasCustomConfig\n      ? new ModelConfigManager(opts?.modelConfig, opts?.createOpenAIClient)\n      : globalModelConfigManager;\n\n    this.onTaskStartTip = this.opts.onTaskStartTip;\n\n    this.service = new Service(async () => {\n      return this.getUIContext();\n    });\n\n    // Process cache configuration\n    const cacheConfigObj = this.processCacheConfig(opts || {});\n    if (cacheConfigObj) {\n      this.taskCache = new TaskCache(\n        cacheConfigObj.id,\n        cacheConfigObj.enabled,\n        undefined, // cacheFilePath\n        {\n          readOnly: cacheConfigObj.readOnly,\n          writeOnly: cacheConfigObj.writeOnly,\n        },\n      );\n    }\n\n    const baseActionSpace = this.interface.actionSpace();\n    this.fullActionSpace = [...baseActionSpace, defineActionSleep()];\n\n    this.taskExecutor = new TaskExecutor(this.interface, this.service, {\n      taskCache: this.taskCache,\n      onTaskStart: this.callbackOnTaskStartTip.bind(this),\n      replanningCycleLimit: this.opts.replanningCycleLimit,\n      waitAfterAction: this.opts.waitAfterAction,\n      useDeviceTimestamp: this.opts.useDeviceTimestamp,\n      actionSpace: this.fullActionSpace,\n      hooks: {\n        onTaskUpdate: (runner) => {\n          const executionDump = runner.dump();\n          this.appendExecutionDump(executionDump, runner);\n\n          // Call all registered dump update listeners\n          const dumpString = this.dumpDataString();\n          for (const listener of this.dumpUpdateListeners) {\n            try {\n              listener(dumpString, executionDump);\n            } catch (error) {\n              console.error('Error in onDumpUpdate listener', error);\n            }\n          }\n\n          // Fire and forget - don't block task execution\n          this.writeOutActionDumps();\n        },\n      },\n    });\n    this.dump = this.resetDump();\n    this.reportFileName =\n      opts?.reportFileName ||\n      getReportFileName(opts?.testId || this.interface.interfaceType || 'web');\n\n    this.reportGenerator = ReportGenerator.create(this.reportFileName!, {\n      generateReport: this.opts.generateReport,\n      outputFormat: this.opts.outputFormat,\n      autoPrintReportMsg: this.opts.autoPrintReportMsg,\n    });\n  }\n\n  async getActionSpace(): Promise<DeviceAction[]> {\n    return this.fullActionSpace;\n  }\n\n  async getUIContext(action?: ServiceAction): Promise<UIContext> {\n    // Check VL model configuration when UI context is first needed\n    this.ensureVLModelWarning();\n\n    // If page context is frozen, return the frozen context for all actions\n    if (this.frozenUIContext) {\n      debug('Using frozen page context for action:', action);\n      return this.frozenUIContext;\n    }\n\n    // Get original context\n    const context = await commonContextParser(this.interface, {\n      uploadServerUrl: this.modelConfigManager.getUploadTestServerUrl(),\n      screenshotShrinkFactor: this.opts.screenshotShrinkFactor,\n    });\n\n    return context;\n  }\n\n  async _snapshotContext(): Promise<UIContext> {\n    return await this.getUIContext('locate');\n  }\n\n  /**\n   * @deprecated Use {@link setAIActContext} instead.\n   */\n  async setAIActionContext(prompt: string) {\n    await this.setAIActContext(prompt);\n  }\n\n  async setAIActContext(prompt: string) {\n    if (this.aiActContext) {\n      console.warn(\n        'aiActContext is already set, and it is called again, will override the previous setting',\n      );\n    }\n    this.opts.aiActContext = prompt;\n    this.opts.aiActionContext = prompt;\n  }\n\n  resetDump() {\n    this.dump = new GroupedActionDump({\n      sdkVersion: getVersion(),\n      groupName: this.opts.groupName!,\n      groupDescription: this.opts.groupDescription,\n      executions: [],\n      modelBriefs: [],\n      deviceType: this.interface.interfaceType,\n    });\n    this.executionDumpIndexByRunner = new WeakMap<TaskRunner, number>();\n\n    return this.dump;\n  }\n\n  appendExecutionDump(execution: ExecutionDump, runner?: TaskRunner) {\n    const currentDump = this.dump;\n    if (runner) {\n      const existingIndex = this.executionDumpIndexByRunner.get(runner);\n      if (existingIndex !== undefined) {\n        currentDump.executions[existingIndex] = execution;\n        return;\n      }\n      currentDump.executions.push(execution);\n      this.executionDumpIndexByRunner.set(\n        runner,\n        currentDump.executions.length - 1,\n      );\n      return;\n    }\n    currentDump.executions.push(execution);\n  }\n\n  dumpDataString(opt?: { inlineScreenshots?: boolean }) {\n    // update dump info\n    this.dump.groupName = this.opts.groupName!;\n    this.dump.groupDescription = this.opts.groupDescription;\n    // In browser environment, use inline screenshots since file system is not available\n    if (ifInBrowser || opt?.inlineScreenshots) {\n      return this.dump.serializeWithInlineScreenshots();\n    }\n    return this.dump.serialize();\n  }\n\n  reportHTMLString(opt?: { inlineScreenshots?: boolean }) {\n    // dumpDataString() handles browser environment with inline screenshots\n    return reportHTMLContent(this.dumpDataString(opt));\n  }\n\n  writeOutActionDumps() {\n    this.reportGenerator.onDumpUpdate(this.dump);\n    this.reportFile = this.reportGenerator.getReportPath();\n  }\n\n  private async callbackOnTaskStartTip(task: ExecutionTask) {\n    const param = paramStr(task);\n    const tip = param ? `${typeStr(task)} - ${param}` : typeStr(task);\n\n    if (this.onTaskStartTip) {\n      await this.onTaskStartTip(tip);\n    }\n  }\n\n  wrapActionInActionSpace<T extends DeviceAction>(\n    name: string,\n  ): (param: ActionParam<T>) => Promise<ActionReturn<T>> {\n    return async (param: ActionParam<T>) => {\n      return await this.callActionInActionSpace<ActionReturn<T>>(name, param);\n    };\n  }\n\n  async callActionInActionSpace<T = any>(\n    type: string,\n    opt?: T, // and all other action params\n  ) {\n    debug('callActionInActionSpace', type, ',', opt);\n\n    const actionPlan: PlanningAction<T> = {\n      type: type as any,\n      param: (opt as any) || {},\n      thought: '',\n    };\n    debug('actionPlan', actionPlan); // , ', in which the locateParam is', locateParam);\n\n    const plans: PlanningAction[] = [actionPlan].filter(\n      Boolean,\n    ) as PlanningAction[];\n\n    const title = taskTitleStr(\n      type as any,\n      locateParamStr((opt as any)?.locate || {}),\n    );\n\n    // assume all operation in action space is related to locating\n    const defaultIntentModelConfig =\n      this.modelConfigManager.getModelConfig('default');\n    const modelConfigForPlanning =\n      this.modelConfigManager.getModelConfig('planning');\n\n    const { output } = await this.taskExecutor.runPlans(\n      title,\n      plans,\n      modelConfigForPlanning,\n      defaultIntentModelConfig,\n    );\n    return output;\n  }\n\n  async aiTap(\n    locatePrompt: TUserPrompt,\n    opt?: LocateOption & { fileChooserAccept?: string | string[] },\n  ) {\n    assert(locatePrompt, 'missing locate prompt for tap');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    const fileChooserAccept = opt?.fileChooserAccept\n      ? this.normalizeFileInput(opt.fileChooserAccept)\n      : undefined;\n\n    return withFileChooser(this.interface, fileChooserAccept, async () => {\n      return this.callActionInActionSpace('Tap', {\n        locate: detailedLocateParam,\n      });\n    });\n  }\n\n  async aiRightClick(locatePrompt: TUserPrompt, opt?: LocateOption) {\n    assert(locatePrompt, 'missing locate prompt for right click');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    return this.callActionInActionSpace('RightClick', {\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiDoubleClick(locatePrompt: TUserPrompt, opt?: LocateOption) {\n    assert(locatePrompt, 'missing locate prompt for double click');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    return this.callActionInActionSpace('DoubleClick', {\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiHover(locatePrompt: TUserPrompt, opt?: LocateOption) {\n    assert(locatePrompt, 'missing locate prompt for hover');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    return this.callActionInActionSpace('Hover', {\n      locate: detailedLocateParam,\n    });\n  }\n\n  // New signature, always use locatePrompt as the first param\n  async aiInput(\n    locatePrompt: TUserPrompt,\n    opt: LocateOption & { value: string | number } & {\n      autoDismissKeyboard?: boolean;\n    } & { mode?: 'replace' | 'clear' | 'typeOnly' | 'append' },\n  ): Promise<any>;\n\n  // Legacy signature - deprecated\n  /**\n   * @deprecated Use aiInput(locatePrompt, opt) instead where opt contains the value\n   */\n  async aiInput(\n    value: string | number,\n    locatePrompt: TUserPrompt,\n    opt?: LocateOption & { autoDismissKeyboard?: boolean } & {\n      mode?: 'replace' | 'clear' | 'typeOnly' | 'append';\n    }, // AndroidDeviceInputOpt &\n  ): Promise<any>;\n\n  // Implementation\n  async aiInput(\n    locatePromptOrValue: TUserPrompt | string | number,\n    locatePromptOrOpt:\n      | TUserPrompt\n      | (LocateOption & { value: string | number } & {\n          autoDismissKeyboard?: boolean;\n        } & { mode?: 'replace' | 'clear' | 'typeOnly' | 'append' }) // AndroidDeviceInputOpt &\n      | undefined,\n    optOrUndefined?: LocateOption, // AndroidDeviceInputOpt &\n  ) {\n    let value: string | number;\n    let locatePrompt: TUserPrompt;\n    let opt:\n      | (LocateOption & { value: string | number } & {\n          autoDismissKeyboard?: boolean;\n        } & { mode?: 'replace' | 'clear' | 'typeOnly' | 'append' }) // AndroidDeviceInputOpt &\n      | undefined;\n\n    // Check if using new signature (first param is locatePrompt, second has value)\n    if (\n      typeof locatePromptOrOpt === 'object' &&\n      locatePromptOrOpt !== null &&\n      'value' in locatePromptOrOpt\n    ) {\n      // New signature: aiInput(locatePrompt, opt)\n      locatePrompt = locatePromptOrValue as TUserPrompt;\n      const optWithValue = locatePromptOrOpt as LocateOption & {\n        // AndroidDeviceInputOpt &\n        value: string | number;\n        autoDismissKeyboard?: boolean;\n      };\n      value = optWithValue.value;\n      opt = optWithValue;\n    } else {\n      // Legacy signature: aiInput(value, locatePrompt, opt)\n      value = locatePromptOrValue as string | number;\n      locatePrompt = locatePromptOrOpt as TUserPrompt;\n      opt = {\n        ...optOrUndefined,\n        value,\n      };\n    }\n\n    assert(\n      typeof value === 'string' || typeof value === 'number',\n      'input value must be a string or number, use empty string if you want to clear the input',\n    );\n    assert(locatePrompt, 'missing locate prompt for input');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    // Convert value to string to ensure consistency\n    const stringValue = typeof value === 'number' ? String(value) : value;\n\n    // backward compat: convert deprecated 'append' to 'typeOnly'\n    const mode = opt?.mode === 'append' ? 'typeOnly' : opt?.mode;\n\n    return this.callActionInActionSpace('Input', {\n      ...(opt || {}),\n      value: stringValue,\n      locate: detailedLocateParam,\n      mode,\n    });\n  }\n\n  // New signature\n  async aiKeyboardPress(\n    locatePrompt: TUserPrompt,\n    opt: LocateOption & { keyName: string },\n  ): Promise<any>;\n\n  // Legacy signature - deprecated\n  /**\n   * @deprecated Use aiKeyboardPress(locatePrompt, opt) instead where opt contains the keyName\n   */\n  async aiKeyboardPress(\n    keyName: string,\n    locatePrompt?: TUserPrompt,\n    opt?: LocateOption,\n  ): Promise<any>;\n\n  // Implementation\n  async aiKeyboardPress(\n    locatePromptOrKeyName: TUserPrompt | string,\n    locatePromptOrOpt:\n      | TUserPrompt\n      | (LocateOption & { keyName: string })\n      | undefined,\n    optOrUndefined?: LocateOption,\n  ) {\n    let keyName: string;\n    let locatePrompt: TUserPrompt | undefined;\n    let opt: (LocateOption & { keyName: string }) | undefined;\n\n    // Check if using new signature (first param is locatePrompt, second has keyName)\n    if (\n      typeof locatePromptOrOpt === 'object' &&\n      locatePromptOrOpt !== null &&\n      'keyName' in locatePromptOrOpt\n    ) {\n      // New signature: aiKeyboardPress(locatePrompt, opt)\n      locatePrompt = locatePromptOrKeyName as TUserPrompt;\n      opt = locatePromptOrOpt as LocateOption & {\n        keyName: string;\n      };\n    } else {\n      // Legacy signature: aiKeyboardPress(keyName, locatePrompt, opt)\n      keyName = locatePromptOrKeyName as string;\n      locatePrompt = locatePromptOrOpt as TUserPrompt | undefined;\n      opt = {\n        ...(optOrUndefined || {}),\n        keyName,\n      };\n    }\n\n    assert(opt?.keyName, 'missing keyName for keyboard press');\n\n    const detailedLocateParam = locatePrompt\n      ? buildDetailedLocateParam(locatePrompt, opt)\n      : undefined;\n\n    return this.callActionInActionSpace('KeyboardPress', {\n      ...(opt || {}),\n      locate: detailedLocateParam,\n    });\n  }\n\n  // New signature\n  async aiScroll(\n    locatePrompt: TUserPrompt | undefined,\n    opt: LocateOption & ScrollParam,\n  ): Promise<any>;\n\n  // Legacy signature - deprecated\n  /**\n   * @deprecated Use aiScroll(locatePrompt, opt) instead where opt contains the scroll parameters\n   */\n  async aiScroll(\n    scrollParam: ScrollParam,\n    locatePrompt?: TUserPrompt,\n    opt?: LocateOption,\n  ): Promise<any>;\n\n  // Implementation\n  async aiScroll(\n    locatePromptOrScrollParam: TUserPrompt | ScrollParam | undefined,\n    locatePromptOrOpt: TUserPrompt | (LocateOption & ScrollParam) | undefined,\n    optOrUndefined?: LocateOption,\n  ) {\n    let scrollParam: ScrollParam;\n    let locatePrompt: TUserPrompt | undefined;\n    let opt: LocateOption | undefined;\n\n    // Check if using new signature (first param is locatePrompt, second has scroll params)\n    if (\n      typeof locatePromptOrOpt === 'object' &&\n      ('direction' in locatePromptOrOpt ||\n        'scrollType' in locatePromptOrOpt ||\n        'distance' in locatePromptOrOpt)\n    ) {\n      // New signature: aiScroll(locatePrompt, opt)\n      locatePrompt = locatePromptOrScrollParam as TUserPrompt;\n      opt = locatePromptOrOpt as LocateOption & ScrollParam;\n    } else {\n      // Legacy signature: aiScroll(scrollParam, locatePrompt, opt)\n      scrollParam = locatePromptOrScrollParam as ScrollParam;\n      locatePrompt = locatePromptOrOpt as TUserPrompt | undefined;\n      opt = {\n        ...(optOrUndefined || {}),\n        ...(scrollParam || {}),\n      };\n    }\n\n    if (opt) {\n      const normalizedScrollType = normalizeScrollType(\n        (opt as ScrollParam).scrollType as\n          | ScrollParam['scrollType']\n          | LegacyScrollType\n          | undefined,\n      );\n\n      if (normalizedScrollType !== (opt as ScrollParam).scrollType) {\n        (opt as ScrollParam) = {\n          ...(opt || {}),\n          scrollType: normalizedScrollType as ScrollParam['scrollType'],\n        };\n      }\n    }\n\n    const detailedLocateParam = buildDetailedLocateParam(\n      locatePrompt || '',\n      opt,\n    );\n\n    return this.callActionInActionSpace('Scroll', {\n      ...(opt || {}),\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiAct(\n    taskPrompt: string,\n    opt?: AiActOptions,\n  ): Promise<string | undefined> {\n    const fileChooserAccept = opt?.fileChooserAccept\n      ? this.normalizeFileInput(opt.fileChooserAccept)\n      : undefined;\n\n    const abortSignal = opt?.abortSignal;\n    if (abortSignal?.aborted) {\n      throw new Error(\n        `aiAct aborted: ${abortSignal.reason || 'signal already aborted'}`,\n      );\n    }\n\n    const runAiAct = async () => {\n      const modelConfigForPlanning =\n        this.modelConfigManager.getModelConfig('planning');\n      const defaultIntentModelConfig =\n        this.modelConfigManager.getModelConfig('default');\n      const deepThink = opt?.deepThink === 'unset' ? undefined : opt?.deepThink;\n\n      const deepLocate = opt?.deepLocate;\n\n      const noIndividualLocateModel =\n        modelConfigForPlanning.modelName ===\n          defaultIntentModelConfig.modelName &&\n        modelConfigForPlanning.openaiBaseURL ===\n          defaultIntentModelConfig.openaiBaseURL;\n\n      const includeBboxInPlanning =\n        !deepThink && noIndividualLocateModel && !deepLocate;\n\n      debug('setting includeBboxInPlanning to', includeBboxInPlanning, {\n        deepThink,\n        noIndividualLocateModel,\n        deepLocate,\n      });\n\n      if (deepLocate && includeBboxInPlanning) {\n        console.warn(\n          'deepLocate option is ignored when includeBboxInPlanning is true (same model for planning and default intent without deepThink). Locate is already done during planning.',\n        );\n      }\n\n      const cacheable = opt?.cacheable;\n      const replanningCycleLimit = this.resolveReplanningCycleLimit(\n        modelConfigForPlanning,\n      );\n      // if vlm-ui-tars or auto-glm, plan cache is not used\n      const isVlmUiTars = isUITars(modelConfigForPlanning.modelFamily);\n      const isAutoGlm = isAutoGLM(modelConfigForPlanning.modelFamily);\n      const matchedCache =\n        isVlmUiTars || isAutoGlm || cacheable === false\n          ? undefined\n          : await this.taskCache?.matchPlanCache(taskPrompt);\n      if (\n        matchedCache &&\n        this.taskCache?.isCacheResultUsed &&\n        matchedCache.cacheContent?.yamlWorkflow?.trim()\n      ) {\n        // log into report file\n        await this.taskExecutor.loadYamlFlowAsPlanning(\n          taskPrompt,\n          matchedCache.cacheContent.yamlWorkflow,\n        );\n\n        debug('matched cache, will call .runYaml to run the action');\n        const yaml = matchedCache.cacheContent.yamlWorkflow;\n        await this.runYaml(yaml);\n        return;\n      }\n\n      // If cache matched but yamlWorkflow is empty, fall through to normal execution\n      const imagesIncludeCount: number = deepThink ? 2 : 1;\n      const { output: actionOutput } = await this.taskExecutor.action(\n        taskPrompt,\n        modelConfigForPlanning,\n        defaultIntentModelConfig,\n        includeBboxInPlanning,\n        this.aiActContext,\n        cacheable,\n        replanningCycleLimit,\n        imagesIncludeCount,\n        deepThink,\n        fileChooserAccept,\n        includeBboxInPlanning ? undefined : deepLocate,\n        abortSignal,\n      );\n\n      // update cache\n      if (this.taskCache && actionOutput?.yamlFlow && cacheable !== false) {\n        const yamlContent: MidsceneYamlScript = {\n          tasks: [\n            {\n              name: taskPrompt,\n              flow: actionOutput.yamlFlow,\n            },\n          ],\n        };\n        const yamlFlowStr = yaml.dump(yamlContent);\n        this.taskCache.updateOrAppendCacheRecord(\n          {\n            type: 'plan',\n            prompt: taskPrompt,\n            yamlWorkflow: yamlFlowStr,\n          },\n          matchedCache,\n        );\n      }\n\n      return actionOutput?.output;\n    };\n\n    return await runAiAct();\n  }\n\n  /**\n   * @deprecated Use {@link Agent.aiAct} instead.\n   */\n  async aiAction(taskPrompt: string, opt?: AiActOptions) {\n    return this.aiAct(taskPrompt, opt);\n  }\n\n  async aiQuery<ReturnType = any>(\n    demand: ServiceExtractParam,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<ReturnType> {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'Query',\n      demand,\n      modelConfig,\n      opt,\n    );\n    return output as ReturnType;\n  }\n\n  async aiBoolean(\n    prompt: TUserPrompt,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<boolean> {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'Boolean',\n      textPrompt,\n      modelConfig,\n      opt,\n      multimodalPrompt,\n    );\n    return output as boolean;\n  }\n\n  async aiNumber(\n    prompt: TUserPrompt,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<number> {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'Number',\n      textPrompt,\n      modelConfig,\n      opt,\n      multimodalPrompt,\n    );\n    return output as number;\n  }\n\n  async aiString(\n    prompt: TUserPrompt,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<string> {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'String',\n      textPrompt,\n      modelConfig,\n      opt,\n      multimodalPrompt,\n    );\n    return output as string;\n  }\n\n  async aiAsk(\n    prompt: TUserPrompt,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<string> {\n    return this.aiString(prompt, opt);\n  }\n\n  async describeElementAtPoint(\n    center: [number, number],\n    opt?: {\n      verifyPrompt?: boolean;\n      retryLimit?: number;\n      deepLocate?: boolean;\n    } & LocatorValidatorOption,\n  ): Promise<AgentDescribeElementAtPointResult> {\n    const { verifyPrompt = true, retryLimit = 3 } = opt || {};\n\n    let success = false;\n    let retryCount = 0;\n    let resultPrompt = '';\n    let deepLocate = opt?.deepLocate || false;\n    let verifyResult: LocateValidatorResult | undefined;\n\n    while (!success && retryCount < retryLimit) {\n      if (retryCount >= 2) {\n        deepLocate = true;\n      }\n      debug(\n        'aiDescribe',\n        center,\n        'verifyPrompt',\n        verifyPrompt,\n        'retryCount',\n        retryCount,\n        'deepLocate',\n        deepLocate,\n      );\n      // use same intent as aiLocate\n      const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n      const text = await this.service.describe(center, modelConfig, {\n        deepLocate,\n      });\n      debug('aiDescribe text', text);\n      assert(text.description, `failed to describe element at [${center}]`);\n      resultPrompt = text.description;\n\n      // Don't pass deepLocate to verification locate — the description was generated\n      // from a cropped view (deepLocate describe), but verification should use regular\n      // locate on the full screenshot to confirm the description works universally.\n      // Passing deepLocate here would trigger AiLocateSection with an element-level\n      // description as a section prompt, which is semantically incorrect.\n      verifyResult = await this.verifyLocator(\n        resultPrompt,\n        undefined,\n        center,\n        opt,\n      );\n      if (verifyResult.pass) {\n        success = true;\n      } else {\n        retryCount++;\n      }\n    }\n\n    return {\n      prompt: resultPrompt,\n      deepLocate,\n      verifyResult,\n    };\n  }\n\n  async verifyLocator(\n    prompt: string,\n    locateOpt: LocateOption | undefined,\n    expectCenter: [number, number],\n    verifyLocateOption?: LocatorValidatorOption,\n  ): Promise<LocateValidatorResult> {\n    debug('verifyLocator', prompt, locateOpt, expectCenter, verifyLocateOption);\n\n    const { center: verifyCenter, rect: verifyRect } = await this.aiLocate(\n      prompt,\n      locateOpt,\n    );\n    const distance = distanceOfTwoPoints(expectCenter, verifyCenter);\n    const included = includedInRect(expectCenter, verifyRect);\n    const pass =\n      distance <= (verifyLocateOption?.centerDistanceThreshold || 20) ||\n      included;\n    const verifyResult = {\n      pass,\n      rect: verifyRect,\n      center: verifyCenter,\n      centerDistance: distance,\n    };\n    debug('aiDescribe verifyResult', verifyResult);\n    return verifyResult;\n  }\n\n  async aiLocate(prompt: TUserPrompt, opt?: LocateOption) {\n    const locateParam = buildDetailedLocateParam(prompt, opt);\n    assert(locateParam, 'cannot get locate param for aiLocate');\n    const locatePlan = locatePlanForLocate(locateParam);\n    const plans = [locatePlan];\n    const defaultIntentModelConfig =\n      this.modelConfigManager.getModelConfig('default');\n    const modelConfigForPlanning =\n      this.modelConfigManager.getModelConfig('planning');\n\n    const { output } = await this.taskExecutor.runPlans(\n      taskTitleStr('Locate', locateParamStr(locateParam)),\n      plans,\n      modelConfigForPlanning,\n      defaultIntentModelConfig,\n    );\n\n    const { element } = output;\n\n    return {\n      rect: element?.rect,\n      center: element?.center,\n      dpr: element?.dpr,\n    } as Pick<LocateResultElement, 'rect' | 'center'>;\n  }\n\n  async aiAssert(\n    assertion: TUserPrompt,\n    msg?: string,\n    opt?: AgentAssertOpt & ServiceExtractOption,\n  ) {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n    const serviceOpt: ServiceExtractOption = {\n      domIncluded: opt?.domIncluded ?? defaultServiceExtractOption.domIncluded,\n      screenshotIncluded:\n        opt?.screenshotIncluded ??\n        defaultServiceExtractOption.screenshotIncluded,\n    };\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(assertion);\n    const assertionText =\n      typeof assertion === 'string' ? assertion : assertion.prompt;\n\n    try {\n      const { output, thought } =\n        await this.taskExecutor.createTypeQueryExecution<boolean>(\n          'Assert',\n          textPrompt,\n          modelConfig,\n          serviceOpt,\n          multimodalPrompt,\n        );\n\n      const pass = Boolean(output);\n      const message = pass\n        ? undefined\n        : `Assertion failed: ${msg || assertionText}\\nReason: ${thought || '(no_reason)'}`;\n\n      if (opt?.keepRawResponse) {\n        return {\n          pass,\n          thought,\n          message,\n        };\n      }\n\n      if (!pass) {\n        throw new Error(message);\n      }\n    } catch (error) {\n      if (error instanceof TaskExecutionError) {\n        const errorTask = error.errorTask;\n        const thought = errorTask?.thought;\n        const rawError = errorTask?.error;\n        const rawMessage =\n          errorTask?.errorMessage ||\n          (rawError instanceof Error\n            ? rawError.message\n            : rawError\n              ? String(rawError)\n              : undefined);\n        const reason = thought || rawMessage || '(no_reason)';\n        const message = `Assertion failed: ${msg || assertionText}\\nReason: ${reason}`;\n\n        if (opt?.keepRawResponse) {\n          return {\n            pass: false,\n            thought,\n            message,\n          };\n        }\n\n        throw new Error(message, {\n          cause: rawError ?? error,\n        });\n      }\n\n      throw error;\n    }\n  }\n\n  async aiWaitFor(assertion: TUserPrompt, opt?: AgentWaitForOpt) {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n    await this.taskExecutor.waitFor(\n      assertion,\n      {\n        ...opt,\n        timeoutMs: opt?.timeoutMs || 15 * 1000,\n        checkIntervalMs: opt?.checkIntervalMs || 3 * 1000,\n      },\n      modelConfig,\n    );\n  }\n\n  async ai(...args: Parameters<typeof this.aiAct>) {\n    return this.aiAct(...args);\n  }\n\n  async runYaml(yamlScriptContent: string): Promise<{\n    result: Record<string, any>;\n  }> {\n    const script = parseYamlScript(yamlScriptContent, 'yaml');\n    const player = new ScriptPlayer(script, async () => {\n      return { agent: this, freeFn: [] };\n    });\n    await player.run();\n\n    if (player.status === 'error') {\n      const errors = player.taskStatusList\n        .filter((task) => task.status === 'error')\n        .map((task) => {\n          return `task - ${task.name}: ${task.error?.message}`;\n        })\n        .join('\\n');\n      throw new Error(`Error(s) occurred in running yaml script:\\n${errors}`);\n    }\n\n    return {\n      result: player.result,\n    };\n  }\n\n  async evaluateJavaScript(script: string) {\n    assert(\n      this.interface.evaluateJavaScript,\n      'evaluateJavaScript is not supported in current agent',\n    );\n    return this.interface.evaluateJavaScript(script);\n  }\n\n  /**\n   * Add a dump update listener\n   * @param listener Listener function\n   * @returns A remove function that can be called to remove this listener\n   */\n  addDumpUpdateListener(\n    listener: (dump: string, executionDump?: ExecutionDump) => void,\n  ): () => void {\n    this.dumpUpdateListeners.push(listener);\n\n    // Return remove function\n    return () => {\n      this.removeDumpUpdateListener(listener);\n    };\n  }\n\n  /**\n   * Remove a dump update listener\n   * @param listener The listener function to remove\n   */\n  removeDumpUpdateListener(\n    listener: (dump: string, executionDump?: ExecutionDump) => void,\n  ): void {\n    const index = this.dumpUpdateListeners.indexOf(listener);\n    if (index > -1) {\n      this.dumpUpdateListeners.splice(index, 1);\n    }\n  }\n\n  /**\n   * Clear all dump update listeners\n   */\n  clearDumpUpdateListeners(): void {\n    this.dumpUpdateListeners = [];\n  }\n\n  async destroy() {\n    // Early return if already destroyed\n    if (this.destroyed) {\n      return;\n    }\n\n    // Wait for all queued write operations to complete\n    await this.reportGenerator.flush();\n\n    await this.reportGenerator.finalize(this.dump);\n    this.reportFile = this.reportGenerator.getReportPath();\n\n    await this.interface.destroy?.();\n    this.resetDump(); // reset dump to release memory\n    this.destroyed = true;\n  }\n\n  async recordToReport(\n    title?: string,\n    opt?: {\n      content: string;\n    },\n  ) {\n    // 1. screenshot\n    const base64 = await this.interface.screenshotBase64();\n    const now = Date.now();\n    const screenshot = ScreenshotItem.create(base64, now);\n    // 2. build recorder\n    const recorder: ExecutionRecorderItem[] = [\n      {\n        type: 'screenshot',\n        ts: now,\n        screenshot,\n      },\n    ];\n    // 3. build ExecutionTaskLog\n    const task: ExecutionTaskLog = {\n      taskId: uuid(),\n      type: 'Log',\n      subType: 'Screenshot',\n      status: 'finished',\n      recorder,\n      timing: {\n        start: now,\n        end: now,\n        cost: 0,\n      },\n      param: {\n        content: opt?.content || '',\n      },\n      executor: async () => {},\n    };\n    // 4. build ExecutionDump\n    const executionDump = new ExecutionDump({\n      logTime: now,\n      name: `Log - ${title || 'untitled'}`,\n      description: opt?.content || '',\n      tasks: [task],\n    });\n    // 5. append to execution dump\n    this.appendExecutionDump(executionDump);\n\n    // Call all registered dump update listeners\n    const dumpString = this.dumpDataString();\n    for (const listener of this.dumpUpdateListeners) {\n      try {\n        listener(dumpString);\n      } catch (error) {\n        console.error('Error in onDumpUpdate listener', error);\n      }\n    }\n\n    this.writeOutActionDumps();\n    await this.reportGenerator.flush();\n  }\n\n  /**\n   * @deprecated Use {@link Agent.recordToReport} instead.\n   */\n  async logScreenshot(\n    title?: string,\n    opt?: {\n      content: string;\n    },\n  ) {\n    await this.recordToReport(title, opt);\n  }\n\n  _unstableLogContent() {\n    const { groupName, groupDescription, executions } = this.dump;\n    return {\n      groupName,\n      groupDescription,\n      executions: executions || [],\n    };\n  }\n\n  /**\n   * Freezes the current page context to be reused in subsequent AI operations\n   * This avoids recalculating page context for each operation\n   */\n  async freezePageContext(): Promise<void> {\n    debug('Freezing page context');\n    const context = await this._snapshotContext();\n    // Mark the context as frozen\n    context._isFrozen = true;\n    this.frozenUIContext = context;\n    debug('Page context frozen successfully');\n  }\n\n  /**\n   * Unfreezes the page context, allowing AI operations to calculate context dynamically\n   */\n  async unfreezePageContext(): Promise<void> {\n    debug('Unfreezing page context');\n    this.frozenUIContext = undefined;\n    debug('Page context unfrozen successfully');\n  }\n\n  /**\n   * Process cache configuration and return normalized cache settings\n   */\n  private processCacheConfig(opts: AgentOpt): {\n    id: string;\n    enabled: boolean;\n    readOnly: boolean;\n    writeOnly: boolean;\n  } | null {\n    // Validate original cache config before processing\n    // Agent requires explicit IDs - don't allow auto-generation\n    if (opts.cache === true) {\n      throw new Error(\n        'cache: true requires an explicit cache ID. Please provide:\\n' +\n          'Example: cache: { id: \"my-cache-id\" }',\n      );\n    }\n\n    // Check if cache config object is missing ID\n    if (\n      opts.cache &&\n      typeof opts.cache === 'object' &&\n      opts.cache !== null &&\n      !opts.cache.id\n    ) {\n      throw new Error(\n        'cache configuration requires an explicit id.\\n' +\n          'Example: cache: { id: \"my-cache-id\" }',\n      );\n    }\n\n    // Use the unified utils function to process cache configuration\n    const cacheConfig = processCacheConfig(\n      opts.cache,\n      opts.cacheId || opts.testId || 'default',\n    );\n\n    if (!cacheConfig) {\n      return null;\n    }\n\n    // Handle cache configuration object\n    if (typeof cacheConfig === 'object' && cacheConfig !== null) {\n      const id = cacheConfig.id;\n      const rawStrategy = cacheConfig.strategy as unknown;\n      let strategyValue: string;\n\n      if (rawStrategy === undefined) {\n        strategyValue = 'read-write';\n      } else if (typeof rawStrategy === 'string') {\n        strategyValue = rawStrategy;\n      } else {\n        throw new Error(\n          `cache.strategy must be a string when provided, but received type ${typeof rawStrategy}`,\n        );\n      }\n\n      if (!isValidCacheStrategy(strategyValue)) {\n        throw new Error(\n          `cache.strategy must be one of ${CACHE_STRATEGY_VALUES}, but received \"${strategyValue}\"`,\n        );\n      }\n\n      const isReadOnly = strategyValue === 'read-only';\n      const isWriteOnly = strategyValue === 'write-only';\n\n      return {\n        id,\n        enabled: !isWriteOnly,\n        readOnly: isReadOnly,\n        writeOnly: isWriteOnly,\n      };\n    }\n\n    return null;\n  }\n\n  private normalizeFilePaths(files: string[]): string[] {\n    if (ifInBrowser) {\n      throw new Error('File chooser is not supported in browser environment');\n    }\n\n    return files.map((file) => {\n      const absolutePath = resolve(file);\n      if (!existsSync(absolutePath)) {\n        throw new Error(`File not found: ${file}`);\n      }\n      return absolutePath;\n    });\n  }\n\n  private normalizeFileInput(files: string | string[]): string[] {\n    const filesArray = Array.isArray(files) ? files : [files];\n    return this.normalizeFilePaths(filesArray);\n  }\n\n  /**\n   * Manually flush cache to file\n   * @param options - Optional configuration\n   * @param options.cleanUnused - If true, removes unused cache records before flushing\n   */\n  async flushCache(options?: { cleanUnused?: boolean }): Promise<void> {\n    if (!this.taskCache) {\n      throw new Error('Cache is not configured');\n    }\n\n    this.taskCache.flushCacheToFile(options);\n  }\n}\n\nexport const createAgent = (\n  interfaceInstance: AbstractInterface,\n  opts?: AgentOpt,\n) => {\n  return new Agent(interfaceInstance, opts);\n};\n"],"names":["debug","getDebug","distanceOfTwoPoints","p1","p2","x1","y1","x2","y2","Math","includedInRect","point","rect","x","y","left","top","width","height","defaultServiceExtractOption","CACHE_STRATEGIES","isValidCacheStrategy","strategy","value","CACHE_STRATEGY_VALUES","legacyScrollTypeMap","normalizeScrollType","scrollType","defaultReplanningCycleLimit","defaultVlmUiTarsReplanningCycleLimit","defaultAutoGlmReplanningCycleLimit","Agent","callback","modelConfigForPlanning","undefined","isUITars","isAutoGLM","action","context","commonContextParser","prompt","console","GroupedActionDump","getVersion","WeakMap","execution","runner","currentDump","existingIndex","opt","ifInBrowser","reportHTMLContent","task","param","paramStr","tip","typeStr","name","type","actionPlan","plans","Boolean","title","taskTitleStr","locateParamStr","defaultIntentModelConfig","output","locatePrompt","assert","detailedLocateParam","buildDetailedLocateParam","fileChooserAccept","withFileChooser","locatePromptOrValue","locatePromptOrOpt","optOrUndefined","optWithValue","stringValue","String","mode","locatePromptOrKeyName","keyName","locatePromptOrScrollParam","scrollParam","normalizedScrollType","taskPrompt","abortSignal","Error","runAiAct","deepThink","deepLocate","noIndividualLocateModel","includeBboxInPlanning","cacheable","replanningCycleLimit","isVlmUiTars","isAutoGlm","matchedCache","yaml","imagesIncludeCount","actionOutput","yamlContent","yamlFlowStr","demand","modelConfig","textPrompt","multimodalPrompt","parsePrompt","center","verifyPrompt","retryLimit","success","retryCount","resultPrompt","verifyResult","text","locateOpt","expectCenter","verifyLocateOption","verifyCenter","verifyRect","distance","included","pass","locateParam","locatePlan","locatePlanForLocate","element","assertion","msg","serviceOpt","assertionText","thought","message","error","TaskExecutionError","errorTask","rawError","rawMessage","reason","args","yamlScriptContent","script","parseYamlScript","player","ScriptPlayer","errors","listener","index","base64","now","Date","screenshot","ScreenshotItem","recorder","uuid","executionDump","ExecutionDump","dumpString","groupName","groupDescription","executions","opts","cacheConfig","processCacheConfig","id","rawStrategy","strategyValue","isReadOnly","isWriteOnly","files","file","absolutePath","resolve","existsSync","filesArray","Array","options","interfaceInstance","envReplanningCycleLimit","globalConfigManager","MIDSCENE_REPLANNING_CYCLE_LIMIT","Object","Number","resolvedAiActContext","hasCustomConfig","ModelConfigManager","globalModelConfigManager","Service","cacheConfigObj","TaskCache","baseActionSpace","defineActionSleep","TaskExecutor","getReportFileName","ReportGenerator","createAgent"],"mappings":"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"}
+{"version":3,"file":"agent/agent.mjs","sources":["../../../src/agent/agent.ts"],"sourcesContent":["import type { TUserPrompt } from '../ai-model/index';\nimport { ScreenshotItem } from '../screenshot-item';\nimport Service from '../service/index';\n// Import types and values directly from their source files to avoid circular dependency\n// DO NOT import from '../index' as it creates a circular dependency:\n// index.ts -> agent/index.ts -> agent/agent.ts -> index.ts\nimport {\n  type ActionParam,\n  type ActionReturn,\n  type AgentAssertOpt,\n  type AgentDescribeElementAtPointResult,\n  type AgentOpt,\n  type AgentWaitForOpt,\n  type CacheConfig,\n  type DeepThinkOption,\n  type DeviceAction,\n  ExecutionDump,\n  type ExecutionRecorderItem,\n  type ExecutionTask,\n  type ExecutionTaskLog,\n  GroupedActionDump,\n  type LocateOption,\n  type LocateResultElement,\n  type LocateValidatorResult,\n  type LocatorValidatorOption,\n  type OnTaskStartTip,\n  type PlanningAction,\n  type Rect,\n  type ScrollParam,\n  type ServiceAction,\n  type ServiceExtractOption,\n  type ServiceExtractParam,\n  type UIContext,\n} from '../types';\nimport type { MidsceneYamlScript } from '../yaml';\nexport type TestStatus =\n  | 'passed'\n  | 'failed'\n  | 'timedOut'\n  | 'skipped'\n  | 'interrupted';\nimport { isAutoGLM, isUITars } from '@/ai-model/auto-glm/util';\nimport yaml from 'js-yaml';\n\nimport type { IReportGenerator } from '@/report-generator';\nimport { ReportGenerator } from '@/report-generator';\nimport { getVersion, processCacheConfig, reportHTMLContent } from '@/utils';\nimport {\n  ScriptPlayer,\n  buildDetailedLocateParam,\n  parseYamlScript,\n} from '../yaml/index';\n\nimport { existsSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport type { AbstractInterface } from '@/device';\nimport type { TaskRunner } from '@/task-runner';\nimport {\n  type IModelConfig,\n  MIDSCENE_REPLANNING_CYCLE_LIMIT,\n  ModelConfigManager,\n  globalConfigManager,\n  globalModelConfigManager,\n} from '@midscene/shared/env';\nimport { getDebug } from '@midscene/shared/logger';\nimport { assert, ifInBrowser, uuid } from '@midscene/shared/utils';\nimport { defineActionSleep } from '../device';\nimport { TaskCache } from './task-cache';\nimport {\n  TaskExecutionError,\n  TaskExecutor,\n  locatePlanForLocate,\n  withFileChooser,\n} from './tasks';\nimport { locateParamStr, paramStr, taskTitleStr, typeStr } from './ui-utils';\nimport { commonContextParser, getReportFileName, parsePrompt } from './utils';\n\nconst debug = getDebug('agent');\n\nconst distanceOfTwoPoints = (p1: [number, number], p2: [number, number]) => {\n  const [x1, y1] = p1;\n  const [x2, y2] = p2;\n  return Math.round(Math.sqrt((x1 - x2) ** 2 + (y1 - y2) ** 2));\n};\n\nconst includedInRect = (point: [number, number], rect: Rect) => {\n  const [x, y] = point;\n  const { left, top, width, height } = rect;\n  return x >= left && x <= left + width && y >= top && y <= top + height;\n};\n\nconst defaultServiceExtractOption: ServiceExtractOption = {\n  domIncluded: false,\n  screenshotIncluded: true,\n};\n\ntype CacheStrategy = NonNullable<CacheConfig['strategy']>;\n\nconst CACHE_STRATEGIES: readonly CacheStrategy[] = [\n  'read-only',\n  'read-write',\n  'write-only',\n];\n\nconst isValidCacheStrategy = (strategy: string): strategy is CacheStrategy =>\n  CACHE_STRATEGIES.some((value) => value === strategy);\n\nconst CACHE_STRATEGY_VALUES = CACHE_STRATEGIES.map(\n  (value) => `\"${value}\"`,\n).join(', ');\n\nconst legacyScrollTypeMap = {\n  once: 'singleAction',\n  untilBottom: 'scrollToBottom',\n  untilTop: 'scrollToTop',\n  untilRight: 'scrollToRight',\n  untilLeft: 'scrollToLeft',\n} as const;\n\ntype LegacyScrollType = keyof typeof legacyScrollTypeMap;\n\nconst normalizeScrollType = (\n  scrollType: ScrollParam['scrollType'] | LegacyScrollType | undefined,\n): ScrollParam['scrollType'] | undefined => {\n  if (!scrollType) {\n    return scrollType;\n  }\n\n  if (scrollType in legacyScrollTypeMap) {\n    return legacyScrollTypeMap[scrollType as LegacyScrollType];\n  }\n\n  return scrollType as ScrollParam['scrollType'];\n};\n\nconst defaultReplanningCycleLimit = 20;\nconst defaultVlmUiTarsReplanningCycleLimit = 40;\nconst defaultAutoGlmReplanningCycleLimit = 100;\n\nexport type AiActOptions = {\n  cacheable?: boolean;\n  fileChooserAccept?: string | string[];\n  deepThink?: DeepThinkOption;\n  deepLocate?: boolean;\n  abortSignal?: AbortSignal;\n};\n\nexport class Agent<\n  InterfaceType extends AbstractInterface = AbstractInterface,\n> {\n  interface: InterfaceType;\n\n  service: Service;\n\n  dump: GroupedActionDump;\n\n  reportFile?: string | null;\n\n  reportFileName?: string;\n\n  taskExecutor: TaskExecutor;\n\n  opts: AgentOpt;\n\n  /**\n   * If true, the agent will not perform any actions\n   */\n  dryMode = false;\n\n  onTaskStartTip?: OnTaskStartTip;\n\n  taskCache?: TaskCache;\n\n  private dumpUpdateListeners: Array<\n    (dump: string, executionDump?: ExecutionDump) => void\n  > = [];\n\n  get onDumpUpdate():\n    | ((dump: string, executionDump?: ExecutionDump) => void)\n    | undefined {\n    return this.dumpUpdateListeners[0];\n  }\n\n  set onDumpUpdate(callback:\n    | ((dump: string, executionDump?: ExecutionDump) => void)\n    | undefined) {\n    // Clear existing listeners\n    this.dumpUpdateListeners = [];\n    // Add callback to array if provided\n    if (callback) {\n      this.dumpUpdateListeners.push(callback);\n    }\n  }\n\n  destroyed = false;\n\n  modelConfigManager: ModelConfigManager;\n\n  /**\n   * Frozen page context for consistent AI operations\n   */\n  private frozenUIContext?: UIContext;\n\n  private get aiActContext(): string | undefined {\n    return this.opts.aiActContext ?? this.opts.aiActionContext;\n  }\n\n  /**\n   * Flag to track if VL model warning has been shown\n   */\n  private hasWarnedNonVLModel = false;\n\n  private executionDumpIndexByRunner = new WeakMap<TaskRunner, number>();\n\n  private fullActionSpace: DeviceAction[];\n\n  private reportGenerator: IReportGenerator;\n\n  // @deprecated use .interface instead\n  get page() {\n    return this.interface;\n  }\n\n  /**\n   * Ensures VL model warning is shown once when needed\n   */\n  private ensureVLModelWarning() {\n    if (\n      !this.hasWarnedNonVLModel &&\n      this.interface.interfaceType !== 'puppeteer' &&\n      this.interface.interfaceType !== 'playwright' &&\n      this.interface.interfaceType !== 'static' &&\n      this.interface.interfaceType !== 'chrome-extension-proxy' &&\n      this.interface.interfaceType !== 'page-over-chrome-extension-bridge'\n    ) {\n      this.modelConfigManager.throwErrorIfNonVLModel();\n      this.hasWarnedNonVLModel = true;\n    }\n  }\n\n  private resolveReplanningCycleLimit(\n    modelConfigForPlanning: IModelConfig,\n  ): number {\n    if (this.opts.replanningCycleLimit !== undefined) {\n      return this.opts.replanningCycleLimit;\n    }\n\n    return isUITars(modelConfigForPlanning.modelFamily)\n      ? defaultVlmUiTarsReplanningCycleLimit\n      : isAutoGLM(modelConfigForPlanning.modelFamily)\n        ? defaultAutoGlmReplanningCycleLimit\n        : defaultReplanningCycleLimit;\n  }\n\n  constructor(interfaceInstance: InterfaceType, opts?: AgentOpt) {\n    this.interface = interfaceInstance;\n\n    const envReplanningCycleLimit =\n      globalConfigManager.getEnvConfigValueAsNumber(\n        MIDSCENE_REPLANNING_CYCLE_LIMIT,\n      );\n\n    this.opts = Object.assign(\n      {\n        generateReport: true,\n        autoPrintReportMsg: true,\n        groupName: 'Midscene Report',\n        groupDescription: '',\n      },\n      opts || {},\n      opts?.replanningCycleLimit === undefined &&\n        envReplanningCycleLimit !== undefined &&\n        !Number.isNaN(envReplanningCycleLimit)\n        ? { replanningCycleLimit: envReplanningCycleLimit }\n        : {},\n    );\n\n    const resolvedAiActContext =\n      this.opts.aiActContext ?? this.opts.aiActionContext;\n    if (resolvedAiActContext !== undefined) {\n      this.opts.aiActContext = resolvedAiActContext;\n      this.opts.aiActionContext ??= resolvedAiActContext;\n    }\n\n    if (\n      opts?.modelConfig &&\n      (typeof opts?.modelConfig !== 'object' || Array.isArray(opts.modelConfig))\n    ) {\n      throw new Error(\n        `opts.modelConfig must be a plain object map of env keys to values, but got ${typeof opts?.modelConfig}`,\n      );\n    }\n    // Create ModelConfigManager if modelConfig or createOpenAIClient is provided\n    // Otherwise, use the global config manager\n    const hasCustomConfig = opts?.modelConfig || opts?.createOpenAIClient;\n    this.modelConfigManager = hasCustomConfig\n      ? new ModelConfigManager(opts?.modelConfig, opts?.createOpenAIClient)\n      : globalModelConfigManager;\n\n    this.onTaskStartTip = this.opts.onTaskStartTip;\n\n    this.service = new Service(async () => {\n      return this.getUIContext();\n    });\n\n    // Process cache configuration\n    const cacheConfigObj = this.processCacheConfig(opts || {});\n    if (cacheConfigObj) {\n      this.taskCache = new TaskCache(\n        cacheConfigObj.id,\n        cacheConfigObj.enabled,\n        cacheConfigObj.cacheAdapter,\n        {\n          readOnly: cacheConfigObj.readOnly,\n          writeOnly: cacheConfigObj.writeOnly,\n        },\n      );\n    }\n\n    const baseActionSpace = this.interface.actionSpace();\n    this.fullActionSpace = [...baseActionSpace, defineActionSleep()];\n\n    this.taskExecutor = new TaskExecutor(this.interface, this.service, {\n      taskCache: this.taskCache,\n      onTaskStart: this.callbackOnTaskStartTip.bind(this),\n      replanningCycleLimit: this.opts.replanningCycleLimit,\n      waitAfterAction: this.opts.waitAfterAction,\n      useDeviceTimestamp: this.opts.useDeviceTimestamp,\n      actionSpace: this.fullActionSpace,\n      hooks: {\n        onTaskUpdate: (runner) => {\n          const executionDump = runner.dump();\n          this.appendExecutionDump(executionDump, runner);\n\n          // Call all registered dump update listeners\n          const dumpString = this.dumpDataString();\n          for (const listener of this.dumpUpdateListeners) {\n            try {\n              listener(dumpString, executionDump);\n            } catch (error) {\n              console.error('Error in onDumpUpdate listener', error);\n            }\n          }\n\n          // Fire and forget - don't block task execution\n          this.writeOutActionDumps();\n        },\n      },\n    });\n    this.dump = this.resetDump();\n    this.reportFileName =\n      opts?.reportFileName ||\n      getReportFileName(opts?.testId || this.interface.interfaceType || 'web');\n\n    this.reportGenerator = ReportGenerator.create(this.reportFileName!, {\n      generateReport: this.opts.generateReport,\n      outputFormat: this.opts.outputFormat,\n      autoPrintReportMsg: this.opts.autoPrintReportMsg,\n    });\n  }\n\n  async getActionSpace(): Promise<DeviceAction[]> {\n    return this.fullActionSpace;\n  }\n\n  async getUIContext(action?: ServiceAction): Promise<UIContext> {\n    // Check VL model configuration when UI context is first needed\n    this.ensureVLModelWarning();\n\n    // If page context is frozen, return the frozen context for all actions\n    if (this.frozenUIContext) {\n      debug('Using frozen page context for action:', action);\n      return this.frozenUIContext;\n    }\n\n    // Get original context\n    const context = await commonContextParser(this.interface, {\n      uploadServerUrl: this.modelConfigManager.getUploadTestServerUrl(),\n      screenshotShrinkFactor: this.opts.screenshotShrinkFactor,\n    });\n\n    return context;\n  }\n\n  async _snapshotContext(): Promise<UIContext> {\n    return await this.getUIContext('locate');\n  }\n\n  /**\n   * @deprecated Use {@link setAIActContext} instead.\n   */\n  async setAIActionContext(prompt: string) {\n    await this.setAIActContext(prompt);\n  }\n\n  async setAIActContext(prompt: string) {\n    if (this.aiActContext) {\n      console.warn(\n        'aiActContext is already set, and it is called again, will override the previous setting',\n      );\n    }\n    this.opts.aiActContext = prompt;\n    this.opts.aiActionContext = prompt;\n  }\n\n  resetDump() {\n    this.dump = new GroupedActionDump({\n      sdkVersion: getVersion(),\n      groupName: this.opts.groupName!,\n      groupDescription: this.opts.groupDescription,\n      executions: [],\n      modelBriefs: [],\n      deviceType: this.interface.interfaceType,\n    });\n    this.executionDumpIndexByRunner = new WeakMap<TaskRunner, number>();\n\n    return this.dump;\n  }\n\n  appendExecutionDump(execution: ExecutionDump, runner?: TaskRunner) {\n    const currentDump = this.dump;\n    if (runner) {\n      const existingIndex = this.executionDumpIndexByRunner.get(runner);\n      if (existingIndex !== undefined) {\n        currentDump.executions[existingIndex] = execution;\n        return;\n      }\n      currentDump.executions.push(execution);\n      this.executionDumpIndexByRunner.set(\n        runner,\n        currentDump.executions.length - 1,\n      );\n      return;\n    }\n    currentDump.executions.push(execution);\n  }\n\n  dumpDataString(opt?: { inlineScreenshots?: boolean }) {\n    // update dump info\n    this.dump.groupName = this.opts.groupName!;\n    this.dump.groupDescription = this.opts.groupDescription;\n    // In browser environment, use inline screenshots since file system is not available\n    if (ifInBrowser || opt?.inlineScreenshots) {\n      return this.dump.serializeWithInlineScreenshots();\n    }\n    return this.dump.serialize();\n  }\n\n  reportHTMLString(opt?: { inlineScreenshots?: boolean }) {\n    // dumpDataString() handles browser environment with inline screenshots\n    return reportHTMLContent(this.dumpDataString(opt));\n  }\n\n  writeOutActionDumps() {\n    this.reportGenerator.onDumpUpdate(this.dump);\n    this.reportFile = this.reportGenerator.getReportPath();\n  }\n\n  private async callbackOnTaskStartTip(task: ExecutionTask) {\n    const param = paramStr(task);\n    const tip = param ? `${typeStr(task)} - ${param}` : typeStr(task);\n\n    if (this.onTaskStartTip) {\n      await this.onTaskStartTip(tip);\n    }\n  }\n\n  wrapActionInActionSpace<T extends DeviceAction>(\n    name: string,\n  ): (param: ActionParam<T>) => Promise<ActionReturn<T>> {\n    return async (param: ActionParam<T>) => {\n      return await this.callActionInActionSpace<ActionReturn<T>>(name, param);\n    };\n  }\n\n  async callActionInActionSpace<T = any>(\n    type: string,\n    opt?: T, // and all other action params\n  ) {\n    debug('callActionInActionSpace', type, ',', opt);\n\n    const actionPlan: PlanningAction<T> = {\n      type: type as any,\n      param: (opt as any) || {},\n      thought: '',\n    };\n    debug('actionPlan', actionPlan); // , ', in which the locateParam is', locateParam);\n\n    const plans: PlanningAction[] = [actionPlan].filter(\n      Boolean,\n    ) as PlanningAction[];\n\n    const title = taskTitleStr(\n      type as any,\n      locateParamStr((opt as any)?.locate || {}),\n    );\n\n    // assume all operation in action space is related to locating\n    const defaultIntentModelConfig =\n      this.modelConfigManager.getModelConfig('default');\n    const modelConfigForPlanning =\n      this.modelConfigManager.getModelConfig('planning');\n\n    const { output } = await this.taskExecutor.runPlans(\n      title,\n      plans,\n      modelConfigForPlanning,\n      defaultIntentModelConfig,\n    );\n    return output;\n  }\n\n  async aiTap(\n    locatePrompt: TUserPrompt,\n    opt?: LocateOption & { fileChooserAccept?: string | string[] },\n  ) {\n    assert(locatePrompt, 'missing locate prompt for tap');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    const fileChooserAccept = opt?.fileChooserAccept\n      ? this.normalizeFileInput(opt.fileChooserAccept)\n      : undefined;\n\n    return withFileChooser(this.interface, fileChooserAccept, async () => {\n      return this.callActionInActionSpace('Tap', {\n        locate: detailedLocateParam,\n      });\n    });\n  }\n\n  async aiRightClick(locatePrompt: TUserPrompt, opt?: LocateOption) {\n    assert(locatePrompt, 'missing locate prompt for right click');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    return this.callActionInActionSpace('RightClick', {\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiDoubleClick(locatePrompt: TUserPrompt, opt?: LocateOption) {\n    assert(locatePrompt, 'missing locate prompt for double click');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    return this.callActionInActionSpace('DoubleClick', {\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiHover(locatePrompt: TUserPrompt, opt?: LocateOption) {\n    assert(locatePrompt, 'missing locate prompt for hover');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    return this.callActionInActionSpace('Hover', {\n      locate: detailedLocateParam,\n    });\n  }\n\n  // New signature, always use locatePrompt as the first param\n  async aiInput(\n    locatePrompt: TUserPrompt,\n    opt: LocateOption & { value: string | number } & {\n      autoDismissKeyboard?: boolean;\n    } & { mode?: 'replace' | 'clear' | 'typeOnly' | 'append' },\n  ): Promise<any>;\n\n  // Legacy signature - deprecated\n  /**\n   * @deprecated Use aiInput(locatePrompt, opt) instead where opt contains the value\n   */\n  async aiInput(\n    value: string | number,\n    locatePrompt: TUserPrompt,\n    opt?: LocateOption & { autoDismissKeyboard?: boolean } & {\n      mode?: 'replace' | 'clear' | 'typeOnly' | 'append';\n    }, // AndroidDeviceInputOpt &\n  ): Promise<any>;\n\n  // Implementation\n  async aiInput(\n    locatePromptOrValue: TUserPrompt | string | number,\n    locatePromptOrOpt:\n      | TUserPrompt\n      | (LocateOption & { value: string | number } & {\n          autoDismissKeyboard?: boolean;\n        } & { mode?: 'replace' | 'clear' | 'typeOnly' | 'append' }) // AndroidDeviceInputOpt &\n      | undefined,\n    optOrUndefined?: LocateOption, // AndroidDeviceInputOpt &\n  ) {\n    let value: string | number;\n    let locatePrompt: TUserPrompt;\n    let opt:\n      | (LocateOption & { value: string | number } & {\n          autoDismissKeyboard?: boolean;\n        } & { mode?: 'replace' | 'clear' | 'typeOnly' | 'append' }) // AndroidDeviceInputOpt &\n      | undefined;\n\n    // Check if using new signature (first param is locatePrompt, second has value)\n    if (\n      typeof locatePromptOrOpt === 'object' &&\n      locatePromptOrOpt !== null &&\n      'value' in locatePromptOrOpt\n    ) {\n      // New signature: aiInput(locatePrompt, opt)\n      locatePrompt = locatePromptOrValue as TUserPrompt;\n      const optWithValue = locatePromptOrOpt as LocateOption & {\n        // AndroidDeviceInputOpt &\n        value: string | number;\n        autoDismissKeyboard?: boolean;\n      };\n      value = optWithValue.value;\n      opt = optWithValue;\n    } else {\n      // Legacy signature: aiInput(value, locatePrompt, opt)\n      value = locatePromptOrValue as string | number;\n      locatePrompt = locatePromptOrOpt as TUserPrompt;\n      opt = {\n        ...optOrUndefined,\n        value,\n      };\n    }\n\n    assert(\n      typeof value === 'string' || typeof value === 'number',\n      'input value must be a string or number, use empty string if you want to clear the input',\n    );\n    assert(locatePrompt, 'missing locate prompt for input');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    // Convert value to string to ensure consistency\n    const stringValue = typeof value === 'number' ? String(value) : value;\n\n    // backward compat: convert deprecated 'append' to 'typeOnly'\n    const mode = opt?.mode === 'append' ? 'typeOnly' : opt?.mode;\n\n    return this.callActionInActionSpace('Input', {\n      ...(opt || {}),\n      value: stringValue,\n      locate: detailedLocateParam,\n      mode,\n    });\n  }\n\n  // New signature\n  async aiKeyboardPress(\n    locatePrompt: TUserPrompt,\n    opt: LocateOption & { keyName: string },\n  ): Promise<any>;\n\n  // Legacy signature - deprecated\n  /**\n   * @deprecated Use aiKeyboardPress(locatePrompt, opt) instead where opt contains the keyName\n   */\n  async aiKeyboardPress(\n    keyName: string,\n    locatePrompt?: TUserPrompt,\n    opt?: LocateOption,\n  ): Promise<any>;\n\n  // Implementation\n  async aiKeyboardPress(\n    locatePromptOrKeyName: TUserPrompt | string,\n    locatePromptOrOpt:\n      | TUserPrompt\n      | (LocateOption & { keyName: string })\n      | undefined,\n    optOrUndefined?: LocateOption,\n  ) {\n    let keyName: string;\n    let locatePrompt: TUserPrompt | undefined;\n    let opt: (LocateOption & { keyName: string }) | undefined;\n\n    // Check if using new signature (first param is locatePrompt, second has keyName)\n    if (\n      typeof locatePromptOrOpt === 'object' &&\n      locatePromptOrOpt !== null &&\n      'keyName' in locatePromptOrOpt\n    ) {\n      // New signature: aiKeyboardPress(locatePrompt, opt)\n      locatePrompt = locatePromptOrKeyName as TUserPrompt;\n      opt = locatePromptOrOpt as LocateOption & {\n        keyName: string;\n      };\n    } else {\n      // Legacy signature: aiKeyboardPress(keyName, locatePrompt, opt)\n      keyName = locatePromptOrKeyName as string;\n      locatePrompt = locatePromptOrOpt as TUserPrompt | undefined;\n      opt = {\n        ...(optOrUndefined || {}),\n        keyName,\n      };\n    }\n\n    assert(opt?.keyName, 'missing keyName for keyboard press');\n\n    const detailedLocateParam = locatePrompt\n      ? buildDetailedLocateParam(locatePrompt, opt)\n      : undefined;\n\n    return this.callActionInActionSpace('KeyboardPress', {\n      ...(opt || {}),\n      locate: detailedLocateParam,\n    });\n  }\n\n  // New signature\n  async aiScroll(\n    locatePrompt: TUserPrompt | undefined,\n    opt: LocateOption & ScrollParam,\n  ): Promise<any>;\n\n  // Legacy signature - deprecated\n  /**\n   * @deprecated Use aiScroll(locatePrompt, opt) instead where opt contains the scroll parameters\n   */\n  async aiScroll(\n    scrollParam: ScrollParam,\n    locatePrompt?: TUserPrompt,\n    opt?: LocateOption,\n  ): Promise<any>;\n\n  // Implementation\n  async aiScroll(\n    locatePromptOrScrollParam: TUserPrompt | ScrollParam | undefined,\n    locatePromptOrOpt: TUserPrompt | (LocateOption & ScrollParam) | undefined,\n    optOrUndefined?: LocateOption,\n  ) {\n    let scrollParam: ScrollParam;\n    let locatePrompt: TUserPrompt | undefined;\n    let opt: LocateOption | undefined;\n\n    // Check if using new signature (first param is locatePrompt, second has scroll params)\n    if (\n      typeof locatePromptOrOpt === 'object' &&\n      ('direction' in locatePromptOrOpt ||\n        'scrollType' in locatePromptOrOpt ||\n        'distance' in locatePromptOrOpt)\n    ) {\n      // New signature: aiScroll(locatePrompt, opt)\n      locatePrompt = locatePromptOrScrollParam as TUserPrompt;\n      opt = locatePromptOrOpt as LocateOption & ScrollParam;\n    } else {\n      // Legacy signature: aiScroll(scrollParam, locatePrompt, opt)\n      scrollParam = locatePromptOrScrollParam as ScrollParam;\n      locatePrompt = locatePromptOrOpt as TUserPrompt | undefined;\n      opt = {\n        ...(optOrUndefined || {}),\n        ...(scrollParam || {}),\n      };\n    }\n\n    if (opt) {\n      const normalizedScrollType = normalizeScrollType(\n        (opt as ScrollParam).scrollType as\n          | ScrollParam['scrollType']\n          | LegacyScrollType\n          | undefined,\n      );\n\n      if (normalizedScrollType !== (opt as ScrollParam).scrollType) {\n        (opt as ScrollParam) = {\n          ...(opt || {}),\n          scrollType: normalizedScrollType as ScrollParam['scrollType'],\n        };\n      }\n    }\n\n    const detailedLocateParam = buildDetailedLocateParam(\n      locatePrompt || '',\n      opt,\n    );\n\n    return this.callActionInActionSpace('Scroll', {\n      ...(opt || {}),\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiAct(\n    taskPrompt: string,\n    opt?: AiActOptions,\n  ): Promise<string | undefined> {\n    const fileChooserAccept = opt?.fileChooserAccept\n      ? this.normalizeFileInput(opt.fileChooserAccept)\n      : undefined;\n\n    const abortSignal = opt?.abortSignal;\n    if (abortSignal?.aborted) {\n      throw new Error(\n        `aiAct aborted: ${abortSignal.reason || 'signal already aborted'}`,\n      );\n    }\n\n    const runAiAct = async () => {\n      const modelConfigForPlanning =\n        this.modelConfigManager.getModelConfig('planning');\n      const defaultIntentModelConfig =\n        this.modelConfigManager.getModelConfig('default');\n      const deepThink = opt?.deepThink === 'unset' ? undefined : opt?.deepThink;\n\n      const deepLocate = opt?.deepLocate;\n\n      const noIndividualLocateModel =\n        modelConfigForPlanning.modelName ===\n          defaultIntentModelConfig.modelName &&\n        modelConfigForPlanning.openaiBaseURL ===\n          defaultIntentModelConfig.openaiBaseURL;\n\n      const includeBboxInPlanning =\n        !deepThink && noIndividualLocateModel && !deepLocate;\n\n      debug('setting includeBboxInPlanning to', includeBboxInPlanning, {\n        deepThink,\n        noIndividualLocateModel,\n        deepLocate,\n      });\n\n      if (deepLocate && includeBboxInPlanning) {\n        console.warn(\n          'deepLocate option is ignored when includeBboxInPlanning is true (same model for planning and default intent without deepThink). Locate is already done during planning.',\n        );\n      }\n\n      const cacheable = opt?.cacheable;\n      const replanningCycleLimit = this.resolveReplanningCycleLimit(\n        modelConfigForPlanning,\n      );\n      // if vlm-ui-tars or auto-glm, plan cache is not used\n      const isVlmUiTars = isUITars(modelConfigForPlanning.modelFamily);\n      const isAutoGlm = isAutoGLM(modelConfigForPlanning.modelFamily);\n      const matchedCache =\n        isVlmUiTars || isAutoGlm || cacheable === false\n          ? undefined\n          : await this.taskCache?.matchPlanCache(taskPrompt);\n      if (\n        matchedCache &&\n        this.taskCache?.isCacheResultUsed &&\n        matchedCache.cacheContent?.yamlWorkflow?.trim()\n      ) {\n        // log into report file\n        await this.taskExecutor.loadYamlFlowAsPlanning(\n          taskPrompt,\n          matchedCache.cacheContent.yamlWorkflow,\n        );\n\n        debug('matched cache, will call .runYaml to run the action');\n        const yaml = matchedCache.cacheContent.yamlWorkflow;\n        await this.runYaml(yaml);\n        return;\n      }\n\n      // If cache matched but yamlWorkflow is empty, fall through to normal execution\n      const imagesIncludeCount: number = deepThink ? 2 : 1;\n      const { output: actionOutput } = await this.taskExecutor.action(\n        taskPrompt,\n        modelConfigForPlanning,\n        defaultIntentModelConfig,\n        includeBboxInPlanning,\n        this.aiActContext,\n        cacheable,\n        replanningCycleLimit,\n        imagesIncludeCount,\n        deepThink,\n        fileChooserAccept,\n        includeBboxInPlanning ? undefined : deepLocate,\n        abortSignal,\n      );\n\n      // update cache\n      if (this.taskCache && actionOutput?.yamlFlow && cacheable !== false) {\n        const yamlContent: MidsceneYamlScript = {\n          tasks: [\n            {\n              name: taskPrompt,\n              flow: actionOutput.yamlFlow,\n            },\n          ],\n        };\n        const yamlFlowStr = yaml.dump(yamlContent);\n        this.taskCache.updateOrAppendCacheRecord(\n          {\n            type: 'plan',\n            prompt: taskPrompt,\n            yamlWorkflow: yamlFlowStr,\n          },\n          matchedCache,\n        );\n      }\n\n      return actionOutput?.output;\n    };\n\n    return await runAiAct();\n  }\n\n  /**\n   * @deprecated Use {@link Agent.aiAct} instead.\n   */\n  async aiAction(taskPrompt: string, opt?: AiActOptions) {\n    return this.aiAct(taskPrompt, opt);\n  }\n\n  async aiQuery<ReturnType = any>(\n    demand: ServiceExtractParam,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<ReturnType> {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'Query',\n      demand,\n      modelConfig,\n      opt,\n    );\n    return output as ReturnType;\n  }\n\n  async aiBoolean(\n    prompt: TUserPrompt,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<boolean> {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'Boolean',\n      textPrompt,\n      modelConfig,\n      opt,\n      multimodalPrompt,\n    );\n    return output as boolean;\n  }\n\n  async aiNumber(\n    prompt: TUserPrompt,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<number> {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'Number',\n      textPrompt,\n      modelConfig,\n      opt,\n      multimodalPrompt,\n    );\n    return output as number;\n  }\n\n  async aiString(\n    prompt: TUserPrompt,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<string> {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'String',\n      textPrompt,\n      modelConfig,\n      opt,\n      multimodalPrompt,\n    );\n    return output as string;\n  }\n\n  async aiAsk(\n    prompt: TUserPrompt,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<string> {\n    return this.aiString(prompt, opt);\n  }\n\n  async describeElementAtPoint(\n    center: [number, number],\n    opt?: {\n      verifyPrompt?: boolean;\n      retryLimit?: number;\n      deepLocate?: boolean;\n    } & LocatorValidatorOption,\n  ): Promise<AgentDescribeElementAtPointResult> {\n    const { verifyPrompt = true, retryLimit = 3 } = opt || {};\n\n    let success = false;\n    let retryCount = 0;\n    let resultPrompt = '';\n    let deepLocate = opt?.deepLocate || false;\n    let verifyResult: LocateValidatorResult | undefined;\n\n    while (!success && retryCount < retryLimit) {\n      if (retryCount >= 2) {\n        deepLocate = true;\n      }\n      debug(\n        'aiDescribe',\n        center,\n        'verifyPrompt',\n        verifyPrompt,\n        'retryCount',\n        retryCount,\n        'deepLocate',\n        deepLocate,\n      );\n      // use same intent as aiLocate\n      const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n      const text = await this.service.describe(center, modelConfig, {\n        deepLocate,\n      });\n      debug('aiDescribe text', text);\n      assert(text.description, `failed to describe element at [${center}]`);\n      resultPrompt = text.description;\n\n      // Don't pass deepLocate to verification locate — the description was generated\n      // from a cropped view (deepLocate describe), but verification should use regular\n      // locate on the full screenshot to confirm the description works universally.\n      // Passing deepLocate here would trigger AiLocateSection with an element-level\n      // description as a section prompt, which is semantically incorrect.\n      verifyResult = await this.verifyLocator(\n        resultPrompt,\n        undefined,\n        center,\n        opt,\n      );\n      if (verifyResult.pass) {\n        success = true;\n      } else {\n        retryCount++;\n      }\n    }\n\n    return {\n      prompt: resultPrompt,\n      deepLocate,\n      verifyResult,\n    };\n  }\n\n  async verifyLocator(\n    prompt: string,\n    locateOpt: LocateOption | undefined,\n    expectCenter: [number, number],\n    verifyLocateOption?: LocatorValidatorOption,\n  ): Promise<LocateValidatorResult> {\n    debug('verifyLocator', prompt, locateOpt, expectCenter, verifyLocateOption);\n\n    const { center: verifyCenter, rect: verifyRect } = await this.aiLocate(\n      prompt,\n      locateOpt,\n    );\n    const distance = distanceOfTwoPoints(expectCenter, verifyCenter);\n    const included = includedInRect(expectCenter, verifyRect);\n    const pass =\n      distance <= (verifyLocateOption?.centerDistanceThreshold || 20) ||\n      included;\n    const verifyResult = {\n      pass,\n      rect: verifyRect,\n      center: verifyCenter,\n      centerDistance: distance,\n    };\n    debug('aiDescribe verifyResult', verifyResult);\n    return verifyResult;\n  }\n\n  async aiLocate(prompt: TUserPrompt, opt?: LocateOption) {\n    const locateParam = buildDetailedLocateParam(prompt, opt);\n    assert(locateParam, 'cannot get locate param for aiLocate');\n    const locatePlan = locatePlanForLocate(locateParam);\n    const plans = [locatePlan];\n    const defaultIntentModelConfig =\n      this.modelConfigManager.getModelConfig('default');\n    const modelConfigForPlanning =\n      this.modelConfigManager.getModelConfig('planning');\n\n    const { output } = await this.taskExecutor.runPlans(\n      taskTitleStr('Locate', locateParamStr(locateParam)),\n      plans,\n      modelConfigForPlanning,\n      defaultIntentModelConfig,\n    );\n\n    const { element } = output;\n\n    return {\n      rect: element?.rect,\n      center: element?.center,\n      dpr: element?.dpr,\n    } as Pick<LocateResultElement, 'rect' | 'center'>;\n  }\n\n  async aiAssert(\n    assertion: TUserPrompt,\n    msg?: string,\n    opt?: AgentAssertOpt & ServiceExtractOption,\n  ) {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n    const serviceOpt: ServiceExtractOption = {\n      domIncluded: opt?.domIncluded ?? defaultServiceExtractOption.domIncluded,\n      screenshotIncluded:\n        opt?.screenshotIncluded ??\n        defaultServiceExtractOption.screenshotIncluded,\n    };\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(assertion);\n    const assertionText =\n      typeof assertion === 'string' ? assertion : assertion.prompt;\n\n    try {\n      const { output, thought } =\n        await this.taskExecutor.createTypeQueryExecution<boolean>(\n          'Assert',\n          textPrompt,\n          modelConfig,\n          serviceOpt,\n          multimodalPrompt,\n        );\n\n      const pass = Boolean(output);\n      const message = pass\n        ? undefined\n        : `Assertion failed: ${msg || assertionText}\\nReason: ${thought || '(no_reason)'}`;\n\n      if (opt?.keepRawResponse) {\n        return {\n          pass,\n          thought,\n          message,\n        };\n      }\n\n      if (!pass) {\n        throw new Error(message);\n      }\n    } catch (error) {\n      if (error instanceof TaskExecutionError) {\n        const errorTask = error.errorTask;\n        const thought = errorTask?.thought;\n        const rawError = errorTask?.error;\n        const rawMessage =\n          errorTask?.errorMessage ||\n          (rawError instanceof Error\n            ? rawError.message\n            : rawError\n              ? String(rawError)\n              : undefined);\n        const reason = thought || rawMessage || '(no_reason)';\n        const message = `Assertion failed: ${msg || assertionText}\\nReason: ${reason}`;\n\n        if (opt?.keepRawResponse) {\n          return {\n            pass: false,\n            thought,\n            message,\n          };\n        }\n\n        throw new Error(message, {\n          cause: rawError ?? error,\n        });\n      }\n\n      throw error;\n    }\n  }\n\n  async aiWaitFor(assertion: TUserPrompt, opt?: AgentWaitForOpt) {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n    await this.taskExecutor.waitFor(\n      assertion,\n      {\n        ...opt,\n        timeoutMs: opt?.timeoutMs || 15 * 1000,\n        checkIntervalMs: opt?.checkIntervalMs || 3 * 1000,\n      },\n      modelConfig,\n    );\n  }\n\n  async ai(...args: Parameters<typeof this.aiAct>) {\n    return this.aiAct(...args);\n  }\n\n  async runYaml(yamlScriptContent: string): Promise<{\n    result: Record<string, any>;\n  }> {\n    const script = parseYamlScript(yamlScriptContent, 'yaml');\n    const player = new ScriptPlayer(script, async () => {\n      return { agent: this, freeFn: [] };\n    });\n    await player.run();\n\n    if (player.status === 'error') {\n      const errors = player.taskStatusList\n        .filter((task) => task.status === 'error')\n        .map((task) => {\n          return `task - ${task.name}: ${task.error?.message}`;\n        })\n        .join('\\n');\n      throw new Error(`Error(s) occurred in running yaml script:\\n${errors}`);\n    }\n\n    return {\n      result: player.result,\n    };\n  }\n\n  async evaluateJavaScript(script: string) {\n    assert(\n      this.interface.evaluateJavaScript,\n      'evaluateJavaScript is not supported in current agent',\n    );\n    return this.interface.evaluateJavaScript(script);\n  }\n\n  /**\n   * Add a dump update listener\n   * @param listener Listener function\n   * @returns A remove function that can be called to remove this listener\n   */\n  addDumpUpdateListener(\n    listener: (dump: string, executionDump?: ExecutionDump) => void,\n  ): () => void {\n    this.dumpUpdateListeners.push(listener);\n\n    // Return remove function\n    return () => {\n      this.removeDumpUpdateListener(listener);\n    };\n  }\n\n  /**\n   * Remove a dump update listener\n   * @param listener The listener function to remove\n   */\n  removeDumpUpdateListener(\n    listener: (dump: string, executionDump?: ExecutionDump) => void,\n  ): void {\n    const index = this.dumpUpdateListeners.indexOf(listener);\n    if (index > -1) {\n      this.dumpUpdateListeners.splice(index, 1);\n    }\n  }\n\n  /**\n   * Clear all dump update listeners\n   */\n  clearDumpUpdateListeners(): void {\n    this.dumpUpdateListeners = [];\n  }\n\n  async destroy() {\n    // Early return if already destroyed\n    if (this.destroyed) {\n      return;\n    }\n\n    // Wait for all queued write operations to complete\n    await this.reportGenerator.flush();\n\n    await this.reportGenerator.finalize(this.dump);\n    this.reportFile = this.reportGenerator.getReportPath();\n\n    await this.interface.destroy?.();\n    this.resetDump(); // reset dump to release memory\n    this.destroyed = true;\n  }\n\n  async recordToReport(\n    title?: string,\n    opt?: {\n      content: string;\n    },\n  ) {\n    // 1. screenshot\n    const base64 = await this.interface.screenshotBase64();\n    const now = Date.now();\n    const screenshot = ScreenshotItem.create(base64, now);\n    // 2. build recorder\n    const recorder: ExecutionRecorderItem[] = [\n      {\n        type: 'screenshot',\n        ts: now,\n        screenshot,\n      },\n    ];\n    // 3. build ExecutionTaskLog\n    const task: ExecutionTaskLog = {\n      taskId: uuid(),\n      type: 'Log',\n      subType: 'Screenshot',\n      status: 'finished',\n      recorder,\n      timing: {\n        start: now,\n        end: now,\n        cost: 0,\n      },\n      param: {\n        content: opt?.content || '',\n      },\n      executor: async () => {},\n    };\n    // 4. build ExecutionDump\n    const executionDump = new ExecutionDump({\n      logTime: now,\n      name: `Log - ${title || 'untitled'}`,\n      description: opt?.content || '',\n      tasks: [task],\n    });\n    // 5. append to execution dump\n    this.appendExecutionDump(executionDump);\n\n    // Call all registered dump update listeners\n    const dumpString = this.dumpDataString();\n    for (const listener of this.dumpUpdateListeners) {\n      try {\n        listener(dumpString);\n      } catch (error) {\n        console.error('Error in onDumpUpdate listener', error);\n      }\n    }\n\n    this.writeOutActionDumps();\n    await this.reportGenerator.flush();\n  }\n\n  /**\n   * @deprecated Use {@link Agent.recordToReport} instead.\n   */\n  async logScreenshot(\n    title?: string,\n    opt?: {\n      content: string;\n    },\n  ) {\n    await this.recordToReport(title, opt);\n  }\n\n  _unstableLogContent() {\n    const { groupName, groupDescription, executions } = this.dump;\n    return {\n      groupName,\n      groupDescription,\n      executions: executions || [],\n    };\n  }\n\n  /**\n   * Freezes the current page context to be reused in subsequent AI operations\n   * This avoids recalculating page context for each operation\n   */\n  async freezePageContext(): Promise<void> {\n    debug('Freezing page context');\n    const context = await this._snapshotContext();\n    // Mark the context as frozen\n    context._isFrozen = true;\n    this.frozenUIContext = context;\n    debug('Page context frozen successfully');\n  }\n\n  /**\n   * Unfreezes the page context, allowing AI operations to calculate context dynamically\n   */\n  async unfreezePageContext(): Promise<void> {\n    debug('Unfreezing page context');\n    this.frozenUIContext = undefined;\n    debug('Page context unfrozen successfully');\n  }\n\n  /**\n   * Process cache configuration and return normalized cache settings\n   */\n  private processCacheConfig(opts: AgentOpt): {\n    id: string;\n    enabled: boolean;\n    readOnly: boolean;\n    writeOnly: boolean;\n    cacheAdapter?: import('./cache-adapter').CacheAdapter;\n  } | null {\n    // Validate original cache config before processing\n    // Agent requires explicit IDs - don't allow auto-generation\n    if (opts.cache === true) {\n      throw new Error(\n        'cache: true requires an explicit cache ID. Please provide:\\n' +\n          'Example: cache: { id: \"my-cache-id\" }',\n      );\n    }\n\n    // Check if cache config object is missing ID\n    if (\n      opts.cache &&\n      typeof opts.cache === 'object' &&\n      opts.cache !== null &&\n      !opts.cache.id\n    ) {\n      throw new Error(\n        'cache configuration requires an explicit id.\\n' +\n          'Example: cache: { id: \"my-cache-id\" }',\n      );\n    }\n\n    // Use the unified utils function to process cache configuration\n    const cacheConfig = processCacheConfig(\n      opts.cache,\n      opts.cacheId || opts.testId || 'default',\n    );\n\n    if (!cacheConfig) {\n      return null;\n    }\n\n    // Handle cache configuration object\n    if (typeof cacheConfig === 'object' && cacheConfig !== null) {\n      const id = cacheConfig.id;\n      const rawStrategy = cacheConfig.strategy as unknown;\n      let strategyValue: string;\n\n      if (rawStrategy === undefined) {\n        strategyValue = 'read-write';\n      } else if (typeof rawStrategy === 'string') {\n        strategyValue = rawStrategy;\n      } else {\n        throw new Error(\n          `cache.strategy must be a string when provided, but received type ${typeof rawStrategy}`,\n        );\n      }\n\n      if (!isValidCacheStrategy(strategyValue)) {\n        throw new Error(\n          `cache.strategy must be one of ${CACHE_STRATEGY_VALUES}, but received \"${strategyValue}\"`,\n        );\n      }\n\n      const isReadOnly = strategyValue === 'read-only';\n      const isWriteOnly = strategyValue === 'write-only';\n\n      return {\n        id,\n        enabled: !isWriteOnly,\n        readOnly: isReadOnly,\n        writeOnly: isWriteOnly,\n        cacheAdapter: cacheConfig.cacheAdapter,\n      };\n    }\n\n    return null;\n  }\n\n  private normalizeFilePaths(files: string[]): string[] {\n    if (ifInBrowser) {\n      throw new Error('File chooser is not supported in browser environment');\n    }\n\n    return files.map((file) => {\n      const absolutePath = resolve(file);\n      if (!existsSync(absolutePath)) {\n        throw new Error(`File not found: ${file}`);\n      }\n      return absolutePath;\n    });\n  }\n\n  private normalizeFileInput(files: string | string[]): string[] {\n    const filesArray = Array.isArray(files) ? files : [files];\n    return this.normalizeFilePaths(filesArray);\n  }\n\n  /**\n   * Manually flush cache to file\n   * @param options - Optional configuration\n   * @param options.cleanUnused - If true, removes unused cache records before flushing\n   */\n  async flushCache(options?: { cleanUnused?: boolean }): Promise<void> {\n    if (!this.taskCache) {\n      throw new Error('Cache is not configured');\n    }\n\n    this.taskCache.flushCacheToFile(options);\n  }\n}\n\nexport const createAgent = (\n  interfaceInstance: AbstractInterface,\n  opts?: AgentOpt,\n) => {\n  return new Agent(interfaceInstance, opts);\n};\n"],"names":["debug","getDebug","distanceOfTwoPoints","p1","p2","x1","y1","x2","y2","Math","includedInRect","point","rect","x","y","left","top","width","height","defaultServiceExtractOption","CACHE_STRATEGIES","isValidCacheStrategy","strategy","value","CACHE_STRATEGY_VALUES","legacyScrollTypeMap","normalizeScrollType","scrollType","defaultReplanningCycleLimit","defaultVlmUiTarsReplanningCycleLimit","defaultAutoGlmReplanningCycleLimit","Agent","callback","modelConfigForPlanning","undefined","isUITars","isAutoGLM","action","context","commonContextParser","prompt","console","GroupedActionDump","getVersion","WeakMap","execution","runner","currentDump","existingIndex","opt","ifInBrowser","reportHTMLContent","task","param","paramStr","tip","typeStr","name","type","actionPlan","plans","Boolean","title","taskTitleStr","locateParamStr","defaultIntentModelConfig","output","locatePrompt","assert","detailedLocateParam","buildDetailedLocateParam","fileChooserAccept","withFileChooser","locatePromptOrValue","locatePromptOrOpt","optOrUndefined","optWithValue","stringValue","String","mode","locatePromptOrKeyName","keyName","locatePromptOrScrollParam","scrollParam","normalizedScrollType","taskPrompt","abortSignal","Error","runAiAct","deepThink","deepLocate","noIndividualLocateModel","includeBboxInPlanning","cacheable","replanningCycleLimit","isVlmUiTars","isAutoGlm","matchedCache","yaml","imagesIncludeCount","actionOutput","yamlContent","yamlFlowStr","demand","modelConfig","textPrompt","multimodalPrompt","parsePrompt","center","verifyPrompt","retryLimit","success","retryCount","resultPrompt","verifyResult","text","locateOpt","expectCenter","verifyLocateOption","verifyCenter","verifyRect","distance","included","pass","locateParam","locatePlan","locatePlanForLocate","element","assertion","msg","serviceOpt","assertionText","thought","message","error","TaskExecutionError","errorTask","rawError","rawMessage","reason","args","yamlScriptContent","script","parseYamlScript","player","ScriptPlayer","errors","listener","index","base64","now","Date","screenshot","ScreenshotItem","recorder","uuid","executionDump","ExecutionDump","dumpString","groupName","groupDescription","executions","opts","cacheConfig","processCacheConfig","id","rawStrategy","strategyValue","isReadOnly","isWriteOnly","files","file","absolutePath","resolve","existsSync","filesArray","Array","options","interfaceInstance","envReplanningCycleLimit","globalConfigManager","MIDSCENE_REPLANNING_CYCLE_LIMIT","Object","Number","resolvedAiActContext","hasCustomConfig","ModelConfigManager","globalModelConfigManager","Service","cacheConfigObj","TaskCache","baseActionSpace","defineActionSleep","TaskExecutor","getReportFileName","ReportGenerator","createAgent"],"mappings":"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"}

package/dist/es/agent/utils.mjs

@@ -152,7 +152,7 @@ async function matchElementFromCache(context, cacheEntry, cachePrompt, cacheable
         return;
     }
 }
-const getMidsceneVersion = ()=>"1.5.9";
+const getMidsceneVersion = ()=>"1.5.10";
 const parsePrompt = (prompt)=>{
     if ('string' == typeof prompt) return {
         textPrompt: prompt,

package/dist/es/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","sources":["../../src/types.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport {\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  rmSync,\n  writeFileSync,\n} from 'node:fs';\nimport { join } from 'node:path';\nimport type { NodeType } from '@midscene/shared/constants';\nimport type { CreateOpenAIClientFn, TModelConfig } from '@midscene/shared/env';\nimport type {\n  BaseElement,\n  LocateResultElement,\n  Rect,\n  Size,\n} from '@midscene/shared/types';\nimport type { z } from 'zod';\nimport type { TUserPrompt } from './common';\nimport { restoreImageReferences } from './dump/image-restoration';\nimport { ScreenshotItem } from './screenshot-item';\nimport type {\n  DetailedLocateParam,\n  MidsceneYamlFlowItem,\n  ServiceExtractOption,\n} from './yaml';\n\nexport type {\n  ElementTreeNode,\n  BaseElement,\n  Rect,\n  Size,\n  Point,\n} from '@midscene/shared/types';\nexport * from './yaml';\n\nexport type AIUsageInfo = Record<string, any> & {\n  prompt_tokens: number | undefined;\n  completion_tokens: number | undefined;\n  total_tokens: number | undefined;\n  cached_input: number | undefined;\n  time_cost: number | undefined;\n  model_name: string | undefined;\n  model_description: string | undefined;\n  intent: string | undefined;\n  request_id: string | undefined;\n};\n\nexport type { LocateResultElement };\n\nexport type AISingleElementResponseByPosition = {\n  position?: {\n    x: number;\n    y: number;\n  };\n  bbox?: [number, number, number, number];\n  reason: string;\n  text: string;\n};\n\nexport interface AIElementCoordinatesResponse {\n  bbox: [number, number, number, number];\n  errors?: string[];\n}\n\nexport type AIElementResponse = AIElementCoordinatesResponse;\n\nexport interface AIDataExtractionResponse<DataDemand> {\n  data: DataDemand;\n  errors?: string[];\n  thought?: string;\n}\n\nexport interface AISectionLocatorResponse {\n  bbox: [number, number, number, number];\n  references_bbox?: [number, number, number, number][];\n  error?: string;\n}\n\nexport interface AIAssertionResponse {\n  pass: boolean;\n  thought: string;\n}\n\nexport interface AIDescribeElementResponse {\n  description: string;\n  error?: string;\n}\n\nexport interface LocatorValidatorOption {\n  centerDistanceThreshold?: number;\n}\n\nexport interface LocateValidatorResult {\n  pass: boolean;\n  rect: Rect;\n  center: [number, number];\n  centerDistance?: number;\n}\n\nexport interface AgentDescribeElementAtPointResult {\n  prompt: string;\n  deepLocate: boolean;\n  verifyResult?: LocateValidatorResult;\n}\n\n/**\n * context\n */\n\nexport abstract class UIContext {\n  /**\n   * screenshot of the current UI state. which size is shotSize(be shrunk by screenshotShrinkFactor),\n   */\n  abstract screenshot: ScreenshotItem;\n\n  /**\n   * screenshot size after shrinking\n   */\n  abstract shotSize: Size;\n\n  /**\n   * The ratio for converting shrunk screenshot coordinates to logical coordinates.\n   *\n   * Example:\n   * - Physical screen width: 3000px, dpr=6\n   * - Logical width: 500px\n   * - User-defined screenshotShrinkFactor: 2\n   * - Actual shrunk screenshot width: 3000 / 2 = 1500px\n   * - shrunkShotToLogicalRatio: dpr / screenshotShrinkFactor = 6 / 2 = 3\n   * - To map back to logical coordinates: 1500 / shrunkShotToLogicalRatio = 500px\n   */\n  abstract shrunkShotToLogicalRatio: number;\n\n  abstract _isFrozen?: boolean;\n\n  // @deprecated - backward compatibility for aiLocate\n  abstract deprecatedDpr?: number;\n}\n\nexport type EnsureObject<T> = { [K in keyof T]: any };\n\nexport type ServiceAction = 'locate' | 'extract' | 'assert' | 'describe';\n\nexport type ServiceExtractParam = string | Record<string, string>;\n\nexport type ElementCacheFeature = Record<string, unknown>;\n\nexport interface LocateResult {\n  element: LocateResultElement | null;\n  rect?: Rect;\n}\n\nexport type ThinkingLevel = 'off' | 'medium' | 'high';\n\nexport type DeepThinkOption = 'unset' | true | false;\n\nexport interface ServiceTaskInfo {\n  durationMs: number;\n  formatResponse?: string;\n  rawResponse?: string;\n  usage?: AIUsageInfo;\n  searchArea?: Rect;\n  searchAreaRawResponse?: string;\n  searchAreaUsage?: AIUsageInfo;\n  reasoning_content?: string;\n}\n\nexport interface DumpMeta {\n  logTime: number;\n}\n\nexport interface ReportDumpWithAttributes {\n  dumpString: string;\n  attributes?: Record<string, any>;\n}\n\nexport interface ServiceDump extends DumpMeta {\n  type: 'locate' | 'extract' | 'assert';\n  logId: string;\n  userQuery: {\n    element?: TUserPrompt;\n    dataDemand?: ServiceExtractParam;\n    assertion?: TUserPrompt;\n  };\n  matchedElement: LocateResultElement[];\n  matchedRect?: Rect;\n  deepLocate?: boolean;\n  data: any;\n  assertionPass?: boolean;\n  assertionThought?: string;\n  taskInfo: ServiceTaskInfo;\n  error?: string;\n  output?: any;\n}\n\nexport type PartialServiceDumpFromSDK = Omit<\n  ServiceDump,\n  'logTime' | 'logId' | 'model_name'\n>;\n\nexport interface ServiceResultBase {\n  dump: ServiceDump;\n}\n\nexport type LocateResultWithDump = LocateResult & ServiceResultBase;\n\nexport interface ServiceExtractResult<T> extends ServiceResultBase {\n  data: T;\n  thought?: string;\n  usage?: AIUsageInfo;\n  reasoning_content?: string;\n}\n\nexport class ServiceError extends Error {\n  dump: ServiceDump;\n\n  constructor(message: string, dump: ServiceDump) {\n    super(message);\n    this.name = 'ServiceError';\n    this.dump = dump;\n  }\n}\n\n// intermediate variables to optimize the return value by AI\nexport interface LiteUISection {\n  name: string;\n  description: string;\n  sectionCharacteristics: string;\n  textIds: string[];\n}\n\nexport type ElementById = (id: string) => BaseElement | null;\n\nexport type ServiceAssertionResponse = AIAssertionResponse & {\n  usage?: AIUsageInfo;\n};\n\n/**\n * agent\n */\n\nexport type OnTaskStartTip = (tip: string) => Promise<void> | void;\n\nexport interface AgentWaitForOpt extends ServiceExtractOption {\n  checkIntervalMs?: number;\n  timeoutMs?: number;\n}\n\nexport interface AgentAssertOpt {\n  keepRawResponse?: boolean;\n}\n\n/**\n * planning\n *\n */\n\nexport interface PlanningLocateParam extends DetailedLocateParam {\n  bbox?: [number, number, number, number];\n}\n\nexport interface PlanningAction<ParamType = any> {\n  thought?: string;\n  log?: string; // a brief preamble to the user explaining what you’re about to do\n  type: string;\n  param: ParamType;\n}\n\nexport type SubGoalStatus = 'pending' | 'running' | 'finished';\n\nexport interface SubGoal {\n  index: number;\n  status: SubGoalStatus;\n  description: string;\n  logs?: string[];\n}\n\nexport interface RawResponsePlanningAIResponse {\n  action: PlanningAction;\n  thought?: string;\n  log: string;\n  memory?: string;\n  error?: string;\n  finalizeMessage?: string;\n  finalizeSuccess?: boolean;\n  updateSubGoals?: SubGoal[];\n  markFinishedIndexes?: number[];\n}\n\nexport interface PlanningAIResponse\n  extends Omit<RawResponsePlanningAIResponse, 'action'> {\n  actions?: PlanningAction[];\n  usage?: AIUsageInfo;\n  rawResponse?: string;\n  yamlFlow?: MidsceneYamlFlowItem[];\n  yamlString?: string;\n  error?: string;\n  reasoning_content?: string;\n  shouldContinuePlanning: boolean;\n  output?: string; // Output message from <complete> tag (same as finalizeMessage)\n}\n\nexport interface PlanningActionParamSleep {\n  timeMs: number;\n}\n\nexport interface PlanningActionParamError {\n  thought: string;\n}\n\nexport type PlanningActionParamWaitFor = AgentWaitForOpt & {};\n\nexport interface LongPressParam {\n  duration?: number;\n}\n\nexport interface PullParam {\n  direction: 'up' | 'down';\n  distance?: number;\n  duration?: number;\n}\n/**\n * misc\n */\n\nexport interface Color {\n  name: string;\n  hex: string;\n}\n\nexport interface BaseAgentParserOpt {\n  selector?: string;\n}\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\nexport interface PuppeteerParserOpt extends BaseAgentParserOpt {}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\nexport interface PlaywrightParserOpt extends BaseAgentParserOpt {}\n\n/*\naction\n*/\nexport interface ExecutionTaskProgressOptions {\n  onTaskStart?: (task: ExecutionTask) => Promise<void> | void;\n}\n\nexport interface ExecutionRecorderItem {\n  type: 'screenshot';\n  ts: number;\n  screenshot?: ScreenshotItem;\n  timing?: string;\n}\n\nexport type ExecutionTaskType = 'Planning' | 'Insight' | 'Action Space' | 'Log';\n\nexport interface ExecutorContext {\n  task: ExecutionTask;\n  element?: LocateResultElement | null;\n  uiContext?: UIContext;\n}\n\nexport interface ExecutionTaskApply<\n  Type extends ExecutionTaskType = any,\n  TaskParam = any,\n  TaskOutput = any,\n  TaskLog = any,\n> {\n  type: Type;\n  subType?: string;\n  param?: TaskParam;\n  thought?: string;\n  uiContext?: UIContext;\n  executor: (\n    param: TaskParam,\n    context: ExecutorContext,\n  ) => // biome-ignore lint/suspicious/noConfusingVoidType: void is intentionally allowed as some executors may not return a value\n    | Promise<ExecutionTaskReturn<TaskOutput, TaskLog> | undefined | void>\n    | undefined\n    | void;\n}\n\nexport interface ExecutionTaskHitBy {\n  from: string;\n  context: Record<string, any>;\n}\n\nexport interface ExecutionTaskReturn<TaskOutput = unknown, TaskLog = unknown> {\n  output?: TaskOutput;\n  log?: TaskLog;\n  recorder?: ExecutionRecorderItem[];\n  hitBy?: ExecutionTaskHitBy;\n}\n\nexport type ExecutionTask<\n  E extends ExecutionTaskApply<any, any, any> = ExecutionTaskApply<\n    any,\n    any,\n    any\n  >,\n> = E &\n  ExecutionTaskReturn<\n    E extends ExecutionTaskApply<any, any, infer TaskOutput, any>\n      ? TaskOutput\n      : unknown,\n    E extends ExecutionTaskApply<any, any, any, infer TaskLog>\n      ? TaskLog\n      : unknown\n  > & {\n    taskId: string;\n    status: 'pending' | 'running' | 'finished' | 'failed' | 'cancelled';\n    error?: Error;\n    errorMessage?: string;\n    errorStack?: string;\n    timing?: {\n      start: number;\n      getUiContextStart?: number;\n      getUiContextEnd?: number;\n      callAiStart?: number;\n      callAiEnd?: number;\n      beforeInvokeActionHookStart?: number;\n      beforeInvokeActionHookEnd?: number;\n      callActionStart?: number;\n      callActionEnd?: number;\n      afterInvokeActionHookStart?: number;\n      afterInvokeActionHookEnd?: number;\n      captureAfterCallingSnapshotStart?: number;\n      captureAfterCallingSnapshotEnd?: number;\n      end?: number;\n      cost?: number;\n    };\n    usage?: AIUsageInfo;\n    searchAreaUsage?: AIUsageInfo;\n    reasoning_content?: string;\n  };\n\nexport interface IExecutionDump extends DumpMeta {\n  name: string;\n  description?: string;\n  tasks: ExecutionTask[];\n  aiActContext?: string;\n}\n\n/**\n * Replacer function for JSON serialization that handles Page, Browser objects and ScreenshotItem\n */\nfunction replacerForDumpSerialization(_key: string, value: any): any {\n  if (value && value.constructor?.name === 'Page') {\n    return '[Page object]';\n  }\n  if (value && value.constructor?.name === 'Browser') {\n    return '[Browser object]';\n  }\n  // Handle ScreenshotItem serialization\n  if (value && typeof value.toSerializable === 'function') {\n    return value.toSerializable();\n  }\n  return value;\n}\n\n/**\n * Reviver function for JSON deserialization that handles ScreenshotItem formats.\n *\n * BEHAVIOR:\n * - For { $screenshot: \"id\" } format: Left as-is (plain object)\n *   Consumer must use imageMap to restore base64 data\n * - For { base64: \"...\" } format: Creates ScreenshotItem from base64 data\n *\n * @param key - JSON key being processed\n * @param value - JSON value being processed\n * @returns Restored value\n */\nfunction reviverForDumpDeserialization(key: string, value: any): any {\n  // Only process screenshot fields\n  if (key !== 'screenshot' || typeof value !== 'object' || value === null) {\n    return value;\n  }\n\n  // Handle serialized format: { $screenshot: \"id\" }\n  // Leave as plain object — consumer uses imageMap to restore\n  if (ScreenshotItem.isSerialized(value)) {\n    return value;\n  }\n\n  // Handle inline base64 format: { base64: \"...\" }\n  if ('base64' in value && typeof value.base64 === 'string') {\n    return value;\n  }\n\n  return value;\n}\n\n/**\n * ExecutionDump class for serializing and deserializing execution dumps\n */\nexport class ExecutionDump implements IExecutionDump {\n  logTime: number;\n  name: string;\n  description?: string;\n  tasks: ExecutionTask[];\n  aiActContext?: string;\n\n  constructor(data: IExecutionDump) {\n    this.logTime = data.logTime;\n    this.name = data.name;\n    this.description = data.description;\n    this.tasks = data.tasks;\n    this.aiActContext = data.aiActContext;\n  }\n\n  /**\n   * Serialize the ExecutionDump to a JSON string\n   */\n  serialize(indents?: number): string {\n    return JSON.stringify(this.toJSON(), replacerForDumpSerialization, indents);\n  }\n\n  /**\n   * Convert to a plain object for JSON serialization\n   */\n  toJSON(): IExecutionDump {\n    return {\n      logTime: this.logTime,\n      name: this.name,\n      description: this.description,\n      tasks: this.tasks.map((task) => ({\n        ...task,\n        recorder: task.recorder || [],\n      })),\n      aiActContext: this.aiActContext,\n    };\n  }\n\n  /**\n   * Create an ExecutionDump instance from a serialized JSON string\n   */\n  static fromSerializedString(serialized: string): ExecutionDump {\n    const parsed = JSON.parse(\n      serialized,\n      reviverForDumpDeserialization,\n    ) as IExecutionDump;\n    return new ExecutionDump(parsed);\n  }\n\n  /**\n   * Create an ExecutionDump instance from a plain object\n   */\n  static fromJSON(data: IExecutionDump): ExecutionDump {\n    return new ExecutionDump(data);\n  }\n\n  /**\n   * Collect all ScreenshotItem instances from tasks.\n   * Scans through uiContext and recorder items to find screenshots.\n   *\n   * @returns Array of ScreenshotItem instances\n   */\n  collectScreenshots(): ScreenshotItem[] {\n    const screenshots: ScreenshotItem[] = [];\n\n    for (const task of this.tasks) {\n      // Collect uiContext.screenshot if present\n      if (task.uiContext?.screenshot instanceof ScreenshotItem) {\n        screenshots.push(task.uiContext.screenshot);\n      }\n\n      // Collect recorder screenshots\n      if (task.recorder) {\n        for (const record of task.recorder) {\n          if (record.screenshot instanceof ScreenshotItem) {\n            screenshots.push(record.screenshot);\n          }\n        }\n      }\n    }\n\n    return screenshots;\n  }\n}\n\n/*\ntask - service-locate\n*/\nexport type ExecutionTaskInsightLocateParam = PlanningLocateParam;\n\nexport interface ExecutionTaskInsightLocateOutput {\n  element: LocateResultElement | null;\n}\n\nexport type ExecutionTaskInsightDump = ServiceDump;\n\nexport type ExecutionTaskInsightLocateApply = ExecutionTaskApply<\n  'Insight',\n  ExecutionTaskInsightLocateParam,\n  ExecutionTaskInsightLocateOutput,\n  ExecutionTaskInsightDump\n>;\n\nexport type ExecutionTaskInsightLocate =\n  ExecutionTask<ExecutionTaskInsightLocateApply>;\n\n/*\ntask - service-query\n*/\nexport interface ExecutionTaskInsightQueryParam {\n  dataDemand: ServiceExtractParam;\n}\n\nexport interface ExecutionTaskInsightQueryOutput {\n  data: any;\n}\n\nexport type ExecutionTaskInsightQueryApply = ExecutionTaskApply<\n  'Insight',\n  ExecutionTaskInsightQueryParam,\n  any,\n  ExecutionTaskInsightDump\n>;\n\nexport type ExecutionTaskInsightQuery =\n  ExecutionTask<ExecutionTaskInsightQueryApply>;\n\n/*\ntask - assertion\n*/\nexport interface ExecutionTaskInsightAssertionParam {\n  assertion: string;\n}\n\nexport type ExecutionTaskInsightAssertionApply = ExecutionTaskApply<\n  'Insight',\n  ExecutionTaskInsightAssertionParam,\n  ServiceAssertionResponse,\n  ExecutionTaskInsightDump\n>;\n\nexport type ExecutionTaskInsightAssertion =\n  ExecutionTask<ExecutionTaskInsightAssertionApply>;\n\n/*\ntask - action (i.e. interact) \n*/\nexport type ExecutionTaskActionApply<ActionParam = any> = ExecutionTaskApply<\n  'Action Space',\n  ActionParam,\n  void,\n  void\n>;\n\nexport type ExecutionTaskAction = ExecutionTask<ExecutionTaskActionApply>;\n\n/*\ntask - Log\n*/\n\nexport type ExecutionTaskLogApply<\n  LogParam = {\n    content: string;\n  },\n> = ExecutionTaskApply<'Log', LogParam, void, void>;\n\nexport type ExecutionTaskLog = ExecutionTask<ExecutionTaskLogApply>;\n\n/*\ntask - planning\n*/\n\nexport type ExecutionTaskPlanningApply = ExecutionTaskApply<\n  'Planning',\n  {\n    userInstruction: string;\n    aiActContext?: string;\n  },\n  PlanningAIResponse\n>;\n\nexport type ExecutionTaskPlanning = ExecutionTask<ExecutionTaskPlanningApply>;\n\n/*\ntask - planning-locate\n*/\nexport type ExecutionTaskPlanningLocateParam = PlanningLocateParam;\n\nexport interface ExecutionTaskPlanningLocateOutput {\n  element: LocateResultElement | null;\n}\n\nexport type ExecutionTaskPlanningDump = ServiceDump;\n\nexport type ExecutionTaskPlanningLocateApply = ExecutionTaskApply<\n  'Planning',\n  ExecutionTaskPlanningLocateParam,\n  ExecutionTaskPlanningLocateOutput,\n  ExecutionTaskPlanningDump\n>;\n\nexport type ExecutionTaskPlanningLocate =\n  ExecutionTask<ExecutionTaskPlanningLocateApply>;\n\n/*\nGrouped dump\n*/\nexport interface IGroupedActionDump {\n  sdkVersion: string;\n  groupName: string;\n  groupDescription?: string;\n  modelBriefs: string[];\n  executions: IExecutionDump[];\n  deviceType?: string;\n}\n\n/**\n * GroupedActionDump class for serializing and deserializing grouped action dumps\n */\nexport class GroupedActionDump implements IGroupedActionDump {\n  sdkVersion: string;\n  groupName: string;\n  groupDescription?: string;\n  modelBriefs: string[];\n  executions: ExecutionDump[];\n  deviceType?: string;\n\n  constructor(data: IGroupedActionDump) {\n    this.sdkVersion = data.sdkVersion;\n    this.groupName = data.groupName;\n    this.groupDescription = data.groupDescription;\n    this.modelBriefs = data.modelBriefs;\n    this.executions = data.executions.map((exec) =>\n      exec instanceof ExecutionDump ? exec : ExecutionDump.fromJSON(exec),\n    );\n    this.deviceType = data.deviceType;\n  }\n\n  /**\n   * Serialize the GroupedActionDump to a JSON string\n   * Uses compact { $screenshot: id } format\n   */\n  serialize(indents?: number): string {\n    return JSON.stringify(this.toJSON(), replacerForDumpSerialization, indents);\n  }\n\n  /**\n   * Serialize the GroupedActionDump with inline screenshots to a JSON string.\n   * Each ScreenshotItem is replaced with { base64: \"...\", capturedAt }.\n   */\n  serializeWithInlineScreenshots(indents?: number): string {\n    const processValue = (obj: unknown): unknown => {\n      if (obj instanceof ScreenshotItem) {\n        return { base64: obj.base64, capturedAt: obj.capturedAt };\n      }\n      if (Array.isArray(obj)) {\n        return obj.map(processValue);\n      }\n      if (obj && typeof obj === 'object') {\n        const entries = Object.entries(obj).map(([key, value]) => [\n          key,\n          processValue(value),\n        ]);\n        return Object.fromEntries(entries);\n      }\n      return obj;\n    };\n\n    const data = processValue(this.toJSON());\n    return JSON.stringify(data, null, indents);\n  }\n\n  /**\n   * Convert to a plain object for JSON serialization\n   */\n  toJSON(): IGroupedActionDump {\n    return {\n      sdkVersion: this.sdkVersion,\n      groupName: this.groupName,\n      groupDescription: this.groupDescription,\n      modelBriefs: this.modelBriefs,\n      executions: this.executions.map((exec) => exec.toJSON()),\n      deviceType: this.deviceType,\n    };\n  }\n\n  /**\n   * Create a GroupedActionDump instance from a serialized JSON string\n   */\n  static fromSerializedString(serialized: string): GroupedActionDump {\n    const parsed = JSON.parse(\n      serialized,\n      reviverForDumpDeserialization,\n    ) as IGroupedActionDump;\n    return new GroupedActionDump(parsed);\n  }\n\n  /**\n   * Create a GroupedActionDump instance from a plain object\n   */\n  static fromJSON(data: IGroupedActionDump): GroupedActionDump {\n    return new GroupedActionDump(data);\n  }\n\n  /**\n   * Collect all ScreenshotItem instances from all executions.\n   *\n   * @returns Array of all ScreenshotItem instances across all executions\n   */\n  collectAllScreenshots(): ScreenshotItem[] {\n    const screenshots: ScreenshotItem[] = [];\n    for (const execution of this.executions) {\n      screenshots.push(...execution.collectScreenshots());\n    }\n    return screenshots;\n  }\n\n  /**\n   * Serialize the dump to files with screenshots as separate PNG files.\n   * Creates:\n   * - {basePath} - dump JSON with { $screenshot: id } references\n   * - {basePath}.screenshots/ - PNG files\n   * - {basePath}.screenshots.json - ID to path mapping\n   *\n   * @param basePath - Base path for the dump file\n   */\n  serializeToFiles(basePath: string): void {\n    const screenshotsDir = `${basePath}.screenshots`;\n    if (!existsSync(screenshotsDir)) {\n      mkdirSync(screenshotsDir, { recursive: true });\n    }\n\n    // Write screenshots to separate files\n    const screenshotMap: Record<string, string> = {};\n    const screenshots = this.collectAllScreenshots();\n\n    for (const screenshot of screenshots) {\n      if (screenshot.hasBase64()) {\n        const imagePath = join(\n          screenshotsDir,\n          `${screenshot.id}.${screenshot.extension}`,\n        );\n        const rawBase64 = screenshot.rawBase64;\n        writeFileSync(imagePath, Buffer.from(rawBase64, 'base64'));\n        screenshotMap[screenshot.id] = imagePath;\n      }\n    }\n\n    // Write screenshot map file\n    writeFileSync(\n      `${basePath}.screenshots.json`,\n      JSON.stringify(screenshotMap),\n      'utf-8',\n    );\n\n    // Write dump JSON with references\n    writeFileSync(basePath, this.serialize(), 'utf-8');\n  }\n\n  /**\n   * Read dump from files and return JSON string with inline screenshots.\n   * Reads the dump JSON and screenshot files, then inlines the base64 data.\n   *\n   * @param basePath - Base path for the dump file\n   * @returns JSON string with inline screenshots ({ base64: \"...\" } format)\n   */\n  static fromFilesAsInlineJson(basePath: string): string {\n    const dumpString = readFileSync(basePath, 'utf-8');\n    const screenshotsMapPath = `${basePath}.screenshots.json`;\n\n    if (!existsSync(screenshotsMapPath)) {\n      return dumpString;\n    }\n\n    // Read screenshot map and build imageMap from files\n    const screenshotMap: Record<string, string> = JSON.parse(\n      readFileSync(screenshotsMapPath, 'utf-8'),\n    );\n\n    const imageMap: Record<string, string> = {};\n    for (const [id, filePath] of Object.entries(screenshotMap)) {\n      if (existsSync(filePath)) {\n        const data = readFileSync(filePath);\n        const mime =\n          filePath.endsWith('.jpeg') || filePath.endsWith('.jpg')\n            ? 'jpeg'\n            : 'png';\n        imageMap[id] = `data:image/${mime};base64,${data.toString('base64')}`;\n      }\n    }\n\n    // Restore image references\n    const dumpData = JSON.parse(dumpString);\n    const processedData = restoreImageReferences(\n      dumpData,\n      (id) => imageMap[id] ?? '',\n    );\n    return JSON.stringify(processedData);\n  }\n\n  /**\n   * Clean up all files associated with a serialized dump.\n   *\n   * @param basePath - Base path for the dump file\n   */\n  static cleanupFiles(basePath: string): void {\n    const filesToClean = [\n      basePath,\n      `${basePath}.screenshots.json`,\n      `${basePath}.screenshots`,\n    ];\n\n    for (const filePath of filesToClean) {\n      try {\n        rmSync(filePath, { force: true, recursive: true });\n      } catch {\n        // Ignore errors - file may already be deleted\n      }\n    }\n  }\n\n  /**\n   * Get all file paths associated with a serialized dump.\n   *\n   * @param basePath - Base path for the dump file\n   * @returns Array of all associated file paths\n   */\n  static getFilePaths(basePath: string): string[] {\n    return [\n      basePath,\n      `${basePath}.screenshots.json`,\n      `${basePath}.screenshots`,\n    ];\n  }\n}\n\nexport type InterfaceType =\n  | 'puppeteer'\n  | 'playwright'\n  | 'static'\n  | 'chrome-extension-proxy'\n  | 'android'\n  | string;\n\nexport interface StreamingCodeGenerationOptions {\n  /** Whether to enable streaming output */\n  stream?: boolean;\n  /** Callback function to handle streaming chunks */\n  onChunk?: StreamingCallback;\n  /** Callback function to handle streaming completion */\n  onComplete?: (finalCode: string) => void;\n  /** Callback function to handle streaming errors */\n  onError?: (error: Error) => void;\n}\n\nexport type StreamingCallback = (chunk: CodeGenerationChunk) => void;\n\nexport interface CodeGenerationChunk {\n  /** The incremental content chunk */\n  content: string;\n  /** The reasoning content */\n  reasoning_content: string;\n  /** The accumulated content so far */\n  accumulated: string;\n  /** Whether this is the final chunk */\n  isComplete: boolean;\n  /** Token usage information if available */\n  usage?: AIUsageInfo;\n}\n\nexport interface StreamingAIResponse {\n  /** The final accumulated content */\n  content: string;\n  /** Token usage information */\n  usage?: AIUsageInfo;\n  /** Whether the response was streamed */\n  isStreamed: boolean;\n}\n\nexport interface DeviceAction<TParam = any, TReturn = any> {\n  name: string;\n  description?: string;\n  interfaceAlias?: string;\n  paramSchema?: z.ZodType<TParam>;\n  call: (param: TParam, context: ExecutorContext) => Promise<TReturn> | TReturn;\n  delayAfterRunner?: number;\n  /**\n   * An example param object for this action.\n   * Locate fields with { prompt } will automatically get bbox injected when needed.\n   */\n  sample?: { [K in keyof TParam]?: any };\n}\n\n/**\n * Type utilities for extracting types from DeviceAction definitions\n */\n\n/**\n * Extract parameter type from a DeviceAction\n */\nexport type ActionParam<Action extends DeviceAction<any, any>> =\n  Action extends DeviceAction<infer P, any> ? P : never;\n\n/**\n * Extract return type from a DeviceAction\n */\nexport type ActionReturn<Action extends DeviceAction<any, any>> =\n  Action extends DeviceAction<any, infer R> ? R : never;\n\n/**\n * Web-specific types\n */\nexport interface WebElementInfo extends BaseElement {\n  id: string;\n  attributes: {\n    nodeType: NodeType;\n    [key: string]: string;\n  };\n}\n\n/**\n * Agent\n */\n\nexport type CacheConfig = {\n  strategy?: 'read-only' | 'read-write' | 'write-only';\n  id: string;\n};\n\nexport type Cache =\n  | false // No read, no write\n  | true // Will throw error at runtime - deprecated\n  | CacheConfig; // Object configuration (requires explicit id)\n\nexport interface AgentOpt {\n  testId?: string;\n  // @deprecated\n  cacheId?: string; // Keep backward compatibility, but marked as deprecated\n  groupName?: string;\n  groupDescription?: string;\n  /* if auto generate report, default true */\n  generateReport?: boolean;\n  /* if auto print report msg, default true */\n  autoPrintReportMsg?: boolean;\n\n  /**\n   * Use directory-based report format with separate image files.\n   *\n   * When enabled:\n   * - Screenshots are saved as PNG files in a `screenshots/` subdirectory\n   * - Report is generated as `index.html` with relative image paths\n   * - Reduces memory usage and report file size\n   *\n   * IMPORTANT: 'html-and-external-assets' reports must be served via HTTP server\n   * (e.g., `npx serve ./report-dir`). The file:// protocol will not\n   * work due to browser CORS restrictions.\n   *\n   * @default 'single-html'\n   */\n  outputFormat?: 'single-html' | 'html-and-external-assets';\n\n  onTaskStartTip?: OnTaskStartTip;\n  aiActContext?: string;\n  aiActionContext?: string;\n  /* custom report file name */\n  reportFileName?: string;\n  modelConfig?: TModelConfig;\n  cache?: Cache;\n  /**\n   * Maximum number of replanning cycles for aiAct.\n   * Defaults to 20 (40 for `vlm-ui-tars`) when not provided.\n   * If omitted, the agent will also read `MIDSCENE_REPLANNING_CYCLE_LIMIT` for backward compatibility.\n   */\n  replanningCycleLimit?: number;\n\n  /**\n   * Wait time in milliseconds after each action execution.\n   * This allows the UI to settle and stabilize before the next action.\n   * Defaults to 300ms when not provided.\n   */\n  waitAfterAction?: number;\n\n  /**\n   * When set to true, Midscene will use the target device's time (Android/iOS)\n   * instead of the system time. Useful when the device time differs from the\n   * host machine. Default: false\n   */\n  useDeviceTimestamp?: boolean;\n\n  /**\n   * Custom screenshot shrink factor to reduce AI token usage.\n   * When set, the screenshot will be scaled down by this factor from the physical resolution.\n   *\n   * Example:\n   * - Physical screen width: 3000px, dpr=6\n   * - Logical width: 500px\n   * - screenshotShrinkFactor: 2\n   * - Actual shrunk screenshot width: 3000 / 2 = 1500px\n   * - AI analyzes the 1500px screenshot\n   * - Coordinates are transformed back to logical (500px) before actions execute\n   *\n   * Benefits:\n   * - Reduces token usage for high-resolution screenshots\n   * - Maintains accuracy by scaling coordinates appropriately\n   *\n   * Must be >= 1 (shrinking only, enlarging is not supported).\n   *\n   * @default 1 (no shrinking, uses original physical screenshot)\n   */\n  screenshotShrinkFactor?: number;\n\n  /**\n   * Custom OpenAI client factory function\n   *\n   * If provided, this function will be called to create OpenAI client instances\n   * for each AI call, allowing you to:\n   * - Wrap clients with observability tools (langsmith, langfuse)\n   * - Use custom OpenAI-compatible clients\n   * - Apply different configurations based on intent\n   *\n   * @param config - Resolved model configuration\n   * @returns OpenAI client instance (original or wrapped)\n   *\n   * @example\n   * ```typescript\n   * createOpenAIClient: async (openai, opts) => {\n   *   // Wrap with langsmith for planning tasks\n   *   if (opts.baseURL?.includes('planning')) {\n   *     return wrapOpenAI(openai, { metadata: { task: 'planning' } });\n   *   }\n   *\n   *   return openai;\n   * }\n   * ```\n   */\n  createOpenAIClient?: CreateOpenAIClientFn;\n}\n\nexport type TestStatus =\n  | 'passed'\n  | 'failed'\n  | 'timedOut'\n  | 'skipped'\n  | 'interrupted';\n\nexport interface ReportFileWithAttributes {\n  reportFilePath: string;\n  reportAttributes: {\n    testDuration: number;\n    testStatus: TestStatus;\n    testTitle: string;\n    testId: string;\n    testDescription: string;\n  };\n}\n"],"names":["UIContext","ServiceError","Error","message","dump","replacerForDumpSerialization","_key","value","reviverForDumpDeserialization","key","ScreenshotItem","ExecutionDump","indents","JSON","task","serialized","parsed","data","screenshots","record","GroupedActionDump","processValue","obj","Array","entries","Object","exec","execution","basePath","screenshotsDir","existsSync","mkdirSync","screenshotMap","screenshot","imagePath","join","rawBase64","writeFileSync","Buffer","dumpString","readFileSync","screenshotsMapPath","imageMap","id","filePath","mime","dumpData","processedData","restoreImageReferences","filesToClean","rmSync"],"mappings":"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"}
+{"version":3,"file":"types.mjs","sources":["../../src/types.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport {\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  rmSync,\n  writeFileSync,\n} from 'node:fs';\nimport { join } from 'node:path';\nimport type { NodeType } from '@midscene/shared/constants';\nimport type { CreateOpenAIClientFn, TModelConfig } from '@midscene/shared/env';\nimport type {\n  BaseElement,\n  LocateResultElement,\n  Rect,\n  Size,\n} from '@midscene/shared/types';\nimport type { z } from 'zod';\nimport type { TUserPrompt } from './common';\nimport { restoreImageReferences } from './dump/image-restoration';\nimport { ScreenshotItem } from './screenshot-item';\nimport type {\n  DetailedLocateParam,\n  MidsceneYamlFlowItem,\n  ServiceExtractOption,\n} from './yaml';\n\nexport type {\n  ElementTreeNode,\n  BaseElement,\n  Rect,\n  Size,\n  Point,\n} from '@midscene/shared/types';\nexport * from './yaml';\n\nexport type AIUsageInfo = Record<string, any> & {\n  prompt_tokens: number | undefined;\n  completion_tokens: number | undefined;\n  total_tokens: number | undefined;\n  cached_input: number | undefined;\n  time_cost: number | undefined;\n  model_name: string | undefined;\n  model_description: string | undefined;\n  intent: string | undefined;\n  request_id: string | undefined;\n};\n\nexport type { LocateResultElement };\n\nexport type AISingleElementResponseByPosition = {\n  position?: {\n    x: number;\n    y: number;\n  };\n  bbox?: [number, number, number, number];\n  reason: string;\n  text: string;\n};\n\nexport interface AIElementCoordinatesResponse {\n  bbox: [number, number, number, number];\n  errors?: string[];\n}\n\nexport type AIElementResponse = AIElementCoordinatesResponse;\n\nexport interface AIDataExtractionResponse<DataDemand> {\n  data: DataDemand;\n  errors?: string[];\n  thought?: string;\n}\n\nexport interface AISectionLocatorResponse {\n  bbox: [number, number, number, number];\n  references_bbox?: [number, number, number, number][];\n  error?: string;\n}\n\nexport interface AIAssertionResponse {\n  pass: boolean;\n  thought: string;\n}\n\nexport interface AIDescribeElementResponse {\n  description: string;\n  error?: string;\n}\n\nexport interface LocatorValidatorOption {\n  centerDistanceThreshold?: number;\n}\n\nexport interface LocateValidatorResult {\n  pass: boolean;\n  rect: Rect;\n  center: [number, number];\n  centerDistance?: number;\n}\n\nexport interface AgentDescribeElementAtPointResult {\n  prompt: string;\n  deepLocate: boolean;\n  verifyResult?: LocateValidatorResult;\n}\n\n/**\n * context\n */\n\nexport abstract class UIContext {\n  /**\n   * screenshot of the current UI state. which size is shotSize(be shrunk by screenshotShrinkFactor),\n   */\n  abstract screenshot: ScreenshotItem;\n\n  /**\n   * screenshot size after shrinking\n   */\n  abstract shotSize: Size;\n\n  /**\n   * The ratio for converting shrunk screenshot coordinates to logical coordinates.\n   *\n   * Example:\n   * - Physical screen width: 3000px, dpr=6\n   * - Logical width: 500px\n   * - User-defined screenshotShrinkFactor: 2\n   * - Actual shrunk screenshot width: 3000 / 2 = 1500px\n   * - shrunkShotToLogicalRatio: dpr / screenshotShrinkFactor = 6 / 2 = 3\n   * - To map back to logical coordinates: 1500 / shrunkShotToLogicalRatio = 500px\n   */\n  abstract shrunkShotToLogicalRatio: number;\n\n  abstract _isFrozen?: boolean;\n\n  // @deprecated - backward compatibility for aiLocate\n  abstract deprecatedDpr?: number;\n}\n\nexport type EnsureObject<T> = { [K in keyof T]: any };\n\nexport type ServiceAction = 'locate' | 'extract' | 'assert' | 'describe';\n\nexport type ServiceExtractParam = string | Record<string, string>;\n\nexport type ElementCacheFeature = Record<string, unknown>;\n\nexport interface LocateResult {\n  element: LocateResultElement | null;\n  rect?: Rect;\n}\n\nexport type ThinkingLevel = 'off' | 'medium' | 'high';\n\nexport type DeepThinkOption = 'unset' | true | false;\n\nexport interface ServiceTaskInfo {\n  durationMs: number;\n  formatResponse?: string;\n  rawResponse?: string;\n  usage?: AIUsageInfo;\n  searchArea?: Rect;\n  searchAreaRawResponse?: string;\n  searchAreaUsage?: AIUsageInfo;\n  reasoning_content?: string;\n}\n\nexport interface DumpMeta {\n  logTime: number;\n}\n\nexport interface ReportDumpWithAttributes {\n  dumpString: string;\n  attributes?: Record<string, any>;\n}\n\nexport interface ServiceDump extends DumpMeta {\n  type: 'locate' | 'extract' | 'assert';\n  logId: string;\n  userQuery: {\n    element?: TUserPrompt;\n    dataDemand?: ServiceExtractParam;\n    assertion?: TUserPrompt;\n  };\n  matchedElement: LocateResultElement[];\n  matchedRect?: Rect;\n  deepLocate?: boolean;\n  data: any;\n  assertionPass?: boolean;\n  assertionThought?: string;\n  taskInfo: ServiceTaskInfo;\n  error?: string;\n  output?: any;\n}\n\nexport type PartialServiceDumpFromSDK = Omit<\n  ServiceDump,\n  'logTime' | 'logId' | 'model_name'\n>;\n\nexport interface ServiceResultBase {\n  dump: ServiceDump;\n}\n\nexport type LocateResultWithDump = LocateResult & ServiceResultBase;\n\nexport interface ServiceExtractResult<T> extends ServiceResultBase {\n  data: T;\n  thought?: string;\n  usage?: AIUsageInfo;\n  reasoning_content?: string;\n}\n\nexport class ServiceError extends Error {\n  dump: ServiceDump;\n\n  constructor(message: string, dump: ServiceDump) {\n    super(message);\n    this.name = 'ServiceError';\n    this.dump = dump;\n  }\n}\n\n// intermediate variables to optimize the return value by AI\nexport interface LiteUISection {\n  name: string;\n  description: string;\n  sectionCharacteristics: string;\n  textIds: string[];\n}\n\nexport type ElementById = (id: string) => BaseElement | null;\n\nexport type ServiceAssertionResponse = AIAssertionResponse & {\n  usage?: AIUsageInfo;\n};\n\n/**\n * agent\n */\n\nexport type OnTaskStartTip = (tip: string) => Promise<void> | void;\n\nexport interface AgentWaitForOpt extends ServiceExtractOption {\n  checkIntervalMs?: number;\n  timeoutMs?: number;\n}\n\nexport interface AgentAssertOpt {\n  keepRawResponse?: boolean;\n}\n\n/**\n * planning\n *\n */\n\nexport interface PlanningLocateParam extends DetailedLocateParam {\n  bbox?: [number, number, number, number];\n}\n\nexport interface PlanningAction<ParamType = any> {\n  thought?: string;\n  log?: string; // a brief preamble to the user explaining what you’re about to do\n  type: string;\n  param: ParamType;\n}\n\nexport type SubGoalStatus = 'pending' | 'running' | 'finished';\n\nexport interface SubGoal {\n  index: number;\n  status: SubGoalStatus;\n  description: string;\n  logs?: string[];\n}\n\nexport interface RawResponsePlanningAIResponse {\n  action: PlanningAction;\n  thought?: string;\n  log: string;\n  memory?: string;\n  error?: string;\n  finalizeMessage?: string;\n  finalizeSuccess?: boolean;\n  updateSubGoals?: SubGoal[];\n  markFinishedIndexes?: number[];\n}\n\nexport interface PlanningAIResponse\n  extends Omit<RawResponsePlanningAIResponse, 'action'> {\n  actions?: PlanningAction[];\n  usage?: AIUsageInfo;\n  rawResponse?: string;\n  yamlFlow?: MidsceneYamlFlowItem[];\n  yamlString?: string;\n  error?: string;\n  reasoning_content?: string;\n  shouldContinuePlanning: boolean;\n  output?: string; // Output message from <complete> tag (same as finalizeMessage)\n}\n\nexport interface PlanningActionParamSleep {\n  timeMs: number;\n}\n\nexport interface PlanningActionParamError {\n  thought: string;\n}\n\nexport type PlanningActionParamWaitFor = AgentWaitForOpt & {};\n\nexport interface LongPressParam {\n  duration?: number;\n}\n\nexport interface PullParam {\n  direction: 'up' | 'down';\n  distance?: number;\n  duration?: number;\n}\n/**\n * misc\n */\n\nexport interface Color {\n  name: string;\n  hex: string;\n}\n\nexport interface BaseAgentParserOpt {\n  selector?: string;\n}\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\nexport interface PuppeteerParserOpt extends BaseAgentParserOpt {}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\nexport interface PlaywrightParserOpt extends BaseAgentParserOpt {}\n\n/*\naction\n*/\nexport interface ExecutionTaskProgressOptions {\n  onTaskStart?: (task: ExecutionTask) => Promise<void> | void;\n}\n\nexport interface ExecutionRecorderItem {\n  type: 'screenshot';\n  ts: number;\n  screenshot?: ScreenshotItem;\n  timing?: string;\n}\n\nexport type ExecutionTaskType = 'Planning' | 'Insight' | 'Action Space' | 'Log';\n\nexport interface ExecutorContext {\n  task: ExecutionTask;\n  element?: LocateResultElement | null;\n  uiContext?: UIContext;\n}\n\nexport interface ExecutionTaskApply<\n  Type extends ExecutionTaskType = any,\n  TaskParam = any,\n  TaskOutput = any,\n  TaskLog = any,\n> {\n  type: Type;\n  subType?: string;\n  param?: TaskParam;\n  thought?: string;\n  uiContext?: UIContext;\n  executor: (\n    param: TaskParam,\n    context: ExecutorContext,\n  ) => // biome-ignore lint/suspicious/noConfusingVoidType: void is intentionally allowed as some executors may not return a value\n    | Promise<ExecutionTaskReturn<TaskOutput, TaskLog> | undefined | void>\n    | undefined\n    | void;\n}\n\nexport interface ExecutionTaskHitBy {\n  from: string;\n  context: Record<string, any>;\n}\n\nexport interface ExecutionTaskReturn<TaskOutput = unknown, TaskLog = unknown> {\n  output?: TaskOutput;\n  log?: TaskLog;\n  recorder?: ExecutionRecorderItem[];\n  hitBy?: ExecutionTaskHitBy;\n}\n\nexport type ExecutionTask<\n  E extends ExecutionTaskApply<any, any, any> = ExecutionTaskApply<\n    any,\n    any,\n    any\n  >,\n> = E &\n  ExecutionTaskReturn<\n    E extends ExecutionTaskApply<any, any, infer TaskOutput, any>\n      ? TaskOutput\n      : unknown,\n    E extends ExecutionTaskApply<any, any, any, infer TaskLog>\n      ? TaskLog\n      : unknown\n  > & {\n    taskId: string;\n    status: 'pending' | 'running' | 'finished' | 'failed' | 'cancelled';\n    error?: Error;\n    errorMessage?: string;\n    errorStack?: string;\n    timing?: {\n      start: number;\n      getUiContextStart?: number;\n      getUiContextEnd?: number;\n      callAiStart?: number;\n      callAiEnd?: number;\n      beforeInvokeActionHookStart?: number;\n      beforeInvokeActionHookEnd?: number;\n      callActionStart?: number;\n      callActionEnd?: number;\n      afterInvokeActionHookStart?: number;\n      afterInvokeActionHookEnd?: number;\n      captureAfterCallingSnapshotStart?: number;\n      captureAfterCallingSnapshotEnd?: number;\n      end?: number;\n      cost?: number;\n    };\n    usage?: AIUsageInfo;\n    searchAreaUsage?: AIUsageInfo;\n    reasoning_content?: string;\n  };\n\nexport interface IExecutionDump extends DumpMeta {\n  name: string;\n  description?: string;\n  tasks: ExecutionTask[];\n  aiActContext?: string;\n}\n\n/**\n * Replacer function for JSON serialization that handles Page, Browser objects and ScreenshotItem\n */\nfunction replacerForDumpSerialization(_key: string, value: any): any {\n  if (value && value.constructor?.name === 'Page') {\n    return '[Page object]';\n  }\n  if (value && value.constructor?.name === 'Browser') {\n    return '[Browser object]';\n  }\n  // Handle ScreenshotItem serialization\n  if (value && typeof value.toSerializable === 'function') {\n    return value.toSerializable();\n  }\n  return value;\n}\n\n/**\n * Reviver function for JSON deserialization that handles ScreenshotItem formats.\n *\n * BEHAVIOR:\n * - For { $screenshot: \"id\" } format: Left as-is (plain object)\n *   Consumer must use imageMap to restore base64 data\n * - For { base64: \"...\" } format: Creates ScreenshotItem from base64 data\n *\n * @param key - JSON key being processed\n * @param value - JSON value being processed\n * @returns Restored value\n */\nfunction reviverForDumpDeserialization(key: string, value: any): any {\n  // Only process screenshot fields\n  if (key !== 'screenshot' || typeof value !== 'object' || value === null) {\n    return value;\n  }\n\n  // Handle serialized format: { $screenshot: \"id\" }\n  // Leave as plain object — consumer uses imageMap to restore\n  if (ScreenshotItem.isSerialized(value)) {\n    return value;\n  }\n\n  // Handle inline base64 format: { base64: \"...\" }\n  if ('base64' in value && typeof value.base64 === 'string') {\n    return value;\n  }\n\n  return value;\n}\n\n/**\n * ExecutionDump class for serializing and deserializing execution dumps\n */\nexport class ExecutionDump implements IExecutionDump {\n  logTime: number;\n  name: string;\n  description?: string;\n  tasks: ExecutionTask[];\n  aiActContext?: string;\n\n  constructor(data: IExecutionDump) {\n    this.logTime = data.logTime;\n    this.name = data.name;\n    this.description = data.description;\n    this.tasks = data.tasks;\n    this.aiActContext = data.aiActContext;\n  }\n\n  /**\n   * Serialize the ExecutionDump to a JSON string\n   */\n  serialize(indents?: number): string {\n    return JSON.stringify(this.toJSON(), replacerForDumpSerialization, indents);\n  }\n\n  /**\n   * Convert to a plain object for JSON serialization\n   */\n  toJSON(): IExecutionDump {\n    return {\n      logTime: this.logTime,\n      name: this.name,\n      description: this.description,\n      tasks: this.tasks.map((task) => ({\n        ...task,\n        recorder: task.recorder || [],\n      })),\n      aiActContext: this.aiActContext,\n    };\n  }\n\n  /**\n   * Create an ExecutionDump instance from a serialized JSON string\n   */\n  static fromSerializedString(serialized: string): ExecutionDump {\n    const parsed = JSON.parse(\n      serialized,\n      reviverForDumpDeserialization,\n    ) as IExecutionDump;\n    return new ExecutionDump(parsed);\n  }\n\n  /**\n   * Create an ExecutionDump instance from a plain object\n   */\n  static fromJSON(data: IExecutionDump): ExecutionDump {\n    return new ExecutionDump(data);\n  }\n\n  /**\n   * Collect all ScreenshotItem instances from tasks.\n   * Scans through uiContext and recorder items to find screenshots.\n   *\n   * @returns Array of ScreenshotItem instances\n   */\n  collectScreenshots(): ScreenshotItem[] {\n    const screenshots: ScreenshotItem[] = [];\n\n    for (const task of this.tasks) {\n      // Collect uiContext.screenshot if present\n      if (task.uiContext?.screenshot instanceof ScreenshotItem) {\n        screenshots.push(task.uiContext.screenshot);\n      }\n\n      // Collect recorder screenshots\n      if (task.recorder) {\n        for (const record of task.recorder) {\n          if (record.screenshot instanceof ScreenshotItem) {\n            screenshots.push(record.screenshot);\n          }\n        }\n      }\n    }\n\n    return screenshots;\n  }\n}\n\n/*\ntask - service-locate\n*/\nexport type ExecutionTaskInsightLocateParam = PlanningLocateParam;\n\nexport interface ExecutionTaskInsightLocateOutput {\n  element: LocateResultElement | null;\n}\n\nexport type ExecutionTaskInsightDump = ServiceDump;\n\nexport type ExecutionTaskInsightLocateApply = ExecutionTaskApply<\n  'Insight',\n  ExecutionTaskInsightLocateParam,\n  ExecutionTaskInsightLocateOutput,\n  ExecutionTaskInsightDump\n>;\n\nexport type ExecutionTaskInsightLocate =\n  ExecutionTask<ExecutionTaskInsightLocateApply>;\n\n/*\ntask - service-query\n*/\nexport interface ExecutionTaskInsightQueryParam {\n  dataDemand: ServiceExtractParam;\n}\n\nexport interface ExecutionTaskInsightQueryOutput {\n  data: any;\n}\n\nexport type ExecutionTaskInsightQueryApply = ExecutionTaskApply<\n  'Insight',\n  ExecutionTaskInsightQueryParam,\n  any,\n  ExecutionTaskInsightDump\n>;\n\nexport type ExecutionTaskInsightQuery =\n  ExecutionTask<ExecutionTaskInsightQueryApply>;\n\n/*\ntask - assertion\n*/\nexport interface ExecutionTaskInsightAssertionParam {\n  assertion: string;\n}\n\nexport type ExecutionTaskInsightAssertionApply = ExecutionTaskApply<\n  'Insight',\n  ExecutionTaskInsightAssertionParam,\n  ServiceAssertionResponse,\n  ExecutionTaskInsightDump\n>;\n\nexport type ExecutionTaskInsightAssertion =\n  ExecutionTask<ExecutionTaskInsightAssertionApply>;\n\n/*\ntask - action (i.e. interact) \n*/\nexport type ExecutionTaskActionApply<ActionParam = any> = ExecutionTaskApply<\n  'Action Space',\n  ActionParam,\n  void,\n  void\n>;\n\nexport type ExecutionTaskAction = ExecutionTask<ExecutionTaskActionApply>;\n\n/*\ntask - Log\n*/\n\nexport type ExecutionTaskLogApply<\n  LogParam = {\n    content: string;\n  },\n> = ExecutionTaskApply<'Log', LogParam, void, void>;\n\nexport type ExecutionTaskLog = ExecutionTask<ExecutionTaskLogApply>;\n\n/*\ntask - planning\n*/\n\nexport type ExecutionTaskPlanningApply = ExecutionTaskApply<\n  'Planning',\n  {\n    userInstruction: string;\n    aiActContext?: string;\n  },\n  PlanningAIResponse\n>;\n\nexport type ExecutionTaskPlanning = ExecutionTask<ExecutionTaskPlanningApply>;\n\n/*\ntask - planning-locate\n*/\nexport type ExecutionTaskPlanningLocateParam = PlanningLocateParam;\n\nexport interface ExecutionTaskPlanningLocateOutput {\n  element: LocateResultElement | null;\n}\n\nexport type ExecutionTaskPlanningDump = ServiceDump;\n\nexport type ExecutionTaskPlanningLocateApply = ExecutionTaskApply<\n  'Planning',\n  ExecutionTaskPlanningLocateParam,\n  ExecutionTaskPlanningLocateOutput,\n  ExecutionTaskPlanningDump\n>;\n\nexport type ExecutionTaskPlanningLocate =\n  ExecutionTask<ExecutionTaskPlanningLocateApply>;\n\n/*\nGrouped dump\n*/\nexport interface IGroupedActionDump {\n  sdkVersion: string;\n  groupName: string;\n  groupDescription?: string;\n  modelBriefs: string[];\n  executions: IExecutionDump[];\n  deviceType?: string;\n}\n\n/**\n * GroupedActionDump class for serializing and deserializing grouped action dumps\n */\nexport class GroupedActionDump implements IGroupedActionDump {\n  sdkVersion: string;\n  groupName: string;\n  groupDescription?: string;\n  modelBriefs: string[];\n  executions: ExecutionDump[];\n  deviceType?: string;\n\n  constructor(data: IGroupedActionDump) {\n    this.sdkVersion = data.sdkVersion;\n    this.groupName = data.groupName;\n    this.groupDescription = data.groupDescription;\n    this.modelBriefs = data.modelBriefs;\n    this.executions = data.executions.map((exec) =>\n      exec instanceof ExecutionDump ? exec : ExecutionDump.fromJSON(exec),\n    );\n    this.deviceType = data.deviceType;\n  }\n\n  /**\n   * Serialize the GroupedActionDump to a JSON string\n   * Uses compact { $screenshot: id } format\n   */\n  serialize(indents?: number): string {\n    return JSON.stringify(this.toJSON(), replacerForDumpSerialization, indents);\n  }\n\n  /**\n   * Serialize the GroupedActionDump with inline screenshots to a JSON string.\n   * Each ScreenshotItem is replaced with { base64: \"...\", capturedAt }.\n   */\n  serializeWithInlineScreenshots(indents?: number): string {\n    const processValue = (obj: unknown): unknown => {\n      if (obj instanceof ScreenshotItem) {\n        return { base64: obj.base64, capturedAt: obj.capturedAt };\n      }\n      if (Array.isArray(obj)) {\n        return obj.map(processValue);\n      }\n      if (obj && typeof obj === 'object') {\n        const entries = Object.entries(obj).map(([key, value]) => [\n          key,\n          processValue(value),\n        ]);\n        return Object.fromEntries(entries);\n      }\n      return obj;\n    };\n\n    const data = processValue(this.toJSON());\n    return JSON.stringify(data, null, indents);\n  }\n\n  /**\n   * Convert to a plain object for JSON serialization\n   */\n  toJSON(): IGroupedActionDump {\n    return {\n      sdkVersion: this.sdkVersion,\n      groupName: this.groupName,\n      groupDescription: this.groupDescription,\n      modelBriefs: this.modelBriefs,\n      executions: this.executions.map((exec) => exec.toJSON()),\n      deviceType: this.deviceType,\n    };\n  }\n\n  /**\n   * Create a GroupedActionDump instance from a serialized JSON string\n   */\n  static fromSerializedString(serialized: string): GroupedActionDump {\n    const parsed = JSON.parse(\n      serialized,\n      reviverForDumpDeserialization,\n    ) as IGroupedActionDump;\n    return new GroupedActionDump(parsed);\n  }\n\n  /**\n   * Create a GroupedActionDump instance from a plain object\n   */\n  static fromJSON(data: IGroupedActionDump): GroupedActionDump {\n    return new GroupedActionDump(data);\n  }\n\n  /**\n   * Collect all ScreenshotItem instances from all executions.\n   *\n   * @returns Array of all ScreenshotItem instances across all executions\n   */\n  collectAllScreenshots(): ScreenshotItem[] {\n    const screenshots: ScreenshotItem[] = [];\n    for (const execution of this.executions) {\n      screenshots.push(...execution.collectScreenshots());\n    }\n    return screenshots;\n  }\n\n  /**\n   * Serialize the dump to files with screenshots as separate PNG files.\n   * Creates:\n   * - {basePath} - dump JSON with { $screenshot: id } references\n   * - {basePath}.screenshots/ - PNG files\n   * - {basePath}.screenshots.json - ID to path mapping\n   *\n   * @param basePath - Base path for the dump file\n   */\n  serializeToFiles(basePath: string): void {\n    const screenshotsDir = `${basePath}.screenshots`;\n    if (!existsSync(screenshotsDir)) {\n      mkdirSync(screenshotsDir, { recursive: true });\n    }\n\n    // Write screenshots to separate files\n    const screenshotMap: Record<string, string> = {};\n    const screenshots = this.collectAllScreenshots();\n\n    for (const screenshot of screenshots) {\n      if (screenshot.hasBase64()) {\n        const imagePath = join(\n          screenshotsDir,\n          `${screenshot.id}.${screenshot.extension}`,\n        );\n        const rawBase64 = screenshot.rawBase64;\n        writeFileSync(imagePath, Buffer.from(rawBase64, 'base64'));\n        screenshotMap[screenshot.id] = imagePath;\n      }\n    }\n\n    // Write screenshot map file\n    writeFileSync(\n      `${basePath}.screenshots.json`,\n      JSON.stringify(screenshotMap),\n      'utf-8',\n    );\n\n    // Write dump JSON with references\n    writeFileSync(basePath, this.serialize(), 'utf-8');\n  }\n\n  /**\n   * Read dump from files and return JSON string with inline screenshots.\n   * Reads the dump JSON and screenshot files, then inlines the base64 data.\n   *\n   * @param basePath - Base path for the dump file\n   * @returns JSON string with inline screenshots ({ base64: \"...\" } format)\n   */\n  static fromFilesAsInlineJson(basePath: string): string {\n    const dumpString = readFileSync(basePath, 'utf-8');\n    const screenshotsMapPath = `${basePath}.screenshots.json`;\n\n    if (!existsSync(screenshotsMapPath)) {\n      return dumpString;\n    }\n\n    // Read screenshot map and build imageMap from files\n    const screenshotMap: Record<string, string> = JSON.parse(\n      readFileSync(screenshotsMapPath, 'utf-8'),\n    );\n\n    const imageMap: Record<string, string> = {};\n    for (const [id, filePath] of Object.entries(screenshotMap)) {\n      if (existsSync(filePath)) {\n        const data = readFileSync(filePath);\n        const mime =\n          filePath.endsWith('.jpeg') || filePath.endsWith('.jpg')\n            ? 'jpeg'\n            : 'png';\n        imageMap[id] = `data:image/${mime};base64,${data.toString('base64')}`;\n      }\n    }\n\n    // Restore image references\n    const dumpData = JSON.parse(dumpString);\n    const processedData = restoreImageReferences(\n      dumpData,\n      (id) => imageMap[id] ?? '',\n    );\n    return JSON.stringify(processedData);\n  }\n\n  /**\n   * Clean up all files associated with a serialized dump.\n   *\n   * @param basePath - Base path for the dump file\n   */\n  static cleanupFiles(basePath: string): void {\n    const filesToClean = [\n      basePath,\n      `${basePath}.screenshots.json`,\n      `${basePath}.screenshots`,\n    ];\n\n    for (const filePath of filesToClean) {\n      try {\n        rmSync(filePath, { force: true, recursive: true });\n      } catch {\n        // Ignore errors - file may already be deleted\n      }\n    }\n  }\n\n  /**\n   * Get all file paths associated with a serialized dump.\n   *\n   * @param basePath - Base path for the dump file\n   * @returns Array of all associated file paths\n   */\n  static getFilePaths(basePath: string): string[] {\n    return [\n      basePath,\n      `${basePath}.screenshots.json`,\n      `${basePath}.screenshots`,\n    ];\n  }\n}\n\nexport type InterfaceType =\n  | 'puppeteer'\n  | 'playwright'\n  | 'static'\n  | 'chrome-extension-proxy'\n  | 'android'\n  | string;\n\nexport interface StreamingCodeGenerationOptions {\n  /** Whether to enable streaming output */\n  stream?: boolean;\n  /** Callback function to handle streaming chunks */\n  onChunk?: StreamingCallback;\n  /** Callback function to handle streaming completion */\n  onComplete?: (finalCode: string) => void;\n  /** Callback function to handle streaming errors */\n  onError?: (error: Error) => void;\n}\n\nexport type StreamingCallback = (chunk: CodeGenerationChunk) => void;\n\nexport interface CodeGenerationChunk {\n  /** The incremental content chunk */\n  content: string;\n  /** The reasoning content */\n  reasoning_content: string;\n  /** The accumulated content so far */\n  accumulated: string;\n  /** Whether this is the final chunk */\n  isComplete: boolean;\n  /** Token usage information if available */\n  usage?: AIUsageInfo;\n}\n\nexport interface StreamingAIResponse {\n  /** The final accumulated content */\n  content: string;\n  /** Token usage information */\n  usage?: AIUsageInfo;\n  /** Whether the response was streamed */\n  isStreamed: boolean;\n}\n\nexport interface DeviceAction<TParam = any, TReturn = any> {\n  name: string;\n  description?: string;\n  interfaceAlias?: string;\n  paramSchema?: z.ZodType<TParam>;\n  call: (param: TParam, context: ExecutorContext) => Promise<TReturn> | TReturn;\n  delayAfterRunner?: number;\n  /**\n   * An example param object for this action.\n   * Locate fields with { prompt } will automatically get bbox injected when needed.\n   */\n  sample?: { [K in keyof TParam]?: any };\n}\n\n/**\n * Type utilities for extracting types from DeviceAction definitions\n */\n\n/**\n * Extract parameter type from a DeviceAction\n */\nexport type ActionParam<Action extends DeviceAction<any, any>> =\n  Action extends DeviceAction<infer P, any> ? P : never;\n\n/**\n * Extract return type from a DeviceAction\n */\nexport type ActionReturn<Action extends DeviceAction<any, any>> =\n  Action extends DeviceAction<any, infer R> ? R : never;\n\n/**\n * Web-specific types\n */\nexport interface WebElementInfo extends BaseElement {\n  id: string;\n  attributes: {\n    nodeType: NodeType;\n    [key: string]: string;\n  };\n}\n\n/**\n * Agent\n */\n\nexport type CacheConfig = {\n  strategy?: 'read-only' | 'read-write' | 'write-only';\n  id: string;\n  cacheAdapter?: import('./agent/cache-adapter').CacheAdapter;\n};\n\nexport type Cache =\n  | false // No read, no write\n  | true // Will throw error at runtime - deprecated\n  | CacheConfig; // Object configuration (requires explicit id)\n\nexport interface AgentOpt {\n  testId?: string;\n  // @deprecated\n  cacheId?: string; // Keep backward compatibility, but marked as deprecated\n  groupName?: string;\n  groupDescription?: string;\n  /* if auto generate report, default true */\n  generateReport?: boolean;\n  /* if auto print report msg, default true */\n  autoPrintReportMsg?: boolean;\n\n  /**\n   * Use directory-based report format with separate image files.\n   *\n   * When enabled:\n   * - Screenshots are saved as PNG files in a `screenshots/` subdirectory\n   * - Report is generated as `index.html` with relative image paths\n   * - Reduces memory usage and report file size\n   *\n   * IMPORTANT: 'html-and-external-assets' reports must be served via HTTP server\n   * (e.g., `npx serve ./report-dir`). The file:// protocol will not\n   * work due to browser CORS restrictions.\n   *\n   * @default 'single-html'\n   */\n  outputFormat?: 'single-html' | 'html-and-external-assets';\n\n  onTaskStartTip?: OnTaskStartTip;\n  aiActContext?: string;\n  aiActionContext?: string;\n  /* custom report file name */\n  reportFileName?: string;\n  modelConfig?: TModelConfig;\n  cache?: Cache;\n  /**\n   * Maximum number of replanning cycles for aiAct.\n   * Defaults to 20 (40 for `vlm-ui-tars`) when not provided.\n   * If omitted, the agent will also read `MIDSCENE_REPLANNING_CYCLE_LIMIT` for backward compatibility.\n   */\n  replanningCycleLimit?: number;\n\n  /**\n   * Wait time in milliseconds after each action execution.\n   * This allows the UI to settle and stabilize before the next action.\n   * Defaults to 300ms when not provided.\n   */\n  waitAfterAction?: number;\n\n  /**\n   * When set to true, Midscene will use the target device's time (Android/iOS)\n   * instead of the system time. Useful when the device time differs from the\n   * host machine. Default: false\n   */\n  useDeviceTimestamp?: boolean;\n\n  /**\n   * Custom screenshot shrink factor to reduce AI token usage.\n   * When set, the screenshot will be scaled down by this factor from the physical resolution.\n   *\n   * Example:\n   * - Physical screen width: 3000px, dpr=6\n   * - Logical width: 500px\n   * - screenshotShrinkFactor: 2\n   * - Actual shrunk screenshot width: 3000 / 2 = 1500px\n   * - AI analyzes the 1500px screenshot\n   * - Coordinates are transformed back to logical (500px) before actions execute\n   *\n   * Benefits:\n   * - Reduces token usage for high-resolution screenshots\n   * - Maintains accuracy by scaling coordinates appropriately\n   *\n   * Must be >= 1 (shrinking only, enlarging is not supported).\n   *\n   * @default 1 (no shrinking, uses original physical screenshot)\n   */\n  screenshotShrinkFactor?: number;\n\n  /**\n   * Custom OpenAI client factory function\n   *\n   * If provided, this function will be called to create OpenAI client instances\n   * for each AI call, allowing you to:\n   * - Wrap clients with observability tools (langsmith, langfuse)\n   * - Use custom OpenAI-compatible clients\n   * - Apply different configurations based on intent\n   *\n   * @param config - Resolved model configuration\n   * @returns OpenAI client instance (original or wrapped)\n   *\n   * @example\n   * ```typescript\n   * createOpenAIClient: async (openai, opts) => {\n   *   // Wrap with langsmith for planning tasks\n   *   if (opts.baseURL?.includes('planning')) {\n   *     return wrapOpenAI(openai, { metadata: { task: 'planning' } });\n   *   }\n   *\n   *   return openai;\n   * }\n   * ```\n   */\n  createOpenAIClient?: CreateOpenAIClientFn;\n}\n\nexport type TestStatus =\n  | 'passed'\n  | 'failed'\n  | 'timedOut'\n  | 'skipped'\n  | 'interrupted';\n\nexport interface ReportFileWithAttributes {\n  reportFilePath: string;\n  reportAttributes: {\n    testDuration: number;\n    testStatus: TestStatus;\n    testTitle: string;\n    testId: string;\n    testDescription: string;\n  };\n}\n"],"names":["UIContext","ServiceError","Error","message","dump","replacerForDumpSerialization","_key","value","reviverForDumpDeserialization","key","ScreenshotItem","ExecutionDump","indents","JSON","task","serialized","parsed","data","screenshots","record","GroupedActionDump","processValue","obj","Array","entries","Object","exec","execution","basePath","screenshotsDir","existsSync","mkdirSync","screenshotMap","screenshot","imagePath","join","rawBase64","writeFileSync","Buffer","dumpString","readFileSync","screenshotsMapPath","imageMap","id","filePath","mime","dumpData","processedData","restoreImageReferences","filesToClean","rmSync"],"mappings":"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"}

package/dist/es/utils.mjs

@@ -159,7 +159,7 @@ function stringifyDumpData(data, indents) {
     return JSON.stringify(data, replacerForPageObject, indents);
 }
 function getVersion() {
-    return "1.5.9";
+    return "1.5.10";
 }
 function debugLog(...message) {
     const debugMode = process.env[MIDSCENE_DEBUG_MODE];

package/dist/lib/agent/agent.js

@@ -641,7 +641,8 @@ class Agent {
                 id,
                 enabled: !isWriteOnly,
                 readOnly: isReadOnly,
-                writeOnly: isWriteOnly
+                writeOnly: isWriteOnly,
+                cacheAdapter: cacheConfig.cacheAdapter
             };
         }
         return null;
@@ -704,7 +705,7 @@ class Agent {
         this.onTaskStartTip = this.opts.onTaskStartTip;
         this.service = new (index_js_default())(async ()=>this.getUIContext());
         const cacheConfigObj = this.processCacheConfig(opts || {});
-        if (cacheConfigObj) this.taskCache = new external_task_cache_js_namespaceObject.TaskCache(cacheConfigObj.id, cacheConfigObj.enabled, void 0, {
+        if (cacheConfigObj) this.taskCache = new external_task_cache_js_namespaceObject.TaskCache(cacheConfigObj.id, cacheConfigObj.enabled, cacheConfigObj.cacheAdapter, {
             readOnly: cacheConfigObj.readOnly,
             writeOnly: cacheConfigObj.writeOnly
         });

package/dist/lib/agent/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent/agent.js","sources":["webpack/runtime/compat_get_default_export","webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../../src/agent/agent.ts"],"sourcesContent":["// getDefaultExport function for compatibility with non-ESM modules\n__webpack_require__.n = (module) => {\n\tvar getter = module && module.__esModule ?\n\t\t() => (module['default']) :\n\t\t() => (module);\n\t__webpack_require__.d(getter, { a: getter });\n\treturn getter;\n};\n","__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import type { TUserPrompt } from '../ai-model/index';\nimport { ScreenshotItem } from '../screenshot-item';\nimport Service from '../service/index';\n// Import types and values directly from their source files to avoid circular dependency\n// DO NOT import from '../index' as it creates a circular dependency:\n// index.ts -> agent/index.ts -> agent/agent.ts -> index.ts\nimport {\n  type ActionParam,\n  type ActionReturn,\n  type AgentAssertOpt,\n  type AgentDescribeElementAtPointResult,\n  type AgentOpt,\n  type AgentWaitForOpt,\n  type CacheConfig,\n  type DeepThinkOption,\n  type DeviceAction,\n  ExecutionDump,\n  type ExecutionRecorderItem,\n  type ExecutionTask,\n  type ExecutionTaskLog,\n  GroupedActionDump,\n  type LocateOption,\n  type LocateResultElement,\n  type LocateValidatorResult,\n  type LocatorValidatorOption,\n  type OnTaskStartTip,\n  type PlanningAction,\n  type Rect,\n  type ScrollParam,\n  type ServiceAction,\n  type ServiceExtractOption,\n  type ServiceExtractParam,\n  type UIContext,\n} from '../types';\nimport type { MidsceneYamlScript } from '../yaml';\nexport type TestStatus =\n  | 'passed'\n  | 'failed'\n  | 'timedOut'\n  | 'skipped'\n  | 'interrupted';\nimport { isAutoGLM, isUITars } from '@/ai-model/auto-glm/util';\nimport yaml from 'js-yaml';\n\nimport type { IReportGenerator } from '@/report-generator';\nimport { ReportGenerator } from '@/report-generator';\nimport { getVersion, processCacheConfig, reportHTMLContent } from '@/utils';\nimport {\n  ScriptPlayer,\n  buildDetailedLocateParam,\n  parseYamlScript,\n} from '../yaml/index';\n\nimport { existsSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport type { AbstractInterface } from '@/device';\nimport type { TaskRunner } from '@/task-runner';\nimport {\n  type IModelConfig,\n  MIDSCENE_REPLANNING_CYCLE_LIMIT,\n  ModelConfigManager,\n  globalConfigManager,\n  globalModelConfigManager,\n} from '@midscene/shared/env';\nimport { getDebug } from '@midscene/shared/logger';\nimport { assert, ifInBrowser, uuid } from '@midscene/shared/utils';\nimport { defineActionSleep } from '../device';\nimport { TaskCache } from './task-cache';\nimport {\n  TaskExecutionError,\n  TaskExecutor,\n  locatePlanForLocate,\n  withFileChooser,\n} from './tasks';\nimport { locateParamStr, paramStr, taskTitleStr, typeStr } from './ui-utils';\nimport { commonContextParser, getReportFileName, parsePrompt } from './utils';\n\nconst debug = getDebug('agent');\n\nconst distanceOfTwoPoints = (p1: [number, number], p2: [number, number]) => {\n  const [x1, y1] = p1;\n  const [x2, y2] = p2;\n  return Math.round(Math.sqrt((x1 - x2) ** 2 + (y1 - y2) ** 2));\n};\n\nconst includedInRect = (point: [number, number], rect: Rect) => {\n  const [x, y] = point;\n  const { left, top, width, height } = rect;\n  return x >= left && x <= left + width && y >= top && y <= top + height;\n};\n\nconst defaultServiceExtractOption: ServiceExtractOption = {\n  domIncluded: false,\n  screenshotIncluded: true,\n};\n\ntype CacheStrategy = NonNullable<CacheConfig['strategy']>;\n\nconst CACHE_STRATEGIES: readonly CacheStrategy[] = [\n  'read-only',\n  'read-write',\n  'write-only',\n];\n\nconst isValidCacheStrategy = (strategy: string): strategy is CacheStrategy =>\n  CACHE_STRATEGIES.some((value) => value === strategy);\n\nconst CACHE_STRATEGY_VALUES = CACHE_STRATEGIES.map(\n  (value) => `\"${value}\"`,\n).join(', ');\n\nconst legacyScrollTypeMap = {\n  once: 'singleAction',\n  untilBottom: 'scrollToBottom',\n  untilTop: 'scrollToTop',\n  untilRight: 'scrollToRight',\n  untilLeft: 'scrollToLeft',\n} as const;\n\ntype LegacyScrollType = keyof typeof legacyScrollTypeMap;\n\nconst normalizeScrollType = (\n  scrollType: ScrollParam['scrollType'] | LegacyScrollType | undefined,\n): ScrollParam['scrollType'] | undefined => {\n  if (!scrollType) {\n    return scrollType;\n  }\n\n  if (scrollType in legacyScrollTypeMap) {\n    return legacyScrollTypeMap[scrollType as LegacyScrollType];\n  }\n\n  return scrollType as ScrollParam['scrollType'];\n};\n\nconst defaultReplanningCycleLimit = 20;\nconst defaultVlmUiTarsReplanningCycleLimit = 40;\nconst defaultAutoGlmReplanningCycleLimit = 100;\n\nexport type AiActOptions = {\n  cacheable?: boolean;\n  fileChooserAccept?: string | string[];\n  deepThink?: DeepThinkOption;\n  deepLocate?: boolean;\n  abortSignal?: AbortSignal;\n};\n\nexport class Agent<\n  InterfaceType extends AbstractInterface = AbstractInterface,\n> {\n  interface: InterfaceType;\n\n  service: Service;\n\n  dump: GroupedActionDump;\n\n  reportFile?: string | null;\n\n  reportFileName?: string;\n\n  taskExecutor: TaskExecutor;\n\n  opts: AgentOpt;\n\n  /**\n   * If true, the agent will not perform any actions\n   */\n  dryMode = false;\n\n  onTaskStartTip?: OnTaskStartTip;\n\n  taskCache?: TaskCache;\n\n  private dumpUpdateListeners: Array<\n    (dump: string, executionDump?: ExecutionDump) => void\n  > = [];\n\n  get onDumpUpdate():\n    | ((dump: string, executionDump?: ExecutionDump) => void)\n    | undefined {\n    return this.dumpUpdateListeners[0];\n  }\n\n  set onDumpUpdate(callback:\n    | ((dump: string, executionDump?: ExecutionDump) => void)\n    | undefined) {\n    // Clear existing listeners\n    this.dumpUpdateListeners = [];\n    // Add callback to array if provided\n    if (callback) {\n      this.dumpUpdateListeners.push(callback);\n    }\n  }\n\n  destroyed = false;\n\n  modelConfigManager: ModelConfigManager;\n\n  /**\n   * Frozen page context for consistent AI operations\n   */\n  private frozenUIContext?: UIContext;\n\n  private get aiActContext(): string | undefined {\n    return this.opts.aiActContext ?? this.opts.aiActionContext;\n  }\n\n  /**\n   * Flag to track if VL model warning has been shown\n   */\n  private hasWarnedNonVLModel = false;\n\n  private executionDumpIndexByRunner = new WeakMap<TaskRunner, number>();\n\n  private fullActionSpace: DeviceAction[];\n\n  private reportGenerator: IReportGenerator;\n\n  // @deprecated use .interface instead\n  get page() {\n    return this.interface;\n  }\n\n  /**\n   * Ensures VL model warning is shown once when needed\n   */\n  private ensureVLModelWarning() {\n    if (\n      !this.hasWarnedNonVLModel &&\n      this.interface.interfaceType !== 'puppeteer' &&\n      this.interface.interfaceType !== 'playwright' &&\n      this.interface.interfaceType !== 'static' &&\n      this.interface.interfaceType !== 'chrome-extension-proxy' &&\n      this.interface.interfaceType !== 'page-over-chrome-extension-bridge'\n    ) {\n      this.modelConfigManager.throwErrorIfNonVLModel();\n      this.hasWarnedNonVLModel = true;\n    }\n  }\n\n  private resolveReplanningCycleLimit(\n    modelConfigForPlanning: IModelConfig,\n  ): number {\n    if (this.opts.replanningCycleLimit !== undefined) {\n      return this.opts.replanningCycleLimit;\n    }\n\n    return isUITars(modelConfigForPlanning.modelFamily)\n      ? defaultVlmUiTarsReplanningCycleLimit\n      : isAutoGLM(modelConfigForPlanning.modelFamily)\n        ? defaultAutoGlmReplanningCycleLimit\n        : defaultReplanningCycleLimit;\n  }\n\n  constructor(interfaceInstance: InterfaceType, opts?: AgentOpt) {\n    this.interface = interfaceInstance;\n\n    const envReplanningCycleLimit =\n      globalConfigManager.getEnvConfigValueAsNumber(\n        MIDSCENE_REPLANNING_CYCLE_LIMIT,\n      );\n\n    this.opts = Object.assign(\n      {\n        generateReport: true,\n        autoPrintReportMsg: true,\n        groupName: 'Midscene Report',\n        groupDescription: '',\n      },\n      opts || {},\n      opts?.replanningCycleLimit === undefined &&\n        envReplanningCycleLimit !== undefined &&\n        !Number.isNaN(envReplanningCycleLimit)\n        ? { replanningCycleLimit: envReplanningCycleLimit }\n        : {},\n    );\n\n    const resolvedAiActContext =\n      this.opts.aiActContext ?? this.opts.aiActionContext;\n    if (resolvedAiActContext !== undefined) {\n      this.opts.aiActContext = resolvedAiActContext;\n      this.opts.aiActionContext ??= resolvedAiActContext;\n    }\n\n    if (\n      opts?.modelConfig &&\n      (typeof opts?.modelConfig !== 'object' || Array.isArray(opts.modelConfig))\n    ) {\n      throw new Error(\n        `opts.modelConfig must be a plain object map of env keys to values, but got ${typeof opts?.modelConfig}`,\n      );\n    }\n    // Create ModelConfigManager if modelConfig or createOpenAIClient is provided\n    // Otherwise, use the global config manager\n    const hasCustomConfig = opts?.modelConfig || opts?.createOpenAIClient;\n    this.modelConfigManager = hasCustomConfig\n      ? new ModelConfigManager(opts?.modelConfig, opts?.createOpenAIClient)\n      : globalModelConfigManager;\n\n    this.onTaskStartTip = this.opts.onTaskStartTip;\n\n    this.service = new Service(async () => {\n      return this.getUIContext();\n    });\n\n    // Process cache configuration\n    const cacheConfigObj = this.processCacheConfig(opts || {});\n    if (cacheConfigObj) {\n      this.taskCache = new TaskCache(\n        cacheConfigObj.id,\n        cacheConfigObj.enabled,\n        undefined, // cacheFilePath\n        {\n          readOnly: cacheConfigObj.readOnly,\n          writeOnly: cacheConfigObj.writeOnly,\n        },\n      );\n    }\n\n    const baseActionSpace = this.interface.actionSpace();\n    this.fullActionSpace = [...baseActionSpace, defineActionSleep()];\n\n    this.taskExecutor = new TaskExecutor(this.interface, this.service, {\n      taskCache: this.taskCache,\n      onTaskStart: this.callbackOnTaskStartTip.bind(this),\n      replanningCycleLimit: this.opts.replanningCycleLimit,\n      waitAfterAction: this.opts.waitAfterAction,\n      useDeviceTimestamp: this.opts.useDeviceTimestamp,\n      actionSpace: this.fullActionSpace,\n      hooks: {\n        onTaskUpdate: (runner) => {\n          const executionDump = runner.dump();\n          this.appendExecutionDump(executionDump, runner);\n\n          // Call all registered dump update listeners\n          const dumpString = this.dumpDataString();\n          for (const listener of this.dumpUpdateListeners) {\n            try {\n              listener(dumpString, executionDump);\n            } catch (error) {\n              console.error('Error in onDumpUpdate listener', error);\n            }\n          }\n\n          // Fire and forget - don't block task execution\n          this.writeOutActionDumps();\n        },\n      },\n    });\n    this.dump = this.resetDump();\n    this.reportFileName =\n      opts?.reportFileName ||\n      getReportFileName(opts?.testId || this.interface.interfaceType || 'web');\n\n    this.reportGenerator = ReportGenerator.create(this.reportFileName!, {\n      generateReport: this.opts.generateReport,\n      outputFormat: this.opts.outputFormat,\n      autoPrintReportMsg: this.opts.autoPrintReportMsg,\n    });\n  }\n\n  async getActionSpace(): Promise<DeviceAction[]> {\n    return this.fullActionSpace;\n  }\n\n  async getUIContext(action?: ServiceAction): Promise<UIContext> {\n    // Check VL model configuration when UI context is first needed\n    this.ensureVLModelWarning();\n\n    // If page context is frozen, return the frozen context for all actions\n    if (this.frozenUIContext) {\n      debug('Using frozen page context for action:', action);\n      return this.frozenUIContext;\n    }\n\n    // Get original context\n    const context = await commonContextParser(this.interface, {\n      uploadServerUrl: this.modelConfigManager.getUploadTestServerUrl(),\n      screenshotShrinkFactor: this.opts.screenshotShrinkFactor,\n    });\n\n    return context;\n  }\n\n  async _snapshotContext(): Promise<UIContext> {\n    return await this.getUIContext('locate');\n  }\n\n  /**\n   * @deprecated Use {@link setAIActContext} instead.\n   */\n  async setAIActionContext(prompt: string) {\n    await this.setAIActContext(prompt);\n  }\n\n  async setAIActContext(prompt: string) {\n    if (this.aiActContext) {\n      console.warn(\n        'aiActContext is already set, and it is called again, will override the previous setting',\n      );\n    }\n    this.opts.aiActContext = prompt;\n    this.opts.aiActionContext = prompt;\n  }\n\n  resetDump() {\n    this.dump = new GroupedActionDump({\n      sdkVersion: getVersion(),\n      groupName: this.opts.groupName!,\n      groupDescription: this.opts.groupDescription,\n      executions: [],\n      modelBriefs: [],\n      deviceType: this.interface.interfaceType,\n    });\n    this.executionDumpIndexByRunner = new WeakMap<TaskRunner, number>();\n\n    return this.dump;\n  }\n\n  appendExecutionDump(execution: ExecutionDump, runner?: TaskRunner) {\n    const currentDump = this.dump;\n    if (runner) {\n      const existingIndex = this.executionDumpIndexByRunner.get(runner);\n      if (existingIndex !== undefined) {\n        currentDump.executions[existingIndex] = execution;\n        return;\n      }\n      currentDump.executions.push(execution);\n      this.executionDumpIndexByRunner.set(\n        runner,\n        currentDump.executions.length - 1,\n      );\n      return;\n    }\n    currentDump.executions.push(execution);\n  }\n\n  dumpDataString(opt?: { inlineScreenshots?: boolean }) {\n    // update dump info\n    this.dump.groupName = this.opts.groupName!;\n    this.dump.groupDescription = this.opts.groupDescription;\n    // In browser environment, use inline screenshots since file system is not available\n    if (ifInBrowser || opt?.inlineScreenshots) {\n      return this.dump.serializeWithInlineScreenshots();\n    }\n    return this.dump.serialize();\n  }\n\n  reportHTMLString(opt?: { inlineScreenshots?: boolean }) {\n    // dumpDataString() handles browser environment with inline screenshots\n    return reportHTMLContent(this.dumpDataString(opt));\n  }\n\n  writeOutActionDumps() {\n    this.reportGenerator.onDumpUpdate(this.dump);\n    this.reportFile = this.reportGenerator.getReportPath();\n  }\n\n  private async callbackOnTaskStartTip(task: ExecutionTask) {\n    const param = paramStr(task);\n    const tip = param ? `${typeStr(task)} - ${param}` : typeStr(task);\n\n    if (this.onTaskStartTip) {\n      await this.onTaskStartTip(tip);\n    }\n  }\n\n  wrapActionInActionSpace<T extends DeviceAction>(\n    name: string,\n  ): (param: ActionParam<T>) => Promise<ActionReturn<T>> {\n    return async (param: ActionParam<T>) => {\n      return await this.callActionInActionSpace<ActionReturn<T>>(name, param);\n    };\n  }\n\n  async callActionInActionSpace<T = any>(\n    type: string,\n    opt?: T, // and all other action params\n  ) {\n    debug('callActionInActionSpace', type, ',', opt);\n\n    const actionPlan: PlanningAction<T> = {\n      type: type as any,\n      param: (opt as any) || {},\n      thought: '',\n    };\n    debug('actionPlan', actionPlan); // , ', in which the locateParam is', locateParam);\n\n    const plans: PlanningAction[] = [actionPlan].filter(\n      Boolean,\n    ) as PlanningAction[];\n\n    const title = taskTitleStr(\n      type as any,\n      locateParamStr((opt as any)?.locate || {}),\n    );\n\n    // assume all operation in action space is related to locating\n    const defaultIntentModelConfig =\n      this.modelConfigManager.getModelConfig('default');\n    const modelConfigForPlanning =\n      this.modelConfigManager.getModelConfig('planning');\n\n    const { output } = await this.taskExecutor.runPlans(\n      title,\n      plans,\n      modelConfigForPlanning,\n      defaultIntentModelConfig,\n    );\n    return output;\n  }\n\n  async aiTap(\n    locatePrompt: TUserPrompt,\n    opt?: LocateOption & { fileChooserAccept?: string | string[] },\n  ) {\n    assert(locatePrompt, 'missing locate prompt for tap');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    const fileChooserAccept = opt?.fileChooserAccept\n      ? this.normalizeFileInput(opt.fileChooserAccept)\n      : undefined;\n\n    return withFileChooser(this.interface, fileChooserAccept, async () => {\n      return this.callActionInActionSpace('Tap', {\n        locate: detailedLocateParam,\n      });\n    });\n  }\n\n  async aiRightClick(locatePrompt: TUserPrompt, opt?: LocateOption) {\n    assert(locatePrompt, 'missing locate prompt for right click');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    return this.callActionInActionSpace('RightClick', {\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiDoubleClick(locatePrompt: TUserPrompt, opt?: LocateOption) {\n    assert(locatePrompt, 'missing locate prompt for double click');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    return this.callActionInActionSpace('DoubleClick', {\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiHover(locatePrompt: TUserPrompt, opt?: LocateOption) {\n    assert(locatePrompt, 'missing locate prompt for hover');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    return this.callActionInActionSpace('Hover', {\n      locate: detailedLocateParam,\n    });\n  }\n\n  // New signature, always use locatePrompt as the first param\n  async aiInput(\n    locatePrompt: TUserPrompt,\n    opt: LocateOption & { value: string | number } & {\n      autoDismissKeyboard?: boolean;\n    } & { mode?: 'replace' | 'clear' | 'typeOnly' | 'append' },\n  ): Promise<any>;\n\n  // Legacy signature - deprecated\n  /**\n   * @deprecated Use aiInput(locatePrompt, opt) instead where opt contains the value\n   */\n  async aiInput(\n    value: string | number,\n    locatePrompt: TUserPrompt,\n    opt?: LocateOption & { autoDismissKeyboard?: boolean } & {\n      mode?: 'replace' | 'clear' | 'typeOnly' | 'append';\n    }, // AndroidDeviceInputOpt &\n  ): Promise<any>;\n\n  // Implementation\n  async aiInput(\n    locatePromptOrValue: TUserPrompt | string | number,\n    locatePromptOrOpt:\n      | TUserPrompt\n      | (LocateOption & { value: string | number } & {\n          autoDismissKeyboard?: boolean;\n        } & { mode?: 'replace' | 'clear' | 'typeOnly' | 'append' }) // AndroidDeviceInputOpt &\n      | undefined,\n    optOrUndefined?: LocateOption, // AndroidDeviceInputOpt &\n  ) {\n    let value: string | number;\n    let locatePrompt: TUserPrompt;\n    let opt:\n      | (LocateOption & { value: string | number } & {\n          autoDismissKeyboard?: boolean;\n        } & { mode?: 'replace' | 'clear' | 'typeOnly' | 'append' }) // AndroidDeviceInputOpt &\n      | undefined;\n\n    // Check if using new signature (first param is locatePrompt, second has value)\n    if (\n      typeof locatePromptOrOpt === 'object' &&\n      locatePromptOrOpt !== null &&\n      'value' in locatePromptOrOpt\n    ) {\n      // New signature: aiInput(locatePrompt, opt)\n      locatePrompt = locatePromptOrValue as TUserPrompt;\n      const optWithValue = locatePromptOrOpt as LocateOption & {\n        // AndroidDeviceInputOpt &\n        value: string | number;\n        autoDismissKeyboard?: boolean;\n      };\n      value = optWithValue.value;\n      opt = optWithValue;\n    } else {\n      // Legacy signature: aiInput(value, locatePrompt, opt)\n      value = locatePromptOrValue as string | number;\n      locatePrompt = locatePromptOrOpt as TUserPrompt;\n      opt = {\n        ...optOrUndefined,\n        value,\n      };\n    }\n\n    assert(\n      typeof value === 'string' || typeof value === 'number',\n      'input value must be a string or number, use empty string if you want to clear the input',\n    );\n    assert(locatePrompt, 'missing locate prompt for input');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    // Convert value to string to ensure consistency\n    const stringValue = typeof value === 'number' ? String(value) : value;\n\n    // backward compat: convert deprecated 'append' to 'typeOnly'\n    const mode = opt?.mode === 'append' ? 'typeOnly' : opt?.mode;\n\n    return this.callActionInActionSpace('Input', {\n      ...(opt || {}),\n      value: stringValue,\n      locate: detailedLocateParam,\n      mode,\n    });\n  }\n\n  // New signature\n  async aiKeyboardPress(\n    locatePrompt: TUserPrompt,\n    opt: LocateOption & { keyName: string },\n  ): Promise<any>;\n\n  // Legacy signature - deprecated\n  /**\n   * @deprecated Use aiKeyboardPress(locatePrompt, opt) instead where opt contains the keyName\n   */\n  async aiKeyboardPress(\n    keyName: string,\n    locatePrompt?: TUserPrompt,\n    opt?: LocateOption,\n  ): Promise<any>;\n\n  // Implementation\n  async aiKeyboardPress(\n    locatePromptOrKeyName: TUserPrompt | string,\n    locatePromptOrOpt:\n      | TUserPrompt\n      | (LocateOption & { keyName: string })\n      | undefined,\n    optOrUndefined?: LocateOption,\n  ) {\n    let keyName: string;\n    let locatePrompt: TUserPrompt | undefined;\n    let opt: (LocateOption & { keyName: string }) | undefined;\n\n    // Check if using new signature (first param is locatePrompt, second has keyName)\n    if (\n      typeof locatePromptOrOpt === 'object' &&\n      locatePromptOrOpt !== null &&\n      'keyName' in locatePromptOrOpt\n    ) {\n      // New signature: aiKeyboardPress(locatePrompt, opt)\n      locatePrompt = locatePromptOrKeyName as TUserPrompt;\n      opt = locatePromptOrOpt as LocateOption & {\n        keyName: string;\n      };\n    } else {\n      // Legacy signature: aiKeyboardPress(keyName, locatePrompt, opt)\n      keyName = locatePromptOrKeyName as string;\n      locatePrompt = locatePromptOrOpt as TUserPrompt | undefined;\n      opt = {\n        ...(optOrUndefined || {}),\n        keyName,\n      };\n    }\n\n    assert(opt?.keyName, 'missing keyName for keyboard press');\n\n    const detailedLocateParam = locatePrompt\n      ? buildDetailedLocateParam(locatePrompt, opt)\n      : undefined;\n\n    return this.callActionInActionSpace('KeyboardPress', {\n      ...(opt || {}),\n      locate: detailedLocateParam,\n    });\n  }\n\n  // New signature\n  async aiScroll(\n    locatePrompt: TUserPrompt | undefined,\n    opt: LocateOption & ScrollParam,\n  ): Promise<any>;\n\n  // Legacy signature - deprecated\n  /**\n   * @deprecated Use aiScroll(locatePrompt, opt) instead where opt contains the scroll parameters\n   */\n  async aiScroll(\n    scrollParam: ScrollParam,\n    locatePrompt?: TUserPrompt,\n    opt?: LocateOption,\n  ): Promise<any>;\n\n  // Implementation\n  async aiScroll(\n    locatePromptOrScrollParam: TUserPrompt | ScrollParam | undefined,\n    locatePromptOrOpt: TUserPrompt | (LocateOption & ScrollParam) | undefined,\n    optOrUndefined?: LocateOption,\n  ) {\n    let scrollParam: ScrollParam;\n    let locatePrompt: TUserPrompt | undefined;\n    let opt: LocateOption | undefined;\n\n    // Check if using new signature (first param is locatePrompt, second has scroll params)\n    if (\n      typeof locatePromptOrOpt === 'object' &&\n      ('direction' in locatePromptOrOpt ||\n        'scrollType' in locatePromptOrOpt ||\n        'distance' in locatePromptOrOpt)\n    ) {\n      // New signature: aiScroll(locatePrompt, opt)\n      locatePrompt = locatePromptOrScrollParam as TUserPrompt;\n      opt = locatePromptOrOpt as LocateOption & ScrollParam;\n    } else {\n      // Legacy signature: aiScroll(scrollParam, locatePrompt, opt)\n      scrollParam = locatePromptOrScrollParam as ScrollParam;\n      locatePrompt = locatePromptOrOpt as TUserPrompt | undefined;\n      opt = {\n        ...(optOrUndefined || {}),\n        ...(scrollParam || {}),\n      };\n    }\n\n    if (opt) {\n      const normalizedScrollType = normalizeScrollType(\n        (opt as ScrollParam).scrollType as\n          | ScrollParam['scrollType']\n          | LegacyScrollType\n          | undefined,\n      );\n\n      if (normalizedScrollType !== (opt as ScrollParam).scrollType) {\n        (opt as ScrollParam) = {\n          ...(opt || {}),\n          scrollType: normalizedScrollType as ScrollParam['scrollType'],\n        };\n      }\n    }\n\n    const detailedLocateParam = buildDetailedLocateParam(\n      locatePrompt || '',\n      opt,\n    );\n\n    return this.callActionInActionSpace('Scroll', {\n      ...(opt || {}),\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiAct(\n    taskPrompt: string,\n    opt?: AiActOptions,\n  ): Promise<string | undefined> {\n    const fileChooserAccept = opt?.fileChooserAccept\n      ? this.normalizeFileInput(opt.fileChooserAccept)\n      : undefined;\n\n    const abortSignal = opt?.abortSignal;\n    if (abortSignal?.aborted) {\n      throw new Error(\n        `aiAct aborted: ${abortSignal.reason || 'signal already aborted'}`,\n      );\n    }\n\n    const runAiAct = async () => {\n      const modelConfigForPlanning =\n        this.modelConfigManager.getModelConfig('planning');\n      const defaultIntentModelConfig =\n        this.modelConfigManager.getModelConfig('default');\n      const deepThink = opt?.deepThink === 'unset' ? undefined : opt?.deepThink;\n\n      const deepLocate = opt?.deepLocate;\n\n      const noIndividualLocateModel =\n        modelConfigForPlanning.modelName ===\n          defaultIntentModelConfig.modelName &&\n        modelConfigForPlanning.openaiBaseURL ===\n          defaultIntentModelConfig.openaiBaseURL;\n\n      const includeBboxInPlanning =\n        !deepThink && noIndividualLocateModel && !deepLocate;\n\n      debug('setting includeBboxInPlanning to', includeBboxInPlanning, {\n        deepThink,\n        noIndividualLocateModel,\n        deepLocate,\n      });\n\n      if (deepLocate && includeBboxInPlanning) {\n        console.warn(\n          'deepLocate option is ignored when includeBboxInPlanning is true (same model for planning and default intent without deepThink). Locate is already done during planning.',\n        );\n      }\n\n      const cacheable = opt?.cacheable;\n      const replanningCycleLimit = this.resolveReplanningCycleLimit(\n        modelConfigForPlanning,\n      );\n      // if vlm-ui-tars or auto-glm, plan cache is not used\n      const isVlmUiTars = isUITars(modelConfigForPlanning.modelFamily);\n      const isAutoGlm = isAutoGLM(modelConfigForPlanning.modelFamily);\n      const matchedCache =\n        isVlmUiTars || isAutoGlm || cacheable === false\n          ? undefined\n          : await this.taskCache?.matchPlanCache(taskPrompt);\n      if (\n        matchedCache &&\n        this.taskCache?.isCacheResultUsed &&\n        matchedCache.cacheContent?.yamlWorkflow?.trim()\n      ) {\n        // log into report file\n        await this.taskExecutor.loadYamlFlowAsPlanning(\n          taskPrompt,\n          matchedCache.cacheContent.yamlWorkflow,\n        );\n\n        debug('matched cache, will call .runYaml to run the action');\n        const yaml = matchedCache.cacheContent.yamlWorkflow;\n        await this.runYaml(yaml);\n        return;\n      }\n\n      // If cache matched but yamlWorkflow is empty, fall through to normal execution\n      const imagesIncludeCount: number = deepThink ? 2 : 1;\n      const { output: actionOutput } = await this.taskExecutor.action(\n        taskPrompt,\n        modelConfigForPlanning,\n        defaultIntentModelConfig,\n        includeBboxInPlanning,\n        this.aiActContext,\n        cacheable,\n        replanningCycleLimit,\n        imagesIncludeCount,\n        deepThink,\n        fileChooserAccept,\n        includeBboxInPlanning ? undefined : deepLocate,\n        abortSignal,\n      );\n\n      // update cache\n      if (this.taskCache && actionOutput?.yamlFlow && cacheable !== false) {\n        const yamlContent: MidsceneYamlScript = {\n          tasks: [\n            {\n              name: taskPrompt,\n              flow: actionOutput.yamlFlow,\n            },\n          ],\n        };\n        const yamlFlowStr = yaml.dump(yamlContent);\n        this.taskCache.updateOrAppendCacheRecord(\n          {\n            type: 'plan',\n            prompt: taskPrompt,\n            yamlWorkflow: yamlFlowStr,\n          },\n          matchedCache,\n        );\n      }\n\n      return actionOutput?.output;\n    };\n\n    return await runAiAct();\n  }\n\n  /**\n   * @deprecated Use {@link Agent.aiAct} instead.\n   */\n  async aiAction(taskPrompt: string, opt?: AiActOptions) {\n    return this.aiAct(taskPrompt, opt);\n  }\n\n  async aiQuery<ReturnType = any>(\n    demand: ServiceExtractParam,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<ReturnType> {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'Query',\n      demand,\n      modelConfig,\n      opt,\n    );\n    return output as ReturnType;\n  }\n\n  async aiBoolean(\n    prompt: TUserPrompt,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<boolean> {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'Boolean',\n      textPrompt,\n      modelConfig,\n      opt,\n      multimodalPrompt,\n    );\n    return output as boolean;\n  }\n\n  async aiNumber(\n    prompt: TUserPrompt,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<number> {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'Number',\n      textPrompt,\n      modelConfig,\n      opt,\n      multimodalPrompt,\n    );\n    return output as number;\n  }\n\n  async aiString(\n    prompt: TUserPrompt,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<string> {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'String',\n      textPrompt,\n      modelConfig,\n      opt,\n      multimodalPrompt,\n    );\n    return output as string;\n  }\n\n  async aiAsk(\n    prompt: TUserPrompt,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<string> {\n    return this.aiString(prompt, opt);\n  }\n\n  async describeElementAtPoint(\n    center: [number, number],\n    opt?: {\n      verifyPrompt?: boolean;\n      retryLimit?: number;\n      deepLocate?: boolean;\n    } & LocatorValidatorOption,\n  ): Promise<AgentDescribeElementAtPointResult> {\n    const { verifyPrompt = true, retryLimit = 3 } = opt || {};\n\n    let success = false;\n    let retryCount = 0;\n    let resultPrompt = '';\n    let deepLocate = opt?.deepLocate || false;\n    let verifyResult: LocateValidatorResult | undefined;\n\n    while (!success && retryCount < retryLimit) {\n      if (retryCount >= 2) {\n        deepLocate = true;\n      }\n      debug(\n        'aiDescribe',\n        center,\n        'verifyPrompt',\n        verifyPrompt,\n        'retryCount',\n        retryCount,\n        'deepLocate',\n        deepLocate,\n      );\n      // use same intent as aiLocate\n      const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n      const text = await this.service.describe(center, modelConfig, {\n        deepLocate,\n      });\n      debug('aiDescribe text', text);\n      assert(text.description, `failed to describe element at [${center}]`);\n      resultPrompt = text.description;\n\n      // Don't pass deepLocate to verification locate — the description was generated\n      // from a cropped view (deepLocate describe), but verification should use regular\n      // locate on the full screenshot to confirm the description works universally.\n      // Passing deepLocate here would trigger AiLocateSection with an element-level\n      // description as a section prompt, which is semantically incorrect.\n      verifyResult = await this.verifyLocator(\n        resultPrompt,\n        undefined,\n        center,\n        opt,\n      );\n      if (verifyResult.pass) {\n        success = true;\n      } else {\n        retryCount++;\n      }\n    }\n\n    return {\n      prompt: resultPrompt,\n      deepLocate,\n      verifyResult,\n    };\n  }\n\n  async verifyLocator(\n    prompt: string,\n    locateOpt: LocateOption | undefined,\n    expectCenter: [number, number],\n    verifyLocateOption?: LocatorValidatorOption,\n  ): Promise<LocateValidatorResult> {\n    debug('verifyLocator', prompt, locateOpt, expectCenter, verifyLocateOption);\n\n    const { center: verifyCenter, rect: verifyRect } = await this.aiLocate(\n      prompt,\n      locateOpt,\n    );\n    const distance = distanceOfTwoPoints(expectCenter, verifyCenter);\n    const included = includedInRect(expectCenter, verifyRect);\n    const pass =\n      distance <= (verifyLocateOption?.centerDistanceThreshold || 20) ||\n      included;\n    const verifyResult = {\n      pass,\n      rect: verifyRect,\n      center: verifyCenter,\n      centerDistance: distance,\n    };\n    debug('aiDescribe verifyResult', verifyResult);\n    return verifyResult;\n  }\n\n  async aiLocate(prompt: TUserPrompt, opt?: LocateOption) {\n    const locateParam = buildDetailedLocateParam(prompt, opt);\n    assert(locateParam, 'cannot get locate param for aiLocate');\n    const locatePlan = locatePlanForLocate(locateParam);\n    const plans = [locatePlan];\n    const defaultIntentModelConfig =\n      this.modelConfigManager.getModelConfig('default');\n    const modelConfigForPlanning =\n      this.modelConfigManager.getModelConfig('planning');\n\n    const { output } = await this.taskExecutor.runPlans(\n      taskTitleStr('Locate', locateParamStr(locateParam)),\n      plans,\n      modelConfigForPlanning,\n      defaultIntentModelConfig,\n    );\n\n    const { element } = output;\n\n    return {\n      rect: element?.rect,\n      center: element?.center,\n      dpr: element?.dpr,\n    } as Pick<LocateResultElement, 'rect' | 'center'>;\n  }\n\n  async aiAssert(\n    assertion: TUserPrompt,\n    msg?: string,\n    opt?: AgentAssertOpt & ServiceExtractOption,\n  ) {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n    const serviceOpt: ServiceExtractOption = {\n      domIncluded: opt?.domIncluded ?? defaultServiceExtractOption.domIncluded,\n      screenshotIncluded:\n        opt?.screenshotIncluded ??\n        defaultServiceExtractOption.screenshotIncluded,\n    };\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(assertion);\n    const assertionText =\n      typeof assertion === 'string' ? assertion : assertion.prompt;\n\n    try {\n      const { output, thought } =\n        await this.taskExecutor.createTypeQueryExecution<boolean>(\n          'Assert',\n          textPrompt,\n          modelConfig,\n          serviceOpt,\n          multimodalPrompt,\n        );\n\n      const pass = Boolean(output);\n      const message = pass\n        ? undefined\n        : `Assertion failed: ${msg || assertionText}\\nReason: ${thought || '(no_reason)'}`;\n\n      if (opt?.keepRawResponse) {\n        return {\n          pass,\n          thought,\n          message,\n        };\n      }\n\n      if (!pass) {\n        throw new Error(message);\n      }\n    } catch (error) {\n      if (error instanceof TaskExecutionError) {\n        const errorTask = error.errorTask;\n        const thought = errorTask?.thought;\n        const rawError = errorTask?.error;\n        const rawMessage =\n          errorTask?.errorMessage ||\n          (rawError instanceof Error\n            ? rawError.message\n            : rawError\n              ? String(rawError)\n              : undefined);\n        const reason = thought || rawMessage || '(no_reason)';\n        const message = `Assertion failed: ${msg || assertionText}\\nReason: ${reason}`;\n\n        if (opt?.keepRawResponse) {\n          return {\n            pass: false,\n            thought,\n            message,\n          };\n        }\n\n        throw new Error(message, {\n          cause: rawError ?? error,\n        });\n      }\n\n      throw error;\n    }\n  }\n\n  async aiWaitFor(assertion: TUserPrompt, opt?: AgentWaitForOpt) {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n    await this.taskExecutor.waitFor(\n      assertion,\n      {\n        ...opt,\n        timeoutMs: opt?.timeoutMs || 15 * 1000,\n        checkIntervalMs: opt?.checkIntervalMs || 3 * 1000,\n      },\n      modelConfig,\n    );\n  }\n\n  async ai(...args: Parameters<typeof this.aiAct>) {\n    return this.aiAct(...args);\n  }\n\n  async runYaml(yamlScriptContent: string): Promise<{\n    result: Record<string, any>;\n  }> {\n    const script = parseYamlScript(yamlScriptContent, 'yaml');\n    const player = new ScriptPlayer(script, async () => {\n      return { agent: this, freeFn: [] };\n    });\n    await player.run();\n\n    if (player.status === 'error') {\n      const errors = player.taskStatusList\n        .filter((task) => task.status === 'error')\n        .map((task) => {\n          return `task - ${task.name}: ${task.error?.message}`;\n        })\n        .join('\\n');\n      throw new Error(`Error(s) occurred in running yaml script:\\n${errors}`);\n    }\n\n    return {\n      result: player.result,\n    };\n  }\n\n  async evaluateJavaScript(script: string) {\n    assert(\n      this.interface.evaluateJavaScript,\n      'evaluateJavaScript is not supported in current agent',\n    );\n    return this.interface.evaluateJavaScript(script);\n  }\n\n  /**\n   * Add a dump update listener\n   * @param listener Listener function\n   * @returns A remove function that can be called to remove this listener\n   */\n  addDumpUpdateListener(\n    listener: (dump: string, executionDump?: ExecutionDump) => void,\n  ): () => void {\n    this.dumpUpdateListeners.push(listener);\n\n    // Return remove function\n    return () => {\n      this.removeDumpUpdateListener(listener);\n    };\n  }\n\n  /**\n   * Remove a dump update listener\n   * @param listener The listener function to remove\n   */\n  removeDumpUpdateListener(\n    listener: (dump: string, executionDump?: ExecutionDump) => void,\n  ): void {\n    const index = this.dumpUpdateListeners.indexOf(listener);\n    if (index > -1) {\n      this.dumpUpdateListeners.splice(index, 1);\n    }\n  }\n\n  /**\n   * Clear all dump update listeners\n   */\n  clearDumpUpdateListeners(): void {\n    this.dumpUpdateListeners = [];\n  }\n\n  async destroy() {\n    // Early return if already destroyed\n    if (this.destroyed) {\n      return;\n    }\n\n    // Wait for all queued write operations to complete\n    await this.reportGenerator.flush();\n\n    await this.reportGenerator.finalize(this.dump);\n    this.reportFile = this.reportGenerator.getReportPath();\n\n    await this.interface.destroy?.();\n    this.resetDump(); // reset dump to release memory\n    this.destroyed = true;\n  }\n\n  async recordToReport(\n    title?: string,\n    opt?: {\n      content: string;\n    },\n  ) {\n    // 1. screenshot\n    const base64 = await this.interface.screenshotBase64();\n    const now = Date.now();\n    const screenshot = ScreenshotItem.create(base64, now);\n    // 2. build recorder\n    const recorder: ExecutionRecorderItem[] = [\n      {\n        type: 'screenshot',\n        ts: now,\n        screenshot,\n      },\n    ];\n    // 3. build ExecutionTaskLog\n    const task: ExecutionTaskLog = {\n      taskId: uuid(),\n      type: 'Log',\n      subType: 'Screenshot',\n      status: 'finished',\n      recorder,\n      timing: {\n        start: now,\n        end: now,\n        cost: 0,\n      },\n      param: {\n        content: opt?.content || '',\n      },\n      executor: async () => {},\n    };\n    // 4. build ExecutionDump\n    const executionDump = new ExecutionDump({\n      logTime: now,\n      name: `Log - ${title || 'untitled'}`,\n      description: opt?.content || '',\n      tasks: [task],\n    });\n    // 5. append to execution dump\n    this.appendExecutionDump(executionDump);\n\n    // Call all registered dump update listeners\n    const dumpString = this.dumpDataString();\n    for (const listener of this.dumpUpdateListeners) {\n      try {\n        listener(dumpString);\n      } catch (error) {\n        console.error('Error in onDumpUpdate listener', error);\n      }\n    }\n\n    this.writeOutActionDumps();\n    await this.reportGenerator.flush();\n  }\n\n  /**\n   * @deprecated Use {@link Agent.recordToReport} instead.\n   */\n  async logScreenshot(\n    title?: string,\n    opt?: {\n      content: string;\n    },\n  ) {\n    await this.recordToReport(title, opt);\n  }\n\n  _unstableLogContent() {\n    const { groupName, groupDescription, executions } = this.dump;\n    return {\n      groupName,\n      groupDescription,\n      executions: executions || [],\n    };\n  }\n\n  /**\n   * Freezes the current page context to be reused in subsequent AI operations\n   * This avoids recalculating page context for each operation\n   */\n  async freezePageContext(): Promise<void> {\n    debug('Freezing page context');\n    const context = await this._snapshotContext();\n    // Mark the context as frozen\n    context._isFrozen = true;\n    this.frozenUIContext = context;\n    debug('Page context frozen successfully');\n  }\n\n  /**\n   * Unfreezes the page context, allowing AI operations to calculate context dynamically\n   */\n  async unfreezePageContext(): Promise<void> {\n    debug('Unfreezing page context');\n    this.frozenUIContext = undefined;\n    debug('Page context unfrozen successfully');\n  }\n\n  /**\n   * Process cache configuration and return normalized cache settings\n   */\n  private processCacheConfig(opts: AgentOpt): {\n    id: string;\n    enabled: boolean;\n    readOnly: boolean;\n    writeOnly: boolean;\n  } | null {\n    // Validate original cache config before processing\n    // Agent requires explicit IDs - don't allow auto-generation\n    if (opts.cache === true) {\n      throw new Error(\n        'cache: true requires an explicit cache ID. Please provide:\\n' +\n          'Example: cache: { id: \"my-cache-id\" }',\n      );\n    }\n\n    // Check if cache config object is missing ID\n    if (\n      opts.cache &&\n      typeof opts.cache === 'object' &&\n      opts.cache !== null &&\n      !opts.cache.id\n    ) {\n      throw new Error(\n        'cache configuration requires an explicit id.\\n' +\n          'Example: cache: { id: \"my-cache-id\" }',\n      );\n    }\n\n    // Use the unified utils function to process cache configuration\n    const cacheConfig = processCacheConfig(\n      opts.cache,\n      opts.cacheId || opts.testId || 'default',\n    );\n\n    if (!cacheConfig) {\n      return null;\n    }\n\n    // Handle cache configuration object\n    if (typeof cacheConfig === 'object' && cacheConfig !== null) {\n      const id = cacheConfig.id;\n      const rawStrategy = cacheConfig.strategy as unknown;\n      let strategyValue: string;\n\n      if (rawStrategy === undefined) {\n        strategyValue = 'read-write';\n      } else if (typeof rawStrategy === 'string') {\n        strategyValue = rawStrategy;\n      } else {\n        throw new Error(\n          `cache.strategy must be a string when provided, but received type ${typeof rawStrategy}`,\n        );\n      }\n\n      if (!isValidCacheStrategy(strategyValue)) {\n        throw new Error(\n          `cache.strategy must be one of ${CACHE_STRATEGY_VALUES}, but received \"${strategyValue}\"`,\n        );\n      }\n\n      const isReadOnly = strategyValue === 'read-only';\n      const isWriteOnly = strategyValue === 'write-only';\n\n      return {\n        id,\n        enabled: !isWriteOnly,\n        readOnly: isReadOnly,\n        writeOnly: isWriteOnly,\n      };\n    }\n\n    return null;\n  }\n\n  private normalizeFilePaths(files: string[]): string[] {\n    if (ifInBrowser) {\n      throw new Error('File chooser is not supported in browser environment');\n    }\n\n    return files.map((file) => {\n      const absolutePath = resolve(file);\n      if (!existsSync(absolutePath)) {\n        throw new Error(`File not found: ${file}`);\n      }\n      return absolutePath;\n    });\n  }\n\n  private normalizeFileInput(files: string | string[]): string[] {\n    const filesArray = Array.isArray(files) ? files : [files];\n    return this.normalizeFilePaths(filesArray);\n  }\n\n  /**\n   * Manually flush cache to file\n   * @param options - Optional configuration\n   * @param options.cleanUnused - If true, removes unused cache records before flushing\n   */\n  async flushCache(options?: { cleanUnused?: boolean }): Promise<void> {\n    if (!this.taskCache) {\n      throw new Error('Cache is not configured');\n    }\n\n    this.taskCache.flushCacheToFile(options);\n  }\n}\n\nexport const createAgent = (\n  interfaceInstance: AbstractInterface,\n  opts?: AgentOpt,\n) => {\n  return new Agent(interfaceInstance, opts);\n};\n"],"names":["__webpack_require__","module","getter","definition","key","Object","obj","prop","Symbol","debug","getDebug","distanceOfTwoPoints","p1","p2","x1","y1","x2","y2","Math","includedInRect","point","rect","x","y","left","top","width","height","defaultServiceExtractOption","CACHE_STRATEGIES","isValidCacheStrategy","strategy","value","CACHE_STRATEGY_VALUES","legacyScrollTypeMap","normalizeScrollType","scrollType","defaultReplanningCycleLimit","defaultVlmUiTarsReplanningCycleLimit","defaultAutoGlmReplanningCycleLimit","Agent","callback","modelConfigForPlanning","undefined","isUITars","isAutoGLM","action","context","commonContextParser","prompt","console","GroupedActionDump","getVersion","WeakMap","execution","runner","currentDump","existingIndex","opt","ifInBrowser","reportHTMLContent","task","param","paramStr","tip","typeStr","name","type","actionPlan","plans","Boolean","title","taskTitleStr","locateParamStr","defaultIntentModelConfig","output","locatePrompt","assert","detailedLocateParam","buildDetailedLocateParam","fileChooserAccept","withFileChooser","locatePromptOrValue","locatePromptOrOpt","optOrUndefined","optWithValue","stringValue","String","mode","locatePromptOrKeyName","keyName","locatePromptOrScrollParam","scrollParam","normalizedScrollType","taskPrompt","abortSignal","Error","runAiAct","deepThink","deepLocate","noIndividualLocateModel","includeBboxInPlanning","cacheable","replanningCycleLimit","isVlmUiTars","isAutoGlm","matchedCache","yaml","imagesIncludeCount","actionOutput","yamlContent","yamlFlowStr","demand","modelConfig","textPrompt","multimodalPrompt","parsePrompt","center","verifyPrompt","retryLimit","success","retryCount","resultPrompt","verifyResult","text","locateOpt","expectCenter","verifyLocateOption","verifyCenter","verifyRect","distance","included","pass","locateParam","locatePlan","locatePlanForLocate","element","assertion","msg","serviceOpt","assertionText","thought","message","error","TaskExecutionError","errorTask","rawError","rawMessage","reason","args","yamlScriptContent","script","parseYamlScript","player","ScriptPlayer","errors","listener","index","base64","now","Date","screenshot","ScreenshotItem","recorder","uuid","executionDump","ExecutionDump","dumpString","groupName","groupDescription","executions","opts","cacheConfig","processCacheConfig","id","rawStrategy","strategyValue","isReadOnly","isWriteOnly","files","file","absolutePath","resolve","existsSync","filesArray","Array","options","interfaceInstance","envReplanningCycleLimit","globalConfigManager","MIDSCENE_REPLANNING_CYCLE_LIMIT","Number","resolvedAiActContext","hasCustomConfig","ModelConfigManager","globalModelConfigManager","Service","cacheConfigObj","TaskCache","baseActionSpace","defineActionSleep","TaskExecutor","getReportFileName","ReportGenerator","createAgent"],"mappings":"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"}
+{"version":3,"file":"agent/agent.js","sources":["webpack/runtime/compat_get_default_export","webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../../src/agent/agent.ts"],"sourcesContent":["// getDefaultExport function for compatibility with non-ESM modules\n__webpack_require__.n = (module) => {\n\tvar getter = module && module.__esModule ?\n\t\t() => (module['default']) :\n\t\t() => (module);\n\t__webpack_require__.d(getter, { a: getter });\n\treturn getter;\n};\n","__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import type { TUserPrompt } from '../ai-model/index';\nimport { ScreenshotItem } from '../screenshot-item';\nimport Service from '../service/index';\n// Import types and values directly from their source files to avoid circular dependency\n// DO NOT import from '../index' as it creates a circular dependency:\n// index.ts -> agent/index.ts -> agent/agent.ts -> index.ts\nimport {\n  type ActionParam,\n  type ActionReturn,\n  type AgentAssertOpt,\n  type AgentDescribeElementAtPointResult,\n  type AgentOpt,\n  type AgentWaitForOpt,\n  type CacheConfig,\n  type DeepThinkOption,\n  type DeviceAction,\n  ExecutionDump,\n  type ExecutionRecorderItem,\n  type ExecutionTask,\n  type ExecutionTaskLog,\n  GroupedActionDump,\n  type LocateOption,\n  type LocateResultElement,\n  type LocateValidatorResult,\n  type LocatorValidatorOption,\n  type OnTaskStartTip,\n  type PlanningAction,\n  type Rect,\n  type ScrollParam,\n  type ServiceAction,\n  type ServiceExtractOption,\n  type ServiceExtractParam,\n  type UIContext,\n} from '../types';\nimport type { MidsceneYamlScript } from '../yaml';\nexport type TestStatus =\n  | 'passed'\n  | 'failed'\n  | 'timedOut'\n  | 'skipped'\n  | 'interrupted';\nimport { isAutoGLM, isUITars } from '@/ai-model/auto-glm/util';\nimport yaml from 'js-yaml';\n\nimport type { IReportGenerator } from '@/report-generator';\nimport { ReportGenerator } from '@/report-generator';\nimport { getVersion, processCacheConfig, reportHTMLContent } from '@/utils';\nimport {\n  ScriptPlayer,\n  buildDetailedLocateParam,\n  parseYamlScript,\n} from '../yaml/index';\n\nimport { existsSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport type { AbstractInterface } from '@/device';\nimport type { TaskRunner } from '@/task-runner';\nimport {\n  type IModelConfig,\n  MIDSCENE_REPLANNING_CYCLE_LIMIT,\n  ModelConfigManager,\n  globalConfigManager,\n  globalModelConfigManager,\n} from '@midscene/shared/env';\nimport { getDebug } from '@midscene/shared/logger';\nimport { assert, ifInBrowser, uuid } from '@midscene/shared/utils';\nimport { defineActionSleep } from '../device';\nimport { TaskCache } from './task-cache';\nimport {\n  TaskExecutionError,\n  TaskExecutor,\n  locatePlanForLocate,\n  withFileChooser,\n} from './tasks';\nimport { locateParamStr, paramStr, taskTitleStr, typeStr } from './ui-utils';\nimport { commonContextParser, getReportFileName, parsePrompt } from './utils';\n\nconst debug = getDebug('agent');\n\nconst distanceOfTwoPoints = (p1: [number, number], p2: [number, number]) => {\n  const [x1, y1] = p1;\n  const [x2, y2] = p2;\n  return Math.round(Math.sqrt((x1 - x2) ** 2 + (y1 - y2) ** 2));\n};\n\nconst includedInRect = (point: [number, number], rect: Rect) => {\n  const [x, y] = point;\n  const { left, top, width, height } = rect;\n  return x >= left && x <= left + width && y >= top && y <= top + height;\n};\n\nconst defaultServiceExtractOption: ServiceExtractOption = {\n  domIncluded: false,\n  screenshotIncluded: true,\n};\n\ntype CacheStrategy = NonNullable<CacheConfig['strategy']>;\n\nconst CACHE_STRATEGIES: readonly CacheStrategy[] = [\n  'read-only',\n  'read-write',\n  'write-only',\n];\n\nconst isValidCacheStrategy = (strategy: string): strategy is CacheStrategy =>\n  CACHE_STRATEGIES.some((value) => value === strategy);\n\nconst CACHE_STRATEGY_VALUES = CACHE_STRATEGIES.map(\n  (value) => `\"${value}\"`,\n).join(', ');\n\nconst legacyScrollTypeMap = {\n  once: 'singleAction',\n  untilBottom: 'scrollToBottom',\n  untilTop: 'scrollToTop',\n  untilRight: 'scrollToRight',\n  untilLeft: 'scrollToLeft',\n} as const;\n\ntype LegacyScrollType = keyof typeof legacyScrollTypeMap;\n\nconst normalizeScrollType = (\n  scrollType: ScrollParam['scrollType'] | LegacyScrollType | undefined,\n): ScrollParam['scrollType'] | undefined => {\n  if (!scrollType) {\n    return scrollType;\n  }\n\n  if (scrollType in legacyScrollTypeMap) {\n    return legacyScrollTypeMap[scrollType as LegacyScrollType];\n  }\n\n  return scrollType as ScrollParam['scrollType'];\n};\n\nconst defaultReplanningCycleLimit = 20;\nconst defaultVlmUiTarsReplanningCycleLimit = 40;\nconst defaultAutoGlmReplanningCycleLimit = 100;\n\nexport type AiActOptions = {\n  cacheable?: boolean;\n  fileChooserAccept?: string | string[];\n  deepThink?: DeepThinkOption;\n  deepLocate?: boolean;\n  abortSignal?: AbortSignal;\n};\n\nexport class Agent<\n  InterfaceType extends AbstractInterface = AbstractInterface,\n> {\n  interface: InterfaceType;\n\n  service: Service;\n\n  dump: GroupedActionDump;\n\n  reportFile?: string | null;\n\n  reportFileName?: string;\n\n  taskExecutor: TaskExecutor;\n\n  opts: AgentOpt;\n\n  /**\n   * If true, the agent will not perform any actions\n   */\n  dryMode = false;\n\n  onTaskStartTip?: OnTaskStartTip;\n\n  taskCache?: TaskCache;\n\n  private dumpUpdateListeners: Array<\n    (dump: string, executionDump?: ExecutionDump) => void\n  > = [];\n\n  get onDumpUpdate():\n    | ((dump: string, executionDump?: ExecutionDump) => void)\n    | undefined {\n    return this.dumpUpdateListeners[0];\n  }\n\n  set onDumpUpdate(callback:\n    | ((dump: string, executionDump?: ExecutionDump) => void)\n    | undefined) {\n    // Clear existing listeners\n    this.dumpUpdateListeners = [];\n    // Add callback to array if provided\n    if (callback) {\n      this.dumpUpdateListeners.push(callback);\n    }\n  }\n\n  destroyed = false;\n\n  modelConfigManager: ModelConfigManager;\n\n  /**\n   * Frozen page context for consistent AI operations\n   */\n  private frozenUIContext?: UIContext;\n\n  private get aiActContext(): string | undefined {\n    return this.opts.aiActContext ?? this.opts.aiActionContext;\n  }\n\n  /**\n   * Flag to track if VL model warning has been shown\n   */\n  private hasWarnedNonVLModel = false;\n\n  private executionDumpIndexByRunner = new WeakMap<TaskRunner, number>();\n\n  private fullActionSpace: DeviceAction[];\n\n  private reportGenerator: IReportGenerator;\n\n  // @deprecated use .interface instead\n  get page() {\n    return this.interface;\n  }\n\n  /**\n   * Ensures VL model warning is shown once when needed\n   */\n  private ensureVLModelWarning() {\n    if (\n      !this.hasWarnedNonVLModel &&\n      this.interface.interfaceType !== 'puppeteer' &&\n      this.interface.interfaceType !== 'playwright' &&\n      this.interface.interfaceType !== 'static' &&\n      this.interface.interfaceType !== 'chrome-extension-proxy' &&\n      this.interface.interfaceType !== 'page-over-chrome-extension-bridge'\n    ) {\n      this.modelConfigManager.throwErrorIfNonVLModel();\n      this.hasWarnedNonVLModel = true;\n    }\n  }\n\n  private resolveReplanningCycleLimit(\n    modelConfigForPlanning: IModelConfig,\n  ): number {\n    if (this.opts.replanningCycleLimit !== undefined) {\n      return this.opts.replanningCycleLimit;\n    }\n\n    return isUITars(modelConfigForPlanning.modelFamily)\n      ? defaultVlmUiTarsReplanningCycleLimit\n      : isAutoGLM(modelConfigForPlanning.modelFamily)\n        ? defaultAutoGlmReplanningCycleLimit\n        : defaultReplanningCycleLimit;\n  }\n\n  constructor(interfaceInstance: InterfaceType, opts?: AgentOpt) {\n    this.interface = interfaceInstance;\n\n    const envReplanningCycleLimit =\n      globalConfigManager.getEnvConfigValueAsNumber(\n        MIDSCENE_REPLANNING_CYCLE_LIMIT,\n      );\n\n    this.opts = Object.assign(\n      {\n        generateReport: true,\n        autoPrintReportMsg: true,\n        groupName: 'Midscene Report',\n        groupDescription: '',\n      },\n      opts || {},\n      opts?.replanningCycleLimit === undefined &&\n        envReplanningCycleLimit !== undefined &&\n        !Number.isNaN(envReplanningCycleLimit)\n        ? { replanningCycleLimit: envReplanningCycleLimit }\n        : {},\n    );\n\n    const resolvedAiActContext =\n      this.opts.aiActContext ?? this.opts.aiActionContext;\n    if (resolvedAiActContext !== undefined) {\n      this.opts.aiActContext = resolvedAiActContext;\n      this.opts.aiActionContext ??= resolvedAiActContext;\n    }\n\n    if (\n      opts?.modelConfig &&\n      (typeof opts?.modelConfig !== 'object' || Array.isArray(opts.modelConfig))\n    ) {\n      throw new Error(\n        `opts.modelConfig must be a plain object map of env keys to values, but got ${typeof opts?.modelConfig}`,\n      );\n    }\n    // Create ModelConfigManager if modelConfig or createOpenAIClient is provided\n    // Otherwise, use the global config manager\n    const hasCustomConfig = opts?.modelConfig || opts?.createOpenAIClient;\n    this.modelConfigManager = hasCustomConfig\n      ? new ModelConfigManager(opts?.modelConfig, opts?.createOpenAIClient)\n      : globalModelConfigManager;\n\n    this.onTaskStartTip = this.opts.onTaskStartTip;\n\n    this.service = new Service(async () => {\n      return this.getUIContext();\n    });\n\n    // Process cache configuration\n    const cacheConfigObj = this.processCacheConfig(opts || {});\n    if (cacheConfigObj) {\n      this.taskCache = new TaskCache(\n        cacheConfigObj.id,\n        cacheConfigObj.enabled,\n        cacheConfigObj.cacheAdapter,\n        {\n          readOnly: cacheConfigObj.readOnly,\n          writeOnly: cacheConfigObj.writeOnly,\n        },\n      );\n    }\n\n    const baseActionSpace = this.interface.actionSpace();\n    this.fullActionSpace = [...baseActionSpace, defineActionSleep()];\n\n    this.taskExecutor = new TaskExecutor(this.interface, this.service, {\n      taskCache: this.taskCache,\n      onTaskStart: this.callbackOnTaskStartTip.bind(this),\n      replanningCycleLimit: this.opts.replanningCycleLimit,\n      waitAfterAction: this.opts.waitAfterAction,\n      useDeviceTimestamp: this.opts.useDeviceTimestamp,\n      actionSpace: this.fullActionSpace,\n      hooks: {\n        onTaskUpdate: (runner) => {\n          const executionDump = runner.dump();\n          this.appendExecutionDump(executionDump, runner);\n\n          // Call all registered dump update listeners\n          const dumpString = this.dumpDataString();\n          for (const listener of this.dumpUpdateListeners) {\n            try {\n              listener(dumpString, executionDump);\n            } catch (error) {\n              console.error('Error in onDumpUpdate listener', error);\n            }\n          }\n\n          // Fire and forget - don't block task execution\n          this.writeOutActionDumps();\n        },\n      },\n    });\n    this.dump = this.resetDump();\n    this.reportFileName =\n      opts?.reportFileName ||\n      getReportFileName(opts?.testId || this.interface.interfaceType || 'web');\n\n    this.reportGenerator = ReportGenerator.create(this.reportFileName!, {\n      generateReport: this.opts.generateReport,\n      outputFormat: this.opts.outputFormat,\n      autoPrintReportMsg: this.opts.autoPrintReportMsg,\n    });\n  }\n\n  async getActionSpace(): Promise<DeviceAction[]> {\n    return this.fullActionSpace;\n  }\n\n  async getUIContext(action?: ServiceAction): Promise<UIContext> {\n    // Check VL model configuration when UI context is first needed\n    this.ensureVLModelWarning();\n\n    // If page context is frozen, return the frozen context for all actions\n    if (this.frozenUIContext) {\n      debug('Using frozen page context for action:', action);\n      return this.frozenUIContext;\n    }\n\n    // Get original context\n    const context = await commonContextParser(this.interface, {\n      uploadServerUrl: this.modelConfigManager.getUploadTestServerUrl(),\n      screenshotShrinkFactor: this.opts.screenshotShrinkFactor,\n    });\n\n    return context;\n  }\n\n  async _snapshotContext(): Promise<UIContext> {\n    return await this.getUIContext('locate');\n  }\n\n  /**\n   * @deprecated Use {@link setAIActContext} instead.\n   */\n  async setAIActionContext(prompt: string) {\n    await this.setAIActContext(prompt);\n  }\n\n  async setAIActContext(prompt: string) {\n    if (this.aiActContext) {\n      console.warn(\n        'aiActContext is already set, and it is called again, will override the previous setting',\n      );\n    }\n    this.opts.aiActContext = prompt;\n    this.opts.aiActionContext = prompt;\n  }\n\n  resetDump() {\n    this.dump = new GroupedActionDump({\n      sdkVersion: getVersion(),\n      groupName: this.opts.groupName!,\n      groupDescription: this.opts.groupDescription,\n      executions: [],\n      modelBriefs: [],\n      deviceType: this.interface.interfaceType,\n    });\n    this.executionDumpIndexByRunner = new WeakMap<TaskRunner, number>();\n\n    return this.dump;\n  }\n\n  appendExecutionDump(execution: ExecutionDump, runner?: TaskRunner) {\n    const currentDump = this.dump;\n    if (runner) {\n      const existingIndex = this.executionDumpIndexByRunner.get(runner);\n      if (existingIndex !== undefined) {\n        currentDump.executions[existingIndex] = execution;\n        return;\n      }\n      currentDump.executions.push(execution);\n      this.executionDumpIndexByRunner.set(\n        runner,\n        currentDump.executions.length - 1,\n      );\n      return;\n    }\n    currentDump.executions.push(execution);\n  }\n\n  dumpDataString(opt?: { inlineScreenshots?: boolean }) {\n    // update dump info\n    this.dump.groupName = this.opts.groupName!;\n    this.dump.groupDescription = this.opts.groupDescription;\n    // In browser environment, use inline screenshots since file system is not available\n    if (ifInBrowser || opt?.inlineScreenshots) {\n      return this.dump.serializeWithInlineScreenshots();\n    }\n    return this.dump.serialize();\n  }\n\n  reportHTMLString(opt?: { inlineScreenshots?: boolean }) {\n    // dumpDataString() handles browser environment with inline screenshots\n    return reportHTMLContent(this.dumpDataString(opt));\n  }\n\n  writeOutActionDumps() {\n    this.reportGenerator.onDumpUpdate(this.dump);\n    this.reportFile = this.reportGenerator.getReportPath();\n  }\n\n  private async callbackOnTaskStartTip(task: ExecutionTask) {\n    const param = paramStr(task);\n    const tip = param ? `${typeStr(task)} - ${param}` : typeStr(task);\n\n    if (this.onTaskStartTip) {\n      await this.onTaskStartTip(tip);\n    }\n  }\n\n  wrapActionInActionSpace<T extends DeviceAction>(\n    name: string,\n  ): (param: ActionParam<T>) => Promise<ActionReturn<T>> {\n    return async (param: ActionParam<T>) => {\n      return await this.callActionInActionSpace<ActionReturn<T>>(name, param);\n    };\n  }\n\n  async callActionInActionSpace<T = any>(\n    type: string,\n    opt?: T, // and all other action params\n  ) {\n    debug('callActionInActionSpace', type, ',', opt);\n\n    const actionPlan: PlanningAction<T> = {\n      type: type as any,\n      param: (opt as any) || {},\n      thought: '',\n    };\n    debug('actionPlan', actionPlan); // , ', in which the locateParam is', locateParam);\n\n    const plans: PlanningAction[] = [actionPlan].filter(\n      Boolean,\n    ) as PlanningAction[];\n\n    const title = taskTitleStr(\n      type as any,\n      locateParamStr((opt as any)?.locate || {}),\n    );\n\n    // assume all operation in action space is related to locating\n    const defaultIntentModelConfig =\n      this.modelConfigManager.getModelConfig('default');\n    const modelConfigForPlanning =\n      this.modelConfigManager.getModelConfig('planning');\n\n    const { output } = await this.taskExecutor.runPlans(\n      title,\n      plans,\n      modelConfigForPlanning,\n      defaultIntentModelConfig,\n    );\n    return output;\n  }\n\n  async aiTap(\n    locatePrompt: TUserPrompt,\n    opt?: LocateOption & { fileChooserAccept?: string | string[] },\n  ) {\n    assert(locatePrompt, 'missing locate prompt for tap');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    const fileChooserAccept = opt?.fileChooserAccept\n      ? this.normalizeFileInput(opt.fileChooserAccept)\n      : undefined;\n\n    return withFileChooser(this.interface, fileChooserAccept, async () => {\n      return this.callActionInActionSpace('Tap', {\n        locate: detailedLocateParam,\n      });\n    });\n  }\n\n  async aiRightClick(locatePrompt: TUserPrompt, opt?: LocateOption) {\n    assert(locatePrompt, 'missing locate prompt for right click');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    return this.callActionInActionSpace('RightClick', {\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiDoubleClick(locatePrompt: TUserPrompt, opt?: LocateOption) {\n    assert(locatePrompt, 'missing locate prompt for double click');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    return this.callActionInActionSpace('DoubleClick', {\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiHover(locatePrompt: TUserPrompt, opt?: LocateOption) {\n    assert(locatePrompt, 'missing locate prompt for hover');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    return this.callActionInActionSpace('Hover', {\n      locate: detailedLocateParam,\n    });\n  }\n\n  // New signature, always use locatePrompt as the first param\n  async aiInput(\n    locatePrompt: TUserPrompt,\n    opt: LocateOption & { value: string | number } & {\n      autoDismissKeyboard?: boolean;\n    } & { mode?: 'replace' | 'clear' | 'typeOnly' | 'append' },\n  ): Promise<any>;\n\n  // Legacy signature - deprecated\n  /**\n   * @deprecated Use aiInput(locatePrompt, opt) instead where opt contains the value\n   */\n  async aiInput(\n    value: string | number,\n    locatePrompt: TUserPrompt,\n    opt?: LocateOption & { autoDismissKeyboard?: boolean } & {\n      mode?: 'replace' | 'clear' | 'typeOnly' | 'append';\n    }, // AndroidDeviceInputOpt &\n  ): Promise<any>;\n\n  // Implementation\n  async aiInput(\n    locatePromptOrValue: TUserPrompt | string | number,\n    locatePromptOrOpt:\n      | TUserPrompt\n      | (LocateOption & { value: string | number } & {\n          autoDismissKeyboard?: boolean;\n        } & { mode?: 'replace' | 'clear' | 'typeOnly' | 'append' }) // AndroidDeviceInputOpt &\n      | undefined,\n    optOrUndefined?: LocateOption, // AndroidDeviceInputOpt &\n  ) {\n    let value: string | number;\n    let locatePrompt: TUserPrompt;\n    let opt:\n      | (LocateOption & { value: string | number } & {\n          autoDismissKeyboard?: boolean;\n        } & { mode?: 'replace' | 'clear' | 'typeOnly' | 'append' }) // AndroidDeviceInputOpt &\n      | undefined;\n\n    // Check if using new signature (first param is locatePrompt, second has value)\n    if (\n      typeof locatePromptOrOpt === 'object' &&\n      locatePromptOrOpt !== null &&\n      'value' in locatePromptOrOpt\n    ) {\n      // New signature: aiInput(locatePrompt, opt)\n      locatePrompt = locatePromptOrValue as TUserPrompt;\n      const optWithValue = locatePromptOrOpt as LocateOption & {\n        // AndroidDeviceInputOpt &\n        value: string | number;\n        autoDismissKeyboard?: boolean;\n      };\n      value = optWithValue.value;\n      opt = optWithValue;\n    } else {\n      // Legacy signature: aiInput(value, locatePrompt, opt)\n      value = locatePromptOrValue as string | number;\n      locatePrompt = locatePromptOrOpt as TUserPrompt;\n      opt = {\n        ...optOrUndefined,\n        value,\n      };\n    }\n\n    assert(\n      typeof value === 'string' || typeof value === 'number',\n      'input value must be a string or number, use empty string if you want to clear the input',\n    );\n    assert(locatePrompt, 'missing locate prompt for input');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    // Convert value to string to ensure consistency\n    const stringValue = typeof value === 'number' ? String(value) : value;\n\n    // backward compat: convert deprecated 'append' to 'typeOnly'\n    const mode = opt?.mode === 'append' ? 'typeOnly' : opt?.mode;\n\n    return this.callActionInActionSpace('Input', {\n      ...(opt || {}),\n      value: stringValue,\n      locate: detailedLocateParam,\n      mode,\n    });\n  }\n\n  // New signature\n  async aiKeyboardPress(\n    locatePrompt: TUserPrompt,\n    opt: LocateOption & { keyName: string },\n  ): Promise<any>;\n\n  // Legacy signature - deprecated\n  /**\n   * @deprecated Use aiKeyboardPress(locatePrompt, opt) instead where opt contains the keyName\n   */\n  async aiKeyboardPress(\n    keyName: string,\n    locatePrompt?: TUserPrompt,\n    opt?: LocateOption,\n  ): Promise<any>;\n\n  // Implementation\n  async aiKeyboardPress(\n    locatePromptOrKeyName: TUserPrompt | string,\n    locatePromptOrOpt:\n      | TUserPrompt\n      | (LocateOption & { keyName: string })\n      | undefined,\n    optOrUndefined?: LocateOption,\n  ) {\n    let keyName: string;\n    let locatePrompt: TUserPrompt | undefined;\n    let opt: (LocateOption & { keyName: string }) | undefined;\n\n    // Check if using new signature (first param is locatePrompt, second has keyName)\n    if (\n      typeof locatePromptOrOpt === 'object' &&\n      locatePromptOrOpt !== null &&\n      'keyName' in locatePromptOrOpt\n    ) {\n      // New signature: aiKeyboardPress(locatePrompt, opt)\n      locatePrompt = locatePromptOrKeyName as TUserPrompt;\n      opt = locatePromptOrOpt as LocateOption & {\n        keyName: string;\n      };\n    } else {\n      // Legacy signature: aiKeyboardPress(keyName, locatePrompt, opt)\n      keyName = locatePromptOrKeyName as string;\n      locatePrompt = locatePromptOrOpt as TUserPrompt | undefined;\n      opt = {\n        ...(optOrUndefined || {}),\n        keyName,\n      };\n    }\n\n    assert(opt?.keyName, 'missing keyName for keyboard press');\n\n    const detailedLocateParam = locatePrompt\n      ? buildDetailedLocateParam(locatePrompt, opt)\n      : undefined;\n\n    return this.callActionInActionSpace('KeyboardPress', {\n      ...(opt || {}),\n      locate: detailedLocateParam,\n    });\n  }\n\n  // New signature\n  async aiScroll(\n    locatePrompt: TUserPrompt | undefined,\n    opt: LocateOption & ScrollParam,\n  ): Promise<any>;\n\n  // Legacy signature - deprecated\n  /**\n   * @deprecated Use aiScroll(locatePrompt, opt) instead where opt contains the scroll parameters\n   */\n  async aiScroll(\n    scrollParam: ScrollParam,\n    locatePrompt?: TUserPrompt,\n    opt?: LocateOption,\n  ): Promise<any>;\n\n  // Implementation\n  async aiScroll(\n    locatePromptOrScrollParam: TUserPrompt | ScrollParam | undefined,\n    locatePromptOrOpt: TUserPrompt | (LocateOption & ScrollParam) | undefined,\n    optOrUndefined?: LocateOption,\n  ) {\n    let scrollParam: ScrollParam;\n    let locatePrompt: TUserPrompt | undefined;\n    let opt: LocateOption | undefined;\n\n    // Check if using new signature (first param is locatePrompt, second has scroll params)\n    if (\n      typeof locatePromptOrOpt === 'object' &&\n      ('direction' in locatePromptOrOpt ||\n        'scrollType' in locatePromptOrOpt ||\n        'distance' in locatePromptOrOpt)\n    ) {\n      // New signature: aiScroll(locatePrompt, opt)\n      locatePrompt = locatePromptOrScrollParam as TUserPrompt;\n      opt = locatePromptOrOpt as LocateOption & ScrollParam;\n    } else {\n      // Legacy signature: aiScroll(scrollParam, locatePrompt, opt)\n      scrollParam = locatePromptOrScrollParam as ScrollParam;\n      locatePrompt = locatePromptOrOpt as TUserPrompt | undefined;\n      opt = {\n        ...(optOrUndefined || {}),\n        ...(scrollParam || {}),\n      };\n    }\n\n    if (opt) {\n      const normalizedScrollType = normalizeScrollType(\n        (opt as ScrollParam).scrollType as\n          | ScrollParam['scrollType']\n          | LegacyScrollType\n          | undefined,\n      );\n\n      if (normalizedScrollType !== (opt as ScrollParam).scrollType) {\n        (opt as ScrollParam) = {\n          ...(opt || {}),\n          scrollType: normalizedScrollType as ScrollParam['scrollType'],\n        };\n      }\n    }\n\n    const detailedLocateParam = buildDetailedLocateParam(\n      locatePrompt || '',\n      opt,\n    );\n\n    return this.callActionInActionSpace('Scroll', {\n      ...(opt || {}),\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiAct(\n    taskPrompt: string,\n    opt?: AiActOptions,\n  ): Promise<string | undefined> {\n    const fileChooserAccept = opt?.fileChooserAccept\n      ? this.normalizeFileInput(opt.fileChooserAccept)\n      : undefined;\n\n    const abortSignal = opt?.abortSignal;\n    if (abortSignal?.aborted) {\n      throw new Error(\n        `aiAct aborted: ${abortSignal.reason || 'signal already aborted'}`,\n      );\n    }\n\n    const runAiAct = async () => {\n      const modelConfigForPlanning =\n        this.modelConfigManager.getModelConfig('planning');\n      const defaultIntentModelConfig =\n        this.modelConfigManager.getModelConfig('default');\n      const deepThink = opt?.deepThink === 'unset' ? undefined : opt?.deepThink;\n\n      const deepLocate = opt?.deepLocate;\n\n      const noIndividualLocateModel =\n        modelConfigForPlanning.modelName ===\n          defaultIntentModelConfig.modelName &&\n        modelConfigForPlanning.openaiBaseURL ===\n          defaultIntentModelConfig.openaiBaseURL;\n\n      const includeBboxInPlanning =\n        !deepThink && noIndividualLocateModel && !deepLocate;\n\n      debug('setting includeBboxInPlanning to', includeBboxInPlanning, {\n        deepThink,\n        noIndividualLocateModel,\n        deepLocate,\n      });\n\n      if (deepLocate && includeBboxInPlanning) {\n        console.warn(\n          'deepLocate option is ignored when includeBboxInPlanning is true (same model for planning and default intent without deepThink). Locate is already done during planning.',\n        );\n      }\n\n      const cacheable = opt?.cacheable;\n      const replanningCycleLimit = this.resolveReplanningCycleLimit(\n        modelConfigForPlanning,\n      );\n      // if vlm-ui-tars or auto-glm, plan cache is not used\n      const isVlmUiTars = isUITars(modelConfigForPlanning.modelFamily);\n      const isAutoGlm = isAutoGLM(modelConfigForPlanning.modelFamily);\n      const matchedCache =\n        isVlmUiTars || isAutoGlm || cacheable === false\n          ? undefined\n          : await this.taskCache?.matchPlanCache(taskPrompt);\n      if (\n        matchedCache &&\n        this.taskCache?.isCacheResultUsed &&\n        matchedCache.cacheContent?.yamlWorkflow?.trim()\n      ) {\n        // log into report file\n        await this.taskExecutor.loadYamlFlowAsPlanning(\n          taskPrompt,\n          matchedCache.cacheContent.yamlWorkflow,\n        );\n\n        debug('matched cache, will call .runYaml to run the action');\n        const yaml = matchedCache.cacheContent.yamlWorkflow;\n        await this.runYaml(yaml);\n        return;\n      }\n\n      // If cache matched but yamlWorkflow is empty, fall through to normal execution\n      const imagesIncludeCount: number = deepThink ? 2 : 1;\n      const { output: actionOutput } = await this.taskExecutor.action(\n        taskPrompt,\n        modelConfigForPlanning,\n        defaultIntentModelConfig,\n        includeBboxInPlanning,\n        this.aiActContext,\n        cacheable,\n        replanningCycleLimit,\n        imagesIncludeCount,\n        deepThink,\n        fileChooserAccept,\n        includeBboxInPlanning ? undefined : deepLocate,\n        abortSignal,\n      );\n\n      // update cache\n      if (this.taskCache && actionOutput?.yamlFlow && cacheable !== false) {\n        const yamlContent: MidsceneYamlScript = {\n          tasks: [\n            {\n              name: taskPrompt,\n              flow: actionOutput.yamlFlow,\n            },\n          ],\n        };\n        const yamlFlowStr = yaml.dump(yamlContent);\n        this.taskCache.updateOrAppendCacheRecord(\n          {\n            type: 'plan',\n            prompt: taskPrompt,\n            yamlWorkflow: yamlFlowStr,\n          },\n          matchedCache,\n        );\n      }\n\n      return actionOutput?.output;\n    };\n\n    return await runAiAct();\n  }\n\n  /**\n   * @deprecated Use {@link Agent.aiAct} instead.\n   */\n  async aiAction(taskPrompt: string, opt?: AiActOptions) {\n    return this.aiAct(taskPrompt, opt);\n  }\n\n  async aiQuery<ReturnType = any>(\n    demand: ServiceExtractParam,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<ReturnType> {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'Query',\n      demand,\n      modelConfig,\n      opt,\n    );\n    return output as ReturnType;\n  }\n\n  async aiBoolean(\n    prompt: TUserPrompt,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<boolean> {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'Boolean',\n      textPrompt,\n      modelConfig,\n      opt,\n      multimodalPrompt,\n    );\n    return output as boolean;\n  }\n\n  async aiNumber(\n    prompt: TUserPrompt,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<number> {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'Number',\n      textPrompt,\n      modelConfig,\n      opt,\n      multimodalPrompt,\n    );\n    return output as number;\n  }\n\n  async aiString(\n    prompt: TUserPrompt,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<string> {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'String',\n      textPrompt,\n      modelConfig,\n      opt,\n      multimodalPrompt,\n    );\n    return output as string;\n  }\n\n  async aiAsk(\n    prompt: TUserPrompt,\n    opt: ServiceExtractOption = defaultServiceExtractOption,\n  ): Promise<string> {\n    return this.aiString(prompt, opt);\n  }\n\n  async describeElementAtPoint(\n    center: [number, number],\n    opt?: {\n      verifyPrompt?: boolean;\n      retryLimit?: number;\n      deepLocate?: boolean;\n    } & LocatorValidatorOption,\n  ): Promise<AgentDescribeElementAtPointResult> {\n    const { verifyPrompt = true, retryLimit = 3 } = opt || {};\n\n    let success = false;\n    let retryCount = 0;\n    let resultPrompt = '';\n    let deepLocate = opt?.deepLocate || false;\n    let verifyResult: LocateValidatorResult | undefined;\n\n    while (!success && retryCount < retryLimit) {\n      if (retryCount >= 2) {\n        deepLocate = true;\n      }\n      debug(\n        'aiDescribe',\n        center,\n        'verifyPrompt',\n        verifyPrompt,\n        'retryCount',\n        retryCount,\n        'deepLocate',\n        deepLocate,\n      );\n      // use same intent as aiLocate\n      const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n      const text = await this.service.describe(center, modelConfig, {\n        deepLocate,\n      });\n      debug('aiDescribe text', text);\n      assert(text.description, `failed to describe element at [${center}]`);\n      resultPrompt = text.description;\n\n      // Don't pass deepLocate to verification locate — the description was generated\n      // from a cropped view (deepLocate describe), but verification should use regular\n      // locate on the full screenshot to confirm the description works universally.\n      // Passing deepLocate here would trigger AiLocateSection with an element-level\n      // description as a section prompt, which is semantically incorrect.\n      verifyResult = await this.verifyLocator(\n        resultPrompt,\n        undefined,\n        center,\n        opt,\n      );\n      if (verifyResult.pass) {\n        success = true;\n      } else {\n        retryCount++;\n      }\n    }\n\n    return {\n      prompt: resultPrompt,\n      deepLocate,\n      verifyResult,\n    };\n  }\n\n  async verifyLocator(\n    prompt: string,\n    locateOpt: LocateOption | undefined,\n    expectCenter: [number, number],\n    verifyLocateOption?: LocatorValidatorOption,\n  ): Promise<LocateValidatorResult> {\n    debug('verifyLocator', prompt, locateOpt, expectCenter, verifyLocateOption);\n\n    const { center: verifyCenter, rect: verifyRect } = await this.aiLocate(\n      prompt,\n      locateOpt,\n    );\n    const distance = distanceOfTwoPoints(expectCenter, verifyCenter);\n    const included = includedInRect(expectCenter, verifyRect);\n    const pass =\n      distance <= (verifyLocateOption?.centerDistanceThreshold || 20) ||\n      included;\n    const verifyResult = {\n      pass,\n      rect: verifyRect,\n      center: verifyCenter,\n      centerDistance: distance,\n    };\n    debug('aiDescribe verifyResult', verifyResult);\n    return verifyResult;\n  }\n\n  async aiLocate(prompt: TUserPrompt, opt?: LocateOption) {\n    const locateParam = buildDetailedLocateParam(prompt, opt);\n    assert(locateParam, 'cannot get locate param for aiLocate');\n    const locatePlan = locatePlanForLocate(locateParam);\n    const plans = [locatePlan];\n    const defaultIntentModelConfig =\n      this.modelConfigManager.getModelConfig('default');\n    const modelConfigForPlanning =\n      this.modelConfigManager.getModelConfig('planning');\n\n    const { output } = await this.taskExecutor.runPlans(\n      taskTitleStr('Locate', locateParamStr(locateParam)),\n      plans,\n      modelConfigForPlanning,\n      defaultIntentModelConfig,\n    );\n\n    const { element } = output;\n\n    return {\n      rect: element?.rect,\n      center: element?.center,\n      dpr: element?.dpr,\n    } as Pick<LocateResultElement, 'rect' | 'center'>;\n  }\n\n  async aiAssert(\n    assertion: TUserPrompt,\n    msg?: string,\n    opt?: AgentAssertOpt & ServiceExtractOption,\n  ) {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n\n    const serviceOpt: ServiceExtractOption = {\n      domIncluded: opt?.domIncluded ?? defaultServiceExtractOption.domIncluded,\n      screenshotIncluded:\n        opt?.screenshotIncluded ??\n        defaultServiceExtractOption.screenshotIncluded,\n    };\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(assertion);\n    const assertionText =\n      typeof assertion === 'string' ? assertion : assertion.prompt;\n\n    try {\n      const { output, thought } =\n        await this.taskExecutor.createTypeQueryExecution<boolean>(\n          'Assert',\n          textPrompt,\n          modelConfig,\n          serviceOpt,\n          multimodalPrompt,\n        );\n\n      const pass = Boolean(output);\n      const message = pass\n        ? undefined\n        : `Assertion failed: ${msg || assertionText}\\nReason: ${thought || '(no_reason)'}`;\n\n      if (opt?.keepRawResponse) {\n        return {\n          pass,\n          thought,\n          message,\n        };\n      }\n\n      if (!pass) {\n        throw new Error(message);\n      }\n    } catch (error) {\n      if (error instanceof TaskExecutionError) {\n        const errorTask = error.errorTask;\n        const thought = errorTask?.thought;\n        const rawError = errorTask?.error;\n        const rawMessage =\n          errorTask?.errorMessage ||\n          (rawError instanceof Error\n            ? rawError.message\n            : rawError\n              ? String(rawError)\n              : undefined);\n        const reason = thought || rawMessage || '(no_reason)';\n        const message = `Assertion failed: ${msg || assertionText}\\nReason: ${reason}`;\n\n        if (opt?.keepRawResponse) {\n          return {\n            pass: false,\n            thought,\n            message,\n          };\n        }\n\n        throw new Error(message, {\n          cause: rawError ?? error,\n        });\n      }\n\n      throw error;\n    }\n  }\n\n  async aiWaitFor(assertion: TUserPrompt, opt?: AgentWaitForOpt) {\n    const modelConfig = this.modelConfigManager.getModelConfig('insight');\n    await this.taskExecutor.waitFor(\n      assertion,\n      {\n        ...opt,\n        timeoutMs: opt?.timeoutMs || 15 * 1000,\n        checkIntervalMs: opt?.checkIntervalMs || 3 * 1000,\n      },\n      modelConfig,\n    );\n  }\n\n  async ai(...args: Parameters<typeof this.aiAct>) {\n    return this.aiAct(...args);\n  }\n\n  async runYaml(yamlScriptContent: string): Promise<{\n    result: Record<string, any>;\n  }> {\n    const script = parseYamlScript(yamlScriptContent, 'yaml');\n    const player = new ScriptPlayer(script, async () => {\n      return { agent: this, freeFn: [] };\n    });\n    await player.run();\n\n    if (player.status === 'error') {\n      const errors = player.taskStatusList\n        .filter((task) => task.status === 'error')\n        .map((task) => {\n          return `task - ${task.name}: ${task.error?.message}`;\n        })\n        .join('\\n');\n      throw new Error(`Error(s) occurred in running yaml script:\\n${errors}`);\n    }\n\n    return {\n      result: player.result,\n    };\n  }\n\n  async evaluateJavaScript(script: string) {\n    assert(\n      this.interface.evaluateJavaScript,\n      'evaluateJavaScript is not supported in current agent',\n    );\n    return this.interface.evaluateJavaScript(script);\n  }\n\n  /**\n   * Add a dump update listener\n   * @param listener Listener function\n   * @returns A remove function that can be called to remove this listener\n   */\n  addDumpUpdateListener(\n    listener: (dump: string, executionDump?: ExecutionDump) => void,\n  ): () => void {\n    this.dumpUpdateListeners.push(listener);\n\n    // Return remove function\n    return () => {\n      this.removeDumpUpdateListener(listener);\n    };\n  }\n\n  /**\n   * Remove a dump update listener\n   * @param listener The listener function to remove\n   */\n  removeDumpUpdateListener(\n    listener: (dump: string, executionDump?: ExecutionDump) => void,\n  ): void {\n    const index = this.dumpUpdateListeners.indexOf(listener);\n    if (index > -1) {\n      this.dumpUpdateListeners.splice(index, 1);\n    }\n  }\n\n  /**\n   * Clear all dump update listeners\n   */\n  clearDumpUpdateListeners(): void {\n    this.dumpUpdateListeners = [];\n  }\n\n  async destroy() {\n    // Early return if already destroyed\n    if (this.destroyed) {\n      return;\n    }\n\n    // Wait for all queued write operations to complete\n    await this.reportGenerator.flush();\n\n    await this.reportGenerator.finalize(this.dump);\n    this.reportFile = this.reportGenerator.getReportPath();\n\n    await this.interface.destroy?.();\n    this.resetDump(); // reset dump to release memory\n    this.destroyed = true;\n  }\n\n  async recordToReport(\n    title?: string,\n    opt?: {\n      content: string;\n    },\n  ) {\n    // 1. screenshot\n    const base64 = await this.interface.screenshotBase64();\n    const now = Date.now();\n    const screenshot = ScreenshotItem.create(base64, now);\n    // 2. build recorder\n    const recorder: ExecutionRecorderItem[] = [\n      {\n        type: 'screenshot',\n        ts: now,\n        screenshot,\n      },\n    ];\n    // 3. build ExecutionTaskLog\n    const task: ExecutionTaskLog = {\n      taskId: uuid(),\n      type: 'Log',\n      subType: 'Screenshot',\n      status: 'finished',\n      recorder,\n      timing: {\n        start: now,\n        end: now,\n        cost: 0,\n      },\n      param: {\n        content: opt?.content || '',\n      },\n      executor: async () => {},\n    };\n    // 4. build ExecutionDump\n    const executionDump = new ExecutionDump({\n      logTime: now,\n      name: `Log - ${title || 'untitled'}`,\n      description: opt?.content || '',\n      tasks: [task],\n    });\n    // 5. append to execution dump\n    this.appendExecutionDump(executionDump);\n\n    // Call all registered dump update listeners\n    const dumpString = this.dumpDataString();\n    for (const listener of this.dumpUpdateListeners) {\n      try {\n        listener(dumpString);\n      } catch (error) {\n        console.error('Error in onDumpUpdate listener', error);\n      }\n    }\n\n    this.writeOutActionDumps();\n    await this.reportGenerator.flush();\n  }\n\n  /**\n   * @deprecated Use {@link Agent.recordToReport} instead.\n   */\n  async logScreenshot(\n    title?: string,\n    opt?: {\n      content: string;\n    },\n  ) {\n    await this.recordToReport(title, opt);\n  }\n\n  _unstableLogContent() {\n    const { groupName, groupDescription, executions } = this.dump;\n    return {\n      groupName,\n      groupDescription,\n      executions: executions || [],\n    };\n  }\n\n  /**\n   * Freezes the current page context to be reused in subsequent AI operations\n   * This avoids recalculating page context for each operation\n   */\n  async freezePageContext(): Promise<void> {\n    debug('Freezing page context');\n    const context = await this._snapshotContext();\n    // Mark the context as frozen\n    context._isFrozen = true;\n    this.frozenUIContext = context;\n    debug('Page context frozen successfully');\n  }\n\n  /**\n   * Unfreezes the page context, allowing AI operations to calculate context dynamically\n   */\n  async unfreezePageContext(): Promise<void> {\n    debug('Unfreezing page context');\n    this.frozenUIContext = undefined;\n    debug('Page context unfrozen successfully');\n  }\n\n  /**\n   * Process cache configuration and return normalized cache settings\n   */\n  private processCacheConfig(opts: AgentOpt): {\n    id: string;\n    enabled: boolean;\n    readOnly: boolean;\n    writeOnly: boolean;\n    cacheAdapter?: import('./cache-adapter').CacheAdapter;\n  } | null {\n    // Validate original cache config before processing\n    // Agent requires explicit IDs - don't allow auto-generation\n    if (opts.cache === true) {\n      throw new Error(\n        'cache: true requires an explicit cache ID. Please provide:\\n' +\n          'Example: cache: { id: \"my-cache-id\" }',\n      );\n    }\n\n    // Check if cache config object is missing ID\n    if (\n      opts.cache &&\n      typeof opts.cache === 'object' &&\n      opts.cache !== null &&\n      !opts.cache.id\n    ) {\n      throw new Error(\n        'cache configuration requires an explicit id.\\n' +\n          'Example: cache: { id: \"my-cache-id\" }',\n      );\n    }\n\n    // Use the unified utils function to process cache configuration\n    const cacheConfig = processCacheConfig(\n      opts.cache,\n      opts.cacheId || opts.testId || 'default',\n    );\n\n    if (!cacheConfig) {\n      return null;\n    }\n\n    // Handle cache configuration object\n    if (typeof cacheConfig === 'object' && cacheConfig !== null) {\n      const id = cacheConfig.id;\n      const rawStrategy = cacheConfig.strategy as unknown;\n      let strategyValue: string;\n\n      if (rawStrategy === undefined) {\n        strategyValue = 'read-write';\n      } else if (typeof rawStrategy === 'string') {\n        strategyValue = rawStrategy;\n      } else {\n        throw new Error(\n          `cache.strategy must be a string when provided, but received type ${typeof rawStrategy}`,\n        );\n      }\n\n      if (!isValidCacheStrategy(strategyValue)) {\n        throw new Error(\n          `cache.strategy must be one of ${CACHE_STRATEGY_VALUES}, but received \"${strategyValue}\"`,\n        );\n      }\n\n      const isReadOnly = strategyValue === 'read-only';\n      const isWriteOnly = strategyValue === 'write-only';\n\n      return {\n        id,\n        enabled: !isWriteOnly,\n        readOnly: isReadOnly,\n        writeOnly: isWriteOnly,\n        cacheAdapter: cacheConfig.cacheAdapter,\n      };\n    }\n\n    return null;\n  }\n\n  private normalizeFilePaths(files: string[]): string[] {\n    if (ifInBrowser) {\n      throw new Error('File chooser is not supported in browser environment');\n    }\n\n    return files.map((file) => {\n      const absolutePath = resolve(file);\n      if (!existsSync(absolutePath)) {\n        throw new Error(`File not found: ${file}`);\n      }\n      return absolutePath;\n    });\n  }\n\n  private normalizeFileInput(files: string | string[]): string[] {\n    const filesArray = Array.isArray(files) ? files : [files];\n    return this.normalizeFilePaths(filesArray);\n  }\n\n  /**\n   * Manually flush cache to file\n   * @param options - Optional configuration\n   * @param options.cleanUnused - If true, removes unused cache records before flushing\n   */\n  async flushCache(options?: { cleanUnused?: boolean }): Promise<void> {\n    if (!this.taskCache) {\n      throw new Error('Cache is not configured');\n    }\n\n    this.taskCache.flushCacheToFile(options);\n  }\n}\n\nexport const createAgent = (\n  interfaceInstance: AbstractInterface,\n  opts?: AgentOpt,\n) => {\n  return new Agent(interfaceInstance, opts);\n};\n"],"names":["__webpack_require__","module","getter","definition","key","Object","obj","prop","Symbol","debug","getDebug","distanceOfTwoPoints","p1","p2","x1","y1","x2","y2","Math","includedInRect","point","rect","x","y","left","top","width","height","defaultServiceExtractOption","CACHE_STRATEGIES","isValidCacheStrategy","strategy","value","CACHE_STRATEGY_VALUES","legacyScrollTypeMap","normalizeScrollType","scrollType","defaultReplanningCycleLimit","defaultVlmUiTarsReplanningCycleLimit","defaultAutoGlmReplanningCycleLimit","Agent","callback","modelConfigForPlanning","undefined","isUITars","isAutoGLM","action","context","commonContextParser","prompt","console","GroupedActionDump","getVersion","WeakMap","execution","runner","currentDump","existingIndex","opt","ifInBrowser","reportHTMLContent","task","param","paramStr","tip","typeStr","name","type","actionPlan","plans","Boolean","title","taskTitleStr","locateParamStr","defaultIntentModelConfig","output","locatePrompt","assert","detailedLocateParam","buildDetailedLocateParam","fileChooserAccept","withFileChooser","locatePromptOrValue","locatePromptOrOpt","optOrUndefined","optWithValue","stringValue","String","mode","locatePromptOrKeyName","keyName","locatePromptOrScrollParam","scrollParam","normalizedScrollType","taskPrompt","abortSignal","Error","runAiAct","deepThink","deepLocate","noIndividualLocateModel","includeBboxInPlanning","cacheable","replanningCycleLimit","isVlmUiTars","isAutoGlm","matchedCache","yaml","imagesIncludeCount","actionOutput","yamlContent","yamlFlowStr","demand","modelConfig","textPrompt","multimodalPrompt","parsePrompt","center","verifyPrompt","retryLimit","success","retryCount","resultPrompt","verifyResult","text","locateOpt","expectCenter","verifyLocateOption","verifyCenter","verifyRect","distance","included","pass","locateParam","locatePlan","locatePlanForLocate","element","assertion","msg","serviceOpt","assertionText","thought","message","error","TaskExecutionError","errorTask","rawError","rawMessage","reason","args","yamlScriptContent","script","parseYamlScript","player","ScriptPlayer","errors","listener","index","base64","now","Date","screenshot","ScreenshotItem","recorder","uuid","executionDump","ExecutionDump","dumpString","groupName","groupDescription","executions","opts","cacheConfig","processCacheConfig","id","rawStrategy","strategyValue","isReadOnly","isWriteOnly","files","file","absolutePath","resolve","existsSync","filesArray","Array","options","interfaceInstance","envReplanningCycleLimit","globalConfigManager","MIDSCENE_REPLANNING_CYCLE_LIMIT","Number","resolvedAiActContext","hasCustomConfig","ModelConfigManager","globalModelConfigManager","Service","cacheConfigObj","TaskCache","baseActionSpace","defineActionSleep","TaskExecutor","getReportFileName","ReportGenerator","createAgent"],"mappings":"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"}

package/dist/lib/agent/utils.js

@@ -201,7 +201,7 @@ async function matchElementFromCache(context, cacheEntry, cachePrompt, cacheable
         return;
     }
 }
-const getMidsceneVersion = ()=>"1.5.9";
+const getMidsceneVersion = ()=>"1.5.10";
 const parsePrompt = (prompt)=>{
     if ('string' == typeof prompt) return {
         textPrompt: prompt,

package/dist/lib/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["webpack/runtime/compat_get_default_export","webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../src/types.ts"],"sourcesContent":["// getDefaultExport function for compatibility with non-ESM modules\n__webpack_require__.n = (module) => {\n\tvar getter = module && module.__esModule ?\n\t\t() => (module['default']) :\n\t\t() => (module);\n\t__webpack_require__.d(getter, { a: getter });\n\treturn getter;\n};\n","__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport {\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  rmSync,\n  writeFileSync,\n} from 'node:fs';\nimport { join } from 'node:path';\nimport type { NodeType } from '@midscene/shared/constants';\nimport type { CreateOpenAIClientFn, TModelConfig } from '@midscene/shared/env';\nimport type {\n  BaseElement,\n  LocateResultElement,\n  Rect,\n  Size,\n} from '@midscene/shared/types';\nimport type { z } from 'zod';\nimport type { TUserPrompt } from './common';\nimport { restoreImageReferences } from './dump/image-restoration';\nimport { ScreenshotItem } from './screenshot-item';\nimport type {\n  DetailedLocateParam,\n  MidsceneYamlFlowItem,\n  ServiceExtractOption,\n} from './yaml';\n\nexport type {\n  ElementTreeNode,\n  BaseElement,\n  Rect,\n  Size,\n  Point,\n} from '@midscene/shared/types';\nexport * from './yaml';\n\nexport type AIUsageInfo = Record<string, any> & {\n  prompt_tokens: number | undefined;\n  completion_tokens: number | undefined;\n  total_tokens: number | undefined;\n  cached_input: number | undefined;\n  time_cost: number | undefined;\n  model_name: string | undefined;\n  model_description: string | undefined;\n  intent: string | undefined;\n  request_id: string | undefined;\n};\n\nexport type { LocateResultElement };\n\nexport type AISingleElementResponseByPosition = {\n  position?: {\n    x: number;\n    y: number;\n  };\n  bbox?: [number, number, number, number];\n  reason: string;\n  text: string;\n};\n\nexport interface AIElementCoordinatesResponse {\n  bbox: [number, number, number, number];\n  errors?: string[];\n}\n\nexport type AIElementResponse = AIElementCoordinatesResponse;\n\nexport interface AIDataExtractionResponse<DataDemand> {\n  data: DataDemand;\n  errors?: string[];\n  thought?: string;\n}\n\nexport interface AISectionLocatorResponse {\n  bbox: [number, number, number, number];\n  references_bbox?: [number, number, number, number][];\n  error?: string;\n}\n\nexport interface AIAssertionResponse {\n  pass: boolean;\n  thought: string;\n}\n\nexport interface AIDescribeElementResponse {\n  description: string;\n  error?: string;\n}\n\nexport interface LocatorValidatorOption {\n  centerDistanceThreshold?: number;\n}\n\nexport interface LocateValidatorResult {\n  pass: boolean;\n  rect: Rect;\n  center: [number, number];\n  centerDistance?: number;\n}\n\nexport interface AgentDescribeElementAtPointResult {\n  prompt: string;\n  deepLocate: boolean;\n  verifyResult?: LocateValidatorResult;\n}\n\n/**\n * context\n */\n\nexport abstract class UIContext {\n  /**\n   * screenshot of the current UI state. which size is shotSize(be shrunk by screenshotShrinkFactor),\n   */\n  abstract screenshot: ScreenshotItem;\n\n  /**\n   * screenshot size after shrinking\n   */\n  abstract shotSize: Size;\n\n  /**\n   * The ratio for converting shrunk screenshot coordinates to logical coordinates.\n   *\n   * Example:\n   * - Physical screen width: 3000px, dpr=6\n   * - Logical width: 500px\n   * - User-defined screenshotShrinkFactor: 2\n   * - Actual shrunk screenshot width: 3000 / 2 = 1500px\n   * - shrunkShotToLogicalRatio: dpr / screenshotShrinkFactor = 6 / 2 = 3\n   * - To map back to logical coordinates: 1500 / shrunkShotToLogicalRatio = 500px\n   */\n  abstract shrunkShotToLogicalRatio: number;\n\n  abstract _isFrozen?: boolean;\n\n  // @deprecated - backward compatibility for aiLocate\n  abstract deprecatedDpr?: number;\n}\n\nexport type EnsureObject<T> = { [K in keyof T]: any };\n\nexport type ServiceAction = 'locate' | 'extract' | 'assert' | 'describe';\n\nexport type ServiceExtractParam = string | Record<string, string>;\n\nexport type ElementCacheFeature = Record<string, unknown>;\n\nexport interface LocateResult {\n  element: LocateResultElement | null;\n  rect?: Rect;\n}\n\nexport type ThinkingLevel = 'off' | 'medium' | 'high';\n\nexport type DeepThinkOption = 'unset' | true | false;\n\nexport interface ServiceTaskInfo {\n  durationMs: number;\n  formatResponse?: string;\n  rawResponse?: string;\n  usage?: AIUsageInfo;\n  searchArea?: Rect;\n  searchAreaRawResponse?: string;\n  searchAreaUsage?: AIUsageInfo;\n  reasoning_content?: string;\n}\n\nexport interface DumpMeta {\n  logTime: number;\n}\n\nexport interface ReportDumpWithAttributes {\n  dumpString: string;\n  attributes?: Record<string, any>;\n}\n\nexport interface ServiceDump extends DumpMeta {\n  type: 'locate' | 'extract' | 'assert';\n  logId: string;\n  userQuery: {\n    element?: TUserPrompt;\n    dataDemand?: ServiceExtractParam;\n    assertion?: TUserPrompt;\n  };\n  matchedElement: LocateResultElement[];\n  matchedRect?: Rect;\n  deepLocate?: boolean;\n  data: any;\n  assertionPass?: boolean;\n  assertionThought?: string;\n  taskInfo: ServiceTaskInfo;\n  error?: string;\n  output?: any;\n}\n\nexport type PartialServiceDumpFromSDK = Omit<\n  ServiceDump,\n  'logTime' | 'logId' | 'model_name'\n>;\n\nexport interface ServiceResultBase {\n  dump: ServiceDump;\n}\n\nexport type LocateResultWithDump = LocateResult & ServiceResultBase;\n\nexport interface ServiceExtractResult<T> extends ServiceResultBase {\n  data: T;\n  thought?: string;\n  usage?: AIUsageInfo;\n  reasoning_content?: string;\n}\n\nexport class ServiceError extends Error {\n  dump: ServiceDump;\n\n  constructor(message: string, dump: ServiceDump) {\n    super(message);\n    this.name = 'ServiceError';\n    this.dump = dump;\n  }\n}\n\n// intermediate variables to optimize the return value by AI\nexport interface LiteUISection {\n  name: string;\n  description: string;\n  sectionCharacteristics: string;\n  textIds: string[];\n}\n\nexport type ElementById = (id: string) => BaseElement | null;\n\nexport type ServiceAssertionResponse = AIAssertionResponse & {\n  usage?: AIUsageInfo;\n};\n\n/**\n * agent\n */\n\nexport type OnTaskStartTip = (tip: string) => Promise<void> | void;\n\nexport interface AgentWaitForOpt extends ServiceExtractOption {\n  checkIntervalMs?: number;\n  timeoutMs?: number;\n}\n\nexport interface AgentAssertOpt {\n  keepRawResponse?: boolean;\n}\n\n/**\n * planning\n *\n */\n\nexport interface PlanningLocateParam extends DetailedLocateParam {\n  bbox?: [number, number, number, number];\n}\n\nexport interface PlanningAction<ParamType = any> {\n  thought?: string;\n  log?: string; // a brief preamble to the user explaining what you’re about to do\n  type: string;\n  param: ParamType;\n}\n\nexport type SubGoalStatus = 'pending' | 'running' | 'finished';\n\nexport interface SubGoal {\n  index: number;\n  status: SubGoalStatus;\n  description: string;\n  logs?: string[];\n}\n\nexport interface RawResponsePlanningAIResponse {\n  action: PlanningAction;\n  thought?: string;\n  log: string;\n  memory?: string;\n  error?: string;\n  finalizeMessage?: string;\n  finalizeSuccess?: boolean;\n  updateSubGoals?: SubGoal[];\n  markFinishedIndexes?: number[];\n}\n\nexport interface PlanningAIResponse\n  extends Omit<RawResponsePlanningAIResponse, 'action'> {\n  actions?: PlanningAction[];\n  usage?: AIUsageInfo;\n  rawResponse?: string;\n  yamlFlow?: MidsceneYamlFlowItem[];\n  yamlString?: string;\n  error?: string;\n  reasoning_content?: string;\n  shouldContinuePlanning: boolean;\n  output?: string; // Output message from <complete> tag (same as finalizeMessage)\n}\n\nexport interface PlanningActionParamSleep {\n  timeMs: number;\n}\n\nexport interface PlanningActionParamError {\n  thought: string;\n}\n\nexport type PlanningActionParamWaitFor = AgentWaitForOpt & {};\n\nexport interface LongPressParam {\n  duration?: number;\n}\n\nexport interface PullParam {\n  direction: 'up' | 'down';\n  distance?: number;\n  duration?: number;\n}\n/**\n * misc\n */\n\nexport interface Color {\n  name: string;\n  hex: string;\n}\n\nexport interface BaseAgentParserOpt {\n  selector?: string;\n}\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\nexport interface PuppeteerParserOpt extends BaseAgentParserOpt {}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\nexport interface PlaywrightParserOpt extends BaseAgentParserOpt {}\n\n/*\naction\n*/\nexport interface ExecutionTaskProgressOptions {\n  onTaskStart?: (task: ExecutionTask) => Promise<void> | void;\n}\n\nexport interface ExecutionRecorderItem {\n  type: 'screenshot';\n  ts: number;\n  screenshot?: ScreenshotItem;\n  timing?: string;\n}\n\nexport type ExecutionTaskType = 'Planning' | 'Insight' | 'Action Space' | 'Log';\n\nexport interface ExecutorContext {\n  task: ExecutionTask;\n  element?: LocateResultElement | null;\n  uiContext?: UIContext;\n}\n\nexport interface ExecutionTaskApply<\n  Type extends ExecutionTaskType = any,\n  TaskParam = any,\n  TaskOutput = any,\n  TaskLog = any,\n> {\n  type: Type;\n  subType?: string;\n  param?: TaskParam;\n  thought?: string;\n  uiContext?: UIContext;\n  executor: (\n    param: TaskParam,\n    context: ExecutorContext,\n  ) => // biome-ignore lint/suspicious/noConfusingVoidType: void is intentionally allowed as some executors may not return a value\n    | Promise<ExecutionTaskReturn<TaskOutput, TaskLog> | undefined | void>\n    | undefined\n    | void;\n}\n\nexport interface ExecutionTaskHitBy {\n  from: string;\n  context: Record<string, any>;\n}\n\nexport interface ExecutionTaskReturn<TaskOutput = unknown, TaskLog = unknown> {\n  output?: TaskOutput;\n  log?: TaskLog;\n  recorder?: ExecutionRecorderItem[];\n  hitBy?: ExecutionTaskHitBy;\n}\n\nexport type ExecutionTask<\n  E extends ExecutionTaskApply<any, any, any> = ExecutionTaskApply<\n    any,\n    any,\n    any\n  >,\n> = E &\n  ExecutionTaskReturn<\n    E extends ExecutionTaskApply<any, any, infer TaskOutput, any>\n      ? TaskOutput\n      : unknown,\n    E extends ExecutionTaskApply<any, any, any, infer TaskLog>\n      ? TaskLog\n      : unknown\n  > & {\n    taskId: string;\n    status: 'pending' | 'running' | 'finished' | 'failed' | 'cancelled';\n    error?: Error;\n    errorMessage?: string;\n    errorStack?: string;\n    timing?: {\n      start: number;\n      getUiContextStart?: number;\n      getUiContextEnd?: number;\n      callAiStart?: number;\n      callAiEnd?: number;\n      beforeInvokeActionHookStart?: number;\n      beforeInvokeActionHookEnd?: number;\n      callActionStart?: number;\n      callActionEnd?: number;\n      afterInvokeActionHookStart?: number;\n      afterInvokeActionHookEnd?: number;\n      captureAfterCallingSnapshotStart?: number;\n      captureAfterCallingSnapshotEnd?: number;\n      end?: number;\n      cost?: number;\n    };\n    usage?: AIUsageInfo;\n    searchAreaUsage?: AIUsageInfo;\n    reasoning_content?: string;\n  };\n\nexport interface IExecutionDump extends DumpMeta {\n  name: string;\n  description?: string;\n  tasks: ExecutionTask[];\n  aiActContext?: string;\n}\n\n/**\n * Replacer function for JSON serialization that handles Page, Browser objects and ScreenshotItem\n */\nfunction replacerForDumpSerialization(_key: string, value: any): any {\n  if (value && value.constructor?.name === 'Page') {\n    return '[Page object]';\n  }\n  if (value && value.constructor?.name === 'Browser') {\n    return '[Browser object]';\n  }\n  // Handle ScreenshotItem serialization\n  if (value && typeof value.toSerializable === 'function') {\n    return value.toSerializable();\n  }\n  return value;\n}\n\n/**\n * Reviver function for JSON deserialization that handles ScreenshotItem formats.\n *\n * BEHAVIOR:\n * - For { $screenshot: \"id\" } format: Left as-is (plain object)\n *   Consumer must use imageMap to restore base64 data\n * - For { base64: \"...\" } format: Creates ScreenshotItem from base64 data\n *\n * @param key - JSON key being processed\n * @param value - JSON value being processed\n * @returns Restored value\n */\nfunction reviverForDumpDeserialization(key: string, value: any): any {\n  // Only process screenshot fields\n  if (key !== 'screenshot' || typeof value !== 'object' || value === null) {\n    return value;\n  }\n\n  // Handle serialized format: { $screenshot: \"id\" }\n  // Leave as plain object — consumer uses imageMap to restore\n  if (ScreenshotItem.isSerialized(value)) {\n    return value;\n  }\n\n  // Handle inline base64 format: { base64: \"...\" }\n  if ('base64' in value && typeof value.base64 === 'string') {\n    return value;\n  }\n\n  return value;\n}\n\n/**\n * ExecutionDump class for serializing and deserializing execution dumps\n */\nexport class ExecutionDump implements IExecutionDump {\n  logTime: number;\n  name: string;\n  description?: string;\n  tasks: ExecutionTask[];\n  aiActContext?: string;\n\n  constructor(data: IExecutionDump) {\n    this.logTime = data.logTime;\n    this.name = data.name;\n    this.description = data.description;\n    this.tasks = data.tasks;\n    this.aiActContext = data.aiActContext;\n  }\n\n  /**\n   * Serialize the ExecutionDump to a JSON string\n   */\n  serialize(indents?: number): string {\n    return JSON.stringify(this.toJSON(), replacerForDumpSerialization, indents);\n  }\n\n  /**\n   * Convert to a plain object for JSON serialization\n   */\n  toJSON(): IExecutionDump {\n    return {\n      logTime: this.logTime,\n      name: this.name,\n      description: this.description,\n      tasks: this.tasks.map((task) => ({\n        ...task,\n        recorder: task.recorder || [],\n      })),\n      aiActContext: this.aiActContext,\n    };\n  }\n\n  /**\n   * Create an ExecutionDump instance from a serialized JSON string\n   */\n  static fromSerializedString(serialized: string): ExecutionDump {\n    const parsed = JSON.parse(\n      serialized,\n      reviverForDumpDeserialization,\n    ) as IExecutionDump;\n    return new ExecutionDump(parsed);\n  }\n\n  /**\n   * Create an ExecutionDump instance from a plain object\n   */\n  static fromJSON(data: IExecutionDump): ExecutionDump {\n    return new ExecutionDump(data);\n  }\n\n  /**\n   * Collect all ScreenshotItem instances from tasks.\n   * Scans through uiContext and recorder items to find screenshots.\n   *\n   * @returns Array of ScreenshotItem instances\n   */\n  collectScreenshots(): ScreenshotItem[] {\n    const screenshots: ScreenshotItem[] = [];\n\n    for (const task of this.tasks) {\n      // Collect uiContext.screenshot if present\n      if (task.uiContext?.screenshot instanceof ScreenshotItem) {\n        screenshots.push(task.uiContext.screenshot);\n      }\n\n      // Collect recorder screenshots\n      if (task.recorder) {\n        for (const record of task.recorder) {\n          if (record.screenshot instanceof ScreenshotItem) {\n            screenshots.push(record.screenshot);\n          }\n        }\n      }\n    }\n\n    return screenshots;\n  }\n}\n\n/*\ntask - service-locate\n*/\nexport type ExecutionTaskInsightLocateParam = PlanningLocateParam;\n\nexport interface ExecutionTaskInsightLocateOutput {\n  element: LocateResultElement | null;\n}\n\nexport type ExecutionTaskInsightDump = ServiceDump;\n\nexport type ExecutionTaskInsightLocateApply = ExecutionTaskApply<\n  'Insight',\n  ExecutionTaskInsightLocateParam,\n  ExecutionTaskInsightLocateOutput,\n  ExecutionTaskInsightDump\n>;\n\nexport type ExecutionTaskInsightLocate =\n  ExecutionTask<ExecutionTaskInsightLocateApply>;\n\n/*\ntask - service-query\n*/\nexport interface ExecutionTaskInsightQueryParam {\n  dataDemand: ServiceExtractParam;\n}\n\nexport interface ExecutionTaskInsightQueryOutput {\n  data: any;\n}\n\nexport type ExecutionTaskInsightQueryApply = ExecutionTaskApply<\n  'Insight',\n  ExecutionTaskInsightQueryParam,\n  any,\n  ExecutionTaskInsightDump\n>;\n\nexport type ExecutionTaskInsightQuery =\n  ExecutionTask<ExecutionTaskInsightQueryApply>;\n\n/*\ntask - assertion\n*/\nexport interface ExecutionTaskInsightAssertionParam {\n  assertion: string;\n}\n\nexport type ExecutionTaskInsightAssertionApply = ExecutionTaskApply<\n  'Insight',\n  ExecutionTaskInsightAssertionParam,\n  ServiceAssertionResponse,\n  ExecutionTaskInsightDump\n>;\n\nexport type ExecutionTaskInsightAssertion =\n  ExecutionTask<ExecutionTaskInsightAssertionApply>;\n\n/*\ntask - action (i.e. interact) \n*/\nexport type ExecutionTaskActionApply<ActionParam = any> = ExecutionTaskApply<\n  'Action Space',\n  ActionParam,\n  void,\n  void\n>;\n\nexport type ExecutionTaskAction = ExecutionTask<ExecutionTaskActionApply>;\n\n/*\ntask - Log\n*/\n\nexport type ExecutionTaskLogApply<\n  LogParam = {\n    content: string;\n  },\n> = ExecutionTaskApply<'Log', LogParam, void, void>;\n\nexport type ExecutionTaskLog = ExecutionTask<ExecutionTaskLogApply>;\n\n/*\ntask - planning\n*/\n\nexport type ExecutionTaskPlanningApply = ExecutionTaskApply<\n  'Planning',\n  {\n    userInstruction: string;\n    aiActContext?: string;\n  },\n  PlanningAIResponse\n>;\n\nexport type ExecutionTaskPlanning = ExecutionTask<ExecutionTaskPlanningApply>;\n\n/*\ntask - planning-locate\n*/\nexport type ExecutionTaskPlanningLocateParam = PlanningLocateParam;\n\nexport interface ExecutionTaskPlanningLocateOutput {\n  element: LocateResultElement | null;\n}\n\nexport type ExecutionTaskPlanningDump = ServiceDump;\n\nexport type ExecutionTaskPlanningLocateApply = ExecutionTaskApply<\n  'Planning',\n  ExecutionTaskPlanningLocateParam,\n  ExecutionTaskPlanningLocateOutput,\n  ExecutionTaskPlanningDump\n>;\n\nexport type ExecutionTaskPlanningLocate =\n  ExecutionTask<ExecutionTaskPlanningLocateApply>;\n\n/*\nGrouped dump\n*/\nexport interface IGroupedActionDump {\n  sdkVersion: string;\n  groupName: string;\n  groupDescription?: string;\n  modelBriefs: string[];\n  executions: IExecutionDump[];\n  deviceType?: string;\n}\n\n/**\n * GroupedActionDump class for serializing and deserializing grouped action dumps\n */\nexport class GroupedActionDump implements IGroupedActionDump {\n  sdkVersion: string;\n  groupName: string;\n  groupDescription?: string;\n  modelBriefs: string[];\n  executions: ExecutionDump[];\n  deviceType?: string;\n\n  constructor(data: IGroupedActionDump) {\n    this.sdkVersion = data.sdkVersion;\n    this.groupName = data.groupName;\n    this.groupDescription = data.groupDescription;\n    this.modelBriefs = data.modelBriefs;\n    this.executions = data.executions.map((exec) =>\n      exec instanceof ExecutionDump ? exec : ExecutionDump.fromJSON(exec),\n    );\n    this.deviceType = data.deviceType;\n  }\n\n  /**\n   * Serialize the GroupedActionDump to a JSON string\n   * Uses compact { $screenshot: id } format\n   */\n  serialize(indents?: number): string {\n    return JSON.stringify(this.toJSON(), replacerForDumpSerialization, indents);\n  }\n\n  /**\n   * Serialize the GroupedActionDump with inline screenshots to a JSON string.\n   * Each ScreenshotItem is replaced with { base64: \"...\", capturedAt }.\n   */\n  serializeWithInlineScreenshots(indents?: number): string {\n    const processValue = (obj: unknown): unknown => {\n      if (obj instanceof ScreenshotItem) {\n        return { base64: obj.base64, capturedAt: obj.capturedAt };\n      }\n      if (Array.isArray(obj)) {\n        return obj.map(processValue);\n      }\n      if (obj && typeof obj === 'object') {\n        const entries = Object.entries(obj).map(([key, value]) => [\n          key,\n          processValue(value),\n        ]);\n        return Object.fromEntries(entries);\n      }\n      return obj;\n    };\n\n    const data = processValue(this.toJSON());\n    return JSON.stringify(data, null, indents);\n  }\n\n  /**\n   * Convert to a plain object for JSON serialization\n   */\n  toJSON(): IGroupedActionDump {\n    return {\n      sdkVersion: this.sdkVersion,\n      groupName: this.groupName,\n      groupDescription: this.groupDescription,\n      modelBriefs: this.modelBriefs,\n      executions: this.executions.map((exec) => exec.toJSON()),\n      deviceType: this.deviceType,\n    };\n  }\n\n  /**\n   * Create a GroupedActionDump instance from a serialized JSON string\n   */\n  static fromSerializedString(serialized: string): GroupedActionDump {\n    const parsed = JSON.parse(\n      serialized,\n      reviverForDumpDeserialization,\n    ) as IGroupedActionDump;\n    return new GroupedActionDump(parsed);\n  }\n\n  /**\n   * Create a GroupedActionDump instance from a plain object\n   */\n  static fromJSON(data: IGroupedActionDump): GroupedActionDump {\n    return new GroupedActionDump(data);\n  }\n\n  /**\n   * Collect all ScreenshotItem instances from all executions.\n   *\n   * @returns Array of all ScreenshotItem instances across all executions\n   */\n  collectAllScreenshots(): ScreenshotItem[] {\n    const screenshots: ScreenshotItem[] = [];\n    for (const execution of this.executions) {\n      screenshots.push(...execution.collectScreenshots());\n    }\n    return screenshots;\n  }\n\n  /**\n   * Serialize the dump to files with screenshots as separate PNG files.\n   * Creates:\n   * - {basePath} - dump JSON with { $screenshot: id } references\n   * - {basePath}.screenshots/ - PNG files\n   * - {basePath}.screenshots.json - ID to path mapping\n   *\n   * @param basePath - Base path for the dump file\n   */\n  serializeToFiles(basePath: string): void {\n    const screenshotsDir = `${basePath}.screenshots`;\n    if (!existsSync(screenshotsDir)) {\n      mkdirSync(screenshotsDir, { recursive: true });\n    }\n\n    // Write screenshots to separate files\n    const screenshotMap: Record<string, string> = {};\n    const screenshots = this.collectAllScreenshots();\n\n    for (const screenshot of screenshots) {\n      if (screenshot.hasBase64()) {\n        const imagePath = join(\n          screenshotsDir,\n          `${screenshot.id}.${screenshot.extension}`,\n        );\n        const rawBase64 = screenshot.rawBase64;\n        writeFileSync(imagePath, Buffer.from(rawBase64, 'base64'));\n        screenshotMap[screenshot.id] = imagePath;\n      }\n    }\n\n    // Write screenshot map file\n    writeFileSync(\n      `${basePath}.screenshots.json`,\n      JSON.stringify(screenshotMap),\n      'utf-8',\n    );\n\n    // Write dump JSON with references\n    writeFileSync(basePath, this.serialize(), 'utf-8');\n  }\n\n  /**\n   * Read dump from files and return JSON string with inline screenshots.\n   * Reads the dump JSON and screenshot files, then inlines the base64 data.\n   *\n   * @param basePath - Base path for the dump file\n   * @returns JSON string with inline screenshots ({ base64: \"...\" } format)\n   */\n  static fromFilesAsInlineJson(basePath: string): string {\n    const dumpString = readFileSync(basePath, 'utf-8');\n    const screenshotsMapPath = `${basePath}.screenshots.json`;\n\n    if (!existsSync(screenshotsMapPath)) {\n      return dumpString;\n    }\n\n    // Read screenshot map and build imageMap from files\n    const screenshotMap: Record<string, string> = JSON.parse(\n      readFileSync(screenshotsMapPath, 'utf-8'),\n    );\n\n    const imageMap: Record<string, string> = {};\n    for (const [id, filePath] of Object.entries(screenshotMap)) {\n      if (existsSync(filePath)) {\n        const data = readFileSync(filePath);\n        const mime =\n          filePath.endsWith('.jpeg') || filePath.endsWith('.jpg')\n            ? 'jpeg'\n            : 'png';\n        imageMap[id] = `data:image/${mime};base64,${data.toString('base64')}`;\n      }\n    }\n\n    // Restore image references\n    const dumpData = JSON.parse(dumpString);\n    const processedData = restoreImageReferences(\n      dumpData,\n      (id) => imageMap[id] ?? '',\n    );\n    return JSON.stringify(processedData);\n  }\n\n  /**\n   * Clean up all files associated with a serialized dump.\n   *\n   * @param basePath - Base path for the dump file\n   */\n  static cleanupFiles(basePath: string): void {\n    const filesToClean = [\n      basePath,\n      `${basePath}.screenshots.json`,\n      `${basePath}.screenshots`,\n    ];\n\n    for (const filePath of filesToClean) {\n      try {\n        rmSync(filePath, { force: true, recursive: true });\n      } catch {\n        // Ignore errors - file may already be deleted\n      }\n    }\n  }\n\n  /**\n   * Get all file paths associated with a serialized dump.\n   *\n   * @param basePath - Base path for the dump file\n   * @returns Array of all associated file paths\n   */\n  static getFilePaths(basePath: string): string[] {\n    return [\n      basePath,\n      `${basePath}.screenshots.json`,\n      `${basePath}.screenshots`,\n    ];\n  }\n}\n\nexport type InterfaceType =\n  | 'puppeteer'\n  | 'playwright'\n  | 'static'\n  | 'chrome-extension-proxy'\n  | 'android'\n  | string;\n\nexport interface StreamingCodeGenerationOptions {\n  /** Whether to enable streaming output */\n  stream?: boolean;\n  /** Callback function to handle streaming chunks */\n  onChunk?: StreamingCallback;\n  /** Callback function to handle streaming completion */\n  onComplete?: (finalCode: string) => void;\n  /** Callback function to handle streaming errors */\n  onError?: (error: Error) => void;\n}\n\nexport type StreamingCallback = (chunk: CodeGenerationChunk) => void;\n\nexport interface CodeGenerationChunk {\n  /** The incremental content chunk */\n  content: string;\n  /** The reasoning content */\n  reasoning_content: string;\n  /** The accumulated content so far */\n  accumulated: string;\n  /** Whether this is the final chunk */\n  isComplete: boolean;\n  /** Token usage information if available */\n  usage?: AIUsageInfo;\n}\n\nexport interface StreamingAIResponse {\n  /** The final accumulated content */\n  content: string;\n  /** Token usage information */\n  usage?: AIUsageInfo;\n  /** Whether the response was streamed */\n  isStreamed: boolean;\n}\n\nexport interface DeviceAction<TParam = any, TReturn = any> {\n  name: string;\n  description?: string;\n  interfaceAlias?: string;\n  paramSchema?: z.ZodType<TParam>;\n  call: (param: TParam, context: ExecutorContext) => Promise<TReturn> | TReturn;\n  delayAfterRunner?: number;\n  /**\n   * An example param object for this action.\n   * Locate fields with { prompt } will automatically get bbox injected when needed.\n   */\n  sample?: { [K in keyof TParam]?: any };\n}\n\n/**\n * Type utilities for extracting types from DeviceAction definitions\n */\n\n/**\n * Extract parameter type from a DeviceAction\n */\nexport type ActionParam<Action extends DeviceAction<any, any>> =\n  Action extends DeviceAction<infer P, any> ? P : never;\n\n/**\n * Extract return type from a DeviceAction\n */\nexport type ActionReturn<Action extends DeviceAction<any, any>> =\n  Action extends DeviceAction<any, infer R> ? R : never;\n\n/**\n * Web-specific types\n */\nexport interface WebElementInfo extends BaseElement {\n  id: string;\n  attributes: {\n    nodeType: NodeType;\n    [key: string]: string;\n  };\n}\n\n/**\n * Agent\n */\n\nexport type CacheConfig = {\n  strategy?: 'read-only' | 'read-write' | 'write-only';\n  id: string;\n};\n\nexport type Cache =\n  | false // No read, no write\n  | true // Will throw error at runtime - deprecated\n  | CacheConfig; // Object configuration (requires explicit id)\n\nexport interface AgentOpt {\n  testId?: string;\n  // @deprecated\n  cacheId?: string; // Keep backward compatibility, but marked as deprecated\n  groupName?: string;\n  groupDescription?: string;\n  /* if auto generate report, default true */\n  generateReport?: boolean;\n  /* if auto print report msg, default true */\n  autoPrintReportMsg?: boolean;\n\n  /**\n   * Use directory-based report format with separate image files.\n   *\n   * When enabled:\n   * - Screenshots are saved as PNG files in a `screenshots/` subdirectory\n   * - Report is generated as `index.html` with relative image paths\n   * - Reduces memory usage and report file size\n   *\n   * IMPORTANT: 'html-and-external-assets' reports must be served via HTTP server\n   * (e.g., `npx serve ./report-dir`). The file:// protocol will not\n   * work due to browser CORS restrictions.\n   *\n   * @default 'single-html'\n   */\n  outputFormat?: 'single-html' | 'html-and-external-assets';\n\n  onTaskStartTip?: OnTaskStartTip;\n  aiActContext?: string;\n  aiActionContext?: string;\n  /* custom report file name */\n  reportFileName?: string;\n  modelConfig?: TModelConfig;\n  cache?: Cache;\n  /**\n   * Maximum number of replanning cycles for aiAct.\n   * Defaults to 20 (40 for `vlm-ui-tars`) when not provided.\n   * If omitted, the agent will also read `MIDSCENE_REPLANNING_CYCLE_LIMIT` for backward compatibility.\n   */\n  replanningCycleLimit?: number;\n\n  /**\n   * Wait time in milliseconds after each action execution.\n   * This allows the UI to settle and stabilize before the next action.\n   * Defaults to 300ms when not provided.\n   */\n  waitAfterAction?: number;\n\n  /**\n   * When set to true, Midscene will use the target device's time (Android/iOS)\n   * instead of the system time. Useful when the device time differs from the\n   * host machine. Default: false\n   */\n  useDeviceTimestamp?: boolean;\n\n  /**\n   * Custom screenshot shrink factor to reduce AI token usage.\n   * When set, the screenshot will be scaled down by this factor from the physical resolution.\n   *\n   * Example:\n   * - Physical screen width: 3000px, dpr=6\n   * - Logical width: 500px\n   * - screenshotShrinkFactor: 2\n   * - Actual shrunk screenshot width: 3000 / 2 = 1500px\n   * - AI analyzes the 1500px screenshot\n   * - Coordinates are transformed back to logical (500px) before actions execute\n   *\n   * Benefits:\n   * - Reduces token usage for high-resolution screenshots\n   * - Maintains accuracy by scaling coordinates appropriately\n   *\n   * Must be >= 1 (shrinking only, enlarging is not supported).\n   *\n   * @default 1 (no shrinking, uses original physical screenshot)\n   */\n  screenshotShrinkFactor?: number;\n\n  /**\n   * Custom OpenAI client factory function\n   *\n   * If provided, this function will be called to create OpenAI client instances\n   * for each AI call, allowing you to:\n   * - Wrap clients with observability tools (langsmith, langfuse)\n   * - Use custom OpenAI-compatible clients\n   * - Apply different configurations based on intent\n   *\n   * @param config - Resolved model configuration\n   * @returns OpenAI client instance (original or wrapped)\n   *\n   * @example\n   * ```typescript\n   * createOpenAIClient: async (openai, opts) => {\n   *   // Wrap with langsmith for planning tasks\n   *   if (opts.baseURL?.includes('planning')) {\n   *     return wrapOpenAI(openai, { metadata: { task: 'planning' } });\n   *   }\n   *\n   *   return openai;\n   * }\n   * ```\n   */\n  createOpenAIClient?: CreateOpenAIClientFn;\n}\n\nexport type TestStatus =\n  | 'passed'\n  | 'failed'\n  | 'timedOut'\n  | 'skipped'\n  | 'interrupted';\n\nexport interface ReportFileWithAttributes {\n  reportFilePath: string;\n  reportAttributes: {\n    testDuration: number;\n    testStatus: TestStatus;\n    testTitle: string;\n    testId: string;\n    testDescription: string;\n  };\n}\n"],"names":["__webpack_require__","module","getter","definition","key","Object","obj","prop","Symbol","UIContext","ServiceError","Error","message","dump","replacerForDumpSerialization","_key","value","reviverForDumpDeserialization","ScreenshotItem","ExecutionDump","indents","JSON","task","serialized","parsed","data","screenshots","record","GroupedActionDump","processValue","Array","entries","exec","execution","basePath","screenshotsDir","existsSync","mkdirSync","screenshotMap","screenshot","imagePath","join","rawBase64","writeFileSync","Buffer","dumpString","readFileSync","screenshotsMapPath","imageMap","id","filePath","mime","dumpData","processedData","restoreImageReferences","filesToClean","rmSync"],"mappings":"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"}
+{"version":3,"file":"types.js","sources":["webpack/runtime/compat_get_default_export","webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object","../../src/types.ts"],"sourcesContent":["// getDefaultExport function for compatibility with non-ESM modules\n__webpack_require__.n = (module) => {\n\tvar getter = module && module.__esModule ?\n\t\t() => (module['default']) :\n\t\t() => (module);\n\t__webpack_require__.d(getter, { a: getter });\n\treturn getter;\n};\n","__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport {\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  rmSync,\n  writeFileSync,\n} from 'node:fs';\nimport { join } from 'node:path';\nimport type { NodeType } from '@midscene/shared/constants';\nimport type { CreateOpenAIClientFn, TModelConfig } from '@midscene/shared/env';\nimport type {\n  BaseElement,\n  LocateResultElement,\n  Rect,\n  Size,\n} from '@midscene/shared/types';\nimport type { z } from 'zod';\nimport type { TUserPrompt } from './common';\nimport { restoreImageReferences } from './dump/image-restoration';\nimport { ScreenshotItem } from './screenshot-item';\nimport type {\n  DetailedLocateParam,\n  MidsceneYamlFlowItem,\n  ServiceExtractOption,\n} from './yaml';\n\nexport type {\n  ElementTreeNode,\n  BaseElement,\n  Rect,\n  Size,\n  Point,\n} from '@midscene/shared/types';\nexport * from './yaml';\n\nexport type AIUsageInfo = Record<string, any> & {\n  prompt_tokens: number | undefined;\n  completion_tokens: number | undefined;\n  total_tokens: number | undefined;\n  cached_input: number | undefined;\n  time_cost: number | undefined;\n  model_name: string | undefined;\n  model_description: string | undefined;\n  intent: string | undefined;\n  request_id: string | undefined;\n};\n\nexport type { LocateResultElement };\n\nexport type AISingleElementResponseByPosition = {\n  position?: {\n    x: number;\n    y: number;\n  };\n  bbox?: [number, number, number, number];\n  reason: string;\n  text: string;\n};\n\nexport interface AIElementCoordinatesResponse {\n  bbox: [number, number, number, number];\n  errors?: string[];\n}\n\nexport type AIElementResponse = AIElementCoordinatesResponse;\n\nexport interface AIDataExtractionResponse<DataDemand> {\n  data: DataDemand;\n  errors?: string[];\n  thought?: string;\n}\n\nexport interface AISectionLocatorResponse {\n  bbox: [number, number, number, number];\n  references_bbox?: [number, number, number, number][];\n  error?: string;\n}\n\nexport interface AIAssertionResponse {\n  pass: boolean;\n  thought: string;\n}\n\nexport interface AIDescribeElementResponse {\n  description: string;\n  error?: string;\n}\n\nexport interface LocatorValidatorOption {\n  centerDistanceThreshold?: number;\n}\n\nexport interface LocateValidatorResult {\n  pass: boolean;\n  rect: Rect;\n  center: [number, number];\n  centerDistance?: number;\n}\n\nexport interface AgentDescribeElementAtPointResult {\n  prompt: string;\n  deepLocate: boolean;\n  verifyResult?: LocateValidatorResult;\n}\n\n/**\n * context\n */\n\nexport abstract class UIContext {\n  /**\n   * screenshot of the current UI state. which size is shotSize(be shrunk by screenshotShrinkFactor),\n   */\n  abstract screenshot: ScreenshotItem;\n\n  /**\n   * screenshot size after shrinking\n   */\n  abstract shotSize: Size;\n\n  /**\n   * The ratio for converting shrunk screenshot coordinates to logical coordinates.\n   *\n   * Example:\n   * - Physical screen width: 3000px, dpr=6\n   * - Logical width: 500px\n   * - User-defined screenshotShrinkFactor: 2\n   * - Actual shrunk screenshot width: 3000 / 2 = 1500px\n   * - shrunkShotToLogicalRatio: dpr / screenshotShrinkFactor = 6 / 2 = 3\n   * - To map back to logical coordinates: 1500 / shrunkShotToLogicalRatio = 500px\n   */\n  abstract shrunkShotToLogicalRatio: number;\n\n  abstract _isFrozen?: boolean;\n\n  // @deprecated - backward compatibility for aiLocate\n  abstract deprecatedDpr?: number;\n}\n\nexport type EnsureObject<T> = { [K in keyof T]: any };\n\nexport type ServiceAction = 'locate' | 'extract' | 'assert' | 'describe';\n\nexport type ServiceExtractParam = string | Record<string, string>;\n\nexport type ElementCacheFeature = Record<string, unknown>;\n\nexport interface LocateResult {\n  element: LocateResultElement | null;\n  rect?: Rect;\n}\n\nexport type ThinkingLevel = 'off' | 'medium' | 'high';\n\nexport type DeepThinkOption = 'unset' | true | false;\n\nexport interface ServiceTaskInfo {\n  durationMs: number;\n  formatResponse?: string;\n  rawResponse?: string;\n  usage?: AIUsageInfo;\n  searchArea?: Rect;\n  searchAreaRawResponse?: string;\n  searchAreaUsage?: AIUsageInfo;\n  reasoning_content?: string;\n}\n\nexport interface DumpMeta {\n  logTime: number;\n}\n\nexport interface ReportDumpWithAttributes {\n  dumpString: string;\n  attributes?: Record<string, any>;\n}\n\nexport interface ServiceDump extends DumpMeta {\n  type: 'locate' | 'extract' | 'assert';\n  logId: string;\n  userQuery: {\n    element?: TUserPrompt;\n    dataDemand?: ServiceExtractParam;\n    assertion?: TUserPrompt;\n  };\n  matchedElement: LocateResultElement[];\n  matchedRect?: Rect;\n  deepLocate?: boolean;\n  data: any;\n  assertionPass?: boolean;\n  assertionThought?: string;\n  taskInfo: ServiceTaskInfo;\n  error?: string;\n  output?: any;\n}\n\nexport type PartialServiceDumpFromSDK = Omit<\n  ServiceDump,\n  'logTime' | 'logId' | 'model_name'\n>;\n\nexport interface ServiceResultBase {\n  dump: ServiceDump;\n}\n\nexport type LocateResultWithDump = LocateResult & ServiceResultBase;\n\nexport interface ServiceExtractResult<T> extends ServiceResultBase {\n  data: T;\n  thought?: string;\n  usage?: AIUsageInfo;\n  reasoning_content?: string;\n}\n\nexport class ServiceError extends Error {\n  dump: ServiceDump;\n\n  constructor(message: string, dump: ServiceDump) {\n    super(message);\n    this.name = 'ServiceError';\n    this.dump = dump;\n  }\n}\n\n// intermediate variables to optimize the return value by AI\nexport interface LiteUISection {\n  name: string;\n  description: string;\n  sectionCharacteristics: string;\n  textIds: string[];\n}\n\nexport type ElementById = (id: string) => BaseElement | null;\n\nexport type ServiceAssertionResponse = AIAssertionResponse & {\n  usage?: AIUsageInfo;\n};\n\n/**\n * agent\n */\n\nexport type OnTaskStartTip = (tip: string) => Promise<void> | void;\n\nexport interface AgentWaitForOpt extends ServiceExtractOption {\n  checkIntervalMs?: number;\n  timeoutMs?: number;\n}\n\nexport interface AgentAssertOpt {\n  keepRawResponse?: boolean;\n}\n\n/**\n * planning\n *\n */\n\nexport interface PlanningLocateParam extends DetailedLocateParam {\n  bbox?: [number, number, number, number];\n}\n\nexport interface PlanningAction<ParamType = any> {\n  thought?: string;\n  log?: string; // a brief preamble to the user explaining what you’re about to do\n  type: string;\n  param: ParamType;\n}\n\nexport type SubGoalStatus = 'pending' | 'running' | 'finished';\n\nexport interface SubGoal {\n  index: number;\n  status: SubGoalStatus;\n  description: string;\n  logs?: string[];\n}\n\nexport interface RawResponsePlanningAIResponse {\n  action: PlanningAction;\n  thought?: string;\n  log: string;\n  memory?: string;\n  error?: string;\n  finalizeMessage?: string;\n  finalizeSuccess?: boolean;\n  updateSubGoals?: SubGoal[];\n  markFinishedIndexes?: number[];\n}\n\nexport interface PlanningAIResponse\n  extends Omit<RawResponsePlanningAIResponse, 'action'> {\n  actions?: PlanningAction[];\n  usage?: AIUsageInfo;\n  rawResponse?: string;\n  yamlFlow?: MidsceneYamlFlowItem[];\n  yamlString?: string;\n  error?: string;\n  reasoning_content?: string;\n  shouldContinuePlanning: boolean;\n  output?: string; // Output message from <complete> tag (same as finalizeMessage)\n}\n\nexport interface PlanningActionParamSleep {\n  timeMs: number;\n}\n\nexport interface PlanningActionParamError {\n  thought: string;\n}\n\nexport type PlanningActionParamWaitFor = AgentWaitForOpt & {};\n\nexport interface LongPressParam {\n  duration?: number;\n}\n\nexport interface PullParam {\n  direction: 'up' | 'down';\n  distance?: number;\n  duration?: number;\n}\n/**\n * misc\n */\n\nexport interface Color {\n  name: string;\n  hex: string;\n}\n\nexport interface BaseAgentParserOpt {\n  selector?: string;\n}\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\nexport interface PuppeteerParserOpt extends BaseAgentParserOpt {}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\nexport interface PlaywrightParserOpt extends BaseAgentParserOpt {}\n\n/*\naction\n*/\nexport interface ExecutionTaskProgressOptions {\n  onTaskStart?: (task: ExecutionTask) => Promise<void> | void;\n}\n\nexport interface ExecutionRecorderItem {\n  type: 'screenshot';\n  ts: number;\n  screenshot?: ScreenshotItem;\n  timing?: string;\n}\n\nexport type ExecutionTaskType = 'Planning' | 'Insight' | 'Action Space' | 'Log';\n\nexport interface ExecutorContext {\n  task: ExecutionTask;\n  element?: LocateResultElement | null;\n  uiContext?: UIContext;\n}\n\nexport interface ExecutionTaskApply<\n  Type extends ExecutionTaskType = any,\n  TaskParam = any,\n  TaskOutput = any,\n  TaskLog = any,\n> {\n  type: Type;\n  subType?: string;\n  param?: TaskParam;\n  thought?: string;\n  uiContext?: UIContext;\n  executor: (\n    param: TaskParam,\n    context: ExecutorContext,\n  ) => // biome-ignore lint/suspicious/noConfusingVoidType: void is intentionally allowed as some executors may not return a value\n    | Promise<ExecutionTaskReturn<TaskOutput, TaskLog> | undefined | void>\n    | undefined\n    | void;\n}\n\nexport interface ExecutionTaskHitBy {\n  from: string;\n  context: Record<string, any>;\n}\n\nexport interface ExecutionTaskReturn<TaskOutput = unknown, TaskLog = unknown> {\n  output?: TaskOutput;\n  log?: TaskLog;\n  recorder?: ExecutionRecorderItem[];\n  hitBy?: ExecutionTaskHitBy;\n}\n\nexport type ExecutionTask<\n  E extends ExecutionTaskApply<any, any, any> = ExecutionTaskApply<\n    any,\n    any,\n    any\n  >,\n> = E &\n  ExecutionTaskReturn<\n    E extends ExecutionTaskApply<any, any, infer TaskOutput, any>\n      ? TaskOutput\n      : unknown,\n    E extends ExecutionTaskApply<any, any, any, infer TaskLog>\n      ? TaskLog\n      : unknown\n  > & {\n    taskId: string;\n    status: 'pending' | 'running' | 'finished' | 'failed' | 'cancelled';\n    error?: Error;\n    errorMessage?: string;\n    errorStack?: string;\n    timing?: {\n      start: number;\n      getUiContextStart?: number;\n      getUiContextEnd?: number;\n      callAiStart?: number;\n      callAiEnd?: number;\n      beforeInvokeActionHookStart?: number;\n      beforeInvokeActionHookEnd?: number;\n      callActionStart?: number;\n      callActionEnd?: number;\n      afterInvokeActionHookStart?: number;\n      afterInvokeActionHookEnd?: number;\n      captureAfterCallingSnapshotStart?: number;\n      captureAfterCallingSnapshotEnd?: number;\n      end?: number;\n      cost?: number;\n    };\n    usage?: AIUsageInfo;\n    searchAreaUsage?: AIUsageInfo;\n    reasoning_content?: string;\n  };\n\nexport interface IExecutionDump extends DumpMeta {\n  name: string;\n  description?: string;\n  tasks: ExecutionTask[];\n  aiActContext?: string;\n}\n\n/**\n * Replacer function for JSON serialization that handles Page, Browser objects and ScreenshotItem\n */\nfunction replacerForDumpSerialization(_key: string, value: any): any {\n  if (value && value.constructor?.name === 'Page') {\n    return '[Page object]';\n  }\n  if (value && value.constructor?.name === 'Browser') {\n    return '[Browser object]';\n  }\n  // Handle ScreenshotItem serialization\n  if (value && typeof value.toSerializable === 'function') {\n    return value.toSerializable();\n  }\n  return value;\n}\n\n/**\n * Reviver function for JSON deserialization that handles ScreenshotItem formats.\n *\n * BEHAVIOR:\n * - For { $screenshot: \"id\" } format: Left as-is (plain object)\n *   Consumer must use imageMap to restore base64 data\n * - For { base64: \"...\" } format: Creates ScreenshotItem from base64 data\n *\n * @param key - JSON key being processed\n * @param value - JSON value being processed\n * @returns Restored value\n */\nfunction reviverForDumpDeserialization(key: string, value: any): any {\n  // Only process screenshot fields\n  if (key !== 'screenshot' || typeof value !== 'object' || value === null) {\n    return value;\n  }\n\n  // Handle serialized format: { $screenshot: \"id\" }\n  // Leave as plain object — consumer uses imageMap to restore\n  if (ScreenshotItem.isSerialized(value)) {\n    return value;\n  }\n\n  // Handle inline base64 format: { base64: \"...\" }\n  if ('base64' in value && typeof value.base64 === 'string') {\n    return value;\n  }\n\n  return value;\n}\n\n/**\n * ExecutionDump class for serializing and deserializing execution dumps\n */\nexport class ExecutionDump implements IExecutionDump {\n  logTime: number;\n  name: string;\n  description?: string;\n  tasks: ExecutionTask[];\n  aiActContext?: string;\n\n  constructor(data: IExecutionDump) {\n    this.logTime = data.logTime;\n    this.name = data.name;\n    this.description = data.description;\n    this.tasks = data.tasks;\n    this.aiActContext = data.aiActContext;\n  }\n\n  /**\n   * Serialize the ExecutionDump to a JSON string\n   */\n  serialize(indents?: number): string {\n    return JSON.stringify(this.toJSON(), replacerForDumpSerialization, indents);\n  }\n\n  /**\n   * Convert to a plain object for JSON serialization\n   */\n  toJSON(): IExecutionDump {\n    return {\n      logTime: this.logTime,\n      name: this.name,\n      description: this.description,\n      tasks: this.tasks.map((task) => ({\n        ...task,\n        recorder: task.recorder || [],\n      })),\n      aiActContext: this.aiActContext,\n    };\n  }\n\n  /**\n   * Create an ExecutionDump instance from a serialized JSON string\n   */\n  static fromSerializedString(serialized: string): ExecutionDump {\n    const parsed = JSON.parse(\n      serialized,\n      reviverForDumpDeserialization,\n    ) as IExecutionDump;\n    return new ExecutionDump(parsed);\n  }\n\n  /**\n   * Create an ExecutionDump instance from a plain object\n   */\n  static fromJSON(data: IExecutionDump): ExecutionDump {\n    return new ExecutionDump(data);\n  }\n\n  /**\n   * Collect all ScreenshotItem instances from tasks.\n   * Scans through uiContext and recorder items to find screenshots.\n   *\n   * @returns Array of ScreenshotItem instances\n   */\n  collectScreenshots(): ScreenshotItem[] {\n    const screenshots: ScreenshotItem[] = [];\n\n    for (const task of this.tasks) {\n      // Collect uiContext.screenshot if present\n      if (task.uiContext?.screenshot instanceof ScreenshotItem) {\n        screenshots.push(task.uiContext.screenshot);\n      }\n\n      // Collect recorder screenshots\n      if (task.recorder) {\n        for (const record of task.recorder) {\n          if (record.screenshot instanceof ScreenshotItem) {\n            screenshots.push(record.screenshot);\n          }\n        }\n      }\n    }\n\n    return screenshots;\n  }\n}\n\n/*\ntask - service-locate\n*/\nexport type ExecutionTaskInsightLocateParam = PlanningLocateParam;\n\nexport interface ExecutionTaskInsightLocateOutput {\n  element: LocateResultElement | null;\n}\n\nexport type ExecutionTaskInsightDump = ServiceDump;\n\nexport type ExecutionTaskInsightLocateApply = ExecutionTaskApply<\n  'Insight',\n  ExecutionTaskInsightLocateParam,\n  ExecutionTaskInsightLocateOutput,\n  ExecutionTaskInsightDump\n>;\n\nexport type ExecutionTaskInsightLocate =\n  ExecutionTask<ExecutionTaskInsightLocateApply>;\n\n/*\ntask - service-query\n*/\nexport interface ExecutionTaskInsightQueryParam {\n  dataDemand: ServiceExtractParam;\n}\n\nexport interface ExecutionTaskInsightQueryOutput {\n  data: any;\n}\n\nexport type ExecutionTaskInsightQueryApply = ExecutionTaskApply<\n  'Insight',\n  ExecutionTaskInsightQueryParam,\n  any,\n  ExecutionTaskInsightDump\n>;\n\nexport type ExecutionTaskInsightQuery =\n  ExecutionTask<ExecutionTaskInsightQueryApply>;\n\n/*\ntask - assertion\n*/\nexport interface ExecutionTaskInsightAssertionParam {\n  assertion: string;\n}\n\nexport type ExecutionTaskInsightAssertionApply = ExecutionTaskApply<\n  'Insight',\n  ExecutionTaskInsightAssertionParam,\n  ServiceAssertionResponse,\n  ExecutionTaskInsightDump\n>;\n\nexport type ExecutionTaskInsightAssertion =\n  ExecutionTask<ExecutionTaskInsightAssertionApply>;\n\n/*\ntask - action (i.e. interact) \n*/\nexport type ExecutionTaskActionApply<ActionParam = any> = ExecutionTaskApply<\n  'Action Space',\n  ActionParam,\n  void,\n  void\n>;\n\nexport type ExecutionTaskAction = ExecutionTask<ExecutionTaskActionApply>;\n\n/*\ntask - Log\n*/\n\nexport type ExecutionTaskLogApply<\n  LogParam = {\n    content: string;\n  },\n> = ExecutionTaskApply<'Log', LogParam, void, void>;\n\nexport type ExecutionTaskLog = ExecutionTask<ExecutionTaskLogApply>;\n\n/*\ntask - planning\n*/\n\nexport type ExecutionTaskPlanningApply = ExecutionTaskApply<\n  'Planning',\n  {\n    userInstruction: string;\n    aiActContext?: string;\n  },\n  PlanningAIResponse\n>;\n\nexport type ExecutionTaskPlanning = ExecutionTask<ExecutionTaskPlanningApply>;\n\n/*\ntask - planning-locate\n*/\nexport type ExecutionTaskPlanningLocateParam = PlanningLocateParam;\n\nexport interface ExecutionTaskPlanningLocateOutput {\n  element: LocateResultElement | null;\n}\n\nexport type ExecutionTaskPlanningDump = ServiceDump;\n\nexport type ExecutionTaskPlanningLocateApply = ExecutionTaskApply<\n  'Planning',\n  ExecutionTaskPlanningLocateParam,\n  ExecutionTaskPlanningLocateOutput,\n  ExecutionTaskPlanningDump\n>;\n\nexport type ExecutionTaskPlanningLocate =\n  ExecutionTask<ExecutionTaskPlanningLocateApply>;\n\n/*\nGrouped dump\n*/\nexport interface IGroupedActionDump {\n  sdkVersion: string;\n  groupName: string;\n  groupDescription?: string;\n  modelBriefs: string[];\n  executions: IExecutionDump[];\n  deviceType?: string;\n}\n\n/**\n * GroupedActionDump class for serializing and deserializing grouped action dumps\n */\nexport class GroupedActionDump implements IGroupedActionDump {\n  sdkVersion: string;\n  groupName: string;\n  groupDescription?: string;\n  modelBriefs: string[];\n  executions: ExecutionDump[];\n  deviceType?: string;\n\n  constructor(data: IGroupedActionDump) {\n    this.sdkVersion = data.sdkVersion;\n    this.groupName = data.groupName;\n    this.groupDescription = data.groupDescription;\n    this.modelBriefs = data.modelBriefs;\n    this.executions = data.executions.map((exec) =>\n      exec instanceof ExecutionDump ? exec : ExecutionDump.fromJSON(exec),\n    );\n    this.deviceType = data.deviceType;\n  }\n\n  /**\n   * Serialize the GroupedActionDump to a JSON string\n   * Uses compact { $screenshot: id } format\n   */\n  serialize(indents?: number): string {\n    return JSON.stringify(this.toJSON(), replacerForDumpSerialization, indents);\n  }\n\n  /**\n   * Serialize the GroupedActionDump with inline screenshots to a JSON string.\n   * Each ScreenshotItem is replaced with { base64: \"...\", capturedAt }.\n   */\n  serializeWithInlineScreenshots(indents?: number): string {\n    const processValue = (obj: unknown): unknown => {\n      if (obj instanceof ScreenshotItem) {\n        return { base64: obj.base64, capturedAt: obj.capturedAt };\n      }\n      if (Array.isArray(obj)) {\n        return obj.map(processValue);\n      }\n      if (obj && typeof obj === 'object') {\n        const entries = Object.entries(obj).map(([key, value]) => [\n          key,\n          processValue(value),\n        ]);\n        return Object.fromEntries(entries);\n      }\n      return obj;\n    };\n\n    const data = processValue(this.toJSON());\n    return JSON.stringify(data, null, indents);\n  }\n\n  /**\n   * Convert to a plain object for JSON serialization\n   */\n  toJSON(): IGroupedActionDump {\n    return {\n      sdkVersion: this.sdkVersion,\n      groupName: this.groupName,\n      groupDescription: this.groupDescription,\n      modelBriefs: this.modelBriefs,\n      executions: this.executions.map((exec) => exec.toJSON()),\n      deviceType: this.deviceType,\n    };\n  }\n\n  /**\n   * Create a GroupedActionDump instance from a serialized JSON string\n   */\n  static fromSerializedString(serialized: string): GroupedActionDump {\n    const parsed = JSON.parse(\n      serialized,\n      reviverForDumpDeserialization,\n    ) as IGroupedActionDump;\n    return new GroupedActionDump(parsed);\n  }\n\n  /**\n   * Create a GroupedActionDump instance from a plain object\n   */\n  static fromJSON(data: IGroupedActionDump): GroupedActionDump {\n    return new GroupedActionDump(data);\n  }\n\n  /**\n   * Collect all ScreenshotItem instances from all executions.\n   *\n   * @returns Array of all ScreenshotItem instances across all executions\n   */\n  collectAllScreenshots(): ScreenshotItem[] {\n    const screenshots: ScreenshotItem[] = [];\n    for (const execution of this.executions) {\n      screenshots.push(...execution.collectScreenshots());\n    }\n    return screenshots;\n  }\n\n  /**\n   * Serialize the dump to files with screenshots as separate PNG files.\n   * Creates:\n   * - {basePath} - dump JSON with { $screenshot: id } references\n   * - {basePath}.screenshots/ - PNG files\n   * - {basePath}.screenshots.json - ID to path mapping\n   *\n   * @param basePath - Base path for the dump file\n   */\n  serializeToFiles(basePath: string): void {\n    const screenshotsDir = `${basePath}.screenshots`;\n    if (!existsSync(screenshotsDir)) {\n      mkdirSync(screenshotsDir, { recursive: true });\n    }\n\n    // Write screenshots to separate files\n    const screenshotMap: Record<string, string> = {};\n    const screenshots = this.collectAllScreenshots();\n\n    for (const screenshot of screenshots) {\n      if (screenshot.hasBase64()) {\n        const imagePath = join(\n          screenshotsDir,\n          `${screenshot.id}.${screenshot.extension}`,\n        );\n        const rawBase64 = screenshot.rawBase64;\n        writeFileSync(imagePath, Buffer.from(rawBase64, 'base64'));\n        screenshotMap[screenshot.id] = imagePath;\n      }\n    }\n\n    // Write screenshot map file\n    writeFileSync(\n      `${basePath}.screenshots.json`,\n      JSON.stringify(screenshotMap),\n      'utf-8',\n    );\n\n    // Write dump JSON with references\n    writeFileSync(basePath, this.serialize(), 'utf-8');\n  }\n\n  /**\n   * Read dump from files and return JSON string with inline screenshots.\n   * Reads the dump JSON and screenshot files, then inlines the base64 data.\n   *\n   * @param basePath - Base path for the dump file\n   * @returns JSON string with inline screenshots ({ base64: \"...\" } format)\n   */\n  static fromFilesAsInlineJson(basePath: string): string {\n    const dumpString = readFileSync(basePath, 'utf-8');\n    const screenshotsMapPath = `${basePath}.screenshots.json`;\n\n    if (!existsSync(screenshotsMapPath)) {\n      return dumpString;\n    }\n\n    // Read screenshot map and build imageMap from files\n    const screenshotMap: Record<string, string> = JSON.parse(\n      readFileSync(screenshotsMapPath, 'utf-8'),\n    );\n\n    const imageMap: Record<string, string> = {};\n    for (const [id, filePath] of Object.entries(screenshotMap)) {\n      if (existsSync(filePath)) {\n        const data = readFileSync(filePath);\n        const mime =\n          filePath.endsWith('.jpeg') || filePath.endsWith('.jpg')\n            ? 'jpeg'\n            : 'png';\n        imageMap[id] = `data:image/${mime};base64,${data.toString('base64')}`;\n      }\n    }\n\n    // Restore image references\n    const dumpData = JSON.parse(dumpString);\n    const processedData = restoreImageReferences(\n      dumpData,\n      (id) => imageMap[id] ?? '',\n    );\n    return JSON.stringify(processedData);\n  }\n\n  /**\n   * Clean up all files associated with a serialized dump.\n   *\n   * @param basePath - Base path for the dump file\n   */\n  static cleanupFiles(basePath: string): void {\n    const filesToClean = [\n      basePath,\n      `${basePath}.screenshots.json`,\n      `${basePath}.screenshots`,\n    ];\n\n    for (const filePath of filesToClean) {\n      try {\n        rmSync(filePath, { force: true, recursive: true });\n      } catch {\n        // Ignore errors - file may already be deleted\n      }\n    }\n  }\n\n  /**\n   * Get all file paths associated with a serialized dump.\n   *\n   * @param basePath - Base path for the dump file\n   * @returns Array of all associated file paths\n   */\n  static getFilePaths(basePath: string): string[] {\n    return [\n      basePath,\n      `${basePath}.screenshots.json`,\n      `${basePath}.screenshots`,\n    ];\n  }\n}\n\nexport type InterfaceType =\n  | 'puppeteer'\n  | 'playwright'\n  | 'static'\n  | 'chrome-extension-proxy'\n  | 'android'\n  | string;\n\nexport interface StreamingCodeGenerationOptions {\n  /** Whether to enable streaming output */\n  stream?: boolean;\n  /** Callback function to handle streaming chunks */\n  onChunk?: StreamingCallback;\n  /** Callback function to handle streaming completion */\n  onComplete?: (finalCode: string) => void;\n  /** Callback function to handle streaming errors */\n  onError?: (error: Error) => void;\n}\n\nexport type StreamingCallback = (chunk: CodeGenerationChunk) => void;\n\nexport interface CodeGenerationChunk {\n  /** The incremental content chunk */\n  content: string;\n  /** The reasoning content */\n  reasoning_content: string;\n  /** The accumulated content so far */\n  accumulated: string;\n  /** Whether this is the final chunk */\n  isComplete: boolean;\n  /** Token usage information if available */\n  usage?: AIUsageInfo;\n}\n\nexport interface StreamingAIResponse {\n  /** The final accumulated content */\n  content: string;\n  /** Token usage information */\n  usage?: AIUsageInfo;\n  /** Whether the response was streamed */\n  isStreamed: boolean;\n}\n\nexport interface DeviceAction<TParam = any, TReturn = any> {\n  name: string;\n  description?: string;\n  interfaceAlias?: string;\n  paramSchema?: z.ZodType<TParam>;\n  call: (param: TParam, context: ExecutorContext) => Promise<TReturn> | TReturn;\n  delayAfterRunner?: number;\n  /**\n   * An example param object for this action.\n   * Locate fields with { prompt } will automatically get bbox injected when needed.\n   */\n  sample?: { [K in keyof TParam]?: any };\n}\n\n/**\n * Type utilities for extracting types from DeviceAction definitions\n */\n\n/**\n * Extract parameter type from a DeviceAction\n */\nexport type ActionParam<Action extends DeviceAction<any, any>> =\n  Action extends DeviceAction<infer P, any> ? P : never;\n\n/**\n * Extract return type from a DeviceAction\n */\nexport type ActionReturn<Action extends DeviceAction<any, any>> =\n  Action extends DeviceAction<any, infer R> ? R : never;\n\n/**\n * Web-specific types\n */\nexport interface WebElementInfo extends BaseElement {\n  id: string;\n  attributes: {\n    nodeType: NodeType;\n    [key: string]: string;\n  };\n}\n\n/**\n * Agent\n */\n\nexport type CacheConfig = {\n  strategy?: 'read-only' | 'read-write' | 'write-only';\n  id: string;\n  cacheAdapter?: import('./agent/cache-adapter').CacheAdapter;\n};\n\nexport type Cache =\n  | false // No read, no write\n  | true // Will throw error at runtime - deprecated\n  | CacheConfig; // Object configuration (requires explicit id)\n\nexport interface AgentOpt {\n  testId?: string;\n  // @deprecated\n  cacheId?: string; // Keep backward compatibility, but marked as deprecated\n  groupName?: string;\n  groupDescription?: string;\n  /* if auto generate report, default true */\n  generateReport?: boolean;\n  /* if auto print report msg, default true */\n  autoPrintReportMsg?: boolean;\n\n  /**\n   * Use directory-based report format with separate image files.\n   *\n   * When enabled:\n   * - Screenshots are saved as PNG files in a `screenshots/` subdirectory\n   * - Report is generated as `index.html` with relative image paths\n   * - Reduces memory usage and report file size\n   *\n   * IMPORTANT: 'html-and-external-assets' reports must be served via HTTP server\n   * (e.g., `npx serve ./report-dir`). The file:// protocol will not\n   * work due to browser CORS restrictions.\n   *\n   * @default 'single-html'\n   */\n  outputFormat?: 'single-html' | 'html-and-external-assets';\n\n  onTaskStartTip?: OnTaskStartTip;\n  aiActContext?: string;\n  aiActionContext?: string;\n  /* custom report file name */\n  reportFileName?: string;\n  modelConfig?: TModelConfig;\n  cache?: Cache;\n  /**\n   * Maximum number of replanning cycles for aiAct.\n   * Defaults to 20 (40 for `vlm-ui-tars`) when not provided.\n   * If omitted, the agent will also read `MIDSCENE_REPLANNING_CYCLE_LIMIT` for backward compatibility.\n   */\n  replanningCycleLimit?: number;\n\n  /**\n   * Wait time in milliseconds after each action execution.\n   * This allows the UI to settle and stabilize before the next action.\n   * Defaults to 300ms when not provided.\n   */\n  waitAfterAction?: number;\n\n  /**\n   * When set to true, Midscene will use the target device's time (Android/iOS)\n   * instead of the system time. Useful when the device time differs from the\n   * host machine. Default: false\n   */\n  useDeviceTimestamp?: boolean;\n\n  /**\n   * Custom screenshot shrink factor to reduce AI token usage.\n   * When set, the screenshot will be scaled down by this factor from the physical resolution.\n   *\n   * Example:\n   * - Physical screen width: 3000px, dpr=6\n   * - Logical width: 500px\n   * - screenshotShrinkFactor: 2\n   * - Actual shrunk screenshot width: 3000 / 2 = 1500px\n   * - AI analyzes the 1500px screenshot\n   * - Coordinates are transformed back to logical (500px) before actions execute\n   *\n   * Benefits:\n   * - Reduces token usage for high-resolution screenshots\n   * - Maintains accuracy by scaling coordinates appropriately\n   *\n   * Must be >= 1 (shrinking only, enlarging is not supported).\n   *\n   * @default 1 (no shrinking, uses original physical screenshot)\n   */\n  screenshotShrinkFactor?: number;\n\n  /**\n   * Custom OpenAI client factory function\n   *\n   * If provided, this function will be called to create OpenAI client instances\n   * for each AI call, allowing you to:\n   * - Wrap clients with observability tools (langsmith, langfuse)\n   * - Use custom OpenAI-compatible clients\n   * - Apply different configurations based on intent\n   *\n   * @param config - Resolved model configuration\n   * @returns OpenAI client instance (original or wrapped)\n   *\n   * @example\n   * ```typescript\n   * createOpenAIClient: async (openai, opts) => {\n   *   // Wrap with langsmith for planning tasks\n   *   if (opts.baseURL?.includes('planning')) {\n   *     return wrapOpenAI(openai, { metadata: { task: 'planning' } });\n   *   }\n   *\n   *   return openai;\n   * }\n   * ```\n   */\n  createOpenAIClient?: CreateOpenAIClientFn;\n}\n\nexport type TestStatus =\n  | 'passed'\n  | 'failed'\n  | 'timedOut'\n  | 'skipped'\n  | 'interrupted';\n\nexport interface ReportFileWithAttributes {\n  reportFilePath: string;\n  reportAttributes: {\n    testDuration: number;\n    testStatus: TestStatus;\n    testTitle: string;\n    testId: string;\n    testDescription: string;\n  };\n}\n"],"names":["__webpack_require__","module","getter","definition","key","Object","obj","prop","Symbol","UIContext","ServiceError","Error","message","dump","replacerForDumpSerialization","_key","value","reviverForDumpDeserialization","ScreenshotItem","ExecutionDump","indents","JSON","task","serialized","parsed","data","screenshots","record","GroupedActionDump","processValue","Array","entries","exec","execution","basePath","screenshotsDir","existsSync","mkdirSync","screenshotMap","screenshot","imagePath","join","rawBase64","writeFileSync","Buffer","dumpString","readFileSync","screenshotsMapPath","imageMap","id","filePath","mime","dumpData","processedData","restoreImageReferences","filesToClean","rmSync"],"mappings":"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"}

package/dist/lib/utils.js

@@ -202,7 +202,7 @@ function stringifyDumpData(data, indents) {
     return JSON.stringify(data, replacerForPageObject, indents);
 }
 function getVersion() {
-    return "1.5.9";
+    return "1.5.10";
 }
 function debugLog(...message) {
     const debugMode = process.env[env_namespaceObject.MIDSCENE_DEBUG_MODE];

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

@@ -2,9 +2,8 @@ export { Agent, createAgent } from './agent';
 export { commonContextParser } from './utils';
 export { getReportFileName, printReportMsg, } from './utils';
 export { extractInsightParam, locateParamStr, paramStr, taskTitleStr, typeStr, } from './ui-utils';
-export { type LocateCache, type PlanningCache, TaskCache } from './task-cache';
+export { type LocateCache, type PlanningCache, TaskCache, type CacheFileContent, } from './task-cache';
 export { cacheFileExt } from './task-cache';
-export type { CacheFileContent } from './task-cache';
 export type { CacheAdapter } from './cache-adapter';
 export { TaskExecutor } from './tasks';
 export { getCurrentExecutionFile } from './utils';

package/dist/types/types.d.ts

@@ -537,6 +537,7 @@ export interface WebElementInfo extends BaseElement {
 export type CacheConfig = {
     strategy?: 'read-only' | 'read-write' | 'write-only';
     id: string;
+    cacheAdapter?: import('./agent/cache-adapter').CacheAdapter;
 };
 export type Cache = false | true | CacheConfig;
 export interface AgentOpt {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@donggui/core",
   "description": "DongGUI Core - Automate browser actions, extract data, and perform assertions using AI.",
-  "version": "1.5.9",
+  "version": "1.5.11",
   "repository": "https://github.com/web-infra-dev/midscene",
   "homepage": "https://midscenejs.com/",
   "main": "./dist/lib/index.js",