agent-relay-server 0.30.0 → 0.31.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-server",
-  "version": "0.30.0",
+  "version": "0.31.0",
   "description": "Lightweight HTTP message relay for inter-agent communication across machines",
   "module": "src/index.ts",
   "type": "module",

package/public/index.html

@@ -12425,6 +12425,9 @@ var useRelayStore = create$1()(persist((set, get) => ({
 	spawnWorkspaceMode: "inherit",
 	spawnPrompt: "",
 	spawnSystemPromptAppend: "",
+	spawnCount: 1,
+	spawnCwdHistory: [],
+	isSpawning: false,
 	spawnDirBrowser: {
 		open: false,
 		loading: false,
@@ -13925,6 +13928,7 @@ var useRelayStore = create$1()(persist((set, get) => ({
 			spawnWorkspaceMode: "inherit",
 			spawnPrompt: "",
 			spawnSystemPromptAppend: "",
+			spawnCount: 1,
 			pendingForkImport: null,
 			orchestratorSpawnOpen: true
 		});
@@ -13974,6 +13978,7 @@ var useRelayStore = create$1()(persist((set, get) => ({
 			spawnWorkspaceMode: "inherit",
 			spawnPrompt: "Continue from this previous session.",
 			spawnSystemPromptAppend: systemPromptAppend,
+			spawnCount: 1,
 			pendingForkImport: {
 				sourcePeerId: agent.id,
 				sourceAgentId: agent.id,
@@ -14005,12 +14010,35 @@ var useRelayStore = create$1()(persist((set, get) => ({
 			spawnWorkspaceMode: "inherit",
 			spawnPrompt: "",
 			spawnSystemPromptAppend: "",
+			spawnCount: 1,
 			pendingForkImport: null,
 			orchestratorSpawnOpen: true
 		});
 	},
+	selectSpawnHistory(orchId, cwd) {
+		const s = get();
+		const orch = s.orchestrators.find((o) => o.id === orchId && o.status === "online");
+		if (!orch) {
+			get().showError("Unavailable", "That orchestrator is no longer online.");
+			return;
+		}
+		if (orchId === s.spawnOrchId) {
+			set({ spawnCwd: cwd });
+			return;
+		}
+		const provider = s.spawnProvider && orch.providers.includes(s.spawnProvider) ? s.spawnProvider : firstAvailableProvider(orch);
+		const model = s.spawnProvider === provider && s.spawnModel ? s.spawnModel : defaultModelFor(provider);
+		set({
+			spawnOrchId: orchId,
+			spawnProvider: provider,
+			spawnModel: model,
+			spawnEffort: s.spawnProvider === provider && s.spawnModel === model ? s.spawnEffort : "",
+			spawnCwd: cwd
+		});
+	},
 	async submitOrchestratorSpawn() {
 		const s = get();
+		if (s.isSpawning) return;
 		if (!s.spawnOrchId) {
 			get().showError("Validation", "Select an orchestrator.");
 			return;
@@ -14029,34 +14057,42 @@ var useRelayStore = create$1()(persist((set, get) => ({
 			get().showError("Validation", `Working directory must be under ${orch.baseDir}.`);
 			return;
 		}
+		const pendingForkImport = s.pendingForkImport;
+		const count = pendingForkImport ? 1 : Math.max(1, Math.min(10, Math.round(s.spawnCount) || 1));
+		set({ isSpawning: true });
 		try {
-			const payload = {
-				provider: s.spawnProvider,
-				approvalMode: s.spawnApproval,
-				workspaceMode: s.spawnWorkspaceMode || "inherit"
-			};
-			if (s.spawnModel) payload.model = s.spawnModel;
-			if (s.spawnEffort) payload.effort = s.spawnEffort;
-			if (s.spawnProfile) payload.profile = s.spawnProfile;
-			payload.cwd = cwd;
-			if (s.spawnLabel) payload.label = s.spawnLabel;
-			if (s.spawnPrompt) payload.prompt = s.spawnPrompt;
-			if (s.spawnSystemPromptAppend) payload.systemPromptAppend = s.spawnSystemPromptAppend;
-			const response = await api("POST", "/orchestrators/" + encodeURIComponent(s.spawnOrchId) + "/spawn", payload);
-			const pendingForkImport = s.pendingForkImport;
-			const targetSpawnRequestId = response.command?.params?.spawnRequestId;
-			if (pendingForkImport && targetSpawnRequestId && pendingForkImport.messageIds.length > 0) await api("POST", "/chat/history-imports", {
-				targetSpawnRequestId,
-				sourcePeerId: pendingForkImport.sourcePeerId,
-				sourceAgentId: pendingForkImport.sourceAgentId,
-				sourceThreadId: pendingForkImport.sourceThreadId,
-				sourceAgentLabel: pendingForkImport.sourceAgentLabel,
-				importedBy: INBOX_OPERATOR_ID,
-				messageIds: pendingForkImport.messageIds
-			});
+			for (let i = 0; i < count; i++) {
+				const payload = {
+					provider: s.spawnProvider,
+					approvalMode: s.spawnApproval,
+					workspaceMode: s.spawnWorkspaceMode || "inherit"
+				};
+				if (s.spawnModel) payload.model = s.spawnModel;
+				if (s.spawnEffort) payload.effort = s.spawnEffort;
+				if (s.spawnProfile) payload.profile = s.spawnProfile;
+				payload.cwd = cwd;
+				if (s.spawnLabel) payload.label = count > 1 ? `${s.spawnLabel} ${i + 1}` : s.spawnLabel;
+				if (s.spawnPrompt) payload.prompt = s.spawnPrompt;
+				if (s.spawnSystemPromptAppend) payload.systemPromptAppend = s.spawnSystemPromptAppend;
+				const targetSpawnRequestId = (await api("POST", "/orchestrators/" + encodeURIComponent(s.spawnOrchId) + "/spawn", payload)).command?.params?.spawnRequestId;
+				if (pendingForkImport && targetSpawnRequestId && pendingForkImport.messageIds.length > 0) await api("POST", "/chat/history-imports", {
+					targetSpawnRequestId,
+					sourcePeerId: pendingForkImport.sourcePeerId,
+					sourceAgentId: pendingForkImport.sourceAgentId,
+					sourceThreadId: pendingForkImport.sourceThreadId,
+					sourceAgentLabel: pendingForkImport.sourceAgentLabel,
+					importedBy: INBOX_OPERATOR_ID,
+					messageIds: pendingForkImport.messageIds
+				});
+			}
 			set({
 				orchestratorSpawnOpen: false,
-				pendingForkImport: null
+				pendingForkImport: null,
+				isSpawning: false,
+				spawnCwdHistory: [{
+					orchId: s.spawnOrchId,
+					cwd
+				}, ...s.spawnCwdHistory.filter((h) => !(h.orchId === s.spawnOrchId && h.cwd === cwd))].slice(0, 5)
 			});
 			await Promise.all([
 				get().fetchAgents(),
@@ -14065,6 +14101,7 @@ var useRelayStore = create$1()(persist((set, get) => ({
 				get().fetchChatHistoryImports()
 			]);
 		} catch (e) {
+			set({ isSpawning: false });
 			get().showError("Spawn Failed", e.message);
 		}
 	},
@@ -14710,7 +14747,8 @@ var useRelayStore = create$1()(persist((set, get) => ({
 		spawnProfile: state.spawnProfile,
 		spawnCwd: state.spawnCwd,
 		spawnApproval: state.spawnApproval,
-		spawnWorkspaceMode: state.spawnWorkspaceMode
+		spawnWorkspaceMode: state.spawnWorkspaceMode,
+		spawnCwdHistory: state.spawnCwdHistory
 	})
 }));
 var _voiceActiveChat = null;
@@ -77210,7 +77248,7 @@ function SidebarContent() {
 }
 function Sidebar() {
 	return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("aside", {
-		className: "hidden xl:flex w-[250px] min-w-[250px] h-dvh sticky top-0 flex-col border-r border-border bg-card",
+		className: "hidden xl:flex w-[250px] min-w-[250px] h-[calc(100dvh-var(--sat))] sticky top-[var(--sat)] flex-col border-r border-border bg-card",
 		children: [/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
 			className: "px-5 py-4 font-bold text-base border-b border-border flex items-center gap-2",
 			children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)(Radio, { className: "w-4 h-4 text-primary" }), "Agent Relay"]
@@ -77232,7 +77270,7 @@ function MobileDrawer() {
 		className: cn$2("xl:hidden fixed inset-0 z-40 bg-black/50 transition-opacity duration-200", open ? "opacity-100" : "opacity-0 pointer-events-none"),
 		onClick: () => set({ mobileMenuOpen: false })
 	}), /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("aside", {
-		className: cn$2("xl:hidden fixed inset-y-0 left-0 z-50 w-[280px] flex flex-col bg-card border-r border-border transition-transform duration-200 ease-out", open ? "translate-x-0" : "-translate-x-full"),
+		className: cn$2("xl:hidden fixed inset-y-0 left-0 z-50 w-[280px] flex flex-col pt-[var(--sat)] bg-card border-r border-border transition-transform duration-200 ease-out", open ? "translate-x-0" : "-translate-x-full"),
 		children: [/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
 			className: "px-5 py-4 font-bold text-base border-b border-border flex items-center gap-2",
 			children: [
@@ -77735,6 +77773,60 @@ function useAgentTerminal(agentId) {
 	};
 }
 //#endregion
+//#region src/hooks/use-keyboard-viewport.ts
+var KEYBOARD_MIN_DELTA = 100;
+function isEditableTarget(el) {
+	if (!el) return false;
+	const tag = el.tagName;
+	return tag === "INPUT" || tag === "TEXTAREA" || el.isContentEditable === true;
+}
+/**
+* Returns a pixel height to apply while the on-screen keyboard is open, or null
+* when it's closed (so the element falls back to its CSS height, e.g. 100dvh).
+*
+* iPad Safari ignores `interactive-widget=resizes-content`, so the keyboard
+* shrinks only the *visual* viewport, never the layout viewport — `dvh` units
+* don't react to it. Pinning `visualViewport.height` is what actually makes a
+* fullscreen container shrink for the keyboard there.
+*
+* The trap (#270 follow-up): if you pin `vv.height` unconditionally and never
+* reset it, the container stays shrunk after the keyboard closes, and iOS's
+* documented post-dismiss bug (a late resize event reporting wrong/offset
+* dimensions) gets applied blindly — leaving the layout too narrow / dialogs
+* too tall until an orientation toggle resets the OS viewport.
+*
+* So we pin a height ONLY while the keyboard is genuinely open (an editable
+* element is focused AND the visual viewport is meaningfully shorter than the
+* layout viewport) and return null otherwise. Returning null hands sizing back
+* to CSS, which recovers automatically — the same reset the orientation toggle
+* triggers, minus the manual flip. This also no-ops for iPad hardware keyboards
+* (no visual-viewport shrink → no spurious pin).
+*
+* @param active when false the hook stays inert and returns null (e.g. a closed dialog)
+*/
+function useKeyboardViewportHeight(active = true) {
+	const [height, setHeight] = (0, import_react.useState)(null);
+	(0, import_react.useEffect)(() => {
+		if (!active) {
+			setHeight(null);
+			return;
+		}
+		const vv = window.visualViewport;
+		if (!vv) return;
+		function onResize() {
+			setHeight(isEditableTarget(document.activeElement) && window.innerHeight - vv.height > KEYBOARD_MIN_DELTA ? vv.height : null);
+		}
+		onResize();
+		vv.addEventListener("resize", onResize);
+		window.addEventListener("focusout", onResize);
+		return () => {
+			vv.removeEventListener("resize", onResize);
+			window.removeEventListener("focusout", onResize);
+		};
+	}, [active]);
+	return height;
+}
+//#endregion
 //#region node_modules/comma-separated-tokens/index.js
 /**
 * Serialize an array of strings or numbers to comma-separated tokens.
@@ -126441,11 +126533,13 @@ function TerminalViewer({ orchestratorId, session, interactive: initialInteracti
 	});
 }
 function TerminalDialog({ open, onOpenChange, orchestratorId, session, interactive }) {
+	const vpHeight = useKeyboardViewportHeight(open);
 	return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Dialog, {
 		open,
 		onOpenChange,
 		children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(DialogContent, {
-			className: "inset-0 translate-x-0 translate-y-0 w-auto h-auto max-w-none rounded-none p-0 bg-background border-border gap-0 overflow-hidden",
+			className: "inset-x-0 top-0 translate-x-0 translate-y-0 w-auto max-w-none rounded-none p-0 pt-[var(--sat)] bg-background border-border gap-0 overflow-hidden",
+			style: { height: vpHeight ? `${vpHeight}px` : "100dvh" },
 			showCloseButton: false,
 			blurOverlay: false,
 			onEscapeKeyDown: (e) => e.preventDefault(),
@@ -128894,7 +128988,7 @@ var MessageBubble = (0, import_react.memo)(function MessageBubble({ msg, peer, o
 					type: "button",
 					title: isTtsPlaying ? "Stop playback" : "Play aloud",
 					onClick: togglePlay,
-					className: cn$2("absolute -top-2 -right-2 z-20 inline-flex h-6 w-6 items-center justify-center rounded-full border bg-popover shadow-sm transition", isTtsPlaying ? "border-primary/50 text-primary opacity-100" : "border-border text-muted-foreground opacity-70 hover:bg-muted hover:text-foreground hover:opacity-100 md:opacity-0 md:group-hover/msg:opacity-100"),
+					className: cn$2("absolute -top-2 -right-2 z-20 inline-flex h-6 w-6 items-center justify-center rounded-full border bg-popover shadow-sm transition", isTtsPlaying ? "border-primary/50 text-primary opacity-100" : "border-border text-muted-foreground opacity-70 hover:bg-muted hover:text-foreground hover:opacity-100 [@media(hover:hover)]:md:opacity-0 [@media(hover:hover)]:md:group-hover/msg:opacity-100"),
 					children: isTtsPlaying ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(CircleStop, { className: "h-3.5 w-3.5 animate-pulse" }) : /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Volume2, { className: "h-3.5 w-3.5" })
 				}),
 				/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
@@ -129692,7 +129786,7 @@ function ChatPanel({ threads, onBack, showBackButton }) {
 									onClick: interruptAgent,
 									children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(CircleStop, { className: "w-3.5 h-3.5" })
 								}),
-								agent.branchState === "changes" && agent.branchWorkspaceId && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Button, {
+								(agent.branchState === "changes" || agent.branchState === "idle") && agent.branchWorkspaceId && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Button, {
 									variant: "ghost",
 									size: "icon-sm",
 									className: "hidden @4xl/chat:inline-flex text-amber-400 hover:text-amber-300",
@@ -129787,7 +129881,7 @@ function ChatPanel({ threads, onBack, showBackButton }) {
 											onClick: interruptAgent,
 											children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)(CircleStop, { className: "w-3.5 h-3.5" }), "Interrupt"]
 										}),
-										agent.branchState === "changes" && agent.branchWorkspaceId && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(DropdownMenuItem, {
+										(agent.branchState === "changes" || agent.branchState === "idle") && agent.branchWorkspaceId && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(DropdownMenuItem, {
 											onClick: () => openConfirm("Mark Workspace Ready", `Mark ${displayName(agent)}'s branch ready to land? The relay auto-merge will rebase and land it.`, () => workspaceAction(agent.branchWorkspaceId, "ready")),
 											children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)(Flag, { className: "w-3.5 h-3.5" }), "Mark Ready"]
 										}),
@@ -130113,7 +130207,7 @@ function ChatView() {
 	}
 	return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
 		className: "flex -m-4 md:-m-6",
-		style: { height: "calc(100dvh - var(--header-h))" },
+		style: { height: "calc(100dvh - var(--header-h) - var(--sat))" },
 		children: [/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
 			className: "hidden md:flex w-full",
 			children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
@@ -130137,19 +130231,9 @@ function ChatView() {
 	});
 }
 function MobileChatContainer({ children }) {
-	const [height, setHeight] = (0, import_react.useState)(null);
-	(0, import_react.useEffect)(() => {
-		const vv = window.visualViewport;
-		if (!vv) return;
-		function onResize() {
-			setHeight(vv.height);
-		}
-		onResize();
-		vv.addEventListener("resize", onResize);
-		return () => vv.removeEventListener("resize", onResize);
-	}, []);
+	const height = useKeyboardViewportHeight();
 	return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
-		className: "fixed inset-x-0 top-0 z-40 flex flex-col bg-background",
+		className: "fixed inset-x-0 top-0 z-40 flex flex-col bg-background pt-[var(--sat)]",
 		style: { height: height ? `${height}px` : "100dvh" },
 		children
 	});
@@ -130313,7 +130397,7 @@ function AgentCard({ agent }) {
 							onClick: () => void handleOpenTerminal(),
 							children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Terminal, { className: "w-3 h-3" })
 						}),
-						agent.branchState === "changes" && agent.branchWorkspaceId && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Button, {
+						(agent.branchState === "changes" || agent.branchState === "idle") && agent.branchWorkspaceId && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Button, {
 							size: "icon",
 							variant: "ghost",
 							className: "h-7 w-7 text-amber-400 hover:text-amber-300",
@@ -155596,7 +155680,7 @@ function InsightsView() {
 			}) : /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
 				className: "overflow-x-auto",
 				children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("table", {
-					className: "w-full text-left text-xs",
+					className: "w-full min-w-[680px] text-left text-xs",
 					children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("thead", {
 						className: "text-muted-foreground",
 						children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("tr", {
@@ -159356,15 +159440,23 @@ function OrchestratorSpawnModal() {
 	const workspaceMode = useRelayStore((s) => s.spawnWorkspaceMode);
 	const prompt = useRelayStore((s) => s.spawnPrompt);
 	const systemPromptAppend = useRelayStore((s) => s.spawnSystemPromptAppend);
+	const count = useRelayStore((s) => s.spawnCount);
+	const cwdHistory = useRelayStore((s) => s.spawnCwdHistory);
+	const isSpawning = useRelayStore((s) => s.isSpawning);
+	const isFork = useRelayStore((s) => Boolean(s.pendingForkImport));
 	const set = useRelayStore((s) => s.set);
 	const submitOrchestratorSpawn = useRelayStore((s) => s.submitOrchestratorSpawn);
+	const selectSpawnHistory = useRelayStore((s) => s.selectSpawnHistory);
 	const agentProfiles = useRelayStore((s) => s.agentProfiles);
 	const orch = orchestrators.find((o) => o.id === orchId);
 	const providers = orch?.providers || [];
 	const models = PROVIDER_CATALOG[provider]?.models || [];
 	const selectedModel = models.find((m) => m.alias === model);
 	const efforts = selectedModel?.efforts || [];
-	const canSpawn = Boolean(orch && providers.length > 0 && cwd.trim());
+	const canSpawn = Boolean(orch && providers.length > 0 && cwd.trim()) && !isSpawning;
+	const onlineOrchs = orchestrators.filter((o) => o.status === "online");
+	const multiOrch = onlineOrchs.length > 1;
+	const recentDirs = cwdHistory.filter((h) => onlineOrchs.some((o) => o.id === h.orchId)).slice(0, 5);
 	function selectOrchestrator(nextId) {
 		const nextOrch = orchestrators.find((o) => o.id === nextId);
 		const nextProvider = nextOrch?.providers[0] || "";
@@ -159394,6 +159486,7 @@ function OrchestratorSpawnModal() {
 		onOpenChange: (o) => !o && set({ orchestratorSpawnOpen: false }),
 		children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(DialogContent, {
 			className: "max-w-lg max-h-[90dvh] flex flex-col",
+			onOpenAutoFocus: (e) => e.preventDefault(),
 			children: [
 				/* @__PURE__ */ (0, import_jsx_runtime.jsx)(DialogHeader, { children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(DialogTitle, { children: "Spawn Agent" }) }),
 				/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
@@ -159502,15 +159595,39 @@ function OrchestratorSpawnModal() {
 								})
 							]
 						})] }),
-						/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)(Label, { children: "Working Directory" }), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
-							className: "mt-1",
-							children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(DirectoryPicker, {
-								value: cwd,
-								onChange: (path) => set({ spawnCwd: path }),
-								orchestratorId: orchId,
-								placeholder: "Select a project directory"
+						/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
+							/* @__PURE__ */ (0, import_jsx_runtime.jsx)(Label, { children: "Working Directory" }),
+							/* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
+								className: "mt-1",
+								children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(DirectoryPicker, {
+									value: cwd,
+									onChange: (path) => set({ spawnCwd: path }),
+									orchestratorId: orchId,
+									placeholder: "Select a project directory"
+								})
+							}),
+							recentDirs.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+								className: "mt-2",
+								children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", {
+									className: "text-xs text-muted-foreground mb-1",
+									children: "Recent"
+								}), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", {
+									className: "flex gap-1.5 overflow-x-auto pb-1 sm:flex-wrap sm:overflow-x-visible sm:pb-0",
+									children: recentDirs.map((h) => {
+										const base = h.cwd.replace(/\/+$/, "").split("/").pop() || h.cwd;
+										const host = onlineOrchs.find((o) => o.id === h.orchId)?.hostname;
+										const active = h.orchId === orchId && h.cwd === cwd;
+										return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", {
+											type: "button",
+											title: multiOrch && host ? `${host}: ${h.cwd}` : h.cwd,
+											onClick: () => selectSpawnHistory(h.orchId, h.cwd),
+											className: `shrink-0 rounded-full border px-2.5 py-1 text-xs font-mono transition-colors ${active ? "border-primary bg-primary/10 text-foreground" : "border-input bg-background text-muted-foreground hover:bg-accent hover:text-foreground"}`,
+											children: multiOrch && host ? `${host}: ${base}` : base
+										}, `${h.orchId}:${h.cwd}`);
+									})
+								})]
 							})
-						})] }),
+						] }),
 						/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)(Label, { children: "Label" }), /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Input, {
 							value: label,
 							onChange: (e) => set({ spawnLabel: e.target.value }),
@@ -159541,17 +159658,47 @@ function OrchestratorSpawnModal() {
 								className: "text-xs text-muted-foreground mt-1",
 								children: "Use for fork history or launch context. It informs the session but does not start work by itself."
 							})
+						] }),
+						!isFork && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
+							/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+								className: "flex items-center justify-between",
+								children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)(Label, { children: "Number of Agents" }), /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", {
+									className: "text-sm font-mono tabular-nums text-muted-foreground",
+									children: count
+								})]
+							}),
+							/* @__PURE__ */ (0, import_jsx_runtime.jsx)("input", {
+								type: "range",
+								min: 1,
+								max: 10,
+								step: 1,
+								value: count,
+								onChange: (e) => set({ spawnCount: Number(e.target.value) }),
+								className: "w-full mt-2 accent-primary",
+								"aria-label": "Number of agents to spawn"
+							}),
+							count > 1 && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("p", {
+								className: "text-xs text-muted-foreground mt-1",
+								children: [
+									"Spawns ",
+									count,
+									" identical agents",
+									label.trim() ? `, labelled "${label.trim()} 1"…"${label.trim()} ${count}"` : "",
+									"."
+								]
+							})
 						] })
 					]
 				}),
 				/* @__PURE__ */ (0, import_jsx_runtime.jsxs)(DialogFooter, { children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)(Button, {
 					variant: "outline",
 					onClick: () => set({ orchestratorSpawnOpen: false }),
+					disabled: isSpawning,
 					children: "Cancel"
 				}), /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Button, {
 					onClick: submitOrchestratorSpawn,
 					disabled: !canSpawn,
-					children: providers.length ? "Spawn" : "No providers"
+					children: isSpawning ? "Spawning…" : providers.length ? count > 1 ? `Spawn ${count}` : "Spawn" : "No providers"
 				})] })
 			]
 		})
@@ -160677,12 +160824,12 @@ function App() {
 	}, [commandPaletteOpen]);
 	const ViewComponent = views[view] || OverviewView;
 	return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(ErrorBoundary, { children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(TooltipProvider, { children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
-		className: "flex min-h-dvh",
+		className: "flex min-h-[calc(100dvh-var(--sat))] mt-[var(--sat)]",
 		children: [
 			/* @__PURE__ */ (0, import_jsx_runtime.jsx)(Sidebar, {}),
 			/* @__PURE__ */ (0, import_jsx_runtime.jsx)(MobileDrawer, {}),
 			/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("main", {
-				className: "flex-1 h-dvh overflow-y-auto",
+				className: "flex-1 min-w-0 h-[calc(100dvh-var(--sat))] overflow-y-auto",
 				children: [
 					/* @__PURE__ */ (0, import_jsx_runtime.jsx)(MobileNav, {}),
 					!authNeeded && connectionError && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
@@ -161305,6 +161452,10 @@ if ("serviceWorker" in navigator) {
     top: calc(var(--header-h, 3rem) + .5rem);
   }
 
+  .top-\[var\(--sat\)\] {
+    top: var(--sat);
+  }
+
   .-right-0\.5 {
     right: calc(var(--spacing) * -.5);
   }
@@ -161507,6 +161658,10 @@ if ("serviceWorker" in navigator) {
     margin-top: calc(var(--spacing) * 4);
   }
 
+  .mt-\[var\(--sat\)\] {
+    margin-top: var(--sat);
+  }
+
   .mt-auto {
     margin-top: auto;
   }
@@ -161761,16 +161916,12 @@ if ("serviceWorker" in navigator) {
     height: calc(100dvh - 24rem);
   }
 
-  .h-\[var\(--header-h\)\] {
-    height: var(--header-h);
+  .h-\[calc\(100dvh-var\(--sat\)\)\] {
+    height: calc(100dvh - var(--sat));
   }
 
-  .h-auto {
-    height: auto;
-  }
-
-  .h-dvh {
-    height: 100dvh;
+  .h-\[var\(--header-h\)\] {
+    height: var(--header-h);
   }
 
   .h-fit {
@@ -161893,8 +162044,8 @@ if ("serviceWorker" in navigator) {
     min-height: 360px;
   }
 
-  .min-h-dvh {
-    min-height: 100dvh;
+  .min-h-\[calc\(100dvh-var\(--sat\)\)\] {
+    min-height: calc(100dvh - var(--sat));
   }
 
   .w-\(--radix-dropdown-menu-trigger-width\) {
@@ -162133,6 +162284,10 @@ if ("serviceWorker" in navigator) {
     min-width: 360px;
   }
 
+  .min-w-\[680px\] {
+    min-width: 680px;
+  }
+
   .min-w-\[980px\] {
     min-width: 980px;
   }
@@ -162141,6 +162296,10 @@ if ("serviceWorker" in navigator) {
     flex: 1;
   }
 
+  .shrink {
+    flex-shrink: 1;
+  }
+
   .shrink-0 {
     flex-shrink: 0;
   }
@@ -163913,6 +164072,10 @@ if ("serviceWorker" in navigator) {
     padding-top: 15vh;
   }
 
+  .pt-\[var\(--sat\)\] {
+    padding-top: var(--sat);
+  }
+
   .pr-2 {
     padding-right: calc(var(--spacing) * 2);
   }
@@ -164515,6 +164678,10 @@ if ("serviceWorker" in navigator) {
     -moz-osx-font-smoothing: grayscale;
   }
 
+  .accent-primary {
+    accent-color: var(--primary);
+  }
+
   .opacity-0 {
     opacity: 0;
   }
@@ -165730,10 +165897,18 @@ if ("serviceWorker" in navigator) {
       flex-direction: row;
     }
 
+    .sm\:flex-wrap {
+      flex-wrap: wrap;
+    }
+
     .sm\:justify-end {
       justify-content: flex-end;
     }
 
+    .sm\:overflow-x-visible {
+      overflow-x: visible;
+    }
+
     .sm\:px-2 {
       padding-inline: calc(var(--spacing) * 2);
     }
@@ -165742,6 +165917,10 @@ if ("serviceWorker" in navigator) {
       padding-right: calc(var(--spacing) * 3);
     }
 
+    .sm\:pb-0 {
+      padding-bottom: calc(var(--spacing) * 0);
+    }
+
     .sm\:opacity-0 {
       opacity: 0;
     }
@@ -165886,10 +166065,6 @@ if ("serviceWorker" in navigator) {
       text-wrap: pretty;
     }
 
-    .md\:opacity-0 {
-      opacity: 0;
-    }
-
     @media (hover: hover) {
       .md\:group-hover\/msg\:pointer-events-auto:is(:where(.group\/msg):hover *) {
         pointer-events: auto;
@@ -166500,6 +166675,20 @@ if ("serviceWorker" in navigator) {
     height: calc(var(--spacing) * 3) !important;
   }
 
+  @media (hover: hover) {
+    @media (min-width: 48rem) {
+      .\[\@media\(hover\:hover\)\]\:md\:opacity-0 {
+        opacity: 0;
+      }
+
+      @media (hover: hover) {
+        .\[\@media\(hover\:hover\)\]\:md\:group-hover\/msg\:opacity-100:is(:where(.group\/msg):hover *) {
+          opacity: 1;
+        }
+      }
+    }
+  }
+
   .safe-area-bottom {
     padding-bottom: max(.625rem, env(safe-area-inset-bottom));
   }
@@ -167103,6 +167292,7 @@ if ("serviceWorker" in navigator) {
 
 :root {
   --header-h: 3rem;
+  --sat: env(safe-area-inset-top, 0px);
 }
 
 .code-preview .shiki {

package/runner/src/config.ts

@@ -1,7 +1,9 @@
+import { execFileSync } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir, hostname } from "node:os";
 import { join, resolve } from "node:path";
 import { DEFAULT_RELAY_URL, stringValue } from "agent-relay-sdk";
+import type { WorkspaceMetadata } from "agent-relay-sdk";
 import { sanitizeFsName } from "agent-relay-sdk/fs-name";
 import type { ProviderConfig } from "./adapter";
 
@@ -101,6 +103,37 @@ export function runnerId(provider: string, cwd: string, label?: string): string
   return `${hostname()}-${provider}-${cleanLabel}-${crypto.randomUUID().slice(0, 8)}`;
 }
 
+/**
+ * Stable project identifier for insights aggregation: the repo NAME, never a
+ * per-branch/per-session worktree dir or full path. Isolated workspace agents run
+ * from a session-specific worktree (…/workspaces/<repo>/<id>) whose basename is
+ * unique per session — using it would scatter one repo's data across many "projects"
+ * and break per-project rollups. So we resolve up to the main repo root, then take
+ * its basename. Falls back to the git toplevel of cwd (handles a direct agent
+ * launched in a subdir), then to the cwd basename for a non-git directory.
+ */
+export function resolveProjectName(cwd: string, workspace?: WorkspaceMetadata): string {
+  const root =
+    workspace?.repoRoot ||
+    workspace?.probe?.repoRoot ||
+    gitToplevel(cwd) ||
+    workspace?.sourceCwd ||
+    cwd;
+  return root.split("/").filter(Boolean).at(-1) || "unknown";
+}
+
+function gitToplevel(cwd: string): string | undefined {
+  try {
+    const out = execFileSync("git", ["-C", cwd, "rev-parse", "--show-toplevel"], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+    }).trim();
+    return out || undefined;
+  } catch {
+    return undefined;
+  }
+}
+
 export function resolveCwd(value: string | undefined, fallback: string): string {
   return resolve(value || fallback);
 }

package/src/cli.ts

@@ -143,7 +143,8 @@ Upgrade options:
   --providers LIST  Provider integrations to upgrade: auto, all, codex, claude, orchestrator
   --host ID         Upgrade a remote orchestrator host over the relay (repeatable). Skips the local upgrade
   --all-hosts       Upgrade this host, then fan out to every connected remote host that is behind
-  --no-restart      Do not restart agent-relay.service
+  --no-restart      Do not restart agent-relay.service (warns you to restart it manually)
+  --restart-deferred  Like --no-restart, but the caller restarts the services itself; suppresses the manual-restart warning (used by the release script)
   --dry-run         Print detected state and planned commands
   --yes             Skip confirmation prompts
 
@@ -402,6 +403,7 @@ async function handleUpgradeCommand(args: string[]): Promise<void> {
   let targetVersion: string | undefined;
   let dryRun = false;
   let noRestart = false;
+  let restartDeferred = false;
   let yes = false;
   let json = false;
   let runtimePrefix: string | undefined;
@@ -425,6 +427,7 @@ async function handleUpgradeCommand(args: string[]): Promise<void> {
     else if (arg === "--all") providers.push("all");
     else if (arg === "--dry-run") dryRun = true;
     else if (arg === "--no-restart") noRestart = true;
+    else if (arg === "--restart-deferred") restartDeferred = true;
     else if (arg === "--yes" || arg === "-y") yes = true;
     else if (arg === "--json") json = true;
     else throw new Error(`Unknown upgrade option "${arg}"`);
@@ -449,6 +452,7 @@ async function handleUpgradeCommand(args: string[]): Promise<void> {
     ...(runtimePrefix ? { runtimePrefix } : {}),
     providers,
     noRestart,
+    restartDeferred,
   });
 
   if (json) {
@@ -2034,7 +2038,7 @@ async function handleIntrospectCommand(args: string[]): Promise<void> {
 
   const observation = await apiRequest("POST", "/api/insights/observations", {
     sessionId: sessionId || process.env.AGENT_RELAY_PROVIDER_SESSION_ID || `manual-${from}`,
-    project: project || process.cwd(),
+    project: project || process.env.AGENT_RELAY_PROJECT || process.cwd().split("/").filter(Boolean).at(-1) || process.cwd(),
     agentId: from,
     signal: "introspection",
     source: "agent",

package/src/upgrade.ts

@@ -13,6 +13,13 @@ type UpgradeOptions = {
   targetVersion?: string;
   providers?: UpgradeProvider[];
   noRestart?: boolean;
+  /**
+   * Like `noRestart` (no restart action → no premature post-restart verify),
+   * but the caller restarts the services itself right after install (the
+   * release script does). Suppresses the "restart manually" warning, which is
+   * a false alarm in that flow — only the caller knows the restart is coming.
+   */
+  restartDeferred?: boolean;
   runtimePrefix?: string;
 };
 
@@ -206,10 +213,14 @@ export function createUpgradePlan(snapshot: UpgradeSnapshot, options: UpgradeOpt
     warnings.push("Agent Relay orchestrator not detected; skipping orchestrator package upgrade.");
   }
 
+  // `restartDeferred` means a caller restarts for us — skip the restart action
+  // (and thus the post-restart verify) exactly like `noRestart`, but without the
+  // "restart manually" warning, which would be a false alarm in that flow.
+  const deferRestart = Boolean(options.noRestart || options.restartDeferred);
   const serverRestartNeeded = serverPackageUpdated || Boolean(snapshot.runningServerVersion && snapshot.runningServerVersion !== targetVersion);
   if (snapshot.hasSystemdUserService && serverRestartNeeded) {
-    if (options.noRestart) {
-      warnings.push("agent-relay.service detected but --no-restart was set; restart manually to run the upgraded server.");
+    if (deferRestart) {
+      if (!options.restartDeferred) warnings.push("agent-relay.service detected but --no-restart was set; restart manually to run the upgraded server.");
     } else {
       actions.push({
         label: "Restart Agent Relay service",
@@ -226,8 +237,8 @@ export function createUpgradePlan(snapshot: UpgradeSnapshot, options: UpgradeOpt
     Boolean((orch.version && orch.version !== targetVersion) || orch.health?.restartRequired)
   );
   if (snapshot.hasSystemdUserOrchestratorService && orchestratorRestartNeeded) {
-    if (options.noRestart) {
-      warnings.push("agent-relay-orchestrator.service detected but --no-restart was set; restart manually to run the upgraded orchestrator.");
+    if (deferRestart) {
+      if (!options.restartDeferred) warnings.push("agent-relay-orchestrator.service detected but --no-restart was set; restart manually to run the upgraded orchestrator.");
     } else {
       actions.push({
         label: "Restart Agent Relay orchestrator service",

package/src/workspace-phase.ts

@@ -232,9 +232,12 @@ function metaNumber(meta: Record<string, unknown> | undefined, key: string): num
 //
 // idle/changes need the worktree's ahead/dirty counts, which the relay isn't in the
 // git path to know live — the ~2 min conflict scan stashes them in metadata
-// (`gitAhead`/`gitDirtyCount`). Until the first scan they're absent, so an active
-// worktree shows the optimistic `changes` (the high-value "mark ready" affordance);
-// the scan then settles it to `idle` when genuinely empty (#236 v1 option a).
+// (`gitAhead`/`gitDirtyCount`). Until the first scan they're absent: presume `idle`,
+// because a freshly-spawned (or freshly-rebased post-land `--N`) worktree genuinely
+// has nothing ahead/dirty, and the old optimistic `changes` default mislabeled every
+// brand-new branch as having unlanded work (#236 v2). The scan flips it to `changes`
+// within one sweep once real commits/dirt appear. The "mark ready" affordance no
+// longer depends on this guess — the dashboard offers it on idle too.
 //
 // Returns undefined for non-branch / torn-down workspaces (no badge).
 export function deriveBranchState(
@@ -248,7 +251,8 @@ export function deriveBranchState(
       const meta = workspace.metadata as Record<string, unknown> | undefined;
       const ahead = metaNumber(meta, "gitAhead");
       const dirty = metaNumber(meta, "gitDirtyCount");
-      if (ahead === undefined && dirty === undefined) return "changes";
+      // Unprobed → presume idle (clean fresh/rebased branch); the scan reveals real work.
+      if (ahead === undefined && dirty === undefined) return "idle";
       return (ahead ?? 0) > 0 || (dirty ?? 0) > 0 ? "changes" : "idle";
     }
     case "ready":