@midscene/core 1.12.10-beta-20260920031616.0 → 1.13.0

package/dist/es/dump/screenshot-store.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"dump/screenshot-store.mjs","sources":["../../../src/dump/screenshot-store.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { existsSync, mkdirSync, readFileSync, rmSync } from 'node:fs';\nimport { writeFile as writeFileAsync } from 'node:fs/promises';\nimport { dirname, isAbsolute, join } from 'node:path';\nimport type { ScreenshotItem } from '../screenshot-item';\nimport { collectImageScriptIds, extractImageByIdSync } from './html-utils';\nimport {\n  type ImageUrlRef,\n  type ScreenshotRef,\n  type StoredImageRef,\n  imageFileExtensionForMimeType,\n  imageRefFileExtension,\n  normalizeImageUrlRef,\n  normalizeScreenshotRef,\n  normalizeStoredImageRef,\n} from './image-reference';\n\nexport type {\n  ImageUrlRef,\n  ScreenshotRef,\n  StoredImageRef,\n} from './image-reference';\nexport {\n  imageRefFileExtension,\n  normalizeImageUrlRef,\n  normalizeScreenshotRef,\n  normalizeStoredImageRef,\n} from './image-reference';\n\nconst base64ImageDataUrlPattern =\n  /^data:(image\\/[a-z0-9.+-]+)(?:;[^,]*)?;base64,([a-z0-9+/=\\s]+)$/i;\ntype ResolvedImageSource =\n  | {\n      type: 'data-uri';\n      id: string;\n      mimeType: StoredImageRef['mimeType'];\n      dataUri: string;\n    }\n  | {\n      type: 'file';\n      id: string;\n      mimeType: StoredImageRef['mimeType'];\n      filePath: string;\n    };\n\n/** Parse and normalize a base64 image data URL for report persistence. */\nexport function parseBase64ImageDataUrl(imageUrl: string): {\n  mimeType: `image/${string}`;\n  extension: string;\n  rawBase64: string;\n} {\n  const match = imageUrl.match(base64ImageDataUrlPattern);\n  if (!match) {\n    throw new Error(\n      'ReportImageStore: reference image must be a valid base64 image data URL',\n    );\n  }\n  const mimeType = match[1].toLowerCase() as `image/${string}`;\n  return {\n    mimeType,\n    extension: imageFileExtensionForMimeType(mimeType),\n    rawBase64: match[2].replace(/\\s/g, ''),\n  };\n}\n\nexport function isBase64ImageDataUrl(value: string): boolean {\n  return base64ImageDataUrlPattern.test(value);\n}\n\nexport function resolveImageSource(\n  refInput: unknown,\n  options: {\n    reportPath: string;\n    imageDirectory?: string;\n    fallbackId?: string;\n    fallbackMimeType?: ScreenshotRef['mimeType'];\n  },\n): ResolvedImageSource {\n  const ref = normalizeStoredImageRef(refInput);\n  const id = ref?.id ?? options.fallbackId;\n  const mimeType = ref?.mimeType ?? options.fallbackMimeType;\n\n  if (!id || !mimeType) {\n    throw new Error(\n      'ReportImageStore: image id and mimeType are required to resolve an image',\n    );\n  }\n\n  const resolveReportRelativePath = (filePath: string): string =>\n    isAbsolute(filePath)\n      ? filePath\n      : join(dirname(options.reportPath), filePath);\n\n  if (ref?.storage === 'file') {\n    if (!ref.path) {\n      throw new Error(\n        `ReportImageStore: image ref \"${ref.id}\" missing file path`,\n      );\n    }\n\n    const explicitFilePath = resolveReportRelativePath(ref.path);\n    if (existsSync(explicitFilePath)) {\n      return {\n        type: 'file',\n        id,\n        mimeType,\n        filePath: explicitFilePath,\n      };\n    }\n  }\n\n  const inlineDataUri = extractImageByIdSync(options.reportPath, id);\n  if (inlineDataUri) {\n    return {\n      type: 'data-uri',\n      id,\n      mimeType,\n      dataUri: inlineDataUri,\n    };\n  }\n\n  const extension = ref\n    ? imageRefFileExtension(ref)\n    : imageFileExtensionForMimeType(options.fallbackMimeType!);\n  if (options.imageDirectory) {\n    const companionImagePath = join(\n      options.imageDirectory,\n      `${id}.${extension}`,\n    );\n    if (existsSync(companionImagePath)) {\n      return {\n        type: 'file',\n        id,\n        mimeType,\n        filePath: companionImagePath,\n      };\n    }\n  }\n  const siblingImagePath = join(\n    dirname(options.reportPath),\n    'screenshots',\n    `${id}.${extension}`,\n  );\n  if (existsSync(siblingImagePath)) {\n    return {\n      type: 'file',\n      id,\n      mimeType,\n      filePath: siblingImagePath,\n    };\n  }\n\n  throw new Error(\n    `ReportImageStore: cannot resolve image \"${id}\" from ${options.reportPath}`,\n  );\n}\n\nexport function resolveScreenshotSource(\n  refInput: unknown,\n  options: {\n    reportPath: string;\n    imageDirectory?: string;\n    fallbackId?: string;\n    fallbackMimeType?: ScreenshotRef['mimeType'];\n  },\n): ResolvedImageSource {\n  const ref = normalizeScreenshotRef(refInput);\n  return resolveImageSource(ref, options);\n}\n\n/** Persists and restores every image asset referenced by a report. */\nexport class ReportImageStore {\n  private readonly mode: 'inline' | 'directory';\n  private readonly reportPath: string;\n  private readonly screenshotsDir?: string;\n  private readonly writeInlineImage?: (\n    id: string,\n    base64: string,\n  ) => void | Promise<void>;\n  private readonly alsoWriteFileCopy: boolean;\n  private readonly writtenInlineIds = new Set<string>();\n  private readonly writtenFileIds = new Set<string>();\n  private readonly shouldReuseExistingInlineReport: boolean;\n  private existingInlineImageIdsPromise?: Promise<void>;\n\n  constructor(options: {\n    mode: 'inline' | 'directory';\n    reportPath: string;\n    screenshotsDir?: string;\n    writeInlineImage?: (id: string, base64: string) => void | Promise<void>;\n    alsoWriteFileCopy?: boolean;\n    /** @deprecated Use alsoWriteFileCopy instead. */\n    ensureFileCopy?: boolean;\n    /** Reuse inline image assets already present in reportPath. */\n    reuseExistingReport?: boolean;\n  }) {\n    this.mode = options.mode;\n    this.reportPath = options.reportPath;\n    this.screenshotsDir = options.screenshotsDir;\n    this.writeInlineImage = options.writeInlineImage;\n    this.alsoWriteFileCopy =\n      options.alsoWriteFileCopy ?? options.ensureFileCopy ?? false;\n    this.shouldReuseExistingInlineReport = Boolean(\n      options.reuseExistingReport && this.mode === 'inline',\n    );\n  }\n\n  async persist(screenshot: ScreenshotItem): Promise<ScreenshotRef> {\n    await this.ensureExistingInlineImageIdsLoaded();\n    const shouldWriteFileCopy =\n      this.mode === 'directory' || this.alsoWriteFileCopy;\n    const fileRef = shouldWriteFileCopy\n      ? await this.persistToSharedFileIfNeeded(screenshot, {\n          markAsPersisted: this.mode === 'directory',\n        })\n      : null;\n\n    if (this.mode === 'inline') {\n      if (!this.writeInlineImage) {\n        throw new Error(\n          'ReportImageStore: writeInlineImage is required in inline mode',\n        );\n      }\n      if (!this.writtenInlineIds.has(screenshot.id)) {\n        await this.writeInlineImage(screenshot.id, screenshot.base64);\n        this.writtenInlineIds.add(screenshot.id);\n      }\n      return screenshot.markPersistedInline(this.reportPath);\n    }\n\n    if (!fileRef) {\n      throw new Error(\n        'ReportImageStore: file persistence is required in directory mode',\n      );\n    }\n    return fileRef;\n  }\n\n  /** Persist a base64 multimodal prompt image and return its content-addressed ref. */\n  async persistReferenceImage(imageUrl: string): Promise<ImageUrlRef> {\n    await this.ensureExistingInlineImageIdsLoaded();\n    const { mimeType, extension, rawBase64 } =\n      parseBase64ImageDataUrl(imageUrl);\n    const id = `reference-${createHash('sha256')\n      .update(mimeType)\n      .update('\\0')\n      .update(Buffer.from(rawBase64, 'base64'))\n      .digest('hex')}`;\n    const shouldWriteFileCopy =\n      this.mode === 'directory' || this.alsoWriteFileCopy;\n    const fileLocation = shouldWriteFileCopy\n      ? await this.writeImageFileIfNeeded({ id, extension, rawBase64 })\n      : null;\n\n    let ref: ImageUrlRef;\n    if (this.mode === 'inline') {\n      if (!this.writeInlineImage) {\n        throw new Error(\n          'ReportImageStore: writeInlineImage is required in inline mode',\n        );\n      }\n      if (!this.writtenInlineIds.has(id)) {\n        await this.writeInlineImage(id, imageUrl);\n        this.writtenInlineIds.add(id);\n      }\n      ref = {\n        type: 'midscene_image_url_ref',\n        id,\n        mimeType,\n        storage: 'inline',\n      };\n    } else {\n      if (!fileLocation) {\n        throw new Error(\n          'ReportImageStore: file persistence is required in directory mode',\n        );\n      }\n      ref = {\n        type: 'midscene_image_url_ref',\n        id,\n        mimeType,\n        storage: 'file',\n        path: fileLocation.relativePath,\n      };\n    }\n    return ref;\n  }\n\n  private async ensureExistingInlineImageIdsLoaded(): Promise<void> {\n    if (!this.shouldReuseExistingInlineReport) return;\n    if (!this.existingInlineImageIdsPromise) {\n      this.existingInlineImageIdsPromise = (async () => {\n        try {\n          const imageIds = await collectImageScriptIds(this.reportPath);\n          for (const imageId of imageIds) this.writtenInlineIds.add(imageId);\n        } catch (error) {\n          if (\n            typeof error === 'object' &&\n            error !== null &&\n            'code' in error &&\n            error.code === 'ENOENT'\n          ) {\n            return;\n          }\n          throw new Error(\n            `ReportImageStore: failed to index existing inline images from ${this.reportPath}`,\n            { cause: error },\n          );\n        }\n      })();\n    }\n    await this.existingInlineImageIdsPromise;\n  }\n\n  private async persistToSharedFileIfNeeded(\n    screenshot: ScreenshotItem,\n    options: {\n      markAsPersisted: boolean;\n    },\n  ): Promise<ScreenshotRef> {\n    const { relativePath, absolutePath } = await this.writeImageFileIfNeeded({\n      id: screenshot.id,\n      extension: screenshot.extension,\n      rawBase64: screenshot.rawBase64,\n    });\n\n    if (options.markAsPersisted) {\n      return screenshot.markPersistedToPath(relativePath, absolutePath);\n    }\n\n    return screenshot.registerPersistedFileCopy(relativePath, absolutePath);\n  }\n\n  private async writeImageFileIfNeeded(image: {\n    id: string;\n    extension: string;\n    rawBase64: string;\n  }): Promise<{ relativePath: string; absolutePath: string }> {\n    const screenshotsDir = this.screenshotsDir;\n    if (!screenshotsDir) {\n      throw new Error(\n        'ReportImageStore: screenshotsDir is required when file persistence is enabled',\n      );\n    }\n    if (!existsSync(screenshotsDir)) {\n      mkdirSync(screenshotsDir, { recursive: true });\n    }\n\n    const fileName = `${image.id}.${image.extension}`;\n    const relativePath = `./screenshots/${fileName}`;\n    const absolutePath = join(screenshotsDir, fileName);\n    if (!this.writtenFileIds.has(image.id)) {\n      await writeFileAsync(\n        absolutePath,\n        Buffer.from(image.rawBase64, 'base64'),\n      );\n      this.writtenFileIds.add(image.id);\n    }\n    return { relativePath, absolutePath };\n  }\n\n  /** Resolve any stored report image reference to a data URI. */\n  loadDataUri(refInput: unknown): string {\n    const ref = normalizeStoredImageRef(refInput);\n    if (!ref) {\n      throw new Error('ReportImageStore: invalid image reference');\n    }\n\n    const resolved = resolveImageSource(ref, {\n      reportPath: this.reportPath,\n      imageDirectory: this.screenshotsDir,\n    });\n\n    if (resolved.type === 'data-uri') {\n      return resolved.dataUri;\n    }\n\n    const data = readFileSync(resolved.filePath);\n    return `data:${resolved.mimeType};base64,${data.toString('base64')}`;\n  }\n\n  /** @deprecated Use loadDataUri. */\n  loadBase64(refInput: unknown): string {\n    const screenshotRef = normalizeScreenshotRef(refInput);\n    if (!screenshotRef) {\n      throw new Error('ReportImageStore: invalid screenshot reference');\n    }\n    return this.loadDataUri(screenshotRef);\n  }\n\n  cleanup(): void {\n    if (\n      this.mode === 'directory' &&\n      this.screenshotsDir &&\n      existsSync(this.screenshotsDir)\n    ) {\n      rmSync(this.screenshotsDir, { recursive: true, force: true });\n    }\n    this.writtenInlineIds.clear();\n    this.writtenFileIds.clear();\n    this.existingInlineImageIdsPromise = undefined;\n  }\n}\n\n/** @deprecated Use ReportImageStore. */\nexport { ReportImageStore as ScreenshotStore };\n"],"names":["base64ImageDataUrlPattern","parseBase64ImageDataUrl","imageUrl","match","Error","mimeType","imageFileExtensionForMimeType","isBase64ImageDataUrl","value","resolveImageSource","refInput","options","ref","normalizeStoredImageRef","id","resolveReportRelativePath","filePath","isAbsolute","join","dirname","explicitFilePath","existsSync","inlineDataUri","extractImageByIdSync","extension","imageRefFileExtension","companionImagePath","siblingImagePath","resolveScreenshotSource","normalizeScreenshotRef","ReportImageStore","screenshot","shouldWriteFileCopy","fileRef","rawBase64","createHash","Buffer","fileLocation","imageIds","collectImageScriptIds","imageId","error","relativePath","absolutePath","image","screenshotsDir","mkdirSync","fileName","writeFileAsync","resolved","data","readFileSync","screenshotRef","rmSync","undefined","Set","Boolean"],"mappings":"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"}
+{"version":3,"file":"dump/screenshot-store.mjs","sources":["../../../src/dump/screenshot-store.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { existsSync, mkdirSync, readFileSync, rmSync } from 'node:fs';\nimport { writeFile as writeFileAsync } from 'node:fs/promises';\nimport { dirname, isAbsolute, join } from 'node:path';\nimport type { ScreenshotItem } from '../screenshot-item';\nimport { collectImageScriptIds, extractImageByIdSync } from './html-utils';\nimport {\n  type ImageUrlRef,\n  type ScreenshotRef,\n  type StoredImageRef,\n  imageFileExtensionForMimeType,\n  imageRefFileExtension,\n  normalizeImageUrlRef,\n  normalizeScreenshotRef,\n  normalizeStoredImageRef,\n} from './image-reference';\n\nexport type {\n  ImageUrlRef,\n  ScreenshotRef,\n  StoredImageRef,\n} from './image-reference';\nexport {\n  imageRefFileExtension,\n  normalizeImageUrlRef,\n  normalizeScreenshotRef,\n  normalizeStoredImageRef,\n} from './image-reference';\n\nconst base64ImageDataUrlPattern =\n  /^data:(image\\/[a-z0-9.+-]+)(?:;[^,]*)?;base64,([a-z0-9+/=\\s]+)$/i;\ntype ResolvedImageSource =\n  | {\n      type: 'data-uri';\n      id: string;\n      mimeType: StoredImageRef['mimeType'];\n      dataUri: string;\n    }\n  | {\n      type: 'file';\n      id: string;\n      mimeType: StoredImageRef['mimeType'];\n      filePath: string;\n    };\n\n/** Parse and normalize a base64 image data URL for report persistence. */\nexport function parseBase64ImageDataUrl(imageUrl: string): {\n  mimeType: `image/${string}`;\n  extension: string;\n  rawBase64: string;\n} {\n  const match = imageUrl.match(base64ImageDataUrlPattern);\n  if (!match) {\n    throw new Error(\n      'ReportImageStore: reference image must be a valid base64 image data URL',\n    );\n  }\n  const mimeType = match[1].toLowerCase() as `image/${string}`;\n  return {\n    mimeType,\n    extension: imageFileExtensionForMimeType(mimeType),\n    rawBase64: match[2].replace(/\\s/g, ''),\n  };\n}\n\nexport function isBase64ImageDataUrl(value: string): boolean {\n  return base64ImageDataUrlPattern.test(value);\n}\n\nexport function resolveImageSource(\n  refInput: unknown,\n  options: {\n    reportPath: string;\n    imageDirectory?: string;\n    fallbackId?: string;\n    fallbackMimeType?: ScreenshotRef['mimeType'];\n  },\n): ResolvedImageSource {\n  const ref = normalizeStoredImageRef(refInput);\n  const id = ref?.id ?? options.fallbackId;\n  const mimeType = ref?.mimeType ?? options.fallbackMimeType;\n\n  if (!id || !mimeType) {\n    throw new Error(\n      'ReportImageStore: image id and mimeType are required to resolve an image',\n    );\n  }\n\n  const resolveReportRelativePath = (filePath: string): string =>\n    isAbsolute(filePath)\n      ? filePath\n      : join(dirname(options.reportPath), filePath);\n\n  if (ref?.storage === 'file') {\n    if (!ref.path) {\n      throw new Error(\n        `ReportImageStore: image ref \"${ref.id}\" missing file path`,\n      );\n    }\n\n    const explicitFilePath = resolveReportRelativePath(ref.path);\n    if (existsSync(explicitFilePath)) {\n      return {\n        type: 'file',\n        id,\n        mimeType,\n        filePath: explicitFilePath,\n      };\n    }\n  }\n\n  const inlineDataUri = extractImageByIdSync(options.reportPath, id);\n  if (inlineDataUri) {\n    return {\n      type: 'data-uri',\n      id,\n      mimeType,\n      dataUri: inlineDataUri,\n    };\n  }\n\n  const extension = ref\n    ? imageRefFileExtension(ref)\n    : imageFileExtensionForMimeType(options.fallbackMimeType!);\n  if (options.imageDirectory) {\n    const companionImagePath = join(\n      options.imageDirectory,\n      `${id}.${extension}`,\n    );\n    if (existsSync(companionImagePath)) {\n      return {\n        type: 'file',\n        id,\n        mimeType,\n        filePath: companionImagePath,\n      };\n    }\n  }\n  const siblingImagePath = join(\n    dirname(options.reportPath),\n    'screenshots',\n    `${id}.${extension}`,\n  );\n  if (existsSync(siblingImagePath)) {\n    return {\n      type: 'file',\n      id,\n      mimeType,\n      filePath: siblingImagePath,\n    };\n  }\n\n  throw new Error(\n    `ReportImageStore: cannot resolve image \"${id}\" from ${options.reportPath}`,\n  );\n}\n\nexport function resolveScreenshotSource(\n  refInput: unknown,\n  options: {\n    reportPath: string;\n    imageDirectory?: string;\n    fallbackId?: string;\n    fallbackMimeType?: ScreenshotRef['mimeType'];\n  },\n): ResolvedImageSource {\n  const ref = normalizeScreenshotRef(refInput);\n  return resolveImageSource(ref, options);\n}\n\n/** Persists and restores every image asset referenced by a report. */\nexport class ReportImageStore {\n  private readonly mode: 'inline' | 'directory';\n  private readonly reportPath: string;\n  private readonly screenshotsDir?: string;\n  private readonly writeInlineImage?: (\n    id: string,\n    base64: string,\n  ) => void | Promise<void>;\n  private alsoWriteFileCopy: boolean;\n  private readonly writtenInlineIds = new Set<string>();\n  private readonly writtenFileIds = new Set<string>();\n  private readonly shouldReuseExistingInlineReport: boolean;\n  private existingInlineImageIdsPromise?: Promise<void>;\n\n  constructor(options: {\n    mode: 'inline' | 'directory';\n    reportPath: string;\n    screenshotsDir?: string;\n    writeInlineImage?: (id: string, base64: string) => void | Promise<void>;\n    alsoWriteFileCopy?: boolean;\n    /** @deprecated Use alsoWriteFileCopy instead. */\n    ensureFileCopy?: boolean;\n    /** Reuse inline image assets already present in reportPath. */\n    reuseExistingReport?: boolean;\n  }) {\n    this.mode = options.mode;\n    this.reportPath = options.reportPath;\n    this.screenshotsDir = options.screenshotsDir;\n    this.writeInlineImage = options.writeInlineImage;\n    this.alsoWriteFileCopy =\n      options.alsoWriteFileCopy ?? options.ensureFileCopy ?? false;\n    this.shouldReuseExistingInlineReport = Boolean(\n      options.reuseExistingReport && this.mode === 'inline',\n    );\n  }\n\n  enableFileCopies(): void {\n    this.alsoWriteFileCopy = true;\n  }\n\n  async persist(screenshot: ScreenshotItem): Promise<ScreenshotRef> {\n    await this.ensureExistingInlineImageIdsLoaded();\n    const shouldWriteFileCopy =\n      this.mode === 'directory' || this.alsoWriteFileCopy;\n    const fileRef = shouldWriteFileCopy\n      ? await this.persistToSharedFileIfNeeded(screenshot, {\n          markAsPersisted: this.mode === 'directory',\n        })\n      : null;\n\n    if (this.mode === 'inline') {\n      if (!this.writeInlineImage) {\n        throw new Error(\n          'ReportImageStore: writeInlineImage is required in inline mode',\n        );\n      }\n      if (!this.writtenInlineIds.has(screenshot.id)) {\n        await this.writeInlineImage(screenshot.id, screenshot.base64);\n        this.writtenInlineIds.add(screenshot.id);\n      }\n      return screenshot.markPersistedInline(this.reportPath);\n    }\n\n    if (!fileRef) {\n      throw new Error(\n        'ReportImageStore: file persistence is required in directory mode',\n      );\n    }\n    return fileRef;\n  }\n\n  /** Persist a base64 multimodal prompt image and return its content-addressed ref. */\n  async persistReferenceImage(imageUrl: string): Promise<ImageUrlRef> {\n    await this.ensureExistingInlineImageIdsLoaded();\n    const { mimeType, extension, rawBase64 } =\n      parseBase64ImageDataUrl(imageUrl);\n    const id = `reference-${createHash('sha256')\n      .update(mimeType)\n      .update('\\0')\n      .update(Buffer.from(rawBase64, 'base64'))\n      .digest('hex')}`;\n    const shouldWriteFileCopy =\n      this.mode === 'directory' || this.alsoWriteFileCopy;\n    const fileLocation = shouldWriteFileCopy\n      ? await this.writeImageFileIfNeeded({ id, extension, rawBase64 })\n      : null;\n\n    let ref: ImageUrlRef;\n    if (this.mode === 'inline') {\n      if (!this.writeInlineImage) {\n        throw new Error(\n          'ReportImageStore: writeInlineImage is required in inline mode',\n        );\n      }\n      if (!this.writtenInlineIds.has(id)) {\n        await this.writeInlineImage(id, imageUrl);\n        this.writtenInlineIds.add(id);\n      }\n      ref = {\n        type: 'midscene_image_url_ref',\n        id,\n        mimeType,\n        storage: 'inline',\n      };\n    } else {\n      if (!fileLocation) {\n        throw new Error(\n          'ReportImageStore: file persistence is required in directory mode',\n        );\n      }\n      ref = {\n        type: 'midscene_image_url_ref',\n        id,\n        mimeType,\n        storage: 'file',\n        path: fileLocation.relativePath,\n      };\n    }\n    return ref;\n  }\n\n  private async ensureExistingInlineImageIdsLoaded(): Promise<void> {\n    if (!this.shouldReuseExistingInlineReport) return;\n    if (!this.existingInlineImageIdsPromise) {\n      this.existingInlineImageIdsPromise = (async () => {\n        try {\n          const imageIds = await collectImageScriptIds(this.reportPath);\n          for (const imageId of imageIds) this.writtenInlineIds.add(imageId);\n        } catch (error) {\n          if (\n            typeof error === 'object' &&\n            error !== null &&\n            'code' in error &&\n            error.code === 'ENOENT'\n          ) {\n            return;\n          }\n          throw new Error(\n            `ReportImageStore: failed to index existing inline images from ${this.reportPath}`,\n            { cause: error },\n          );\n        }\n      })();\n    }\n    await this.existingInlineImageIdsPromise;\n  }\n\n  private async persistToSharedFileIfNeeded(\n    screenshot: ScreenshotItem,\n    options: {\n      markAsPersisted: boolean;\n    },\n  ): Promise<ScreenshotRef> {\n    const fileName = `${screenshot.id}.${screenshot.extension}`;\n    const { relativePath, absolutePath } = this.writtenFileIds.has(\n      screenshot.id,\n    )\n      ? {\n          relativePath: `./screenshots/${fileName}`,\n          absolutePath: join(this.screenshotsDir!, fileName),\n        }\n      : await this.writeImageFileIfNeeded({\n          id: screenshot.id,\n          extension: screenshot.extension,\n          rawBase64: screenshot.rawBase64,\n        });\n\n    if (options.markAsPersisted) {\n      return screenshot.markPersistedToPath(relativePath, absolutePath);\n    }\n\n    return screenshot.registerPersistedFileCopy(relativePath, absolutePath);\n  }\n\n  private async writeImageFileIfNeeded(image: {\n    id: string;\n    extension: string;\n    rawBase64: string;\n  }): Promise<{ relativePath: string; absolutePath: string }> {\n    const screenshotsDir = this.screenshotsDir;\n    if (!screenshotsDir) {\n      throw new Error(\n        'ReportImageStore: screenshotsDir is required when file persistence is enabled',\n      );\n    }\n    if (!existsSync(screenshotsDir)) {\n      mkdirSync(screenshotsDir, { recursive: true });\n    }\n\n    const fileName = `${image.id}.${image.extension}`;\n    const relativePath = `./screenshots/${fileName}`;\n    const absolutePath = join(screenshotsDir, fileName);\n    if (!this.writtenFileIds.has(image.id)) {\n      await writeFileAsync(\n        absolutePath,\n        Buffer.from(image.rawBase64, 'base64'),\n      );\n      this.writtenFileIds.add(image.id);\n    }\n    return { relativePath, absolutePath };\n  }\n\n  /** Resolve any stored report image reference to a data URI. */\n  loadDataUri(refInput: unknown): string {\n    const ref = normalizeStoredImageRef(refInput);\n    if (!ref) {\n      throw new Error('ReportImageStore: invalid image reference');\n    }\n\n    const resolved = resolveImageSource(ref, {\n      reportPath: this.reportPath,\n      imageDirectory: this.screenshotsDir,\n    });\n\n    if (resolved.type === 'data-uri') {\n      return resolved.dataUri;\n    }\n\n    const data = readFileSync(resolved.filePath);\n    return `data:${resolved.mimeType};base64,${data.toString('base64')}`;\n  }\n\n  /** @deprecated Use loadDataUri. */\n  loadBase64(refInput: unknown): string {\n    const screenshotRef = normalizeScreenshotRef(refInput);\n    if (!screenshotRef) {\n      throw new Error('ReportImageStore: invalid screenshot reference');\n    }\n    return this.loadDataUri(screenshotRef);\n  }\n\n  cleanup(): void {\n    if (\n      this.mode === 'directory' &&\n      this.screenshotsDir &&\n      existsSync(this.screenshotsDir)\n    ) {\n      rmSync(this.screenshotsDir, { recursive: true, force: true });\n    }\n    this.writtenInlineIds.clear();\n    this.writtenFileIds.clear();\n    this.existingInlineImageIdsPromise = undefined;\n  }\n}\n\n/** @deprecated Use ReportImageStore. */\nexport { ReportImageStore as ScreenshotStore };\n"],"names":["base64ImageDataUrlPattern","parseBase64ImageDataUrl","imageUrl","match","Error","mimeType","imageFileExtensionForMimeType","isBase64ImageDataUrl","value","resolveImageSource","refInput","options","ref","normalizeStoredImageRef","id","resolveReportRelativePath","filePath","isAbsolute","join","dirname","explicitFilePath","existsSync","inlineDataUri","extractImageByIdSync","extension","imageRefFileExtension","companionImagePath","siblingImagePath","resolveScreenshotSource","normalizeScreenshotRef","ReportImageStore","screenshot","shouldWriteFileCopy","fileRef","rawBase64","createHash","Buffer","fileLocation","imageIds","collectImageScriptIds","imageId","error","fileName","relativePath","absolutePath","image","screenshotsDir","mkdirSync","writeFileAsync","resolved","data","readFileSync","screenshotRef","rmSync","undefined","Set","Boolean"],"mappings":"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"}

