@mcp-b/react-components 0.27.0 → 0.29.0

package/dist/{AgentChat-B6sgfQ_q.d.ts → AgentChat-Dy3cKCd-.d.ts}

@@ -1,6 +1,6 @@
 import { i as AgentMessageRenderPartContext } from "./AgentMessageParts-CyD2UB3V.js";
-import { n as AgentChatStartScreenProps } from "./AgentChatStartScreen-DDZ25aax.js";
-import { $ as PromptInputDictationProps, A as PromptInputCommandDefinition, X as PromptInputContextSelectorProps, gt as PromptInputReference, n as PermissionMode, ut as PromptInputMessage } from "./PromptInput-CES0WO4u.js";
+import { n as AgentChatStartScreenProps } from "./AgentChatStartScreen-DXZ0hAX0.js";
+import { $ as PromptInputDictationProps, A as PromptInputCommandDefinition, X as PromptInputContextSelectorProps, gt as PromptInputReference, n as PermissionMode, ut as PromptInputMessage } from "./PromptInput-B75Np5VB.js";
 import * as React from "react";
 import { ChatAddToolApproveResponseFunction, ChatStatus, UIMessage } from "ai";
 import { PendingApproval, Think } from "@cloudflare/think";
@@ -76,15 +76,22 @@ interface AgentChatProps<MessageT extends UIMessage = UIMessage> {
   showComposer?: boolean;
   /** Called when the user hits stop while `status` is streaming/submitted. */
   onStop?: () => void;
+  /**
+   * Called when a submission lands in the pending queue instead of going out
+   * (the composer was busy). Hosts with an autonomous continuation mode (goal
+   * mode) pause it here: a user who queues a message expects it to run next,
+   * not to race the loop's own next turn.
+   */
+  onPromptQueued?: () => void;
   placeholder?: string;
   disabled?: boolean;
   /** Rendered in place of the transcript while `messages` is empty. */
   emptyState?: React.ReactNode;
   /**
    * First-turn composition that places the live composer between a welcoming
-   * heading and app-authored starter actions. It is the default when messages
-   * are empty and no legacy `emptyState` is supplied. Pass `false` to retain
-   * the transcript-style empty row.
+   * heading and app-authored starter descriptors. It is the default when
+   * messages are empty and no legacy `emptyState` is supplied. Pass `false` to
+   * retain the transcript-style empty row.
    */
   startScreen?: Omit<AgentChatStartScreenProps, "composer" | "className" | "aria-labelledby"> | false;
   /** Extra controls rendered in the composer toolbar. */
@@ -254,6 +261,7 @@ declare function AgentChat<MessageT extends UIMessage = UIMessage>({
   onSubmit,
   showComposer,
   onStop,
+  onPromptQueued,
   placeholder,
   disabled,
   emptyState,

package/dist/{AgentChatStartScreen-DDZ25aax.d.ts → AgentChatStartScreen-DXZ0hAX0.d.ts}

@@ -2,6 +2,22 @@ import { r as ButtonProps } from "./Button-SBIz6Lqi.js";
 import * as React from "react";
 
 //#region src/components/AgentChatStartScreen.d.ts
+interface AgentChatStarterItem {
+  id: string;
+  label: React.ReactNode;
+  icon?: React.ReactNode;
+  muted?: boolean;
+  disabled?: boolean;
+  /** Accessible label for this suggestion's optional dismiss action. */
+  dismissLabel?: string;
+}
+interface AgentChatStarterListProps extends Omit<React.ComponentPropsWithoutRef<"ul">, "children" | "onDismiss" | "onSelect"> {
+  /** Complete starter data from a host-owned suggestion query. */
+  items: readonly AgentChatStarterItem[];
+  onSelect: (item: AgentChatStarterItem) => void;
+  /** Enables dismiss actions for items that provide `dismissLabel`. */
+  onDismiss?: (item: AgentChatStarterItem) => void;
+}
 interface AgentChatStartScreenProps extends Omit<React.ComponentPropsWithoutRef<"section">, "children" | "title"> {
   /** The prompt that orients the user before their first message. */
   heading?: React.ReactNode;
@@ -9,8 +25,8 @@ interface AgentChatStartScreenProps extends Omit<React.ComponentPropsWithoutRef<
   composer: React.ReactNode;
   /** App-authored content for the utility tray beneath the first-turn composer. */
   composerTray?: React.ReactNode;
-  /** App-authored starter actions rendered below the composer. */
-  children?: React.ReactNode;
+  /** Host-authored starter data and callables rendered below the composer. */
+  starters?: AgentChatStarterListProps;
 }
 /**
  * Welcoming first-turn layout for `AgentChat` and `ThinkChat`.
@@ -23,15 +39,17 @@ declare function AgentChatStartScreen({
   heading,
   composer,
   composerTray,
-  children,
+  starters,
   className,
   "aria-label": ariaLabel,
   "aria-labelledby": ariaLabelledBy,
   ...props
 }: AgentChatStartScreenProps): React.JSX.Element;
-interface AgentChatStarterListProps extends React.ComponentPropsWithoutRef<"ul"> {}
 /** Semantic list for first-turn prompts below an `AgentChatStartScreen`. */
 declare function AgentChatStarterList({
+  items,
+  onSelect,
+  onDismiss,
   className,
   ...props
 }: AgentChatStarterListProps): React.JSX.Element;
@@ -57,4 +75,4 @@ declare function AgentChatStarter({
   ...props
 }: AgentChatStarterProps): React.JSX.Element;
 //#endregion
-export { AgentChatStarterListProps as a, AgentChatStarterList as i, AgentChatStartScreenProps as n, AgentChatStarterProps as o, AgentChatStarter as r, AgentChatStartScreen as t };
+export { AgentChatStarterList as a, AgentChatStarterItem as i, AgentChatStartScreenProps as n, AgentChatStarterListProps as o, AgentChatStarter as r, AgentChatStarterProps as s, AgentChatStartScreen as t };

package/dist/{PromptInput-CES0WO4u.d.ts → PromptInput-B75Np5VB.d.ts}

@@ -8,6 +8,8 @@ import { ChatAddToolApproveResponseFunction, ChatStatus, DynamicToolUIPart, File
 import { PendingApproval, Think } from "@cloudflare/think";
 import { AgentStub } from "agents/client";
 import { UseVoiceInputReturn } from "@cloudflare/voice/react";
+import { MCPServersState } from "agents";
+import { SkillDescriptor } from "agents/skills";
 
 //#region src/components/PromptInput.d.ts
 /** The payload produced when the prompt input is submitted. */
@@ -785,6 +787,10 @@ interface PromptInputCommandDefinition {
   /** Quiet trailing provenance such as a workspace, server, or installation scope. */
   meta?: React.ReactNode;
 }
+/** Project whole upstream Agents MCP state into composer mention commands. */
+declare function mcpPromptInputCommands(mcp: MCPServersState): PromptInputCommandDefinition[];
+/** Project whole upstream skill descriptors into composer slash commands. */
+declare function skillPromptInputCommands(skills: readonly SkillDescriptor[]): PromptInputCommandDefinition[];
 type PromptInputCommandTrigger = "/" | "@";
 interface PromptInputReference {
   id: string;
@@ -866,4 +872,4 @@ declare function PromptInputContextSelector({
   action
 }: PromptInputContextSelectorProps): React.JSX.Element;
 //#endregion
-export { PromptInputDictationProps as $, PromptInputCommandDefinition as A, PromptInputTabProps as At, PromptInputCommandItemProps as B, TextInputContext as Bt, PromptInputBodyProps as C, PromptInputTab as Ct, PromptInputCommand as D, PromptInputTabItemProps as Dt, PromptInputButtonTooltip as E, PromptInputTabItem as Et, PromptInputCommandGroupLabelProps as F, PromptInputTools as Ft, PromptInputCommandSeparatorProps as G, usePromptInputAttachments as Gt, PromptInputCommandListProps as H, getApprovalRequestId as Ht, PromptInputCommandGroupProps as I, PromptInputToolsProps as It, PromptInputContextItem as J, PromptInputCommandTrigger as K, usePromptInputController as Kt, PromptInputCommandInput as L, PromptInputTooltipConfig as Lt, PromptInputCommandEmptyProps as M, PromptInputTabsListProps as Mt, PromptInputCommandGroup as N, PromptInputTextarea as Nt, PromptInputCommandComposer as O, PromptInputTabLabel as Ot, PromptInputCommandGroupLabel as P, PromptInputTextareaProps as Pt, PromptInputDictation as Q, PromptInputCommandInputProps as R, PromptInputTray as Rt, PromptInputBody as S, PromptInputSubmitProps as St, PromptInputButtonProps as T, PromptInputTabBodyProps as Tt, PromptInputCommandProps as U, getApprovalStateKey as Ut, PromptInputCommandList as V, TooltipSide as Vt, PromptInputCommandSeparator as W, getPendingToolApprovals as Wt, PromptInputContextSelectorProps as X, PromptInputContextSelector as Y, PromptInputControllerProps as Z, PromptInputApprovalProps as _, PromptInputReferences as _t, PromptInputActionAddAttachmentsProps as a, PromptInputHoverCardContent as at, PromptInputAttachments as b, PromptInputSelectProps as bt, PromptInputActionMenu as c, PromptInputHoverCardTrigger as ct, PromptInputActionMenuItem as d, PromptInputPermissionSelector as dt, PromptInputFooter as et, PromptInputActionMenuItemProps as f, PromptInputPermissionSelectorProps as ft, PromptInputApproval as g, PromptInputReference as gt, PromptInputActionMenuTriggerProps as h, PromptInputProviderProps as ht, PromptInputActionAddAttachments as i, PromptInputHoverCard as it, PromptInputCommandEmpty as j, PromptInputTabsList as jt, PromptInputCommandComposerProps as k, PromptInputTabLabelProps as kt, PromptInputActionMenuContent as l, PromptInputHoverCardTriggerProps as lt, PromptInputActionMenuTrigger as m, PromptInputProvider as mt, PermissionMode as n, PromptInputHeader as nt, PromptInputActionAddScreenshot as o, PromptInputHoverCardContentProps as ot, PromptInputActionMenuProps as p, PromptInputProps as pt, PromptInputContextAction as q, useProviderAttachments as qt, PromptInput as r, PromptInputHeaderProps as rt, PromptInputActionAddScreenshotProps as s, PromptInputHoverCardProps as st, AttachmentsContext as t, PromptInputFooterProps as tt, PromptInputActionMenuContentProps as u, PromptInputMessage as ut, PromptInputAttachment as v, PromptInputReferencesProps as vt, PromptInputButton as w, PromptInputTabBody as wt, PromptInputAttachmentsProps as x, PromptInputSubmit as xt, PromptInputAttachmentProps as y, PromptInputSelect as yt, PromptInputCommandItem as z, PromptInputTrayProps as zt };
+export { PromptInputDictationProps as $, PromptInputCommandDefinition as A, PromptInputTabProps as At, PromptInputCommandItemProps as B, TextInputContext as Bt, PromptInputBodyProps as C, PromptInputTab as Ct, PromptInputCommand as D, PromptInputTabItemProps as Dt, PromptInputButtonTooltip as E, PromptInputTabItem as Et, PromptInputCommandGroupLabelProps as F, PromptInputTools as Ft, PromptInputCommandSeparatorProps as G, mcpPromptInputCommands as Gt, PromptInputCommandListProps as H, getApprovalRequestId as Ht, PromptInputCommandGroupProps as I, PromptInputToolsProps as It, PromptInputContextItem as J, usePromptInputController as Jt, PromptInputCommandTrigger as K, skillPromptInputCommands as Kt, PromptInputCommandInput as L, PromptInputTooltipConfig as Lt, PromptInputCommandEmptyProps as M, PromptInputTabsListProps as Mt, PromptInputCommandGroup as N, PromptInputTextarea as Nt, PromptInputCommandComposer as O, PromptInputTabLabel as Ot, PromptInputCommandGroupLabel as P, PromptInputTextareaProps as Pt, PromptInputDictation as Q, PromptInputCommandInputProps as R, PromptInputTray as Rt, PromptInputBody as S, PromptInputSubmitProps as St, PromptInputButtonProps as T, PromptInputTabBodyProps as Tt, PromptInputCommandProps as U, getApprovalStateKey as Ut, PromptInputCommandList as V, TooltipSide as Vt, PromptInputCommandSeparator as W, getPendingToolApprovals as Wt, PromptInputContextSelectorProps as X, PromptInputContextSelector as Y, useProviderAttachments as Yt, PromptInputControllerProps as Z, PromptInputApprovalProps as _, PromptInputReferences as _t, PromptInputActionAddAttachmentsProps as a, PromptInputHoverCardContent as at, PromptInputAttachments as b, PromptInputSelectProps as bt, PromptInputActionMenu as c, PromptInputHoverCardTrigger as ct, PromptInputActionMenuItem as d, PromptInputPermissionSelector as dt, PromptInputFooter as et, PromptInputActionMenuItemProps as f, PromptInputPermissionSelectorProps as ft, PromptInputApproval as g, PromptInputReference as gt, PromptInputActionMenuTriggerProps as h, PromptInputProviderProps as ht, PromptInputActionAddAttachments as i, PromptInputHoverCard as it, PromptInputCommandEmpty as j, PromptInputTabsList as jt, PromptInputCommandComposerProps as k, PromptInputTabLabelProps as kt, PromptInputActionMenuContent as l, PromptInputHoverCardTriggerProps as lt, PromptInputActionMenuTrigger as m, PromptInputProvider as mt, PermissionMode as n, PromptInputHeader as nt, PromptInputActionAddScreenshot as o, PromptInputHoverCardContentProps as ot, PromptInputActionMenuProps as p, PromptInputProps as pt, PromptInputContextAction as q, usePromptInputAttachments as qt, PromptInput as r, PromptInputHeaderProps as rt, PromptInputActionAddScreenshotProps as s, PromptInputHoverCardProps as st, AttachmentsContext as t, PromptInputFooterProps as tt, PromptInputActionMenuContentProps as u, PromptInputMessage as ut, PromptInputAttachment as v, PromptInputReferencesProps as vt, PromptInputButton as w, PromptInputTabBody as wt, PromptInputAttachmentsProps as x, PromptInputSubmit as xt, PromptInputAttachmentProps as y, PromptInputSelect as yt, PromptInputCommandItem as z, PromptInputTrayProps as zt };

package/dist/SessionCompaction-DMa1vv6Y.d.ts

@@ -0,0 +1,59 @@
+import { ChatStatus, UIMessage } from "ai";
+
+//#region src/components/SessionCompaction.d.ts
+type SessionStatusPhase = "idle" | "compacting";
+interface SessionStatusFrame {
+  phase: SessionStatusPhase;
+  /** Present on the idle frame that follows a successful compaction. */
+  compacted: boolean;
+}
+/**
+ * Parse a raw websocket payload as a `cf_agent_session` status frame.
+ * Returns null for every other frame on the connection.
+ */
+declare function parseSessionStatusFrame(data: unknown): SessionStatusFrame | null;
+/**
+ * Parse a raw websocket payload as a `cf_agent_session_error` frame,
+ * returning its error text. Null for every other frame on the connection.
+ */
+declare function parseSessionErrorFrame(data: unknown): string | null;
+/** The message-frame surface of a `useAgent` connection. */
+interface SessionFrameSource {
+  addEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+  removeEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+}
+interface UseSessionCompactionOptions<MessageT extends UIMessage> {
+  /** The conversation agent's `useAgent` connection. */
+  agent: SessionFrameSource;
+  /** The conversation's `useAgentChat` value (status + local view setter). */
+  chat: {
+    status: ChatStatus;
+    setMessages: (messages: MessageT[]) => void;
+  };
+  /** Server read used to reload the transcript after a compaction lands. */
+  getMessages: () => Promise<MessageT[]>;
+}
+interface UseSessionCompactionResult {
+  compacting: boolean;
+  /**
+   * Set when the post-compaction transcript reload rejected — the local view
+   * is stale relative to the server until a retry succeeds. Surface it
+   * ("Transcript may be out of date"); the hook retries on the next status
+   * transition to `"ready"`.
+   */
+  reloadError: unknown;
+  /**
+   * Error text from the last `cf_agent_session_error` frame — the only signal
+   * a user who ran /compact gets when the server-side compaction itself fails
+   * (the phase just flips back to idle with no `compacted` payload). Cleared
+   * when the next compaction starts.
+   */
+  sessionError: string | null;
+}
+declare function useSessionCompaction<MessageT extends UIMessage>({
+  agent,
+  chat,
+  getMessages
+}: UseSessionCompactionOptions<MessageT>): UseSessionCompactionResult;
+//#endregion
+export { UseSessionCompactionResult as a, useSessionCompaction as c, UseSessionCompactionOptions as i, SessionStatusFrame as n, parseSessionErrorFrame as o, SessionStatusPhase as r, parseSessionStatusFrame as s, SessionFrameSource as t };

package/dist/{ThinkChat-DVhCEjq-.js → ThinkChat-Bp-nAnoW.js}

@@ -1,3 +1,5 @@
+import { J as SpinnerIcon } from "./icons-B4mGvCvc.js";
+import { TransitionSurface } from "./components/TransitionSurface.js";
 import { AgentChat } from "./components/AgentChat.js";
 import { AgentToolRunsProvider, useOptionalAgentToolRuns } from "./components/AgentToolRunsContext.js";
 import { SubagentRunList } from "./components/SubagentRunList.js";
@@ -182,7 +184,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, renderAgentToolRunLink, toolRenderers, thinkStub, onExecutionSettled, pendingApprovals, notice, ...props }) {
+function ThinkChatMessages({ composerHeader, renderPart, excludeTools, renderAgentToolRunLink, toolRenderers, thinkStub, onExecutionSettled, pendingApprovals, notice, sessionCompaction, ...props }) {
 	const chat = useThinkChatContext("ThinkChat.Messages");
 	const agentTools = useOptionalAgentToolRuns();
 	const approvals = React.useContext(ThinkChatApprovalsContext);
@@ -217,6 +219,16 @@ function ThinkChatMessages({ composerHeader, renderPart, excludeTools, renderAge
 		return custom === void 0 ? renderBuiltIn() : custom;
 	} : defaultRenderPart, [defaultRenderPart, renderPart]);
 	const defaultNotice = /* @__PURE__ */ jsx(ThinkRecoveryNotice, { chat });
+	const sessionCompactionNotice = sessionCompaction?.compacting ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(SpinnerIcon, {}), "Compacting context…"] }) : sessionCompaction?.sessionError ? /* @__PURE__ */ jsxs(TransitionSurface, {
+		className: "think-recovery-notice",
+		"data-tone": "danger",
+		children: ["Compaction failed: ", sessionCompaction.sessionError]
+	}) : sessionCompaction?.reloadError ? /* @__PURE__ */ jsx(TransitionSurface, {
+		className: "think-recovery-notice",
+		"data-tone": "danger",
+		children: "Transcript may be out of date. The next completed turn will retry the refresh."
+	}) : null;
+	const recoveryActive = chat.isRecovering || chat.connectionError || chat.error;
 	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",
@@ -240,7 +252,7 @@ function ThinkChatMessages({ composerHeader, renderPart, excludeTools, renderAge
 		thinkStub: resolvedApprovals.thinkStub,
 		onExecutionSettled: resolvedApprovals.onExecutionSettled,
 		pendingApprovals: resolvedApprovals.pendingApprovals,
-		notice: notice ?? defaultNotice,
+		notice: notice ?? (recoveryActive ? defaultNotice : sessionCompactionNotice),
 		composerHeader: resolvedComposerHeader,
 		onRegenerate: (messageId) => void chat.regenerate({ messageId }),
 		onSubmit: ({ text, files, references }) => {

package/dist/{ThinkChatActivity-DawPYgga.d.ts → ThinkChatActivity-Dq0lOAgw.d.ts}

@@ -1,7 +1,7 @@
 import { i as AgentMessageRenderPartContext } from "./AgentMessageParts-CyD2UB3V.js";
-import { r as AgentChatProps } from "./AgentChat-B6sgfQ_q.js";
-import { l as ThinkChatPart } from "./ThinkChatToolParts-CSzVwMXf.js";
-import { t as ThinkChatActivityDescription } from "./ThinkChatActivitySummary-kr5fE0wg.js";
+import { r as AgentChatProps } from "./AgentChat-Dy3cKCd-.js";
+import { l as ThinkChatPart } from "./ThinkChatToolParts-BfroXQ4F.js";
+import { t as ThinkChatActivityDescription } from "./ThinkChatActivitySummary-F062wneC.js";
 import * as React from "react";
 import { DynamicToolUIPart, ToolUIPart, UIMessage } from "ai";
 import { AgentToolRunState } from "agents/agent-tools";

package/dist/{ThinkChatActivitySummary-kr5fE0wg.d.ts → ThinkChatActivitySummary-F062wneC.d.ts}

@@ -1,5 +1,5 @@
 import { i as AgentActivityIconKind, s as AgentActivitySummary } from "./AgentActivity-D3OvrC02.js";
-import { l as ThinkChatPart } from "./ThinkChatToolParts-CSzVwMXf.js";
+import { l as ThinkChatPart } from "./ThinkChatToolParts-BfroXQ4F.js";
 import { DynamicToolUIPart, ToolUIPart } from "ai";
 
 //#region src/components/ThinkChatActivitySummary.d.ts

package/dist/{ThinkChatToolParts-CSzVwMXf.d.ts → ThinkChatToolParts-BfroXQ4F.d.ts}

@@ -22,7 +22,25 @@ type ThinkWorkspaceToolName = keyof WorkspaceUITools;
 type ThinkBashToolPart = Extract<WorkspaceToolPart, {
   type: "tool-bash";
 }>;
-type ThinkBashToolOutput = WorkspaceUITools["bash"]["output"];
+/**
+ * Runtime result returned by Think 0.15's `dist/tools/workspace.js`
+ * `createBashTool`. Its public declaration currently widens the tool to
+ * unparameterized `Tool`, so keep only the emitted fields the panel reads.
+ */
+interface ThinkBashToolOutput {
+  stdout: string;
+  stderr: string;
+  exitCode: number;
+  errors?: string[];
+  skippedFiles?: string[];
+  changedFiles: {
+    created: string[];
+    updated: string[];
+    deleted: string[];
+    directoriesCreated: string[];
+    directoriesDeleted: string[];
+  };
+}
 declare function isWorkspaceToolPart(part: ThinkChatPart): part is WorkspaceToolPart;
 type SkillUITools = {
   activate_skill: {

package/dist/{Workspace-CIycQ4xE.d.ts → Workspace-Bn6In4wi.d.ts}

@@ -71,6 +71,10 @@ interface WorkspaceFileReadTarget {
  */
 declare function workspaceQueryKey(sourceKey: string, root: string): readonly ["workspace", string, string];
 type WorkspaceQueryKey = ReturnType<typeof workspaceQueryKey>;
+/** Directory-listing prefix for targeted cache invalidation. */
+declare function workspaceDirectoryQueryPrefix(sourceKey: string, root: string): readonly ["workspace", string, string, "directory"];
+/** Exact directory-listing key shared by query options and live hosts. */
+declare function workspaceDirectoryQueryKey(sourceKey: string, root: string, path: string): readonly ["workspace", string, string, "directory", string];
 /** 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;
@@ -271,4 +275,4 @@ declare function useWorkspace({
   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 };
+export { WorkspaceSource as a, workspaceBinaryFileQueryOptions as c, workspaceDirectoryQueryPrefix as d, workspaceFileAssetQueryOptions as f, workspaceTextFileQueryOptions as g, workspaceQueryKey as h, WorkspaceQueryKey as i, workspaceDirectoryQueryKey as l, workspaceInfoQueryOptions as m, WorkspaceFileReadTarget as n, WorkspaceState as o, workspaceFileStatQueryOptions as p, WorkspaceInfo as r, useWorkspace as s, UseWorkspaceOptions as t, workspaceDirectoryQueryOptions as u };

package/dist/{WorkspaceExplorer-BCipn7Vd.d.ts → WorkspaceExplorer-D0aiscG6.d.ts}

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

package/dist/components/ActionGuide.d.ts

@@ -4,16 +4,33 @@ import * as React from "react";
 //#region src/components/ActionGuide.d.ts
 type ActionGuideHeadingLevel = 2 | 3 | 4 | 5 | 6;
 type ActionGuideListLayout = "compact" | "cards" | "list";
-interface ActionGuideProps extends Omit<React.ComponentPropsWithoutRef<"article">, "title"> {
+interface ActionGuideActionItem {
+  id: string;
+  label: React.ReactNode;
+  icon?: React.ReactNode;
+  variant?: "surface" | "ghost";
+  disabled?: boolean;
+}
+interface ActionGuideSectionItem {
+  id: string;
+  title: React.ReactNode;
+  layout?: ActionGuideListLayout;
+  actions: readonly ActionGuideActionItem[];
+}
+interface ActionGuideProps extends Omit<React.ComponentPropsWithoutRef<"article">, "children" | "title"> {
   /** Short, task-oriented introduction to the guide. */
   title: React.ReactNode;
   /** Optional sentence that explains what the guide helps the user do. */
   description?: React.ReactNode;
   /** Semantic heading level for the guide title. */
   headingLevel?: ActionGuideHeadingLevel;
+  /** Complete section/action data; product copy and availability remain host-owned. */
+  sections: readonly ActionGuideSectionItem[];
+  /** Central action policy for data-driven sections. */
+  onAction: (action: ActionGuideActionItem) => void;
 }
 /**
- * Composable, app-agnostic guide for presenting groups of useful actions.
+ * App-agnostic guide hydrated from product-owned sections and actions.
  *
  * Product code owns the copy, icons, availability, and click behavior. This
  * component owns only the shared article rhythm and responsive layout.
@@ -22,7 +39,8 @@ declare function ActionGuide({
   title,
   description,
   headingLevel,
-  children,
+  sections,
+  onAction,
   className,
   "aria-label": ariaLabel,
   "aria-labelledby": ariaLabelledBy,
@@ -37,7 +55,7 @@ interface ActionGuideSectionProps extends Omit<React.ComponentPropsWithoutRef<"s
   /** Semantic heading level for the section title. */
   headingLevel?: ActionGuideHeadingLevel;
 }
-/** A labelled group inside an {@link ActionGuide}. */
+/** A labelled action group for custom guide compositions. */
 declare function ActionGuideSection({
   title,
   headingLevel,
@@ -82,4 +100,4 @@ declare function ActionGuideAction({
   ref?: React.Ref<HTMLButtonElement>;
 }): React.JSX.Element;
 //#endregion
-export { ActionGuide, ActionGuideAction, ActionGuideActionProps, ActionGuideHeadingLevel, ActionGuideList, ActionGuideListLayout, ActionGuideListProps, ActionGuideProps, ActionGuideSection, ActionGuideSectionProps };
+export { ActionGuide, ActionGuideAction, ActionGuideActionItem, ActionGuideActionProps, ActionGuideHeadingLevel, ActionGuideList, ActionGuideListLayout, ActionGuideListProps, ActionGuideProps, ActionGuideSection, ActionGuideSectionItem, ActionGuideSectionProps };

package/dist/components/ActionGuide.js

@@ -4,14 +4,15 @@ import * as React from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/components/ActionGuide.tsx
 /**
-* Composable, app-agnostic guide for presenting groups of useful actions.
+* App-agnostic guide hydrated from product-owned sections and actions.
 *
 * Product code owns the copy, icons, availability, and click behavior. This
 * component owns only the shared article rhythm and responsive layout.
 */
-function ActionGuide({ title, description, headingLevel = 2, children, className, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, ref, ...props }) {
+function ActionGuide({ title, description, headingLevel = 2, sections, onAction, className, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, ref, ...props }) {
 	const titleId = React.useId();
 	const Title = `h${headingLevel}`;
+	const sectionHeadingLevel = Math.min(headingLevel + 1, 6);
 	return /* @__PURE__ */ jsxs("article", {
 		ref,
 		"data-slot": "action-guide",
@@ -33,10 +34,23 @@ function ActionGuide({ title, description, headingLevel = 2, children, className
 				className: "action-guide__description",
 				children: description
 			}) : null]
-		}), children]
+		}), sections.map((section) => /* @__PURE__ */ jsx(ActionGuideSection, {
+			title: section.title,
+			headingLevel: sectionHeadingLevel,
+			children: /* @__PURE__ */ jsx(ActionGuideList, {
+				layout: section.layout,
+				children: section.actions.map((action) => /* @__PURE__ */ jsx(ActionGuideAction, {
+					icon: action.icon,
+					variant: action.variant,
+					disabled: action.disabled,
+					onClick: () => onAction(action),
+					children: action.label
+				}, action.id))
+			})
+		}, section.id))]
 	});
 }
-/** A labelled group inside an {@link ActionGuide}. */
+/** A labelled action group for custom guide compositions. */
 function ActionGuideSection({ title, headingLevel = 3, children, className, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, ref, ...props }) {
 	const titleId = React.useId();
 	const Title = `h${headingLevel}`;

package/dist/components/AgentChat.d.ts

@@ -1,2 +1,2 @@
-import { a as PermissionModeControl, i as AgentChatRenderMessageContext, n as AgentChatComposerDraft, r as AgentChatProps, t as AgentChat } from "../AgentChat-B6sgfQ_q.js";
+import { a as PermissionModeControl, i as AgentChatRenderMessageContext, n as AgentChatComposerDraft, r as AgentChatProps, t as AgentChat } from "../AgentChat-Dy3cKCd-.js";
 export { AgentChat, AgentChatComposerDraft, AgentChatProps, AgentChatRenderMessageContext, PermissionModeControl };

package/dist/components/AgentChat.js

@@ -22,7 +22,7 @@ import { isTextUIPart } from "ai";
 //#region src/components/AgentChat.tsx
 /**
 * Agents exports this helper from `agents/sessions` after cloudflare/agents#1896;
-* the current 0.17.4 release still publishes it from the experimental path.
+* the current 0.19.0 release still publishes it from the experimental path.
 * It checks the canonical `compaction_` id prefix used when Session history
 * materializes a summary overlay. `UIMessage` is structurally compatible with
 * the `SessionMessage` fields it reads, so use the upstream helper directly
@@ -210,11 +210,12 @@ const AgentChatTranscriptRowBody = React.memo(AgentChatTranscriptRowBodyImpl);
 *   announce re-inserted old rows as new); announce new messages from a
 *   host-owned live region if that matters.
 */
-function AgentChat({ className, messages, status = "ready", onSubmit, showComposer = onSubmit !== void 0, onStop, placeholder = "Ask anything...", disabled, emptyState, startScreen, composerHeader, composerTray, composerTools, slashCommands, onCompact, mentionCommands, contextSelector, composerEndTools, voiceInput, beforeVoiceStart, composerAddMenuItems, notice, onRegenerate, onEditAndResend, onApprovalResponse, thinkStub, approvalsEnabled = true, permissionModeControl, onExecutionSettled, pendingApprovals: durableApprovals = EMPTY_PENDING_APPROVALS, contextWindow, renderPart, renderMessageAfter, showAssistantActions, ref }) {
+function AgentChat({ className, messages, status = "ready", onSubmit, showComposer = onSubmit !== void 0, onStop, onPromptQueued, placeholder = "Ask anything...", disabled, emptyState, startScreen, composerHeader, composerTray, composerTools, slashCommands, onCompact, mentionCommands, contextSelector, composerEndTools, voiceInput, beforeVoiceStart, composerAddMenuItems, notice, onRegenerate, onEditAndResend, onApprovalResponse, thinkStub, approvalsEnabled = true, permissionModeControl, onExecutionSettled, pendingApprovals: durableApprovals = EMPTY_PENDING_APPROVALS, contextWindow, renderPart, renderMessageAfter, showAssistantActions, ref }) {
 	const [copyAnnouncement, setCopyAnnouncement] = React.useState("");
 	const [composerDraft, setComposerDraft] = React.useState("");
 	const [composerReferences, setComposerReferences] = React.useState([]);
 	const [pendingPrompts, setPendingPrompts] = React.useState([]);
+	const [queueHeld, setQueueHeld] = React.useState(false);
 	const busy = status === "submitted" || status === "streaming";
 	const wasBusy = React.useRef(busy);
 	const addComposerReference = React.useCallback((reference) => {
@@ -240,30 +241,42 @@ function AgentChat({ className, messages, status = "ready", onSubmit, showCompos
 			...message,
 			...composerReferences.length ? { references: composerReferences } : {}
 		};
-		const submission = busy || pendingPrompts.length ? setPendingPrompts((current) => [...current, {
-			id: crypto.randomUUID(),
-			message: prompt
-		}]) : onSubmit?.(prompt);
+		setQueueHeld(false);
 		setComposerDraft("");
 		setComposerReferences([]);
-		return submission;
+		if (busy || pendingPrompts.length && !queueHeld) {
+			setPendingPrompts((current) => [...current, {
+				id: crypto.randomUUID(),
+				message: prompt
+			}]);
+			onPromptQueued?.();
+			return;
+		}
+		return onSubmit?.(prompt);
 	}, [
 		busy,
 		composerReferences,
+		onPromptQueued,
 		onSubmit,
-		pendingPrompts.length
+		pendingPrompts.length,
+		queueHeld
 	]);
+	const handleStop = React.useMemo(() => onStop ? () => {
+		setQueueHeld(true);
+		onStop();
+	} : void 0, [onStop]);
 	React.useEffect(() => {
 		const becameReady = wasBusy.current && !busy;
 		wasBusy.current = busy;
 		const next = pendingPrompts[0];
-		if (!becameReady || !next || !onSubmit) return;
+		if (!becameReady || queueHeld || !next || !onSubmit) return;
 		setPendingPrompts((current) => current.slice(1));
 		onSubmit(next.message);
 	}, [
 		busy,
 		onSubmit,
-		pendingPrompts
+		pendingPrompts,
+		queueHeld
 	]);
 	const [compactionNotice, setCompactionNotice] = React.useState(null);
 	const compactionInFlight = React.useRef(false);
@@ -558,7 +571,7 @@ function AgentChat({ className, messages, status = "ready", onSubmit, showCompos
 							}) : null,
 							/* @__PURE__ */ jsx(AgentChatSubmitAction, {
 								status,
-								onStop,
+								onStop: handleStop,
 								disabled,
 								hasDraft: Boolean(composerDraft.trim() || composerReferences.length)
 							})

package/dist/components/AgentChatStartScreen.d.ts

@@ -1,2 +1,2 @@
-import { a as AgentChatStarterListProps, i as AgentChatStarterList, n as AgentChatStartScreenProps, o as AgentChatStarterProps, r as AgentChatStarter, t as AgentChatStartScreen } from "../AgentChatStartScreen-DDZ25aax.js";
-export { AgentChatStartScreen, AgentChatStartScreenProps, AgentChatStarter, AgentChatStarterList, AgentChatStarterListProps, AgentChatStarterProps };
+import { a as AgentChatStarterList, i as AgentChatStarterItem, n as AgentChatStartScreenProps, o as AgentChatStarterListProps, r as AgentChatStarter, s as AgentChatStarterProps, t as AgentChatStartScreen } from "../AgentChatStartScreen-DXZ0hAX0.js";
+export { AgentChatStartScreen, AgentChatStartScreenProps, AgentChatStarter, AgentChatStarterItem, AgentChatStarterList, AgentChatStarterListProps, AgentChatStarterProps };

package/dist/components/AgentChatStartScreen.js

@@ -13,7 +13,7 @@ import { jsx, jsxs } from "react/jsx-runtime";
 * the same live composer moves from the center of the empty view to the pinned
 * transcript position after the first message.
 */
-function AgentChatStartScreen({ heading = "What should we work on?", composer, composerTray, children, className, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, ...props }) {
+function AgentChatStartScreen({ heading = "What should we work on?", composer, composerTray, starters, className, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, ...props }) {
 	const headingId = React.useId();
 	return /* @__PURE__ */ jsx("section", {
 		"data-slot": "agent-chat-start-screen",
@@ -37,20 +37,31 @@ function AgentChatStartScreen({ heading = "What should we work on?", composer, c
 						children: composerTray
 					}) : null]
 				})]
-			}), children ? /* @__PURE__ */ jsx("div", {
+			}), starters?.items.length ? /* @__PURE__ */ jsx("div", {
 				className: "agent-chat-start-screen__starters",
-				children
+				children: /* @__PURE__ */ jsx(AgentChatStarterList, { ...starters })
 			}) : null]
 		})
 	});
 }
 /** Semantic list for first-turn prompts below an `AgentChatStartScreen`. */
