pi-studio 0.9.11 → 0.9.13

package/client/studio-client.js

@@ -61,6 +61,7 @@
       const editorSelectionJumpBtn = document.getElementById("editorSelectionJumpBtn");
       const leftPaneEl = document.getElementById("leftPane");
       const rightPaneEl = document.getElementById("rightPane");
+      const paneResizeHandleEl = document.getElementById("paneResizeHandle");
       const sourceBadgeEl = document.getElementById("sourceBadge");
       const syncBadgeEl = document.getElementById("syncBadge");
       let critiqueViewEl = document.getElementById("critiqueView");
@@ -102,6 +103,7 @@
       const saveAsBtn = document.getElementById("saveAsBtn");
       const saveOverBtn = document.getElementById("saveOverBtn");
       const refreshFromDiskBtn = document.getElementById("refreshFromDiskBtn");
+      const clearWorkspaceBtn = document.getElementById("clearWorkspaceBtn");
       const sendEditorBtn = document.getElementById("sendEditorBtn");
       const openCompanionBtn = document.getElementById("openCompanionBtn");
       const getEditorBtn = document.getElementById("getEditorBtn");
@@ -246,6 +248,7 @@
       const PDF_EXPORT_FETCH_TIMEOUT_MS = 180_000;
       const HTML_EXPORT_FETCH_TIMEOUT_MS = 180_000;
       const HTML_ARTIFACT_MATH_RENDER_FETCH_TIMEOUT_MS = 30_000;
+      const HTML_ARTIFACT_RESOURCE_FETCH_TIMEOUT_MS = 30_000;
       const EDITOR_TAB_TEXT = "  ";
       const QUIZ_DEFAULT_COUNT = 5;
       const QUIZ_SCOPES = ["editor", "selection", "file", "folder", "repo"];
@@ -288,6 +291,15 @@
           return "python";
         }
       })();
+      let replCommandOverrides = (() => {
+        try {
+          const raw = window.localStorage && window.localStorage.getItem("piStudio.replCommandOverrides");
+          const parsed = raw ? JSON.parse(raw) : {};
+          return parsed && typeof parsed === "object" ? parsed : {};
+        } catch {
+          return {};
+        }
+      })();
       let replTranscript = "";
       let replError = "";
       let replMessage = "";
@@ -952,11 +964,26 @@
         setStatus("Loaded visible working into editor.", "success");
       }
 
-      function normalizeReplRuntime(value) {
+      function getKnownReplRuntime(value) {
         const runtime = String(value || "").trim().toLowerCase();
         return runtime === "shell" || runtime === "python" || runtime === "ipython" || runtime === "julia" || runtime === "r" || runtime === "ghci" || runtime === "clojure"
           ? runtime
-          : "python";
+          : "";
+      }
+
+      function normalizeReplRuntime(value) {
+        return getKnownReplRuntime(value) || "python";
+      }
+
+      function getReplRuntimeLabel(value) {
+        const runtime = normalizeReplRuntime(value);
+        if (runtime === "shell") return "Shell";
+        if (runtime === "python") return "Python";
+        if (runtime === "ipython") return "IPython";
+        if (runtime === "julia") return "Julia";
+        if (runtime === "r") return "R";
+        if (runtime === "ghci") return "GHCi";
+        return "Clojure";
       }
 
       function normalizeReplSession(session) {
@@ -981,6 +1008,47 @@
         }
       }
 
+      function normalizeReplCommandOverride(value) {
+        return String(value || "").replace(/\r?\n/g, " ").replace(/\s+/g, " ").trim().slice(0, 240);
+      }
+
+      function getReplCommandOverride(runtime) {
+        const normalizedRuntime = normalizeReplRuntime(runtime || replRuntime);
+        const value = replCommandOverrides && typeof replCommandOverrides === "object"
+          ? replCommandOverrides[normalizedRuntime]
+          : "";
+        return normalizeReplCommandOverride(value);
+      }
+
+      function persistReplCommandOverrides() {
+        try {
+          if (window.localStorage) window.localStorage.setItem("piStudio.replCommandOverrides", JSON.stringify(replCommandOverrides || {}));
+        } catch {
+          // Ignore storage failures.
+        }
+      }
+
+      function setReplCommandOverride(runtime, command) {
+        const normalizedRuntime = normalizeReplRuntime(runtime || replRuntime);
+        const normalizedCommand = normalizeReplCommandOverride(command);
+        replCommandOverrides = replCommandOverrides && typeof replCommandOverrides === "object" ? replCommandOverrides : {};
+        if (normalizedCommand) {
+          replCommandOverrides[normalizedRuntime] = normalizedCommand;
+        } else {
+          delete replCommandOverrides[normalizedRuntime];
+        }
+        persistReplCommandOverrides();
+      }
+
+      function getCurrentReplStartCommandFromDom() {
+        if (!critiqueViewEl || typeof critiqueViewEl.querySelector !== "function") return getReplCommandOverride(replRuntime);
+        const inputEl = critiqueViewEl.querySelector("[data-repl-command]");
+        if (inputEl && "value" in inputEl) {
+          return normalizeReplCommandOverride(inputEl.value);
+        }
+        return getReplCommandOverride(replRuntime);
+      }
+
       function normalizeReplSendMode(value) {
         return String(value || "").trim().toLowerCase() === "literate" ? "literate" : "raw";
       }
@@ -1056,7 +1124,10 @@
           ? sessions.map(normalizeReplSession).filter(Boolean)
           : [];
         if (replActiveSessionName && !replSessions.some((session) => session.sessionName === replActiveSessionName)) {
-          replActiveSessionName = replSessions[0] ? replSessions[0].sessionName : "";
+          setActiveReplSession("");
+        }
+        if (!getActiveReplSessionForCurrentRuntime()) {
+          selectReplSessionForRuntime(replRuntime, replActiveSessionName);
         }
         return previous !== serializeReplSessionsForCompare(replSessions) || previousActive !== replActiveSessionName;
       }
@@ -1065,9 +1136,43 @@
         return replSessions.find((session) => session.sessionName === replActiveSessionName) || null;
       }
 
