pi-studio 0.5.55 → 0.5.56

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to `pi-studio` are documented here.
 
 ## [Unreleased]
 
+## [0.5.56] — 2026-04-15
+
+### Removed
+- Removed Studio's standalone npm update checker and footer update badge now that package update tracking is handled in pi.
+
+### Fixed
+- Studio now always prints its localhost URL even when automatic browser open fails, and SSH sessions get a localhost-only port-forwarding hint instead of needing non-local binding.
+
 ## [0.5.54] — 2026-04-13
 
 ### Fixed

package/README.md

@@ -74,6 +74,7 @@ pi -e https://github.com/omaclaren/pi-studio
 ## 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` prints the localhost URL and an SSH tunnel hint when SSH is detected.
 - 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.
 - Editor/code font uses a best-effort terminal-monospace match when the current terminal config exposes it; set `PI_STUDIO_FONT_MONO` to force a specific CSS `font-family` stack.

package/client/studio-client.js

@@ -202,8 +202,6 @@
       let contextTokens = null;
       let contextWindow = null;
       let contextPercent = null;
-      let updateInstalledVersion = null;
-      let updateLatestVersion = null;
       let windowHasFocus = typeof document.hasFocus === "function" ? document.hasFocus() : true;
       let titleAttentionMessage = "";
       let titleAttentionRequestId = null;
@@ -664,8 +662,6 @@
         if (typeof message.contextTokens === "number") summary.contextTokens = message.contextTokens;
         if (typeof message.contextWindow === "number") summary.contextWindow = message.contextWindow;
         if (typeof message.contextPercent === "number") summary.contextPercent = message.contextPercent;
-        if (typeof message.updateInstalledVersion === "string") summary.updateInstalledVersion = message.updateInstalledVersion;
-        if (typeof message.updateLatestVersion === "string") summary.updateLatestVersion = message.updateLatestVersion;
         if (message.document && typeof message.document === "object" && typeof message.document.text === "string") {
           summary.documentLength = message.document.text.length;
           if (typeof message.document.label === "string") summary.documentLabel = message.document.label;
@@ -926,30 +922,6 @@
         return changed;
       }
 
-      function applyUpdateInfoFromMessage(message) {
-        if (!message || typeof message !== "object") return false;
-
-        let changed = false;
-
-        if (Object.prototype.hasOwnProperty.call(message, "updateInstalledVersion")) {
-          const nextInstalled = parseNonEmptyString(message.updateInstalledVersion);
-          if (nextInstalled !== updateInstalledVersion) {
-            updateInstalledVersion = nextInstalled;
-            changed = true;
-          }
-        }
-
-        if (Object.prototype.hasOwnProperty.call(message, "updateLatestVersion")) {
-          const nextLatest = parseNonEmptyString(message.updateLatestVersion);
-          if (nextLatest !== updateLatestVersion) {
-            updateLatestVersion = nextLatest;
-            changed = true;
-          }
-        }
-
-        return changed;
-      }
-
       function isTitleAttentionRequestKind(kind) {
         return kind === "annotation" || kind === "critique" || kind === "direct";
       }
@@ -1134,13 +1106,7 @@
         const modelText = modelLabel && modelLabel.trim() ? modelLabel.trim() : "none";
         const terminalText = terminalSessionLabel && terminalSessionLabel.trim() ? terminalSessionLabel.trim() : "unknown";
         const contextText = formatContextUsageText();
