pi-studio 0.5.58 → 0.6.0

package/CHANGELOG.md

@@ -4,6 +4,28 @@ All notable changes to `pi-studio` are documented here.
 
 ## [Unreleased]
 
+## [0.6.0] — 2026-04-27
+
+### Added
+- The comments rail now includes **Comments → prompt**, which turns non-empty local comments into an editor prompt with line anchors and file labels when available.
+
+### Changed
+- The refreshed Studio layout is now the default, with the classic layout still available via the footer UI switch or `?uiRefresh=0`.
+- Working-view tool output now replaces image/base64 payloads with compact placeholders instead of dumping raw image data.
+
+### Fixed
+- Queued steering now updates Studio's active effective-prompt metadata so response history and prompt loading reflect the original run plus steering messages.
+- Newly arrived responses now force the right response pane to reset to the top, while editor-preview/document views still preserve scroll.
+
+## [0.5.59] — 2026-04-27
+
+### Added
+- Added an opt-in refreshed Studio layout, available via the footer UI switch or `?uiRefresh=1`, while keeping the classic layout as the default.
+- Added refreshed layout support for editor-only Studio mode.
+
+### Changed
+- Tuned refreshed pane headers, toolbar grouping, focus controls, dropdown labels, queue steering sizing, and preview export styling.
+
 ## [0.5.58] — 2026-04-24
 
 ### Added

package/client/studio-client.js

@@ -132,6 +132,7 @@
       const reviewNotesListEl = document.getElementById("reviewNotesList");
       const reviewNotesEmptyStateEl = document.getElementById("reviewNotesEmptyState");
       const reviewNotesAddBtn = document.getElementById("reviewNotesAddBtn");
+      const reviewNotesPromptBtn = document.getElementById("reviewNotesPromptBtn");
       const reviewNotesInlineAllBtn = document.getElementById("reviewNotesInlineAllBtn");
       const reviewNotesDeleteAllBtn = document.getElementById("reviewNotesDeleteAllBtn");
       const reviewNotesCloseBtn = document.getElementById("reviewNotesCloseBtn");
@@ -644,6 +645,12 @@
       let lineNumbersEnabled = false;
       let lineNumbersRenderRaf = null;
       let annotationsEnabled = true;
+      const STUDIO_UI_REFRESH_STORAGE_KEY = "piStudio.uiRefresh";
+      const studioUiRefreshEnabled = readStudioUiRefreshEnabled();
+      let studioUiRefreshUi = null;
+      if (studioUiRefreshEnabled && document.body) {
+        document.body.classList.add("studio-ui-refresh");
+      }
       let scratchpadText = "";
       let scratchpadReturnFocusEl = null;
       let scratchpadPersistTimer = null;
@@ -662,6 +669,332 @@
       let suppressedEditorSelectionEnd = null;
       const previewJumpHighlightState = new WeakMap();
       const PREVIEW_ANNOTATION_PLACEHOLDER_PREFIX = "PISTUDIOANNOT";
