@aiscene/core 1.1.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"report-markdown.mjs","sources":["../../src/report-markdown.ts"],"sourcesContent":["import { basename } from 'node:path';\nimport { extractInsightParam, paramStr, typeStr } from '@/agent/ui-utils';\nimport { ScreenshotItem } from '@/screenshot-item';\nimport type {\n  ExecutionDump,\n  ExecutionRecorderItem,\n  ExecutionTask,\n  IExecutionDump,\n  IReportActionDump,\n  ReportActionDump,\n} from '@/types';\nimport { normalizeScreenshotRef } from './dump/screenshot-store';\n\nexport interface MarkdownAttachment {\n  id: string;\n  suggestedFileName: string;\n  mimeType?: string;\n  filePath: string;\n  executionIndex: number;\n  taskIndex: number;\n  /** Populated when screenshot data is available in memory (e.g. browser context). */\n  base64Data?: string;\n}\n\nexport interface ExecutionMarkdownOptions {\n  screenshotBaseDir?: string;\n}\n\nexport interface ExecutionMarkdownResult {\n  markdown: string;\n  attachments: MarkdownAttachment[];\n}\n\nexport interface ReportMarkdownResult {\n  markdown: string;\n  attachments: MarkdownAttachment[];\n}\n\nfunction toExecutionDump(\n  execution: ExecutionDump | IExecutionDump,\n): IExecutionDump {\n  if (!execution || typeof execution !== 'object') {\n    throw new Error('executionToMarkdown: execution is required');\n  }\n\n  if (!Array.isArray(execution.tasks)) {\n    throw new Error('executionToMarkdown: execution.tasks must be an array');\n  }\n\n  if (!execution.name) {\n    throw new Error('executionToMarkdown: execution.name is required');\n  }\n\n  return execution;\n}\n\nfunction toReportDump(\n  report: ReportActionDump | IReportActionDump,\n): IReportActionDump {\n  if (!report || typeof report !== 'object') {\n    throw new Error('reportToMarkdown: report is required');\n  }\n\n  if (!Array.isArray(report.executions)) {\n    throw new Error('reportToMarkdown: report.executions must be an array');\n  }\n\n  return report;\n}\n\nfunction formatTime(ts?: number): string {\n  if (typeof ts !== 'number' || Number.isNaN(ts)) {\n    return 'N/A';\n  }\n  return new Date(ts).toISOString();\n}\n\nfunction resolveTaskTiming(task: ExecutionTask): {\n  start?: number;\n  end?: number;\n  cost?: number;\n} {\n  const timing = task.timing;\n  if (!timing) {\n    return {};\n  }\n\n  const start = timing.start ?? timing.callAiStart ?? timing.callActionStart;\n  const end =\n    timing.end ??\n    timing.callAiEnd ??\n    timing.callActionEnd ??\n    timing.captureAfterCallingSnapshotEnd;\n  const cost =\n    timing.cost ??\n    (typeof start === 'number' && typeof end === 'number'\n      ? end - start\n      : undefined);\n\n  return { start, end, cost };\n}\n\nfunction safeTaskParam(task: ExecutionTask): string {\n  const readable = paramStr(task);\n  if (readable) {\n    return readable;\n  }\n\n  if (task.type === 'Insight') {\n    return extractInsightParam((task as any).param).content;\n  }\n\n  return '';\n}\n\nfunction formatSize(\n  size?: { width?: number; height?: number } | null,\n): string | undefined {\n  if (\n    !size ||\n    typeof size.width !== 'number' ||\n    typeof size.height !== 'number' ||\n    Number.isNaN(size.width) ||\n    Number.isNaN(size.height)\n  ) {\n    return undefined;\n  }\n\n  return `${size.width} x ${size.height}`;\n}\n\nfunction extractLocateCenter(\n  task: ExecutionTask,\n): [number, number] | undefined {\n  const outputCenter = (task.output as { element?: { center?: unknown } })\n    ?.element?.center;\n  if (\n    Array.isArray(outputCenter) &&\n    outputCenter.length >= 2 &&\n    typeof outputCenter[0] === 'number' &&\n    typeof outputCenter[1] === 'number'\n  ) {\n    return [outputCenter[0], outputCenter[1]];\n  }\n\n  const paramLocateCenter = (task.param as { locate?: { center?: unknown } })\n    ?.locate?.center;\n  if (\n    Array.isArray(paramLocateCenter) &&\n    paramLocateCenter.length >= 2 &&\n    typeof paramLocateCenter[0] === 'number' &&\n    typeof paramLocateCenter[1] === 'number'\n  ) {\n    return [paramLocateCenter[0], paramLocateCenter[1]];\n  }\n\n  const paramCenter = (task.param as { center?: unknown })?.center;\n  if (\n    Array.isArray(paramCenter) &&\n    paramCenter.length >= 2 &&\n    typeof paramCenter[0] === 'number' &&\n    typeof paramCenter[1] === 'number'\n  ) {\n    return [paramCenter[0], paramCenter[1]];\n  }\n\n  return undefined;\n}\n\nfunction tryExtractBase64(screenshot: unknown): string | undefined {\n  if (!screenshot || typeof screenshot !== 'object') return undefined;\n  const s = screenshot as Record<string, unknown>;\n  if (typeof s.base64 === 'string' && s.base64.length > 0) {\n    return s.base64;\n  }\n  return undefined;\n}\n\nfunction screenshotAttachment(\n  screenshot: unknown,\n  screenshotBaseDir: string,\n  executionIndex: number,\n  taskIndex: number,\n): { markdown: string; attachment: MarkdownAttachment } {\n  if (screenshot instanceof ScreenshotItem) {\n    const ext = screenshot.extension;\n    const suggestedFileName = `execution-${executionIndex + 1}-task-${taskIndex + 1}-${screenshot.id}.${ext}`;\n    const filePath = `${screenshotBaseDir}/${suggestedFileName}`;\n    return {\n      markdown: `\\n![task-${taskIndex + 1}](${filePath})`,\n      attachment: {\n        id: screenshot.id,\n        suggestedFileName,\n        filePath,\n        mimeType: `image/${ext === 'jpeg' ? 'jpeg' : 'png'}`,\n        executionIndex,\n        taskIndex,\n        base64Data: tryExtractBase64(screenshot),\n      },\n    };\n  }\n\n  const ref = normalizeScreenshotRef(screenshot);\n  if (ref) {\n    const ext = ref.mimeType === 'image/jpeg' ? 'jpeg' : 'png';\n    const suggestedFileName = `execution-${executionIndex + 1}-task-${taskIndex + 1}-${ref.id}.${ext}`;\n    const filePath = ref.path || `${screenshotBaseDir}/${suggestedFileName}`;\n    return {\n      markdown: `\\n![task-${taskIndex + 1}](${filePath})`,\n      attachment: {\n        id: ref.id,\n        suggestedFileName,\n        filePath,\n        mimeType: ref.mimeType,\n        executionIndex,\n        taskIndex,\n        base64Data: tryExtractBase64(screenshot),\n      },\n    };\n  }\n\n  const base64 = tryExtractBase64(screenshot);\n  if (base64) {\n    const ext = base64.startsWith('data:image/jpeg') ? 'jpeg' : 'png';\n    const id = `restored-${executionIndex + 1}-${taskIndex + 1}`;\n    const suggestedFileName = `execution-${executionIndex + 1}-task-${taskIndex + 1}-${id}.${ext}`;\n    const filePath = `${screenshotBaseDir}/${suggestedFileName}`;\n    return {\n      markdown: `\\n![task-${taskIndex + 1}](${filePath})`,\n      attachment: {\n        id,\n        suggestedFileName,\n        filePath,\n        mimeType: `image/${ext}`,\n        executionIndex,\n        taskIndex,\n        base64Data: base64,\n      },\n    };\n  }\n\n  throw new Error(\n    `executionToMarkdown: missing screenshot for execution #${executionIndex + 1} task #${taskIndex + 1}`,\n  );\n}\n\nfunction recorderMarkdownSection(\n  recorder: ExecutionRecorderItem[] | undefined,\n  screenshotBaseDir: string,\n  executionIndex: number,\n  taskIndex: number,\n): { lines: string[]; attachments: MarkdownAttachment[] } {\n  if (!recorder?.length) {\n    return { lines: [], attachments: [] };\n  }\n\n  const lines: string[] = ['', '### Recorder'];\n  const attachments: MarkdownAttachment[] = [];\n\n  recorder.forEach((item, recorderIndex) => {\n    lines.push(\n      `- #${recorderIndex + 1} type=${item.type}, ts=${formatTime(item.ts)}, timing=${item.timing || 'N/A'}`,\n    );\n\n    if (!item.screenshot) {\n      return;\n    }\n\n    const imageResult = screenshotAttachment(\n      item.screenshot,\n      screenshotBaseDir,\n      executionIndex,\n      taskIndex,\n    );\n\n    lines.push(imageResult.markdown);\n    attachments.push(imageResult.attachment);\n  });\n\n  return { lines, attachments };\n}\n\nfunction renderExecution(\n  executionRaw: ExecutionDump | IExecutionDump,\n  executionIndex: number,\n  options?: ExecutionMarkdownOptions,\n): ExecutionMarkdownResult {\n  const execution = toExecutionDump(executionRaw);\n  const screenshotBaseDir = options?.screenshotBaseDir ?? './screenshots';\n\n  const lines: string[] = [];\n  const attachments: MarkdownAttachment[] = [];\n\n  lines.push(`# ${execution.name}`);\n  if (execution.description) {\n    lines.push('', execution.description);\n  }\n\n  lines.push('', `- Execution start: ${formatTime(execution.logTime)}`);\n  lines.push(`- Task count: ${execution.tasks.length}`);\n\n  execution.tasks.forEach((task, taskIndex) => {\n    const title = typeStr(task);\n    const detail = safeTaskParam(task);\n    const time = resolveTaskTiming(task);\n\n    lines.push(\n      '',\n      `## ${taskIndex + 1}. ${title}${detail ? ` - ${detail}` : ''}`,\n    );\n    lines.push(`- Status: ${task.status || 'unknown'}`);\n    lines.push(`- Start: ${formatTime(time.start)}`);\n    lines.push(`- End: ${formatTime(time.end)}`);\n    lines.push(\n      `- Cost(ms): ${typeof time.cost === 'number' ? time.cost : 'N/A'}`,\n    );\n    lines.push(\n      `- Screen size: ${formatSize(task.uiContext?.shotSize) || 'N/A'}`,\n    );\n\n    if (task.subType === 'Locate') {\n      const locateCenter = extractLocateCenter(task);\n      if (locateCenter) {\n        lines.push(`- Locate center: (${locateCenter[0]}, ${locateCenter[1]})`);\n      }\n    }\n\n    if (task.errorMessage) {\n      lines.push(`- Error: ${task.errorMessage}`);\n    }\n\n    if (task.uiContext?.screenshot) {\n      const imageResult = screenshotAttachment(\n        task.uiContext.screenshot,\n        screenshotBaseDir,\n        executionIndex,\n        taskIndex,\n      );\n\n      lines.push(imageResult.markdown);\n      attachments.push(imageResult.attachment);\n    }\n\n    const recorderSection = recorderMarkdownSection(\n      task.recorder,\n      screenshotBaseDir,\n      executionIndex,\n      taskIndex,\n    );\n    if (recorderSection.lines.length) {\n      lines.push(...recorderSection.lines);\n      attachments.push(...recorderSection.attachments);\n    }\n  });\n\n  return {\n    markdown: lines.join('\\n'),\n    attachments,\n  };\n}\n\nfunction reportFileName(\n  execution: IExecutionDump,\n  executionIndex: number,\n): string {\n  const safeName =\n    execution.name\n      .trim()\n      .replace(/\\s+/g, '-')\n      .replace(/[^a-zA-Z0-9-_]/g, '') || `execution-${executionIndex + 1}`;\n  return `${executionIndex + 1}-${basename(safeName)}.md`;\n}\n\nexport function executionToMarkdown(\n  execution: ExecutionDump | IExecutionDump,\n  options?: ExecutionMarkdownOptions,\n): ExecutionMarkdownResult {\n  return renderExecution(execution, 0, options);\n}\n\nexport function reportToMarkdown(\n  report: ReportActionDump | IReportActionDump,\n): ReportMarkdownResult {\n  const reportDump = toReportDump(report);\n\n  const executionResults = reportDump.executions.map((execution, index) => {\n    const rendered = renderExecution(execution, index);\n    return {\n      executionIndex: index,\n      executionName: execution.name,\n      markdown: rendered.markdown,\n      attachments: rendered.attachments,\n      suggestedFileName: reportFileName(execution, index),\n    };\n  });\n\n  const attachments = executionResults.flatMap((item) => item.attachments);\n\n  const header = [\n    `# ${reportDump.groupName}`,\n    reportDump.groupDescription ? `\\n${reportDump.groupDescription}` : '',\n    `\\n- SDK Version: ${reportDump.sdkVersion}`,\n    `- Execution count: ${reportDump.executions.length}`,\n    '\\n## Suggested execution markdown files',\n    ...executionResults.map(\n      (item) => `- ${item.suggestedFileName} (${item.executionName})`,\n    ),\n  ]\n    .filter(Boolean)\n    .join('\\n');\n\n  return {\n    markdown: `${header}\\n\\n${executionResults.map((item) => item.markdown).join('\\n\\n---\\n\\n')}`,\n    attachments,\n  };\n}\n"],"names":["toExecutionDump","execution","Error","Array","toReportDump","report","formatTime","ts","Number","Date","resolveTaskTiming","task","timing","start","end","cost","undefined","safeTaskParam","readable","paramStr","extractInsightParam","formatSize","size","extractLocateCenter","outputCenter","paramLocateCenter","paramCenter","tryExtractBase64","screenshot","s","screenshotAttachment","screenshotBaseDir","executionIndex","taskIndex","ScreenshotItem","ext","suggestedFileName","filePath","ref","normalizeScreenshotRef","base64","id","recorderMarkdownSection","recorder","lines","attachments","item","recorderIndex","imageResult","renderExecution","executionRaw","options","title","typeStr","detail","time","locateCenter","recorderSection","reportFileName","safeName","basename","executionToMarkdown","reportToMarkdown","reportDump","executionResults","index","rendered","header","Boolean"],"mappings":"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"}

