pi-studio 0.5.17 → 0.5.19

package/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to `pi-studio` are documented here.
 
 ## [Unreleased]
 
+## [0.5.19] — 2026-03-19
+
+### Fixed
+- Studio now waits until `agent_end` before emitting the terminal/cmux “response ready” notification for completed requests, and it keeps the cmux `running…` status pill visible until that same turn fully finishes.
+
+## [0.5.18] — 2026-03-17
+
+### Fixed
+- cmux sidebar Studio status pills now use a darker blue in light mode, making `running…` / `compacting…` much easier to read.
+- The annotated-reply header wording in Studio now says `user annotation syntax: [an: note]`, matching the intended user-guidance semantics more clearly.
+
 ## [0.5.17] — 2026-03-17
 
 ### Fixed

package/client/studio-client.js

@@ -3364,7 +3364,7 @@
         const sourceDescriptor = describeSourceForAnnotation();
         let header = "annotated reply below:\n";
         header += "original source: " + sourceDescriptor + "\n";
-        header += "annotation syntax: [an: your note]\n";
+        header += "user annotation syntax: [an: note]\n";
         header += "precedence: later messages supersede these annotations unless user explicitly references them\n\n---\n\n";
         return header;
       }

package/index.ts

@@ -160,6 +160,8 @@ const UPDATE_CHECK_TIMEOUT_MS = 1800;
 const CMUX_NOTIFY_TIMEOUT_MS = 1200;
 const STUDIO_TERMINAL_NOTIFY_TITLE = "pi Studio";
 const CMUX_STUDIO_STATUS_KEY = "pi_studio";
