pi-studio 0.5.9 → 0.5.11

package/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to `pi-studio` are documented here.
 
 ## [Unreleased]
 
+## [0.5.11] — 2026-03-15
+
+### Added
+- Studio tabs now show a title attention marker like `● Response ready` or `● Critique ready` when a Studio-started model request finishes while the tab is unfocused, and clear that marker when the tab regains focus or the next Studio request starts.
+
+## [0.5.10] — 2026-03-14
+
+### Fixed
+- Studio preview/PDF math normalization is now more robust for model-emitted `\(...\)` / `\[...\]` math, including malformed mixed delimiters like `$\(...\)$`, optional spacing around those mixed delimiters, and multiline display-math line-break formatting that previously leaked raw/broken `$$` output into preview.
+
 ## [0.5.9] — 2026-03-13
 
 ### Fixed

package/index.ts

@@ -991,13 +991,58 @@ async function fetchLatestNpmVersion(packageName: string, timeoutMs = UPDATE_CHE
 	}
 }
 
+function isLikelyMathExpression(expr: string): boolean {
+	const content = expr.trim();
+	if (content.length === 0) return false;
+
+	if (/\\[a-zA-Z]+/.test(content)) return true; // LaTeX commands like \frac, \alpha
+	if (/[0-9]/.test(content)) return true;
+	if (/[=+\-*/^_<>≤≥±×÷]/u.test(content)) return true;
+	if (/[{}]/.test(content)) return true;
+	if (/[α-ωΑ-Ω]/u.test(content)) return true;
+	if (/^[A-Za-z]$/.test(content)) return true; // single-variable forms like \(x\)
+
+	// Plain words (e.g. escaped markdown like \[not a link\]) are not math.
+	if (/^[A-Za-z][A-Za-z\s'".,:;!?-]*[A-Za-z]$/.test(content)) return false;
+
+	return false;
+}
+
+function collapseDisplayMathContent(expr: string): string {
+	let content = expr.trim();
+	if (content.includes("\\\\") || content.includes("\n")) {
+		content = content.replace(/\\\\\s*/g, " ");
+		content = content.replace(/\s*\n\s*/g, " ");
+		content = content.replace(/\s{2,}/g, " ").trim();
+	}
+	return content;
+}
+
 function normalizeMathDelimitersInSegment(markdown: string): string {
-	let normalized = markdown.replace(/\\\[\s*([\s\S]*?)\s*\\\]/g, (_match, expr: string) => {
+	let normalized = markdown.replace(/\$\s*\\\(([\s\S]*?)\\\)\s*\$/g, (match, expr: string) => {
+		if (!isLikelyMathExpression(expr)) return match;
+		const content = expr.trim();
+		return content.length > 0 ? `\\(${content}\\)` : "\\(\\)";
+	});
+
+	normalized = normalized.replace(/\$\s*\\\[\s*([\s\S]*?)\s*\\\]\s*\$/g, (match, expr: string) => {
+		if (!isLikelyMathExpression(expr)) return match;
+		const content = collapseDisplayMathContent(expr);
+		return content.length > 0 ? `\\[${content}\\]` : "\\[\\]";
+	});
+
+	normalized = normalized.replace(/\\\[\s*([\s\S]*?)\s*\\\]/g, (match, expr: string) => {
+		if (!isLikelyMathExpression(expr)) return `[${expr.trim()}]`;
+		const content = collapseDisplayMathContent(expr);
+		return content.length > 0 ? `\\[${content}\\]` : "\\[\\]";
+	});
+
+	normalized = normalized.replace(/\\\(([\s\S]*?)\\\)/g, (match, expr: string) => {
+		if (!isLikelyMathExpression(expr)) return `(${expr})`;
 		const content = expr.trim();
-		return content.length > 0 ? `$$\n${content}\n$$` : "$$\n$$";
+		return content.length > 0 ? `\\(${content}\\)` : "\\(\\)";
 	});
 
-	normalized = normalized.replace(/\\\(([\s\S]*?)\\\)/g, (_match, expr: string) => `$${expr}$`);
 	return normalized;
 }
 
@@ -1216,7 +1261,7 @@ 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+tex_math_dollars+autolink_bare_uris-raw_html";
+	const inputFormat = isLatex ? "latex" : "markdown+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"];
 	if (resourcePath) {
 		args.push(`--resource-path=${resourcePath}`);
@@ -1288,7 +1333,7 @@ async function renderStudioPdfWithPandoc(
 	const pdfEngine = process.env.PANDOC_PDF_ENGINE?.trim() || "xelatex";
 	const inputFormat = isLatex
 		? "latex"
-		: "markdown+tex_math_dollars+autolink_bare_uris+superscript+subscript-raw_html";
+		: "markdown+tex_math_dollars+tex_math_single_backslash+tex_math_double_backslash+autolink_bare_uris+superscript+subscript-raw_html";
 	const normalizedMarkdown = isLatex ? markdown : normalizeObsidianImages(normalizeMathDelimiters(markdown));
 
 	const tempDir = join(tmpdir(), `pi-studio-pdf-${Date.now()}-${randomUUID()}`);
@@ -3494,6 +3539,10 @@ ${cssVarsBlock}
       let contextPercent = null;
       let updateInstalledVersion = null;
       let updateLatestVersion = null;
+      let windowHasFocus = typeof document.hasFocus === "function" ? document.hasFocus() : true;
+      let titleAttentionMessage = "";
+      let titleAttentionRequestId = null;
+      let titleAttentionRequestKind = null;
 
       function parseFiniteNumber(value) {
         if (value == null || value === "") return null;
@@ -3854,12 +3903,63 @@ ${cssVarsBlock}
         return changed;
       }
 
+      function isTitleAttentionRequestKind(kind) {
+        return kind === "annotation" || kind === "critique" || kind === "direct";
+      }
+
+      function armTitleAttentionForRequest(requestId, kind) {
+        if (typeof requestId !== "string" || !isTitleAttentionRequestKind(kind)) {
+          titleAttentionRequestId = null;
+          titleAttentionRequestKind = null;
+          return;
+        }
+        titleAttentionRequestId = requestId;
+        titleAttentionRequestKind = kind;
+      }
+
+      function clearArmedTitleAttention(requestId) {
+        if (typeof requestId === "string" && titleAttentionRequestId && requestId !== titleAttentionRequestId) {
+          return;
+        }
+        titleAttentionRequestId = null;
+        titleAttentionRequestKind = null;
+      }
+
+      function clearTitleAttention() {
+        if (!titleAttentionMessage) return;
+        titleAttentionMessage = "";
+        updateDocumentTitle();
+      }
+
+      function shouldShowTitleAttention() {
+        const focused = typeof document.hasFocus === "function" ? document.hasFocus() : windowHasFocus;
+        return Boolean(document.hidden) || !focused;
+      }
+
+      function getTitleAttentionMessage(kind) {
+        if (kind === "critique") return "● Critique ready";
+        if (kind === "direct") return "● Response ready";
+        return "● Reply ready";
+      }
+
+      function maybeShowTitleAttentionForCompletedRequest(requestId, kind) {
+        const matchedRequest = typeof requestId === "string" && titleAttentionRequestId && requestId === titleAttentionRequestId;
+        const completedKind = isTitleAttentionRequestKind(kind) ? kind : titleAttentionRequestKind;
+        clearArmedTitleAttention(requestId);
+        if (!matchedRequest || !completedKind || !shouldShowTitleAttention()) {
+          return;
+        }
+        titleAttentionMessage = getTitleAttentionMessage(completedKind);
+        updateDocumentTitle();
+      }
+
       function updateDocumentTitle() {
         const modelText = modelLabel && modelLabel.trim() ? modelLabel.trim() : "none";
         const terminalText = terminalSessionLabel && terminalSessionLabel.trim() ? terminalSessionLabel.trim() : "unknown";
         const titleParts = ["pi Studio"];
         if (terminalText && terminalText !== "unknown") titleParts.push(terminalText);
         if (modelText && modelText !== "none") titleParts.push(modelText);
+        if (titleAttentionMessage) titleParts.unshift(titleAttentionMessage);
         document.title = titleParts.join(" · ");
       }
 
@@ -3953,6 +4053,24 @@ ${cssVarsBlock}
 
       renderStatus();
 
+      window.addEventListener("focus", () => {
+        windowHasFocus = true;
+        clearTitleAttention();
+      });
+
+      window.addEventListener("blur", () => {
+        windowHasFocus = false;
+      });
+
+      document.addEventListener("visibilitychange", () => {
+        if (!document.hidden) {
+          windowHasFocus = typeof document.hasFocus === "function" ? document.hasFocus() : windowHasFocus;
+          if (windowHasFocus) {
+            clearTitleAttention();
+          }
+        }
+      });
+
       function updateSourceBadge() {
         const label = sourceState && sourceState.label ? sourceState.label : "blank";
         sourceBadgeEl.textContent = "Editor origin: " + label;
@@ -5765,8 +5883,10 @@ ${cssVarsBlock}
           setStatus("No matching Studio request is running.", "warning");
           return false;
         }
-        const sent = sendMessage({ type: "cancel_request", requestId: pendingRequestId });
+        const requestId = pendingRequestId;
+        const sent = sendMessage({ type: "cancel_request", requestId });
         if (!sent) return false;
+        clearArmedTitleAttention(requestId);
         setStatus("Stopping request…", "warning");
         return true;
       }
@@ -6074,6 +6194,7 @@ ${cssVarsBlock}
             return;
           }
 
+          const completedRequestId = typeof message.requestId === "string" ? message.requestId : pendingRequestId;
           const responseKind =
             typeof message.kind === "string"
               ? message.kind
@@ -6106,6 +6227,7 @@ ${cssVarsBlock}
           } else {
             setStatus("Response ready.", "success");
           }
+          maybeShowTitleAttentionForCompletedRequest(completedRequestId, responseKind);
           return;
         }
 
@@ -6307,6 +6429,9 @@ ${cssVarsBlock}
             pendingRequestId = null;
             pendingKind = null;
           }
+          if (typeof message.requestId === "string") {
+            clearArmedTitleAttention(message.requestId);
+          }
           stickyStudioKind = null;
           setBusy(false);
           setWsState("Ready");
@@ -6322,6 +6447,9 @@ ${cssVarsBlock}
             pendingRequestId = null;
             pendingKind = null;
           }
+          if (typeof message.requestId === "string") {
+            clearArmedTitleAttention(message.requestId);
+          }
           stickyStudioKind = null;
           setBusy(false);
           setWsState("Ready");
@@ -6480,10 +6608,12 @@ ${cssVarsBlock}
           setStatus("Studio is busy.", "warning");
           return null;
         }
+        clearTitleAttention();
         const requestId = makeRequestId();
         pendingRequestId = requestId;
         pendingKind = kind;
         stickyStudioKind = kind;
+        armTitleAttentionForRequest(requestId, kind);
         setBusy(true);
         setWsState("Submitting");
         setStatus(getStudioBusyStatus(kind), "warning");

package/package.json

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