pi-studio 0.9.46 → 0.9.48

package/client/studio.css

@@ -148,7 +148,7 @@
       background: var(--panel-2);
     }
 
-    button, select, .file-label {
+    button, select {
       border: 1px solid var(--control-border);
       background: var(--panel);
       color: var(--text);
@@ -163,14 +163,12 @@
     }
 
     button:not(:disabled):hover,
-    select:hover,
-    .file-label:hover {
+    select:hover {
       background: var(--panel-2);
     }
 
     button:focus-visible,
-    select:focus-visible,
-    .file-label:focus-within {
+    select:focus-visible {
       outline: 2px solid var(--accent-soft-strong);
       outline-offset: 1px;
     }
@@ -229,15 +227,8 @@
       filter: none;
     }
 
-    .file-label {
-      cursor: pointer;
-      display: inline-flex;
-      align-items: center;
-      gap: 6px;
-    }
-
-    .file-label input {
-      display: none;
+    .file-input-hidden {
+      display: none !important;
     }
 
     main {
@@ -1749,6 +1740,7 @@
 
     .rendered-markdown .studio-pdf-card-header {
       display: flex;
+      flex-wrap: wrap;
       align-items: center;
       justify-content: space-between;
       gap: 10px;
@@ -1777,10 +1769,13 @@
     }
 
     .rendered-markdown .studio-pdf-card-actions {
-      flex: 0 0 auto;
+      flex: 0 1 auto;
       display: inline-flex;
+      flex-wrap: wrap;
+      justify-content: flex-end;
       align-items: center;
       gap: 8px;
+      margin-left: auto;
     }
 
     .rendered-markdown .studio-pdf-card-link,
@@ -1907,6 +1902,7 @@
     .studio-pdf-focus-header {
       flex: 0 0 auto;
       display: flex;
+      flex-wrap: wrap;
       align-items: center;
       justify-content: space-between;
       gap: 12px;
@@ -1934,10 +1930,13 @@
     }
 
     .studio-pdf-focus-actions {
-      flex: 0 0 auto;
+      flex: 0 1 auto;
       display: inline-flex;
+      flex-wrap: wrap;
+      justify-content: flex-end;
       align-items: center;
       gap: 8px;
+      margin-left: auto;
     }
 
     .studio-pdf-focus-link,
@@ -2909,6 +2908,10 @@
       font-style: italic;
     }
 
+    .studio-latex-compatibility-warning {
+      margin: 0 0 0.85em;
+    }
+
     .marker {
       display: inline-block;
       padding: 0 4px;
@@ -5362,13 +5365,13 @@
     }
 
     body.studio-ui-refresh > header button,
-    body.studio-ui-refresh > header .file-label,
     body.studio-ui-refresh #responseActions button,
     body.studio-ui-refresh #responseActions select {
       padding: 5px 7px;
       font-size: 12px;
     }
 
+
     body.studio-ui-refresh main {
       gap: 0;
       padding: 9px;
@@ -6101,6 +6104,102 @@
       font-weight: 700;
     }
 
+    .studio-decision-overlay {
+      position: fixed;
+      inset: 0;
+      z-index: 13000;
+      display: grid;
+      place-items: center;
+      padding: 20px;
+      background: rgba(0, 0, 0, 0.58);
+      backdrop-filter: blur(2px);
+    }
+
+    .studio-decision-overlay[hidden] {
+      display: none !important;
+    }
+
+    .studio-decision-dialog {
+      width: min(560px, calc(100vw - 32px));
+      max-height: min(80vh, 680px);
+      overflow: auto;
+      padding: 20px;
+      border: 1px solid var(--panel-border);
+      border-radius: 14px;
+      background: var(--panel);
+      color: var(--text);
+      box-shadow: 0 24px 70px rgba(0, 0, 0, 0.48);
+    }
+
+    .studio-decision-title {
+      margin: 0;
+      color: var(--text);
+      font-size: 17px;
+      line-height: 1.3;
+    }
+
+    .studio-decision-message {
+      margin-top: 10px;
+      color: var(--studio-info-text, var(--muted));
+      font-size: 13px;
+      line-height: 1.5;
+      white-space: pre-wrap;
+      overflow-wrap: anywhere;
+    }
+
+    .studio-decision-input {
+      width: 100%;
+      margin-top: 16px;
+      padding: 9px 10px;
+      border: 1px solid var(--control-border);
+      border-radius: 8px;
+      background: var(--panel-2);
+      color: var(--text);
+      font-family: var(--font-mono);
+      font-size: 13px;
+    }
+
+    .studio-decision-input[hidden] {
+      display: none !important;
+    }
+
+    .studio-decision-input:focus {
+      border-color: var(--accent);
+      outline: 2px solid var(--accent-soft);
+      outline-offset: 1px;
+    }
+
+    .studio-decision-actions {
+      display: flex;
+      flex-wrap: wrap;
+      justify-content: flex-end;
+      gap: 8px;
+      margin-top: 18px;
+    }
+
+    .studio-decision-confirm:not(.is-destructive) {
+      border-color: var(--accent);
+      background: var(--accent);
+      color: var(--accent-contrast);
+      font-weight: 650;
+    }
+
+    .studio-decision-confirm.is-destructive {
+      border-color: var(--warn-border);
+      background: color-mix(in srgb, var(--warn) 15%, var(--panel));
+      color: var(--warn);
+      font-weight: 650;
+    }
+
+    .studio-decision-confirm.is-destructive:hover,
+    .studio-decision-confirm.is-destructive:focus-visible {
+      background: color-mix(in srgb, var(--warn) 24%, var(--panel));
+    }
+
+    body.studio-decision-open {
+      overflow: hidden;
+    }
+
     .studio-preview-link-menu {
       position: fixed;
       z-index: 12000;

package/index.ts

@@ -29,6 +29,8 @@ import {
 } from "./shared/studio-markdown-latex-literals.js";
 import { escapeStudioPdfLatexTextFragment } from "./shared/studio-pdf-escape.js";
 import { resolveStudioPdfResourceFile } from "./shared/studio-pdf-resource.js";
+import { createStudioPandocHtmlResourceFlagResolver } from "./shared/studio-pandoc-resource-flag.js";
+import { prepareStudioLatexForPandoc } from "./shared/studio-latex-pandoc-compat.js";
 import { isStudioCmuxSession, openStudioUrlInBrowser } from "./shared/studio-browser-launcher.js";
 import { buildStudioReplTmuxStartArgs } from "./shared/studio-repl-tmux.js";
 import { buildStudioForwardingHint, buildStudioSshTunnelHint, isStudioSshSession as isSshSession } from "./shared/studio-ssh-hint.js";
@@ -647,6 +649,7 @@ const STUDIO_QUIZ_CONTEXT_MAX_FILES = 18;
 const STUDIO_QUIZ_SNIPPET_MAX_CHARS = 8_000;
 const STUDIO_QUIZ_DISCUSSION_MAX_CHARS = 6_000;
 const REQUEST_BODY_MAX_BYTES = 1_000_000;
+const STUDIO_IMPORT_FILE_MAX_BYTES = 10_000_000;
 const STUDIO_WORKSPACE_STATE_REQUEST_MAX_BYTES = 4_000_000;
 const RESPONSE_HISTORY_LIMIT = 30;
 const CMUX_NOTIFY_TIMEOUT_MS = 1200;
@@ -6126,28 +6129,45 @@ function decorateStudioPandocSyntaxHtml(html: string): string {
 	);
 }
 
-const studioPandocHtmlResourceFlagCache = new Map<string, Promise<"--embed-resources" | "--self-contained">>();
+function buildStudioLatexPandocCompatibilityWarning(omittedPackages: Array<{ name: string }>): string | undefined {
+	const packageNames = Array.from(new Set(
+		omittedPackages
+			.map((entry) => String(entry?.name ?? "").trim())
+			.filter(Boolean),
+	));
+	if (packageNames.length === 0) return undefined;
+	const packageLabel = packageNames
+		.map((name) => name.toLowerCase().endsWith(".sty") ? name : `${name}.sty`)
+		.join(", ");
+	const noun = packageNames.length === 1 ? "package" : "packages";
+	const subject = packageNames.length === 1 ? "it redefines" : "they redefine";
+	return `Studio omitted local LaTeX ${noun} ${packageLabel} from this Pandoc rendering because ${subject} document startup. Package-specific layout may be absent; compile the source directly with LaTeX for authoritative output.`;
+}
 
-async function getStudioPandocHtmlResourceFlag(pandocCommand: string): Promise<"--embed-resources" | "--self-contained"> {
-	let cached = studioPandocHtmlResourceFlagCache.get(pandocCommand);
-	if (!cached) {
-		cached = runStudioSubprocess(pandocCommand, ["--help"], {
-			timeoutMs: 5_000,
-			stdoutMaxBytes: 250_000,
-			stderrMaxBytes: 20_000,
-			label: "pandoc capability probe",
-			notFoundMessage: "pandoc was not found. Install pandoc or set PANDOC_PATH to the pandoc binary.",
-		}).then((result) => {
-			if (result.code !== 0) {
-				throw new Error(`pandoc capability probe failed with exit code ${result.code}${result.stderr ? `: ${result.stderr}` : ""}`);
-			}
-			return result.stdout.includes("--embed-resources") ? "--embed-resources" : "--self-contained";
-		});
-		studioPandocHtmlResourceFlagCache.set(pandocCommand, cached);
-	}
-	return cached;
+function combineStudioWarnings(...warnings: Array<string | undefined>): string | undefined {
+	const messages = Array.from(new Set(warnings.map((warning) => String(warning ?? "").trim()).filter(Boolean)));
+	return messages.length > 0 ? messages.join(" ") : undefined;
+}
+
+function renderStudioLatexPandocCompatibilityWarningHtml(warning: string | undefined): string {
+	if (!warning) return "";
+	return `<div class="preview-warning studio-latex-compatibility-warning" role="note">${escapeStudioHtmlText(warning)}</div>`;
 }
 
+const resolveStudioPandocHtmlResourceFlag = createStudioPandocHtmlResourceFlagResolver(async (pandocCommand: string) => {
+	const result = await runStudioSubprocess(pandocCommand, ["--help"], {
+		timeoutMs: 5_000,
+		stdoutMaxBytes: 250_000,
+		stderrMaxBytes: 20_000,
+		label: "pandoc capability probe",
+		notFoundMessage: "pandoc was not found. Install pandoc or set PANDOC_PATH to the pandoc binary.",
+	});
+	if (result.code !== 0) {
+		throw new Error(`pandoc capability probe failed with exit code ${result.code}${result.stderr ? `: ${result.stderr}` : ""}`);
+	}
+	return result.stdout;
+});
+
 function preprocessStudioLatexFootnotemarksForPreview(latex: string): string {
 	return String(latex ?? "").replace(/\\footnotemark\s*\[\s*([^\]\r\n]+?)\s*\]/g, (_match, marker: string) => {
 		const value = String(marker || "").trim();
@@ -6157,8 +6177,15 @@ function preprocessStudioLatexFootnotemarksForPreview(latex: string): string {
 
 async function renderStudioMarkdownWithPandoc(markdown: string, isLatex?: boolean, resourcePath?: string, sourcePath?: string): Promise<string> {
 	const pandocCommand = process.env.PANDOC_PATH?.trim() || "pandoc";
-	const latexPreviewSource = isLatex ? preprocessStudioLatexFootnotemarksForPreview(markdown) : markdown;
-	const markdownWithNormalizedFences = isLatex ? latexPreviewSource : normalizeStudioMarkdownSmartFences(markdown);
+	const pandocWorkingDir = resolveStudioPandocWorkingDir(resourcePath)
+		?? resolveStudioPandocWorkingDir(sourcePath ? dirname(sourcePath) : undefined);
+	const latexPandocCompatibility = isLatex
+		? prepareStudioLatexForPandoc(markdown, pandocWorkingDir)
+		: { source: markdown, omittedPackages: [] as Array<{ name: string; path: string }> };
+	const latexPandocCompatibilityWarning = buildStudioLatexPandocCompatibilityWarning(latexPandocCompatibility.omittedPackages);
+	const pandocInputSource = latexPandocCompatibility.source;
+	const latexPreviewSource = isLatex ? preprocessStudioLatexFootnotemarksForPreview(pandocInputSource) : pandocInputSource;
+	const markdownWithNormalizedFences = isLatex ? latexPreviewSource : normalizeStudioMarkdownSmartFences(pandocInputSource);
 	const markdownWithoutHtmlComments = isLatex ? markdownWithNormalizedFences : stripStudioMarkdownHtmlCommentsPreservingYamlFrontMatter(markdownWithNormalizedFences);
 	const markdownWithPreviewPageBreaks = isLatex ? markdownWithoutHtmlComments : replaceStudioPreviewPageBreakCommands(markdownWithoutHtmlComments);
 	const latexSubfigurePreviewTransform = isLatex
@@ -6171,7 +6198,7 @@ async function renderStudioMarkdownWithPandoc(markdown: string, isLatex?: boolea
 		? preprocessStudioLatexReferences(latexAlgorithmPreviewTransform.markdown, sourcePath, resourcePath)
 		: markdownWithPreviewPageBreaks;
 	const inputFormat = isLatex ? "latex" : "markdown+lists_without_preceding_blankline-blank_before_blockquote-blank_before_header+tex_math_dollars+tex_math_single_backslash+tex_math_double_backslash+autolink_bare_uris-raw_html";
-	const bibliographyArgs = buildStudioPandocBibliographyArgs(markdown, isLatex, resourcePath);
+	const bibliographyArgs = buildStudioPandocBibliographyArgs(pandocInputSource, isLatex, resourcePath);
 	const args = ["-f", inputFormat, "-t", "html5", "--mathml", "--wrap=none", ...bibliographyArgs];
 	let htmlTemplateDir: string | null = null;
 	const useStudioHtmlTemplate = Boolean(resourcePath || isLatex);
@@ -6186,13 +6213,12 @@ async function renderStudioMarkdownWithPandoc(markdown: string, isLatex?: boolea
 		await mkdir(htmlTemplateDir, { recursive: true });
 		const htmlTemplatePath = join(htmlTemplateDir, "template.html");
 		await writeFile(htmlTemplatePath, STUDIO_PANDOC_HTML_FRAGMENT_TEMPLATE, "utf-8");
-		if (resourcePath) args.push(await getStudioPandocHtmlResourceFlag(pandocCommand));
+		if (resourcePath) args.push(await resolveStudioPandocHtmlResourceFlag(pandocCommand));
 		args.push("--standalone", `--template=${htmlTemplatePath}`);
 	}
 	const normalizedMarkdown = isLatex
 		? sourceWithResolvedRefs
 		: normalizeStudioMarkdownFencedBlocks(prepareStudioMarkdownForPandoc(sourceWithResolvedRefs));
-	const pandocWorkingDir = resolveStudioPandocWorkingDir(resourcePath);
 
 	let pandocResult: StudioSubprocessResult;
 	try {
@@ -6237,6 +6263,7 @@ async function renderStudioMarkdownWithPandoc(markdown: string, isLatex?: boolea
 		renderedHtml = decorateStudioPreviewPageBreakHtml(renderedHtml);
 	}
 	renderedHtml = decorateStudioPandocSyntaxHtml(renderedHtml);
+	renderedHtml = renderStudioLatexPandocCompatibilityWarningHtml(latexPandocCompatibilityWarning) + renderedHtml;
 	return stripMathMlAnnotationTags(renderedHtml);
 }
 
@@ -6623,8 +6650,15 @@ async function renderStudioStandaloneHtmlWithPandoc(
 	sourcePath?: string,
 	options?: StudioHtmlRenderOptions,
 ): Promise<{ html: Buffer; warning?: string }> {
-	const delimitedMarkdown = isLatex ? null : formatStudioDelimitedTextAsMarkdown(markdown, editorLanguage);
-	const input = delimitedMarkdown ?? markdown;
+	const pandocWorkingDir = resolveStudioPandocWorkingDir(resourcePath)
+		?? resolveStudioPandocWorkingDir(sourcePath ? dirname(sourcePath) : undefined);
+	const latexPandocCompatibility = isLatex
+		? prepareStudioLatexForPandoc(markdown, pandocWorkingDir)
+		: { source: markdown, omittedPackages: [] as Array<{ name: string; path: string }> };
+	const latexPandocCompatibilityWarning = buildStudioLatexPandocCompatibilityWarning(latexPandocCompatibility.omittedPackages);
+	const pandocCompatibleMarkdown = latexPandocCompatibility.source;
+	const delimitedMarkdown = isLatex ? null : formatStudioDelimitedTextAsMarkdown(pandocCompatibleMarkdown, editorLanguage);
+	const input = delimitedMarkdown ?? pandocCompatibleMarkdown;
 	const effectiveEditorLanguage = delimitedMarkdown ? "markdown" : inferStudioPdfLanguage(input, editorLanguage);
 	if (!isLatex && isLikelyStandaloneStudioHtml(input, effectiveEditorLanguage)) {
 		return { html: Buffer.from(String(input ?? ""), "utf-8") };
@@ -6641,8 +6675,12 @@ async function renderStudioStandaloneHtmlWithPandoc(
 	let renderedHtml = await renderStudioMarkdownWithPandoc(pdfPrepared.markdown, isLatex, resourcePath, sourcePath);
 	renderedHtml = renderStudioPdfBlocksInHtml(renderedHtml, pdfPrepared.blocks, sourcePath, resourcePath);
 	renderedHtml = applyStudioAnnotationPlaceholdersToHtml(renderedHtml, annotationPrepared.placeholders);
+	renderedHtml = renderStudioLatexPandocCompatibilityWarningHtml(latexPandocCompatibilityWarning) + renderedHtml;
 	const standaloneHtml = buildStudioStandaloneHtmlDocument(renderedHtml, resourcePath, options);
-	return { html: Buffer.from(standaloneHtml, "utf-8") };
+	return {
+		html: Buffer.from(standaloneHtml, "utf-8"),
+		warning: latexPandocCompatibilityWarning,
+	};
 }
 
 async function renderStudioLiteralTextPdf(text: string, title = "Studio export", options?: StudioPdfRenderOptions): Promise<Buffer> {
@@ -7031,19 +7069,26 @@ async function renderStudioPdfWithPandoc(
 ): Promise<{ pdf: Buffer; warning?: string }> {
 	const pandocCommand = process.env.PANDOC_PATH?.trim() || "pandoc";
 	const pdfEngine = process.env.PANDOC_PDF_ENGINE?.trim() || "xelatex";
+	const pandocWorkingDir = resolveStudioPandocWorkingDir(resourcePath)
+		?? resolveStudioPandocWorkingDir(sourcePath ? dirname(sourcePath) : undefined);
+	const latexPandocCompatibility = isLatex
+		? prepareStudioLatexForPandoc(markdown, pandocWorkingDir)
+		: { source: markdown, omittedPackages: [] as Array<{ name: string; path: string }> };
+	const latexPandocCompatibilityWarning = buildStudioLatexPandocCompatibilityWarning(latexPandocCompatibility.omittedPackages);
+	const pandocInputSource = latexPandocCompatibility.source;
 	const latexSubfigurePdfTransform = isLatex
-		? preprocessStudioLatexSubfiguresForPdf(markdown)
-		: { markdown, groups: [] };
+		? preprocessStudioLatexSubfiguresForPdf(pandocInputSource)
+		: { markdown: pandocInputSource, groups: [] };
 	const latexPdfSource = isLatex
 		? preprocessStudioLatexAlgorithmsForPdf(
 			latexSubfigurePdfTransform.markdown,
 			sourcePath,
 			resourcePath,
 		)
-		: markdown;
+		: pandocInputSource;
 	const sourceWithResolvedRefs = isLatex
 		? injectStudioLatexEquationTags(preprocessStudioLatexReferences(latexPdfSource, sourcePath, resourcePath), sourcePath, resourcePath)
-		: markdown;
+		: pandocInputSource;
 	const effectiveEditorLanguage = inferStudioPdfLanguage(sourceWithResolvedRefs, editorPdfLanguage);
 	const pdfCalloutTransform = !isLatex && (!effectiveEditorLanguage || effectiveEditorLanguage === "markdown")
 		? preprocessStudioMarkdownCalloutsForPdf(sourceWithResolvedRefs)
@@ -7051,8 +7096,7 @@ async function renderStudioPdfWithPandoc(
 	const pdfAlignedImageTransform = !isLatex && (!effectiveEditorLanguage || effectiveEditorLanguage === "markdown")
 		? preprocessStudioMarkdownImageAlignmentForPdf(pdfCalloutTransform.markdown)
 		: { markdown: pdfCalloutTransform.markdown, blocks: [] as StudioPdfAlignedImageBlock[] };
-	const pandocWorkingDir = resolveStudioPandocWorkingDir(resourcePath);
-	const bibliographyArgs = buildStudioPandocBibliographyArgs(markdown, isLatex, resourcePath);
+	const bibliographyArgs = buildStudioPandocBibliographyArgs(pandocInputSource, isLatex, resourcePath);
 
 	const runPandocPdfExport = async (
 		inputFormat: string,
@@ -7105,7 +7149,7 @@ async function renderStudioPdfWithPandoc(
 	};
 
 	if (isLatex && (latexSubfigurePdfTransform.groups.length > 0 || collectStudioInlineAnnotationMarkers(sourceWithResolvedRefs).length > 0)) {
-		return await renderStudioPdfFromGeneratedLatex(
+		const rendered = await renderStudioPdfFromGeneratedLatex(
 			sourceWithResolvedRefs,
 			pandocCommand,
 			pdfEngine,
@@ -7121,6 +7165,10 @@ async function renderStudioPdfWithPandoc(
 			"",
 			themeStyle,
 		);
+		return {
+			pdf: rendered.pdf,
+			warning: combineStudioWarnings(latexPandocCompatibilityWarning, rendered.warning),
+		};
 	}
 
 	if (!isLatex && effectiveEditorLanguage === "diff") {
@@ -7194,7 +7242,10 @@ async function renderStudioPdfWithPandoc(
 			themeStyle,
 		);
 		await rm(tempDir, { recursive: true, force: true }).catch(() => undefined);
-		return { pdf: rendered.pdf, warning: mermaidPrepared.warning ?? rendered.warning };
+		return {
+			pdf: rendered.pdf,
+			warning: combineStudioWarnings(latexPandocCompatibilityWarning, mermaidPrepared.warning, rendered.warning),
+		};
 	}
 
 	const hasYamlHeaderIncludesForPdf = !isLatex && hasStudioYamlHeaderIncludes(markdownForPdf);
@@ -7229,7 +7280,10 @@ async function renderStudioPdfWithPandoc(
 			throw new Error(`pandoc PDF export failed with exit code ${pandocResult.code}${stderr ? `: ${stderr}` : ""}${hint}`);
 		}
 
-		return { pdf: await readFile(outputPath), warning: mermaidPrepared.warning };
+		return {
+			pdf: await readFile(outputPath),
+			warning: combineStudioWarnings(latexPandocCompatibilityWarning, mermaidPrepared.warning),
+		};
 	} finally {
 		await rm(tempDir, { recursive: true, force: true }).catch(() => undefined);
 	}
@@ -7539,6 +7593,64 @@ function revealStudioLocalFile(filePath: string): { ok: true; message: string }
 	return { ok: true, message: process.platform === "linux" ? "Opened containing folder." : "Revealed resource in file manager." };
 }
 
+async function handleImportStudioFileCopyRequest(req: IncomingMessage, res: ServerResponse, studioCwd: string): Promise<void> {
+	const method = (req.method ?? "GET").toUpperCase();
+	if (method !== "POST") {
+		res.setHeader("Allow", "POST");
+		respondJson(res, 405, { ok: false, error: "Method not allowed. Use POST." });
+		return;
+	}
+
+	const rawBody = await readRequestBody(req, REQUEST_BODY_MAX_BYTES);
+	let payload: Record<string, unknown> = {};
+	try {
+		payload = rawBody ? JSON.parse(rawBody) : {};
+	} catch {
+		respondJson(res, 400, { ok: false, error: "Invalid JSON body." });
+		return;
+	}
+
+	const requestedPath = typeof payload.path === "string" ? payload.path : "";
+	const resolved = resolveStudioPath(requestedPath, studioCwd);
+	if (resolved.ok === false) {
+		respondJson(res, 400, { ok: false, error: resolved.message });
+		return;
+	}
+
+	try {
+		const stats = statSync(resolved.resolved);
+		if (!stats.isFile()) {
+			respondJson(res, 400, { ok: false, error: `Path is not a file: ${resolved.label}` });
+			return;
+		}
+		if (stats.size > STUDIO_IMPORT_FILE_MAX_BYTES) {
+			respondJson(res, 413, {
+				ok: false,
+				error: `File is too large to import into Studio (${stats.size} bytes; limit ${STUDIO_IMPORT_FILE_MAX_BYTES} bytes).`,
+			});
+			return;
+		}
+	} catch (error) {
+		respondJson(res, 404, {
+			ok: false,
+			error: `Could not access file: ${resolved.label} (${error instanceof Error ? error.message : String(error)})`,
+		});
+		return;
+	}
+
+	const file = readStudioFile(resolved.resolved, studioCwd);
+	if (file.ok === false) {
+		respondJson(res, 400, { ok: false, error: file.message });
+		return;
+	}
+	respondJson(res, 200, {
+		ok: true,
+		text: file.text,
+		filename: basename(file.resolvedPath),
+		resolvedPath: file.resolvedPath,
+	});
+}
+
 async function handleRevealLocalPreviewResourceRequest(req: IncomingMessage, res: ServerResponse, studioCwd: string): Promise<void> {
 	const method = (req.method ?? "GET").toUpperCase();
 	if (method !== "POST") {
@@ -7574,6 +7686,50 @@ async function handleRevealLocalPreviewResourceRequest(req: IncomingMessage, res
 	}
 }
 
+async function handleOpenLocalPreviewResourceRequest(req: IncomingMessage, res: ServerResponse, studioCwd: string): Promise<void> {
+	const method = (req.method ?? "GET").toUpperCase();
+	if (method !== "POST") {
+		res.setHeader("Allow", "POST");
+		respondJson(res, 405, { ok: false, error: "Method not allowed. Use POST." });
+		return;
+	}
+	if (isSshSession()) {
+		respondJson(res, 409, { ok: false, error: "Cannot open a system PDF viewer from an SSH/headless Studio session. Copy the path instead." });
+		return;
+	}
+
+	const rawBody = await readRequestBody(req, REQUEST_BODY_MAX_BYTES);
+	let payload: Record<string, unknown> = {};
+	try {
+		payload = rawBody ? JSON.parse(rawBody) : {};
+	} catch {
+		respondJson(res, 400, { ok: false, error: "Invalid JSON body." });
+		return;
+	}
+
+	try {
+		const resource = resolveStudioLocalPreviewResourcePath(
+			typeof payload.path === "string" ? payload.path : "",
+			typeof payload.sourcePath === "string" ? payload.sourcePath : undefined,
+			typeof payload.resourceDir === "string" ? payload.resourceDir : undefined,
+			studioCwd,
+		);
+		if (resource.kind !== "pdf") {
+			respondJson(res, 400, { ok: false, error: "Only local PDF previews can be opened in the system PDF viewer." });
+			return;
+		}
+		await openPathInDefaultViewer(resource.filePath);
+		respondJson(res, 200, {
+			ok: true,
+			message: "Opened PDF in the system viewer.",
+			path: resource.filePath,
+			label: resource.label,
+		});
+	} catch (error) {
+		respondJson(res, 404, { ok: false, error: `Local PDF unavailable: ${error instanceof Error ? error.message : String(error)}` });
+	}
+}
+
 function openPathInDefaultViewer(path: string): Promise<void> {
 	const openCommand =
 		process.platform === "darwin"
@@ -10596,7 +10752,8 @@ ${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="Browser import: load a selected text file as a detached copy. Use Save editor as… to attach this copy to a file path and make it file-backed, or use the Files view to open a refreshable file-backed document directly.">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="importFileBtn" type="button" title="Import a file as an editable copy.">Import file copy…</button>
+      <input id="fileInput" class="file-input-hidden" type="file" tabindex="-1" aria-hidden="true" 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" />
       <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>
     </div>
@@ -14916,6 +15073,19 @@ export default function (pi: ExtensionAPI) {
 			return;
 		}
 
+		if (requestUrl.pathname === "/import-file-copy") {
+			const token = requestUrl.searchParams.get("token") ?? "";
+			if (token !== serverState.token) {
+				respondJson(res, 403, { ok: false, error: "Invalid or expired studio token. Re-run /studio." });
+				return;
+			}
+
+			void handleImportStudioFileCopyRequest(req, res, studioCwd).catch((error) => {
+				respondJson(res, 500, { ok: false, error: `File import failed: ${error instanceof Error ? error.message : String(error)}` });
+			});
+			return;
+		}
+
 		if (requestUrl.pathname === "/local-preview-link") {
 			const token = requestUrl.searchParams.get("token") ?? "";
 			if (token !== serverState.token) {
@@ -14952,6 +15122,19 @@ export default function (pi: ExtensionAPI) {
 			return;
 		}
 
+		if (requestUrl.pathname === "/open-local-resource") {
+			const token = requestUrl.searchParams.get("token") ?? "";
+			if (token !== serverState.token) {
+				respondJson(res, 403, { ok: false, error: "Invalid or expired studio token. Re-run /studio." });
+				return;
+			}
+
+			void handleOpenLocalPreviewResourceRequest(req, res, studioCwd).catch((error) => {
+				respondJson(res, 500, { ok: false, error: `Open in system viewer failed: ${error instanceof Error ? error.message : String(error)}` });
+			});
+			return;
+		}
+
 		if (requestUrl.pathname === "/pdf-resource") {
 			const token = requestUrl.searchParams.get("token") ?? "";
 			if (token !== serverState.token) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-studio",
-  "version": "0.9.46",
+  "version": "0.9.48",
   "description": "Two-pane browser workspace for pi with prompt/response editing, annotations, critiques, active quiz, prompt/response history, live previews, and tmux-backed REPL/literate REPL workflows",
   "type": "module",
   "license": "MIT",