pi-studio 0.5.28 → 0.5.30

package/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to `pi-studio` are documented here.
 
 ## [Unreleased]
 
+## [0.5.30] — 2026-03-24
+
+### Fixed
+- LaTeX preview now preserves structured display-math environments such as `bmatrix` inside `\[ ... \]` instead of flattening their rows during Markdown math normalization, and preview display equations now center more robustly across browser engines.
+- Studio now highlights custom `[an: ...]` markers in LaTeX editor syntax-highlighting mode, and PDF export renders those markers as styled annotation badges for both Markdown and LaTeX documents instead of leaving the raw bracket syntax in the final PDF.
+- Right-pane response PDF export now also respects the current annotation-visibility mode, so hidden annotations do not leak into exported PDFs as raw `[an: ...]` text.
+
+## [0.5.29] — 2026-03-21
+
+### Changed
+- Studio keyboard shortcuts now keep `Cmd/Ctrl+Enter` for running editor text while using `Esc` to stop an active request, and the focus-pane hint/button copy now describes focus mode as a toggle via `F10` or `Cmd/Ctrl+Esc`.
+- While **Run editor text** is active, Studio now exposes a separate **Queue steering** action (and `Cmd/Ctrl+Enter` queues steering) while preserving a visible **Stop** control, and response-history prompt loading now preserves the effective prompt chain for steered responses rather than only the last correction message.
+
 ## [0.5.28] — 2026-03-21
 
 ### Changed

package/client/studio-client.js

@@ -78,6 +78,7 @@
       const getEditorBtn = document.getElementById("getEditorBtn");
       const loadGitDiffBtn = document.getElementById("loadGitDiffBtn");
       const sendRunBtn = document.getElementById("sendRunBtn");
+      const queueSteerBtn = document.getElementById("queueSteerBtn");
       const copyDraftBtn = document.getElementById("copyDraftBtn");
       const saveAnnotatedBtn = document.getElementById("saveAnnotatedBtn");
       const stripAnnotationsBtn = document.getElementById("stripAnnotationsBtn");
@@ -120,6 +121,8 @@
       let latestCritiqueNotesNormalized = "";
       let responseHistory = [];
       let responseHistoryIndex = -1;
+      let studioRunChainActive = false;
+      let queuedSteeringCount = 0;
       let agentBusyFromServer = false;
       let terminalActivityPhase = "idle";
       let terminalActivityToolName = "";
@@ -152,6 +155,23 @@
         return trimmed ? trimmed : null;
       }
 
+      function applyStudioRunQueueStateFromMessage(message) {
+        if (!message || typeof message !== "object") return false;
+        let changed = false;
+        if (typeof message.studioRunChainActive === "boolean" && studioRunChainActive !== message.studioRunChainActive) {
+          studioRunChainActive = message.studioRunChainActive;
+          changed = true;
+        }
+        if (typeof message.queuedSteeringCount === "number" && Number.isFinite(message.queuedSteeringCount)) {
+          const nextCount = Math.max(0, Math.floor(message.queuedSteeringCount));
+          if (queuedSteeringCount !== nextCount) {
+            queuedSteeringCount = nextCount;
+            changed = true;
+          }
+        }
+        return changed;
+      }
+
       contextTokens = parseFiniteNumber(document.body && document.body.dataset ? document.body.dataset.contextTokens : null);
       contextWindow = parseFiniteNumber(document.body && document.body.dataset ? document.body.dataset.contextWindow : null);
       contextPercent = parseFiniteNumber(document.body && document.body.dataset ? document.body.dataset.contextPercent : null);
@@ -383,26 +403,80 @@
         return "submitting request";
       }
 