package/dist/es/report.mjs

@@ -0,0 +1,270 @@
+import { appendFileSync, copyFileSync, existsSync, mkdirSync, readdirSync, rmSync, unlinkSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
+import { getMidsceneRunSubDir } from "@midscene/shared/common";
+import { antiEscapeScriptTag, logMsg } from "@midscene/shared/utils";
+import { getReportFileName } from "./agent/index.mjs";
+import { extractAllDumpScriptsSync, extractLastDumpScriptSync, getBaseUrlFixScript, streamDumpScriptsSync, streamImageScriptsToFile } from "./dump/html-utils.mjs";
+import { normalizeScreenshotRef, resolveScreenshotSource } from "./dump/screenshot-store.mjs";
+import { ReportActionDump } from "./types.mjs";
+import { getReportTpl, reportHTMLContent } from "./utils.mjs";
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+function isDirectoryModeReport(reportFilePath) {
+    const reportDir = dirname(reportFilePath);
+    return 'index.html' === basename(reportFilePath) && existsSync(join(reportDir, 'screenshots'));
+}
+function dedupeExecutionsKeepLatest(executions) {
+    let noIdCounter = 0;
+    const deduped = new Map();
+    for (const exec of executions){
+        const key = exec.id || `__no_id_${noIdCounter++}`;
+        deduped.set(key, exec);
+    }
+    return Array.from(deduped.values());
+}
+class ReportMergingTool {
+    createEmptyDumpString(groupName, groupDescription) {
+        return new ReportActionDump({
+            sdkVersion: '',
+            groupName,
+            groupDescription,
+            modelBriefs: [],
+            executions: []
+        }).serialize();
+    }
+    append(reportInfo) {
+        this.reportInfos.push(reportInfo);
+    }
+    clear() {
+        this.reportInfos = [];
+    }
+    mergeDumpScripts(contents) {
+        const unescaped = contents.map((c)=>antiEscapeScriptTag(c)).filter((c)=>c.length > 0);
+        if (0 === unescaped.length) return '';
+        if (1 === unescaped.length) return unescaped[0];
+        const base = ReportActionDump.fromSerializedString(unescaped[0]);
+        const allExecutions = [
+            ...base.executions
+        ];
+        for(let i = 1; i < unescaped.length; i++){
+            const other = ReportActionDump.fromSerializedString(unescaped[i]);
+            allExecutions.push(...other.executions);
+        }
+        base.executions = dedupeExecutionsKeepLatest(allExecutions);
+        return base.serialize();
+    }
+    mergeReports(reportFileName = 'AUTO', opts) {
+        const { rmOriginalReports = false, overwrite = false } = opts ?? {};
+        if (0 === this.reportInfos.length) {
+            logMsg('No reports to merge');
+            return null;
+        }
+        const targetDir = getMidsceneRunSubDir('report');
+        const hasDirectoryModeReport = this.reportInfos.some((info)=>{
+            const reportFilePath = info.reportFilePath;
+            return Boolean(reportFilePath && isDirectoryModeReport(reportFilePath));
+        });
+        const resolvedName = 'AUTO' === reportFileName ? getReportFileName('merged-report') : reportFileName;
+        const outputFilePath = hasDirectoryModeReport ? resolve(targetDir, resolvedName, 'index.html') : resolve(targetDir, `${resolvedName}.html`);
+        if ('AUTO' !== reportFileName && existsSync(outputFilePath)) {
+            if (!overwrite) throw new Error(`Report file already exists: ${outputFilePath}\nSet overwrite to true to overwrite this file.`);
+            if (hasDirectoryModeReport) rmSync(dirname(outputFilePath), {
+                recursive: true,
+                force: true
+            });
+            else unlinkSync(outputFilePath);
+        }
+        if (hasDirectoryModeReport) mkdirSync(dirname(outputFilePath), {
+            recursive: true
+        });
+        logMsg(`Start merging ${this.reportInfos.length} reports...\nCreating template file...`);
+        try {
+            const htmlEndTag = '</html>';
+            const tpl = getReportTpl();
+            const htmlEndIdx = tpl.lastIndexOf(htmlEndTag);
+            const tplWithoutClose = -1 !== htmlEndIdx ? tpl.slice(0, htmlEndIdx) : tpl;
+            appendFileSync(outputFilePath, tplWithoutClose);
+            if (hasDirectoryModeReport) appendFileSync(outputFilePath, getBaseUrlFixScript());
+            for(let i = 0; i < this.reportInfos.length; i++){
+                const reportInfo = this.reportInfos[i];
+                logMsg(`Processing report ${i + 1}/${this.reportInfos.length}`);
+                const { reportAttributes } = reportInfo;
+                let dumpString = this.createEmptyDumpString(reportAttributes.testTitle, reportAttributes.testDescription);
+                let mergedGroupId = `merged-group-${i}`;
+                if (reportInfo.reportFilePath) {
+                    if (isDirectoryModeReport(reportInfo.reportFilePath)) {
+                        const reportDir = dirname(reportInfo.reportFilePath);
+                        const screenshotsDir = join(reportDir, 'screenshots');
+                        const mergedScreenshotsDir = join(dirname(outputFilePath), 'screenshots');
+                        mkdirSync(mergedScreenshotsDir, {
+                            recursive: true
+                        });
+                        for (const file of readdirSync(screenshotsDir)){
+                            const src = join(screenshotsDir, file);
+                            const dest = join(mergedScreenshotsDir, file);
+                            copyFileSync(src, dest);
+                        }
+                    } else streamImageScriptsToFile(reportInfo.reportFilePath, outputFilePath);
+                    const allDumps = extractAllDumpScriptsSync(reportInfo.reportFilePath).filter((d)=>d.openTag.includes('data-group-id'));
+                    const groupIdMatch = allDumps[0]?.openTag.match(/data-group-id="([^"]+)"/);
+                    if (groupIdMatch) mergedGroupId = decodeURIComponent(groupIdMatch[1]);
+                    const extractedDumpString = allDumps.length > 0 ? this.mergeDumpScripts(allDumps.map((d)=>d.content)) : extractLastDumpScriptSync(reportInfo.reportFilePath);
+                    if (extractedDumpString) dumpString = extractedDumpString;
+                }
+                const reportHtmlStr = `${reportHTMLContent({
+                    dumpString,
+                    attributes: {
+                        'data-group-id': mergedGroupId,
+                        playwright_test_duration: reportAttributes.testDuration,
+                        playwright_test_status: reportAttributes.testStatus,
+                        playwright_test_title: reportAttributes.testTitle,
+                        playwright_test_id: reportAttributes.testId,
+                        playwright_test_description: reportAttributes.testDescription,
+                        is_merged: true
+                    }
+                }, void 0, void 0, false)}\n`;
+                appendFileSync(outputFilePath, reportHtmlStr);
+            }
+            appendFileSync(outputFilePath, `${htmlEndTag}\n`);
+            logMsg(`Successfully merged new report: ${outputFilePath}`);
+            if (rmOriginalReports) {
+                for (const info of this.reportInfos)if (info.reportFilePath) try {
+                    if (isDirectoryModeReport(info.reportFilePath)) {
+                        const reportDir = dirname(info.reportFilePath);
+                        rmSync(reportDir, {
+                            recursive: true,
+                            force: true
+                        });
+                    } else unlinkSync(info.reportFilePath);
+                } catch (error) {
+                    logMsg(`Error deleting report ${info.reportFilePath}: ${error}`);
+                }
+                logMsg(`Removed ${this.reportInfos.length} original reports`);
+            }
+            return outputFilePath;
+        } catch (error) {
+            logMsg(`Error in mergeReports: ${error}`);
+            throw error;
+        }
+    }
+    constructor(){
+        _define_property(this, "reportInfos", []);
+    }
+}
+function collectDedupedExecutions(htmlPath) {
+    let baseDump = null;
+    let executionSerial = 0;
+    const latestSerialByExecutionId = new Map();
+    streamDumpScriptsSync(htmlPath, (dumpScript)=>{
+        if (!dumpScript.openTag.includes('data-group-id')) return false;
+        const groupedDump = ReportActionDump.fromSerializedString(antiEscapeScriptTag(dumpScript.content));
+        for (const execution of groupedDump.executions){
+            executionSerial += 1;
+            if (execution.id) latestSerialByExecutionId.set(execution.id, executionSerial);
+        }
+        return false;
+    });
+    const executions = [];
+    executionSerial = 0;
+    streamDumpScriptsSync(htmlPath, (dumpScript)=>{
+        if (!dumpScript.openTag.includes('data-group-id')) return false;
+        const groupedDump = ReportActionDump.fromSerializedString(antiEscapeScriptTag(dumpScript.content));
+        if (!baseDump) baseDump = groupedDump;
+        for (const execution of groupedDump.executions){
+            executionSerial += 1;
+            if (!execution.id || latestSerialByExecutionId.get(execution.id) === executionSerial) executions.push(execution);
+        }
+        return false;
+    });
+    if (!baseDump) throw new Error(`No report dump scripts found in ${htmlPath}`);
+    return {
+        baseDump,
+        executions
+    };
+}
+function extensionByMimeType(mimeType) {
+    if ('image/png' === mimeType) return 'png';
+    if ('image/jpeg' === mimeType) return 'jpeg';
+    throw new Error(`Unsupported screenshot mime type: ${mimeType}`);
+}
+function externalizeScreenshotsInExecution(execution, opts) {
+    const visit = (node)=>{
+        if (Array.isArray(node)) {
+            for (const item of node)visit(item);
+            return;
+        }
+        if ('object' != typeof node || null === node) return;
+        const ref = normalizeScreenshotRef(node);
+        if (ref) {
+            const ext = extensionByMimeType(ref.mimeType);
+            const fileName = `${ref.id}.${ext}`;
+            const relativePath = `./screenshots/${fileName}`;
+            const absolutePath = join(opts.screenshotsDir, fileName);
+            if (!opts.writtenFiles.has(fileName)) {
+                const resolved = resolveScreenshotSource(ref, {
+                    reportPath: opts.htmlPath
+                });
+                if ('data-uri' === resolved.type) {
+                    const rawBase64 = resolved.dataUri.replace(/^data:image\/[a-zA-Z+]+;base64,/, '');
+                    writeFileSync(absolutePath, Buffer.from(rawBase64, 'base64'));
+                } else copyFileSync(resolved.filePath, absolutePath);
+                opts.writtenFiles.add(fileName);
+            }
+            ref.storage = 'file';
+            ref.path = relativePath;
+            return;
+        }
+        for (const value of Object.values(node))visit(value);
+    };
+    visit(execution);
+}
+function splitReportHtmlByExecution(options) {
+    const { htmlPath, outputDir } = options;
+    const screenshotsDir = join(outputDir, 'screenshots');
+    mkdirSync(outputDir, {
+        recursive: true
+    });
+    mkdirSync(screenshotsDir, {
+        recursive: true
+    });
+    const executionJsonFiles = [];
+    const writtenScreenshotFiles = new Set();
+    const { baseDump, executions } = collectDedupedExecutions(htmlPath);
+    let fileIndex = 0;
+    for (const execution of executions){
+        fileIndex += 1;
+        externalizeScreenshotsInExecution(execution, {
+            htmlPath,
+            screenshotsDir,
+            writtenFiles: writtenScreenshotFiles
+        });
+        const singleExecutionDump = new ReportActionDump({
+            sdkVersion: baseDump.sdkVersion,
+            groupName: baseDump.groupName,
+            groupDescription: baseDump.groupDescription,
+            modelBriefs: baseDump.modelBriefs,
+            deviceType: baseDump.deviceType,
+            executions: [
+                execution
+            ]
+        });
+        const jsonFilePath = join(outputDir, `${fileIndex}.execution.json`);
+        writeFileSync(jsonFilePath, singleExecutionDump.serialize(2), 'utf-8');
+        executionJsonFiles.push(jsonFilePath);
+    }
+    return {
+        executionJsonFiles,
+        screenshotFiles: Array.from(writtenScreenshotFiles).sort().map((fileName)=>join(screenshotsDir, fileName))
+    };
+}
+export { ReportMergingTool, collectDedupedExecutions, dedupeExecutionsKeepLatest, isDirectoryModeReport, splitReportHtmlByExecution };
+
+//# sourceMappingURL=report.mjs.map