+      function isReplSessionRuntimeCompatible(session, runtime) {
+        if (!session) return false;
+        const sessionRuntime = getKnownReplRuntime(session.runtime);
+        return Boolean(sessionRuntime) && sessionRuntime === normalizeReplRuntime(runtime);
+      }
+
+      function getReplSessionsForRuntime(runtime) {
+        const normalizedRuntime = normalizeReplRuntime(runtime);
+        return replSessions.filter((session) => isReplSessionRuntimeCompatible(session, normalizedRuntime));
+      }
+
+      function selectReplSessionForRuntime(runtime, preferredSessionName) {
+        const sessions = getReplSessionsForRuntime(runtime);
+        const preferred = String(preferredSessionName || "").trim();
+        const selected = sessions.find((session) => session.sessionName === preferred) || sessions[0] || null;
+        setActiveReplSession(selected ? selected.sessionName : "");
+        return selected;
+      }
+
+      function setActiveReplSessionForCurrentRuntime(sessionName) {
+        const name = String(sessionName || "").trim();
+        const candidate = name ? replSessions.find((session) => session.sessionName === name) : null;
+        if (candidate && isReplSessionRuntimeCompatible(candidate, replRuntime)) {
+          setActiveReplSession(candidate.sessionName);
+          return candidate;
+        }
+        return selectReplSessionForRuntime(replRuntime, replActiveSessionName);
+      }
+
+      function getActiveReplSessionForCurrentRuntime() {
+        const session = getActiveReplSession();
+        return isReplSessionRuntimeCompatible(session, replRuntime) ? session : null;
+      }
+
       function buildActiveReplPromptContext() {
         if (rightView !== "repl") return "";
-        const session = getActiveReplSession();
+        const session = getActiveReplSessionForCurrentRuntime();
         if (!session) return "";
         const runtime = session.runtime && session.runtime !== "unknown" ? session.runtime : "unknown";
         return [
@@ -1162,7 +1267,7 @@
       }
 
       function getActiveReplRuntime() {
-        const session = getActiveReplSession();
+        const session = getActiveReplSessionForCurrentRuntime();
         if (session && session.runtime && session.runtime !== "unknown") return normalizeReplRuntime(session.runtime);
         return normalizeReplRuntime(replRuntime);
       }
@@ -1502,7 +1607,7 @@
 
       function stripStudioReplSubmissionEcho(delta) {
         let value = String(delta || "").replace(/^\s+/, "");
-        // The raw mirror below remains raw; REPL Studio cards hide only the
+        // The raw mirror below remains raw; Studio record cards hide only the
         // temp-file wrapper used to submit multiline snippets safely. The
         // pi-studio-re fragment catches IPython's wrapped pi-studio-repl paths.
         const submissionEchoPatterns = [
@@ -1566,11 +1671,11 @@
       function buildReplJournalMarkdown(entries) {
         const visibleEntries = Array.isArray(entries) ? entries : getVisibleReplJournalEntries();
         const sessionName = getActiveReplJournalSessionName();
-        const lines = ["# REPL Studio", "", "Generated: " + new Date().toLocaleString()];
+        const lines = ["# Studio REPL Record", "", "Generated: " + new Date().toLocaleString()];
         if (sessionName) lines.push("Session: `" + sessionName + "`");
         lines.push("");
         if (!visibleEntries.length) {
-          lines.push(sessionName ? ("_No REPL Studio entries for `" + sessionName + "` yet._") : "_No REPL Studio entries yet._");
+          lines.push(sessionName ? ("_No Studio REPL record entries for `" + sessionName + "` yet._") : "_No Studio REPL record entries yet._");
           return lines.join("\n");
         }
         visibleEntries.forEach((entry, index) => {
@@ -1602,11 +1707,11 @@
       async function copyReplJournalToClipboard() {
         const entries = getVisibleReplJournalEntries();
         if (!entries.length) {
-          setStatus("No REPL Studio entries to copy for this session yet.", "warning");
+          setStatus("No Studio REPL record entries to copy for this session yet.", "warning");
           return;
         }
         if (await writeTextToClipboard(buildReplJournalMarkdown(entries))) {
-          setStatus("Copied REPL Studio session as Markdown.", "success");
+          setStatus("Copied Studio REPL record as Markdown.", "success");
         } else {
           setStatus("Clipboard write failed.", "warning");
         }
@@ -1615,7 +1720,7 @@
       function exportReplJournalMarkdown() {
         const entries = getVisibleReplJournalEntries();
         if (!entries.length) {
-          setStatus("No REPL Studio entries to export for this session yet.", "warning");
+          setStatus("No Studio REPL record entries to export for this session yet.", "warning");
           return;
         }
         const blob = new Blob([buildReplJournalMarkdown(entries)], { type: "text/markdown;charset=utf-8" });
@@ -1629,7 +1734,7 @@
         link.click();
         link.remove();
         window.setTimeout(() => URL.revokeObjectURL(blobUrl), 1000);
-        setStatus("Exported REPL Studio session Markdown.", "success");
+        setStatus("Exported Studio REPL record Markdown.", "success");
       }
 
       function clearReplJournal() {
@@ -1641,27 +1746,27 @@
         }
         activeReplJournalEntryId = "";
         persistReplJournalEntries();
-        setStatus(sessionName ? "Cleared REPL Studio for this session." : "Cleared REPL Studio.", "success");
+        setStatus(sessionName ? "Cleared Studio REPL record for this session." : "Cleared Studio REPL record.", "success");
         renderReplViewIfActive({ force: true });
       }
 
       function loadReplJournalIntoEditor() {
         const entries = getVisibleReplJournalEntries();
         if (!entries.length) {
-          setStatus("No REPL Studio entries to load for this session yet.", "warning");
+          setStatus("No Studio REPL record entries to load for this session yet.", "warning");
           return;
         }
         const markdown = buildReplJournalMarkdown(entries);
         setEditorText(markdown, { preserveScroll: false, preserveSelection: false });
-        setSourceState({ source: "blank", label: "REPL Studio", path: null });
+        setSourceState({ source: "blank", label: "Studio REPL Record", path: null });
         setEditorLanguage("markdown");
-        setStatus("Loaded REPL Studio session into editor.", "success");
+        setStatus("Loaded Studio REPL record into editor.", "success");
       }
 
       function addSelectedReplJournalNote() {
         const note = getSelectedOrCurrentParagraphForReplNote();
         if (!note.trim()) {
-          setStatus("Select prose or place the cursor in a paragraph to add a REPL Studio note.", "warning");
+          setStatus("Select prose or place the cursor in a paragraph to add a Studio REPL record note.", "warning");
           return;
         }
         addReplJournalEntry({
@@ -1672,14 +1777,14 @@
           sessionName: replActiveSessionName,
           runtime: getActiveReplRuntime(),
         });
-        setStatus("Added note to REPL Studio.", "success");
+        setStatus("Added note to Studio REPL record.", "success");
         renderReplViewIfActive({ force: true });
       }
 
       function sendReplPayload(payload) {
-        const session = getActiveReplSession();
+        const session = getActiveReplSessionForCurrentRuntime();
         if (!session) {
-          setStatus("Start or select a REPL session first.", "warning");
+          setStatus("Start or select a " + getReplRuntimeLabel(replRuntime) + " REPL session first.", "warning");
           return;
         }
         if (!payload || payload.error) {
@@ -1697,7 +1802,7 @@
               runtime: getActiveReplRuntime(),
               skippedChunks: payload.skippedChunks,
             });
-            setStatus("Added prose to REPL Studio.", "success");
+            setStatus("Added prose to Studio REPL record.", "success");
             renderReplViewIfActive({ force: true });
           } else {
             setStatus("No code or prose found to send.", "warning");
@@ -1771,6 +1876,13 @@
       let fileBackedBaselineText = null;
       let activePane = "left";
       let paneFocusTarget = "off";
+      let paneSplitPercent = 50;
+      const PANE_SPLIT_STORAGE_KEY = "piStudio.paneSplitPercent";
+      const PANE_SPLIT_MIN_PERCENT = 20;
+      const PANE_SPLIT_MAX_PERCENT = 80;
+      const PANE_SPLIT_SNAP_TO_CENTER_PERCENT = 1;
+      const STUDIO_WORKSPACE_STORAGE_KEY = "piStudio.workspaceState.v1";
+      const STUDIO_WORKSPACE_MAX_TEXT_CHARS = 900_000;
       const EDITOR_HIGHLIGHT_MAX_CHARS = 100_000;
       const EDITOR_HIGHLIGHT_STORAGE_KEY = "piStudio.editorHighlightEnabled";
       const EDITOR_LANGUAGE_STORAGE_KEY = "piStudio.editorLanguage";
@@ -1865,6 +1977,9 @@
       let pendingReviewNoteInlineFocusId = null;
       let activePreviewCommentSelection = null;
       let suppressEditorSelectionComment = false;
+      let workspacePersistenceReady = false;
+      let workspacePersistTimer = null;
+      let workspaceRestoredFromBrowser = false;
       let suppressedEditorSelectionStart = null;
       let suppressedEditorSelectionEnd = null;
       const previewJumpHighlightState = new WeakMap();
@@ -2071,12 +2186,8 @@
         if (!studioUiRefreshUi) return;
         if (studioUiRefreshUi.annotationsButton) {
           const inlineLabel = annotationsEnabled ? "Inline on" : "Inline hidden";
-          if (isEditorOnlyMode) {
-            setStudioUiRefreshButtonText(studioUiRefreshUi.annotationsButton, "Annotations: " + inlineLabel);
-          } else {
-            const headerLabel = getStudioUiRefreshAnnotationHeaderEnabled() ? "Header on" : "Header off";
-            setStudioUiRefreshButtonText(studioUiRefreshUi.annotationsButton, "Annotations: " + inlineLabel + " · " + headerLabel);
-          }
+          const headerLabel = getStudioUiRefreshAnnotationHeaderEnabled() ? "Header on" : "Header off";
+          setStudioUiRefreshButtonText(studioUiRefreshUi.annotationsButton, "Annotations: " + inlineLabel + " · " + headerLabel);
         }
         if (studioUiRefreshUi.viewButton) {
           const syntaxLabel = editorHighlightEnabled
@@ -2240,7 +2351,7 @@
         const stateEl = makeStudioUiRefreshElement("div", "studio-refresh-toolbar-state");
         const annotationsButton = makeStudioUiRefreshElement("button", "", "Annotations");
         const annotationsMenu = makeStudioUiRefreshMenu(annotationsButton, "annotations", "studio-refresh-annotations-anchor");
-        appendStudioUiRefreshMenuSection(annotationsMenu.menu, "Display", isEditorOnlyMode ? [annotationModeSelect] : [annotationModeSelect, insertHeaderBtn]);
+        appendStudioUiRefreshMenuSection(annotationsMenu.menu, "Display", [annotationModeSelect, insertHeaderBtn]);
         appendStudioUiRefreshMenuSection(annotationsMenu.menu, "Actions", [stripAnnotationsBtn, saveAnnotatedBtn]);
         const viewButton = makeStudioUiRefreshElement("button", "", "View");
         const viewMenu = makeStudioUiRefreshMenu(viewButton, "view", "studio-refresh-view-anchor");
@@ -2431,7 +2542,7 @@
 
       function getTerminalBusyStatus() {
         if (terminalActivityPhase === "tool") {
-          if (terminalActivityLabel) {
+          if (terminalActivityLabel && !isGenericToolLabel(terminalActivityLabel)) {
             return "Terminal: " + withEllipsis(terminalActivityLabel);
           }
           return terminalActivityToolName
@@ -2475,7 +2586,7 @@
         const action = getStudioActionLabel(kind);
         const queueSuffix = studioRunChainActive ? formatQueuedSteeringSuffix() : "";
         if (terminalActivityPhase === "tool") {
-          if (terminalActivityLabel) {
+          if (terminalActivityLabel && !isGenericToolLabel(terminalActivityLabel)) {
             return "Studio: " + withEllipsis(terminalActivityLabel) + queueSuffix;
           }
           return terminalActivityToolName
@@ -2962,14 +3073,16 @@
         // Show "Set working dir" button when not file-backed
         var isFileBacked = hasRefreshableFilePath();
         if (isFileBacked) {
-          if (resourceDirInput) resourceDirInput.value = "";
+          var fileBackedResourceDir = getCurrentResourceDirValue() || dirnameForDisplayPath(sourceState.path);
+          if (resourceDirInput) resourceDirInput.value = fileBackedResourceDir;
           if (resourceDirLabel) resourceDirLabel.textContent = "";
           if (resourceDirBtn) resourceDirBtn.hidden = true;
           if (resourceDirLabel) resourceDirLabel.hidden = true;
           if (resourceDirInputWrap) resourceDirInputWrap.classList.remove("visible");
         } else {
           // Restore to label if dir is set, otherwise show button
-          var dir = resourceDirInput ? resourceDirInput.value.trim() : "";
+          var dir = getCurrentResourceDirValue();
+          if (resourceDirInput) resourceDirInput.value = dir;
           if (dir) {
             if (resourceDirBtn) resourceDirBtn.hidden = true;
             if (resourceDirLabel) { resourceDirLabel.textContent = "Working dir: " + dir; resourceDirLabel.hidden = false; }
@@ -3002,6 +3115,141 @@
         setStatus(descriptor.fileBacked ? "Detached editor from file origin into a new draft." : "Reset editor origin to a new draft.", "success");
       }
 
+      function clampPaneSplitPercent(value) {
+        const numeric = Number(value);
+        if (!Number.isFinite(numeric)) return 50;
+        const clamped = Math.max(PANE_SPLIT_MIN_PERCENT, Math.min(PANE_SPLIT_MAX_PERCENT, Math.round(numeric * 10) / 10));
+        return Math.abs(clamped - 50) <= PANE_SPLIT_SNAP_TO_CENTER_PERCENT ? 50 : clamped;
+      }
+
+      function applyPaneSplitPercent(percent, options) {
+        paneSplitPercent = clampPaneSplitPercent(percent);
+        const rightPercent = Math.round((100 - paneSplitPercent) * 10) / 10;
+        document.documentElement.style.setProperty("--studio-left-pane-fr", paneSplitPercent + "fr");
+        document.documentElement.style.setProperty("--studio-right-pane-fr", rightPercent + "fr");
+        if (paneResizeHandleEl) {
+          paneResizeHandleEl.setAttribute("aria-valuemin", String(PANE_SPLIT_MIN_PERCENT));
+          paneResizeHandleEl.setAttribute("aria-valuemax", String(PANE_SPLIT_MAX_PERCENT));
+          paneResizeHandleEl.setAttribute("aria-valuenow", String(Math.round(paneSplitPercent)));
+          paneResizeHandleEl.setAttribute("aria-valuetext", "Editor " + Math.round(paneSplitPercent) + " percent, response " + Math.round(rightPercent) + " percent");
+        }
+        if (!options || options.persist !== false) {
+          try {
+            if (window.localStorage) window.localStorage.setItem(PANE_SPLIT_STORAGE_KEY, String(paneSplitPercent));
+          } catch {
+            // Ignore localStorage failures.
+          }
+        }
+      }
+
+      function resetPaneSplitPercent() {
+        applyPaneSplitPercent(50);
+        setStatus("Pane split reset to 50/50.");
+      }
+
+      function loadPaneSplitPercent() {
+        let stored = "";
+        try {
+          stored = window.localStorage ? String(window.localStorage.getItem(PANE_SPLIT_STORAGE_KEY) || "") : "";
+        } catch {
+          stored = "";
+        }
+        applyPaneSplitPercent(stored ? Number(stored) : 50, { persist: false });
+      }
+
+      function getPaneSplitPercentFromPointerEvent(event) {
+        const mainEl = paneResizeHandleEl && typeof paneResizeHandleEl.closest === "function"
+          ? paneResizeHandleEl.closest("main")
+          : null;
+        if (!mainEl || typeof mainEl.getBoundingClientRect !== "function") return paneSplitPercent;
+        const rect = mainEl.getBoundingClientRect();
+        if (!rect.width) return paneSplitPercent;
+        const x = typeof event.clientX === "number" ? event.clientX : (rect.left + rect.width / 2);
+        return ((x - rect.left) / rect.width) * 100;
+      }
+
+      function setupPaneResizeHandle() {
+        if (!paneResizeHandleEl) return;
+        loadPaneSplitPercent();
+        let dragging = false;
+        let movedDuringDrag = false;
+        let pointerStartX = 0;
+        let activePaneResizePointerId = null;
+        const finishDrag = () => {
+          if (!dragging) return;
+          dragging = false;
+          if (document.body && document.body.classList) document.body.classList.remove("pane-resizing");
+          try {
+            if (typeof paneResizeHandleEl.releasePointerCapture === "function" && activePaneResizePointerId != null) {
+              paneResizeHandleEl.releasePointerCapture(activePaneResizePointerId);
+            }
+          } catch {
+            // Ignore pointer-capture cleanup failures.
+          }
+          activePaneResizePointerId = null;
+          if (movedDuringDrag) {
+            setStatus("Pane split: editor " + Math.round(paneSplitPercent) + "%, response " + Math.round(100 - paneSplitPercent) + "%.");
+          }
+          movedDuringDrag = false;
+        };
+        paneResizeHandleEl.addEventListener("pointerdown", (event) => {
+          if (event.button != null && event.button !== 0) return;
+          event.preventDefault();
+          event.stopPropagation();
+          dragging = true;
+          movedDuringDrag = false;
+          pointerStartX = typeof event.clientX === "number" ? event.clientX : 0;
+          activePaneResizePointerId = event.pointerId;
+          if (document.body && document.body.classList) document.body.classList.add("pane-resizing");
+          try {
+            if (typeof paneResizeHandleEl.focus === "function") paneResizeHandleEl.focus({ preventScroll: true });
+          } catch {
+            try { paneResizeHandleEl.focus(); } catch {}
+          }
+          try {
+            if (typeof paneResizeHandleEl.setPointerCapture === "function") paneResizeHandleEl.setPointerCapture(event.pointerId);
+          } catch {
+            // Ignore pointer-capture failures.
+          }
+        });
+        paneResizeHandleEl.addEventListener("pointermove", (event) => {
+          if (!dragging) return;
+          const movement = typeof event.clientX === "number" ? Math.abs(event.clientX - pointerStartX) : 0;
+          if (!movedDuringDrag && movement < 3) return;
+          movedDuringDrag = true;
+          event.preventDefault();
+          applyPaneSplitPercent(getPaneSplitPercentFromPointerEvent(event));
+        });
+        paneResizeHandleEl.addEventListener("pointerup", finishDrag);
+        paneResizeHandleEl.addEventListener("pointercancel", finishDrag);
+        paneResizeHandleEl.addEventListener("dblclick", (event) => {
+          event.preventDefault();
+          event.stopPropagation();
+          resetPaneSplitPercent();
+        });
+        paneResizeHandleEl.addEventListener("keydown", (event) => {
+          if (event.key === "Home") {
+            event.preventDefault();
+            applyPaneSplitPercent(PANE_SPLIT_MIN_PERCENT);
+            return;
+          }
+          if (event.key === "End") {
+            event.preventDefault();
+            applyPaneSplitPercent(PANE_SPLIT_MAX_PERCENT);
+            return;
+          }
+          if (event.key === "Enter" || event.key === " " || event.key === "Spacebar") {
+            event.preventDefault();
+            resetPaneSplitPercent();
+            return;
+          }
+          if (event.key !== "ArrowLeft" && event.key !== "ArrowRight") return;
+          event.preventDefault();
+          const step = event.shiftKey ? 10 : 5;
+          applyPaneSplitPercent(paneSplitPercent + (event.key === "ArrowLeft" ? -step : step));
+        });
+      }
+
       function updatePaneFocusButtons() {
         [
           [leftFocusBtn, "left"],
@@ -3102,10 +3350,6 @@
 
       function activatePaneFromShortcut(nextPane) {
         const pane = nextPane === "right" ? "right" : "left";
-        if (isEditorOnlyMode && pane === "right") {
-          setStatus("Only the editor pane is available in editor-only Studio.", "warning");
-          return;
-        }
         const snapshot = snapshotStudioScrollablePositions();
         setActivePane(pane);
         scheduleStudioScrollablePositionRestore(snapshot);
@@ -3148,10 +3392,6 @@
       }
 
       function focusRightContentFromShortcut() {
-        if (isEditorOnlyMode) {
-          setStatus("Only the editor pane is available in editor-only Studio.", "warning");
-          return;
-        }
         const snapshot = snapshotStudioScrollablePositions();
         setActivePane("right");
         scheduleStudioScrollablePositionRestore(snapshot);
@@ -3240,6 +3480,40 @@
         return false;
       }
 
+      function triggerResponseHistoryShortcut(action) {
+        if (isEditorOnlyMode) {
+          setStatus("Response history is unavailable in editor-only Studio.", "warning");
+          return false;
+        }
+        const total = Array.isArray(responseHistory) ? responseHistory.length : 0;
+        if (total <= 0) {
+          setStatus("No response history available yet.", "warning");
+          return false;
+        }
+        if (action === "previous") {
+          if (responseHistoryIndex <= 0) {
+            setStatus("Already at the first response.", "warning");
+            return false;
+          }
+          return selectHistoryIndex(responseHistoryIndex - 1);
+        }
+        if (action === "next") {
+          if (responseHistoryIndex >= total - 1) {
+            setStatus("Already at the latest response.", "warning");
+            return false;
+          }
+          return selectHistoryIndex(responseHistoryIndex + 1);
+        }
+        if (action === "latest") {
+          if (responseHistoryIndex >= total - 1) {
+            setStatus("Already viewing the latest response.");
+            return false;
+          }
+          return selectHistoryIndex(total - 1);
+        }
+        return false;
+      }
+
       function isTextEntryShortcutTarget(target) {
         if (!(target instanceof Element)) return false;
         const editable = target.closest("input, textarea, select, [contenteditable]");
@@ -3255,6 +3529,7 @@
         if (!event || event.defaultPrevented) return;
 
         const key = typeof event.key === "string" ? event.key : "";
+        const code = typeof event.code === "string" ? event.code : "";
         const plainEscape = key === "Escape"
           && !event.metaKey
           && !event.ctrlKey
@@ -3355,6 +3630,24 @@
           return;
         }
 
+        if (!isTextEntryShortcutTarget(event.target) && !event.metaKey && !event.ctrlKey && event.altKey && !event.shiftKey) {
+          if (key === "ArrowLeft") {
+            event.preventDefault();
+            triggerResponseHistoryShortcut("previous");
+            return;
+          }
+          if (key === "ArrowRight") {
+            event.preventDefault();
+            triggerResponseHistoryShortcut("next");
+            return;
+          }
+          if (key.toLowerCase() === "l" || code === "KeyL") {
+            event.preventDefault();
+            triggerResponseHistoryShortcut("latest");
+            return;
+          }
+        }
+
         const isPaneSwitchShortcut = key === "F6" && !event.metaKey && !event.ctrlKey && !event.altKey;
         if (isPaneSwitchShortcut) {
           event.preventDefault();
@@ -4018,6 +4311,36 @@
           + "    if (node && node.nodeType === 3) node = node.parentElement;\n"
           + "    return node && typeof node.closest === 'function' ? node.closest('a[href]') : null;\n"
           + "  }\n"
+          + "  function isLocalHtmlPreviewLinkHref(value) {\n"
+          + "    const raw = String(value || '').trim();\n"
+          + "    if (!raw || raw.charAt(0) === '#') return false;\n"
+          + "    if (/^\\/\\//.test(raw)) return false;\n"
+          + "    if (/^(?:https?|mailto|tel|data|blob|javascript|about):/i.test(raw)) return false;\n"
+          + "    return true;\n"
+          + "  }\n"
+          + "  function postHtmlPreviewLocalLink(action, anchor, event) {\n"
+          + "    if (!anchor || typeof anchor.getAttribute !== 'function') return false;\n"
+          + "    if (anchor.hasAttribute('download')) return false;\n"
+          + "    const target = String(anchor.getAttribute('target') || '').trim().toLowerCase();\n"
+          + "    if (target && target !== '_self') return false;\n"
+          + "    const href = String(anchor.getAttribute('href') || '').trim();\n"
+          + "    if (!isLocalHtmlPreviewLinkHref(href)) return false;\n"
+          + "    try { parent.postMessage({ type: 'pi-studio-html-artifact-local-link', id: PREVIEW_ID, action, href, title: String(anchor.textContent || href).trim(), clientX: event && event.clientX || 0, clientY: event && event.clientY || 0 }, '*'); } catch {}\n"
+          + "    return true;\n"
+          + "  }\n"
+          + "  function handleHtmlPreviewLocalLinkClick(event) {\n"
+          + "    if (!event || event.defaultPrevented) return;\n"
+          + "    if (typeof event.button === 'number' && event.button !== 0) return;\n"
+          + "    const anchor = getAnchorFromClickTarget(event.target);\n"
+          + "    if (!postHtmlPreviewLocalLink('open', anchor, event)) return;\n"
+          + "    event.preventDefault();\n"
+          + "  }\n"
+          + "  function handleHtmlPreviewLocalLinkContextMenu(event) {\n"
+          + "    if (!event || event.defaultPrevented) return;\n"
+          + "    const anchor = getAnchorFromClickTarget(event.target);\n"
+          + "    if (!postHtmlPreviewLocalLink('contextmenu', anchor, event)) return;\n"
+          + "    event.preventDefault();\n"
+          + "  }\n"
           + "  function getSameDocumentFragment(anchor) {\n"
           + "    if (!anchor || typeof anchor.getAttribute !== 'function') return null;\n"
           + "    if (anchor.hasAttribute('download')) return null;\n"
@@ -4205,6 +4528,60 @@
           + "    htmlMathScanScheduled = true;\n"
           + "    requestAnimationFrame(runHtmlMathRenderScan);\n"
           + "  }\n"
+          + "  const htmlResourcePlaceholders = new Map();\n"
+          + "  let htmlResourceSerial = 0;\n"
+          + "  let htmlResourceScanScheduled = false;\n"
+          + "  function shouldResolveHtmlPreviewResourceUrl(value) {\n"
+          + "    const raw = String(value || '').trim();\n"
+          + "    if (!raw || raw.charAt(0) === '#') return false;\n"
+          + "    if (/^(?:data|blob|http|https|about|javascript|mailto):/i.test(raw)) return false;\n"
+          + "    if (/^\\/\\//.test(raw)) return false;\n"
+          + "    return /\\.(?:png|jpe?g|gif|webp)(?:[?#].*)?$/i.test(raw);\n"
+          + "  }\n"
+          + "  function scanHtmlPreviewResources() {\n"
+          + "    htmlResourceScanScheduled = false;\n"
+          + "    if (!document.body) return;\n"
+          + "    const items = [];\n"
+          + "    const images = Array.prototype.slice.call(document.querySelectorAll('img[src]'));\n"
+          + "    images.forEach((image) => {\n"
+          + "      if (!image || !image.getAttribute) return;\n"
+          + "      if (image.getAttribute('data-pi-studio-html-resource-resolved') === 'true') return;\n"
+          + "      const raw = String(image.getAttribute('src') || '').trim();\n"
+          + "      if (!shouldResolveHtmlPreviewResourceUrl(raw)) return;\n"
+          + "      let resourceId = image.getAttribute('data-pi-studio-html-resource-id') || '';\n"
+          + "      if (!resourceId) {\n"
+          + "        resourceId = PREVIEW_ID + '_resource_' + (++htmlResourceSerial).toString(36);\n"
+          + "        image.setAttribute('data-pi-studio-html-resource-id', resourceId);\n"
+          + "      }\n"
+          + "      htmlResourcePlaceholders.set(resourceId, image);\n"
+          + "      items.push({ resourceId, url: raw });\n"
+          + "    });\n"
+          + "    if (items.length > 0) {\n"
+          + "      try { parent.postMessage({ type: 'pi-studio-html-artifact-resolve-resources', id: PREVIEW_ID, resources: items.slice(0, 100) }, '*'); } catch {}\n"
+          + "    }\n"
+          + "  }\n"
+          + "  function scheduleHtmlPreviewResourceScan() {\n"
+          + "    if (htmlResourceScanScheduled) return;\n"
+          + "    htmlResourceScanScheduled = true;\n"
+          + "    requestAnimationFrame(scanHtmlPreviewResources);\n"
+          + "  }\n"
+          + "  function applyResolvedHtmlPreviewResources(results) {\n"
+          + "    if (!Array.isArray(results)) return;\n"
+          + "    results.forEach((result) => {\n"
+          + "      if (!result || typeof result !== 'object') return;\n"
+          + "      const resourceId = typeof result.resourceId === 'string' ? result.resourceId : '';\n"
+          + "      const image = resourceId ? htmlResourcePlaceholders.get(resourceId) : null;\n"
+          + "      if (!image || !image.isConnected) return;\n"
+          + "      if (result.ok === true && typeof result.dataUrl === 'string' && result.dataUrl) {\n"
+          + "        image.setAttribute('src', result.dataUrl);\n"
+          + "        image.setAttribute('data-pi-studio-html-resource-resolved', 'true');\n"
+          + "      } else if (typeof result.error === 'string' && result.error) {\n"
+          + "        image.setAttribute('title', result.error);\n"
+          + "      }\n"
+          + "      htmlResourcePlaceholders.delete(resourceId);\n"
+          + "    });\n"
+          + "    scheduleHeight();\n"
+          + "  }\n"
           + "  window.addEventListener('message', (event) => {\n"
           + "    const data = event && event.data;\n"
           + "    if (!data || typeof data !== 'object' || data.id !== PREVIEW_ID) return;\n"
@@ -4214,15 +4591,21 @@
           + "    }\n"
           + "    if (data.type === 'pi-studio-html-artifact-math-rendered') {\n"
           + "      applyRenderedHtmlMath(data.results);\n"
+          + "      return;\n"
+          + "    }\n"
+          + "    if (data.type === 'pi-studio-html-artifact-resources-resolved') {\n"
+          + "      applyResolvedHtmlPreviewResources(data.results);\n"
           + "    }\n"
           + "  });\n"
           + "  document.addEventListener('click', handleFragmentAnchorClick);\n"
-          + "  document.addEventListener('DOMContentLoaded', scheduleHtmlMathRenderScan);\n"
+          + "  document.addEventListener('click', handleHtmlPreviewLocalLinkClick);\n"
+          + "  document.addEventListener('contextmenu', handleHtmlPreviewLocalLinkContextMenu);\n"
+          + "  document.addEventListener('DOMContentLoaded', () => { scheduleHtmlMathRenderScan(); scheduleHtmlPreviewResourceScan(); });\n"
           + "  window.addEventListener('hashchange', () => {\n"
           + "    const hash = String(window.location && window.location.hash || '');\n"
           + "    if (hash) scrollFragmentIntoView(hash.slice(1), { smooth: false });\n"
           + "  });\n"
-          + "  window.addEventListener('load', () => { scheduleHeight(); scheduleHtmlMathRenderScan(); });\n"
+          + "  window.addEventListener('load', () => { scheduleHeight(); scheduleHtmlMathRenderScan(); scheduleHtmlPreviewResourceScan(); });\n"
           + "  window.addEventListener('resize', scheduleHeight);\n"
           + "  if (typeof ResizeObserver === 'function') {\n"
           + "    const observer = new ResizeObserver(scheduleHeight);\n"
@@ -4230,15 +4613,15 @@
           + "    if (document.body) observer.observe(document.body);\n"
           + "  }\n"
           + "  if (typeof MutationObserver === 'function') {\n"
-          + "    const observer = new MutationObserver(() => { scheduleHeight(); scheduleHtmlMathRenderScan(); });\n"
+          + "    const observer = new MutationObserver(() => { scheduleHeight(); scheduleHtmlMathRenderScan(); scheduleHtmlPreviewResourceScan(); });\n"
           + "    observer.observe(document.documentElement, { childList: true, subtree: true, attributes: true, characterData: true });\n"
           + "  }\n"
           + "  scheduleHeight();\n"
           + "  setTimeout(scheduleHeight, 80);\n"
           + "  setTimeout(scheduleHeight, 350);\n"
-          + "  setTimeout(scheduleHtmlMathRenderScan, 0);\n"
-          + "  setTimeout(scheduleHtmlMathRenderScan, 120);\n"
-          + "  setTimeout(scheduleHtmlMathRenderScan, 500);\n"
+          + "  setTimeout(() => { scheduleHtmlMathRenderScan(); scheduleHtmlPreviewResourceScan(); }, 0);\n"
+          + "  setTimeout(() => { scheduleHtmlMathRenderScan(); scheduleHtmlPreviewResourceScan(); }, 120);\n"
+          + "  setTimeout(() => { scheduleHtmlMathRenderScan(); scheduleHtmlPreviewResourceScan(); }, 500);\n"
           + "})();\n"
           + "<\/script>";
       }
@@ -4467,9 +4850,154 @@
         void renderHtmlArtifactMathItems(record, items);
       }
 
+      function normalizeHtmlArtifactResourceItems(rawItems) {
+        if (!Array.isArray(rawItems)) return [];
+        return rawItems.slice(0, 100).map((item) => {
+          const raw = item && typeof item === "object" ? item : null;
+          const resourceId = raw && typeof raw.resourceId === "string" ? raw.resourceId : "";
+          const url = raw && typeof raw.url === "string" ? raw.url : "";
+          if (!resourceId || !url.trim()) return null;
+          return { resourceId, url };
+        }).filter(Boolean);
+      }
+
+      function buildHtmlArtifactResourceFetchUrl(record, resourceUrl) {
+        const token = getToken();
+        if (!token) return "";
+        const params = new URLSearchParams({ token, path: String(resourceUrl || "") });
+        if (record && record.sourcePath) {
+          params.set("sourcePath", record.sourcePath);
+        }
+        if (record && record.resourceDir) {
+          params.set("resourceDir", record.resourceDir);
+        }
+        return "/html-preview-resource?" + params.toString();
+      }
+
+      function postHtmlArtifactResourceResults(record, results) {
+        if (!record || !record.iframe || !record.iframe.isConnected || !record.iframe.contentWindow) return;
+        try {
+          record.iframe.contentWindow.postMessage({
+            type: "pi-studio-html-artifact-resources-resolved",
+            id: record.id || "",
+            results: Array.isArray(results) ? results : [],
+          }, "*");
+        } catch {
+          // Ignore iframe postMessage failures.
+        }
+      }
+
+      async function fetchHtmlArtifactResource(record, item) {
+        const resourceId = item && item.resourceId ? item.resourceId : "";
+        try {
+          const fetchUrl = buildHtmlArtifactResourceFetchUrl(record, item.url);
+          if (!fetchUrl) throw new Error("Missing Studio token in URL.");
+          const response = await fetchWithTimeout(fetchUrl, { method: "GET" }, HTML_ARTIFACT_RESOURCE_FETCH_TIMEOUT_MS, "HTML preview resource load");
+          const payload = await response.json().catch(() => null);
+          if (!response.ok || !payload || payload.ok !== true || typeof payload.dataUrl !== "string") {
+            const message = payload && typeof payload.error === "string" ? payload.error : "HTML preview resource load failed with HTTP " + response.status + ".";
+            throw new Error(message);
+          }
+          return { resourceId, ok: true, dataUrl: payload.dataUrl };
+        } catch (error) {
+          return { resourceId, ok: false, error: error && error.message ? error.message : String(error || "HTML preview resource load failed.") };
+        }
+      }
+
+      async function resolveHtmlArtifactResources(record, items) {
+        if (!record || !Array.isArray(items) || items.length === 0) return;
+        if (record.detail) record.detail.textContent = "HTML preview · loading local images";
+        const results = await Promise.all(items.map((item) => fetchHtmlArtifactResource(record, item)));
+        postHtmlArtifactResourceResults(record, results);
+        if (record.detail) record.detail.textContent = "HTML preview";
+      }
+
+      function handleHtmlArtifactFrameResourceMessage(event) {
+        const data = event && event.data;
+        if (!data || typeof data !== "object" || data.type !== "pi-studio-html-artifact-resolve-resources") return;
+        const id = typeof data.id === "string" ? data.id : "";
+        const record = id ? htmlArtifactFramesById.get(id) : null;
+        if (!record || !record.iframe || !record.iframe.isConnected) {
+          if (id) htmlArtifactFramesById.delete(id);
+          return;
+        }
+        if (event.source && record.iframe.contentWindow && event.source !== record.iframe.contentWindow) return;
+        const items = normalizeHtmlArtifactResourceItems(data.resources);
+        if (items.length === 0) return;
+        record.resourceResolveBatchCount = Math.max(0, Number(record.resourceResolveBatchCount) || 0) + 1;
+        record.resourceResolveItemCount = Math.max(0, Number(record.resourceResolveItemCount) || 0) + items.length;
+        if (record.resourceResolveBatchCount > 12 || record.resourceResolveItemCount > 300) {
+          postHtmlArtifactResourceResults(record, items.map((item) => ({ resourceId: item.resourceId, ok: false, error: "HTML preview local image load limit reached." })));
+          return;
+        }
+        void resolveHtmlArtifactResources(record, items);
+      }
+
+      function getHtmlArtifactLocalLinkContext(record, data) {
+        return {
+          href: typeof data.href === "string" ? data.href : "",
+          title: typeof data.title === "string" && data.title.trim() ? data.title.trim() : (typeof data.href === "string" ? data.href : "local link"),
+          sourcePath: record && record.sourcePath ? String(record.sourcePath) : "",
+          resourceDir: record && record.resourceDir ? String(record.resourceDir) : "",
+        };
+      }
+
+      function getHtmlArtifactLocalLinkClientPoint(record, data) {
+        const iframe = record && record.iframe;
+        const rect = iframe && typeof iframe.getBoundingClientRect === "function"
+          ? iframe.getBoundingClientRect()
+          : { left: 0, top: 0 };
+        return {
+          clientX: rect.left + (Number(data.clientX) || 0),
+          clientY: rect.top + (Number(data.clientY) || 0),
+        };
+      }
+
+      function handleHtmlArtifactFrameLocalLinkMessage(event) {
+        const data = event && event.data;
+        if (!data || typeof data !== "object" || data.type !== "pi-studio-html-artifact-local-link") return;
+        const id = typeof data.id === "string" ? data.id : "";
+        const record = id ? htmlArtifactFramesById.get(id) : null;
+        if (!record || !record.iframe || !record.iframe.isConnected) {
+          if (id) htmlArtifactFramesById.delete(id);
+          return;
+        }
+        if (event.source && record.iframe.contentWindow && event.source !== record.iframe.contentWindow) return;
+        const context = getHtmlArtifactLocalLinkContext(record, data);
+        if (!isStudioLocalPreviewHref(context.href)) return;
+        const action = typeof data.action === "string" ? data.action : "open";
+        if (action === "contextmenu") {
+          const point = getHtmlArtifactLocalLinkClientPoint(record, data);
+          showPreviewLinkMenu(null, point, context);
+          return;
+        }
+        const kind = getPreviewLocalLinkKind(context.href);
+        if (kind === "pdf") {
+          openPreviewPdfLink(context.href, context.title, context);
+          return;
+        }
+        if (kind === "image") {
+          const pendingWindow = window.open("", "_blank");
+          void openPreviewImageLink(context.href, context.title, context, pendingWindow).catch((error) => {
+            setStatus((error && error.message) ? error.message : String(error || "Could not open linked image."), "warning");
+          });
+          return;
+        }
+        if (kind === "text") {
+          const pendingWindow = window.open("", "_blank");
+          void openPreviewDocumentInNewEditor(context.href, pendingWindow, context).catch((error) => {
+            setStatus((error && error.message) ? error.message : String(error || "Could not open linked file."), "warning");
+          });
+          return;
+        }
+        setStatus("Right-click this local HTML preview link for file actions.", "warning");
+      }
+
       window.addEventListener("message", handleHtmlArtifactFrameSizeMessage);
       window.addEventListener("message", handleHtmlArtifactFrameFragmentMessage);
       window.addEventListener("message", handleHtmlArtifactFrameMathRenderMessage);
+      window.addEventListener("message", handleHtmlArtifactFrameResourceMessage);
+      window.addEventListener("message", handleHtmlArtifactFrameLocalLinkMessage);
 
       function isStudioHtmlFocusOpen() {
         return Boolean(studioHtmlFocusOverlayEl && studioHtmlFocusOverlayEl.hidden === false && studioHtmlFocusShellEl);
@@ -4777,7 +5305,19 @@
         iframe.addEventListener("load", () => { postArtifactZoom(); });
         iframe.srcdoc = buildHtmlArtifactSrcdoc(html, previewId);
         shell.appendChild(iframe);
-        htmlArtifactFramesById.set(previewId, { id: previewId, iframe, shell, detail, zoomControls, mathRenderBatchCount: 0, mathRenderItemCount: 0 });
+        htmlArtifactFramesById.set(previewId, {
+          id: previewId,
+          iframe,
+          shell,
+          detail,
+          zoomControls,
+          sourcePath: options && options.sourcePath ? String(options.sourcePath) : "",
+          resourceDir: options && options.resourceDir ? String(options.resourceDir) : "",
+          mathRenderBatchCount: 0,
+          mathRenderItemCount: 0,
+          resourceResolveBatchCount: 0,
+          resourceResolveItemCount: 0,
+        });
 
         targetEl.appendChild(shell);
 
@@ -5010,13 +5550,16 @@
         if (!token) return "";
         const pdfPath = String(options && options.path ? options.path : "").trim();
         if (!pdfPath) return "";
+        const explicitSourcePath = options && typeof options.sourcePath === "string" ? options.sourcePath.trim() : "";
+        const explicitResourceDir = options && typeof options.resourceDir === "string" ? normalizeStudioResourceDirValue(options.resourceDir) : "";
         const effectivePath = getEffectiveSavePath();
-        const sourcePath = useEditorResourceContext ? (effectivePath || sourceState.path || "") : "";
-        const resourceDir = resourceDirInput && resourceDirInput.value.trim() ? resourceDirInput.value.trim() : "";
+        const sourcePath = explicitSourcePath || (useEditorResourceContext ? (effectivePath || sourceState.path || "") : "");
+        const resourceDir = explicitResourceDir || getCurrentResourceDirValue();
         const params = new URLSearchParams({ token, path: pdfPath });
         if (sourcePath) {
           params.set("sourcePath", sourcePath);
-        } else if (resourceDir) {
+        }
+        if (resourceDir) {
           params.set("resourceDir", resourceDir);
         }
         return "/pdf-resource?" + params.toString();
@@ -5892,12 +6435,16 @@
         const action = actionBtn.getAttribute("data-repl-action") || "";
         if (action === "start" || action === "new-session") {
           const requestId = makeRequestId();
+          const command = getCurrentReplStartCommandFromDom();
+          setReplCommandOverride(replRuntime, command);
           replBusy = true;
           replError = "";
-          replMessage = (action === "new-session" ? "Starting new " : "Starting ") + replRuntime + " REPL…";
+          replMessage = (action === "new-session" ? "Starting new " : "Starting ") + getReplRuntimeLabel(replRuntime) + " session" + (command ? " with custom command" : "") + "…";
           syncActionButtons();
           renderReplViewIfActive({ force: true });
-          if (!sendMessage({ type: "repl_start_request", requestId, runtime: replRuntime, newSession: action === "new-session" })) {
+          const message = { type: "repl_start_request", requestId, runtime: replRuntime, newSession: action === "new-session" };
+          if (command) message.command = command;
+          if (!sendMessage(message)) {
             replBusy = false;
             syncActionButtons();
           }
@@ -6001,13 +6548,29 @@
         if (!(target instanceof Element)) return;
         const runtimeSelect = target.closest("[data-repl-runtime]");
         if (runtimeSelect && "value" in runtimeSelect) {
+          const previousActive = replActiveSessionName;
           setReplRuntime(runtimeSelect.value);
+          selectReplSessionForRuntime(replRuntime, previousActive);
+          replError = "";
+          replMessage = "";
+          if (replActiveSessionName) {
+            requestReplCapture();
+          } else {
+            replTranscript = "";
+            replCapturedAt = 0;
+            syncActionButtons();
+          }
           renderReplViewIfActive({ force: true });
           return;
         }
+        const commandInput = target.closest("[data-repl-command]");
+        if (commandInput && "value" in commandInput) {
+          setReplCommandOverride(replRuntime, commandInput.value);
+          return;
+        }
         const sessionSelect = target.closest("[data-repl-session]");
         if (sessionSelect && "value" in sessionSelect) {
-          setActiveReplSession(sessionSelect.value);
+          setActiveReplSessionForCurrentRuntime(sessionSelect.value);
           replError = "";
           replMessage = "";
           replFollow = true;
@@ -6190,7 +6753,7 @@
           const payload = {
             markdown: String(markdown || ""),
             sourcePath: sourcePath,
-            resourceDir: (!sourcePath && resourceDirInput) ? resourceDirInput.value.trim() : "",
+            resourceDir: (!sourcePath && resourceDirInput) ? getCurrentResourceDirValue() : "",
           };
           if (previewOptions.includeEditorLanguage) {
             payload.editorLanguage = String(editorLanguage || "");
@@ -6291,12 +6854,12 @@
         const exportingReplJournal = rightView === "repl";
         const rightPaneShowsPreview = rightView === "preview" || rightView === "editor-preview";
         if (!rightPaneShowsPreview && !exportingReplJournal) {
-          setStatus("Switch right pane to Response (Preview), Editor (Preview), or REPL Studio to export PDF.", "warning");
+          setStatus("Switch right pane to Response (Preview), Editor (Preview), or REPL to export PDF.", "warning");
           return;
         }
         const replJournalExportEntries = exportingReplJournal ? getVisibleReplJournalEntries() : [];
         if (exportingReplJournal && !replJournalExportEntries.length) {
-          setStatus("No REPL Studio entries to export for this session yet.", "warning");
+          setStatus("No Studio REPL record entries to export for this session yet.", "warning");
           return;
         }
 
@@ -6318,7 +6881,7 @@
 
         const effectivePath = getEffectiveSavePath();
         const sourcePath = exportingReplJournal ? "" : (effectivePath || sourceState.path || "");
-        const resourceDir = (!sourcePath && resourceDirInput) ? resourceDirInput.value.trim() : "";
+        const resourceDir = (!sourcePath && resourceDirInput) ? getCurrentResourceDirValue() : "";
         const isEditorPreview = rightView === "editor-preview";
         const editorPdfLanguage = isEditorPreview ? normalizeFenceLanguage(editorLanguage || "") : "";
         const isLatex = isEditorPreview
@@ -6464,12 +7027,12 @@
         const exportingReplJournal = rightView === "repl";
         const rightPaneShowsPreview = rightView === "preview" || rightView === "editor-preview";
         if (!rightPaneShowsPreview && !exportingReplJournal) {
-          setStatus("Switch right pane to Response (Preview), Editor (Preview), or REPL Studio to export HTML.", "warning");
+          setStatus("Switch right pane to Response (Preview), Editor (Preview), or REPL to export HTML.", "warning");
           return;
         }
         const replJournalExportEntries = exportingReplJournal ? getVisibleReplJournalEntries() : [];
         if (exportingReplJournal && !replJournalExportEntries.length) {
-          setStatus("No REPL Studio entries to export for this session yet.", "warning");
+          setStatus("No Studio REPL record entries to export for this session yet.", "warning");
           return;
         }
 
@@ -6484,14 +7047,14 @@
 
         const effectivePath = getEffectiveSavePath();
         const sourcePath = exportingReplJournal ? "" : (effectivePath || sourceState.path || "");
-        const resourceDir = (!sourcePath && resourceDirInput) ? resourceDirInput.value.trim() : "";
+        const resourceDir = (!sourcePath && resourceDirInput) ? getCurrentResourceDirValue() : "";
         const isEditorPreview = rightView === "editor-preview";
         const editorHtmlLanguage = htmlArtifactSource ? "html" : (isEditorPreview ? normalizeFenceLanguage(editorLanguage || "") : "");
         const isLatex = htmlArtifactSource ? false : (isEditorPreview
           ? editorHtmlLanguage === "latex"
           : /\\documentclass\b|\\begin\{document\}/.test(markdown));
         let filenameHint = exportingReplJournal ? "repl-studio.html" : (isEditorPreview ? "studio-editor-preview.html" : "studio-response-preview.html");
-        let titleHint = exportingReplJournal ? "REPL Studio" : (isEditorPreview ? "Studio editor preview" : "Studio response preview");
+        let titleHint = exportingReplJournal ? "Studio REPL Record" : (isEditorPreview ? "Studio editor preview" : "Studio response preview");
         if (sourcePath) {
           const baseName = sourcePath.split(/[\\/]/).pop() || "studio";
           const stem = baseName.replace(/\.[^.]+$/, "") || "studio";
@@ -6873,7 +7436,7 @@
           decorateCopyablePreviewBlocks(targetEl);
 
           // Warn if relative images are present but unlikely to resolve (non-file-backed content)
-          if (!sourceState.path && !(resourceDirInput && resourceDirInput.value.trim())) {
+          if (!sourceState.path && !getCurrentResourceDirValue()) {
             var hasRelativeImages = /!\[.*?\]\((?!https?:\/\/|data:)[^)]+\)/.test(markdown || "");
             var hasLatexImages = /\\includegraphics/.test(markdown || "");
             if (hasRelativeImages || hasLatexImages) {
@@ -6907,7 +7470,7 @@
         if (editorView !== "preview") return;
         const text = prepareEditorTextForPreview(sourceTextEl.value || "");
         if (isHtmlArtifactPreviewText(text, editorLanguage)) {
-          renderHtmlArtifactPreview(sourcePreviewEl, text, "source", { title: "Editor HTML preview" });
+          renderHtmlArtifactPreview(sourcePreviewEl, text, "source", { title: "Editor HTML preview", ...getHtmlPreviewResourceContextOptions() });
           return;
         }
         if (supportsCodePreviewCommentsForCurrentEditor()) {
@@ -7190,10 +7753,9 @@
         const visibleEntries = getVisibleReplJournalEntries();
         const hasEntries = visibleEntries.length > 0;
         const entryCount = visibleEntries.length;
-        const hiddenEntryCount = getHiddenReplJournalEntryCount();
         const sessionName = getActiveReplJournalSessionName();
         const collapsedClass = replJournalCollapsed ? " is-collapsed" : "";
-        const toggleButton = "<button type='button' data-repl-action='journal-toggle' aria-expanded='" + (replJournalCollapsed ? "false" : "true") + "'>" + (replJournalCollapsed ? "Show REPL Studio" : "Hide REPL Studio") + "</button>";
+        const toggleButton = "<button type='button' data-repl-action='journal-toggle' aria-expanded='" + (replJournalCollapsed ? "false" : "true") + "'>" + (replJournalCollapsed ? "Show record" : "Hide record") + "</button>";
         const toggleActions = "<div class='repl-journal-actions'>" + toggleButton + "</div>";
         const summaryText = hasEntries
           ? (entryCount + " Studio entr" + (entryCount === 1 ? "y" : "ies") + (sessionName ? " for " + sessionName : "") + ". Export is Markdown.")
@@ -7201,7 +7763,7 @@
         if (replJournalCollapsed) {
           return "<section class='repl-journal repl-journal-compact" + collapsedClass + "'>"
             + "<div class='repl-journal-compact-row'>"
-            + "<div class='repl-journal-compact-title'><span class='repl-journal-chip'>REPL Studio</span><span>" + escapeHtml(summaryText) + "</span></div>"
+            + "<div class='repl-journal-compact-title'><span class='repl-journal-chip'>Studio REPL Record</span><span>" + escapeHtml(summaryText) + "</span></div>"
             + "<div class='repl-journal-actions'>" + toggleButton + "</div>"
             + "</div>"
             + "</section>";
@@ -7239,14 +7801,14 @@
         }).join("");
         const emptyText = sessionName
           ? (String(transcript || "").trim()
-            ? "No REPL Studio entries for this tmux session yet. The raw tmux mirror below still has this session's history; send code from Studio to build a clean record."
-            : "No REPL Studio entries for this tmux session yet. Send code from the editor, or use More → Add note (Literate send) to record prose.")
-          : "No REPL Studio entries yet. Send code from the editor, or use More → Add note (Literate send) to record prose.";
+            ? "No Studio REPL record entries yet. The raw tmux mirror below still has this session's history; send code from Studio to build a clean record."
+            : "No Studio REPL record entries yet. Send code from the editor, or use More → Add note (Literate send) to record prose.")
+          : "No Studio REPL record entries yet. Send code from the editor, or use More → Add note (Literate send) to record prose.";
         const terminalContent = banner
           + (hasEntries ? cards : "<div class='repl-studio-empty'>" + escapeHtml(emptyText) + "</div>");
         return "<section class='repl-journal'>"
-          + "<div class='repl-journal-header'><div><h3>REPL Studio</h3><p>Clean collaborative Studio REPL record for the selected tmux session. The raw tmux mirror is available below.</p></div>" + toggleActions + "</div>"
-          + (hiddenEntryCount ? "<div class='repl-journal-omitted'>" + escapeHtml(String(hiddenEntryCount)) + " entr" + (hiddenEntryCount === 1 ? "y" : "ies") + " from other REPL sessions hidden.</div>" : "")
+          + "<div class='repl-journal-header'><h3>Studio REPL Record</h3>" + toggleActions + "</div>"
+          + "<p class='repl-journal-description'>Clean record for the selected tmux session. Raw tmux mirror below.</p>"
           + (omitted ? "<div class='repl-journal-omitted'>Showing latest 12 entries for this session; " + escapeHtml(String(omitted)) + " older entries remain in export.</div>" : "")
           + "<div class='repl-journal-list'>" + terminalContent + "</div>"
           + "</section>";
@@ -7270,7 +7832,7 @@
             + "</section>";
         }
         return "<section class='repl-mirror'>"
-          + "<div class='repl-journal-header'><div><h3>Raw REPL mirror</h3><p>Best-effort tmux pane mirror. Useful for directly typed commands and debugging; REPL Studio above is the cleaner record.</p></div>" + actions + "</div>"
+          + "<div class='repl-journal-header'><div><h3>Raw REPL Mirror</h3><p>Best-effort tmux pane mirror. Useful for directly typed commands and debugging; the Studio record above is cleaner.</p></div>" + actions + "</div>"
           + body
           + "</section>";
       }
@@ -7290,10 +7852,13 @@
           ["ghci", "GHCi"],
           ["clojure", "Clojure"],
         ].map(([value, label]) => "<option value='" + escapeHtml(value) + "'" + (replRuntime === value ? " selected" : "") + ">" + escapeHtml(label) + "</option>").join("");
-        const sessionOptions = replSessions.length
-          ? replSessions.map((session) => "<option value='" + escapeHtml(session.sessionName) + "'" + (session.sessionName === replActiveSessionName ? " selected" : "") + ">" + escapeHtml(session.label || session.sessionName) + "</option>").join("")
-          : "<option value=''>No REPL sessions</option>";
-        const activeSession = getActiveReplSession();
+        const runtimeLabel = getReplRuntimeLabel(replRuntime);
+        const visibleSessions = getReplSessionsForRuntime(replRuntime);
+        const sessionOptions = visibleSessions.length
+          ? visibleSessions.map((session) => "<option value='" + escapeHtml(session.sessionName) + "'" + (session.sessionName === replActiveSessionName ? " selected" : "") + ">" + escapeHtml(session.label || session.sessionName) + "</option>").join("")
+          : "<option value=''>None</option>";
+        const replCommand = getReplCommandOverride(replRuntime);
+        const activeSession = getActiveReplSessionForCurrentRuntime();
         const transcript = trimReplTranscript(replTranscript);
         const emptyMessage = replTmuxAvailable === false
           ? "tmux is not available. Install tmux to use Studio REPL sessions."
@@ -7307,17 +7872,17 @@
           + "<div class='repl-toolbar'>"
           + "<div class='repl-controls'>"
           + "<label class='repl-control-label'>Runtime <select data-repl-runtime aria-label='REPL runtime'>" + runtimeOptions + "</select></label>"
-          + "<button type='button' data-repl-action='start'" + (replBusy || replTmuxAvailable === false ? " disabled" : "") + " title='Start or attach to the default session for this runtime.'>Start</button>"
-          + "<label class='repl-control-label'>Session <select data-repl-session aria-label='REPL session'" + (replSessions.length ? "" : " disabled") + ">" + sessionOptions + "</select></label>"
+          + "<label class='repl-control-label repl-command-label'>Start cmd <input data-repl-command type='text' value='" + escapeHtml(replCommand) + "' placeholder='default' aria-label='REPL start command' title='Command used by Start for this runtime. Leave blank for the default; use this for envs, e.g. .venv/bin/python, uv run python, or conda run --no-capture-output -n env python.'></label>"
+          + "<button class='repl-start-btn' type='button' data-repl-action='start'" + (replBusy || replTmuxAvailable === false ? " disabled" : "") + " title='Start or switch to a " + escapeHtml(runtimeLabel) + " session using the selected runtime and start command.'>Start</button>"
+          + "<label class='repl-control-label repl-session-label'>Session <select data-repl-session aria-label='REPL session'" + (visibleSessions.length ? "" : " disabled") + ">" + sessionOptions + "</select></label>"
           + "<details class='repl-more-controls'>"
           + "<summary title='More REPL actions'>More</summary>"
           + "<div class='repl-more-menu'>"
-          + "<button type='button' data-repl-action='new-session'" + (replBusy || replTmuxAvailable === false ? " disabled" : "") + " title='Start a new additional session for this runtime.'>New session</button>"
           + "<button type='button' data-repl-action='stop-session'" + (canStopActiveSession ? "" : " disabled") + " title='Stop the selected Studio-owned REPL session.'>Stop session</button>"
           + "<button type='button' data-repl-action='interrupt'" + (activeSession && !replBusy ? "" : " disabled") + " title='Send Ctrl+C to the active REPL session.'>Interrupt</button>"
           + "<button type='button' data-repl-action='copy-attach-command'" + (activeSession ? "" : " disabled") + " title='Copy command for attaching to this tmux session in a terminal.'>Copy attach command</button>"
           + "<button type='button' data-repl-action='run-all-chunks'" + (canSendToActiveSession ? "" : " disabled") + " title='Literate send: send all fenced code chunks matching the active REPL runtime.'>Run all chunks</button>"
-          + "<button type='button' data-repl-action='journal-note' title='Add the selected prose/current paragraph to REPL Studio (Literate send) without sending it to the runtime.'>Add note</button>"
+          + "<button type='button' data-repl-action='journal-note' title='Add the selected prose/current paragraph to the Studio REPL record (Literate send) without sending it to the runtime.'>Add note</button>"
           + "<button type='button' data-repl-action='refresh'>Refresh</button>"
           + "<button type='button' data-repl-action='follow'>Follow: " + (replFollow ? "On" : "Off") + "</button>"
           + "</div>"
@@ -7501,7 +8066,7 @@
             return;
           }
           if (isHtmlArtifactPreviewText(editorText, editorLanguage)) {
-            renderHtmlArtifactPreview(critiqueViewEl, editorText, "response", { title: "Editor HTML preview" });
+            renderHtmlArtifactPreview(critiqueViewEl, editorText, "response", { title: "Editor HTML preview", ...getHtmlPreviewResourceContextOptions() });
             return;
           }
           if (supportsCodePreviewCommentsForCurrentEditor()) {
@@ -7525,7 +8090,7 @@
 
         if (rightView === "preview") {
           if (isHtmlArtifactPreviewText(markdown, "")) {
-            renderHtmlArtifactPreview(critiqueViewEl, markdown, "response", { title: "Response HTML preview" });
+            renderHtmlArtifactPreview(critiqueViewEl, markdown, "response", { title: "Response HTML preview", ...getHtmlPreviewResourceContextOptions() });
             return;
           }
           const nonce = ++responsePreviewRenderNonce;
@@ -7604,19 +8169,19 @@
           exportPdfBtn.disabled = uiBusy || previewExportInProgress || !canExportPreview;
           exportPdfBtn.textContent = previewExportInProgress
             ? "Exporting…"
-            : (exportingReplJournal ? "Export REPL Studio" : "Export right preview");
+            : (exportingReplJournal ? "Export record" : "Export right preview");
           if (rightView === "trace") {
             exportPdfBtn.title = "Working view does not support preview export.";
           } else if (exportingReplJournal && !replJournalExportEntries.length) {
-            exportPdfBtn.title = "No REPL Studio entries to export for this session yet.";
+            exportPdfBtn.title = "No Studio REPL record entries to export for this session yet.";
           } else if (rightView === "markdown") {
-            exportPdfBtn.title = "Switch right pane to Response (Preview), Editor (Preview), or REPL Studio to export.";
+            exportPdfBtn.title = "Switch right pane to Response (Preview), Editor (Preview), or REPL to export.";
           } else if (!canExportPreview) {
             exportPdfBtn.title = "Nothing to export yet.";
           } else if (isHtmlArtifactPreview) {
             exportPdfBtn.title = "This is an interactive HTML preview. Export as HTML; PDF export is not available yet.";
           } else if (exportingReplJournal) {
-            exportPdfBtn.title = "Choose PDF or HTML and export REPL Studio.";
+            exportPdfBtn.title = "Choose PDF or HTML and export the Studio REPL record.";
           } else {
             exportPdfBtn.title = "Choose PDF or HTML and export the current right-pane preview.";
           }
@@ -7625,20 +8190,20 @@
           exportPreviewPdfBtn.disabled = uiBusy || previewExportInProgress || !canExportPreview || isHtmlArtifactPreview;
           exportPreviewPdfBtn.title = isHtmlArtifactPreview
             ? "Interactive HTML preview PDF export is not available yet."
-            : (exportingReplJournal ? "Export REPL Studio as PDF." : "Export the current right-pane preview as PDF.");
+            : (exportingReplJournal ? "Export the Studio REPL record as PDF." : "Export the current right-pane preview as PDF.");
         }
         if (exportPreviewHtmlBtn) {
           exportPreviewHtmlBtn.disabled = uiBusy || previewExportInProgress || !canExportPreview;
           exportPreviewHtmlBtn.title = isHtmlArtifactPreview
             ? "Export the authored HTML preview."
-            : (exportingReplJournal ? "Export REPL Studio as standalone HTML." : "Export the current right-pane preview as standalone HTML.");
+            : (exportingReplJournal ? "Export the Studio REPL record as standalone HTML." : "Export the current right-pane preview as standalone HTML.");
         }
         if (exportPreviewControlsEl) {
           exportPreviewControlsEl.title = canExportPreview
             ? (exportingReplJournal
-              ? "Choose a format and export REPL Studio."
+              ? "Choose a format and export the Studio REPL record."
               : (isHtmlArtifactPreview ? "Export this HTML preview." : "Choose a format and export the current right-pane preview."))
-            : (exportingReplJournal ? "No REPL Studio entries to export for this session yet." : "Switch right pane to a non-empty preview before exporting.");
+            : (exportingReplJournal ? "No Studio REPL record entries to export for this session yet." : "Switch right pane to a non-empty preview before exporting.");
         }
         if (!canExportPreview || previewExportInProgress) {
           closeExportPreviewMenu();
@@ -7658,17 +8223,57 @@
         updateResultActionButtons();
       }
 
+      function normalizeStudioResourceDirValue(value) {
+        let text = String(value || "").trim();
+        if (text.length >= 2) {
+          const first = text.charAt(0);
+          const last = text.charAt(text.length - 1);
+          if ((first === "\"" && last === "\"") || (first === "'" && last === "'")) {
+            text = text.slice(1, -1).trim();
+          }
+        }
+        if (/^file:\/\//i.test(text)) {
+          try {
+            text = decodeURIComponent(new URL(text).pathname || text).trim();
+          } catch {}
+        }
+        const markers = ["/Users/", "/home/", "/Volumes/", "/private/", "/tmp/", "/var/", "/opt/", "/Applications/"];
+        let embeddedAbsoluteIndex = -1;
+        for (const marker of markers) {
+          const index = text.lastIndexOf(marker);
+          if (index > 0) embeddedAbsoluteIndex = Math.max(embeddedAbsoluteIndex, index);
+        }
+        const windowsMatch = text.match(/.*([A-Za-z]:[\\/].*)$/);
+        if (windowsMatch && windowsMatch[1]) return windowsMatch[1].trim();
+        if (embeddedAbsoluteIndex > 0) text = text.slice(embeddedAbsoluteIndex).trim();
+        return text;
+      }
+
+      function getCurrentResourceDirValue() {
+        return resourceDirInput ? normalizeStudioResourceDirValue(resourceDirInput.value) : "";
+      }
+
       function getEffectiveSavePath() {
         // File-backed: use the original path
         if (sourceState.path) return sourceState.path;
         // Upload with working dir + filename: derive path
-        if (sourceState.source === "upload" && sourceState.label && resourceDirInput && resourceDirInput.value.trim()) {
+        const resourceDir = getCurrentResourceDirValue();
+        if (sourceState.source === "upload" && sourceState.label && resourceDir) {
           var name = sourceState.label.replace(/^upload:\s*/i, "");
-          if (name) return resourceDirInput.value.trim().replace(/\/$/, "") + "/" + name;
+          if (name) return resourceDir.replace(/\/$/, "") + "/" + name;
         }
         return null;
       }
 
+      function getHtmlPreviewResourceContextOptions() {
+        const sourcePath = getEffectiveSavePath() || sourceState.path || "";
+        const resourceDir = getCurrentResourceDirValue();
+        return {
+          sourcePath,
+          resourceDir,
+        };
+      }
+
       function buildAnnotatedSaveSuggestion() {
         const effectivePath = getEffectiveSavePath() || sourceState.path || "";
         if (effectivePath) {
@@ -7681,8 +8286,8 @@
 
         const rawLabel = sourceState.label ? sourceState.label.replace(/^upload:\s*/i, "") : "draft.md";
         const stem = rawLabel.replace(/\.[^.]+$/, "") || "draft";
-        const suggestedDir = resourceDirInput && resourceDirInput.value.trim()
-          ? resourceDirInput.value.trim().replace(/\/$/, "") + "/"
+        const suggestedDir = getCurrentResourceDirValue()
+          ? getCurrentResourceDirValue().replace(/\/$/, "") + "/"
           : "./";
         return suggestedDir + stem + ".annotated.md";
       }
@@ -7719,6 +8324,7 @@
         saveAsBtn.disabled = uiBusy;
         saveOverBtn.disabled = uiBusy || !canSaveOver;
         if (refreshFromDiskBtn) refreshFromDiskBtn.disabled = uiBusy || !canRefreshFromDisk;
+        if (clearWorkspaceBtn) clearWorkspaceBtn.disabled = uiBusy;
         sendEditorBtn.disabled = uiBusy || isEditorOnlyMode;
         if (getEditorBtn) getEditorBtn.disabled = uiBusy;
         if (loadGitDiffBtn) loadGitDiffBtn.disabled = uiBusy;
@@ -7735,7 +8341,7 @@
         rightViewSelect.disabled = isEditorOnlyMode;
         followSelect.disabled = isEditorOnlyMode || uiBusy;
         if (responseHighlightSelect) responseHighlightSelect.disabled = isEditorOnlyMode || rightView !== "markdown";
-        insertHeaderBtn.disabled = uiBusy || isEditorOnlyMode;
+        insertHeaderBtn.disabled = uiBusy;
         lensSelect.disabled = uiBusy || isEditorOnlyMode;
         updateSaveFileTooltip();
         updateRefreshFromDiskTooltip();
@@ -7777,6 +8383,197 @@
           previousDescriptor: previousDescriptor,
           carryCurrentMetadataToNewDocument: Boolean(options && options.carryCurrentMetadataToNewDocument),
         });
+        scheduleWorkspacePersistence();
+      }
+
+      function normalizeWorkspaceSourceState(value) {
+        const raw = value && typeof value === "object" ? value : {};
+        const path = typeof raw.path === "string" && raw.path.trim() ? raw.path.trim() : null;
+        return {
+          source: typeof raw.source === "string" && raw.source.trim() ? raw.source.trim() : "blank",
+          label: typeof raw.label === "string" && raw.label.trim() ? raw.label.trim() : "blank",
+          path,
+          draftId: path ? null : (typeof raw.draftId === "string" && raw.draftId.trim() ? raw.draftId.trim() : null),
+        };
+      }
+
+      function getWorkspaceStateIdentity(state) {
+        const normalized = normalizeWorkspaceSourceState(state);
+        if (normalized.path) return "file:" + normalized.path;
+        if (normalized.draftId) return "draft:" + normalized.draftId;
+        return "source:" + normalized.source + ":" + normalized.label;
+      }
+
+      function readPersistedWorkspaceState() {
+        try {
+          const raw = window.localStorage ? window.localStorage.getItem(STUDIO_WORKSPACE_STORAGE_KEY) : null;
+          if (!raw) return null;
+          const parsed = JSON.parse(raw);
+          if (!parsed || typeof parsed !== "object" || parsed.version !== 1) return null;
+          if (typeof parsed.text !== "string") return null;
+          return parsed;
+        } catch {
+          return null;
+        }
+      }
+
+      function shouldRestorePersistedWorkspaceState(state) {
+        if (!state || typeof state.text !== "string") return false;
+        const storedSourceState = normalizeWorkspaceSourceState(state.sourceState);
+        const initialIdentity = getWorkspaceStateIdentity(initialSourceState);
+        const storedIdentity = getWorkspaceStateIdentity(storedSourceState);
+        if (storedIdentity === initialIdentity) return true;
+        if (!explicitDocumentIdentityFromUrl && initialSourceState.source === "blank" && !initialSourceState.path) return true;
+        return false;
+      }
+
+      function buildWorkspacePersistencePayload() {
+        return {
+          version: 1,
+          savedAt: Date.now(),
+          sourceState: normalizeWorkspaceSourceState(sourceState),
+          resourceDir: getCurrentResourceDirValue(),
+          editorView,
+          rightView,
+          editorLanguage,
+          followLatest,
+          responseHistoryIndex,
+          selectionStart: typeof sourceTextEl.selectionStart === "number" ? sourceTextEl.selectionStart : 0,
+          selectionEnd: typeof sourceTextEl.selectionEnd === "number" ? sourceTextEl.selectionEnd : 0,
+          scrollTop: typeof sourceTextEl.scrollTop === "number" ? sourceTextEl.scrollTop : 0,
+          text: String(sourceTextEl.value || ""),
+        };
+      }
+
+      function persistWorkspaceStateNow() {
+        if (!workspacePersistenceReady) return;
+        try {
+          if (!window.localStorage) return;
+          const payload = buildWorkspacePersistencePayload();
+          if (payload.text.length > STUDIO_WORKSPACE_MAX_TEXT_CHARS) {
+            window.localStorage.removeItem(STUDIO_WORKSPACE_STORAGE_KEY);
+            return;
+          }
+          window.localStorage.setItem(STUDIO_WORKSPACE_STORAGE_KEY, JSON.stringify(payload));
+        } catch {
+          // Ignore browser storage failures and quota limits.
+        }
+      }
+
+      function scheduleWorkspacePersistence() {
+        if (!workspacePersistenceReady) return;
+        if (workspacePersistTimer !== null) window.clearTimeout(workspacePersistTimer);
+        workspacePersistTimer = window.setTimeout(() => {
+          workspacePersistTimer = null;
+          persistWorkspaceStateNow();
+        }, 160);
+      }
+
+      function flushWorkspacePersistence() {
+        if (workspacePersistTimer !== null) {
+          window.clearTimeout(workspacePersistTimer);
+          workspacePersistTimer = null;
+        }
+        persistWorkspaceStateNow();
+      }
+
+      function clearPersistedWorkspaceState() {
+        if (workspacePersistTimer !== null) {
+          window.clearTimeout(workspacePersistTimer);
+          workspacePersistTimer = null;
+        }
+        try {
+          if (window.localStorage) window.localStorage.removeItem(STUDIO_WORKSPACE_STORAGE_KEY);
+        } catch {}
+      }
+
+      function applyPersistedWorkspaceState(state) {
+        if (!shouldRestorePersistedWorkspaceState(state)) return false;
+        const nextSourceState = normalizeWorkspaceSourceState(state.sourceState);
+        const nextResourceDir = normalizeStudioResourceDirValue(typeof state.resourceDir === "string" ? state.resourceDir : "");
+        if (resourceDirInput) resourceDirInput.value = nextResourceDir;
+        setEditorText(state.text, { preserveScroll: false, preserveSelection: false });
+        setSourceState(nextSourceState);
+        if (resourceDirInput && nextResourceDir) {
+          resourceDirInput.value = nextResourceDir;
+          updateSourceBadge();
+        }
+        if (typeof state.editorLanguage === "string" && state.editorLanguage.trim()) {
+          setEditorLanguage(state.editorLanguage.trim());
+        }
+        editorView = state.editorView === "preview" ? "preview" : "markdown";
+        rightView = state.rightView === "preview"
+          ? "preview"
+          : (state.rightView === "editor-preview"
+            ? "editor-preview"
+            : (state.rightView === "repl" ? "repl" : ((state.rightView === "trace" || state.rightView === "thinking") ? "trace" : "markdown")));
+        if (typeof state.followLatest === "boolean") {
+          followLatest = state.followLatest;
+        }
+        if (followSelect) followSelect.value = followLatest ? "on" : "off";
+        if (typeof state.responseHistoryIndex === "number" && Number.isFinite(state.responseHistoryIndex)) {
+          responseHistoryIndex = Math.max(-1, Math.floor(state.responseHistoryIndex));
+        }
+        const maxIndex = String(sourceTextEl.value || "").length;
+        const start = Math.max(0, Math.min(Math.floor(Number(state.selectionStart) || 0), maxIndex));
+        const end = Math.max(start, Math.min(Math.floor(Number(state.selectionEnd) || start), maxIndex));
+        try { sourceTextEl.setSelectionRange(start, end); } catch {}
+        if (typeof state.scrollTop === "number" && Number.isFinite(state.scrollTop)) {
+          sourceTextEl.scrollTop = Math.max(0, state.scrollTop);
+        }
+        workspaceRestoredFromBrowser = true;
+        initialDocumentApplied = true;
+        return true;
+      }
+
+      function clearStudioWorkspace() {
+        if (uiBusy) {
+          setStatus("Studio is busy.", "warning");
+          return;
+        }
+        const confirmed = window.confirm("Clear the current editor draft in this browser tab? Saved files and responses are not changed.");
+        if (!confirmed) return;
+        const preservedResponseState = {
+          responseHistory: Array.isArray(responseHistory) ? responseHistory.slice() : [],
+          responseHistoryIndex,
+          queuedLatestResponse,
+          followLatest,
+          latestResponseMarkdown,
+          latestResponseThinking,
+          latestResponseTimestamp,
+          latestResponseKind,
+          latestResponseIsStructuredCritique,
+          latestResponseHasContent,
+          latestResponseNormalized,
+          latestResponseThinkingNormalized,
+          latestCritiqueNotes,
+          latestCritiqueNotesNormalized,
+        };
+        clearPersistedWorkspaceState();
+        if (resourceDirInput) resourceDirInput.value = "";
+        if (resourceDirLabel) resourceDirLabel.textContent = "";
+        setEditorText("", { preserveScroll: false, preserveSelection: false });
+        setSourceState({ source: "blank", label: "blank", path: null, draftId: makeStudioDraftId() });
+        setEditorLanguage("markdown");
+        setEditorView("markdown");
+        responseHistory = preservedResponseState.responseHistory;
+        responseHistoryIndex = preservedResponseState.responseHistoryIndex;
+        queuedLatestResponse = preservedResponseState.queuedLatestResponse;
+        followLatest = preservedResponseState.followLatest;
+        latestResponseMarkdown = preservedResponseState.latestResponseMarkdown;
+        latestResponseThinking = preservedResponseState.latestResponseThinking;
+        latestResponseTimestamp = preservedResponseState.latestResponseTimestamp;
+        latestResponseKind = preservedResponseState.latestResponseKind;
+        latestResponseIsStructuredCritique = preservedResponseState.latestResponseIsStructuredCritique;
+        latestResponseHasContent = preservedResponseState.latestResponseHasContent;
+        latestResponseNormalized = preservedResponseState.latestResponseNormalized;
+        latestResponseThinkingNormalized = preservedResponseState.latestResponseThinkingNormalized;
+        latestCritiqueNotes = preservedResponseState.latestCritiqueNotes;
+        latestCritiqueNotesNormalized = preservedResponseState.latestCritiqueNotesNormalized;
+        if (followSelect) followSelect.value = followLatest ? "on" : "off";
+        refreshResponseUi();
+        persistWorkspaceStateNow();
+        setStatus("Editor cleared. Saved files and responses were not changed.", "success");
       }
 
       function setEditorText(nextText, options) {
@@ -7826,6 +8623,7 @@
         }
         updateEditorSelectionCommentUi();
         updateOutlineUi();
+        scheduleWorkspacePersistence();
       }
 
       function applySourceTextEdit(nextText, selectionStart, selectionEnd) {
@@ -7963,6 +8761,7 @@
         updateReviewNotesUi();
         updateEditorSelectionCommentUi();
         updateOutlineUi();
+        scheduleWorkspacePersistence();
       }
 
       function setRightView(nextView) {
@@ -7995,6 +8794,7 @@
 
         refreshResponseUi();
         syncActionButtons();
+        scheduleWorkspacePersistence();
       }
 
       function lineNumbersShouldBeVisible() {
@@ -8303,6 +9103,383 @@
         }
       }
 
+      const PREVIEW_LOCAL_TEXT_LINK_EXTENSIONS = new Set([
+        ".md", ".markdown", ".mdx", ".qmd", ".txt", ".tex", ".latex", ".rst", ".adoc",
+        ".html", ".htm", ".css", ".xml", ".yaml", ".yml", ".toml", ".json", ".jsonc", ".json5", ".csv", ".tsv", ".log",
+        ".js", ".mjs", ".cjs", ".jsx", ".ts", ".mts", ".cts", ".tsx",
+        ".py", ".pyw", ".sh", ".bash", ".zsh", ".rs", ".c", ".h", ".cpp", ".cxx", ".cc", ".hpp", ".hxx",
+        ".jl", ".f90", ".f95", ".f03", ".f", ".for", ".r", ".m", ".java", ".go", ".rb", ".swift", ".lua",
+        ".diff", ".patch",
+      ]);
+      const PREVIEW_LOCAL_IMAGE_LINK_EXTENSIONS = new Set([".png", ".jpg", ".jpeg", ".gif", ".webp"]);
+      let previewLinkMenuEl = null;
+      let activePreviewLinkContext = null;
+
+      function stripPreviewLocalLinkUrlSuffix(href) {
+        const raw = String(href || "").trim();
+        const hashIndex = raw.indexOf("#");
+        const queryIndex = raw.indexOf("?");
+        let end = raw.length;
+        if (queryIndex >= 0) end = Math.min(end, queryIndex);
+        if (hashIndex >= 0) end = Math.min(end, hashIndex);
+        return raw.slice(0, end);
+      }
+
+      function parsePreviewLocalLinkPage(href) {
+        const raw = String(href || "");
+        const parts = [];
+        const queryIndex = raw.indexOf("?");
+        if (queryIndex >= 0) {
+          const queryEnd = raw.indexOf("#", queryIndex);
+          parts.push(raw.slice(queryIndex + 1, queryEnd >= 0 ? queryEnd : raw.length));
+        }
+        const hashIndex = raw.indexOf("#");
+        if (hashIndex >= 0) parts.push(raw.slice(hashIndex + 1));
+        for (const part of parts) {
+          try {
+            const params = new URLSearchParams(part);
+            const value = params.get("page") || params.get("p");
+            if (value) {
+              const page = Number.parseInt(value, 10);
+              if (Number.isFinite(page) && page > 0) return page;
+            }
+          } catch {}
+          const match = String(part || "").match(/(?:^|[&;])page=(\d+)/i) || String(part || "").match(/^page=(\d+)$/i);
+          if (match && match[1]) {
+            const page = Number.parseInt(match[1], 10);
+            if (Number.isFinite(page) && page > 0) return page;
+          }
+        }
+        return 0;
+      }
+
+      function getPreviewLocalLinkExtension(href) {
+        const path = stripPreviewLocalLinkUrlSuffix(href);
+        const match = path.match(/\.([A-Za-z0-9_+-]+)$/);
+        return match ? ("." + match[1].toLowerCase()) : "";
+      }
+
+      function getPreviewLocalLinkKind(href) {
+        const ext = getPreviewLocalLinkExtension(href);
+        if (ext === ".pdf") return "pdf";
+        if (PREVIEW_LOCAL_TEXT_LINK_EXTENSIONS.has(ext)) return "text";
+        if (PREVIEW_LOCAL_IMAGE_LINK_EXTENSIONS.has(ext)) return "image";
+        return "other";
+      }
+
+      function isStudioLocalPreviewHref(href) {
+        const raw = String(href || "").trim();
+        if (!raw || raw.charAt(0) === "#") return false;
+        if (/^\/\//.test(raw)) return false;
+        if (/^(?:https?|mailto|tel|data|blob|javascript|about):/i.test(raw)) return false;
+        if (/^\/(?:pdf-resource|html-preview-resource|export-pdf|export-html|render-preview|render-math|local-preview-link|reveal-local-resource)(?:[?#/]|$)/i.test(raw)) return false;
+        return true;
+      }
+
+      function getEffectivePreviewLinkContext(contextOverride) {
+        const fallback = getHtmlPreviewResourceContextOptions();
+        const context = contextOverride && typeof contextOverride === "object" ? contextOverride : null;
+        return {
+          sourcePath: context && context.sourcePath ? String(context.sourcePath) : (fallback.sourcePath || ""),
+          resourceDir: context && context.resourceDir ? String(context.resourceDir) : (fallback.resourceDir || ""),
+        };
+      }
+
+      function getPreviewLinkResourceQuery(path, contextOverride) {
+        const context = getEffectivePreviewLinkContext(contextOverride);
+        const query = { path: String(path || "") };
+        if (context.sourcePath) query.sourcePath = String(context.sourcePath);
+        if (context.resourceDir) query.resourceDir = String(context.resourceDir);
+        return query;
+      }
+
+      function getPreviewLinkAnchorFromEvent(event) {
+        const target = event && event.target;
+        const anchor = target instanceof Element ? target.closest("#sourcePreview a[href], #critiqueView a[href]") : null;
+        if (!anchor) return null;
+        if (anchor.closest(".studio-pdf-card, .studio-html-artifact-toolbar, .studio-copy-block-btn")) return null;
+        const href = String(anchor.getAttribute("href") || "").trim();
+        if (!isStudioLocalPreviewHref(href)) return null;
+        return anchor;
+      }
+
+      function closePreviewLinkMenu() {
+        activePreviewLinkContext = null;
+        if (previewLinkMenuEl) previewLinkMenuEl.hidden = true;
+      }
+
+      function ensurePreviewLinkMenu() {
+        if (previewLinkMenuEl) return previewLinkMenuEl;
+        const menu = document.createElement("div");
+        menu.className = "studio-preview-link-menu";
+        menu.hidden = true;
+        menu.setAttribute("role", "menu");
+        document.body.appendChild(menu);
+        previewLinkMenuEl = menu;
+        return menu;
+      }
+
+      function appendPreviewLinkMenuButton(menu, label, action) {
+        const button = document.createElement("button");
+        button.type = "button";
+        button.setAttribute("role", "menuitem");
+        button.dataset.previewLinkAction = action;
+        button.textContent = label;
+        menu.appendChild(button);
+      }
+
+      function positionPreviewLinkMenu(menu, clientX, clientY) {
+        const margin = 8;
+        menu.style.left = "0px";
+        menu.style.top = "0px";
+        menu.hidden = false;
+        const rect = menu.getBoundingClientRect();
+        const x = Math.max(margin, Math.min(window.innerWidth - rect.width - margin, Number(clientX) || margin));
+        const y = Math.max(margin, Math.min(window.innerHeight - rect.height - margin, Number(clientY) || margin));
+        menu.style.left = x + "px";
+        menu.style.top = y + "px";
+      }
+
+      function showPreviewLinkMenu(anchor, event, contextOverride) {
+        const href = String(anchor && anchor.getAttribute ? anchor.getAttribute("href") || "" : (contextOverride && contextOverride.href ? contextOverride.href : "")).trim();
+        if (!isStudioLocalPreviewHref(href)) return false;
+        const kind = getPreviewLocalLinkKind(href);
+        const menu = ensurePreviewLinkMenu();
+        menu.innerHTML = "";
+        const linkContext = getEffectivePreviewLinkContext(contextOverride);
+        activePreviewLinkContext = {
+          href,
+          title: String((contextOverride && contextOverride.title) || (anchor && anchor.textContent) || href || "local link").trim() || href,
+          sourcePath: linkContext.sourcePath,
+          resourceDir: linkContext.resourceDir,
+        };
+        if (kind === "pdf") {
+          appendPreviewLinkMenuButton(menu, "Open PDF preview", "open-pdf");
+        } else if (kind === "text") {
+          appendPreviewLinkMenuButton(menu, "Open in new editor", "open-new");
+          appendPreviewLinkMenuButton(menu, "Open here", "open-here");
+        } else if (kind === "image") {
+          appendPreviewLinkMenuButton(menu, "Open image preview", "open-image");
+        }
+        appendPreviewLinkMenuButton(menu, "Reveal in file manager", "reveal");
+        appendPreviewLinkMenuButton(menu, "Copy path", "copy-path");
+        positionPreviewLinkMenu(menu, event && event.clientX, event && event.clientY);
+        const firstButton = menu.querySelector("button");
+        if (firstButton && typeof firstButton.focus === "function") {
+          window.setTimeout(() => firstButton.focus({ preventScroll: true }), 0);
+        }
+        return true;
+      }
+
+      async function fetchPreviewLocalLink(action, href, contextOverride) {
+        return fetchStudioJson("/local-preview-link", {
+          query: { ...getPreviewLinkResourceQuery(href, contextOverride), action },
+        });
+      }
+
+      function getPreviewPdfViewerUrl(href, contextOverride) {
+        const cleanPath = stripPreviewLocalLinkUrlSuffix(href);
+        const context = contextOverride && typeof contextOverride === "object" ? contextOverride : {};
+        const resourceUrl = buildStudioPdfResourceUrl({ path: cleanPath, sourcePath: context.sourcePath || "", resourceDir: context.resourceDir || "" }, true);
+        const page = parsePreviewLocalLinkPage(href);
+        return resourceUrl && page ? resourceUrl + "#page=" + encodeURIComponent(String(page)) : resourceUrl;
+      }
+
+      function openPreviewPdfLink(href, title, contextOverride) {
+        const viewerUrl = getPreviewPdfViewerUrl(href, contextOverride);
+        if (!viewerUrl) {
+          setStatus("Could not resolve this PDF link. Open the source file or set a working directory first.", "warning");
+          return false;
+        }
+        openStudioPdfFocusViewer(viewerUrl, title || href);
+        return true;
+      }
+
+      async function openPreviewImageLink(href, title, contextOverride, pendingWindow) {
+        const popup = pendingWindow || window.open("", "_blank");
+        try {
+          if (popup && popup.document && popup.document.body) {
+            popup.document.title = "Opening image…";
+            popup.document.body.innerHTML = "<p style=\"font: 13px -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; padding: 16px;\">Opening image…</p>";
+          }
+        } catch {}
+        try {
+          const payload = await fetchStudioJson("/html-preview-resource", {
+            query: getPreviewLinkResourceQuery(href, contextOverride),
+          });
+          const dataUrl = payload && typeof payload.dataUrl === "string" ? payload.dataUrl : "";
+          if (!dataUrl) throw new Error("Studio did not return image data.");
+          const safeTitle = escapeHtml(String(title || href || "Local image"));
+          const safeSrc = escapeHtml(dataUrl);
+          const html = "<!doctype html><html><head><meta charset='utf-8'><title>" + safeTitle + "</title>"
+            + "<style>body{margin:0;min-height:100vh;display:grid;place-items:center;background:#111;color:#eee;font:13px -apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;}img{max-width:100vw;max-height:100vh;object-fit:contain;}header{position:fixed;left:0;right:0;top:0;padding:8px 10px;background:rgba(0,0,0,.55);backdrop-filter:blur(6px);}</style>"
+            + "</head><body><header>" + safeTitle + "</header><img src='" + safeSrc + "' alt='" + safeTitle + "'></body></html>";
+          if (popup && !popup.closed && popup.document) {
+            popup.document.open();
+            popup.document.write(html);
+            popup.document.close();
+            setStatus("Opened local image preview.", "success");
+            return;
+          }
+          const opened = window.open(dataUrl, "_blank");
+          if (!opened) throw new Error("Popup blocked while opening image preview.");
+          setStatus("Opened local image preview.", "success");
+        } catch (error) {
+          if (popup && !popup.closed) {
+            try { popup.close(); } catch {}
+          }
+          throw error;
+        }
+      }
+
+      function editorHasPotentialUnsavedContent() {
+        const text = String(sourceTextEl.value || "");
+        if (!text.trim()) return false;
+        if (hasRefreshableFilePath()) return editorDiffersFromFileBackedBaseline();
+        return true;
+      }
+
+      async function openPreviewDocumentHere(href, contextOverride) {
+        if (editorHasPotentialUnsavedContent()) {
+          const confirmed = window.confirm("Replace the current editor contents with this linked file? Unsaved editor changes may be lost.");
+          if (!confirmed) return;
+        }
+        const payload = await fetchPreviewLocalLink("document", href, contextOverride);
+        if (typeof payload.text !== "string") throw new Error("Studio did not return document text.");
+        const path = typeof payload.path === "string" ? payload.path : "";
+        const label = typeof payload.label === "string" && payload.label.trim() ? payload.label.trim() : (path || "linked file");
+        const nextResourceDir = typeof payload.resourceDir === "string" ? normalizeStudioResourceDirValue(payload.resourceDir) : "";
+        if (resourceDirInput && nextResourceDir) resourceDirInput.value = nextResourceDir;
+        setEditorText(payload.text, { preserveScroll: false, preserveSelection: false });
+        setSourceState({ source: "file", label, path });
+        markFileBackedBaseline(payload.text);
+        const detected = detectLanguageFromName(path || label);
+        if (detected) setEditorLanguage(detected);
+        setEditorView("markdown");
+        setActivePane("left");
+        setStatus("Opened linked file in editor: " + label, "success");
+      }
+
+      async function openPreviewDocumentInNewEditor(href, pendingWindow, contextOverride) {
+        const popup = pendingWindow || window.open("", "_blank");
+        try {
+          if (popup && popup.document && popup.document.body) {
+            popup.document.title = "Opening linked file…";
+            popup.document.body.innerHTML = "<p style=\"font: 13px -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; padding: 16px;\">Opening linked file…</p>";
+          }
+        } catch {}
+        try {
+          const payload = await fetchPreviewLocalLink("editor-url", href, contextOverride);
+          const targetUrl = payload && typeof payload.relativeUrl === "string"
+            ? new URL(payload.relativeUrl, window.location.href).href
+            : (payload && typeof payload.url === "string" ? payload.url : "");
+          if (!targetUrl) throw new Error("Studio did not return an editor URL.");
+          if (popup && !popup.closed) {
+            try {
+              popup.opener = null;
+              popup.location.href = targetUrl;
+              setStatus("Opening linked file in a new editor.", "success");
+              return;
+            } catch {}
+          }
+          window.open(targetUrl, "_blank", "noopener");
+          setStatus("Opening linked file in a new editor.", "success");
+        } catch (error) {
+          if (popup && !popup.closed) {
+            try { popup.close(); } catch {}
+          }
+          throw error;
+        }
+      }
+
+      async function copyPreviewLocalLinkPath(href, contextOverride) {
+        const payload = await fetchPreviewLocalLink("resolve", href, contextOverride);
+        const path = typeof payload.path === "string" ? payload.path : "";
+        if (!path) throw new Error("Studio did not return a file path.");
+        const ok = await writeTextToClipboard(path);
+        if (!ok) throw new Error("Clipboard write failed.");
+        setStatus("Copied local path.", "success");
+      }
+
+      async function revealPreviewLocalLink(href, contextOverride) {
+        const query = getPreviewLinkResourceQuery(href, contextOverride);
+        const payload = await fetchStudioJson("/reveal-local-resource", {
+          method: "POST",
+          body: JSON.stringify(query),
+        });
+        setStatus(typeof payload.message === "string" ? payload.message : "Opened file manager.", "success");
+      }
+
+      async function runPreviewLinkAction(action, context) {
+        const href = context && context.href ? context.href : "";
+        if (!href) return;
+        try {
+          if (action === "open-pdf") {
+            openPreviewPdfLink(href, context.title || href, context);
+            return;
+          }
+          if (action === "open-new") {
+            await openPreviewDocumentInNewEditor(href, null, context);
+            return;
+          }
+          if (action === "open-here") {
+            await openPreviewDocumentHere(href, context);
+            return;
+          }
+          if (action === "open-image") {
+            await openPreviewImageLink(href, context.title || href, context);
+            return;
+          }
+          if (action === "copy-path") {
+            await copyPreviewLocalLinkPath(href, context);
+            return;
+          }
+          if (action === "reveal") {
+            await revealPreviewLocalLink(href, context);
+          }
+        } catch (error) {
+          setStatus((error && error.message) ? error.message : String(error || "Local link action failed."), "warning");
+        }
+      }
+
+      function handlePreviewLocalLinkClick(event) {
+        const anchor = getPreviewLinkAnchorFromEvent(event);
+        if (!anchor) return;
+        const href = String(anchor.getAttribute("href") || "").trim();
+        const kind = getPreviewLocalLinkKind(href);
+        event.preventDefault();
+        event.stopPropagation();
+        closePreviewLinkMenu();
+        const title = String(anchor.textContent || href).trim() || href;
+        if (kind === "pdf") {
+          openPreviewPdfLink(href, title);
+          return;
+        }
+        if (kind === "image") {
+          const pendingWindow = window.open("", "_blank");
+          void openPreviewImageLink(href, title, null, pendingWindow).catch((error) => {
+            setStatus((error && error.message) ? error.message : String(error || "Could not open linked image."), "warning");
+          });
+          return;
+        }
+        if (kind === "text") {
+          const pendingWindow = window.open("", "_blank");
+          void openPreviewDocumentInNewEditor(href, pendingWindow).catch((error) => {
+            setStatus((error && error.message) ? error.message : String(error || "Could not open linked file."), "warning");
+          });
+          return;
+        }
+        setStatus("Right-click this local link for file actions.", "warning");
+      }
+
+      function handlePreviewLocalLinkContextMenu(event) {
+        const anchor = getPreviewLinkAnchorFromEvent(event);
+        if (!anchor) return;
+        event.preventDefault();
+        event.stopPropagation();
+        showPreviewLinkMenu(anchor, event);
+      }
+
       function makeRequestId() {
         if (window.crypto && typeof window.crypto.randomUUID === "function") {
           return window.crypto.randomUUID().replace(/[^a-zA-Z0-9_-]/g, "_");
@@ -8520,10 +9697,6 @@
         return index > 0 ? value.slice(0, index) : "";
       }
 
-      function getCurrentResourceDirValue() {
-        return resourceDirInput ? String(resourceDirInput.value || "").trim() : "";
-      }
-
       function getDefaultQuizContextPath(scope) {
         const normalizedScope = normalizeQuizScope(scope);
         const sourcePath = sourceState && sourceState.path ? String(sourceState.path) : "";
@@ -14174,6 +15347,7 @@
           scheduleSourcePreviewRender(0);
         }
         updateOutlineUi();
+        scheduleWorkspacePersistence();
       }
 
       function setEditorHighlightMode(mode) {
@@ -14262,7 +15436,7 @@
           sendRunBtn.classList.toggle("request-stop-active", directIsStop);
           sendRunBtn.classList.toggle("repl-secondary-action", rightView === "repl" && !directIsStop);
           sendRunBtn.disabled = wsState === "Disconnected" || (!directIsStop && (uiBusy || critiqueIsStop));
-          const replHint = rightView === "repl" && getActiveReplSession()
+          const replHint = rightView === "repl" && getActiveReplSessionForCurrentRuntime()
             ? " Sends text to Pi, not the REPL; use Send chunk/selection or Send to REPL to execute code in the active REPL."
             : "";
           sendRunBtn.title = directIsStop
@@ -14283,7 +15457,7 @@
             : "Queue steering is available while Run editor text is active.";
         }
 
-        const hasReplSession = Boolean(getActiveReplSession());
+        const hasReplSession = Boolean(getActiveReplSessionForCurrentRuntime());
         if (sendReplBtn) {
           const showReplSend = rightView === "repl";
           sendReplBtn.hidden = !showReplSend;
@@ -14651,7 +15825,7 @@
           replTmuxAvailable = typeof message.tmuxAvailable === "boolean" ? message.tmuxAvailable : replTmuxAvailable;
           const sessionsChanged = setReplSessions(message.sessions);
           if (typeof message.activeSessionName === "string" && message.activeSessionName.trim()) {
-            setActiveReplSession(message.activeSessionName);
+            setActiveReplSessionForCurrentRuntime(message.activeSessionName);
           }
           const journalChanged = mergeReplJournalEntries(message.journalEntries);
           if (typeof message.transcript === "string") replTranscript = trimReplTranscript(message.transcript);
@@ -14704,7 +15878,7 @@
             }
           }
           if (typeof message.activeSessionName === "string" && message.activeSessionName.trim()) {
-            setActiveReplSession(message.activeSessionName);
+            setActiveReplSessionForCurrentRuntime(message.activeSessionName);
           }
           let journalChanged = mergeReplJournalEntries(message.journalEntries);
           if (typeof message.transcript === "string") {
@@ -14902,6 +16076,10 @@
             stickyStudioKind = null;
           }
           if (message.path) {
+            const savedResourceDir = typeof message.resourceDir === "string" && message.resourceDir.trim()
+              ? normalizeStudioResourceDirValue(message.resourceDir)
+              : dirnameForDisplayPath(message.path);
+            if (resourceDirInput) resourceDirInput.value = savedResourceDir;
             setSourceState({
               source: "file",
               label: message.label || message.path,
@@ -14977,6 +16155,10 @@
             ? nextDoc.path
             : null;
 
+          const nextResourceDir = typeof nextDoc.resourceDir === "string" && nextDoc.resourceDir.trim()
+            ? normalizeStudioResourceDirValue(nextDoc.resourceDir)
+            : (nextPath ? dirnameForDisplayPath(nextPath) : "");
+          if (resourceDirInput) resourceDirInput.value = nextResourceDir;
           setEditorText(nextDoc.text, { preserveScroll: false, preserveSelection: false });
           setSourceState({
             source: nextSource,
@@ -15519,6 +16701,8 @@
         rightPaneEl.addEventListener("focusin", (event) => activatePaneFromInteraction("right", event));
       }
 
+      setupPaneResizeHandle();
+
       if (leftFocusBtn) {
         leftFocusBtn.addEventListener("click", () => {
           if (paneFocusTarget === "left") {
@@ -15543,6 +16727,7 @@
       window.addEventListener("keydown", handlePaneShortcut);
       window.addEventListener("beforeunload", () => {
         stopFooterSpinner();
+        flushWorkspacePersistence();
         flushScratchpadPersistence();
         flushReviewNotesPersistence();
       });
@@ -15559,6 +16744,7 @@
 
       followSelect.addEventListener("change", () => {
         followLatest = followSelect.value !== "off";
+        scheduleWorkspacePersistence();
         if (followLatest && queuedLatestResponse) {
           if (responseHistory.length > 0) {
             selectHistoryIndex(responseHistory.length - 1, { silent: true });
@@ -15722,6 +16908,7 @@
           renderReviewNotesList();
           updateReviewNotesUi();
         }
+        scheduleWorkspacePersistence();
       });
 
       sourceTextEl.addEventListener("select", () => {
@@ -15898,7 +17085,10 @@
         closeExportPreviewMenu();
       });
       document.addEventListener("keydown", (event) => {
-        if (event.key === "Escape") closeExportPreviewMenu();
+        if (event.key === "Escape") {
+          closeExportPreviewMenu();
+          closePreviewLinkMenu();
+        }
       });
 
       saveAsBtn.addEventListener("click", () => {
@@ -15909,7 +17099,7 @@
         }
 
         var suggestedName = sourceState.label ? sourceState.label.replace(/^upload:\s*/i, "") : "draft.md";
-        var suggestedDir = resourceDirInput && resourceDirInput.value.trim() ? resourceDirInput.value.trim().replace(/\/$/, "") + "/" : "./";
+        var suggestedDir = getCurrentResourceDirValue() ? getCurrentResourceDirValue().replace(/\/$/, "") + "/" : "./";
         const suggested = sourceState.path || (suggestedDir + suggestedName);
         const path = window.prompt("Save editor content as:", suggested);
         if (!path) return;
@@ -15988,6 +17178,12 @@
         });
       }
 
+      if (clearWorkspaceBtn) {
+        clearWorkspaceBtn.addEventListener("click", () => {
+          clearStudioWorkspace();
+        });
+      }
+
       sendEditorBtn.addEventListener("click", () => {
         const content = sourceTextEl.value;
         if (!content.trim()) {
@@ -16025,9 +17221,7 @@
             content,
             label: sourceState && sourceState.label ? sourceState.label : "current editor",
             path: sourceState && sourceState.path ? sourceState.path : undefined,
-            resourceDir: resourceDirInput && resourceDirInput.value.trim()
-              ? resourceDirInput.value.trim()
-              : undefined,
+            resourceDir: getCurrentResourceDirValue() || undefined,
           });
 
           if (!sent) {
@@ -16067,9 +17261,7 @@
             type: "load_git_diff_request",
             requestId,
             sourcePath: effectivePath || sourceState.path || undefined,
-            resourceDir: resourceDirInput && resourceDirInput.value.trim()
-              ? resourceDirInput.value.trim()
-              : undefined,
+            resourceDir: getCurrentResourceDirValue() || undefined,
           });
 
           if (!sent) {
@@ -16288,6 +17480,27 @@
         void handleCopyPreviewBlockButtonClick(event);
       }, true);
 
+      document.addEventListener("click", (event) => {
+        const target = event.target;
+        const menuButton = target instanceof Element ? target.closest(".studio-preview-link-menu [data-preview-link-action]") : null;
+        if (menuButton) {
+          event.preventDefault();
+          event.stopPropagation();
+          const action = String(menuButton.getAttribute("data-preview-link-action") || "");
+          const context = activePreviewLinkContext;
+          closePreviewLinkMenu();
+          void runPreviewLinkAction(action, context);
+          return;
+        }
+        if (target instanceof Element && target.closest(".studio-preview-link-menu")) return;
+        closePreviewLinkMenu();
+        handlePreviewLocalLinkClick(event);
+      }, true);
+
+      document.addEventListener("contextmenu", (event) => {
+        handlePreviewLocalLinkContextMenu(event);
+      }, true);
+
       document.addEventListener("pointerup", (event) => {
         const target = event.target;
         const copyBtn = target instanceof Element ? target.closest(".studio-copy-block-btn") : null;
@@ -16478,7 +17691,8 @@
         if (resourceDirLabel) resourceDirLabel.hidden = state !== "label";
       }
       function applyResourceDir() {
-        var dir = resourceDirInput ? resourceDirInput.value.trim() : "";
+        var dir = getCurrentResourceDirValue();
+        if (resourceDirInput) resourceDirInput.value = dir;
         if (dir) {
           if (resourceDirLabel) resourceDirLabel.textContent = "Working dir: " + dir;
           showResourceDirState("label");
@@ -16488,6 +17702,7 @@
         updateSaveFileTooltip();
         syncActionButtons();
         renderSourcePreview();
+        scheduleWorkspacePersistence();
       }
       if (sourceBadgeEl) {
         sourceBadgeEl.addEventListener("click", () => {
@@ -16513,7 +17728,7 @@
             applyResourceDir();
           } else if (e.key === "Escape") {
             e.preventDefault();
-            var dir = resourceDirInput.value.trim();
+            var dir = getCurrentResourceDirValue();
             if (dir) {
               showResourceDirState("label");
             } else {
@@ -16530,6 +17745,7 @@
           updateSaveFileTooltip();
           syncActionButtons();
           renderSourcePreview();
+          scheduleWorkspacePersistence();
         });
       }
 
@@ -16578,7 +17794,7 @@
       setResponseFontSize(initialResponseFontSize, { persist: false });
 
       if (resourceDirInput && initialResourceDir) {
-        resourceDirInput.value = initialResourceDir;
+        resourceDirInput.value = normalizeStudioResourceDirValue(initialResourceDir);
       }
       setSourceState(initialSourceState);
       refreshResponseUi();
@@ -16606,9 +17822,16 @@
       setAnnotationsEnabled(initialAnnotationsEnabled, { silent: true });
       setReplSendMode(replSendMode);
 
+      const persistedWorkspaceState = readPersistedWorkspaceState();
+      applyPersistedWorkspaceState(persistedWorkspaceState);
+
       setEditorView(editorView);
       setRightView(rightView);
       renderSourcePreview();
+      workspacePersistenceReady = true;
+      if (workspaceRestoredFromBrowser) {
+        setStatus("Restored editor workspace from this browser tab. Use Clear editor to discard it.", "success");
+      }
       connect();
       } catch (error) {
         hardFail("Studio UI init failed", error);