@midscene/core 1.11.0 → 1.11.1-beta-20260819031908.0

package/dist/es/agent/agent.mjs

@@ -394,22 +394,21 @@ class Agent {
             const defaultModel = this.resolveModelRuntime('default');
             const aiActContext = opt?.context !== void 0 ? opt.context : this.aiActContext;
             const cachePrompt = buildPromptWithContext(taskPrompt, aiActContext);
-            let deepThink = opt?.deepThink === true;
-            if (deepThink && 'custom' === planningModel.adapter.planning.kind) {
-                warn(`The "deepThink" option is not supported for aiAct with custom planning adapters (modelFamily: ${planningModel.config.modelFamily ?? 'unknown'}). It will be ignored.`);
-                deepThink = false;
-            }
+            const effort = (()=>{
+                const resolvedEffort = opt?.effort ?? (opt?.deepThink === true ? 'deepThink' : 'balance');
+                if (opt?.effort !== void 0) warn('The "effort" option is experimental and not yet open for public use. Do not use it. When both "effort" and "deepThink" are provided, "effort" takes precedence.');
+                if ('fast' === resolvedEffort && 'custom' === planningModel.adapter.planning.kind) throw new Error(`The "fast" aiAct effort is not supported with custom planning adapters (modelFamily: ${planningModel.config.modelFamily ?? 'unknown'}).`);
+                if ('deepThink' === resolvedEffort && 'custom' === planningModel.adapter.planning.kind) {
+                    warn(`The "deepThink" aiAct effort is not supported with custom planning adapters (modelFamily: ${planningModel.config.modelFamily ?? 'unknown'}). It will be ignored.`);
+                    return 'balance';
+                }
+                return resolvedEffort;
+            })();
             let deepLocate = opt?.deepLocate;
             if (deepLocate && !planningModel.adapter.planning.supportsActionDeepLocate) {
                 warn(`The "deepLocate" option is not supported for aiAct with the current planning adapter (modelFamily: ${planningModel.config.modelFamily ?? 'unknown'}). It will be ignored.`);
                 deepLocate = false;
             }
-            const noIndividualLocateModel = 'default' === planningModel.config.slot;
-            const includeLocateInPlanning = !deepThink && noIndividualLocateModel;
-            debug('setting includeLocateInPlanning to', includeLocateInPlanning, {
-                deepThink,
-                noIndividualLocateModel
-            });
             const cacheable = opt?.cacheable;
             const replanningCycleLimit = this.resolveReplanningCycleLimit(planningModel);
             const planCacheEnabled = planningModel.adapter.planning.cacheEnabled;
@@ -427,8 +426,7 @@ class Agent {
                     warn(`cached aiAct plan failed, will replan and disable the stale cache: ${error instanceof Error ? error.message : String(error)}`);
                 }
             }
