@mcp-b/react-components 0.48.0 → 0.49.0

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

@@ -1,2 +1,198 @@
-import { a as PermissionModeControl, i as AgentChatRenderMessageContext, n as AgentChatComposerDraft, o as compactingNotice, r as AgentChatProps, t as AgentChat } from "../../AgentChat-BLmQghkt.js";
-export { AgentChat, AgentChatComposerDraft, AgentChatProps, AgentChatRenderMessageContext, PermissionModeControl, compactingNotice };
+import { D as PromptInputCommandDefinition, J as PromptInputMessage, r as PromptInput, vt as PromptInputTray } from "../../PromptInput-C4Mofitz.js";
+import { r as AgentChatQueuedPrompt } from "../../AgentChatQueue-C_Jaw3Ia.js";
+import { AgentMessageRenderPartContext } from "../ai-sdk/AgentMessageParts.js";
+import { i as MessageActions } from "../../Message-DyaTBiV7.js";
+import { t as VirtualMessageScrollAnchor } from "../../MessageScrollerVirtual-D4afYwVB.js";
+import { a as getPendingToolApprovals } from "../../PromptInputApproval-D2hpn54U.js";
+import * as React from "react";
+import { useRender } from "@base-ui/react/use-render";
+import { ChatAddToolApproveResponseFunction, ChatStatus, UIMessage } from "ai";
+import { PendingApproval, Think } from "@cloudflare/think";
+import { AgentStub } from "agents/client";
+
+//#region src/components/agents-sdk/AgentChat.d.ts
+interface AgentChatRootProps<MessageT extends UIMessage = UIMessage> extends Omit<React.HTMLAttributes<HTMLDivElement>, "onSubmit"> {
+  /** Complete upstream messages, oldest first. Preserve identities across stream deltas. */
+  messages: readonly MessageT[];
+  status?: ChatStatus;
+  onSubmit?: (message: PromptInputMessage) => void | Promise<void>;
+  onStop?: () => void | Promise<void>;
+  /** Called after a prompt is queued while a response is in progress. */
+  onPromptQueued?: () => void;
+  onRegenerate?: (messageId: string) => void;
+  /** This callback owns the durable edit; Think setMessages is display-only. */
+  onEditAndResend?: (input: {
+    message: MessageT;
+    text: string;
+  }) => void | Promise<void>;
+  onApprovalResponse?: ChatAddToolApproveResponseFunction;
+  /** Explicit transcript, dock, and other parts sharing this chat runtime. */
+  children: React.ReactNode;
+}
+interface AgentChatRenderMessageContext<MessageT extends UIMessage = UIMessage> {
+  message: MessageT;
+  messageIndex: number;
+}
+interface AgentChatRuntime<MessageT extends UIMessage = UIMessage> {
+  messages: readonly MessageT[];
+  status: ChatStatus;
+  busy: boolean;
+  submit: (message: PromptInputMessage) => void | Promise<void>;
+  stop: (() => void) | undefined;
+  canSubmit: boolean;
+  onRegenerate: AgentChatRootProps<MessageT>["onRegenerate"];
+  onEditAndResend: AgentChatRootProps<MessageT>["onEditAndResend"];
+  onApprovalResponse: ChatAddToolApproveResponseFunction | undefined;
+  queued: readonly AgentChatQueuedPrompt[];
+  removeQueued: (id: string) => void;
+  steer: (id: string) => Promise<void>;
+  captureSubmit: () => AgentChatRuntime<MessageT>["submit"];
+  queueError: string | null;
+  submissionVersion: number;
+  dockRef: React.RefObject<HTMLDivElement | null>;
+  announce: (text: string) => void;
+}
+declare function useAgentChatRuntime<MessageT extends UIMessage = UIMessage>(): AgentChatRuntime<MessageT>;
+/** Layout and runtime adapter over the nearest queue owner; connections remain host-owned. */
+declare function AgentChatRoot<MessageT extends UIMessage = UIMessage>({
+  onSubmit,
+  onStop,
+  onPromptQueued,
+  ...props
+}: AgentChatRootProps<MessageT> & {
+  ref?: React.Ref<HTMLDivElement>;
+}): React.JSX.Element;
+interface AgentChatTranscriptProps<MessageT extends UIMessage = UIMessage> {
+  /** Explicit message composition. No message actions or content are injected. */
+  children: (context: AgentChatRenderMessageContext<MessageT>) => React.ReactNode;
+  emptyState?: React.ReactNode;
+  className?: string;
+  /** Parent-owned reading position retained while the transcript is unmounted. */
+  scrollAnchor?: React.RefObject<VirtualMessageScrollAnchor | undefined>;
+}
+/** Windowed transcript. Historical rows are never a live region; their disclosure state survives windowing. */
+declare function AgentChatTranscript<MessageT extends UIMessage = UIMessage>({
+  children,
+  emptyState,
+  className,
+  scrollAnchor
+}: AgentChatTranscriptProps<MessageT>): React.JSX.Element;
+declare function AgentChatLoading(): React.JSX.Element;
+interface AgentChatMessageProps<MessageT extends UIMessage = UIMessage> extends AgentChatRenderMessageContext<MessageT> {
+  children: React.ReactNode;
+}
+/** Preserves runtime-authored event/compaction provenance and owns only the local edit lifecycle. */
+declare function AgentChatMessage<MessageT extends UIMessage = UIMessage>({
+  message,
+  messageIndex,
+  children
+}: AgentChatMessageProps<MessageT>): React.JSX.Element;
+interface AgentChatMessageContentProps<MessageT extends UIMessage = UIMessage> {
+  message: MessageT;
+  renderPart?: (context: AgentMessageRenderPartContext<MessageT>) => React.ReactNode | undefined;
+}
+declare function AgentChatMessageContent<MessageT extends UIMessage = UIMessage>({
+  message,
+  renderPart
+}: AgentChatMessageContentProps<MessageT>): React.JSX.Element;
+/** Stable action space for a message; callers choose every action inside it. */
+declare function AgentChatActions({
+  children,
+  ...props
+}: React.ComponentProps<typeof MessageActions>): React.JSX.Element;
+declare function AgentChatCopyAction(): React.JSX.Element | null;
+declare function AgentChatRetryAction(): React.JSX.Element | null;
+declare function AgentChatEditAction(): React.JSX.Element | null;
+declare function AgentChatTimestamp(): React.JSX.Element | null;
+interface AgentChatComposerProps extends Omit<React.ComponentProps<typeof PromptInput>, "onSubmit"> {
+  /** Makes the composer and its controls inert without changing the chat runtime. */
+  disabled?: boolean;
+}
+/** Measured bottom surface for notices, queued prompts, approvals and the form. */
+declare function AgentChatDock({
+  children,
+  render,
+  ref,
+  ...props
+}: useRender.ComponentProps<"div">): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+/** Submission adapter only. Compose it inside Dock; the caller owns its inputs and controls. */
+declare function AgentChatComposer({
+  children,
+  disabled,
+  className,
+  onSubmitCapture,
+  ...props
+}: AgentChatComposerProps): React.JSX.Element;
+declare function AgentChatSubmit({
+  disabled
+}: {
+  /** Disables the submission control independently of the chat runtime. */disabled?: boolean;
+}): React.JSX.Element;
+interface AgentChatPromptTrayProps extends Omit<React.ComponentProps<typeof PromptInputTray>, "side"> {}
+/** A queue tray aligned with the chat composer. */
+declare function AgentChatPromptTray({
+  className,
+  ...props
+}: AgentChatPromptTrayProps): React.JSX.Element;
+declare function AgentChatQueue(): React.JSX.Element | null;
+declare function AgentChatNotice({
+  children,
+  ...props
+}: React.HTMLAttributes<HTMLDivElement>): React.JSX.Element;
+/** Approval discovery is explicit. Mounting this owner never grants permission. */
+interface AgentChatApprovalsProps {
+  thinkStub?: AgentStub<Think>;
+  pendingApprovals?: readonly PendingApproval[];
+  onExecutionSettled?: () => void | Promise<void>;
+  children: React.ReactNode;
+}
+type ApprovalItem = {
+  part: ReturnType<typeof getPendingToolApprovals>[number];
+} | {
+  approval: PendingApproval;
+};
+interface ApprovalsValue {
+  pending: readonly ApprovalItem[];
+  skip: () => void;
+  settled: () => Promise<void>;
+  thinkStub?: AgentStub<Think>;
+}
+declare function useAgentChatApprovals(): ApprovalsValue;
+declare function AgentChatApprovals({
+  thinkStub,
+  pendingApprovals,
+  onExecutionSettled,
+  children
+}: AgentChatApprovalsProps): React.JSX.Element;
+declare function AgentChatApproval(): React.JSX.Element | null;
+declare const compactingNotice: React.JSX.Element;
+/** Explicit command action controller; callers put its command in the catalog and its notice where appropriate. */
+declare function useAgentChatCompaction(onCompact: () => Promise<{
+  compacted: boolean;
+}>): {
+  command: PromptInputCommandDefinition | undefined;
+  run: () => void;
+  notice: string | React.JSX.Element | null;
+};
+declare const AgentChat: {
+  Root: typeof AgentChatRoot;
+  Transcript: typeof AgentChatTranscript;
+  Message: typeof AgentChatMessage;
+  MessageContent: typeof AgentChatMessageContent;
+  Actions: typeof AgentChatActions;
+  CopyAction: typeof AgentChatCopyAction;
+  RetryAction: typeof AgentChatRetryAction;
+  EditAction: typeof AgentChatEditAction;
+  Timestamp: typeof AgentChatTimestamp;
+  Dock: typeof AgentChatDock;
+  Composer: typeof AgentChatComposer;
+  Submit: typeof AgentChatSubmit;
+  PromptTray: typeof AgentChatPromptTray;
+  Queue: typeof AgentChatQueue;
+  Notice: typeof AgentChatNotice;
+  Loading: typeof AgentChatLoading;
+  Approvals: typeof AgentChatApprovals;
+  Approval: typeof AgentChatApproval;
+};
+//#endregion
+export { AgentChat, AgentChatActions, AgentChatApproval, AgentChatApprovals, AgentChatApprovalsProps, AgentChatComposer, AgentChatComposerProps, AgentChatCopyAction, AgentChatDock, AgentChatEditAction, AgentChatLoading, AgentChatMessage, AgentChatMessageContent, AgentChatMessageContentProps, AgentChatMessageProps, AgentChatNotice, AgentChatPromptTray, AgentChatPromptTrayProps, AgentChatQueue, AgentChatRenderMessageContext, AgentChatRetryAction, AgentChatRoot, AgentChatRootProps, AgentChatSubmit, AgentChatTimestamp, AgentChatTranscript, AgentChatTranscriptProps, compactingNotice, useAgentChatApprovals, useAgentChatCompaction, useAgentChatRuntime };