@mcp-b/react-components 0.46.7 → 0.48.0

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

@@ -1,91 +1,2 @@
-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 extends Omit<React.HTMLAttributes<HTMLElement>, "onSelect" | "title"> {
-  /** Threads from the parent agent, already sorted in the order the app wants to show. */
-  threads: readonly ThinkThreadItem[];
-  /**
-   * 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: ThinkThreadItem) => 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: ThinkThreadItem) => void;
-  /** Optional parent-agent delete action, usually `parent.stub.deleteThread(thread.id)`. */
-  onDelete?: (thread: ThinkThreadItem) => 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({
-  threads,
-  renderThreadLink,
-  createThreadLink,
-  onSelect,
-  onDelete,
-  className,
-  title,
-  "aria-label": ariaLabel,
-  ref,
-  ...props
-}: ThinkThreadPickerProps & {
-  ref?: React.Ref<HTMLElement>;
-}): React.JSX.Element;
-//#endregion
+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";
 export { ThinkThreadItem, ThinkThreadPicker, ThinkThreadPickerProps, ThinkThreadStatusIndicators, ThinkThreadStatusIndicatorsProps, ThinkThreadStatusSummary, summarizeThinkThreads };

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

@@ -1,5 +1,5 @@
 import { t as cx } from "../../class-names-BiMDVpUo.js";
-import { $ as WarningIcon, B as PlusIcon, K as SpinnerIcon, _ as DotIcon, t as ArchiveIcon } from "../../icons-BC4HZqSK.js";
+import { B as PlusIcon, K as SpinnerIcon, _ as DotIcon, et as WarningIcon, t as ArchiveIcon } from "../../icons-CeGfXO21.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";

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

@@ -1,2 +1,2 @@
-import { A as workspaceQueryKey, C as workspaceBinaryFileQueryOptions, D as workspaceFileAssetQueryOptions, E as workspaceDirectoryQueryPrefix, O as workspaceFileStatQueryOptions, S as useWorkspace, T as workspaceDirectoryQueryOptions, _ as WorkspaceResolvedAsset, a as WorkspaceDirectoryQueryOptions, b as WorkspaceTextFileQueryKey, c as WorkspaceFileQueryKey, d as WorkspaceFileStatQueryOptions, f as WorkspaceFileVersion, g as WorkspaceQueryKey, h as WorkspaceInfoQueryOptions, i as WorkspaceDirectoryQueryKey, j as workspaceTextFileQueryOptions, k as workspaceInfoQueryOptions, 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 WorkspaceSource, w as workspaceDirectoryQueryKey, x as WorkspaceTextFileQueryOptions, y as WorkspaceState } from "../../Workspace-DZusrEeP.js";
-export { UseWorkspaceOptions, WorkspaceBinaryFileQueryKey, WorkspaceBinaryFileQueryOptions, WorkspaceDirectoryQueryKey, WorkspaceDirectoryQueryOptions, WorkspaceFileAssetQueryKey, WorkspaceFileAssetQueryOptions, WorkspaceFileQueryKey, WorkspaceFileReadTarget, WorkspaceFileStatQueryKey, WorkspaceFileStatQueryOptions, WorkspaceFileVersion, WorkspaceInfo, WorkspaceInfoQueryKey, WorkspaceInfoQueryOptions, WorkspaceQueryKey, WorkspaceResolvedAsset, WorkspaceSource, WorkspaceState, WorkspaceTextFileQueryKey, WorkspaceTextFileQueryOptions, useWorkspace, workspaceBinaryFileQueryOptions, workspaceDirectoryQueryKey, workspaceDirectoryQueryOptions, workspaceDirectoryQueryPrefix, workspaceFileAssetQueryOptions, workspaceFileStatQueryOptions, workspaceInfoQueryOptions, workspaceQueryKey, workspaceTextFileQueryOptions };
+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";
+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

@@ -75,12 +75,15 @@ function workspaceDirectoryQueryPrefix(sourceKey, root) {
 function workspaceDirectoryQueryKey(sourceKey, root, path) {
 	return [...workspaceDirectoryQueryPrefix(sourceKey, root), path];
 }
+/** File-resource prefix shared by the exact resource keys below. */
+function workspaceFileQueryPrefix(sourceKey, root) {
+	return [...workspaceQueryKey(sourceKey, root), "file"];
+}
 function workspaceFileQueryKey(sourceKey, root, requestedPath) {
-	return [
-		...workspaceQueryKey(sourceKey, root),
-		"file",
-		requestedPath
-	];
+	return [...workspaceFileQueryPrefix(sourceKey, root), requestedPath];
+}
+function workspaceInfoQueryKey(sourceKey, root) {
+	return [...workspaceQueryKey(sourceKey, root), "info"];
 }
 function workspaceFileVersion(target) {
 	return {
@@ -119,7 +122,7 @@ function workspaceDirectoryQueryOptions(source, sourceKey, root, path) {
 /** Shared workspace-summary options for workspace components and route loaders. */
 function workspaceInfoQueryOptions(source, sourceKey, root) {
 	return queryOptions({
-		queryKey: [...workspaceQueryKey(sourceKey, root), "info"],
+		queryKey: workspaceInfoQueryKey(sourceKey, root),
 		queryFn: async ({ signal }) => {
 			const info = await source.getWorkspaceInfo();
 			throwIfAborted(signal);
@@ -222,7 +225,7 @@ function workspaceBinaryFileQueryOptions(source, sourceKey, root, target, maxInl
 		retry: false
 	});
 }
-async function refreshWorkspaceFile(queryClient, { source, sourceKey, root, selectedPath, resolveFileAsset, maxInlineAssetBytes }) {
+async function refreshWorkspaceFileQueries(queryClient, { source, sourceKey, root, selectedPath, resolveFileAsset, maxInlineAssetBytes }) {
 	if (!selectedPath) return;
 	const target = await queryClient.fetchQuery({
 		...workspaceFileStatQueryOptions(source, sourceKey, root, selectedPath),
@@ -237,7 +240,7 @@ async function refreshWorkspaceFile(queryClient, { source, sourceKey, root, sele
 		})) return;
 	}
 	if (target.media) {
-		const options = workspaceBinaryFileQueryOptions(source, sourceKey, root, target, maxInlineAssetBytes);
+		const options = workspaceBinaryFileQueryOptions(source, sourceKey, root, target, maxInlineAssetBytes ?? DEFAULT_MAX_INLINE_ASSET_BYTES);
 		if (queryClient.getQueryState(options.queryKey)) await queryClient.fetchQuery({
 			...options,
 			staleTime: 0
@@ -407,7 +410,7 @@ function useWorkspace({ source, sourceKey, root = "/", selectedPath, onSelectedP
 				staleTime: 0
 			}).catch(() => void 0);
 			if (refreshedDirectories.includes(false)) return;
-			await refreshWorkspaceFile(queryClient, {
+			await refreshWorkspaceFileQueries(queryClient, {
 				source,
 				sourceKey,
 				root,
@@ -444,4 +447,4 @@ function useWorkspace({ source, sourceKey, root = "/", selectedPath, onSelectedP
 	};
 }
 //#endregion
-export { useWorkspace, workspaceBinaryFileQueryOptions, workspaceDirectoryQueryKey, workspaceDirectoryQueryOptions, workspaceDirectoryQueryPrefix, workspaceFileAssetQueryOptions, workspaceFileStatQueryOptions, workspaceInfoQueryOptions, workspaceQueryKey, workspaceTextFileQueryOptions };
+export { refreshWorkspaceFileQueries, useWorkspace, workspaceBinaryFileQueryOptions, workspaceDirectoryQueryKey, workspaceDirectoryQueryOptions, workspaceDirectoryQueryPrefix, workspaceFileAssetQueryOptions, workspaceFileQueryKey, workspaceFileStatQueryOptions, workspaceInfoQueryKey, workspaceInfoQueryOptions, workspaceQueryKey, workspaceTextFileQueryOptions };

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

@@ -1,4 +1,4 @@
-import { y as WorkspaceState } from "../../Workspace-DZusrEeP.js";
+import { b as WorkspaceState } from "../../Workspace-LIoU30n7.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-jtP9471I.js";
+import { i as FileTreeFolder, r as FileTreeFile, t as FileTree } from "../../FileTree-DvE0hNZu.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

@@ -0,0 +1,45 @@
+import { _ as WorkspaceQueryOptions, g as WorkspaceQueryKey } from "../../Workspace-LIoU30n7.js";
+import { QueryClient, QueryFunction } from "@tanstack/react-query";
+
+//#region src/components/agents-sdk/WorkspaceConcept.d.ts
+/**
+ * Concept query identity is what the data is: source, root, concept, scope.
+ * Freshness never lives in the key — external changes arrive as invalidation
+ * through `useWorkspaceLiveQueries` (native observer events or the host's
+ * `revision` tick), so cards keep their data, mutation state, and typed form
+ * drafts across refreshes.
+ */
+type WorkspaceConceptQueryKey = readonly [...WorkspaceQueryKey, "concept", concept: string, scope: string];
+type WorkspaceConceptQueryOptions<TData> = WorkspaceQueryOptions<TData, WorkspaceConceptQueryKey>;
+interface WorkspaceConceptQueryInput<TData> {
+  sourceKey: string;
+  /**
+   * The host's workspace boundary. Required, and never defaulted: concept keys
+   * and live invalidation must agree on one root, and a silent `"/"` default on
+   * either side leaves a host with a nested root receiving zero invalidations.
+   */
+  root: string;
+  concept: string;
+  /** The workspace path (file or directory) this projection reads. */
+  scope: string;
+  queryFn: QueryFunction<TData, WorkspaceConceptQueryKey>;
+}
+declare function workspaceConceptQueryPrefix(sourceKey: string, root: string): readonly ["workspace", string, string, "concept"];
+declare function workspaceConceptQueryKey(sourceKey: string, root: string, concept: string, scope: string): WorkspaceConceptQueryKey;
+/** Shared concept options for design-system components and host loaders. */
+declare function workspaceConceptQueryOptions<TData>({
+  sourceKey,
+  root,
+  concept,
+  scope,
+  queryFn
+}: WorkspaceConceptQueryInput<TData>): WorkspaceConceptQueryOptions<TData>;
+declare function workspacePathsOverlap(left: string, right: string): boolean;
+/**
+ * Invalidate active concept queries touched by an external workspace change.
+ * `root` is required and must be the same root the concept options were built
+ * with — the prefix is derived from it, so a mismatch invalidates nothing.
+ */
+declare function invalidateWorkspaceConceptQueries(queryClient: QueryClient, sourceKey: string, root: string, changedPaths?: readonly string[]): Promise<void>;
+//#endregion
+export { WorkspaceConceptQueryInput, WorkspaceConceptQueryKey, WorkspaceConceptQueryOptions, invalidateWorkspaceConceptQueries, workspaceConceptQueryKey, workspaceConceptQueryOptions, workspaceConceptQueryPrefix, workspacePathsOverlap };

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

@@ -0,0 +1,42 @@
+import { workspaceQueryKey } from "./Workspace.js";
+import { queryOptions } from "@tanstack/react-query";
+//#region src/components/agents-sdk/WorkspaceConcept.ts
+function workspaceConceptQueryPrefix(sourceKey, root) {
+	return [...workspaceQueryKey(sourceKey, root), "concept"];
+}
+function workspaceConceptQueryKey(sourceKey, root, concept, scope) {
+	return [
+		...workspaceConceptQueryPrefix(sourceKey, root),
+		concept,
+		scope
+	];
+}
+/** Shared concept options for design-system components and host loaders. */
+function workspaceConceptQueryOptions({ sourceKey, root, concept, scope, queryFn }) {
+	return queryOptions({
+		queryKey: workspaceConceptQueryKey(sourceKey, root, concept, scope),
+		queryFn,
+		staleTime: Infinity
+	});
+}
+function workspacePathsOverlap(left, right) {
+	return left === right || left === "/" || right === "/" || left.startsWith(`${right}/`) || right.startsWith(`${left}/`);
+}
+/**
+* Invalidate active concept queries touched by an external workspace change.
+* `root` is required and must be the same root the concept options were built
+* with — the prefix is derived from it, so a mismatch invalidates nothing.
+*/
+function invalidateWorkspaceConceptQueries(queryClient, sourceKey, root, changedPaths) {
+	const prefix = workspaceConceptQueryPrefix(sourceKey, root);
+	return queryClient.invalidateQueries({
+		queryKey: prefix,
+		predicate: (query) => {
+			if (!changedPaths || changedPaths.length === 0) return true;
+			const scope = query.queryKey[prefix.length + 1];
+			return typeof scope === "string" && changedPaths.some((path) => workspacePathsOverlap(scope, path));
+		}
+	});
+}
+//#endregion
+export { invalidateWorkspaceConceptQueries, workspaceConceptQueryKey, workspaceConceptQueryOptions, workspaceConceptQueryPrefix, workspacePathsOverlap };

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

@@ -0,0 +1,96 @@
+import { WorkspaceConceptQueryOptions } from "./WorkspaceConcept.js";
+import { CardProps } from "../foundations/Card.js";
+import { ConnectedAppCardSaveState } from "../ai-sdk/ConnectedAppCards.js";
+import * as React from "react";
+
+//#region src/components/agents-sdk/WorkspaceCorrespondence.d.ts
+interface WorkspaceCorrespondenceField {
+  name: string;
+  label: string;
+  value: string;
+}
+interface WorkspaceCorrespondenceDraft {
+  fields: readonly WorkspaceCorrespondenceField[];
+  body: string;
+}
+/**
+ * Lifecycle of the reviewed file. `draft` is editable and sendable; `sent`
+ * renders the snapshot. `WorkspaceCorrespondenceFile` latches `sent` for the
+ * session after `onSend` resolves; a host with real delivery state overrides
+ * the latch by setting `state` on the queried data.
+ */
+type WorkspaceCorrespondenceState = "draft" | "sent";
+interface WorkspaceCorrespondence extends WorkspaceCorrespondenceDraft {
+  kind: string;
+  path: string;
+  state?: WorkspaceCorrespondenceState;
+}
+interface WorkspaceCorrespondenceSource {
+  queryOptions: WorkspaceConceptQueryOptions<WorkspaceCorrespondence | null>;
+  onChange?: (path: string, next: WorkspaceCorrespondenceDraft) => Promise<void>;
+  onSend?: (path: string) => Promise<void>;
+  onOpen?: (path: string) => void;
+  onDelete?: (path: string) => void | Promise<void>;
+}
+interface WorkspaceCorrespondenceCardProps extends Omit<CardProps, "children" | "hover" | "size" | "title" | "onChange"> {
+  kind: string;
+  path: string;
+  fields: readonly WorkspaceCorrespondenceField[];
+  body: string;
+  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;
+  onChange?: (next: WorkspaceCorrespondenceDraft) => void;
+  onSend?: () => void | Promise<void>;
+  onOpen?: () => void;
+  onDelete?: () => void | Promise<void>;
+}
+interface WorkspaceCorrespondenceFileProps extends Omit<WorkspaceCorrespondenceCardProps, "body" | "fields" | "kind" | "onChange" | "onDelete" | "onOpen" | "onSend" | "path" | "saveState" | "state"> {
+  source: WorkspaceCorrespondenceSource;
+  fallback?: React.ReactNode;
+}
+/**
+ * Reviewed workspace correspondence. The host passes one normalized file
+ * shape; this component owns channel-specific presentation, the sent
+ * snapshot, and falls back to the generic card for kinds without a richer
+ * design-system surface.
+ */
+declare function WorkspaceCorrespondenceCard({
+  body,
+  fields,
+  kind,
+  path,
+  icon,
+  saveState,
+  state,
+  onChange,
+  onDelete,
+  onOpen,
+  onSend,
+  ref,
+  ...props
+}: WorkspaceCorrespondenceCardProps & {
+  ref?: React.Ref<HTMLDivElement>;
+}): React.JSX.Element;
+/**
+ * Query-backed reviewed correspondence. The host supplies normalized reads
+ * and writes; this adapter owns the draft, its debounced save lifecycle, the
+ * save-gated Send, and the session sent latch.
+ *
+ * The visible draft is interaction state layered over query data, so an
+ * observer-driven refetch can never clobber typing, and a failed save is
+ * shown with a retry affordance instead of rendering as success. Send always
+ * flushes the outstanding edit first and refuses when that save fails — the
+ * agent must never be told to send content the workspace does not hold.
+ *
+ * Interaction state belongs to one query identity. The keyed session makes a
+ * source swap a real unmount, so an old save or send cannot settle onto the
+ * next file.
+ */
+declare function WorkspaceCorrespondenceFile(props: WorkspaceCorrespondenceFileProps & {
+  ref?: React.Ref<HTMLDivElement>;
+}): React.JSX.Element;
+//#endregion
+export { WorkspaceCorrespondence, WorkspaceCorrespondenceCard, WorkspaceCorrespondenceCardProps, WorkspaceCorrespondenceDraft, WorkspaceCorrespondenceField, WorkspaceCorrespondenceFile, WorkspaceCorrespondenceFileProps, WorkspaceCorrespondenceSource, WorkspaceCorrespondenceState };