-            const imagesIncludeCount = deepThink ? 2 : 1;
-            const { output: actionOutput } = await this.taskExecutor.action(taskPrompt, planningModel, defaultModel, includeLocateInPlanning, aiActContext, cacheable, replanningCycleLimit, imagesIncludeCount, deepThink, void 0, deepLocate, abortSignal, internalReportDisplay);
+            const { output: actionOutput } = await this.taskExecutor.action(taskPrompt, planningModel, defaultModel, aiActContext, cacheable, replanningCycleLimit, effort, void 0, deepLocate, abortSignal, internalReportDisplay);
             if (this.taskCache && false !== cacheable) {
                 const yamlFlow = cachedYamlFailed ? [] : actionOutput?.yamlFlow;
                 if (!cachedYamlFailed && !yamlFlow?.length) return actionOutput?.output;

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 { INTERNAL_CALL_ID_FIELD } from '@/ai-model/service-caller';\nimport { IS_REPORT_BUILD } from '@/constants';\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 AIUsageInfo,\n  type ActionParam,\n  type ActionReturn,\n  type AgentAssertResult,\n  type AgentOpt,\n  type AgentProgressListener,\n  type AgentWaitForOpt,\n  type AssertOptions,\n  type DeepThinkOption,\n  type DeviceAction,\n  ExecutionDump,\n  type ExecutionRecorderItem,\n  type ExecutionTask,\n  type ExecutionTaskLog,\n  type InsightAPI,\n  type LocateOption,\n  type LocateResultElement,\n  type OnTaskStartTip,\n  type PlanningAction,\n  type QueryOptions,\n  type RecordToReportOptions,\n  type RecordToReportScreenshot,\n  ReportActionDump,\n  type ReportMeta,\n  type ScrollParam,\n  type ServiceAction,\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  buildDetailedLocateParamAndRestParams,\n  parseYamlScript,\n} from '../yaml/index';\n\nimport { readFile } from 'node:fs/promises';\nimport { basename, resolve } from 'node:path';\nimport type { AbstractInterface } from '@/device';\nimport type { TaskRunner } from '@/task-runner';\nimport {\n  type ObservationArtifactAdapter,\n  observationArtifactAdapterSymbol,\n} from '@midscene/shared/agent-tools/observation-artifact';\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 {\n  defineActionRegisterFileChooserAccept,\n  defineActionSleep,\n} from '../device';\nimport { validateAgentCacheInput } from './cache-config';\nimport { FileChooserAccepter } from './file-chooser';\nimport { Insight } from './insight';\nimport { MetricsCollector, type MidsceneUsageMetrics } from './metrics';\nimport { AgentProgressBus } from './progress';\nimport { buildPromptWithContext } from './prompt-context';\nimport { normalizeRecordToReportScreenshot } from './record-to-report';\nimport {\n  type RunGherkinScenarioOptions,\n  runGherkinScenario,\n} from './run-gherkin-scenario';\nimport { markdownToAiActPrompt } from './run-markdown';\nimport { TaskCache } from './task-cache';\nimport { TaskExecutor, locatePlanForLocate, withFileChooser } from './tasks';\nimport {\n  UIObservationImpl,\n  type UIObserver,\n  UIObserverImpl,\n  type UIObserverOption,\n  uiContextFromObservationRecord,\n} from './ui-observer';\nimport {\n  type TaskTitleType,\n  locateParamStr,\n  paramStr,\n  taskTitleStr,\n  typeStr,\n} from './ui-utils';\nimport {\n  commonContextParser,\n  getReportFileName,\n  normalizeFilePaths,\n  normalizeScrollType,\n} from './utils';\n\nconst debug = getDebug('agent');\nconst warn = getDebug('agent', { console: true });\n\nexport type AiActOptions = {\n  cacheable?: boolean;\n  fileChooserAccept?: string | string[];\n  fileChooserAllowedDir?: string;\n  deepThink?: DeepThinkOption;\n  deepLocate?: boolean;\n  abortSignal?: AbortSignal;\n  context?: string;\n};\n\ntype AiActInternalOptions = AiActOptions & {\n  _internalReportDisplay?: {\n    type?: TaskTitleType;\n    prompt?: string;\n  };\n};\n\n/**\n * Shared input option type for aiInput(), used consistently across\n * overload signatures and the implementation so fields don't drift.\n */\ntype AgentInputOption = LocateOption & {\n  autoDismissKeyboard?: boolean;\n  keyboardTypeDelay?: number;\n  mode?: 'replace' | 'clear' | 'typeOnly' | 'append';\n};\n\nexport class Agent<InterfaceType extends AbstractInterface = AbstractInterface>\n  implements InsightAPI\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 readonly metricsCollector = new MetricsCollector();\n\n  // Monotonic counter for generating unique dedup keys when a usage has no\n  // request_id (e.g. estimated streaming usage).\n  private usageCallCounter = 0;\n\n  // Usage values already folded into `metricsCollector`, keyed by\n  // `${taskId}:${field}` so re-emitted snapshots never double-count.\n  private readonly countedUsageKeys = new Set<string>();\n\n  private dumpUpdateListeners: Array<\n    (dump: string, executionDump?: ExecutionDump) => void\n  > = [];\n\n  // Generic progress bus: every producer (aiAct today, more later) broadcasts\n  // through here. Consumers narrow by `event.scope`.\n  private readonly progressBus = new AgentProgressBus();\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  /**\n   * Currently active UIObserver (from startObserving). Only one observer may\n   * be active at a time since frame sources are device-level singletons.\n   */\n  private activeObserver: UIObserverImpl | null = null;\n\n  /** Observers own temporary frame files until their observation is disposed. */\n  private ownedObservers = new Set<UIObserverImpl>();\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 activeFileChooserAccepter?: FileChooserAccepter;\n\n  private activeFileChooserAllowedDir?: string;\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    const runtime = getModelRuntime(\n      this.modelConfigManager.getModelConfig(intent),\n    );\n    return {\n      ...runtime,\n      onUsage: (usage) => {\n        this.usageCallCounter += 1;\n        // buildUsageInfo leaves intent undefined; fill it from the model\n        // config slot so metrics.byIntent has a meaningful category.\n        const enriched = usage.intent\n          ? usage\n          : { ...usage, intent: usage.slot };\n        this.consumeUsage(\n          enriched,\n          `callai:${usage.request_id ?? this.usageCallCounter}`,\n        );\n      },\n    };\n  }\n\n  private createInsight(getUIContext?: () => UIContext): Insight {\n    return new Insight(\n      this.taskExecutor,\n      () => this.resolveModelRuntime('insight'),\n      getUIContext,\n    );\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    const fileChooserActions = this.interface.registerFileChooserListener\n      ? [\n          defineActionRegisterFileChooserAccept(async (files) => {\n            if (!this.activeFileChooserAccepter) {\n              throw new Error(\n                'RegisterFileChooserAccept can only be used while aiAct is running',\n              );\n            }\n            if (!this.activeFileChooserAllowedDir) {\n              throw new Error(\n                'RegisterFileChooserAccept requires aiAct option fileChooserAllowedDir',\n              );\n            }\n            await this.activeFileChooserAccepter.registerFromAllowedDir(\n              files,\n              this.activeFileChooserAllowedDir,\n            );\n          }),\n        ]\n      : [];\n    this.fullActionSpace = [\n      ...baseActionSpace,\n      ...fileChooserActions,\n      defineActionSleep(),\n    ];\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        onSnapshotChange: async (runner) => {\n          const executionDump = runner.dump();\n          this.appendExecutionDump(executionDump, runner);\n          this.collectUsageMetrics(executionDump);\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        onProgress: this.progressBus.publish,\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    Object.defineProperty(this, observationArtifactAdapterSymbol, {\n      value: {\n        exportRecord: async (observation) => {\n          assert(\n            observation instanceof UIObservationImpl,\n            'Cannot export an observation that was not created by this Midscene runtime',\n          );\n          return observation.exportRecord();\n        },\n        loadRecord: (record) => {\n          // CLI manifests are validated before this adapter is called. Rebuild\n          // once here as a final runtime-boundary check before creating insight.\n          uiContextFromObservationRecord(record);\n          return new UIObservationImpl(\n            record,\n            this.createInsight(() => uiContextFromObservationRecord(record)),\n          );\n        },\n      } satisfies ObservationArtifactAdapter,\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   * Start observing the screen in the background and return a fixed insight\n   * surface when the observation is stopped:\n   *\n   * ```ts\n   * const observer = await agent.startObserving();\n   * await agent.aiAct('submit the form');\n   * const observation = await observer.stop();\n   * await observation.aiAssert('a success toast appeared during the process');\n   * ```\n   *\n   * Frames come from the device's continuous frame source when available\n   * (scrcpy on Android, WDA MJPEG on iOS — both opt-in; CDP screencast on\n   * web) and fall back to plain screenshots otherwise. Sampling is capped at\n   * 5fps, the buffer is bounded and self-thinning, decoding is deferred to\n   * the end, and all buffered frames (up to `maxFrames`) are sent to\n   * the model at insight time. To control token cost for long windows,\n   * increase `intervalMs` or decrease `maxFrames`.\n   * Awaiting `startObserving()` guarantees one baseline frame is captured\n   * before your next action.\n   */\n  async startObserving(opt?: UIObserverOption): Promise<UIObserver> {\n    // A frozen context pins perception to a single snapshot; observing a\n    // window of frames contradicts that. Fail fast instead of silently\n    // producing an all-identical sequence.\n    assert(\n      !this.frozenUIContext,\n      'startObserving() cannot be used while the UI context is frozen (call unfreezePageContext() first)',\n    );\n    // Frame sources are device-level singletons — two concurrent observers\n    // would conflict (scrcpy stream, WDA MJPEG port, CDP screencast).\n    assert(\n      !this.activeObserver,\n      'An observation window is already active on this agent. ' +\n        'Stop the existing observer first (await observer.stop()) before starting a new one.',\n    );\n    const observer = new UIObserverImpl(\n      {\n        openFrameSource: async () =>\n          (await this.interface.openFrameSource?.()) ?? undefined,\n        // Fallback single-frame capture. Deliberately bypasses getUIContext so\n        // the observation loop never pollutes the TaskRunner context cache.\n        screenshot: () => this.interface.screenshotBase64(),\n        captureRepresentative: () => this.getUIContext('assert'),\n        createInsight: (record) =>\n          this.createInsight(() => uiContextFromObservationRecord(record)),\n        onStopped: () => {\n          if (this.activeObserver === observer) {\n            this.activeObserver = null;\n          }\n        },\n        onDisposed: () => this.ownedObservers.delete(observer),\n        screenshotShrinkFactor: this.opts.screenshotShrinkFactor,\n      },\n      opt,\n    );\n    // Mark as active BEFORE the async start() so concurrent calls hit the\n    // assert guard above. If start() throws, clear the reference below.\n    this.activeObserver = observer;\n    this.ownedObservers.add(observer);\n    try {\n      await observer.start();\n    } catch (error) {\n      this.activeObserver = null;\n      this.ownedObservers.delete(observer);\n      await observer.dispose().catch((disposeError) => {\n        debug(`error disposing failed observer start: ${disposeError}`);\n      });\n      throw error;\n    }\n    return observer;\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  /**\n   * Fold any not-yet-counted task usage from an execution dump into the\n   * instance metrics. Snapshots are re-emitted as tasks progress, so each\n   * usage value is keyed by `${taskId}:${field}` and counted at most once.\n   */\n  private collectUsageMetrics(execution: ExecutionDump) {\n    for (const task of execution.tasks) {\n      this.consumeUsage(task.usage, `${task.taskId}:usage`);\n      this.consumeUsage(task.searchAreaUsage, `${task.taskId}:searchAreaUsage`);\n    }\n  }\n\n  private consumeUsage(usage: AIUsageInfo | undefined, key: string) {\n    if (!usage) {\n      return;\n    }\n    // Dedup key priority:\n    // 1. request_id — provider-issued, stable across onUsage and task dump paths\n    // 2. INTERNAL_CALL_ID_FIELD — callAI-generated internal id, covers\n    //    providers that don't return a request_id\n    // 3. caller-provided key (taskId:field or callai:counter)\n    let dedupKey: string;\n    if (usage.request_id) {\n      dedupKey = `req:${usage.request_id}`;\n    } else if ((usage as any)[INTERNAL_CALL_ID_FIELD]) {\n      dedupKey = `int:${(usage as any)[INTERNAL_CALL_ID_FIELD]}`;\n    } else {\n      dedupKey = key;\n    }\n    if (this.countedUsageKeys.has(dedupKey)) {\n      return;\n    }\n    this.countedUsageKeys.add(dedupKey);\n    this.metricsCollector.add(usage);\n    if (this.opts.onLLMUsage) {\n      try {\n        this.opts.onLLMUsage(usage);\n      } catch (error) {\n        warn(`onLLMUsage listener threw, ignoring: ${error}`);\n      }\n    }\n  }\n\n  /**\n   * Aggregated LLM usage accumulated by this agent since it was created.\n   */\n  get metrics(): MidsceneUsageMetrics {\n    return this.metricsCollector.snapshot();\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    // Short-circuit at the call site because JavaScript evaluates function\n    // arguments first. This avoids serializing the dump (including inline\n    // screenshots) when the Report Viewer build does not need report HTML.\n    if (IS_REPORT_BUILD) {\n      return '';\n    }\n\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: AgentInputOption & { value: string | number },\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?: AgentInputOption,\n  ): Promise<void>;\n\n  // Implementation\n  async aiInput(\n    locatePromptOrValue: TUserPrompt | string | number,\n    locatePromptOrOpt:\n      | TUserPrompt\n      | (AgentInputOption & { value: string | number })\n      | undefined,\n    optOrUndefined?: AgentInputOption,\n  ) {\n    let value: string | number;\n    let locatePrompt: TUserPrompt;\n    let opt: (AgentInputOption & { value: string | number }) | 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 AgentInputOption & {\n        value: string | number;\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 { locateParam, restParams } = buildDetailedLocateParamAndRestParams(\n      locatePrompt,\n      opt,\n    );\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      ...restParams,\n      value: stringValue,\n      locate: locateParam,\n      mode,\n    });\n  }\n\n  // New signature\n  async aiKeyboardPress(\n    locatePrompt: TUserPrompt | undefined,\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 | undefined,\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 { locateParam, restParams } = buildDetailedLocateParamAndRestParams(\n      locatePrompt || '',\n      opt,\n    );\n\n    await this.callActionInActionSpace('KeyboardPress', {\n      ...restParams,\n      locate: locateParam,\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,\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 { locateParam, restParams } = buildDetailedLocateParamAndRestParams(\n      locatePrompt || '',\n      opt,\n    );\n\n    await this.callActionInActionSpace('Scroll', {\n      ...restParams,\n      locate: locateParam,\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 { locateParam, restParams } = buildDetailedLocateParamAndRestParams(\n      locatePrompt || '',\n      opt,\n    );\n\n    await this.callActionInActionSpace('Pinch', {\n      ...restParams,\n      locate: locateParam,\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 { locateParam, restParams } = buildDetailedLocateParamAndRestParams(\n      locatePrompt,\n      opt,\n    );\n\n    await this.callActionInActionSpace('LongPress', {\n      ...restParams,\n      locate: locateParam,\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 internalReportDisplay = (opt as AiActInternalOptions | undefined)\n      ?._internalReportDisplay;\n    const taskPromptText =\n      typeof taskPrompt === 'string' ? taskPrompt : taskPrompt.prompt;\n    const reportPrompt = internalReportDisplay?.prompt || taskPromptText;\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      const aiActContext =\n        opt?.context !== undefined ? opt.context : this.aiActContext;\n      const cachePrompt = buildPromptWithContext(taskPrompt, aiActContext);\n      // Controls the aiAct planning mode, such as sub-goal prompts and locate result strategy.\n      let deepThink = opt?.deepThink === true;\n      if (deepThink && planningModel.adapter.planning.kind === 'custom') {\n        warn(\n          `The \"deepThink\" option is not supported for aiAct with custom planning adapters (modelFamily: ${planningModel.config.modelFamily ?? 'unknown'}). It will be ignored.`,\n        );\n        deepThink = false;\n      }\n\n      let deepLocate = opt?.deepLocate;\n      if (\n        deepLocate &&\n        !planningModel.adapter.planning.supportsActionDeepLocate\n      ) {\n        warn(\n          `The \"deepLocate\" option is not supported for aiAct with the current planning adapter (modelFamily: ${planningModel.config.modelFamily ?? 'unknown'}). It will be ignored.`,\n        );\n        deepLocate = false;\n      }\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(cachePrompt);\n      let cachedYamlFailed = false;\n      if (\n        matchedCache?.cacheUsable &&\n        this.taskCache?.isCacheResultUsed &&\n        matchedCache.cacheContent?.yamlWorkflow?.trim()\n      ) {\n        const yaml = matchedCache.cacheContent.yamlWorkflow;\n        try {\n          // log into report file\n          await this.taskExecutor.loadYamlFlowAsPlanning(\n            taskPrompt,\n            yaml,\n            internalReportDisplay,\n          );\n\n          debug('matched cache, will call .runYaml to run the action');\n          await this.runYaml(yaml);\n          return;\n        } catch (error) {\n          cachedYamlFailed = true;\n          warn(\n            `cached aiAct plan failed, will replan and disable the stale cache: ${\n              error instanceof Error ? error.message : String(error)\n            }`,\n          );\n        }\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        aiActContext,\n        cacheable,\n        replanningCycleLimit,\n        imagesIncludeCount,\n        deepThink,\n        undefined,\n        deepLocate,\n        abortSignal,\n        internalReportDisplay,\n      );\n\n      // update cache\n      if (this.taskCache && cacheable !== false) {\n        const yamlFlow = cachedYamlFailed ? [] : actionOutput?.yamlFlow;\n\n        if (!cachedYamlFailed && !yamlFlow?.length) {\n          return actionOutput?.output;\n        }\n\n        const yamlFlowToCache = yamlFlow ?? [];\n        const yamlContent: MidsceneYamlScript = {\n          tasks: [\n            {\n              name: reportPrompt,\n              flow: yamlFlowToCache,\n            },\n          ],\n        };\n        const yamlFlowStr = yaml.dump(yamlContent);\n        this.taskCache.updateOrAppendCacheRecord(\n          {\n            type: 'plan',\n            prompt: cachePrompt,\n            yamlWorkflow: yamlFlowStr,\n          },\n          matchedCache,\n        );\n      }\n\n      return actionOutput?.output;\n    };\n\n    const fileChooserAccepter = this.interface.registerFileChooserListener\n      ? new FileChooserAccepter(this.interface)\n      : undefined;\n    this.activeFileChooserAccepter = fileChooserAccepter;\n    this.activeFileChooserAllowedDir = opt?.fileChooserAllowedDir\n      ? resolve(opt.fileChooserAllowedDir)\n      : undefined;\n    let aiActError: { error: unknown } | undefined;\n    let fileChooserHandlingError: Error | undefined;\n    let result: string | undefined;\n    try {\n      if (fileChooserAccept?.length) {\n        if (!fileChooserAccepter) {\n          throw new Error(\n            `File upload is not supported on ${this.interface.interfaceType}`,\n          );\n        }\n        await fileChooserAccepter.register(fileChooserAccept);\n      }\n      result = await runAiAct();\n    } catch (error) {\n      aiActError = { error };\n    } finally {\n      this.activeFileChooserAccepter = undefined;\n      this.activeFileChooserAllowedDir = undefined;\n      try {\n        fileChooserHandlingError = await fileChooserAccepter?.clear();\n      } catch (error) {\n        warn(`Failed to clear file chooser registration: ${error}`);\n      }\n    }\n\n    if (aiActError) {\n      throw aiActError.error;\n    }\n    if (fileChooserHandlingError) {\n      throw fileChooserHandlingError;\n    }\n    return result;\n  }\n\n  async runMarkdown(\n    markdownPath: string,\n    opt?: AiActOptions,\n  ): Promise<string | undefined> {\n    const markdown = await readFile(markdownPath, 'utf-8');\n    const { prompt } = await markdownToAiActPrompt(markdown, markdownPath);\n    return this.aiAct(prompt, {\n      ...opt,\n      _internalReportDisplay: {\n        type: 'Markdown',\n        prompt: basename(markdownPath),\n      },\n    } as AiActOptions);\n  }\n\n  async runGherkinScenario(\n    scenarioText: string,\n    opt?: RunGherkinScenarioOptions,\n  ): Promise<void> {\n    return runGherkinScenario(this, scenarioText, opt);\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?: QueryOptions,\n  ): Promise<ReturnType> {\n    return this.createInsight().aiQuery<ReturnType>(demand, opt);\n  }\n\n  async aiBoolean(prompt: TUserPrompt, opt?: QueryOptions): Promise<boolean> {\n    return this.createInsight().aiBoolean(prompt, opt);\n  }\n\n  async aiNumber(prompt: TUserPrompt, opt?: QueryOptions): Promise<number> {\n    return this.createInsight().aiNumber(prompt, opt);\n  }\n\n  async aiString(prompt: TUserPrompt, opt?: QueryOptions): Promise<string> {\n    return this.createInsight().aiString(prompt, opt);\n  }\n\n  async aiAsk(prompt: TUserPrompt, opt?: QueryOptions): Promise<string> {\n    return this.createInsight().aiAsk(prompt, opt);\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      opt?.uiContext ? { uiContext: opt.uiContext } : undefined,\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' | 'dpr'>;\n  }\n\n  async aiAssert(\n    assertion: TUserPrompt,\n    msg?: string,\n    opt?: AssertOptions,\n  ): Promise<AgentAssertResult | undefined> {\n    return this.createInsight().aiAssert(assertion, msg, opt);\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  /**\n   * Subscribe to the generic agent progress bus. The listener receives every\n   * progress event regardless of producer; narrow by `event.scope` to handle a\n   * specific producer (e.g. `'aiAct'`).\n   * @param listener Listener function\n   * @returns A remove function that can be called to remove this listener\n   */\n  addProgressListener(listener: AgentProgressListener): () => void {\n    return this.progressBus.subscribe(listener);\n  }\n\n  /**\n   * Remove a progress listener added via {@link addProgressListener}.\n   */\n  removeProgressListener(listener: AgentProgressListener): void {\n    this.progressBus.unsubscribe(listener);\n  }\n\n  /**\n   * Clear all generic progress listeners.\n   */\n  clearProgressListeners(): void {\n    this.progressBus.clear();\n  }\n\n  private notifyDumpUpdateListeners(executionDump?: ExecutionDump) {\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  async destroy() {\n    // Early return if already destroyed\n    if (this.destroyed) {\n      return;\n    }\n\n    this.destroyed = true;\n\n    // Observers own observation frame files until explicitly disposed.\n    for (const observer of this.ownedObservers) {\n      try {\n        await observer.dispose();\n      } catch (error) {\n        debug(`error disposing unexported observer during destroy: ${error}`);\n      }\n    }\n    this.ownedObservers.clear();\n    this.activeObserver = null;\n\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(title?: string, opt?: RecordToReportOptions) {\n    const now = Date.now();\n    const screenshots = opt?.screenshots;\n    const screenshotBase64 = opt?.screenshotBase64;\n    const hasScreenshots = screenshots !== undefined;\n    const hasScreenshotBase64 = screenshotBase64 !== undefined;\n    if (hasScreenshots && !Array.isArray(screenshots)) {\n      throw new Error('recordToReport: screenshots must be an array');\n    }\n    if (hasScreenshotBase64 && typeof screenshotBase64 !== 'string') {\n      throw new Error('recordToReport: screenshotBase64 must be a string');\n    }\n    if (hasScreenshots && hasScreenshotBase64) {\n      throw new Error(\n        'recordToReport: provide only one of screenshots or screenshotBase64',\n      );\n    }\n    if (opt && 'subType' in opt) {\n      throw new Error('recordToReport: subType is not supported');\n    }\n    const customScreenshots = hasScreenshots ? screenshots : undefined;\n    if (customScreenshots && customScreenshots.length === 0) {\n      throw new Error('recordToReport: screenshots cannot be empty');\n    }\n    const screenshotInputs: RecordToReportScreenshot[] =\n      customScreenshots ??\n      (hasScreenshotBase64\n        ? [{ base64: screenshotBase64 }]\n        : [{ base64: await this.interface.screenshotBase64() }]);\n\n    // 1. build recorder\n    const recorder: ExecutionRecorderItem[] = screenshotInputs.map(\n      (screenshotInput, index) => {\n        const normalizedScreenshotInput = normalizeRecordToReportScreenshot(\n          screenshotInput,\n          index,\n        );\n        const ts = now + index;\n        return {\n          type: 'screenshot',\n          ts,\n          screenshot: ScreenshotItem.create(\n            normalizedScreenshotInput.base64,\n            ts,\n          ),\n          description: normalizedScreenshotInput.description,\n        };\n      },\n    );\n    // 2. 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    // 3. 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    // 4. 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    this.notifyDumpUpdateListeners(executionDump);\n  }\n\n  async recordErrorToReport(\n    title: string,\n    opt: {\n      error: Error;\n      content?: string;\n      screenshotBase64?: string;\n    },\n  ) {\n    const now = Date.now();\n    const recorder: ExecutionRecorderItem[] = [];\n    const base64 =\n      opt.screenshotBase64 ?? (await this.interface.screenshotBase64());\n    if (base64) {\n      recorder.push({\n        type: 'screenshot',\n        ts: now,\n        screenshot: ScreenshotItem.create(base64, now),\n      });\n    }\n\n    const task: ExecutionTaskLog = {\n      taskId: uuid(),\n      type: 'Log',\n      subType: 'Error',\n      status: 'failed',\n      recorder,\n      timing: {\n        start: now,\n        end: now,\n        cost: 0,\n      },\n      param: {\n        content: opt.content || '',\n      },\n      error: opt.error,\n      errorMessage: opt.error.message,\n      errorStack: opt.error.stack,\n      executor: async () => {},\n    };\n\n    const executionDump = new ExecutionDump({\n      id: uuid(),\n      logTime: now,\n      name: title,\n      description: opt.content || opt.error.message,\n      tasks: [task],\n    });\n\n    this.appendExecutionDump(executionDump);\n    this.writeOutActionDumps(executionDump);\n    await this.reportGenerator.flush();\n    this.notifyDumpUpdateListeners(executionDump);\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 normalizeFileInput(files: string | string[]): string[] {\n    const filesArray = Array.isArray(files) ? files : [files];\n    return 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","warn","Agent","callback","planningModel","globalConfigManager","MIDSCENE_REPLANNING_CYCLE_LIMIT","intent","runtime","getModelRuntime","usage","enriched","getUIContext","Insight","_error","action","maxRetries","attempt","commonContextParser","error","Promise","resolve","setTimeout","opt","assert","observer","UIObserverImpl","undefined","record","uiContextFromObservationRecord","disposeError","prompt","console","ReportActionDump","getVersion","WeakMap","execution","runner","currentDump","existingIndex","task","key","dedupKey","INTERNAL_CALL_ID_FIELD","ifInBrowser","IS_REPORT_BUILD","reportHTMLContent","executionDump","exec","param","paramStr","tip","typeStr","name","type","actionPlan","plans","Boolean","title","taskTitleStr","locateParamStr","defaultModel","output","locatePrompt","detailedLocateParam","buildDetailedLocateParam","fileChooserAccept","withFileChooser","locatePromptOrValue","locatePromptOrOpt","optOrUndefined","value","optWithValue","locateParam","restParams","buildDetailedLocateParamAndRestParams","stringValue","String","mode","locatePromptOrKeyName","keyName","locatePromptOrScrollParam","scrollParam","isLocatePromptLike","normalizedScrollType","normalizeScrollType","taskPrompt","internalReportDisplay","taskPromptText","reportPrompt","abortSignal","Error","runAiAct","aiActContext","cachePrompt","buildPromptWithContext","deepThink","deepLocate","noIndividualLocateModel","includeLocateInPlanning","cacheable","replanningCycleLimit","planCacheEnabled","matchedCache","cachedYamlFailed","yaml","imagesIncludeCount","actionOutput","yamlFlow","yamlFlowToCache","yamlContent","yamlFlowStr","fileChooserAccepter","FileChooserAccepter","aiActError","fileChooserHandlingError","result","markdownPath","markdown","readFile","markdownToAiActPrompt","basename","scenarioText","runGherkinScenario","demand","locatePlan","locatePlanForLocate","element","assertion","msg","modelRuntime","args","yamlScriptContent","script","parseYamlScript","player","ScriptPlayer","errors","listener","index","dumpString","interfaceDestroyError","finalPath","now","Date","screenshots","screenshotBase64","hasScreenshots","hasScreenshotBase64","Array","customScreenshots","screenshotInputs","recorder","screenshotInput","normalizedScreenshotInput","normalizeRecordToReportScreenshot","ts","ScreenshotItem","uuid","ExecutionDump","base64","groupName","groupDescription","executions","context","opts","validateAgentCacheInput","cacheConfig","processCacheConfig","id","strategyValue","isReadOnly","isWriteOnly","files","filesArray","normalizeFilePaths","options","interfaceInstance","MetricsCollector","Set","AgentProgressBus","Object","assertReportGenerationOptions","resolvedAiActContext","hasCustomConfig","ModelConfigManager","globalModelConfigManager","Service","cacheConfigObj","TaskCache","baseActionSpace","fileChooserActions","defineActionRegisterFileChooserAccept","defineActionSleep","TaskExecutor","getReportFileName","ReportGenerator","observationArtifactAdapterSymbol","observation","UIObservationImpl","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 { INTERNAL_CALL_ID_FIELD } from '@/ai-model/service-caller';\nimport { IS_REPORT_BUILD } from '@/constants';\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 AIUsageInfo,\n  type ActionParam,\n  type ActionReturn,\n  type AgentAssertResult,\n  type AgentOpt,\n  type AgentProgressListener,\n  type AgentWaitForOpt,\n  type AiActEffort,\n  type AssertOptions,\n  type DeepThinkOption,\n  type DeviceAction,\n  ExecutionDump,\n  type ExecutionRecorderItem,\n  type ExecutionTask,\n  type ExecutionTaskLog,\n  type InsightAPI,\n  type LocateOption,\n  type LocateResultElement,\n  type OnTaskStartTip,\n  type PlanningAction,\n  type QueryOptions,\n  type RecordToReportOptions,\n  type RecordToReportScreenshot,\n  ReportActionDump,\n  type ReportMeta,\n  type ScrollParam,\n  type ServiceAction,\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  buildDetailedLocateParamAndRestParams,\n  parseYamlScript,\n} from '../yaml/index';\n\nimport { readFile } from 'node:fs/promises';\nimport { basename, resolve } from 'node:path';\nimport type { AbstractInterface } from '@/device';\nimport type { TaskRunner } from '@/task-runner';\nimport {\n  type ObservationArtifactAdapter,\n  observationArtifactAdapterSymbol,\n} from '@midscene/shared/agent-tools/observation-artifact';\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 {\n  defineActionRegisterFileChooserAccept,\n  defineActionSleep,\n} from '../device';\nimport { validateAgentCacheInput } from './cache-config';\nimport { FileChooserAccepter } from './file-chooser';\nimport { Insight } from './insight';\nimport { MetricsCollector, type MidsceneUsageMetrics } from './metrics';\nimport { AgentProgressBus } from './progress';\nimport { buildPromptWithContext } from './prompt-context';\nimport { normalizeRecordToReportScreenshot } from './record-to-report';\nimport {\n  type RunGherkinScenarioOptions,\n  runGherkinScenario,\n} from './run-gherkin-scenario';\nimport { markdownToAiActPrompt } from './run-markdown';\nimport { TaskCache } from './task-cache';\nimport { TaskExecutor, locatePlanForLocate, withFileChooser } from './tasks';\nimport {\n  UIObservationImpl,\n  type UIObserver,\n  UIObserverImpl,\n  type UIObserverOption,\n  uiContextFromObservationRecord,\n} from './ui-observer';\nimport {\n  type TaskTitleType,\n  locateParamStr,\n  paramStr,\n  taskTitleStr,\n  typeStr,\n} from './ui-utils';\nimport {\n  commonContextParser,\n  getReportFileName,\n  normalizeFilePaths,\n  normalizeScrollType,\n} from './utils';\n\nconst debug = getDebug('agent');\nconst warn = getDebug('agent', { console: true });\n\nexport type AiActOptions = {\n  cacheable?: boolean;\n  fileChooserAccept?: string | string[];\n  fileChooserAllowedDir?: string;\n  effort?: AiActEffort;\n  deepThink?: DeepThinkOption;\n  deepLocate?: boolean;\n  abortSignal?: AbortSignal;\n  context?: string;\n};\n\ntype AiActInternalOptions = AiActOptions & {\n  _internalReportDisplay?: {\n    type?: TaskTitleType;\n    prompt?: string;\n  };\n};\n\n/**\n * Shared input option type for aiInput(), used consistently across\n * overload signatures and the implementation so fields don't drift.\n */\ntype AgentInputOption = LocateOption & {\n  autoDismissKeyboard?: boolean;\n  keyboardTypeDelay?: number;\n  mode?: 'replace' | 'clear' | 'typeOnly' | 'append';\n};\n\nexport class Agent<InterfaceType extends AbstractInterface = AbstractInterface>\n  implements InsightAPI\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 readonly metricsCollector = new MetricsCollector();\n\n  // Monotonic counter for generating unique dedup keys when a usage has no\n  // request_id (e.g. estimated streaming usage).\n  private usageCallCounter = 0;\n\n  // Usage values already folded into `metricsCollector`, keyed by\n  // `${taskId}:${field}` so re-emitted snapshots never double-count.\n  private readonly countedUsageKeys = new Set<string>();\n\n  private dumpUpdateListeners: Array<\n    (dump: string, executionDump?: ExecutionDump) => void\n  > = [];\n\n  // Generic progress bus: every producer (aiAct today, more later) broadcasts\n  // through here. Consumers narrow by `event.scope`.\n  private readonly progressBus = new AgentProgressBus();\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  /**\n   * Currently active UIObserver (from startObserving). Only one observer may\n   * be active at a time since frame sources are device-level singletons.\n   */\n  private activeObserver: UIObserverImpl | null = null;\n\n  /** Observers own temporary frame files until their observation is disposed. */\n  private ownedObservers = new Set<UIObserverImpl>();\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 activeFileChooserAccepter?: FileChooserAccepter;\n\n  private activeFileChooserAllowedDir?: string;\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    const runtime = getModelRuntime(\n      this.modelConfigManager.getModelConfig(intent),\n    );\n    return {\n      ...runtime,\n      onUsage: (usage) => {\n        this.usageCallCounter += 1;\n        // buildUsageInfo leaves intent undefined; fill it from the model\n        // config slot so metrics.byIntent has a meaningful category.\n        const enriched = usage.intent\n          ? usage\n          : { ...usage, intent: usage.slot };\n        this.consumeUsage(\n          enriched,\n          `callai:${usage.request_id ?? this.usageCallCounter}`,\n        );\n      },\n    };\n  }\n\n  private createInsight(getUIContext?: () => UIContext): Insight {\n    return new Insight(\n      this.taskExecutor,\n      () => this.resolveModelRuntime('insight'),\n      getUIContext,\n    );\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    const fileChooserActions = this.interface.registerFileChooserListener\n      ? [\n          defineActionRegisterFileChooserAccept(async (files) => {\n            if (!this.activeFileChooserAccepter) {\n              throw new Error(\n                'RegisterFileChooserAccept can only be used while aiAct is running',\n              );\n            }\n            if (!this.activeFileChooserAllowedDir) {\n              throw new Error(\n                'RegisterFileChooserAccept requires aiAct option fileChooserAllowedDir',\n              );\n            }\n            await this.activeFileChooserAccepter.registerFromAllowedDir(\n              files,\n              this.activeFileChooserAllowedDir,\n            );\n          }),\n        ]\n      : [];\n    this.fullActionSpace = [\n      ...baseActionSpace,\n      ...fileChooserActions,\n      defineActionSleep(),\n    ];\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        onSnapshotChange: async (runner) => {\n          const executionDump = runner.dump();\n          this.appendExecutionDump(executionDump, runner);\n          this.collectUsageMetrics(executionDump);\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        onProgress: this.progressBus.publish,\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    Object.defineProperty(this, observationArtifactAdapterSymbol, {\n      value: {\n        exportRecord: async (observation) => {\n          assert(\n            observation instanceof UIObservationImpl,\n            'Cannot export an observation that was not created by this Midscene runtime',\n          );\n          return observation.exportRecord();\n        },\n        loadRecord: (record) => {\n          // CLI manifests are validated before this adapter is called. Rebuild\n          // once here as a final runtime-boundary check before creating insight.\n          uiContextFromObservationRecord(record);\n          return new UIObservationImpl(\n            record,\n            this.createInsight(() => uiContextFromObservationRecord(record)),\n          );\n        },\n      } satisfies ObservationArtifactAdapter,\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   * Start observing the screen in the background and return a fixed insight\n   * surface when the observation is stopped:\n   *\n   * ```ts\n   * const observer = await agent.startObserving();\n   * await agent.aiAct('submit the form');\n   * const observation = await observer.stop();\n   * await observation.aiAssert('a success toast appeared during the process');\n   * ```\n   *\n   * Frames come from the device's continuous frame source when available\n   * (scrcpy on Android, WDA MJPEG on iOS — both opt-in; CDP screencast on\n   * web) and fall back to plain screenshots otherwise. Sampling is capped at\n   * 5fps, the buffer is bounded and self-thinning, decoding is deferred to\n   * the end, and all buffered frames (up to `maxFrames`) are sent to\n   * the model at insight time. To control token cost for long windows,\n   * increase `intervalMs` or decrease `maxFrames`.\n   * Awaiting `startObserving()` guarantees one baseline frame is captured\n   * before your next action.\n   */\n  async startObserving(opt?: UIObserverOption): Promise<UIObserver> {\n    // A frozen context pins perception to a single snapshot; observing a\n    // window of frames contradicts that. Fail fast instead of silently\n    // producing an all-identical sequence.\n    assert(\n      !this.frozenUIContext,\n      'startObserving() cannot be used while the UI context is frozen (call unfreezePageContext() first)',\n    );\n    // Frame sources are device-level singletons — two concurrent observers\n    // would conflict (scrcpy stream, WDA MJPEG port, CDP screencast).\n    assert(\n      !this.activeObserver,\n      'An observation window is already active on this agent. ' +\n        'Stop the existing observer first (await observer.stop()) before starting a new one.',\n    );\n    const observer = new UIObserverImpl(\n      {\n        openFrameSource: async () =>\n          (await this.interface.openFrameSource?.()) ?? undefined,\n        // Fallback single-frame capture. Deliberately bypasses getUIContext so\n        // the observation loop never pollutes the TaskRunner context cache.\n        screenshot: () => this.interface.screenshotBase64(),\n        captureRepresentative: () => this.getUIContext('assert'),\n        createInsight: (record) =>\n          this.createInsight(() => uiContextFromObservationRecord(record)),\n        onStopped: () => {\n          if (this.activeObserver === observer) {\n            this.activeObserver = null;\n          }\n        },\n        onDisposed: () => this.ownedObservers.delete(observer),\n        screenshotShrinkFactor: this.opts.screenshotShrinkFactor,\n      },\n      opt,\n    );\n    // Mark as active BEFORE the async start() so concurrent calls hit the\n    // assert guard above. If start() throws, clear the reference below.\n    this.activeObserver = observer;\n    this.ownedObservers.add(observer);\n    try {\n      await observer.start();\n    } catch (error) {\n      this.activeObserver = null;\n      this.ownedObservers.delete(observer);\n      await observer.dispose().catch((disposeError) => {\n        debug(`error disposing failed observer start: ${disposeError}`);\n      });\n      throw error;\n    }\n    return observer;\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  /**\n   * Fold any not-yet-counted task usage from an execution dump into the\n   * instance metrics. Snapshots are re-emitted as tasks progress, so each\n   * usage value is keyed by `${taskId}:${field}` and counted at most once.\n   */\n  private collectUsageMetrics(execution: ExecutionDump) {\n    for (const task of execution.tasks) {\n      this.consumeUsage(task.usage, `${task.taskId}:usage`);\n      this.consumeUsage(task.searchAreaUsage, `${task.taskId}:searchAreaUsage`);\n    }\n  }\n\n  private consumeUsage(usage: AIUsageInfo | undefined, key: string) {\n    if (!usage) {\n      return;\n    }\n    // Dedup key priority:\n    // 1. request_id — provider-issued, stable across onUsage and task dump paths\n    // 2. INTERNAL_CALL_ID_FIELD — callAI-generated internal id, covers\n    //    providers that don't return a request_id\n    // 3. caller-provided key (taskId:field or callai:counter)\n    let dedupKey: string;\n    if (usage.request_id) {\n      dedupKey = `req:${usage.request_id}`;\n    } else if ((usage as any)[INTERNAL_CALL_ID_FIELD]) {\n      dedupKey = `int:${(usage as any)[INTERNAL_CALL_ID_FIELD]}`;\n    } else {\n      dedupKey = key;\n    }\n    if (this.countedUsageKeys.has(dedupKey)) {\n      return;\n    }\n    this.countedUsageKeys.add(dedupKey);\n    this.metricsCollector.add(usage);\n    if (this.opts.onLLMUsage) {\n      try {\n        this.opts.onLLMUsage(usage);\n      } catch (error) {\n        warn(`onLLMUsage listener threw, ignoring: ${error}`);\n      }\n    }\n  }\n\n  /**\n   * Aggregated LLM usage accumulated by this agent since it was created.\n   */\n  get metrics(): MidsceneUsageMetrics {\n    return this.metricsCollector.snapshot();\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    // Short-circuit at the call site because JavaScript evaluates function\n    // arguments first. This avoids serializing the dump (including inline\n    // screenshots) when the Report Viewer build does not need report HTML.\n    if (IS_REPORT_BUILD) {\n      return '';\n    }\n\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: AgentInputOption & { value: string | number },\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?: AgentInputOption,\n  ): Promise<void>;\n\n  // Implementation\n  async aiInput(\n    locatePromptOrValue: TUserPrompt | string | number,\n    locatePromptOrOpt:\n      | TUserPrompt\n      | (AgentInputOption & { value: string | number })\n      | undefined,\n    optOrUndefined?: AgentInputOption,\n  ) {\n    let value: string | number;\n    let locatePrompt: TUserPrompt;\n    let opt: (AgentInputOption & { value: string | number }) | 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 AgentInputOption & {\n        value: string | number;\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 { locateParam, restParams } = buildDetailedLocateParamAndRestParams(\n      locatePrompt,\n      opt,\n    );\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      ...restParams,\n      value: stringValue,\n      locate: locateParam,\n      mode,\n    });\n  }\n\n  // New signature\n  async aiKeyboardPress(\n    locatePrompt: TUserPrompt | undefined,\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 | undefined,\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 { locateParam, restParams } = buildDetailedLocateParamAndRestParams(\n      locatePrompt || '',\n      opt,\n    );\n\n    await this.callActionInActionSpace('KeyboardPress', {\n      ...restParams,\n      locate: locateParam,\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,\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 { locateParam, restParams } = buildDetailedLocateParamAndRestParams(\n      locatePrompt || '',\n      opt,\n    );\n\n    await this.callActionInActionSpace('Scroll', {\n      ...restParams,\n      locate: locateParam,\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 { locateParam, restParams } = buildDetailedLocateParamAndRestParams(\n      locatePrompt || '',\n      opt,\n    );\n\n    await this.callActionInActionSpace('Pinch', {\n      ...restParams,\n      locate: locateParam,\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 { locateParam, restParams } = buildDetailedLocateParamAndRestParams(\n      locatePrompt,\n      opt,\n    );\n\n    await this.callActionInActionSpace('LongPress', {\n      ...restParams,\n      locate: locateParam,\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 internalReportDisplay = (opt as AiActInternalOptions | undefined)\n      ?._internalReportDisplay;\n    const taskPromptText =\n      typeof taskPrompt === 'string' ? taskPrompt : taskPrompt.prompt;\n    const reportPrompt = internalReportDisplay?.prompt || taskPromptText;\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      const aiActContext =\n        opt?.context !== undefined ? opt.context : this.aiActContext;\n      const cachePrompt = buildPromptWithContext(taskPrompt, aiActContext);\n      // Resolve the public planning controls at the API boundary. Internal\n      // aiAct plumbing only uses effort from this point onward. The explicit\n      // effort option takes precedence over deepThink when both are provided.\n      const effort: AiActEffort = (() => {\n        const resolvedEffort =\n          opt?.effort ?? (opt?.deepThink === true ? 'deepThink' : 'balance');\n\n        if (opt?.effort !== undefined) {\n          warn(\n            'The \"effort\" option is experimental and not yet open for public use. Do not use it. When both \"effort\" and \"deepThink\" are provided, \"effort\" takes precedence.',\n          );\n        }\n\n        if (\n          resolvedEffort === 'fast' &&\n          planningModel.adapter.planning.kind === 'custom'\n        ) {\n          throw new Error(\n            `The \"fast\" aiAct effort is not supported with custom planning adapters (modelFamily: ${planningModel.config.modelFamily ?? 'unknown'}).`,\n          );\n        }\n\n        if (\n          resolvedEffort === 'deepThink' &&\n          planningModel.adapter.planning.kind === 'custom'\n        ) {\n          warn(\n            `The \"deepThink\" aiAct effort is not supported with custom planning adapters (modelFamily: ${planningModel.config.modelFamily ?? 'unknown'}). It will be ignored.`,\n          );\n          return 'balance';\n        }\n\n        return resolvedEffort;\n      })();\n\n      let deepLocate = opt?.deepLocate;\n      if (\n        deepLocate &&\n        !planningModel.adapter.planning.supportsActionDeepLocate\n      ) {\n        warn(\n          `The \"deepLocate\" option is not supported for aiAct with the current planning adapter (modelFamily: ${planningModel.config.modelFamily ?? 'unknown'}). It will be ignored.`,\n        );\n        deepLocate = false;\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(cachePrompt);\n      let cachedYamlFailed = false;\n      if (\n        matchedCache?.cacheUsable &&\n        this.taskCache?.isCacheResultUsed &&\n        matchedCache.cacheContent?.yamlWorkflow?.trim()\n      ) {\n        const yaml = matchedCache.cacheContent.yamlWorkflow;\n        try {\n          // log into report file\n          await this.taskExecutor.loadYamlFlowAsPlanning(\n            taskPrompt,\n            yaml,\n            internalReportDisplay,\n          );\n\n          debug('matched cache, will call .runYaml to run the action');\n          await this.runYaml(yaml);\n          return;\n        } catch (error) {\n          cachedYamlFailed = true;\n          warn(\n            `cached aiAct plan failed, will replan and disable the stale cache: ${\n              error instanceof Error ? error.message : String(error)\n            }`,\n          );\n        }\n      }\n\n      // If cache matched but is not executable, fall through to normal execution\n      const { output: actionOutput } = await this.taskExecutor.action(\n        taskPrompt,\n        planningModel,\n        defaultModel,\n        aiActContext,\n        cacheable,\n        replanningCycleLimit,\n        effort,\n        undefined,\n        deepLocate,\n        abortSignal,\n        internalReportDisplay,\n      );\n\n      // update cache\n      if (this.taskCache && cacheable !== false) {\n        const yamlFlow = cachedYamlFailed ? [] : actionOutput?.yamlFlow;\n\n        if (!cachedYamlFailed && !yamlFlow?.length) {\n          return actionOutput?.output;\n        }\n\n        const yamlFlowToCache = yamlFlow ?? [];\n        const yamlContent: MidsceneYamlScript = {\n          tasks: [\n            {\n              name: reportPrompt,\n              flow: yamlFlowToCache,\n            },\n          ],\n        };\n        const yamlFlowStr = yaml.dump(yamlContent);\n        this.taskCache.updateOrAppendCacheRecord(\n          {\n            type: 'plan',\n            prompt: cachePrompt,\n            yamlWorkflow: yamlFlowStr,\n          },\n          matchedCache,\n        );\n      }\n\n      return actionOutput?.output;\n    };\n\n    const fileChooserAccepter = this.interface.registerFileChooserListener\n      ? new FileChooserAccepter(this.interface)\n      : undefined;\n    this.activeFileChooserAccepter = fileChooserAccepter;\n    this.activeFileChooserAllowedDir = opt?.fileChooserAllowedDir\n      ? resolve(opt.fileChooserAllowedDir)\n      : undefined;\n    let aiActError: { error: unknown } | undefined;\n    let fileChooserHandlingError: Error | undefined;\n    let result: string | undefined;\n    try {\n      if (fileChooserAccept?.length) {\n        if (!fileChooserAccepter) {\n          throw new Error(\n            `File upload is not supported on ${this.interface.interfaceType}`,\n          );\n        }\n        await fileChooserAccepter.register(fileChooserAccept);\n      }\n      result = await runAiAct();\n    } catch (error) {\n      aiActError = { error };\n    } finally {\n      this.activeFileChooserAccepter = undefined;\n      this.activeFileChooserAllowedDir = undefined;\n      try {\n        fileChooserHandlingError = await fileChooserAccepter?.clear();\n      } catch (error) {\n        warn(`Failed to clear file chooser registration: ${error}`);\n      }\n    }\n\n    if (aiActError) {\n      throw aiActError.error;\n    }\n    if (fileChooserHandlingError) {\n      throw fileChooserHandlingError;\n    }\n    return result;\n  }\n\n  async runMarkdown(\n    markdownPath: string,\n    opt?: AiActOptions,\n  ): Promise<string | undefined> {\n    const markdown = await readFile(markdownPath, 'utf-8');\n    const { prompt } = await markdownToAiActPrompt(markdown, markdownPath);\n    return this.aiAct(prompt, {\n      ...opt,\n      _internalReportDisplay: {\n        type: 'Markdown',\n        prompt: basename(markdownPath),\n      },\n    } as AiActOptions);\n  }\n\n  async runGherkinScenario(\n    scenarioText: string,\n    opt?: RunGherkinScenarioOptions,\n  ): Promise<void> {\n    return runGherkinScenario(this, scenarioText, opt);\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?: QueryOptions,\n  ): Promise<ReturnType> {\n    return this.createInsight().aiQuery<ReturnType>(demand, opt);\n  }\n\n  async aiBoolean(prompt: TUserPrompt, opt?: QueryOptions): Promise<boolean> {\n    return this.createInsight().aiBoolean(prompt, opt);\n  }\n\n  async aiNumber(prompt: TUserPrompt, opt?: QueryOptions): Promise<number> {\n    return this.createInsight().aiNumber(prompt, opt);\n  }\n\n  async aiString(prompt: TUserPrompt, opt?: QueryOptions): Promise<string> {\n    return this.createInsight().aiString(prompt, opt);\n  }\n\n  async aiAsk(prompt: TUserPrompt, opt?: QueryOptions): Promise<string> {\n    return this.createInsight().aiAsk(prompt, opt);\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      opt?.uiContext ? { uiContext: opt.uiContext } : undefined,\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' | 'dpr'>;\n  }\n\n  async aiAssert(\n    assertion: TUserPrompt,\n    msg?: string,\n    opt?: AssertOptions,\n  ): Promise<AgentAssertResult | undefined> {\n    return this.createInsight().aiAssert(assertion, msg, opt);\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  /**\n   * Subscribe to the generic agent progress bus. The listener receives every\n   * progress event regardless of producer; narrow by `event.scope` to handle a\n   * specific producer (e.g. `'aiAct'`).\n   * @param listener Listener function\n   * @returns A remove function that can be called to remove this listener\n   */\n  addProgressListener(listener: AgentProgressListener): () => void {\n    return this.progressBus.subscribe(listener);\n  }\n\n  /**\n   * Remove a progress listener added via {@link addProgressListener}.\n   */\n  removeProgressListener(listener: AgentProgressListener): void {\n    this.progressBus.unsubscribe(listener);\n  }\n\n  /**\n   * Clear all generic progress listeners.\n   */\n  clearProgressListeners(): void {\n    this.progressBus.clear();\n  }\n\n  private notifyDumpUpdateListeners(executionDump?: ExecutionDump) {\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  async destroy() {\n    // Early return if already destroyed\n    if (this.destroyed) {\n      return;\n    }\n\n    this.destroyed = true;\n\n    // Observers own observation frame files until explicitly disposed.\n    for (const observer of this.ownedObservers) {\n      try {\n        await observer.dispose();\n      } catch (error) {\n        debug(`error disposing unexported observer during destroy: ${error}`);\n      }\n    }\n    this.ownedObservers.clear();\n    this.activeObserver = null;\n\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(title?: string, opt?: RecordToReportOptions) {\n    const now = Date.now();\n    const screenshots = opt?.screenshots;\n    const screenshotBase64 = opt?.screenshotBase64;\n    const hasScreenshots = screenshots !== undefined;\n    const hasScreenshotBase64 = screenshotBase64 !== undefined;\n    if (hasScreenshots && !Array.isArray(screenshots)) {\n      throw new Error('recordToReport: screenshots must be an array');\n    }\n    if (hasScreenshotBase64 && typeof screenshotBase64 !== 'string') {\n      throw new Error('recordToReport: screenshotBase64 must be a string');\n    }\n    if (hasScreenshots && hasScreenshotBase64) {\n      throw new Error(\n        'recordToReport: provide only one of screenshots or screenshotBase64',\n      );\n    }\n    if (opt && 'subType' in opt) {\n      throw new Error('recordToReport: subType is not supported');\n    }\n    const customScreenshots = hasScreenshots ? screenshots : undefined;\n    if (customScreenshots && customScreenshots.length === 0) {\n      throw new Error('recordToReport: screenshots cannot be empty');\n    }\n    const screenshotInputs: RecordToReportScreenshot[] =\n      customScreenshots ??\n      (hasScreenshotBase64\n        ? [{ base64: screenshotBase64 }]\n        : [{ base64: await this.interface.screenshotBase64() }]);\n\n    // 1. build recorder\n    const recorder: ExecutionRecorderItem[] = screenshotInputs.map(\n      (screenshotInput, index) => {\n        const normalizedScreenshotInput = normalizeRecordToReportScreenshot(\n          screenshotInput,\n          index,\n        );\n        const ts = now + index;\n        return {\n          type: 'screenshot',\n          ts,\n          screenshot: ScreenshotItem.create(\n            normalizedScreenshotInput.base64,\n            ts,\n          ),\n          description: normalizedScreenshotInput.description,\n        };\n      },\n    );\n    // 2. 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    // 3. 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    // 4. 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    this.notifyDumpUpdateListeners(executionDump);\n  }\n\n  async recordErrorToReport(\n    title: string,\n    opt: {\n      error: Error;\n      content?: string;\n      screenshotBase64?: string;\n    },\n  ) {\n    const now = Date.now();\n    const recorder: ExecutionRecorderItem[] = [];\n    const base64 =\n      opt.screenshotBase64 ?? (await this.interface.screenshotBase64());\n    if (base64) {\n      recorder.push({\n        type: 'screenshot',\n        ts: now,\n        screenshot: ScreenshotItem.create(base64, now),\n      });\n    }\n\n    const task: ExecutionTaskLog = {\n      taskId: uuid(),\n      type: 'Log',\n      subType: 'Error',\n      status: 'failed',\n      recorder,\n      timing: {\n        start: now,\n        end: now,\n        cost: 0,\n      },\n      param: {\n        content: opt.content || '',\n      },\n      error: opt.error,\n      errorMessage: opt.error.message,\n      errorStack: opt.error.stack,\n      executor: async () => {},\n    };\n\n    const executionDump = new ExecutionDump({\n      id: uuid(),\n      logTime: now,\n      name: title,\n      description: opt.content || opt.error.message,\n      tasks: [task],\n    });\n\n    this.appendExecutionDump(executionDump);\n    this.writeOutActionDumps(executionDump);\n    await this.reportGenerator.flush();\n    this.notifyDumpUpdateListeners(executionDump);\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 normalizeFileInput(files: string | string[]): string[] {\n    const filesArray = Array.isArray(files) ? files : [files];\n    return 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","warn","Agent","callback","planningModel","globalConfigManager","MIDSCENE_REPLANNING_CYCLE_LIMIT","intent","runtime","getModelRuntime","usage","enriched","getUIContext","Insight","_error","action","maxRetries","attempt","commonContextParser","error","Promise","resolve","setTimeout","opt","assert","observer","UIObserverImpl","undefined","record","uiContextFromObservationRecord","disposeError","prompt","console","ReportActionDump","getVersion","WeakMap","execution","runner","currentDump","existingIndex","task","key","dedupKey","INTERNAL_CALL_ID_FIELD","ifInBrowser","IS_REPORT_BUILD","reportHTMLContent","executionDump","exec","param","paramStr","tip","typeStr","name","type","actionPlan","plans","Boolean","title","taskTitleStr","locateParamStr","defaultModel","output","locatePrompt","detailedLocateParam","buildDetailedLocateParam","fileChooserAccept","withFileChooser","locatePromptOrValue","locatePromptOrOpt","optOrUndefined","value","optWithValue","locateParam","restParams","buildDetailedLocateParamAndRestParams","stringValue","String","mode","locatePromptOrKeyName","keyName","locatePromptOrScrollParam","scrollParam","isLocatePromptLike","normalizedScrollType","normalizeScrollType","taskPrompt","internalReportDisplay","taskPromptText","reportPrompt","abortSignal","Error","runAiAct","aiActContext","cachePrompt","buildPromptWithContext","effort","resolvedEffort","deepLocate","cacheable","replanningCycleLimit","planCacheEnabled","matchedCache","cachedYamlFailed","yaml","actionOutput","yamlFlow","yamlFlowToCache","yamlContent","yamlFlowStr","fileChooserAccepter","FileChooserAccepter","aiActError","fileChooserHandlingError","result","markdownPath","markdown","readFile","markdownToAiActPrompt","basename","scenarioText","runGherkinScenario","demand","locatePlan","locatePlanForLocate","element","assertion","msg","modelRuntime","args","yamlScriptContent","script","parseYamlScript","player","ScriptPlayer","errors","listener","index","dumpString","interfaceDestroyError","finalPath","now","Date","screenshots","screenshotBase64","hasScreenshots","hasScreenshotBase64","Array","customScreenshots","screenshotInputs","recorder","screenshotInput","normalizedScreenshotInput","normalizeRecordToReportScreenshot","ts","ScreenshotItem","uuid","ExecutionDump","base64","groupName","groupDescription","executions","context","opts","validateAgentCacheInput","cacheConfig","processCacheConfig","id","strategyValue","isReadOnly","isWriteOnly","files","filesArray","normalizeFilePaths","options","interfaceInstance","MetricsCollector","Set","AgentProgressBus","Object","assertReportGenerationOptions","resolvedAiActContext","hasCustomConfig","ModelConfigManager","globalModelConfigManager","Service","cacheConfigObj","TaskCache","baseActionSpace","fileChooserActions","defineActionRegisterFileChooserAccept","defineActionSleep","TaskExecutor","getReportFileName","ReportGenerator","observationArtifactAdapterSymbol","observation","UIObservationImpl","createAgent"],"mappings":"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"}

