@midscene/core 1.15.2-beta-20261012100626.0 → 1.15.2

package/dist/es/device/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"device/index.mjs","sources":["../../../src/device/index.ts"],"sourcesContent":["import type { ModelRuntime } from '@/ai-model/models';\nimport { getMidsceneLocationSchema } from '@/common';\nimport type {\n  ActionScrollParam,\n  DeviceAction,\n  ExecutorContext,\n  LocateResultElement,\n} from '@/types';\nimport type { ElementNode } from '@midscene/shared/extractor';\nimport { getDebug } from '@midscene/shared/logger';\nimport { _keyDefinitions } from '@midscene/shared/us-keyboard-layout';\nimport { z } from 'zod';\nimport type {\n  ElementCacheFeature,\n  Rect,\n  Size,\n  UIContext,\n  UITreeSnapshot,\n} from '../types';\nimport { type InputStrategy, inputStrategies } from './input-strategy';\n\nexport interface FileChooserHandler {\n  accept(files: string[]): Promise<void>;\n}\n\nexport interface FileChooserRegistration {\n  dispose: () => void;\n  getError: () => Error | undefined | Promise<Error | undefined>;\n}\n\nexport interface MjpegStreamFrame {\n  /** Raw base64-encoded image bytes WITHOUT a `data:image/...;base64,` prefix. */\n  data: string;\n  contentType?: string;\n}\n\nexport interface MjpegStreamHandle {\n  stop(): void | Promise<void>;\n}\n\nexport interface MjpegStreamOptions {\n  signal?: AbortSignal;\n  onFrame(frame: MjpegStreamFrame): void;\n  onError?(error: unknown): void;\n}\n\n/**\n * A cheap, not-yet-decoded handle to one screen frame from a\n * {@link DeviceFrameSource}. `ref` is platform-specific (a raw H.264 keyframe\n * buffer on Android, an already-encoded JPEG data URL on iOS/web) and must not\n * be interpreted by callers — pass it back to `decode()` to materialize.\n */\nexport interface DeviceFrameRef {\n  ref: unknown;\n  capturedAt: number;\n}\n\n/**\n * A continuous screen-frame source opened via\n * {@link AbstractInterface.openFrameSource}. Designed for deferred decoding:\n * grabbing `latest()` is near-zero cost, so observers can sample at a steady\n * cadence and pay any decode cost only once, for the frames they keep.\n */\nexport interface DeviceFrameSource {\n  /** Latest frame handle, near-zero cost. Null until the first frame arrives. */\n  latest(): DeviceFrameRef | null;\n  /**\n   * Materialize frame handles into `data:image/...;base64,` URLs, preserving\n   * order. Possibly expensive (e.g. one ffmpeg run per unique frame on\n   * Android) — call once with the sampled handles, never per tick.\n   */\n  decode(refs: DeviceFrameRef[]): Promise<string[]>;\n  /** Release the source (stop streams/subscriptions it started). */\n  stop(): Promise<void> | void;\n}\n\n/** A point in device-pixel coordinates on the screen. */\nexport interface PointerPoint {\n  x: number;\n  y: number;\n}\n\n/** Low-level swipe gesture implemented by touch or pointer-backed devices. */\nexport type SwipeInputPrimitive = (\n  start: PointerPoint,\n  end: PointerPoint,\n  opts?: { duration?: number; repeat?: number },\n) => Promise<void>;\n\n/** The physical input source used to execute and describe a swipe. */\nexport type SwipeInputMode = 'touch' | 'mouse';\n\n/** A resolved swipe capability and the input semantics exposed to the model. */\nexport interface ResolvedSwipeInputPrimitive {\n  swipe: SwipeInputPrimitive;\n  inputMode: SwipeInputMode;\n}\n\nexport interface PointerInputPrimitives {\n  tap(p: PointerPoint, opts?: { duration?: number }): Promise<void>;\n  doubleClick?(p: PointerPoint): Promise<void>;\n  rightClick?(p: PointerPoint): Promise<void>;\n  hover?(p: PointerPoint): Promise<void>;\n  longPress?(p: PointerPoint, opts?: { duration?: number }): Promise<void>;\n  dragAndDrop?(from: PointerPoint, to: PointerPoint): Promise<void>;\n  swipe?: SwipeInputPrimitive;\n}\n\nexport interface TouchInputPrimitives {\n  swipe: SwipeInputPrimitive;\n  pinch?(\n    center: PointerPoint,\n    opts: { startDistance: number; endDistance: number; duration: number },\n  ): Promise<void>;\n}\n\nexport interface KeyboardInputPrimitives {\n  keyboardPress(keyName: string, opts?: { target?: unknown }): Promise<void>;\n  cursorMove?(direction: 'left' | 'right', times?: number): Promise<void>;\n  typeText(\n    value: string,\n    opts?: {\n      autoDismissKeyboard?: boolean;\n      keyboardDismissStrategy?: 'esc-first' | 'back-first';\n      keyboardTypeDelay?: number;\n      inputStrategy?: InputStrategy;\n      target?: unknown;\n      replace?: boolean;\n      focusOnly?: boolean;\n      /** @internal Custom readiness replaces optional post-input settling. */\n      skipDefaultWait?: boolean;\n    },\n  ): Promise<void>;\n  clearInput(target?: unknown): Promise<void>;\n}\n\nexport interface ScrollInputPrimitives {\n  scroll(\n    param: ActionScrollParam,\n    opts?: { skipDefaultWait?: boolean },\n  ): Promise<void>;\n}\n\nexport interface SystemInputPrimitives {\n  backButton?(): Promise<void>;\n  homeButton?(): Promise<void>;\n  recentAppsButton?(): Promise<void>;\n}\n\nexport interface InputPrimitives {\n  pointer?: PointerInputPrimitives;\n  keyboard?: KeyboardInputPrimitives;\n  touch?: TouchInputPrimitives;\n  scroll?: ScrollInputPrimitives;\n  system?: SystemInputPrimitives;\n}\n\n/**\n * Resolve the canonical swipe capability for an input collection.\n * Touch remains preferred for devices that expose both capabilities; desktop\n * devices can fall back to a pointer-backed primary-button gesture.\n */\nexport function resolveSwipeInputPrimitive(\n  input: Pick<InputPrimitives, 'pointer' | 'touch'>,\n): ResolvedSwipeInputPrimitive | undefined {\n  if (input.touch?.swipe) {\n    return { swipe: input.touch.swipe, inputMode: 'touch' };\n  }\n  if (input.pointer?.swipe) {\n    return { swipe: input.pointer.swipe, inputMode: 'mouse' };\n  }\n  return undefined;\n}\n\nexport interface MobileInputPrimitives extends InputPrimitives {\n  pointer: PointerInputPrimitives & {\n    doubleClick(p: PointerPoint): Promise<void>;\n    longPress(p: PointerPoint, opts?: { duration?: number }): Promise<void>;\n    dragAndDrop(from: PointerPoint, to: PointerPoint): Promise<void>;\n  };\n  keyboard: KeyboardInputPrimitives;\n  touch: TouchInputPrimitives;\n}\n\nexport interface BrowserInputPrimitives extends InputPrimitives {\n  pointer: PointerInputPrimitives & {\n    doubleClick(p: PointerPoint): Promise<void>;\n    rightClick(p: PointerPoint): Promise<void>;\n    hover(p: PointerPoint): Promise<void>;\n    dragAndDrop(from: PointerPoint, to: PointerPoint): Promise<void>;\n    longPress(p: PointerPoint, opts?: { duration?: number }): Promise<void>;\n  };\n  keyboard: KeyboardInputPrimitives;\n  scroll: ScrollInputPrimitives;\n  touch: TouchInputPrimitives;\n}\n\nexport interface ComputerInputPrimitives extends InputPrimitives {\n  pointer: PointerInputPrimitives & {\n    doubleClick(p: PointerPoint): Promise<void>;\n    rightClick(p: PointerPoint): Promise<void>;\n    hover(p: PointerPoint): Promise<void>;\n    dragAndDrop(from: PointerPoint, to: PointerPoint): Promise<void>;\n  };\n  keyboard: KeyboardInputPrimitives;\n  scroll: ScrollInputPrimitives;\n}\n\nexport abstract class AbstractInterface {\n  abstract interfaceType: string;\n\n  abstract screenshotBase64(): Promise<string>;\n  abstract size(): Promise<Size>;\n  abstract actionSpace(): DeviceAction[];\n\n  abstract cacheFeatureForPoint?(\n    center: [number, number],\n    options?: {\n      targetDescription?: string;\n      modelRuntime?: ModelRuntime;\n    },\n  ): Promise<ElementCacheFeature>;\n  abstract rectMatchesCacheFeature?(\n    feature: ElementCacheFeature,\n  ): Promise<Rect>;\n\n  abstract getUITree?(): Promise<UITreeSnapshot>;\n\n  abstract destroy?(): Promise<void>;\n\n  abstract describe?(): string;\n  abstract beforeInvokeAction?(actionName: string, param: any): Promise<void>;\n  abstract afterInvokeAction?(actionName: string, param: any): Promise<void>;\n\n  /** Platform readiness heuristics, skipped when a custom action waiter takes over. */\n  async defaultActionWait?(_actionName: string, _param: any): Promise<void> {}\n\n  // for web only\n  registerFileChooserListener?(\n    handler: (chooser: FileChooserHandler) => Promise<void>,\n  ): Promise<FileChooserRegistration>;\n\n  // @deprecated do NOT extend this method\n  abstract getElementsNodeTree?: () => Promise<ElementNode>;\n\n  // @deprecated do NOT extend this method\n  abstract url?: () => string | Promise<string>;\n\n  // @deprecated do NOT extend this method\n  abstract evaluateJavaScript?<T = any>(script: string): Promise<T>;\n\n  /**\n   * Get the current device-local time as a formatted string.\n   * Prefer this for user-visible time because timestamps alone do not preserve\n   * the target device's timezone when formatted on the host machine.\n   */\n  getDeviceLocalTimeString?(format?: string): Promise<string>;\n\n  /** URL of native MJPEG stream for real-time screen preview (e.g. WDA MJPEG server) */\n  mjpegStreamUrl?: string;\n\n  /**\n   * Optional continuous frame source for UI observation (`startObserving`).\n   * Devices that maintain a continuous frame stream — scrcpy on Android, WDA\n   * MJPEG on iOS, CDP screencast on web — implement this so an observer can\n   * sample the screen far faster than repeated `screenshotBase64()` calls,\n   * catching short-lived UI (toasts, carousels, transitions).\n   *\n   * The contract enables DEFERRED decoding: `latest()` returns a cheap opaque\n   * handle (e.g. a raw H.264 keyframe on Android) with no per-frame decode\n   * cost, and `decode()` materializes only the handles that were actually\n   * sampled — once, at the end of the observation window.\n   */\n  openFrameSource?(): Promise<DeviceFrameSource | undefined>;\n\n  /**\n   * Optional in-process MJPEG frame producer. Implementations can push raw\n   * base64 frames here when there is no standalone native MJPEG URL, e.g.\n   * Chromium CDP Page.startScreencast for web previews.\n   */\n  startMjpegStream?(\n    options: MjpegStreamOptions,\n  ): MjpegStreamHandle | undefined | Promise<MjpegStreamHandle | undefined>;\n\n  /**\n   * Optional hook used after a UI action to push a fresh frame on the active\n   * MJPEG stream. Set `force` after navigation to replace a transient loading\n   * frame even when the screencast has already emitted one. Implementations\n   * should be a no-op when no stream is active.\n   */\n  flushPendingVisualUpdate?(force?: boolean): Promise<void>;\n\n  /**\n   * Optional non-blocking variant of `flushPendingVisualUpdate`. Keyboard-\n   * heavy preview interactions can schedule a coalesced refresh here without\n   * stalling the input hot path; `force` preserves a requested navigation\n   * refresh while work is already queued.\n   */\n  schedulePendingVisualUpdate?(force?: boolean): void;\n\n  /**\n   * Optional navigation state probe for browser-like interfaces, used to drive\n   * loading indicators in playground UIs. Returning `undefined` means the\n   * interface does not expose this concept.\n   */\n  navigationState?(): Promise<{ isLoading: boolean }>;\n\n  /**\n   * Low-level device input surface. Platform implementations expose transport\n   * primitives here; higher-level AI actions and manual pointer dispatch should\n   * adapt to this instead of duplicating platform gesture logic.\n   */\n  inputPrimitives?: InputPrimitives;\n}\n\n// Generic function to define actions with proper type inference\n// TRuntime allows specifying a different type for the runtime parameter (after location resolution)\n// TReturn allows specifying the return type of the action\nexport const defineAction = <\n  TSchema extends z.ZodType | undefined = undefined,\n  TRuntime = TSchema extends z.ZodType ? z.infer<TSchema> : undefined,\n  TReturn = any,\n>(\n  config: {\n    name: string;\n    description: string;\n    interfaceAlias?: string;\n    paramSchema?: TSchema;\n    call: (\n      param: TRuntime,\n      context?: ExecutorContext,\n    ) => Promise<TReturn> | TReturn;\n  } & Partial<\n    Omit<\n      DeviceAction<TRuntime, TReturn>,\n      'name' | 'description' | 'interfaceAlias' | 'paramSchema' | 'call'\n    >\n  >,\n): DeviceAction<TRuntime, TReturn> => {\n  return config as any; // Type assertion needed because schema validation type differs from runtime type\n};\n\nfunction pointFromLocate(\n  locate: LocateResultElement | undefined,\n  missingMessage: string,\n): PointerPoint {\n  if (!locate) {\n    throw new Error(missingMessage);\n  }\n  return { x: locate.center[0], y: locate.center[1] };\n}\n\nfunction defineLocatedPointAction<\n  TSchema extends z.ZodType,\n  TParam extends { locate: LocateResultElement },\n>(config: {\n  name: string;\n  description: string;\n  interfaceAlias?: string;\n  paramSchema: TSchema;\n  sample: DeviceAction<TParam>['sample'];\n  missingLocateMessage: string;\n  call: (point: PointerPoint, param: TParam) => Promise<void>;\n}): DeviceAction<TParam> {\n  return defineAction<TSchema, TParam>({\n    name: config.name,\n    description: config.description,\n    interfaceAlias: config.interfaceAlias,\n    paramSchema: config.paramSchema,\n    sample: config.sample,\n    call: async (param) => {\n      await config.call(\n        pointFromLocate(param.locate, config.missingLocateMessage),\n        param,\n      );\n    },\n  });\n}\n\n// Tap\nexport const actionTapParamSchema = z.object({\n  locate: getMidsceneLocationSchema().describe('The element to be tapped'),\n});\nexport type ActionTapParam = {\n  locate: LocateResultElement;\n};\n\nexport const defineActionTap = (\n  tap: PointerInputPrimitives['tap'],\n): DeviceAction<ActionTapParam> => {\n  return defineLocatedPointAction<typeof actionTapParamSchema, ActionTapParam>({\n    name: 'Tap',\n    description: 'Tap the element',\n    interfaceAlias: 'aiTap',\n    paramSchema: actionTapParamSchema,\n    sample: {\n      locate: { prompt: 'the \"Submit\" button' },\n    },\n    missingLocateMessage: 'Element not found, cannot tap',\n    call: async (point) => {\n      await tap(point);\n    },\n  });\n};\n\nexport const registerFileChooserAcceptParamSchema = z.object({\n  files: z\n    .union([z.string(), z.array(z.string())])\n    .describe(\n      \"File path(s) within the current aiAct call's fileChooserAllowedDir to use whenever a later action triggers a file chooser. fileChooserAllowedDir must be provided for this action. This setting replaces any previously registered file path(s).\",\n    ),\n});\nexport type RegisterFileChooserAcceptParam = {\n  files: string | string[];\n};\n\nexport const defineActionRegisterFileChooserAccept = (\n  register: (files: string | string[]) => Promise<void>,\n): DeviceAction<RegisterFileChooserAcceptParam> => {\n  return defineAction<\n    typeof registerFileChooserAcceptParamSchema,\n    RegisterFileChooserAcceptParam\n  >({\n    name: 'RegisterFileChooserAccept',\n    description:\n      'Configure files for file chooser dialogs triggered by later actions in this aiAct',\n    interfaceAlias: 'registerFileChooserAccept',\n    paramSchema: registerFileChooserAcceptParamSchema,\n    sample: {\n      files: ['fixtures/document.pdf'],\n    },\n    call: async (param) => {\n      await register(param.files);\n    },\n  });\n};\n\n// RightClick\nexport const actionRightClickParamSchema = z.object({\n  locate: getMidsceneLocationSchema().describe(\n    'The element to be right clicked',\n  ),\n});\nexport type ActionRightClickParam = {\n  locate: LocateResultElement;\n};\n\nexport const defineActionRightClick = (\n  rightClick: NonNullable<PointerInputPrimitives['rightClick']>,\n): DeviceAction<ActionRightClickParam> => {\n  return defineLocatedPointAction<\n    typeof actionRightClickParamSchema,\n    ActionRightClickParam\n  >({\n    name: 'RightClick',\n    description: 'Right click the element',\n    interfaceAlias: 'aiRightClick',\n    paramSchema: actionRightClickParamSchema,\n    sample: {\n      locate: { prompt: 'the file icon on the desktop' },\n    },\n    missingLocateMessage: 'Element not found, cannot right click',\n    call: async (point) => {\n      await rightClick(point);\n    },\n  });\n};\n\n// DoubleClick\nexport const actionDoubleClickParamSchema = z.object({\n  locate: getMidsceneLocationSchema().describe(\n    'The element to be double clicked',\n  ),\n});\nexport type ActionDoubleClickParam = {\n  locate: LocateResultElement;\n};\n\nexport const defineActionDoubleClick = (\n  doubleClick: NonNullable<PointerInputPrimitives['doubleClick']>,\n): DeviceAction<ActionDoubleClickParam> => {\n  return defineLocatedPointAction<\n    typeof actionDoubleClickParamSchema,\n    ActionDoubleClickParam\n  >({\n    name: 'DoubleClick',\n    description: 'Double click the element',\n    interfaceAlias: 'aiDoubleClick',\n    paramSchema: actionDoubleClickParamSchema,\n    sample: {\n      locate: { prompt: 'the folder icon' },\n    },\n    missingLocateMessage: 'Element not found, cannot double click',\n    call: async (point) => {\n      await doubleClick(point);\n    },\n  });\n};\n\n// Hover\nexport const actionHoverParamSchema = z.object({\n  locate: getMidsceneLocationSchema().describe('The element to be hovered'),\n});\nexport type ActionHoverParam = {\n  locate: LocateResultElement;\n};\n\nexport const defineActionHover = (\n  hover: NonNullable<PointerInputPrimitives['hover']>,\n): DeviceAction<ActionHoverParam> => {\n  return defineLocatedPointAction<\n    typeof actionHoverParamSchema,\n    ActionHoverParam\n  >({\n    name: 'Hover',\n    description: 'Move the mouse to the element',\n    interfaceAlias: 'aiHover',\n    paramSchema: actionHoverParamSchema,\n    sample: {\n      locate: { prompt: 'the navigation menu item \"Products\"' },\n    },\n    missingLocateMessage: 'Element not found, cannot hover',\n    call: async (point) => {\n      await hover(point);\n    },\n  });\n};\n\n// Input\nconst inputLocateDescription =\n  'the position of the placeholder or text content in the target input field. If there is no content, locate the center of the input field.';\nexport const actionInputParamSchema = z.object({\n  value: z\n    .union([z.string(), z.number()])\n    .transform((val) => String(val))\n    .describe(\n      'The text to input. Provide the final content for replace mode, only the inserted characters for typeOnly mode, or an empty string when using clear mode to remove existing text.',\n    ),\n  locate: getMidsceneLocationSchema()\n    .describe(inputLocateDescription)\n    .optional(),\n  mode: z\n    .enum(['replace', 'clear', 'typeOnly'])\n    .default('replace')\n    .describe(\n      'Input mode: \"replace\" (default) - clear the field and input the value; \"typeOnly\" - type the value directly without clearing the field first, and should be set explicitly for incremental edits after moving the cursor; \"clear\" - clear the field without inputting new text.',\n    ),\n  autoDismissKeyboard: z\n    .boolean()\n    .optional()\n    .describe(\n      'If true, the keyboard will be dismissed after the input is completed. Do not set it unless the user asks you to do so.',\n    ),\n  keyboardTypeDelay: z\n    .number()\n    .finite()\n    .nonnegative()\n    .optional()\n    .describe(\n      'Delay in milliseconds between keystrokes when typing. Passed through from device/user configuration. Do not set it unless the user asks you to do so.',\n    ),\n  inputStrategy: z\n    .enum(inputStrategies)\n    .optional()\n    .describe(\n      'Text input strategy: \"legacy\" (default) preserves the current platform behavior; \"sequential\" enters one Unicode code point at a time; \"bulk\" sends the complete text through one platform input operation when supported and requires keyboardTypeDelay to be omitted or set to 0. Do not set it unless the user asks you to do so.',\n    ),\n});\nexport type ActionInputParam = {\n  value: string;\n  locate?: LocateResultElement;\n  mode?: 'replace' | 'clear' | 'typeOnly' | 'append';\n  autoDismissKeyboard?: boolean;\n  keyboardTypeDelay?: number;\n  inputStrategy?: InputStrategy;\n};\n\nexport const defineActionInput = (\n  keyboard: KeyboardInputPrimitives,\n): DeviceAction<ActionInputParam> => {\n  return defineAction<typeof actionInputParamSchema, ActionInputParam>({\n    name: 'Input',\n    description: 'Input the value into the element',\n    interfaceAlias: 'aiInput',\n    paramSchema: actionInputParamSchema,\n    sample: {\n      value: 'test@example.com',\n      locate: { prompt: 'the email input field' },\n    },\n    call: async (param, context) => {\n      // backward compat: convert deprecated 'append' to 'typeOnly'\n      if ((param.mode as string) === 'append') {\n        param.mode = 'typeOnly';\n      }\n\n      if (param.mode === 'clear') {\n        await keyboard.clearInput(param.locate);\n        return;\n      }\n\n      if (!param || !param.value) {\n        return;\n      }\n\n      await keyboard.typeText(param.value, {\n        target: param.locate,\n        replace: param.mode !== 'typeOnly',\n        autoDismissKeyboard: param.autoDismissKeyboard,\n        keyboardTypeDelay: param.keyboardTypeDelay,\n        inputStrategy: param.inputStrategy,\n        ...(context?.skipDefaultWait ? { skipDefaultWait: true } : {}),\n      });\n    },\n  });\n};\n\n// KeyboardPress\nexport const actionKeyboardPressParamSchema = z.object({\n  locate: getMidsceneLocationSchema()\n    .describe(\n      'The optional element to click before pressing the key. Omit this when the key should operate on the currently focused element, especially when copying or cutting an existing text selection.',\n    )\n    .optional(),\n  keyName: z\n    .string()\n    .describe(\n      \"The key to be pressed. Use '+' for key combinations, e.g., 'Control+A', 'Shift+Enter'\",\n    ),\n});\nexport type ActionKeyboardPressParam = {\n  locate?: LocateResultElement;\n  keyName: string;\n};\n\nexport const defineActionKeyboardPress = (\n  keyboardPress: KeyboardInputPrimitives['keyboardPress'],\n): DeviceAction<ActionKeyboardPressParam> => {\n  return defineAction<\n    typeof actionKeyboardPressParamSchema,\n    ActionKeyboardPressParam\n  >({\n    name: 'KeyboardPress',\n    description:\n      'Press a key or key combination, like \"Enter\", \"Tab\", \"Escape\", or \"Control+A\", \"Shift+Enter\". Do not use this to type text. Omit locate to operate on the current focus without clicking again, especially for Copy or Cut after text has been selected.',\n    interfaceAlias: 'aiKeyboardPress',\n    paramSchema: actionKeyboardPressParamSchema,\n    sample: {\n      keyName: 'Enter',\n    },\n    call: async (param) => {\n      await keyboardPress(param.keyName, {\n        target: param.locate,\n      });\n    },\n  });\n};\n\n// Scroll\nexport const actionScrollParamSchema = z.object({\n  scrollType: z\n    .enum([\n      'singleAction',\n      'scrollToBottom',\n      'scrollToTop',\n      'scrollToRight',\n      'scrollToLeft',\n    ])\n    .default('singleAction')\n    .describe(\n      'The scroll behavior: \"singleAction\" for a single scroll action, \"scrollToBottom\" for scrolling all the way to the bottom by rapidly scrolling 5-10 times (skipping intermediate content until reaching the bottom), \"scrollToTop\" for scrolling all the way to the top by rapidly scrolling 5-10 times (skipping intermediate content until reaching the top), \"scrollToRight\" for scrolling all the way to the right by rapidly scrolling multiple times, \"scrollToLeft\" for scrolling all the way to the left by rapidly scrolling multiple times',\n    ),\n  direction: z\n    .enum(['down', 'up', 'right', 'left'])\n    .default('down')\n    .describe(\n      'The direction toward the off-screen content to reveal. \"down\" reveals content below the current viewport, \"up\" reveals content above, \"right\" reveals content to the right, and \"left\" reveals content to the left. This does not describe the movement direction of the content currently visible on the screen. Only effective when scrollType is \"singleAction\".',\n    ),\n  distance: z\n    .number()\n    .positive()\n    .nullable()\n    .optional()\n    .describe(\n      'Positive requested scroll amount in screen-coordinate units. On touch platforms, it controls the length of the swipe gesture used to scroll; on web and desktop platforms, it controls or approximates the wheel scroll delta. Only effective when scrollType is \"singleAction\".',\n    ),\n  locate: getMidsceneLocationSchema()\n    .optional()\n    .describe(\n      'Describe the target element to be scrolled on, like \"the table\" or \"the list\" or \"the content area\" or \"the scrollable area\". Do NOT provide a general intent like \"scroll to find some element\"',\n    ),\n});\n\nexport const defineActionScroll = (\n  scroll: ScrollInputPrimitives['scroll'],\n): DeviceAction<ActionScrollParam> => {\n  return defineAction<typeof actionScrollParamSchema, ActionScrollParam>({\n    name: 'Scroll',\n    description:\n      'Scroll a page or scrollable region to reveal off-screen content. Use Scroll when the goal is to browse content outside the current viewport. For direct gesture interactions, such as adjusting a slider or wheel picker, switching between paged cards or images, following an on-screen swipe gesture to continue or dismiss, or swiping an item to delete it, use Swipe instead if available in the current Action Space. Supports scrollToBottom/scrollToTop for boundary navigation. Default: direction `down`, scrollType `singleAction`, distance `null`.',\n    interfaceAlias: 'aiScroll',\n    paramSchema: actionScrollParamSchema,\n    sample: {\n      direction: 'down',\n      scrollType: 'singleAction',\n      locate: { prompt: 'the center of the product list area' },\n    },\n    call: async (param, context) => {\n      if (context?.skipDefaultWait)\n        await scroll(param, { skipDefaultWait: true });\n      else await scroll(param);\n    },\n  });\n};\n\n// DragAndDrop\nexport const actionDragAndDropParamSchema = z.object({\n  from: getMidsceneLocationSchema().describe('The position to be dragged'),\n  to: getMidsceneLocationSchema().describe('The position to be dropped'),\n});\nexport type ActionDragAndDropParam = {\n  from: LocateResultElement;\n  to: LocateResultElement;\n};\n\nexport const defineActionDragAndDrop = (\n  dragAndDrop: NonNullable<PointerInputPrimitives['dragAndDrop']>,\n): DeviceAction<ActionDragAndDropParam> => {\n  return defineAction<\n    typeof actionDragAndDropParamSchema,\n    ActionDragAndDropParam\n  >({\n    name: 'DragAndDrop',\n    description:\n      'Pick up a specific UI element and move it to a new position (e.g., reorder a card, move a file into a folder, sort list items). The element itself moves with your finger/mouse.',\n    interfaceAlias: 'aiDragAndDrop',\n    paramSchema: actionDragAndDropParamSchema,\n    sample: {\n      from: { prompt: 'the \"report.pdf\" file icon' },\n      to: { prompt: 'the upload drop zone' },\n    },\n    call: async (param) => {\n      const from = param.from;\n      const to = param.to;\n      if (!from) {\n        throw new Error('missing \"from\" param for drag and drop');\n      }\n      if (!to) {\n        throw new Error('missing \"to\" param for drag and drop');\n      }\n      await dragAndDrop(\n        { x: from.center[0], y: from.center[1] },\n        { x: to.center[0], y: to.center[1] },\n      );\n    },\n  });\n};\n\nexport const ActionLongPressParamSchema = z.object({\n  locate: getMidsceneLocationSchema().describe(\n    'The element to be long pressed',\n  ),\n  duration: z\n    .number()\n    .optional()\n    .describe('Long press duration in milliseconds'),\n});\n\nexport type ActionLongPressParam = {\n  locate: LocateResultElement;\n  duration?: number;\n};\nexport const defineActionLongPress = (\n  longPress: NonNullable<PointerInputPrimitives['longPress']>,\n): DeviceAction<ActionLongPressParam> => {\n  return defineLocatedPointAction<\n    typeof ActionLongPressParamSchema,\n    ActionLongPressParam\n  >({\n    name: 'LongPress',\n    description: 'Long press the element',\n    interfaceAlias: 'aiLongPress',\n    paramSchema: ActionLongPressParamSchema,\n    sample: {\n      locate: { prompt: 'the message bubble' },\n    },\n    missingLocateMessage: 'LongPress requires an element to be located',\n    call: async (point, param) => {\n      await longPress(point, { duration: param.duration });\n    },\n  });\n};\n\nfunction createActionSwipeParamSchema(inputMode: SwipeInputMode) {\n  const movementSource = inputMode === 'touch' ? 'finger' : 'pointer';\n\n  return z.object({\n    start: getMidsceneLocationSchema()\n      .optional()\n      .describe(\n        `Optional starting point of the ${movementSource} movement. Available in both relative and endpoint forms. If omitted, the center of the page is used.`,\n      ),\n    direction: z\n      .enum(['up', 'down', 'left', 'right'])\n      .optional()\n      .describe(\n        `${movementSource === 'finger' ? 'Finger' : 'Pointer'} movement direction. Required together with a positive distance for a relative swipe. Omit when using end.`,\n      ),\n    distance: z\n      .number()\n      .positive()\n      .optional()\n      .describe(\n        `Positive length of the ${movementSource} movement in pixels. Required together with direction for a relative swipe. Omit when using end.`,\n      ),\n    end: getMidsceneLocationSchema()\n      .optional()\n      .describe(\n        `Endpoint of the ${movementSource} movement. Use for an endpoint swipe, optionally with start. Do not provide direction or distance when using end.`,\n      ),\n    duration: z\n      .number()\n      .default(300)\n      .describe('Duration of the swipe gesture in milliseconds'),\n    repeat: z\n      .number()\n      .optional()\n      .describe(\n        'The number of times to repeat the swipe gesture. 1 for default, 0 for infinite (e.g. endless swipe until the end of the page)',\n      ),\n  });\n}\n\n// Preserve the historical touch-oriented public schema. Desktop actions use\n// an equivalent schema with mouse-specific descriptions at definition time.\nexport const ActionSwipeParamSchema = createActionSwipeParamSchema('touch');\n\nexport type ActionSwipeParam = {\n  start?: LocateResultElement;\n  direction?: 'up' | 'down' | 'left' | 'right';\n  distance?: number;\n  end?: LocateResultElement;\n  duration?: number;\n  repeat?: number;\n};\n\nexport function normalizeSwipeParam(\n  param: ActionSwipeParam,\n  screenSize: { width: number; height: number },\n): {\n  startPoint: { x: number; y: number };\n  endPoint: { x: number; y: number };\n  duration: number;\n  repeatCount: number;\n} {\n  const { width, height } = screenSize;\n  const { start, end } = param;\n\n  const startPoint = start\n    ? { x: start.center[0], y: start.center[1] }\n    : { x: width / 2, y: height / 2 };\n\n  const endPoint = (() => {\n    if (end) {\n      if (param.direction !== undefined || param.distance !== undefined) {\n        throw new Error(\n          'Invalid Swipe parameters: \"end\" cannot be combined with \"direction\" or \"distance\". Use \"end\", optionally with \"start\", for an endpoint swipe.',\n        );\n      }\n\n      return { x: end.center[0], y: end.center[1] };\n    }\n\n    if (param.direction === undefined || param.distance === undefined) {\n      throw new Error(\n        'Invalid Swipe parameters: a relative swipe requires both \"direction\" and a positive \"distance\".',\n      );\n    }\n\n    if (param.distance <= 0) {\n      throw new Error(\n        'Invalid Swipe parameters: \"distance\" must be a positive number.',\n      );\n    }\n\n    return {\n      x:\n        startPoint.x +\n        (param.direction === 'right'\n          ? param.distance\n          : param.direction === 'left'\n            ? -param.distance\n            : 0),\n      y:\n        startPoint.y +\n        (param.direction === 'down'\n          ? param.distance\n          : param.direction === 'up'\n            ? -param.distance\n            : 0),\n    };\n  })();\n\n  endPoint.x = Math.max(0, Math.min(endPoint.x, width));\n  endPoint.y = Math.max(0, Math.min(endPoint.y, height));\n\n  const duration = param.duration ?? 300;\n\n  let repeatCount = typeof param.repeat === 'number' ? param.repeat : 1;\n  if (repeatCount === 0) {\n    repeatCount = 10;\n  }\n\n  return { startPoint, endPoint, duration, repeatCount };\n}\n\n/** @deprecated Use {@link normalizeSwipeParam} instead. */\nexport const normalizeMobileSwipeParam = normalizeSwipeParam;\n\nexport const defineActionSwipe = (config: {\n  swipe: SwipeInputPrimitive;\n  size(): Promise<Size>;\n  inputMode?: SwipeInputMode;\n}): DeviceAction<ActionSwipeParam> => {\n  const inputMode = config.inputMode ?? 'touch';\n  return defineAction<typeof ActionSwipeParamSchema, ActionSwipeParam>({\n    name: 'Swipe',\n    description:\n      inputMode === 'touch'\n        ? 'Perform a touch gesture that directly manipulates the UI (e.g., adjust a continuous control such as a slider or wheel picker, switch between paged cards or images, follow an on-screen swipe gesture to continue or dismiss, or swipe an item to delete it). For browsing off-screen content in a page or scrollable region, use Scroll instead. Choose exactly one movement form: (1) relative swipe — provide \"direction\" and a positive \"distance\"; or (2) endpoint swipe — provide \"end\". \"start\" is optional for both forms and defaults to the center of the page. Do not combine \"end\" with \"direction\" or \"distance\".'\n        : 'Perform a primary-mouse-button gesture that continuously presses and moves the pointer across the desktop UI. Use it to adjust a continuous control such as a slider or wheel picker, switch between paged cards or images, follow an on-screen swipe gesture to continue or dismiss, or swipe an item to delete it. For browsing off-screen content in a page or scrollable region, use Scroll instead. Choose exactly one movement form: (1) relative swipe — provide \"direction\" and a positive \"distance\"; or (2) endpoint swipe — provide \"end\". \"start\" is optional for both forms and defaults to the center of the page. Do not combine \"end\" with \"direction\" or \"distance\".',\n    interfaceAlias: 'aiSwipe',\n    paramSchema:\n      inputMode === 'touch'\n        ? ActionSwipeParamSchema\n        : createActionSwipeParamSchema(inputMode),\n    sample: {\n      start: { prompt: 'center of the notification' },\n      end: { prompt: 'upper edge of the screen' },\n    },\n    call: async (param) => {\n      const { startPoint, endPoint, duration, repeatCount } =\n        normalizeSwipeParam(param, await config.size());\n      for (let i = 0; i < repeatCount; i++) {\n        await config.swipe(startPoint, endPoint, { duration });\n      }\n    },\n  });\n};\n\n// ClearInput\nexport const actionClearInputParamSchema = z.object({\n  locate: getMidsceneLocationSchema()\n    .describe('The input field to be cleared')\n    .optional(),\n});\nexport type ActionClearInputParam = {\n  locate?: LocateResultElement;\n};\n\nexport const defineActionClearInput = (\n  clearInput: KeyboardInputPrimitives['clearInput'],\n): DeviceAction<ActionClearInputParam> => {\n  return defineAction<\n    typeof actionClearInputParamSchema,\n    ActionClearInputParam\n  >({\n    name: 'ClearInput',\n    description: inputLocateDescription,\n    interfaceAlias: 'aiClearInput',\n    paramSchema: actionClearInputParamSchema,\n    sample: {\n      locate: { prompt: 'the search input field' },\n    },\n    call: async (param) => {\n      await clearInput(param.locate);\n    },\n  });\n};\n\n// CursorMove\nexport const actionCursorMoveParamSchema = z.object({\n  direction: z\n    .enum(['left', 'right'])\n    .describe('The direction to move the cursor'),\n  times: z\n    .number()\n    .int()\n    .min(1)\n    .default(1)\n    .describe(\n      'The number of times to move the cursor in the specified direction',\n    ),\n});\nexport type ActionCursorMoveParam = {\n  direction: 'left' | 'right';\n  times?: number;\n};\n\nexport const defineActionCursorMove = (config: {\n  keyboard: Pick<KeyboardInputPrimitives, 'keyboardPress' | 'cursorMove'>;\n  sleep?(timeMs: number): Promise<void>;\n}): DeviceAction<ActionCursorMoveParam> => {\n  return defineAction<\n    typeof actionCursorMoveParamSchema,\n    ActionCursorMoveParam\n  >({\n    name: 'CursorMove',\n    description:\n      'Move the text cursor (caret) left or right within an input field or text area. Use this to reposition the cursor without selecting text.',\n    paramSchema: actionCursorMoveParamSchema,\n    sample: {\n      direction: 'left',\n      times: 3,\n    },\n    call: async (param) => {\n      const times = param.times ?? 1;\n      if (config.keyboard.cursorMove) {\n        await config.keyboard.cursorMove(param.direction, times);\n        return;\n      }\n\n      const wait =\n        config.sleep ??\n        ((timeMs: number) =>\n          new Promise<void>((resolve) => setTimeout(resolve, timeMs)));\n      const arrowKey = param.direction === 'left' ? 'ArrowLeft' : 'ArrowRight';\n      for (let i = 0; i < times; i++) {\n        await config.keyboard.keyboardPress(arrowKey);\n        await wait(100);\n      }\n    },\n  });\n};\n\n// Pinch\nexport const ActionPinchParamSchema = z.object({\n  locate: getMidsceneLocationSchema()\n    .optional()\n    .describe(\n      'The element to pinch on. If not specified, the center of the screen will be used',\n    ),\n  direction: z\n    .enum(['in', 'out'])\n    .describe(\n      'Pinch direction. \"in\" = pinch fingers together (zoom out / shrink), \"out\" = spread fingers apart (zoom in / enlarge).',\n    ),\n  distance: z\n    .number()\n    .positive()\n    .optional()\n    .describe(\n      'How far each finger moves in pixels. Defaults to a quarter of the shorter screen dimension.',\n    ),\n  duration: z\n    .number()\n    .default(500)\n    .optional()\n    .describe('Duration of the pinch gesture in milliseconds'),\n});\n\nexport type ActionPinchParam = {\n  locate?: LocateResultElement;\n  direction: 'in' | 'out';\n  distance?: number;\n  duration?: number;\n};\n\nexport const defineActionPinch = (config: {\n  pinch: TouchInputPrimitives['pinch'];\n  size(): Promise<Size>;\n}): DeviceAction<ActionPinchParam> | undefined => {\n  if (!config.pinch) {\n    return undefined;\n  }\n\n  return defineAction<typeof ActionPinchParamSchema, ActionPinchParam>({\n    name: 'Pinch',\n    description:\n      'Perform a two-finger pinch gesture. Use direction \"in\" to pinch fingers together (zoom out), or \"out\" to spread fingers apart (zoom in). Optionally specify distance for how far each finger moves.',\n    interfaceAlias: 'aiPinch',\n    paramSchema: ActionPinchParamSchema,\n    sample: {\n      locate: { prompt: 'the map area' },\n      direction: 'out',\n      distance: 200,\n    },\n    call: async (param) => {\n      const { centerX, centerY, startDistance, endDistance, duration } =\n        normalizePinchParam(param, await config.size());\n      await config.pinch?.(\n        { x: centerX, y: centerY },\n        { startDistance, endDistance, duration },\n      );\n    },\n  });\n};\n\nexport function normalizePinchParam(\n  param: ActionPinchParam,\n  screenSize: { width: number; height: number },\n): {\n  centerX: number;\n  centerY: number;\n  startDistance: number;\n  endDistance: number;\n  duration: number;\n} {\n  const { width, height } = screenSize;\n  const element = param.locate;\n  const centerX = element\n    ? Math.round(element.center[0])\n    : Math.round(width / 2);\n  const centerY = element\n    ? Math.round(element.center[1])\n    : Math.round(height / 2);\n  const duration = param.duration ?? 500;\n\n  const baseDistance = Math.round(Math.min(width, height) / 4);\n  const fingerDistance = param.distance ?? baseDistance;\n\n  const startDistance = baseDistance;\n  const endDistance =\n    param.direction === 'out'\n      ? baseDistance + fingerDistance\n      : Math.max(10, baseDistance - fingerDistance);\n\n  return { centerX, centerY, startDistance, endDistance, duration };\n}\n\nexport interface MobileInputActionContext {\n  input: MobileInputPrimitives;\n  size(): Promise<Size>;\n  sleep?(timeMs: number): Promise<void>;\n  getDefaultAutoDismissKeyboard?(): boolean | undefined;\n  systemActions?: SystemInputActionOptions;\n}\n\nexport interface SystemInputActionConfig {\n  name: string;\n  description: string;\n  interfaceAlias?: string;\n  delayBeforeRunner?: number;\n  delayAfterRunner?: number;\n}\n\nexport interface SystemInputActionOptions {\n  backButton?: SystemInputActionConfig;\n  homeButton?: SystemInputActionConfig;\n  recentAppsButton?: SystemInputActionConfig;\n}\n\nexport interface InputPrimitiveActionOptions {\n  size?: () => Promise<Size>;\n  sleep?: (timeMs: number) => Promise<void>;\n  includeSwipe?: boolean;\n  includePinch?: boolean;\n  systemActions?: SystemInputActionOptions;\n}\n\nfunction defineSystemInputAction(\n  config: SystemInputActionConfig,\n  call: () => Promise<void>,\n): DeviceAction<undefined, void> {\n  return defineAction<undefined, undefined, void>({\n    name: config.name,\n    description: config.description,\n    interfaceAlias: config.interfaceAlias,\n    delayBeforeRunner: config.delayBeforeRunner,\n    delayAfterRunner: config.delayAfterRunner,\n    call,\n  });\n}\n\nexport function defineActionsFromInputPrimitives(\n  input: InputPrimitives,\n  options: InputPrimitiveActionOptions = {},\n): DeviceAction<any>[] {\n  const actions: Array<DeviceAction<any> | undefined> = [];\n  const { pointer, keyboard, scroll, touch, system } = input;\n\n  if (pointer) {\n    actions.push(defineActionTap(pointer.tap));\n    if (pointer.doubleClick) {\n      actions.push(defineActionDoubleClick(pointer.doubleClick));\n    }\n    if (pointer.rightClick) {\n      actions.push(defineActionRightClick(pointer.rightClick));\n    }\n    if (pointer.hover) {\n      actions.push(defineActionHover(pointer.hover));\n    }\n    if (pointer.dragAndDrop) {\n      actions.push(defineActionDragAndDrop(pointer.dragAndDrop));\n    }\n    if (pointer.longPress) {\n      actions.push(defineActionLongPress(pointer.longPress));\n    }\n  }\n\n  if (keyboard) {\n    actions.push(\n      defineActionInput(keyboard),\n      defineActionClearInput(keyboard.clearInput),\n      defineActionKeyboardPress(keyboard.keyboardPress),\n      defineActionCursorMove({ keyboard, sleep: options.sleep }),\n    );\n  }\n\n  if (scroll) {\n    actions.push(defineActionScroll(scroll.scroll));\n  }\n\n  const swipeConfig = resolveSwipeInputPrimitive({ pointer, touch });\n  if (swipeConfig && options.size && options.includeSwipe !== false) {\n    actions.push(defineActionSwipe({ ...swipeConfig, size: options.size }));\n  }\n\n  if (touch?.pinch && options.size && options.includePinch !== false) {\n    actions.push(defineActionPinch({ pinch: touch.pinch, size: options.size }));\n  }\n\n  if (system && options.systemActions) {\n    const { systemActions } = options;\n    if (system.backButton && systemActions.backButton) {\n      actions.push(\n        defineSystemInputAction(systemActions.backButton, system.backButton),\n      );\n    }\n    if (system.homeButton && systemActions.homeButton) {\n      actions.push(\n        defineSystemInputAction(systemActions.homeButton, system.homeButton),\n      );\n    }\n    if (system.recentAppsButton && systemActions.recentAppsButton) {\n      actions.push(\n        defineSystemInputAction(\n          systemActions.recentAppsButton,\n          system.recentAppsButton,\n        ),\n      );\n    }\n  }\n\n  return actions.filter((action): action is DeviceAction<any> =>\n    Boolean(action),\n  );\n}\n\nexport function createDefaultMobileActions(\n  context: MobileInputActionContext,\n): DeviceAction<any>[] {\n  return defineActionsFromInputPrimitives(context.input, {\n    size: context.size,\n    sleep: context.sleep,\n    systemActions: context.systemActions,\n  });\n}\n\n// Sleep\nexport const ActionSleepParamSchema = z.object({\n  timeMs: z\n    .number()\n    .default(1000)\n    .optional()\n    .describe('Sleep duration in milliseconds, defaults to 1000ms (1 second)'),\n});\n\nexport type ActionSleepParam = {\n  timeMs?: number;\n};\n\nexport const defineActionSleep = (\n  abortSignal?: AbortSignal,\n): DeviceAction<ActionSleepParam> => {\n  return defineAction<typeof ActionSleepParamSchema, ActionSleepParam>({\n    name: 'Sleep',\n    description:\n      'Wait for a specified duration before continuing. Defaults to 1 second (1000ms) if not specified.',\n    paramSchema: ActionSleepParamSchema,\n    sample: {\n      timeMs: 2000,\n    },\n    call: async (param) => {\n      const duration = param?.timeMs ?? 1000;\n      getDebug('device:common-action')(`Sleeping for ${duration}ms`);\n      abortSignal?.throwIfAborted();\n      await new Promise<void>((resolve, reject) => {\n        const abort = () => {\n          clearTimeout(timer);\n          reject(abortSignal?.reason);\n        };\n        const timer = setTimeout(() => {\n          abortSignal?.removeEventListener('abort', abort);\n          resolve();\n        }, duration);\n        abortSignal?.addEventListener('abort', abort, { once: true });\n      });\n    },\n  });\n};\n\nexport type { DeviceAction } from '../types';\nexport type { ActionScrollParam, LocateResultElement, Size } from '../types';\nexport { getMidsceneLocationSchema } from '../common';\nexport { z };\nexport {\n  inputStrategies,\n  type InputStrategy,\n  type ResolvedTextInputOptions,\n  type SequentialTextInputHandlers,\n  type TextInputOptions,\n  resolveInputStrategy,\n  resolveTextInputOptions,\n  sendTextSequentially,\n  shouldInputSequentially,\n} from './input-strategy';\nexport type {\n  AndroidDeviceOpt,\n  AndroidDeviceInputOpt,\n  IOSDeviceOpt,\n  IOSDeviceInputOpt,\n  HarmonyDeviceOpt,\n  HarmonyDeviceInputOpt,\n} from './device-options';\n"],"names":["resolveSwipeInputPrimitive","input","AbstractInterface","_actionName","_param","defineAction","config","pointFromLocate","locate","missingMessage","Error","defineLocatedPointAction","param","actionTapParamSchema","z","getMidsceneLocationSchema","defineActionTap","tap","point","registerFileChooserAcceptParamSchema","defineActionRegisterFileChooserAccept","register","actionRightClickParamSchema","defineActionRightClick","rightClick","actionDoubleClickParamSchema","defineActionDoubleClick","doubleClick","actionHoverParamSchema","defineActionHover","hover","inputLocateDescription","actionInputParamSchema","val","String","inputStrategies","defineActionInput","keyboard","context","actionKeyboardPressParamSchema","defineActionKeyboardPress","keyboardPress","actionScrollParamSchema","defineActionScroll","scroll","actionDragAndDropParamSchema","defineActionDragAndDrop","dragAndDrop","from","to","ActionLongPressParamSchema","defineActionLongPress","longPress","createActionSwipeParamSchema","inputMode","movementSource","ActionSwipeParamSchema","normalizeSwipeParam","screenSize","width","height","start","end","startPoint","endPoint","undefined","Math","duration","repeatCount","normalizeMobileSwipeParam","defineActionSwipe","i","actionClearInputParamSchema","defineActionClearInput","clearInput","actionCursorMoveParamSchema","defineActionCursorMove","times","wait","timeMs","Promise","resolve","setTimeout","arrowKey","ActionPinchParamSchema","defineActionPinch","centerX","centerY","startDistance","endDistance","normalizePinchParam","element","baseDistance","fingerDistance","defineSystemInputAction","call","defineActionsFromInputPrimitives","options","actions","pointer","touch","system","swipeConfig","systemActions","action","Boolean","createDefaultMobileActions","ActionSleepParamSchema","defineActionSleep","abortSignal","getDebug","reject","abort","clearTimeout","timer"],"mappings":"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"}
+{"version":3,"file":"device/index.mjs","sources":["../../../src/device/index.ts"],"sourcesContent":["import type { ModelRuntime } from '@/ai-model/models';\nimport { getMidsceneLocationSchema } from '@/common';\nimport type {\n  ActionScrollParam,\n  DeviceAction,\n  ExecutorContext,\n  LocateResultElement,\n} from '@/types';\nimport type { ElementNode } from '@midscene/shared/extractor';\nimport { getDebug } from '@midscene/shared/logger';\nimport { _keyDefinitions } from '@midscene/shared/us-keyboard-layout';\nimport { z } from 'zod';\nimport type {\n  ElementCacheFeature,\n  Rect,\n  Size,\n  UIContext,\n  UITreeSnapshot,\n} from '../types';\nimport { type InputStrategy, inputStrategies } from './input-strategy';\n\nexport interface FileChooserHandler {\n  accept(files: string[]): Promise<void>;\n}\n\nexport interface FileChooserRegistration {\n  dispose: () => void;\n  getError: () => Error | undefined | Promise<Error | undefined>;\n}\n\nexport interface MjpegStreamFrame {\n  /** Raw base64-encoded image bytes WITHOUT a `data:image/...;base64,` prefix. */\n  data: string;\n  contentType?: string;\n}\n\nexport interface MjpegStreamHandle {\n  stop(): void | Promise<void>;\n}\n\nexport interface MjpegStreamOptions {\n  signal?: AbortSignal;\n  onFrame(frame: MjpegStreamFrame): void;\n  onError?(error: unknown): void;\n}\n\n/**\n * A cheap, not-yet-decoded handle to one screen frame from a\n * {@link DeviceFrameSource}. `ref` is platform-specific (a raw H.264 keyframe\n * buffer on Android, an already-encoded JPEG data URL on iOS/web) and must not\n * be interpreted by callers — pass it back to `decode()` to materialize.\n */\nexport interface DeviceFrameRef {\n  ref: unknown;\n  capturedAt: number;\n}\n\n/**\n * A continuous screen-frame source opened via\n * {@link AbstractInterface.openFrameSource}. Designed for deferred decoding:\n * grabbing `latest()` is near-zero cost, so observers can sample at a steady\n * cadence and pay any decode cost only once, for the frames they keep.\n */\nexport interface DeviceFrameSource {\n  /** Latest frame handle, near-zero cost. Null until the first frame arrives. */\n  latest(): DeviceFrameRef | null;\n  /**\n   * Materialize frame handles into `data:image/...;base64,` URLs, preserving\n   * order. Possibly expensive (e.g. one ffmpeg run per unique frame on\n   * Android) — call once with the sampled handles, never per tick.\n   */\n  decode(refs: DeviceFrameRef[]): Promise<string[]>;\n  /** Release the source (stop streams/subscriptions it started). */\n  stop(): Promise<void> | void;\n}\n\n/** A point in device-pixel coordinates on the screen. */\nexport interface PointerPoint {\n  x: number;\n  y: number;\n}\n\n/** Low-level swipe gesture implemented by touch or pointer-backed devices. */\nexport type SwipeInputPrimitive = (\n  start: PointerPoint,\n  end: PointerPoint,\n  opts?: { duration?: number; repeat?: number },\n) => Promise<void>;\n\n/** The physical input source used to execute and describe a swipe. */\nexport type SwipeInputMode = 'touch' | 'mouse';\n\n/** A resolved swipe capability and the input semantics exposed to the model. */\nexport interface ResolvedSwipeInputPrimitive {\n  swipe: SwipeInputPrimitive;\n  inputMode: SwipeInputMode;\n}\n\nexport interface PointerInputPrimitives {\n  tap(p: PointerPoint, opts?: { duration?: number }): Promise<void>;\n  doubleClick?(p: PointerPoint): Promise<void>;\n  rightClick?(p: PointerPoint): Promise<void>;\n  hover?(p: PointerPoint): Promise<void>;\n  longPress?(p: PointerPoint, opts?: { duration?: number }): Promise<void>;\n  dragAndDrop?(from: PointerPoint, to: PointerPoint): Promise<void>;\n  swipe?: SwipeInputPrimitive;\n}\n\nexport interface TouchInputPrimitives {\n  swipe: SwipeInputPrimitive;\n  pinch?(\n    center: PointerPoint,\n    opts: { startDistance: number; endDistance: number; duration: number },\n  ): Promise<void>;\n}\n\nexport interface KeyboardInputPrimitives {\n  keyboardPress(keyName: string, opts?: { target?: unknown }): Promise<void>;\n  cursorMove?(direction: 'left' | 'right', times?: number): Promise<void>;\n  typeText(\n    value: string,\n    opts?: {\n      autoDismissKeyboard?: boolean;\n      keyboardDismissStrategy?: 'esc-first' | 'back-first';\n      keyboardTypeDelay?: number;\n      inputStrategy?: InputStrategy;\n      target?: unknown;\n      replace?: boolean;\n      focusOnly?: boolean;\n      /** @internal Custom readiness replaces optional post-input settling. */\n      skipDefaultWait?: boolean;\n    },\n  ): Promise<void>;\n  clearInput(target?: unknown): Promise<void>;\n}\n\nexport interface ScrollInputPrimitives {\n  scroll(\n    param: ActionScrollParam,\n    opts?: { skipDefaultWait?: boolean },\n  ): Promise<void>;\n}\n\nexport interface SystemInputPrimitives {\n  backButton?(): Promise<void>;\n  homeButton?(): Promise<void>;\n  recentAppsButton?(): Promise<void>;\n}\n\nexport interface InputPrimitives {\n  pointer?: PointerInputPrimitives;\n  keyboard?: KeyboardInputPrimitives;\n  touch?: TouchInputPrimitives;\n  scroll?: ScrollInputPrimitives;\n  system?: SystemInputPrimitives;\n}\n\n/**\n * Resolve the canonical swipe capability for an input collection.\n * Touch remains preferred for devices that expose both capabilities; desktop\n * devices can fall back to a pointer-backed primary-button gesture.\n */\nexport function resolveSwipeInputPrimitive(\n  input: Pick<InputPrimitives, 'pointer' | 'touch'>,\n): ResolvedSwipeInputPrimitive | undefined {\n  if (input.touch?.swipe) {\n    return { swipe: input.touch.swipe, inputMode: 'touch' };\n  }\n  if (input.pointer?.swipe) {\n    return { swipe: input.pointer.swipe, inputMode: 'mouse' };\n  }\n  return undefined;\n}\n\nexport interface MobileInputPrimitives extends InputPrimitives {\n  pointer: PointerInputPrimitives & {\n    doubleClick(p: PointerPoint): Promise<void>;\n    longPress(p: PointerPoint, opts?: { duration?: number }): Promise<void>;\n    dragAndDrop(from: PointerPoint, to: PointerPoint): Promise<void>;\n  };\n  keyboard: KeyboardInputPrimitives;\n  touch: TouchInputPrimitives;\n}\n\nexport interface BrowserInputPrimitives extends InputPrimitives {\n  pointer: PointerInputPrimitives & {\n    doubleClick(p: PointerPoint): Promise<void>;\n    rightClick(p: PointerPoint): Promise<void>;\n    hover(p: PointerPoint): Promise<void>;\n    dragAndDrop(from: PointerPoint, to: PointerPoint): Promise<void>;\n    longPress(p: PointerPoint, opts?: { duration?: number }): Promise<void>;\n  };\n  keyboard: KeyboardInputPrimitives;\n  scroll: ScrollInputPrimitives;\n  touch: TouchInputPrimitives;\n}\n\nexport interface ComputerInputPrimitives extends InputPrimitives {\n  pointer: PointerInputPrimitives & {\n    doubleClick(p: PointerPoint): Promise<void>;\n    rightClick(p: PointerPoint): Promise<void>;\n    hover(p: PointerPoint): Promise<void>;\n    dragAndDrop(from: PointerPoint, to: PointerPoint): Promise<void>;\n  };\n  keyboard: KeyboardInputPrimitives;\n  scroll: ScrollInputPrimitives;\n}\n\nexport abstract class AbstractInterface {\n  abstract interfaceType: string;\n\n  abstract screenshotBase64(): Promise<string>;\n  abstract size(): Promise<Size>;\n  abstract actionSpace(): DeviceAction[];\n\n  abstract cacheFeatureForPoint?(\n    center: [number, number],\n    options?: {\n      targetDescription?: string;\n      modelRuntime?: ModelRuntime;\n    },\n  ): Promise<ElementCacheFeature>;\n  abstract rectMatchesCacheFeature?(\n    feature: ElementCacheFeature,\n  ): Promise<Rect>;\n\n  abstract getUITree?(): Promise<UITreeSnapshot>;\n\n  abstract destroy?(): Promise<void>;\n\n  abstract describe?(): string;\n  abstract beforeInvokeAction?(\n    actionName: string,\n    param: any,\n    signal?: AbortSignal,\n  ): Promise<void>;\n  abstract afterInvokeAction?(\n    actionName: string,\n    param: any,\n    signal?: AbortSignal,\n  ): Promise<void>;\n\n  /** Platform readiness heuristics, skipped when a custom action waiter takes over. */\n  async defaultActionWait?(\n    _actionName: string,\n    _param: any,\n    _signal?: AbortSignal,\n  ): Promise<void> {}\n\n  // for web only\n  registerFileChooserListener?(\n    handler: (chooser: FileChooserHandler) => Promise<void>,\n  ): Promise<FileChooserRegistration>;\n\n  // @deprecated do NOT extend this method\n  abstract getElementsNodeTree?: () => Promise<ElementNode>;\n\n  // @deprecated do NOT extend this method\n  abstract url?: () => string | Promise<string>;\n\n  // @deprecated do NOT extend this method\n  abstract evaluateJavaScript?<T = any>(script: string): Promise<T>;\n\n  /**\n   * Get the current device-local time as a formatted string.\n   * Prefer this for user-visible time because timestamps alone do not preserve\n   * the target device's timezone when formatted on the host machine.\n   */\n  getDeviceLocalTimeString?(format?: string): Promise<string>;\n\n  /** URL of native MJPEG stream for real-time screen preview (e.g. WDA MJPEG server) */\n  mjpegStreamUrl?: string;\n\n  /**\n   * Optional continuous frame source for UI observation (`startObserving`).\n   * Devices that maintain a continuous frame stream — scrcpy on Android, WDA\n   * MJPEG on iOS, CDP screencast on web — implement this so an observer can\n   * sample the screen far faster than repeated `screenshotBase64()` calls,\n   * catching short-lived UI (toasts, carousels, transitions).\n   *\n   * The contract enables DEFERRED decoding: `latest()` returns a cheap opaque\n   * handle (e.g. a raw H.264 keyframe on Android) with no per-frame decode\n   * cost, and `decode()` materializes only the handles that were actually\n   * sampled — once, at the end of the observation window.\n   */\n  openFrameSource?(): Promise<DeviceFrameSource | undefined>;\n\n  /**\n   * Optional in-process MJPEG frame producer. Implementations can push raw\n   * base64 frames here when there is no standalone native MJPEG URL, e.g.\n   * Chromium CDP Page.startScreencast for web previews.\n   */\n  startMjpegStream?(\n    options: MjpegStreamOptions,\n  ): MjpegStreamHandle | undefined | Promise<MjpegStreamHandle | undefined>;\n\n  /**\n   * Optional hook used after a UI action to push a fresh frame on the active\n   * MJPEG stream. Set `force` after navigation to replace a transient loading\n   * frame even when the screencast has already emitted one. Implementations\n   * should be a no-op when no stream is active.\n   */\n  flushPendingVisualUpdate?(force?: boolean): Promise<void>;\n\n  /**\n   * Optional non-blocking variant of `flushPendingVisualUpdate`. Keyboard-\n   * heavy preview interactions can schedule a coalesced refresh here without\n   * stalling the input hot path; `force` preserves a requested navigation\n   * refresh while work is already queued.\n   */\n  schedulePendingVisualUpdate?(force?: boolean): void;\n\n  /**\n   * Optional navigation state probe for browser-like interfaces, used to drive\n   * loading indicators in playground UIs. Returning `undefined` means the\n   * interface does not expose this concept.\n   */\n  navigationState?(): Promise<{ isLoading: boolean }>;\n\n  /**\n   * Low-level device input surface. Platform implementations expose transport\n   * primitives here; higher-level AI actions and manual pointer dispatch should\n   * adapt to this instead of duplicating platform gesture logic.\n   */\n  inputPrimitives?: InputPrimitives;\n}\n\n// Generic function to define actions with proper type inference\n// TRuntime allows specifying a different type for the runtime parameter (after location resolution)\n// TReturn allows specifying the return type of the action\nexport const defineAction = <\n  TSchema extends z.ZodType | undefined = undefined,\n  TRuntime = TSchema extends z.ZodType ? z.infer<TSchema> : undefined,\n  TReturn = any,\n>(\n  config: {\n    name: string;\n    description: string;\n    interfaceAlias?: string;\n    paramSchema?: TSchema;\n    call: (\n      param: TRuntime,\n      context?: ExecutorContext,\n    ) => Promise<TReturn> | TReturn;\n  } & Partial<\n    Omit<\n      DeviceAction<TRuntime, TReturn>,\n      'name' | 'description' | 'interfaceAlias' | 'paramSchema' | 'call'\n    >\n  >,\n): DeviceAction<TRuntime, TReturn> => {\n  return config as any; // Type assertion needed because schema validation type differs from runtime type\n};\n\nfunction pointFromLocate(\n  locate: LocateResultElement | undefined,\n  missingMessage: string,\n): PointerPoint {\n  if (!locate) {\n    throw new Error(missingMessage);\n  }\n  return { x: locate.center[0], y: locate.center[1] };\n}\n\nfunction defineLocatedPointAction<\n  TSchema extends z.ZodType,\n  TParam extends { locate: LocateResultElement },\n>(config: {\n  name: string;\n  description: string;\n  interfaceAlias?: string;\n  paramSchema: TSchema;\n  sample: DeviceAction<TParam>['sample'];\n  missingLocateMessage: string;\n  call: (point: PointerPoint, param: TParam) => Promise<void>;\n}): DeviceAction<TParam> {\n  return defineAction<TSchema, TParam>({\n    name: config.name,\n    description: config.description,\n    interfaceAlias: config.interfaceAlias,\n    paramSchema: config.paramSchema,\n    sample: config.sample,\n    call: async (param) => {\n      await config.call(\n        pointFromLocate(param.locate, config.missingLocateMessage),\n        param,\n      );\n    },\n  });\n}\n\n// Tap\nexport const actionTapParamSchema = z.object({\n  locate: getMidsceneLocationSchema().describe('The element to be tapped'),\n});\nexport type ActionTapParam = {\n  locate: LocateResultElement;\n};\n\nexport const defineActionTap = (\n  tap: PointerInputPrimitives['tap'],\n): DeviceAction<ActionTapParam> => {\n  return defineLocatedPointAction<typeof actionTapParamSchema, ActionTapParam>({\n    name: 'Tap',\n    description: 'Tap the element',\n    interfaceAlias: 'aiTap',\n    paramSchema: actionTapParamSchema,\n    sample: {\n      locate: { prompt: 'the \"Submit\" button' },\n    },\n    missingLocateMessage: 'Element not found, cannot tap',\n    call: async (point) => {\n      await tap(point);\n    },\n  });\n};\n\nexport const registerFileChooserAcceptParamSchema = z.object({\n  files: z\n    .union([z.string(), z.array(z.string())])\n    .describe(\n      \"File path(s) within the current aiAct call's fileChooserAllowedDir to use whenever a later action triggers a file chooser. fileChooserAllowedDir must be provided for this action. This setting replaces any previously registered file path(s).\",\n    ),\n});\nexport type RegisterFileChooserAcceptParam = {\n  files: string | string[];\n};\n\nexport const defineActionRegisterFileChooserAccept = (\n  register: (files: string | string[]) => Promise<void>,\n): DeviceAction<RegisterFileChooserAcceptParam> => {\n  return defineAction<\n    typeof registerFileChooserAcceptParamSchema,\n    RegisterFileChooserAcceptParam\n  >({\n    name: 'RegisterFileChooserAccept',\n    description:\n      'Configure files for file chooser dialogs triggered by later actions in this aiAct',\n    interfaceAlias: 'registerFileChooserAccept',\n    paramSchema: registerFileChooserAcceptParamSchema,\n    sample: {\n      files: ['fixtures/document.pdf'],\n    },\n    call: async (param) => {\n      await register(param.files);\n    },\n  });\n};\n\n// RightClick\nexport const actionRightClickParamSchema = z.object({\n  locate: getMidsceneLocationSchema().describe(\n    'The element to be right clicked',\n  ),\n});\nexport type ActionRightClickParam = {\n  locate: LocateResultElement;\n};\n\nexport const defineActionRightClick = (\n  rightClick: NonNullable<PointerInputPrimitives['rightClick']>,\n): DeviceAction<ActionRightClickParam> => {\n  return defineLocatedPointAction<\n    typeof actionRightClickParamSchema,\n    ActionRightClickParam\n  >({\n    name: 'RightClick',\n    description: 'Right click the element',\n    interfaceAlias: 'aiRightClick',\n    paramSchema: actionRightClickParamSchema,\n    sample: {\n      locate: { prompt: 'the file icon on the desktop' },\n    },\n    missingLocateMessage: 'Element not found, cannot right click',\n    call: async (point) => {\n      await rightClick(point);\n    },\n  });\n};\n\n// DoubleClick\nexport const actionDoubleClickParamSchema = z.object({\n  locate: getMidsceneLocationSchema().describe(\n    'The element to be double clicked',\n  ),\n});\nexport type ActionDoubleClickParam = {\n  locate: LocateResultElement;\n};\n\nexport const defineActionDoubleClick = (\n  doubleClick: NonNullable<PointerInputPrimitives['doubleClick']>,\n): DeviceAction<ActionDoubleClickParam> => {\n  return defineLocatedPointAction<\n    typeof actionDoubleClickParamSchema,\n    ActionDoubleClickParam\n  >({\n    name: 'DoubleClick',\n    description: 'Double click the element',\n    interfaceAlias: 'aiDoubleClick',\n    paramSchema: actionDoubleClickParamSchema,\n    sample: {\n      locate: { prompt: 'the folder icon' },\n    },\n    missingLocateMessage: 'Element not found, cannot double click',\n    call: async (point) => {\n      await doubleClick(point);\n    },\n  });\n};\n\n// Hover\nexport const actionHoverParamSchema = z.object({\n  locate: getMidsceneLocationSchema().describe('The element to be hovered'),\n});\nexport type ActionHoverParam = {\n  locate: LocateResultElement;\n};\n\nexport const defineActionHover = (\n  hover: NonNullable<PointerInputPrimitives['hover']>,\n): DeviceAction<ActionHoverParam> => {\n  return defineLocatedPointAction<\n    typeof actionHoverParamSchema,\n    ActionHoverParam\n  >({\n    name: 'Hover',\n    description: 'Move the mouse to the element',\n    interfaceAlias: 'aiHover',\n    paramSchema: actionHoverParamSchema,\n    sample: {\n      locate: { prompt: 'the navigation menu item \"Products\"' },\n    },\n    missingLocateMessage: 'Element not found, cannot hover',\n    call: async (point) => {\n      await hover(point);\n    },\n  });\n};\n\n// Input\nconst inputLocateDescription =\n  'the position of the placeholder or text content in the target input field. If there is no content, locate the center of the input field.';\nexport const actionInputParamSchema = z.object({\n  value: z\n    .union([z.string(), z.number()])\n    .transform((val) => String(val))\n    .describe(\n      'The text to input. Provide the final content for replace mode, only the inserted characters for typeOnly mode, or an empty string when using clear mode to remove existing text.',\n    ),\n  locate: getMidsceneLocationSchema()\n    .describe(inputLocateDescription)\n    .optional(),\n  mode: z\n    .enum(['replace', 'clear', 'typeOnly'])\n    .default('replace')\n    .describe(\n      'Input mode: \"replace\" (default) - clear the field and input the value; \"typeOnly\" - type the value directly without clearing the field first, and should be set explicitly for incremental edits after moving the cursor; \"clear\" - clear the field without inputting new text.',\n    ),\n  autoDismissKeyboard: z\n    .boolean()\n    .optional()\n    .describe(\n      'If true, the keyboard will be dismissed after the input is completed. Do not set it unless the user asks you to do so.',\n    ),\n  keyboardTypeDelay: z\n    .number()\n    .finite()\n    .nonnegative()\n    .optional()\n    .describe(\n      'Delay in milliseconds between keystrokes when typing. Passed through from device/user configuration. Do not set it unless the user asks you to do so.',\n    ),\n  inputStrategy: z\n    .enum(inputStrategies)\n    .optional()\n    .describe(\n      'Text input strategy: \"legacy\" (default) preserves the current platform behavior; \"sequential\" enters one Unicode code point at a time; \"bulk\" sends the complete text through one platform input operation when supported and requires keyboardTypeDelay to be omitted or set to 0. Do not set it unless the user asks you to do so.',\n    ),\n});\nexport type ActionInputParam = {\n  value: string;\n  locate?: LocateResultElement;\n  mode?: 'replace' | 'clear' | 'typeOnly' | 'append';\n  autoDismissKeyboard?: boolean;\n  keyboardTypeDelay?: number;\n  inputStrategy?: InputStrategy;\n};\n\nexport const defineActionInput = (\n  keyboard: KeyboardInputPrimitives,\n): DeviceAction<ActionInputParam> => {\n  return defineAction<typeof actionInputParamSchema, ActionInputParam>({\n    name: 'Input',\n    description: 'Input the value into the element',\n    interfaceAlias: 'aiInput',\n    paramSchema: actionInputParamSchema,\n    sample: {\n      value: 'test@example.com',\n      locate: { prompt: 'the email input field' },\n    },\n    call: async (param, context) => {\n      // backward compat: convert deprecated 'append' to 'typeOnly'\n      if ((param.mode as string) === 'append') {\n        param.mode = 'typeOnly';\n      }\n\n      if (param.mode === 'clear') {\n        await keyboard.clearInput(param.locate);\n        return;\n      }\n\n      if (!param || !param.value) {\n        return;\n      }\n\n      await keyboard.typeText(param.value, {\n        target: param.locate,\n        replace: param.mode !== 'typeOnly',\n        autoDismissKeyboard: param.autoDismissKeyboard,\n        keyboardTypeDelay: param.keyboardTypeDelay,\n        inputStrategy: param.inputStrategy,\n        ...(context?.skipDefaultWait ? { skipDefaultWait: true } : {}),\n      });\n    },\n  });\n};\n\n// KeyboardPress\nexport const actionKeyboardPressParamSchema = z.object({\n  locate: getMidsceneLocationSchema()\n    .describe(\n      'The optional element to click before pressing the key. Omit this when the key should operate on the currently focused element, especially when copying or cutting an existing text selection.',\n    )\n    .optional(),\n  keyName: z\n    .string()\n    .describe(\n      \"The key to be pressed. Use '+' for key combinations, e.g., 'Control+A', 'Shift+Enter'\",\n    ),\n});\nexport type ActionKeyboardPressParam = {\n  locate?: LocateResultElement;\n  keyName: string;\n};\n\nexport const defineActionKeyboardPress = (\n  keyboardPress: KeyboardInputPrimitives['keyboardPress'],\n): DeviceAction<ActionKeyboardPressParam> => {\n  return defineAction<\n    typeof actionKeyboardPressParamSchema,\n    ActionKeyboardPressParam\n  >({\n    name: 'KeyboardPress',\n    description:\n      'Press a key or key combination, like \"Enter\", \"Tab\", \"Escape\", or \"Control+A\", \"Shift+Enter\". Do not use this to type text. Omit locate to operate on the current focus without clicking again, especially for Copy or Cut after text has been selected.',\n    interfaceAlias: 'aiKeyboardPress',\n    paramSchema: actionKeyboardPressParamSchema,\n    sample: {\n      keyName: 'Enter',\n    },\n    call: async (param) => {\n      await keyboardPress(param.keyName, {\n        target: param.locate,\n      });\n    },\n  });\n};\n\n// Scroll\nexport const actionScrollParamSchema = z.object({\n  scrollType: z\n    .enum([\n      'singleAction',\n      'scrollToBottom',\n      'scrollToTop',\n      'scrollToRight',\n      'scrollToLeft',\n    ])\n    .default('singleAction')\n    .describe(\n      'The scroll behavior: \"singleAction\" for a single scroll action, \"scrollToBottom\" for scrolling all the way to the bottom by rapidly scrolling 5-10 times (skipping intermediate content until reaching the bottom), \"scrollToTop\" for scrolling all the way to the top by rapidly scrolling 5-10 times (skipping intermediate content until reaching the top), \"scrollToRight\" for scrolling all the way to the right by rapidly scrolling multiple times, \"scrollToLeft\" for scrolling all the way to the left by rapidly scrolling multiple times',\n    ),\n  direction: z\n    .enum(['down', 'up', 'right', 'left'])\n    .default('down')\n    .describe(\n      'The direction toward the off-screen content to reveal. \"down\" reveals content below the current viewport, \"up\" reveals content above, \"right\" reveals content to the right, and \"left\" reveals content to the left. This does not describe the movement direction of the content currently visible on the screen. Only effective when scrollType is \"singleAction\".',\n    ),\n  distance: z\n    .number()\n    .positive()\n    .nullable()\n    .optional()\n    .describe(\n      'Positive requested scroll amount in screen-coordinate units. On touch platforms, it controls the length of the swipe gesture used to scroll; on web and desktop platforms, it controls or approximates the wheel scroll delta. Only effective when scrollType is \"singleAction\".',\n    ),\n  locate: getMidsceneLocationSchema()\n    .optional()\n    .describe(\n      'Describe the target element to be scrolled on, like \"the table\" or \"the list\" or \"the content area\" or \"the scrollable area\". Do NOT provide a general intent like \"scroll to find some element\"',\n    ),\n});\n\nexport const defineActionScroll = (\n  scroll: ScrollInputPrimitives['scroll'],\n): DeviceAction<ActionScrollParam> => {\n  return defineAction<typeof actionScrollParamSchema, ActionScrollParam>({\n    name: 'Scroll',\n    description:\n      'Scroll a page or scrollable region to reveal off-screen content. Use Scroll when the goal is to browse content outside the current viewport. For direct gesture interactions, such as adjusting a slider or wheel picker, switching between paged cards or images, following an on-screen swipe gesture to continue or dismiss, or swiping an item to delete it, use Swipe instead if available in the current Action Space. Supports scrollToBottom/scrollToTop for boundary navigation. Default: direction `down`, scrollType `singleAction`, distance `null`.',\n    interfaceAlias: 'aiScroll',\n    paramSchema: actionScrollParamSchema,\n    sample: {\n      direction: 'down',\n      scrollType: 'singleAction',\n      locate: { prompt: 'the center of the product list area' },\n    },\n    call: async (param, context) => {\n      if (context?.skipDefaultWait)\n        await scroll(param, { skipDefaultWait: true });\n      else await scroll(param);\n    },\n  });\n};\n\n// DragAndDrop\nexport const actionDragAndDropParamSchema = z.object({\n  from: getMidsceneLocationSchema().describe('The position to be dragged'),\n  to: getMidsceneLocationSchema().describe('The position to be dropped'),\n});\nexport type ActionDragAndDropParam = {\n  from: LocateResultElement;\n  to: LocateResultElement;\n};\n\nexport const defineActionDragAndDrop = (\n  dragAndDrop: NonNullable<PointerInputPrimitives['dragAndDrop']>,\n): DeviceAction<ActionDragAndDropParam> => {\n  return defineAction<\n    typeof actionDragAndDropParamSchema,\n    ActionDragAndDropParam\n  >({\n    name: 'DragAndDrop',\n    description:\n      'Pick up a specific UI element and move it to a new position (e.g., reorder a card, move a file into a folder, sort list items). The element itself moves with your finger/mouse.',\n    interfaceAlias: 'aiDragAndDrop',\n    paramSchema: actionDragAndDropParamSchema,\n    sample: {\n      from: { prompt: 'the \"report.pdf\" file icon' },\n      to: { prompt: 'the upload drop zone' },\n    },\n    call: async (param) => {\n      const from = param.from;\n      const to = param.to;\n      if (!from) {\n        throw new Error('missing \"from\" param for drag and drop');\n      }\n      if (!to) {\n        throw new Error('missing \"to\" param for drag and drop');\n      }\n      await dragAndDrop(\n        { x: from.center[0], y: from.center[1] },\n        { x: to.center[0], y: to.center[1] },\n      );\n    },\n  });\n};\n\nexport const ActionLongPressParamSchema = z.object({\n  locate: getMidsceneLocationSchema().describe(\n    'The element to be long pressed',\n  ),\n  duration: z\n    .number()\n    .optional()\n    .describe('Long press duration in milliseconds'),\n});\n\nexport type ActionLongPressParam = {\n  locate: LocateResultElement;\n  duration?: number;\n};\nexport const defineActionLongPress = (\n  longPress: NonNullable<PointerInputPrimitives['longPress']>,\n): DeviceAction<ActionLongPressParam> => {\n  return defineLocatedPointAction<\n    typeof ActionLongPressParamSchema,\n    ActionLongPressParam\n  >({\n    name: 'LongPress',\n    description: 'Long press the element',\n    interfaceAlias: 'aiLongPress',\n    paramSchema: ActionLongPressParamSchema,\n    sample: {\n      locate: { prompt: 'the message bubble' },\n    },\n    missingLocateMessage: 'LongPress requires an element to be located',\n    call: async (point, param) => {\n      await longPress(point, { duration: param.duration });\n    },\n  });\n};\n\nfunction createActionSwipeParamSchema(inputMode: SwipeInputMode) {\n  const movementSource = inputMode === 'touch' ? 'finger' : 'pointer';\n\n  return z.object({\n    start: getMidsceneLocationSchema()\n      .optional()\n      .describe(\n        `Optional starting point of the ${movementSource} movement. Available in both relative and endpoint forms. If omitted, the center of the page is used.`,\n      ),\n    direction: z\n      .enum(['up', 'down', 'left', 'right'])\n      .optional()\n      .describe(\n        `${movementSource === 'finger' ? 'Finger' : 'Pointer'} movement direction. Required together with a positive distance for a relative swipe. Omit when using end.`,\n      ),\n    distance: z\n      .number()\n      .positive()\n      .optional()\n      .describe(\n        `Positive length of the ${movementSource} movement in pixels. Required together with direction for a relative swipe. Omit when using end.`,\n      ),\n    end: getMidsceneLocationSchema()\n      .optional()\n      .describe(\n        `Endpoint of the ${movementSource} movement. Use for an endpoint swipe, optionally with start. Do not provide direction or distance when using end.`,\n      ),\n    duration: z\n      .number()\n      .default(300)\n      .describe('Duration of the swipe gesture in milliseconds'),\n    repeat: z\n      .number()\n      .optional()\n      .describe(\n        'The number of times to repeat the swipe gesture. 1 for default, 0 for infinite (e.g. endless swipe until the end of the page)',\n      ),\n  });\n}\n\n// Preserve the historical touch-oriented public schema. Desktop actions use\n// an equivalent schema with mouse-specific descriptions at definition time.\nexport const ActionSwipeParamSchema = createActionSwipeParamSchema('touch');\n\nexport type ActionSwipeParam = {\n  start?: LocateResultElement;\n  direction?: 'up' | 'down' | 'left' | 'right';\n  distance?: number;\n  end?: LocateResultElement;\n  duration?: number;\n  repeat?: number;\n};\n\nexport function normalizeSwipeParam(\n  param: ActionSwipeParam,\n  screenSize: { width: number; height: number },\n): {\n  startPoint: { x: number; y: number };\n  endPoint: { x: number; y: number };\n  duration: number;\n  repeatCount: number;\n} {\n  const { width, height } = screenSize;\n  const { start, end } = param;\n\n  const startPoint = start\n    ? { x: start.center[0], y: start.center[1] }\n    : { x: width / 2, y: height / 2 };\n\n  const endPoint = (() => {\n    if (end) {\n      if (param.direction !== undefined || param.distance !== undefined) {\n        throw new Error(\n          'Invalid Swipe parameters: \"end\" cannot be combined with \"direction\" or \"distance\". Use \"end\", optionally with \"start\", for an endpoint swipe.',\n        );\n      }\n\n      return { x: end.center[0], y: end.center[1] };\n    }\n\n    if (param.direction === undefined || param.distance === undefined) {\n      throw new Error(\n        'Invalid Swipe parameters: a relative swipe requires both \"direction\" and a positive \"distance\".',\n      );\n    }\n\n    if (param.distance <= 0) {\n      throw new Error(\n        'Invalid Swipe parameters: \"distance\" must be a positive number.',\n      );\n    }\n\n    return {\n      x:\n        startPoint.x +\n        (param.direction === 'right'\n          ? param.distance\n          : param.direction === 'left'\n            ? -param.distance\n            : 0),\n      y:\n        startPoint.y +\n        (param.direction === 'down'\n          ? param.distance\n          : param.direction === 'up'\n            ? -param.distance\n            : 0),\n    };\n  })();\n\n  endPoint.x = Math.max(0, Math.min(endPoint.x, width));\n  endPoint.y = Math.max(0, Math.min(endPoint.y, height));\n\n  const duration = param.duration ?? 300;\n\n  let repeatCount = typeof param.repeat === 'number' ? param.repeat : 1;\n  if (repeatCount === 0) {\n    repeatCount = 10;\n  }\n\n  return { startPoint, endPoint, duration, repeatCount };\n}\n\n/** @deprecated Use {@link normalizeSwipeParam} instead. */\nexport const normalizeMobileSwipeParam = normalizeSwipeParam;\n\nexport const defineActionSwipe = (config: {\n  swipe: SwipeInputPrimitive;\n  size(): Promise<Size>;\n  inputMode?: SwipeInputMode;\n}): DeviceAction<ActionSwipeParam> => {\n  const inputMode = config.inputMode ?? 'touch';\n  return defineAction<typeof ActionSwipeParamSchema, ActionSwipeParam>({\n    name: 'Swipe',\n    description:\n      inputMode === 'touch'\n        ? 'Perform a touch gesture that directly manipulates the UI (e.g., adjust a continuous control such as a slider or wheel picker, switch between paged cards or images, follow an on-screen swipe gesture to continue or dismiss, or swipe an item to delete it). For browsing off-screen content in a page or scrollable region, use Scroll instead. Choose exactly one movement form: (1) relative swipe — provide \"direction\" and a positive \"distance\"; or (2) endpoint swipe — provide \"end\". \"start\" is optional for both forms and defaults to the center of the page. Do not combine \"end\" with \"direction\" or \"distance\".'\n        : 'Perform a primary-mouse-button gesture that continuously presses and moves the pointer across the desktop UI. Use it to adjust a continuous control such as a slider or wheel picker, switch between paged cards or images, follow an on-screen swipe gesture to continue or dismiss, or swipe an item to delete it. For browsing off-screen content in a page or scrollable region, use Scroll instead. Choose exactly one movement form: (1) relative swipe — provide \"direction\" and a positive \"distance\"; or (2) endpoint swipe — provide \"end\". \"start\" is optional for both forms and defaults to the center of the page. Do not combine \"end\" with \"direction\" or \"distance\".',\n    interfaceAlias: 'aiSwipe',\n    paramSchema:\n      inputMode === 'touch'\n        ? ActionSwipeParamSchema\n        : createActionSwipeParamSchema(inputMode),\n    sample: {\n      start: { prompt: 'center of the notification' },\n      end: { prompt: 'upper edge of the screen' },\n    },\n    call: async (param) => {\n      const { startPoint, endPoint, duration, repeatCount } =\n        normalizeSwipeParam(param, await config.size());\n      for (let i = 0; i < repeatCount; i++) {\n        await config.swipe(startPoint, endPoint, { duration });\n      }\n    },\n  });\n};\n\n// ClearInput\nexport const actionClearInputParamSchema = z.object({\n  locate: getMidsceneLocationSchema()\n    .describe('The input field to be cleared')\n    .optional(),\n});\nexport type ActionClearInputParam = {\n  locate?: LocateResultElement;\n};\n\nexport const defineActionClearInput = (\n  clearInput: KeyboardInputPrimitives['clearInput'],\n): DeviceAction<ActionClearInputParam> => {\n  return defineAction<\n    typeof actionClearInputParamSchema,\n    ActionClearInputParam\n  >({\n    name: 'ClearInput',\n    description: inputLocateDescription,\n    interfaceAlias: 'aiClearInput',\n    paramSchema: actionClearInputParamSchema,\n    sample: {\n      locate: { prompt: 'the search input field' },\n    },\n    call: async (param) => {\n      await clearInput(param.locate);\n    },\n  });\n};\n\n// CursorMove\nexport const actionCursorMoveParamSchema = z.object({\n  direction: z\n    .enum(['left', 'right'])\n    .describe('The direction to move the cursor'),\n  times: z\n    .number()\n    .int()\n    .min(1)\n    .default(1)\n    .describe(\n      'The number of times to move the cursor in the specified direction',\n    ),\n});\nexport type ActionCursorMoveParam = {\n  direction: 'left' | 'right';\n  times?: number;\n};\n\nexport const defineActionCursorMove = (config: {\n  keyboard: Pick<KeyboardInputPrimitives, 'keyboardPress' | 'cursorMove'>;\n  sleep?(timeMs: number): Promise<void>;\n}): DeviceAction<ActionCursorMoveParam> => {\n  return defineAction<\n    typeof actionCursorMoveParamSchema,\n    ActionCursorMoveParam\n  >({\n    name: 'CursorMove',\n    description:\n      'Move the text cursor (caret) left or right within an input field or text area. Use this to reposition the cursor without selecting text.',\n    paramSchema: actionCursorMoveParamSchema,\n    sample: {\n      direction: 'left',\n      times: 3,\n    },\n    call: async (param) => {\n      const times = param.times ?? 1;\n      if (config.keyboard.cursorMove) {\n        await config.keyboard.cursorMove(param.direction, times);\n        return;\n      }\n\n      const wait =\n        config.sleep ??\n        ((timeMs: number) =>\n          new Promise<void>((resolve) => setTimeout(resolve, timeMs)));\n      const arrowKey = param.direction === 'left' ? 'ArrowLeft' : 'ArrowRight';\n      for (let i = 0; i < times; i++) {\n        await config.keyboard.keyboardPress(arrowKey);\n        await wait(100);\n      }\n    },\n  });\n};\n\n// Pinch\nexport const ActionPinchParamSchema = z.object({\n  locate: getMidsceneLocationSchema()\n    .optional()\n    .describe(\n      'The element to pinch on. If not specified, the center of the screen will be used',\n    ),\n  direction: z\n    .enum(['in', 'out'])\n    .describe(\n      'Pinch direction. \"in\" = pinch fingers together (zoom out / shrink), \"out\" = spread fingers apart (zoom in / enlarge).',\n    ),\n  distance: z\n    .number()\n    .positive()\n    .optional()\n    .describe(\n      'How far each finger moves in pixels. Defaults to a quarter of the shorter screen dimension.',\n    ),\n  duration: z\n    .number()\n    .default(500)\n    .optional()\n    .describe('Duration of the pinch gesture in milliseconds'),\n});\n\nexport type ActionPinchParam = {\n  locate?: LocateResultElement;\n  direction: 'in' | 'out';\n  distance?: number;\n  duration?: number;\n};\n\nexport const defineActionPinch = (config: {\n  pinch: TouchInputPrimitives['pinch'];\n  size(): Promise<Size>;\n}): DeviceAction<ActionPinchParam> | undefined => {\n  if (!config.pinch) {\n    return undefined;\n  }\n\n  return defineAction<typeof ActionPinchParamSchema, ActionPinchParam>({\n    name: 'Pinch',\n    description:\n      'Perform a two-finger pinch gesture. Use direction \"in\" to pinch fingers together (zoom out), or \"out\" to spread fingers apart (zoom in). Optionally specify distance for how far each finger moves.',\n    interfaceAlias: 'aiPinch',\n    paramSchema: ActionPinchParamSchema,\n    sample: {\n      locate: { prompt: 'the map area' },\n      direction: 'out',\n      distance: 200,\n    },\n    call: async (param) => {\n      const { centerX, centerY, startDistance, endDistance, duration } =\n        normalizePinchParam(param, await config.size());\n      await config.pinch?.(\n        { x: centerX, y: centerY },\n        { startDistance, endDistance, duration },\n      );\n    },\n  });\n};\n\nexport function normalizePinchParam(\n  param: ActionPinchParam,\n  screenSize: { width: number; height: number },\n): {\n  centerX: number;\n  centerY: number;\n  startDistance: number;\n  endDistance: number;\n  duration: number;\n} {\n  const { width, height } = screenSize;\n  const element = param.locate;\n  const centerX = element\n    ? Math.round(element.center[0])\n    : Math.round(width / 2);\n  const centerY = element\n    ? Math.round(element.center[1])\n    : Math.round(height / 2);\n  const duration = param.duration ?? 500;\n\n  const baseDistance = Math.round(Math.min(width, height) / 4);\n  const fingerDistance = param.distance ?? baseDistance;\n\n  const startDistance = baseDistance;\n  const endDistance =\n    param.direction === 'out'\n      ? baseDistance + fingerDistance\n      : Math.max(10, baseDistance - fingerDistance);\n\n  return { centerX, centerY, startDistance, endDistance, duration };\n}\n\nexport interface MobileInputActionContext {\n  input: MobileInputPrimitives;\n  size(): Promise<Size>;\n  sleep?(timeMs: number): Promise<void>;\n  getDefaultAutoDismissKeyboard?(): boolean | undefined;\n  systemActions?: SystemInputActionOptions;\n}\n\nexport interface SystemInputActionConfig {\n  name: string;\n  description: string;\n  interfaceAlias?: string;\n  delayBeforeRunner?: number;\n  delayAfterRunner?: number;\n}\n\nexport interface SystemInputActionOptions {\n  backButton?: SystemInputActionConfig;\n  homeButton?: SystemInputActionConfig;\n  recentAppsButton?: SystemInputActionConfig;\n}\n\nexport interface InputPrimitiveActionOptions {\n  size?: () => Promise<Size>;\n  sleep?: (timeMs: number) => Promise<void>;\n  includeSwipe?: boolean;\n  includePinch?: boolean;\n  systemActions?: SystemInputActionOptions;\n}\n\nfunction defineSystemInputAction(\n  config: SystemInputActionConfig,\n  call: () => Promise<void>,\n): DeviceAction<undefined, void> {\n  return defineAction<undefined, undefined, void>({\n    name: config.name,\n    description: config.description,\n    interfaceAlias: config.interfaceAlias,\n    delayBeforeRunner: config.delayBeforeRunner,\n    delayAfterRunner: config.delayAfterRunner,\n    call,\n  });\n}\n\nexport function defineActionsFromInputPrimitives(\n  input: InputPrimitives,\n  options: InputPrimitiveActionOptions = {},\n): DeviceAction<any>[] {\n  const actions: Array<DeviceAction<any> | undefined> = [];\n  const { pointer, keyboard, scroll, touch, system } = input;\n\n  if (pointer) {\n    actions.push(defineActionTap(pointer.tap));\n    if (pointer.doubleClick) {\n      actions.push(defineActionDoubleClick(pointer.doubleClick));\n    }\n    if (pointer.rightClick) {\n      actions.push(defineActionRightClick(pointer.rightClick));\n    }\n    if (pointer.hover) {\n      actions.push(defineActionHover(pointer.hover));\n    }\n    if (pointer.dragAndDrop) {\n      actions.push(defineActionDragAndDrop(pointer.dragAndDrop));\n    }\n    if (pointer.longPress) {\n      actions.push(defineActionLongPress(pointer.longPress));\n    }\n  }\n\n  if (keyboard) {\n    actions.push(\n      defineActionInput(keyboard),\n      defineActionClearInput(keyboard.clearInput),\n      defineActionKeyboardPress(keyboard.keyboardPress),\n      defineActionCursorMove({ keyboard, sleep: options.sleep }),\n    );\n  }\n\n  if (scroll) {\n    actions.push(defineActionScroll(scroll.scroll));\n  }\n\n  const swipeConfig = resolveSwipeInputPrimitive({ pointer, touch });\n  if (swipeConfig && options.size && options.includeSwipe !== false) {\n    actions.push(defineActionSwipe({ ...swipeConfig, size: options.size }));\n  }\n\n  if (touch?.pinch && options.size && options.includePinch !== false) {\n    actions.push(defineActionPinch({ pinch: touch.pinch, size: options.size }));\n  }\n\n  if (system && options.systemActions) {\n    const { systemActions } = options;\n    if (system.backButton && systemActions.backButton) {\n      actions.push(\n        defineSystemInputAction(systemActions.backButton, system.backButton),\n      );\n    }\n    if (system.homeButton && systemActions.homeButton) {\n      actions.push(\n        defineSystemInputAction(systemActions.homeButton, system.homeButton),\n      );\n    }\n    if (system.recentAppsButton && systemActions.recentAppsButton) {\n      actions.push(\n        defineSystemInputAction(\n          systemActions.recentAppsButton,\n          system.recentAppsButton,\n        ),\n      );\n    }\n  }\n\n  return actions.filter((action): action is DeviceAction<any> =>\n    Boolean(action),\n  );\n}\n\nexport function createDefaultMobileActions(\n  context: MobileInputActionContext,\n): DeviceAction<any>[] {\n  return defineActionsFromInputPrimitives(context.input, {\n    size: context.size,\n    sleep: context.sleep,\n    systemActions: context.systemActions,\n  });\n}\n\n// Sleep\nexport const ActionSleepParamSchema = z.object({\n  timeMs: z\n    .number()\n    .default(1000)\n    .optional()\n    .describe('Sleep duration in milliseconds, defaults to 1000ms (1 second)'),\n});\n\nexport type ActionSleepParam = {\n  timeMs?: number;\n};\n\nexport const defineActionSleep = (\n  abortSignal?: AbortSignal,\n): DeviceAction<ActionSleepParam> => {\n  return defineAction<typeof ActionSleepParamSchema, ActionSleepParam>({\n    name: 'Sleep',\n    description:\n      'Wait for a specified duration before continuing. Defaults to 1 second (1000ms) if not specified.',\n    paramSchema: ActionSleepParamSchema,\n    sample: {\n      timeMs: 2000,\n    },\n    call: async (param, context) => {\n      const signal = abortSignal ?? context?.signal;\n      const duration = param?.timeMs ?? 1000;\n      getDebug('device:common-action')(`Sleeping for ${duration}ms`);\n      signal?.throwIfAborted();\n      await new Promise<void>((resolve, reject) => {\n        const abort = () => {\n          clearTimeout(timer);\n          reject(signal?.reason);\n        };\n        const timer = setTimeout(() => {\n          signal?.removeEventListener('abort', abort);\n          resolve();\n        }, duration);\n        signal?.addEventListener('abort', abort, { once: true });\n      });\n    },\n  });\n};\n\nexport type { DeviceAction } from '../types';\nexport type { ActionScrollParam, LocateResultElement, Size } from '../types';\nexport { getMidsceneLocationSchema } from '../common';\nexport { z };\nexport {\n  inputStrategies,\n  type InputStrategy,\n  type ResolvedTextInputOptions,\n  type SequentialTextInputHandlers,\n  type TextInputOptions,\n  resolveInputStrategy,\n  resolveTextInputOptions,\n  sendTextSequentially,\n  shouldInputSequentially,\n} from './input-strategy';\nexport type {\n  AndroidDeviceOpt,\n  AndroidDeviceInputOpt,\n  IOSDeviceOpt,\n  IOSDeviceInputOpt,\n  HarmonyDeviceOpt,\n  HarmonyDeviceInputOpt,\n} from './device-options';\n"],"names":["resolveSwipeInputPrimitive","input","AbstractInterface","_actionName","_param","_signal","defineAction","config","pointFromLocate","locate","missingMessage","Error","defineLocatedPointAction","param","actionTapParamSchema","z","getMidsceneLocationSchema","defineActionTap","tap","point","registerFileChooserAcceptParamSchema","defineActionRegisterFileChooserAccept","register","actionRightClickParamSchema","defineActionRightClick","rightClick","actionDoubleClickParamSchema","defineActionDoubleClick","doubleClick","actionHoverParamSchema","defineActionHover","hover","inputLocateDescription","actionInputParamSchema","val","String","inputStrategies","defineActionInput","keyboard","context","actionKeyboardPressParamSchema","defineActionKeyboardPress","keyboardPress","actionScrollParamSchema","defineActionScroll","scroll","actionDragAndDropParamSchema","defineActionDragAndDrop","dragAndDrop","from","to","ActionLongPressParamSchema","defineActionLongPress","longPress","createActionSwipeParamSchema","inputMode","movementSource","ActionSwipeParamSchema","normalizeSwipeParam","screenSize","width","height","start","end","startPoint","endPoint","undefined","Math","duration","repeatCount","normalizeMobileSwipeParam","defineActionSwipe","i","actionClearInputParamSchema","defineActionClearInput","clearInput","actionCursorMoveParamSchema","defineActionCursorMove","times","wait","timeMs","Promise","resolve","setTimeout","arrowKey","ActionPinchParamSchema","defineActionPinch","centerX","centerY","startDistance","endDistance","normalizePinchParam","element","baseDistance","fingerDistance","defineSystemInputAction","call","defineActionsFromInputPrimitives","options","actions","pointer","touch","system","swipeConfig","systemActions","action","Boolean","createDefaultMobileActions","ActionSleepParamSchema","defineActionSleep","abortSignal","signal","getDebug","reject","abort","clearTimeout","timer"],"mappings":"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"}