-        let updateText = "";
-        if (updateLatestVersion) {
-          updateText = updateInstalledVersion
-            ? "Update: " + updateInstalledVersion + " → " + updateLatestVersion
-            : "Update: " + updateLatestVersion + " available";
-        }
-        const text = "Model: " + modelText + " · Terminal: " + terminalText + " · " + contextText + (updateText ? " · " + updateText : "");
+        const text = "Model: " + modelText + " · Terminal: " + terminalText + " · " + contextText;
         if (footerMetaTextEl) {
           footerMetaTextEl.textContent = text;
           footerMetaTextEl.title = text;
@@ -9000,8 +8966,7 @@
         debugTrace("server_message", summarizeServerMessage(message));
 
         const contextChanged = applyContextUsageFromMessage(message);
-        const updateInfoChanged = applyUpdateInfoFromMessage(message);
-        if (contextChanged || updateInfoChanged) {
+        if (contextChanged) {
           updateFooterMeta();
         }
 

package/index.ts

@@ -272,7 +272,6 @@ const PREVIEW_RENDER_MAX_CHARS = 400_000;
 const PDF_EXPORT_MAX_CHARS = 400_000;
 const REQUEST_BODY_MAX_BYTES = 1_000_000;
 const RESPONSE_HISTORY_LIMIT = 30;
-const UPDATE_CHECK_TIMEOUT_MS = 1800;
 const CMUX_NOTIFY_TIMEOUT_MS = 1200;
 const PREPARED_PDF_EXPORT_TTL_MS = 5 * 60 * 1000;
 const MAX_PREPARED_PDF_EXPORTS = 8;
@@ -2737,93 +2736,6 @@ function readStudioGitDiff(baseDir: string):
 	return { ok: true, text: fullDiff, label };
 }
 
-function readLocalPackageMetadata(): { name: string; version: string } | null {
-	try {
-		const raw = readFileSync(new URL("./package.json", import.meta.url), "utf-8");
-		const parsed = JSON.parse(raw) as { name?: unknown; version?: unknown };
-		const name = typeof parsed.name === "string" ? parsed.name.trim() : "";
-		const version = typeof parsed.version === "string" ? parsed.version.trim() : "";
-		if (!name || !version) return null;
-		return { name, version };
-	} catch {
-		return null;
-	}
-}
-
-interface ParsedSemver {
-	major: number;
-	minor: number;
-	patch: number;
-	prerelease: string | null;
-}
-
-function parseSemverLoose(version: string): ParsedSemver | null {
-	const normalized = String(version || "").trim().replace(/^v/i, "");
-	const match = normalized.match(/^(\d+)(?:\.(\d+))?(?:\.(\d+))?(?:-([0-9A-Za-z.-]+))?/);
-	if (!match) return null;
-	const major = Number.parseInt(match[1] ?? "", 10);
-	const minor = Number.parseInt(match[2] ?? "0", 10);
-	const patch = Number.parseInt(match[3] ?? "0", 10);
-	if (!Number.isFinite(major) || !Number.isFinite(minor) || !Number.isFinite(patch)) return null;
-	const prerelease = typeof match[4] === "string" && match[4].trim() ? match[4].trim() : null;
-	return { major, minor, patch, prerelease };
-}
-
-function compareSemverLoose(a: string, b: string): number {
-	const pa = parseSemverLoose(a);
-	const pb = parseSemverLoose(b);
-	if (!pa || !pb) {
-		return a.localeCompare(b, undefined, { numeric: true, sensitivity: "base" });
-	}
-	if (pa.major !== pb.major) return pa.major - pb.major;
-	if (pa.minor !== pb.minor) return pa.minor - pb.minor;
-	if (pa.patch !== pb.patch) return pa.patch - pb.patch;
-	if (pa.prerelease && !pb.prerelease) return -1;
-	if (!pa.prerelease && pb.prerelease) return 1;
-	if (!pa.prerelease && !pb.prerelease) return 0;
-	return (pa.prerelease ?? "").localeCompare(pb.prerelease ?? "", undefined, {
-		numeric: true,
-		sensitivity: "base",
-	});
-}
-
-function isVersionBehind(installedVersion: string, latestVersion: string): boolean {
-	return compareSemverLoose(installedVersion, latestVersion) < 0;
-}
-
-async function fetchLatestNpmVersion(packageName: string, timeoutMs = UPDATE_CHECK_TIMEOUT_MS): Promise<string | null> {
-	const pkg = String(packageName || "").trim();
-	if (!pkg) return null;
-	const encodedPackage = encodeURIComponent(pkg).replace(/^%40/, "@");
-	const endpoint = `https://registry.npmjs.org/${encodedPackage}/latest`;
-	const controller = typeof AbortController === "function" ? new AbortController() : null;
-	const timer = controller
-		? setTimeout(() => {
-			try {
-				controller.abort();
-			} catch {
-				// ignore abort race
-			}
-		}, timeoutMs)
-		: null;
-
-	try {
-		const response = await fetch(endpoint, {
-			method: "GET",
-			headers: { Accept: "application/json" },
-			signal: controller?.signal,
-		});
-		if (!response.ok) return null;
-		const payload = await response.json() as { version?: unknown };
-		const version = typeof payload.version === "string" ? payload.version.trim() : "";
-		return version || null;
-	} catch {
-		return null;
-	} finally {
-		if (timer) clearTimeout(timer);
-	}
-}
-
 function isLikelyMathExpression(expr: string): boolean {
 	const content = expr.trim();
 	if (content.length === 0) return false;
@@ -5842,6 +5754,17 @@ 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 buildStudioSshTunnelHint(port: number): string | null {
+	if (!isSshSession()) return null;
+	return `SSH detected. If Studio is running on a remote machine, forward the port from your local machine, then open the Studio URL locally: ssh -L ${port}:127.0.0.1:${port} <remote-host>`;
+}
+
 function resolveRequestedStudioDocumentFromUrl(
 	requestUrl: URL,
 	fallback: InitialStudioDocument | null,
@@ -6382,11 +6305,6 @@ export default function (pi: ExtensionAPI) {
 	};
 	let compactInProgress = false;
 	let compactRequestId: string | null = null;
-	let updateCheckStarted = false;
-	let updateCheckCompleted = false;
-	const packageMetadata = readLocalPackageMetadata();
-	const installedPackageVersion = packageMetadata?.version ?? null;
-	let updateAvailableLatestVersion: string | null = null;
 
 	const isStudioDirectRunChainActive = () => Boolean(studioDirectRunChain);
 	const getQueuedStudioSteeringCount = () => queuedStudioDirectRequests.length;
@@ -6766,28 +6684,6 @@ export default function (pi: ExtensionAPI) {
 		});
 	};
 
-	const maybeNotifyUpdateAvailable = async (ctx: ExtensionCommandContext) => {
-		if (updateCheckStarted || updateCheckCompleted) return;
-		updateCheckStarted = true;
-		try {
-			const metadata = packageMetadata;
-			if (!metadata) return;
-			const latest = await fetchLatestNpmVersion(metadata.name, UPDATE_CHECK_TIMEOUT_MS);
-			if (!latest) return;
-			if (!isVersionBehind(metadata.version, latest)) return;
-
-			updateAvailableLatestVersion = latest;
-			broadcastState();
-
-			const notification =
-				`Update available for ${metadata.name}: ${metadata.version} → ${latest}. Run: pi install npm:${metadata.name}`;
-			ctx.ui.notify(notification, "info");
-			broadcast({ type: "info", message: notification, level: "info" });
-		} finally {
-			updateCheckCompleted = true;
-		}
-	};
-
 	const sendToClient = (client: WebSocket, payload: unknown) => {
 		if (client.readyState !== WebSocket.OPEN) return;
 		try {
@@ -7067,8 +6963,6 @@ export default function (pi: ExtensionAPI) {
 			contextTokens: contextUsageSnapshot.tokens,
 			contextWindow: contextUsageSnapshot.contextWindow,
 			contextPercent: contextUsageSnapshot.percent,
-			updateInstalledVersion: installedPackageVersion,
-			updateLatestVersion: updateAvailableLatestVersion,
 			compactInProgress,
 			activeRequestId: activeRequest?.id ?? compactRequestId ?? null,
 			activeRequestKind: activeRequest?.kind ?? (compactInProgress ? "compact" : null),
@@ -7349,8 +7243,6 @@ export default function (pi: ExtensionAPI) {
 				contextTokens: contextUsageSnapshot.tokens,
 				contextWindow: contextUsageSnapshot.contextWindow,
 				contextPercent: contextUsageSnapshot.percent,
-				updateInstalledVersion: installedPackageVersion,
-				updateLatestVersion: updateAvailableLatestVersion,
 				compactInProgress,
 				activeRequestId: activeRequest?.id ?? compactRequestId ?? null,
 				activeRequestKind: activeRequest?.kind ?? (compactInProgress ? "compact" : null),
@@ -9018,6 +8910,8 @@ export default function (pi: ExtensionAPI) {
 				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);
+					if (sshTunnelHint) ctx.ui.notify(sshTunnelHint, "info");
 				}
 				return;
 			}
@@ -9043,6 +8937,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 openedLabel = mode === "editor-only" ? "pi Studio editor-only view" : "pi Studio";
 
 		try {
@@ -9054,11 +8949,16 @@ export default function (pi: ExtensionAPI) {
 			} else {
 				ctx.ui.notify(`Opened ${openedLabel} with blank editor.`, "info");
 			}
-			ctx.ui.notify(`Studio URL: ${url}`, "info");
 		} catch (error) {
-			ctx.ui.notify(`Failed to open browser: ${error instanceof Error ? error.message : String(error)}`, "error");
+			const message = error instanceof Error ? error.message : String(error);
+			if (isSshSession()) {
+				ctx.ui.notify(`Failed to open browser automatically over SSH: ${message}`, "warning");
+			} else {
+				ctx.ui.notify(`Failed to open browser: ${message}`, "error");
+			}
 		} finally {
-			void maybeNotifyUpdateAvailable(ctx);
+			ctx.ui.notify(`Studio URL: ${url}`, "info");
+			if (sshTunnelHint) ctx.ui.notify(sshTunnelHint, "info");
 		}
 	};
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-studio",
-  "version": "0.5.55",
+  "version": "0.5.56",
   "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",