-function AgentChatStarterList({ className, ...props }) {
+function AgentChatStarterList({ items, onSelect, onDismiss, className, ...props }) {
 	return /* @__PURE__ */ jsx("ul", {
 		"data-slot": "agent-chat-starter-list",
 		role: "list",
 		className: cx("agent-chat-starter-list", className),
-		...props
+		...props,
+		children: items.map((item) => /* @__PURE__ */ jsx(AgentChatStarter, {
+			icon: item.icon,
+			muted: item.muted,
+			disabled: item.disabled,
+			dismissLabel: item.dismissLabel,
+			onDismiss: item.dismissLabel && onDismiss ? () => {
+				onDismiss(item);
+			} : void 0,
+			onClick: () => onSelect(item),
+			children: item.label
+		}, item.id))
 	});
 }
 /** One full-width, keyboard-native starter prompt. */

package/dist/components/AgentConnection.d.ts

@@ -1,4 +1,4 @@
-import { d as McpServerSetupAuthFieldName, l as McpServerSetupAuth } from "../mcp-server-catalog-BewjV7Eq.js";
+import { d as McpServerSetupAuthFieldName, l as McpServerSetupAuth } from "../mcp-server-catalog-CO7GAl1f.js";
 import * as React from "react";
 
 //#region src/components/AgentConnection.d.ts

package/dist/components/AgentToolDetail.js

@@ -5,7 +5,7 @@ import { AppTopBar } from "./AppTopBar.js";
 import { NaniteMark } from "./NaniteScene.js";
 import { SubagentRunIndicator, getSubagentRunName } from "./SubagentRunIndicator.js";
 import { SubagentRunMilestone, SubagentRunMilestones, SubagentRunProgress } from "./SubagentRunDetails.js";
-import { t as ThinkChat } from "../ThinkChat-DVhCEjq-.js";
+import { t as ThinkChat } from "../ThinkChat-Bp-nAnoW.js";
 import * as React from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useAgentChat } from "@cloudflare/think/react";