+
+      function readStudioUiRefreshEnabled() {
+        const normalize = (value) => String(value == null ? "" : value).trim().toLowerCase();
+        const queryValue = initialQueryParams.has("uiRefresh")
+          ? initialQueryParams.get("uiRefresh")
+          : (initialQueryParams.has("studioUiRefresh") ? initialQueryParams.get("studioUiRefresh") : null);
+        const isTruthy = (value) => ["1", "true", "yes", "on", "v2", "refresh", "fresh"].indexOf(normalize(value)) !== -1;
+        const isFalsey = (value) => ["0", "false", "no", "off", "classic"].indexOf(normalize(value)) !== -1;
+        if (queryValue !== null) {
+          const normalizedQuery = normalize(queryValue);
+          const enabled = isTruthy(queryValue) || (!isFalsey(queryValue) && normalizedQuery !== "");
+          try {
+            window.localStorage && window.localStorage.setItem(STUDIO_UI_REFRESH_STORAGE_KEY, enabled ? "1" : "0");
+          } catch {}
+          return enabled;
+        }
+        try {
+          const stored = window.localStorage ? window.localStorage.getItem(STUDIO_UI_REFRESH_STORAGE_KEY) : null;
+          if (stored !== null) return stored !== "0" && !isFalsey(stored);
+        } catch {}
+        return true;
+      }
+
+      function makeStudioUiRefreshElement(tagName, className, text) {
+        const element = document.createElement(tagName);
+        if (className) element.className = className;
+        if (typeof text === "string") element.textContent = text;
+        return element;
+      }
+
+      function makeStudioUiRefreshSeparator() {
+        return makeStudioUiRefreshElement("span", "studio-refresh-sep");
+      }
+
+      function makeStudioUiRefreshIcon(kind) {
+        const svg = document.createElementNS("http://www.w3.org/2000/svg", "svg");
+        svg.setAttribute("viewBox", "0 0 24 24");
+        svg.setAttribute("aria-hidden", "true");
+        svg.classList.add("studio-refresh-icon");
+        const paths = kind === "focus-exit"
+          ? ["M4 4l6 6", "M10 4v6H4", "M20 20l-6-6", "M14 20v-6h6"]
+          : ["M14 4h6v6", "M20 4l-6 6", "M10 20H4v-6", "M4 20l6-6"];
+        for (const d of paths) {
+          const path = document.createElementNS("http://www.w3.org/2000/svg", "path");
+          path.setAttribute("d", d);
+          svg.appendChild(path);
+        }
+        return svg;
+      }
+
+      function setStudioUiRefreshFocusButtonIcon(buttonEl, isFocusedPane) {
+        if (!buttonEl || !studioUiRefreshEnabled) return;
+        buttonEl.replaceChildren(makeStudioUiRefreshIcon(isFocusedPane ? "focus-exit" : "focus"));
+        buttonEl.setAttribute("aria-label", isFocusedPane ? "Exit focus" : "Focus pane");
+      }
+
+      function appendStudioUiRefreshMenuSection(menuEl, heading, controls) {
+        const sectionEl = makeStudioUiRefreshElement("div", "studio-refresh-menu-section");
+        if (heading) {
+          sectionEl.appendChild(makeStudioUiRefreshElement("div", "studio-refresh-menu-heading", heading));
+        }
+        for (const control of controls) {
+          if (!control) continue;
+          const itemEl = makeStudioUiRefreshElement("div", "studio-refresh-menu-item");
+          itemEl.appendChild(control);
+          sectionEl.appendChild(itemEl);
+        }
+        menuEl.appendChild(sectionEl);
+      }
+
+      function getStudioUiRefreshSelectSummary(selectEl, prefix) {
+        if (!selectEl) return "";
+        const option = selectEl.options && selectEl.selectedIndex >= 0 ? selectEl.options[selectEl.selectedIndex] : null;
+        let label = option ? String(option.textContent || option.label || option.value || "") : String(selectEl.value || "");
+        if (prefix) label = label.replace(new RegExp("^" + prefix.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "\\s*:?\\s*", "i"), "");
+        return label.trim();
+      }
+
+      function setStudioUiRefreshButtonText(buttonEl, text) {
+        if (!buttonEl) return;
+        buttonEl.textContent = text;
+      }
+
+      function getStudioUiRefreshAnnotationHeaderEnabled() {
+        try {
+          return Boolean(stripAnnotationHeader(sourceTextEl.value).hadHeader);
+        } catch {
+          return false;
+        }
+      }
+
+      function syncStudioUiRefreshSummaries() {
+        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);
+          }
+        }
+        if (studioUiRefreshUi.viewButton) {
+          const syntaxLabel = editorHighlightEnabled
+            ? (getStudioUiRefreshSelectSummary(highlightSelect, "Syntax highlight") || editorLanguage || "Markdown")
+            : "Off";
+          const lineLabel = lineNumbersEnabled ? "Lines on" : "Lines off";
+          setStudioUiRefreshButtonText(studioUiRefreshUi.viewButton, "View: " + syntaxLabel + " · " + lineLabel);
+        }
+        syncStudioUiRefreshReviewTrigger();
+      }
+
+      function closeStudioUiRefreshMenus() {
+        if (!studioUiRefreshUi || !studioUiRefreshUi.menus) return;
+        for (const item of studioUiRefreshUi.menus) {
+          item.menu.hidden = true;
+          item.button.classList.remove("is-open");
+          item.button.setAttribute("aria-expanded", "false");
+        }
+      }
+
+      function toggleStudioUiRefreshMenu(name) {
+        if (!studioUiRefreshUi || !studioUiRefreshUi.menus) return;
+        let willOpen = false;
+        for (const item of studioUiRefreshUi.menus) {
+          if (item.name === name) willOpen = item.menu.hidden;
+        }
+        for (const item of studioUiRefreshUi.menus) {
+          const isOpen = willOpen && item.name === name;
+          item.menu.hidden = !isOpen;
+          item.button.classList.toggle("is-open", isOpen);
+          item.button.setAttribute("aria-expanded", isOpen ? "true" : "false");
+        }
+      }
+
+      function syncStudioUiRefreshReviewTrigger() {
+        if (!studioUiRefreshUi || !studioUiRefreshUi.reviewButton) return;
+        const critiqueIsStop = getAbortablePendingKind() === "critique";
+        const reviewButton = studioUiRefreshUi.reviewButton;
+        reviewButton.textContent = critiqueIsStop ? "Stop critique" : "Review";
+        reviewButton.classList.toggle("request-stop-active", critiqueIsStop);
+        reviewButton.disabled = critiqueIsStop ? Boolean(critiqueBtn && critiqueBtn.disabled) : false;
+        reviewButton.title = critiqueIsStop
+          ? "Stop the running critique request. Shortcut: Esc."
+          : "Open review actions and settings.";
+        if (critiqueIsStop) {
+          closeStudioUiRefreshMenus();
+        }
+      }
+
+      function makeStudioUiRefreshMenu(buttonEl, name, menuClassName) {
+        const anchorEl = makeStudioUiRefreshElement("span", "studio-refresh-menu-anchor " + (menuClassName || ""));
+        const menuEl = makeStudioUiRefreshElement("div", "studio-refresh-menu");
+        menuEl.hidden = true;
+        buttonEl.type = "button";
+        buttonEl.classList.add("studio-refresh-chip");
+        buttonEl.setAttribute("aria-haspopup", "menu");
+        buttonEl.setAttribute("aria-expanded", "false");
+        buttonEl.addEventListener("click", (event) => {
+          event.stopPropagation();
+          if (name === "review" && getAbortablePendingKind() === "critique") {
+            requestCancelForPendingRequest("critique");
+            return;
+          }
+          toggleStudioUiRefreshMenu(name);
+        });
+        anchorEl.appendChild(buttonEl);
+        anchorEl.appendChild(menuEl);
+        return { name, anchor: anchorEl, button: buttonEl, menu: menuEl };
+      }
+
+      function setStudioUiRefreshPreference(enabled) {
+        try {
+          window.localStorage && window.localStorage.setItem(STUDIO_UI_REFRESH_STORAGE_KEY, enabled ? "1" : "0");
+        } catch {}
+        try {
+          const url = new URL(window.location.href);
+          url.searchParams.set("uiRefresh", enabled ? "1" : "0");
+          window.location.assign(url.toString());
+        } catch {
+          window.location.reload();
+        }
+      }
+
+      function setupStudioUiRefreshToggleButton() {
+        if (!footerMetaEl || document.getElementById("studioUiRefreshToggleBtn")) return;
+        const button = makeStudioUiRefreshElement("button", "footer-compact-btn studio-ui-refresh-toggle", studioUiRefreshEnabled ? "UI: Fresh" : "UI: Classic");
+        button.id = "studioUiRefreshToggleBtn";
+        button.type = "button";
+        button.title = studioUiRefreshEnabled
+          ? "Switch Studio to the classic layout."
+          : "Switch Studio to the refreshed layout.";
+        button.addEventListener("click", () => {
+          setStudioUiRefreshPreference(!studioUiRefreshEnabled);
+        });
+        if (compactBtn && compactBtn.parentNode === footerMetaEl) {
+          compactBtn.insertAdjacentElement("afterend", button);
+        } else {
+          footerMetaEl.appendChild(button);
+        }
+      }
+
+      function setupStudioUiRefreshPrototype() {
+        if (!studioUiRefreshEnabled || studioUiRefreshUi) return;
+        const leftHeaderEl = document.getElementById("leftSectionHeader");
+        const sourceMetaEl = leftPaneEl ? leftPaneEl.querySelector(".source-meta") : null;
+        if (!leftHeaderEl || !sourceMetaEl || !copyDraftBtn) return;
+
+        let reviewMenu = null;
+        if (!isEditorOnlyMode && critiqueBtn && lensSelect) {
+          const reviewButton = makeStudioUiRefreshElement("button", "studio-refresh-tool-tab studio-refresh-review-btn", "Review");
+          reviewMenu = makeStudioUiRefreshMenu(reviewButton, "review", "studio-refresh-review-anchor");
+          appendStudioUiRefreshMenuSection(reviewMenu.menu, "Action", [critiqueBtn]);
+          appendStudioUiRefreshMenuSection(reviewMenu.menu, "Setting", [lensSelect]);
+        }
+
+        const headerTopEl = makeStudioUiRefreshElement("div", "studio-refresh-header-top");
+        const titleGroupEl = makeStudioUiRefreshElement("div", "studio-refresh-title-group");
+        if (leftFocusBtn) {
+          setStudioUiRefreshFocusButtonIcon(leftFocusBtn, false);
+          titleGroupEl.appendChild(leftFocusBtn);
+        }
+        titleGroupEl.appendChild(makeStudioUiRefreshSeparator());
+        if (isEditorOnlyMode) {
+          titleGroupEl.appendChild(makeStudioUiRefreshElement("span", "studio-refresh-static-title", "Editor (Raw)"));
+        } else if (editorViewSelect) {
+          titleGroupEl.appendChild(editorViewSelect);
+        }
+        headerTopEl.appendChild(titleGroupEl);
+        const headerToolsEl = makeStudioUiRefreshElement("div", "studio-refresh-pane-tools");
+        if (reviewNotesBtn) headerToolsEl.appendChild(reviewNotesBtn);
+        if (outlineBtn) headerToolsEl.appendChild(outlineBtn);
+        if (scratchpadBtn) headerToolsEl.appendChild(scratchpadBtn);
+        if (reviewMenu) headerToolsEl.appendChild(reviewMenu.anchor);
+        headerTopEl.appendChild(headerToolsEl);
+
+        const headerUtilityEl = makeStudioUiRefreshElement("div", "studio-refresh-header-utility");
+        const utilityLeftEl = makeStudioUiRefreshElement("div", "studio-refresh-utility-left");
+        if (sourceBadgeEl) utilityLeftEl.appendChild(sourceBadgeEl);
+        if (sourceBadgeEl && (resourceDirBtn || resourceDirLabel || resourceDirInputWrap || syncBadgeEl)) {
+          utilityLeftEl.appendChild(makeStudioUiRefreshSeparator());
+        }
+        if (resourceDirBtn) utilityLeftEl.appendChild(resourceDirBtn);
+        if (resourceDirLabel) utilityLeftEl.appendChild(resourceDirLabel);
+        if (resourceDirInputWrap) utilityLeftEl.appendChild(resourceDirInputWrap);
+        if (syncBadgeEl) utilityLeftEl.appendChild(syncBadgeEl);
+        headerUtilityEl.appendChild(utilityLeftEl);
+        leftHeaderEl.replaceChildren(headerTopEl, headerUtilityEl);
+
+        const rightHeaderEl = document.getElementById("rightSectionHeader");
+        if (rightHeaderEl && rightViewSelect) {
+          const rightIdentityEl = makeStudioUiRefreshElement("div", "studio-refresh-pane-identity studio-refresh-pane-identity-right");
+          const rightTitleGroupEl = makeStudioUiRefreshElement("div", "studio-refresh-title-group");
+          if (rightFocusBtn) {
+            setStudioUiRefreshFocusButtonIcon(rightFocusBtn, false);
+            rightTitleGroupEl.appendChild(rightFocusBtn);
+            rightTitleGroupEl.appendChild(makeStudioUiRefreshSeparator());
+          }
+          if (isEditorOnlyMode) {
+            rightTitleGroupEl.appendChild(makeStudioUiRefreshElement("span", "studio-refresh-static-title", "Editor (Preview)"));
+          } else {
+            rightTitleGroupEl.appendChild(rightViewSelect);
+          }
+          rightIdentityEl.appendChild(rightTitleGroupEl);
+          const rightToolsEl = makeStudioUiRefreshElement("div", "studio-refresh-pane-tools");
+          if (exportPdfBtn) rightToolsEl.appendChild(exportPdfBtn);
+          rightHeaderEl.replaceChildren(rightIdentityEl, rightToolsEl);
+        }
+
+        const toolbarEl = makeStudioUiRefreshElement("div", "studio-refresh-toolbar");
+        const toolbarMainEl = makeStudioUiRefreshElement("div", "studio-refresh-toolbar-main");
+        const actionsEl = makeStudioUiRefreshElement("div", "studio-refresh-toolbar-actions");
+        const actionLineOneEl = makeStudioUiRefreshElement("div", "studio-refresh-action-line");
+        if (!isEditorOnlyMode && sendRunBtn) actionLineOneEl.appendChild(sendRunBtn);
+        if (!isEditorOnlyMode && queueSteerBtn) actionLineOneEl.appendChild(queueSteerBtn);
+        const actionLineTwoEl = makeStudioUiRefreshElement("div", "studio-refresh-action-line");
+        actionLineTwoEl.appendChild(copyDraftBtn);
+        if (!isEditorOnlyMode && sendEditorBtn) actionLineTwoEl.appendChild(sendEditorBtn);
+        if (actionLineOneEl.childNodes.length > 0) actionsEl.appendChild(actionLineOneEl);
+        actionsEl.appendChild(actionLineTwoEl);
+
+        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, "Actions", [stripAnnotationsBtn, saveAnnotatedBtn]);
+        const viewButton = makeStudioUiRefreshElement("button", "", "View");
+        const viewMenu = makeStudioUiRefreshMenu(viewButton, "view", "studio-refresh-view-anchor");
+        appendStudioUiRefreshMenuSection(viewMenu.menu, "Display", [highlightSelect, lineNumbersSelect]);
+        stateEl.appendChild(annotationsMenu.anchor);
+        stateEl.appendChild(viewMenu.anchor);
+
+        toolbarMainEl.appendChild(actionsEl);
+        toolbarMainEl.appendChild(stateEl);
+        toolbarEl.appendChild(toolbarMainEl);
+        sourceMetaEl.replaceChildren(toolbarEl);
+
+        studioUiRefreshUi = {
+          annotationsButton,
+          viewButton,
+          reviewButton: reviewMenu ? reviewMenu.button : null,
+          menus: [annotationsMenu, viewMenu].concat(reviewMenu ? [reviewMenu] : []),
+        };
+
+        document.addEventListener("click", (event) => {
+          const target = event.target;
+          if (target instanceof Element && target.closest(".studio-refresh-menu-anchor")) return;
+          closeStudioUiRefreshMenus();
+        });
+        document.addEventListener("keydown", (event) => {
+          if (event.key === "Escape") closeStudioUiRefreshMenus();
+        });
+        toolbarEl.addEventListener("change", () => {
+          window.setTimeout(syncStudioUiRefreshSummaries, 0);
+        });
+        toolbarEl.addEventListener("click", (event) => {
+          const target = event.target;
+          if (target instanceof Element && target.closest(".studio-refresh-menu")) {
+            window.setTimeout(syncStudioUiRefreshSummaries, 0);
+          }
+        });
+        syncStudioUiRefreshSummaries();
+      }
+
+      setupStudioUiRefreshToggleButton();
+      setupStudioUiRefreshPrototype();
       const annotationHelpers = globalThis.PiStudioAnnotationHelpers;
       if (!annotationHelpers || typeof annotationHelpers.collectInlineAnnotationMarkers !== "function") {
         throw new Error("Studio annotation helpers failed to load.");
@@ -932,7 +1265,24 @@
         }
       }
 
