pi-studio 0.6.9 → 0.7.0

package/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to `pi-studio` are documented here.
 
 ## [Unreleased]
 
+## [0.7.0] — 2026-05-06
+
+### Added
+- Added explicit `studio-pdf` fenced blocks that render token-protected local PDFs in Studio preview cards.
+- Added an **Open new editor** action that opens a detached copy of the current editor text in a new editor-only Studio view.
+- Documented Studio Markdown asset paths and `studio-pdf` syntax in the README.
+
+### Changed
+- Hid response-sync badges in editor-only Studio views, simplified editor action labels, and slightly strengthened refreshed-layout focus icons.
+
+## [0.6.10] — 2026-05-04
+
+### Fixed
+- SSH tunnel hints now include the full tokenized Studio URL directly so the token remains visible even when the terminal only shows the latest notification.
+
 ## [0.6.9] — 2026-05-01
 
 ### Changed

package/README.md

@@ -19,7 +19,7 @@ Extension for [pi](https://pi.dev) that opens a local two-pane browser workspace
 ## What it does
 
 - Opens a two-pane browser workspace: **Editor** (left) + **Response/Working/Editor Preview** (right)
-- Supports one canonical full Studio view per Pi session, plus additional editor-only companion views when you just want extra editing/preview surfaces
+- Supports one canonical full Studio view per Pi session, plus additional editor-only companion views when you just want extra editing/preview surfaces; the editor toolbar can open a detached copy of the current editor text as a companion view
 - Runs editor text directly, or asks for structured critique (auto/writing/code focus)
 - Includes a live **Working** view for following current model/tool activity, with `All` / `Thinking` / `Tools` filters plus **Load visible into editor** and **Copy visible** actions
 - Includes a local persistent scratchpad for quick notes you want to keep out of the main editor until you're ready to copy or insert them
@@ -35,6 +35,7 @@ Extension for [pi](https://pi.dev) that opens a local two-pane browser workspace
   - strips markers before send (optional)
   - saves `.annotated.md`
 - Renders Markdown/LaTeX/code previews (math + Mermaid), theme-synced with pi
+- Embeds local PDFs in Studio Markdown previews via explicit `studio-pdf` fenced blocks
 - Ships optional `pi-studio-dark` and `pi-studio-light` themes tuned for Studio's browser workspace
 - Exports right-pane preview as PDF (pandoc + LaTeX)
 - Exports local files headlessly via `/studio-pdf <path>` to `<name>.studio.pdf`
@@ -72,10 +73,32 @@ Run once without installing:
 pi -e https://github.com/omaclaren/pi-studio
 ```
 
+## Studio Markdown extras
+
+Studio previews standard Markdown, code fences, display math, Mermaid, and local images. When adding companion files such as generated plots or PDFs, prefer the project's existing folder convention. If there is no convention, `attachments/` is a reasonable default for newly generated assets. Use relative paths from the opened Markdown file or Studio working/resource directory, and wrap paths in angle brackets when spaces are possible:
+
+```md
+![Short descriptive caption](<attachments/plot.png>)
+```
+
+Local PDFs can be embedded with an explicit Studio-only fenced block:
+
+````md
+```studio-pdf
+path: attachments/paper.pdf
+title: Optional title
+page: 3
+height: 760
+caption: Optional caption
+```
+````
+
+`path` must point to a local `.pdf` within the current Studio resource directory. Relative paths resolve from the opened document's directory, or from Studio's working dir for non-file-backed content. `page` is an initial page hint for the browser PDF viewer, and `height` controls the embedded frame height in pixels. Use normal Markdown links for PDFs when embedding is not useful.
+
 ## Notes
 
 - Local-only server (`127.0.0.1`) with tokenized Studio URLs.
-- For remote SSH sessions, keep Studio bound to localhost and use SSH local port forwarding; `/studio` and `/studio --status` print the full tokenized localhost URL. Open that URL through the tunnel, preserving the `?token=...` parameter.
+- For remote SSH sessions, keep Studio bound to localhost and use SSH local port forwarding; `/studio` and `/studio --status` print the full tokenized localhost URL. The SSH hint repeats the full URL so it is visible even if your terminal only shows the latest notification. Open that URL through the tunnel, preserving the `?token=...` parameter.
 - Full Studio is a singleton per Pi session: use `/studio` to open it, `/studio-replace` to explicitly replace it, and `/studio-editor-only` for extra editing/preview tabs that do not take over the full Studio session view.
 - Studio is designed as a complement to terminal pi, not a replacement.
 - Installing pi-studio makes the optional `pi-studio-dark` and `pi-studio-light` themes available in pi's theme selector; it does not change your active theme.

package/client/studio-client.js

@@ -98,6 +98,7 @@
       const saveOverBtn = document.getElementById("saveOverBtn");
       const refreshFromDiskBtn = document.getElementById("refreshFromDiskBtn");
       const sendEditorBtn = document.getElementById("sendEditorBtn");
+      const openCompanionBtn = document.getElementById("openCompanionBtn");
       const getEditorBtn = document.getElementById("getEditorBtn");
       const loadGitDiffBtn = document.getElementById("loadGitDiffBtn");
       const sendRunBtn = document.getElementById("sendRunBtn");
@@ -149,7 +150,8 @@
       const isEditorOnlyMode = studioMode === "editor-only";
 
       const initialQueryParams = new URLSearchParams(window.location.search || "");
-      const explicitDocumentIdentityFromUrl = initialQueryParams.has("docSource")
+      const explicitDocumentIdentityFromUrl = initialQueryParams.has("docId")
+        || initialQueryParams.has("docSource")
         || initialQueryParams.has("docLabel")
         || initialQueryParams.has("docPath")
         || initialQueryParams.has("draftId");
@@ -163,6 +165,8 @@
         draftId: initialQueryParams.get("draftId")
           || ((document.body && document.body.dataset && document.body.dataset.initialDraftId) || null),
       };
+      const initialResourceDir = initialQueryParams.get("resourceDir")
+        || ((document.body && document.body.dataset && document.body.dataset.initialResourceDir) || "");
 
       let ws = null;
       let wsState = "Connecting";
@@ -173,6 +177,7 @@
       let pendingRequestId = null;
       let pendingKind = null;
       let stickyStudioKind = null;
+      const pendingCompanionWindows = new Map();
       let initialDocumentApplied = false;
       function getInitialRightView(source) {
         if (isEditorOnlyMode) return "editor-preview";
@@ -1041,6 +1046,7 @@
         if (!isEditorOnlyMode && queueSteerBtn) actionLineOneEl.appendChild(queueSteerBtn);
         const actionLineTwoEl = makeStudioUiRefreshElement("div", "studio-refresh-action-line");
         actionLineTwoEl.appendChild(copyDraftBtn);
+        if (openCompanionBtn) actionLineTwoEl.appendChild(openCompanionBtn);
         if (!isEditorOnlyMode && sendEditorBtn) actionLineTwoEl.appendChild(sendEditorBtn);
         if (actionLineOneEl.childNodes.length > 0) actionsEl.appendChild(actionLineOneEl);
         actionsEl.appendChild(actionLineTwoEl);
@@ -1266,6 +1272,7 @@
         if (kind === "send_to_editor") return "sending to pi editor";
         if (kind === "get_from_editor") return "loading from pi editor";
         if (kind === "load_git_diff") return "loading git diff";
+        if (kind === "open_editor_only") return "opening companion editor";
         if (kind === "refresh_from_disk") return "refreshing from disk";
         if (kind === "save_as" || kind === "save_over") return "saving editor text";
         return "submitting request";
@@ -2301,6 +2308,12 @@
       function updateSyncBadge(normalizedEditorText) {
         if (!syncBadgeEl) return;
 
+        if (isEditorOnlyMode) {
+          syncBadgeEl.hidden = true;
+          syncBadgeEl.classList.remove("sync");
+          return;
+        }
+
         if (rightView === "trace") {
           syncBadgeEl.hidden = true;
           syncBadgeEl.classList.remove("sync");
@@ -2339,6 +2352,148 @@
         return "<div class='preview-error'>" + escapeHtml(String(message || "Preview rendering failed.")) + "</div>" + buildPlainMarkdownHtml(markdown, options);
       }
 
+      function stripMatchingQuotes(value) {
+        const text = String(value || "").trim();
+        if (text.length >= 2) {
+          const first = text[0];
+          const last = text[text.length - 1];
+          if ((first === "\"" && last === "\"") || (first === "'" && last === "'")) {
+            return text.slice(1, -1).trim();
+          }
+        }
+        return text;
+      }
+
+      function parseStudioPdfBlockOptions(body) {
+        const options = { path: "", title: "", caption: "", page: "", height: "" };
+        String(body || "").split(/\r?\n/).forEach((line) => {
+          const raw = String(line || "").trim();
+          if (!raw || raw.startsWith("#")) return;
+          const match = raw.match(/^([A-Za-z][A-Za-z0-9_-]*)\s*:\s*([\s\S]*)$/);
+          if (match) {
+            const key = String(match[1] || "").toLowerCase();
+            const value = stripMatchingQuotes(match[2] || "");
+            if (key === "path" || key === "src" || key === "file") options.path = value;
+            else if (key === "title") options.title = value;
+            else if (key === "caption") options.caption = value;
+            else if (key === "page") options.page = value;
+            else if (key === "height") options.height = value;
+            return;
+          }
+          if (!options.path) options.path = stripMatchingQuotes(raw);
+        });
+        return options;
+      }
+
+      function prepareStudioPdfBlocksForPreview(markdown) {
+        const blocks = [];
+        const prefix = "STUDIO_PDF_BLOCK_" + Date.now().toString(36) + "_" + Math.random().toString(36).slice(2) + "_";
+        const source = String(markdown || "");
+        const blockPattern = /(^|\n)([ \t]{0,3})(`{3,}|~{3,})[ \t]*studio-pdf[^\n]*\n([\s\S]*?)\n[ \t]*\3[ \t]*(?=\n|$)/g;
+        const nextMarkdown = source.replace(blockPattern, (match, leadingNewline, _indent, _fence, body) => {
+          const placeholder = prefix + blocks.length;
+          blocks.push({ placeholder, options: parseStudioPdfBlockOptions(body) });
+          return String(leadingNewline || "") + placeholder + "\n";
+        });
+        return { markdown: nextMarkdown, blocks };
+      }
+
+      function normalizeStudioPdfHeight(value) {
+        const parsed = Number.parseInt(String(value || ""), 10);
+        if (!Number.isFinite(parsed)) return 680;
+        return Math.max(240, Math.min(1400, parsed));
+      }
+
+      function normalizeStudioPdfPage(value) {
+        const parsed = Number.parseInt(String(value || ""), 10);
+        return Number.isFinite(parsed) && parsed > 0 ? parsed : 0;
+      }
+
+      function buildStudioPdfResourceUrl(options) {
+        const token = getToken();
+        if (!token) return "";
+        const pdfPath = String(options && options.path ? options.path : "").trim();
+        if (!pdfPath) return "";
+        const effectivePath = getEffectiveSavePath();
+        const sourcePath = effectivePath || sourceState.path || "";
+        const params = new URLSearchParams({ token, path: pdfPath });
+        if (sourcePath) {
+          params.set("sourcePath", sourcePath);
+        } else if (resourceDirInput && resourceDirInput.value.trim()) {
+          params.set("resourceDir", resourceDirInput.value.trim());
+        }
+        return "/pdf-resource?" + params.toString();
+      }
+
+      function createStudioPdfCard(block) {
+        const options = block && block.options ? block.options : {};
+        const path = String(options.path || "").trim();
+        const title = String(options.title || path || "Embedded PDF").trim();
+        const caption = String(options.caption || "").trim();
+        const height = normalizeStudioPdfHeight(options.height);
+        const page = normalizeStudioPdfPage(options.page);
+        const resourceUrl = buildStudioPdfResourceUrl(options);
+        const viewerUrl = resourceUrl && page ? resourceUrl + "#page=" + encodeURIComponent(String(page)) : resourceUrl;
+
+        const card = document.createElement("figure");
+        card.className = "studio-pdf-card";
+
+        const header = document.createElement("figcaption");
+        header.className = "studio-pdf-card-header";
+        const label = document.createElement("div");
+        label.className = "studio-pdf-card-title";
+        label.textContent = title;
+        header.appendChild(label);
+
+        if (resourceUrl) {
+          const openLink = document.createElement("a");
+          openLink.className = "studio-pdf-card-link";
+          openLink.href = viewerUrl;
+          openLink.target = "_blank";
+          openLink.rel = "noopener noreferrer";
+          openLink.textContent = "Open PDF";
+          header.appendChild(openLink);
+        }
+        card.appendChild(header);
+
+        if (caption) {
+          const captionEl = document.createElement("div");
+          captionEl.className = "studio-pdf-card-caption";
+          captionEl.textContent = caption;
+          card.appendChild(captionEl);
+        }
+
+        if (!resourceUrl) {
+          const errorEl = document.createElement("div");
+          errorEl.className = "studio-pdf-card-error";
+          errorEl.textContent = "PDF block needs a local path.";
+          card.appendChild(errorEl);
+          return card;
+        }
+
+        const iframe = document.createElement("iframe");
+        iframe.className = "studio-pdf-frame";
+        iframe.src = viewerUrl;
+        iframe.title = title;
+        iframe.loading = "lazy";
+        iframe.style.height = height + "px";
+        card.appendChild(iframe);
+        return card;
+      }
+
+      function renderStudioPdfBlocksInElement(targetEl, blocks) {
+        if (!targetEl || !Array.isArray(blocks) || blocks.length === 0) return;
+        const candidates = Array.from(targetEl.querySelectorAll("p, pre, div"));
+        blocks.forEach((block) => {
+          const placeholder = block && block.placeholder ? block.placeholder : "";
+          if (!placeholder) return;
+          const match = candidates.find((el) => String(el.textContent || "").trim() === placeholder);
+          if (match && match.parentNode) {
+            match.replaceWith(createStudioPdfCard(block));
+          }
+        });
+      }
+
       function sanitizeRenderedHtml(html, markdown, options) {
         const rawHtml = typeof html === "string" ? html : "";
         const mathAnnotationPreserved = rawHtml.replace(/<math\b([^>]*)>([\s\S]*?)<\/math>/gi, (match, attrs, inner) => {
@@ -3499,9 +3654,10 @@
         const previewFallbackOptions = {
           stripMarkdownHtmlComments: !previewingEditorText || editorLanguage !== "latex",
         };
+        const pdfPrepared = prepareStudioPdfBlocksForPreview(previewPrepared.markdown);
 
         try {
-          const renderedHtml = await renderMarkdownWithPandoc(previewPrepared.markdown, {
+          const renderedHtml = await renderMarkdownWithPandoc(pdfPrepared.markdown, {
             includeEditorLanguage: pane === "source" || rightView === "editor-preview",
           });
 
@@ -3514,6 +3670,7 @@
           clearPreviewJumpHighlight(targetEl);
           finishPreviewRender(targetEl);
           targetEl.innerHTML = sanitizeRenderedHtml(renderedHtml, markdown, previewFallbackOptions);
+          renderStudioPdfBlocksInElement(targetEl, pdfPrepared.blocks);
           applyPreviewAnnotationPlaceholdersToElement(targetEl, previewPrepared.placeholders);
           await renderAnnotationMathInElement(targetEl);
           decoratePdfEmbeds(targetEl);
@@ -4002,6 +4159,7 @@
         if (loadGitDiffBtn) loadGitDiffBtn.disabled = uiBusy;
         syncRunAndCritiqueButtons();
         copyDraftBtn.disabled = uiBusy;
+        if (openCompanionBtn) openCompanionBtn.disabled = uiBusy || wsState !== "Ready";
         if (highlightSelect) highlightSelect.disabled = uiBusy;
         if (lineNumbersSelect) lineNumbersSelect.disabled = uiBusy;
         if (annotationModeSelect) annotationModeSelect.disabled = uiBusy;
@@ -10201,6 +10359,27 @@
           return;
         }
 
+        if (message.type === "editor_only_ready") {
+          const responseRequestId = typeof message.requestId === "string" ? message.requestId : "";
+          if (responseRequestId && pendingRequestId === responseRequestId) {
+            pendingRequestId = null;
+            pendingKind = null;
+            clearArmedTitleAttention(responseRequestId);
+            stickyStudioKind = null;
+          }
+          setBusy(false);
+          setWsState("Ready");
+          const targetUrl = resolveCompanionEditorTargetUrl(message);
+          const opened = navigatePendingCompanionWindow(responseRequestId, targetUrl);
+          setStatus(
+            opened
+              ? "Opened companion editor with a detached copy of the current editor text."
+              : (targetUrl ? "Companion editor ready: " + targetUrl : "Companion editor is ready, but Studio did not receive a URL."),
+            opened ? "success" : "warning",
+          );
+          return;
+        }
+
         if (message.type === "studio_state") {
           const busy = Boolean(message.busy);
           agentBusyFromServer = Boolean(message.agentBusy);
@@ -10267,6 +10446,9 @@
         }
 
         if (message.type === "busy") {
+          if (typeof message.requestId === "string") {
+            closePendingCompanionWindow(message.requestId);
+          }
           if (message.requestId && pendingRequestId === message.requestId) {
             if (pendingKind === "compact") {
               compactInProgress = false;
@@ -10285,6 +10467,9 @@
         }
 
         if (message.type === "error") {
+          if (typeof message.requestId === "string") {
+            closePendingCompanionWindow(message.requestId);
+          }
           if (message.requestId && pendingRequestId === message.requestId) {
             if (pendingKind === "compact") {
               compactInProgress = false;
@@ -10494,6 +10679,69 @@
         return requestId;
       }
 
+      function openPendingCompanionWindow(requestId) {
+        if (!requestId) return null;
+        let companionWindow = null;
+        try {
+          companionWindow = window.open("", "_blank");
+          if (companionWindow && companionWindow.document && companionWindow.document.body) {
+            companionWindow.document.title = "Opening companion editor…";
+            companionWindow.document.body.innerHTML = "<p style=\"font: 13px -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; padding: 16px;\">Opening companion editor…</p>";
+          }
+        } catch {
+          companionWindow = null;
+        }
+        if (companionWindow) {
+          pendingCompanionWindows.set(requestId, companionWindow);
+        }
+        return companionWindow;
+      }
+
+      function takePendingCompanionWindow(requestId) {
+        if (!requestId || !pendingCompanionWindows.has(requestId)) return null;
+        const companionWindow = pendingCompanionWindows.get(requestId);
+        pendingCompanionWindows.delete(requestId);
+        return companionWindow || null;
+      }
+
+      function closePendingCompanionWindow(requestId) {
+        const companionWindow = takePendingCompanionWindow(requestId);
+        if (!companionWindow || companionWindow.closed) return;
+        try {
+          companionWindow.close();
+        } catch {}
+      }
+
+      function resolveCompanionEditorTargetUrl(message) {
+        const relativeUrl = message && typeof message.relativeUrl === "string" ? message.relativeUrl : "";
+        if (relativeUrl) {
+          try {
+            return new URL(relativeUrl, window.location.href).href;
+          } catch {}
+        }
+        return message && typeof message.url === "string" ? message.url : "";
+      }
+
+      function navigatePendingCompanionWindow(requestId, targetUrl) {
+        if (!targetUrl) {
+          closePendingCompanionWindow(requestId);
+          return false;
+        }
+        const companionWindow = takePendingCompanionWindow(requestId);
+        if (companionWindow && !companionWindow.closed) {
+          try {
+            companionWindow.opener = null;
+            companionWindow.location.href = targetUrl;
+            return true;
+          } catch {}
+        }
+        try {
+          return Boolean(window.open(targetUrl, "_blank", "noopener"));
+        } catch {
+          return false;
+        }
+      }
+
       function describeSourceForAnnotation() {
         if (sourceState.source === "file" && sourceState.label) {
           return "file " + sourceState.label;
@@ -11056,6 +11304,38 @@
         }
       });
 
+      if (openCompanionBtn) {
+        openCompanionBtn.addEventListener("click", () => {
+          const content = sourceTextEl.value;
+          if (!content.trim()) {
+            setStatus("Editor is empty. Nothing to copy into a companion view.", "warning");
+            return;
+          }
+
+          const requestId = beginUiAction("open_editor_only");
+          if (!requestId) return;
+          openPendingCompanionWindow(requestId);
+
+          const sent = sendMessage({
+            type: "open_editor_only_request",
+            requestId,
+            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,
+          });
+
+          if (!sent) {
+            closePendingCompanionWindow(requestId);
+            pendingRequestId = null;
+            pendingKind = null;
+            setBusy(false);
+          }
+        });
+      }
+
       if (getEditorBtn) {
         getEditorBtn.addEventListener("click", () => {
           const requestId = beginUiAction("get_from_editor");
@@ -11158,7 +11438,7 @@
 
         try {
           await writeTextToClipboard(content);
-          setStatus("Copied editor text.", "success");
+          setStatus("Copied text.", "success");
         } catch (error) {
           setStatus("Clipboard write failed.", "warning");
         }
@@ -11540,6 +11820,9 @@
       const initialResponseFontSize = readStoredFontSize(RESPONSE_FONT_SIZE_STORAGE_KEY, RESPONSE_FONT_SIZE_OPTIONS, DEFAULT_RESPONSE_FONT_SIZE);
       setResponseFontSize(initialResponseFontSize, { persist: false });
 
+      if (resourceDirInput && initialResourceDir) {
+        resourceDirInput.value = initialResourceDir;
+      }
       setSourceState(initialSourceState);
       refreshResponseUi();
       updateAnnotatedReplyHeaderButton();

package/client/studio.css

@@ -1393,6 +1393,62 @@
       max-width: 100%;
     }
 
+    .rendered-markdown .studio-pdf-card {
+      margin: 1.15em 0;
+      border: 1px solid var(--panel-border);
+      border-radius: 12px;
+      background: var(--panel);
+      overflow: hidden;
+      box-shadow: 0 1px 2px var(--shadow-color);
+    }
+
+    .rendered-markdown .studio-pdf-card-header {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      gap: 10px;
+      padding: 8px 10px;
+      border-bottom: 1px solid var(--border-subtle);
+      background: var(--panel-2);
+      color: var(--studio-info-text, var(--muted));
+      font-size: 12px;
+    }
+
+    .rendered-markdown .studio-pdf-card-title {
+      min-width: 0;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+      font-weight: 600;
+      color: var(--text);
+    }
+
+    .rendered-markdown .studio-pdf-card-link {
+      flex: 0 0 auto;
+      font-size: 12px;
+      font-weight: 600;
+    }
+
+    .rendered-markdown .studio-pdf-card-caption {
+      padding: 8px 10px 0;
+      color: var(--studio-info-text, var(--muted));
+      font-size: 12px;
+    }
+
+    .rendered-markdown .studio-pdf-card-error {
+      padding: 12px;
+      color: var(--warn);
+      font-size: 12px;
+    }
+
+    .rendered-markdown .studio-pdf-frame {
+      display: block;
+      width: 100%;
+      min-height: 240px;
+      border: 0;
+      background: #fff;
+    }
+
     .rendered-markdown .studio-subfigure-group {
       margin: 1.25em auto;
     }
@@ -2579,7 +2635,7 @@
       width: 15px;
       height: 15px;
       stroke: currentColor;
-      stroke-width: 1.85;
+      stroke-width: 2;
       stroke-linecap: round;
       stroke-linejoin: round;
       fill: none;
@@ -2629,11 +2685,23 @@
       min-width: 29px;
       min-height: 29px;
       padding: 0;
-      color: var(--muted);
+      color: var(--studio-info-text, var(--muted));
       align-items: center;
       justify-content: center;
     }
 
+    body.studio-ui-refresh #leftFocusBtn:not(:disabled):hover,
+    body.studio-ui-refresh #rightFocusBtn:not(:disabled):hover {
+      color: var(--text);
+    }
+
+    body.studio-ui-refresh #leftFocusBtn.is-active,
+    body.studio-ui-refresh #rightFocusBtn.is-active {
+      background: var(--accent);
+      border-color: var(--accent);
+      color: var(--accent-contrast);
+    }
+
     body.studio-ui-refresh #sourceBadge,
     body.studio-ui-refresh #resourceDirBtn,
     body.studio-ui-refresh #resourceDirLabel {

package/index.ts

@@ -25,6 +25,7 @@ import {
 	preserveLiteralLatexCommandsInMarkdown,
 } from "./shared/studio-markdown-latex-literals.js";
 import { escapeStudioPdfLatexTextFragment } from "./shared/studio-pdf-escape.js";
+import { resolveStudioPdfResourceFile } from "./shared/studio-pdf-resource.js";
 
 type Lens = "writing" | "code";
 type RequestedLens = Lens | "auto";
@@ -115,6 +116,7 @@ interface InitialStudioDocument {
 	source: StudioSourceKind;
 	path?: string;
 	draftId?: string;
+	resourceDir?: string;
 }
 
 interface PersistedStudioReviewNote {
@@ -249,6 +251,15 @@ interface LoadGitDiffRequestMessage {
 	resourceDir?: string;
 }
 
+interface OpenEditorOnlyRequestMessage {
+	type: "open_editor_only_request";
+	requestId: string;
+	content: string;
+	label?: string;
+	path?: string;
+	resourceDir?: string;
+}
+
 interface CancelRequestMessage {
 	type: "cancel_request";
 	requestId: string;
@@ -268,6 +279,7 @@ type IncomingStudioMessage =
 	| SendToEditorRequestMessage
 	| GetFromEditorRequestMessage
 	| LoadGitDiffRequestMessage
+	| OpenEditorOnlyRequestMessage
 	| CancelRequestMessage;
 
 const REQUEST_TIMEOUT_MS = 5 * 60 * 1000;
@@ -278,6 +290,8 @@ const RESPONSE_HISTORY_LIMIT = 30;
 const CMUX_NOTIFY_TIMEOUT_MS = 1200;
 const PREPARED_PDF_EXPORT_TTL_MS = 5 * 60 * 1000;
 const MAX_PREPARED_PDF_EXPORTS = 8;
+const TRANSIENT_STUDIO_DOCUMENT_TTL_MS = 30 * 60 * 1000;
+const MAX_TRANSIENT_STUDIO_DOCUMENTS = 16;
 const STUDIO_TERMINAL_NOTIFY_TITLE = "pi Studio";
 const CMUX_STUDIO_STATUS_KEY = "pi_studio";
 const CMUX_STUDIO_STATUS_COLOR_DARK = "#5ea1ff";
@@ -289,6 +303,7 @@ const STUDIO_PERSISTENT_STATE_PATH = join(STUDIO_PERSISTENT_STATE_DIR, "local-st
 
 let studioPersistentStateCache: StudioPersistentState | null = null;
 let studioPersistentStateQueue: Promise<void> = Promise.resolve();
+let transientStudioDocuments: Map<string, { document: InitialStudioDocument; createdAt: number }> = new Map();
 
 function createEmptyStudioPersistentState(): StudioPersistentState {
 	return {
@@ -1638,6 +1653,31 @@ function resolveStudioGitDiffBaseDir(sourcePath: string | undefined, resourceDir
 	return resolveStudioBaseDir(sourcePath, resourceDir, fallbackCwd);
 }
 
+function resolveStudioCompanionResourceDir(sourcePath: string | undefined, resourceDir: string | undefined, fallbackCwd: string): string | undefined {
+	const explicitResource = typeof resourceDir === "string" ? resourceDir.trim() : "";
+	if (explicitResource) {
+		const expanded = expandHome(explicitResource);
+		return isAbsolute(expanded) ? expanded : resolve(fallbackCwd, expanded);
+	}
+
+	const source = typeof sourcePath === "string" ? sourcePath.trim() : "";
+	if (source) {
+		const expanded = expandHome(source);
+		return dirname(isAbsolute(expanded) ? expanded : resolve(fallbackCwd, expanded));
+	}
+
+	return undefined;
+}
+
+function buildStudioCompanionLabel(_label: string | undefined): string {
+	return "copy of editor text";
+}
+
+function resolveStudioPdfResourcePath(pdfPath: string | undefined, sourcePath: string | undefined, resourceDir: string | undefined, fallbackCwd: string): string {
+	const baseDir = resolveStudioBaseDir(sourcePath, resourceDir, fallbackCwd);
+	return resolveStudioPdfResourceFile(pdfPath, baseDir);
+}
+
 function resolveStudioPandocWorkingDir(baseDir: string | undefined): string | undefined {
 	const normalized = typeof baseDir === "string" ? baseDir.trim() : "";
 	if (!normalized) return undefined;
@@ -5213,6 +5253,26 @@ function respondText(res: ServerResponse, status: number, text: string): void {
 	res.end(text);
 }
 
+function respondPdfFile(req: IncomingMessage, res: ServerResponse, filePath: string): void {
+	const method = (req.method ?? "GET").toUpperCase();
+	if (method !== "GET" && method !== "HEAD") {
+		res.setHeader("Allow", "GET, HEAD");
+		respondText(res, 405, "Method not allowed. Use GET.");
+		return;
+	}
+
+	const pdf = readFileSync(filePath);
+	res.writeHead(200, {
+		"Content-Type": "application/pdf",
+		"Content-Length": String(pdf.length),
+		"Content-Disposition": `inline; filename="${basename(filePath).replace(/["\\]/g, "") || "document.pdf"}"`,
+		"Cache-Control": "no-store",
+		"X-Content-Type-Options": "nosniff",
+		"Cross-Origin-Resource-Policy": "same-origin",
+	});
+	res.end(method === "HEAD" ? undefined : pdf);
+}
+
 function openUrlInDefaultBrowser(url: string): Promise<void> {
 	const openCommand =
 		process.platform === "darwin"
@@ -5810,6 +5870,24 @@ function parseIncomingMessage(data: RawData): IncomingStudioMessage | null {
 		};
 	}
 
+	if (
+		msg.type === "open_editor_only_request"
+		&& typeof msg.requestId === "string"
+		&& typeof msg.content === "string"
+		&& (msg.label === undefined || typeof msg.label === "string")
+		&& (msg.path === undefined || typeof msg.path === "string")
+		&& (msg.resourceDir === undefined || typeof msg.resourceDir === "string")
+	) {
+		return {
+			type: "open_editor_only_request",
+			requestId: msg.requestId,
+			content: msg.content,
+			label: typeof msg.label === "string" ? msg.label : undefined,
+			path: typeof msg.path === "string" ? msg.path : undefined,
+			resourceDir: typeof msg.resourceDir === "string" ? msg.resourceDir : undefined,
+		};
+	}
+
 	if (msg.type === "cancel_request" && typeof msg.requestId === "string") {
 		return {
 			type: "cancel_request",
@@ -6067,18 +6145,52 @@ function normalizeStudioUiMode(raw: string | null | undefined): StudioUiMode {
 	return raw === "editor-only" ? "editor-only" : "full";
 }
 
+function cleanupTransientStudioDocuments(now = Date.now()): void {
+	for (const [id, entry] of transientStudioDocuments) {
+		if (now - entry.createdAt > TRANSIENT_STUDIO_DOCUMENT_TTL_MS) {
+			transientStudioDocuments.delete(id);
+		}
+	}
+
+	while (transientStudioDocuments.size > MAX_TRANSIENT_STUDIO_DOCUMENTS) {
+		const oldest = transientStudioDocuments.keys().next().value;
+		if (!oldest) break;
+		transientStudioDocuments.delete(oldest);
+	}
+}
+
+function storeTransientStudioDocument(document: InitialStudioDocument): string {
+	cleanupTransientStudioDocuments();
+	const id = randomUUID();
+	transientStudioDocuments.set(id, {
+		document: { ...document },
+		createdAt: Date.now(),
+	});
+	cleanupTransientStudioDocuments();
+	return id;
+}
+
+function readTransientStudioDocument(id: string): InitialStudioDocument | null {
+	cleanupTransientStudioDocuments();
+	const entry = transientStudioDocuments.get(id);
+	return entry ? { ...entry.document } : null;
+}
+
 function buildStudioUrl(
 	port: number,
 	token: string,
 	mode: StudioUiMode = "full",
 	doc?: InitialStudioDocument | null,
+	docId?: string,
 ): string {
 	const params = new URLSearchParams({ token });
 	if (mode !== "full") params.set("mode", mode);
+	if (docId) params.set("docId", docId);
 	if (doc?.source) params.set("docSource", doc.source);
 	if (doc?.label) params.set("docLabel", doc.label);
 	if (doc?.path) params.set("docPath", doc.path);
 	if (doc?.draftId) params.set("draftId", doc.draftId);
+	if (doc?.resourceDir) params.set("resourceDir", doc.resourceDir);
 	return `http://127.0.0.1:${port}/?${params.toString()}`;
 }
 
@@ -6088,9 +6200,9 @@ function isSshSession(): boolean {
 	);
 }
 
-function buildStudioSshTunnelHint(port: number): string | null {
+function buildStudioSshTunnelHint(port: number, studioUrl: string): string | null {
 	if (!isSshSession()) return null;
-	return `SSH detected. Forward the remote Studio port, then open the full Studio URL above locally, including its ?token=... parameter: ssh -L ${port}:127.0.0.1:${port} <remote-host>. If you choose a different local port, change only the port in the URL; keep the token.`;
+	return `SSH detected. Full Studio URL: ${studioUrl}. Forward the remote Studio port with: ssh -L ${port}:127.0.0.1:${port} <remote-host>. Open the full URL locally through the tunnel, preserving its ?token=... parameter. If you choose a different local port, change only the port in the URL; keep the token.`;
 }
 
 function resolveRequestedStudioDocumentFromUrl(
@@ -6099,10 +6211,17 @@ function resolveRequestedStudioDocumentFromUrl(
 	studioCwd: string,
 	latestResponse?: LastStudioResponse | null,
 ): InitialStudioDocument | null {
+	const requestedDocId = (requestUrl.searchParams.get("docId") ?? "").trim();
+	if (requestedDocId) {
+		const transientDocument = readTransientStudioDocument(requestedDocId);
+		if (transientDocument) return transientDocument;
+	}
+
 	const requestedPath = (requestUrl.searchParams.get("docPath") ?? "").trim();
 	const requestedSourceRaw = (requestUrl.searchParams.get("docSource") ?? "").trim();
 	const requestedLabel = (requestUrl.searchParams.get("docLabel") ?? "").trim();
 	const requestedDraftId = (requestUrl.searchParams.get("draftId") ?? "").trim();
+	const requestedResourceDir = (requestUrl.searchParams.get("resourceDir") ?? "").trim();
 
 	if (requestedPath) {
 		const file = readStudioFile(requestedPath, studioCwd);
@@ -6112,6 +6231,7 @@ function resolveRequestedStudioDocumentFromUrl(
 				label: requestedLabel || file.label,
 				source: "file",
 				path: file.resolvedPath,
+				resourceDir: requestedResourceDir || undefined,
 			};
 		}
 	}
@@ -6122,6 +6242,7 @@ function resolveRequestedStudioDocumentFromUrl(
 			label: requestedLabel || "last model response",
 			source: "last-response",
 			draftId: requestedDraftId || undefined,
+			resourceDir: requestedResourceDir || undefined,
 		};
 	}
 
@@ -6131,6 +6252,7 @@ function resolveRequestedStudioDocumentFromUrl(
 			label: requestedLabel || requestedSourceRaw || "blank",
 			source: "blank",
 			draftId: requestedDraftId || undefined,
+			resourceDir: requestedResourceDir || fallback?.resourceDir || undefined,
 		};
 	}
 
@@ -6370,6 +6492,7 @@ function buildStudioHtml(
 	const initialLabel = escapeHtmlForInline(initialDocument?.label ?? "blank");
 	const initialPath = escapeHtmlForInline(initialDocument?.path ?? "");
 	const initialDraftId = escapeHtmlForInline(initialDocument?.draftId ?? "");
+	const initialResourceDir = escapeHtmlForInline(initialDocument?.resourceDir ?? "");
 	const initialModel = escapeHtmlForInline(initialModelLabel ?? "none");
 	const initialTerminal = escapeHtmlForInline(initialTerminalLabel ?? "unknown");
 	const initialTerminalDetailAttr = escapeHtmlForInline(initialTerminalDetail ?? initialTerminalLabel ?? "unknown");
@@ -6439,7 +6562,7 @@ ${cssVarsBlock}
   </style>
   <link rel="stylesheet" href="${stylesheetHref}" />
 </head>
-<body data-initial-source="${initialSource}" data-initial-label="${initialLabel}" data-initial-path="${initialPath}" data-initial-draft-id="${initialDraftId}" data-model-label="${initialModel}" data-terminal-label="${initialTerminal}" data-terminal-detail="${initialTerminalDetailAttr}" data-context-tokens="${initialContextTokens}" data-context-window="${initialContextWindow}" data-context-percent="${initialContextPercent}" data-studio-mode="${studioMode}">
+<body data-initial-source="${initialSource}" data-initial-label="${initialLabel}" data-initial-path="${initialPath}" data-initial-draft-id="${initialDraftId}" data-initial-resource-dir="${initialResourceDir}" data-model-label="${initialModel}" data-terminal-label="${initialTerminal}" data-terminal-detail="${initialTerminalDetailAttr}" data-context-tokens="${initialContextTokens}" data-context-window="${initialContextWindow}" data-context-percent="${initialContextPercent}" data-studio-mode="${studioMode}">
   <header>
     <h1><span class="app-logo" aria-hidden="true">π</span> Studio <span class="app-subtitle">${appSubtitle}</span></h1>
     <div class="controls">
@@ -6484,7 +6607,8 @@ ${cssVarsBlock}
             <div class="source-actions-row">
               <button id="sendRunBtn" type="button" title="Run editor text. While a direct run is active, this button becomes Stop. Cmd/Ctrl+Enter queues steering from the current editor text. Stop the active request with Esc.">Run editor text</button>
               <button id="queueSteerBtn" type="button" title="Queue steering is available while Run editor text is active." disabled>Queue steering</button>
-              <button id="copyDraftBtn" type="button">Copy editor text</button>
+              <button id="copyDraftBtn" type="button" title="Copy the current editor text to the clipboard.">Copy text</button>
+              <button id="openCompanionBtn" type="button" title="Open a detached copy of the current editor text in a new editor-only Studio tab.">Open new editor</button>
               <button id="sendEditorBtn" type="button">Send to pi editor</button>
             </div>
             <div class="source-actions-row">
@@ -7778,6 +7902,45 @@ export default function (pi: ExtensionAPI) {
 			return;
 		}
 
+		if (msg.type === "open_editor_only_request") {
+			if (!isValidRequestId(msg.requestId)) {
+				sendToClient(client, { type: "error", requestId: msg.requestId, message: "Invalid request ID." });
+				return;
+			}
+			if (!serverState) {
+				sendToClient(client, { type: "error", requestId: msg.requestId, message: "Studio server is not running." });
+				return;
+			}
+			if (msg.content.length > PREVIEW_RENDER_MAX_CHARS) {
+				sendToClient(client, {
+					type: "error",
+					requestId: msg.requestId,
+					message: `Editor text is too large to copy into a companion view (${PREVIEW_RENDER_MAX_CHARS} character limit).`,
+				});
+				return;
+			}
+
+			const resourceDir = resolveStudioCompanionResourceDir(msg.path, msg.resourceDir, studioCwd);
+			const document: InitialStudioDocument = {
+				text: msg.content,
+				label: buildStudioCompanionLabel(msg.label),
+				source: "blank",
+				draftId: createStudioDraftId(),
+				resourceDir,
+			};
+			const docId = storeTransientStudioDocument(document);
+			const url = buildStudioUrl(serverState.port, serverState.token, "editor-only", document, docId);
+			const parsedUrl = new URL(url);
+			sendToClient(client, {
+				type: "editor_only_ready",
+				requestId: msg.requestId,
+				url,
+				relativeUrl: `${parsedUrl.pathname}${parsedUrl.search}`,
+				message: "Companion editor is ready with a detached copy of the current editor text.",
+			});
+			return;
+		}
+
 		if (msg.type === "cancel_request") {
 			if (!isValidRequestId(msg.requestId)) {
 				sendToClient(client, { type: "error", requestId: msg.requestId, message: "Invalid request ID." });
@@ -8812,6 +8975,27 @@ export default function (pi: ExtensionAPI) {
 			return;
 		}
 
+		if (requestUrl.pathname === "/pdf-resource") {
+			const token = requestUrl.searchParams.get("token") ?? "";
+			if (token !== serverState.token) {
+				respondText(res, 403, "Invalid or expired studio token. Re-run /studio.");
+				return;
+			}
+
+			try {
+				const filePath = resolveStudioPdfResourcePath(
+					requestUrl.searchParams.get("path") ?? "",
+					requestUrl.searchParams.get("sourcePath") ?? undefined,
+					requestUrl.searchParams.get("resourceDir") ?? undefined,
+					studioCwd,
+				);
+				respondPdfFile(req, res, filePath);
+			} catch (error) {
+				respondText(res, 404, `PDF resource unavailable: ${error instanceof Error ? error.message : String(error)}`);
+			}
+			return;
+		}
+
 		if (requestUrl.pathname !== "/") {
 			respondText(res, 404, "Not found");
 			return;
@@ -9329,6 +9513,7 @@ export default function (pi: ExtensionAPI) {
 		clearStudioDirectRunState();
 		clearPendingStudioCompletion();
 		clearPreparedPdfExports();
+		transientStudioDocuments.clear();
 		clearCompactionState();
 		clearStudioTrace();
 		setTerminalActivity("idle");
@@ -9436,8 +9621,9 @@ export default function (pi: ExtensionAPI) {
 			} else {
 				ctx.ui.notify("A full pi Studio view is already open for this session. Close it first, use /studio-replace for a fresh full Studio view, or use /studio-editor-only for a concurrent editor-only Studio view.", "warning");
 				if (serverState) {
-					ctx.ui.notify(`Studio URL: ${buildStudioUrl(serverState.port, serverState.token, "full")}`, "info");
-					const sshTunnelHint = buildStudioSshTunnelHint(serverState.port);
+					const url = buildStudioUrl(serverState.port, serverState.token, "full");
+					ctx.ui.notify(`Studio URL: ${url}`, "info");
+					const sshTunnelHint = buildStudioSshTunnelHint(serverState.port, url);
 					if (sshTunnelHint) ctx.ui.notify(sshTunnelHint, "info");
 				}
 				return;
@@ -9464,7 +9650,7 @@ export default function (pi: ExtensionAPI) {
 
 		const state = await ensureServer();
 		const url = buildStudioUrl(state.port, state.token, mode, selected);
-		const sshTunnelHint = buildStudioSshTunnelHint(state.port);
+		const sshTunnelHint = buildStudioSshTunnelHint(state.port, url);
 		const openedLabel = mode === "editor-only" ? "pi Studio editor-only view" : "pi Studio";
 
 		try {
@@ -9511,7 +9697,7 @@ export default function (pi: ExtensionAPI) {
 					`Studio running at ${url} (busy: ${isStudioBusy() ? "yes" : "no"}; full views: ${counts.full}; editor-only views: ${counts.editorOnly})`,
 					"info",
 				);
-				const sshTunnelHint = buildStudioSshTunnelHint(serverState.port);
+				const sshTunnelHint = buildStudioSshTunnelHint(serverState.port, url);
 				if (sshTunnelHint) ctx.ui.notify(sshTunnelHint, "info");
 				return;
 			}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-studio",
-  "version": "0.6.9",
+  "version": "0.7.0",
   "description": "Two-pane browser workspace for pi with prompt/response editing, annotations, critiques, prompt/response history, and live Markdown/LaTeX/code preview",
   "type": "module",
   "license": "MIT",

package/shared/studio-pdf-resource.js

@@ -0,0 +1,39 @@
+import { realpathSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { extname, isAbsolute, relative, resolve } from "node:path";
+
+export function expandStudioPdfResourcePath(input) {
+	const value = String(input || "").trim();
+	if (value === "~") return homedir();
+	if (value.startsWith("~/") || value.startsWith("~\\")) {
+		return resolve(homedir(), value.slice(2));
+	}
+	return value;
+}
+
+export function resolveStudioPdfResourceFile(pdfPath, baseDir) {
+	const rawPath = typeof pdfPath === "string" ? pdfPath.trim() : "";
+	if (!rawPath) throw new Error("Missing PDF path.");
+	if (/\0/.test(rawPath)) throw new Error("Invalid PDF path.");
+	if (/^[a-z][a-z0-9+.-]*:/i.test(rawPath) && !/^[a-z]:[\\/]/i.test(rawPath)) {
+		throw new Error("Only local PDF paths are supported.");
+	}
+
+	const rawBaseDir = typeof baseDir === "string" ? baseDir.trim() : "";
+	if (!rawBaseDir) throw new Error("Missing Studio resource directory.");
+
+	const expandedPath = expandStudioPdfResourcePath(rawPath);
+	const candidate = isAbsolute(expandedPath) ? expandedPath : resolve(rawBaseDir, expandedPath);
+	if (extname(candidate).toLowerCase() !== ".pdf") throw new Error("Only .pdf files can be embedded.");
+
+	const baseReal = realpathSync(rawBaseDir);
+	const candidateReal = realpathSync(candidate);
+	const rel = relative(baseReal, candidateReal);
+	if (rel.startsWith("..") || isAbsolute(rel)) {
+		throw new Error("PDF path must stay within the current Studio resource directory.");
+	}
+
+	const stat = statSync(candidateReal);
+	if (!stat.isFile()) throw new Error("PDF path does not refer to a file.");
+	return candidateReal;
+}