@mcp-b/react-components 0.17.0 → 0.18.0

package/dist/{ThinkChat-DInElus-.js → ThinkChat-15EhfvYJ.js}

@@ -8,6 +8,7 @@ import * as React from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useAgentChat } from "@cloudflare/think/react";
 import { useAgent, useAgentToolEvents } from "agents/react";
+import { queryOptions, useQuery, useQueryClient } from "@tanstack/react-query";
 //#region src/components/_internal/think-approvals.ts
 /**
 * Ambient approvals belong to their stub. An explicit different stub may only
@@ -23,54 +24,69 @@ function resolveThinkApprovalProps(overrides, ambient) {
 }
 //#endregion
 //#region src/components/ThinkChat.tsx
+const EMPTY_PENDING_APPROVALS = [];
 function toAgentChatStatus(chat) {
 	if (chat.status === "submitted") return "submitted";
 	if (chat.isStreaming || chat.isRecovering) return "streaming";
 	return chat.status ?? "ready";
 }
-function useThinkPendingApprovals(stub, refreshKey) {
-	const requestIdRef = React.useRef(0);
-	const [state, setState] = React.useState(() => ({
-		source: stub,
-		pendingApprovals: []
-	}));
-	const refresh = React.useCallback(async () => {
-		const requestId = ++requestIdRef.current;
-		try {
-			const pendingApprovals = await stub.pendingApprovals();
-			if (requestId !== requestIdRef.current) return;
-			setState({
-				source: stub,
-				pendingApprovals
-			});
-		} catch {
-			if (requestId !== requestIdRef.current) return;
-			setState({
-				source: stub,
-				pendingApprovals: []
-			});
-		}
-	}, [stub]);
-	React.useEffect(() => {
-		requestIdRef.current += 1;
-		setState((current) => current.source === stub ? current : {
-			source: stub,
-			pendingApprovals: []
-		});
-		refresh();
-		return () => {
-			requestIdRef.current += 1;
+function thinkPendingExecutionApprovalsQueryKey(sourceKey) {
+	return [
+		"think",
+		sourceKey,
+		"pending-approvals"
+	];
+}
+/** Shared pending-approval options for components and TanStack Router loaders. */
+function thinkPendingExecutionApprovalsQueryOptions(stub, sourceKey) {
+	return queryOptions({
+		queryKey: thinkPendingExecutionApprovalsQueryKey(sourceKey),
+		queryFn: () => stub.pendingApprovals(),
+		staleTime: 5e3
+	});
+}
+function useThinkPendingExecutionApprovals(stub, sourceKey, refreshSignal) {
+	const queryClient = useQueryClient();
+	const approvalsQuery = useQuery(thinkPendingExecutionApprovalsQueryOptions(stub, sourceKey));
+	const refreshState = React.useRef({
+		sourceKey,
+		observedSignal: refreshSignal,
+		pending: false
+	});
+	const refetch = React.useEffectEvent(() => approvalsQuery.refetch());
+	const refreshPendingApprovals = React.useCallback(async () => {
+		const filters = {
+			queryKey: thinkPendingExecutionApprovalsQueryKey(sourceKey),
+			exact: true
 		};
+		await queryClient.cancelQueries(filters);
+		await queryClient.invalidateQueries(filters);
+	}, [queryClient, sourceKey]);
+	React.useEffect(() => {
+		if (refreshState.current.sourceKey !== sourceKey) {
+			refreshState.current = {
+				sourceKey,
+				observedSignal: refreshSignal,
+				pending: false
+			};
+			return;
+		}
+		if (!Object.is(refreshState.current.observedSignal, refreshSignal)) {
+			refreshState.current.observedSignal = refreshSignal;
+			refreshState.current.pending = true;
+		}
+		if (approvalsQuery.isFetching || !refreshState.current.pending) return;
+		refreshState.current.pending = false;
+		refetch();
 	}, [
-		refresh,
-		refreshKey,
-		stub
+		approvalsQuery.isFetching,
+		refreshSignal,
+		sourceKey
 	]);
-	const pendingApprovals = state.source === stub ? state.pendingApprovals : [];
 	return React.useMemo(() => ({
-		pendingApprovals,
-		refreshPendingApprovals: refresh
-	}), [pendingApprovals, refresh]);
+		pendingApprovals: approvalsQuery.data ?? EMPTY_PENDING_APPROVALS,
+		refreshPendingApprovals
+	}), [approvalsQuery.data, refreshPendingApprovals]);
 }
 /**
 * Chat UI for Cloudflare Think agents. Provide a `useAgentChat` value (or let
@@ -90,16 +106,23 @@ function ThinkChatProvider({ agentTools, chat, children }) {
 /**
 * Batteries-included root: connects to the named Think agent (upstream's
 * `useAgent` + `useAgentChat`) and provides the live chat to everything
-* inside. If the app already owns the chat hook, use `ThinkChat.Provider`.
+* inside. Render it beneath the app's `QueryClientProvider`. If the app
+* already owns the chat hook, use `ThinkChat.Provider`.
 *
 * @example
 * ```tsx
-* <ThinkChat.Root agent="my-agent" name="session-1">
-*   <ThinkChat.Messages />
-* </ThinkChat.Root>
+* <QueryClientProvider client={queryClient}>
+*   <ThinkChat.Root
+*     agent="my-agent"
+*     name="session-1"
+*     sourceKey="api.example.com:account:acme:agent:session-1"
+*   >
+*     <ThinkChat.Messages />
+*   </ThinkChat.Root>
+* </QueryClientProvider>
 * ```
 */