package/dist/es/report-generator.mjs

@@ -142,22 +142,21 @@ ${generateAgentReportComment(agentDump)}`;
     enableSourceSnapshots() {
         this.screenshotStore.enableFileCopies();
     }
-    async serializeSourceDump() {
+    async serializeSourceDump(frozenDump, screenshots) {
         this.enableSourceSnapshots();
+        const executions = frozenDump?.executions ?? [
+            ...this.executionsByKey.values()
+        ];
         const references = new Map();
-        for (const execution of this.executionsByKey.values()){
-            for (const screenshot of execution.collectScreenshots())await this.screenshotStore.persist(screenshot);
-            for (const [url, ref] of (await this.persistReferenceImages(execution)))references.set(url, ref);
-        }
-        const dump = new ReportActionDump({
+        for (const screenshot of screenshots ?? executions.flatMap((execution)=>execution.collectScreenshots()))await this.screenshotStore.persist(screenshot);
+        for (const execution of executions)for (const [url, ref] of (await this.persistReferenceImages(execution)))references.set(url, ref);
+        const dump = frozenDump ?? new ReportActionDump({
             ...this.lastReportMeta ?? {
                 sdkVersion: '',
                 groupName: 'YAML execution',
                 modelBriefs: []
             },
-            executions: [
-                ...this.executionsByKey.values()
-            ]
+            executions
         });
         const images = new Map();
         const serialized = JSON.stringify(JSON.parse(dump.serializeWithReferenceImages(references)), (_key, value)=>{
@@ -176,11 +175,24 @@ ${generateAgentReportComment(agentDump)}`;
             images
         };
     }