+      function formatQueuedSteeringSuffix() {
+        if (!queuedSteeringCount) return "";
+        return queuedSteeringCount === 1
+          ? " · 1 steering queued"
+          : " · " + queuedSteeringCount + " steering queued";
+      }
+
       function getStudioBusyStatus(kind) {
         const action = getStudioActionLabel(kind);
+        const queueSuffix = studioRunChainActive ? formatQueuedSteeringSuffix() : "";
         if (terminalActivityPhase === "tool") {
           if (terminalActivityLabel) {
-            return "Studio: " + withEllipsis(terminalActivityLabel);
+            return "Studio: " + withEllipsis(terminalActivityLabel) + queueSuffix;
           }
           return terminalActivityToolName
-            ? "Studio: " + action + " (tool: " + terminalActivityToolName + ")…"
-            : "Studio: " + action + " (running tool)…";
+            ? "Studio: " + action + " (tool: " + terminalActivityToolName + ")…" + queueSuffix
+            : "Studio: " + action + " (running tool)…" + queueSuffix;
         }
         if (terminalActivityPhase === "responding") {
           if (lastSpecificToolLabel) {
-            return "Studio: " + lastSpecificToolLabel + " (generating response)…";
+            return "Studio: " + lastSpecificToolLabel + " (generating response)…" + queueSuffix;
           }
-          return "Studio: " + action + " (generating response)…";
+          return "Studio: " + action + " (generating response)…" + queueSuffix;
         }
         if (terminalActivityPhase === "running" && lastSpecificToolLabel) {
-          return "Studio: " + withEllipsis(lastSpecificToolLabel);
+          return "Studio: " + withEllipsis(lastSpecificToolLabel) + queueSuffix;
+        }
+        return "Studio: " + action + "…" + queueSuffix;
+      }
+
+      function getHistoryPromptSourceLabel(item) {
+        if (!item || !item.promptMode) return null;
+        const steeringCount = typeof item.promptSteeringCount === "number" && Number.isFinite(item.promptSteeringCount)
+          ? Math.max(0, Math.floor(item.promptSteeringCount))
+          : 0;
+        if (item.promptMode === "run") return "original run";
+        if (item.promptMode !== "effective") return null;
+        if (steeringCount <= 0) return "original run";
+        return steeringCount === 1
+          ? "original run + 1 steering message"
+          : "original run + " + steeringCount + " steering messages";
+      }
+
+      function getHistoryPromptButtonLabel(item) {
+        if (!item || !item.prompt || !String(item.prompt).trim()) {
+          return "Response prompt unavailable";
+        }
+        if (item.promptMode === "effective") {
+          return "Load effective prompt into editor";
+        }
+        if (item.promptMode === "run") {
+          return "Load run prompt into editor";
+        }
+        return "Load response prompt into editor";
+      }
+
+      function getHistoryPromptLoadedStatus(item) {
+        if (!item || !item.prompt || !String(item.prompt).trim()) {
+          return "Prompt unavailable for the selected response.";
+        }
+        if (item.promptMode === "effective") {
+          return "Loaded effective prompt into editor.";
+        }
+        if (item.promptMode === "run") {
+          return "Loaded run prompt into editor.";
         }
-        return "Studio: " + action + "…";
+        return "Loaded response prompt into editor.";
+      }
+
+      function getHistoryPromptSourceStateLabel(item) {
+        if (!item || !item.prompt || !String(item.prompt).trim()) return "response prompt";
+        if (item.promptMode === "effective") return "effective prompt";
+        if (item.promptMode === "run") return "run prompt";
+        return "response prompt";
       }
 
       function shouldAnimateFooterSpinner() {
@@ -715,8 +789,8 @@
           btn.setAttribute("aria-pressed", isFocusedPane ? "true" : "false");
           btn.textContent = isFocusedPane ? "Exit focus" : "Focus pane";
           btn.title = isFocusedPane
-            ? "Exit focus mode for the " + paneName + " pane."
-            : "Show only the " + paneName + " pane. Shortcut: Cmd/Ctrl+Esc or F10.";
+            ? "Return to the two-pane layout. Shortcut: F10 or Cmd/Ctrl+Esc."
+            : "Show only the " + paneName + " pane. Shortcut: F10 or Cmd/Ctrl+Esc.";
         });
       }
 
@@ -754,7 +828,7 @@
         setActivePane(pane);
         paneFocusTarget = pane;
         applyPaneFocusClasses();
