skydive-cli 0.1.0-beta.45 → 0.1.0-beta.49

package/dist/js/bin.mjs

@@ -13,7 +13,7 @@ import fs from "node:fs";
 import zlib from "node:zlib";
 
 //#region package.json
-var version$1 = "0.1.0-beta.45";
+var version$1 = "0.1.0-beta.49";
 
 //#endregion
 //#region src/types.ts
@@ -2046,7 +2046,7 @@ const chatCommand = {
 			printError(`Unknown theme "${themeId}". Valid themes: ${themes.map((t) => t.id).join(", ")}`);
 			process.exit(1);
 		}
-		const { runChat } = await import("./boot-BQ8xC2R8.mjs");
+		const { runChat } = await import("./boot-h5qiGgfB.mjs");
 		await runChat({
 			appUrl,
 			sessionToken: session.value.sessionToken,

package/dist/js/{boot-BQ8xC2R8.mjs → boot-h5qiGgfB.mjs}

@@ -7,10 +7,11 @@ import open from "open";
 import { spawn } from "node:child_process";
 import { MarkdownRenderable, RenderableEvents, SyntaxStyle, createCliRenderer, decodePasteBytes, detectLinks } from "@opentui/core";
 import { createRoot, extend, useKeyboard, usePaste, useRenderer, useTerminalDimensions } from "@opentui/react";
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
 import { create } from "zustand";
 import { WebSocket } from "ws";
 import os, { homedir, platform, release, tmpdir } from "node:os";
+import { createConnection } from "node:net";
 import { appendFile, mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import { Fragment, jsx, jsxs } from "@opentui/react/jsx-runtime";
 import { fileURLToPath } from "node:url";
@@ -65,7 +66,6 @@ const useStore = create((set, get) => ({
 	chatTitle: null,
 	portal: initialPortalUi,
 	portalClient: null,
-	attention: null,
 	toast: null,
 	goTo: (screen) => set({
 		screen,
@@ -122,7 +122,6 @@ const useStore = create((set, get) => ({
 		...state.portal,
 		prompt
 	} })),
-	setAttention: (attention) => set({ attention }),
 	showToast: (input) => set({ toast: createToast(input) }),
 	dismissToast: (id) => set((state) => state.toast?.id === id ? { toast: null } : {})
 }));
@@ -649,19 +648,49 @@ function usePortal({ appUrl, sessionToken, shareMachine }) {
 }
 
 //#endregion
-//#region src/chat/tui/attention.ts
-/**
-* Whether a notification should fire. We only ping when the terminal is
-* blurred — the whole point is to catch the user who has tabbed away. While
-* focus is still `unknown` (no focus/blur reported yet, or a terminal that
-* doesn't report focus at all) we stay silent rather than interrupt someone
-* who is very likely watching.
-*/
+//#region src/chat/agent-host/context.tsx
+const noopAgentHost = {
+	transition() {},
+	setSession() {},
+	dispose() {}
+};
+const AgentHostContext = createContext(noopAgentHost);
+function useAgentHost() {
+	return useContext(AgentHostContext);
+}
+
+//#endregion
+//#region src/chat/agent-host/compose.ts
+/** Fans semantic events out to every detected adapter. */
+function composeAgentHost(adapters) {
+	let disposed = false;
+	return {
+		transition(transition) {
+			if (disposed) return;
+			for (const adapter of adapters) adapter.transition?.(transition);
+		},
+		setSession(sessionId) {
+			if (disposed) return;
+			for (const adapter of adapters) adapter.setSession?.(sessionId);
+		},
+		dispose() {
+			if (disposed) return;
+			disposed = true;
+			for (const adapter of adapters) adapter.dispose?.();
+		}
+	};
+}
+
+//#endregion
+//#region src/chat/agent-host/adapters/terminal-notifications.ts
 function shouldNotify({ enabled, focus }) {
 	return enabled && focus === "blurred";
 }
-/** The title and body for each attention event. */
-function attentionMessage(event, agentName) {
+function notificationMessage({ event, agentName, message }) {
+	if (message) return {
+		title: agentName,
+		message
+	};
 	switch (event) {
 		case "run-finished": return {
 			title: agentName,
@@ -674,12 +703,10 @@ function attentionMessage(event, agentName) {
 	}
 }
 /**
-* Tracks terminal focus and fires a desktop notification when the agent wants
-* the user's attention while the terminal is in the background. The renderer's
-* focus/blur events are the source of truth for whether the terminal is in the
-* foreground.
+* Sends focus-gated desktop notifications through OpenTUI. OpenTUI selects
+* OSC 9/99/777 for the detected terminal; this adapter owns that transport.
 */
-function createAttention({ renderer, enabled }) {
+function createTerminalNotificationsAdapter({ renderer, enabled }) {
 	let focus = "unknown";
 	const onFocus = () => {
 		focus = "focused";
@@ -690,12 +717,12 @@ function createAttention({ renderer, enabled }) {
 	renderer.on("focus", onFocus);
 	renderer.on("blur", onBlur);
 	return {
-		notify(event, agentName) {
-			if (!shouldNotify({
+		transition({ notification }) {
+			if (!notification || !shouldNotify({
 				enabled,
 				focus
 			})) return;
-			const { title, message } = attentionMessage(event, agentName);
+			const { title, message } = notificationMessage(notification);
 			try {
 				renderer.triggerNotification(message, title);
 			} catch (_error) {}
@@ -707,6 +734,181 @@ function createAttention({ renderer, enabled }) {
 	};
 }
 
+//#endregion
+//#region src/chat/agent-host/adapters/herdr/adapter.ts
+/** Maps one complete semantic transition to one herdr state report. */
+function createHerdrAdapter(herdr) {
+	let lastState;
+	return {
+		transition({ state, notification }) {
+			if (state === lastState && !notification) return;
+			lastState = state;
+			const message = state === "idle" && notification?.event === "run-finished" ? notification.message : void 0;
+			herdr.report(state, message);
+		},
+		setSession: herdr.setConversation,
+		dispose: herdr.dispose
+	};
+}
+
+//#endregion
+//#region src/chat/agent-host/adapters/herdr/client.ts
+/** How we identify ourselves to herdr. The agent label is what herdr shows
+* in its sidebar/agents pane; unknown labels pass through verbatim (herdr
+* normalizes only its built-in agents), so no herdr-side support is needed. */
+const SOURCE = "skydive-cli";
+const AGENT_LABEL = "skydive";
+/** Cap on how long a report may hold a socket open. herdr answers in
+* microseconds when healthy; past this we drop the report on the floor. */
+const REQUEST_TIMEOUT_MS = 500;
+/**
+* The herdr environment, if this process is running inside a herdr pane.
+* All three variables are injected by herdr into every pane it spawns;
+* anything missing means "not in herdr" and reporting stays off.
+*/
+function detectHerdrEnv(env = process.env) {
+	if (env.HERDR_ENV !== "1") return null;
+	const socketPath = env.HERDR_SOCKET_PATH;
+	const paneId = env.HERDR_PANE_ID;
+	if (!socketPath || !paneId) return null;
+	return {
+		socketPath,
+		paneId
+	};
+}
+function buildStateReport({ paneId, state, message, seq, conversationId }) {
+	return {
+		id: requestId(),
+		method: "pane.report_agent",
+		params: {
+			pane_id: paneId,
+			source: SOURCE,
+			agent: AGENT_LABEL,
+			state,
+			...message ? { message } : {},
+			seq,
+			...conversationId ? { agent_session_id: conversationId } : {}
+		}
+	};
+}
+function buildSessionReport({ paneId, seq, conversationId }) {
+	return {
+		id: requestId(),
+		method: "pane.report_agent_session",
+		params: {
+			pane_id: paneId,
+			source: SOURCE,
+			agent: AGENT_LABEL,
+			seq,
+			agent_session_id: conversationId
+		}
+	};
+}
+function buildRelease({ paneId, seq }) {
+	return {
+		id: requestId(),
+		method: "pane.release_agent",
+		params: {
+			pane_id: paneId,
+			source: SOURCE,
+			agent: AGENT_LABEL,
+			seq
+		}
+	};
+}
+let requestCounter = 0;
+function requestId() {
+	requestCounter += 1;
+	return `${SOURCE}:${Date.now()}:${requestCounter}`;
+}
+const socketSend = (socketPath, request) => {
+	try {
+		const socket = createConnection(socketPath);
+		socket.unref();
+		let done = false;
+		const finish = () => {
+			if (done) return;
+			done = true;
+			clearTimeout(timeout);
+			socket.destroy();
+		};
+		socket.on("error", finish);
+		socket.on("data", finish);
+		socket.on("end", finish);
+		socket.on("connect", () => {
+			socket.write(`${JSON.stringify(request)}\n`);
+		});
+		const timeout = setTimeout(finish, REQUEST_TIMEOUT_MS);
+		timeout.unref?.();
+	} catch (_error) {}
+};
+/**
+* The reporter, or null when not running inside herdr (the common case —
+* callers hold `HerdrReporter | null` and optional-chain every call).
+*/
+function createHerdrReporter({ env, send = socketSend } = { env: detectHerdrEnv() }) {
+	if (!env) return null;
+	const { socketPath, paneId } = env;
+	let seq = Date.now() * 1e3;
+	const nextSeq = () => {
+		seq += 1;
+		return seq;
+	};
+	let lastState;
+	let lastMessage;
+	let conversationId = null;
+	let disposed = false;
+	return {
+		report(state, message) {
+			if (disposed || state === lastState && message === lastMessage) return;
+			lastState = state;
+			lastMessage = message;
+			send(socketPath, buildStateReport({
+				paneId,
+				state,
+				message,
+				seq: nextSeq(),
+				conversationId
+			}));
+		},
+		setConversation(id) {
+			if (disposed || id === conversationId) return;
+			conversationId = id;
+			if (!id) return;
+			send(socketPath, buildSessionReport({
+				paneId,
+				seq: nextSeq(),
+				conversationId: id
+			}));
+		},
+		dispose() {
+			if (disposed) return;
+			disposed = true;
+			send(socketPath, buildRelease({
+				paneId,
+				seq: nextSeq()
+			}));
+		}
+	};
+}
+
+//#endregion
+//#region src/chat/agent-host/create.ts
+/**
+* The sole integration assembly point. Adding a host protocol means adding an
+* adapter and registering it here; chat lifecycle and generic host code stay
+* unchanged.
+*/
+function createAgentHost({ renderer, notifications }) {
+	const adapters = [createTerminalNotificationsAdapter({
+		renderer,
+		enabled: notifications
+	})];
+	const herdr = createHerdrReporter();
+	if (herdr) adapters.push(createHerdrAdapter(herdr));
+	return composeAgentHost(adapters);
+}
+
 //#endregion
 //#region src/chat/clipboard.ts
 /** Spawns a command with no stdin and collects its stdout. Resolves (never
@@ -3409,6 +3611,36 @@ function reconcileMaskedInput(previousValue, displayed) {
 	return previousValue.slice(0, kept) + displayed.slice(kept);
 }
 
+//#endregion
+//#region src/chat/notification-preview.ts
+const MAX_NOTIFICATION_PREVIEW_CHARS = 240;
+/**
+* Collects assistant `text-delta` chunks for one run and turns them into a
+* desktop-notification-sized preview. Reasoning, tool output, cards, errors,
+* and old transcript items are intentionally excluded.
+*/
+function createResponsePreview() {
+	let text = "";
+	let lastPartId;
+	return {
+		addChunk(chunk) {
+			if (chunk.type !== "text-delta") return;
+			const delta = typeof chunk.delta === "string" ? chunk.delta : typeof chunk.text === "string" ? chunk.text : "";
+			const partId = typeof chunk.id === "string" ? chunk.id : void 0;
+			if (text && partId && lastPartId && partId !== lastPartId) text += " ";
+			text += delta;
+			lastPartId = partId ?? lastPartId;
+		},
+		get() {
+			const normalized = text.replace(/\s+/g, " ").trim();
+			if (!normalized) return void 0;
+			const characters = Array.from(normalized);
+			if (characters.length <= MAX_NOTIFICATION_PREVIEW_CHARS) return normalized;
+			return `${characters.slice(0, MAX_NOTIFICATION_PREVIEW_CHARS - 1).join("")}…`;
+		}
+	};
+}
+
 //#endregion
 //#region src/chat/tui/spinner-frames.ts
 /** Braille dot-cycle frames — the classic smooth terminal spinner. */
@@ -4486,6 +4718,7 @@ function ChatScreen({ agent, conversation }) {
 	const grantPrompt = portal.prompt && portal.prompt.agentId === agent.id ? portal.prompt : null;
 	const isShared = portal.status !== "off";
 	const initialConversationId = isNewConversation(conversation) ? null : conversation.id;
+	const agentHost = useAgentHost();
 	const [conversationId, setConversationId] = useState(initialConversationId);
 	const [items, setItems] = useState([]);
 	const [historyLoaded, setHistoryLoaded] = useState(initialConversationId === null);
@@ -4509,6 +4742,17 @@ function ChatScreen({ agent, conversation }) {
 	inputRef.current = input;
 	const credPromptRef = useRef(credPrompt);
 	credPromptRef.current = credPrompt;
+	const hostState = grantPrompt || credPrompt ? "blocked" : run.kind === "idle" ? "idle" : "working";
+	useEffect(() => {
+		agentHost.transition({ state: hostState });
+	}, [agentHost, hostState]);
+	useEffect(() => () => {
+		agentHost.transition({ state: "idle" });
+		agentHost.setSession(null);
+	}, [agentHost]);
+	useEffect(() => {
+		agentHost.setSession(conversationId);
+	}, [agentHost, conversationId]);
 	const scrollRef = useRef(null);
 	const composerRef = useRef(null);
 	const composerBoxHeight = composerRows + 2;
@@ -4563,6 +4807,7 @@ function ChatScreen({ agent, conversation }) {
 	const attachToRun = useCallback((runId) => {
 		if (!rest) return;
 		const abort = new AbortController();
+		const responsePreview = createResponsePreview();
 		setRun({
 			kind: "streaming",
 			runId,
@@ -4573,6 +4818,7 @@ function ChatScreen({ agent, conversation }) {
 			signal: abort.signal,
 			onEvent: (event) => {
 				if (event.kind === "chunk") {
+					responsePreview.addChunk(event.chunk);
 					setItems((prev) => applyChunk(prev, event.chunk));
 					return;
 				}
@@ -4588,7 +4834,14 @@ function ChatScreen({ agent, conversation }) {
 					text: m.text
 				} : m));
 				setRun({ kind: "idle" });
-				useStore.getState().attention?.notify("run-finished", agent.name);
+				agentHost.transition({
+					state: "idle",
+					notification: {
+						event: "run-finished",
+						agentName: agent.name,
+						message: responsePreview.get()
+					}
+				});
 			}
 		}).catch((err) => {
 			if (abort.signal.aborted) return;
@@ -4599,7 +4852,11 @@ function ChatScreen({ agent, conversation }) {
 			}]);
 			setRun({ kind: "idle" });
 		});
-	}, [rest, agent.name]);
+	}, [
+		rest,
+		agent.name,
+		agentHost
+	]);
 	useEffect(() => {
 		if (!rest || !conversationId) return;
 		if (initialConversationId !== null) return;
@@ -5062,7 +5319,13 @@ function ChatScreen({ agent, conversation }) {
 			agentId: agent.id,
 			agentName: agent.name
 		});
-		useStore.getState().attention?.notify("needs-input", agent.name);
+		agentHost.transition({
+			state: "blocked",
+			notification: {
+				event: "needs-input",
+				agentName: agent.name
+			}
+		});
 	}, [
 		portalClient,
 		portal.status,
@@ -5070,7 +5333,8 @@ function ChatScreen({ agent, conversation }) {
 		portal.prompt,
 		agent.id,
 		agent.name,
-		setPortalPrompt
+		setPortalPrompt,
+		agentHost
 	]);
 	useKeyboard((key) => {
 		if (modelPickerOpen || themePickerOpen || helpOpen) return;
@@ -5169,6 +5433,7 @@ function ChatScreen({ agent, conversation }) {
 			}
 			if (ctrlCArmed) {
 				portalClient?.dispose();
+				agentHost.dispose();
 				renderer.destroy();
 				return;
 			}
@@ -5515,28 +5780,20 @@ function App({ appUrl, sessionToken, shareMachine, promptHistoryPath, notificati
 	const rest = useStore((s) => s.rest);
 	const goTo = useStore((s) => s.goTo);
 	const setClients = useStore((s) => s.setClients);
-	const setAttention = useStore((s) => s.setAttention);
 	const showToast = useStore((s) => s.showToast);
+	const [agentHost] = useState(() => createAgentHost({
+		renderer,
+		notifications
+	}));
 	usePortal({
 		appUrl,
 		sessionToken,
 		shareMachine
 	});
 	useEffect(() => {
-		const attention = createAttention({
-			renderer,
-			enabled: notifications
-		});
-		setAttention(attention);
-		return () => {
-			attention.dispose();
-			setAttention(null);
-		};
-	}, [
-		renderer,
-		notifications,
-		setAttention
-	]);
+		agentHost.transition({ state: "idle" });
+		return () => agentHost.dispose();
+	}, [agentHost]);
 	useEffect(() => {
 		const selectionCopy = createSelectionCopy({
 			renderer,
@@ -5615,37 +5872,40 @@ function App({ appUrl, sessionToken, shareMachine, promptHistoryPath, notificati
 	useKeyboard((key) => {
 		if (key.name === "c" && key.ctrl && screen.kind !== "chat") {
 			useStore.getState().portalClient?.dispose();
-			useStore.getState().attention?.dispose();
+			agentHost.dispose();
 			renderer.destroy();
 		}
 	});
-	return /* @__PURE__ */ jsxs("box", {
-		style: {
-			flexDirection: "column",
-			flexGrow: 1,
-			backgroundColor: theme.background
-		},
-		children: [
-			/* @__PURE__ */ jsx(StatusBar, {}),
-			/* @__PURE__ */ jsx(ToastView, {}),
-			/* @__PURE__ */ jsxs("box", {
-				style: {
-					flexGrow: 1,
-					padding: 1
-				},
-				children: [
-					screen.kind === "splash" && /* @__PURE__ */ jsx(Splash, {}),
-					screen.kind === "error" && /* @__PURE__ */ jsx(ErrorScreen, { message: screen.message }),
-					screen.kind === "agent-picker" && rest && /* @__PURE__ */ jsx(AgentPickerScreen, {}),
-					screen.kind === "agent-create" && rest && /* @__PURE__ */ jsx(AgentCreateScreen, {}),
-					screen.kind === "conversation-picker" && rest && /* @__PURE__ */ jsx(ConversationPickerScreen, { agent: screen.agent }),
-					screen.kind === "chat" && rest && /* @__PURE__ */ jsx(ChatScreen, {
-						agent: screen.agent,
-						conversation: screen.conversation
-					})
-				]
-			})
-		]
+	return /* @__PURE__ */ jsx(AgentHostContext.Provider, {
+		value: agentHost,
+		children: /* @__PURE__ */ jsxs("box", {
+			style: {
+				flexDirection: "column",
+				flexGrow: 1,
+				backgroundColor: theme.background
+			},
+			children: [
+				/* @__PURE__ */ jsx(StatusBar, {}),
+				/* @__PURE__ */ jsx(ToastView, {}),
+				/* @__PURE__ */ jsxs("box", {
+					style: {
+						flexGrow: 1,
+						padding: 1
+					},
+					children: [
+						screen.kind === "splash" && /* @__PURE__ */ jsx(Splash, {}),
+						screen.kind === "error" && /* @__PURE__ */ jsx(ErrorScreen, { message: screen.message }),
+						screen.kind === "agent-picker" && rest && /* @__PURE__ */ jsx(AgentPickerScreen, {}),
+						screen.kind === "agent-create" && rest && /* @__PURE__ */ jsx(AgentCreateScreen, {}),
+						screen.kind === "conversation-picker" && rest && /* @__PURE__ */ jsx(ConversationPickerScreen, { agent: screen.agent }),
+						screen.kind === "chat" && rest && /* @__PURE__ */ jsx(ChatScreen, {
+							agent: screen.agent,
+							conversation: screen.conversation
+						})
+					]
+				})
+			]
+		})
 	});
 }
 function Splash() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skydive-cli",
-  "version": "0.1.0-beta.45",
+  "version": "0.1.0-beta.49",
   "description": "Skydive CLI — manage AI agents from the command line",
   "homepage": "https://skydive.com",
   "license": "MIT",