+const CMUX_STUDIO_STATUS_COLOR_DARK = "#5ea1ff";
+const CMUX_STUDIO_STATUS_COLOR_LIGHT = "#0047ab";
 
 const PDF_PREAMBLE = `\\usepackage{titlesec}
 \\titleformat{\\section}{\\Large\\bfseries\\sffamily}{}{0pt}{}[\\vspace{2pt}\\titlerule]
@@ -2950,6 +2952,7 @@ export default function (pi: ExtensionAPI) {
 	let lastCommandCtx: ExtensionCommandContext | null = null;
 	let lastThemeVarsJson = "";
 	let suppressedStudioResponse: { requestId: string; kind: StudioRequestKind } | null = null;
+	let pendingStudioCompletionKind: StudioRequestKind | null = null;
 	let agentBusy = false;
 	let terminalActivityPhase: TerminalActivityPhase = "idle";
 	let terminalActivityToolName: string | null = null;
@@ -3139,16 +3142,22 @@ export default function (pi: ExtensionAPI) {
 		runCmuxCommand(["clear-notifications"]);
 	};
 
+	const getCmuxStudioStatusColor = (): string => {
+		const mode = getStudioThemeMode(lastCommandCtx?.ui?.theme);
+		return mode === "light" ? CMUX_STUDIO_STATUS_COLOR_LIGHT : CMUX_STUDIO_STATUS_COLOR_DARK;
+	};
+
 	const syncCmuxStudioStatus = () => {
 		if (!shouldUseCmuxTerminalIntegration()) return;
 		const workspaceArgs = getCmuxWorkspaceArgs();
-		if (activeRequest) {
+		const statusColor = getCmuxStudioStatusColor();
+		if (activeRequest || (pendingStudioCompletionKind && agentBusy)) {
 			runCmuxCommand([
 				"set-status",
 				CMUX_STUDIO_STATUS_KEY,
 				"running…",
 				"--color",
-				"#5ea1ff",
+				statusColor,
 				...workspaceArgs,
 			]);
 			return;
@@ -3159,7 +3168,7 @@ export default function (pi: ExtensionAPI) {
 				CMUX_STUDIO_STATUS_KEY,
 				"compacting…",
 				"--color",
-				"#5ea1ff",
+				statusColor,
 				...workspaceArgs,
 			]);
 			return;
@@ -3261,6 +3270,23 @@ export default function (pi: ExtensionAPI) {
 		return "Studio: response ready.";
 	};
 
+	const clearPendingStudioCompletion = () => {
+		if (!pendingStudioCompletionKind) return;
+		pendingStudioCompletionKind = null;
+		syncCmuxStudioStatus();
+	};
+
+	const flushPendingStudioCompletionNotification = () => {
+		if (!pendingStudioCompletionKind) return;
+		const kind = pendingStudioCompletionKind;
+		pendingStudioCompletionKind = null;
+		syncCmuxStudioStatus();
+		const message = getStudioRequestCompletionNotification(kind);
+		emitDebugEvent("studio_completion_notification", { kind });
+		notifyStudio(message, "info");
+		notifyStudioTerminal(message, "info");
+	};
+
 	const refreshContextUsage = (
 		ctx?: { getContextUsage(): { tokens: number | null; contextWindow: number; percent: number | null } | undefined },
 	): StudioContextUsageSnapshot => {
@@ -4392,6 +4418,7 @@ export default function (pi: ExtensionAPI) {
 				const json = JSON.stringify(vars);
 				if (json !== lastThemeVarsJson) {
 					lastThemeVarsJson = json;
+					syncCmuxStudioStatus();
 					for (const client of serverState.clients) {
 						sendToClient(client, { type: "theme_update", vars });
 					}
@@ -4409,6 +4436,7 @@ export default function (pi: ExtensionAPI) {
 	const stopServer = async () => {
 		if (!serverState) return;
 		clearActiveRequest();
+		clearPendingStudioCompletion();
 		clearCompactionState();
 		closeAllClients(1001, "Server shutting down");
 
@@ -4440,6 +4468,7 @@ export default function (pi: ExtensionAPI) {
 		hydrateLatestAssistant(ctx.sessionManager.getBranch());
 		clearCompactionState();
 		agentBusy = false;
+		clearPendingStudioCompletion();
 		refreshRuntimeMetadata({ cwd: ctx.cwd, model: ctx.model });
 		refreshContextUsage(ctx);
 		emitDebugEvent("session_start", {
@@ -4458,6 +4487,7 @@ export default function (pi: ExtensionAPI) {
 		lastCommandCtx = null;
 		hydrateLatestAssistant(ctx.sessionManager.getBranch());
 		agentBusy = false;
+		clearPendingStudioCompletion();
 		refreshRuntimeMetadata({ cwd: ctx.cwd, model: ctx.model });
 		refreshContextUsage(ctx);
 		emitDebugEvent("session_switch", {
@@ -4618,10 +4648,8 @@ export default function (pi: ExtensionAPI) {
 				responseHistory: studioResponseHistory,
 			});
 			broadcastResponseHistory();
-			clearActiveRequest({
-				terminalNotify: getStudioRequestCompletionNotification(kind),
-				terminalNotifyLevel: "info",
-			});
+			pendingStudioCompletionKind = kind;
+			clearActiveRequest();
 			return;
 		}
 
@@ -4658,6 +4686,7 @@ export default function (pi: ExtensionAPI) {
 			activeRequestKind: activeRequest?.kind ?? null,
 			suppressedRequestId: suppressedStudioResponse?.requestId ?? null,
 			suppressedRequestKind: suppressedStudioResponse?.kind ?? null,
+			pendingCompletionKind: pendingStudioCompletionKind,
 		});
 		setTerminalActivity("idle");
 		if (activeRequest) {
@@ -4668,6 +4697,9 @@ export default function (pi: ExtensionAPI) {
 				message: "Request ended without a complete assistant response.",
 			});
 			clearActiveRequest();
+			clearPendingStudioCompletion();
+		} else {
+			flushPendingStudioCompletionNotification();
 		}
 		suppressedStudioResponse = null;
 	});
@@ -4675,6 +4707,7 @@ export default function (pi: ExtensionAPI) {
 	pi.on("session_shutdown", async () => {
 		lastCommandCtx = null;
 		agentBusy = false;
+		clearPendingStudioCompletion();
 		clearCompactionState();
 		setTerminalActivity("idle");
 		await stopServer();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-studio",
-  "version": "0.5.17",
+  "version": "0.5.19",
   "description": "Browser GUI for structured critique workflows in pi",
   "type": "module",
   "license": "MIT",