-        setStatus("Focus mode: " + paneLabel(pane) + " pane (Esc to exit).");
+        setStatus("Focus mode: " + paneLabel(pane) + " pane. Toggle with F10 or Cmd/Ctrl+Esc.");
       }
 
       function togglePaneFocus() {
@@ -777,7 +851,7 @@
       }
 
       function handlePaneShortcut(event) {
-        if (!event) return;
+        if (!event || event.defaultPrevented) return;
 
         const key = typeof event.key === "string" ? event.key : "";
         const isToggleShortcut =
@@ -797,9 +871,16 @@
           && !event.altKey
           && !event.shiftKey
         ) {
+          const activeKind = getAbortablePendingKind();
+          if (activeKind === "direct" || activeKind === "critique") {
+            event.preventDefault();
+            requestCancelForPendingRequest(activeKind);
+            return;
+          }
           if (exitPaneFocus()) {
             event.preventDefault();
           }
+          return;
         }
 
         if (
@@ -808,11 +889,16 @@
           && !event.altKey
           && !event.shiftKey
           && activePane === "left"
-          && sendRunBtn
-          && !sendRunBtn.disabled
         ) {
-          event.preventDefault();
-          sendRunBtn.click();
+          if (queueSteerBtn && !queueSteerBtn.disabled) {
+            event.preventDefault();
+            queueSteerBtn.click();
+            return;
+          }
+          if (sendRunBtn && !sendRunBtn.disabled) {
+            event.preventDefault();
+            sendRunBtn.click();
+          }
         }
       }
 
@@ -851,6 +937,18 @@
         const thinking = typeof item.thinking === "string"
           ? item.thinking
           : (item.thinking == null ? null : String(item.thinking));
+        const promptMode = item.promptMode === "run" || item.promptMode === "effective"
+          ? item.promptMode
+          : "response";
+        const promptTriggerKind = item.promptTriggerKind === "run" || item.promptTriggerKind === "steer"
+          ? item.promptTriggerKind
+          : null;
+        const promptSteeringCount = typeof item.promptSteeringCount === "number" && Number.isFinite(item.promptSteeringCount)
+          ? Math.max(0, Math.floor(item.promptSteeringCount))
+          : 0;
+        const promptTriggerText = typeof item.promptTriggerText === "string"
+          ? item.promptTriggerText
+          : (item.promptTriggerText == null ? null : String(item.promptTriggerText));
 
         return {
           id,
@@ -859,6 +957,10 @@
           timestamp,
           kind: normalizeHistoryKind(item.kind),
           prompt,
+          promptMode,
+          promptTriggerKind,
+          promptSteeringCount,
+          promptTriggerText,
         };
       }
 
@@ -904,9 +1006,13 @@
         const hasPrompt = Boolean(selectedItem && typeof selectedItem.prompt === "string" && selectedItem.prompt.trim());
         if (loadHistoryPromptBtn) {
           loadHistoryPromptBtn.disabled = uiBusy || !hasPrompt;
-          loadHistoryPromptBtn.textContent = hasPrompt
-            ? "Load response prompt into editor"
-            : "Response prompt unavailable";
+          loadHistoryPromptBtn.textContent = getHistoryPromptButtonLabel(selectedItem);
+          const promptSourceLabel = getHistoryPromptSourceLabel(selectedItem);
+          loadHistoryPromptBtn.title = hasPrompt
+            ? (promptSourceLabel
+              ? "Load the " + promptSourceLabel + " prompt chain that generated the selected response into the editor."
+              : "Load the prompt that generated the selected response into the editor.")
+            : "Prompt unavailable for the selected response.";
         }
       }
 
@@ -1609,7 +1715,9 @@
           return;
         }
 