-      function formatContextUsageText() {
+      function formatCompactNumber(value) {
+        if (typeof value !== "number" || !Number.isFinite(value)) return "?";
+        const sign = value < 0 ? "-" : "";
+        const abs = Math.abs(value);
+        if (abs < 1000) return sign + formatNumber(abs);
+        const units = [
+          { divisor: 1_000_000_000, suffix: "B" },
+          { divisor: 1_000_000, suffix: "M" },
+          { divisor: 1_000, suffix: "k" },
+        ];
+        const unit = units.find((entry) => abs >= entry.divisor) || units[units.length - 1];
+        const scaled = abs / unit.divisor;
+        const decimals = scaled >= 100 ? 0 : 1;
+        return sign + scaled.toFixed(decimals).replace(/\.0$/, "") + unit.suffix;
+      }
+
+      function formatContextUsageText(compact) {
+        const formatContextNumber = compact ? formatCompactNumber : formatNumber;
         const hasWindow = typeof contextWindow === "number" && Number.isFinite(contextWindow) && contextWindow > 0;
         const hasTokens = typeof contextTokens === "number" && Number.isFinite(contextTokens) && contextTokens >= 0;
         let percentValue = typeof contextPercent === "number" && Number.isFinite(contextPercent)
@@ -947,12 +1297,12 @@
           return "Context: unknown";
         }
         if (!hasTokens && hasWindow) {
-          return "Context: ? / " + formatNumber(contextWindow);
+          return "Context: ? / " + formatContextNumber(contextWindow);
         }
 
-        let text = "Context: " + formatNumber(contextTokens);
+        let text = "Context: " + formatContextNumber(contextTokens);
         if (hasWindow) {
-          text += " / " + formatNumber(contextWindow);
+          text += " / " + formatContextNumber(contextWindow);
         }
         if (percentValue != null && Number.isFinite(percentValue)) {
           const bounded = Math.max(0, Math.min(100, percentValue));
@@ -1182,14 +1532,16 @@
       function updateFooterMeta() {
         const modelText = modelLabel && modelLabel.trim() ? modelLabel.trim() : "none";
         const terminalText = terminalSessionLabel && terminalSessionLabel.trim() ? terminalSessionLabel.trim() : "unknown";
-        const contextText = formatContextUsageText();
+        const contextText = formatContextUsageText(true);
+        const contextTitleText = formatContextUsageText(false);
         const text = "Model: " + modelText + " · Terminal: " + terminalText + " · " + contextText;
+        const titleText = "Model: " + modelText + " · Terminal: " + terminalText + " · " + contextTitleText;
         if (footerMetaTextEl) {
           footerMetaTextEl.textContent = text;
-          footerMetaTextEl.title = text;
+          footerMetaTextEl.title = titleText;
         } else if (footerMetaEl) {
           footerMetaEl.textContent = text;
-          footerMetaEl.title = text;
+          footerMetaEl.title = titleText;
         }
         updateDocumentTitle();
       }
@@ -1301,7 +1653,7 @@
 
       function updateSourceBadge() {
         const label = sourceState && sourceState.label ? sourceState.label : "blank";
-        sourceBadgeEl.textContent = "Editor origin: " + label;
+        sourceBadgeEl.textContent = (studioUiRefreshEnabled ? "Origin: " : "Editor origin: ") + label;
         const descriptor = getCurrentStudioDocumentDescriptor();
         if (sourceBadgeEl) {
           sourceBadgeEl.title = descriptor.fileBacked
@@ -1362,6 +1714,9 @@
           btn.classList.toggle("is-active", isFocusedPane);
           btn.setAttribute("aria-pressed", isFocusedPane ? "true" : "false");
           btn.textContent = isFocusedPane ? "Exit focus" : "Focus pane";
+          if (studioUiRefreshEnabled) {
+            setStudioUiRefreshFocusButtonIcon(btn, isFocusedPane);
+          }
           btn.title = isFocusedPane
             ? "Return to the two-pane layout. Shortcut: F10 or Cmd/Ctrl+Esc."
             : "Show only the " + paneName + " pane. Shortcut: F10 or Cmd/Ctrl+Esc.";
@@ -3849,6 +4204,7 @@
         if (lineNumbersSelect) {
           lineNumbersSelect.value = lineNumbersEnabled ? "on" : "off";
         }
+        syncStudioUiRefreshSummaries();
         updateLineNumberGutterVisibility();
         scheduleEditorLineNumberRender();
         if (editorHighlightEnabled && editorView === "markdown") {
@@ -4537,6 +4893,7 @@
         if (stripAnnotationsBtn) {
           stripAnnotationsBtn.disabled = uiBusy || !hasAnnotationMarkers(sourceTextEl.value);
         }
+        syncStudioUiRefreshSummaries();
       }
 
       function scheduleEditorMetaUpdate() {
@@ -5412,6 +5769,87 @@
         };
       }
 
+      function getDiffFileLabelForLine(source, lineNumber) {
+        const lines = String(source || "").replace(/\r\n/g, "\n").split("\n");
+        const safeLine = Math.max(1, Math.min(Math.floor(Number(lineNumber) || 1), Math.max(1, lines.length)));
+        let currentFile = "";
+        for (let i = 0; i < safeLine; i += 1) {
+          const line = String(lines[i] || "");
+          const diffMatch = line.match(/^diff --git\s+a\/(.+?)\s+b\/(.+?)\s*$/);
+          if (diffMatch) {
+            currentFile = diffMatch[2] || diffMatch[1] || currentFile;
+            continue;
+          }
+          const plusMatch = line.match(/^\+\+\+\s+(?:b\/)?(.+)\s*$/);
+          if (plusMatch && plusMatch[1] && plusMatch[1] !== "/dev/null") {
+            currentFile = plusMatch[1];
+          }
+        }
+        return currentFile.trim();
+      }
+
+      function getReviewNotePromptFileLabel(note, source) {
+        if (sourceState && sourceState.path) return String(sourceState.path);
+        const bounds = getResolvedReviewNoteLineBounds(note, source);
+        const diffFile = bounds ? getDiffFileLabelForLine(source, bounds.lineStart) : "";
+        if (diffFile) return diffFile;
+        const descriptor = getCurrentStudioDocumentDescriptor();
+        return descriptor && descriptor.fileBacked ? descriptor.label : "";
+      }
+
+      function formatReviewNotePromptLineRange(bounds, note) {
+        const start = bounds ? bounds.lineStart : Math.max(1, Number(note && note.lineStart) || 1);
+        const end = bounds ? bounds.lineEnd : Math.max(start, Number(note && note.lineEnd) || start);
+        return start === end ? "L" + start : ("L" + start + "-L" + end);
+      }
+
+      function buildReviewNotesPrompt() {
+        const source = String(sourceTextEl && sourceTextEl.value ? sourceTextEl.value : "");
+        const notes = getDisplayReviewNotes().filter((note) => String(note && note.text ? note.text : "").trim());
+        if (!notes.length) return "";
+
+        const descriptor = getCurrentStudioDocumentDescriptor();
+        const documentLabel = descriptor && descriptor.label ? descriptor.label : (sourceState && sourceState.label ? sourceState.label : "Studio document");
+        const parts = [
+          "Please address the following Studio comments. Use the file names and line numbers as anchors. The full document is not included here, only the comments and their anchors.",
+          "Document: " + documentLabel,
+          "",
+          "## Comments",
+        ];
+
+        notes.forEach((note, index) => {
+          const bounds = getResolvedReviewNoteLineBounds(note, source);
+          const fileLabel = getReviewNotePromptFileLabel(note, source);
+          const location = (fileLabel ? (fileLabel + ":") : "") + formatReviewNotePromptLineRange(bounds, note);
+          const comment = String(note && note.text ? note.text : "").trim();
+          const anchor = String(note && (note.selectedDisplayText || note.selectedText) ? (note.selectedDisplayText || note.selectedText) : "")
+            .replace(/\s+/g, " ")
+            .trim();
+          parts.push(
+            "### Comment " + (index + 1) + " — " + location,
+            "",
+            comment,
+          );
+          if (anchor) {
+            parts.push("", "> " + anchor.replace(/\n/g, "\n> "));
+          }
+          parts.push("");
+        });
+
+        return parts.join("\n").replace(/\n{3,}/g, "\n\n").trim() + "\n";
+      }
+
+      function loadReviewNotesPromptIntoEditor() {
+        const prompt = buildReviewNotesPrompt();
+        if (!prompt.trim()) {
+          setStatus("No non-empty comments to load as a prompt.", "warning");
+          return;
+        }
+        setEditorText(prompt, { preserveScroll: false, preserveSelection: false });
+        setSourceState({ source: "blank", label: "comments prompt", path: null });
+        setStatus("Loaded comments prompt into editor.", "success");
+      }
+
       function buildReviewNoteLineMap(text) {
         const source = String(text || "");
         const lineMap = new Map();
@@ -8235,12 +8673,19 @@
               ? "Select preview text and use Comment for a local preview-anchored comment."
               : "Switch to Editor (Raw) to comment on the current line.");
         }
+        if (reviewNotesPromptBtn) {
+          const promptCandidates = reviewNotes.filter((note) => String(note && note.text ? note.text : "").trim());
+          reviewNotesPromptBtn.disabled = uiBusy || promptCandidates.length === 0;
+          reviewNotesPromptBtn.title = promptCandidates.length > 0
+            ? "Load local comments, line numbers, and file labels into the editor as a prompt."
+            : "No non-empty local comments to load as a prompt.";
+        }
         if (reviewNotesInlineAllBtn) {
           const currentText = String(sourceTextEl && sourceTextEl.value ? sourceTextEl.value : "");
           const toggleCandidates = getDisplayReviewNotes().filter((note) => getReviewNoteInlineState(note, currentText).canToggle);
           const allInline = toggleCandidates.length > 0 && toggleCandidates.every((note) => getReviewNoteInlineState(note, currentText).exists);
           reviewNotesInlineAllBtn.disabled = uiBusy || toggleCandidates.length === 0;
-          reviewNotesInlineAllBtn.textContent = allInline ? "All inline: On" : "All inline: Off";
+          reviewNotesInlineAllBtn.textContent = allInline ? "Inline: On" : "Inline: Off";
           reviewNotesInlineAllBtn.setAttribute("aria-pressed", allInline ? "true" : "false");
           reviewNotesInlineAllBtn.title = allInline
             ? "Inline annotations derived from all non-empty comments are currently on. Click to remove them."
@@ -8870,11 +9315,13 @@
         if (!highlightSelect) return;
         if (!editorHighlightEnabled) {
           highlightSelect.value = "off";
+          syncStudioUiRefreshSummaries();
           return;
         }
         highlightSelect.value = (editorLanguage && SUPPORTED_LANGUAGES.indexOf(editorLanguage) !== -1)
           ? editorLanguage
           : "markdown";
+        syncStudioUiRefreshSummaries();
       }
 
       function setEditorHighlightEnabled(enabled) {
@@ -8977,6 +9424,7 @@
             critiqueBtn.disabled = true;
             critiqueBtn.title = "Critique is unavailable in editor-only mode.";
           }
+          syncStudioUiRefreshReviewTrigger();
           return;
         }
 
@@ -9014,6 +9462,7 @@
                 ? "Critique text as-is (includes [an: ...] markers)."
                 : "Critique text with [an: ...] markers stripped."));
         }