package/dist/es/agent/tasks.mjs

@@ -142,8 +142,8 @@ class TaskExecutor {
             runner
         };
     }
-    async action(userPrompt, planningModel, defaultModel, includeLocateInPlanning, aiActContext, cacheable, replanningCycleLimitOverride, imagesIncludeCount, deepThink, fileChooserAccept, deepLocate, abortSignal, reportOptions) {
-        return withFileChooser(this.interface, fileChooserAccept, async ()=>this.runAction(userPrompt, planningModel, defaultModel, includeLocateInPlanning, aiActContext, cacheable, replanningCycleLimitOverride, imagesIncludeCount, deepThink, deepLocate, abortSignal, reportOptions));
+    async action(userPrompt, planningModel, defaultModel, aiActContext, cacheable, replanningCycleLimitOverride, effort = 'balance', fileChooserAccept, deepLocate, abortSignal, reportOptions) {
+        return withFileChooser(this.interface, fileChooserAccept, async ()=>this.runAction(userPrompt, planningModel, defaultModel, aiActContext, cacheable, replanningCycleLimitOverride, effort, deepLocate, abortSignal, reportOptions));
     }
     invalidateFailedCacheHitLocates(runner, fromIndex) {
         if (!this.taskCache) return;
@@ -155,7 +155,7 @@ class TaskExecutor {
             }
         }
     }
