pi-studio 0.5.18 → 0.5.20

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `pi-studio` are documented here.
 
 ## [Unreleased]
 
+## [0.5.20] — 2026-03-19
+
+### Fixed
+- LaTeX preview/PDF export now runs pandoc from the resolved source/working directory, so project-relative `\input{...}` files, shared macros, and similar local assets resolve more reliably for multi-file documents.
+- LaTeX preview/PDF export now also detects basic bibliography directives such as `\bibliography{...}` and `\addbibresource{...}` and passes the resolved `.bib` files to pandoc citeproc, so references show up more often in Studio without a full `latexmk` build.
+- Display-math blocks in preview are now styled to center more naturally, and the raw-editor highlight cutoff is bumped to `100_000` characters so moderately large `.tex` files still get inline syntax colouring.
+
+## [0.5.19] — 2026-03-19
+
+### Fixed
+- Studio now waits until `agent_end` before emitting the terminal/cmux “response ready” notification for completed requests, and it keeps the cmux `running…` status pill visible until that same turn fully finishes.
+
 ## [0.5.18] — 2026-03-17
 
 ### Fixed

package/client/studio-client.js

@@ -163,7 +163,7 @@
       };
       let activePane = "left";
       let paneFocusTarget = "off";
-      const EDITOR_HIGHLIGHT_MAX_CHARS = 80_000;
+      const EDITOR_HIGHLIGHT_MAX_CHARS = 100_000;
       const EDITOR_HIGHLIGHT_STORAGE_KEY = "piStudio.editorHighlightEnabled";
       const EDITOR_LANGUAGE_STORAGE_KEY = "piStudio.editorLanguage";
       // Single source of truth: language -> file extensions (and display label)

package/client/studio.css

@@ -758,9 +758,14 @@
       max-width: 100%;
     }
 
+    .rendered-markdown math {
+      font-family: "STIX Two Math", "Cambria Math", "Latin Modern Math", "STIXGeneral", serif;
+    }
+
     .rendered-markdown math[display="block"] {
       display: block;
       margin: 1em 0;
+      text-align: center;
       overflow-x: auto;
       overflow-y: hidden;
     }

package/index.ts

@@ -994,20 +994,111 @@ function buildStudioSyntheticNewFileDiff(filePath: string, content: string): str
 	return diffLines.join("\n");
 }
 
