zidane-ui 9.0.4 → 9.1.3

package/dist/chat/sidebar/session-menu.js

@@ -1,4 +1,5 @@
 import { useSidebarHost, useSidebarNotice } from "./SidebarHostProvider.js";
+import { useLinkRouter } from "../../extensions/links.js";
 import { useConfirm } from "../../app/useConfirm.js";
 import { useSidebarLabels } from "./useSidebarLabels.js";
 import { deleteSessionPrompt, runsInRemoteSandbox } from "../headless/sidebar/environment.js";
@@ -171,16 +172,21 @@ function useEnvironmentCommands() {
 	const environment = useSidebarHost().environment;
 	const notify = useSidebarNotice();
 	const labels = useSidebarLabels();
+	const links = useLinkRouter();
 	const run = useCallback((sessionId, actionId, label) => {
 		if (!environment) return;
 		environment.run(sessionId, actionId).then((result) => {
-			if (result.url) window.open(result.url, "_blank", "noopener");
+			if (result.url) links.open(result.url, {
+				source: "other",
+				sessionId
+			});
 			else notify(result.message);
 		}).catch((err) => notify(labels.environmentActionFailed(label, messageOf(err))));
 	}, [
 		environment,
 		notify,
-		labels
+		labels,
+		links
 	]);
 	const retry = useCallback((sessionId) => {
 		environment?.retry(sessionId).catch((err) => notify(labels.retryEnvironmentFailed(messageOf(err))));

package/dist/chat/sidebar/sidebar-live.d.ts

@@ -2,6 +2,7 @@ import { HostView } from "../headless/hosts.js";
 import { SessionPresence } from "../../machines/headless/presence.js";
 import { SessionBadgesStore } from "../headless/sidebar/badges.js";
 import { SessionActivityStore } from "../headless/sidebar/activity.js";
+import { RunEstimatesStore } from "../headless/sidebar/estimates.js";
 import { SessionDotState } from "../StatusDot.js";
 import { RowProject } from "./RowChips.js";
 import { NamedExoticComponent } from "react";
@@ -40,6 +41,8 @@ interface SidebarLiveOptions {
   useHost?: (hostId: string | undefined) => HostView | undefined;
   /** What each session's run is doing (`createSessionActivity`). */
   activity: SessionActivityStore;
+  /** How long each session's run has left (`createRunEstimates`): shown instead of the elapsed time while known. Absent: the elapsed time. */
+  estimates?: RunEstimatesStore;
   /** Each session's artifact badges (`createSessionBadges`). */
   badges: SessionBadgesStore;
   /** Opens a badge's panel (`badge.panel`, else the app's default) focused on it. Absent: a badge click only selects the row. */
@@ -72,7 +75,15 @@ interface SidebarRowArtifactsProps {
   project?: RowProject;
   /** Where the session runs when not here, after the project (not an artifact either). */
   environment?: SessionEnvironmentSummary;
+  /**
+   * Where a badge's card opens: beside the row, top-aligned with it (`'beside'`, the sidebar: never over the
+   * rows below), or under the badge itself (`'below'`, a wide list where the row's edge is far away).
+   * @default 'beside'
+   */
+  cards?: BadgeCardPlacement;
 }
+/** Where a row badge's card opens ({@link SidebarRowArtifactsProps.cards}). */
+type BadgeCardPlacement = 'beside' | 'below';
 /** The live row parts {@link createSidebarLive} returns. */
 interface SidebarLive {
   /** A session's dot state (a hook). */
@@ -95,4 +106,4 @@ interface SidebarLive {
  */
 declare function createSidebarLive(options: SidebarLiveOptions): SidebarLive;
 //#endregion
-export { ARRIVAL_MS, SidebarBadgeFocus, SidebarLive, SidebarLiveOptions, SidebarRowArtifactsProps, SidebarRowMetaProps, createSidebarLive, useArrival };
+export { ARRIVAL_MS, BadgeCardPlacement, SidebarBadgeFocus, SidebarLive, SidebarLiveOptions, SidebarRowArtifactsProps, SidebarRowMetaProps, createSidebarLive, useArrival };

package/dist/chat/sidebar/sidebar-live.js

@@ -4,11 +4,14 @@ import { syncShimmer } from "../../motion/shimmer.js";
 import { HeldWidth } from "../../motion/size.js";
 import { Crossfade, useCadencedValue } from "../../motion/swap.js";
 import { useMinuteTick } from "../../hooks/useMinuteTick.js";
-import { HostBadge } from "../HostBadge.js";
-import { formatElapsedShort, relativeTime } from "../headless/session-list.js";
-import { StatusDot } from "../StatusDot.js";
+import { useLinkRouter } from "../../extensions/links.js";
+import { useChatLabels } from "../useChatLabels.js";
 import { useBadgeMenu } from "../transcript/BadgeMenu.js";
 import { badgeColorStyle, badgeToneClass } from "../../session/ArtifactRowChips.js";
+import { formatElapsedShort, relativeTime } from "../headless/session-list.js";
+import { HostBadge } from "../HostBadge.js";
+import { RunEstimateChip, useRunEstimate } from "../RunEstimateChip.js";
+import { StatusDot } from "../StatusDot.js";
 import { useSidebarLabels } from "./useSidebarLabels.js";
 import { activityLabel } from "../headless/sidebar/activity.js";
 import { deriveDotState } from "../headless/sidebar/dot-state.js";
@@ -184,16 +187,20 @@ function CardRow({ row, onOpen, onMenu }) {
 function rowOf(trigger) {
 	return trigger.closest("[data-session-id]");
 }
-function SessionBadge({ entry, grewAt, onOpen: open, onMenu: menu }) {
+function SessionBadge({ entry, grewAt, cards, onOpen: open, onMenu: menu }) {
 	const onMenu = menu ? (event, row) => menu(event, entry, row) : void 0;
 	const fresh = useArrival(grewAt);
+	const links = useLinkRouter();
 	const { badge } = entry;
 	const testId = `row-badge-${entry.kind}`;
 	const onOpen = (event, target) => {
 		event.stopPropagation();
 		if ((event.metaKey || event.ctrlKey) && target.href) {
 			event.preventDefault();
-			window.open(target.href, "_blank", "noopener");
+			links.open(target.href, {
+				source: "badge",
+				event
+			});
 			return;
 		}
 		event.preventDefault();
@@ -211,9 +218,9 @@ function SessionBadge({ entry, grewAt, onOpen: open, onMenu: menu }) {
 		ariaLabel: card.title,
 		testId: `${testId}-card`,
 		width: 340,
-		side: "right",
+		side: cards === "below" ? "bottom" : "right",
 		align: "start",
-		anchorTo: rowOf,
+		...cards === "below" ? {} : { anchorTo: rowOf },
 		trigger: (props) => /* @__PURE__ */ jsx(BadgeChip, {
 			badge,
 			fresh,
@@ -237,7 +244,7 @@ function SessionBadge({ entry, grewAt, onOpen: open, onMenu: menu }) {
 * The badges' line, mounted when the session has some. It grows open when it mounts for an arrival (the
 * first badge coming in while the row is on screen); a session that already had some shows them at once.
 */
-function BadgeLine({ entry, host, project, environment, fresh, onOpen, onMenu }) {
+function BadgeLine({ entry, host, project, environment, fresh, cards, onOpen, onMenu }) {
 	const [growIn] = useState(fresh);
 	return /* @__PURE__ */ jsx("div", {
 		className: "zg-row-extra",
@@ -255,6 +262,7 @@ function BadgeLine({ entry, host, project, environment, fresh, onOpen, onMenu })
 				entry?.badges.map((b) => /* @__PURE__ */ jsx(SessionBadge, {
 					entry: b,
 					grewAt: entry.grewAt[b.kind] ?? 0,
+					cards,
 					onOpen,
 					...onMenu ? { onMenu } : {}
 				}, b.kind))
@@ -269,7 +277,7 @@ function BadgeLine({ entry, host, project, environment, fresh, onOpen, onMenu })
 * @param options - The app's hooks and stores.
 */
 function createSidebarLive(options) {
-	const { useRunning, useRunElapsedSec, activity: activityStore, badges: badgesStore, openBadge } = options;
+	const { useRunning, useRunElapsedSec, activity: activityStore, badges: badgesStore, openBadge, estimates: estimatesStore } = options;
 	const usePending = options.usePending ?? never;
 	const useNotification = options.useNotification ?? none;
 	const usePresence = options.usePresence ?? none;
@@ -307,15 +315,45 @@ function createSidebarLive(options) {
 			className: "zg-meta shrink-0 text-[var(--zg-text-subtle)]"
 		});
 	}
-	/** The trailing slot as it was before run details: an accent dot and "Working", else the relative time. */
-	function PlainMeta({ running, updatedAt }) {
+	/** The session's own run's estimate, while the host estimated it (`undefined` without an estimates store). */
+	function useSessionEstimate(sessionId) {
+		return useRunEstimate(estimatesStore ? sessionId : void 0, void 0, estimatesStore);
+	}
+	/** The run's time: what it has left while the host estimated it, else how long it has gone. */
+	function RunTime({ sessionId }) {
+		const estimate = useSessionEstimate(sessionId);
+		return estimate ? /* @__PURE__ */ jsx(EstimateChip, { estimate }) : /* @__PURE__ */ jsx(Elapsed, { sessionId });
+	}
+	/**
+	* The estimate chip. Its tooltip says how long the run has gone, read from the run's start when the
+	* tooltip shows: the row renders when the chip's text changes, not every second.
+	*/
+	function EstimateChip({ estimate }) {
+		const labels = useChatLabels();
+		const { startedAt } = estimate;
+		const detail = useCallback(() => labels.runningFor(formatElapsedShort(Math.max(0, Math.floor((Date.now() - startedAt) / 1e3)))), [labels, startedAt]);
+		return /* @__PURE__ */ jsx(RunEstimateChip, {
+			estimate,
+			detail
+		});
+	}
+	/**
+	* The trailing slot as it was before run details: an accent dot and "Working" (and the time left, while
+	* the host estimated the run), else the relative time.
+	*/
+	function PlainMeta({ sessionId, running, updatedAt }) {
 		const labels = useSidebarLabels();
+		const estimate = useSessionEstimate(sessionId);
 		return running ? /* @__PURE__ */ jsxs("span", {
 			className: "zg-row-meta shrink-0 inline-flex items-baseline gap-1 text-zg-meta leading-4 font-medium text-[var(--zg-accent)]",
-			children: [/* @__PURE__ */ jsx("span", {
-				"aria-hidden": true,
-				className: "self-center w-1.5 h-1.5 rounded-full bg-[var(--zg-accent)]"
-			}), labels.rowWorking]
+			children: [
+				/* @__PURE__ */ jsx("span", {
+					"aria-hidden": true,
+					className: "self-center w-1.5 h-1.5 rounded-full bg-[var(--zg-accent)]"
+				}),
+				labels.rowWorking,
+				estimate && /* @__PURE__ */ jsx(EstimateChip, { estimate })
+			]
 		}) : /* @__PURE__ */ jsx(Ago, {
 			at: updatedAt,
 			className: "zg-row-meta zg-meta shrink-0 leading-4"
@@ -359,7 +397,7 @@ function createSidebarLive(options) {
 								"data-testid": "row-state",
 								children: shown.text
 							})
-						}), running && /* @__PURE__ */ jsx(Elapsed, { sessionId })]
+						}), running && /* @__PURE__ */ jsx(RunTime, { sessionId })]
 					}) : /* @__PURE__ */ jsx(Ago, {
 						at: updatedAt,
 						className: "zg-meta leading-4"
@@ -380,6 +418,7 @@ function createSidebarLive(options) {
 			running,
 			updatedAt
 		}) : /* @__PURE__ */ jsx(PlainMeta, {
+			sessionId,
 			running,
 			updatedAt
 		});
@@ -388,7 +427,7 @@ function createSidebarLive(options) {
 	* Line 2: the session's badges (commits, pull requests, extension kinds), when it has some. A badge click
 	* selects the chat (`onSelect`) and opens the badge's panel focused on it.
 	*/
-	function RowArtifactsInner({ sessionId, enabled, onArrival, onSelect, cwd, hostId, project, environment }) {
+	function RowArtifactsInner({ sessionId, enabled, onArrival, onSelect, cwd, hostId, project, environment, cards = "beside" }) {
 		const openMenu = useBadgeMenu();
 		const host = useHost(hostId);
 		const server = hostId && host?.kind === "server" ? host : void 0;
@@ -416,6 +455,7 @@ function createSidebarLive(options) {
 			project,
 			environment,
 			fresh,
+			cards,
 			onOpen,
 			...onMenu ? { onMenu } : {}
 		});

package/dist/chat/sidebar/useAgentNames.d.ts

@@ -0,0 +1,8 @@
+//#region src/chat/sidebar/useAgentNames.d.ts
+/**
+ * The agent catalog's names by agent id (`ComposerHost.agents`, the profiles offered without a folder):
+ * what the sidebar's agent grouping and filter show. Empty without a composer host or its `agents`.
+ */
+declare function useAgentNames(): Readonly<Record<string, string>>;
+//#endregion
+export { useAgentNames };

package/dist/chat/sidebar/useAgentNames.js

@@ -0,0 +1,13 @@
+import { useAgentProfiles } from "../composer/use-agent-profiles.js";
+import { useMemo } from "react";
+//#region src/chat/sidebar/useAgentNames.ts
+/**
+* The agent catalog's names by agent id (`ComposerHost.agents`, the profiles offered without a folder):
+* what the sidebar's agent grouping and filter show. Empty without a composer host or its `agents`.
+*/
+function useAgentNames() {
+	const profiles = useAgentProfiles("");
+	return useMemo(() => Object.fromEntries(profiles.map((p) => [p.id, p.label])), [profiles]);
+}
+//#endregion
+export { useAgentNames };

package/dist/chat/sidebar/useSaveViewAsSpace.d.ts

@@ -0,0 +1,13 @@
+import { Space } from "zidane/chat/pure";
+//#region src/chat/sidebar/useSaveViewAsSpace.d.ts
+/**
+ * The filter menu's `onSaveView` over a directory's `saveViewAsSpace`: saves the shown view under
+ * the next free saved-view name; a failure (an invalid query, a settings write that failed) shows
+ * `labels.saveViewFailed`. `undefined` when `save` is.
+ *
+ * @param save - `SessionDirectory.saveViewAsSpace` (or the app's wrapper of it).
+ * @param spaces - Every space (`SessionDirectoryState.spaces`): the names already taken.
+ */
+declare function useSaveViewAsSpace(save: ((name: string) => Promise<unknown>) | undefined, spaces: readonly Pick<Space, 'name'>[]): (() => void) | undefined;
+//#endregion
+export { useSaveViewAsSpace };

package/dist/chat/sidebar/useSaveViewAsSpace.js

@@ -0,0 +1,44 @@
+import { useSidebarNotice } from "./SidebarHostProvider.js";
+import { useSidebarLabels } from "./useSidebarLabels.js";
+import { nextSavedViewName } from "../headless/sidebar/query.js";
+import { useCallback, useRef } from "react";
+//#region src/chat/sidebar/useSaveViewAsSpace.ts
+/**
+* "Save view as space" for the filter menu: the kit names the new space (the
+* first free `labels.savedViewName`, Settings › Spaces renames it) and tells
+* the user when the save fails (`labels.saveViewFailed` through the nearest
+* `SidebarHostProvider`'s `notify`), so every app saves views the same way.
+*/
+const messageOf = (err) => err instanceof Error ? err.message : String(err);
+/**
+* The filter menu's `onSaveView` over a directory's `saveViewAsSpace`: saves the shown view under
+* the next free saved-view name; a failure (an invalid query, a settings write that failed) shows
+* `labels.saveViewFailed`. `undefined` when `save` is.
+*
+* @param save - `SessionDirectory.saveViewAsSpace` (or the app's wrapper of it).
+* @param spaces - Every space (`SessionDirectoryState.spaces`): the names already taken.
+*/
+function useSaveViewAsSpace(save, spaces) {
+	const labels = useSidebarLabels();
+	const notify = useSidebarNotice();
+	const latest = useRef({
+		save,
+		spaces,
+		labels,
+		notify
+	});
+	latest.current = {
+		save,
+		spaces,
+		labels,
+		notify
+	};
+	const onSave = useCallback(() => {
+		const { save: run, spaces: all, labels: words, notify: tell } = latest.current;
+		if (!run) return;
+		run(nextSavedViewName(all, words.savedViewName)).catch((err) => tell(words.saveViewFailed(messageOf(err))));
+	}, []);
+	return save ? onSave : void 0;
+}
+//#endregion
+export { useSaveViewAsSpace };

package/dist/chat/sidebar/useSessionDirectoryView.d.ts

@@ -1,9 +1,10 @@
 import { SidebarListSession, SidebarView } from "../headless/sidebar/types.js";
+import { SidebarQueryLayer } from "../headless/sidebar/query.js";
 import { SessionDirectory, SessionDirectoryState, SessionRef } from "../headless/sidebar/directory.js";
 //#region src/chat/sidebar/useSessionDirectoryView.d.ts
 /** The directory as the sidebar reads it: its state plus the shown space's filtered list and view. */
 interface SessionDirectoryView<S extends SidebarListSession> extends SessionDirectoryState<S> {
-  /** The sessions the list shows (space, project and activity filters applied). */
+  /** The sessions the list shows (space, project, activity, agent and contributed filters applied). */
   sessions: readonly S[];
   /**
    * The space the list shows: `activeSpace`, in the same render. Deferring it
@@ -24,6 +25,8 @@ interface SessionDirectoryView<S extends SidebarListSession> extends SessionDire
   availableProjects: string[];
   /** How a reference names each session. */
   sessionRefs: ReadonlyMap<string, SessionRef>;
+  /** The shown space's query layer: pass it to `SessionSidebar` and `SidebarFilterMenu`. */
+  query: SidebarQueryLayer;
 }
 /**
  * Subscribe to a session directory.

package/dist/chat/sidebar/useSessionDirectoryView.js

@@ -1,8 +1,8 @@
 import { useReadable } from "../headless/store.js";
 import { DEFAULT_SIDEBAR_VIEW } from "../headless/sidebar/view.js";
+import { filtersForSpace, itemsForSpace, resolveGrouping, resolveSort, spaceMembership, viewFilterOf } from "../headless/sidebar/query.js";
 import { availableProjectsOf, filterDirectorySessions, sessionRefsOf } from "../headless/sidebar/directory.js";
 import { useEffect, useMemo } from "react";
-import { sessionSpaceFilter } from "zidane/chat/pure";
 //#region src/chat/sidebar/useSessionDirectoryView.ts
 /**
 * Subscribe to a session directory.
@@ -13,18 +13,18 @@ import { sessionSpaceFilter } from "zidane/chat/pure";
 function useSessionDirectoryView(directory, unfiltered = false) {
 	const base = useReadable(directory.state);
 	const listSpaceId = base.activeSpace.id;
-	const { archive, project, activity, groupBy, sortBy } = useReadable(directory.views.views)[listSpaceId] ?? DEFAULT_SIDEBAR_VIEW;
+	const view = useReadable(directory.views.views)[listSpaceId] ?? DEFAULT_SIDEBAR_VIEW;
+	const { archive, project, activity, groupBy, sortBy } = view;
+	const { activeSpace, spaces, spacesOn, contributions } = base;
 	useEffect(() => directory.setArchive(archive), [directory, archive]);
 	const raw = base.allSessions;
-	const inSpace = useMemo(() => sessionSpaceFilter({
-		spaces: base.spacesOn,
-		spaceList: base.spaces
-	}, listSpaceId), [
-		base.spacesOn,
-		base.spaces,
-		listSpaceId
+	const inSpace = useMemo(() => spaceMembership(activeSpace, spaces, spacesOn), [
+		activeSpace,
+		spaces,
+		spacesOn
 	]);
-	const sessions = useMemo(() => unfiltered ? raw : filterDirectorySessions(raw, {
+	const filters = useMemo(() => filtersForSpace(contributions.filters, listSpaceId), [contributions.filters, listSpaceId]);
+	const spaceSessions = useMemo(() => unfiltered ? raw : filterDirectorySessions(raw, {
 		inSpace,
 		project,
 		activity
@@ -35,8 +35,40 @@ function useSessionDirectoryView(directory, unfiltered = false) {
 		project,
 		activity
 	]);
+	const viewFilter = useMemo(() => unfiltered ? null : viewFilterOf({
+		...view,
+		agent: view.agent ?? null
+	}, filters), [
+		unfiltered,
+		view,
+		filters
+	]);
+	const sessions = useMemo(() => viewFilter ? spaceSessions.filter(viewFilter) : spaceSessions, [spaceSessions, viewFilter]);
 	const availableProjects = useMemo(() => availableProjectsOf(raw), [raw]);
 	const sessionRefs = useMemo(() => sessionRefsOf(raw), [raw]);
+	const agents = useMemo(() => {
+		const ids = /* @__PURE__ */ new Set();
+		for (const s of spaceSessions) if (s.agentId) ids.add(s.agentId);
+		return [...ids].sort();
+	}, [spaceSessions]);
+	const query = useMemo(() => ({
+		space: activeSpace,
+		view,
+		grouping: resolveGrouping(view, activeSpace, contributions.groups),
+		sort: resolveSort(view, activeSpace, contributions.sorts),
+		filters,
+		sorts: contributions.sorts,
+		groups: contributions.groups,
+		decorations: contributions.decorations,
+		items: itemsForSpace(contributions.items, activeSpace),
+		agents
+	}), [
+		activeSpace,
+		view,
+		contributions,
+		filters,
+		agents
+	]);
 	return useMemo(() => ({
 		...base,
 		sessions,
@@ -47,7 +79,8 @@ function useSessionDirectoryView(directory, unfiltered = false) {
 		groupBy,
 		sortBy,
 		availableProjects,
-		sessionRefs
+		sessionRefs,
+		query
 	}), [
 		base,
 		sessions,
@@ -58,7 +91,8 @@ function useSessionDirectoryView(directory, unfiltered = false) {
 		groupBy,
 		sortBy,
 		availableProjects,
-		sessionRefs
+		sessionRefs,
+		query
 	]);
 }
 //#endregion

package/dist/chat/sidebar/useSidebarKeyboardNav.js

@@ -3,7 +3,9 @@ import { useCallback, useEffect, useRef } from "react";
 //#region src/chat/sidebar/useSidebarKeyboardNav.ts
 /**
 * The sidebar's keyboard: ↑ / ↓ walk the chats in the order the list shows
-* them, ⌘N / Ctrl+N starts a new one.
+* them, ⌘N / Ctrl+N starts a new one. Only sessions: an extension's item row
+* is skipped, since the walk opens what it lands on and an item's target may
+* run an extension command (Tab reaches the item instead).
 *
 * A tentative cursor moves at CSS speed: each press sets
 * `data-tentative-active` on the row (`[data-session-id]`) straight in the

package/dist/chat/testing/composer.contract.d.ts

@@ -1,11 +1,11 @@
 import { ComposerModelEntry, ModelPickRef } from "../headless/composer/models.js";
 import { RunMeterSignal } from "../headless/composer/run-meter.js";
-import { ComposerAgentProfile, ComposerCacheImpact, ComposerContextBreakdown, ComposerContextStatus, ComposerCostStatus, ComposerHudSnapshot, ComposerPrefsState, ComposerRunProgress } from "../headless/composer/host-chrome.js";
+import { ComposerAgentProfile, ComposerCacheImpact, ComposerContextBreakdown, ComposerContextStatus, ComposerCostStatus, ComposerPrefsState, ComposerRunProgress } from "../headless/composer/host-chrome.js";
 import { CommandArgSuggestionSummary, CommandSummary, ComposerHost, ComposerPromptSuggestion, ComposerSharedGhost, FileEntry, PromptAttachment, SharedDraft, SkillConfig } from "../headless/composer/host.js";
 import { ChatReferenceEntry } from "zidane/chat/pure";
 //#region src/chat/testing/composer.contract.d.ts
 /** An optional `ComposerHost` member, by its path. */
-type ComposerHostCapability = 'drafts' | 'drafts.setAttachments' | 'drafts.onChanged' | 'drafts.onAttachmentsChanged' | 'completions' | 'completions.files' | 'completions.commands' | 'completions.commandArgs' | 'completions.chats' | 'completions.watchSkills' | 'completions.watchExtensionProviders' | 'completions.extensionItems' | 'completions.submit' | 'completions.locationOf' | 'folders' | 'autocomplete' | 'autocomplete.onShared' | 'suggestions' | 'suggestions.onStale' | 'controls' | 'controls.setModel' | 'controls.setEffort' | 'controls.setModelOptions' | 'controls.setAgent' | 'controls.cacheImpact' | 'models' | 'models.images' | 'models.providers' | 'agents' | 'agents.onChanged' | 'prefs' | 'pickerPrefs' | 'context' | 'context.status' | 'context.breakdown' | 'context.cost' | 'runs' | 'runs.progress' | 'runs.noteSeen' | 'runs.noteProgress' | 'runs.settleCost' | 'hud' | 'hud.get';
+type ComposerHostCapability = 'drafts' | 'drafts.setAttachments' | 'drafts.onChanged' | 'drafts.onAttachmentsChanged' | 'completions' | 'completions.files' | 'completions.commands' | 'completions.commandArgs' | 'completions.chats' | 'completions.watchSkills' | 'completions.watchExtensionProviders' | 'completions.extensionItems' | 'completions.submit' | 'completions.locationOf' | 'folders' | 'autocomplete' | 'autocomplete.onShared' | 'suggestions' | 'suggestions.onStale' | 'controls' | 'controls.setModel' | 'controls.setEffort' | 'controls.setModelOptions' | 'controls.setAgent' | 'controls.cacheImpact' | 'models' | 'models.images' | 'models.providers' | 'agents' | 'agents.onChanged' | 'prefs' | 'pickerPrefs' | 'context' | 'context.status' | 'context.breakdown' | 'context.cost' | 'runs' | 'runs.progress' | 'runs.noteSeen' | 'runs.noteProgress' | 'runs.settleCost';
 /** A session's picks as the backend holds them: what the controls write. */
 interface ComposerContractSession {
   /** The model chain, primary first. */
@@ -53,8 +53,6 @@ interface ComposerHostContractBackend {
   }>;
   /** Each session's run in progress. */
   runProgress: Record<string, ComposerRunProgress>;
-  /** What extensions show, per session. */
-  hud: ComposerHudSnapshot;
 }
 /** What the other windows (and the agent) do, announced as the backend announces it. */
 interface ComposerHostContractControl {
@@ -70,8 +68,6 @@ interface ComposerHostContractControl {
   startRun(sessionId: string): void;
   /** The backend streams a run signal. Needed for `runs`. */
   runSignal?(signal: RunMeterSignal): void;
-  /** The backend pushes a new extensions snapshot. Needed for `hud`. */
-  pushHud?(snapshot: ComposerHudSnapshot): void;
 }
 /** A host built over a backend, the backend's control, and how to tear them down. */
 interface ComposerHostHarness {

package/dist/chat/testing/composer.contract.js

@@ -48,9 +48,7 @@ const CAPABILITIES = [
 	"runs.progress",
 	"runs.noteSeen",
 	"runs.noteProgress",
-	"runs.settleCost",
-	"hud",
-	"hud.get"
+	"runs.settleCost"
 ];
 function contractBackend() {
 	return {
@@ -140,15 +138,7 @@ function contractBackend() {
 		runProgress: { "s-1": {
 			startedAt: 1e3,
 			outputTokens: 40
-		} },
-		hud: {
-			sessions: { "s-1": [{
-				extension: "goal",
-				text: "Goal 2/10",
-				loader: false
-			}] },
-			badges: {}
-		}
+		} }
 	};
 }
 /** The first settled value of a resource. */
@@ -428,25 +418,6 @@ function describeComposerHostContract(name, makeHarness, capabilities) {
 				outputTokens: 40
 			});
 		});
-		it.skipIf(!has("hud"))("hears what extensions show with a session", async () => {
-			const { host, control } = await setup();
-			const seen = [];
-			const off = host.hud.onState((snapshot) => seen.push(snapshot.sessions["s-1"]?.[0]?.text ?? ""));
-			control.pushHud({
-				sessions: { "s-1": [{
-					extension: "goal",
-					text: "Goal 3/10",
-					loader: false
-				}] },
-				badges: {}
-			});
-			await waitFor(() => expect(seen).toEqual(["Goal 3/10"]));
-			off();
-		});
-		it.skipIf(!has("hud.get"))("reads what extensions show now", async () => {
-			const { host } = await setup();
-			expect((await host.hud.get())?.sessions["s-1"]?.[0]?.text).toBe("Goal 2/10");
-		});
 	});
 }
 //#endregion

package/dist/chat/testing/contract.d.ts

@@ -6,7 +6,7 @@ import { BadgeActionEffect, BadgeMenuItem, ExtensionReferenceView, ReferenceProv
 import { InteractionRequest } from "zidane/chat";
 //#region src/chat/testing/contract.d.ts
 /** An optional `ChatHost` member, by its path. */
-type ChatHostCapability = 'sessions' | 'sessions.create' | 'sessions.rename' | 'sessions.setArchived' | 'sessions.setFavorite' | 'sessions.remove' | 'sessions.query' | 'sessions.setSpace' | 'sessions.search' | 'sessions.onChanged' | 'sessions.views' | 'sessions.main' | 'send' | 'interrupt' | 'shell' | 'providerReady' | 'steer' | 'followUp' | 'interactions' | 'interactions.cancel' | 'interactions.all' | 'models' | 'toolOutput' | 'cancelTool' | 'searchSync' | 'references' | 'paths' | 'chips' | 'chips.commit' | 'chips.sessions' | 'chips.context' | 'chips.skills' | 'chips.commands' | 'badges' | 'siteIcons';
+type ChatHostCapability = 'sessions' | 'sessions.create' | 'sessions.rename' | 'sessions.setArchived' | 'sessions.setFavorite' | 'sessions.remove' | 'sessions.query' | 'sessions.setSpace' | 'sessions.search' | 'sessions.onChanged' | 'sessions.views' | 'sessions.main' | 'send' | 'interrupt' | 'shell' | 'providerReady' | 'steer' | 'followUp' | 'interactions' | 'interactions.cancel' | 'interactions.all' | 'models' | 'toolOutput' | 'cancelTool' | 'searchSync' | 'references' | 'paths' | 'chips' | 'chips.commit' | 'chips.sessions' | 'chips.context' | 'chips.skills' | 'chips.commands' | 'badges' | 'siteIcons' | 'blockRuns';
 /** One thing the backend does while it runs a prompt, in order. */
 type ChatHostScriptStep =
 /** Stream a markdown reply with this text. */
@@ -65,6 +65,11 @@ interface ChatHostContractBackend {
   badgeEffects: Readonly<Record<string, BadgeActionEffect>>;
   /** Site icons by origin (an origin missing here has none). */
   siteIcons: Readonly<Record<string, string>>;
+  /** Run here: what every block writes, and its exit code. */
+  blockRuns: {
+    output: string;
+    exitCode: number;
+  };
 }
 /** Changes the backend from outside, as another window or the backend does. */
 interface ChatHostContractControl {

package/dist/chat/testing/contract.js

@@ -37,7 +37,8 @@ const CAPABILITIES = [
 	"chips.skills",
 	"chips.commands",
 	"badges",
-	"siteIcons"
+	"siteIcons",
+	"blockRuns"
 ];
 /** The capabilities whose member is an object of methods, not a function. */
 const GROUPS = [
@@ -49,7 +50,8 @@ const GROUPS = [
 	"paths",
 	"chips",
 	"badges",
-	"siteIcons"
+	"siteIcons",
+	"blockRuns"
 ];
 /** The request a contract run raises when the script asks a question. */
 const CONTRACT_QUESTION = {
@@ -163,7 +165,11 @@ function contractBackend() {
 			label: "Copy key"
 		}] },
 		badgeEffects: { "copy-key": { copy: "ZID-1" } },
-		siteIcons: { "https://example.com": "data:image/png;base64,AAAA" }
+		siteIcons: { "https://example.com": "data:image/png;base64,AAAA" },
+		blockRuns: {
+			output: "built\n",
+			exitCode: 0
+		}
 	};
 }
 const CONTRACT_SHA = "abc1234def5678abc1234def5678abc1234def56";
@@ -550,6 +556,27 @@ function describeChatHostContract(name, makeHarness, capabilities) {
 			await new Promise((r) => setTimeout(r, 10));
 			expect(icons.get("https://none.example")).toBeNull();
 		});
+		it.skipIf(!has("blockRuns"))("runs a block, streams its output, keeps the run, forgets it", async () => {
+			const { host } = await setup();
+			const backend = contractBackend();
+			const blocks = host.blockRuns;
+			const runs = blocks.runs("c-1");
+			const heard = [];
+			const run = await blocks.run("c-1", {
+				turnId: "t-1",
+				code: "make",
+				language: "bash"
+			}, { onOutput: (_stream, text) => heard.push(text) });
+			expect(heard.join("")).toBe(backend.blockRuns.output);
+			expect(run).toMatchObject({
+				turnId: "t-1",
+				output: backend.blockRuns.output,
+				exitCode: backend.blockRuns.exitCode
+			});
+			await waitFor(() => expect(runs.get()[run.key]).toEqual(run));
+			await blocks.remove("c-1", run.key);
+			await waitFor(() => expect(runs.get()[run.key]).toBeUndefined());
+		});
 		it.skipIf(!has("badges"))("lists a badge's extension actions and runs one", async () => {
 			const { host } = await setup();
 			const target = {

package/dist/chat/testing/fixture-composer-chrome.d.ts

@@ -1,6 +1,6 @@
 import { ComposerModelEntry, ImageModelRow, ModelPickRef } from "../headless/composer/models.js";
 import { RunMeterSignal } from "../headless/composer/run-meter.js";
-import { ComposerAgentProfile, ComposerCacheImpact, ComposerContextBreakdown, ComposerContextStatus, ComposerCostStatus, ComposerHudSnapshot, ComposerPrefsState, ComposerRunProgress } from "../headless/composer/host-chrome.js";
+import { ComposerAgentProfile, ComposerCacheImpact, ComposerContextBreakdown, ComposerContextStatus, ComposerCostStatus, ComposerPrefsState, ComposerRunProgress } from "../headless/composer/host-chrome.js";
 import { ComposerHost } from "../headless/composer/host.js";
 //#region src/chat/testing/fixture-composer-chrome.d.ts
 /** A session's picks as the fixture holds them. */
@@ -36,15 +36,11 @@ interface FixtureComposerChromeOptions {
   }>;
   /** Each session's run in progress. */
   runProgress?: Record<string, ComposerRunProgress>;
-  /** What extensions show, per session. */
-  hud?: ComposerHudSnapshot;
 }
 /** The chrome members, with the controls a demo or a test plays. */
-interface FixtureComposerChrome extends Required<Pick<ComposerHost, 'controls' | 'models' | 'agents' | 'prefs' | 'pickerPrefs' | 'context' | 'runs' | 'hud'>> {
+interface FixtureComposerChrome extends Required<Pick<ComposerHost, 'controls' | 'models' | 'agents' | 'prefs' | 'pickerPrefs' | 'context' | 'runs'>> {
   /** The backend streams a run signal (`run:start`, `stream:progress`, `turn:end`, `run:end`). */
   runSignal(signal: RunMeterSignal): void;
-  /** The backend pushes a new extensions snapshot. */
-  pushHud(snapshot: ComposerHudSnapshot): void;
 }
 /** Demo chat models for the pickers. */
 declare const DEMO_COMPOSER_MODELS: readonly ComposerModelEntry[];