-    async createSourceSnapshot(scopeId) {
+    async createSourceSnapshot(scopeId, executionIds) {
         if (!scopeId || basename(scopeId) !== scopeId) throw new Error('Invalid report scope ID');
-        await this.flush();
-        const { serialized } = await this.serializeSourceDump();
-        const dumpPath = `${this.reportPath}.${scopeId}.json`;
+        const capturedAt = new Date().toISOString();
+        const selectedIds = executionIds ? new Set(executionIds) : void 0;
+        const executions = [
+            ...this.executionsByKey.values()
+        ].filter((execution)=>!selectedIds || execution.id && selectedIds.has(execution.id));
+        const screenshots = executions.flatMap((execution)=>execution.collectScreenshots());
+        const frozen = ReportActionDump.fromSerializedString(new ReportActionDump({
+            ...this.lastReportMeta ?? {
+                sdkVersion: '',
+                groupName: 'YAML execution',
+                modelBriefs: []
+            },
+            executions
+        }).serialize());
+        const { serialized } = await this.serializeSourceDump(frozen, screenshots);
+        const dumpPath = `${this.reportPath}.${scopeId}.${uuid()}.json`;
         mkdirSync(dirname(dumpPath), {
             recursive: true
         });
@@ -189,7 +201,11 @@ ${generateAgentReportComment(agentDump)}`;
         });
         return {
             sourcePath: this.reportPath,
-            dumpPath
+            dumpPath,
+            collection: {
+                status: 'complete',
+                capturedAt
+            }
         };
     }
     printReportPath() {

package/dist/es/report-generator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"report-generator.mjs","sources":["../../src/report-generator.ts"],"sourcesContent":["/*\n * PERF INVARIANT — DO NOT reintroduce sync fs APIs (writeFileSync /\n * appendFileSync) in this file's write paths. `ReportGenerator` runs on\n * the Electron main event loop during agent execution, and a single\n * progress tick appends a multi-MB ExecutionDump payload. Sync I/O here\n * blocked the loop for 20+ seconds per run, freezing IPC, scrcpy and\n * every renderer round-trip. Always use `fs/promises`. See commit\n * 6a25e05c and `report-generator-async-contract.test.ts`.\n */\nimport { existsSync, mkdirSync, readdirSync } from 'node:fs';\nimport {\n  appendFile as appendFileAsync,\n  readFile as readFileAsync,\n  rename as renameAsync,\n  unlink as unlinkAsync,\n  writeFile as writeFileAsync,\n} from 'node:fs/promises';\nimport { basename, dirname, join } from 'node:path';\nimport { getMidsceneRunSubDir } from '@midscene/shared/common';\nimport {\n  MIDSCENE_REPORT_QUIET,\n  globalConfigManager,\n} from '@midscene/shared/env';\nimport { getDebug } from '@midscene/shared/logger';\nimport { ifInBrowser, logMsg, uuid } from '@midscene/shared/utils';\nimport {\n  DATA_SCREENSHOT_MODE_ATTR,\n  generateAgentReportComment,\n  generateDumpScriptTag,\n  generateImageScriptTag,\n  generateTestRunReportScriptTag,\n  getBaseUrlFixScript,\n} from './dump/html-utils';\nimport {\n  imageRefFileExtension,\n  normalizeStoredImageRef,\n} from './dump/image-reference';\nimport { compactReportDumps } from './dump/report-dump-compactor';\nimport { type ImageUrlRef, ReportImageStore } from './dump/screenshot-store';\nimport type { WorkflowReportSource } from './test-runner/engine/types';\nimport { buildAgentTestRunReportDump } from './test-runner/reporting/agent-report';\nimport type { RunReportInput } from './test-runner/reporting/types';\nimport {\n  type ExecutionDump,\n  ReportActionDump,\n  type ReportAttributes,\n  type ReportMeta,\n  type ScreenshotMode,\n} from './types';\nimport { getReportTpl } from './utils';\n\nconst warnReport = getDebug('report-generator', { console: true });\nconst maxReportFilenameBytes = 255;\n\nexport interface IReportGenerator {\n  /**\n   * Write or update a single execution.\n   * Each call appends a new dump script tag. The frontend deduplicates\n   * executions with the same id/name, keeping only the last one.\n   *\n   * @param execution  Current execution's full data\n   * @param reportMeta  Report-level metadata (groupName, sdkVersion, etc.)\n   */\n  onExecutionUpdate(\n    execution: ExecutionDump,\n    reportMeta: ReportMeta,\n    attributes?: ReportAttributes,\n  ): void;\n\n  /**\n   * @deprecated Use onExecutionUpdate instead. Kept for backward compatibility.\n   */\n  onDumpUpdate?(dump: ReportActionDump): void;\n\n  /**\n   * Wait for all queued write operations to complete.\n   */\n  flush(): Promise<void>;\n  enableSourceSnapshots?(): void;\n  createSourceSnapshot?(\n    scopeId: string,\n  ): Promise<WorkflowReportSource | undefined>;\n\n  /**\n   * Finalize the report. Calls flush() internally.\n   */\n  finalize(): Promise<string | undefined>;\n\n  getReportPath(): string | undefined;\n  /** Publish a single root Runner snapshot into this Agent's existing report. */\n  writeRunnerReport?(\n    input: RunReportInput,\n    scopeId: string,\n    meta: ReportMeta,\n  ): Promise<string | undefined>;\n}\n\nexport const nullReportGenerator: IReportGenerator = {\n  onExecutionUpdate: () => {},\n  flush: async () => {},\n  finalize: async () => undefined,\n  getReportPath: () => undefined,\n  writeRunnerReport: async () => undefined,\n};\n\nexport function assertReportGenerationOptions(opts: {\n  generateReport?: boolean;\n  persistExecutionDump?: boolean;\n}): void {\n  if (opts.generateReport === false && opts.persistExecutionDump === true) {\n    throw new Error(\n      'persistExecutionDump cannot be true when generateReport is false',\n    );\n  }\n}\n\nexport class ReportGenerator implements IReportGenerator {\n  private reportPath: string;\n  private screenshotMode: ScreenshotMode;\n  private shouldPersistExecutionDump: boolean;\n  private autoPrint: boolean;\n  private firstWriteDone = false;\n  private executionLogIndex = 0;\n  private executionLogFileIndexByExecutionKey = new Map<string, number>();\n\n  // Unique identifier for this report stream — used as data-group-id\n  private readonly reportStreamId: string;\n\n  // Tracks screenshots already written to disk (by id) to avoid duplicates\n  private screenshotStore: ReportImageStore;\n  private initialized = false;\n\n  // Tracks the last execution + groupMeta for re-writing on finalize\n  private lastExecution?: ExecutionDump;\n  private lastReportMeta?: ReportMeta;\n  private executionsByKey = new Map<string, ExecutionDump>();\n  private executionCommentKeyByObject = new WeakMap<ExecutionDump, string>();\n  private executionCommentKeyIndex = 0;\n  private reportAttributes: Record<string, string> = {};\n  private agentCommentWritten = false;\n\n  // write queue for serial execution\n  private writeQueue: Promise<void> = Promise.resolve();\n  private destroyed = false;\n\n  constructor(options: {\n    reportPath: string;\n    screenshotMode: ScreenshotMode;\n    persistExecutionDump?: boolean;\n    autoPrint?: boolean;\n    reuseExistingReport?: boolean;\n  }) {\n    this.reportPath = options.reportPath;\n    this.screenshotMode = options.screenshotMode;\n    this.shouldPersistExecutionDump = options.persistExecutionDump ?? false;\n    this.autoPrint = options.autoPrint ?? true;\n    this.reportStreamId = uuid();\n    this.screenshotStore = new ReportImageStore({\n      mode: this.screenshotMode === 'inline' ? 'inline' : 'directory',\n      reportPath: this.reportPath,\n      screenshotsDir: join(dirname(this.reportPath), 'screenshots'),\n      writeInlineImage: async (id, base64) => {\n        await appendFileAsync(\n          this.reportPath,\n          `\\n${generateImageScriptTag(id, base64)}`,\n        );\n      },\n      alsoWriteFileCopy: this.shouldPersistExecutionDump,\n      reuseExistingReport: options.reuseExistingReport,\n    });\n    if (options.reuseExistingReport) {\n      this.hydrateStateFromExistingReport();\n    }\n  }\n\n  static create(\n    reportFileName: string,\n    opts: {\n      generateReport?: boolean;\n      persistExecutionDump?: boolean;\n      outputFormat?: 'single-html' | 'html-and-external-assets';\n      autoPrintReportMsg?: boolean;\n      reuseExistingReport?: boolean;\n    },\n  ): IReportGenerator {\n    assertReportGenerationOptions(opts);\n    validateReportFileName(reportFileName, opts.outputFormat);\n    if (opts.generateReport === false) return nullReportGenerator;\n\n    // In browser environment, file system is not available\n    if (ifInBrowser) return nullReportGenerator;\n\n    const reportRootDir = getMidsceneRunSubDir('report');\n    const outputDir = join(reportRootDir, reportFileName);\n    const reportPath =\n      opts.outputFormat === 'html-and-external-assets'\n        ? join(outputDir, 'index.html')\n        : join(reportRootDir, ensureHtmlFileName(reportFileName));\n    return new ReportGenerator({\n      reportPath,\n      screenshotMode:\n        opts.outputFormat === 'html-and-external-assets'\n          ? 'directory'\n          : 'inline',\n      persistExecutionDump: opts.persistExecutionDump,\n      autoPrint: opts.autoPrintReportMsg,\n      reuseExistingReport: opts.reuseExistingReport,\n    });\n  }\n\n  onExecutionUpdate(\n    execution: ExecutionDump,\n    reportMeta: ReportMeta,\n    attributes?: ReportAttributes,\n  ): void {\n    this.lastExecution = execution;\n    this.lastReportMeta = reportMeta;\n    this.executionsByKey.set(this.getExecutionCommentKey(execution), execution);\n    this.mergeReportAttributes(attributes);\n    this.writeQueue = this.writeQueue.then(async () => {\n      if (this.destroyed) return;\n      await this.doWriteExecution(execution, reportMeta);\n    });\n  }\n\n  async flush(): Promise<void> {\n    await this.writeQueue;\n  }\n\n  async finalize(): Promise<string | undefined> {\n    // Re-write the last execution to capture any final state changes\n    if (this.lastExecution && this.lastReportMeta) {\n      this.onExecutionUpdate(this.lastExecution, this.lastReportMeta);\n    }\n    await this.flush();\n    this.destroyed = true;\n\n    if (!this.initialized) {\n      // No executions were ever written — no file exists\n      return undefined;\n    }\n\n    await this.appendAgentReportComment();\n    try {\n      await compactReportDumps(this.reportPath);\n    } catch (error) {\n      warnReport(\n        `Failed to compact report ${this.reportPath}; keeping the uncompressed report: ${String(error)}`,\n      );\n    }\n    return this.reportPath;\n  }\n\n  getReportPath(): string | undefined {\n    return this.reportPath;\n  }\n\n  async writeRunnerReport(\n    input: RunReportInput,\n    scopeId: string,\n    meta: ReportMeta,\n  ): Promise<string> {\n    this.writeQueue = this.writeQueue.then(async () => {\n      // This runs at YAML invocation completion, never on progress ticks. Keep\n      // all file I/O asynchronous and publish atomically for an open viewer.\n      const reportMeta = this.lastReportMeta ?? meta;\n      const executions = [...this.executionsByKey.values()];\n      const agentDump = new ReportActionDump({ ...reportMeta, executions });\n      const reportId =\n        this.reportAttributes['data-report-id'] ??\n        this.reportAttributes['data-group-id'] ??\n        this.reportStreamId;\n      const dump = buildAgentTestRunReportDump(input, agentDump, {\n        reportId,\n        scopeId,\n        sourcePath: this.reportPath,\n      });\n      for (const diagnostic of dump.diagnostics ?? [])\n        warnReport(diagnostic.message);\n      const sourceDump = await this.serializeSourceDump();\n      const images: string[] = [];\n      if (this.screenshotMode === 'inline') {\n        for (const ref of sourceDump.images.values()) {\n          const bytes = await readFileAsync(\n            join(dirname(this.reportPath), ref.path!),\n          );\n          images.push(\n            generateImageScriptTag(\n              ref.id,\n              `data:${ref.mimeType};base64,${bytes.toString('base64')}`,\n            ),\n          );\n        }\n      }\n      // Rebuild from the owned dump and image index, never parse this HTML back.\n      const renderedDump =\n        this.screenshotMode === 'inline'\n          ? JSON.stringify(JSON.parse(sourceDump.serialized), (_key, value) => {\n              const ref = normalizeStoredImageRef(value);\n              return ref\n                ? { ...ref, storage: 'inline', path: undefined }\n                : value;\n            })\n          : sourceDump.serialized;\n      const contents = `${getReportTpl()}${this.screenshotMode === 'directory' ? getBaseUrlFixScript() : ''}\n${generateDumpScriptTag(renderedDump, this.getDumpScriptAttributes())}\n${images.join('\\n')}\n${generateTestRunReportScriptTag(dump)}\n${generateAgentReportComment(agentDump)}`;\n      mkdirSync(dirname(this.reportPath), { recursive: true });\n      const temporaryPath = `${this.reportPath}.runner-${uuid()}.tmp`;\n      try {\n        await writeFileAsync(temporaryPath, contents);\n        await renameAsync(temporaryPath, this.reportPath);\n      } finally {\n        await unlinkAsync(temporaryPath).catch((error) => {\n          if (error.code !== 'ENOENT') throw error;\n        });\n      }\n      this.initialized = true;\n      if (!this.firstWriteDone) {\n        this.firstWriteDone = true;\n        this.printReportPath();\n      }\n    });\n    await this.flush();\n    return this.reportPath;\n  }\n\n  enableSourceSnapshots(): void {\n    this.screenshotStore.enableFileCopies();\n  }\n\n  private async serializeSourceDump() {\n    this.enableSourceSnapshots();\n    const references = new Map<string, ImageUrlRef>();\n    for (const execution of this.executionsByKey.values()) {\n      for (const screenshot of execution.collectScreenshots())\n        await this.screenshotStore.persist(screenshot);\n      for (const [url, ref] of await this.persistReferenceImages(execution))\n        references.set(url, ref);\n    }\n    const dump = new ReportActionDump({\n      ...(this.lastReportMeta ?? {\n        sdkVersion: '',\n        groupName: 'YAML execution',\n        modelBriefs: [],\n      }),\n      executions: [...this.executionsByKey.values()],\n    });\n    const images = new Map<\n      string,\n      ReturnType<typeof normalizeStoredImageRef> & {}\n    >();\n    const serialized = JSON.stringify(\n      JSON.parse(dump.serializeWithReferenceImages(references)),\n      (_key, value) => {\n        const ref = normalizeStoredImageRef(value);\n        if (!ref) return value;\n        const stored = {\n          ...ref,\n          storage: 'file' as const,\n          path: `./screenshots/${ref.id}.${imageRefFileExtension(ref)}`,\n        };\n        images.set(ref.id, stored);\n        return stored;\n      },\n    );\n    return { serialized, images };\n  }\n\n  async createSourceSnapshot(scopeId: string): Promise<WorkflowReportSource> {\n    // Scope IDs originate in the kernel; never allow a filename to escape the report directory.\n    if (!scopeId || basename(scopeId) !== scopeId)\n      throw new Error('Invalid report scope ID');\n    await this.flush();\n    const { serialized } = await this.serializeSourceDump();\n    const dumpPath = `${this.reportPath}.${scopeId}.json`;\n    mkdirSync(dirname(dumpPath), { recursive: true });\n    await writeFileAsync(dumpPath, serialized, { flag: 'wx' });\n    return { sourcePath: this.reportPath, dumpPath };\n  }\n\n  private printReportPath(): void {\n    if (!this.autoPrint || !this.reportPath) return;\n    if (globalConfigManager.getEnvConfigInBoolean(MIDSCENE_REPORT_QUIET))\n      return;\n\n    if (this.screenshotMode === 'directory') {\n      logMsg(\n        `Midscene - report file updated: npx serve ${dirname(this.reportPath)}`,\n      );\n    } else {\n      logMsg(`Midscene - report file updated: ${this.reportPath}`);\n    }\n  }\n\n  private async doWriteExecution(\n    execution: ExecutionDump,\n    reportMeta: ReportMeta,\n  ): Promise<void> {\n    const singleDump = this.wrapAsReportDump(execution, reportMeta);\n\n    const referenceImageRefs = await this.writeExecution(execution, singleDump);\n\n    if (this.shouldPersistExecutionDump) {\n      await this.persistExecutionDumpToFile(\n        execution,\n        singleDump,\n        referenceImageRefs,\n      );\n    }\n\n    if (!this.firstWriteDone) {\n      this.firstWriteDone = true;\n      this.printReportPath();\n    }\n  }\n\n  private mergeReportAttributes(attributes?: ReportAttributes): void {\n    if (!attributes) {\n      return;\n    }\n\n    for (const [key, value] of Object.entries(attributes)) {\n      if (value === undefined || value === null) {\n        continue;\n      }\n      this.reportAttributes[key] = String(value);\n    }\n  }\n\n  private hydrateStateFromExistingReport(): void {\n    if (!existsSync(this.reportPath)) {\n      return;\n    }\n\n    // Reuse existing report file and append new updates instead of rewriting.\n    this.initialized = true;\n\n    if (!this.shouldPersistExecutionDump) {\n      return;\n    }\n\n    const reportDir = dirname(this.reportPath);\n    const existingExecutionIndices = readdirSync(reportDir)\n      .map((name) => /^(\\d+)\\.execution\\.json$/.exec(name)?.[1])\n      .filter((index): index is string => Boolean(index))\n      .map((index) => Number.parseInt(index, 10))\n      .filter((index) => Number.isFinite(index));\n\n    if (existingExecutionIndices.length > 0) {\n      this.executionLogIndex = Math.max(...existingExecutionIndices);\n    }\n  }\n\n  private getDumpScriptAttributes(): Record<string, string> {\n    return {\n      'data-group-id': this.reportStreamId,\n      // Self-describe how this report file stores screenshots so consumers\n      // (merge/delete) never have to guess the mode from the filesystem.\n      [DATA_SCREENSHOT_MODE_ATTR]: this.screenshotMode,\n      ...this.reportAttributes,\n    };\n  }\n\n  /**\n   * Wrap an ExecutionDump + ReportMeta into a single-execution ReportActionDump.\n   */\n  private wrapAsReportDump(\n    execution: ExecutionDump,\n    reportMeta: ReportMeta,\n  ): ReportActionDump {\n    return new ReportActionDump({\n      sdkVersion: reportMeta.sdkVersion,\n      groupName: reportMeta.groupName,\n      groupDescription: reportMeta.groupDescription,\n      modelBriefs: reportMeta.modelBriefs,\n      deviceType: reportMeta.deviceType,\n      executions: [execution],\n    });\n  }\n\n  /**\n   * Append assets and a dump tag without duplicating mode-specific workflows.\n   * The frontend deduplicates executions with the same id/name (keeps last).\n   * Duplicate dump JSON is acceptable; only screenshots are deduplicated.\n   *\n   * All writes go through `fs/promises` so they run on libuv's thread pool\n   * rather than blocking the Node event loop. A long agent run previously\n   * appended multi-MB dumps (screenshots + serialized tasks) per progress\n   * tick on the main thread, starving IPC and UI for >10s per stall.\n   */\n  private async writeExecution(\n    execution: ExecutionDump,\n    singleDump: ReportActionDump,\n  ): Promise<Map<string, ImageUrlRef>> {\n    const dir = dirname(this.reportPath);\n    if (!existsSync(dir)) {\n      mkdirSync(dir, { recursive: true });\n    }\n\n    // Initialize: write HTML template once\n    if (!this.initialized) {\n      const baseUrlFix =\n        this.screenshotMode === 'directory' ? getBaseUrlFixScript() : '';\n      await writeFileAsync(this.reportPath, `${getReportTpl()}${baseUrlFix}`);\n      this.initialized = true;\n    }\n\n    // Append new screenshots (skip already-written ones)\n    for (const screenshot of execution.collectScreenshots()) {\n      await this.screenshotStore.persist(screenshot);\n    }\n    const referenceImageRefs = await this.persistReferenceImages(execution);\n\n    // Append dump tag (always — frontend keeps only last per execution id)\n    const serialized =\n      singleDump.serializeWithReferenceImages(referenceImageRefs);\n    await appendFileAsync(\n      this.reportPath,\n      `\\n${generateDumpScriptTag(serialized, this.getDumpScriptAttributes())}`,\n    );\n    return referenceImageRefs;\n  }\n\n  private async persistReferenceImages(\n    execution: ExecutionDump,\n  ): Promise<Map<string, ImageUrlRef>> {\n    const refs = new Map<string, ImageUrlRef>();\n    for (const imageUrl of execution.getReferenceImageUrls()) {\n      const ref = await this.screenshotStore.persistReferenceImage(imageUrl);\n      refs.set(imageUrl, ref);\n    }\n    return refs;\n  }\n\n  private async appendAgentReportComment(): Promise<void> {\n    if (\n      this.agentCommentWritten ||\n      !this.lastReportMeta ||\n      this.executionsByKey.size === 0\n    ) {\n      return;\n    }\n\n    const reportDump = new ReportActionDump({\n      sdkVersion: this.lastReportMeta.sdkVersion,\n      groupName: this.lastReportMeta.groupName,\n      groupDescription: this.lastReportMeta.groupDescription,\n      modelBriefs: this.lastReportMeta.modelBriefs,\n      deviceType: this.lastReportMeta.deviceType,\n      executions: Array.from(this.executionsByKey.values()),\n    });\n    await appendFileAsync(\n      this.reportPath,\n      `\\n${generateAgentReportComment(reportDump)}`,\n    );\n    this.agentCommentWritten = true;\n  }\n\n  private getExecutionLogKey(execution: ExecutionDump): string {\n    if (!execution.id) {\n      throw new Error(\n        'ReportGenerator: execution.id is required for persisting execution dumps',\n      );\n    }\n    return `id:${execution.id}`;\n  }\n\n  private getExecutionCommentKey(execution: ExecutionDump): string {\n    if (execution.id) {\n      return `id:${execution.id}`;\n    }\n\n    const existingKey = this.executionCommentKeyByObject.get(execution);\n    if (existingKey) {\n      return existingKey;\n    }\n\n    const key = `no-id:${this.executionCommentKeyIndex++}`;\n    this.executionCommentKeyByObject.set(execution, key);\n    return key;\n  }\n\n  private async persistExecutionDumpToFile(\n    execution: ExecutionDump,\n    singleDump: ReportActionDump,\n    referenceImageRefs: ReadonlyMap<string, ImageUrlRef>,\n  ): Promise<void> {\n    const dir = dirname(this.reportPath);\n    if (!existsSync(dir)) {\n      mkdirSync(dir, { recursive: true });\n    }\n\n    const executionLogKey = this.getExecutionLogKey(execution);\n    let fileIndex =\n      this.executionLogFileIndexByExecutionKey.get(executionLogKey);\n    if (!fileIndex) {\n      this.executionLogIndex += 1;\n      fileIndex = this.executionLogIndex;\n      this.executionLogFileIndexByExecutionKey.set(executionLogKey, fileIndex);\n    }\n\n    const fileName = `${fileIndex}.execution.json`;\n    const filePath = join(dirname(this.reportPath), fileName);\n    await writeFileAsync(\n      filePath,\n      singleDump.serializeWithReferenceImages(referenceImageRefs, 2),\n      'utf-8',\n    );\n  }\n}\n\nfunction ensureHtmlFileName(reportFileName: string): string {\n  return reportFileName.endsWith('.html')\n    ? reportFileName\n    : `${reportFileName}.html`;\n}\n\nfunction validateReportFileName(\n  reportFileName: string,\n  outputFormat?: 'single-html' | 'html-and-external-assets',\n): void {\n  if (!reportFileName?.trim()) {\n    throw new Error('reportFileName must be a non-empty string');\n  }\n\n  if (/[\\\\/]/.test(reportFileName)) {\n    throw new Error(\n      'reportFileName must not contain path separators (`/` or `\\\\\\\\`)',\n    );\n  }\n\n  if (/[:*?\"<>|]/.test(reportFileName)) {\n    throw new Error(\n      'reportFileName contains illegal filename characters: : * ? \" < > |',\n    );\n  }\n\n  const filenameComponent =\n    outputFormat === 'html-and-external-assets'\n      ? reportFileName\n      : ensureHtmlFileName(reportFileName);\n  const filenameBytes = new TextEncoder().encode(filenameComponent).byteLength;\n  if (filenameBytes > maxReportFilenameBytes) {\n    throw new Error(\n      `reportFileName produces a filename component of ${filenameBytes} UTF-8 bytes; maximum is ${maxReportFilenameBytes}`,\n    );\n  }\n}\n"],"names":["warnReport","getDebug","maxReportFilenameBytes","nullReportGenerator","undefined","assertReportGenerationOptions","opts","Error","ReportGenerator","reportFileName","validateReportFileName","ifInBrowser","reportRootDir","getMidsceneRunSubDir","outputDir","join","reportPath","ensureHtmlFileName","execution","reportMeta","attributes","compactReportDumps","error","String","input","scopeId","meta","executions","agentDump","ReportActionDump","reportId","dump","buildAgentTestRunReportDump","diagnostic","sourceDump","images","ref","bytes","readFileAsync","dirname","generateImageScriptTag","renderedDump","JSON","_key","value","normalizeStoredImageRef","contents","getReportTpl","getBaseUrlFixScript","generateDumpScriptTag","generateTestRunReportScriptTag","generateAgentReportComment","mkdirSync","temporaryPath","uuid","writeFileAsync","renameAsync","unlinkAsync","references","Map","screenshot","url","serialized","stored","imageRefFileExtension","basename","dumpPath","globalConfigManager","MIDSCENE_REPORT_QUIET","logMsg","singleDump","referenceImageRefs","key","Object","existsSync","reportDir","existingExecutionIndices","readdirSync","name","index","Boolean","Number","Math","DATA_SCREENSHOT_MODE_ATTR","dir","baseUrlFix","appendFileAsync","refs","imageUrl","reportDump","Array","existingKey","executionLogKey","fileIndex","fileName","filePath","options","WeakMap","Promise","ReportImageStore","id","base64","outputFormat","filenameComponent","filenameBytes","TextEncoder"],"mappings":"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"}
+{"version":3,"file":"report-generator.mjs","sources":["../../src/report-generator.ts"],"sourcesContent":["/*\n * PERF INVARIANT — DO NOT reintroduce sync fs APIs (writeFileSync /\n * appendFileSync) in this file's write paths. `ReportGenerator` runs on\n * the Electron main event loop during agent execution, and a single\n * progress tick appends a multi-MB ExecutionDump payload. Sync I/O here\n * blocked the loop for 20+ seconds per run, freezing IPC, scrcpy and\n * every renderer round-trip. Always use `fs/promises`. See commit\n * 6a25e05c and `report-generator-async-contract.test.ts`.\n */\nimport { existsSync, mkdirSync, readdirSync } from 'node:fs';\nimport {\n  appendFile as appendFileAsync,\n  readFile as readFileAsync,\n  rename as renameAsync,\n  unlink as unlinkAsync,\n  writeFile as writeFileAsync,\n} from 'node:fs/promises';\nimport { basename, dirname, join } from 'node:path';\nimport { getMidsceneRunSubDir } from '@midscene/shared/common';\nimport {\n  MIDSCENE_REPORT_QUIET,\n  globalConfigManager,\n} from '@midscene/shared/env';\nimport { getDebug } from '@midscene/shared/logger';\nimport { ifInBrowser, logMsg, uuid } from '@midscene/shared/utils';\nimport {\n  DATA_SCREENSHOT_MODE_ATTR,\n  generateAgentReportComment,\n  generateDumpScriptTag,\n  generateImageScriptTag,\n  generateTestRunReportScriptTag,\n  getBaseUrlFixScript,\n} from './dump/html-utils';\nimport {\n  imageRefFileExtension,\n  normalizeStoredImageRef,\n} from './dump/image-reference';\nimport { compactReportDumps } from './dump/report-dump-compactor';\nimport { type ImageUrlRef, ReportImageStore } from './dump/screenshot-store';\nimport type { WorkflowReportSource } from './test-runner/engine/types';\nimport { buildAgentTestRunReportDump } from './test-runner/reporting/agent-report';\nimport type { RunReportInput } from './test-runner/reporting/types';\nimport {\n  type ExecutionDump,\n  ReportActionDump,\n  type ReportAttributes,\n  type ReportMeta,\n  type ScreenshotMode,\n} from './types';\nimport { getReportTpl } from './utils';\n\nconst warnReport = getDebug('report-generator', { console: true });\nconst maxReportFilenameBytes = 255;\n\nexport interface IReportGenerator {\n  /**\n   * Write or update a single execution.\n   * Each call appends a new dump script tag. The frontend deduplicates\n   * executions with the same id/name, keeping only the last one.\n   *\n   * @param execution  Current execution's full data\n   * @param reportMeta  Report-level metadata (groupName, sdkVersion, etc.)\n   */\n  onExecutionUpdate(\n    execution: ExecutionDump,\n    reportMeta: ReportMeta,\n    attributes?: ReportAttributes,\n  ): void;\n\n  /**\n   * @deprecated Use onExecutionUpdate instead. Kept for backward compatibility.\n   */\n  onDumpUpdate?(dump: ReportActionDump): void;\n\n  /**\n   * Wait for all queued write operations to complete.\n   */\n  flush(): Promise<void>;\n  enableSourceSnapshots?(): void;\n  createSourceSnapshot?(\n    scopeId: string,\n    executionIds?: readonly string[],\n  ): Promise<WorkflowReportSource | undefined>;\n\n  /**\n   * Finalize the report. Calls flush() internally.\n   */\n  finalize(): Promise<string | undefined>;\n\n  getReportPath(): string | undefined;\n  /** Publish a single root Runner snapshot into this Agent's existing report. */\n  writeRunnerReport?(\n    input: RunReportInput,\n    scopeId: string,\n    meta: ReportMeta,\n  ): Promise<string | undefined>;\n}\n\nexport const nullReportGenerator: IReportGenerator = {\n  onExecutionUpdate: () => {},\n  flush: async () => {},\n  finalize: async () => undefined,\n  getReportPath: () => undefined,\n  writeRunnerReport: async () => undefined,\n};\n\nexport function assertReportGenerationOptions(opts: {\n  generateReport?: boolean;\n  persistExecutionDump?: boolean;\n}): void {\n  if (opts.generateReport === false && opts.persistExecutionDump === true) {\n    throw new Error(\n      'persistExecutionDump cannot be true when generateReport is false',\n    );\n  }\n}\n\nexport class ReportGenerator implements IReportGenerator {\n  private reportPath: string;\n  private screenshotMode: ScreenshotMode;\n  private shouldPersistExecutionDump: boolean;\n  private autoPrint: boolean;\n  private firstWriteDone = false;\n  private executionLogIndex = 0;\n  private executionLogFileIndexByExecutionKey = new Map<string, number>();\n\n  // Unique identifier for this report stream — used as data-group-id\n  private readonly reportStreamId: string;\n\n  // Tracks screenshots already written to disk (by id) to avoid duplicates\n  private screenshotStore: ReportImageStore;\n  private initialized = false;\n\n  // Tracks the last execution + groupMeta for re-writing on finalize\n  private lastExecution?: ExecutionDump;\n  private lastReportMeta?: ReportMeta;\n  private executionsByKey = new Map<string, ExecutionDump>();\n  private executionCommentKeyByObject = new WeakMap<ExecutionDump, string>();\n  private executionCommentKeyIndex = 0;\n  private reportAttributes: Record<string, string> = {};\n  private agentCommentWritten = false;\n\n  // write queue for serial execution\n  private writeQueue: Promise<void> = Promise.resolve();\n  private destroyed = false;\n\n  constructor(options: {\n    reportPath: string;\n    screenshotMode: ScreenshotMode;\n    persistExecutionDump?: boolean;\n    autoPrint?: boolean;\n    reuseExistingReport?: boolean;\n  }) {\n    this.reportPath = options.reportPath;\n    this.screenshotMode = options.screenshotMode;\n    this.shouldPersistExecutionDump = options.persistExecutionDump ?? false;\n    this.autoPrint = options.autoPrint ?? true;\n    this.reportStreamId = uuid();\n    this.screenshotStore = new ReportImageStore({\n      mode: this.screenshotMode === 'inline' ? 'inline' : 'directory',\n      reportPath: this.reportPath,\n      screenshotsDir: join(dirname(this.reportPath), 'screenshots'),\n      writeInlineImage: async (id, base64) => {\n        await appendFileAsync(\n          this.reportPath,\n          `\\n${generateImageScriptTag(id, base64)}`,\n        );\n      },\n      alsoWriteFileCopy: this.shouldPersistExecutionDump,\n      reuseExistingReport: options.reuseExistingReport,\n    });\n    if (options.reuseExistingReport) {\n      this.hydrateStateFromExistingReport();\n    }\n  }\n\n  static create(\n    reportFileName: string,\n    opts: {\n      generateReport?: boolean;\n      persistExecutionDump?: boolean;\n      outputFormat?: 'single-html' | 'html-and-external-assets';\n      autoPrintReportMsg?: boolean;\n      reuseExistingReport?: boolean;\n    },\n  ): IReportGenerator {\n    assertReportGenerationOptions(opts);\n    validateReportFileName(reportFileName, opts.outputFormat);\n    if (opts.generateReport === false) return nullReportGenerator;\n\n    // In browser environment, file system is not available\n    if (ifInBrowser) return nullReportGenerator;\n\n    const reportRootDir = getMidsceneRunSubDir('report');\n    const outputDir = join(reportRootDir, reportFileName);\n    const reportPath =\n      opts.outputFormat === 'html-and-external-assets'\n        ? join(outputDir, 'index.html')\n        : join(reportRootDir, ensureHtmlFileName(reportFileName));\n    return new ReportGenerator({\n      reportPath,\n      screenshotMode:\n        opts.outputFormat === 'html-and-external-assets'\n          ? 'directory'\n          : 'inline',\n      persistExecutionDump: opts.persistExecutionDump,\n      autoPrint: opts.autoPrintReportMsg,\n      reuseExistingReport: opts.reuseExistingReport,\n    });\n  }\n\n  onExecutionUpdate(\n    execution: ExecutionDump,\n    reportMeta: ReportMeta,\n    attributes?: ReportAttributes,\n  ): void {\n    this.lastExecution = execution;\n    this.lastReportMeta = reportMeta;\n    this.executionsByKey.set(this.getExecutionCommentKey(execution), execution);\n    this.mergeReportAttributes(attributes);\n    this.writeQueue = this.writeQueue.then(async () => {\n      if (this.destroyed) return;\n      await this.doWriteExecution(execution, reportMeta);\n    });\n  }\n\n  async flush(): Promise<void> {\n    await this.writeQueue;\n  }\n\n  async finalize(): Promise<string | undefined> {\n    // Re-write the last execution to capture any final state changes\n    if (this.lastExecution && this.lastReportMeta) {\n      this.onExecutionUpdate(this.lastExecution, this.lastReportMeta);\n    }\n    await this.flush();\n    this.destroyed = true;\n\n    if (!this.initialized) {\n      // No executions were ever written — no file exists\n      return undefined;\n    }\n\n    await this.appendAgentReportComment();\n    try {\n      await compactReportDumps(this.reportPath);\n    } catch (error) {\n      warnReport(\n        `Failed to compact report ${this.reportPath}; keeping the uncompressed report: ${String(error)}`,\n      );\n    }\n    return this.reportPath;\n  }\n\n  getReportPath(): string | undefined {\n    return this.reportPath;\n  }\n\n  async writeRunnerReport(\n    input: RunReportInput,\n    scopeId: string,\n    meta: ReportMeta,\n  ): Promise<string> {\n    this.writeQueue = this.writeQueue.then(async () => {\n      // This runs at YAML invocation completion, never on progress ticks. Keep\n      // all file I/O asynchronous and publish atomically for an open viewer.\n      const reportMeta = this.lastReportMeta ?? meta;\n      const executions = [...this.executionsByKey.values()];\n      const agentDump = new ReportActionDump({ ...reportMeta, executions });\n      const reportId =\n        this.reportAttributes['data-report-id'] ??\n        this.reportAttributes['data-group-id'] ??\n        this.reportStreamId;\n      const dump = buildAgentTestRunReportDump(input, agentDump, {\n        reportId,\n        scopeId,\n        sourcePath: this.reportPath,\n      });\n      for (const diagnostic of dump.diagnostics ?? [])\n        warnReport(diagnostic.message);\n      const sourceDump = await this.serializeSourceDump();\n      const images: string[] = [];\n      if (this.screenshotMode === 'inline') {\n        for (const ref of sourceDump.images.values()) {\n          const bytes = await readFileAsync(\n            join(dirname(this.reportPath), ref.path!),\n          );\n          images.push(\n            generateImageScriptTag(\n              ref.id,\n              `data:${ref.mimeType};base64,${bytes.toString('base64')}`,\n            ),\n          );\n        }\n      }\n      // Rebuild from the owned dump and image index, never parse this HTML back.\n      const renderedDump =\n        this.screenshotMode === 'inline'\n          ? JSON.stringify(JSON.parse(sourceDump.serialized), (_key, value) => {\n              const ref = normalizeStoredImageRef(value);\n              return ref\n                ? { ...ref, storage: 'inline', path: undefined }\n                : value;\n            })\n          : sourceDump.serialized;\n      const contents = `${getReportTpl()}${this.screenshotMode === 'directory' ? getBaseUrlFixScript() : ''}\n${generateDumpScriptTag(renderedDump, this.getDumpScriptAttributes())}\n${images.join('\\n')}\n${generateTestRunReportScriptTag(dump)}\n${generateAgentReportComment(agentDump)}`;\n      mkdirSync(dirname(this.reportPath), { recursive: true });\n      const temporaryPath = `${this.reportPath}.runner-${uuid()}.tmp`;\n      try {\n        await writeFileAsync(temporaryPath, contents);\n        await renameAsync(temporaryPath, this.reportPath);\n      } finally {\n        await unlinkAsync(temporaryPath).catch((error) => {\n          if (error.code !== 'ENOENT') throw error;\n        });\n      }\n      this.initialized = true;\n      if (!this.firstWriteDone) {\n        this.firstWriteDone = true;\n        this.printReportPath();\n      }\n    });\n    await this.flush();\n    return this.reportPath;\n  }\n\n  enableSourceSnapshots(): void {\n    this.screenshotStore.enableFileCopies();\n  }\n\n  private async serializeSourceDump(\n    frozenDump?: ReportActionDump,\n    screenshots?: ReturnType<ExecutionDump['collectScreenshots']>,\n  ) {\n    this.enableSourceSnapshots();\n    const executions = frozenDump?.executions ?? [\n      ...this.executionsByKey.values(),\n    ];\n    const references = new Map<string, ImageUrlRef>();\n    for (const screenshot of screenshots ??\n      executions.flatMap((execution) => execution.collectScreenshots()))\n      await this.screenshotStore.persist(screenshot);\n    for (const execution of executions) {\n      for (const [url, ref] of await this.persistReferenceImages(execution))\n        references.set(url, ref);\n    }\n    const dump =\n      frozenDump ??\n      new ReportActionDump({\n        ...(this.lastReportMeta ?? {\n          sdkVersion: '',\n          groupName: 'YAML execution',\n          modelBriefs: [],\n        }),\n        executions,\n      });\n    const images = new Map<\n      string,\n      ReturnType<typeof normalizeStoredImageRef> & {}\n    >();\n    const serialized = JSON.stringify(\n      JSON.parse(dump.serializeWithReferenceImages(references)),\n      (_key, value) => {\n        const ref = normalizeStoredImageRef(value);\n        if (!ref) return value;\n        const stored = {\n          ...ref,\n          storage: 'file' as const,\n          path: `./screenshots/${ref.id}.${imageRefFileExtension(ref)}`,\n        };\n        images.set(ref.id, stored);\n        return stored;\n      },\n    );\n    return { serialized, images };\n  }\n\n  async createSourceSnapshot(\n    scopeId: string,\n    executionIds?: readonly string[],\n  ): Promise<WorkflowReportSource & { dumpPath: string }> {\n    // Scope IDs originate in the kernel; never allow a filename to escape the report directory.\n    if (!scopeId || basename(scopeId) !== scopeId)\n      throw new Error('Invalid report scope ID');\n    // Freeze before the first await. HTML writes and the live action can still\n    // be pending; neither is a prerequisite for publishing this cutoff.\n    const capturedAt = new Date().toISOString();\n    const selectedIds = executionIds ? new Set(executionIds) : undefined;\n    const executions = [...this.executionsByKey.values()].filter(\n      (execution) =>\n        !selectedIds || (execution.id && selectedIds.has(execution.id)),\n    );\n    const screenshots = executions.flatMap((execution) =>\n      execution.collectScreenshots(),\n    );\n    const frozen = ReportActionDump.fromSerializedString(\n      new ReportActionDump({\n        ...(this.lastReportMeta ?? {\n          sdkVersion: '',\n          groupName: 'YAML execution',\n          modelBriefs: [],\n        }),\n        executions,\n      }).serialize(),\n    );\n    const { serialized } = await this.serializeSourceDump(frozen, screenshots);\n    const dumpPath = `${this.reportPath}.${scopeId}.${uuid()}.json`;\n    mkdirSync(dirname(dumpPath), { recursive: true });\n    await writeFileAsync(dumpPath, serialized, { flag: 'wx' });\n    return {\n      sourcePath: this.reportPath,\n      dumpPath,\n      collection: { status: 'complete', capturedAt },\n    };\n  }\n\n  private printReportPath(): void {\n    if (!this.autoPrint || !this.reportPath) return;\n    if (globalConfigManager.getEnvConfigInBoolean(MIDSCENE_REPORT_QUIET))\n      return;\n\n    if (this.screenshotMode === 'directory') {\n      logMsg(\n        `Midscene - report file updated: npx serve ${dirname(this.reportPath)}`,\n      );\n    } else {\n      logMsg(`Midscene - report file updated: ${this.reportPath}`);\n    }\n  }\n\n  private async doWriteExecution(\n    execution: ExecutionDump,\n    reportMeta: ReportMeta,\n  ): Promise<void> {\n    const singleDump = this.wrapAsReportDump(execution, reportMeta);\n\n    const referenceImageRefs = await this.writeExecution(execution, singleDump);\n\n    if (this.shouldPersistExecutionDump) {\n      await this.persistExecutionDumpToFile(\n        execution,\n        singleDump,\n        referenceImageRefs,\n      );\n    }\n\n    if (!this.firstWriteDone) {\n      this.firstWriteDone = true;\n      this.printReportPath();\n    }\n  }\n\n  private mergeReportAttributes(attributes?: ReportAttributes): void {\n    if (!attributes) {\n      return;\n    }\n\n    for (const [key, value] of Object.entries(attributes)) {\n      if (value === undefined || value === null) {\n        continue;\n      }\n      this.reportAttributes[key] = String(value);\n    }\n  }\n\n  private hydrateStateFromExistingReport(): void {\n    if (!existsSync(this.reportPath)) {\n      return;\n    }\n\n    // Reuse existing report file and append new updates instead of rewriting.\n    this.initialized = true;\n\n    if (!this.shouldPersistExecutionDump) {\n      return;\n    }\n\n    const reportDir = dirname(this.reportPath);\n    const existingExecutionIndices = readdirSync(reportDir)\n      .map((name) => /^(\\d+)\\.execution\\.json$/.exec(name)?.[1])\n      .filter((index): index is string => Boolean(index))\n      .map((index) => Number.parseInt(index, 10))\n      .filter((index) => Number.isFinite(index));\n\n    if (existingExecutionIndices.length > 0) {\n      this.executionLogIndex = Math.max(...existingExecutionIndices);\n    }\n  }\n\n  private getDumpScriptAttributes(): Record<string, string> {\n    return {\n      'data-group-id': this.reportStreamId,\n      // Self-describe how this report file stores screenshots so consumers\n      // (merge/delete) never have to guess the mode from the filesystem.\n      [DATA_SCREENSHOT_MODE_ATTR]: this.screenshotMode,\n      ...this.reportAttributes,\n    };\n  }\n\n  /**\n   * Wrap an ExecutionDump + ReportMeta into a single-execution ReportActionDump.\n   */\n  private wrapAsReportDump(\n    execution: ExecutionDump,\n    reportMeta: ReportMeta,\n  ): ReportActionDump {\n    return new ReportActionDump({\n      sdkVersion: reportMeta.sdkVersion,\n      groupName: reportMeta.groupName,\n      groupDescription: reportMeta.groupDescription,\n      modelBriefs: reportMeta.modelBriefs,\n      deviceType: reportMeta.deviceType,\n      executions: [execution],\n    });\n  }\n\n  /**\n   * Append assets and a dump tag without duplicating mode-specific workflows.\n   * The frontend deduplicates executions with the same id/name (keeps last).\n   * Duplicate dump JSON is acceptable; only screenshots are deduplicated.\n   *\n   * All writes go through `fs/promises` so they run on libuv's thread pool\n   * rather than blocking the Node event loop. A long agent run previously\n   * appended multi-MB dumps (screenshots + serialized tasks) per progress\n   * tick on the main thread, starving IPC and UI for >10s per stall.\n   */\n  private async writeExecution(\n    execution: ExecutionDump,\n    singleDump: ReportActionDump,\n  ): Promise<Map<string, ImageUrlRef>> {\n    const dir = dirname(this.reportPath);\n    if (!existsSync(dir)) {\n      mkdirSync(dir, { recursive: true });\n    }\n\n    // Initialize: write HTML template once\n    if (!this.initialized) {\n      const baseUrlFix =\n        this.screenshotMode === 'directory' ? getBaseUrlFixScript() : '';\n      await writeFileAsync(this.reportPath, `${getReportTpl()}${baseUrlFix}`);\n      this.initialized = true;\n    }\n\n    // Append new screenshots (skip already-written ones)\n    for (const screenshot of execution.collectScreenshots()) {\n      await this.screenshotStore.persist(screenshot);\n    }\n    const referenceImageRefs = await this.persistReferenceImages(execution);\n\n    // Append dump tag (always — frontend keeps only last per execution id)\n    const serialized =\n      singleDump.serializeWithReferenceImages(referenceImageRefs);\n    await appendFileAsync(\n      this.reportPath,\n      `\\n${generateDumpScriptTag(serialized, this.getDumpScriptAttributes())}`,\n    );\n    return referenceImageRefs;\n  }\n\n  private async persistReferenceImages(\n    execution: ExecutionDump,\n  ): Promise<Map<string, ImageUrlRef>> {\n    const refs = new Map<string, ImageUrlRef>();\n    for (const imageUrl of execution.getReferenceImageUrls()) {\n      const ref = await this.screenshotStore.persistReferenceImage(imageUrl);\n      refs.set(imageUrl, ref);\n    }\n    return refs;\n  }\n\n  private async appendAgentReportComment(): Promise<void> {\n    if (\n      this.agentCommentWritten ||\n      !this.lastReportMeta ||\n      this.executionsByKey.size === 0\n    ) {\n      return;\n    }\n\n    const reportDump = new ReportActionDump({\n      sdkVersion: this.lastReportMeta.sdkVersion,\n      groupName: this.lastReportMeta.groupName,\n      groupDescription: this.lastReportMeta.groupDescription,\n      modelBriefs: this.lastReportMeta.modelBriefs,\n      deviceType: this.lastReportMeta.deviceType,\n      executions: Array.from(this.executionsByKey.values()),\n    });\n    await appendFileAsync(\n      this.reportPath,\n      `\\n${generateAgentReportComment(reportDump)}`,\n    );\n    this.agentCommentWritten = true;\n  }\n\n  private getExecutionLogKey(execution: ExecutionDump): string {\n    if (!execution.id) {\n      throw new Error(\n        'ReportGenerator: execution.id is required for persisting execution dumps',\n      );\n    }\n    return `id:${execution.id}`;\n  }\n\n  private getExecutionCommentKey(execution: ExecutionDump): string {\n    if (execution.id) {\n      return `id:${execution.id}`;\n    }\n\n    const existingKey = this.executionCommentKeyByObject.get(execution);\n    if (existingKey) {\n      return existingKey;\n    }\n\n    const key = `no-id:${this.executionCommentKeyIndex++}`;\n    this.executionCommentKeyByObject.set(execution, key);\n    return key;\n  }\n\n  private async persistExecutionDumpToFile(\n    execution: ExecutionDump,\n    singleDump: ReportActionDump,\n    referenceImageRefs: ReadonlyMap<string, ImageUrlRef>,\n  ): Promise<void> {\n    const dir = dirname(this.reportPath);\n    if (!existsSync(dir)) {\n      mkdirSync(dir, { recursive: true });\n    }\n\n    const executionLogKey = this.getExecutionLogKey(execution);\n    let fileIndex =\n      this.executionLogFileIndexByExecutionKey.get(executionLogKey);\n    if (!fileIndex) {\n      this.executionLogIndex += 1;\n      fileIndex = this.executionLogIndex;\n      this.executionLogFileIndexByExecutionKey.set(executionLogKey, fileIndex);\n    }\n\n    const fileName = `${fileIndex}.execution.json`;\n    const filePath = join(dirname(this.reportPath), fileName);\n    await writeFileAsync(\n      filePath,\n      singleDump.serializeWithReferenceImages(referenceImageRefs, 2),\n      'utf-8',\n    );\n  }\n}\n\nfunction ensureHtmlFileName(reportFileName: string): string {\n  return reportFileName.endsWith('.html')\n    ? reportFileName\n    : `${reportFileName}.html`;\n}\n\nfunction validateReportFileName(\n  reportFileName: string,\n  outputFormat?: 'single-html' | 'html-and-external-assets',\n): void {\n  if (!reportFileName?.trim()) {\n    throw new Error('reportFileName must be a non-empty string');\n  }\n\n  if (/[\\\\/]/.test(reportFileName)) {\n    throw new Error(\n      'reportFileName must not contain path separators (`/` or `\\\\\\\\`)',\n    );\n  }\n\n  if (/[:*?\"<>|]/.test(reportFileName)) {\n    throw new Error(\n      'reportFileName contains illegal filename characters: : * ? \" < > |',\n    );\n  }\n\n  const filenameComponent =\n    outputFormat === 'html-and-external-assets'\n      ? reportFileName\n      : ensureHtmlFileName(reportFileName);\n  const filenameBytes = new TextEncoder().encode(filenameComponent).byteLength;\n  if (filenameBytes > maxReportFilenameBytes) {\n    throw new Error(\n      `reportFileName produces a filename component of ${filenameBytes} UTF-8 bytes; maximum is ${maxReportFilenameBytes}`,\n    );\n  }\n}\n"],"names":["warnReport","getDebug","maxReportFilenameBytes","nullReportGenerator","undefined","assertReportGenerationOptions","opts","Error","ReportGenerator","reportFileName","validateReportFileName","ifInBrowser","reportRootDir","getMidsceneRunSubDir","outputDir","join","reportPath","ensureHtmlFileName","execution","reportMeta","attributes","compactReportDumps","error","String","input","scopeId","meta","executions","agentDump","ReportActionDump","reportId","dump","buildAgentTestRunReportDump","diagnostic","sourceDump","images","ref","bytes","readFileAsync","dirname","generateImageScriptTag","renderedDump","JSON","_key","value","normalizeStoredImageRef","contents","getReportTpl","getBaseUrlFixScript","generateDumpScriptTag","generateTestRunReportScriptTag","generateAgentReportComment","mkdirSync","temporaryPath","uuid","writeFileAsync","renameAsync","unlinkAsync","frozenDump","screenshots","references","Map","screenshot","url","serialized","stored","imageRefFileExtension","executionIds","basename","capturedAt","Date","selectedIds","Set","frozen","dumpPath","globalConfigManager","MIDSCENE_REPORT_QUIET","logMsg","singleDump","referenceImageRefs","key","Object","existsSync","reportDir","existingExecutionIndices","readdirSync","name","index","Boolean","Number","Math","DATA_SCREENSHOT_MODE_ATTR","dir","baseUrlFix","appendFileAsync","refs","imageUrl","reportDump","Array","existingKey","executionLogKey","fileIndex","fileName","filePath","options","WeakMap","Promise","ReportImageStore","id","base64","outputFormat","filenameComponent","filenameBytes","TextEncoder"],"mappings":"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"}