package/dist/components/ChatGptSignInScreen.d.ts

@@ -1,6 +1,11 @@
 import * as React from "react";
 
 //#region src/components/ChatGptSignInScreen.d.ts
+interface ChatGptSignInSecondaryAction {
+  label: React.ReactNode;
+  onSelect: () => void;
+  disabled?: boolean;
+}
 interface ChatGptSignInScreenProps extends React.HTMLAttributes<HTMLElement> {
   /** Whether the sign-in request is currently opening ChatGPT. */
   busy?: boolean;
@@ -16,6 +21,8 @@ interface ChatGptSignInScreenProps extends React.HTMLAttributes<HTMLElement> {
   brandLogo?: React.ReactNode;
   /** Called when the user clicks the sign-in action. */
   onSignIn?: () => void;
+  /** Optional app-owned alternative rendered in the shared full-screen layout. */
+  secondaryAction?: ChatGptSignInSecondaryAction;
 }
 /** Full-screen ChatGPT authentication prompt for MCP-B onboarding. */
 declare function ChatGptSignInScreen({
@@ -29,10 +36,11 @@ declare function ChatGptSignInScreen({
   onPointerLeave,
   onPointerMove,
   onSignIn,
+  secondaryAction,
   ref,
   ...props
 }: ChatGptSignInScreenProps & {
   ref?: React.Ref<HTMLElement>;
 }): React.JSX.Element;
 //#endregion
-export { ChatGptSignInScreen, ChatGptSignInScreenProps };
+export { ChatGptSignInScreen, ChatGptSignInScreenProps, ChatGptSignInSecondaryAction };