@mcp-b/react-components 0.47.0 → 0.49.0

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

@@ -1,5 +1,5 @@
-import { workspaceDirectoryQueryKey, workspaceDirectoryQueryPrefix } from "./Workspace.js";
-import { invalidateWorkspaceConceptQueries } from "./WorkspaceConcept.js";
+import { refreshWorkspaceFileQueries, workspaceDirectoryQueryKey, workspaceDirectoryQueryPrefix, workspaceFileQueryKey, workspaceInfoQueryKey } from "./Workspace.js";
+import { invalidateWorkspaceConceptQueries, workspacePathsOverlap } from "./WorkspaceConcept.js";
 import * as React from "react";
 import { useQueryClient } from "@tanstack/react-query";
 //#region src/components/agents-sdk/WorkspaceLive.ts
@@ -11,6 +11,22 @@ function workspaceDirname(path) {
 function invalidateWorkspaceDirectories(queryClient, sourceKey, directories, root) {
 	for (const directory of directories) queryClient.invalidateQueries({ queryKey: workspaceDirectoryQueryKey(sourceKey, root, directory) });
 }
+async function invalidateWorkspaceResources(queryClient, sourceKey, root, source, selectedPath, resolveFileAsset, maxInlineAssetBytes, paths) {
+	queryClient.invalidateQueries({
+		queryKey: workspaceInfoQueryKey(sourceKey, root),
+		exact: true
+	});
+	if (!source || !selectedPath || paths && !paths.some((path) => workspacePathsOverlap(selectedPath, path))) return;
+	await queryClient.cancelQueries({ queryKey: workspaceFileQueryKey(sourceKey, root, selectedPath) });
+	await refreshWorkspaceFileQueries(queryClient, {
+		source,
+		sourceKey,
+		root,
+		selectedPath,
+		resolveFileAsset,
+		maxInlineAssetBytes
+	}).catch(() => {});
+}
 /**
 * Synchronize external workspace freshness with the design system's Query
 * resources. This is the one external-system effect: native observer events
@@ -18,15 +34,25 @@ function invalidateWorkspaceDirectories(queryClient, sourceKey, directories, roo
 * stable query keys. Hosts only supply events; neither layer adds another
 * watcher.
 */
-function useWorkspaceLiveQueries({ changes, sourceKey, root, revision }) {
+function useWorkspaceLiveQueries({ changes, maxInlineAssetBytes, resolveFileAsset, selectedPath, source, sourceKey, root, revision }) {
 	const queryClient = useQueryClient();
+	const refreshResources = React.useEffectEvent((paths) => {
+		if (!sourceKey) return;
+		invalidateWorkspaceResources(queryClient, sourceKey, root, source, selectedPath, resolveFileAsset, maxInlineAssetBytes, paths);
+	});
 	const previousRevisionRef = React.useRef(void 0);
 	React.useEffect(() => {
 		if (!sourceKey || revision === void 0) return;
 		const previous = previousRevisionRef.current;
-		previousRevisionRef.current = revision;
-		if (revision === previous) return;
+		previousRevisionRef.current = {
+			sourceKey,
+			root,
+			revision
+		};
+		if (previous?.sourceKey === sourceKey && previous.root === root && previous.revision === revision) return;
+		queryClient.invalidateQueries({ queryKey: workspaceDirectoryQueryPrefix(sourceKey, root) });
 		invalidateWorkspaceConceptQueries(queryClient, sourceKey, root);
+		refreshResources();
 	}, [
 		queryClient,
 		revision,
@@ -50,6 +76,7 @@ function useWorkspaceLiveQueries({ changes, sourceKey, root, revision }) {
 				pendingPaths.clear();
 				queryClient.invalidateQueries({ queryKey: workspaceDirectoryQueryPrefix(sourceKey, root) });
 				invalidateWorkspaceConceptQueries(queryClient, sourceKey, root);
+				refreshResources();
 				return;
 			}
 			invalidateWorkspaceDirectories(queryClient, sourceKey, pendingDirectories, root);
@@ -57,6 +84,7 @@ function useWorkspaceLiveQueries({ changes, sourceKey, root, revision }) {
 			pendingDirectories.clear();
 			pendingPaths.clear();
 			invalidateWorkspaceConceptQueries(queryClient, sourceKey, root, paths);
+			refreshResources(paths);
 		};
 		const unsubscribe = changes.subscribe((change) => {
 			if (change.type === "unknown") refreshAll = true;

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-Dg_aNpoj.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 };

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

@@ -1,19 +1,16 @@
-import { I as PaperclipIcon } from "../../icons-cuEtsgj9.js";
 import { Button } from "../foundations/Button.js";
-import { Popover } from "../foundations/Popover.js";
 import { EmptyState } from "../foundations/EmptyState.js";
-import { AppTopBar } from "../general-purpose/AppTopBar.js";
+import { Popover } from "../foundations/Popover.js";
 import { Card, CardFooter, CardHeader, CardTitle } from "../foundations/Card.js";
 import "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/components/agents-sdk/WorkspaceMountManager.tsx
 /** Controlled local-mount presentation; native handles and persistence stay in the host. */
-function WorkspaceMountManager({ mounts, adding = false, busyMountId = null, error, onAdd, onReconnect, onRemove, triggerLabel = "Attach local folders" }) {
+function WorkspaceMountManager({ mounts, adding = false, busyMountId = null, error, onAdd, onReconnect, onRemove, trigger }) {
 	const busy = adding || busyMountId !== null;
-	return /* @__PURE__ */ jsxs(Popover.Root, { children: [/* @__PURE__ */ jsx(AppTopBar.Button, {
-		label: triggerLabel,
-		render: /* @__PURE__ */ jsx(Popover.Trigger, { unstyled: true }),
-		children: /* @__PURE__ */ jsx(PaperclipIcon, {})
+	return /* @__PURE__ */ jsxs(Popover.Root, { children: [/* @__PURE__ */ jsx(Popover.Trigger, {
+		render: trigger,
+		unstyled: true
 	}), /* @__PURE__ */ jsx(Popover.Portal, { children: /* @__PURE__ */ jsx(Popover.Positioner, {
 		side: "bottom",
 		align: "end",

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

@@ -0,0 +1,38 @@
+import { n as WorkspaceDestination } from "../../WorkspaceLink-Bh9-Jo1r.js";
+import * as React from "react";
+
+//#region src/components/agents-sdk/WorkspaceNavigationRestoration.d.ts
+interface WorkspaceNavigationRestoration {
+  focusDestination?: WorkspaceDestination;
+  focusScope?: string;
+  scrollTop?: number;
+}
+interface WorkspaceNavigationRestorationContextValue {
+  get(entryKey: string): WorkspaceNavigationRestoration | undefined;
+  recordFocus(entryKey: string, destination: WorkspaceDestination, scope?: string): void;
+  recordScroll(entryKey: string, scrollTop: number): void;
+}
+/**
+ * Owns entry-keyed presentation state unless an ancestor already provides it.
+ * This lets a full application share restoration between chat and files while
+ * keeping a standalone WorkspaceExplorer self-contained.
+ */
+declare function WorkspaceNavigationRestorationBoundary({
+  children
+}: {
+  children: React.ReactNode;
+}): string | number | bigint | boolean | React.JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
+/** Restores a link in a named surface, including when that surface renders asynchronously. */
+declare function WorkspaceNavigationFocusRestorer({
+  entryKey,
+  rootRef,
+  scope
+}: {
+  entryKey: string;
+  rootRef: React.RefObject<HTMLElement | null>;
+  scope: string;
+}): null;
+declare function useWorkspaceNavigationRestoration(): WorkspaceNavigationRestorationContextValue | null;
+declare function useRequiredWorkspaceNavigationRestoration(): WorkspaceNavigationRestorationContextValue;
+//#endregion
+export { WorkspaceNavigationFocusRestorer, WorkspaceNavigationRestoration, WorkspaceNavigationRestorationBoundary, WorkspaceNavigationRestorationContextValue, useRequiredWorkspaceNavigationRestoration, useWorkspaceNavigationRestoration };

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

@@ -0,0 +1,86 @@
+import * as React from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/components/agents-sdk/WorkspaceNavigationRestoration.tsx
+const WorkspaceNavigationRestorationContext = React.createContext(null);
+/**
+* Owns entry-keyed presentation state unless an ancestor already provides it.
+* This lets a full application share restoration between chat and files while
+* keeping a standalone WorkspaceExplorer self-contained.
+*/
+function WorkspaceNavigationRestorationBoundary({ children }) {
+	const parent = React.use(WorkspaceNavigationRestorationContext);
+	const restorationsRef = React.useRef(/* @__PURE__ */ new Map());
+	const localValue = React.useMemo(() => ({
+		get: (entryKey) => restorationsRef.current.get(entryKey),
+		recordFocus: (entryKey, destination, scope) => {
+			const current = restorationsRef.current.get(entryKey);
+			restorationsRef.current.set(entryKey, {
+				...current,
+				focusDestination: destination,
+				focusScope: scope
+			});
+		},
+		recordScroll: (entryKey, scrollTop) => {
+			const current = restorationsRef.current.get(entryKey);
+			restorationsRef.current.set(entryKey, {
+				...current,
+				scrollTop
+			});
+		}
+	}), []);
+	if (parent) return children;
+	return /* @__PURE__ */ jsx(WorkspaceNavigationRestorationContext, {
+		value: localValue,
+		children
+	});
+}
+function findDestinationLink(root, destination) {
+	if (destination.kind !== "file") return null;
+	return [...root.querySelectorAll("[data-workspace-link=\"file\"]")].find((candidate) => candidate.dataset.workspacePath === destination.path && (candidate.dataset.workspaceDestinationFragment || null) === destination.fragment) ?? null;
+}
+/** Restores a link in a named surface, including when that surface renders asynchronously. */
+function WorkspaceNavigationFocusRestorer({ entryKey, rootRef, scope }) {
+	const restoration = useWorkspaceNavigationRestoration();
+	const handledEntryRef = React.useRef(null);
+	React.useEffect(() => {
+		if (handledEntryRef.current === entryKey) return;
+		const saved = restoration?.get(entryKey);
+		if (!saved?.focusDestination || saved.focusScope !== scope) return;
+		const focusDestination = saved.focusDestination;
+		const root = rootRef.current;
+		if (!root) return;
+		const restore = () => {
+			const surface = [...root.matches("[data-workspace-restoration-scope]") ? [root] : [], ...root.querySelectorAll("[data-workspace-restoration-scope]")].find((candidate) => candidate.dataset.workspaceRestorationScope === scope);
+			const target = surface ? findDestinationLink(surface, focusDestination) : null;
+			if (!target) return false;
+			target.focus({ preventScroll: true });
+			handledEntryRef.current = entryKey;
+			return true;
+		};
+		if (restore()) return;
+		const observer = new MutationObserver(() => {
+			if (restore()) observer.disconnect();
+		});
+		observer.observe(root, {
+			childList: true,
+			subtree: true
+		});
+		return () => observer.disconnect();
+	}, [
+		entryKey,
+		restoration,
+		rootRef,
+		scope
+	]);
+	return null;
+}
+function useWorkspaceNavigationRestoration() {
+	return React.use(WorkspaceNavigationRestorationContext);
+}
+function useRequiredWorkspaceNavigationRestoration() {
+	const restoration = useWorkspaceNavigationRestoration();
+	if (!restoration) throw new Error("Workspace navigation restoration is unavailable outside its boundary.");
+	return restoration;
+}
+//#endregion
+export { WorkspaceNavigationFocusRestorer, WorkspaceNavigationRestorationBoundary, useRequiredWorkspaceNavigationRestoration, useWorkspaceNavigationRestoration };

package/dist/components/agents-sdk/WorkspaceProject.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";
@@ -8,7 +7,22 @@ type WorkspaceProjectThreadOrigin = "user" | "routine" | "messenger";
 interface WorkspaceProjectFile {
   path: string;
   label: string;
-  onOpen?: () => void;
+}
+type WorkspaceProjectSectionItem = {
+  kind: "file";
+  path: string;
+  label: string;
+} | {
+  kind: "link";
+  href: string;
+  label: string;
+} | {
+  kind: "text";
+  label: string;
+};
+interface WorkspaceProjectSection {
+  label: string;
+  items: readonly WorkspaceProjectSectionItem[];
 }
 interface WorkspaceProjectThread {
   id: string;
@@ -16,7 +30,6 @@ interface WorkspaceProjectThread {
   origin: WorkspaceProjectThreadOrigin;
   /** Channel or origin mark. Messenger threads pass a brand favicon. */
   icon?: React.ReactNode;
-  onOpen?: () => void;
 }
 interface WorkspaceProject {
   /** Workspace path of PROJECT.md — directories are not addressable. */
@@ -26,7 +39,29 @@ interface WorkspaceProject {
   /** Brand mark. Defaults to `FolderIcon`. */
   icon?: React.ReactNode;
   files?: readonly WorkspaceProjectFile[];
+  /** Explicit groups authored under `## Working set` in PROJECT.md. */
+  sections?: readonly WorkspaceProjectSection[];
   threads?: readonly WorkspaceProjectThread[];
+}
+type WorkspaceProjectOpenable = {
+  onOpen?: () => void;
+};
+type WorkspaceProjectFileView = WorkspaceProjectFile & WorkspaceProjectOpenable;
+type WorkspaceProjectSectionItemView = (Extract<WorkspaceProjectSectionItem, {
+  kind: "file";
+}> & WorkspaceProjectOpenable) | Exclude<WorkspaceProjectSectionItem, {
+  kind: "file";
+}>;
+interface WorkspaceProjectSectionView {
+  label: string;
+  items: readonly WorkspaceProjectSectionItemView[];
+}
+type WorkspaceProjectThreadView = WorkspaceProjectThread & WorkspaceProjectOpenable;
+/** Data-only project projection hydrated with card actions outside Query. */
+interface WorkspaceProjectView extends Omit<WorkspaceProject, "files" | "sections" | "threads"> {
+  files?: readonly WorkspaceProjectFileView[];
+  sections?: readonly WorkspaceProjectSectionView[];
+  threads?: readonly WorkspaceProjectThreadView[];
   onOpen?: () => void;
   onDelete?: () => void | Promise<void>;
 }
@@ -38,7 +73,7 @@ interface WorkspaceProjectSource {
   onDelete?: (path: string) => void | Promise<void>;
 }
 interface WorkspaceProjectCardProps extends Omit<CardProps, "children" | "hover" | "size" | "title"> {
-  project: WorkspaceProject;
+  project: WorkspaceProjectView;
 }
 interface WorkspaceProjectFileCardProps extends Omit<WorkspaceProjectCardProps, "project"> {
   path: string;
@@ -46,10 +81,8 @@ interface WorkspaceProjectFileCardProps extends Omit<WorkspaceProjectCardProps,
   fallback?: React.ReactNode;
 }
 interface WorkspaceProjectsPanelProps extends Omit<React.HTMLAttributes<HTMLElement>, "children"> {
-  projects: readonly WorkspaceProject[];
-  /** Query failure to show instead of the empty state. Loaded projects win. */
-  error?: string;
-  onRetry?: () => void;
+  /** Shared workspace query and host actions, also used by inline project cards. */
+  source: WorkspaceProjectSource;
 }
 declare function WorkspaceProjectCard({
   className,
@@ -79,15 +112,11 @@ declare function useWorkspaceProjects(source: WorkspaceProjectSource): readonly
  */
 declare function WorkspaceProjectsPanel({
   className,
-  error,
-  projects,
-  onRetry,
+  source,
   ref,
   ...props
 }: WorkspaceProjectsPanelProps & {
-  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 workspaceProjectsPanel(source: WorkspaceProjectSource): ThinkFullAppPanel;
 //#endregion
-export { WorkspaceProject, WorkspaceProjectCard, WorkspaceProjectCardProps, WorkspaceProjectFile, WorkspaceProjectFileCard, WorkspaceProjectFileCardProps, WorkspaceProjectSource, WorkspaceProjectThread, WorkspaceProjectThreadOrigin, WorkspaceProjectsPanel, WorkspaceProjectsPanelProps, useWorkspaceProjects, workspaceProjectsPanel };
+export { WorkspaceProject, WorkspaceProjectCard, WorkspaceProjectCardProps, WorkspaceProjectFile, WorkspaceProjectFileCard, WorkspaceProjectFileCardProps, WorkspaceProjectFileView, WorkspaceProjectSection, WorkspaceProjectSectionItem, WorkspaceProjectSectionItemView, WorkspaceProjectSectionView, WorkspaceProjectSource, WorkspaceProjectThread, WorkspaceProjectThreadOrigin, WorkspaceProjectThreadView, WorkspaceProjectView, WorkspaceProjectsPanel, WorkspaceProjectsPanelProps, useWorkspaceProjects };

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

@@ -1,12 +1,13 @@
 import { t as cx } from "../../class-names-BiMDVpUo.js";
-import { $ as UserIcon, C as FolderIcon, S as FileIcon, j as MessageSquareIcon, u as CalendarIcon } from "../../icons-cuEtsgj9.js";
+import { $ as UserIcon, C as FolderIcon, D as LinkIcon, K as SpinnerIcon, S as FileIcon, j as MessageSquareIcon, u as CalendarIcon } from "../../icons-cuEtsgj9.js";
 import { Button } from "../foundations/Button.js";
 import { IconButton } from "../foundations/IconButton.js";
 import { a as formatErrorMessage } from "../../format-COCyV98Z.js";
 import { EmptyState } from "../foundations/EmptyState.js";
+import { LinkButton } from "../foundations/LinkButton.js";
 import { DescriptionList } from "../foundations/DescriptionList.js";
 import { Card, CardAction, CardContent, CardDescription, CardHeader, CardTitle } from "../foundations/Card.js";
-import { i as WorkspaceDeleteControl, n as WorkspaceComposerLink } from "../../workspace-assets-CxpEHsac.js";
+import { i as WorkspaceDeleteControl, n as WorkspaceComposerLink, t as FaviconMark } from "../../workspace-assets-Bg7XhPsk.js";
 import * as React from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useQuery } from "@tanstack/react-query";
@@ -51,30 +52,55 @@ function LinkList({ items }) {
 	});
 }
 function ProjectDetails({ project }) {
-	const files = (project.files ?? []).filter((file) => !file.path.endsWith("/PROJECT.md"));
+	const referencedFiles = new Set((project.sections ?? []).flatMap(({ items }) => items.flatMap((item) => item.kind === "file" ? [item.path] : [])));
+	const files = (project.files ?? []).filter((file) => !file.path.endsWith("/PROJECT.md") && !referencedFiles.has(file.path));
+	const sections = (project.sections ?? []).filter(({ items }) => items.length > 0);
 	const threads = project.threads ?? [];
-	if (files.length === 0 && threads.length === 0) return null;
+	if (files.length === 0 && sections.length === 0 && threads.length === 0) return null;
 	return /* @__PURE__ */ jsxs(DescriptionList.Root, {
 		align: "start",
 		variant: "divided",
-		children: [files.length > 0 ? /* @__PURE__ */ jsxs(DescriptionList.Item, { children: [/* @__PURE__ */ jsx(DescriptionList.Term, { children: "Contents" }), /* @__PURE__ */ jsx(DescriptionList.Details, { children: /* @__PURE__ */ jsx("div", {
-			className: "sigvelo-cluster",
-			children: files.map((file) => /* @__PURE__ */ jsx(WorkspaceComposerLink, {
-				value: file.path,
-				label: file.label,
-				hint: file.path,
-				onOpen: file.onOpen
-			}, file.path))
-		}) })] }) : null, ORIGIN_ORDER.map((origin) => {
-			const grouped = threads.filter((thread) => thread.origin === origin);
-			if (grouped.length === 0) return null;
-			return /* @__PURE__ */ jsxs(DescriptionList.Item, { children: [/* @__PURE__ */ jsx(DescriptionList.Term, { children: ORIGIN_LABEL[origin] }), /* @__PURE__ */ jsx(DescriptionList.Details, { children: /* @__PURE__ */ jsx(LinkList, { items: grouped.map((thread) => ({
-				key: thread.id,
-				label: thread.title,
-				icon: thread.icon ?? ORIGIN_ICON[origin],
-				onOpen: thread.onOpen
-			})) }) })] }, origin);
-		})]
+		children: [
+			sections.map((section) => /* @__PURE__ */ jsxs(DescriptionList.Item, { children: [/* @__PURE__ */ jsx(DescriptionList.Term, { children: section.label }), /* @__PURE__ */ jsx(DescriptionList.Details, { children: /* @__PURE__ */ jsx("div", {
+				className: "sigvelo-cluster",
+				children: section.items.map((item) => item.kind === "file" ? /* @__PURE__ */ jsx(WorkspaceComposerLink, {
+					value: item.path,
+					label: item.label,
+					hint: item.path,
+					onOpen: item.onOpen
+				}, `${item.kind}:${item.path}`) : item.kind === "link" ? /* @__PURE__ */ jsxs(LinkButton, {
+					href: item.href,
+					target: "_blank",
+					rel: "noreferrer",
+					variant: "link",
+					color: "neutral",
+					size: "xs",
+					children: [/* @__PURE__ */ jsx(FaviconMark, {
+						href: item.href,
+						fallback: /* @__PURE__ */ jsx(LinkIcon, {})
+					}), item.label]
+				}, `${item.kind}:${item.href}`) : /* @__PURE__ */ jsx("span", { children: item.label }, `${item.kind}:${item.label}`))
+			}) })] }, section.label)),
+			files.length > 0 ? /* @__PURE__ */ jsxs(DescriptionList.Item, { children: [/* @__PURE__ */ jsx(DescriptionList.Term, { children: "Contents" }), /* @__PURE__ */ jsx(DescriptionList.Details, { children: /* @__PURE__ */ jsx("div", {
+				className: "sigvelo-cluster",
+				children: files.map((file) => /* @__PURE__ */ jsx(WorkspaceComposerLink, {
+					value: file.path,
+					label: file.label,
+					hint: file.path,
+					onOpen: file.onOpen
+				}, file.path))
+			}) })] }) : null,
+			ORIGIN_ORDER.map((origin) => {
+				const grouped = threads.filter((thread) => thread.origin === origin);
+				if (grouped.length === 0) return null;
+				return /* @__PURE__ */ jsxs(DescriptionList.Item, { children: [/* @__PURE__ */ jsx(DescriptionList.Term, { children: ORIGIN_LABEL[origin] }), /* @__PURE__ */ jsx(DescriptionList.Details, { children: /* @__PURE__ */ jsx(LinkList, { items: grouped.map((thread) => ({
+					key: thread.id,
+					label: thread.title,
+					icon: thread.icon ?? ORIGIN_ICON[origin],
+					onOpen: thread.onOpen
+				})) }) })] }, origin);
+			})
+		]
 	});
 }
 function WorkspaceProjectCard({ className, project, ref, ...props }) {
@@ -93,7 +119,10 @@ function WorkspaceProjectCard({ className, project, 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",
@@ -126,7 +155,7 @@ function WorkspaceProjectFileCard({ fallback = null, path, source, ...props }) {
 	return project ? /* @__PURE__ */ jsx(WorkspaceProjectCard, {
 		...props,
 		project: projectWithSource(project, source)
-	}) : fallback;
+	}, JSON.stringify(source.queryOptions.queryKey)) : fallback;
 }
 /** Design-system-owned project query shared by panels, cards, and composer context. */
 function useWorkspaceProjects(source) {
@@ -137,7 +166,9 @@ function useWorkspaceProjects(source) {
 * query failure with nothing loaded renders as a quiet inline error, never as
 * an empty library.
 */
-function WorkspaceProjectsPanel({ className, error, projects, onRetry, ref, ...props }) {
+function WorkspaceProjectsPanel({ className, source, ref, ...props }) {
+	const query = useQuery(source.queryOptions);
+	const projects = query.data ?? [];
 	return /* @__PURE__ */ jsx("section", {
 		ref,
 		"data-slot": "workspace-projects-panel",
@@ -146,23 +177,26 @@ function WorkspaceProjectsPanel({ className, error, projects, onRetry, ref, ...p
 		"aria-label": props["aria-label"] ?? "Projects",
 		children: projects.length > 0 ? /* @__PURE__ */ jsx("ul", {
 			className: "sigvelo-stack-list sigvelo-stack",
-			children: projects.map((project) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(WorkspaceProjectCard, { project }) }, project.path))
-		}) : error !== void 0 ? /* @__PURE__ */ jsx(EmptyState, {
+			children: projects.map((project) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(WorkspaceProjectCard, { project: projectWithSource(project, source) }) }, project.path))
+		}) : query.error ? /* @__PURE__ */ jsx(EmptyState, {
 			icon: /* @__PURE__ */ jsx(FolderIcon, {}),
 			title: "Projects 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
+			})
+		}) : query.isPending ? /* @__PURE__ */ jsx(EmptyState, {
+			icon: /* @__PURE__ */ jsx(SpinnerIcon, {}),
+			title: "Loading projects"
 		}) : /* @__PURE__ */ jsx(EmptyState, {
 			icon: /* @__PURE__ */ jsx(FolderIcon, {}),
 			title: "No projects"
 		})
-	});
+	}, JSON.stringify(source.queryOptions.queryKey));
 }
 function projectWithSource(project, source) {
 	return {
@@ -171,6 +205,13 @@ function projectWithSource(project, source) {
 			...file,
 			onOpen: source.onOpenFile ? () => source.onOpenFile?.(file.path) : void 0
 		})),
+		sections: project.sections?.map((section) => ({
+			...section,
+			items: section.items.map((item) => item.kind === "file" ? {
+				...item,
+				onOpen: source.onOpenFile ? () => source.onOpenFile?.(item.path) : void 0
+			} : item)
+		})),
 		threads: project.threads?.map((thread) => ({
 			...thread,
 			onOpen: source.onOpenThread ? () => source.onOpenThread?.(thread.id) : void 0
@@ -179,23 +220,5 @@ function projectWithSource(project, source) {
 		onDelete: source.onDelete ? () => source.onDelete?.(project.path) : void 0
 	};
 }
-function WorkspaceProjectSourcePanel({ source }) {
-	const query = useQuery(source.queryOptions);
-	return /* @__PURE__ */ jsx(WorkspaceProjectsPanel, {
-		projects: (query.data ?? []).map((project) => projectWithSource(project, source)),
-		error: query.isError ? formatErrorMessage(query.error) : void 0,
-		onRetry: query.isError ? () => void query.refetch() : void 0,
-		"aria-busy": query.isFetching || void 0
-	});
-}
-/** Canonical workbench descriptor; hosts supply only the source adapter. */
-function workspaceProjectsPanel(source) {
-	return {
-		id: "projects",
-		label: "Projects",
-		icon: /* @__PURE__ */ jsx(FolderIcon, {}),
-		render: () => /* @__PURE__ */ jsx(WorkspaceProjectSourcePanel, { source })
-	};
-}
 //#endregion
-export { WorkspaceProjectCard, WorkspaceProjectFileCard, WorkspaceProjectsPanel, useWorkspaceProjects, workspaceProjectsPanel };
+export { WorkspaceProjectCard, WorkspaceProjectFileCard, WorkspaceProjectsPanel, useWorkspaceProjects };

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

@@ -41,7 +41,7 @@ declare function WorkspaceUserScriptsPanel({
   scripts,
   ...props
 }: WorkspaceUserScriptsPanelProps & {
-  ref?: React.Ref<HTMLElement>;
+  /** Ref forwarded to the component's rendered root element. */ref?: React.Ref<HTMLElement>;
 }): React.JSX.Element;
 //#endregion
 export { WorkspaceUserScript, WorkspaceUserScriptCard, WorkspaceUserScriptCardProps, WorkspaceUserScriptsPanel, WorkspaceUserScriptsPanelProps };

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

@@ -5,7 +5,7 @@ import { EmptyState } from "../foundations/EmptyState.js";
 import { DescriptionList } from "../foundations/DescriptionList.js";
 import { Switch } from "../foundations/Switch.js";
 import { Card, CardAction, CardContent, CardDescription, CardHeader, CardTitle } from "../foundations/Card.js";
-import { i as WorkspaceDeleteControl, n as WorkspaceComposerLink, t as FaviconMark } from "../../workspace-assets-CxpEHsac.js";
+import { i as WorkspaceDeleteControl, n as WorkspaceComposerLink, t as FaviconMark } from "../../workspace-assets-Bg7XhPsk.js";
 import * as React from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/components/agents-sdk/WorkspaceUserScript.tsx
@@ -93,7 +93,10 @@ function WorkspaceUserScriptCard({ className, script, 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",

package/dist/components/ai-sdk/Activity.d.ts

@@ -43,7 +43,7 @@ declare function Activity({
   ref,
   ...props
 }: ActivityProps & {
-  ref?: React.Ref<HTMLDivElement>;
+  /** Ref forwarded to the component's rendered root element. */ref?: React.Ref<HTMLDivElement>;
 }): React.JSX.Element;
 interface ActivityTriggerProps extends Omit<React.ComponentProps<typeof Collapsible.Trigger>, "unstyled" | "children"> {
   /** The action being taken. Defaults to "Working…". */