-    async runAction(userPrompt, planningModel, defaultModel, includeLocateInPlanning, aiActContext, cacheable, replanningCycleLimitOverride, imagesIncludeCount, deepThink, deepLocate, abortSignal, reportOptions) {
+    async runAction(userPrompt, planningModel, defaultModel, aiActContext, cacheable, replanningCycleLimitOverride, effort = 'balance', deepLocate, abortSignal, reportOptions) {
         const conversationHistory = new ConversationHistory();
         const promptDisplay = reportOptions?.prompt || userPromptToString(userPrompt);
         let activeActionReporter;
@@ -173,6 +173,13 @@ class TaskExecutor {
             ...defaultModel,
             executionId: runner.id
         };
+        const noIndividualLocateModel = 'default' === planningModel.config.slot;
+        const includeLocateInPlanning = 'deepThink' !== effort && noIndividualLocateModel;
+        const imagesIncludeCount = 'deepThink' === effort ? 2 : 1;
+        debug('setting includeLocateInPlanning to', includeLocateInPlanning, {
+            effort,
+            noIndividualLocateModel
+        });
         let replanCount = 0;
         const yamlFlow = [];
         const replanningCycleLimit = replanningCycleLimitOverride ?? this.replanningCycleLimit;
@@ -214,7 +221,7 @@ class TaskExecutor {
                     replanningCycleLimit,
                     aiActContext,
                     imagesIncludeCount,
-                    deepThink,
+                    effort,
                     ...subGoalStatus ? {
                         subGoalStatus
                     } : {},
@@ -225,6 +232,7 @@ class TaskExecutor {
                 executor: async (param, executorContext)=>{
                     const { uiContext } = executorContext;
                     assert(uiContext, 'uiContext is required for Planning task');
+                    assert(param.effort, 'effort is required for Planning Plan task');
                     const planningUiContext = uiContext;
                     const timing = executorContext.task.timing;
                     await this.emitAiActProgress('plan_thinking', {
@@ -247,8 +255,8 @@ class TaskExecutor {
                             modelRuntime: planningModel,
                             conversationHistory,
                             includeLocateInPlanning,
-                            imagesIncludeCount,
-                            deepThink,
+                            imagesIncludeCount: param.imagesIncludeCount,
+                            effort: param.effort,
                             referenceImageMessages,
                             abortSignal
                         });