package/dist/es/report.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.mjs","sources":["../../src/report.ts"],"sourcesContent":["import {\n  appendFileSync,\n  copyFileSync,\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  rmSync,\n  unlinkSync,\n  writeFileSync,\n} from 'node:fs';\nimport * as path from 'node:path';\nimport { getMidsceneRunSubDir } from '@midscene/shared/common';\nimport { antiEscapeScriptTag, logMsg } from '@midscene/shared/utils';\nimport { getReportFileName } from './agent';\nimport {\n  extractAllDumpScriptsSync,\n  extractLastDumpScriptSync,\n  getBaseUrlFixScript,\n  streamDumpScriptsSync,\n  streamImageScriptsToFile,\n} from './dump/html-utils';\nimport {\n  normalizeScreenshotRef,\n  resolveScreenshotSource,\n} from './dump/screenshot-store';\nimport {\n  type ExecutionDump,\n  type IExecutionDump,\n  ReportActionDump,\n} from './types';\nimport type { ReportFileWithAttributes } from './types';\nimport { getReportTpl, reportHTMLContent } from './utils';\n\n/**\n * Check if a report is in directory mode (html-and-external-assets).\n * Directory mode reports: {name}/index.html + {name}/screenshots/\n */\nexport function isDirectoryModeReport(reportFilePath: string): boolean {\n  const reportDir = path.dirname(reportFilePath);\n  return (\n    path.basename(reportFilePath) === 'index.html' &&\n    existsSync(path.join(reportDir, 'screenshots'))\n  );\n}\n\n/**\n * Deduplicate executions by stable id, keeping only the last occurrence.\n * Old-format executions without id are always preserved.\n */\nexport function dedupeExecutionsKeepLatest<T extends Pick<ExecutionDump, 'id'>>(\n  executions: T[],\n): T[] {\n  let noIdCounter = 0;\n  const deduped = new Map<string, T>();\n  for (const exec of executions) {\n    const key = exec.id || `__no_id_${noIdCounter++}`;\n    deduped.set(key, exec);\n  }\n  return Array.from(deduped.values());\n}\nexport class ReportMergingTool {\n  private reportInfos: ReportFileWithAttributes[] = [];\n\n  private createEmptyDumpString(groupName: string, groupDescription?: string) {\n    return new ReportActionDump({\n      sdkVersion: '',\n      groupName,\n      groupDescription,\n      modelBriefs: [],\n      executions: [],\n    }).serialize();\n  }\n\n  public append(reportInfo: ReportFileWithAttributes) {\n    this.reportInfos.push(reportInfo);\n  }\n  public clear() {\n    this.reportInfos = [];\n  }\n\n  /**\n   * Merge multiple dump script contents (from the same source report)\n   * into a single serialized ReportActionDump string.\n   * If there's only one dump, return it as-is. If multiple, merge\n   * all executions into the first dump's group structure.\n   */\n  private mergeDumpScripts(contents: string[]): string {\n    const unescaped = contents\n      .map((c) => antiEscapeScriptTag(c))\n      .filter((c) => c.length > 0);\n    if (unescaped.length === 0) return '';\n    if (unescaped.length === 1) return unescaped[0];\n\n    // Parse all dumps and collect executions, deduplicating by id (keep last).\n    // Only executions with a stable id are deduped; old-format entries without\n    // id are always kept (they may be distinct despite sharing the same name).\n    const base = ReportActionDump.fromSerializedString(unescaped[0]);\n    const allExecutions = [...base.executions];\n    for (let i = 1; i < unescaped.length; i++) {\n      const other = ReportActionDump.fromSerializedString(unescaped[i]);\n      allExecutions.push(...other.executions);\n    }\n    base.executions = dedupeExecutionsKeepLatest(allExecutions);\n    return base.serialize();\n  }\n\n  public mergeReports(\n    reportFileName: 'AUTO' | string = 'AUTO',\n    opts?: {\n      rmOriginalReports?: boolean;\n      overwrite?: boolean;\n    },\n  ): string | null {\n    const { rmOriginalReports = false, overwrite = false } = opts ?? {};\n\n    if (this.reportInfos.length === 0) {\n      logMsg('No reports to merge');\n      return null;\n    }\n\n    const targetDir = getMidsceneRunSubDir('report');\n\n    // Check if any source report is directory mode\n    const hasDirectoryModeReport = this.reportInfos.some((info) => {\n      const reportFilePath = info.reportFilePath;\n      return Boolean(reportFilePath && isDirectoryModeReport(reportFilePath));\n    });\n\n    const resolvedName =\n      reportFileName === 'AUTO'\n        ? getReportFileName('merged-report')\n        : reportFileName;\n\n    // Directory mode: output as {name}/index.html to keep relative paths working\n    // Inline mode: output as {name}.html (single file)\n    const outputFilePath = hasDirectoryModeReport\n      ? path.resolve(targetDir, resolvedName, 'index.html')\n      : path.resolve(targetDir, `${resolvedName}.html`);\n\n    if (reportFileName !== 'AUTO' && existsSync(outputFilePath)) {\n      if (!overwrite) {\n        throw new Error(\n          `Report file already exists: ${outputFilePath}\\nSet overwrite to true to overwrite this file.`,\n        );\n      }\n      if (hasDirectoryModeReport) {\n        rmSync(path.dirname(outputFilePath), { recursive: true, force: true });\n      } else {\n        unlinkSync(outputFilePath);\n      }\n    }\n\n    if (hasDirectoryModeReport) {\n      mkdirSync(path.dirname(outputFilePath), { recursive: true });\n    }\n\n    logMsg(\n      `Start merging ${this.reportInfos.length} reports...\\nCreating template file...`,\n    );\n\n    try {\n      // Write template without closing </html> tag so we can append\n      // dump scripts before it. The closing tag is added at the end.\n      const htmlEndTag = '</html>';\n      const tpl = getReportTpl();\n      const htmlEndIdx = tpl.lastIndexOf(htmlEndTag);\n      const tplWithoutClose =\n        htmlEndIdx !== -1 ? tpl.slice(0, htmlEndIdx) : tpl;\n      appendFileSync(outputFilePath, tplWithoutClose);\n\n      // For directory-mode output, inject base URL fix script\n      if (hasDirectoryModeReport) {\n        appendFileSync(outputFilePath, getBaseUrlFixScript());\n      }\n\n      // Process all reports one by one\n      for (let i = 0; i < this.reportInfos.length; i++) {\n        const reportInfo = this.reportInfos[i];\n        logMsg(`Processing report ${i + 1}/${this.reportInfos.length}`);\n\n        const { reportAttributes } = reportInfo;\n        let dumpString = this.createEmptyDumpString(\n          reportAttributes.testTitle,\n          reportAttributes.testDescription,\n        );\n        let mergedGroupId = `merged-group-${i}`;\n\n        if (reportInfo.reportFilePath) {\n          if (isDirectoryModeReport(reportInfo.reportFilePath)) {\n            // Directory mode: copy external screenshot files\n            const reportDir = path.dirname(reportInfo.reportFilePath);\n            const screenshotsDir = path.join(reportDir, 'screenshots');\n            const mergedScreenshotsDir = path.join(\n              path.dirname(outputFilePath),\n              'screenshots',\n            );\n            mkdirSync(mergedScreenshotsDir, { recursive: true });\n            for (const file of readdirSync(screenshotsDir)) {\n              const src = path.join(screenshotsDir, file);\n              const dest = path.join(mergedScreenshotsDir, file);\n              copyFileSync(src, dest);\n            }\n          } else {\n            // Inline mode: stream image scripts to output file\n            streamImageScriptsToFile(reportInfo.reportFilePath, outputFilePath);\n          }\n\n          // Extract all dump scripts from the source report.\n          // After the per-execution append refactor, a single source report\n          // may contain multiple <script type=\"midscene_web_dump\"> tags\n          // (one per execution). We merge them into a single ReportActionDump.\n          // Filter by data-group-id to exclude false matches from the template's\n          // bundled JS code, which also references the midscene_web_dump type string.\n          const allDumps = extractAllDumpScriptsSync(\n            reportInfo.reportFilePath,\n          ).filter((d) => d.openTag.includes('data-group-id'));\n          const groupIdMatch = allDumps[0]?.openTag.match(\n            /data-group-id=\"([^\"]+)\"/,\n          );\n          if (groupIdMatch) {\n            mergedGroupId = decodeURIComponent(groupIdMatch[1]);\n          }\n          const extractedDumpString =\n            allDumps.length > 0\n              ? this.mergeDumpScripts(allDumps.map((d) => d.content))\n              : extractLastDumpScriptSync(reportInfo.reportFilePath);\n          if (extractedDumpString) {\n            dumpString = extractedDumpString;\n          }\n        }\n\n        const reportHtmlStr = `${reportHTMLContent(\n          {\n            dumpString,\n            attributes: {\n              'data-group-id': mergedGroupId,\n              playwright_test_duration: reportAttributes.testDuration,\n              playwright_test_status: reportAttributes.testStatus,\n              playwright_test_title: reportAttributes.testTitle,\n              playwright_test_id: reportAttributes.testId,\n              playwright_test_description: reportAttributes.testDescription,\n              is_merged: true,\n            },\n          },\n          undefined,\n          undefined,\n          false,\n        )}\\n`;\n\n        appendFileSync(outputFilePath, reportHtmlStr);\n      }\n\n      // Close the HTML document\n      appendFileSync(outputFilePath, `${htmlEndTag}\\n`);\n\n      logMsg(`Successfully merged new report: ${outputFilePath}`);\n\n      // Remove original reports if needed\n      if (rmOriginalReports) {\n        for (const info of this.reportInfos) {\n          if (!info.reportFilePath) continue;\n          try {\n            if (isDirectoryModeReport(info.reportFilePath)) {\n              // Directory mode: remove the entire report directory\n              const reportDir = path.dirname(info.reportFilePath);\n              rmSync(reportDir, { recursive: true, force: true });\n            } else {\n              unlinkSync(info.reportFilePath);\n            }\n          } catch (error) {\n            logMsg(`Error deleting report ${info.reportFilePath}: ${error}`);\n          }\n        }\n        logMsg(`Removed ${this.reportInfos.length} original reports`);\n      }\n      return outputFilePath;\n    } catch (error) {\n      logMsg(`Error in mergeReports: ${error}`);\n      throw error;\n    }\n  }\n}\n\nexport interface SplitReportHtmlOptions {\n  htmlPath: string;\n  outputDir: string;\n}\n\nexport interface SplitReportHtmlResult {\n  executionJsonFiles: string[];\n  screenshotFiles: string[];\n}\n\nexport interface CollectedReportExecutions {\n  baseDump: ReportActionDump;\n  executions: IExecutionDump[];\n}\n\n/**\n * Collect executions from a report HTML, deduplicating by stable id while\n * keeping only the latest occurrence. Old-format executions without id are\n * always preserved.\n */\nexport function collectDedupedExecutions(\n  htmlPath: string,\n): CollectedReportExecutions {\n  let baseDump: ReportActionDump | null = null;\n  let executionSerial = 0;\n  const latestSerialByExecutionId = new Map<string, number>();\n\n  streamDumpScriptsSync(htmlPath, (dumpScript) => {\n    if (!dumpScript.openTag.includes('data-group-id')) {\n      return false;\n    }\n    const groupedDump = ReportActionDump.fromSerializedString(\n      antiEscapeScriptTag(dumpScript.content),\n    );\n    for (const execution of groupedDump.executions) {\n      executionSerial += 1;\n      if (execution.id) {\n        latestSerialByExecutionId.set(execution.id, executionSerial);\n      }\n    }\n    return false;\n  });\n\n  const executions: IExecutionDump[] = [];\n  executionSerial = 0;\n  streamDumpScriptsSync(htmlPath, (dumpScript) => {\n    if (!dumpScript.openTag.includes('data-group-id')) {\n      return false;\n    }\n\n    const groupedDump = ReportActionDump.fromSerializedString(\n      antiEscapeScriptTag(dumpScript.content),\n    );\n    if (!baseDump) {\n      baseDump = groupedDump;\n    }\n\n    for (const execution of groupedDump.executions) {\n      executionSerial += 1;\n      if (\n        execution.id &&\n        latestSerialByExecutionId.get(execution.id) !== executionSerial\n      ) {\n        continue;\n      }\n      executions.push(execution);\n    }\n\n    return false;\n  });\n\n  if (!baseDump) {\n    throw new Error(`No report dump scripts found in ${htmlPath}`);\n  }\n\n  return {\n    baseDump,\n    executions,\n  };\n}\n\nfunction extensionByMimeType(mimeType: string): 'png' | 'jpeg' {\n  if (mimeType === 'image/png') return 'png';\n  if (mimeType === 'image/jpeg') return 'jpeg';\n  throw new Error(`Unsupported screenshot mime type: ${mimeType}`);\n}\n\nfunction externalizeScreenshotsInExecution(\n  execution: IExecutionDump,\n  opts: {\n    htmlPath: string;\n    screenshotsDir: string;\n    writtenFiles: Set<string>;\n  },\n): void {\n  const visit = (node: unknown): void => {\n    if (Array.isArray(node)) {\n      for (const item of node) {\n        visit(item);\n      }\n      return;\n    }\n\n    if (typeof node !== 'object' || node === null) return;\n\n    const ref = normalizeScreenshotRef(node);\n    if (ref) {\n      const ext = extensionByMimeType(ref.mimeType);\n      const fileName = `${ref.id}.${ext}`;\n      const relativePath = `./screenshots/${fileName}`;\n      const absolutePath = path.join(opts.screenshotsDir, fileName);\n\n      if (!opts.writtenFiles.has(fileName)) {\n        const resolved = resolveScreenshotSource(ref, {\n          reportPath: opts.htmlPath,\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        } else {\n          copyFileSync(resolved.filePath, absolutePath);\n        }\n        opts.writtenFiles.add(fileName);\n      }\n\n      ref.storage = 'file';\n      ref.path = relativePath;\n      return;\n    }\n\n    for (const value of Object.values(node)) {\n      visit(value);\n    }\n  };\n\n  visit(execution);\n}\n\n/**\n * Reverse parse a Midscene report HTML into per-execution JSON files and\n * externalized screenshots.\n */\nexport function splitReportHtmlByExecution(\n  options: SplitReportHtmlOptions,\n): SplitReportHtmlResult {\n  const { htmlPath, outputDir } = options;\n  const screenshotsDir = path.join(outputDir, 'screenshots');\n\n  mkdirSync(outputDir, { recursive: true });\n  mkdirSync(screenshotsDir, { recursive: true });\n\n  const executionJsonFiles: string[] = [];\n  const writtenScreenshotFiles = new Set<string>();\n  const { baseDump, executions } = collectDedupedExecutions(htmlPath);\n\n  let fileIndex = 0;\n  for (const execution of executions) {\n    fileIndex += 1;\n    externalizeScreenshotsInExecution(execution, {\n      htmlPath,\n      screenshotsDir,\n      writtenFiles: writtenScreenshotFiles,\n    });\n    const singleExecutionDump = new ReportActionDump({\n      sdkVersion: baseDump.sdkVersion,\n      groupName: baseDump.groupName,\n      groupDescription: baseDump.groupDescription,\n      modelBriefs: baseDump.modelBriefs,\n      deviceType: baseDump.deviceType,\n      executions: [execution],\n    });\n\n    const jsonFilePath = path.join(outputDir, `${fileIndex}.execution.json`);\n    writeFileSync(jsonFilePath, singleExecutionDump.serialize(2), 'utf-8');\n    executionJsonFiles.push(jsonFilePath);\n  }\n\n  return {\n    executionJsonFiles,\n    screenshotFiles: Array.from(writtenScreenshotFiles)\n      .sort()\n      .map((fileName) => path.join(screenshotsDir, fileName)),\n  };\n}\n"],"names":["isDirectoryModeReport","reportFilePath","reportDir","path","existsSync","dedupeExecutionsKeepLatest","executions","noIdCounter","deduped","Map","exec","key","Array","ReportMergingTool","groupName","groupDescription","ReportActionDump","reportInfo","contents","unescaped","c","antiEscapeScriptTag","base","allExecutions","i","other","reportFileName","opts","rmOriginalReports","overwrite","logMsg","targetDir","getMidsceneRunSubDir","hasDirectoryModeReport","info","Boolean","resolvedName","getReportFileName","outputFilePath","Error","rmSync","unlinkSync","mkdirSync","htmlEndTag","tpl","getReportTpl","htmlEndIdx","tplWithoutClose","appendFileSync","getBaseUrlFixScript","reportAttributes","dumpString","mergedGroupId","screenshotsDir","mergedScreenshotsDir","file","readdirSync","src","dest","copyFileSync","streamImageScriptsToFile","allDumps","extractAllDumpScriptsSync","d","groupIdMatch","decodeURIComponent","extractedDumpString","extractLastDumpScriptSync","reportHtmlStr","reportHTMLContent","undefined","error","collectDedupedExecutions","htmlPath","baseDump","executionSerial","latestSerialByExecutionId","streamDumpScriptsSync","dumpScript","groupedDump","execution","extensionByMimeType","mimeType","externalizeScreenshotsInExecution","visit","node","item","ref","normalizeScreenshotRef","ext","fileName","relativePath","absolutePath","resolved","resolveScreenshotSource","rawBase64","writeFileSync","Buffer","value","Object","splitReportHtmlByExecution","options","outputDir","executionJsonFiles","writtenScreenshotFiles","Set","fileIndex","singleExecutionDump","jsonFilePath"],"mappings":"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"}

package/dist/es/screenshot-item.mjs

@@ -0,0 +1,122 @@
+import { readFileSync } from "node:fs";
+import { uuid } from "@midscene/shared/utils";
+import { extractImageByIdSync } from "./dump/html-utils.mjs";
+import { normalizeScreenshotRef } from "./dump/screenshot-store.mjs";
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+function detectFormat(base64) {
+    if (base64.startsWith('data:image/jpeg')) return 'jpeg';
+    if (base64.startsWith('data:image/jpg')) return 'jpeg';
+    return 'png';
+}
+class ScreenshotItem {
+    static create(base64, capturedAt) {
+        return new ScreenshotItem(uuid(), base64, capturedAt);
+    }
+    get id() {
+        return this._id;
+    }
+    get format() {
+        return this._format;
+    }
+    get extension() {
+        return 'jpeg' === this._format ? 'jpeg' : 'png';
+    }
+    get capturedAt() {
+        return this._capturedAt;
+    }
+    get base64() {
+        if (null !== this._base64) return this._base64;
+        const loadFromFile = ()=>{
+            if (null === this._persistedPath) throw new Error(`Screenshot ${this._id}: file recovery path missing`);
+            const buffer = readFileSync(this._persistedPath);
+            return `data:image/${this._format};base64,${buffer.toString('base64')}`;
+        };
+        const loadFromInline = ()=>{
+            if (null === this._persistedHtmlPath) throw new Error(`Screenshot ${this._id}: HTML recovery path missing`);
+            const data = extractImageByIdSync(this._persistedHtmlPath, this._id);
+            if (data) return data;
+            throw new Error(`Screenshot ${this._id}: cannot recover from HTML (id not found in ${this._persistedHtmlPath})`);
+        };
+        if (this._serializedRef?.storage === 'file') return loadFromFile();
+        if (this._serializedRef?.storage === 'inline') return loadFromInline();
+        if (null !== this._persistedPath) return loadFromFile();
+        if (null !== this._persistedHtmlPath) return loadFromInline();
+        throw new Error(`Screenshot ${this._id}: base64 data released without recovery path`);
+    }
+    hasBase64() {
+        return null !== this._base64;
+    }
+    markPersistedInline(htmlPath) {
+        const ref = this.createRef('inline');
+        this._serializedRef = ref;
+        this._persistedHtmlPath = htmlPath;
+        this._base64 = null;
+        return ref;
+    }
+    registerPersistedFileCopy(relativePath, absolutePath) {
+        const ref = this.createRef('file', relativePath);
+        this._persistedPath = absolutePath;
+        this._base64 = null;
+        return ref;
+    }
+    markPersistedToPath(relativePath, absolutePath) {
+        const ref = this.registerPersistedFileCopy(relativePath, absolutePath);
+        this._serializedRef = ref;
+        return ref;
+    }
+    toSerializable() {
+        return this._serializedRef ?? {
+            type: 'midscene_screenshot_ref',
+            id: this._id,
+            capturedAt: this._capturedAt,
+            mimeType: 'jpeg' === this._format ? 'image/jpeg' : 'image/png',
+            storage: 'inline'
+        };
+    }
+    static isSerialized(value) {
+        return null !== normalizeScreenshotRef(value);
+    }
+    createRef(storage, relativePath) {
+        const baseRef = {
+            type: 'midscene_screenshot_ref',
+            id: this._id,
+            capturedAt: this._capturedAt,
+            mimeType: 'jpeg' === this._format ? 'image/jpeg' : 'image/png',
+            storage
+        };
+        if ('file' === storage) return {
+            ...baseRef,
+            storage,
+            path: relativePath
+        };
+        return baseRef;
+    }
+    get rawBase64() {
+        return this.base64.replace(/^data:image\/(png|jpeg|jpg);base64,/, '');
+    }
+    constructor(id, base64, capturedAt){
+        _define_property(this, "_id", void 0);
+        _define_property(this, "_base64", void 0);
+        _define_property(this, "_format", void 0);
+        _define_property(this, "_capturedAt", void 0);
+        _define_property(this, "_serializedRef", null);
+        _define_property(this, "_persistedPath", null);
+        _define_property(this, "_persistedHtmlPath", null);
+        this._id = id;
+        this._base64 = base64;
+        this._format = detectFormat(base64);
+        this._capturedAt = capturedAt;
+    }
+}
+export { ScreenshotItem };
+
+//# sourceMappingURL=screenshot-item.mjs.map

package/dist/es/screenshot-item.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot-item.mjs","sources":["../../src/screenshot-item.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { uuid } from '@midscene/shared/utils';\nimport { extractImageByIdSync } from './dump/html-utils';\nimport {\n  type ScreenshotRef,\n  normalizeScreenshotRef,\n} from './dump/screenshot-store';\n\n/**\n * Serialization format for ScreenshotItem\n * - { $screenshot: \"id\" } - inline mode, references imageMap in HTML\n * - { base64: \"path\" } - directory mode, references external file path\n */\nexport type ScreenshotSerializeFormat = ScreenshotRef;\n\n/**\n * Detect image format from base64 data URI prefix.\n */\nfunction detectFormat(base64: string): 'png' | 'jpeg' {\n  if (base64.startsWith('data:image/jpeg')) return 'jpeg';\n  if (base64.startsWith('data:image/jpg')) return 'jpeg';\n  return 'png';\n}\n\n/**\n * ScreenshotItem encapsulates screenshot data.\n *\n * Supports lazy loading after memory release:\n * - inline mode: reads from HTML file using streaming (extractImageByIdSync)\n * - directory mode: reads from file on disk\n *\n * After persistence, memory is released but the screenshot can be recovered\n * on-demand from disk, making it safe to release memory at any time.\n */\nexport class ScreenshotItem {\n  private _id: string;\n  private _base64: string | null;\n  private _format: 'png' | 'jpeg';\n  private _capturedAt: number;\n  private _serializedRef: ScreenshotRef | null = null;\n  private _persistedPath: string | null = null;\n  private _persistedHtmlPath: string | null = null;\n\n  private constructor(id: string, base64: string, capturedAt: number) {\n    this._id = id;\n    this._base64 = base64;\n    this._format = detectFormat(base64);\n    this._capturedAt = capturedAt;\n  }\n\n  /** Create a new ScreenshotItem from base64 data */\n  static create(base64: string, capturedAt: number): ScreenshotItem {\n    return new ScreenshotItem(uuid(), base64, capturedAt);\n  }\n\n  get id(): string {\n    return this._id;\n  }\n\n  /** Get the image format (png or jpeg) */\n  get format(): 'png' | 'jpeg' {\n    return this._format;\n  }\n\n  /** Get the file extension for this screenshot */\n  get extension(): string {\n    return this._format === 'jpeg' ? 'jpeg' : 'png';\n  }\n\n  /** Get screenshot capture timestamp in milliseconds */\n  get capturedAt(): number {\n    return this._capturedAt;\n  }\n\n  get base64(): string {\n    // If data is in memory, return it directly\n    if (this._base64 !== null) {\n      return this._base64;\n    }\n\n    const loadFromFile = (): string => {\n      if (this._persistedPath === null) {\n        throw new Error(`Screenshot ${this._id}: file recovery path missing`);\n      }\n      const buffer = readFileSync(this._persistedPath);\n      return `data:image/${this._format};base64,${buffer.toString('base64')}`;\n    };\n\n    const loadFromInline = (): string => {\n      if (this._persistedHtmlPath === null) {\n        throw new Error(`Screenshot ${this._id}: HTML recovery path missing`);\n      }\n      const data = extractImageByIdSync(this._persistedHtmlPath, this._id);\n      if (data) {\n        return data;\n      }\n      throw new Error(\n        `Screenshot ${this._id}: cannot recover from HTML (id not found in ${this._persistedHtmlPath})`,\n      );\n    };\n\n    // Recover from the primary serialized mode first.\n    if (this._serializedRef?.storage === 'file') {\n      return loadFromFile();\n    }\n\n    if (this._serializedRef?.storage === 'inline') {\n      return loadFromInline();\n    }\n\n    // Fall back to whichever recovery path is available.\n    if (this._persistedPath !== null) {\n      return loadFromFile();\n    }\n\n    if (this._persistedHtmlPath !== null) {\n      return loadFromInline();\n    }\n\n    throw new Error(\n      `Screenshot ${this._id}: base64 data released without recovery path`,\n    );\n  }\n\n  /** Check if base64 data is still available in memory (not yet released) */\n  hasBase64(): boolean {\n    return this._base64 !== null;\n  }\n\n  /**\n   * Mark as persisted to HTML (inline mode).\n   * Releases base64 memory, but keeps HTML path for lazy loading recovery.\n   * @param htmlPath - absolute path to the HTML file containing the image\n   */\n  markPersistedInline(htmlPath: string): ScreenshotRef {\n    const ref = this.createRef('inline');\n    this._serializedRef = ref;\n    this._persistedHtmlPath = htmlPath;\n    this._base64 = null;\n    return ref;\n  }\n\n  /**\n   * Register a file-backed recovery path without changing the serialized mode.\n   * Used when inline persistence also needs a shared file copy next to dumps.\n   */\n  registerPersistedFileCopy(\n    relativePath: string,\n    absolutePath: string,\n  ): ScreenshotRef {\n    const ref = this.createRef('file', relativePath);\n    this._persistedPath = absolutePath;\n    this._base64 = null;\n    return ref;\n  }\n\n  /**\n   * Mark as persisted to file (directory mode).\n   * Releases base64 memory, but keeps file path for lazy loading recovery.\n   * @param relativePath - relative path for serialization (e.g., \"./screenshots/id.jpeg\")\n   * @param absolutePath - absolute path for lazy loading recovery\n   */\n  markPersistedToPath(\n    relativePath: string,\n    absolutePath: string,\n  ): ScreenshotRef {\n    const ref = this.registerPersistedFileCopy(relativePath, absolutePath);\n    this._serializedRef = ref;\n    return ref;\n  }\n\n  /** Serialize for JSON - format depends on persistence state */\n  toSerializable(): ScreenshotSerializeFormat {\n    return (\n      this._serializedRef ?? {\n        type: 'midscene_screenshot_ref',\n        id: this._id,\n        capturedAt: this._capturedAt,\n        mimeType: this._format === 'jpeg' ? 'image/jpeg' : 'image/png',\n        storage: 'inline',\n      }\n    );\n  }\n\n  /** Check if a value is a serialized ScreenshotItem reference (inline or directory mode) */\n  static isSerialized(value: unknown): value is ScreenshotSerializeFormat {\n    return normalizeScreenshotRef(value) !== null;\n  }\n\n  private createRef(\n    storage: 'inline' | 'file',\n    relativePath?: string,\n  ): ScreenshotRef {\n    const baseRef: Omit<ScreenshotRef, 'path'> = {\n      type: 'midscene_screenshot_ref',\n      id: this._id,\n      capturedAt: this._capturedAt,\n      mimeType: this._format === 'jpeg' ? 'image/jpeg' : 'image/png',\n      storage,\n    };\n    if (storage === 'file') {\n      return {\n        ...baseRef,\n        storage,\n        path: relativePath!,\n      };\n    }\n    return baseRef;\n  }\n\n  /**\n   * Get base64 data without the data URI prefix.\n   * Useful for writing raw binary data to files.\n   */\n  get rawBase64(): string {\n    return this.base64.replace(/^data:image\\/(png|jpeg|jpg);base64,/, '');\n  }\n}\n"],"names":["detectFormat","base64","ScreenshotItem","capturedAt","uuid","loadFromFile","Error","buffer","readFileSync","loadFromInline","data","extractImageByIdSync","htmlPath","ref","relativePath","absolutePath","value","normalizeScreenshotRef","storage","baseRef","id"],"mappings":"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"}