@mcp-b/react-components 0.48.0 → 0.49.1

package/dist/components/agents-sdk/ThinkThreadPicker.d.ts

@@ -1,2 +1,91 @@
-import { a as ThinkThreadStatusIndicatorsProps, i as ThinkThreadStatusIndicators, n as ThinkThreadPicker, o as ThinkThreadStatusSummary, r as ThinkThreadPickerProps, s as summarizeThinkThreads, t as ThinkThreadItem } from "../../ThinkThreadPicker-yFz4vvIf.js";
+import * as React from "react";
+
+//#region src/components/agents-sdk/ThinkThreadPicker.d.ts
+interface ThinkThreadItem {
+  /** Stable child-agent/thread id used by the app-authored link's route params. */
+  id: string;
+  /** Human-readable thread title, usually generated by the parent Think agent. */
+  title: string;
+  /** Optional parent-owned preview for apps that render their own richer sidebar. */
+  lastMessagePreview?: string;
+  /** Timestamp from the parent registry or metadata row. `updatedAt` wins over `createdAt`. */
+  createdAt?: Date | number;
+  /** Timestamp from parent-owned thread metadata when available. */
+  updatedAt?: Date | number;
+  /** Preformatted timestamp label when the app already has one, such as "14m". */
+  updatedAtLabel?: string;
+  /** Optional upstream/app status string. The picker only displays it; it does not derive it. */
+  status?: string;
+  /** Human label for `status` when the raw upstream value is not user-facing. */
+  statusLabel?: string;
+}
+interface ThinkThreadStatusSummary {
+  /** Threads currently processing a turn. */
+  running: number;
+  /** Completed or interrupted background threads that have not been reviewed. */
+  attention: number;
+  /** Threads whose latest turn failed. */
+  failed: number;
+}
+interface ThinkThreadStatusIndicatorsProps {
+  summary: ThinkThreadStatusSummary;
+  className?: string;
+}
+interface ThinkThreadPickerProps<Thread extends ThinkThreadItem = ThinkThreadItem> extends Omit<React.HTMLAttributes<HTMLElement>, "onSelect" | "title"> {
+  /** Threads from the parent agent, already sorted in the order the app wants to show. */
+  threads: readonly Thread[];
+  /**
+   * Renders the application-owned TanStack Router Link for a thread.
+   *
+   * Put `to`, `params`, `search`, and active state on this element so they stay
+   * inferred from the consuming application's registered route tree.
+   */
+  renderThreadLink: (thread: Thread) => React.ReactElement;
+  /**
+   * App-authored TanStack Router Link to the new-thread screen. A thread
+   * created on click is an empty thread until someone writes in it.
+   */
+  createThreadLink?: React.ReactElement;
+  /**
+   * Notified on unmodified primary activation. The link still navigates — the
+   * route is the selection — so this is for side effects such as closing a
+   * compact drawer, never for performing the selection itself.
+   */
+  onSelect?: (thread: Thread) => void;
+  /** Optional parent-agent delete action, usually `parent.stub.deleteThread(thread.id)`. */
+  onDelete?: (thread: Thread) => void | Promise<void>;
+  /** Visible heading for the roster. */
+  title?: React.ReactNode;
+  /** Accessible label for the list navigation. */
+  "aria-label"?: string;
+}
+declare function summarizeThinkThreads(threads: readonly Pick<ThinkThreadItem, "status">[]): ThinkThreadStatusSummary;
+declare function ThinkThreadStatusIndicators({
+  summary,
+  className
+}: ThinkThreadStatusIndicatorsProps): React.JSX.Element | null;
+/**
+ * Thread roster UI for sub-agent chat apps.
+ *
+ * This component does not call Think or Cloudflare RPC methods directly. Feed
+ * it from the parent agent's roster method, then render app-owned route links
+ * that select the child `useAgent({ sub: [...] })` name. Keep backend contract
+ * notes beside the parent Think agent because
+ * `listThreads()`/`createThread()`/`deleteThread()` are app-owned.
+ */
+declare function ThinkThreadPicker<Thread extends ThinkThreadItem>({
+  threads,
+  renderThreadLink,
+  createThreadLink,
+  onSelect,
+  onDelete,
+  className,
+  title,
+  "aria-label": ariaLabel,
+  ref,
+  ...props
+}: ThinkThreadPickerProps<Thread> & {
+  /** Ref forwarded to the component's rendered root element. */ref?: React.Ref<HTMLElement>;
+}): React.JSX.Element;
+//#endregion
 export { ThinkThreadItem, ThinkThreadPicker, ThinkThreadPickerProps, ThinkThreadStatusIndicators, ThinkThreadStatusIndicatorsProps, ThinkThreadStatusSummary, summarizeThinkThreads };

package/dist/components/agents-sdk/ThinkThreadPicker.js

@@ -1,11 +1,11 @@
 import { t as cx } from "../../class-names-BiMDVpUo.js";
-import { B as PlusIcon, K as SpinnerIcon, _ as DotIcon, et as WarningIcon, t as ArchiveIcon } from "../../icons-CeGfXO21.js";
+import { B as PlusIcon, K as SpinnerIcon, _ as DotIcon, et as WarningIcon, t as ArchiveIcon } from "../../icons-cuEtsgj9.js";
 import { Button, buttonVariants } from "../foundations/Button.js";
 import { a as formatErrorMessage } from "../../format-COCyV98Z.js";