-        const markdown = rightView === "editor-preview" ? prepareEditorTextForPdfExport(sourceTextEl.value) : latestResponseMarkdown;
+        const markdown = rightView === "editor-preview"
+          ? prepareEditorTextForPdfExport(sourceTextEl.value)
+          : prepareEditorTextForPreview(latestResponseMarkdown);
         if (!markdown || !markdown.trim()) {
           setStatus("Nothing to export yet.", "warning");
           return;
@@ -2452,17 +2560,49 @@
         }
 
         if (lang === "latex") {
-          const texPattern = /(%.*$)|(\\(?:documentclass|usepackage|newtheorem|begin|end|section|subsection|subsubsection|chapter|part|title|author|date|maketitle|tableofcontents|includegraphics|caption|label|ref|eqref|cite|textbf|textit|texttt|emph|footnote|centering|newcommand|renewcommand|providecommand|bibliography|bibliographystyle|bibitem|item|input|include)\b)|(\\[A-Za-z]+)|(\{|\})|(\$\$?(?:[^$\\]|\\.)+\$\$?)|(\[(?:.*?)\])/g;
-          const highlighted = highlightCodeTokens(source, texPattern, (match) => {
-            if (match[1]) return "hl-code-com";
-            if (match[2]) return "hl-code-kw";
-            if (match[3]) return "hl-code-fn";
-            if (match[4]) return "hl-code-op";
-            if (match[5]) return "hl-code-str";
-            if (match[6]) return "hl-code-num";
-            return "hl-code";
-          });
-          return highlighted;
+          const texPattern = /(%.*$)|(\[an:\s*[^\]]+\])|(\\(?:documentclass|usepackage|newtheorem|begin|end|section|subsection|subsubsection|chapter|part|title|author|date|maketitle|tableofcontents|includegraphics|caption|label|ref|eqref|cite|textbf|textit|texttt|emph|footnote|centering|newcommand|renewcommand|providecommand|bibliography|bibliographystyle|bibitem|item|input|include)\b)|(\\[A-Za-z]+)|(\{|\})|(\$\$?(?:[^$\\]|\\.)+\$\$?)|(\[(?:.*?)\])/gi;
+          let out = "";
+          let lastIndex = 0;
+          texPattern.lastIndex = 0;
+
+          let match;
+          while ((match = texPattern.exec(source)) !== null) {
+            const token = match[0] || "";
+            const start = typeof match.index === "number" ? match.index : 0;
+
+            if (start > lastIndex) {
+              out += escapeHtml(source.slice(lastIndex, start));
+            }
+
+            if (match[1]) {
+              out += wrapHighlight("hl-code-com", token);
+            } else if (match[2]) {
+              out += highlightInlineAnnotations(token, renderMode);
+            } else if (match[3]) {
+              out += wrapHighlight("hl-code-kw", token);
+            } else if (match[4]) {
+              out += wrapHighlight("hl-code-fn", token);
+            } else if (match[5]) {
+              out += wrapHighlight("hl-code-op", token);
+            } else if (match[6]) {
+              out += wrapHighlight("hl-code-str", token);
+            } else if (match[7]) {
+              out += wrapHighlight("hl-code-num", token);
+            } else {
+              out += escapeHtml(token);
+            }
+
+            lastIndex = start + token.length;
+            if (token.length === 0) {
+              texPattern.lastIndex += 1;
+            }
+          }
+
+          if (lastIndex < source.length) {
+            out += escapeHtml(source.slice(lastIndex));
+          }
+
+          return out;
         }
 
         if (lang === "diff") {
@@ -2806,29 +2946,43 @@
 
       function syncRunAndCritiqueButtons() {
         const activeKind = getAbortablePendingKind();
-        const sendRunIsStop = activeKind === "direct";
+        const directIsStop = activeKind === "direct";
         const critiqueIsStop = activeKind === "critique";
+        const canQueueSteering = studioRunChainActive && !critiqueIsStop;
 
         if (sendRunBtn) {
-          sendRunBtn.textContent = sendRunIsStop ? "Stop" : "Run editor text";
-          sendRunBtn.classList.toggle("request-stop-active", sendRunIsStop);
-          sendRunBtn.disabled = sendRunIsStop ? wsState === "Disconnected" : (uiBusy || critiqueIsStop);
-          sendRunBtn.title = sendRunIsStop
-            ? "Stop the running editor-text request."
+          sendRunBtn.textContent = directIsStop ? "Stop" : "Run editor text";
+          sendRunBtn.classList.toggle("request-stop-active", directIsStop);
+          sendRunBtn.disabled = wsState === "Disconnected" || (!directIsStop && (uiBusy || critiqueIsStop));
+          sendRunBtn.title = directIsStop
+            ? "Stop the active run. Shortcut: Esc."
             : (annotationsEnabled
-              ? "Run editor text as-is (includes [an: ...] markers). Shortcut: Cmd/Ctrl+Enter."
-              : "Run editor text with [an: ...] markers stripped. Shortcut: Cmd/Ctrl+Enter.");
+              ? "Run editor text as-is (includes [an: ...] markers). Shortcut: Cmd/Ctrl+Enter. Stop the active request with Esc."
+              : "Run editor text with [an: ...] markers stripped. Shortcut: Cmd/Ctrl+Enter. Stop the active request with Esc.");
+        }
+
+        if (queueSteerBtn) {
+          queueSteerBtn.hidden = false;
+          queueSteerBtn.disabled = wsState === "Disconnected" || !canQueueSteering;
+          queueSteerBtn.classList.remove("request-stop-active");
+          queueSteerBtn.title = canQueueSteering
+            ? (annotationsEnabled
+              ? "Queue the current editor text as a steering message for the active run. Shortcut: Cmd/Ctrl+Enter."
+              : "Queue the current editor text as a steering message for the active run after stripping [an: ...] markers. Shortcut: Cmd/Ctrl+Enter.")
+            : "Queue steering is available while Run editor text is active.";
         }
 
         if (critiqueBtn) {
           critiqueBtn.textContent = critiqueIsStop ? "Stop" : "Critique editor text";
           critiqueBtn.classList.toggle("request-stop-active", critiqueIsStop);
-          critiqueBtn.disabled = critiqueIsStop ? wsState === "Disconnected" : (uiBusy || sendRunIsStop);
+          critiqueBtn.disabled = critiqueIsStop ? wsState === "Disconnected" : (uiBusy || canQueueSteering);
           critiqueBtn.title = critiqueIsStop
-            ? "Stop the running critique request."
-            : (annotationsEnabled
-              ? "Critique editor text as-is (includes [an: ...] markers)."
-              : "Critique editor text with [an: ...] markers stripped.");
+            ? "Stop the running critique request. Shortcut: Esc."
+            : (canQueueSteering
+              ? "Critique queueing is not supported while Run editor text is active."
+              : (annotationsEnabled
+                ? "Critique editor text as-is (includes [an: ...] markers)."
+                : "Critique editor text with [an: ...] markers stripped."));
         }
       }
 