-function resolveStudioGitDiffBaseDir(sourcePath: string | undefined, resourceDir: string | undefined, fallbackCwd: string): string {
+function resolveStudioBaseDir(sourcePath: string | undefined, resourceDir: string | undefined, fallbackCwd: string): string {
 	const source = typeof sourcePath === "string" ? sourcePath.trim() : "";
 	if (source) {
-		return dirname(source);
+		const expanded = expandHome(source);
+		return dirname(isAbsolute(expanded) ? expanded : resolve(fallbackCwd, expanded));
 	}
 
 	const resource = typeof resourceDir === "string" ? resourceDir.trim() : "";
 	if (resource) {
-		return isAbsolute(resource) ? resource : resolve(fallbackCwd, resource);
+		const expanded = expandHome(resource);
+		return isAbsolute(expanded) ? expanded : resolve(fallbackCwd, expanded);
 	}
 
 	return fallbackCwd;
 }
 
+function resolveStudioGitDiffBaseDir(sourcePath: string | undefined, resourceDir: string | undefined, fallbackCwd: string): string {
+	return resolveStudioBaseDir(sourcePath, resourceDir, fallbackCwd);
+}
+
+function resolveStudioPandocWorkingDir(baseDir: string | undefined): string | undefined {
+	const normalized = typeof baseDir === "string" ? baseDir.trim() : "";
+	if (!normalized) return undefined;
+	try {
+		return statSync(normalized).isDirectory() ? normalized : undefined;
+	} catch {
+		return undefined;
+	}
+}
+
+function stripStudioLatexComments(text: string): string {
+	const lines = String(text ?? "").replace(/\r\n/g, "\n").split("\n");
+	return lines.map((line) => {
+		let out = "";
+		let backslashRun = 0;
+		for (let i = 0; i < line.length; i++) {
+			const ch = line[i]!;
+			if (ch === "%" && backslashRun % 2 === 0) break;
+			out += ch;
+			if (ch === "\\") backslashRun++;
+			else backslashRun = 0;
+		}
+		return out;
+	}).join("\n");
+}
+
+function collectStudioLatexBibliographyCandidates(markdown: string): string[] {
+	const stripped = stripStudioLatexComments(markdown);
+	const candidates: string[] = [];
+	const seen = new Set<string>();
+	const pushCandidate = (raw: string) => {
+		let candidate = String(raw ?? "").trim().replace(/^file:/i, "").replace(/^['"]|['"]$/g, "");
+		if (!candidate) return;
+		if (!/\.[A-Za-z0-9]+$/.test(candidate)) candidate += ".bib";
+		if (seen.has(candidate)) return;
+		seen.add(candidate);
+		candidates.push(candidate);
+	};
+
+	for (const match of stripped.matchAll(/\\bibliography\s*\{([^}]+)\}/g)) {
+		const rawList = match[1] ?? "";
+		for (const part of rawList.split(",")) {
+			pushCandidate(part);
+		}
+	}
+
+	for (const match of stripped.matchAll(/\\addbibresource(?:\[[^\]]*\])?\s*\{([^}]+)\}/g)) {
+		pushCandidate(match[1] ?? "");
+	}
+
+	return candidates;
+}
+
+function resolveStudioLatexBibliographyPaths(markdown: string, baseDir: string | undefined): string[] {
+	const workingDir = resolveStudioPandocWorkingDir(baseDir);
+	if (!workingDir) return [];
+	const resolvedPaths: string[] = [];
+	const seen = new Set<string>();
+
+	for (const candidate of collectStudioLatexBibliographyCandidates(markdown)) {
+		const expanded = expandHome(candidate);
+		const resolvedPath = isAbsolute(expanded) ? expanded : resolve(workingDir, expanded);
+		try {
+			if (!statSync(resolvedPath).isFile()) continue;
+			if (seen.has(resolvedPath)) continue;
+			seen.add(resolvedPath);
+			resolvedPaths.push(resolvedPath);
+		} catch {
+			// Ignore missing bibliography files; pandoc can still render the document body.
+		}
+	}
+
+	return resolvedPaths;
+}
+
+function buildStudioPandocBibliographyArgs(markdown: string, isLatex: boolean | undefined, baseDir: string | undefined): string[] {
+	if (!isLatex) return [];
+	const bibliographyPaths = resolveStudioLatexBibliographyPaths(markdown, baseDir);
+	if (bibliographyPaths.length === 0) return [];
+	return [
+		"--citeproc",
+		...bibliographyPaths.flatMap((path) => ["--bibliography", path]),
+	];
+}
+
 function readStudioGitDiff(baseDir: string):
 	| { ok: true; text: string; label: string }
 	| { ok: false; level: "info" | "warning" | "error"; message: string } {
@@ -1593,16 +1684,18 @@ async function preprocessStudioMermaidForPdf(markdown: string, workDir: string):
 async function renderStudioMarkdownWithPandoc(markdown: string, isLatex?: boolean, resourcePath?: string): Promise<string> {
 	const pandocCommand = process.env.PANDOC_PATH?.trim() || "pandoc";
 	const inputFormat = isLatex ? "latex" : "markdown+lists_without_preceding_blankline+tex_math_dollars+tex_math_single_backslash+tex_math_double_backslash+autolink_bare_uris-raw_html";
-	const args = ["-f", inputFormat, "-t", "html5", "--mathml", "--wrap=none"];
+	const bibliographyArgs = buildStudioPandocBibliographyArgs(markdown, isLatex, resourcePath);
+	const args = ["-f", inputFormat, "-t", "html5", "--mathml", "--wrap=none", ...bibliographyArgs];
 	if (resourcePath) {
 		args.push(`--resource-path=${resourcePath}`);
 		// Embed images as data URIs so they render in the browser preview
 		args.push("--embed-resources", "--standalone");
 	}
 	const normalizedMarkdown = isLatex ? markdown : normalizeObsidianImages(normalizeMathDelimiters(markdown));
+	const pandocWorkingDir = resolveStudioPandocWorkingDir(resourcePath);
 
 	return await new Promise<string>((resolve, reject) => {
-		const child = spawn(pandocCommand, args, { stdio: ["pipe", "pipe", "pipe"] });
+		const child = spawn(pandocCommand, args, { stdio: ["pipe", "pipe", "pipe"], cwd: pandocWorkingDir });
 		const stdoutChunks: Buffer[] = [];
 		const stderrChunks: Buffer[] = [];
 		let settled = false;
@@ -1743,6 +1836,8 @@ async function renderStudioPdfWithPandoc(
 	const pandocCommand = process.env.PANDOC_PATH?.trim() || "pandoc";
 	const pdfEngine = process.env.PANDOC_PDF_ENGINE?.trim() || "xelatex";
 	const effectiveEditorLanguage = inferStudioPdfLanguage(markdown, editorPdfLanguage);
+	const pandocWorkingDir = resolveStudioPandocWorkingDir(resourcePath);
+	const bibliographyArgs = buildStudioPandocBibliographyArgs(markdown, isLatex, resourcePath);
 
 	const runPandocPdfExport = async (
 		inputFormat: string,
@@ -1766,12 +1861,13 @@ async function renderStudioPdfWithPandoc(
 			"-V", "urlcolor=blue",
 			"-V", "linkcolor=blue",
 			"--include-in-header", preamblePath,
+			...bibliographyArgs,
 		];
 		if (resourcePath) args.push(`--resource-path=${resourcePath}`);
 
 		try {
 			await new Promise<void>((resolve, reject) => {
-				const child = spawn(pandocCommand, args, { stdio: ["pipe", "pipe", "pipe"] });
+				const child = spawn(pandocCommand, args, { stdio: ["pipe", "pipe", "pipe"], cwd: pandocWorkingDir });
 				const stderrChunks: Buffer[] = [];
 				let settled = false;
 
@@ -1862,12 +1958,13 @@ async function renderStudioPdfWithPandoc(
 		"-V", "urlcolor=blue",
 		"-V", "linkcolor=blue",
 		"--include-in-header", preamblePath,
+		...bibliographyArgs,
 	];
 	if (resourcePath) args.push(`--resource-path=${resourcePath}`);
 
 	try {
 		await new Promise<void>((resolve, reject) => {
-			const child = spawn(pandocCommand, args, { stdio: ["pipe", "pipe", "pipe"] });
+			const child = spawn(pandocCommand, args, { stdio: ["pipe", "pipe", "pipe"], cwd: pandocWorkingDir });
 			const stderrChunks: Buffer[] = [];
 			let settled = false;
 
@@ -2952,6 +3049,7 @@ export default function (pi: ExtensionAPI) {
 	let lastCommandCtx: ExtensionCommandContext | null = null;
 	let lastThemeVarsJson = "";
 	let suppressedStudioResponse: { requestId: string; kind: StudioRequestKind } | null = null;
+	let pendingStudioCompletionKind: StudioRequestKind | null = null;
 	let agentBusy = false;
 	let terminalActivityPhase: TerminalActivityPhase = "idle";
 	let terminalActivityToolName: string | null = null;
@@ -3150,7 +3248,7 @@ export default function (pi: ExtensionAPI) {
 		if (!shouldUseCmuxTerminalIntegration()) return;
 		const workspaceArgs = getCmuxWorkspaceArgs();
 		const statusColor = getCmuxStudioStatusColor();
-		if (activeRequest) {
+		if (activeRequest || (pendingStudioCompletionKind && agentBusy)) {
 			runCmuxCommand([
 				"set-status",
 				CMUX_STUDIO_STATUS_KEY,
@@ -3269,6 +3367,23 @@ export default function (pi: ExtensionAPI) {
 		return "Studio: response ready.";
 	};
 
+	const clearPendingStudioCompletion = () => {
+		if (!pendingStudioCompletionKind) return;
+		pendingStudioCompletionKind = null;
+		syncCmuxStudioStatus();
+	};
+
+	const flushPendingStudioCompletionNotification = () => {
+		if (!pendingStudioCompletionKind) return;
+		const kind = pendingStudioCompletionKind;
+		pendingStudioCompletionKind = null;
+		syncCmuxStudioStatus();
+		const message = getStudioRequestCompletionNotification(kind);
+		emitDebugEvent("studio_completion_notification", { kind });
+		notifyStudio(message, "info");
+		notifyStudioTerminal(message, "info");
+	};
+
 	const refreshContextUsage = (
 		ctx?: { getContextUsage(): { tokens: number | null; contextWindow: number; percent: number | null } | undefined },
 	): StudioContextUsageSnapshot => {
@@ -4036,7 +4151,7 @@ export default function (pi: ExtensionAPI) {
 				parsedBody && typeof parsedBody === "object" && typeof (parsedBody as { resourceDir?: unknown }).resourceDir === "string"
 					? (parsedBody as { resourceDir: string }).resourceDir
 					: "";
-			const resourcePath = sourcePath ? dirname(sourcePath) : (userResourceDir || studioCwd || undefined);
+			const resourcePath = resolveStudioBaseDir(sourcePath || undefined, userResourceDir || undefined, studioCwd);
 			const isLatex = /\\documentclass\b|\\begin\{document\}/.test(markdown);
 			const html = await renderStudioMarkdownWithPandoc(markdown, isLatex, resourcePath);
 			respondJson(res, 200, { ok: true, html, renderer: "pandoc" });
@@ -4090,7 +4205,7 @@ export default function (pi: ExtensionAPI) {
 			parsedBody && typeof parsedBody === "object" && typeof (parsedBody as { resourceDir?: unknown }).resourceDir === "string"
 				? (parsedBody as { resourceDir: string }).resourceDir
 				: "";
-		const resourcePath = sourcePath ? dirname(sourcePath) : (userResourceDir || studioCwd || undefined);
+		const resourcePath = resolveStudioBaseDir(sourcePath || undefined, userResourceDir || undefined, studioCwd);
 		const requestedIsLatex =
 			parsedBody && typeof parsedBody === "object" && typeof (parsedBody as { isLatex?: unknown }).isLatex === "boolean"
 				? (parsedBody as { isLatex: boolean }).isLatex
@@ -4418,6 +4533,7 @@ export default function (pi: ExtensionAPI) {
 	const stopServer = async () => {
 		if (!serverState) return;
 		clearActiveRequest();
+		clearPendingStudioCompletion();
 		clearCompactionState();
 		closeAllClients(1001, "Server shutting down");
 
@@ -4449,6 +4565,7 @@ export default function (pi: ExtensionAPI) {
 		hydrateLatestAssistant(ctx.sessionManager.getBranch());
 		clearCompactionState();
 		agentBusy = false;
+		clearPendingStudioCompletion();
 		refreshRuntimeMetadata({ cwd: ctx.cwd, model: ctx.model });
 		refreshContextUsage(ctx);
 		emitDebugEvent("session_start", {
@@ -4467,6 +4584,7 @@ export default function (pi: ExtensionAPI) {
 		lastCommandCtx = null;
 		hydrateLatestAssistant(ctx.sessionManager.getBranch());
 		agentBusy = false;
+		clearPendingStudioCompletion();
 		refreshRuntimeMetadata({ cwd: ctx.cwd, model: ctx.model });
 		refreshContextUsage(ctx);
 		emitDebugEvent("session_switch", {
@@ -4627,10 +4745,8 @@ export default function (pi: ExtensionAPI) {
 				responseHistory: studioResponseHistory,
 			});
 			broadcastResponseHistory();
-			clearActiveRequest({
-				terminalNotify: getStudioRequestCompletionNotification(kind),
-				terminalNotifyLevel: "info",
-			});
+			pendingStudioCompletionKind = kind;
+			clearActiveRequest();
 			return;
 		}
 
@@ -4667,6 +4783,7 @@ export default function (pi: ExtensionAPI) {
 			activeRequestKind: activeRequest?.kind ?? null,
 			suppressedRequestId: suppressedStudioResponse?.requestId ?? null,
 			suppressedRequestKind: suppressedStudioResponse?.kind ?? null,
+			pendingCompletionKind: pendingStudioCompletionKind,
 		});
 		setTerminalActivity("idle");
 		if (activeRequest) {
@@ -4677,6 +4794,9 @@ export default function (pi: ExtensionAPI) {
 				message: "Request ended without a complete assistant response.",
 			});
 			clearActiveRequest();
+			clearPendingStudioCompletion();
+		} else {
+			flushPendingStudioCompletionNotification();
 		}
 		suppressedStudioResponse = null;
 	});
@@ -4684,6 +4804,7 @@ export default function (pi: ExtensionAPI) {
 	pi.on("session_shutdown", async () => {
 		lastCommandCtx = null;
 		agentBusy = false;
+		clearPendingStudioCompletion();
 		clearCompactionState();
 		setTerminalActivity("idle");
 		await stopServer();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-studio",
-  "version": "0.5.18",
+  "version": "0.5.20",
   "description": "Browser GUI for structured critique workflows in pi",
   "type": "module",
   "license": "MIT",