+        syncStudioUiRefreshReviewTrigger();
       }
 
       function updateAnnotationModeUi() {
@@ -9024,6 +9473,7 @@
             : "Inline annotations Hide: keep markers in the editor, hide them in preview, and strip before Run/Critique.";
         }
 
+        syncStudioUiRefreshSummaries();
         syncRunAndCritiqueButtons();
       }
 
@@ -9362,6 +9812,7 @@
           setBusy(false);
           setWsState("Ready");
 
+          pendingResponseScrollReset = true;
           let appliedFromHistory = false;
           if (Array.isArray(message.responseHistory)) {
             appliedFromHistory = setResponseHistory(message.responseHistory, {
@@ -9390,6 +9841,9 @@
           if (pendingRequestId) return;
 
           const hasHistory = Array.isArray(message.responseHistory);
+          if (followLatest) {
+            pendingResponseScrollReset = true;
+          }
           if (hasHistory) {
             setResponseHistory(message.responseHistory, {
               autoSelectLatest: followLatest,
@@ -9413,7 +9867,7 @@
               return;
             }
 
-            if (!hasHistory && applyLatestPayload(payload)) {
+            if (!hasHistory && applyLatestPayload(payload, { resetScroll: true })) {
               queuedLatestResponse = null;
               updateResultActionButtons();
               setStatus("Updated from latest response.", "success");
@@ -9909,10 +10363,12 @@
         if (hasHeader) {
           insertHeaderBtn.textContent = "Annotation header: On";
           insertHeaderBtn.title = "Remove annotated-reply protocol header while keeping body text.";
+          syncStudioUiRefreshSummaries();
           return;
         }
         insertHeaderBtn.textContent = "Annotation header: Off";
         insertHeaderBtn.title = "Insert annotated-reply protocol header (source metadata, [an: ...] syntax hint, precedence note, and end marker).";
+        syncStudioUiRefreshSummaries();
       }
 
       function toggleAnnotatedReplyHeader() {
@@ -10581,6 +11037,12 @@
         });
       }
 
+      if (reviewNotesPromptBtn) {
+        reviewNotesPromptBtn.addEventListener("click", () => {
+          loadReviewNotesPromptIntoEditor();
+        });
+      }
+
       if (reviewNotesInlineAllBtn) {
         reviewNotesInlineAllBtn.addEventListener("click", () => {
           toggleAllReviewNotesInlineAnnotations();