@@ -2973,6 +3127,7 @@
           if (typeof message.terminalSessionLabel === "string") {
             terminalSessionLabel = message.terminalSessionLabel;
           }
+          applyStudioRunQueueStateFromMessage(message);
           updateFooterMeta();
           setBusy(busy);
           setWsState(busy ? "Submitting" : "Ready");
@@ -3045,6 +3200,8 @@
           if (busy) {
             if (agentBusyFromServer && stickyStudioKind) {
               setStatus(getStudioBusyStatus(stickyStudioKind), "warning");
+            } else if (agentBusyFromServer && studioRunChainActive) {
+              setStatus(getStudioBusyStatus("direct"), "warning");
             } else if (agentBusyFromServer) {
               setStatus(getTerminalBusyStatus(), "warning");
             } else {
@@ -3065,6 +3222,9 @@
           pendingRequestId = typeof message.requestId === "string" ? message.requestId : pendingRequestId;
           pendingKind = typeof message.kind === "string" ? message.kind : "unknown";
           stickyStudioKind = pendingKind;
+          if (pendingKind === "direct") {
+            studioRunChainActive = true;
+          }
           if (pendingKind === "compact") {
             compactInProgress = true;
           }
@@ -3074,6 +3234,14 @@
           return;
         }
 
+        if (message.type === "request_queued") {
+          studioRunChainActive = true;
+          applyStudioRunQueueStateFromMessage(message);
+          syncActionButtons();
+          setStatus("Steering queued.", "success");
+          return;
+        }
+
         if (message.type === "compaction_completed") {
           if (typeof message.requestId === "string" && pendingRequestId === message.requestId) {
             pendingRequestId = null;
@@ -3310,6 +3478,7 @@
           if (typeof message.terminalSessionLabel === "string") {
             terminalSessionLabel = message.terminalSessionLabel;
           }
+          applyStudioRunQueueStateFromMessage(message);
           updateFooterMeta();
 
           if (typeof message.activeRequestId === "string" && message.activeRequestId.length > 0) {
@@ -3346,6 +3515,8 @@
           if (busy) {
             if (agentBusyFromServer && stickyStudioKind) {
               setStatus(getStudioBusyStatus(stickyStudioKind), "warning");
+            } else if (agentBusyFromServer && studioRunChainActive) {
+              setStatus(getStudioBusyStatus("direct"), "warning");
             } else if (agentBusyFromServer) {
               setStatus(getTerminalBusyStatus(), "warning");
             } else {
@@ -3816,8 +3987,8 @@
           }
 
           setEditorText(prompt, { preserveScroll: false, preserveSelection: false });
-          setSourceState({ source: "blank", label: "response prompt", path: null });
-          setStatus("Loaded response prompt into editor.", "success");
+          setSourceState({ source: "blank", label: getHistoryPromptSourceStateLabel(item), path: null });
+          setStatus(getHistoryPromptLoadedStatus(item), "success");
         });
       }
 
@@ -4118,6 +4289,30 @@
         }
       });
 
