ptywright 0.6.1 → 0.6.3

package/dist/agent.mjs

@@ -1,2 +1,2 @@
-import { a as formatAgentLaunchPlan, i as runAgentSpecPath, n as replayAgentRecordPath, r as runAgentSpec, t as defaultSpecNameForPath } from "./runner-XEimk7TO.mjs";
+import { a as formatAgentLaunchPlan, i as runAgentSpecPath, n as replayAgentRecordPath, r as runAgentSpec, t as defaultSpecNameForPath } from "./runner-RhWYhus1.mjs";
 export { defaultSpecNameForPath, formatAgentLaunchPlan, replayAgentRecordPath, runAgentSpec, runAgentSpecPath };

package/dist/bin/ptywright.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env bun
-import { t as main } from "../cli-XLR4BPhA.mjs";
+import { t as main } from "../cli-uj8xaanE.mjs";
 //#region src/bin/ptywright.ts
 await main();
 //#endregion

package/dist/{cli-XLR4BPhA.mjs → cli-uj8xaanE.mjs}

@@ -1,9 +1,9 @@
 import { n as loadPtywrightConfig } from "./config-bGg636EW.mjs";
-import { C as writeAgentManifestPath, D as escapeHtml, E as escapeAttribute, O as normalizeAgentFlowSpec, S as validateAgentManifestFiles, T as readAgentCassettePath, _ as formatArgv, b as isAgentManifestLike, c as launchAgentBrowser, d as AGENT_RUN_RECORD_SCHEMA_URL, f as agentRunModeSchema, g as writeAgentRunRecordPath, h as readAgentRunRecordPath, i as runAgentSpecPath, k as sanitizeArtifactName, l as createAgentTemplateSpec, m as isAgentRunRecordLike, n as replayAgentRecordPath, o as resolveAgentLaunchTarget, p as formatAgentArgv, s as normalizeAgentFlowSpecWithConfig, u as loadAgentSpec, v as AGENT_MANIFEST_FILE_NAME, w as isAgentCassetteLike, x as readAgentManifestPath, y as agentManifestPath } from "./runner-XEimk7TO.mjs";
+import { C as writeAgentManifestPath, D as escapeHtml, E as escapeAttribute, O as normalizeAgentFlowSpec, S as validateAgentManifestFiles, T as readAgentCassettePath, _ as formatArgv, b as isAgentManifestLike, c as launchAgentBrowser, d as AGENT_RUN_RECORD_SCHEMA_URL, f as agentRunModeSchema, g as writeAgentRunRecordPath, h as readAgentRunRecordPath, i as runAgentSpecPath, k as sanitizeArtifactName, l as createAgentTemplateSpec, m as isAgentRunRecordLike, n as replayAgentRecordPath, o as resolveAgentLaunchTarget, p as formatAgentArgv, s as normalizeAgentFlowSpecWithConfig, u as loadAgentSpec, v as AGENT_MANIFEST_FILE_NAME, w as isAgentCassetteLike, x as readAgentManifestPath, y as agentManifestPath } from "./runner-RhWYhus1.mjs";
 import { a as sameArgv, i as diffCommandMaps, r as formatZodIssues } from "./manifest_files-DW80c1H7.mjs";
 import { i as portableCliPath, n as mergeProcessEnv, o as relativeHref, s as samePath } from "./env-DPYHo-zH.mjs";
 import { d as resolvePtyBackend, u as createDefaultPtyAdapter } from "./runner-BHXXwxYp.mjs";
-import { a as resolveScriptManifestPath, c as relocateScriptManifestCommands, d as resolveScriptRunSummaryPath, f as runScriptPath, i as readScriptManifestPath, l as resolveManifestPrimaryPath$1, n as runAllScripts, o as validateScriptManifest, r as findScriptSummaryManifest, t as createPtywrightServer, u as readScriptRunSummaryPath } from "./server-COuf3mW7.mjs";
+import { a as resolveScriptManifestPath, c as relocateScriptManifestCommands, d as resolveScriptRunSummaryPath, f as runScriptPath, i as readScriptManifestPath, l as resolveManifestPrimaryPath$1, n as runAllScripts, o as validateScriptManifest, r as findScriptSummaryManifest, t as createPtywrightServer, u as readScriptRunSummaryPath } from "./server-B4Bbuluz.mjs";
 import { c as createPtyCassetteReplay, i as formatPtyCassetteInspectLines, l as readPtyCassettePath, o as inspectPtyCassettePath, r as createPtyCassetteRecorder, t as wrapPtyLike, v as validatePtyCassette } from "./pty_like-DWIlWGgA.mjs";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, extname, isAbsolute, join, relative, resolve } from "node:path";