-import { n as isPlainPrimaryLinkActivation, t as NavigationLink } from "../../navigation-link-kqMa81v5.js";
 import { ScrollArea } from "../foundations/ScrollArea.js";
-import { AlertDialog } from "../foundations/AlertDialog.js";
 import { EmptyState } from "../foundations/EmptyState.js";
+import { AlertDialog } from "../foundations/AlertDialog.js";
+import { n as isPlainPrimaryLinkActivation, t as NavigationLink } from "../../navigation-link-kqMa81v5.js";
 import { LinkButton } from "../foundations/LinkButton.js";
 import { SearchField } from "../foundations/SearchField.js";
 import * as React from "react";

package/dist/components/agents-sdk/Workspace.d.ts

@@ -1,2 +1,2 @@
-import { A as workspaceFileQueryKey, C as refreshWorkspaceFileQueries, D as workspaceDirectoryQueryOptions, E as workspaceDirectoryQueryKey, F as workspaceTextFileQueryOptions, M as workspaceInfoQueryKey, N as workspaceInfoQueryOptions, O as workspaceDirectoryQueryPrefix, P as workspaceQueryKey, S as WorkspaceTextFileQueryOptions, T as workspaceBinaryFileQueryOptions, _ as WorkspaceQueryOptions, a as WorkspaceDirectoryQueryOptions, b as WorkspaceState, c as WorkspaceFileQueryKey, d as WorkspaceFileStatQueryOptions, f as WorkspaceFileVersion, g as WorkspaceQueryKey, h as WorkspaceInfoQueryOptions, i as WorkspaceDirectoryQueryKey, j as workspaceFileStatQueryOptions, k as workspaceFileAssetQueryOptions, l as WorkspaceFileReadTarget, m as WorkspaceInfoQueryKey, n as WorkspaceBinaryFileQueryKey, o as WorkspaceFileAssetQueryKey, p as WorkspaceInfo, r as WorkspaceBinaryFileQueryOptions, s as WorkspaceFileAssetQueryOptions, t as UseWorkspaceOptions, u as WorkspaceFileStatQueryKey, v as WorkspaceResolvedAsset, w as useWorkspace, x as WorkspaceTextFileQueryKey, y as WorkspaceSource } from "../../Workspace-LIoU30n7.js";
+import { A as workspaceFileQueryKey, C as refreshWorkspaceFileQueries, D as workspaceDirectoryQueryOptions, E as workspaceDirectoryQueryKey, F as workspaceTextFileQueryOptions, M as workspaceInfoQueryKey, N as workspaceInfoQueryOptions, O as workspaceDirectoryQueryPrefix, P as workspaceQueryKey, S as WorkspaceTextFileQueryOptions, T as workspaceBinaryFileQueryOptions, _ as WorkspaceQueryOptions, a as WorkspaceDirectoryQueryOptions, b as WorkspaceState, c as WorkspaceFileQueryKey, d as WorkspaceFileStatQueryOptions, f as WorkspaceFileVersion, g as WorkspaceQueryKey, h as WorkspaceInfoQueryOptions, i as WorkspaceDirectoryQueryKey, j as workspaceFileStatQueryOptions, k as workspaceFileAssetQueryOptions, l as WorkspaceFileReadTarget, m as WorkspaceInfoQueryKey, n as WorkspaceBinaryFileQueryKey, o as WorkspaceFileAssetQueryKey, p as WorkspaceInfo, r as WorkspaceBinaryFileQueryOptions, s as WorkspaceFileAssetQueryOptions, t as UseWorkspaceOptions, u as WorkspaceFileStatQueryKey, v as WorkspaceResolvedAsset, w as useWorkspace, x as WorkspaceTextFileQueryKey, y as WorkspaceSource } from "../../Workspace-HzGrWDX3.js";
 export { UseWorkspaceOptions, WorkspaceBinaryFileQueryKey, WorkspaceBinaryFileQueryOptions, WorkspaceDirectoryQueryKey, WorkspaceDirectoryQueryOptions, WorkspaceFileAssetQueryKey, WorkspaceFileAssetQueryOptions, WorkspaceFileQueryKey, WorkspaceFileReadTarget, WorkspaceFileStatQueryKey, WorkspaceFileStatQueryOptions, WorkspaceFileVersion, WorkspaceInfo, WorkspaceInfoQueryKey, WorkspaceInfoQueryOptions, WorkspaceQueryKey, WorkspaceQueryOptions, WorkspaceResolvedAsset, WorkspaceSource, WorkspaceState, WorkspaceTextFileQueryKey, WorkspaceTextFileQueryOptions, refreshWorkspaceFileQueries, useWorkspace, workspaceBinaryFileQueryOptions, workspaceDirectoryQueryKey, workspaceDirectoryQueryOptions, workspaceDirectoryQueryPrefix, workspaceFileAssetQueryOptions, workspaceFileQueryKey, workspaceFileStatQueryOptions, workspaceInfoQueryKey, workspaceInfoQueryOptions, workspaceQueryKey, workspaceTextFileQueryOptions };