package/dist/es/report-cli.mjs

@@ -1,11 +1,12 @@
 import { copyFileSync, existsSync, mkdirSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, extname, join, resolve } from "node:path";
 import { z } from "zod";
-import { extractAllDumpScriptsSync } from "./dump/html-utils.mjs";
+import { extractAllDumpScriptsSync, extractTestRunReportDumpSync } from "./dump/html-utils.mjs";
 import { resolveScreenshotSource } from "./dump/screenshot-store.mjs";
 import { deriveCaseStatus } from "./dump/task-status.mjs";
 import { ReportMergingTool, collectDedupedExecutions, splitReportHtmlByExecution } from "./report.mjs";
 import { reportToMarkdown } from "./report-markdown.mjs";
+import { collectReportSummary } from "./report-stats.mjs";
 import { ReportActionDump } from "./types.mjs";
 function writeAttachmentFromReport(attachment, opts) {
     const { suggestedFileName, id, mimeType } = attachment;
@@ -110,14 +111,18 @@ function readSourceTestStatus(htmlPath) {
 }
 function deriveReportAttributesFromHtml(htmlPath, index) {
     const fallbackId = `${basename(dirname(htmlPath)) || basename(htmlPath, extname(htmlPath))}-${index + 1}`;
+    const runnerDump = extractTestRunReportDumpSync(htmlPath);
     try {
         const { baseDump, executions } = collectDedupedExecutions(htmlPath);
-        const testStatus = readSourceTestStatus(htmlPath) ?? deriveCaseStatus(executions);
+        const recordedStatus = readSourceTestStatus(htmlPath);
+        const testStatus = recordedStatus && FAILING_TEST_STATUSES.has(recordedStatus) ? recordedStatus : runnerDump?.status === 'failed' ? 'failed' : recordedStatus ?? (runnerDump ? 'passed' : deriveCaseStatus(executions));
         return {
             testId: fallbackId,
             testTitle: baseDump.groupName || fallbackId,
             testDescription: baseDump.groupDescription ?? '',
-            testDuration: 0,
+            testDuration: runnerDump?.durationMs ?? collectReportSummary({
+                executions
+            }).timing.wallTimeMs ?? 0,
             testStatus
         };
     } catch  {
@@ -126,7 +131,7 @@ function deriveReportAttributesFromHtml(htmlPath, index) {
             testTitle: fallbackId,
             testDescription: '',
             testDuration: 0,
-            testStatus: 'passed'
+            testStatus: runnerDump?.status === 'failed' ? 'failed' : 'passed'
         };
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"report-cli.mjs","sources":["../../src/report-cli.ts"],"sourcesContent":["import {\n  copyFileSync,\n  existsSync,\n  mkdirSync,\n  statSync,\n  writeFileSync,\n} from 'node:fs';\nimport * as path from 'node:path';\nimport { z } from 'zod';\nimport { extractAllDumpScriptsSync } from './dump/html-utils';\nimport { resolveScreenshotSource } from './dump/screenshot-store';\nimport { deriveCaseStatus } from './dump/task-status';\nimport {\n  ReportMergingTool,\n  collectDedupedExecutions,\n  splitReportHtmlByExecution,\n} from './report';\nimport { reportToMarkdown } from './report-markdown';\nimport type { MarkdownAttachment } from './report-markdown';\nimport type { ReportFileAttributes, TestStatus } from './types';\nimport { ReportActionDump } from './types';\n\ntype ReportCliToolResult = {\n  isError: boolean;\n  content: Array<{\n    type: 'text';\n    text: string;\n  }>;\n};\n\ntype ReportCliSchema = Record<string, z.ZodTypeAny>;\n\nexport interface ReportCliCommandDefinition {\n  name: string;\n  description: string;\n  schema: ReportCliSchema;\n  handler: (args: Record<string, unknown>) => Promise<ReportCliToolResult>;\n}\n\nexport interface ReportCliCommandEntry {\n  name: string;\n  def: ReportCliCommandDefinition;\n}\n\nexport type ConsumeReportFileAction = 'split' | 'to-markdown' | 'merge-html';\n\nexport interface ConsumeReportFileOptions {\n  htmlPath: string;\n  outputDir: string;\n}\n\nexport type SplitReportFileOptions = ConsumeReportFileOptions;\nexport type ReportFileToMarkdownOptions = ConsumeReportFileOptions;\n\nexport interface MergeReportFilesOptions {\n  htmlPaths: string[];\n  outputDir?: string;\n  outputName?: string;\n  overwrite?: boolean;\n}\n\nexport interface MergeReportFilesResult {\n  mergedReportPath: string;\n}\n\nfunction writeAttachmentFromReport(\n  attachment: MarkdownAttachment,\n  opts: {\n    htmlPath: string;\n    screenshotsDir: string;\n    writtenFiles: Set<string>;\n  },\n): void {\n  const { suggestedFileName, id, mimeType } = attachment;\n  if (opts.writtenFiles.has(suggestedFileName)) return;\n\n  const absolutePath = path.join(opts.screenshotsDir, suggestedFileName);\n\n  const resolved = resolveScreenshotSource(attachment.sourceRef ?? null, {\n    reportPath: opts.htmlPath,\n    fallbackId: id,\n    fallbackMimeType: (mimeType || 'image/png') as 'image/png' | 'image/jpeg',\n  });\n\n  if (resolved.type === 'data-uri') {\n    const rawBase64 = resolved.dataUri.replace(\n      /^data:image\\/[a-zA-Z+]+;base64,/,\n      '',\n    );\n    writeFileSync(absolutePath, Buffer.from(rawBase64, 'base64'));\n    opts.writtenFiles.add(suggestedFileName);\n    return;\n  }\n\n  if (!existsSync(resolved.filePath)) {\n    throw new Error(\n      `Cannot resolve screenshot \"${id}\" for markdown attachment from ${opts.htmlPath}`,\n    );\n  }\n\n  copyFileSync(resolved.filePath, absolutePath);\n  opts.writtenFiles.add(suggestedFileName);\n}\n\nasync function markdownFromReport(\n  htmlPath: string,\n  outputDir: string,\n): Promise<{ markdownFiles: string[]; screenshotFiles: string[] }> {\n  const screenshotsDir = path.join(outputDir, 'screenshots');\n\n  mkdirSync(outputDir, { recursive: true });\n  mkdirSync(screenshotsDir, { recursive: true });\n\n  const { baseDump, executions } = collectDedupedExecutions(htmlPath);\n\n  const mergedReport = new ReportActionDump({\n    sdkVersion: baseDump.sdkVersion,\n    groupName: baseDump.groupName,\n    groupDescription: baseDump.groupDescription,\n    modelBriefs: baseDump.modelBriefs,\n    deviceType: baseDump.deviceType,\n    executions,\n  });\n\n  const result = reportToMarkdown(mergedReport);\n\n  const markdownFiles: string[] = [];\n  const writtenScreenshots = new Set<string>();\n\n  const mdPath = path.join(outputDir, 'report.md');\n  writeFileSync(mdPath, result.markdown, 'utf-8');\n  markdownFiles.push(mdPath);\n\n  for (const attachment of result.attachments) {\n    writeAttachmentFromReport(attachment, {\n      htmlPath,\n      screenshotsDir,\n      writtenFiles: writtenScreenshots,\n    });\n  }\n\n  return {\n    markdownFiles,\n    screenshotFiles: Array.from(writtenScreenshots)\n      .sort()\n      .map((f) => path.join(screenshotsDir, f)),\n  };\n}\n\nfunction resolveReportHtmlPath(htmlPath: string): string {\n  const normalizedPath = path.resolve(htmlPath);\n\n  if (!existsSync(normalizedPath)) {\n    throw new Error(`report-tool: --htmlPath does not exist: ${htmlPath}`);\n  }\n\n  const stats = statSync(normalizedPath);\n  if (!stats.isDirectory()) {\n    return normalizedPath;\n  }\n\n  const indexHtmlPath = path.join(normalizedPath, 'index.html');\n  if (!existsSync(indexHtmlPath)) {\n    throw new Error(\n      `report-tool: \"${htmlPath}\" is not an HTML report file, and no index.html was found under this directory.`,\n    );\n  }\n\n  return indexHtmlPath;\n}\n\nexport function splitReportFile(options: SplitReportFileOptions): {\n  executionJsonFiles: string[];\n  screenshotFiles: string[];\n} {\n  const { htmlPath, outputDir } = options;\n  if (!htmlPath) {\n    throw new Error('splitReportFile: htmlPath is required');\n  }\n\n  if (!outputDir) {\n    throw new Error('splitReportFile: outputDir is required');\n  }\n\n  const resolvedHtmlPath = resolveReportHtmlPath(htmlPath);\n  return splitReportHtmlByExecution({\n    htmlPath: resolvedHtmlPath,\n    outputDir,\n  });\n}\n\nexport async function reportFileToMarkdown(\n  options: ReportFileToMarkdownOptions,\n): Promise<{ markdownFiles: string[]; screenshotFiles: string[] }> {\n  const { htmlPath, outputDir } = options;\n  if (!htmlPath) {\n    throw new Error('reportFileToMarkdown: htmlPath is required');\n  }\n\n  if (!outputDir) {\n    throw new Error('reportFileToMarkdown: outputDir is required');\n  }\n\n  const resolvedHtmlPath = resolveReportHtmlPath(htmlPath);\n  return markdownFromReport(resolvedHtmlPath, outputDir);\n}\n\nconst TEST_STATUS_VALUES: ReadonlySet<TestStatus> = new Set<TestStatus>([\n  'passed',\n  'failed',\n  'timedOut',\n  'skipped',\n  'interrupted',\n]);\n\nconst FAILING_TEST_STATUSES: ReadonlySet<TestStatus> = new Set<TestStatus>([\n  'failed',\n  'timedOut',\n  'interrupted',\n]);\n\n/**\n * Reuse a `playwright_test_status` already recorded on the source report's dump\n * scripts (e.g. a Playwright-generated report carries the precise\n * timedOut/skipped/interrupted status). Returns undefined when the source has\n * no such attribute, so the caller can fall back to deriving from the dump.\n *\n * A single source report may bundle several executions (e.g. an already-merged\n * report), so surface a failing status if any execution failed — mirroring\n * `deriveCaseStatus`'s any-failure-wins semantics rather than taking the first\n * script's status and masking later failures.\n */\nfunction readSourceTestStatus(htmlPath: string): TestStatus | undefined {\n  const recorded: TestStatus[] = [];\n  for (const { openTag } of extractAllDumpScriptsSync(htmlPath)) {\n    const match = openTag.match(/playwright_test_status=\"([^\"]*)\"/);\n    if (!match) continue;\n    const status = decodeURIComponent(match[1]) as TestStatus;\n    if (TEST_STATUS_VALUES.has(status)) {\n      recorded.push(status);\n    }\n  }\n  if (recorded.length === 0) return undefined;\n  return recorded.find((s) => FAILING_TEST_STATUSES.has(s)) ?? recorded[0];\n}\n\nfunction deriveReportAttributesFromHtml(\n  htmlPath: string,\n  index: number,\n): ReportFileAttributes {\n  const fallbackId = `${path.basename(path.dirname(htmlPath)) || path.basename(htmlPath, path.extname(htmlPath))}-${index + 1}`;\n  try {\n    const { baseDump, executions } = collectDedupedExecutions(htmlPath);\n    // Prefer a status the source report already recorded (keeps Playwright's\n    // precise timedOut/skipped/interrupted); otherwise infer it from the dump\n    // so a failing case is not silently merged in as passed.\n    const testStatus =\n      readSourceTestStatus(htmlPath) ?? deriveCaseStatus(executions);\n    return {\n      testId: fallbackId,\n      testTitle: baseDump.groupName || fallbackId,\n      testDescription: baseDump.groupDescription ?? '',\n      testDuration: 0,\n      testStatus,\n    };\n  } catch {\n    return {\n      testId: fallbackId,\n      testTitle: fallbackId,\n      testDescription: '',\n      testDuration: 0,\n      testStatus: 'passed' as TestStatus,\n    };\n  }\n}\n\nexport function mergeReportFiles(\n  options: MergeReportFilesOptions,\n): MergeReportFilesResult {\n  const { htmlPaths, outputDir, outputName, overwrite = false } = options;\n  if (!htmlPaths || htmlPaths.length === 0) {\n    throw new Error('mergeReportFiles: htmlPaths is required');\n  }\n\n  const resolvedPaths = htmlPaths.map((p) => resolveReportHtmlPath(p));\n\n  const tool = new ReportMergingTool();\n  resolvedPaths.forEach((htmlPath, index) => {\n    tool.append({\n      reportFilePath: htmlPath,\n      reportAttributes: deriveReportAttributesFromHtml(htmlPath, index),\n    });\n  });\n\n  const mergedReportPath = tool.mergeReports(outputName ?? 'AUTO', {\n    overwrite,\n    outputDir,\n  });\n\n  if (!mergedReportPath) {\n    throw new Error('mergeReportFiles: failed to produce a merged report');\n  }\n\n  return { mergedReportPath };\n}\n\nfunction normalizeHtmlReportArg(raw: unknown): string[] | undefined {\n  if (raw === undefined || raw === null) return undefined;\n  if (Array.isArray(raw)) {\n    return raw.filter(\n      (p): p is string => typeof p === 'string' && p.length > 0,\n    );\n  }\n  if (typeof raw === 'string') {\n    const trimmed = raw.trim();\n    return trimmed ? [trimmed] : [];\n  }\n  return undefined;\n}\n\nconst reportCommandDefinition: ReportCliCommandDefinition = {\n  name: 'report-tool',\n  description:\n    'Transform Midscene report artifacts, including splitting executions, converting to markdown, and merging multiple reports.',\n  schema: {\n    action: z\n      .enum(['split', 'to-markdown', 'merge-html'])\n      .optional()\n      .describe(\n        'Report action to run. Supports: split, to-markdown, merge-html. Defaults to split.',\n      ),\n    htmlPath: z\n      .string()\n      .optional()\n      .describe(\n        'Input report HTML path (e.g. ./report/index.html). Used by split and to-markdown.',\n      ),\n    htmlReport: z\n      .union([z.string(), z.array(z.string())])\n      .optional()\n      .describe(\n        'Input report HTML path for the merge action. Repeat the flag to merge multiple reports (e.g. --htmlReport ./a/index.html --htmlReport ./b.html).',\n      ),\n    outputDir: z\n      .string()\n      .optional()\n      .describe(\n        'Output directory for generated report artifacts. For merge, defaults to the Midscene report directory.',\n      ),\n    outputName: z\n      .string()\n      .optional()\n      .describe(\n        'Output report file/directory name (without .html) for the merge action. Defaults to an auto-generated name.',\n      ),\n    overwrite: z\n      .union([z.boolean(), z.string()])\n      .optional()\n      .describe(\n        'Overwrite the existing merged report file if present (merge action only).',\n      ),\n  },\n  handler: async (args) => {\n    const {\n      action = 'split',\n      htmlPath,\n      htmlReport,\n      outputDir,\n      outputName,\n      overwrite,\n    } = args as {\n      action?: string;\n      htmlPath?: string;\n      htmlReport?: unknown;\n      outputDir?: string;\n      outputName?: string;\n      overwrite?: unknown;\n    };\n    if (\n      action !== 'split' &&\n      action !== 'to-markdown' &&\n      action !== 'merge-html'\n    ) {\n      throw new Error(\n        `report-tool: unsupported --action value \"${action}\". Currently supported: split, to-markdown, merge-html`,\n      );\n    }\n\n    if (action === 'merge-html') {\n      const paths = normalizeHtmlReportArg(htmlReport);\n      if (!paths || paths.length === 0) {\n        throw new Error(\n          'report-tool: --htmlReport is required for action \"merge-html\". Repeat --htmlReport for each report (e.g. --htmlReport ./a/index.html --htmlReport ./b.html).',\n        );\n      }\n\n      const overwriteFlag =\n        overwrite === true || overwrite === 'true' || overwrite === '1';\n\n      const result = mergeReportFiles({\n        htmlPaths: paths,\n        outputDir,\n        outputName,\n        overwrite: overwriteFlag,\n      });\n\n      return {\n        isError: false,\n        content: [\n          {\n            type: 'text',\n            text: `Merged ${paths.length} report(s) into ${result.mergedReportPath}`,\n          },\n        ],\n      };\n    }\n\n    if (!htmlPath) {\n      throw new Error('report-tool: --htmlPath is required');\n    }\n\n    if (!outputDir) {\n      throw new Error('report-tool: --outputDir is required');\n    }\n\n    if (action === 'to-markdown') {\n      const result = await reportFileToMarkdown({\n        htmlPath,\n        outputDir,\n      });\n      return {\n        isError: false,\n        content: [\n          {\n            type: 'text',\n            text: `Markdown export completed. Generated ${result.markdownFiles.length} markdown file(s) and ${result.screenshotFiles.length} screenshot(s). Output path: ${outputDir}`,\n          },\n        ],\n      };\n    }\n\n    const result = splitReportFile({\n      htmlPath,\n      outputDir,\n    });\n\n    return {\n      isError: false,\n      content: [\n        {\n          type: 'text',\n          text: `Report split completed. Generated ${result.executionJsonFiles.length} execution JSON files and ${result.screenshotFiles.length} screenshots. Output path: ${outputDir}`,\n        },\n      ],\n    };\n  },\n};\n\nexport function createReportCliCommands(): ReportCliCommandEntry[] {\n  return [\n    {\n      name: 'report-tool',\n      def: reportCommandDefinition,\n    },\n  ];\n}\n"],"names":["writeAttachmentFromReport","attachment","opts","suggestedFileName","id","mimeType","absolutePath","path","resolved","resolveScreenshotSource","rawBase64","writeFileSync","Buffer","existsSync","Error","copyFileSync","markdownFromReport","htmlPath","outputDir","screenshotsDir","mkdirSync","baseDump","executions","collectDedupedExecutions","mergedReport","ReportActionDump","result","reportToMarkdown","markdownFiles","writtenScreenshots","Set","mdPath","Array","f","resolveReportHtmlPath","normalizedPath","stats","statSync","indexHtmlPath","splitReportFile","options","resolvedHtmlPath","splitReportHtmlByExecution","reportFileToMarkdown","TEST_STATUS_VALUES","FAILING_TEST_STATUSES","readSourceTestStatus","recorded","openTag","extractAllDumpScriptsSync","match","status","decodeURIComponent","s","deriveReportAttributesFromHtml","index","fallbackId","testStatus","deriveCaseStatus","mergeReportFiles","htmlPaths","outputName","overwrite","resolvedPaths","p","tool","ReportMergingTool","mergedReportPath","normalizeHtmlReportArg","raw","trimmed","reportCommandDefinition","z","args","action","htmlReport","paths","overwriteFlag","createReportCliCommands"],"mappings":";;;;;;;;;AAiEA,SAASA,0BACPC,UAA8B,EAC9BC,IAIC;IAED,MAAM,EAAEC,iBAAiB,EAAEC,EAAE,EAAEC,QAAQ,EAAE,GAAGJ;IAC5C,IAAIC,KAAK,YAAY,CAAC,GAAG,CAACC,oBAAoB;IAE9C,MAAMG,eAAeC,KAAUL,KAAK,cAAc,EAAEC;IAEpD,MAAMK,WAAWC,wBAAwBR,WAAW,SAAS,IAAI,MAAM;QACrE,YAAYC,KAAK,QAAQ;QACzB,YAAYE;QACZ,kBAAmBC,YAAY;IACjC;IAEA,IAAIG,AAAkB,eAAlBA,SAAS,IAAI,EAAiB;QAChC,MAAME,YAAYF,SAAS,OAAO,CAAC,OAAO,CACxC,mCACA;QAEFG,cAAcL,cAAcM,OAAO,IAAI,CAACF,WAAW;QACnDR,KAAK,YAAY,CAAC,GAAG,CAACC;QACtB;IACF;IAEA,IAAI,CAACU,WAAWL,SAAS,QAAQ,GAC/B,MAAM,IAAIM,MACR,CAAC,2BAA2B,EAAEV,GAAG,+BAA+B,EAAEF,KAAK,QAAQ,EAAE;IAIrFa,aAAaP,SAAS,QAAQ,EAAEF;IAChCJ,KAAK,YAAY,CAAC,GAAG,CAACC;AACxB;AAEA,eAAea,mBACbC,QAAgB,EAChBC,SAAiB;IAEjB,MAAMC,iBAAiBZ,KAAUW,WAAW;IAE5CE,UAAUF,WAAW;QAAE,WAAW;IAAK;IACvCE,UAAUD,gBAAgB;QAAE,WAAW;IAAK;IAE5C,MAAM,EAAEE,QAAQ,EAAEC,UAAU,EAAE,GAAGC,yBAAyBN;IAE1D,MAAMO,eAAe,IAAIC,iBAAiB;QACxC,YAAYJ,SAAS,UAAU;QAC/B,WAAWA,SAAS,SAAS;QAC7B,kBAAkBA,SAAS,gBAAgB;QAC3C,aAAaA,SAAS,WAAW;QACjC,YAAYA,SAAS,UAAU;QAC/BC;IACF;IAEA,MAAMI,SAASC,iBAAiBH;IAEhC,MAAMI,gBAA0B,EAAE;IAClC,MAAMC,qBAAqB,IAAIC;IAE/B,MAAMC,SAASxB,KAAUW,WAAW;IACpCP,cAAcoB,QAAQL,OAAO,QAAQ,EAAE;IACvCE,cAAc,IAAI,CAACG;IAEnB,KAAK,MAAM9B,cAAcyB,OAAO,WAAW,CACzC1B,0BAA0BC,YAAY;QACpCgB;QACAE;QACA,cAAcU;IAChB;IAGF,OAAO;QACLD;QACA,iBAAiBI,MAAM,IAAI,CAACH,oBACzB,IAAI,GACJ,GAAG,CAAC,CAACI,IAAM1B,KAAUY,gBAAgBc;IAC1C;AACF;AAEA,SAASC,sBAAsBjB,QAAgB;IAC7C,MAAMkB,iBAAiB5B,QAAaU;IAEpC,IAAI,CAACJ,WAAWsB,iBACd,MAAM,IAAIrB,MAAM,CAAC,wCAAwC,EAAEG,UAAU;IAGvE,MAAMmB,QAAQC,SAASF;IACvB,IAAI,CAACC,MAAM,WAAW,IACpB,OAAOD;IAGT,MAAMG,gBAAgB/B,KAAU4B,gBAAgB;IAChD,IAAI,CAACtB,WAAWyB,gBACd,MAAM,IAAIxB,MACR,CAAC,cAAc,EAAEG,SAAS,+EAA+E,CAAC;IAI9G,OAAOqB;AACT;AAEO,SAASC,gBAAgBC,OAA+B;IAI7D,MAAM,EAAEvB,QAAQ,EAAEC,SAAS,EAAE,GAAGsB;IAChC,IAAI,CAACvB,UACH,MAAM,IAAIH,MAAM;IAGlB,IAAI,CAACI,WACH,MAAM,IAAIJ,MAAM;IAGlB,MAAM2B,mBAAmBP,sBAAsBjB;IAC/C,OAAOyB,2BAA2B;QAChC,UAAUD;QACVvB;IACF;AACF;AAEO,eAAeyB,qBACpBH,OAAoC;IAEpC,MAAM,EAAEvB,QAAQ,EAAEC,SAAS,EAAE,GAAGsB;IAChC,IAAI,CAACvB,UACH,MAAM,IAAIH,MAAM;IAGlB,IAAI,CAACI,WACH,MAAM,IAAIJ,MAAM;IAGlB,MAAM2B,mBAAmBP,sBAAsBjB;IAC/C,OAAOD,mBAAmByB,kBAAkBvB;AAC9C;AAEA,MAAM0B,qBAA8C,IAAId,IAAgB;IACtE;IACA;IACA;IACA;IACA;CACD;AAED,MAAMe,wBAAiD,IAAIf,IAAgB;IACzE;IACA;IACA;CACD;AAaD,SAASgB,qBAAqB7B,QAAgB;IAC5C,MAAM8B,WAAyB,EAAE;IACjC,KAAK,MAAM,EAAEC,OAAO,EAAE,IAAIC,0BAA0BhC,UAAW;QAC7D,MAAMiC,QAAQF,QAAQ,KAAK,CAAC;QAC5B,IAAI,CAACE,OAAO;QACZ,MAAMC,SAASC,mBAAmBF,KAAK,CAAC,EAAE;QAC1C,IAAIN,mBAAmB,GAAG,CAACO,SACzBJ,SAAS,IAAI,CAACI;IAElB;IACA,IAAIJ,AAAoB,MAApBA,SAAS,MAAM,EAAQ;IAC3B,OAAOA,SAAS,IAAI,CAAC,CAACM,IAAMR,sBAAsB,GAAG,CAACQ,OAAON,QAAQ,CAAC,EAAE;AAC1E;AAEA,SAASO,+BACPrC,QAAgB,EAChBsC,KAAa;IAEb,MAAMC,aAAa,GAAGjD,SAAcA,QAAaU,cAAcV,SAAcU,UAAUV,QAAaU,WAAW,CAAC,EAAEsC,QAAQ,GAAG;IAC7H,IAAI;QACF,MAAM,EAAElC,QAAQ,EAAEC,UAAU,EAAE,GAAGC,yBAAyBN;QAI1D,MAAMwC,aACJX,qBAAqB7B,aAAayC,iBAAiBpC;QACrD,OAAO;YACL,QAAQkC;YACR,WAAWnC,SAAS,SAAS,IAAImC;YACjC,iBAAiBnC,SAAS,gBAAgB,IAAI;YAC9C,cAAc;YACdoC;QACF;IACF,EAAE,OAAM;QACN,OAAO;YACL,QAAQD;YACR,WAAWA;YACX,iBAAiB;YACjB,cAAc;YACd,YAAY;QACd;IACF;AACF;AAEO,SAASG,iBACdnB,OAAgC;IAEhC,MAAM,EAAEoB,SAAS,EAAE1C,SAAS,EAAE2C,UAAU,EAAEC,YAAY,KAAK,EAAE,GAAGtB;IAChE,IAAI,CAACoB,aAAaA,AAAqB,MAArBA,UAAU,MAAM,EAChC,MAAM,IAAI9C,MAAM;IAGlB,MAAMiD,gBAAgBH,UAAU,GAAG,CAAC,CAACI,IAAM9B,sBAAsB8B;IAEjE,MAAMC,OAAO,IAAIC;IACjBH,cAAc,OAAO,CAAC,CAAC9C,UAAUsC;QAC/BU,KAAK,MAAM,CAAC;YACV,gBAAgBhD;YAChB,kBAAkBqC,+BAA+BrC,UAAUsC;QAC7D;IACF;IAEA,MAAMY,mBAAmBF,KAAK,YAAY,CAACJ,cAAc,QAAQ;QAC/DC;QACA5C;IACF;IAEA,IAAI,CAACiD,kBACH,MAAM,IAAIrD,MAAM;IAGlB,OAAO;QAAEqD;IAAiB;AAC5B;AAEA,SAASC,uBAAuBC,GAAY;IAC1C,IAAIA,QAAAA,KAAmC;IACvC,IAAIrC,MAAM,OAAO,CAACqC,MAChB,OAAOA,IAAI,MAAM,CACf,CAACL,IAAmB,AAAa,YAAb,OAAOA,KAAkBA,EAAE,MAAM,GAAG;IAG5D,IAAI,AAAe,YAAf,OAAOK,KAAkB;QAC3B,MAAMC,UAAUD,IAAI,IAAI;QACxB,OAAOC,UAAU;YAACA;SAAQ,GAAG,EAAE;IACjC;AAEF;AAEA,MAAMC,0BAAsD;IAC1D,MAAM;IACN,aACE;IACF,QAAQ;QACN,QAAQC,CAAC,CAADA,OACD,CAAC;YAAC;YAAS;YAAe;SAAa,EAC3C,QAAQ,GACR,QAAQ,CACP;QAEJ,UAAUA,EAAAA,MACD,GACN,QAAQ,GACR,QAAQ,CACP;QAEJ,YAAYA,EAAAA,KACJ,CAAC;YAACA,EAAE,MAAM;YAAIA,EAAE,KAAK,CAACA,EAAE,MAAM;SAAI,EACvC,QAAQ,GACR,QAAQ,CACP;QAEJ,WAAWA,EAAAA,MACF,GACN,QAAQ,GACR,QAAQ,CACP;QAEJ,YAAYA,EAAAA,MACH,GACN,QAAQ,GACR,QAAQ,CACP;QAEJ,WAAWA,EAAAA,KACH,CAAC;YAACA,EAAE,OAAO;YAAIA,EAAE,MAAM;SAAG,EAC/B,QAAQ,GACR,QAAQ,CACP;IAEN;IACA,SAAS,OAAOC;QACd,MAAM,EACJC,SAAS,OAAO,EAChBzD,QAAQ,EACR0D,UAAU,EACVzD,SAAS,EACT2C,UAAU,EACVC,SAAS,EACV,GAAGW;QAQJ,IACEC,AAAW,YAAXA,UACAA,AAAW,kBAAXA,UACAA,AAAW,iBAAXA,QAEA,MAAM,IAAI5D,MACR,CAAC,yCAAyC,EAAE4D,OAAO,sDAAsD,CAAC;QAI9G,IAAIA,AAAW,iBAAXA,QAAyB;YAC3B,MAAME,QAAQR,uBAAuBO;YACrC,IAAI,CAACC,SAASA,AAAiB,MAAjBA,MAAM,MAAM,EACxB,MAAM,IAAI9D,MACR;YAIJ,MAAM+D,gBACJf,AAAc,SAAdA,aAAsBA,AAAc,WAAdA,aAAwBA,AAAc,QAAdA;YAEhD,MAAMpC,SAASiC,iBAAiB;gBAC9B,WAAWiB;gBACX1D;gBACA2C;gBACA,WAAWgB;YACb;YAEA,OAAO;gBACL,SAAS;gBACT,SAAS;oBACP;wBACE,MAAM;wBACN,MAAM,CAAC,OAAO,EAAED,MAAM,MAAM,CAAC,gBAAgB,EAAElD,OAAO,gBAAgB,EAAE;oBAC1E;iBACD;YACH;QACF;QAEA,IAAI,CAACT,UACH,MAAM,IAAIH,MAAM;QAGlB,IAAI,CAACI,WACH,MAAM,IAAIJ,MAAM;QAGlB,IAAI4D,AAAW,kBAAXA,QAA0B;YAC5B,MAAMhD,SAAS,MAAMiB,qBAAqB;gBACxC1B;gBACAC;YACF;YACA,OAAO;gBACL,SAAS;gBACT,SAAS;oBACP;wBACE,MAAM;wBACN,MAAM,CAAC,qCAAqC,EAAEQ,OAAO,aAAa,CAAC,MAAM,CAAC,sBAAsB,EAAEA,OAAO,eAAe,CAAC,MAAM,CAAC,6BAA6B,EAAER,WAAW;oBAC5K;iBACD;YACH;QACF;QAEA,MAAMQ,SAASa,gBAAgB;YAC7BtB;YACAC;QACF;QAEA,OAAO;YACL,SAAS;YACT,SAAS;gBACP;oBACE,MAAM;oBACN,MAAM,CAAC,kCAAkC,EAAEQ,OAAO,kBAAkB,CAAC,MAAM,CAAC,0BAA0B,EAAEA,OAAO,eAAe,CAAC,MAAM,CAAC,2BAA2B,EAAER,WAAW;gBAChL;aACD;QACH;IACF;AACF;AAEO,SAAS4D;IACd,OAAO;QACL;YACE,MAAM;YACN,KAAKP;QACP;KACD;AACH"}
+{"version":3,"file":"report-cli.mjs","sources":["../../src/report-cli.ts"],"sourcesContent":["import {\n  copyFileSync,\n  existsSync,\n  mkdirSync,\n  statSync,\n  writeFileSync,\n} from 'node:fs';\nimport * as path from 'node:path';\nimport { z } from 'zod';\nimport {\n  extractAllDumpScriptsSync,\n  extractTestRunReportDumpSync,\n} from './dump/html-utils';\nimport { resolveScreenshotSource } from './dump/screenshot-store';\nimport { deriveCaseStatus } from './dump/task-status';\nimport {\n  ReportMergingTool,\n  collectDedupedExecutions,\n  splitReportHtmlByExecution,\n} from './report';\nimport { reportToMarkdown } from './report-markdown';\nimport type { MarkdownAttachment } from './report-markdown';\nimport { collectReportSummary } from './report-stats';\nimport type { ReportFileAttributes, TestStatus } from './types';\nimport { ReportActionDump } from './types';\n\ntype ReportCliToolResult = {\n  isError: boolean;\n  content: Array<{\n    type: 'text';\n    text: string;\n  }>;\n};\n\ntype ReportCliSchema = Record<string, z.ZodTypeAny>;\n\nexport interface ReportCliCommandDefinition {\n  name: string;\n  description: string;\n  schema: ReportCliSchema;\n  handler: (args: Record<string, unknown>) => Promise<ReportCliToolResult>;\n}\n\nexport interface ReportCliCommandEntry {\n  name: string;\n  def: ReportCliCommandDefinition;\n}\n\nexport type ConsumeReportFileAction = 'split' | 'to-markdown' | 'merge-html';\n\nexport interface ConsumeReportFileOptions {\n  htmlPath: string;\n  outputDir: string;\n}\n\nexport type SplitReportFileOptions = ConsumeReportFileOptions;\nexport type ReportFileToMarkdownOptions = ConsumeReportFileOptions;\n\nexport interface MergeReportFilesOptions {\n  htmlPaths: string[];\n  outputDir?: string;\n  outputName?: string;\n  overwrite?: boolean;\n}\n\nexport interface MergeReportFilesResult {\n  mergedReportPath: string;\n}\n\nfunction writeAttachmentFromReport(\n  attachment: MarkdownAttachment,\n  opts: {\n    htmlPath: string;\n    screenshotsDir: string;\n    writtenFiles: Set<string>;\n  },\n): void {\n  const { suggestedFileName, id, mimeType } = attachment;\n  if (opts.writtenFiles.has(suggestedFileName)) return;\n\n  const absolutePath = path.join(opts.screenshotsDir, suggestedFileName);\n\n  const resolved = resolveScreenshotSource(attachment.sourceRef ?? null, {\n    reportPath: opts.htmlPath,\n    fallbackId: id,\n    fallbackMimeType: (mimeType || 'image/png') as 'image/png' | 'image/jpeg',\n  });\n\n  if (resolved.type === 'data-uri') {\n    const rawBase64 = resolved.dataUri.replace(\n      /^data:image\\/[a-zA-Z+]+;base64,/,\n      '',\n    );\n    writeFileSync(absolutePath, Buffer.from(rawBase64, 'base64'));\n    opts.writtenFiles.add(suggestedFileName);\n    return;\n  }\n\n  if (!existsSync(resolved.filePath)) {\n    throw new Error(\n      `Cannot resolve screenshot \"${id}\" for markdown attachment from ${opts.htmlPath}`,\n    );\n  }\n\n  copyFileSync(resolved.filePath, absolutePath);\n  opts.writtenFiles.add(suggestedFileName);\n}\n\nasync function markdownFromReport(\n  htmlPath: string,\n  outputDir: string,\n): Promise<{ markdownFiles: string[]; screenshotFiles: string[] }> {\n  const screenshotsDir = path.join(outputDir, 'screenshots');\n\n  mkdirSync(outputDir, { recursive: true });\n  mkdirSync(screenshotsDir, { recursive: true });\n\n  const { baseDump, executions } = collectDedupedExecutions(htmlPath);\n\n  const mergedReport = new ReportActionDump({\n    sdkVersion: baseDump.sdkVersion,\n    groupName: baseDump.groupName,\n    groupDescription: baseDump.groupDescription,\n    modelBriefs: baseDump.modelBriefs,\n    deviceType: baseDump.deviceType,\n    executions,\n  });\n\n  const result = reportToMarkdown(mergedReport);\n\n  const markdownFiles: string[] = [];\n  const writtenScreenshots = new Set<string>();\n\n  const mdPath = path.join(outputDir, 'report.md');\n  writeFileSync(mdPath, result.markdown, 'utf-8');\n  markdownFiles.push(mdPath);\n\n  for (const attachment of result.attachments) {\n    writeAttachmentFromReport(attachment, {\n      htmlPath,\n      screenshotsDir,\n      writtenFiles: writtenScreenshots,\n    });\n  }\n\n  return {\n    markdownFiles,\n    screenshotFiles: Array.from(writtenScreenshots)\n      .sort()\n      .map((f) => path.join(screenshotsDir, f)),\n  };\n}\n\nfunction resolveReportHtmlPath(htmlPath: string): string {\n  const normalizedPath = path.resolve(htmlPath);\n\n  if (!existsSync(normalizedPath)) {\n    throw new Error(`report-tool: --htmlPath does not exist: ${htmlPath}`);\n  }\n\n  const stats = statSync(normalizedPath);\n  if (!stats.isDirectory()) {\n    return normalizedPath;\n  }\n\n  const indexHtmlPath = path.join(normalizedPath, 'index.html');\n  if (!existsSync(indexHtmlPath)) {\n    throw new Error(\n      `report-tool: \"${htmlPath}\" is not an HTML report file, and no index.html was found under this directory.`,\n    );\n  }\n\n  return indexHtmlPath;\n}\n\nexport function splitReportFile(options: SplitReportFileOptions): {\n  executionJsonFiles: string[];\n  screenshotFiles: string[];\n} {\n  const { htmlPath, outputDir } = options;\n  if (!htmlPath) {\n    throw new Error('splitReportFile: htmlPath is required');\n  }\n\n  if (!outputDir) {\n    throw new Error('splitReportFile: outputDir is required');\n  }\n\n  const resolvedHtmlPath = resolveReportHtmlPath(htmlPath);\n  return splitReportHtmlByExecution({\n    htmlPath: resolvedHtmlPath,\n    outputDir,\n  });\n}\n\nexport async function reportFileToMarkdown(\n  options: ReportFileToMarkdownOptions,\n): Promise<{ markdownFiles: string[]; screenshotFiles: string[] }> {\n  const { htmlPath, outputDir } = options;\n  if (!htmlPath) {\n    throw new Error('reportFileToMarkdown: htmlPath is required');\n  }\n\n  if (!outputDir) {\n    throw new Error('reportFileToMarkdown: outputDir is required');\n  }\n\n  const resolvedHtmlPath = resolveReportHtmlPath(htmlPath);\n  return markdownFromReport(resolvedHtmlPath, outputDir);\n}\n\nconst TEST_STATUS_VALUES: ReadonlySet<TestStatus> = new Set<TestStatus>([\n  'passed',\n  'failed',\n  'timedOut',\n  'skipped',\n  'interrupted',\n]);\n\nconst FAILING_TEST_STATUSES: ReadonlySet<TestStatus> = new Set<TestStatus>([\n  'failed',\n  'timedOut',\n  'interrupted',\n]);\n\n/**\n * Reuse a `playwright_test_status` already recorded on the source report's dump\n * scripts (e.g. a Playwright-generated report carries the precise\n * timedOut/skipped/interrupted status). Returns undefined when the source has\n * no such attribute, so the caller can fall back to deriving from the dump.\n *\n * A single source report may bundle several executions (e.g. an already-merged\n * report), so surface a failing status if any execution failed — mirroring\n * `deriveCaseStatus`'s any-failure-wins semantics rather than taking the first\n * script's status and masking later failures.\n */\nfunction readSourceTestStatus(htmlPath: string): TestStatus | undefined {\n  const recorded: TestStatus[] = [];\n  for (const { openTag } of extractAllDumpScriptsSync(htmlPath)) {\n    const match = openTag.match(/playwright_test_status=\"([^\"]*)\"/);\n    if (!match) continue;\n    const status = decodeURIComponent(match[1]) as TestStatus;\n    if (TEST_STATUS_VALUES.has(status)) {\n      recorded.push(status);\n    }\n  }\n  if (recorded.length === 0) return undefined;\n  return recorded.find((s) => FAILING_TEST_STATUSES.has(s)) ?? recorded[0];\n}\n\nfunction deriveReportAttributesFromHtml(\n  htmlPath: string,\n  index: number,\n): ReportFileAttributes {\n  const fallbackId = `${path.basename(path.dirname(htmlPath)) || path.basename(htmlPath, path.extname(htmlPath))}-${index + 1}`;\n  const runnerDump = extractTestRunReportDumpSync(htmlPath);\n  try {\n    const { baseDump, executions } = collectDedupedExecutions(htmlPath);\n    // Prefer a status the source report already recorded (keeps Playwright's\n    // precise timedOut/skipped/interrupted); otherwise infer it from the dump\n    // so a failing case is not silently merged in as passed.\n    const recordedStatus = readSourceTestStatus(htmlPath);\n    const testStatus =\n      recordedStatus && FAILING_TEST_STATUSES.has(recordedStatus)\n        ? recordedStatus\n        : runnerDump?.status === 'failed'\n          ? 'failed'\n          : (recordedStatus ??\n            (runnerDump ? 'passed' : deriveCaseStatus(executions)));\n    return {\n      testId: fallbackId,\n      testTitle: baseDump.groupName || fallbackId,\n      testDescription: baseDump.groupDescription ?? '',\n      testDuration:\n        runnerDump?.durationMs ??\n        collectReportSummary({ executions }).timing.wallTimeMs ??\n        0,\n      testStatus,\n    };\n  } catch {\n    return {\n      testId: fallbackId,\n      testTitle: fallbackId,\n      testDescription: '',\n      testDuration: 0,\n      testStatus: runnerDump?.status === 'failed' ? 'failed' : 'passed',\n    };\n  }\n}\n\nexport function mergeReportFiles(\n  options: MergeReportFilesOptions,\n): MergeReportFilesResult {\n  const { htmlPaths, outputDir, outputName, overwrite = false } = options;\n  if (!htmlPaths || htmlPaths.length === 0) {\n    throw new Error('mergeReportFiles: htmlPaths is required');\n  }\n\n  const resolvedPaths = htmlPaths.map((p) => resolveReportHtmlPath(p));\n\n  const tool = new ReportMergingTool();\n  resolvedPaths.forEach((htmlPath, index) => {\n    tool.append({\n      reportFilePath: htmlPath,\n      reportAttributes: deriveReportAttributesFromHtml(htmlPath, index),\n    });\n  });\n\n  const mergedReportPath = tool.mergeReports(outputName ?? 'AUTO', {\n    overwrite,\n    outputDir,\n  });\n\n  if (!mergedReportPath) {\n    throw new Error('mergeReportFiles: failed to produce a merged report');\n  }\n\n  return { mergedReportPath };\n}\n\nfunction normalizeHtmlReportArg(raw: unknown): string[] | undefined {\n  if (raw === undefined || raw === null) return undefined;\n  if (Array.isArray(raw)) {\n    return raw.filter(\n      (p): p is string => typeof p === 'string' && p.length > 0,\n    );\n  }\n  if (typeof raw === 'string') {\n    const trimmed = raw.trim();\n    return trimmed ? [trimmed] : [];\n  }\n  return undefined;\n}\n\nconst reportCommandDefinition: ReportCliCommandDefinition = {\n  name: 'report-tool',\n  description:\n    'Transform Midscene report artifacts, including splitting executions, converting to markdown, and merging multiple reports.',\n  schema: {\n    action: z\n      .enum(['split', 'to-markdown', 'merge-html'])\n      .optional()\n      .describe(\n        'Report action to run. Supports: split, to-markdown, merge-html. Defaults to split.',\n      ),\n    htmlPath: z\n      .string()\n      .optional()\n      .describe(\n        'Input report HTML path (e.g. ./report/index.html). Used by split and to-markdown.',\n      ),\n    htmlReport: z\n      .union([z.string(), z.array(z.string())])\n      .optional()\n      .describe(\n        'Input report HTML path for the merge action. Repeat the flag to merge multiple reports (e.g. --htmlReport ./a/index.html --htmlReport ./b.html).',\n      ),\n    outputDir: z\n      .string()\n      .optional()\n      .describe(\n        'Output directory for generated report artifacts. For merge, defaults to the Midscene report directory.',\n      ),\n    outputName: z\n      .string()\n      .optional()\n      .describe(\n        'Output report file/directory name (without .html) for the merge action. Defaults to an auto-generated name.',\n      ),\n    overwrite: z\n      .union([z.boolean(), z.string()])\n      .optional()\n      .describe(\n        'Overwrite the existing merged report file if present (merge action only).',\n      ),\n  },\n  handler: async (args) => {\n    const {\n      action = 'split',\n      htmlPath,\n      htmlReport,\n      outputDir,\n      outputName,\n      overwrite,\n    } = args as {\n      action?: string;\n      htmlPath?: string;\n      htmlReport?: unknown;\n      outputDir?: string;\n      outputName?: string;\n      overwrite?: unknown;\n    };\n    if (\n      action !== 'split' &&\n      action !== 'to-markdown' &&\n      action !== 'merge-html'\n    ) {\n      throw new Error(\n        `report-tool: unsupported --action value \"${action}\". Currently supported: split, to-markdown, merge-html`,\n      );\n    }\n\n    if (action === 'merge-html') {\n      const paths = normalizeHtmlReportArg(htmlReport);\n      if (!paths || paths.length === 0) {\n        throw new Error(\n          'report-tool: --htmlReport is required for action \"merge-html\". Repeat --htmlReport for each report (e.g. --htmlReport ./a/index.html --htmlReport ./b.html).',\n        );\n      }\n\n      const overwriteFlag =\n        overwrite === true || overwrite === 'true' || overwrite === '1';\n\n      const result = mergeReportFiles({\n        htmlPaths: paths,\n        outputDir,\n        outputName,\n        overwrite: overwriteFlag,\n      });\n\n      return {\n        isError: false,\n        content: [\n          {\n            type: 'text',\n            text: `Merged ${paths.length} report(s) into ${result.mergedReportPath}`,\n          },\n        ],\n      };\n    }\n\n    if (!htmlPath) {\n      throw new Error('report-tool: --htmlPath is required');\n    }\n\n    if (!outputDir) {\n      throw new Error('report-tool: --outputDir is required');\n    }\n\n    if (action === 'to-markdown') {\n      const result = await reportFileToMarkdown({\n        htmlPath,\n        outputDir,\n      });\n      return {\n        isError: false,\n        content: [\n          {\n            type: 'text',\n            text: `Markdown export completed. Generated ${result.markdownFiles.length} markdown file(s) and ${result.screenshotFiles.length} screenshot(s). Output path: ${outputDir}`,\n          },\n        ],\n      };\n    }\n\n    const result = splitReportFile({\n      htmlPath,\n      outputDir,\n    });\n\n    return {\n      isError: false,\n      content: [\n        {\n          type: 'text',\n          text: `Report split completed. Generated ${result.executionJsonFiles.length} execution JSON files and ${result.screenshotFiles.length} screenshots. Output path: ${outputDir}`,\n        },\n      ],\n    };\n  },\n};\n\nexport function createReportCliCommands(): ReportCliCommandEntry[] {\n  return [\n    {\n      name: 'report-tool',\n      def: reportCommandDefinition,\n    },\n  ];\n}\n"],"names":["writeAttachmentFromReport","attachment","opts","suggestedFileName","id","mimeType","absolutePath","path","resolved","resolveScreenshotSource","rawBase64","writeFileSync","Buffer","existsSync","Error","copyFileSync","markdownFromReport","htmlPath","outputDir","screenshotsDir","mkdirSync","baseDump","executions","collectDedupedExecutions","mergedReport","ReportActionDump","result","reportToMarkdown","markdownFiles","writtenScreenshots","Set","mdPath","Array","f","resolveReportHtmlPath","normalizedPath","stats","statSync","indexHtmlPath","splitReportFile","options","resolvedHtmlPath","splitReportHtmlByExecution","reportFileToMarkdown","TEST_STATUS_VALUES","FAILING_TEST_STATUSES","readSourceTestStatus","recorded","openTag","extractAllDumpScriptsSync","match","status","decodeURIComponent","s","deriveReportAttributesFromHtml","index","fallbackId","runnerDump","extractTestRunReportDumpSync","recordedStatus","testStatus","deriveCaseStatus","collectReportSummary","mergeReportFiles","htmlPaths","outputName","overwrite","resolvedPaths","p","tool","ReportMergingTool","mergedReportPath","normalizeHtmlReportArg","raw","trimmed","reportCommandDefinition","z","args","action","htmlReport","paths","overwriteFlag","createReportCliCommands"],"mappings":"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"}

package/dist/es/report-generator.mjs

@@ -1,13 +1,15 @@
 import { existsSync, mkdirSync, readdirSync } from "node:fs";
-import { appendFile, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
+import { appendFile, readFile, rename, unlink, writeFile } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
 import { getMidsceneRunSubDir } from "@midscene/shared/common";
 import { MIDSCENE_REPORT_QUIET, globalConfigManager } from "@midscene/shared/env";
 import { getDebug } from "@midscene/shared/logger";
 import { ifInBrowser, logMsg, uuid } from "@midscene/shared/utils";
-import { DATA_SCREENSHOT_MODE_ATTR, generateAgentReportComment, generateDumpScriptTag, generateImageScriptTag, getBaseUrlFixScript } from "./dump/html-utils.mjs";
+import { DATA_SCREENSHOT_MODE_ATTR, generateAgentReportComment, generateDumpScriptTag, generateImageScriptTag, generateTestRunReportScriptTag, getBaseUrlFixScript } from "./dump/html-utils.mjs";
+import { imageRefFileExtension, normalizeStoredImageRef } from "./dump/image-reference.mjs";
 import { compactReportDumps } from "./dump/report-dump-compactor.mjs";
 import { ReportImageStore } from "./dump/screenshot-store.mjs";
+import { buildAgentTestRunReportDump } from "./test-runner/reporting/agent-report.mjs";
 import { ReportActionDump } from "./types.mjs";
 import { getReportTpl } from "./utils.mjs";
 function _define_property(obj, key, value) {
@@ -28,7 +30,8 @@ const nullReportGenerator = {
     onExecutionUpdate: ()=>{},
     flush: async ()=>{},
     finalize: async ()=>void 0,
-    getReportPath: ()=>void 0
+    getReportPath: ()=>void 0,
+    writeRunnerReport: async ()=>void 0
 };
 function assertReportGenerationOptions(opts) {
     if (false === opts.generateReport && true === opts.persistExecutionDump) throw new Error('persistExecutionDump cannot be true when generateReport is false');
@@ -79,6 +82,116 @@ class ReportGenerator {
     getReportPath() {
         return this.reportPath;
     }
+    async writeRunnerReport(input, scopeId, meta) {
+        this.writeQueue = this.writeQueue.then(async ()=>{
+            const reportMeta = this.lastReportMeta ?? meta;
+            const executions = [
+                ...this.executionsByKey.values()
+            ];
+            const agentDump = new ReportActionDump({
+                ...reportMeta,
+                executions
+            });
+            const reportId = this.reportAttributes['data-report-id'] ?? this.reportAttributes['data-group-id'] ?? this.reportStreamId;
+            const dump = buildAgentTestRunReportDump(input, agentDump, {
+                reportId,
+                scopeId,
+                sourcePath: this.reportPath
+            });
+            for (const diagnostic of dump.diagnostics ?? [])warnReport(diagnostic.message);
+            const sourceDump = await this.serializeSourceDump();
+            const images = [];
+            if ('inline' === this.screenshotMode) for (const ref of sourceDump.images.values()){
+                const bytes = await readFile(join(dirname(this.reportPath), ref.path));
+                images.push(generateImageScriptTag(ref.id, `data:${ref.mimeType};base64,${bytes.toString('base64')}`));
+            }
+            const renderedDump = 'inline' === this.screenshotMode ? JSON.stringify(JSON.parse(sourceDump.serialized), (_key, value)=>{
+                const ref = normalizeStoredImageRef(value);
+                return ref ? {
+                    ...ref,
+                    storage: 'inline',
+                    path: void 0
+                } : value;
+            }) : sourceDump.serialized;
+            const contents = `${getReportTpl()}${'directory' === this.screenshotMode ? getBaseUrlFixScript() : ''}
+${generateDumpScriptTag(renderedDump, this.getDumpScriptAttributes())}
+${images.join('\n')}
+${generateTestRunReportScriptTag(dump)}
+${generateAgentReportComment(agentDump)}`;
+            mkdirSync(dirname(this.reportPath), {
+                recursive: true
+            });
+            const temporaryPath = `${this.reportPath}.runner-${uuid()}.tmp`;
+            try {
+                await writeFile(temporaryPath, contents);
+                await rename(temporaryPath, this.reportPath);
+            } finally{
+                await unlink(temporaryPath).catch((error)=>{
+                    if ('ENOENT' !== error.code) throw error;
+                });
+            }
+            this.initialized = true;
+            if (!this.firstWriteDone) {
+                this.firstWriteDone = true;
+                this.printReportPath();
+            }
+        });
+        await this.flush();
+        return this.reportPath;
+    }
+    enableSourceSnapshots() {
+        this.screenshotStore.enableFileCopies();
+    }
+    async serializeSourceDump() {
+        this.enableSourceSnapshots();
+        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({
+            ...this.lastReportMeta ?? {
+                sdkVersion: '',
+                groupName: 'YAML execution',
+                modelBriefs: []
+            },
+            executions: [
+                ...this.executionsByKey.values()
+            ]
+        });
+        const images = new Map();
+        const serialized = JSON.stringify(JSON.parse(dump.serializeWithReferenceImages(references)), (_key, value)=>{
+            const ref = normalizeStoredImageRef(value);
+            if (!ref) return value;
+            const stored = {
+                ...ref,
+                storage: 'file',
+                path: `./screenshots/${ref.id}.${imageRefFileExtension(ref)}`
+            };
+            images.set(ref.id, stored);
+            return stored;
+        });
+        return {
+            serialized,
+            images
+        };
+    }
+    async createSourceSnapshot(scopeId) {
+        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`;
+        mkdirSync(dirname(dumpPath), {
+            recursive: true
+        });
+        await writeFile(dumpPath, serialized, {
+            flag: 'wx'
+        });
+        return {
+            sourcePath: this.reportPath,
+            dumpPath
+        };
+    }
     printReportPath() {
         if (!this.autoPrint || !this.reportPath) return;
         if (globalConfigManager.getEnvConfigInBoolean(MIDSCENE_REPORT_QUIET)) return;

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  writeFile as writeFileAsync,\n} from 'node:fs/promises';\nimport { 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  getBaseUrlFixScript,\n} from './dump/html-utils';\nimport { compactReportDumps } from './dump/report-dump-compactor';\nimport { type ImageUrlRef, ReportImageStore } from './dump/screenshot-store';\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\n  /**\n   * Finalize the report. Calls flush() internally.\n   */\n  finalize(): Promise<string | undefined>;\n\n  getReportPath(): string | undefined;\n}\n\nexport const nullReportGenerator: IReportGenerator = {\n  onExecutionUpdate: () => {},\n  flush: async () => {},\n  finalize: async () => undefined,\n  getReportPath: () => 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  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","globalConfigManager","MIDSCENE_REPORT_QUIET","logMsg","dirname","singleDump","referenceImageRefs","key","value","Object","existsSync","reportDir","existingExecutionIndices","readdirSync","name","index","Boolean","Number","Math","DATA_SCREENSHOT_MODE_ATTR","ReportActionDump","dir","mkdirSync","baseUrlFix","getBaseUrlFixScript","writeFileAsync","getReportTpl","screenshot","serialized","appendFileAsync","generateDumpScriptTag","refs","Map","imageUrl","ref","reportDump","Array","generateAgentReportComment","existingKey","executionLogKey","fileIndex","fileName","filePath","options","WeakMap","Promise","uuid","ReportImageStore","id","base64","generateImageScriptTag","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  ): 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":";;;;;;;;;;;;;;AAQC;;;;;;;;;;AA2CD,MAAMA,aAAaC,SAAS,oBAAoB;IAAE,SAAS;AAAK;AAChE,MAAMC,yBAAyB;AA6CxB,MAAMC,sBAAwC;IACnD,mBAAmB,KAAO;IAC1B,OAAO,WAAa;IACpB,UAAU,UAAYC;IACtB,eAAe,IAAMA;IACrB,mBAAmB,UAAYA;AACjC;AAEO,SAASC,8BAA8BC,IAG7C;IACC,IAAIA,AAAwB,UAAxBA,KAAK,cAAc,IAAcA,AAA8B,SAA9BA,KAAK,oBAAoB,EAC5D,MAAM,IAAIC,MACR;AAGN;AAEO,MAAMC;IA2DX,OAAO,OACLC,cAAsB,EACtBH,IAMC,EACiB;QAClBD,8BAA8BC;QAC9BI,uBAAuBD,gBAAgBH,KAAK,YAAY;QACxD,IAAIA,AAAwB,UAAxBA,KAAK,cAAc,EAAY,OAAOH;QAG1C,IAAIQ,aAAa,OAAOR;QAExB,MAAMS,gBAAgBC,qBAAqB;QAC3C,MAAMC,YAAYC,KAAKH,eAAeH;QACtC,MAAMO,aACJV,AAAsB,+BAAtBA,KAAK,YAAY,GACbS,KAAKD,WAAW,gBAChBC,KAAKH,eAAeK,mBAAmBR;QAC7C,OAAO,IAAID,gBAAgB;YACzBQ;YACA,gBACEV,AAAsB,+BAAtBA,KAAK,YAAY,GACb,cACA;YACN,sBAAsBA,KAAK,oBAAoB;YAC/C,WAAWA,KAAK,kBAAkB;YAClC,qBAAqBA,KAAK,mBAAmB;QAC/C;IACF;IAEA,kBACEY,SAAwB,EACxBC,UAAsB,EACtBC,UAA6B,EACvB;QACN,IAAI,CAAC,aAAa,GAAGF;QACrB,IAAI,CAAC,cAAc,GAAGC;QACtB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,sBAAsB,CAACD,YAAYA;QACjE,IAAI,CAAC,qBAAqB,CAACE;QAC3B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YACrC,IAAI,IAAI,CAAC,SAAS,EAAE;YACpB,MAAM,IAAI,CAAC,gBAAgB,CAACF,WAAWC;QACzC;IACF;IAEA,MAAM,QAAuB;QAC3B,MAAM,IAAI,CAAC,UAAU;IACvB;IAEA,MAAM,WAAwC;QAE5C,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,cAAc,EAC3C,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,cAAc;QAEhE,MAAM,IAAI,CAAC,KAAK;QAChB,IAAI,CAAC,SAAS,GAAG;QAEjB,IAAI,CAAC,IAAI,CAAC,WAAW,EAEnB;QAGF,MAAM,IAAI,CAAC,wBAAwB;QACnC,IAAI;YACF,MAAME,mBAAmB,IAAI,CAAC,UAAU;QAC1C,EAAE,OAAOC,OAAO;YACdtB,WACE,CAAC,yBAAyB,EAAE,IAAI,CAAC,UAAU,CAAC,mCAAmC,EAAEuB,OAAOD,QAAQ;QAEpG;QACA,OAAO,IAAI,CAAC,UAAU;IACxB;IAEA,gBAAoC;QAClC,OAAO,IAAI,CAAC,UAAU;IACxB;IAEA,MAAM,kBACJE,KAAqB,EACrBC,OAAe,EACfC,IAAgB,EACC;QACjB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAGrC,MAAMP,aAAa,IAAI,CAAC,cAAc,IAAIO;YAC1C,MAAMC,aAAa;mBAAI,IAAI,CAAC,eAAe,CAAC,MAAM;aAAG;YACrD,MAAMC,YAAY,IAAIC,iBAAiB;gBAAE,GAAGV,UAAU;gBAAEQ;YAAW;YACnE,MAAMG,WACJ,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,IACvC,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,IACtC,IAAI,CAAC,cAAc;YACrB,MAAMC,OAAOC,4BAA4BR,OAAOI,WAAW;gBACzDE;gBACAL;gBACA,YAAY,IAAI,CAAC,UAAU;YAC7B;YACA,KAAK,MAAMQ,cAAcF,KAAK,WAAW,IAAI,EAAE,CAC7C/B,WAAWiC,WAAW,OAAO;YAC/B,MAAMC,aAAa,MAAM,IAAI,CAAC,mBAAmB;YACjD,MAAMC,SAAmB,EAAE;YAC3B,IAAI,AAAwB,aAAxB,IAAI,CAAC,cAAc,EACrB,KAAK,MAAMC,OAAOF,WAAW,MAAM,CAAC,MAAM,GAAI;gBAC5C,MAAMG,QAAQ,MAAMC,SAClBvB,KAAKwB,QAAQ,IAAI,CAAC,UAAU,GAAGH,IAAI,IAAI;gBAEzCD,OAAO,IAAI,CACTK,uBACEJ,IAAI,EAAE,EACN,CAAC,KAAK,EAAEA,IAAI,QAAQ,CAAC,QAAQ,EAAEC,MAAM,QAAQ,CAAC,WAAW;YAG/D;YAGF,MAAMI,eACJ,AAAwB,aAAxB,IAAI,CAAC,cAAc,GACfC,KAAK,SAAS,CAACA,KAAK,KAAK,CAACR,WAAW,UAAU,GAAG,CAACS,MAAMC;gBACvD,MAAMR,MAAMS,wBAAwBD;gBACpC,OAAOR,MACH;oBAAE,GAAGA,GAAG;oBAAE,SAAS;oBAAU,MAAMhC;gBAAU,IAC7CwC;YACN,KACAV,WAAW,UAAU;YAC3B,MAAMY,WAAW,GAAGC,iBAAiB,AAAwB,gBAAxB,IAAI,CAAC,cAAc,GAAmBC,wBAAwB,GAAG;AAC5G,EAAEC,sBAAsBR,cAAc,IAAI,CAAC,uBAAuB,IAAI;AACtE,EAAEN,OAAO,IAAI,CAAC,MAAM;AACpB,EAAEe,+BAA+BnB,MAAM;AACvC,EAAEoB,2BAA2BvB,YAAY;YACnCwB,UAAUb,QAAQ,IAAI,CAAC,UAAU,GAAG;gBAAE,WAAW;YAAK;YACtD,MAAMc,gBAAgB,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAEC,OAAO,IAAI,CAAC;YAC/D,IAAI;gBACF,MAAMC,UAAeF,eAAeP;gBACpC,MAAMU,OAAYH,eAAe,IAAI,CAAC,UAAU;YAClD,SAAU;gBACR,MAAMI,OAAYJ,eAAe,KAAK,CAAC,CAAC/B;oBACtC,IAAIA,AAAe,aAAfA,MAAM,IAAI,EAAe,MAAMA;gBACrC;YACF;YACA,IAAI,CAAC,WAAW,GAAG;YACnB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE;gBACxB,IAAI,CAAC,cAAc,GAAG;gBACtB,IAAI,CAAC,eAAe;YACtB;QACF;QACA,MAAM,IAAI,CAAC,KAAK;QAChB,OAAO,IAAI,CAAC,UAAU;IACxB;IAEA,wBAA8B;QAC5B,IAAI,CAAC,eAAe,CAAC,gBAAgB;IACvC;IAEA,MAAc,sBAAsB;QAClC,IAAI,CAAC,qBAAqB;QAC1B,MAAMoC,aAAa,IAAIC;QACvB,KAAK,MAAMzC,aAAa,IAAI,CAAC,eAAe,CAAC,MAAM,GAAI;YACrD,KAAK,MAAM0C,cAAc1C,UAAU,kBAAkB,GACnD,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC0C;YACrC,KAAK,MAAM,CAACC,KAAKzB,IAAI,IAAI,OAAM,IAAI,CAAC,sBAAsB,CAAClB,UAAS,EAClEwC,WAAW,GAAG,CAACG,KAAKzB;QACxB;QACA,MAAML,OAAO,IAAIF,iBAAiB;YAChC,GAAI,IAAI,CAAC,cAAc,IAAI;gBACzB,YAAY;gBACZ,WAAW;gBACX,aAAa,EAAE;YACjB,CAAC;YACD,YAAY;mBAAI,IAAI,CAAC,eAAe,CAAC,MAAM;aAAG;QAChD;QACA,MAAMM,SAAS,IAAIwB;QAInB,MAAMG,aAAapB,KAAK,SAAS,CAC/BA,KAAK,KAAK,CAACX,KAAK,4BAA4B,CAAC2B,cAC7C,CAACf,MAAMC;YACL,MAAMR,MAAMS,wBAAwBD;YACpC,IAAI,CAACR,KAAK,OAAOQ;YACjB,MAAMmB,SAAS;gBACb,GAAG3B,GAAG;gBACN,SAAS;gBACT,MAAM,CAAC,cAAc,EAAEA,IAAI,EAAE,CAAC,CAAC,EAAE4B,sBAAsB5B,MAAM;YAC/D;YACAD,OAAO,GAAG,CAACC,IAAI,EAAE,EAAE2B;YACnB,OAAOA;QACT;QAEF,OAAO;YAAED;YAAY3B;QAAO;IAC9B;IAEA,MAAM,qBAAqBV,OAAe,EAAiC;QAEzE,IAAI,CAACA,WAAWwC,SAASxC,aAAaA,SACpC,MAAM,IAAIlB,MAAM;QAClB,MAAM,IAAI,CAAC,KAAK;QAChB,MAAM,EAAEuD,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,mBAAmB;QACrD,MAAMI,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,EAAEzC,QAAQ,KAAK,CAAC;QACrD2B,UAAUb,QAAQ2B,WAAW;YAAE,WAAW;QAAK;QAC/C,MAAMX,UAAeW,UAAUJ,YAAY;YAAE,MAAM;QAAK;QACxD,OAAO;YAAE,YAAY,IAAI,CAAC,UAAU;YAAEI;QAAS;IACjD;IAEQ,kBAAwB;QAC9B,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;QACzC,IAAIC,oBAAoB,qBAAqB,CAACC,wBAC5C;QAE0B,gBAAxB,IAAI,CAAC,cAAc,GACrBC,OACE,CAAC,0CAA0C,EAAE9B,QAAQ,IAAI,CAAC,UAAU,GAAG,IAGzE8B,OAAO,CAAC,gCAAgC,EAAE,IAAI,CAAC,UAAU,EAAE;IAE/D;IAEA,MAAc,iBACZnD,SAAwB,EACxBC,UAAsB,EACP;QACf,MAAMmD,aAAa,IAAI,CAAC,gBAAgB,CAACpD,WAAWC;QAEpD,MAAMoD,qBAAqB,MAAM,IAAI,CAAC,cAAc,CAACrD,WAAWoD;QAEhE,IAAI,IAAI,CAAC,0BAA0B,EACjC,MAAM,IAAI,CAAC,0BAA0B,CACnCpD,WACAoD,YACAC;QAIJ,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE;YACxB,IAAI,CAAC,cAAc,GAAG;YACtB,IAAI,CAAC,eAAe;QACtB;IACF;IAEQ,sBAAsBnD,UAA6B,EAAQ;QACjE,IAAI,CAACA,YACH;QAGF,KAAK,MAAM,CAACoD,KAAK5B,MAAM,IAAI6B,OAAO,OAAO,CAACrD,YACxC,IAAIwB,QAAAA,OAGJ,IAAI,CAAC,gBAAgB,CAAC4B,IAAI,GAAGjD,OAAOqB;IAExC;IAEQ,iCAAuC;QAC7C,IAAI,CAAC8B,WAAW,IAAI,CAAC,UAAU,GAC7B;QAIF,IAAI,CAAC,WAAW,GAAG;QAEnB,IAAI,CAAC,IAAI,CAAC,0BAA0B,EAClC;QAGF,MAAMC,YAAYpC,QAAQ,IAAI,CAAC,UAAU;QACzC,MAAMqC,2BAA2BC,YAAYF,WAC1C,GAAG,CAAC,CAACG,OAAS,2BAA2B,IAAI,CAACA,OAAO,CAAC,EAAE,EACxD,MAAM,CAAC,CAACC,QAA2BC,QAAQD,QAC3C,GAAG,CAAC,CAACA,QAAUE,OAAO,QAAQ,CAACF,OAAO,KACtC,MAAM,CAAC,CAACA,QAAUE,OAAO,QAAQ,CAACF;QAErC,IAAIH,yBAAyB,MAAM,GAAG,GACpC,IAAI,CAAC,iBAAiB,GAAGM,KAAK,GAAG,IAAIN;IAEzC;IAEQ,0BAAkD;QACxD,OAAO;YACL,iBAAiB,IAAI,CAAC,cAAc;YAGpC,CAACO,0BAA0B,EAAE,IAAI,CAAC,cAAc;YAChD,GAAG,IAAI,CAAC,gBAAgB;QAC1B;IACF;IAKQ,iBACNjE,SAAwB,EACxBC,UAAsB,EACJ;QAClB,OAAO,IAAIU,iBAAiB;YAC1B,YAAYV,WAAW,UAAU;YACjC,WAAWA,WAAW,SAAS;YAC/B,kBAAkBA,WAAW,gBAAgB;YAC7C,aAAaA,WAAW,WAAW;YACnC,YAAYA,WAAW,UAAU;YACjC,YAAY;gBAACD;aAAU;QACzB;IACF;IAYA,MAAc,eACZA,SAAwB,EACxBoD,UAA4B,EACO;QACnC,MAAMc,MAAM7C,QAAQ,IAAI,CAAC,UAAU;QACnC,IAAI,CAACmC,WAAWU,MACdhC,UAAUgC,KAAK;YAAE,WAAW;QAAK;QAInC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YACrB,MAAMC,aACJ,AAAwB,gBAAxB,IAAI,CAAC,cAAc,GAAmBrC,wBAAwB;YAChE,MAAMO,UAAe,IAAI,CAAC,UAAU,EAAE,GAAGR,iBAAiBsC,YAAY;YACtE,IAAI,CAAC,WAAW,GAAG;QACrB;QAGA,KAAK,MAAMzB,cAAc1C,UAAU,kBAAkB,GACnD,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC0C;QAErC,MAAMW,qBAAqB,MAAM,IAAI,CAAC,sBAAsB,CAACrD;QAG7D,MAAM4C,aACJQ,WAAW,4BAA4B,CAACC;QAC1C,MAAMe,WACJ,IAAI,CAAC,UAAU,EACf,CAAC,EAAE,EAAErC,sBAAsBa,YAAY,IAAI,CAAC,uBAAuB,KAAK;QAE1E,OAAOS;IACT;IAEA,MAAc,uBACZrD,SAAwB,EACW;QACnC,MAAMqE,OAAO,IAAI5B;QACjB,KAAK,MAAM6B,YAAYtE,UAAU,qBAAqB,GAAI;YACxD,MAAMkB,MAAM,MAAM,IAAI,CAAC,eAAe,CAAC,qBAAqB,CAACoD;YAC7DD,KAAK,GAAG,CAACC,UAAUpD;QACrB;QACA,OAAOmD;IACT;IAEA,MAAc,2BAA0C;QACtD,IACE,IAAI,CAAC,mBAAmB,IACxB,CAAC,IAAI,CAAC,cAAc,IACpB,AAA8B,MAA9B,IAAI,CAAC,eAAe,CAAC,IAAI,EAEzB;QAGF,MAAME,aAAa,IAAI5D,iBAAiB;YACtC,YAAY,IAAI,CAAC,cAAc,CAAC,UAAU;YAC1C,WAAW,IAAI,CAAC,cAAc,CAAC,SAAS;YACxC,kBAAkB,IAAI,CAAC,cAAc,CAAC,gBAAgB;YACtD,aAAa,IAAI,CAAC,cAAc,CAAC,WAAW;YAC5C,YAAY,IAAI,CAAC,cAAc,CAAC,UAAU;YAC1C,YAAY6D,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM;QACpD;QACA,MAAMJ,WACJ,IAAI,CAAC,UAAU,EACf,CAAC,EAAE,EAAEnC,2BAA2BsC,aAAa;QAE/C,IAAI,CAAC,mBAAmB,GAAG;IAC7B;IAEQ,mBAAmBvE,SAAwB,EAAU;QAC3D,IAAI,CAACA,UAAU,EAAE,EACf,MAAM,IAAIX,MACR;QAGJ,OAAO,CAAC,GAAG,EAAEW,UAAU,EAAE,EAAE;IAC7B;IAEQ,uBAAuBA,SAAwB,EAAU;QAC/D,IAAIA,UAAU,EAAE,EACd,OAAO,CAAC,GAAG,EAAEA,UAAU,EAAE,EAAE;QAG7B,MAAMyE,cAAc,IAAI,CAAC,2BAA2B,CAAC,GAAG,CAACzE;QACzD,IAAIyE,aACF,OAAOA;QAGT,MAAMnB,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,wBAAwB,IAAI;QACtD,IAAI,CAAC,2BAA2B,CAAC,GAAG,CAACtD,WAAWsD;QAChD,OAAOA;IACT;IAEA,MAAc,2BACZtD,SAAwB,EACxBoD,UAA4B,EAC5BC,kBAAoD,EACrC;QACf,MAAMa,MAAM7C,QAAQ,IAAI,CAAC,UAAU;QACnC,IAAI,CAACmC,WAAWU,MACdhC,UAAUgC,KAAK;YAAE,WAAW;QAAK;QAGnC,MAAMQ,kBAAkB,IAAI,CAAC,kBAAkB,CAAC1E;QAChD,IAAI2E,YACF,IAAI,CAAC,mCAAmC,CAAC,GAAG,CAACD;QAC/C,IAAI,CAACC,WAAW;YACd,IAAI,CAAC,iBAAiB,IAAI;YAC1BA,YAAY,IAAI,CAAC,iBAAiB;YAClC,IAAI,CAAC,mCAAmC,CAAC,GAAG,CAACD,iBAAiBC;QAChE;QAEA,MAAMC,WAAW,GAAGD,UAAU,eAAe,CAAC;QAC9C,MAAME,WAAWhF,KAAKwB,QAAQ,IAAI,CAAC,UAAU,GAAGuD;QAChD,MAAMvC,UACJwC,UACAzB,WAAW,4BAA4B,CAACC,oBAAoB,IAC5D;IAEJ;IAldA,YAAYyB,OAMX,CAAE;QAlCH,uBAAQ,cAAR;QACA,uBAAQ,kBAAR;QACA,uBAAQ,8BAAR;QACA,uBAAQ,aAAR;QACA,uBAAQ,kBAAiB;QACzB,uBAAQ,qBAAoB;QAC5B,uBAAQ,uCAAsC,IAAIrC;QAGlD,uBAAiB,kBAAjB;QAGA,uBAAQ,mBAAR;QACA,uBAAQ,eAAc;QAGtB,uBAAQ,iBAAR;QACA,uBAAQ,kBAAR;QACA,uBAAQ,mBAAkB,IAAIA;QAC9B,uBAAQ,+BAA8B,IAAIsC;QAC1C,uBAAQ,4BAA2B;QACnC,uBAAQ,oBAA2C,CAAC;QACpD,uBAAQ,uBAAsB;QAG9B,uBAAQ,cAA4BC,QAAQ,OAAO;QACnD,uBAAQ,aAAY;QASlB,IAAI,CAAC,UAAU,GAAGF,QAAQ,UAAU;QACpC,IAAI,CAAC,cAAc,GAAGA,QAAQ,cAAc;QAC5C,IAAI,CAAC,0BAA0B,GAAGA,QAAQ,oBAAoB,IAAI;QAClE,IAAI,CAAC,SAAS,GAAGA,QAAQ,SAAS,IAAI;QACtC,IAAI,CAAC,cAAc,GAAG1C;QACtB,IAAI,CAAC,eAAe,GAAG,IAAI6C,iBAAiB;YAC1C,MAAM,AAAwB,aAAxB,IAAI,CAAC,cAAc,GAAgB,WAAW;YACpD,YAAY,IAAI,CAAC,UAAU;YAC3B,gBAAgBpF,KAAKwB,QAAQ,IAAI,CAAC,UAAU,GAAG;YAC/C,kBAAkB,OAAO6D,IAAIC;gBAC3B,MAAMf,WACJ,IAAI,CAAC,UAAU,EACf,CAAC,EAAE,EAAE9C,uBAAuB4D,IAAIC,SAAS;YAE7C;YACA,mBAAmB,IAAI,CAAC,0BAA0B;YAClD,qBAAqBL,QAAQ,mBAAmB;QAClD;QACA,IAAIA,QAAQ,mBAAmB,EAC7B,IAAI,CAAC,8BAA8B;IAEvC;AAubF;AAEA,SAAS/E,mBAAmBR,cAAsB;IAChD,OAAOA,eAAe,QAAQ,CAAC,WAC3BA,iBACA,GAAGA,eAAe,KAAK,CAAC;AAC9B;AAEA,SAASC,uBACPD,cAAsB,EACtB6F,YAAyD;IAEzD,IAAI,CAAC7F,gBAAgB,QACnB,MAAM,IAAIF,MAAM;IAGlB,IAAI,QAAQ,IAAI,CAACE,iBACf,MAAM,IAAIF,MACR;IAIJ,IAAI,YAAY,IAAI,CAACE,iBACnB,MAAM,IAAIF,MACR;IAIJ,MAAMgG,oBACJD,AAAiB,+BAAjBA,eACI7F,iBACAQ,mBAAmBR;IACzB,MAAM+F,gBAAgB,IAAIC,cAAc,MAAM,CAACF,mBAAmB,UAAU;IAC5E,IAAIC,gBAAgBtG,wBAClB,MAAM,IAAIK,MACR,CAAC,gDAAgD,EAAEiG,cAAc,yBAAyB,EAAEtG,wBAAwB;AAG1H"}