@robota-sdk/agent-ui-web 3.1.2 → 3.2.1

package/dist/index.cjs

@@ -540,13 +540,6 @@ function useAppViewRequests(send, isConnected) {
 }
 //#endregion
 //#region src/hooks/use-execution-detail.ts
-/**
-* #3288 §1: the detail sheet's own correlated request/response state — which entry is open, its
-* accumulated transcript records, and whether more can be loaded. Owned independently from chat
-* state, the same way `use-personal-usage.ts` owns the usage-report protocol: one `requestId` per
-* outstanding read, so a stale reply for an entry the operator already closed (or a page they moved
-* past) is dropped rather than clobbering what is now on screen.
-*/
 let requestCounter$5 = 0;
 function nextRequestId$5() {
 	requestCounter$5 += 1;
@@ -558,14 +551,27 @@ function useExecutionDetailState(send) {
 	const [records, setRecords] = (0, react.useState)([]);
 	const [error, setError] = (0, react.useState)(null);
 	const [complete, setComplete] = (0, react.useState)(false);
+	const [mode, setMode] = (0, react.useState)("live");
+	const [unreadable, setUnreadable] = (0, react.useState)();
 	const requestIdRef = (0, react.useRef)(null);
 	const entryIdRef = (0, react.useRef)(null);
+	const modeRef = (0, react.useRef)("live");
 	const nextCursorRef = (0, react.useRef)(void 0);
-	const readPage = (0, react.useCallback)((entryId, cursor) => {
+	const queuedRef = (0, react.useRef)(null);
+	const timerRef = (0, react.useRef)(null);
+	const lastReadAtRef = (0, react.useRef)(0);
+	const readPage = (0, react.useCallback)((entryId, cursor, refresh = false) => {
+		if (requestIdRef.current !== null) {
+			if (!refresh || queuedRef.current === null || queuedRef.current.refresh) queuedRef.current = {
+				cursor,
+				refresh
+			};
+			return;
+		}
 		const requestId = nextRequestId$5();
 		requestIdRef.current = requestId;
-		entryIdRef.current = entryId;
-		setStatus("loading");
+		lastReadAtRef.current = Date.now();
+		if (!refresh) setStatus("loading");
 		setError(null);
 		send({
 			type: "read-execution-detail",
@@ -574,51 +580,118 @@ function useExecutionDetailState(send) {
 			cursor
 		});
 	}, [send]);
+	const clearPending = (0, react.useCallback)(() => {
+		if (timerRef.current !== null) clearTimeout(timerRef.current);
+		timerRef.current = null;
+		queuedRef.current = null;
+	}, []);
+	(0, react.useEffect)(() => clearPending, [clearPending]);
+	const openExecutionDetail = (0, react.useCallback)((entryId) => {
+		clearPending();
+		requestIdRef.current = null;
+		entryIdRef.current = entryId;
+		modeRef.current = "live";
+		setMode("live");
+		setOpenEntryId(entryId);
+		setRecords([]);
+		setUnreadable(void 0);
+		setComplete(false);
+		nextCursorRef.current = void 0;
+		readPage(entryId);
+	}, [clearPending, readPage]);
+	const loadMoreExecutionDetail = (0, react.useCallback)(() => {
+		if (!openEntryId || status === "loading" || complete) return;
+		readPage(openEntryId, nextCursorRef.current);
+	}, [
+		openEntryId,
+		status,
+		complete,
+		readPage
+	]);
+	const changeMode = (0, react.useCallback)((next) => {
+		const entryId = entryIdRef.current;
+		if (!entryId) return;
+		clearPending();
+		modeRef.current = next;
+		setMode(next);
+		setRecords([]);
+		setUnreadable(void 0);
+		setComplete(false);
+		setStatus("loading");
+		nextCursorRef.current = void 0;
+		readPage(entryId, next === "transcript" ? { offset: 0 } : void 0);
+	}, [clearPending, readPage]);
+	const showEarlierExecutionDetail = (0, react.useCallback)(() => changeMode("transcript"), [changeMode]);
+	const showLiveExecutionDetail = (0, react.useCallback)(() => changeMode("live"), [changeMode]);
+	const closeExecutionDetail = (0, react.useCallback)(() => {
+		clearPending();
+		setOpenEntryId(null);
+		requestIdRef.current = null;
+		entryIdRef.current = null;
+		setRecords([]);
+		setUnreadable(void 0);
+		setStatus("idle");
+		setError(null);
+		setComplete(false);
+	}, [clearPending]);
+	const scheduleRefresh = (0, react.useCallback)((entryId) => {
+		if (timerRef.current !== null) return;
+		const delay = Math.max(0, 250 - (Date.now() - lastReadAtRef.current));
+		timerRef.current = setTimeout(() => {
+			timerRef.current = null;
+			if (entryIdRef.current === entryId && modeRef.current === "live") readPage(entryId, void 0, true);
+		}, delay);
+	}, [readPage]);
+	const handleExecutionWorkspace = (0, react.useCallback)((snapshot) => {
+		const entryId = entryIdRef.current;
+		if (!entryId || modeRef.current !== "live") return;
+		const entry = snapshot.entries.find((item) => item.id === entryId);
+		if (entry?.resumeSessionId && entry.controls.includes("attach")) scheduleRefresh(entryId);
+	}, [scheduleRefresh]);
 	return {
 		openEntryId,
 		executionDetailStatus: status,
 		executionDetailRecords: records,
 		executionDetailError: error,
 		executionDetailComplete: complete,
-		openExecutionDetail: (0, react.useCallback)((entryId) => {
-			setOpenEntryId(entryId);
-			setRecords([]);
-			setComplete(false);
-			nextCursorRef.current = void 0;
-			readPage(entryId);
-		}, [readPage]),
-		loadMoreExecutionDetail: (0, react.useCallback)(() => {
-			if (!openEntryId || status === "loading" || complete) return;
-			readPage(openEntryId, nextCursorRef.current);
-		}, [
-			openEntryId,
-			status,
-			complete,
-			readPage
-		]),
-		closeExecutionDetail: (0, react.useCallback)(() => {
-			setOpenEntryId(null);
-			requestIdRef.current = null;
-			entryIdRef.current = null;
-			setRecords([]);
-			setStatus("idle");
-			setError(null);
-			setComplete(false);
-		}, []),
+		executionDetailMode: mode,
+		executionDetailUnreadable: unreadable,
+		openExecutionDetail,
+		loadMoreExecutionDetail,
+		showEarlierExecutionDetail,
+		showLiveExecutionDetail,
+		closeExecutionDetail,
 		handleExecutionDetailMessage: (0, react.useCallback)((msg) => {
 			if (msg.type !== "execution_detail" && msg.type !== "execution_detail_error") return false;
 			if (requestIdRef.current !== msg.requestId) return true;
-			if (msg.type === "execution_detail_error") {
+			requestIdRef.current = null;
+			const queued = queuedRef.current;
+			queuedRef.current = null;
+			if (!queued || queued.refresh) if (msg.type === "execution_detail_error") {
 				setStatus("error");
 				setError(msg.message);
-				return true;
+			} else {
+				setRecords((previous) => msg.page.cursor === void 0 || msg.page.cursor.offset === 0 ? msg.page.records : [...previous, ...msg.page.records]);
+				setUnreadable((previous) => {
+					const current = msg.page.unreadable;
+					if (msg.page.cursor === void 0 || msg.page.cursor.offset === 0) return current;
+					if (!previous) return current;
+					if (!current) return previous;
+					return {
+						locked: previous.locked + current.locked,
+						noKeys: previous.noKeys + current.noKeys,
+						doesNotOpen: previous.doesNotOpen + current.doesNotOpen
+					};
+				});
+				nextCursorRef.current = msg.page.nextCursor;
+				setComplete(msg.page.nextCursor === void 0);
+				setStatus("ready");
 			}
-			setRecords((previous) => msg.page.cursor === void 0 ? msg.page.records : [...previous, ...msg.page.records]);
-			nextCursorRef.current = msg.page.nextCursor;
-			setComplete(msg.page.nextCursor === void 0);
-			setStatus("ready");
+			if (queued && entryIdRef.current) if (queued.refresh) scheduleRefresh(entryIdRef.current);
+			else readPage(entryIdRef.current, queued.cursor);
 			return true;
-		}, [])
+		}, [readPage, scheduleRefresh]),
+		handleExecutionWorkspace
 	};
 }
 //#endregion
@@ -1387,7 +1460,17 @@ function useSessionClient(makeClient) {
 	const silentCommandRequestIdsRef = (0, react.useRef)(/* @__PURE__ */ new Set());
 	const sessionChangesInFlightRef = (0, react.useRef)(0);
 	const sessionChangeRequestIdsRef = (0, react.useRef)(/* @__PURE__ */ new Set());
+	const [executionDetailInput, setExecutionDetailInput] = (0, react.useState)();
+	const executionDetailInputRef = (0, react.useRef)(null);
 	const send = (0, react.useCallback)((msg) => {
+		if (msg.type === "send-background-task") {
+			if (executionDetailInputRef.current !== null) return;
+			executionDetailInputRef.current = msg.taskId;
+			setExecutionDetailInput({
+				taskId: msg.taskId,
+				status: "pending"
+			});
+		}
 		if (msg.type === "command") {
 			if (msg.name === "help") {
 				setHelpOpen(true);
@@ -1444,7 +1527,7 @@ function useSessionClient(makeClient) {
 		});
 	}, [send]);
 	const { handleUsageMessage, ...personalUsageState } = usePersonalUsageState(send);
-	const { handleExecutionDetailMessage, closeExecutionDetail, ...executionDetailState } = useExecutionDetailState(send);
+	const { handleExecutionDetailMessage, handleExecutionWorkspace, closeExecutionDetail, ...executionDetailState } = useExecutionDetailState(send);
 	const { handleModelListMessage, ...modelListState } = useModelListState(send);
 	const { handleProjectMessage, ...projectPanelState } = useProjectPanelState(send);
 	const { handleAppViewMessage, rejectPendingAppRequests, readAppView, callAppTool } = useAppViewRequests(send, (0, react.useCallback)(() => statusRef.current === "connected", []));
@@ -1528,13 +1611,21 @@ function useSessionClient(makeClient) {
 				break;
 			}
 			case "execution_workspace_event":
+				handleExecutionWorkspace(msg.snapshot);
 				setExecutionWorkspace(msg.snapshot);
 				break;
 			case "background_task_control_result":
+				if (msg.action === "send" && executionDetailInputRef.current === msg.taskId) {
+					executionDetailInputRef.current = null;
+					setExecutionDetailInput({
+						taskId: msg.taskId,
+						status: msg.success ? "sent" : "failed"
+					});
+				}
 				if (!msg.success) setSessionNotices((previous) => [...previous, {
 					id: nextId(),
 					kind: "background-task-control-failed",
-					message: msg.message ?? `Could not stop ${msg.taskId}.`
+					message: msg.message ?? `Could not ${msg.action === "send" ? "send to" : "stop"} ${msg.taskId}.`
 				}]);
 				break;
 			case "pending":
@@ -1679,6 +1770,13 @@ function useSessionClient(makeClient) {
 				}]);
 				break;
 			case "protocol_error": {
+				if (executionDetailInputRef.current !== null && msg.message === "Not permitted for an observer: send-background-task") {
+					setExecutionDetailInput({
+						taskId: executionDetailInputRef.current,
+						status: "failed"
+					});
+					executionDetailInputRef.current = null;
+				}
 				if (sessionChangesInFlightRef.current > 0) {
 					settleSessionChange();
 					setSessionNotices((previous) => [...previous, {
@@ -1791,6 +1889,7 @@ function useSessionClient(makeClient) {
 		handleAgentDefinitionsMessage,
 		handleAppViewMessage,
 		handleExecutionDetailMessage,
+		handleExecutionWorkspace,
 		handleModelListMessage,
 		handleProjectMessage,
 		handleSchedulesMessage,
@@ -1828,6 +1927,14 @@ function useSessionClient(makeClient) {
 			if (next !== "connected") {
 				rejectPendingAppRequests();
 				clearCompactionNotices();
+				closeExecutionDetail();
+				if (executionDetailInputRef.current !== null) {
+					setExecutionDetailInput({
+						taskId: executionDetailInputRef.current,
+						status: "failed"
+					});
+					executionDetailInputRef.current = null;
+				}
 			}
 			if (next === "connected") {
 				commandsInFlightRef.current = 0;
@@ -1858,6 +1965,7 @@ function useSessionClient(makeClient) {
 		makeClient,
 		handleMessage,
 		clearCompactionNotices,
+		closeExecutionDetail,
 		requestSessions,
 		requestSchedules,
 		armRestore,
@@ -1882,6 +1990,7 @@ function useSessionClient(makeClient) {
 		answerAsk,
 		...personalUsageState,
 		...executionDetailState,
+		executionDetailInput,
 		closeExecutionDetail,
 		...modelListState,
 		...projectPanelState,
@@ -1916,6 +2025,63 @@ function useWsSession(url) {
 	};
 }
 //#endregion
+//#region src/client/desktop-session-client.ts
+function createDesktopSessionClient(bridge, callbacks) {
+	let connected = false;
+	let subscribed = false;
+	let release;
+	let failed = false;
+	let revoked = false;
+	const close = () => {
+		revoked = true;
+		connected = false;
+		if (!failed && subscribed) callbacks.onStatusChange("disconnected");
+	};
+	return {
+		connect() {
+			if (revoked || failed) return;
+			if (subscribed) return;
+			subscribed = true;
+			callbacks.onStatusChange("connecting");
+			try {
+				release = bridge.subscribe((frame) => {
+					if (!subscribed || failed || revoked) return;
+					const decoded = (0, _robota_sdk_agent_transport_client.decodeFrame)(frame, _robota_sdk_agent_transport_client.decodeServerMessage);
+					if (!decoded.ok) {
+						failed = true;
+						connected = false;
+						bridge.close();
+						callbacks.onStatusChange("error");
+						return;
+					}
+					callbacks.onMessage(decoded.message);
+				}, close, () => {
+					if (!subscribed || failed || revoked) return;
+					connected = true;
+					callbacks.onStatusChange("connected");
+					bridge.send(JSON.stringify({ type: "get-messages" }));
+				});
+			} catch {
+				close();
+			}
+		},
+		disconnect() {
+			subscribed = false;
+			connected = false;
+			release?.();
+			release = void 0;
+			callbacks.onStatusChange("disconnected");
+		},
+		send(message) {
+			if (!connected || failed) return;
+			if (!bridge.send(JSON.stringify(message))) {
+				bridge.close();
+				close();
+			}
+		}
+	};
+}
+//#endregion
 //#region src/client/runtime-host.ts
 /** Resolve host capabilities without importing Electron or a Node CLI into the browser graph. */
 function resolveClientRuntimeHost(environment) {
@@ -5881,16 +6047,32 @@ function writeDraft(namespace, sessionId, value) {
 * context). The row's controls run the session's own commands (`/provider`, `/mode`, `/effort`), so a
 * setting changes through the one path every client shares.
 */
-const Composer = (0, react.forwardRef)(function Composer({ onSubmit, onCommand, catalog, status, connected = true, running, onStop, queued, onCancelQueue, pickFiles, getPathForFile, modelList = null, onRequestModelList = () => {}, onSilentCommand = onCommand, onManageProviders = () => onCommand("provider") }, ref) {
+const ComposerInstance = (0, react.forwardRef)(function Composer({ draftMode = "persistent", onSubmit, onCommand, catalog, status, connected = true, running, onStop, queued, onCancelQueue, pickFiles, getPathForFile, modelList = null, onRequestModelList = () => {}, onSilentCommand = onCommand, onManageProviders = () => onCommand("provider") }, ref) {
 	const { identity, storage: { browserNamespace } } = useProductIdentity();
 	const textareaRef = (0, react.useRef)(null);
 	(0, react.useImperativeHandle)(ref, () => ({ focus: () => textareaRef.current?.focus() }), []);
 	const sessionId = status?.sessionId;
+	const workspacePath = status?.workspace?.path;
+	const pickerGeneration = (0, react.useRef)(0);
+	const [fileInputEpoch, setFileInputEpoch] = (0, react.useState)(0);
+	const browserPickerOpen = (0, react.useRef)(false);
+	(0, react.useLayoutEffect)(() => {
+		pickerGeneration.current += 1;
+		browserPickerOpen.current = false;
+		return () => {
+			pickerGeneration.current += 1;
+		};
+	}, [sessionId, workspacePath]);
+	const invalidatePickers = () => {
+		pickerGeneration.current += 1;
+		browserPickerOpen.current = false;
+		setFileInputEpoch((epoch) => epoch + 1);
+	};
 	const sessionIdRef = (0, react.useRef)(sessionId);
 	const hasKnownSessionRef = (0, react.useRef)(sessionId !== void 0);
 	const stateRef = (0, react.useRef)(EMPTY_DRAFT);
 	const [draft, setDraftState] = (0, react.useState)(() => {
-		const initial = readDraft(browserNamespace, sessionId);
+		const initial = draftMode === "volatile" ? EMPTY_DRAFT : readDraft(browserNamespace, sessionId);
 		stateRef.current = initial;
 		return initial.text;
 	});
@@ -5914,7 +6096,7 @@ const Composer = (0, react.forwardRef)(function Composer({ onSubmit, onCommand,
 			text: value
 		};
 		setDraftState(value);
-		writeDraft(browserNamespace, sessionIdRef.current, stateRef.current);
+		if (draftMode === "persistent") writeDraft(browserNamespace, sessionIdRef.current, stateRef.current);
 	};
 	/** #3282 §4d: attachment chips persist alongside the text, under the same per-session draft key. */
 	const setAttachments = (updater) => {
@@ -5924,9 +6106,10 @@ const Composer = (0, react.forwardRef)(function Composer({ onSubmit, onCommand,
 			attachments: next
 		};
 		setAttachmentsState(next);
-		writeDraft(browserNamespace, sessionIdRef.current, stateRef.current);
+		if (draftMode === "persistent") writeDraft(browserNamespace, sessionIdRef.current, stateRef.current);
 	};
 	(0, react.useEffect)(() => {
+		if (draftMode === "volatile") return;
 		if (sessionId === void 0 && hasKnownSessionRef.current) return;
 		if (sessionIdRef.current === sessionId) return;
 		const firstArrival = !hasKnownSessionRef.current;
@@ -5945,23 +6128,26 @@ const Composer = (0, react.forwardRef)(function Composer({ onSubmit, onCommand,
 		setDraftState(stored.text);
 		setAttachmentsState(stored.attachments);
 		setAttachmentNotice(null);
-	}, [browserNamespace, sessionId]);
+	}, [
+		browserNamespace,
+		draftMode,
+		sessionId
+	]);
 	const submit = () => {
 		if (!connected) return;
 		const text = draft.trim();
 		if (!text && attachments.length === 0) return;
+		invalidatePickers();
 		onSubmit(buildPromptWithAttachments(text, attachments));
 		setDraft("");
 		setAttachments([]);
 		setAttachmentNotice(null);
 	};
-	const workspacePath = status?.workspace?.path;
-	const totalAttachedBytes = attachments.reduce((sum, a) => sum + a.size, 0);
 	/** Evaluate every dropped/picked file in order, so a mixed batch attaches what it can. */
 	const addCandidates = (candidates) => {
 		if (candidates.length === 0) return;
-		let total = totalAttachedBytes;
-		let count = attachments.length;
+		let total = stateRef.current.attachments.reduce((sum, attachment) => sum + attachment.size, 0);
+		let count = stateRef.current.attachments.length;
 		const added = [];
 		let notice = null;
 		for (const candidate of candidates) {
@@ -5985,19 +6171,44 @@ const Composer = (0, react.forwardRef)(function Composer({ onSubmit, onCommand,
 		absolutePath: getPathForFile ? getPathForFile(file) || void 0 : void 0
 	});
 	const fileInputRef = (0, react.useRef)(null);
+	(0, react.useEffect)(() => {
+		const input = fileInputRef.current;
+		if (!input) return;
+		const cancel = () => {
+			browserPickerOpen.current = false;
+		};
+		input.addEventListener("cancel", cancel);
+		return () => {
+			input.removeEventListener("cancel", cancel);
+		};
+	}, [
+		sessionId,
+		workspacePath,
+		fileInputEpoch
+	]);
 	const handleAttachClick = () => {
 		if (!connected) return;
 		if (pickFiles) {
-			pickFiles().then((picked) => addCandidates(picked.map((f) => ({
-				name: f.name,
-				size: f.size,
-				absolutePath: f.path
-			})))).catch(() => setAttachmentNotice("Could not open the file picker. Try again."));
+			const generation = pickerGeneration.current;
+			pickFiles().then((picked) => {
+				if (generation !== pickerGeneration.current) return;
+				addCandidates(picked.map((f) => ({
+					name: f.name,
+					size: f.size,
+					absolutePath: f.path
+				})));
+			}).catch(() => {
+				if (generation !== pickerGeneration.current) return;
+				setAttachmentNotice("Could not open the file picker. Try again.");
+			});
 			return;
 		}
+		if (browserPickerOpen.current) return;
+		browserPickerOpen.current = true;
 		fileInputRef.current?.click();
 	};
 	const handleFileInputChange = (event) => {
+		browserPickerOpen.current = false;
 		const files = Array.from(event.target.files ?? []);
 		event.target.value = "";
 		addCandidates(files.map(toCandidateFromFile));
@@ -6029,6 +6240,7 @@ const Composer = (0, react.forwardRef)(function Composer({ onSubmit, onCommand,
 	/** Choosing a command from the menu, by mouse or by keyboard (`acceptMenu` below). */
 	const chooseMenuItem = (item) => {
 		if (isImmediateScreenCommand(item)) {
+			invalidatePickers();
 			setDraft("");
 			onCommand(item.name);
 			return;
@@ -6191,7 +6403,11 @@ const Composer = (0, react.forwardRef)(function Composer({ onSubmit, onCommand,
 						className: "sr-only",
 						tabIndex: -1,
 						"aria-hidden": "true"
-					}),
+					}, JSON.stringify([
+						sessionId ?? null,
+						workspacePath ?? null,
+						fileInputEpoch
+					])),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("textarea", {
 						ref: textareaRef,
 						"aria-label": "message",
@@ -6283,6 +6499,15 @@ const Composer = (0, react.forwardRef)(function Composer({ onSubmit, onCommand,
 		]
 	});
 });
+/** Volatile state belongs to one session and never crosses a mode or session boundary. */
+const Composer = (0, react.forwardRef)(function Composer(props, ref) {
+	const key = props.draftMode === "volatile" ? JSON.stringify(["volatile", props.status?.sessionId ?? null]) : "persistent";
+	return /* @__PURE__ */ (0, react.createElement)(ComposerInstance, {
+		...props,
+		key,
+		ref
+	});
+});
 /**
 * The goal being pursued (`/goal`), above the composer while it is active — the objective, how far
 * the turn budget has gone, and a way to stop it (`/goal cancel`).
@@ -6343,6 +6568,7 @@ const STATUS_TAG_TONE = {
 	destructive: "bg-destructive/12 text-destructive",
 	muted: "bg-subtle/15 text-subtle"
 };
+const FOLLOW_BOTTOM_MARGIN_PX = 32;
 const RECORD_KIND_LABEL = {
 	message: "",
 	tool_activity: "Tool",
@@ -6357,10 +6583,40 @@ const RECORD_KIND_LABEL = {
 * headline), its transcript so far (paginated via `onLoadMore`) and, once it has one, its result.
 * `entry === null` renders nothing; the caller owns showing/hiding this over the panel.
 */
-function ExecutionDetailSheet({ entry, status, records, error, complete, onClose, onLoadMore, onStop }) {
+function ExecutionDetailSheet({ entry, status, records, error, complete, onClose, onLoadMore, onStop, onSend, inputState, onContinue, mode = "live", unreadable, onShowEarlier, onShowLive }) {
+	const [prompt, setPrompt] = react.default.useState("");
+	const submitted = react.default.useRef(null);
+	const outputRef = react.default.useRef(null);
+	const followingRef = react.default.useRef(true);
+	const isFork = Boolean(entry?.resumeSessionId && entry.controls.includes("attach"));
+	react.default.useLayoutEffect(() => {
+		followingRef.current = true;
+	}, [entry?.id, mode]);
+	react.default.useLayoutEffect(() => {
+		const output = outputRef.current;
+		if (output && isFork && mode === "live" && followingRef.current) output.scrollTop = output.scrollHeight;
+	}, [
+		entry?.id,
+		isFork,
+		mode,
+		records
+	]);
+	react.default.useEffect(() => {
+		setPrompt("");
+		submitted.current = null;
+	}, [entry?.id]);
+	react.default.useEffect(() => {
+		if (!entry || inputState?.taskId !== entry.sourceId || inputState.status === "pending") return;
+		if (inputState.status === "sent" && submitted.current !== null) {
+			const sent = submitted.current;
+			setPrompt((current) => current.trim() === sent ? "" : current);
+		}
+		submitted.current = null;
+	}, [entry, inputState]);
 	if (!entry) return null;
 	const described = describeExecutionEntryStatus(entry);
 	const canStop = onStop !== void 0 && entry.controls.includes("cancel");
+	const ended = entry.status === "completed" || entry.status === "failed" || entry.status === "cancelled";
 	const askedLine = entry.headline?.text ?? entry.preview;
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		role: "dialog",
@@ -6415,10 +6671,37 @@ function ExecutionDetailSheet({ entry, status, records, error, complete, onClose
 					entry.deniedToolCalls,
 					" tool ",
 					entry.deniedToolCalls === 1 ? "call was" : "calls were",
-					" refused."
+					" ",
+					"refused."
 				]
 			}),
+			isFork && onShowEarlier && onShowLive && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "flex gap-3 border-b border-subtle/15 px-4 py-2 text-[12px]",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+					type: "button",
+					onClick: onShowLive,
+					disabled: mode === "live",
+					children: "Live output"
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+					type: "button",
+					onClick: onShowEarlier,
+					disabled: mode === "transcript",
+					children: "Earlier output"
+				})]
+			}),
 			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				ref: outputRef,
+				role: isFork ? mode === "live" ? "log" : "region" : void 0,
+				"aria-label": isFork ? mode === "live" ? "Live fork output" : "Earlier fork output" : void 0,
+				"aria-live": isFork && mode === "live" ? "polite" : void 0,
+				"aria-relevant": isFork && mode === "live" ? "additions text" : void 0,
+				"aria-atomic": isFork && mode === "live" ? false : void 0,
+				tabIndex: isFork ? 0 : void 0,
+				onScroll: (event) => {
+					if (!isFork || mode !== "live") return;
+					const output = event.currentTarget;
+					followingRef.current = output.scrollHeight - output.scrollTop - output.clientHeight <= FOLLOW_BOTTOM_MARGIN_PX;
+				},
 				className: "flex-1 space-y-2 overflow-y-auto px-4 py-3",
 				children: [
 					records.map((record) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -6439,17 +6722,54 @@ function ExecutionDetailSheet({ entry, status, records, error, complete, onClose
 						className: "text-[13px] text-destructive",
 						children: error
 					}),
-					!complete && status !== "loading" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+					unreadable && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+						className: "text-[12px] text-warning",
+						children: [
+							"Some records could not be read: ",
+							unreadable.locked,
+							" locked, ",
+							unreadable.noKeys,
+							" without keys, ",
+							unreadable.doesNotOpen,
+							" unavailable."
+						]
+					}),
+					(!isFork || mode === "transcript") && !complete && status !== "loading" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 						type: "button",
 						onClick: onLoadMore,
 						className: "text-[12px] text-subtle underline hover:text-foreground",
 						children: "Load more"
 					}),
-					!complete && status === "loading" && records.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					(!isFork || mode === "transcript") && !complete && status === "loading" && records.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 						className: "text-[12px] text-subtle",
 						children: "Loading more…"
 					})
 				]
+			}),
+			isFork && !ended && entry.controls.includes("send") && onSend && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("form", {
+				className: "border-t border-subtle/15 p-3",
+				onSubmit: (event) => {
+					event.preventDefault();
+					if (!prompt.trim() || submitted.current !== null || inputState?.status === "pending") return;
+					submitted.current = prompt.trim();
+					onSend(submitted.current);
+				},
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("textarea", {
+					"aria-label": "Message the fork",
+					value: prompt,
+					onChange: (event) => setPrompt(event.target.value),
+					className: "w-full rounded border border-subtle/20 bg-background p-2 text-foreground"
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+					type: "submit",
+					disabled: !prompt.trim() || inputState?.status === "pending",
+					children: "Send to fork"
+				})]
+			}),
+			isFork && ended && onContinue && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+				type: "button",
+				onClick: onContinue,
+				className: "border-t border-subtle/15 p-3 text-foreground",
+				children: "Continue as session"
 			})
 		]
 	});
@@ -8127,7 +8447,7 @@ function SetupPanel({ onSetUp, disabled }) {
 * The full desktop layout over an `IWsSessionState`. `surface` is an optional label shown next to the
 * mark (e.g. "app").
 */
-function SessionSurface({ state, surface, personalUsageEnabled = false, onReconnect, pickFiles, getPathForFile, onOpenMemoryInEditor, appViewSandboxUrl }) {
+function SessionSurface({ state, surface, personalUsageEnabled = false, draftMode = "persistent", onReconnect, pickFiles, getPathForFile, onOpenMemoryInEditor, appViewSandboxUrl }) {
 	const [view, setView] = (0, react.useState)("chat");
 	const { identity } = useProductIdentity();
 	const appViewHost = (0, react.useMemo)(() => ({
@@ -8306,6 +8626,7 @@ function SessionSurface({ state, surface, personalUsageEnabled = false, onReconn
 										}),
 										setupRequired ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Composer, {
 											ref: composerRef,
+											draftMode,
 											catalog: state.commandCatalog ?? null,
 											status: state.sessionStatus ?? null,
 											connected: state.status === "connected",
@@ -8379,7 +8700,20 @@ function SessionSurface({ state, surface, personalUsageEnabled = false, onReconn
 							complete: state.executionDetailComplete,
 							onClose: () => state.closeExecutionDetail(),
 							onLoadMore: () => state.loadMoreExecutionDetail(),
-							onStop: openEntry ? () => stopExecutionEntry(openEntry) : void 0
+							onStop: openEntry ? () => stopExecutionEntry(openEntry) : void 0,
+							inputState: state.executionDetailInput,
+							mode: state.executionDetailMode,
+							unreadable: state.executionDetailUnreadable,
+							onShowEarlier: state.showEarlierExecutionDetail,
+							onShowLive: state.showLiveExecutionDetail,
+							onSend: openEntry ? (prompt) => state.send({
+								type: "send-background-task",
+								taskId: openEntry.sourceId,
+								input: { prompt }
+							}) : void 0,
+							onContinue: openEntry?.resumeSessionId ? () => {
+								if (openEntry.resumeSessionId) state.switchSession(openEntry.resumeSessionId);
+							} : void 0
 						})
 					]
 				})]
@@ -8582,6 +8916,7 @@ exports.SessionSurface = SessionSurface;
 exports.SettingsScreen = SettingsScreen;
 exports.applyPromptEvent = applyPromptEvent;
 exports.askResponse = askResponse;
+exports.createDesktopSessionClient = createDesktopSessionClient;
 exports.createWsSessionClient = createWsSessionClient;
 exports.describeUiIntentForGui = describeUiIntentForGui;
 exports.guiScreenForUiIntent = guiScreenForUiIntent;