package/dist/components/agents-sdk/Workspace.js

@@ -299,19 +299,13 @@ function useWorkspace({ source, sourceKey, root = "/", selectedPath, onSelectedP
 		...workspaceBinaryFileQueryOptions(source, sourceKey, root, queryTarget, normalizedMaxInlineAssetBytes),
 		enabled: statSettled && resolverSettled && !resolvedAsset && Boolean(target.media)
 	});
-	const entriesByDirectory = React.useMemo(() => {
-		const entries = {};
-		for (const [index, path] of directoryPaths.entries()) {
-			const data = directoryQueries[index]?.data;
-			if (data) entries[path] = data;
-		}
-		return entries;
-	}, [directoryPaths, directoryQueries]);
-	const entryByPath = React.useMemo(() => {
-		const entries = /* @__PURE__ */ new Map();
-		for (const directoryEntries of Object.values(entriesByDirectory)) for (const entry of directoryEntries) entries.set(entry.path, entry);
-		return entries;
-	}, [entriesByDirectory]);
+	const entriesByDirectory = {};
+	for (const [key, data] of queryClient.getQueriesData({ queryKey: workspaceDirectoryQueryPrefix(sourceKey, root) })) {
+		const path = key.at(-1);
+		if (typeof path === "string" && data) entriesByDirectory[path] = data;
+	}
+	const entryByPath = /* @__PURE__ */ new Map();
+	for (const directoryEntries of Object.values(entriesByDirectory)) for (const entry of directoryEntries) entryByPath.set(entry.path, entry);
 	const setExpandedPaths = React.useCallback((next) => {
 		latestExpansionRef.current = {
 			scopeKey,

package/dist/components/agents-sdk/WorkspaceBrowser.d.ts

@@ -1,4 +1,4 @@
-import { b as WorkspaceState } from "../../Workspace-LIoU30n7.js";
+import { b as WorkspaceState } from "../../Workspace-HzGrWDX3.js";
 import * as React from "react";
 
 //#region src/components/agents-sdk/WorkspaceBrowser.d.ts

package/dist/components/agents-sdk/WorkspaceBrowser.js

@@ -1,5 +1,5 @@
 import { SearchField } from "../foundations/SearchField.js";
-import { i as FileTreeFolder, r as FileTreeFile, t as FileTree } from "../../FileTree-DvE0hNZu.js";
+import { i as FileTreeFolder, r as FileTreeFile, t as FileTree } from "../../FileTree-DruTQ-oa.js";
 import { WorkspaceHeader } from "./WorkspaceHeader.js";
 import * as React from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";

package/dist/components/agents-sdk/WorkspaceConcept.d.ts

@@ -1,4 +1,4 @@
-import { _ as WorkspaceQueryOptions, g as WorkspaceQueryKey } from "../../Workspace-LIoU30n7.js";
+import { _ as WorkspaceQueryOptions, g as WorkspaceQueryKey } from "../../Workspace-HzGrWDX3.js";
 import { QueryClient, QueryFunction } from "@tanstack/react-query";
 
 //#region src/components/agents-sdk/WorkspaceConcept.d.ts

package/dist/components/agents-sdk/WorkspaceCorrespondence.d.ts

@@ -33,18 +33,27 @@ interface WorkspaceCorrespondenceSource {
   onDelete?: (path: string) => void | Promise<void>;
 }
 interface WorkspaceCorrespondenceCardProps extends Omit<CardProps, "children" | "hover" | "size" | "title" | "onChange"> {
+  /** Correspondence renderer key, such as the message or email kind selected by the host. */
   kind: string;
+  /** Workspace-relative file path represented by this card. */
   path: string;
+  /** Ordered header fields rendered above the correspondence body. */
   fields: readonly WorkspaceCorrespondenceField[];
+  /** Editable or read-only correspondence body. */
   body: string;
+  /** Leading icon identifying the correspondence channel. */
   icon?: React.ReactNode;
   /** `sent` renders the read-only snapshot and ignores `onChange`/`onSend`. */
   state?: WorkspaceCorrespondenceState;
   /** Persistence lifecycle of the visible draft. Send is disabled while set. */
   saveState?: ConnectedAppCardSaveState;
+  /** Receives the complete draft after an editable field changes. */
   onChange?: (next: WorkspaceCorrespondenceDraft) => void;
+  /** Sends the visible draft through the host-owned channel. */
   onSend?: () => void | Promise<void>;
+  /** Opens the backing correspondence file or detail route. */
   onOpen?: () => void;
+  /** Deletes the backing correspondence through the host. */
   onDelete?: () => void | Promise<void>;
 }
 interface WorkspaceCorrespondenceFileProps extends Omit<WorkspaceCorrespondenceCardProps, "body" | "fields" | "kind" | "onChange" | "onDelete" | "onOpen" | "onSend" | "path" | "saveState" | "state"> {
@@ -72,7 +81,7 @@ declare function WorkspaceCorrespondenceCard({
   ref,
   ...props
 }: WorkspaceCorrespondenceCardProps & {
-  ref?: React.Ref<HTMLDivElement>;
+  /** Ref forwarded to the component's rendered root element. */ref?: React.Ref<HTMLDivElement>;
 }): React.JSX.Element;
 /**
  * Query-backed reviewed correspondence. The host supplies normalized reads

package/dist/components/agents-sdk/WorkspaceCorrespondence.js

@@ -1,15 +1,15 @@
 import { t as cx } from "../../class-names-BiMDVpUo.js";
-import { S as FileIcon, d as CheckIcon } from "../../icons-CeGfXO21.js";
+import { S as FileIcon, d as CheckIcon } from "../../icons-cuEtsgj9.js";
 import { Button } from "../foundations/Button.js";
-import { Field } from "../foundations/Field.js";
-import { Textarea } from "../foundations/Textarea.js";
 import { IconButton } from "../foundations/IconButton.js";
 import { a as formatErrorMessage } from "../../format-COCyV98Z.js";
-import { Card, CardAction, CardContent, CardFooter, CardHeader, CardTitle } from "../foundations/Card.js";
-import { DescriptionList } from "../foundations/DescriptionList.js";
+import { Field } from "../foundations/Field.js";
+import { Textarea } from "../foundations/Textarea.js";
 import { Input } from "../foundations/Input.js";
+import { DescriptionList } from "../foundations/DescriptionList.js";
+import { Card, CardAction, CardContent, CardFooter, CardHeader, CardTitle } from "../foundations/Card.js";
 import { EmailMessageCard, SlackMessageCard } from "../ai-sdk/ConnectedAppCards.js";
-import { i as WorkspaceDeleteControl, r as httpUrl, t as FaviconMark } from "../../workspace-assets-GqsCYxqT.js";
+import { i as WorkspaceDeleteControl, r as httpUrl, t as FaviconMark } from "../../workspace-assets-Bg7XhPsk.js";
 import * as React from "react";
 import { createElement } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
@@ -108,7 +108,10 @@ function GenericWorkspaceCorrespondenceCard({ className, body, fields, kind, pat
 			/* @__PURE__ */ jsxs(CardHeader, { children: [/* @__PURE__ */ jsxs(CardTitle, {
 				id: titleId,
 				className: "connected-app-card__title",
-				render: /* @__PURE__ */ jsx("h3", {}),
+				render: (props) => /* @__PURE__ */ jsx("h3", {
+					...props,
+					children: props.children
+				}),
 				children: [/* @__PURE__ */ jsx("span", {
 					className: "connected-app-card__icon",
 					"aria-hidden": "true",

package/dist/components/agents-sdk/WorkspaceExecution.d.ts

@@ -1,4 +1,3 @@
-import { ThinkFullAppPanel } from "./ThinkFullApp.js";
 import { WorkspaceConceptQueryOptions } from "./WorkspaceConcept.js";
 import { CardProps } from "../foundations/Card.js";
 import * as React from "react";
@@ -71,11 +70,8 @@ interface WorkspaceExecutionFileProps extends Omit<WorkspaceExecutionCardProps,
   fallback?: React.ReactNode;
 }
 interface WorkspaceExecutionsPanelProps extends Omit<React.HTMLAttributes<HTMLElement>, "children"> {
-  modules: readonly WorkspaceExecutionView[];
-  loading?: boolean;
-  /** Query failure to show instead of the empty state. Loaded modules win. */
-  error?: string;
-  onRetry?: () => void;
+  /** Shared workspace query and host actions, also used by inline module cards. */
+  source: WorkspaceExecutionSource;
 }
 declare function WorkspaceExecutionCard({
   module,
@@ -100,16 +96,11 @@ declare function WorkspaceExecutionFile({
  */
 declare function WorkspaceExecutionsPanel({
   className,
-  error,
-  loading,
-  modules,
-  onRetry,
+  source,
   ref,
   ...props
 }: WorkspaceExecutionsPanelProps & {
-  ref?: React.Ref<HTMLElement>;
+  /** Ref forwarded to the component's rendered root element. */ref?: React.Ref<HTMLElement>;
 }): React.JSX.Element;
-/** Canonical workbench descriptor; hosts supply only the source adapter. */
-declare function workspaceExecutionsPanel(source: WorkspaceExecutionSource): ThinkFullAppPanel;
 //#endregion
-export { WorkspaceExecution, WorkspaceExecutionCard, WorkspaceExecutionCardProps, WorkspaceExecutionFile, WorkspaceExecutionFileProps, WorkspaceExecutionOutcome, WorkspaceExecutionParam, WorkspaceExecutionParamType, WorkspaceExecutionRun, WorkspaceExecutionRunView, WorkspaceExecutionSource, WorkspaceExecutionView, WorkspaceExecutionViewOutcome, WorkspaceExecutionsPanel, WorkspaceExecutionsPanelProps, workspaceExecutionsPanel };
+export { WorkspaceExecution, WorkspaceExecutionCard, WorkspaceExecutionCardProps, WorkspaceExecutionFile, WorkspaceExecutionFileProps, WorkspaceExecutionOutcome, WorkspaceExecutionParam, WorkspaceExecutionParamType, WorkspaceExecutionRun, WorkspaceExecutionRunView, WorkspaceExecutionSource, WorkspaceExecutionView, WorkspaceExecutionViewOutcome, WorkspaceExecutionsPanel, WorkspaceExecutionsPanelProps };

package/dist/components/agents-sdk/WorkspaceExecution.js

@@ -1,16 +1,16 @@
 import { t as cx } from "../../class-names-BiMDVpUo.js";
-import { K as SpinnerIcon, S as FileIcon, Z as TerminalIcon, d as CheckIcon, z as PlayIcon } from "../../icons-CeGfXO21.js";
+import { K as SpinnerIcon, S as FileIcon, Z as TerminalIcon, d as CheckIcon, z as PlayIcon } from "../../icons-cuEtsgj9.js";
 import { Button } from "../foundations/Button.js";
-import { Field } from "../foundations/Field.js";
-import { Form } from "../foundations/Form.js";
 import { IconButton } from "../foundations/IconButton.js";
 import { a as formatErrorMessage, o as formatUnknownValue, r as firstLine } from "../../format-COCyV98Z.js";
-import { Card, CardAction, CardContent, CardDescription, CardHeader, CardTitle } from "../foundations/Card.js";
-import { DescriptionList } from "../foundations/DescriptionList.js";
+import { Field } from "../foundations/Field.js";
+import { Form } from "../foundations/Form.js";
+import { EmptyState } from "../foundations/EmptyState.js";
 import { Input } from "../foundations/Input.js";
+import { DescriptionList } from "../foundations/DescriptionList.js";
 import { Checkbox } from "../foundations/Checkbox.js";
-import { EmptyState } from "../foundations/EmptyState.js";
-import { i as WorkspaceDeleteControl, n as WorkspaceComposerLink, r as httpUrl, t as FaviconMark } from "../../workspace-assets-GqsCYxqT.js";
+import { Card, CardAction, CardContent, CardDescription, CardHeader, CardTitle } from "../foundations/Card.js";
+import { i as WorkspaceDeleteControl, n as WorkspaceComposerLink, r as httpUrl, t as FaviconMark } from "../../workspace-assets-Bg7XhPsk.js";
 import * as React from "react";
 import { createElement } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
@@ -191,7 +191,10 @@ function WorkspaceExecutionCardSession({ className, module, ref, ...props }) {
 		/* @__PURE__ */ jsxs(CardTitle, {
 			id: titleId,
 			className: "connected-app-card__title",
-			render: /* @__PURE__ */ jsx("h3", {}),
+			render: (props) => /* @__PURE__ */ jsx("h3", {
+				...props,
+				children: props.children
+			}),
 			children: [/* @__PURE__ */ jsx("span", {
 				className: "connected-app-card__icon",
 				"aria-hidden": "true",
@@ -251,13 +254,15 @@ function WorkspaceExecutionFile({ fallback = null, path, source, ...props }) {
 	return /* @__PURE__ */ jsx(WorkspaceExecutionCard, {
 		...props,
 		module: executionWithSource(module, source)
-	});
+	}, JSON.stringify(source.queryOptions.queryKey));
 }
 /**
 * Workbench library. Same card as the inline placement. A query failure with
 * nothing loaded renders as a quiet inline error, never as an empty library.
 */
-function WorkspaceExecutionsPanel({ className, error, loading = false, modules, onRetry, ref, ...props }) {
+function WorkspaceExecutionsPanel({ className, source, ref, ...props }) {
+	const query = useQuery(source.queryOptions);
+	const modules = query.data ?? [];
 	return /* @__PURE__ */ jsx("section", {
 		ref,
 		"data-slot": "workspace-executions-panel",
@@ -266,26 +271,26 @@ function WorkspaceExecutionsPanel({ className, error, loading = false, modules,
 		"aria-label": props["aria-label"] ?? "Executions",
 		children: modules.length > 0 ? /* @__PURE__ */ jsx("ul", {
 			className: "sigvelo-stack-list sigvelo-stack",
-			children: modules.map((module) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(WorkspaceExecutionCard, { module }) }, module.path))
-		}) : error !== void 0 ? /* @__PURE__ */ jsx(EmptyState, {
+			children: modules.map((module) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(WorkspaceExecutionCard, { module: executionWithSource(module, source) }) }, module.path))
+		}) : query.error ? /* @__PURE__ */ jsx(EmptyState, {
 			icon: /* @__PURE__ */ jsx(TerminalIcon, {}),
 			title: "Executions unavailable",
-			description: error,
-			children: onRetry ? /* @__PURE__ */ jsx(Button, {
+			description: formatErrorMessage(query.error),
+			children: /* @__PURE__ */ jsx(Button, {
 				size: "sm",
 				variant: "outline",
 				color: "neutral",
-				onClick: onRetry,
+				onClick: () => void query.refetch(),
 				children: "Retry"
-			}) : null
-		}) : loading ? /* @__PURE__ */ jsx(EmptyState, {
+			})
+		}) : query.isPending ? /* @__PURE__ */ jsx(EmptyState, {
 			icon: /* @__PURE__ */ jsx(SpinnerIcon, {}),
 			title: "Loading modules"
 		}) : /* @__PURE__ */ jsx(EmptyState, {
 			icon: /* @__PURE__ */ jsx(TerminalIcon, {}),
 			title: "No modules"
 		})
-	});
+	}, JSON.stringify(source.queryOptions.queryKey));
 }
 function executionWithSource(module, source) {
 	const { onDelete, onOpen, onRun } = source;
@@ -307,24 +312,5 @@ function executionWithSource(module, source) {
 		onDelete: onDelete ? () => onDelete(module.path) : void 0
 	};
 }
-function WorkspaceExecutionSourcePanel({ source }) {
-	const query = useQuery(source.queryOptions);
-	return /* @__PURE__ */ jsx(WorkspaceExecutionsPanel, {
-		modules: (query.data ?? []).map((module) => executionWithSource(module, source)),
-		error: query.isError ? formatErrorMessage(query.error) : void 0,
-		loading: query.isPending,
-		onRetry: query.isError ? () => void query.refetch() : void 0,
-		"aria-busy": query.isFetching || void 0
-	});
-}
-/** Canonical workbench descriptor; hosts supply only the source adapter. */
-function workspaceExecutionsPanel(source) {
-	return {
-		id: "executions",
-		label: "Executions",
-		icon: /* @__PURE__ */ jsx(TerminalIcon, {}),
-		render: () => /* @__PURE__ */ jsx(WorkspaceExecutionSourcePanel, { source })
-	};
-}
 //#endregion
-export { WorkspaceExecutionCard, WorkspaceExecutionFile, WorkspaceExecutionsPanel, workspaceExecutionsPanel };
+export { WorkspaceExecutionCard, WorkspaceExecutionFile, WorkspaceExecutionsPanel };

package/dist/components/agents-sdk/WorkspaceExplorer.d.ts

@@ -1,9 +1,10 @@
 import { l as WorkspaceNavigationAdapter } from "../../WorkspaceLink-Bh9-Jo1r.js";
-import { b as WorkspaceState } from "../../Workspace-LIoU30n7.js";
+import { b as WorkspaceState } from "../../Workspace-HzGrWDX3.js";
 import * as React from "react";
 
 //#region src/components/agents-sdk/WorkspaceExplorer.d.ts
 interface WorkspaceExplorerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+  /** Workspace state that owns the file tree, selection, loading, and refresh behavior. */
   workspace: WorkspaceState;
   /** Host-owned URL/history adapter shared by chat links and the file explorer. */
   navigation: WorkspaceNavigationAdapter;
@@ -15,7 +16,9 @@ interface WorkspaceExplorerProps extends Omit<React.HTMLAttributes<HTMLDivElemen
   actions?: React.ReactNode;
   /** Show the file filter input. Hidden by default to keep the browser compact. */
   showFilter?: boolean;
+  /** Placeholder for the optional file filter. */
   filterPlaceholder?: string;
+  /** Content shown when the workspace contains no visible files. */
   emptyState?: React.ReactNode;
 }
 /**
@@ -26,7 +29,7 @@ interface WorkspaceExplorerProps extends Omit<React.HTMLAttributes<HTMLDivElemen
 declare function WorkspaceExplorer({
   ...props
 }: WorkspaceExplorerProps & {
-  ref?: React.Ref<HTMLDivElement>;
+  /** Ref forwarded to the component's rendered root element. */ref?: React.Ref<HTMLDivElement>;
 }): React.JSX.Element;
 //#endregion
 export { WorkspaceExplorer, WorkspaceExplorerProps };

package/dist/components/agents-sdk/WorkspaceExplorer.js

@@ -1,8 +1,9 @@
 import { t as cx } from "../../class-names-BiMDVpUo.js";
 import { n as mergeRefs } from "../../merge-refs-DF_7w2x_.js";
-import { a as WorkspaceNavigationRestorationBoundary, n as WorkspaceNavigationProvider, o as useRequiredWorkspaceNavigationRestoration, r as resolveWorkspaceLink } from "../../WorkspaceLink-B1d2GIGl.js";
+import { n as WorkspaceNavigationProvider, r as resolveWorkspaceLink } from "../../WorkspaceLink-BYZG-V_I.js";
+import { WorkspaceNavigationRestorationBoundary, useRequiredWorkspaceNavigationRestoration } from "./WorkspaceNavigationRestoration.js";
 import { WorkspaceBrowser } from "./WorkspaceBrowser.js";
-import { t as WorkspaceFileView } from "../../WorkspaceFileView-C_WnYm-a.js";
+import { t as WorkspaceFileView } from "../../WorkspaceFileView-DYPtRVpM.js";
 import * as React from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/components/agents-sdk/WorkspaceExplorer.tsx

package/dist/components/agents-sdk/WorkspaceFile.d.ts

@@ -1,2 +1,2 @@
-import { _ as isWorkspaceTextPath, a as WorkspaceMediaInfo, c as WorkspaceMediaTrackKind, d as inferWorkspaceLanguage, f as inferWorkspaceMedia, g as isWorkspaceSkillPath, h as isWorkspaceMediaPath, i as WorkspaceFileState, l as WorkspaceSkillDocument, m as isWorkspaceMarkdownPath, n as WorkspaceFileAssetRequest, o as WorkspaceMediaKind, p as inferWorkspaceMimeType, r as WorkspaceFileAssetResolver, s as WorkspaceMediaTrack, t as WorkspaceFileAsset, u as getWorkspaceBasename, v as parseWorkspaceSkill } from "../../WorkspaceFile-Dq-GC0_T.js";
+import { _ as isWorkspaceTextPath, a as WorkspaceMediaInfo, c as WorkspaceMediaTrackKind, d as inferWorkspaceLanguage, f as inferWorkspaceMedia, g as isWorkspaceSkillPath, h as isWorkspaceMediaPath, i as WorkspaceFileState, l as WorkspaceSkillDocument, m as isWorkspaceMarkdownPath, n as WorkspaceFileAssetRequest, o as WorkspaceMediaKind, p as inferWorkspaceMimeType, r as WorkspaceFileAssetResolver, s as WorkspaceMediaTrack, t as WorkspaceFileAsset, u as getWorkspaceBasename, v as parseWorkspaceSkill } from "../../WorkspaceFile-Bouauobc.js";
 export { WorkspaceFileAsset, WorkspaceFileAssetRequest, WorkspaceFileAssetResolver, WorkspaceFileState, WorkspaceMediaInfo, WorkspaceMediaKind, WorkspaceMediaTrack, WorkspaceMediaTrackKind, WorkspaceSkillDocument, getWorkspaceBasename, inferWorkspaceLanguage, inferWorkspaceMedia, inferWorkspaceMimeType, isWorkspaceMarkdownPath, isWorkspaceMediaPath, isWorkspaceSkillPath, isWorkspaceTextPath, parseWorkspaceSkill };

package/dist/components/agents-sdk/WorkspaceFileView.d.ts

@@ -1,4 +1,4 @@
-import { i as WorkspaceFileState } from "../../WorkspaceFile-Dq-GC0_T.js";
+import { i as WorkspaceFileState } from "../../WorkspaceFile-Bouauobc.js";
 import * as React from "react";
 
 //#region src/components/agents-sdk/WorkspaceFileView.d.ts

package/dist/components/agents-sdk/WorkspaceFileView.js

@@ -1,2 +1,2 @@
-import { t as WorkspaceFileView } from "../../WorkspaceFileView-C_WnYm-a.js";
+import { t as WorkspaceFileView } from "../../WorkspaceFileView-DYPtRVpM.js";
 export { WorkspaceFileView };

package/dist/components/agents-sdk/WorkspaceHeader.js

@@ -1,4 +1,4 @@
-import { H as RefreshIcon } from "../../icons-CeGfXO21.js";
+import { H as RefreshIcon } from "../../icons-cuEtsgj9.js";
 import { AppTopBar } from "../general-purpose/AppTopBar.js";
 import "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";

package/dist/components/agents-sdk/WorkspaceLink.js

@@ -1,2 +1,2 @@
-import { n as WorkspaceNavigationProvider, r as resolveWorkspaceLink, t as WorkspaceFileLink } from "../../WorkspaceLink-B1d2GIGl.js";
+import { n as WorkspaceNavigationProvider, r as resolveWorkspaceLink, t as WorkspaceFileLink } from "../../WorkspaceLink-BYZG-V_I.js";
 export { WorkspaceFileLink, WorkspaceNavigationProvider, resolveWorkspaceLink };

package/dist/components/agents-sdk/WorkspaceLive.d.ts

@@ -1,2 +1,61 @@
-import { a as useWorkspaceLiveQueries, i as invalidateWorkspaceDirectories, n as WorkspaceChange, r as WorkspaceChangeSource, t as UseWorkspaceLiveQueriesOptions } from "../../WorkspaceLive-DfjH1Ypm.js";
+import { r as WorkspaceFileAssetResolver } from "../../WorkspaceFile-Bouauobc.js";
+import { y as WorkspaceSource } from "../../Workspace-HzGrWDX3.js";
+import { QueryClient } from "@tanstack/react-query";
+
+//#region src/components/agents-sdk/WorkspaceLive.d.ts
+type WorkspaceChange = {
+  type: "changed";
+  path: string;
+  movedFrom?: string;
+} | {
+  type: "unknown";
+};
+/** Host adapter for a native workspace observer. */
+interface WorkspaceChangeSource {
+  start?(): void | Promise<void>;
+  subscribe(listener: (change: WorkspaceChange) => void): () => void;
+}
+declare function invalidateWorkspaceDirectories(queryClient: QueryClient, sourceKey: string, directories: Iterable<string>, root: string): void;
+interface UseWorkspaceLiveQueriesOptions {
+  /** Native observer adapter. Omit for hosts without workspace observation. */
+  changes?: WorkspaceChangeSource;
+  sourceKey: string | undefined;
+  /**
+   * The host's workspace boundary. Required, and the same value the concept
+   * options were built with: invalidation is prefix-matched on it, so a root
+   * that disagrees with the queries silently invalidates nothing.
+   */
+  root: string;
+  /** Workspace read adapter used to refresh an observed open file in order. */
+  source?: WorkspaceSource;
+  /** Route-owned open file. Omit or pass null when Files has no selection. */
+  selectedPath?: string | null;
+  resolveFileAsset?: WorkspaceFileAssetResolver;
+  maxInlineAssetBytes?: number;
+  /**
+   * Disposable freshness tick for hosts without native observation — for
+   * example a serialization of settled-turn state. Every change of a defined
+   * value invalidates the source's concept queries. It never enters query
+   * identity, so data, mutation state, and form drafts survive the refresh.
+   */
+  revision?: string;
+}
+/**
+ * Synchronize external workspace freshness with the design system's Query
+ * resources. This is the one external-system effect: native observer events
+ * and host revision ticks both land here as targeted invalidation against
+ * stable query keys. Hosts only supply events; neither layer adds another
+ * watcher.
+ */
+declare function useWorkspaceLiveQueries({
+  changes,
+  maxInlineAssetBytes,
+  resolveFileAsset,
+  selectedPath,
+  source,
+  sourceKey,
+  root,
+  revision
+}: UseWorkspaceLiveQueriesOptions): void;
+//#endregion
 export { UseWorkspaceLiveQueriesOptions, WorkspaceChange, WorkspaceChangeSource, invalidateWorkspaceDirectories, useWorkspaceLiveQueries };

package/dist/components/agents-sdk/WorkspaceMessageResponse.d.ts

@@ -1,2 +1,48 @@
-import { a as WorkspaceMessageResponseProps, i as WorkspaceMessageResponse, n as WorkspaceFileRenderer, r as WorkspaceFileRendererProvider, t as WorkspaceFileRenderInput } from "../../WorkspaceMessageResponse-kJYU8Onj.js";
+import { O as MessageResponseProps } from "../../Message-DyaTBiV7.js";
+import * as React from "react";
+
+//#region src/components/agents-sdk/WorkspaceMessageResponse.d.ts
+interface WorkspaceFileRenderInput {
+  label: string;
+  path: string;
+  /** Shared workspace link element; hosts pass it through to the preview unchanged. */
+  sourceLink: React.ReactElement;
+}
+/**
+ * Host callback for one standalone workspace file link in an assistant
+ * paragraph. Return a node to replace the link, or `null` to keep it.
+ */
+type WorkspaceFileRenderer = (file: WorkspaceFileRenderInput) => React.ReactNode;
+/**
+ * Ambient workspace-file renderer for every `WorkspaceMessageResponse` below,
+ * and the only way to supply one. The value is read inside the promoted
+ * paragraph, not by the response component, so a host handing down a fresh
+ * callback every render re-renders only the paragraphs — the memoized Markdown
+ * pipeline is untouched and promoted cards keep their state.
+ * `ThinkChat.MessageContent` provides it from its `renderWorkspaceFile` prop; hosts
+ * composing `WorkspaceMessageResponse` directly provide it once at their
+ * conversation root.
+ */
+declare function WorkspaceFileRendererProvider({
+  children,
+  renderWorkspaceFile
+}: {
+  children: React.ReactNode;
+  renderWorkspaceFile: WorkspaceFileRenderer | undefined;
+}): React.JSX.Element;
+interface WorkspaceMessageResponseProps extends MessageResponseProps {
+  /**
+   * Whether standalone workspace file links may be promoted. `ThinkChat`
+   * passes `false` for user messages: user links remain ordinary navigation.
+   */
+  promoteWorkspaceFiles?: boolean;
+}
+/** Adds workspace-aware Markdown links when rendered inside a workspace provider. */
+declare const WorkspaceMessageResponse: React.MemoExoticComponent<({
+  components,
+  rehypePlugins,
+  promoteWorkspaceFiles,
+  ...props
+}: WorkspaceMessageResponseProps) => React.JSX.Element>;
+//#endregion
 export { WorkspaceFileRenderInput, WorkspaceFileRenderer, WorkspaceFileRendererProvider, WorkspaceMessageResponse, WorkspaceMessageResponseProps };

package/dist/components/agents-sdk/WorkspaceMessageResponse.js

@@ -1,2 +1,2 @@
-import { n as WorkspaceMessageResponse, t as WorkspaceFileRendererProvider } from "../../WorkspaceMessageResponse-BqOezptB.js";
+import { n as WorkspaceMessageResponse, t as WorkspaceFileRendererProvider } from "../../WorkspaceMessageResponse-CUJk9_P5.js";
 export { WorkspaceFileRendererProvider, WorkspaceMessageResponse };

package/dist/components/agents-sdk/WorkspaceMountManager.d.ts

@@ -15,7 +15,8 @@ interface WorkspaceMountManagerProps {
   onAdd: () => void;
   onReconnect: (mount: WorkspaceMountItem) => void;
   onRemove: (mount: WorkspaceMountItem) => void;
-  triggerLabel?: string;
+  /** Caller-owned button, including its accessible name and optional toolbar composition. */
+  trigger: React.ReactElement;
 }
 /** Controlled local-mount presentation; native handles and persistence stay in the host. */
 declare function WorkspaceMountManager({
@@ -26,7 +27,7 @@ declare function WorkspaceMountManager({
   onAdd,
   onReconnect,
   onRemove,
-  triggerLabel
+  trigger
 }: WorkspaceMountManagerProps): React.JSX.Element;
 //#endregion
 export { WorkspaceMountItem, WorkspaceMountManager, WorkspaceMountManagerProps, WorkspaceMountPermission };