-function ThinkChatRoot({ agent: agentOption, name, children }) {
+function ThinkChatRoot({ agent: agentOption, name, sourceKey, children }) {
 	const agent = useAgent(typeof agentOption === "string" ? {
 		agent: agentOption,
 		name
@@ -110,19 +133,21 @@ function ThinkChatRoot({ agent: agentOption, name, children }) {
 	const chat = useAgentChat({ agent });
 	const agentTools = useAgentToolEvents({ agent });
 	const agentIdentity = JSON.stringify(agent.path);
-	const approvals = useThinkPendingApprovals(agent.stub, `${chat.messages.length}:${chat.status}`);
+	const approvals = useThinkPendingExecutionApprovals(agent.stub, sourceKey, `${chat.messages.length}:${chat.status}`);
+	const resetAgentTools = React.useEffectEvent(() => agentTools.resetLocalState());
 	React.useEffect(() => {
-		agentTools.resetLocalState();
+		resetAgentTools();
 	}, [agentIdentity]);
+	const approvalsContext = React.useMemo(() => ({
+		...approvals,
+		thinkStub: agent.stub
+	}), [agent.stub, approvals]);
 	return /* @__PURE__ */ jsx(AgentToolRunsProvider, {
 		agentTools,
 		children: /* @__PURE__ */ jsx(ThinkChatContext.Provider, {
 			value: chat,
 			children: /* @__PURE__ */ jsx(ThinkChatApprovalsContext.Provider, {
-				value: {
-					...approvals,
-					thinkStub: agent.stub
-				},
+				value: approvalsContext,
 				children
 			})
 		})
@@ -139,7 +164,7 @@ const ThinkChatApprovalsContext = React.createContext(null);
 * inside the log) or `excludeTools` + your own `renderPart` (standalone
 * card) — see README "App-specific tools" and the Custom Tool Panel story.
 */
-function ThinkChatMessages({ composerHeader, renderPart, excludeTools, onAgentToolRunSelect, selectedAgentToolRunId, toolRenderers, thinkStub, onExecutionSettled, pendingApprovals, notice, ...props }) {
+function ThinkChatMessages({ composerHeader, renderPart, excludeTools, renderAgentToolRunLink, toolRenderers, thinkStub, onExecutionSettled, pendingApprovals, notice, ...props }) {
 	const chat = useThinkChatContext("ThinkChat.Messages");
 	const agentTools = useOptionalAgentToolRuns();
 	const approvals = React.useContext(ThinkChatApprovalsContext);
@@ -155,13 +180,11 @@ function ThinkChatMessages({ composerHeader, renderPart, excludeTools, onAgentTo
 	});
 	const defaultRenderPart = React.useMemo(() => createThinkChatActivityRenderer({
 		excludeTools,
-		onAgentToolRunSelect,
-		selectedAgentToolRunId,
+		renderAgentToolRunLink,
 		toolRenderers
 	}), [
 		excludeTools,
-		onAgentToolRunSelect,
-		selectedAgentToolRunId,
+		renderAgentToolRunLink,
 		toolRenderers
 	]);
 	const resolvedRenderPart = React.useMemo(() => renderPart ? (context) => {
@@ -176,8 +199,8 @@ function ThinkChatMessages({ composerHeader, renderPart, excludeTools, onAgentTo
 		return custom === void 0 ? renderBuiltIn() : custom;
 	} : defaultRenderPart, [defaultRenderPart, renderPart]);
 	const defaultNotice = /* @__PURE__ */ jsx(ThinkRecoveryNotice, { chat });
-	const backgroundRuns = onAgentToolRunSelect ? agentTools?.unboundRuns : void 0;
-	const resolvedComposerHeader = composerHeader || backgroundRuns?.length ? /* @__PURE__ */ jsxs(Fragment, { children: [composerHeader, backgroundRuns?.length ? /* @__PURE__ */ jsxs("div", {
+	const backgroundRuns = renderAgentToolRunLink ? agentTools?.unboundRuns : void 0;
+	const resolvedComposerHeader = composerHeader || backgroundRuns?.length ? /* @__PURE__ */ jsxs(Fragment, { children: [composerHeader, backgroundRuns?.length && renderAgentToolRunLink ? /* @__PURE__ */ jsxs("div", {
 		className: "subagent-run__tray",
 		"data-slot": "background-agent-runs",
 		children: [/* @__PURE__ */ jsx("span", {
@@ -186,8 +209,7 @@ function ThinkChatMessages({ composerHeader, renderPart, excludeTools, onAgentTo
 		}), /* @__PURE__ */ jsx(SubagentRunList, {
 			"aria-label": "Background agent runs",
 			runs: backgroundRuns,
-			selectedRunId: selectedAgentToolRunId,
-			onSelect: onAgentToolRunSelect
+			renderRunLink: renderAgentToolRunLink
 		})]
 	}) : null] }) : void 0;
 	return /* @__PURE__ */ jsx(AgentChat, {
@@ -205,7 +227,8 @@ function ThinkChatMessages({ composerHeader, renderPart, excludeTools, onAgentTo
 		onRegenerate: (messageId) => void chat.regenerate({ messageId }),
 		onSubmit: ({ text, files, references }) => {
 			const prompt = [...references?.map(({ trigger, value }) => trigger ? `${trigger}${value}` : value) ?? [], text.trim()].filter(Boolean).join(" ");
-			if (prompt || files.length) return chat.sendMessage({
+			if (!prompt && !files.length) return;
+			return chat.sendMessage({
 				text: prompt,
 				files
 			});
@@ -236,4 +259,4 @@ const ThinkChat = {
 	createActivityRenderer: createThinkChatActivityRenderer
 };
 //#endregion
-export { useThinkChat as a, ThinkChatRoot as i, ThinkChatMessages as n, useThinkPendingApprovals as o, ThinkChatProvider as r, resolveThinkApprovalProps as s, ThinkChat as t };
+export { thinkPendingExecutionApprovalsQueryOptions as a, resolveThinkApprovalProps as c, ThinkChatRoot as i, ThinkChatMessages as n, useThinkChat as o, ThinkChatProvider as r, useThinkPendingExecutionApprovals as s, ThinkChat as t };

package/dist/{ThinkChatActivity-BgesTfZ4.d.ts → ThinkChatActivity-Bzot45kX.d.ts}

@@ -1,5 +1,5 @@
 import { i as AgentMessageRenderPartContext } from "./AgentMessageParts-CyD2UB3V.js";
-import { r as AgentChatProps } from "./AgentChat-CRuMi1Pb.js";
+import { r as AgentChatProps } from "./AgentChat-ClxViuUM.js";
 import { l as ThinkChatPart } from "./ThinkChatToolParts-CSzVwMXf.js";
 import * as React from "react";
 import { DynamicToolUIPart, ToolUIPart, UIMessage } from "ai";
@@ -28,10 +28,8 @@ interface ThinkChatActivityRendererOptions<MessageT extends UIMessage = UIMessag
   excludeTools?: readonly string[];
   /** Per-tool label/panel overrides inside the activity log, keyed by tool name. */
   toolRenderers?: ThinkChatToolRenderers;
-  /** Selected retained child shown in an adjacent detail surface. */
-  selectedAgentToolRunId?: string | null;
-  /** Opens a whole upstream retained run in the host-owned detail surface. */
-  onAgentToolRunSelect?: (run: AgentToolRunState<MessageT["parts"][number]>) => void;
+  /** App-authored TanStack Router Link for each retained child destination. */
+  renderAgentToolRunLink?: (run: AgentToolRunState<MessageT["parts"][number]>) => React.ReactElement;
 }
 interface ThinkChatActivityProps {
   /** Render with the log expanded. */
@@ -64,8 +62,7 @@ declare function ThinkChatActivity({
  */
 declare function createThinkChatActivityRenderer<MessageT extends UIMessage = UIMessage>({
   excludeTools,
-  onAgentToolRunSelect,
-  selectedAgentToolRunId,
+  renderAgentToolRunLink,
   toolRenderers
 }?: ThinkChatActivityRendererOptions<MessageT>): NonNullable<AgentChatProps<MessageT>["renderPart"]>;
 /** Default activity renderer — `createThinkChatActivityRenderer()` with no overrides. */

package/dist/{ThinkChatActivitySummary-BPmu9a-c.d.ts → ThinkChatActivitySummary-D1xOrNrq.d.ts}

@@ -1,4 +1,4 @@
-import { i as AgentActivityIconKind, s as AgentActivitySummary } from "./AgentActivity-BNUNrP9O.js";
+import { i as AgentActivityIconKind, s as AgentActivitySummary } from "./AgentActivity-D2SHSGFX.js";
 import { l as ThinkChatPart } from "./ThinkChatToolParts-CSzVwMXf.js";
 import { DynamicToolUIPart, ToolUIPart } from "ai";
 

package/dist/{Toggle-DaXpe1Lc.d.ts → Toggle-JKZ43D5S.d.ts}

@@ -4,7 +4,7 @@ import { Toggle } from "@base-ui/react/toggle";
 //#region src/components/Toggle.d.ts
 interface ToggleVariantsOptions {
   variant?: "default" | "outline" | null;
-  size?: "default" | "sm" | "lg" | null;
+  size?: "sm" | "md" | "lg" | null;
   className?: string;
 }
 /**

package/dist/{ToggleGroup-yseEWkOC.d.ts → ToggleGroup-DNd6cDJZ.d.ts}

@@ -1,10 +1,10 @@
-import { r as ToggleVariantsOptions } from "./Toggle-DaXpe1Lc.js";
+import { r as ToggleVariantsOptions } from "./Toggle-JKZ43D5S.js";
 import * as React from "react";
 import { ToggleGroup } from "@base-ui/react/toggle-group";
 import { Toggle } from "@base-ui/react/toggle";
 
 //#region src/components/ToggleGroup.d.ts
-type ToggleGroupSize = ToggleVariantsOptions["size"] | "md";
+type ToggleGroupSize = ToggleVariantsOptions["size"];
 interface ToggleGroupProps extends React.ComponentPropsWithRef<typeof ToggleGroup> {
   variant?: ToggleVariantsOptions["variant"];
   /**

package/dist/Workspace-Jez8ffUj.d.ts

@@ -0,0 +1,274 @@
+import { a as WorkspaceMediaInfo, i as WorkspaceFileState, r as WorkspaceFileAssetResolver, t as WorkspaceFileAsset } from "./WorkspaceFile-CzyHnESE.js";
+import { WorkspaceLike } from "@cloudflare/think";
+import { FileInfo, Workspace } from "@cloudflare/shell";
+
+//#region src/components/Workspace.d.ts
+/** Workspace summary, as returned by `Workspace.getWorkspaceInfo()` upstream. */
+type WorkspaceInfo = Awaited<ReturnType<Workspace["getWorkspaceInfo"]>>;
+/** Whole upstream workspace shapes, accepted without narrowing or mirroring. */
+type WorkspaceSource = Workspace | WorkspaceLike;
+interface UseWorkspaceOptions {
+  /** Must be referentially stable (memoize in the app). */
+  source: WorkspaceSource;
+  /**
+   * Stable, non-secret identity for the endpoint/account/tenant/workspace
+   * behind `source`. Change it whenever that backing workspace changes.
+   */
+  sourceKey: string;
+  /** Root directory to list first. Defaults to "/". */
+  root?: string;
+  /** Route-owned selected file path. */
+  selectedPath: string | null;
+  /** Called when a non-link browser asks the app to select a file. */
+  onSelectedPathChange?: (path: string | null) => void;
+  /**
+   * Optional host adapter called before text/binary reads. Return `null` for
+   * ordinary text files and prefer signed/range-friendly URLs for large media.
+   * The configured root scopes navigation; hosts must enforce authorization
+   * atomically when resolving assets across a trust boundary.
+   * Keep this resolver semantically stable for a given `sourceKey`; function
+   * identity is intentionally excluded from serializable query keys.
+   */
+  resolveFileAsset?: WorkspaceFileAssetResolver;
+  /** Maximum size for the built-in buffered-byte fallback. Defaults to 32 MiB. */
+  maxInlineAssetBytes?: number;
+}
+interface WorkspaceState {
+  root: string;
+  /** Loaded directory listings, keyed by directory path. */
+  entriesByDirectory: Readonly<Record<string, readonly FileInfo[]>>;
+  /** Every loaded entry, keyed by its path. */
+  entryByPath: ReadonlyMap<string, FileInfo>;
+  expandedPaths: ReadonlySet<string>;
+  /** Update expansion; newly expanded directories load lazily. */
+  setExpandedPaths: (next: Set<string>) => void;
+  selectedPath: string | null;
+  /** Ask the route owner to select a file. */
+  selectFile: (path: string | null) => void;
+  /** The selected file once its read settles; null while loading. */
+  selectedFile: WorkspaceFileState | null;
+  /** Initial root/info load or explicit refresh in flight. */
+  isLoading: boolean;
+  /** Directory and file paths with a query in flight. */
+  loadingPaths: ReadonlySet<string>;
+  /** Root/directory listing failure. Per-file read errors live on the file state. */
+  error: string | null;
+  /** Workspace summary, when the source provides `getWorkspaceInfo`. */
+  info: WorkspaceInfo | null;
+  /** Reload the root, every expanded directory, and the selected file. */
+  refresh: () => void;
+}
+interface WorkspaceFileReadTarget {
+  requestedPath: string;
+  readPath: string;
+  info: FileInfo;
+  media: WorkspaceMediaInfo | null;
+}
+/**
+ * Source/root prefix for cache inspection, cancellation, or removal.
+ * Do not broadly invalidate this prefix: active file queries must refresh in
+ * stat → resolver → content order. Use a resource option key or `refresh()`.
+ */
+declare function workspaceQueryKey(sourceKey: string, root: string): readonly ["workspace", string, string];
+type WorkspaceQueryKey = ReturnType<typeof workspaceQueryKey>;
+/** Shared directory options for workspace components and route loaders. */
+declare function workspaceDirectoryQueryOptions(source: WorkspaceSource, sourceKey: string, root: string, path: string): import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<readonly FileInfo[], Error, readonly FileInfo[], readonly ["workspace", string, string, "directory", string]>, "queryFn"> & {
+  queryFn?: import("@tanstack/react-query").QueryFunction<readonly FileInfo[], readonly ["workspace", string, string, "directory", string], never> | undefined;
+} & {
+  queryKey: readonly ["workspace", string, string, "directory", string] & {
+    [dataTagSymbol]: readonly FileInfo[];
+    [dataTagErrorSymbol]: Error;
+  };
+};
+/** Shared workspace-summary options for workspace components and route loaders. */
+declare function workspaceInfoQueryOptions(source: WorkspaceSource, sourceKey: string, root: string): import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+  fileCount: number;
+  directoryCount: number;
+  totalBytes: number;
+  r2FileCount: number;
+} | null, Error, {
+  fileCount: number;
+  directoryCount: number;
+  totalBytes: number;
+  r2FileCount: number;
+} | null, readonly ["workspace", string, string, "info"]>, "queryFn"> & {
+  queryFn?: import("@tanstack/react-query").QueryFunction<{
+    fileCount: number;
+    directoryCount: number;
+    totalBytes: number;
+    r2FileCount: number;
+  } | null, readonly ["workspace", string, string, "info"], never> | undefined;
+} & {
+  queryKey: readonly ["workspace", string, string, "info"] & {
+    [dataTagSymbol]: {
+      fileCount: number;
+      directoryCount: number;
+      totalBytes: number;
+      r2FileCount: number;
+    } | null;
+    [dataTagErrorSymbol]: Error;
+  };
+};
+/** Re-stat and validate a requested path before any resolver or file read. */
+declare function workspaceFileStatQueryOptions(source: WorkspaceSource, sourceKey: string, root: string, requestedPath: string): import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<WorkspaceFileReadTarget, Error, WorkspaceFileReadTarget, readonly ["workspace", string, string, "file", string, "stat"]>, "queryFn"> & {
+  queryFn?: import("@tanstack/react-query").QueryFunction<WorkspaceFileReadTarget, readonly ["workspace", string, string, "file", string, "stat"], never> | undefined;
+} & {
+  queryKey: readonly ["workspace", string, string, "file", string, "stat"] & {
+    [dataTagSymbol]: WorkspaceFileReadTarget;
+    [dataTagErrorSymbol]: Error;
+  };
+};
+/** Optional host asset resolution, scoped to the current stat result. */
+declare function workspaceFileAssetQueryOptions(sourceKey: string, root: string, target: WorkspaceFileReadTarget, resolveFileAsset: WorkspaceFileAssetResolver): import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+  asset: WorkspaceFileAsset;
+  media: WorkspaceMediaInfo;
+} | null, Error, {
+  asset: WorkspaceFileAsset;
+  media: WorkspaceMediaInfo;
+} | null, readonly ["workspace", string, string, "file", string, "asset", {
+  readonly path: string;
+  readonly name: string;
+  readonly type: import("@cloudflare/shell").EntryType;
+  readonly mimeType: string;
+  readonly size: number;
+  readonly createdAt: number;
+  readonly updatedAt: number;
+  readonly target: string | null;
+}]>, "queryFn"> & {
+  queryFn?: import("@tanstack/react-query").QueryFunction<{
+    asset: WorkspaceFileAsset;
+    media: WorkspaceMediaInfo;
+  } | null, readonly ["workspace", string, string, "file", string, "asset", {
+    readonly path: string;
+    readonly name: string;
+    readonly type: import("@cloudflare/shell").EntryType;
+    readonly mimeType: string;
+    readonly size: number;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly target: string | null;
+  }], never> | undefined;
+} & {
+  queryKey: readonly ["workspace", string, string, "file", string, "asset", {
+    readonly path: string;
+    readonly name: string;
+    readonly type: import("@cloudflare/shell").EntryType;
+    readonly mimeType: string;
+    readonly size: number;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly target: string | null;
+  }] & {
+    [dataTagSymbol]: {
+      asset: WorkspaceFileAsset;
+      media: WorkspaceMediaInfo;
+    } | null;
+    [dataTagErrorSymbol]: Error;
+  };
+};
+/** Cached text read options, scoped to the validated stat result. */
+declare function workspaceTextFileQueryOptions(source: WorkspaceSource, sourceKey: string, root: string, target: WorkspaceFileReadTarget): import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<string | null, Error, string | null, readonly ["workspace", string, string, "file", string, "text", {
+  readonly path: string;
+  readonly name: string;
+  readonly type: import("@cloudflare/shell").EntryType;
+  readonly mimeType: string;
+  readonly size: number;
+  readonly createdAt: number;
+  readonly updatedAt: number;
+  readonly target: string | null;
+}]>, "queryFn"> & {
+  queryFn?: import("@tanstack/react-query").QueryFunction<string | null, readonly ["workspace", string, string, "file", string, "text", {
+    readonly path: string;
+    readonly name: string;
+    readonly type: import("@cloudflare/shell").EntryType;
+    readonly mimeType: string;
+    readonly size: number;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly target: string | null;
+  }], never> | undefined;
+} & {
+  queryKey: readonly ["workspace", string, string, "file", string, "text", {
+    readonly path: string;
+    readonly name: string;
+    readonly type: import("@cloudflare/shell").EntryType;
+    readonly mimeType: string;
+    readonly size: number;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly target: string | null;
+  }] & {
+    [dataTagSymbol]: string | null;
+    [dataTagErrorSymbol]: Error;
+  };
+};
+/** Active-file-only buffered asset options, scoped to the validated stat result. */
+declare function workspaceBinaryFileQueryOptions(source: WorkspaceSource, sourceKey: string, root: string, target: WorkspaceFileReadTarget, maxInlineAssetBytes: number): import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+  asset: WorkspaceFileAsset;
+  media: WorkspaceMediaInfo;
+} | null, Error, {
+  asset: WorkspaceFileAsset;
+  media: WorkspaceMediaInfo;
+} | null, readonly ["workspace", string, string, "file", string, "bytes", {
+  readonly path: string;
+  readonly name: string;
+  readonly type: import("@cloudflare/shell").EntryType;
+  readonly mimeType: string;
+  readonly size: number;
+  readonly createdAt: number;
+  readonly updatedAt: number;
+  readonly target: string | null;
+}, {
+  readonly maxInlineAssetBytes: number;
+}]>, "queryFn"> & {
+  queryFn?: import("@tanstack/react-query").QueryFunction<{
+    asset: WorkspaceFileAsset;
+    media: WorkspaceMediaInfo;
+  } | null, readonly ["workspace", string, string, "file", string, "bytes", {
+    readonly path: string;
+    readonly name: string;
+    readonly type: import("@cloudflare/shell").EntryType;
+    readonly mimeType: string;
+    readonly size: number;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly target: string | null;
+  }, {
+    readonly maxInlineAssetBytes: number;
+  }], never> | undefined;
+} & {
+  queryKey: readonly ["workspace", string, string, "file", string, "bytes", {
+    readonly path: string;
+    readonly name: string;
+    readonly type: import("@cloudflare/shell").EntryType;
+    readonly mimeType: string;
+    readonly size: number;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly target: string | null;
+  }, {
+    readonly maxInlineAssetBytes: number;
+  }] & {
+    [dataTagSymbol]: {
+      asset: WorkspaceFileAsset;
+      media: WorkspaceMediaInfo;
+    } | null;
+    [dataTagErrorSymbol]: Error;
+  };
+};
+/**
+ * Headless state for browsing a Think workspace. TanStack Query owns remote
+ * directory, metadata, resolver, text, and byte lifecycles; the route owns
+ * selection, while this hook only keeps local tree expansion state.
+ */
+declare function useWorkspace({
+  source,
+  sourceKey,
+  root,
+  selectedPath,
+  onSelectedPathChange,
+  resolveFileAsset,
+  maxInlineAssetBytes
+}: UseWorkspaceOptions): WorkspaceState;
+//#endregion
+export { WorkspaceSource as a, workspaceBinaryFileQueryOptions as c, workspaceFileStatQueryOptions as d, workspaceInfoQueryOptions as f, WorkspaceQueryKey as i, workspaceDirectoryQueryOptions as l, workspaceTextFileQueryOptions as m, WorkspaceFileReadTarget as n, WorkspaceState as o, workspaceQueryKey as p, WorkspaceInfo as r, useWorkspace as s, UseWorkspaceOptions as t, workspaceFileAssetQueryOptions as u };

package/dist/{WorkspaceExplorer-sZewzT2O.d.ts → WorkspaceExplorer-B9dQWNVK.d.ts}

@@ -1,5 +1,5 @@
-import { l as WorkspaceNavigationAdapter } from "./WorkspaceLink-DK1DWMHe.js";
-import { i as WorkspaceState } from "./Workspace-C9RFoxcu.js";
+import { l as WorkspaceNavigationAdapter } from "./WorkspaceLink-O-EBKUJ8.js";
+import { o as WorkspaceState } from "./Workspace-Jez8ffUj.js";
 import * as React from "react";
 
 //#region src/components/WorkspaceExplorer.d.ts

package/dist/{WorkspaceFile-C8UzuSH4.d.ts → WorkspaceFile-CzyHnESE.d.ts}

@@ -1,4 +1,4 @@
-import { A as CodeBlockLanguage } from "./CodeBlock-Dnpr88ZQ.js";
+import { A as CodeBlockLanguage } from "./CodeBlock-gV4kZeCI.js";
 import { SkillParseResult } from "agent-skills-ts-sdk";
 import { FileInfo } from "@cloudflare/shell";