@@ -418,6 +418,7 @@ const agentReplayFailedArtifactSchema = z.object({
 	kind: z.enum([
 		"terminal",
 		"dom",
+		"layout",
 		"screenshot"
 	]),
 	path: z.string().min(1),
@@ -1808,6 +1809,7 @@ async function replayRecordEntry(filePath, artifactsDir, options) {
 	try {
 		return await replayAgentRecordPath(filePath, {
 			artifactsDir,
+			config: options.config,
 			headless: options.headless,
 			updateSnapshots: options.updateSnapshots
 		});
@@ -2023,6 +2025,7 @@ async function replayAllAgentRecords(options = {}) {
 		const artifactsDir = join(suiteDir, "tests", safeArtifactsDirName(relative(dir, filePath)));
 		const entryStartedAt = Date.now();
 		const result = await replayRecordEntry(filePath, artifactsDir, {
+			config: options.config,
 			headless: options.headless ?? true,
 			updateSnapshots
 		});
@@ -2089,6 +2092,7 @@ async function checkAgentRegression(options = {}) {
 		validationAfter: emptyValidationResult(artifactsRoot)
 	});
 	const replay = await replayAllAgentRecords({
+		config: options.config,
 		dir: cassetteDir,
 		artifactsRoot,
 		headless: options.headless ?? true,
@@ -2721,6 +2725,7 @@ async function runAgentRecord(args, context) {
 }
 async function runAgentCheck(args, context) {
 	return printAgentCheckResult(await checkAgentRegression({
+		config: context.config,
 		cassetteDir: args.path ?? args.cassetteDir ?? resolveAgentConfigPath(context.config, context.config?.agent?.cassetteDir),
 		artifactsRoot: args.artifactsRoot ?? resolveAgentConfigPath(context.config, context.config?.agent?.artifactsRoot),
 		headless: context.headless,
@@ -2748,6 +2753,7 @@ async function runAgentRerun(args, context) {
 }
 async function runAgentReplayAll(args, context) {
 	return printAgentReplayAllResult(await replayAllAgentRecords({
+		config: context.config,
 		dir: args.path ?? resolveAgentConfigPath(context.config, context.config?.agent?.cassetteDir),
 		artifactsRoot: args.artifactsRoot ?? resolveAgentConfigPath(context.config, context.config?.agent?.artifactsRoot),
 		headless: context.headless,

package/dist/cli.mjs

@@ -1,2 +1,2 @@
-import { t as main } from "./cli-XLR4BPhA.mjs";
+import { t as main } from "./cli-uj8xaanE.mjs";
 export { main };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { t as createPtywrightServer } from "./server-COuf3mW7.mjs";
+import { t as createPtywrightServer } from "./server-B4Bbuluz.mjs";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 //#region src/index.ts
 const { server, sessions } = createPtywrightServer();

package/dist/mcp.mjs

@@ -1,2 +1,2 @@
-import { t as createPtywrightServer } from "./server-COuf3mW7.mjs";
+import { t as createPtywrightServer } from "./server-B4Bbuluz.mjs";
 export { createPtywrightServer };

package/dist/{runner-XEimk7TO.mjs → runner-RhWYhus1.mjs}

@@ -36,6 +36,9 @@ function normalizeTerminalText(input, rules = []) {
 function normalizeDomSnapshot(input, rules = []) {
 	return applyAgentMasks(input.replace(/\sdata-v-[a-z0-9-]+="[^"]*"/g, "").replace(/\sstyle="[^"]*--term-(?:cell-width|row-height):[^"]*"/g, "").replace(/\s+/g, " ").replace(/>\s+</g, "><").replace(/<div class="[^"]*\bterm-row\b[^"]*\bterm-scrollback-row\b[^"]*"[^>]*><span[^>]*><\/span><\/div>/g, "").trim(), rules, { replacement: escapeHtmlText });
 }
+function normalizeReplayDom(input, rules = []) {
+	return applyAgentMasks(input.replace(/\r\n?/g, "\n"), rules, { replacement: escapeHtmlText });
+}
 function sanitizeArtifactName(input) {
 	return input.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "artifact";
 }
@@ -144,6 +147,7 @@ const snapshotStepSchema = z.object({
 	targets: z.array(z.enum([
 		"terminal",
 		"dom",
+		"layout",
 		"screenshot"
 	])).optional(),
 	fullPage: z.boolean().optional()
@@ -468,6 +472,7 @@ const agentManifestFileKindSchema = z.enum([
 	"report",
 	"terminal",
 	"dom",
+	"layout",
 	"screenshot",
 	"diff"
 ]);
@@ -595,6 +600,7 @@ const agentRunArtifactSchema = z.object({
 	kind: z.enum([
 		"terminal",
 		"dom",
+		"layout",
 		"screenshot"
 	]),
 	path: z.string().min(1),
@@ -879,8 +885,8 @@ function errorFields(error) {
 //#endregion
 //#region src/agent/aitty_report_assets.ts
 function prepareAittyReportAssets(context) {
-	const sources = resolveAittyReportAssetSources(context);
-	if (!existsSync(sources.scriptSource) || !existsSync(sources.styleSource)) throw new Error("@aitty/snapshot report assets are missing. Run the package build before generating reports.");
+	const sources = resolveAittyReportAssetSources();
+	if (!existsSync(sources.scriptSource) || !existsSync(sources.styleSource)) throw new Error("@aitty/snapshot report assets are missing. Reinstall ptywright dependencies before generating reports.");
 	const assetDir = join(context.artifactsDir, "assets");
 	const scriptPath = join(assetDir, "aitty-web-component.js");
 	const stylePath = join(assetDir, "aitty-terminal.css");
@@ -889,63 +895,25 @@ function prepareAittyReportAssets(context) {
 	copyFileSync(sources.styleSource, stylePath);
 	return {
 		scriptPath,
-		scriptType: sources.scriptType,
 		stylePath
 	};
 }
-function resolveAittyReportAssetSources(context) {
-	for (const resolverBase of resolveAittyReportResolverBases(context)) {
-		const sources = tryResolveAittyReportAssetSources(createRequire(resolverBase));
-		if (sources) return sources;
-	}
-	const fallback = tryResolveAittyReportAssetSources(createRequire(import.meta.url));
-	if (fallback) return fallback;
-	throw new Error("@aitty/snapshot report assets are missing. Install @aitty/snapshot or run the package build before generating reports.");
-}
-function resolveAittyReportResolverBases(context) {
-	const candidates = [
-		findNearestPackageJson(dirname(resolve(context.flowPath))),
-		findNearestPackageJson(dirname(resolve(context.reportPath))),
-		findNearestPackageJson(dirname(resolve(context.artifactsDir))),
-		findNearestPackageJson(process.cwd())
-	].filter((path) => Boolean(path));
-	return Array.from(new Set(candidates));
-}
-function findNearestPackageJson(startDir) {
-	let currentDir = resolve(startDir);
-	while (true) {
-		const packagePath = join(currentDir, "package.json");
-		if (existsSync(packagePath)) return packagePath;
-		const parentDir = dirname(currentDir);
-		if (parentDir === currentDir) return null;
-		currentDir = parentDir;
-	}
+function resolveAittyReportAssetSources() {
+	const sources = tryResolveAittyReportAssetSources(createRequire(import.meta.url));
+	if (!sources) throw new Error("@aitty/snapshot report assets are missing. Install @aitty/snapshot before generating reports.");
+	return sources;
 }
 function tryResolveAittyReportAssetSources(resolver) {
-	return tryResolveAittyPackageAssetSources(resolver, "@aitty/snapshot") ?? tryResolveAittyPackageAssetSources(resolver, "@aitty/browser");
-}
-function tryResolveAittyPackageAssetSources(resolver, packageName) {
 	let scriptSource;
-	let scriptType = "classic";
 	let styleSource;
 	try {
-		scriptSource = resolver.resolve(`${packageName}/web-component.global.js`);
-	} catch {
-		try {
-			scriptSource = resolver.resolve(`${packageName}/web-component.js`);
-			scriptType = "module";
-		} catch {
-			return null;
-		}
-	}
-	try {
-		styleSource = resolver.resolve(`${packageName}/style.css`);
+		scriptSource = resolver.resolve("@aitty/snapshot/web-component.global.js");
+		styleSource = resolver.resolve("@aitty/snapshot/style.css");
 	} catch {
 		return null;
 	}
 	return {
 		scriptSource,
-		scriptType,
 		styleSource
 	};
 }
@@ -960,13 +928,12 @@ function relativeHref(fromPath, targetPath, artifactsDir) {
 function resolveAittyPreviewAssets(previewPath, assets, artifactsDir) {
 	return {
 		scriptHref: relativeHref(previewPath, assets.scriptPath, artifactsDir),
-		scriptType: assets.scriptType,
 		styleHref: relativeHref(previewPath, assets.stylePath, artifactsDir)
 	};
 }
 function renderAittyPreviewAssetTags(assets) {
 	return `    <link rel="stylesheet" href="${escapeAttribute(assets.styleHref)}" />
-    <script${assets.scriptType === "module" ? " type=\"module\"" : ""} src="${escapeAttribute(assets.scriptHref)}"><\/script>
+    <script src="${escapeAttribute(assets.scriptHref)}"><\/script>
 `;
 }
 function renderAittyPreviewBody(args) {
@@ -1001,6 +968,7 @@ function renderAittyPreviewCss(viewOptions) {
 //#region src/agent/report_artifact_paths.ts
 function artifactViewerPath(artifact) {
 	if (artifact.kind === "terminal") return artifact.path.endsWith(".terminal.txt") ? artifact.path.replace(/\.terminal\.txt$/, ".terminal.viewer.html") : `${artifact.path}.viewer.html`;
+	if (artifact.kind === "layout") return artifact.path.endsWith(".layout.txt") ? artifact.path.replace(/\.layout\.txt$/, ".layout.viewer.html") : `${artifact.path}.viewer.html`;
 	if (artifact.kind === "dom") return artifact.path.endsWith(".dom.html") ? artifact.path.replace(/\.dom\.html$/, ".dom.viewer.html") : `${artifact.path}.viewer.html`;
 	return null;
 }
@@ -1546,6 +1514,28 @@ function normalizeStringArray(value) {
 	return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
 }
 //#endregion
+//#region src/agent/report_stable_frame_config.ts
+function resolveStableFrameConfig(config, flowName) {
+	const stableFrames = config?.agent?.report?.stableFrames;
+	const flowConfig = stableFrames?.flows?.[flowName];
+	return {
+		...stableFrames,
+		...flowConfig,
+		previewSource: flowConfig?.previewSource ?? stableFrames?.previewSource ?? "captured-dom",
+		stableMs: flowConfig?.stableMs ?? stableFrames?.stableMs ?? 200,
+		theme: flowConfig?.theme ?? stableFrames?.theme ?? "dark",
+		viewportOnly: flowConfig?.viewportOnly ?? stableFrames?.viewportOnly ?? false,
+		viewportTargets: {
+			...stableFrames?.viewportTargets,
+			...flowConfig?.viewportTargets
+		}
+	};
+}
+function shouldUsePtyReplayStableFrameDomPreview(args) {
+	const config = resolveStableFrameConfig(args.config, args.flowName);
+	return config.enabled !== false && !config.skip && config.previewSource === "pty-replay";
+}
+//#endregion
 //#region src/agent/report_view_options.ts
 function isMobileViewport(viewport) {
 	return Boolean(viewport?.isMobile || viewport?.hasTouch || (viewport?.width ?? 9999) <= 720);
@@ -1557,8 +1547,11 @@ function resolveReportViewOptions(result, config) {
 	const themeArg = readFlagValueFromArgSets(launchArgSets, "--theme");
 	const fontSizeArg = readFlagValueFromArgSets(launchArgSets, "--font-size");
 	const lineHeightArg = readFlagValueFromArgSets(launchArgSets, "--line-height");
-	const stableFrameConfig = resolveStableFrameConfig$1(config, result.name);
-	const themeOverride = ptyReplayArg && stableFrameConfig.enabled !== false && !stableFrameConfig.skip ? stableFrameConfig.theme : void 0;
+	const stableFrameConfig = resolveStableFrameConfig(config, result.name);
+	const themeOverride = ptyReplayArg && shouldUsePtyReplayStableFrameDomPreview({
+		config,
+		flowName: result.name
+	}) ? stableFrameConfig.theme : void 0;
 	return {
 		fontSize: parsePositiveNumber(fontSizeArg) ?? 15,
 		lineHeight: parsePositiveNumber(lineHeightArg) ?? 1.6,
@@ -1571,15 +1564,6 @@ function parsePositiveNumber(value) {
 	const parsed = Number(value);
 	return Number.isFinite(parsed) && parsed > 0 ? parsed : void 0;
 }
-function resolveStableFrameConfig$1(config, flowName) {
-	const stableFrames = config?.agent?.report?.stableFrames;
-	const flowConfig = stableFrames?.flows?.[flowName];
-	return {
-		enabled: flowConfig?.enabled ?? stableFrames?.enabled,
-		skip: flowConfig?.skip ?? stableFrames?.skip,
-		theme: flowConfig?.theme ?? stableFrames?.theme ?? "dark"
-	};
-}
 //#endregion
 //#region src/agent/report_artifact_viewer.ts
 function renderArtifactViewerHtml(args) {
@@ -1667,21 +1651,6 @@ ${body}
   </body>
 </html>`;
 }
-function resolveStableFrameConfig(config, flowName) {
-	const stableFrames = config?.agent?.report?.stableFrames;
-	const flowConfig = stableFrames?.flows?.[flowName];
-	return {
-		...stableFrames,
-		...flowConfig,
-		stableMs: flowConfig?.stableMs ?? stableFrames?.stableMs ?? 200,
-		theme: flowConfig?.theme ?? stableFrames?.theme ?? "dark",
-		viewportOnly: flowConfig?.viewportOnly ?? stableFrames?.viewportOnly ?? false,
-		viewportTargets: {
-			...stableFrames?.viewportTargets,
-			...flowConfig?.viewportTargets
-		}
-	};
-}
 function resolvePtyReplayPath(replayPathArg, config) {
 	if (isAbsolute(replayPathArg)) return replayPathArg;
 	return resolve(config?.rootDir ?? process.cwd(), replayPathArg);
@@ -1865,29 +1834,50 @@ function renderStableFrameDom(frame, targetCols) {
 	let html = "";
 	let totalRows = 0;
 	let wideBlockId = 0;
-	for (const line of frame.lines) {
-		const lineCols = cellsDisplayWidth(line.cells);
-		if (shouldRenderViewportPan(line, lineCols, targetCols)) {
-			wideBlockId += 1;
-			const blockCols = Math.max(targetCols, lineCols);
-			html += `<div class="term-wide-row-block" data-aitty-wide-block="true" data-aitty-wide-block-id="${wideBlockId}" data-aitty-wide-block-kind="viewport-pan" style="--aitty-wide-block-cols: ${blockCols}">`;
-			html += renderStableFrameRow(line, blockCols, totalRows);
-			html += "</div>";
-			totalRows += 1;
-		} else for (const row of wrapStableLogicalLine(line, targetCols)) {
+	let codeRunCols = 0;
+	let codeRunRows = [];
+	const renderPlainRow = (line) => {
+		for (const row of wrapStableLogicalLine(line, targetCols)) {
 			html += renderStableFrameRow(row, targetCols, totalRows);
 			totalRows += 1;
 		}
+	};
+	const flushCodeRun = () => {
+		if (codeRunRows.length === 0) return;
+		if (codeRunCols > targetCols) {
+			wideBlockId += 1;
+			const blockCols = Math.max(targetCols, codeRunCols);
+			html += `<div class="term-wide-row-block" data-aitty-wide-block="true" data-aitty-wide-block-id="${wideBlockId}" data-aitty-wide-block-kind="guttered-code" style="--aitty-wide-block-cols: ${blockCols}">`;
+			for (const row of codeRunRows) {
+				html += renderStableFrameRow(row, blockCols, totalRows);
+				totalRows += 1;
+			}
+			html += "</div>";
+		} else for (const row of codeRunRows) renderPlainRow(row);
+		codeRunCols = 0;
+		codeRunRows = [];
+	};
+	for (const line of frame.lines) {
+		const lineText = stableLineText(line);
+		const lineCols = cellsDisplayWidth(line.cells);
+		if (isGutteredCodeLine(lineText) || isDiffLikeLine(lineText)) {
+			codeRunRows.push(line);
+			codeRunCols = Math.max(codeRunCols, lineCols);
+			continue;
+		}
+		flushCodeRun();
+		renderPlainRow(line);
 	}
+	flushCodeRun();
 	return `<div class="term-grid" data-cols="${targetCols}" data-rows="${totalRows}" style="--term-cols: ${targetCols}; --term-rows: ${totalRows};">${html}</div>`;
 }
-function shouldRenderViewportPan(line, lineCols, targetCols) {
-	if (lineCols <= targetCols) return false;
-	return isDiffLikeLine(stableLineText(line));
-}
 function stableLineText(line) {
 	return line.cells.map((cell) => cell.text).join("").trimEnd();
 }
+function isGutteredCodeLine(text) {
+	const normalized = text.replace(/[│┃┆┊▏▕]/g, " ").trimStart();
+	return /^\d+\s+(?:[+-]|\s{2,}\S)/.test(normalized);
+}
 function isDiffLikeLine(text) {
 	const normalized = text.replace(/[│┃┆┊▏▕]/g, " ").trimStart();
 	if (normalized === "") return false;
@@ -1901,27 +1891,61 @@ function isCodeLikeText(text) {
 	return /[{}()[\];=<>]/.test(text) || /\b(?:async|await|class|const|def|export|from|function|if|import|interface|let|return|type|var)\b/.test(text) || /(?:^|\s)(?:--?[a-z][\w-]*|#[\w-]+|\/[A-Za-z0-9._/-]+)(?:\s|$)/.test(text);
 }
 function wrapStableLogicalLine(line, targetCols) {
-	if (cellsDisplayWidth(line.cells) <= targetCols) return [line];
+	const cols = Math.max(1, targetCols);
+	if (cellsDisplayWidth(line.cells) <= cols) return [line];
 	const rows = [];
-	let cells = [];
-	let cols = 0;
-	const flush = () => {
+	let remaining = [...line.cells];
+	while (remaining.length > 0) {
+		const chunk = [];
+		let usedCols = 0;
+		let consumed = 0;
+		for (const cell of remaining) {
+			if (chunk.length > 0 && usedCols + cell.width > cols) break;
+			chunk.push(cell);
+			usedCols += cell.width;
+			consumed += 1;
+			if (usedCols >= cols) break;
+		}
+		if (chunk.length === 0) {
+			chunk.push(remaining[0] ?? {
+				style: DEFAULT_STYLE,
+				text: "",
+				width: 1
+			});
+			consumed = 1;
+		}
+		let rowCells = chunk;
+		let nextRemaining = remaining.slice(consumed);
+		const breakIndex = findStableLineBreakIndex(chunk);
+		if (breakIndex > 0) {
+			rowCells = chunk.slice(0, breakIndex);
+			nextRemaining = [...chunk.slice(breakIndex + 1), ...nextRemaining];
+		}
 		rows.push({
-			cells,
+			cells: trimTrailingStableCells(rowCells),
 			live: line.live,
 			physicalRows: 1
 		});
-		cells = [];
-		cols = 0;
-	};
-	for (const cell of line.cells) {
-		if (cols > 0 && cols + cell.width > targetCols) flush();
-		cells.push(cell);
-		cols += cell.width;
-		if (cols >= targetCols) flush();
+		remaining = dropLeadingStableSpaces(nextRemaining);
 	}
-	if (cells.length > 0 || rows.length === 0) flush();
-	return rows;
+	return rows.length > 0 ? rows : [line];
+}
+function findStableLineBreakIndex(cells) {
+	for (let index = cells.length - 2; index > 0; index -= 1) {
+		const cell = cells[index];
+		if (cell?.text === " " && cell.width === 1) return index;
+	}
+	return -1;
+}
+function trimTrailingStableCells(cells) {
+	let end = cells.length;
+	while (end > 0 && cells[end - 1]?.text === " " && cells[end - 1]?.width === 1) end -= 1;
+	return cells.slice(0, end);
+}
+function dropLeadingStableSpaces(cells) {
+	let start = 0;
+	while (start < cells.length && cells[start]?.text === " " && cells[start]?.width === 1) start += 1;
+	return cells.slice(start);
 }
 function renderStableFrameRow(line, lineCols, lineIndex) {
 	return `<div class="${line.live ? "term-row" : "term-row term-scrollback-row"}"${line.live ? ` data-aitty-live-grid-row="${lineIndex + 1}"` : ""} data-aitty-line-cols="${lineCols}">${renderStableFrameCells(line.cells, lineCols)}</div>`;
@@ -2089,13 +2113,13 @@ async function writeArtifactViewerPages(result, options = {}) {
 		});
 	}
 	const domPreviewPathsBySnapshot = new Map(readableArtifacts.filter(({ artifact }) => artifact.kind === "dom").map(({ artifact }) => [artifactSnapshotKey(artifact), artifactDomPreviewPath(artifact)]));
-	const aittyAssets = domPreviewPathsBySnapshot.size > 0 ? prepareAittyReportAssets({
-		artifactsDir: result.artifactsDir,
-		flowPath: result.flowPath,
-		reportPath: result.reportPath
-	}) : null;
+	const aittyAssets = domPreviewPathsBySnapshot.size > 0 ? prepareAittyReportAssets({ artifactsDir: result.artifactsDir }) : null;
 	const writtenDomPreviewPaths = /* @__PURE__ */ new Set();
-	const ptyReplayStableFrame = aittyAssets ? await extractPtyReplayStableFrameForReport({
+	const usePtyReplayStableFrameDomPreview = shouldUsePtyReplayStableFrameDomPreview({
+		config: options.config,
+		flowName: result.name
+	});
+	const ptyReplayStableFrame = aittyAssets && usePtyReplayStableFrameDomPreview ? await extractPtyReplayStableFrameForReport({
 		config: options.config,
 		result
 	}) : null;
@@ -2888,15 +2912,101 @@ async function waitForStableDom(page, args) {
 	throw new Error(`timed out waiting for stable terminal DOM`);
 }
 async function readTerminalText(page) {
-	const text = await page.evaluate(() => {
+	const text = await readTerminalProjection(page, "text");
+	if (text === null) throw new Error("terminal root is not attached");
+	return text;
+}
+async function readTerminalLayout(page) {
+	const layout = await readTerminalProjection(page, "layout");
+	if (layout === null) throw new Error("terminal root is not attached");
+	return layout;
+}
+async function readTerminalProjection(page, mode) {
+	return page.evaluate((projectionMode) => {
 		const node = document.querySelector("[data-terminal-root]");
 		if (!node) return null;
 		const rows = Array.from(node.querySelectorAll(".term-grid .term-row"));
-		if (rows.length > 0) return rows.map((row) => row.textContent ?? "").join("\n");
-		return node.textContent ?? "";
-	});
-	if (text === null) throw new Error("terminal root is not attached");
-	return text;
+		if (projectionMode === "text") {
+			if (rows.length > 0) return rows.map((row) => serializeTerminalRowText(row)).join("\n");
+			return node.textContent ?? "";
+		}
+		return serializeTerminalLayout(node);
+		function serializeTerminalLayout(root) {
+			const grid = root.querySelector(".term-grid");
+			const target = grid ?? root;
+			const lines = [`# terminal-layout v1 cols=${readElementInteger(grid, "data-cols") ?? "unknown"} rows=${readElementInteger(grid, "data-rows") ?? "unknown"}`];
+			for (const child of Array.from(target.children)) serializeTerminalLayoutElement(child, "", lines);
+			return lines.join("\n");
+		}
+		function serializeTerminalLayoutElement(element, indent, lines) {
+			if (element.classList.contains("term-wide-row-block")) {
+				lines.push(`${indent}wide-block kind=${JSON.stringify(readWideBlockKind(element))} cols=${readWideBlockCols(element) ?? "unknown"}`);
+				for (const child of Array.from(element.children)) serializeTerminalLayoutElement(child, `${indent}  `, lines);
+				lines.push(`${indent}end-wide-block`);
+				return;
+			}
+			if (element.classList.contains("term-row")) {
+				lines.push(`${indent}row cols=${readElementInteger(element, "data-aitty-line-cols") ?? "unknown"} text=${JSON.stringify(serializeTerminalRowText(element))}`);
+				return;
+			}
+			for (const child of Array.from(element.children)) serializeTerminalLayoutElement(child, indent, lines);
+		}
+		function readWideBlockKind(element) {
+			if (!(element instanceof HTMLElement)) return "wide";
+			return element.dataset.aittyWideBlockKind || "wide";
+		}
+		function readWideBlockCols(element) {
+			if (!(element instanceof HTMLElement)) return null;
+			const styleCols = element.style.getPropertyValue("--aitty-wide-block-cols").trim();
+			const cols = Number.parseInt(styleCols, 10);
+			return Number.isFinite(cols) && cols > 0 ? cols : null;
+		}
+		function readElementInteger(element, attribute) {
+			const raw = element?.getAttribute(attribute) ?? "";
+			const value = Number.parseInt(raw, 10);
+			return Number.isFinite(value) && value >= 0 ? value : null;
+		}
+		function serializeTerminalRowText(row) {
+			let text = "";
+			for (const child of Array.from(row.childNodes)) text += serializeTerminalNodeText(child);
+			return text.trimEnd();
+		}
+		function serializeTerminalNodeText(node) {
+			if (node.nodeType === Node.TEXT_NODE) {
+				const text = normalizeTerminalTextSegment(node.textContent ?? "");
+				return text.trim().length === 0 ? "" : text;
+			}
+			if (!(node instanceof HTMLElement)) return "";
+			const text = normalizeTerminalTextSegment(node.textContent ?? "");
+			const cols = parseTerminalCellWidth(node);
+			if (cols === null) return text;
+			const width = terminalTextDisplayWidth(text);
+			const padding = Math.max(0, cols - width);
+			return text + " ".repeat(padding);
+		}
+		function normalizeTerminalTextSegment(text) {
+			return text.replace(/\u00a0/g, " ");
+		}
+		function parseTerminalCellWidth(element) {
+			const width = element.style.getPropertyValue("width");
+			if (/^var\(--term-cell-width\b/.test(width)) return 1;
+			const calcMatch = /calc\(\s*var\(--term-cell-width[^)]*\)\s*\*\s*(\d+(?:\.\d+)?)\s*\)/.exec(width);
+			if (!calcMatch) return null;
+			const cols = Number.parseFloat(calcMatch[1] ?? "");
+			return Number.isFinite(cols) && cols > 0 ? Math.round(cols) : null;
+		}
+		function terminalTextDisplayWidth(text) {
+			let width = 0;
+			for (const char of text) {
+				if (/[\u0300-\u036f]/u.test(char)) continue;
+				width += isWideTerminalChar(char) ? 2 : 1;
+			}
+			return width;
+		}
+		function isWideTerminalChar(char) {
+			return /[\u1100-\u115f\u2329\u232a\u2e80-\ua4cf\uac00-\ud7a3\uf900-\ufaff\ufe10-\ufe19\ufe30-\ufe6f\uff00-\uff60\uffe0-\uffe6]/u.test(char) || /\p{Extended_Pictographic}/u.test(char);
+		}
+	}, mode);
 }
 async function readTerminalDom(page) {
 	const dom = await readTerminalDomIfPresent(page);
@@ -2943,6 +3053,19 @@ async function captureSnapshotStep(ctx, step) {
 			});
 			continue;
 		}
+		if (target === "layout") {
+			const layout = normalizeTerminalText(await readTerminalLayout(ctx.page), ctx.masks);
+			await writeComparableArtifact(ctx, {
+				name: step.name,
+				kind: "layout",
+				relativePath: `${base}.layout.txt`,
+				baselineRelativePath: `${base}.layout.snap.txt`,
+				diffRelativePath: `${base}.layout.diff.txt`,
+				content: layout + "\n",
+				compare: step.compare ?? true
+			});
+			continue;
+		}
 		const screenshotPath = join(ctx.artifactsDir, `${base}.png`);
 		await ctx.page.screenshot({
 			path: screenshotPath,
@@ -3102,7 +3225,7 @@ async function captureCassetteFrame(ctx, frame) {
 		stepIndex: frame.stepIndex,
 		stepType: frame.stepType,
 		terminalText: normalizeTerminalText(await readTerminalText(ctx.page), ctx.masks),
-		dom: normalizeDomSnapshot(await readTerminalDom(ctx.page), ctx.masks),
+		dom: normalizeReplayDom(await readTerminalDom(ctx.page), ctx.masks),
 		capturedAt: (/* @__PURE__ */ new Date()).toISOString()
 	});
 }

package/dist/{server-COuf3mW7.mjs → server-B4Bbuluz.mjs}

@@ -144,7 +144,7 @@ var ScriptRecordingManager = class {
 };
 //#endregion
 //#region package.json
-var version = "0.6.1";
+var version = "0.6.3";
 //#endregion
 //#region src/mcp/tool_result.ts
 function toolError(message, extra = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ptywright",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Terminal/TUI automation driver over PTY + xterm, exposed as MCP tools",
   "keywords": [
     "agent",

package/schemas/ptywright-agent-manifest.schema.json

@@ -93,6 +93,7 @@
             "report",
             "terminal",
             "dom",
+            "layout",
             "screenshot",
             "diff"
           ]

package/schemas/ptywright-agent-replay-summary.schema.json

@@ -129,7 +129,7 @@
       "properties": {
         "name": { "type": "string", "minLength": 1 },
         "viewport": { "type": "string", "minLength": 1 },
-        "kind": { "type": "string", "enum": ["terminal", "dom", "screenshot"] },
+        "kind": { "type": "string", "enum": ["terminal", "dom", "layout", "screenshot"] },
         "path": { "type": "string", "minLength": 1 },
         "baselinePath": { "type": "string", "minLength": 1 },
         "diffPath": { "type": "string", "minLength": 1 },

package/schemas/ptywright-agent-run.schema.json

@@ -113,7 +113,7 @@
       "properties": {
         "name": { "type": "string", "minLength": 1 },
         "viewport": { "type": "string", "minLength": 1 },
-        "kind": { "type": "string", "enum": ["terminal", "dom", "screenshot"] },
+        "kind": { "type": "string", "enum": ["terminal", "dom", "layout", "screenshot"] },
         "path": { "type": "string", "minLength": 1 },
         "baselinePath": { "type": "string", "minLength": 1 },
         "diffPath": { "type": "string", "minLength": 1 },

package/schemas/ptywright-agent.schema.json

@@ -123,7 +123,7 @@
               "compare": { "type": "boolean" },
               "targets": {
                 "type": "array",
-                "items": { "type": "string", "enum": ["terminal", "dom", "screenshot"] }
+                "items": { "type": "string", "enum": ["terminal", "dom", "layout", "screenshot"] }
               },
               "fullPage": { "type": "boolean" }
             }