npm - @midscene/core - Versions diffs - 1.12.5-beta-20260908034641.0 → 1.12.5 - Mend

@midscene/core 1.12.5-beta-20260908034641.0 → 1.12.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (165) hide show

package/dist/es/agent/agent.mjs CHANGED Viewed

@@ -558,7 +558,12 @@ class Agent {
         } : void 0);
         const { element } = output;
         return {
-            rect: element?.rect,
+            rect: element ? element.rect ?? {
+                left: Math.max(element.center[0] - 3.5, 0),
+                top: Math.max(element.center[1] - 3.5, 0),
+                width: 8,
+                height: 8
+            } : void 0,
             center: element?.center,
             dpr: element?.dpr
         };

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

	@@ -1 +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 AgentAIContextKey,\n type AgentAIContexts,\n type AgentAssertResult,\n type AgentOpt,\n type AgentProgressListener,\n type AgentWaitForOpt,\n type AiActEffort,\n type AiApiName,\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, InputStrategy } from '@/device';\nimport type { TaskRunner } from '@/task-runner';\nimport { isAgentAIContextKey } from '@midscene/shared/agent-tools/agent-context';\nimport { serializeError } from '@midscene/shared/agent-tools/error-formatter';\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 type AgentTestRunnerNodeDefinition,\n commonAgentTestRunnerNodeDefinitions,\n} from './test-runner-nodes';\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 /*\n Additional facts, rules, constraints, or output requirements for this AI\n * call. It overrides `aiContexts.aiAct` and `aiContexts.default`; `''`\n * disables inherited user context for this call.\n /\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 inputStrategy?: InputStrategy;\n mode?: 'replace' \| 'clear' \| 'typeOnly' \| 'append';\n};\n\nexport class Agent<InterfaceType extends AbstractInterface = AbstractInterface>\n implements InsightAPI\n{\n /* Nodes this Agent class intentionally exposes to Test Runner. /\n static getTestRunnerNodeDefinitions(): readonly AgentTestRunnerNodeDefinition[] {\n return commonAgentTestRunnerNodeDefinitions;\n }\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 aiContexts(): AgentAIContexts {\n if (!this.opts.aiContexts) {\n this.opts.aiContexts = {};\n }\n return this.opts.aiContexts;\n }\n\n private resolveUserContext(\n apiName: AiApiName,\n callContext?: string,\n ): string \| undefined {\n if (callContext !== undefined) {\n return callContext;\n }\n\n const apiContext = this.opts.aiContexts?.[apiName];\n if (apiContext !== undefined) {\n return apiContext;\n }\n\n const defaultContext = this.opts.aiContexts?.default;\n if (defaultContext !== undefined) {\n return defaultContext;\n }\n\n return undefined;\n }\n\n private withContext<T extends { context?: string }>(\n apiName: AiApiName,\n options?: T,\n ): T \| undefined {\n const resolvedContext = this.resolveUserContext(apiName, options?.context);\n if (resolvedContext === undefined) {\n return options;\n }\n\n return {\n ...(options ?? ({} as T)),\n context: resolvedContext,\n };\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 (apiName, callContext) => this.resolveUserContext(apiName, callContext),\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 if (\n this.opts.aiContexts !== undefined &&\n (typeof this.opts.aiContexts !== 'object' \|\|\n this.opts.aiContexts === null \|\|\n Array.isArray(this.opts.aiContexts))\n ) {\n throw new TypeError('opts.aiContexts must be a plain object');\n }\n\n for (const [key, value] of Object.entries(this.opts.aiContexts ?? {})) {\n if (!isAgentAIContextKey(key)) {\n throw new TypeError(`Unknown Agent context key: ${key}`);\n }\n if (value !== undefined && typeof value !== 'string') {\n throw new TypeError(`Agent context \"${key}\" must be a string`);\n }\n }\n\n const deprecatedAiActContextOption =\n this.opts.aiActContext !== undefined\n ? 'aiActContext'\n : this.opts.aiActionContext !== undefined\n ? 'aiActionContext'\n : undefined;\n if (deprecatedAiActContextOption) {\n warn(\n `Agent option \"${deprecatedAiActContextOption}\" is deprecated; use \"aiContexts.aiAct\" instead. When both are provided, \"aiContexts.aiAct\" takes precedence.`,\n );\n }\n\n const normalizedAIContexts: AgentAIContexts = { ...this.opts.aiContexts };\n const resolvedAiActContext =\n normalizedAIContexts.aiAct ??\n this.opts.aiActContext ??\n this.opts.aiActionContext;\n if (resolvedAiActContext !== undefined) {\n normalizedAIContexts.aiAct = resolvedAiActContext;\n this.opts.aiActContext = resolvedAiActContext;\n this.opts.aiActionContext = resolvedAiActContext;\n }\n this.opts.aiContexts = normalizedAIContexts;\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 captureRawScreenshot: () => this.interface.screenshotBase64(),\n capturePreparedRepresentative: () => 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 `setAIContext('aiAct', context)` instead.\n /\n async setAIActionContext(prompt: string) {\n warn(\n 'setAIActionContext() is deprecated; use setAIContext(\"aiAct\", context) instead.',\n );\n this.setAIContext('aiAct', prompt);\n }\n\n /\n @deprecated Use `setAIContext('aiAct', context)` instead.\n /\n async setAIActContext(prompt: string) {\n warn(\n 'setAIActContext() is deprecated; use setAIContext(\"aiAct\", context) instead.',\n );\n this.setAIContext('aiAct', prompt);\n }\n\n /\n Set Agent-level AI guidance. Use `default` as the shared fallback for all\n * AI-powered APIs, or an API name to override that fallback for the API.\n * API-specific values are not automatically merged with `default`.\n * Passing `undefined` removes the selected value; an API then falls back to\n * `default`, while removing `default` disables the shared fallback. Passing\n * `''` keeps an explicit empty value and therefore prevents an API from using\n * `default`.\n /\n setAIContext(target: AgentAIContextKey, context: string \| undefined): void {\n if (!isAgentAIContextKey(target)) {\n throw new TypeError(`Unknown Agent context key: ${String(target)}`);\n }\n if (context !== undefined && typeof context !== 'string') {\n throw new TypeError('Agent context must be a string or undefined');\n }\n\n this.aiContexts[target] = context;\n\n if (target === 'aiAct') {\n if (context === undefined) {\n this.opts.aiActContext = undefined;\n this.opts.aiActionContext = undefined;\n } else {\n this.opts.aiActContext = context;\n this.opts.aiActionContext = context;\n }\n }\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(\n locatePrompt,\n this.withContext('aiTap', opt),\n );\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(\n locatePrompt,\n this.withContext('aiRightClick', opt),\n );\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(\n locatePrompt,\n this.withContext('aiDoubleClick', opt),\n );\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(\n locatePrompt,\n this.withContext('aiHover', opt),\n );\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 this.withContext('aiInput', 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 this.withContext('aiKeyboardPress', 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 this.withContext('aiScroll', 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 this.withContext('aiPinch', 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 this.withContext('aiLongPress', 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(\n locatePrompt,\n this.withContext('aiClearInput', opt),\n );\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 internalOptions = opt as AiActInternalOptions \| undefined;\n const internalReportDisplay = internalOptions?._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 = this.resolveUserContext('aiAct', opt?.context);\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(\n prompt,\n this.withContext('aiLocate', opt),\n );\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 const options = this.withContext('aiWaitFor', opt);\n await this.taskExecutor.waitFor(\n assertion,\n {\n ...options,\n timeoutMs: options?.timeoutMs \|\| 15 1000,\n checkIntervalMs: options?.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 /* Any thrown value; normalized before it is stored in the report. /\n error: unknown;\n content?: string;\n screenshotBase64?: string;\n },\n ) {\n const now = Date.now();\n const error = serializeError(opt.error);\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,\n errorMessage: error.message,\n errorStack: 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 \|\| 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","commonAgentTestRunnerNodeDefinitions","callback","apiName","callContext","undefined","apiContext","defaultContext","options","resolvedContext","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","record","uiContextFromObservationRecord","disposeError","prompt","target","context","isAgentAIContextKey","TypeError","String","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","mode","locatePromptOrKeyName","keyName","locatePromptOrScrollParam","scrollParam","isLocatePromptLike","normalizedScrollType","normalizeScrollType","taskPrompt","internalOptions","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","console","interfaceDestroyError","finalPath","now","Date","screenshots","screenshotBase64","hasScreenshots","hasScreenshotBase64","Array","customScreenshots","screenshotInputs","recorder","screenshotInput","normalizedScreenshotInput","normalizeRecordToReportScreenshot","ts","ScreenshotItem","uuid","ExecutionDump","serializeError","base64","groupName","groupDescription","executions","opts","validateAgentCacheInput","cacheConfig","processCacheConfig","id","strategyValue","isReadOnly","isWriteOnly","files","filesArray","normalizeFilePaths","interfaceInstance","MetricsCollector","Set","AgentProgressBus","Object","assertReportGenerationOptions","deprecatedAiActContextOption","normalizedAIContexts","resolvedAiActContext","hasCustomConfig","ModelConfigManager","globalModelConfigManager","Service","cacheConfigObj","TaskCache","baseActionSpace","fileChooserActions","defineActionRegisterFileChooserAccept","defineActionSleep","TaskExecutor","getReportFileName","ReportGenerator","observationArtifactAdapterSymbol","observation","UIObservationImpl","createAgent"],"mappings":"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"}
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 AgentAIContextKey,\n type AgentAIContexts,\n type AgentAssertResult,\n type AgentOpt,\n type AgentProgressListener,\n type AgentWaitForOpt,\n type AiActEffort,\n type AiApiName,\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 type Rect,\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, InputStrategy } from '@/device';\nimport type { TaskRunner } from '@/task-runner';\nimport { isAgentAIContextKey } from '@midscene/shared/agent-tools/agent-context';\nimport { serializeError } from '@midscene/shared/agent-tools/error-formatter';\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 type AgentTestRunnerNodeDefinition,\n commonAgentTestRunnerNodeDefinitions,\n} from './test-runner-nodes';\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 /*\n Additional facts, rules, constraints, or output requirements for this AI\n * call. It overrides `aiContexts.aiAct` and `aiContexts.default`; `''`\n * disables inherited user context for this call.\n /\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 inputStrategy?: InputStrategy;\n mode?: 'replace' \| 'clear' \| 'typeOnly' \| 'append';\n};\n\nexport class Agent<InterfaceType extends AbstractInterface = AbstractInterface>\n implements InsightAPI\n{\n /* Nodes this Agent class intentionally exposes to Test Runner. /\n static getTestRunnerNodeDefinitions(): readonly AgentTestRunnerNodeDefinition[] {\n return commonAgentTestRunnerNodeDefinitions;\n }\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 aiContexts(): AgentAIContexts {\n if (!this.opts.aiContexts) {\n this.opts.aiContexts = {};\n }\n return this.opts.aiContexts;\n }\n\n private resolveUserContext(\n apiName: AiApiName,\n callContext?: string,\n ): string \| undefined {\n if (callContext !== undefined) {\n return callContext;\n }\n\n const apiContext = this.opts.aiContexts?.[apiName];\n if (apiContext !== undefined) {\n return apiContext;\n }\n\n const defaultContext = this.opts.aiContexts?.default;\n if (defaultContext !== undefined) {\n return defaultContext;\n }\n\n return undefined;\n }\n\n private withContext<T extends { context?: string }>(\n apiName: AiApiName,\n options?: T,\n ): T \| undefined {\n const resolvedContext = this.resolveUserContext(apiName, options?.context);\n if (resolvedContext === undefined) {\n return options;\n }\n\n return {\n ...(options ?? ({} as T)),\n context: resolvedContext,\n };\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 (apiName, callContext) => this.resolveUserContext(apiName, callContext),\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 if (\n this.opts.aiContexts !== undefined &&\n (typeof this.opts.aiContexts !== 'object' \|\|\n this.opts.aiContexts === null \|\|\n Array.isArray(this.opts.aiContexts))\n ) {\n throw new TypeError('opts.aiContexts must be a plain object');\n }\n\n for (const [key, value] of Object.entries(this.opts.aiContexts ?? {})) {\n if (!isAgentAIContextKey(key)) {\n throw new TypeError(`Unknown Agent context key: ${key}`);\n }\n if (value !== undefined && typeof value !== 'string') {\n throw new TypeError(`Agent context \"${key}\" must be a string`);\n }\n }\n\n const deprecatedAiActContextOption =\n this.opts.aiActContext !== undefined\n ? 'aiActContext'\n : this.opts.aiActionContext !== undefined\n ? 'aiActionContext'\n : undefined;\n if (deprecatedAiActContextOption) {\n warn(\n `Agent option \"${deprecatedAiActContextOption}\" is deprecated; use \"aiContexts.aiAct\" instead. When both are provided, \"aiContexts.aiAct\" takes precedence.`,\n );\n }\n\n const normalizedAIContexts: AgentAIContexts = { ...this.opts.aiContexts };\n const resolvedAiActContext =\n normalizedAIContexts.aiAct ??\n this.opts.aiActContext ??\n this.opts.aiActionContext;\n if (resolvedAiActContext !== undefined) {\n normalizedAIContexts.aiAct = resolvedAiActContext;\n this.opts.aiActContext = resolvedAiActContext;\n this.opts.aiActionContext = resolvedAiActContext;\n }\n this.opts.aiContexts = normalizedAIContexts;\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 captureRawScreenshot: () => this.interface.screenshotBase64(),\n capturePreparedRepresentative: () => 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 `setAIContext('aiAct', context)` instead.\n /\n async setAIActionContext(prompt: string) {\n warn(\n 'setAIActionContext() is deprecated; use setAIContext(\"aiAct\", context) instead.',\n );\n this.setAIContext('aiAct', prompt);\n }\n\n /\n @deprecated Use `setAIContext('aiAct', context)` instead.\n /\n async setAIActContext(prompt: string) {\n warn(\n 'setAIActContext() is deprecated; use setAIContext(\"aiAct\", context) instead.',\n );\n this.setAIContext('aiAct', prompt);\n }\n\n /\n Set Agent-level AI guidance. Use `default` as the shared fallback for all\n * AI-powered APIs, or an API name to override that fallback for the API.\n * API-specific values are not automatically merged with `default`.\n * Passing `undefined` removes the selected value; an API then falls back to\n * `default`, while removing `default` disables the shared fallback. Passing\n * `''` keeps an explicit empty value and therefore prevents an API from using\n * `default`.\n /\n setAIContext(target: AgentAIContextKey, context: string \| undefined): void {\n if (!isAgentAIContextKey(target)) {\n throw new TypeError(`Unknown Agent context key: ${String(target)}`);\n }\n if (context !== undefined && typeof context !== 'string') {\n throw new TypeError('Agent context must be a string or undefined');\n }\n\n this.aiContexts[target] = context;\n\n if (target === 'aiAct') {\n if (context === undefined) {\n this.opts.aiActContext = undefined;\n this.opts.aiActionContext = undefined;\n } else {\n this.opts.aiActContext = context;\n this.opts.aiActionContext = context;\n }\n }\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(\n locatePrompt,\n this.withContext('aiTap', opt),\n );\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(\n locatePrompt,\n this.withContext('aiRightClick', opt),\n );\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(\n locatePrompt,\n this.withContext('aiDoubleClick', opt),\n );\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(\n locatePrompt,\n this.withContext('aiHover', opt),\n );\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 this.withContext('aiInput', 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 this.withContext('aiKeyboardPress', 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 this.withContext('aiScroll', 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 this.withContext('aiPinch', 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 this.withContext('aiLongPress', 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(\n locatePrompt,\n this.withContext('aiClearInput', opt),\n );\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 internalOptions = opt as AiActInternalOptions \| undefined;\n const internalReportDisplay = internalOptions?._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 = this.resolveUserContext('aiAct', opt?.context);\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 a target in screenshot coordinates. Preserve the model-provided rect\n * when available; otherwise, generate an approximate 8x8 compatibility box.\n * Do not rely on rect for strict element boundaries. Prefer center for the target.\n /\n async aiLocate(prompt: TUserPrompt, opt?: LocateOption) {\n const locateParam = buildDetailedLocateParam(\n prompt,\n this.withContext('aiLocate', opt),\n );\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\n ? (element.rect ?? {\n left: Math.max(element.center[0] - 3.5, 0),\n top: Math.max(element.center[1] - 3.5, 0),\n width: 8,\n height: 8,\n })\n : undefined,\n center: element?.center,\n dpr: element?.dpr,\n } as Pick<LocateResultElement, 'center' \| 'dpr'> & {\n rect: Rect;\n };\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 const options = this.withContext('aiWaitFor', opt);\n await this.taskExecutor.waitFor(\n assertion,\n {\n ...options,\n timeoutMs: options?.timeoutMs \|\| 15 1000,\n checkIntervalMs: options?.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 /* Any thrown value; normalized before it is stored in the report. /\n error: unknown;\n content?: string;\n screenshotBase64?: string;\n },\n ) {\n const now = Date.now();\n const error = serializeError(opt.error);\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,\n errorMessage: error.message,\n errorStack: 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 \|\| 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","commonAgentTestRunnerNodeDefinitions","callback","apiName","callContext","undefined","apiContext","defaultContext","options","resolvedContext","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","record","uiContextFromObservationRecord","disposeError","prompt","target","context","isAgentAIContextKey","TypeError","String","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","mode","locatePromptOrKeyName","keyName","locatePromptOrScrollParam","scrollParam","isLocatePromptLike","normalizedScrollType","normalizeScrollType","taskPrompt","internalOptions","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","Math","assertion","msg","modelRuntime","args","yamlScriptContent","script","parseYamlScript","player","ScriptPlayer","errors","listener","index","dumpString","console","interfaceDestroyError","finalPath","now","Date","screenshots","screenshotBase64","hasScreenshots","hasScreenshotBase64","Array","customScreenshots","screenshotInputs","recorder","screenshotInput","normalizedScreenshotInput","normalizeRecordToReportScreenshot","ts","ScreenshotItem","uuid","ExecutionDump","serializeError","base64","groupName","groupDescription","executions","opts","validateAgentCacheInput","cacheConfig","processCacheConfig","id","strategyValue","isReadOnly","isWriteOnly","files","filesArray","normalizeFilePaths","interfaceInstance","MetricsCollector","Set","AgentProgressBus","Object","assertReportGenerationOptions","deprecatedAiActContextOption","normalizedAIContexts","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/progress/ai-act-progress.mjs CHANGED Viewed

@@ -52,12 +52,6 @@ function bboxArrayFromProperty(value, key) {
         bottom
     ];
 }
-function centerPointFromBbox(bbox) {
-    return [
-        Math.floor((bbox[0] + bbox[2]) / 2),
-        Math.floor((bbox[1] + bbox[3]) / 2)
-    ];
-}
 function pointFromLocateLike(value) {
     const center = value.center;
     if (Array.isArray(center) && center.length >= 2) {
@@ -68,23 +62,8 @@ function pointFromLocateLike(value) {
             y
         ];
     }
-    const point = value.point;
-    if (Array.isArray(point) && point.length >= 2) {
-        const x = numberFromUnknown(point[0]);
-        const y = numberFromUnknown(point[1]);
-        if (void 0 !== x && void 0 !== y) return [
-            x,
-            y
-        ];
-    }
-    const locatedPixelBbox = bboxArrayFromProperty(value, 'locatedPixelBbox');
-    if (locatedPixelBbox) return centerPointFromBbox(locatedPixelBbox);
-    const bbox = bboxArrayFromProperty(value, 'bbox');
-    if (bbox) return centerPointFromBbox(bbox);
 }
 function bboxFromLocateLike(value) {
-    const locatedPixelBbox = bboxArrayFromProperty(value, 'locatedPixelBbox');
-    if (locatedPixelBbox) return locatedPixelBbox;
     const bbox = bboxArrayFromProperty(value, 'bbox');
     if (bbox) return bbox;
     if (!isRecord(value.rect)) return;
@@ -107,7 +86,7 @@ function targetTextFromLocateLike(value) {
 }
 function isLocateLike(value) {
     if (!isRecord(value)) return false;
-    return 'center' in value || 'rect' in value || 'point' in value || 'bbox' in value || 'prompt' in value || "description" in value;
+    return 'locatedPixelResult' in value || 'center' in value || 'rect' in value || 'point' in value || 'bbox' in value || 'prompt' in value || "description" in value;
 }
 const locatorParamKeys = [
     'locate',
@@ -128,7 +107,7 @@ function hasUnresolvedLocateLikeParam(param) {
     if (!isRecord(param)) return false;
     return Object.entries(param).some(([key, value])=>{
         if (locatorParamKeys.includes(key) && 'string' == typeof value) return true;
-        return isLocateLike(value) && !pointFromLocateLike(value) && !bboxFromLocateLike(value);
+        return isLocateLike(value) && !pointFromLocateLike(value);
     });
 }
 function extractProgressAction(task) {

package/dist/es/agent/progress/ai-act-progress.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"agent/progress/ai-act-progress.mjs","sources":["../../../../src/agent/progress/ai-act-progress.ts"],"sourcesContent":["import type { TaskRunnerEvent } from '@/task-runner';\nimport type {\n AiActProgressAction,\n AiActProgressData,\n AiActProgressPhase,\n ExecutionTask,\n} from '@/types';\n\n/*\n Structured extraction helpers for aiAct progress notifications.\n \n This module turns a raw {@link ExecutionTask} into the structured\n * {@link AiActProgressAction} carried by progress events. It deliberately does\n * NOT build human-readable strings, truncate text for display, or format\n * coordinates into log lines - that is the consumer's job. Everything here is a\n * data transform that yields plain numbers/objects.\n /\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n// Keep params from bloating the progress payload without rendering them: this\n// only bounds the size of the structured value, it never formats it.\nconst maxCompactStringLength = 180;\n\nfunction compactProgressValue(value: unknown): unknown {\n if (value === undefined \|\| value === null) {\n return value;\n }\n\n if (typeof value === 'string') {\n return value.length > maxCompactStringLength\n ? `${value.slice(0, maxCompactStringLength - 3)}...`\n : value;\n }\n\n if (typeof value === 'number' \|\| typeof value === 'boolean') {\n return value;\n }\n\n if (Array.isArray(value)) {\n return value.slice(0, 5).map(compactProgressValue);\n }\n\n if (isRecord(value) && typeof value.prompt === 'string') {\n return compactProgressValue(value.prompt);\n }\n\n if (!isRecord(value)) {\n return String(value);\n }\n\n const entries = Object.entries(value).slice(0, 6);\n return Object.fromEntries(\n entries.map(([key, entryValue]) => [key, compactProgressValue(entryValue)]),\n );\n}\n\nfunction summarizeParam(param: unknown): unknown {\n if (!param \|\| typeof param !== 'object') {\n return compactProgressValue(param);\n }\n\n const record = param as Record<string, unknown>;\n if (typeof record.prompt === 'string') {\n return compactProgressValue(record.prompt);\n }\n if (\n record.locate &&\n typeof record.locate === 'object' &&\n record.locate !== null\n ) {\n const locate = record.locate as Record<string, unknown>;\n return {\n locate: compactProgressValue(locate.prompt),\n ...Object.fromEntries(\n Object.entries(record)\n .filter(([key]) => key !== 'locate')\n .slice(0, 4)\n .map(([key, value]) => [key, compactProgressValue(value)]),\n ),\n };\n }\n\n return compactProgressValue(record);\n}\n\nexport function errorMessageForAiAct(error: unknown): string {\n return error instanceof Error ? error.message : String(error);\n}\n\nfunction numberFromUnknown(value: unknown): number \| undefined {\n return typeof value === 'number' && Number.isFinite(value)\n ? value\n : undefined;\n}\n\nfunction bboxArrayFromProperty(\n value: Record<string, unknown>,\n key: string,\n): [number, number, number, number] \| undefined {\n const bbox = value[key];\n if (!Array.isArray(bbox) \|\| bbox.length < 4) {\n return undefined;\n }\n\n const left = numberFromUnknown(bbox[0]);\n const top = numberFromUnknown(bbox[1]);\n const right = numberFromUnknown(bbox[2]);\n const bottom = numberFromUnknown(bbox[3]);\n if (\n left === undefined \|\|\n top === undefined \|\|\n right === undefined \|\|\n bottom === undefined\n ) {\n return undefined;\n }\n\n return [left, top, right, bottom];\n}\n\nfunction centerPointFromBbox(\n bbox: readonly [number, number, number, number],\n): [number, number] {\n return [\n Math.floor((bbox[0] + bbox[2]) / 2),\n Math.floor((bbox[1] + bbox[3]) / 2),\n ];\n}\n\nfunction pointFromLocateLike(\n value: Record<string, unknown>,\n): [number, number] \| undefined {\n const center = value.center;\n if (Array.isArray(center) && center.length >= 2) {\n const x = numberFromUnknown(center[0]);\n const y = numberFromUnknown(center[1]);\n if (x !== undefined && y !== undefined) {\n return [x, y];\n }\n }\n\n const point = value.point;\n if (Array.isArray(point) && point.length >= 2) {\n const x = numberFromUnknown(point[0]);\n const y = numberFromUnknown(point[1]);\n if (x !== undefined && y !== undefined) {\n return [x, y];\n }\n }\n\n const locatedPixelBbox = bboxArrayFromProperty(value, 'locatedPixelBbox');\n if (locatedPixelBbox) {\n return centerPointFromBbox(locatedPixelBbox);\n }\n\n const bbox = bboxArrayFromProperty(value, 'bbox');\n if (bbox) {\n return centerPointFromBbox(bbox);\n }\n\n return undefined;\n}\n\nfunction bboxFromLocateLike(\n value: Record<string, unknown>,\n): [number, number, number, number] \| undefined {\n const locatedPixelBbox = bboxArrayFromProperty(value, 'locatedPixelBbox');\n if (locatedPixelBbox) {\n return locatedPixelBbox;\n }\n\n const bbox = bboxArrayFromProperty(value, 'bbox');\n if (bbox) {\n return bbox;\n }\n\n if (!isRecord(value.rect)) {\n return undefined;\n }\n\n const left = numberFromUnknown(value.rect.left);\n const top = numberFromUnknown(value.rect.top);\n const width = numberFromUnknown(value.rect.width);\n const height = numberFromUnknown(value.rect.height);\n if (\n left === undefined \|\|\n top === undefined \|\|\n width === undefined \|\|\n height === undefined\n ) {\n return undefined;\n }\n\n return [left, top, left + width, top + height];\n}\n\nfunction targetTextFromLocateLike(value: Record<string, unknown>): string {\n if (typeof value.description === 'string') {\n return value.description;\n }\n if (typeof value.prompt === 'string') {\n return value.prompt;\n }\n return '';\n}\n\nfunction isLocateLike(value: unknown): value is Record<string, unknown> {\n if (!isRecord(value)) {\n return false;\n }\n\n return (\n 'center' in value \|\|\n 'rect' in value \|\|\n 'point' in value \|\|\n 'bbox' in value \|\|\n 'prompt' in value \|\|\n 'description' in value\n );\n}\n\nconst locatorParamKeys = ['locate', 'from', 'to', 'start', 'end'];\n\nfunction firstLocateLikeParam(\n param: unknown,\n): Record<string, unknown> \| undefined {\n if (!isRecord(param)) {\n return undefined;\n }\n\n for (const key of locatorParamKeys) {\n const value = param[key];\n if (isLocateLike(value)) {\n return value;\n }\n }\n\n return Object.values(param).find(isLocateLike);\n}\n\nfunction hasUnresolvedLocateLikeParam(param: unknown): boolean {\n if (!isRecord(param)) {\n return false;\n }\n\n return Object.entries(param).some(([key, value]) => {\n if (locatorParamKeys.includes(key) && typeof value === 'string') {\n return true;\n }\n\n return (\n isLocateLike(value) &&\n !pointFromLocateLike(value) &&\n !bboxFromLocateLike(value)\n );\n });\n}\n\n/\n Extract the structured action descriptor for an Action Space task, or\n * `undefined` when the task is not a reportable action yet (e.g. a locate param\n * that has not been resolved to coordinates). Returns plain data only.\n /\nexport function extractProgressAction(\n task: ExecutionTask,\n): AiActProgressAction \| undefined {\n if (\n task.type !== 'Action Space' \|\|\n task.subType === 'Finished' \|\|\n task.subType === 'Error'\n ) {\n return undefined;\n }\n\n const name =\n typeof task.subType === 'string' && task.subType.length > 0\n ? task.subType\n : 'Action';\n\n const locate = firstLocateLikeParam(task.param);\n if (locate) {\n const point = pointFromLocateLike(locate);\n if (point) {\n const bbox = bboxFromLocateLike(locate);\n const target = targetTextFromLocateLike(locate);\n return {\n name,\n ...(target ? { target } : {}),\n point,\n ...(bbox ? { bbox } : {}),\n };\n }\n }\n\n // A locate-like param that has not resolved to a point/bbox is not reportable\n // yet; skip it so the consumer never renders a half-resolved action.\n if (hasUnresolvedLocateLikeParam(task.param)) {\n return undefined;\n }\n\n const param = summarizeParam(task.param);\n return {\n name,\n ...(param !== undefined && param !== '' ? { param } : {}),\n };\n}\n\nexport type AiActProgressEmit = (\n phase: AiActProgressPhase,\n data: AiActProgressData,\n) => void \| Promise<void>;\n\n/\n Translate the runner's native task-lifecycle events into aiAct action\n * progress for a single planning round.\n \n Returned as a closure so each action batch captures its own plan context\n * instead of the executor threading it through shared mutable state. The\n * mapping is deliberate and one-shot per transition: a `start` (coordinates are\n * resolved by the time an action starts) becomes the \"planned\" + \"running\"\n * pair, and `finish`/`error` become \"done\"/\"failed\".\n */\nexport function createAiActActionReporter(\n planIndex: number,\n planLimit: number,\n emit: AiActProgressEmit,\n): (event: TaskRunnerEvent) => Promise<void> {\n return async (event) => {\n const action = extractProgressAction(event.task);\n if (!action) {\n return;\n }\n\n const base = { planIndex, planLimit, action };\n const durationMs = event.task.timing?.cost;\n\n switch (event.kind) {\n case 'start':\n await emit('plan_action', base);\n await emit('action_running', base);\n break;\n case 'finish':\n await emit('action_done', { ...base, durationMs });\n break;\n case 'error':\n await emit('action_failed', {\n ...base,\n durationMs,\n error: event.task.errorMessage,\n });\n break;\n default:\n break;\n }\n };\n}\n"],"names":["isRecord","value","Array","maxCompactStringLength","compactProgressValue","String","entries","Object","key","entryValue","summarizeParam","param","record","locate","errorMessageForAiAct","error","Error","numberFromUnknown","Number","undefined","bboxArrayFromProperty","bbox","left","top","right","bottom","centerPointFromBbox","Math","pointFromLocateLike","center","x","y","point","locatedPixelBbox","bboxFromLocateLike","width","height","targetTextFromLocateLike","isLocateLike","locatorParamKeys","firstLocateLikeParam","hasUnresolvedLocateLikeParam","extractProgressAction","task","name","target","createAiActActionReporter","planIndex","planLimit","emit","event","action","base","durationMs"],"mappings":"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"}
1	+ {"version":3,"file":"agent/progress/ai-act-progress.mjs","sources":["../../../../src/agent/progress/ai-act-progress.ts"],"sourcesContent":["import type { TaskRunnerEvent } from '@/task-runner';\nimport type {\n AiActProgressAction,\n AiActProgressData,\n AiActProgressPhase,\n ExecutionTask,\n} from '@/types';\n\n/*\n Structured extraction helpers for aiAct progress notifications.\n \n This module turns a raw {@link ExecutionTask} into the structured\n * {@link AiActProgressAction} carried by progress events. It deliberately does\n * NOT build human-readable strings, truncate text for display, or format\n * coordinates into log lines - that is the consumer's job. Everything here is a\n * data transform that yields plain numbers/objects.\n /\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n// Keep params from bloating the progress payload without rendering them: this\n// only bounds the size of the structured value, it never formats it.\nconst maxCompactStringLength = 180;\n\nfunction compactProgressValue(value: unknown): unknown {\n if (value === undefined \|\| value === null) {\n return value;\n }\n\n if (typeof value === 'string') {\n return value.length > maxCompactStringLength\n ? `${value.slice(0, maxCompactStringLength - 3)}...`\n : value;\n }\n\n if (typeof value === 'number' \|\| typeof value === 'boolean') {\n return value;\n }\n\n if (Array.isArray(value)) {\n return value.slice(0, 5).map(compactProgressValue);\n }\n\n if (isRecord(value) && typeof value.prompt === 'string') {\n return compactProgressValue(value.prompt);\n }\n\n if (!isRecord(value)) {\n return String(value);\n }\n\n const entries = Object.entries(value).slice(0, 6);\n return Object.fromEntries(\n entries.map(([key, entryValue]) => [key, compactProgressValue(entryValue)]),\n );\n}\n\nfunction summarizeParam(param: unknown): unknown {\n if (!param \|\| typeof param !== 'object') {\n return compactProgressValue(param);\n }\n\n const record = param as Record<string, unknown>;\n if (typeof record.prompt === 'string') {\n return compactProgressValue(record.prompt);\n }\n if (\n record.locate &&\n typeof record.locate === 'object' &&\n record.locate !== null\n ) {\n const locate = record.locate as Record<string, unknown>;\n return {\n locate: compactProgressValue(locate.prompt),\n ...Object.fromEntries(\n Object.entries(record)\n .filter(([key]) => key !== 'locate')\n .slice(0, 4)\n .map(([key, value]) => [key, compactProgressValue(value)]),\n ),\n };\n }\n\n return compactProgressValue(record);\n}\n\nexport function errorMessageForAiAct(error: unknown): string {\n return error instanceof Error ? error.message : String(error);\n}\n\nfunction numberFromUnknown(value: unknown): number \| undefined {\n return typeof value === 'number' && Number.isFinite(value)\n ? value\n : undefined;\n}\n\nfunction bboxArrayFromProperty(\n value: Record<string, unknown>,\n key: string,\n): [number, number, number, number] \| undefined {\n const bbox = value[key];\n if (!Array.isArray(bbox) \|\| bbox.length < 4) {\n return undefined;\n }\n\n const left = numberFromUnknown(bbox[0]);\n const top = numberFromUnknown(bbox[1]);\n const right = numberFromUnknown(bbox[2]);\n const bottom = numberFromUnknown(bbox[3]);\n if (\n left === undefined \|\|\n top === undefined \|\|\n right === undefined \|\|\n bottom === undefined\n ) {\n return undefined;\n }\n\n return [left, top, right, bottom];\n}\n\n/* Read the resolved screenshot center; never infer it from raw model fields. /\nfunction pointFromLocateLike(\n value: Record<string, unknown>,\n): [number, number] \| undefined {\n const center = value.center;\n if (Array.isArray(center) && center.length >= 2) {\n const x = numberFromUnknown(center[0]);\n const y = numberFromUnknown(center[1]);\n if (x !== undefined && y !== undefined) {\n return [x, y];\n }\n }\n\n return undefined;\n}\n\nfunction bboxFromLocateLike(\n value: Record<string, unknown>,\n): [number, number, number, number] \| undefined {\n const bbox = bboxArrayFromProperty(value, 'bbox');\n if (bbox) {\n return bbox;\n }\n\n if (!isRecord(value.rect)) {\n return undefined;\n }\n\n const left = numberFromUnknown(value.rect.left);\n const top = numberFromUnknown(value.rect.top);\n const width = numberFromUnknown(value.rect.width);\n const height = numberFromUnknown(value.rect.height);\n if (\n left === undefined \|\|\n top === undefined \|\|\n width === undefined \|\|\n height === undefined\n ) {\n return undefined;\n }\n\n return [left, top, left + width, top + height];\n}\n\nfunction targetTextFromLocateLike(value: Record<string, unknown>): string {\n if (typeof value.description === 'string') {\n return value.description;\n }\n if (typeof value.prompt === 'string') {\n return value.prompt;\n }\n return '';\n}\n\nfunction isLocateLike(value: unknown): value is Record<string, unknown> {\n if (!isRecord(value)) {\n return false;\n }\n\n return (\n 'locatedPixelResult' in value \|\|\n 'center' in value \|\|\n 'rect' in value \|\|\n 'point' in value \|\|\n 'bbox' in value \|\|\n 'prompt' in value \|\|\n 'description' in value\n );\n}\n\nconst locatorParamKeys = ['locate', 'from', 'to', 'start', 'end'];\n\nfunction firstLocateLikeParam(\n param: unknown,\n): Record<string, unknown> \| undefined {\n if (!isRecord(param)) {\n return undefined;\n }\n\n for (const key of locatorParamKeys) {\n const value = param[key];\n if (isLocateLike(value)) {\n return value;\n }\n }\n\n return Object.values(param).find(isLocateLike);\n}\n\nfunction hasUnresolvedLocateLikeParam(param: unknown): boolean {\n if (!isRecord(param)) {\n return false;\n }\n\n return Object.entries(param).some(([key, value]) => {\n if (locatorParamKeys.includes(key) && typeof value === 'string') {\n return true;\n }\n\n return isLocateLike(value) && !pointFromLocateLike(value);\n });\n}\n\n/\n Extract the structured action descriptor for an Action Space task, or\n * `undefined` when the task is not a reportable action yet (e.g. a locate param\n * that has not been resolved to coordinates). Returns plain data only.\n /\nexport function extractProgressAction(\n task: ExecutionTask,\n): AiActProgressAction \| undefined {\n if (\n task.type !== 'Action Space' \|\|\n task.subType === 'Finished' \|\|\n task.subType === 'Error'\n ) {\n return undefined;\n }\n\n const name =\n typeof task.subType === 'string' && task.subType.length > 0\n ? task.subType\n : 'Action';\n\n const locate = firstLocateLikeParam(task.param);\n if (locate) {\n const point = pointFromLocateLike(locate);\n if (point) {\n const bbox = bboxFromLocateLike(locate);\n const target = targetTextFromLocateLike(locate);\n return {\n name,\n ...(target ? { target } : {}),\n point,\n ...(bbox ? { bbox } : {}),\n };\n }\n }\n\n // A locate-like param that has not resolved to a center is not reportable\n // yet; skip it so the consumer never renders a half-resolved action.\n if (hasUnresolvedLocateLikeParam(task.param)) {\n return undefined;\n }\n\n const param = summarizeParam(task.param);\n return {\n name,\n ...(param !== undefined && param !== '' ? { param } : {}),\n };\n}\n\nexport type AiActProgressEmit = (\n phase: AiActProgressPhase,\n data: AiActProgressData,\n) => void \| Promise<void>;\n\n/\n Translate the runner's native task-lifecycle events into aiAct action\n * progress for a single planning round.\n \n Returned as a closure so each action batch captures its own plan context\n * instead of the executor threading it through shared mutable state. The\n * mapping is deliberate and one-shot per transition: a `start` (coordinates are\n * resolved by the time an action starts) becomes the \"planned\" + \"running\"\n * pair, and `finish`/`error` become \"done\"/\"failed\".\n */\nexport function createAiActActionReporter(\n planIndex: number,\n planLimit: number,\n emit: AiActProgressEmit,\n): (event: TaskRunnerEvent) => Promise<void> {\n return async (event) => {\n const action = extractProgressAction(event.task);\n if (!action) {\n return;\n }\n\n const base = { planIndex, planLimit, action };\n const durationMs = event.task.timing?.cost;\n\n switch (event.kind) {\n case 'start':\n await emit('plan_action', base);\n await emit('action_running', base);\n break;\n case 'finish':\n await emit('action_done', { ...base, durationMs });\n break;\n case 'error':\n await emit('action_failed', {\n ...base,\n durationMs,\n error: event.task.errorMessage,\n });\n break;\n default:\n break;\n }\n };\n}\n"],"names":["isRecord","value","Array","maxCompactStringLength","compactProgressValue","String","entries","Object","key","entryValue","summarizeParam","param","record","locate","errorMessageForAiAct","error","Error","numberFromUnknown","Number","undefined","bboxArrayFromProperty","bbox","left","top","right","bottom","pointFromLocateLike","center","x","y","bboxFromLocateLike","width","height","targetTextFromLocateLike","isLocateLike","locatorParamKeys","firstLocateLikeParam","hasUnresolvedLocateLikeParam","extractProgressAction","task","name","point","target","createAiActActionReporter","planIndex","planLimit","emit","event","action","base","durationMs"],"mappings":"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"}