pi-studio 0.9.7 → 0.9.9

package/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to `pi-studio` are documented here.
 
 ## [Unreleased]
 
+## [0.9.9] — 2026-05-19
+
+### Fixed
+- In SSH-launched Studio sessions, copy actions now use the local browser clipboard instead of writing to the remote host clipboard.
+
+## [0.9.8] — 2026-05-19
+
+### Fixed
+- Restored the full tokenized Studio URL inside SSH tunnel hints so the local browser URL remains visible even when only the latest notification is shown.
+
 ## [0.9.7] — 2026-05-19
 
 ### Added

package/client/studio-client.js

@@ -156,6 +156,7 @@
         ? "editor-only"
         : "full";
       const isEditorOnlyMode = studioMode === "editor-only";
+      const isSshStudioSession = Boolean(document.body && document.body.dataset && document.body.dataset.sshSession === "1");
 
       const initialQueryParams = new URLSearchParams(window.location.search || "");
       const explicitDocumentIdentityFromUrl = initialQueryParams.has("docId")
@@ -846,16 +847,18 @@
       async function writeTextToClipboard(text) {
         const content = String(text || "");
 
-        try {
-          await fetchStudioJson("/clipboard", {
-            method: "POST",
-            body: JSON.stringify({ text: content }),
-          });
-          return true;
-        } catch {
-          // Fall back to browser clipboard APIs. The server-side clipboard path
-          // is most reliable for local Studio, but may be unavailable over SSH
-          // or on systems without a clipboard command.
+        if (!isSshStudioSession) {
+          try {
+            await fetchStudioJson("/clipboard", {
+              method: "POST",
+              body: JSON.stringify({ text: content }),
+            });
+            return true;
+          } catch {
+            // Fall back to browser clipboard APIs. The server-side clipboard path
+            // is most reliable for local Studio, but may be unavailable on systems
+            // without a clipboard command.
+          }
         }
 
         // Prefer a copy-event payload first. It runs synchronously inside the

package/index.ts

@@ -28,6 +28,7 @@ import {
 } from "./shared/studio-markdown-latex-literals.js";
 import { escapeStudioPdfLatexTextFragment } from "./shared/studio-pdf-escape.js";
 import { resolveStudioPdfResourceFile } from "./shared/studio-pdf-resource.js";
+import { buildStudioSshTunnelHint, isStudioSshSession as isSshSession } from "./shared/studio-ssh-hint.js";
 
 type Lens = "writing" | "code";
 type RequestedLens = Lens | "auto";
@@ -8270,12 +8271,6 @@ function buildStudioUrl(
 	return `http://127.0.0.1:${port}/?${params.toString()}`;
 }
 
-function isSshSession(): boolean {
-	return Boolean(
-		String(process.env.SSH_CONNECTION ?? process.env.SSH_CLIENT ?? process.env.SSH_TTY ?? "").trim(),
-	);
-}
-
 function parseStudioLaunchOpenFlags(rawArgs: string): { args: string; openRemoteBrowser: boolean; error?: string } {
 	const parsed = tokenizeStudioCommandArgs(rawArgs);
 	if (parsed.error) return { args: rawArgs, openRemoteBrowser: false, error: parsed.error };
@@ -8295,16 +8290,6 @@ function shouldAutoOpenStudioBrowser(options?: { openRemoteBrowser?: boolean }):
 	return !isSshSession() || Boolean(options?.openRemoteBrowser);
 }
 
-function buildStudioSshTunnelHint(port: number): string | null {
-	if (!isSshSession()) return null;
-	return [
-		"SSH detected. Studio was not opened in the remote browser.",
-		"To open it locally, run this on your local machine:",
-		`  ssh -L ${port}:127.0.0.1:${port} <remote-host>`,
-		"Then open the Studio URL above in your local browser.",
-	].join("\n");
-}
-
 function resolveRequestedStudioDocumentFromUrl(
 	requestUrl: URL,
 	fallback: InitialStudioDocument | null,
@@ -8661,6 +8646,7 @@ function buildStudioHtml(
 	const clientScriptHref = `/studio-client.js?token=${encodeURIComponent(studioToken ?? "")}`;
 	const faviconHref = buildStudioFaviconDataUri(style);
 	const bootConfigJson = JSON.stringify({ mermaidConfig }).replace(/</g, "\\u003c");
+	const initialSshSession = isSshSession() ? "1" : "0";
 	const isEditorOnlyMode = studioMode === "editor-only";
 	const appTitle = isEditorOnlyMode ? "π Studio — Editor" : "π Studio";
 	const appSubtitle = isEditorOnlyMode ? "Editor Workspace" : "Editor & Response Workspace";
@@ -8679,7 +8665,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-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}">
+<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}" data-ssh-session="${initialSshSession}">
   <header>
     <h1><span class="app-logo" aria-hidden="true">π</span> Studio <span class="app-subtitle">${appSubtitle}</span></h1>
     <div class="controls">
@@ -11317,6 +11303,11 @@ export default function (pi: ExtensionAPI) {
 			return;
 		}
 
+		if (isSshSession()) {
+			respondJson(res, 409, { ok: false, error: "Server clipboard is disabled for SSH Studio sessions; use the browser clipboard." });
+			return;
+		}
+
 		const result = await writeStudioSystemClipboard(text);
 		if (result.ok) {
 			respondJson(res, 200, { ok: true, method: result.method });
@@ -12550,7 +12541,7 @@ export default function (pi: ExtensionAPI) {
 				if (serverState) {
 					const url = buildStudioUrl(serverState.port, serverState.token, "full");
 					ctx.ui.notify(`Studio URL: ${url}`, "info");
-					const sshTunnelHint = buildStudioSshTunnelHint(serverState.port);
+					const sshTunnelHint = buildStudioSshTunnelHint(serverState.port, url);
 					if (sshTunnelHint) ctx.ui.notify(sshTunnelHint, "info");
 				}
 				return;
@@ -12578,7 +12569,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";
 
 		const shouldOpenBrowser = shouldAutoOpenStudioBrowser({
@@ -12632,7 +12623,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.9.7",
+  "version": "0.9.9",
   "description": "Two-pane browser workspace for pi with prompt/response editing, annotations, critiques, active quiz, prompt/response history, live previews, and tmux-backed REPL/literate REPL workflows",
   "type": "module",
   "license": "MIT",

package/shared/studio-ssh-hint.js

@@ -0,0 +1,19 @@
+export function isStudioSshSession(env = process.env) {
+	return Boolean(
+		String(env.SSH_CONNECTION ?? env.SSH_CLIENT ?? env.SSH_TTY ?? "").trim(),
+	);
+}
+
+export function buildStudioSshTunnelHint(port, studioUrl, env = process.env) {
+	if (!isStudioSshSession(env)) return null;
+	const normalizedPort = Number(port);
+	const remotePort = Number.isInteger(normalizedPort) && normalizedPort > 0 ? normalizedPort : port;
+	const url = String(studioUrl || "").trim();
+	return [
+		"SSH detected. Studio was not opened in the remote browser.",
+		"To open it locally, run this on your local machine:",
+		`  ssh -L ${remotePort}:127.0.0.1:${remotePort} <remote-host>`,
+		"Then open this Studio URL in your local browser:",
+		`  ${url}`,
+	].join("\n");
+}