+      if (queueSteerBtn) {
+        queueSteerBtn.addEventListener("click", () => {
+          const prepared = prepareEditorTextForSend(sourceTextEl.value);
+          if (!prepared.trim()) {
+            setStatus("Editor is empty. Nothing to queue.", "warning");
+            return;
+          }
+          if (!studioRunChainActive) {
+            setStatus("Queue steering is only available while Run editor text is active.", "warning");
+            return;
+          }
+
+          const requestId = makeRequestId();
+          clearTitleAttention();
+          const sent = sendMessage({
+            type: "send_run_request",
+            requestId,
+            text: prepared,
+          });
+          if (!sent) return;
+          setStatus("Queueing steering…", "warning");
+        });
+      }
+
       copyDraftBtn.addEventListener("click", async () => {
         const content = sourceTextEl.value;
         if (!content.trim()) {

package/client/studio.css

@@ -87,6 +87,7 @@
     }
 
     #sendRunBtn,
+    #queueSteerBtn,
     #critiqueBtn {
       min-width: 10rem;
       display: inline-flex;
@@ -95,6 +96,7 @@
     }
 
     #sendRunBtn:not(:disabled):not(.request-stop-active),
+    #queueSteerBtn:not(:disabled),
     #loadResponseBtn:not(:disabled):not([hidden]) {
       background: var(--accent);
       border-color: var(--accent);
@@ -103,6 +105,7 @@
     }
 
     #sendRunBtn:not(:disabled):not(.request-stop-active):hover,
+    #queueSteerBtn:not(:disabled):hover,
     #loadResponseBtn:not(:disabled):not([hidden]):hover {
       filter: brightness(0.95);
     }
@@ -871,7 +874,9 @@
 
     .rendered-markdown mjx-container[display="true"] {
       display: block;
-      margin: 1em 0;
+      width: fit-content;
+      max-width: 100%;
+      margin: 1em auto;
       text-align: center;
       overflow-x: auto;
       overflow-y: hidden;
@@ -890,7 +895,7 @@
 
     .rendered-markdown .studio-display-equation-body math[display="block"],
     .rendered-markdown .studio-display-equation-body mjx-container[display="true"] {
-      margin: 0;
+      margin: 0 auto;
     }
 
     .rendered-markdown .studio-display-equation-number {
@@ -907,7 +912,9 @@
 
     .rendered-markdown math[display="block"] {
       display: block;
-      margin: 1em 0;
+      width: fit-content;
+      max-width: 100%;
+      margin: 1em auto;
       text-align: center;
       overflow-x: auto;
       overflow-y: hidden;