pi-studio 0.9.17 → 0.9.19

package/index.ts

@@ -162,6 +162,7 @@ interface PreparedStudioPdfExport {
 	createdAt: number;
 	filePath?: string;
 	tempDirPath?: string;
+	persistent?: boolean;
 }
 
 interface PreparedStudioHtmlExport {
@@ -171,6 +172,7 @@ interface PreparedStudioHtmlExport {
 	createdAt: number;
 	filePath?: string;
 	tempDirPath?: string;
+	persistent?: boolean;
 }
 
 interface StudioHtmlAnnotationPlaceholder {
@@ -255,6 +257,7 @@ interface StudioTraceToolEntry {
 	toolName: string;
 	label: string | null;
 	argsSummary: string | null;
+	args: string | null;
 	output: string;
 	images: StudioTraceImage[];
 	startedAt: number;
@@ -427,6 +430,7 @@ interface SaveOverRequestMessage {
 interface RefreshFromDiskRequestMessage {
 	type: "refresh_from_disk_request";
 	requestId: string;
+	path?: string;
 }
 
 interface SendToEditorRequestMessage {
@@ -515,6 +519,7 @@ const MAX_PREPARED_PDF_EXPORTS = 8;
 const MAX_PREPARED_HTML_EXPORTS = 8;
 const STUDIO_TRACE_SNAPSHOT_MAX_ENTRIES = 80;
 const STUDIO_TRACE_SNAPSHOT_MAX_FIELD_CHARS = 20_000;
+const STUDIO_TRACE_TOOL_ARGS_MAX_CHARS = 20_000;
 const STUDIO_TRACE_IMAGE_MAX_COUNT = 8;
 const STUDIO_TRACE_IMAGE_MAX_BASE64_CHARS = 2_500_000;
 const STUDIO_TRACE_SNAPSHOT_MAX_IMAGES = 12;
@@ -2257,6 +2262,8 @@ function inferStudioPdfLanguageFromPath(pathInput: string): string | undefined {
 		".yml": "yaml",
 		".toml": "toml",
 		".lua": "lua",
+		".csv": "csv",
+		".tsv": "tsv",
 		".txt": "text",
 		".rst": "text",
 		".adoc": "text",
@@ -2299,6 +2306,33 @@ function buildStudioResponseExportOutputPath(cwd: string, extension: "pdf" | "ht
 	return join(cwd || process.cwd(), `studio-response-${formatStudioExportTimestamp()}.studio.${extension}`);
 }
 
+function buildStudioPreviewExportPath(sourcePath: string | undefined, resourceDir: string | undefined, fallbackCwd: string, filename: string): string | null {
+	const cleanFilename = String(filename || "").trim();
+	if (!cleanFilename) return null;
+	const source = typeof sourcePath === "string" ? sourcePath.trim() : "";
+	if (source) {
+		const expanded = recoverLikelyDroppedLeadingSlashPath(expandHome(source));
+		return join(dirname(isAbsolute(expanded) ? expanded : resolve(fallbackCwd, expanded)), cleanFilename);
+	}
+	const resource = normalizeStudioResourceDirectoryInput(typeof resourceDir === "string" ? resourceDir : "");
+	if (resource) {
+		const expanded = recoverLikelyDroppedLeadingSlashPath(expandHome(resource));
+		return join(isAbsolute(expanded) ? expanded : resolve(fallbackCwd, expanded), cleanFilename);
+	}
+	return join(fallbackCwd || process.cwd(), cleanFilename);
+}
+
+function writeStudioPreviewExportFile(path: string | null, data: Buffer): { filePath: string | null; error: string | null } {
+	if (!path) return { filePath: null, error: "No export path was resolved." };
+	try {
+		mkdirSync(dirname(path), { recursive: true });
+		writeFileSync(path, data);
+		return { filePath: path, error: null };
+	} catch (error) {
+		return { filePath: null, error: error instanceof Error ? error.message : String(error) };
+	}
+}
+
 function writeStudioFile(pathArg: string, cwd: string, content: string):
 	| { ok: true; label: string; resolvedPath: string }
 	| { ok: false; message: string } {
@@ -2466,6 +2500,7 @@ const STUDIO_LOCAL_LINK_TEXT_EXTENSIONS = new Set([
 	".diff", ".patch",
 ]);
 const STUDIO_LOCAL_LINK_IMAGE_EXTENSIONS = new Set([".png", ".jpg", ".jpeg", ".gif", ".webp"]);
+const STUDIO_LOCAL_LINK_OFFICE_EXTENSIONS = new Set([".docx", ".odt"]);
 const STUDIO_LOCAL_LINK_TEXT_FILENAMES = new Set([
 	".dockerignore", ".editorconfig", ".env", ".env.example", ".eslintignore", ".gitattributes",
 	".gitignore", ".gitmodules", ".npmignore", ".prettierignore", "dockerfile", "gemfile",
@@ -2477,7 +2512,7 @@ const STUDIO_FILE_BROWSER_IGNORED_DIRS = new Set([
 	"__pycache__", ".venv", "venv", ".mypy_cache", ".pytest_cache", ".ruff_cache",
 ]);
 
-type StudioLocalPreviewResourceKind = "pdf" | "text" | "image" | "other";
+type StudioLocalPreviewResourceKind = "pdf" | "text" | "image" | "office" | "other";
 
 interface StudioLocalPreviewResource {
 	filePath: string;
@@ -2573,6 +2608,7 @@ function getStudioLocalPreviewResourceKind(extension: string, filePathOrName?: s
 	if (ext === ".pdf") return "pdf";
 	if (STUDIO_LOCAL_LINK_TEXT_EXTENSIONS.has(ext) || STUDIO_LOCAL_LINK_TEXT_FILENAMES.has(name)) return "text";
 	if (STUDIO_LOCAL_LINK_IMAGE_EXTENSIONS.has(ext)) return "image";
+	if (STUDIO_LOCAL_LINK_OFFICE_EXTENSIONS.has(ext)) return "office";
 	return "other";
 }
 
@@ -4304,6 +4340,125 @@ function wrapStudioCodeAsMarkdown(code: string, language?: string): string {
 	return `${marker}${lang}\n${source}\n${marker}`;
 }
 
+const STUDIO_DELIMITED_PREVIEW_MAX_DATA_ROWS = 200;
+const STUDIO_DELIMITED_PREVIEW_MAX_COLUMNS = 50;
+const STUDIO_DELIMITED_PREVIEW_MAX_CELL_CHARS = 500;
+
+function getStudioDelimitedTextConfig(language?: string): { label: string; delimiter: string } | null {
+	const normalized = normalizeStudioEditorLanguage(language);
+	if (normalized === "csv") return { label: "CSV", delimiter: "," };
+	if (normalized === "tsv") return { label: "TSV", delimiter: "\t" };
+	return null;
+}
+
+function parseStudioDelimitedTextRows(text: string, delimiter: string, maxRows: number): { rows: string[][]; truncatedRows: boolean } {
+	const source = String(text ?? "").replace(/^\uFEFF/, "");
+	const limit = Math.max(1, Math.floor(maxRows));
+	const rows: string[][] = [];
+	let row: string[] = [];
+	let cell = "";
+	let inQuotes = false;
+	let truncatedRows = false;
+
+	const pushCell = () => {
+		row.push(cell);
+		cell = "";
+	};
+	const pushRow = (index: number): boolean => {
+		pushCell();
+		rows.push(row);
+		row = [];
+		if (rows.length >= limit) {
+			truncatedRows = index < source.length - 1;
+			return true;
+		}
+		return false;
+	};
+
+	for (let i = 0; i < source.length; i += 1) {
+		if (rows.length >= limit) {
+			truncatedRows = true;
+			break;
+		}
+		const ch = source[i];
+		if (inQuotes) {
+			if (ch === '"') {
+				if (source[i + 1] === '"') {
+					cell += '"';
+					i += 1;
+				} else {
+					inQuotes = false;
+				}
+			} else {
+				cell += ch;
+			}
+			continue;
+		}
+		if (ch === '"' && cell === "") {
+			inQuotes = true;
+			continue;
+		}
+		if (ch === delimiter) {
+			pushCell();
+			continue;
+		}
+		if (ch === "\n") {
+			if (pushRow(i)) break;
+			continue;
+		}
+		if (ch === "\r") {
+			if (source[i + 1] === "\n") i += 1;
+			if (pushRow(i)) break;
+			continue;
+		}
+		cell += ch;
+	}
+
+	if (!truncatedRows && rows.length < limit && (cell.length > 0 || row.length > 0)) {
+		pushCell();
+		rows.push(row);
+	}
+
+	return { rows, truncatedRows };
+}
+
+function formatStudioDelimitedMarkdownCell(value: string | undefined): string {
+	const raw = String(value ?? "").replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+	const shortened = raw.length > STUDIO_DELIMITED_PREVIEW_MAX_CELL_CHARS
+		? `${raw.slice(0, STUDIO_DELIMITED_PREVIEW_MAX_CELL_CHARS)}…`
+		: raw;
+	return shortened.replace(/\n/g, "<br>").replace(/\|/g, "\\|").trim() || " ";
+}
+
+function formatStudioDelimitedTextAsMarkdown(text: string, language?: string): string | null {
+	const config = getStudioDelimitedTextConfig(language);
+	if (!config) return null;
+	const parsed = parseStudioDelimitedTextRows(text, config.delimiter, STUDIO_DELIMITED_PREVIEW_MAX_DATA_ROWS + 1);
+	const rows = parsed.rows;
+	if (!rows.length) return `_${config.label} file has no tabular data to preview._`;
+	const rawColumnCount = rows.reduce((max, row) => Math.max(max, row.length), 0);
+	const columnCount = Math.min(rawColumnCount, STUDIO_DELIMITED_PREVIEW_MAX_COLUMNS);
+	if (columnCount <= 0) return `_${config.label} file has no tabular data to preview._`;
+	const header = rows[0] ?? [];
+	const dataRows = rows.slice(1);
+	const columnIndexes = Array.from({ length: columnCount }, (_value, index) => index);
+	const lines: string[] = [`**${config.label} preview**`, ""];
+	const notices: string[] = [];
+	if (parsed.truncatedRows) notices.push(`showing first ${Math.max(0, dataRows.length)} data rows`);
+	if (rawColumnCount > columnCount) notices.push(`showing first ${columnCount} of ${rawColumnCount} columns`);
+	if (notices.length) lines.push(`_${notices.join("; ")}._`, "");
+	lines.push(`| ${columnIndexes.map((index) => formatStudioDelimitedMarkdownCell(header[index] || `Column ${index + 1}`)).join(" | ")} |`);
+	lines.push(`| ${columnIndexes.map(() => "---").join(" | ")} |`);
+	if (dataRows.length) {
+		dataRows.forEach((row) => {
+			lines.push(`| ${columnIndexes.map((index) => formatStudioDelimitedMarkdownCell(row[index])).join(" | ")} |`);
+		});
+	} else {
+		lines.push(`| ${columnIndexes.map(() => " ").join(" | ")} |`);
+	}
+	return lines.join("\n");
+}
+
 function extractStudioFenceInfoLanguage(info: string): string | undefined {
 	const firstToken = String(info ?? "").trim().split(/\s+/)[0]?.replace(/^\./, "") ?? "";
 	return normalizeStudioEditorLanguage(firstToken || undefined);
@@ -5254,11 +5409,13 @@ function buildStudioLiteralTextPdfTexConfig(options?: StudioPdfRenderOptions): {
 
 function prepareStudioPdfMarkdown(markdown: string, isLatex?: boolean, editorLanguage?: string): string {
 	if (isLatex) return markdown;
-	const effectiveEditorLanguage = inferStudioPdfLanguage(markdown, editorLanguage);
+	const delimitedMarkdown = formatStudioDelimitedTextAsMarkdown(markdown, editorLanguage);
+	const input = delimitedMarkdown ?? markdown;
+	const effectiveEditorLanguage = delimitedMarkdown ? "markdown" : inferStudioPdfLanguage(input, editorLanguage);
 	const source = effectiveEditorLanguage && effectiveEditorLanguage !== "markdown" && effectiveEditorLanguage !== "latex"
-		&& !isStudioSingleFencedCodeBlock(markdown)
-		? wrapStudioCodeAsMarkdown(markdown, effectiveEditorLanguage)
-		: markdown;
+		&& !isStudioSingleFencedCodeBlock(input)
+		? wrapStudioCodeAsMarkdown(input, effectiveEditorLanguage)
+		: input;
 	const annotationReadySource = !effectiveEditorLanguage || effectiveEditorLanguage === "markdown" || effectiveEditorLanguage === "latex"
 		? replaceStudioAnnotationMarkersForPdf(source)
 		: source;
@@ -5979,17 +6136,19 @@ async function renderStudioStandaloneHtmlWithPandoc(
 	sourcePath?: string,
 	options?: StudioHtmlRenderOptions,
 ): Promise<{ html: Buffer; warning?: string }> {
-	const effectiveEditorLanguage = inferStudioPdfLanguage(markdown, editorLanguage);
-	if (!isLatex && isLikelyStandaloneStudioHtml(markdown, effectiveEditorLanguage)) {
-		return { html: Buffer.from(String(markdown ?? ""), "utf-8") };
+	const delimitedMarkdown = isLatex ? null : formatStudioDelimitedTextAsMarkdown(markdown, editorLanguage);
+	const input = delimitedMarkdown ?? markdown;
+	const effectiveEditorLanguage = delimitedMarkdown ? "markdown" : inferStudioPdfLanguage(input, editorLanguage);
+	if (!isLatex && isLikelyStandaloneStudioHtml(input, effectiveEditorLanguage)) {
+		return { html: Buffer.from(String(input ?? ""), "utf-8") };
 	}
 	const source = !isLatex
 		&& effectiveEditorLanguage
 		&& effectiveEditorLanguage !== "markdown"
 		&& effectiveEditorLanguage !== "latex"
-		&& !isStudioSingleFencedCodeBlock(markdown)
-		? wrapStudioCodeAsMarkdown(markdown, effectiveEditorLanguage)
-		: markdown;
+		&& !isStudioSingleFencedCodeBlock(input)
+		? wrapStudioCodeAsMarkdown(input, effectiveEditorLanguage)
+		: input;
 	const annotationPrepared = prepareStudioAnnotationMarkersForHtml(source);
 	const pdfPrepared = prepareStudioPdfBlocksForHtml(annotationPrepared.markdown);
 	let renderedHtml = await renderStudioMarkdownWithPandoc(pdfPrepared.markdown, isLatex, resourcePath, sourcePath);
@@ -6660,7 +6819,74 @@ function respondHtmlPreviewResourceJson(req: IncomingMessage, res: ServerRespons
 	});
 }
 
-function respondLocalPreviewLinkJson(req: IncomingMessage, res: ServerResponse, requestUrl: URL, resource: StudioLocalPreviewResource, serverState: StudioServerState): void {
+function formatStudioMarkdownAngleTarget(pathText: string): string {
+	return `<${String(pathText || "").replace(/>/g, "%3E")}>`;
+}
+
+function sanitizeStudioPreviewBlockLine(value: string): string {
+	return String(value || "").replace(/[\r\n]+/g, " ").trim();
+}
+
+function buildStudioLocalResourcePreviewDocument(resource: StudioLocalPreviewResource): InitialStudioDocument {
+	const label = basename(resource.filePath) || resource.label || "local preview";
+	const resourcePath = resource.label || basename(resource.filePath) || resource.filePath;
+	const title = sanitizeStudioPreviewBlockLine(label);
+	let text = "";
+	if (resource.kind === "pdf") {
+		text = "```studio-pdf\n"
+			+ `path: ${sanitizeStudioPreviewBlockLine(resourcePath)}\n`
+			+ `title: ${title || "PDF preview"}\n`
+			+ "height: 820\n"
+			+ "```\n";
+	} else if (resource.kind === "image") {
+		text = `![${title || "Image preview"}](${formatStudioMarkdownAngleTarget(resourcePath)})\n`;
+	} else {
+		throw new Error("This local resource cannot be opened as a preview document.");
+	}
+	return {
+		text,
+		label: `${label} preview`,
+		source: "blank",
+		resourceDir: resource.resourceDir,
+	};
+}
+
+function getStudioOfficePandocInputFormat(extension: string): string {
+	const ext = String(extension || "").toLowerCase();
+	if (ext === ".docx") return "docx";
+	if (ext === ".odt") return "odt";
+	return ext.replace(/^\./, "") || "docx";
+}
+
+async function convertStudioOfficeDocumentToMarkdown(resource: StudioLocalPreviewResource): Promise<{ text: string; label: string }> {
+	if (resource.kind !== "office") throw new Error("This local resource is not a supported convertible document.");
+	const pandocCommand = process.env.PANDOC_PATH?.trim() || "pandoc";
+	const inputFormat = getStudioOfficePandocInputFormat(resource.extension);
+	const result = await runStudioSubprocess(pandocCommand, [
+		"-f", inputFormat,
+		"-t", "markdown",
+		"--wrap=none",
+		resource.filePath,
+	], {
+		cwd: dirname(resource.filePath),
+		timeoutMs: STUDIO_PANDOC_TIMEOUT_MS,
+		stdoutMaxBytes: STUDIO_SUBPROCESS_OUTPUT_MAX_BYTES,
+		label: "pandoc document conversion",
+		notFoundMessage: "pandoc was not found. Install pandoc or set PANDOC_PATH to convert DOCX/ODT documents in Studio.",
+	});
+	if (result.code !== 0) {
+		throw new Error(`pandoc failed with exit code ${result.code}${result.stderr ? `: ${result.stderr}` : ""}`);
+	}
+	if (result.stdoutTruncated) {
+		throw new Error("Converted document exceeded Studio's import size limit.");
+	}
+	const label = `converted: ${resource.label || basename(resource.filePath) || "document"}`;
+	const note = `<!-- ${label} from ${resource.filePath}. This is a Markdown conversion; saving will not update the original ${resource.extension || "document"} file. -->`;
+	const body = result.stdout.trim();
+	return { text: `${note}\n\n${body}\n`, label };
+}
+
+async function respondLocalPreviewLinkJson(req: IncomingMessage, res: ServerResponse, requestUrl: URL, resource: StudioLocalPreviewResource, serverState: StudioServerState): Promise<void> {
 	const method = (req.method ?? "GET").toUpperCase();
 	if (method !== "GET" && method !== "HEAD") {
 		res.setHeader("Allow", "GET, HEAD");
@@ -6684,32 +6910,72 @@ function respondLocalPreviewLinkJson(req: IncomingMessage, res: ServerResponse,
 		return;
 	}
 
+	if (action === "preview-url") {
+		if (resource.kind !== "pdf" && resource.kind !== "image") {
+			respondJson(res, 400, { ok: false, error: "This local resource cannot be opened in a Studio preview tab." });
+			return;
+		}
+		const document = buildStudioLocalResourcePreviewDocument(resource);
+		const docId = storeTransientStudioDocument(document);
+		const url = buildStudioUrl(serverState.port, serverState.token, "editor-only", document, docId);
+		const parsedUrl = new URL(url);
+		respondJson(res, 200, {
+			...basePayload,
+			url,
+			relativeUrl: `${parsedUrl.pathname}${parsedUrl.search}`,
+		});
+		return;
+	}
+
 	if (action !== "document" && action !== "editor-url") {
 		respondJson(res, 400, { ok: false, error: "Unsupported local link action." });
 		return;
 	}
-	if (resource.kind !== "text") {
-		respondJson(res, 400, { ok: false, error: "This local resource is not a text document Studio can load into the editor." });
+	if (resource.kind !== "text" && resource.kind !== "office") {
+		respondJson(res, 400, { ok: false, error: "This local resource is not a document Studio can load into the editor." });
 		return;
 	}
 
-	const file = readStudioFile(resource.filePath, dirname(resource.filePath));
-	if (file.ok === false) {
-		respondJson(res, 400, { ok: false, error: file.message });
-		return;
+	let document: InitialStudioDocument;
+	let responseText = "";
+	let converted = false;
+	if (resource.kind === "office") {
+		let conversion: { text: string; label: string };
+		try {
+			conversion = await convertStudioOfficeDocumentToMarkdown(resource);
+		} catch (error) {
+			respondJson(res, 400, { ok: false, error: `Document conversion failed: ${error instanceof Error ? error.message : String(error)}` });
+			return;
+		}
+		converted = true;
+		responseText = conversion.text;
+		document = {
+			text: conversion.text,
+			label: conversion.label,
+			source: "blank",
+			resourceDir: resource.resourceDir,
+		};
+	} else {
+		const file = readStudioFile(resource.filePath, dirname(resource.filePath));
+		if (file.ok === false) {
+			respondJson(res, 400, { ok: false, error: file.message });
+			return;
+		}
+		responseText = file.text;
+		document = {
+			text: file.text,
+			label: resource.label || file.label,
+			source: "file",
+			path: file.resolvedPath,
+			resourceDir: resource.resourceDir,
+		};
 	}
-
-	const document: InitialStudioDocument = {
-		text: file.text,
-		label: resource.label || file.label,
-		source: "file",
-		path: file.resolvedPath,
-		resourceDir: resource.resourceDir,
-	};
 	if (action === "document") {
 		respondJson(res, 200, {
 			...basePayload,
-			text: file.text,
+			text: responseText,
+			label: document.label,
+			converted,
 			resourceDir: resource.resourceDir,
 		});
 		return;
@@ -6720,6 +6986,7 @@ function respondLocalPreviewLinkJson(req: IncomingMessage, res: ServerResponse,
 	const parsedUrl = new URL(url);
 	respondJson(res, 200, {
 		...basePayload,
+		converted,
 		url,
 		relativeUrl: `${parsedUrl.pathname}${parsedUrl.search}`,
 	});
@@ -7876,10 +8143,15 @@ function parseIncomingMessage(data: RawData): IncomingStudioMessage | null {
 		};
 	}
 
-	if (msg.type === "refresh_from_disk_request" && typeof msg.requestId === "string") {
+	if (
+		msg.type === "refresh_from_disk_request"
+		&& typeof msg.requestId === "string"
+		&& (msg.path === undefined || typeof msg.path === "string")
+	) {
 		return {
 			type: "refresh_from_disk_request",
 			requestId: msg.requestId,
+			path: typeof msg.path === "string" ? msg.path : undefined,
 		};
 	}
 
@@ -8303,15 +8575,17 @@ function createStudioTraceSnapshot(source: StudioTraceState): { traceState: Stud
 			};
 		}
 		const argsSummary = truncateStudioTraceSnapshotText(entry.argsSummary ?? "");
+		const args = truncateStudioTraceSnapshotText(entry.args ?? entry.argsSummary ?? "");
 		const output = truncateStudioTraceSnapshotText(entry.output);
 		const snapshotImages = copyStudioTraceImagesForSnapshot(entry.images, imageBudget);
-		truncated = truncated || argsSummary.truncated || output.truncated || snapshotImages.omitted > 0;
+		truncated = truncated || argsSummary.truncated || args.truncated || output.truncated || snapshotImages.omitted > 0;
 		const omittedImageNote = snapshotImages.omitted > 0
 			? `[${snapshotImages.omitted} image preview${snapshotImages.omitted === 1 ? "" : "s"} omitted from saved Working view to keep history bounded.]`
 			: "";
 		return {
 			...entry,
 			argsSummary: argsSummary.text || null,
+			args: args.text || null,
 			output: [output.text, omittedImageNote].filter(Boolean).join("\n"),
 			images: snapshotImages.images,
 		};
@@ -8522,6 +8796,34 @@ function summarizeStudioTraceToolArgs(toolName: string, args: unknown): string |
 	}
 }
 
+function truncateStudioTraceToolArgs(text: string): string {
+	const value = sanitizeStudioTraceOutputText(String(text || "").trim());
+	if (!value || value.length <= STUDIO_TRACE_TOOL_ARGS_MAX_CHARS) return value;
+	const keepHead = Math.max(1_000, Math.floor(STUDIO_TRACE_TOOL_ARGS_MAX_CHARS * 0.65));
+	const keepTail = Math.max(1_000, STUDIO_TRACE_TOOL_ARGS_MAX_CHARS - keepHead - 160);
+	const omitted = value.length - keepHead - keepTail;
+	return `${value.slice(0, keepHead)}\n\n… ${omitted} chars omitted from tool input …\n\n${value.slice(value.length - keepTail)}`;
+}
+
+function formatStudioTraceToolArgs(toolName: string, args: unknown): string | null {
+	const normalizedTool = String(toolName || "").trim().toLowerCase();
+	const payload = (args && typeof args === "object") ? (args as Record<string, unknown>) : {};
+	let raw = "";
+	if (normalizedTool === "bash" && typeof payload.command === "string") {
+		raw = payload.command;
+	} else if ((normalizedTool === "repl_send" || normalizedTool === "studio_repl_send") && typeof payload.code === "string") {
+		raw = payload.code;
+	} else {
+		try {
+			raw = JSON.stringify(args, null, 2);
+		} catch {
+			raw = String(args ?? "");
+		}
+	}
+	const truncated = truncateStudioTraceToolArgs(raw);
+	return truncated ? truncated : null;
+}
+
 function isStudioReplRuntime(value: unknown): value is StudioReplRuntime {
 	return value === "shell"
 		|| value === "python"
@@ -9563,7 +9865,7 @@ ${cssVarsBlock}
       <button id="saveOverBtn" type="button" title="Overwrite current file with editor content. Shortcut: Cmd/Ctrl+S.">Save editor</button>
       <button id="refreshFromDiskBtn" type="button" title="Reload the current file-backed document from disk.">Refresh from disk</button>
       <button id="clearWorkspaceBtn" type="button" title="Clear editor text and reset this tab to a fresh blank draft. Saved files and responses are not changed.">Reset editor</button>
-      <label class="file-label" title="Load a local file into editor text.">Load file content<input id="fileInput" type="file" accept=".md,.markdown,.mdx,.qmd,.js,.mjs,.cjs,.jsx,.ts,.mts,.cts,.tsx,.py,.pyw,.sh,.bash,.zsh,.json,.jsonc,.json5,.rs,.c,.h,.cpp,.cxx,.cc,.hpp,.hxx,.jl,.f90,.f95,.f03,.f,.for,.r,.R,.m,.tex,.latex,.diff,.patch,.java,.go,.rb,.swift,.html,.htm,.css,.xml,.yaml,.yml,.toml,.lua,.txt,.rst,.adoc" /></label>
+      <label class="file-label" title="Import a browser-selected text file into the editor as an unsaved copy. It will not be refreshable from disk until you save it.">Import file copy…<input id="fileInput" type="file" accept=".md,.markdown,.mdx,.qmd,.js,.mjs,.cjs,.jsx,.ts,.mts,.cts,.tsx,.py,.pyw,.sh,.bash,.zsh,.json,.jsonc,.json5,.rs,.c,.h,.cpp,.cxx,.cc,.hpp,.hxx,.jl,.f90,.f95,.f03,.f,.for,.r,.R,.m,.tex,.latex,.diff,.patch,.java,.go,.rb,.swift,.html,.htm,.css,.xml,.yaml,.yml,.toml,.lua,.txt,.rst,.adoc" /></label>
       <button id="loadGitDiffBtn" type="button" title="Load the current git diff from the Studio context into the editor.">Load git diff</button>
       <button id="getEditorBtn" type="button" title="Load the current terminal editor draft into Studio.">Load from pi editor</button>
       <button id="zenModeBtn" class="zen-mode-btn" type="button" title="Hide secondary Studio controls. Shortcut: F9.">Zen</button>
@@ -9644,6 +9946,7 @@ ${cssVarsBlock}
                 <option value="c">Syntax highlight: C</option>
                 <option value="cpp">Syntax highlight: C++</option>
                 <option value="css">Syntax highlight: CSS</option>
+                <option value="csv">Syntax highlight: CSV</option>
                 <option value="diff">Syntax highlight: Diff</option>
                 <option value="fortran">Syntax highlight: Fortran</option>
                 <option value="go">Syntax highlight: Go</option>
@@ -9662,6 +9965,7 @@ ${cssVarsBlock}
                 <option value="rust">Syntax highlight: Rust</option>
                 <option value="swift">Syntax highlight: Swift</option>
                 <option value="toml">Syntax highlight: TOML</option>
+                <option value="tsv">Syntax highlight: TSV</option>
                 <option value="typescript">Syntax highlight: TypeScript</option>
                 <option value="xml">Syntax highlight: XML</option>
                 <option value="yaml">Syntax highlight: YAML</option>
@@ -9847,11 +10151,11 @@ ${cssVarsBlock}
       <div class="shortcuts-header">
         <div>
           <h2 id="shortcutsTitle">Keyboard shortcuts</h2>
-          <p class="shortcuts-description">Studio navigation and high-frequency actions.</p>
+          <p class="shortcuts-description">Studio navigation and high-frequency actions. Use arrow keys, Page Up/Down, Home/End, or mouse/trackpad to scroll.</p>
         </div>
         <button id="shortcutsCloseBtn" class="shortcuts-close-btn" type="button" aria-label="Close keyboard shortcuts">Close</button>
       </div>
-      <div class="shortcuts-body">
+      <div id="shortcutsBody" class="shortcuts-body" tabindex="0" aria-label="Keyboard shortcuts list">
         <section class="shortcuts-group">
           <h3>Navigation</h3>
           <dl>
@@ -10774,7 +11078,17 @@ export default function (pi: ExtensionAPI) {
 		const existingId = studioTraceToolEntryIds.get(toolCallId);
 		if (existingId) {
 			const existing = studioTraceState.entries.find((entry) => entry.id === existingId);
-			if (existing && existing.type === "tool") return existing;
+			if (existing && existing.type === "tool") {
+				if (args !== undefined) {
+					existing.toolName = toolName;
+					existing.label = deriveToolActivityLabel(toolName, args);
+					existing.argsSummary = summarizeStudioTraceToolArgs(toolName, args);
+					existing.args = formatStudioTraceToolArgs(toolName, args);
+					existing.updatedAt = Date.now();
+					upsertStudioTraceEntry(existing);
+				}
+				return existing;
+			}
 		}
 		if (studioTraceState.runId == null || studioTraceState.status === "idle") {
 			resetStudioTraceForRun();
@@ -10787,6 +11101,7 @@ export default function (pi: ExtensionAPI) {
 			toolName,
 			label: deriveToolActivityLabel(toolName, args),
 			argsSummary: summarizeStudioTraceToolArgs(toolName, args),
+			args: formatStudioTraceToolArgs(toolName, args),
 			output: "",
 			images: [],
 			startedAt: now,
@@ -10809,6 +11124,8 @@ export default function (pi: ExtensionAPI) {
 		images?: StudioTraceImage[],
 	) => {
 		const entry = ensureStudioTraceToolEntry(toolCallId, toolName, args);
+		if (!entry.argsSummary) entry.argsSummary = summarizeStudioTraceToolArgs(toolName, args);
+		if (!entry.args) entry.args = formatStudioTraceToolArgs(toolName, args);
 		entry.output = output;
 		if (Array.isArray(images)) entry.images = images;
 		entry.status = status;
@@ -11959,16 +12276,18 @@ export default function (pi: ExtensionAPI) {
 				sendToClient(client, { type: "busy", requestId: msg.requestId, message: "Studio is busy." });
 				return;
 			}
-			if (!initialStudioDocument || !initialStudioDocument.path) {
+			const requestedPath = typeof msg.path === "string" && msg.path.trim() ? msg.path.trim() : "";
+			const refreshPath = requestedPath || initialStudioDocument?.path || "";
+			if (!refreshPath) {
 				sendToClient(client, {
 					type: "error",
 					requestId: msg.requestId,
-					message: "Refresh from disk is only available for file-backed documents.",
+					message: "Refresh from disk needs a file path. Use Files → Open here, Files → Open file tab, or /studio-editor-only <path> for a refreshable editor tab.",
 				});
 				return;
 			}
 
-			const refreshed = readStudioFile(initialStudioDocument.path, studioCwd);
+			const refreshed = readStudioFile(refreshPath, studioCwd);
 			if (refreshed.ok === false) {
 				sendToClient(client, {
 					type: "error",
@@ -11978,18 +12297,21 @@ export default function (pi: ExtensionAPI) {
 				return;
 			}
 
-			initialStudioDocument = {
+			const refreshedDocument: InitialStudioDocument = {
 				text: refreshed.text,
 				label: refreshed.label,
 				source: "file",
 				path: refreshed.resolvedPath,
 				resourceDir: dirname(refreshed.resolvedPath),
 			};
+			if (!requestedPath || initialStudioDocument?.path === refreshed.resolvedPath) {
+				initialStudioDocument = refreshedDocument;
+			}
 
-			broadcast({
+			sendToClient(client, {
 				type: "studio_document",
 				requestId: msg.requestId,
-				document: initialStudioDocument,
+				document: refreshedDocument,
 				message: `Reloaded ${refreshed.label} from disk.`,
 			});
 			return;
@@ -12073,6 +12395,7 @@ export default function (pi: ExtensionAPI) {
 	};
 
 	const disposePreparedPdfExport = (entry: PreparedStudioPdfExport | null | undefined) => {
+		if (entry?.persistent) return;
 		if (!entry?.tempDirPath) return;
 		void rm(entry.tempDirPath, { recursive: true, force: true }).catch(() => undefined);
 	};
@@ -12101,7 +12424,7 @@ export default function (pi: ExtensionAPI) {
 		}
 	};
 
-	const storePreparedPdfExport = (pdf: Buffer, filename: string, warning?: string): string => {
+	const storePreparedPdfExport = (pdf: Buffer, filename: string, warning?: string, filePath?: string): string => {
 		prunePreparedPdfExports();
 		const exportId = randomUUID();
 		preparedPdfExports.set(exportId, {
@@ -12109,6 +12432,8 @@ export default function (pi: ExtensionAPI) {
 			filename,
 			warning,
 			createdAt: Date.now(),
+			filePath,
+			persistent: Boolean(filePath),
 		});
 		return exportId;
 	};
@@ -12117,7 +12442,7 @@ export default function (pi: ExtensionAPI) {
 		prunePreparedPdfExports();
 		const entry = preparedPdfExports.get(exportId);
 		if (!entry) return null;
-		if (entry.filePath && entry.tempDirPath) return entry;
+		if (entry.filePath && (entry.tempDirPath || entry.persistent)) return entry;
 
 		const tempDirPath = join(tmpdir(), `pi-studio-prepared-pdf-${Date.now()}-${randomUUID()}`);
 		const filePath = join(tempDirPath, sanitizePdfFilename(entry.filename));
@@ -12167,6 +12492,7 @@ export default function (pi: ExtensionAPI) {
 	};
 
 	const disposePreparedHtmlExport = (entry: PreparedStudioHtmlExport | null | undefined) => {
+		if (entry?.persistent) return;
 		if (!entry?.tempDirPath) return;
 		void rm(entry.tempDirPath, { recursive: true, force: true }).catch(() => undefined);
 	};
@@ -12195,7 +12521,7 @@ export default function (pi: ExtensionAPI) {
 		}
 	};
 
-	const storePreparedHtmlExport = (html: Buffer, filename: string, warning?: string): string => {
+	const storePreparedHtmlExport = (html: Buffer, filename: string, warning?: string, filePath?: string): string => {
 		prunePreparedHtmlExports();
 		const exportId = randomUUID();
 		preparedHtmlExports.set(exportId, {
@@ -12203,6 +12529,8 @@ export default function (pi: ExtensionAPI) {
 			filename,
 			warning,
 			createdAt: Date.now(),
+			filePath,
+			persistent: Boolean(filePath),
 		});
 		return exportId;
 	};
@@ -12211,7 +12539,7 @@ export default function (pi: ExtensionAPI) {
 		prunePreparedHtmlExports();
 		const entry = preparedHtmlExports.get(exportId);
 		if (!entry) return null;
-		if (entry.filePath && entry.tempDirPath) return entry;
+		if (entry.filePath && (entry.tempDirPath || entry.persistent)) return entry;
 
 		const tempDirPath = join(tmpdir(), `pi-studio-prepared-html-${Date.now()}-${randomUUID()}`);
 		const filePath = join(tempDirPath, sanitizeHtmlFilename(entry.filename));
@@ -12632,7 +12960,8 @@ export default function (pi: ExtensionAPI) {
 
 		try {
 			const { pdf, warning } = await renderStudioPdfWithPandoc(markdown, isLatex, resourcePath, editorPdfLanguage, sourcePath || undefined);
-			const exportId = storePreparedPdfExport(pdf, filename, warning);
+			const writeResult = writeStudioPreviewExportFile(buildStudioPreviewExportPath(sourcePath || undefined, userResourceDir || undefined, studioCwd, filename), pdf);
+			const exportId = storePreparedPdfExport(pdf, filename, warning, writeResult.filePath ?? undefined);
 			const token = serverState?.token ?? "";
 			let openedExternal = false;
 			let openError: string | null = null;
@@ -12649,6 +12978,8 @@ export default function (pi: ExtensionAPI) {
 			respondJson(res, 200, {
 				ok: true,
 				filename,
+				path: writeResult.filePath,
+				writeError: writeResult.error,
 				warning: warning ?? null,
 				openedExternal,
 				openError,
@@ -12743,7 +13074,8 @@ export default function (pi: ExtensionAPI) {
 					themeVars,
 				},
 			);
-			const exportId = storePreparedHtmlExport(html, filename, warning);
+			const writeResult = writeStudioPreviewExportFile(buildStudioPreviewExportPath(sourcePath || undefined, userResourceDir || undefined, studioCwd, filename), html);
+			const exportId = storePreparedHtmlExport(html, filename, warning, writeResult.filePath ?? undefined);
 			const token = serverState?.token ?? "";
 			let openedExternal = false;
 			let openError: string | null = null;
@@ -12760,6 +13092,8 @@ export default function (pi: ExtensionAPI) {
 			respondJson(res, 200, {
 				ok: true,
 				filename,
+				path: writeResult.filePath,
+				writeError: writeResult.error,
 				warning: warning ?? null,
 				openedExternal,
 				openError,
@@ -13052,17 +13386,19 @@ export default function (pi: ExtensionAPI) {
 				return;
 			}
 
-			try {
-				const resource = resolveStudioLocalPreviewResourcePath(
-					requestUrl.searchParams.get("path") ?? "",
-					requestUrl.searchParams.get("sourcePath") ?? undefined,
-					requestUrl.searchParams.get("resourceDir") ?? undefined,
-					studioCwd,
-				);
-				respondLocalPreviewLinkJson(req, res, requestUrl, resource, serverState);
-			} catch (error) {
-				respondJson(res, 404, { ok: false, error: `Local resource unavailable: ${error instanceof Error ? error.message : String(error)}` });
-			}
+			void (async () => {
+				try {
+					const resource = resolveStudioLocalPreviewResourcePath(
+						requestUrl.searchParams.get("path") ?? "",
+						requestUrl.searchParams.get("sourcePath") ?? undefined,
+						requestUrl.searchParams.get("resourceDir") ?? undefined,
+						studioCwd,
+					);
+					await respondLocalPreviewLinkJson(req, res, requestUrl, resource, serverState);
+				} catch (error) {
+					respondJson(res, 404, { ok: false, error: `Local resource unavailable: ${error instanceof Error ? error.message : String(error)}` });
+				}
+			})();
 			return;
 		}
 
@@ -13386,7 +13722,9 @@ export default function (pi: ExtensionAPI) {
 		if (!agentBusy) return;
 		const toolName = typeof event.toolName === "string" ? event.toolName : "";
 		const input = (event as { input?: unknown }).input;
+		const toolCallId = typeof event.toolCallId === "string" ? event.toolCallId : "";
 		const label = deriveToolActivityLabel(toolName, input);
+		if (toolCallId) ensureStudioTraceToolEntry(toolCallId, toolName, input);
 		emitDebugEvent("tool_call", { toolName, label, activeRequestId: activeRequest?.id ?? null, activeRequestKind: activeRequest?.kind ?? null });
 		setTerminalActivity("tool", toolName, label);
 	});