@midscene/core 1.9.1 → 1.9.2-beta-20260605084246.0

package/dist/es/agent/agent.mjs

@@ -329,6 +329,7 @@ class Agent {
         });
     }
     async aiAct(taskPrompt, opt) {
+        const taskPromptText = 'string' == typeof taskPrompt ? taskPrompt : taskPrompt.prompt;
         const fileChooserAccept = opt?.fileChooserAccept ? this.normalizeFileInput(opt.fileChooserAccept) : void 0;
         const abortSignal = opt?.abortSignal;
         if (abortSignal?.aborted) throw new Error(`aiAct aborted: ${abortSignal.reason || 'signal already aborted'}`);
@@ -360,7 +361,7 @@ class Agent {
                 const yamlContent = {
                     tasks: [
                         {
-                            name: taskPrompt,
+                            name: taskPromptText,
                             flow: actionOutput.yamlFlow
                         }
                     ]

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

@@ -1 +1 @@
-{"version":3,"file":"agent/agent.mjs","sources":["../../../src/agent/agent.ts"],"sourcesContent":["import { type ModelRuntime, getModelRuntime } from '@/ai-model/models';\nimport yaml from 'js-yaml';\nimport 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 DeepThinkOption,\n  type DeviceAction,\n  ExecutionDump,\n  type ExecutionRecorderItem,\n  type ExecutionTask,\n  type ExecutionTaskLog,\n  type LocateOption,\n  type LocateResultElement,\n  type LocateValidatorResult,\n  type LocatorValidatorOption,\n  type OnTaskStartTip,\n  type PlanningAction,\n  type Rect,\n  ReportActionDump,\n  type ReportMeta,\n  type ScrollParam,\n  type ServiceAction,\n  type ServiceExtractOption,\n  type ServiceExtractParam,\n  type TestStatus,\n  type UIContext,\n} from '../types';\nimport type { MidsceneYamlScript } from '../yaml';\n\nimport type { IReportGenerator } from '@/report-generator';\nimport {\n  ReportGenerator,\n  assertReportGenerationOptions,\n} 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  type TIntent,\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 { validateAgentCacheInput } from './cache-config';\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\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\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: ReportActionDump;\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  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   * Fails fast for non-web interfaces when the model family is missing.\n   *\n   * Early Midscene web usage allowed running without `modelFamily` and falling\n   * back to a default bbox parser. Non-web users do not have that compatibility\n   * path, so this check helps surface configuration problems before spending a\n   * model call.\n   *\n   * Web flows validate missing locate model family at workflow boundaries:\n   * `Service.locate` throws when aiTap/aiType fallback to the default model for\n   * direct locate, and generic planning throws when aiAct asks a planning model\n   * to return inline locate coordinates. Those checks are intentionally placed\n   * where Midscene knows which model role should provide coordinate parsing.\n   */\n  private assertModelFamilyForNonWebContext() {\n    if (\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    }\n  }\n\n  private resolveReplanningCycleLimit(planningModel: ModelRuntime): number {\n    return (\n      this.opts.replanningCycleLimit ??\n      globalConfigManager.getEnvConfigValueAsNumber(\n        MIDSCENE_REPLANNING_CYCLE_LIMIT,\n      ) ??\n      planningModel.adapter.planning.defaultReplanningCycleLimit\n    );\n  }\n\n  private resolveModelRuntime(intent: TIntent): ModelRuntime {\n    return getModelRuntime(this.modelConfigManager.getModelConfig(intent));\n  }\n\n  constructor(interfaceInstance: InterfaceType, opts?: AgentOpt) {\n    this.interface = interfaceInstance;\n\n    this.opts = Object.assign(\n      {\n        generateReport: true,\n        persistExecutionDump: false,\n        autoPrintReportMsg: true,\n        groupName: 'Midscene Report',\n        groupDescription: '',\n      },\n      opts || {},\n    );\n    assertReportGenerationOptions(this.opts);\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          cacheDir: cacheConfigObj.cacheDir,\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      useDeviceTime: this.opts.useDeviceTime,\n      actionSpace: this.fullActionSpace,\n      hooks: {\n        onTaskUpdate: async (runner) => {\n          const executionDump = runner.dump();\n          this.appendExecutionDump(executionDump, runner);\n\n          // Persist report updates before notifying listeners so screenshot\n          // payloads can be released from memory and serialized as references.\n          this.writeOutActionDumps(executionDump);\n          await this.reportGenerator.flush();\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      },\n    });\n    this.dump = this.resetDump();\n    this.reportFileName =\n      opts?.reportFileName ||\n      // Keep deprecated testId behavior for generated report names until it is\n      // fully removed from the public API.\n      getReportFileName(opts?.testId || this.interface.interfaceType || 'web');\n\n    this.reportGenerator = ReportGenerator.create(this.reportFileName!, {\n      generateReport: this.opts.generateReport,\n      persistExecutionDump: this.opts.persistExecutionDump,\n      outputFormat: this.opts.outputFormat,\n      autoPrintReportMsg: this.opts.autoPrintReportMsg,\n      reuseExistingReport:\n        this.opts.reportAttributes?.['data-group-id'] === this.reportFileName,\n    });\n  }\n\n  async getActionSpace(): Promise<DeviceAction[]> {\n    return this.fullActionSpace;\n  }\n\n  private static readonly CONTEXT_RETRY_MAX = 3;\n  private static readonly CONTEXT_RETRY_DELAY_MS = 1500;\n\n  /**\n   * Override in subclasses to indicate which errors are transient and should\n   * trigger an automatic retry when building the UI context.\n   * Returns `false` by default (no retry).\n   */\n  protected isRetryableContextError(_error: unknown): boolean {\n    return false;\n  }\n\n  async getUIContext(action?: ServiceAction): Promise<UIContext> {\n    // Some non-web flows, such as Android, need an Agent instance before they\n    // can call device methods via ADB, so defer missing modelFamily errors\n    // until UI context is actually requested.\n    this.assertModelFamilyForNonWebContext();\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    const maxRetries = Agent.CONTEXT_RETRY_MAX;\n    for (let attempt = 0; ; attempt++) {\n      try {\n        return await commonContextParser(this.interface, {\n          uploadServerUrl: this.modelConfigManager.getUploadTestServerUrl(),\n          screenshotShrinkFactor: this.opts.screenshotShrinkFactor,\n        });\n      } catch (error) {\n        if (attempt < maxRetries && this.isRetryableContextError(error)) {\n          debug(\n            `retryable context error (attempt ${attempt + 1}/${maxRetries}), retrying in ${Agent.CONTEXT_RETRY_DELAY_MS}ms: ${error}`,\n          );\n          await new Promise((resolve) =>\n            setTimeout(resolve, Agent.CONTEXT_RETRY_DELAY_MS),\n          );\n          continue;\n        }\n        throw error;\n      }\n    }\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 ReportActionDump({\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  private lastExecutionDump?: ExecutionDump;\n\n  writeOutActionDumps(executionDump?: ExecutionDump) {\n    const exec = executionDump || this.lastExecutionDump;\n    if (exec) {\n      this.lastExecutionDump = exec;\n      this.reportGenerator.onExecutionUpdate(\n        exec,\n        this.getReportMeta(),\n        this.opts.reportAttributes,\n      );\n    }\n    this.reportFile = this.reportGenerator.getReportPath();\n  }\n\n  private getReportMeta(): ReportMeta {\n    return {\n      groupName: this.dump.groupName,\n      groupDescription: this.dump.groupDescription,\n      sdkVersion: this.dump.sdkVersion,\n      modelBriefs: this.dump.modelBriefs,\n      deviceType: this.dump.deviceType,\n    };\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 defaultModel = this.resolveModelRuntime('default');\n    const planningModel = this.resolveModelRuntime('planning');\n\n    const { output } = await this.taskExecutor.runPlans(\n      title,\n      plans,\n      planningModel,\n      defaultModel,\n    );\n    return output;\n  }\n\n  async aiTap(\n    locatePrompt: TUserPrompt,\n    opt?: LocateOption & { fileChooserAccept?: string | string[] },\n  ): Promise<void> {\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    await withFileChooser(this.interface, fileChooserAccept, async () => {\n      await this.callActionInActionSpace('Tap', {\n        locate: detailedLocateParam,\n      });\n    });\n  }\n\n  async aiRightClick(\n    locatePrompt: TUserPrompt,\n    opt?: LocateOption,\n  ): Promise<void> {\n    assert(locatePrompt, 'missing locate prompt for right click');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    await this.callActionInActionSpace('RightClick', {\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiDoubleClick(\n    locatePrompt: TUserPrompt,\n    opt?: LocateOption,\n  ): Promise<void> {\n    assert(locatePrompt, 'missing locate prompt for double click');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    await this.callActionInActionSpace('DoubleClick', {\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiHover(locatePrompt: TUserPrompt, opt?: LocateOption): Promise<void> {\n    assert(locatePrompt, 'missing locate prompt for hover');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    await 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<void>;\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<void>;\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    await 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<void>;\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<void>;\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    await 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<void>;\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<void>;\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    const isLocatePromptLike = (value: unknown): value is TUserPrompt => {\n      if (\n        typeof value === 'string' ||\n        typeof value === 'undefined' ||\n        value === null\n      ) {\n        return true;\n      }\n\n      return typeof value === 'object' && value !== null && 'prompt' in value;\n    };\n\n    // Check if using new signature (first param is locatePrompt, second is options)\n    if (\n      isLocatePromptLike(locatePromptOrScrollParam) &&\n      typeof locatePromptOrOpt === 'object' &&\n      locatePromptOrOpt !== null\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    await this.callActionInActionSpace('Scroll', {\n      ...(opt || {}),\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiPinch(\n    locatePrompt: TUserPrompt | undefined,\n    opt: LocateOption & {\n      direction: 'in' | 'out';\n      distance?: number;\n      duration?: number;\n    },\n  ): Promise<void> {\n    const detailedLocateParam = buildDetailedLocateParam(\n      locatePrompt || '',\n      opt,\n    );\n\n    await this.callActionInActionSpace('Pinch', {\n      ...opt,\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiLongPress(\n    locatePrompt: TUserPrompt,\n    opt?: LocateOption & { duration?: number },\n  ): Promise<void> {\n    assert(locatePrompt, 'missing locate prompt for long press');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    await this.callActionInActionSpace('LongPress', {\n      ...(opt || {}),\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiClearInput(\n    locatePrompt: TUserPrompt,\n    opt?: LocateOption,\n  ): Promise<void> {\n    assert(locatePrompt, 'missing locate prompt for clear input');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    await this.callActionInActionSpace('ClearInput', {\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 planningModel = this.resolveModelRuntime('planning');\n      const defaultModel = this.resolveModelRuntime('default');\n      // Controls the aiAct planning mode, such as sub-goal prompts and locate result strategy.\n      const deepThink = opt?.deepThink === true;\n\n      const deepLocate = opt?.deepLocate;\n\n      const noIndividualLocateModel = planningModel.config.slot === 'default';\n\n      const includeLocateInPlanning = !deepThink && noIndividualLocateModel;\n\n      debug('setting includeLocateInPlanning to', includeLocateInPlanning, {\n        deepThink,\n        noIndividualLocateModel,\n      });\n\n      const cacheable = opt?.cacheable;\n      const replanningCycleLimit =\n        this.resolveReplanningCycleLimit(planningModel);\n      const planCacheEnabled = planningModel.adapter.planning.cacheEnabled;\n      const matchedCache =\n        !planCacheEnabled || cacheable === false\n          ? undefined\n          : this.taskCache?.matchPlanCache(taskPrompt);\n      if (\n        matchedCache?.cacheUsable &&\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 is not executable, fall through to normal execution\n      const imagesIncludeCount: number = deepThink ? 2 : 1;\n      const { output: actionOutput } = await this.taskExecutor.action(\n        taskPrompt,\n        planningModel,\n        defaultModel,\n        includeLocateInPlanning,\n        this.aiActContext,\n        cacheable,\n        replanningCycleLimit,\n        imagesIncludeCount,\n        deepThink,\n        fileChooserAccept,\n        deepLocate,\n        abortSignal,\n      );\n\n      // update cache\n      if (\n        this.taskCache &&\n        actionOutput?.yamlFlow?.length &&\n        cacheable !== false\n      ) {\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 modelRuntime = this.resolveModelRuntime('insight');\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'Query',\n      demand,\n      modelRuntime,\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 modelRuntime = this.resolveModelRuntime('insight');\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'Boolean',\n      textPrompt,\n      modelRuntime,\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 modelRuntime = this.resolveModelRuntime('insight');\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'Number',\n      textPrompt,\n      modelRuntime,\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 modelRuntime = this.resolveModelRuntime('insight');\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'String',\n      textPrompt,\n      modelRuntime,\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 modelRuntime = this.resolveModelRuntime('insight');\n\n      const text = await this.service.describe(center, modelRuntime, {\n        deepLocate,\n      });\n      debug('aiDescribe text', text);\n      assert(text.description, `failed to describe element at [${center}]`);\n      resultPrompt = text.description;\n\n      if (!verifyPrompt) {\n        success = true;\n        break;\n      }\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 add another first-pass locate and search-area\n      // crop around an already element-level description, which is not the intent of\n      // verification.\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  /**\n   * Locate an element and return both its center point and an approximate rect.\n   *\n   * - In most locate flows, `rect` represents the matched element boundary.\n   * - Some models only support point grounding instead of boundary grounding.\n   *   In those cases (for example, AutoGLM), `rect` falls back to a small 8x8\n   *   box centered on the located point.\n   *\n   * Because `rect` may vary with the underlying model capability, avoid relying\n   * on it too heavily for strict boundary semantics. If you need a stable click\n   * target, prefer `center`.\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 defaultModel = this.resolveModelRuntime('default');\n    const planningModel = this.resolveModelRuntime('planning');\n\n    const { output } = await this.taskExecutor.runPlans(\n      taskTitleStr('Locate', locateParamStr(locateParam)),\n      plans,\n      planningModel,\n      defaultModel,\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 modelRuntime = this.resolveModelRuntime('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          modelRuntime,\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 modelRuntime = this.resolveModelRuntime('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      modelRuntime,\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    this.destroyed = true;\n    let interfaceDestroyError: unknown;\n    try {\n      await this.interface.destroy?.();\n    } catch (error) {\n      interfaceDestroyError = error;\n    }\n\n    // Wait for all queued write operations to complete\n    await this.reportGenerator.flush();\n\n    const finalPath = await this.reportGenerator.finalize();\n    this.reportFile = finalPath;\n\n    this.resetDump(); // reset dump to release memory\n\n    if (interfaceDestroyError) {\n      throw interfaceDestroyError;\n    }\n  }\n\n  async recordToReport(\n    title?: string,\n    opt?: {\n      content?: string;\n      screenshotBase64?: string;\n    },\n  ) {\n    // 1. screenshot\n    const base64 =\n      opt?.screenshotBase64 ?? (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      id: uuid(),\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    this.writeOutActionDumps(executionDump);\n    await this.reportGenerator.flush();\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\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    cacheDir?: string;\n  } | null {\n    validateAgentCacheInput(opts.cache);\n\n    // Use the unified utils function to process cache configuration\n    const cacheConfig = processCacheConfig(\n      opts.cache,\n      opts.cacheId || '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 strategyValue = cacheConfig.strategy ?? 'read-write';\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        cacheDir: cacheConfig.cacheDir?.trim(),\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(\n          `File not found: ${file}. Resolved to: ${absolutePath}. Current working directory: ${process.cwd()}`,\n        );\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","legacyScrollTypeMap","normalizeScrollType","scrollType","Agent","callback","planningModel","globalConfigManager","MIDSCENE_REPLANNING_CYCLE_LIMIT","intent","getModelRuntime","_error","action","maxRetries","attempt","commonContextParser","error","Promise","resolve","setTimeout","prompt","console","ReportActionDump","getVersion","WeakMap","execution","runner","currentDump","existingIndex","undefined","opt","ifInBrowser","reportHTMLContent","executionDump","exec","task","param","paramStr","tip","typeStr","name","type","actionPlan","plans","Boolean","title","taskTitleStr","locateParamStr","defaultModel","output","locatePrompt","assert","detailedLocateParam","buildDetailedLocateParam","fileChooserAccept","withFileChooser","locatePromptOrValue","locatePromptOrOpt","optOrUndefined","value","optWithValue","stringValue","String","mode","locatePromptOrKeyName","keyName","locatePromptOrScrollParam","scrollParam","isLocatePromptLike","normalizedScrollType","taskPrompt","abortSignal","Error","runAiAct","deepThink","deepLocate","noIndividualLocateModel","includeLocateInPlanning","cacheable","replanningCycleLimit","planCacheEnabled","matchedCache","yaml","imagesIncludeCount","actionOutput","yamlContent","yamlFlowStr","demand","modelRuntime","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","TaskExecutionError","errorTask","rawError","rawMessage","reason","args","yamlScriptContent","script","parseYamlScript","player","ScriptPlayer","errors","listener","index","interfaceDestroyError","finalPath","base64","now","Date","screenshot","ScreenshotItem","recorder","uuid","ExecutionDump","dumpString","groupName","groupDescription","executions","context","opts","validateAgentCacheInput","cacheConfig","processCacheConfig","id","strategyValue","isReadOnly","isWriteOnly","files","file","absolutePath","existsSync","process","filesArray","Array","options","interfaceInstance","Object","assertReportGenerationOptions","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 ModelRuntime, getModelRuntime } from '@/ai-model/models';\nimport yaml from 'js-yaml';\nimport 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 DeepThinkOption,\n  type DeviceAction,\n  ExecutionDump,\n  type ExecutionRecorderItem,\n  type ExecutionTask,\n  type ExecutionTaskLog,\n  type LocateOption,\n  type LocateResultElement,\n  type LocateValidatorResult,\n  type LocatorValidatorOption,\n  type OnTaskStartTip,\n  type PlanningAction,\n  type Rect,\n  ReportActionDump,\n  type ReportMeta,\n  type ScrollParam,\n  type ServiceAction,\n  type ServiceExtractOption,\n  type ServiceExtractParam,\n  type TestStatus,\n  type UIContext,\n} from '../types';\nimport type { MidsceneYamlScript } from '../yaml';\n\nimport type { IReportGenerator } from '@/report-generator';\nimport {\n  ReportGenerator,\n  assertReportGenerationOptions,\n} 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  type TIntent,\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 { validateAgentCacheInput } from './cache-config';\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\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\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: ReportActionDump;\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  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   * Fails fast for non-web interfaces when the model family is missing.\n   *\n   * Early Midscene web usage allowed running without `modelFamily` and falling\n   * back to a default bbox parser. Non-web users do not have that compatibility\n   * path, so this check helps surface configuration problems before spending a\n   * model call.\n   *\n   * Web flows validate missing locate model family at workflow boundaries:\n   * `Service.locate` throws when aiTap/aiType fallback to the default model for\n   * direct locate, and generic planning throws when aiAct asks a planning model\n   * to return inline locate coordinates. Those checks are intentionally placed\n   * where Midscene knows which model role should provide coordinate parsing.\n   */\n  private assertModelFamilyForNonWebContext() {\n    if (\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    }\n  }\n\n  private resolveReplanningCycleLimit(planningModel: ModelRuntime): number {\n    return (\n      this.opts.replanningCycleLimit ??\n      globalConfigManager.getEnvConfigValueAsNumber(\n        MIDSCENE_REPLANNING_CYCLE_LIMIT,\n      ) ??\n      planningModel.adapter.planning.defaultReplanningCycleLimit\n    );\n  }\n\n  private resolveModelRuntime(intent: TIntent): ModelRuntime {\n    return getModelRuntime(this.modelConfigManager.getModelConfig(intent));\n  }\n\n  constructor(interfaceInstance: InterfaceType, opts?: AgentOpt) {\n    this.interface = interfaceInstance;\n\n    this.opts = Object.assign(\n      {\n        generateReport: true,\n        persistExecutionDump: false,\n        autoPrintReportMsg: true,\n        groupName: 'Midscene Report',\n        groupDescription: '',\n      },\n      opts || {},\n    );\n    assertReportGenerationOptions(this.opts);\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          cacheDir: cacheConfigObj.cacheDir,\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      useDeviceTime: this.opts.useDeviceTime,\n      actionSpace: this.fullActionSpace,\n      hooks: {\n        onTaskUpdate: async (runner) => {\n          const executionDump = runner.dump();\n          this.appendExecutionDump(executionDump, runner);\n\n          // Persist report updates before notifying listeners so screenshot\n          // payloads can be released from memory and serialized as references.\n          this.writeOutActionDumps(executionDump);\n          await this.reportGenerator.flush();\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      },\n    });\n    this.dump = this.resetDump();\n    this.reportFileName =\n      opts?.reportFileName ||\n      // Keep deprecated testId behavior for generated report names until it is\n      // fully removed from the public API.\n      getReportFileName(opts?.testId || this.interface.interfaceType || 'web');\n\n    this.reportGenerator = ReportGenerator.create(this.reportFileName!, {\n      generateReport: this.opts.generateReport,\n      persistExecutionDump: this.opts.persistExecutionDump,\n      outputFormat: this.opts.outputFormat,\n      autoPrintReportMsg: this.opts.autoPrintReportMsg,\n      reuseExistingReport:\n        this.opts.reportAttributes?.['data-group-id'] === this.reportFileName,\n    });\n  }\n\n  async getActionSpace(): Promise<DeviceAction[]> {\n    return this.fullActionSpace;\n  }\n\n  private static readonly CONTEXT_RETRY_MAX = 3;\n  private static readonly CONTEXT_RETRY_DELAY_MS = 1500;\n\n  /**\n   * Override in subclasses to indicate which errors are transient and should\n   * trigger an automatic retry when building the UI context.\n   * Returns `false` by default (no retry).\n   */\n  protected isRetryableContextError(_error: unknown): boolean {\n    return false;\n  }\n\n  async getUIContext(action?: ServiceAction): Promise<UIContext> {\n    // Some non-web flows, such as Android, need an Agent instance before they\n    // can call device methods via ADB, so defer missing modelFamily errors\n    // until UI context is actually requested.\n    this.assertModelFamilyForNonWebContext();\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    const maxRetries = Agent.CONTEXT_RETRY_MAX;\n    for (let attempt = 0; ; attempt++) {\n      try {\n        return await commonContextParser(this.interface, {\n          uploadServerUrl: this.modelConfigManager.getUploadTestServerUrl(),\n          screenshotShrinkFactor: this.opts.screenshotShrinkFactor,\n        });\n      } catch (error) {\n        if (attempt < maxRetries && this.isRetryableContextError(error)) {\n          debug(\n            `retryable context error (attempt ${attempt + 1}/${maxRetries}), retrying in ${Agent.CONTEXT_RETRY_DELAY_MS}ms: ${error}`,\n          );\n          await new Promise((resolve) =>\n            setTimeout(resolve, Agent.CONTEXT_RETRY_DELAY_MS),\n          );\n          continue;\n        }\n        throw error;\n      }\n    }\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 ReportActionDump({\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  private lastExecutionDump?: ExecutionDump;\n\n  writeOutActionDumps(executionDump?: ExecutionDump) {\n    const exec = executionDump || this.lastExecutionDump;\n    if (exec) {\n      this.lastExecutionDump = exec;\n      this.reportGenerator.onExecutionUpdate(\n        exec,\n        this.getReportMeta(),\n        this.opts.reportAttributes,\n      );\n    }\n    this.reportFile = this.reportGenerator.getReportPath();\n  }\n\n  private getReportMeta(): ReportMeta {\n    return {\n      groupName: this.dump.groupName,\n      groupDescription: this.dump.groupDescription,\n      sdkVersion: this.dump.sdkVersion,\n      modelBriefs: this.dump.modelBriefs,\n      deviceType: this.dump.deviceType,\n    };\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 defaultModel = this.resolveModelRuntime('default');\n    const planningModel = this.resolveModelRuntime('planning');\n\n    const { output } = await this.taskExecutor.runPlans(\n      title,\n      plans,\n      planningModel,\n      defaultModel,\n    );\n    return output;\n  }\n\n  async aiTap(\n    locatePrompt: TUserPrompt,\n    opt?: LocateOption & { fileChooserAccept?: string | string[] },\n  ): Promise<void> {\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    await withFileChooser(this.interface, fileChooserAccept, async () => {\n      await this.callActionInActionSpace('Tap', {\n        locate: detailedLocateParam,\n      });\n    });\n  }\n\n  async aiRightClick(\n    locatePrompt: TUserPrompt,\n    opt?: LocateOption,\n  ): Promise<void> {\n    assert(locatePrompt, 'missing locate prompt for right click');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    await this.callActionInActionSpace('RightClick', {\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiDoubleClick(\n    locatePrompt: TUserPrompt,\n    opt?: LocateOption,\n  ): Promise<void> {\n    assert(locatePrompt, 'missing locate prompt for double click');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    await this.callActionInActionSpace('DoubleClick', {\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiHover(locatePrompt: TUserPrompt, opt?: LocateOption): Promise<void> {\n    assert(locatePrompt, 'missing locate prompt for hover');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    await 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<void>;\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<void>;\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    await 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<void>;\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<void>;\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    await 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<void>;\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<void>;\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    const isLocatePromptLike = (value: unknown): value is TUserPrompt => {\n      if (\n        typeof value === 'string' ||\n        typeof value === 'undefined' ||\n        value === null\n      ) {\n        return true;\n      }\n\n      return typeof value === 'object' && value !== null && 'prompt' in value;\n    };\n\n    // Check if using new signature (first param is locatePrompt, second is options)\n    if (\n      isLocatePromptLike(locatePromptOrScrollParam) &&\n      typeof locatePromptOrOpt === 'object' &&\n      locatePromptOrOpt !== null\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    await this.callActionInActionSpace('Scroll', {\n      ...(opt || {}),\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiPinch(\n    locatePrompt: TUserPrompt | undefined,\n    opt: LocateOption & {\n      direction: 'in' | 'out';\n      distance?: number;\n      duration?: number;\n    },\n  ): Promise<void> {\n    const detailedLocateParam = buildDetailedLocateParam(\n      locatePrompt || '',\n      opt,\n    );\n\n    await this.callActionInActionSpace('Pinch', {\n      ...opt,\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiLongPress(\n    locatePrompt: TUserPrompt,\n    opt?: LocateOption & { duration?: number },\n  ): Promise<void> {\n    assert(locatePrompt, 'missing locate prompt for long press');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    await this.callActionInActionSpace('LongPress', {\n      ...(opt || {}),\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiClearInput(\n    locatePrompt: TUserPrompt,\n    opt?: LocateOption,\n  ): Promise<void> {\n    assert(locatePrompt, 'missing locate prompt for clear input');\n\n    const detailedLocateParam = buildDetailedLocateParam(locatePrompt, opt);\n\n    await this.callActionInActionSpace('ClearInput', {\n      locate: detailedLocateParam,\n    });\n  }\n\n  async aiAct(\n    taskPrompt: TUserPrompt,\n    opt?: AiActOptions,\n  ): Promise<string | undefined> {\n    const taskPromptText =\n      typeof taskPrompt === 'string' ? taskPrompt : taskPrompt.prompt;\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 planningModel = this.resolveModelRuntime('planning');\n      const defaultModel = this.resolveModelRuntime('default');\n      // Controls the aiAct planning mode, such as sub-goal prompts and locate result strategy.\n      const deepThink = opt?.deepThink === true;\n\n      const deepLocate = opt?.deepLocate;\n\n      const noIndividualLocateModel = planningModel.config.slot === 'default';\n\n      const includeLocateInPlanning = !deepThink && noIndividualLocateModel;\n\n      debug('setting includeLocateInPlanning to', includeLocateInPlanning, {\n        deepThink,\n        noIndividualLocateModel,\n      });\n\n      const cacheable = opt?.cacheable;\n      const replanningCycleLimit =\n        this.resolveReplanningCycleLimit(planningModel);\n      const planCacheEnabled = planningModel.adapter.planning.cacheEnabled;\n      const matchedCache =\n        !planCacheEnabled || cacheable === false\n          ? undefined\n          : this.taskCache?.matchPlanCache(taskPrompt);\n      if (\n        matchedCache?.cacheUsable &&\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 is not executable, fall through to normal execution\n      const imagesIncludeCount: number = deepThink ? 2 : 1;\n      const { output: actionOutput } = await this.taskExecutor.action(\n        taskPrompt,\n        planningModel,\n        defaultModel,\n        includeLocateInPlanning,\n        this.aiActContext,\n        cacheable,\n        replanningCycleLimit,\n        imagesIncludeCount,\n        deepThink,\n        fileChooserAccept,\n        deepLocate,\n        abortSignal,\n      );\n\n      // update cache\n      if (\n        this.taskCache &&\n        actionOutput?.yamlFlow?.length &&\n        cacheable !== false\n      ) {\n        const yamlContent: MidsceneYamlScript = {\n          tasks: [\n            {\n              name: taskPromptText,\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: TUserPrompt, 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 modelRuntime = this.resolveModelRuntime('insight');\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'Query',\n      demand,\n      modelRuntime,\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 modelRuntime = this.resolveModelRuntime('insight');\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'Boolean',\n      textPrompt,\n      modelRuntime,\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 modelRuntime = this.resolveModelRuntime('insight');\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'Number',\n      textPrompt,\n      modelRuntime,\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 modelRuntime = this.resolveModelRuntime('insight');\n\n    const { textPrompt, multimodalPrompt } = parsePrompt(prompt);\n    const { output } = await this.taskExecutor.createTypeQueryExecution(\n      'String',\n      textPrompt,\n      modelRuntime,\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 modelRuntime = this.resolveModelRuntime('insight');\n\n      const text = await this.service.describe(center, modelRuntime, {\n        deepLocate,\n      });\n      debug('aiDescribe text', text);\n      assert(text.description, `failed to describe element at [${center}]`);\n      resultPrompt = text.description;\n\n      if (!verifyPrompt) {\n        success = true;\n        break;\n      }\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 add another first-pass locate and search-area\n      // crop around an already element-level description, which is not the intent of\n      // verification.\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  /**\n   * Locate an element and return both its center point and an approximate rect.\n   *\n   * - In most locate flows, `rect` represents the matched element boundary.\n   * - Some models only support point grounding instead of boundary grounding.\n   *   In those cases (for example, AutoGLM), `rect` falls back to a small 8x8\n   *   box centered on the located point.\n   *\n   * Because `rect` may vary with the underlying model capability, avoid relying\n   * on it too heavily for strict boundary semantics. If you need a stable click\n   * target, prefer `center`.\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 defaultModel = this.resolveModelRuntime('default');\n    const planningModel = this.resolveModelRuntime('planning');\n\n    const { output } = await this.taskExecutor.runPlans(\n      taskTitleStr('Locate', locateParamStr(locateParam)),\n      plans,\n      planningModel,\n      defaultModel,\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 modelRuntime = this.resolveModelRuntime('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          modelRuntime,\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 modelRuntime = this.resolveModelRuntime('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      modelRuntime,\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    this.destroyed = true;\n    let interfaceDestroyError: unknown;\n    try {\n      await this.interface.destroy?.();\n    } catch (error) {\n      interfaceDestroyError = error;\n    }\n\n    // Wait for all queued write operations to complete\n    await this.reportGenerator.flush();\n\n    const finalPath = await this.reportGenerator.finalize();\n    this.reportFile = finalPath;\n\n    this.resetDump(); // reset dump to release memory\n\n    if (interfaceDestroyError) {\n      throw interfaceDestroyError;\n    }\n  }\n\n  async recordToReport(\n    title?: string,\n    opt?: {\n      content?: string;\n      screenshotBase64?: string;\n    },\n  ) {\n    // 1. screenshot\n    const base64 =\n      opt?.screenshotBase64 ?? (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      id: uuid(),\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    this.writeOutActionDumps(executionDump);\n    await this.reportGenerator.flush();\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\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    cacheDir?: string;\n  } | null {\n    validateAgentCacheInput(opts.cache);\n\n    // Use the unified utils function to process cache configuration\n    const cacheConfig = processCacheConfig(\n      opts.cache,\n      opts.cacheId || '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 strategyValue = cacheConfig.strategy ?? 'read-write';\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        cacheDir: cacheConfig.cacheDir?.trim(),\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(\n          `File not found: ${file}. Resolved to: ${absolutePath}. Current working directory: ${process.cwd()}`,\n        );\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","legacyScrollTypeMap","normalizeScrollType","scrollType","Agent","callback","planningModel","globalConfigManager","MIDSCENE_REPLANNING_CYCLE_LIMIT","intent","getModelRuntime","_error","action","maxRetries","attempt","commonContextParser","error","Promise","resolve","setTimeout","prompt","console","ReportActionDump","getVersion","WeakMap","execution","runner","currentDump","existingIndex","undefined","opt","ifInBrowser","reportHTMLContent","executionDump","exec","task","param","paramStr","tip","typeStr","name","type","actionPlan","plans","Boolean","title","taskTitleStr","locateParamStr","defaultModel","output","locatePrompt","assert","detailedLocateParam","buildDetailedLocateParam","fileChooserAccept","withFileChooser","locatePromptOrValue","locatePromptOrOpt","optOrUndefined","value","optWithValue","stringValue","String","mode","locatePromptOrKeyName","keyName","locatePromptOrScrollParam","scrollParam","isLocatePromptLike","normalizedScrollType","taskPrompt","taskPromptText","abortSignal","Error","runAiAct","deepThink","deepLocate","noIndividualLocateModel","includeLocateInPlanning","cacheable","replanningCycleLimit","planCacheEnabled","matchedCache","yaml","imagesIncludeCount","actionOutput","yamlContent","yamlFlowStr","demand","modelRuntime","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","TaskExecutionError","errorTask","rawError","rawMessage","reason","args","yamlScriptContent","script","parseYamlScript","player","ScriptPlayer","errors","listener","index","interfaceDestroyError","finalPath","base64","now","Date","screenshot","ScreenshotItem","recorder","uuid","ExecutionDump","dumpString","groupName","groupDescription","executions","context","opts","validateAgentCacheInput","cacheConfig","processCacheConfig","id","strategyValue","isReadOnly","isWriteOnly","files","file","absolutePath","existsSync","process","filesArray","Array","options","interfaceInstance","Object","assertReportGenerationOptions","resolvedAiActContext","hasCustomConfig","ModelConfigManager","globalModelConfigManager","Service","cacheConfigObj","TaskCache","baseActionSpace","defineActionSleep","TaskExecutor","getReportFileName","ReportGenerator","createAgent"],"mappings":"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"}

package/dist/es/agent/task-cache.mjs

@@ -29,7 +29,7 @@ const cacheFileExt = '.cache.yaml';
 class TaskCache {
     matchCache(prompt, type) {
         if (!this.isCacheResultUsed) return;
-        const promptStr = 'string' == typeof prompt ? prompt : JSON.stringify(prompt);
+        const promptStr = this.promptKey(prompt);
         for(let i = 0; i < this.cacheOriginalLength; i++){
             const item = this.cache.caches[i];
             const key = `${type}:${promptStr}:${i}`;
@@ -42,6 +42,10 @@ class TaskCache {
                     if ('xpaths' in locateItem) locateItem.xpaths = void 0;
                 }
                 this.matchedCacheIndices.add(key);
+                const consumeKey = `${type}:${promptStr}`;
+                const consumed = this.consumedCacheIndices.get(consumeKey) ?? [];
+                consumed.push(i);
+                this.consumedCacheIndices.set(consumeKey, consumed);
                 debug('cache found and marked as used, type: %s, prompt: %s, index: %d', type, prompt, i);
                 return {
                     cacheContent: item,
@@ -165,16 +169,45 @@ class TaskCache {
             warn(`write cache to file failed, path: ${this.cacheFilePath}, error: ${err}`);
         }
     }
-    updateOrAppendCacheRecord(newRecord, cachedRecord) {
-        if (cachedRecord) if ('plan' === newRecord.type) cachedRecord.updateFn((cache)=>{
-            cache.yamlWorkflow = newRecord.yamlWorkflow;
-        });
-        else cachedRecord.updateFn((cache)=>{
-            const locateCache = cache;
+    promptKey(prompt) {
+        return 'string' == typeof prompt ? prompt : JSON.stringify(prompt);
+    }
+    applyRecordInto(target, newRecord) {
+        if ('plan' === newRecord.type) target.yamlWorkflow = newRecord.yamlWorkflow;
+        else {
+            const locateCache = target;
             locateCache.cache = newRecord.cache;
             if ('xpaths' in locateCache) locateCache.xpaths = void 0;
+        }
+    }
+    updateOrAppendCacheRecord(newRecord, cachedRecord) {
+        if (cachedRecord) cachedRecord.updateFn((cache)=>{
+            this.applyRecordInto(cache, newRecord);
         });
-        else this.appendCache(newRecord);
+        else {
+            const consumeKey = `${newRecord.type}:${this.promptKey(newRecord.prompt)}`;
+            const staleIndex = this.staleCacheIndices.get(consumeKey)?.pop();
+            if (void 0 !== staleIndex && this.cache.caches[staleIndex]) {
+                debug('replacing stale cache entry in place, type: %s, prompt: %s, index: %d', newRecord.type, newRecord.prompt, staleIndex);
+                this.replaceCacheRecord(staleIndex, newRecord);
+            } else this.appendCache(newRecord);
+        }
+    }
+    markLocateCacheStale(prompt) {
+        const consumeKey = `locate:${this.promptKey(prompt)}`;
+        const index = this.consumedCacheIndices.get(consumeKey)?.pop();
+        if (void 0 === index) return;
+        const stale = this.staleCacheIndices.get(consumeKey) ?? [];
+        stale.push(index);
+        this.staleCacheIndices.set(consumeKey, stale);
+        debug('marked locate cache entry as stale, prompt: %s, index: %d', prompt, index);
+    }
+    replaceCacheRecord(index, newRecord) {
+        const target = this.cache.caches[index];
+        node_assert(target.type === newRecord.type, `cache record type mismatch on replace: expected ${newRecord.type}, got ${target.type}`);
+        this.applyRecordInto(target, newRecord);
+        if (this.readOnlyMode) return void debug('read-only mode, cache replaced in memory but not flushed to file');
+        this.flushCacheToFile();
     }
     constructor(cacheId, isCacheResultUsed, cacheFilePath, options = {}){
         _define_property(this, "cacheId", void 0);
@@ -185,6 +218,8 @@ class TaskCache {
         _define_property(this, "readOnlyMode", void 0);
         _define_property(this, "writeOnlyMode", void 0);
         _define_property(this, "matchedCacheIndices", new Set());
+        _define_property(this, "consumedCacheIndices", new Map());
+        _define_property(this, "staleCacheIndices", new Map());
         node_assert(cacheId, 'cacheId is required');
         if (void 0 !== options.cacheDir && ('string' != typeof options.cacheDir || !options.cacheDir.trim())) throw new Error('cacheDir must be a non-empty string when provided');
         const cacheDir = options.cacheDir?.trim();

package/dist/es/agent/task-cache.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"agent/task-cache.mjs","sources":["../../../src/agent/task-cache.ts"],"sourcesContent":["import assert from 'node:assert';\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { isDeepStrictEqual } from 'node:util';\nimport type { TUserPrompt } from '@/ai-model';\nimport type { ElementCacheFeature } from '@/types';\nimport { getMidsceneRunSubDir } from '@midscene/shared/common';\nimport {\n  MIDSCENE_CACHE_MAX_FILENAME_LENGTH,\n  globalConfigManager,\n} from '@midscene/shared/env';\nimport { getDebug } from '@midscene/shared/logger';\nimport { ifInBrowser, ifInWorker } from '@midscene/shared/utils';\nimport { generateHashId } from '@midscene/shared/utils';\nimport { replaceIllegalPathCharsAndSpace } from '@midscene/shared/utils';\nimport yaml from 'js-yaml';\nimport semver from 'semver';\nimport { getMidsceneVersion } from './utils';\n\nconst DEFAULT_CACHE_MAX_FILENAME_LENGTH = 200;\n\nexport const debug = getDebug('cache');\nconst warn = getDebug('cache', { console: true });\n\nexport interface PlanningCache {\n  type: 'plan';\n  prompt: string;\n  yamlWorkflow: string;\n}\n\nexport interface LocateCache {\n  type: 'locate';\n  prompt: TUserPrompt;\n  cache?: ElementCacheFeature;\n  /** @deprecated kept for backward compatibility */\n  xpaths?: string[];\n}\n\nexport interface MatchCacheResult<T extends PlanningCache | LocateCache> {\n  cacheContent: T;\n  cacheUsable: boolean;\n  updateFn: (cb: (cache: T) => void) => void;\n}\n\nexport type CacheFileContent = {\n  midsceneVersion: string;\n  cacheId: string;\n  caches: Array<PlanningCache | LocateCache>;\n};\n\nconst lowestSupportedMidsceneVersion = '0.16.10';\nexport const cacheFileExt = '.cache.yaml';\n\nexport class TaskCache {\n  cacheId: string;\n\n  cacheFilePath?: string;\n\n  cache: CacheFileContent;\n\n  isCacheResultUsed: boolean; // a flag to indicate if the cache result should be used\n  cacheOriginalLength: number;\n\n  readOnlyMode: boolean; // a flag to indicate if the cache is in read-only mode\n\n  writeOnlyMode: boolean; // a flag to indicate if the cache is in write-only mode\n\n  private matchedCacheIndices: Set<string> = new Set(); // Track matched records\n\n  constructor(\n    cacheId: string,\n    isCacheResultUsed: boolean,\n    cacheFilePath?: string,\n    options: {\n      readOnly?: boolean;\n      writeOnly?: boolean;\n      cacheDir?: string;\n    } = {},\n  ) {\n    assert(cacheId, 'cacheId is required');\n    if (\n      options.cacheDir !== undefined &&\n      (typeof options.cacheDir !== 'string' || !options.cacheDir.trim())\n    ) {\n      throw new Error('cacheDir must be a non-empty string when provided');\n    }\n    const cacheDir = options.cacheDir?.trim();\n    let safeCacheId = replaceIllegalPathCharsAndSpace(cacheId);\n    const cacheMaxFilenameLength =\n      globalConfigManager.getEnvConfigValueAsNumber(\n        MIDSCENE_CACHE_MAX_FILENAME_LENGTH,\n      ) ?? DEFAULT_CACHE_MAX_FILENAME_LENGTH;\n    if (Buffer.byteLength(safeCacheId, 'utf8') > cacheMaxFilenameLength) {\n      const prefix = safeCacheId.slice(0, 32);\n      const hash = generateHashId(undefined, safeCacheId);\n      safeCacheId = `${prefix}-${hash}`;\n    }\n    this.cacheId = safeCacheId;\n\n    this.cacheFilePath =\n      ifInBrowser || ifInWorker\n        ? undefined\n        : cacheFilePath ||\n          join(\n            cacheDir || getMidsceneRunSubDir('cache'),\n            `${this.cacheId}${cacheFileExt}`,\n          );\n    const readOnlyMode = Boolean(options?.readOnly);\n    const writeOnlyMode = Boolean(options?.writeOnly);\n\n    if (readOnlyMode && writeOnlyMode) {\n      throw new Error('TaskCache cannot be both read-only and write-only');\n    }\n\n    this.isCacheResultUsed = writeOnlyMode ? false : isCacheResultUsed;\n    this.readOnlyMode = readOnlyMode;\n    this.writeOnlyMode = writeOnlyMode;\n\n    let cacheContent;\n    if (this.cacheFilePath && !this.writeOnlyMode) {\n      cacheContent = this.loadCacheFromFile();\n    }\n    if (!cacheContent) {\n      cacheContent = {\n        midsceneVersion: getMidsceneVersion(),\n        cacheId: this.cacheId,\n        caches: [],\n      };\n    }\n    this.cache = cacheContent;\n    this.cacheOriginalLength = this.isCacheResultUsed\n      ? this.cache.caches.length\n      : 0;\n  }\n\n  matchCache(\n    prompt: TUserPrompt,\n    type: 'plan' | 'locate',\n  ): MatchCacheResult<PlanningCache | LocateCache> | undefined {\n    if (!this.isCacheResultUsed) {\n      return undefined;\n    }\n    // Find the first unused matching cache\n    const promptStr =\n      typeof prompt === 'string' ? prompt : JSON.stringify(prompt);\n    for (let i = 0; i < this.cacheOriginalLength; i++) {\n      const item = this.cache.caches[i];\n      const key = `${type}:${promptStr}:${i}`;\n      if (\n        item.type === type &&\n        isDeepStrictEqual(item.prompt, prompt) &&\n        !this.matchedCacheIndices.has(key)\n      ) {\n        if (item.type === 'locate') {\n          const locateItem = item as LocateCache;\n          if (!locateItem.cache && Array.isArray(locateItem.xpaths)) {\n            locateItem.cache = { xpaths: locateItem.xpaths };\n          }\n          if ('xpaths' in locateItem) {\n            locateItem.xpaths = undefined;\n          }\n        }\n        this.matchedCacheIndices.add(key);\n        debug(\n          'cache found and marked as used, type: %s, prompt: %s, index: %d',\n          type,\n          prompt,\n          i,\n        );\n        return {\n          cacheContent: item,\n          cacheUsable: true,\n          updateFn: (cb: (cache: PlanningCache | LocateCache) => void) => {\n            debug(\n              'will call updateFn to update cache, type: %s, prompt: %s, index: %d',\n              type,\n              prompt,\n              i,\n            );\n            cb(item);\n\n            if (this.readOnlyMode) {\n              debug(\n                'read-only mode, cache updated in memory but not flushed to file',\n              );\n              return;\n            }\n\n            debug(\n              'cache updated, will flush to file, type: %s, prompt: %s, index: %d',\n              type,\n              prompt,\n              i,\n            );\n            this.flushCacheToFile();\n          },\n        };\n      }\n    }\n    debug('no unused cache found, type: %s, prompt: %s', type, prompt);\n    return undefined;\n  }\n\n  matchPlanCache(prompt: string): MatchCacheResult<PlanningCache> | undefined {\n    const result = this.matchCache(prompt, 'plan') as\n      | MatchCacheResult<PlanningCache>\n      | undefined;\n    if (!result) return undefined;\n    // Guard against stale cache files written before the write-side fix\n    const yamlWorkflow = result.cacheContent.yamlWorkflow;\n    if (!yamlWorkflow?.trim()) {\n      debug(\n        'plan cache matched but yamlWorkflow is empty, treat as cache miss',\n      );\n      return {\n        ...result,\n        cacheUsable: false,\n      };\n    }\n    try {\n      const parsed = yaml.load(yamlWorkflow) as any;\n      const hasNonEmptyFlow = parsed?.tasks?.some(\n        (task: any) => Array.isArray(task.flow) && task.flow.length > 0,\n      );\n      if (!hasNonEmptyFlow) {\n        debug('plan cache matched but flow is empty, treat as cache miss');\n        return {\n          ...result,\n          cacheUsable: false,\n        };\n      }\n    } catch {\n      debug(\n        'plan cache matched but yamlWorkflow is invalid, treat as cache miss',\n      );\n      return {\n        ...result,\n        cacheUsable: false,\n      };\n    }\n    return result;\n  }\n\n  matchLocateCache(\n    prompt: TUserPrompt,\n  ): MatchCacheResult<LocateCache> | undefined {\n    return this.matchCache(prompt, 'locate') as\n      | MatchCacheResult<LocateCache>\n      | undefined;\n  }\n\n  appendCache(cache: PlanningCache | LocateCache) {\n    debug('will append cache', cache);\n    this.cache.caches.push(cache);\n\n    if (this.readOnlyMode) {\n      debug('read-only mode, cache appended to memory but not flushed to file');\n      return;\n    }\n\n    this.flushCacheToFile();\n  }\n\n  loadCacheFromFile() {\n    const cacheFile = this.cacheFilePath;\n    assert(cacheFile, 'cache file path is required');\n\n    if (!existsSync(cacheFile)) {\n      debug('no cache file found, path: %s', cacheFile);\n      return undefined;\n    }\n\n    // detect old cache file\n    const jsonTypeCacheFile = cacheFile.replace(cacheFileExt, '.json');\n    if (existsSync(jsonTypeCacheFile) && this.isCacheResultUsed) {\n      console.warn(\n        `An outdated cache file from an earlier version of Midscene has been detected. Since version 0.17, we have implemented an improved caching strategy. Please delete the old file located at: ${jsonTypeCacheFile}.`,\n      );\n      return undefined;\n    }\n\n    try {\n      const data = readFileSync(cacheFile, 'utf8');\n      const jsonData = yaml.load(data) as CacheFileContent;\n\n      const version = getMidsceneVersion();\n      if (!version) {\n        debug('no midscene version info, will not read cache from file');\n        return undefined;\n      }\n\n      if (\n        semver.lt(jsonData.midsceneVersion, lowestSupportedMidsceneVersion) &&\n        !jsonData.midsceneVersion.includes('beta') // for internal test\n      ) {\n        console.warn(\n          `You are using an old version of Midscene cache file, and we cannot match any info from it. Starting from Midscene v0.17, we changed our strategy to use xpath for cache info, providing better performance.\\nPlease delete the existing cache and rebuild it. Sorry for the inconvenience.\\ncache file: ${cacheFile}`,\n        );\n        return undefined;\n      }\n\n      debug(\n        'cache loaded from file, path: %s, cache version: %s, record length: %s',\n        cacheFile,\n        jsonData.midsceneVersion,\n        jsonData.caches.length,\n      );\n      jsonData.midsceneVersion = getMidsceneVersion(); // update the version\n      return jsonData;\n    } catch (err) {\n      debug(\n        'cache file exists but load failed, path: %s, error: %s',\n        cacheFile,\n        err,\n      );\n      return undefined;\n    }\n  }\n\n  flushCacheToFile(options?: { cleanUnused?: boolean }) {\n    const version = getMidsceneVersion();\n    if (!version) {\n      debug('no midscene version info, will not write cache to file');\n      return;\n    }\n\n    if (!this.cacheFilePath) {\n      debug('no cache file path, will not write cache to file');\n      return;\n    }\n\n    // Clean unused caches if requested\n    if (options?.cleanUnused) {\n      // Skip cleaning in write-only mode or when cache is not used\n      if (this.isCacheResultUsed) {\n        const originalLength = this.cache.caches.length;\n\n        // Collect indices of used caches\n        const usedIndices = new Set<number>();\n        for (const key of this.matchedCacheIndices) {\n          // key format: \"type:prompt:index\"\n          const parts = key.split(':');\n          const index = Number.parseInt(parts[parts.length - 1], 10);\n          if (!Number.isNaN(index)) {\n            usedIndices.add(index);\n          }\n        }\n\n        // Filter: keep used caches and newly added caches\n        this.cache.caches = this.cache.caches.filter((_, index) => {\n          const isUsed = usedIndices.has(index);\n          const isNew = index >= this.cacheOriginalLength;\n          return isUsed || isNew;\n        });\n\n        const removedCount = originalLength - this.cache.caches.length;\n        if (removedCount > 0) {\n          debug('cleaned %d unused cache record(s)', removedCount);\n        } else {\n          debug('no unused cache to clean');\n        }\n      } else {\n        debug('skip cleaning: cache is not used for reading');\n      }\n    }\n\n    try {\n      const dir = dirname(this.cacheFilePath);\n      if (!existsSync(dir)) {\n        mkdirSync(dir, { recursive: true });\n        debug('created cache directory: %s', dir);\n      }\n\n      // Sort caches to ensure plan entries come before locate entries for better readability\n      // Create a sorted copy for writing to disk while keeping in-memory order unchanged\n      const sortedCaches = [...this.cache.caches].sort((a, b) => {\n        if (a.type === 'plan' && b.type === 'locate') return -1;\n        if (a.type === 'locate' && b.type === 'plan') return 1;\n        return 0;\n      });\n\n      const cacheToWrite = {\n        ...this.cache,\n        caches: sortedCaches,\n      };\n\n      const yamlData = yaml.dump(cacheToWrite, { lineWidth: -1 });\n      writeFileSync(this.cacheFilePath, yamlData);\n      debug('cache flushed to file: %s', this.cacheFilePath);\n    } catch (err) {\n      warn(\n        `write cache to file failed, path: ${this.cacheFilePath}, error: ${err}`,\n      );\n    }\n  }\n\n  updateOrAppendCacheRecord(\n    newRecord: PlanningCache | LocateCache,\n    cachedRecord?: MatchCacheResult<PlanningCache | LocateCache>,\n  ) {\n    if (cachedRecord) {\n      // update existing record\n      if (newRecord.type === 'plan') {\n        cachedRecord.updateFn((cache) => {\n          (cache as PlanningCache).yamlWorkflow = newRecord.yamlWorkflow;\n        });\n      } else {\n        cachedRecord.updateFn((cache) => {\n          const locateCache = cache as LocateCache;\n          locateCache.cache = newRecord.cache;\n          if ('xpaths' in locateCache) {\n            locateCache.xpaths = undefined;\n          }\n        });\n      }\n    } else {\n      this.appendCache(newRecord);\n    }\n  }\n}\n"],"names":["DEFAULT_CACHE_MAX_FILENAME_LENGTH","debug","getDebug","warn","lowestSupportedMidsceneVersion","cacheFileExt","TaskCache","prompt","type","promptStr","JSON","i","item","key","isDeepStrictEqual","locateItem","Array","undefined","cb","result","yamlWorkflow","parsed","yaml","hasNonEmptyFlow","task","cache","cacheFile","assert","existsSync","jsonTypeCacheFile","console","data","readFileSync","jsonData","version","getMidsceneVersion","semver","err","options","originalLength","usedIndices","Set","parts","index","Number","_","isUsed","isNew","removedCount","dir","dirname","mkdirSync","sortedCaches","a","b","cacheToWrite","yamlData","writeFileSync","newRecord","cachedRecord","locateCache","cacheId","isCacheResultUsed","cacheFilePath","Error","cacheDir","safeCacheId","replaceIllegalPathCharsAndSpace","cacheMaxFilenameLength","globalConfigManager","MIDSCENE_CACHE_MAX_FILENAME_LENGTH","Buffer","prefix","hash","generateHashId","ifInBrowser","ifInWorker","join","getMidsceneRunSubDir","readOnlyMode","Boolean","writeOnlyMode","cacheContent"],"mappings":"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"}
+{"version":3,"file":"agent/task-cache.mjs","sources":["../../../src/agent/task-cache.ts"],"sourcesContent":["import assert from 'node:assert';\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { isDeepStrictEqual } from 'node:util';\nimport type { TUserPrompt } from '@/ai-model';\nimport type { ElementCacheFeature } from '@/types';\nimport { getMidsceneRunSubDir } from '@midscene/shared/common';\nimport {\n  MIDSCENE_CACHE_MAX_FILENAME_LENGTH,\n  globalConfigManager,\n} from '@midscene/shared/env';\nimport { getDebug } from '@midscene/shared/logger';\nimport { ifInBrowser, ifInWorker } from '@midscene/shared/utils';\nimport { generateHashId } from '@midscene/shared/utils';\nimport { replaceIllegalPathCharsAndSpace } from '@midscene/shared/utils';\nimport yaml from 'js-yaml';\nimport semver from 'semver';\nimport { getMidsceneVersion } from './utils';\n\nconst DEFAULT_CACHE_MAX_FILENAME_LENGTH = 200;\n\nexport const debug = getDebug('cache');\nconst warn = getDebug('cache', { console: true });\n\nexport interface PlanningCache {\n  type: 'plan';\n  prompt: TUserPrompt;\n  yamlWorkflow: string;\n}\n\nexport interface LocateCache {\n  type: 'locate';\n  prompt: TUserPrompt;\n  cache?: ElementCacheFeature;\n  /** @deprecated kept for backward compatibility */\n  xpaths?: string[];\n}\n\nexport interface MatchCacheResult<T extends PlanningCache | LocateCache> {\n  cacheContent: T;\n  cacheUsable: boolean;\n  updateFn: (cb: (cache: T) => void) => void;\n}\n\nexport type CacheFileContent = {\n  midsceneVersion: string;\n  cacheId: string;\n  caches: Array<PlanningCache | LocateCache>;\n};\n\nconst lowestSupportedMidsceneVersion = '0.16.10';\nexport const cacheFileExt = '.cache.yaml';\n\nexport class TaskCache {\n  cacheId: string;\n\n  cacheFilePath?: string;\n\n  cache: CacheFileContent;\n\n  isCacheResultUsed: boolean; // a flag to indicate if the cache result should be used\n  cacheOriginalLength: number;\n\n  readOnlyMode: boolean; // a flag to indicate if the cache is in read-only mode\n\n  writeOnlyMode: boolean; // a flag to indicate if the cache is in write-only mode\n\n  private matchedCacheIndices: Set<string> = new Set(); // Track matched records\n\n  // Per `${type}:${promptStr}`, the in-memory indices of cache entries consumed\n  // by matchCache this run (most recent last). markLocateCacheStale() drains\n  // from here into staleCacheIndices when the consumed entry's element is\n  // rejected by a failed action.\n  private consumedCacheIndices: Map<string, number[]> = new Map();\n\n  // Per `${type}:${promptStr}`, indices of consumed entries whose backing\n  // element was rejected (the action using it failed and the run replanned).\n  // Only these are replaced in place on the re-locate; every other write\n  // appends, so legitimately repeated prompts keep one entry per occurrence.\n  private staleCacheIndices: Map<string, number[]> = new Map();\n\n  constructor(\n    cacheId: string,\n    isCacheResultUsed: boolean,\n    cacheFilePath?: string,\n    options: {\n      readOnly?: boolean;\n      writeOnly?: boolean;\n      cacheDir?: string;\n    } = {},\n  ) {\n    assert(cacheId, 'cacheId is required');\n    if (\n      options.cacheDir !== undefined &&\n      (typeof options.cacheDir !== 'string' || !options.cacheDir.trim())\n    ) {\n      throw new Error('cacheDir must be a non-empty string when provided');\n    }\n    const cacheDir = options.cacheDir?.trim();\n    let safeCacheId = replaceIllegalPathCharsAndSpace(cacheId);\n    const cacheMaxFilenameLength =\n      globalConfigManager.getEnvConfigValueAsNumber(\n        MIDSCENE_CACHE_MAX_FILENAME_LENGTH,\n      ) ?? DEFAULT_CACHE_MAX_FILENAME_LENGTH;\n    if (Buffer.byteLength(safeCacheId, 'utf8') > cacheMaxFilenameLength) {\n      const prefix = safeCacheId.slice(0, 32);\n      const hash = generateHashId(undefined, safeCacheId);\n      safeCacheId = `${prefix}-${hash}`;\n    }\n    this.cacheId = safeCacheId;\n\n    this.cacheFilePath =\n      ifInBrowser || ifInWorker\n        ? undefined\n        : cacheFilePath ||\n          join(\n            cacheDir || getMidsceneRunSubDir('cache'),\n            `${this.cacheId}${cacheFileExt}`,\n          );\n    const readOnlyMode = Boolean(options?.readOnly);\n    const writeOnlyMode = Boolean(options?.writeOnly);\n\n    if (readOnlyMode && writeOnlyMode) {\n      throw new Error('TaskCache cannot be both read-only and write-only');\n    }\n\n    this.isCacheResultUsed = writeOnlyMode ? false : isCacheResultUsed;\n    this.readOnlyMode = readOnlyMode;\n    this.writeOnlyMode = writeOnlyMode;\n\n    let cacheContent;\n    if (this.cacheFilePath && !this.writeOnlyMode) {\n      cacheContent = this.loadCacheFromFile();\n    }\n    if (!cacheContent) {\n      cacheContent = {\n        midsceneVersion: getMidsceneVersion(),\n        cacheId: this.cacheId,\n        caches: [],\n      };\n    }\n    this.cache = cacheContent;\n    this.cacheOriginalLength = this.isCacheResultUsed\n      ? this.cache.caches.length\n      : 0;\n  }\n\n  matchCache(\n    prompt: TUserPrompt,\n    type: 'plan' | 'locate',\n  ): MatchCacheResult<PlanningCache | LocateCache> | undefined {\n    if (!this.isCacheResultUsed) {\n      return undefined;\n    }\n    // Find the first unused matching cache\n    const promptStr = this.promptKey(prompt);\n    for (let i = 0; i < this.cacheOriginalLength; i++) {\n      const item = this.cache.caches[i];\n      const key = `${type}:${promptStr}:${i}`;\n      if (\n        item.type === type &&\n        isDeepStrictEqual(item.prompt, prompt) &&\n        !this.matchedCacheIndices.has(key)\n      ) {\n        if (item.type === 'locate') {\n          const locateItem = item as LocateCache;\n          if (!locateItem.cache && Array.isArray(locateItem.xpaths)) {\n            locateItem.cache = { xpaths: locateItem.xpaths };\n          }\n          if ('xpaths' in locateItem) {\n            locateItem.xpaths = undefined;\n          }\n        }\n        this.matchedCacheIndices.add(key);\n        const consumeKey = `${type}:${promptStr}`;\n        const consumed = this.consumedCacheIndices.get(consumeKey) ?? [];\n        consumed.push(i);\n        this.consumedCacheIndices.set(consumeKey, consumed);\n        debug(\n          'cache found and marked as used, type: %s, prompt: %s, index: %d',\n          type,\n          prompt,\n          i,\n        );\n        return {\n          cacheContent: item,\n          cacheUsable: true,\n          updateFn: (cb: (cache: PlanningCache | LocateCache) => void) => {\n            debug(\n              'will call updateFn to update cache, type: %s, prompt: %s, index: %d',\n              type,\n              prompt,\n              i,\n            );\n            cb(item);\n\n            if (this.readOnlyMode) {\n              debug(\n                'read-only mode, cache updated in memory but not flushed to file',\n              );\n              return;\n            }\n\n            debug(\n              'cache updated, will flush to file, type: %s, prompt: %s, index: %d',\n              type,\n              prompt,\n              i,\n            );\n            this.flushCacheToFile();\n          },\n        };\n      }\n    }\n    debug('no unused cache found, type: %s, prompt: %s', type, prompt);\n    return undefined;\n  }\n\n  matchPlanCache(\n    prompt: TUserPrompt,\n  ): MatchCacheResult<PlanningCache> | undefined {\n    const result = this.matchCache(prompt, 'plan') as\n      | MatchCacheResult<PlanningCache>\n      | undefined;\n    if (!result) return undefined;\n    // Guard against stale cache files written before the write-side fix\n    const yamlWorkflow = result.cacheContent.yamlWorkflow;\n    if (!yamlWorkflow?.trim()) {\n      debug(\n        'plan cache matched but yamlWorkflow is empty, treat as cache miss',\n      );\n      return {\n        ...result,\n        cacheUsable: false,\n      };\n    }\n    try {\n      const parsed = yaml.load(yamlWorkflow) as any;\n      const hasNonEmptyFlow = parsed?.tasks?.some(\n        (task: any) => Array.isArray(task.flow) && task.flow.length > 0,\n      );\n      if (!hasNonEmptyFlow) {\n        debug('plan cache matched but flow is empty, treat as cache miss');\n        return {\n          ...result,\n          cacheUsable: false,\n        };\n      }\n    } catch {\n      debug(\n        'plan cache matched but yamlWorkflow is invalid, treat as cache miss',\n      );\n      return {\n        ...result,\n        cacheUsable: false,\n      };\n    }\n    return result;\n  }\n\n  matchLocateCache(\n    prompt: TUserPrompt,\n  ): MatchCacheResult<LocateCache> | undefined {\n    return this.matchCache(prompt, 'locate') as\n      | MatchCacheResult<LocateCache>\n      | undefined;\n  }\n\n  appendCache(cache: PlanningCache | LocateCache) {\n    debug('will append cache', cache);\n    this.cache.caches.push(cache);\n\n    if (this.readOnlyMode) {\n      debug('read-only mode, cache appended to memory but not flushed to file');\n      return;\n    }\n\n    this.flushCacheToFile();\n  }\n\n  loadCacheFromFile() {\n    const cacheFile = this.cacheFilePath;\n    assert(cacheFile, 'cache file path is required');\n\n    if (!existsSync(cacheFile)) {\n      debug('no cache file found, path: %s', cacheFile);\n      return undefined;\n    }\n\n    // detect old cache file\n    const jsonTypeCacheFile = cacheFile.replace(cacheFileExt, '.json');\n    if (existsSync(jsonTypeCacheFile) && this.isCacheResultUsed) {\n      console.warn(\n        `An outdated cache file from an earlier version of Midscene has been detected. Since version 0.17, we have implemented an improved caching strategy. Please delete the old file located at: ${jsonTypeCacheFile}.`,\n      );\n      return undefined;\n    }\n\n    try {\n      const data = readFileSync(cacheFile, 'utf8');\n      const jsonData = yaml.load(data) as CacheFileContent;\n\n      const version = getMidsceneVersion();\n      if (!version) {\n        debug('no midscene version info, will not read cache from file');\n        return undefined;\n      }\n\n      if (\n        semver.lt(jsonData.midsceneVersion, lowestSupportedMidsceneVersion) &&\n        !jsonData.midsceneVersion.includes('beta') // for internal test\n      ) {\n        console.warn(\n          `You are using an old version of Midscene cache file, and we cannot match any info from it. Starting from Midscene v0.17, we changed our strategy to use xpath for cache info, providing better performance.\\nPlease delete the existing cache and rebuild it. Sorry for the inconvenience.\\ncache file: ${cacheFile}`,\n        );\n        return undefined;\n      }\n\n      debug(\n        'cache loaded from file, path: %s, cache version: %s, record length: %s',\n        cacheFile,\n        jsonData.midsceneVersion,\n        jsonData.caches.length,\n      );\n      jsonData.midsceneVersion = getMidsceneVersion(); // update the version\n      return jsonData;\n    } catch (err) {\n      debug(\n        'cache file exists but load failed, path: %s, error: %s',\n        cacheFile,\n        err,\n      );\n      return undefined;\n    }\n  }\n\n  flushCacheToFile(options?: { cleanUnused?: boolean }) {\n    const version = getMidsceneVersion();\n    if (!version) {\n      debug('no midscene version info, will not write cache to file');\n      return;\n    }\n\n    if (!this.cacheFilePath) {\n      debug('no cache file path, will not write cache to file');\n      return;\n    }\n\n    // Clean unused caches if requested\n    if (options?.cleanUnused) {\n      // Skip cleaning in write-only mode or when cache is not used\n      if (this.isCacheResultUsed) {\n        const originalLength = this.cache.caches.length;\n\n        // Collect indices of used caches\n        const usedIndices = new Set<number>();\n        for (const key of this.matchedCacheIndices) {\n          // key format: \"type:prompt:index\"\n          const parts = key.split(':');\n          const index = Number.parseInt(parts[parts.length - 1], 10);\n          if (!Number.isNaN(index)) {\n            usedIndices.add(index);\n          }\n        }\n\n        // Filter: keep used caches and newly added caches\n        this.cache.caches = this.cache.caches.filter((_, index) => {\n          const isUsed = usedIndices.has(index);\n          const isNew = index >= this.cacheOriginalLength;\n          return isUsed || isNew;\n        });\n\n        const removedCount = originalLength - this.cache.caches.length;\n        if (removedCount > 0) {\n          debug('cleaned %d unused cache record(s)', removedCount);\n        } else {\n          debug('no unused cache to clean');\n        }\n      } else {\n        debug('skip cleaning: cache is not used for reading');\n      }\n    }\n\n    try {\n      const dir = dirname(this.cacheFilePath);\n      if (!existsSync(dir)) {\n        mkdirSync(dir, { recursive: true });\n        debug('created cache directory: %s', dir);\n      }\n\n      // Sort caches to ensure plan entries come before locate entries for better readability\n      // Create a sorted copy for writing to disk while keeping in-memory order unchanged\n      const sortedCaches = [...this.cache.caches].sort((a, b) => {\n        if (a.type === 'plan' && b.type === 'locate') return -1;\n        if (a.type === 'locate' && b.type === 'plan') return 1;\n        return 0;\n      });\n\n      const cacheToWrite = {\n        ...this.cache,\n        caches: sortedCaches,\n      };\n\n      const yamlData = yaml.dump(cacheToWrite, { lineWidth: -1 });\n      writeFileSync(this.cacheFilePath, yamlData);\n      debug('cache flushed to file: %s', this.cacheFilePath);\n    } catch (err) {\n      warn(\n        `write cache to file failed, path: ${this.cacheFilePath}, error: ${err}`,\n      );\n    }\n  }\n\n  // Single source of truth for turning a prompt into a stable string key.\n  // matchCache and updateOrAppendCacheRecord must agree on this, otherwise a\n  // consumed entry can never be found again for in-place replacement.\n  private promptKey(prompt: TUserPrompt): string {\n    return typeof prompt === 'string' ? prompt : JSON.stringify(prompt);\n  }\n\n  // Copy the mutable payload of `newRecord` into an existing cache entry.\n  // Shared by the live-record update path and replaceCacheRecord so the field\n  // list lives in exactly one place. Caller guarantees same `type`.\n  private applyRecordInto(\n    target: PlanningCache | LocateCache,\n    newRecord: PlanningCache | LocateCache,\n  ) {\n    if (newRecord.type === 'plan') {\n      (target as PlanningCache).yamlWorkflow = newRecord.yamlWorkflow;\n    } else {\n      const locateCache = target as LocateCache;\n      locateCache.cache = newRecord.cache;\n      if ('xpaths' in locateCache) {\n        locateCache.xpaths = undefined;\n      }\n    }\n  }\n\n  updateOrAppendCacheRecord(\n    newRecord: PlanningCache | LocateCache,\n    cachedRecord?: MatchCacheResult<PlanningCache | LocateCache>,\n  ) {\n    if (cachedRecord) {\n      // update existing record\n      cachedRecord.updateFn((cache) => {\n        this.applyRecordInto(cache, newRecord);\n      });\n    } else {\n      // No live MatchCacheResult was passed. This is either a genuine first-time\n      // miss or a replanning re-locate after the previously matched entry was\n      // rejected. Only replace an entry that was explicitly marked stale (its\n      // element caused a failed action); otherwise append. Without this gate a\n      // legitimately repeated prompt — located more times than it has cached\n      // entries — would overwrite a still-valid entry instead of appending.\n      const consumeKey = `${newRecord.type}:${this.promptKey(newRecord.prompt)}`;\n      const staleIndex = this.staleCacheIndices.get(consumeKey)?.pop();\n      if (staleIndex !== undefined && this.cache.caches[staleIndex]) {\n        debug(\n          'replacing stale cache entry in place, type: %s, prompt: %s, index: %d',\n          newRecord.type,\n          newRecord.prompt,\n          staleIndex,\n        );\n        this.replaceCacheRecord(staleIndex, newRecord);\n      } else {\n        this.appendCache(newRecord);\n      }\n    }\n  }\n\n  /**\n   * Mark the most recently consumed locate cache entry for `prompt` as stale.\n   * Call this when an action that used the cache-hit element failed and the run\n   * is about to replan: the subsequent re-locate then replaces this entry in\n   * place instead of appending a duplicate, which would otherwise be matched\n   * first on the next run and re-trigger replanning forever (#2529).\n   *\n   * No-op when nothing was consumed for the prompt, so a plain first-time miss\n   * (and any repeated prompt that never failed) still appends normally.\n   */\n  markLocateCacheStale(prompt: TUserPrompt) {\n    const consumeKey = `locate:${this.promptKey(prompt)}`;\n    const index = this.consumedCacheIndices.get(consumeKey)?.pop();\n    if (index === undefined) {\n      return;\n    }\n    const stale = this.staleCacheIndices.get(consumeKey) ?? [];\n    stale.push(index);\n    this.staleCacheIndices.set(consumeKey, stale);\n    debug(\n      'marked locate cache entry as stale, prompt: %s, index: %d',\n      prompt,\n      index,\n    );\n  }\n\n  private replaceCacheRecord(\n    index: number,\n    newRecord: PlanningCache | LocateCache,\n  ) {\n    const target = this.cache.caches[index];\n    // Consumed indices are recorded per `${type}:${prompt}` in matchCache, which\n    // only stores entries whose `item.type === type`, so the target must share\n    // newRecord's type. Assert it to make the invariant explicit and fail fast.\n    assert(\n      target.type === newRecord.type,\n      `cache record type mismatch on replace: expected ${newRecord.type}, got ${target.type}`,\n    );\n    this.applyRecordInto(target, newRecord);\n\n    if (this.readOnlyMode) {\n      debug('read-only mode, cache replaced in memory but not flushed to file');\n      return;\n    }\n\n    this.flushCacheToFile();\n  }\n}\n"],"names":["DEFAULT_CACHE_MAX_FILENAME_LENGTH","debug","getDebug","warn","lowestSupportedMidsceneVersion","cacheFileExt","TaskCache","prompt","type","promptStr","i","item","key","isDeepStrictEqual","locateItem","Array","undefined","consumeKey","consumed","cb","result","yamlWorkflow","parsed","yaml","hasNonEmptyFlow","task","cache","cacheFile","assert","existsSync","jsonTypeCacheFile","console","data","readFileSync","jsonData","version","getMidsceneVersion","semver","err","options","originalLength","usedIndices","Set","parts","index","Number","_","isUsed","isNew","removedCount","dir","dirname","mkdirSync","sortedCaches","a","b","cacheToWrite","yamlData","writeFileSync","JSON","target","newRecord","locateCache","cachedRecord","staleIndex","stale","cacheId","isCacheResultUsed","cacheFilePath","Map","Error","cacheDir","safeCacheId","replaceIllegalPathCharsAndSpace","cacheMaxFilenameLength","globalConfigManager","MIDSCENE_CACHE_MAX_FILENAME_LENGTH","Buffer","prefix","hash","generateHashId","ifInBrowser","ifInWorker","join","getMidsceneRunSubDir","readOnlyMode","Boolean","writeOnlyMode","cacheContent"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAmBA,MAAMA,oCAAoC;AAEnC,MAAMC,QAAQC,SAAS;AAC9B,MAAMC,OAAOD,SAAS,SAAS;IAAE,SAAS;AAAK;AA4B/C,MAAME,iCAAiC;AAChC,MAAMC,eAAe;AAErB,MAAMC;IA8FX,WACEC,MAAmB,EACnBC,IAAuB,EACoC;QAC3D,IAAI,CAAC,IAAI,CAAC,iBAAiB,EACzB;QAGF,MAAMC,YAAY,IAAI,CAAC,SAAS,CAACF;QACjC,IAAK,IAAIG,IAAI,GAAGA,IAAI,IAAI,CAAC,mBAAmB,EAAEA,IAAK;YACjD,MAAMC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAACD,EAAE;YACjC,MAAME,MAAM,GAAGJ,KAAK,CAAC,EAAEC,UAAU,CAAC,EAAEC,GAAG;YACvC,IACEC,KAAK,IAAI,KAAKH,QACdK,kBAAkBF,KAAK,MAAM,EAAEJ,WAC/B,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAACK,MAC9B;gBACA,IAAID,AAAc,aAAdA,KAAK,IAAI,EAAe;oBAC1B,MAAMG,aAAaH;oBACnB,IAAI,CAACG,WAAW,KAAK,IAAIC,MAAM,OAAO,CAACD,WAAW,MAAM,GACtDA,WAAW,KAAK,GAAG;wBAAE,QAAQA,WAAW,MAAM;oBAAC;oBAEjD,IAAI,YAAYA,YACdA,WAAW,MAAM,GAAGE;gBAExB;gBACA,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAACJ;gBAC7B,MAAMK,aAAa,GAAGT,KAAK,CAAC,EAAEC,WAAW;gBACzC,MAAMS,WAAW,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAACD,eAAe,EAAE;gBAChEC,SAAS,IAAI,CAACR;gBACd,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAACO,YAAYC;gBAC1CjB,MACE,mEACAO,MACAD,QACAG;gBAEF,OAAO;oBACL,cAAcC;oBACd,aAAa;oBACb,UAAU,CAACQ;wBACTlB,MACE,uEACAO,MACAD,QACAG;wBAEFS,GAAGR;wBAEH,IAAI,IAAI,CAAC,YAAY,EAAE,YACrBV,MACE;wBAKJA,MACE,sEACAO,MACAD,QACAG;wBAEF,IAAI,CAAC,gBAAgB;oBACvB;gBACF;YACF;QACF;QACAT,MAAM,+CAA+CO,MAAMD;IAE7D;IAEA,eACEA,MAAmB,EAC0B;QAC7C,MAAMa,SAAS,IAAI,CAAC,UAAU,CAACb,QAAQ;QAGvC,IAAI,CAACa,QAAQ;QAEb,MAAMC,eAAeD,OAAO,YAAY,CAAC,YAAY;QACrD,IAAI,CAACC,cAAc,QAAQ;YACzBpB,MACE;YAEF,OAAO;gBACL,GAAGmB,MAAM;gBACT,aAAa;YACf;QACF;QACA,IAAI;YACF,MAAME,SAASC,QAAAA,IAAS,CAACF;YACzB,MAAMG,kBAAkBF,QAAQ,OAAO,KACrC,CAACG,OAAcV,MAAM,OAAO,CAACU,KAAK,IAAI,KAAKA,KAAK,IAAI,CAAC,MAAM,GAAG;YAEhE,IAAI,CAACD,iBAAiB;gBACpBvB,MAAM;gBACN,OAAO;oBACL,GAAGmB,MAAM;oBACT,aAAa;gBACf;YACF;QACF,EAAE,OAAM;YACNnB,MACE;YAEF,OAAO;gBACL,GAAGmB,MAAM;gBACT,aAAa;YACf;QACF;QACA,OAAOA;IACT;IAEA,iBACEb,MAAmB,EACwB;QAC3C,OAAO,IAAI,CAAC,UAAU,CAACA,QAAQ;IAGjC;IAEA,YAAYmB,KAAkC,EAAE;QAC9CzB,MAAM,qBAAqByB;QAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAACA;QAEvB,IAAI,IAAI,CAAC,YAAY,EAAE,YACrBzB,MAAM;QAIR,IAAI,CAAC,gBAAgB;IACvB;IAEA,oBAAoB;QAClB,MAAM0B,YAAY,IAAI,CAAC,aAAa;QACpCC,YAAOD,WAAW;QAElB,IAAI,CAACE,WAAWF,YAAY,YAC1B1B,MAAM,iCAAiC0B;QAKzC,MAAMG,oBAAoBH,UAAU,OAAO,CAACtB,cAAc;QAC1D,IAAIwB,WAAWC,sBAAsB,IAAI,CAAC,iBAAiB,EAAE,YAC3DC,QAAQ,IAAI,CACV,CAAC,2LAA2L,EAAED,kBAAkB,CAAC,CAAC;QAKtN,IAAI;YACF,MAAME,OAAOC,aAAaN,WAAW;YACrC,MAAMO,WAAWX,QAAAA,IAAS,CAACS;YAE3B,MAAMG,UAAUC;YAChB,IAAI,CAACD,SAAS,YACZlC,MAAM;YAIR,IACEoC,OAAO,EAAE,CAACH,SAAS,eAAe,EAAE9B,mCACpC,CAAC8B,SAAS,eAAe,CAAC,QAAQ,CAAC,SACnC,YACAH,QAAQ,IAAI,CACV,CAAC,wSAAwS,EAAEJ,WAAW;YAK1T1B,MACE,0EACA0B,WACAO,SAAS,eAAe,EACxBA,SAAS,MAAM,CAAC,MAAM;YAExBA,SAAS,eAAe,GAAGE;YAC3B,OAAOF;QACT,EAAE,OAAOI,KAAK;YACZrC,MACE,0DACA0B,WACAW;YAEF;QACF;IACF;IAEA,iBAAiBC,OAAmC,EAAE;QACpD,MAAMJ,UAAUC;QAChB,IAAI,CAACD,SAAS,YACZlC,MAAM;QAIR,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,YACvBA,MAAM;QAKR,IAAIsC,SAAS,aAEX,IAAI,IAAI,CAAC,iBAAiB,EAAE;YAC1B,MAAMC,iBAAiB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM;YAG/C,MAAMC,cAAc,IAAIC;YACxB,KAAK,MAAM9B,OAAO,IAAI,CAAC,mBAAmB,CAAE;gBAE1C,MAAM+B,QAAQ/B,IAAI,KAAK,CAAC;gBACxB,MAAMgC,QAAQC,OAAO,QAAQ,CAACF,KAAK,CAACA,MAAM,MAAM,GAAG,EAAE,EAAE;gBACvD,IAAI,CAACE,OAAO,KAAK,CAACD,QAChBH,YAAY,GAAG,CAACG;YAEpB;YAGA,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAACE,GAAGF;gBAC/C,MAAMG,SAASN,YAAY,GAAG,CAACG;gBAC/B,MAAMI,QAAQJ,SAAS,IAAI,CAAC,mBAAmB;gBAC/C,OAAOG,UAAUC;YACnB;YAEA,MAAMC,eAAeT,iBAAiB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM;YAC1DS,eAAe,IACjBhD,MAAM,qCAAqCgD,gBAE3ChD,MAAM;QAEV,OACEA,MAAM;QAIV,IAAI;YACF,MAAMiD,MAAMC,QAAQ,IAAI,CAAC,aAAa;YACtC,IAAI,CAACtB,WAAWqB,MAAM;gBACpBE,UAAUF,KAAK;oBAAE,WAAW;gBAAK;gBACjCjD,MAAM,+BAA+BiD;YACvC;YAIA,MAAMG,eAAe;mBAAI,IAAI,CAAC,KAAK,CAAC,MAAM;aAAC,CAAC,IAAI,CAAC,CAACC,GAAGC;gBACnD,IAAID,AAAW,WAAXA,EAAE,IAAI,IAAeC,AAAW,aAAXA,EAAE,IAAI,EAAe,OAAO;gBACrD,IAAID,AAAW,aAAXA,EAAE,IAAI,IAAiBC,AAAW,WAAXA,EAAE,IAAI,EAAa,OAAO;gBACrD,OAAO;YACT;YAEA,MAAMC,eAAe;gBACnB,GAAG,IAAI,CAAC,KAAK;gBACb,QAAQH;YACV;YAEA,MAAMI,WAAWlC,QAAAA,IAAS,CAACiC,cAAc;gBAAE,WAAW;YAAG;YACzDE,cAAc,IAAI,CAAC,aAAa,EAAED;YAClCxD,MAAM,6BAA6B,IAAI,CAAC,aAAa;QACvD,EAAE,OAAOqC,KAAK;YACZnC,KACE,CAAC,kCAAkC,EAAE,IAAI,CAAC,aAAa,CAAC,SAAS,EAAEmC,KAAK;QAE5E;IACF;IAKQ,UAAU/B,MAAmB,EAAU;QAC7C,OAAO,AAAkB,YAAlB,OAAOA,SAAsBA,SAASoD,KAAK,SAAS,CAACpD;IAC9D;IAKQ,gBACNqD,MAAmC,EACnCC,SAAsC,EACtC;QACA,IAAIA,AAAmB,WAAnBA,UAAU,IAAI,EACfD,OAAyB,YAAY,GAAGC,UAAU,YAAY;aAC1D;YACL,MAAMC,cAAcF;YACpBE,YAAY,KAAK,GAAGD,UAAU,KAAK;YACnC,IAAI,YAAYC,aACdA,YAAY,MAAM,GAAG9C;QAEzB;IACF;IAEA,0BACE6C,SAAsC,EACtCE,YAA4D,EAC5D;QACA,IAAIA,cAEFA,aAAa,QAAQ,CAAC,CAACrC;YACrB,IAAI,CAAC,eAAe,CAACA,OAAOmC;QAC9B;aACK;YAOL,MAAM5C,aAAa,GAAG4C,UAAU,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAACA,UAAU,MAAM,GAAG;YAC1E,MAAMG,aAAa,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC/C,aAAa;YAC3D,IAAI+C,AAAehD,WAAfgD,cAA4B,IAAI,CAAC,KAAK,CAAC,MAAM,CAACA,WAAW,EAAE;gBAC7D/D,MACE,yEACA4D,UAAU,IAAI,EACdA,UAAU,MAAM,EAChBG;gBAEF,IAAI,CAAC,kBAAkB,CAACA,YAAYH;YACtC,OACE,IAAI,CAAC,WAAW,CAACA;QAErB;IACF;IAYA,qBAAqBtD,MAAmB,EAAE;QACxC,MAAMU,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAACV,SAAS;QACrD,MAAMqC,QAAQ,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC3B,aAAa;QACzD,IAAI2B,AAAU5B,WAAV4B,OACF;QAEF,MAAMqB,QAAQ,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAChD,eAAe,EAAE;QAC1DgD,MAAM,IAAI,CAACrB;QACX,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC3B,YAAYgD;QACvChE,MACE,6DACAM,QACAqC;IAEJ;IAEQ,mBACNA,KAAa,EACbiB,SAAsC,EACtC;QACA,MAAMD,SAAS,IAAI,CAAC,KAAK,CAAC,MAAM,CAAChB,MAAM;QAIvChB,YACEgC,OAAO,IAAI,KAAKC,UAAU,IAAI,EAC9B,CAAC,gDAAgD,EAAEA,UAAU,IAAI,CAAC,MAAM,EAAED,OAAO,IAAI,EAAE;QAEzF,IAAI,CAAC,eAAe,CAACA,QAAQC;QAE7B,IAAI,IAAI,CAAC,YAAY,EAAE,YACrB5D,MAAM;QAIR,IAAI,CAAC,gBAAgB;IACvB;IAnbA,YACEiE,OAAe,EACfC,iBAA0B,EAC1BC,aAAsB,EACtB7B,UAII,CAAC,CAAC,CACN;QApCF;QAEA;QAEA;QAEA;QACA;QAEA;QAEA;QAEA,uBAAQ,uBAAmC,IAAIG;QAM/C,uBAAQ,wBAA8C,IAAI2B;QAM1D,uBAAQ,qBAA2C,IAAIA;QAYrDzC,YAAOsC,SAAS;QAChB,IACE3B,AAAqBvB,WAArBuB,QAAQ,QAAQ,IACf,CAA4B,YAA5B,OAAOA,QAAQ,QAAQ,IAAiB,CAACA,QAAQ,QAAQ,CAAC,IAAI,EAAC,GAEhE,MAAM,IAAI+B,MAAM;QAElB,MAAMC,WAAWhC,QAAQ,QAAQ,EAAE;QACnC,IAAIiC,cAAcC,gCAAgCP;QAClD,MAAMQ,yBACJC,oBAAoB,yBAAyB,CAC3CC,uCACG5E;QACP,IAAI6E,OAAO,UAAU,CAACL,aAAa,UAAUE,wBAAwB;YACnE,MAAMI,SAASN,YAAY,KAAK,CAAC,GAAG;YACpC,MAAMO,OAAOC,eAAehE,QAAWwD;YACvCA,cAAc,GAAGM,OAAO,CAAC,EAAEC,MAAM;QACnC;QACA,IAAI,CAAC,OAAO,GAAGP;QAEf,IAAI,CAAC,aAAa,GAChBS,eAAeC,aACXlE,SACAoD,iBACAe,KACEZ,YAAYa,qBAAqB,UACjC,GAAG,IAAI,CAAC,OAAO,GAAG/E,cAAc;QAExC,MAAMgF,eAAeC,QAAQ/C,SAAS;QACtC,MAAMgD,gBAAgBD,QAAQ/C,SAAS;QAEvC,IAAI8C,gBAAgBE,eAClB,MAAM,IAAIjB,MAAM;QAGlB,IAAI,CAAC,iBAAiB,GAAGiB,gBAAgB,QAAQpB;QACjD,IAAI,CAAC,YAAY,GAAGkB;QACpB,IAAI,CAAC,aAAa,GAAGE;QAErB,IAAIC;QACJ,IAAI,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,aAAa,EAC3CA,eAAe,IAAI,CAAC,iBAAiB;QAEvC,IAAI,CAACA,cACHA,eAAe;YACb,iBAAiBpD;YACjB,SAAS,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE;QACZ;QAEF,IAAI,CAAC,KAAK,GAAGoD;QACb,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,iBAAiB,GAC7C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GACxB;IACN;AAoXF"}