modifywithai 1.10.0 → 2.2.1

package/dist/index-B2dmSvFt.d.ts

@@ -0,0 +1,1272 @@
+import { S as UseDynamicUIReturn, a as AssistantConfig, b as UseAssistantTokenOptions, c as DynamicButton, g as ToolAction, l as DynamicButtonGroup, t as ActionDefinition, v as UseAssistantOptions, x as UseAssistantTokenReturn, y as UseAssistantReturn } from "./types-C7I0JuqF.js";
+import * as React$2 from "react";
+import React$1, { ComponentProps, FormEvent, HTMLAttributes, ReactNode } from "react";
+import { ClassValue } from "clsx";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { ComponentRegistry, ComponentRenderProps } from "@json-render/react";
+import { Streamdown } from "streamdown";
+import * as CollapsiblePrimitive from "@radix-ui/react-collapsible";
+import { ChatStatus, ToolUIPart, UIMessage } from "ai";
+import { Drawer } from "vaul-base";
+import { UITree } from "@json-render/core";
+
+//#region src/assistant/components/assistant-messages.d.ts
+interface AssistantMessagesProps {
+  /** The chat messages to render */
+  messages: UIMessage[];
+  /** Function to send a new message */
+  sendMessage: (message: {
+    text: string;
+  }) => void;
+  /** Function to add a tool approval response */
+  addToolApprovalResponse: (response: {
+    id: string;
+    approved: boolean;
+  }) => void;
+  /**
+   * Optional function to get a human-readable description for an action.
+   * If not provided, uses action.name as the description.
+   */
+  getActionDescription?: (action: ToolAction) => string;
+  /** Optional className for the container */
+  className?: string;
+}
+/**
+ * Renders a list of chat messages with proper handling of all part types:
+ * - text: Rendered as markdown via MessageResponse
+ * - tool-performActions: Rendered as Confirmation (if approval needed) or Task (if not)
+ * - tool-renderUI: Rendered as AssistantFormRenderer (only on last message)
+ *
+ * @example
+ * ```tsx
+ * <AssistantMessages
+ *   messages={assistant.messages}
+ *   sendMessage={assistant.sendMessage}
+ *   addToolApprovalResponse={assistant.addToolApprovalResponse}
+ *   getActionDescription={(action) => `${ACTION_LABELS[action.name]}: ${action.options?.text}`}
+ * />
+ * ```
+ */
+declare function AssistantMessages({
+  messages,
+  sendMessage,
+  addToolApprovalResponse,
+  getActionDescription,
+  className
+}: AssistantMessagesProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/assistant/components/confirmation.d.ts
+/**
+ * Approval state for a tool invocation
+ */
+type ToolUIPartApproval = {
+  id: string;
+  approved?: never;
+  reason?: never;
+} | {
+  id: string;
+  approved: boolean;
+  reason?: string;
+} | undefined;
+type ConfirmationProps = ComponentProps<"div"> & {
+  /** The approval state from the tool invocation */approval?: ToolUIPartApproval; /** The current state of the tool invocation */
+  state: ToolUIPart["state"];
+};
+/**
+ * Container for tool approval/confirmation UI
+ *
+ * Provides context for child components and handles visibility
+ * based on the tool invocation state.
+ *
+ * @example
+ * ```tsx
+ * <Confirmation state={state} approval={approval}>
+ *   <ConfirmationTitle>Confirm action</ConfirmationTitle>
+ *   <ConfirmationRequest>
+ *     <ul>{actions.map(a => <li key={a.name}>{a.name}</li>)}</ul>
+ *   </ConfirmationRequest>
+ *   <ConfirmationAccepted>Done!</ConfirmationAccepted>
+ *   <ConfirmationRejected>Cancelled</ConfirmationRejected>
+ *   <ConfirmationActions>
+ *     <ConfirmationAction onClick={deny}>Deny</ConfirmationAction>
+ *     <ConfirmationAction onClick={approve}>Approve</ConfirmationAction>
+ *   </ConfirmationActions>
+ * </Confirmation>
+ * ```
+ */
+declare function Confirmation({
+  className,
+  approval,
+  state,
+  ...props
+}: ConfirmationProps): react_jsx_runtime0.JSX.Element | null;
+type ConfirmationTitleProps = ComponentProps<"p">;
+/**
+ * Title for the confirmation dialog
+ */
+declare function ConfirmationTitle({
+  className,
+  ...props
+}: ConfirmationTitleProps): react_jsx_runtime0.JSX.Element;
+type ConfirmationRequestProps = {
+  children?: ReactNode;
+};
+/**
+ * Content shown when approval is requested (before user response)
+ */
+declare function ConfirmationRequest({
+  children
+}: ConfirmationRequestProps): react_jsx_runtime0.JSX.Element | null;
+type ConfirmationAcceptedProps = {
+  children?: ReactNode;
+};
+/**
+ * Content shown when the action was approved
+ */
+declare function ConfirmationAccepted({
+  children
+}: ConfirmationAcceptedProps): react_jsx_runtime0.JSX.Element | null;
+type ConfirmationRejectedProps = {
+  children?: ReactNode;
+};
+/**
+ * Content shown when the action was rejected/denied
+ */
+declare function ConfirmationRejected({
+  children
+}: ConfirmationRejectedProps): react_jsx_runtime0.JSX.Element | null;
+type ConfirmationActionsProps = ComponentProps<"div">;
+/**
+ * Container for approve/deny action buttons
+ *
+ * Only visible when approval is requested.
+ */
+declare function ConfirmationActions({
+  className,
+  ...props
+}: ConfirmationActionsProps): react_jsx_runtime0.JSX.Element | null;
+type ConfirmationActionProps = ComponentProps<"button"> & {
+  /** Button variant for styling */variant?: "default" | "outline" | "destructive";
+};
+/**
+ * Action button for the confirmation dialog (approve/deny)
+ *
+ * @example
+ * ```tsx
+ * <ConfirmationActions>
+ *   <ConfirmationAction variant="outline" onClick={deny}>
+ *     Deny
+ *   </ConfirmationAction>
+ *   <ConfirmationAction onClick={approve}>
+ *     Approve
+ *   </ConfirmationAction>
+ * </ConfirmationActions>
+ * ```
+ */
+declare function ConfirmationAction({
+  className,
+  variant,
+  ...props
+}: ConfirmationActionProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/assistant/components/conversation.d.ts
+type ConversationProps = HTMLAttributes<HTMLDivElement>;
+/**
+ * Container for the chat conversation
+ *
+ * Provides semantic structure with `role="log"` for accessibility.
+ *
+ * @example
+ * ```tsx
+ * <Conversation>
+ *   <ConversationContent>
+ *     {messages.length === 0 ? (
+ *       <ConversationEmptyState
+ *         title="No messages yet"
+ *         description="Start a conversation"
+ *       />
+ *     ) : (
+ *       messages.map(msg => <Message key={msg.id} {...msg} />)
+ *     )}
+ *   </ConversationContent>
+ * </Conversation>
+ * ```
+ */
+declare function Conversation({
+  className,
+  children,
+  ...props
+}: ConversationProps): react_jsx_runtime0.JSX.Element;
+type ConversationContentProps = HTMLAttributes<HTMLDivElement>;
+/**
+ * Scrollable content area for messages
+ *
+ * Automatically scrolls to the bottom when children change,
+ * keeping the most recent messages visible.
+ *
+ * @example
+ * ```tsx
+ * <ConversationContent aria-live="polite">
+ *   {messages.map(msg => <Message key={msg.id} {...msg} />)}
+ * </ConversationContent>
+ * ```
+ */
+declare function ConversationContent({
+  className,
+  children,
+  ...props
+}: ConversationContentProps): react_jsx_runtime0.JSX.Element;
+type ConversationEmptyStateProps = ComponentProps<"div"> & {
+  /** Title text for the empty state */title?: string; /** Description text for the empty state */
+  description?: string; /** Icon to display above the title */
+  icon?: ReactNode;
+};
+/**
+ * Empty state placeholder shown when there are no messages
+ *
+ * @example
+ * ```tsx
+ * <ConversationEmptyState
+ *   icon={<MessageSquare className="size-12" />}
+ *   title="Start a conversation"
+ *   description="Ask me anything about your tasks"
+ * />
+ * ```
+ */
+declare function ConversationEmptyState({
+  className,
+  title,
+  description,
+  icon,
+  children,
+  ...props
+}: ConversationEmptyStateProps): react_jsx_runtime0.JSX.Element;
+type ConversationScrollButtonProps = ComponentProps<"button">;
+/**
+ * Button to scroll to the bottom of the conversation
+ *
+ * @example
+ * ```tsx
+ * <ConversationScrollButton onClick={scrollToBottom}>
+ *   <ArrowDownIcon />
+ * </ConversationScrollButton>
+ * ```
+ */
+declare function ConversationScrollButton({
+  className,
+  ...props
+}: ConversationScrollButtonProps): null;
+//#endregion
+//#region src/assistant/components/dynamic-action-modal.d.ts
+interface DynamicActionModalProps {
+  /** The button that was clicked */
+  button: DynamicButton | null;
+  /** Available action definitions (to check for required options) */
+  availableActions?: ActionDefinition[];
+  /** Called when actions should be executed */
+  onExecute: (actions: ToolAction[]) => void;
+  /** Called when modal should close */
+  onClose: () => void;
+}
+/**
+ * Modal that handles button click flows:
+ * 1. If actions need input, render form fields
+ * 2. If actions need approval, show confirmation
+ * 3. Execute actions when complete
+ */
+declare function DynamicActionModal({
+  button,
+  availableActions,
+  onExecute,
+  onClose
+}: DynamicActionModalProps): react_jsx_runtime0.JSX.Element | null;
+//#endregion
+//#region src/assistant/components/dynamic-ui.d.ts
+interface DynamicUIProps {
+  /** Additional CSS class names */
+  className?: string;
+}
+/**
+ * DynamicUI component that renders persistent action buttons
+ *
+ * This component:
+ * - Renders within AssistantProvider context
+ * - Displays buttons that trigger arrays of actions
+ * - Shows input modal when actions require data collection
+ * - Shows approval modal when actions have approvalRequired: true
+ * - Persists button configuration to localStorage
+ *
+ * The AI can add/remove/update buttons via the manageDynamicUI tool.
+ *
+ * @example
+ * ```tsx
+ * import { AssistantProvider, DynamicUI } from "modifywithai"
+ *
+ * function App() {
+ *   return (
+ *     <AssistantProvider
+ *       endUserId="user-123"
+ *       availableActions={MY_ACTIONS}
+ *       onAction={handleAction}
+ *     >
+ *       <DynamicUI className="my-quick-actions" />
+ *       <MainContent />
+ *       <AssistantChat />
+ *     </AssistantProvider>
+ *   )
+ * }
+ * ```
+ */
+declare function DynamicUI({
+  className
+}: DynamicUIProps): react_jsx_runtime0.JSX.Element | null;
+//#endregion
+//#region src/assistant/components/dynamic-ui-components.d.ts
+/**
+ * Renderer for DynamicButton elements
+ *
+ * Renders a button that triggers its configured actions when clicked.
+ * Uses the onAction callback to handle action execution.
+ */
+declare function DynamicButtonRenderer({
+  element,
+  onAction
+}: ComponentRenderProps<DynamicButton>): react_jsx_runtime0.JSX.Element | null;
+/**
+ * Renderer for DynamicButtonGroup elements
+ *
+ * Renders a container for organizing buttons.
+ * When no label is set (e.g., root group), renders children directly without wrapper.
+ */
+declare function DynamicButtonGroupRenderer({
+  element,
+  children
+}: ComponentRenderProps<DynamicButtonGroup>): react_jsx_runtime0.JSX.Element;
+/**
+ * Component registry for DynamicUI rendering
+ */
+declare const dynamicUIRegistry: ComponentRegistry;
+//#endregion
+//#region src/assistant/components/form-components.d.ts
+/**
+ * Form component - renders a card container with children and submit button
+ *
+ * Props:
+ * - id: Form identifier (used in submit/cancel callbacks)
+ * - title: Optional title displayed in header
+ * - submitLabel: Label for submit button (default: "Submit")
+ */
+declare function FormRenderer({
+  element,
+  children,
+  onAction
+}: ComponentRenderProps<{
+  id: string;
+  title?: string;
+  submitLabel?: string;
+}>): react_jsx_runtime0.JSX.Element;
+/**
+ * TextField component - renders a labeled input field
+ *
+ * Props:
+ * - name: Input name attribute
+ * - label: Label text
+ * - placeholder: Placeholder text
+ * - required: Whether field is required
+ * - defaultValue: Initial value
+ */
+declare function TextFieldRenderer({
+  element
+}: ComponentRenderProps<{
+  name: string;
+  label: string;
+  placeholder?: string;
+  required?: boolean;
+  defaultValue?: string;
+}>): react_jsx_runtime0.JSX.Element;
+/**
+ * TextArea component - renders a labeled textarea for longer text
+ *
+ * Props:
+ * - name: Input name attribute
+ * - label: Label text
+ * - placeholder: Placeholder text
+ * - required: Whether field is required
+ * - defaultValue: Initial value
+ * - rows: Number of rows (default: 3)
+ */
+declare function TextAreaRenderer({
+  element
+}: ComponentRenderProps<{
+  name: string;
+  label: string;
+  placeholder?: string;
+  required?: boolean;
+  defaultValue?: string;
+  rows?: number;
+}>): react_jsx_runtime0.JSX.Element;
+/**
+ * DateField component - renders a labeled date input
+ *
+ * Props:
+ * - name: Input name attribute
+ * - label: Label text
+ * - required: Whether field is required
+ * - defaultValue: Initial value (ISO format)
+ * - min: Minimum date (ISO format)
+ * - max: Maximum date (ISO format)
+ */
+declare function DateFieldRenderer({
+  element
+}: ComponentRenderProps<{
+  name: string;
+  label: string;
+  required?: boolean;
+  defaultValue?: string;
+  min?: string;
+  max?: string;
+}>): react_jsx_runtime0.JSX.Element;
+/**
+ * Default component registry for form rendering
+ *
+ * Available components:
+ * - Form: Container with submit/cancel buttons
+ * - TextField: Text input with label
+ * - TextArea: Multi-line text input
+ * - DateField: Date picker input
+ *
+ * @example Extending the registry
+ * ```tsx
+ * import { defaultFormRegistry } from "modifywithai"
+ *
+ * const myRegistry = {
+ *   ...defaultFormRegistry,
+ *   CustomField: MyCustomFieldComponent,
+ * }
+ * ```
+ */
+declare const defaultFormRegistry: ComponentRegistry;
+//#endregion
+//#region src/assistant/components/form-renderer.d.ts
+interface AssistantFormRendererProps {
+  /** The UI tree to render (from renderUI tool output) */
+  ui: UITree;
+  /** Optional context data to pass to the form */
+  context?: Record<string, unknown>;
+  /** Called when form is submitted with formId and data */
+  onSubmit: (formId: string, data: Record<string, string>) => void;
+  /** Called when form is cancelled */
+  onCancel?: (formId: string) => void;
+  /** Custom component registry (defaults to defaultFormRegistry) */
+  registry?: ComponentRegistry;
+}
+/**
+ * Renders AI-generated forms from the renderUI tool output
+ *
+ * Wraps json-render's Renderer with a form component registry
+ * and handles form submission/cancellation.
+ *
+ * @example Basic usage
+ * ```tsx
+ * <AssistantFormRenderer
+ *   ui={output.ui}
+ *   context={output.context}
+ *   onSubmit={(formId, data) => {
+ *     sendMessage({ text: `[Form:${formId}] ${JSON.stringify(data)}` })
+ *   }}
+ *   onCancel={(formId) => {
+ *     sendMessage({ text: `[Form:${formId}] cancelled` })
+ *   }}
+ * />
+ * ```
+ *
+ * @example With custom registry
+ * ```tsx
+ * import { defaultFormRegistry } from "modifywithai"
+ *
+ * <AssistantFormRenderer
+ *   ui={output.ui}
+ *   onSubmit={handleSubmit}
+ *   registry={{
+ *     ...defaultFormRegistry,
+ *     CustomField: MyCustomFieldComponent,
+ *   }}
+ * />
+ * ```
+ */
+declare function AssistantFormRenderer({
+  ui,
+  context,
+  onSubmit,
+  onCancel,
+  registry
+}: AssistantFormRendererProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/assistant/components/message.d.ts
+type MessageProps = HTMLAttributes<HTMLDivElement> & {
+  /** The role of the message sender */from: UIMessage["role"];
+};
+/**
+ * Container for a single chat message
+ *
+ * Automatically styles user messages on the right and assistant messages on the left.
+ * Uses CSS class `.is-user` and `.is-assistant` for easy customization.
+ *
+ * @example
+ * ```tsx
+ * <Message from="user">
+ *   <MessageContent>Hello!</MessageContent>
+ * </Message>
+ *
+ * <Message from="assistant">
+ *   <MessageContent>
+ *     <MessageResponse>{response.text}</MessageResponse>
+ *   </MessageContent>
+ * </Message>
+ * ```
+ */
+declare function Message({
+  className,
+  from,
+  ...props
+}: MessageProps): react_jsx_runtime0.JSX.Element;
+type MessageContentProps = HTMLAttributes<HTMLDivElement>;
+/**
+ * Content wrapper for message text/elements
+ *
+ * Provides styling context for user vs assistant messages.
+ * User messages get a background and rounded corners.
+ *
+ * @example
+ * ```tsx
+ * <MessageContent>
+ *   {part.type === "text" ? (
+ *     <MessageResponse>{part.text}</MessageResponse>
+ *   ) : null}
+ * </MessageContent>
+ * ```
+ */
+declare function MessageContent({
+  children,
+  className,
+  ...props
+}: MessageContentProps): react_jsx_runtime0.JSX.Element;
+type MessageResponseProps = ComponentProps<typeof Streamdown>;
+/**
+ * Renders markdown content from the assistant using Streamdown
+ *
+ * Memoized for performance - only re-renders when children change.
+ * Supports streaming markdown content with proper rendering.
+ *
+ * @example
+ * ```tsx
+ * <MessageResponse>
+ *   {message.text}
+ * </MessageResponse>
+ * ```
+ */
+declare const MessageResponse: React$1.MemoExoticComponent<(props: MessageResponseProps) => React$1.JSX.Element>;
+//#endregion
+//#region src/assistant/components/primitives/collapsible.d.ts
+/**
+ * Root collapsible component
+ *
+ * @example
+ * ```tsx
+ * <Collapsible defaultOpen={true}>
+ *   <CollapsibleTrigger>Toggle</CollapsibleTrigger>
+ *   <CollapsibleContent>
+ *     Content that can be shown/hidden
+ *   </CollapsibleContent>
+ * </Collapsible>
+ * ```
+ */
+declare function Collapsible({
+  ...props
+}: React.ComponentProps<typeof CollapsiblePrimitive.Root>): react_jsx_runtime0.JSX.Element;
+/**
+ * Trigger element that toggles the collapsible content
+ */
+declare function CollapsibleTrigger({
+  ...props
+}: React.ComponentProps<typeof CollapsiblePrimitive.CollapsibleTrigger>): react_jsx_runtime0.JSX.Element;
+/**
+ * Content that is shown/hidden based on the collapsible state
+ *
+ * Uses data-[state=open] and data-[state=closed] for styling animations
+ */
+declare function CollapsibleContent({
+  ...props
+}: React.ComponentProps<typeof CollapsiblePrimitive.CollapsibleContent>): react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/assistant/components/primitives/drawer.d.ts
+/**
+ * Root drawer component
+ *
+ * @example
+ * ```tsx
+ * <Drawer>
+ *   <DrawerTrigger>Open</DrawerTrigger>
+ *   <DrawerContent>
+ *     <DrawerHeader>
+ *       <DrawerTitle>Drawer Title</DrawerTitle>
+ *       <DrawerDescription>Optional description</DrawerDescription>
+ *     </DrawerHeader>
+ *     <div>Content here</div>
+ *     <DrawerFooter>
+ *       <DrawerClose>Close</DrawerClose>
+ *     </DrawerFooter>
+ *   </DrawerContent>
+ * </Drawer>
+ * ```
+ */
+declare function Drawer$1({
+  ...props
+}: React$2.ComponentProps<typeof Drawer.Root>): react_jsx_runtime0.JSX.Element;
+/**
+ * Trigger element that opens the drawer
+ */
+declare function DrawerTrigger({
+  ...props
+}: React$2.ComponentProps<typeof Drawer.Trigger>): react_jsx_runtime0.JSX.Element;
+/**
+ * Portal for rendering drawer content outside the DOM hierarchy
+ */
+declare function DrawerPortal({
+  ...props
+}: React$2.ComponentProps<typeof Drawer.Portal>): react_jsx_runtime0.JSX.Element;
+/**
+ * Close button element for the drawer
+ */
+declare function DrawerClose({
+  ...props
+}: React$2.ComponentProps<typeof Drawer.Close>): react_jsx_runtime0.JSX.Element;
+/**
+ * Overlay backdrop for the drawer
+ */
+declare function DrawerOverlay({
+  className,
+  ...props
+}: React$2.ComponentProps<typeof Drawer.Overlay>): react_jsx_runtime0.JSX.Element;
+interface DrawerContentProps extends React$2.ComponentProps<typeof Drawer.Content> {
+  /** Whether to render the overlay (default: true) */
+  overlay?: boolean;
+}
+/**
+ * Content container for the drawer
+ *
+ * Supports multiple directions via the `direction` prop on the root Drawer:
+ * - bottom: Slides up from the bottom
+ * - top: Slides down from the top
+ * - left: Slides in from the left
+ * - right: Slides in from the right
+ */
+declare function DrawerContent({
+  className,
+  children,
+  overlay,
+  ...props
+}: DrawerContentProps): react_jsx_runtime0.JSX.Element;
+/**
+ * Header section for the drawer
+ */
+declare function DrawerHeader({
+  className,
+  ...props
+}: React$2.ComponentProps<"div">): react_jsx_runtime0.JSX.Element;
+/**
+ * Footer section for the drawer
+ */
+declare function DrawerFooter({
+  className,
+  ...props
+}: React$2.ComponentProps<"div">): react_jsx_runtime0.JSX.Element;
+/**
+ * Title element for the drawer
+ */
+declare function DrawerTitle({
+  className,
+  ...props
+}: React$2.ComponentProps<typeof Drawer.Title>): react_jsx_runtime0.JSX.Element;
+/**
+ * Description element for the drawer
+ */
+declare function DrawerDescription({
+  className,
+  ...props
+}: React$2.ComponentProps<typeof Drawer.Description>): react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/assistant/components/prompt-input.d.ts
+type PromptInputMessage = {
+  text: string;
+};
+type PromptInputProps = Omit<HTMLAttributes<HTMLFormElement>, "onSubmit"> & {
+  /** Called when the form is submitted with the message text */onSubmit: (message: PromptInputMessage, event: FormEvent<HTMLFormElement>) => void | Promise<void>;
+};
+/**
+ * Form wrapper for the chat prompt input
+ *
+ * Handles form submission and extracts the message text from a textarea with name="message".
+ *
+ * @example
+ * ```tsx
+ * <PromptInput onSubmit={({ text }) => sendMessage(text)}>
+ *   <PromptInputTextarea placeholder="Ask me anything..." />
+ *   <PromptInputFooter>
+ *     <PromptInputSubmit status={status} />
+ *   </PromptInputFooter>
+ * </PromptInput>
+ * ```
+ */
+declare function PromptInput({
+  className,
+  onSubmit,
+  children,
+  ...props
+}: PromptInputProps): react_jsx_runtime0.JSX.Element;
+type PromptInputTextareaProps = ComponentProps<"textarea">;
+/**
+ * Textarea for entering the chat prompt
+ *
+ * - Press Enter to submit (Shift+Enter for new line)
+ * - Handles IME composition for international text input
+ * - Auto-resizes based on content
+ *
+ * @example
+ * ```tsx
+ * <PromptInputTextarea
+ *   value={input}
+ *   onChange={(e) => setInput(e.target.value)}
+ *   placeholder="Type your message..."
+ * />
+ * ```
+ */
+declare function PromptInputTextarea({
+  onChange,
+  className,
+  placeholder,
+  ...props
+}: PromptInputTextareaProps): react_jsx_runtime0.JSX.Element;
+type PromptInputFooterProps = ComponentProps<"div">;
+/**
+ * Footer section for the prompt input (contains buttons)
+ *
+ * @example
+ * ```tsx
+ * <PromptInputFooter>
+ *   <div>Optional left content</div>
+ *   <PromptInputSubmit status={status} />
+ * </PromptInputFooter>
+ * ```
+ */
+declare function PromptInputFooter({
+  className,
+  ...props
+}: PromptInputFooterProps): react_jsx_runtime0.JSX.Element;
+type PromptInputButtonProps = ComponentProps<"button">;
+/**
+ * Generic button for the prompt input area
+ *
+ * @example
+ * ```tsx
+ * <PromptInputButton onClick={handleAttach}>
+ *   <PaperclipIcon />
+ * </PromptInputButton>
+ * ```
+ */
+declare function PromptInputButton({
+  className,
+  type,
+  children,
+  ...props
+}: PromptInputButtonProps): react_jsx_runtime0.JSX.Element;
+type PromptInputSubmitProps = ComponentProps<"button"> & {
+  /** Current chat status to show appropriate icon */status?: ChatStatus; /** Custom icon to override the default */
+  icon?: ReactNode;
+};
+/**
+ * Submit button for the prompt input
+ *
+ * Shows different icons based on the chat status:
+ * - ready/undefined: Send icon (CornerDownLeft)
+ * - submitted: Loading spinner
+ * - streaming: Stop icon (Square)
+ * - error: Error icon (X)
+ *
+ * @example
+ * ```tsx
+ * <PromptInputSubmit
+ *   status={status}
+ *   disabled={!input.trim() || status === "streaming"}
+ * />
+ * ```
+ */
+declare function PromptInputSubmit({
+  className,
+  status,
+  icon,
+  children,
+  ...props
+}: PromptInputSubmitProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/assistant/components/task.d.ts
+type TaskItemFileProps = ComponentProps<"div">;
+/**
+ * File badge within a task item
+ *
+ * @example
+ * ```tsx
+ * <TaskItem>
+ *   Updated <TaskItemFile>config.json</TaskItemFile>
+ * </TaskItem>
+ * ```
+ */
+declare function TaskItemFile({
+  children,
+  className,
+  ...props
+}: TaskItemFileProps): react_jsx_runtime0.JSX.Element;
+type TaskItemProps = ComponentProps<"div">;
+/**
+ * Individual task/action item within a Task list
+ *
+ * @example
+ * ```tsx
+ * <TaskItem>Add todo: "Buy groceries"</TaskItem>
+ * ```
+ */
+declare function TaskItem({
+  children,
+  className,
+  ...props
+}: TaskItemProps): react_jsx_runtime0.JSX.Element;
+type TaskProps = ComponentProps<typeof Collapsible>;
+/**
+ * Collapsible container for displaying a list of actions/tasks
+ *
+ * @example
+ * ```tsx
+ * <Task defaultOpen={true}>
+ *   <TaskTrigger title="Performing 3 actions" />
+ *   <TaskContent>
+ *     <TaskItem>Add todo: "Buy groceries"</TaskItem>
+ *     <TaskItem>Mark "Call mom" as complete</TaskItem>
+ *     <TaskItem>Delete "Old task"</TaskItem>
+ *   </TaskContent>
+ * </Task>
+ * ```
+ */
+declare function Task({
+  defaultOpen,
+  className,
+  ...props
+}: TaskProps): react_jsx_runtime0.JSX.Element;
+type TaskTriggerProps = ComponentProps<typeof CollapsibleTrigger> & {
+  /** Title text for the task group */title: string; /** Custom icon (defaults to SearchIcon) */
+  icon?: ReactNode;
+};
+/**
+ * Trigger button to expand/collapse the task list
+ *
+ * @example
+ * ```tsx
+ * <TaskTrigger title="Performing 3 actions" />
+ *
+ * // With custom icon
+ * <TaskTrigger title="File changes" icon={<FileIcon />} />
+ * ```
+ */
+declare function TaskTrigger({
+  children,
+  className,
+  title,
+  icon,
+  ...props
+}: TaskTriggerProps): react_jsx_runtime0.JSX.Element;
+type TaskContentProps = ComponentProps<typeof CollapsibleContent>;
+/**
+ * Collapsible content area containing the task items
+ *
+ * Includes slide animation when opening/closing.
+ */
+declare function TaskContent({
+  children,
+  className,
+  ...props
+}: TaskContentProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/assistant/context.d.ts
+/**
+ * Context value for the assistant provider
+ */
+type AssistantContextValue = UseAssistantReturn & {
+  /** The configuration passed to the provider */config: AssistantConfig; /** Callback to execute an action directly */
+  onAction?: (action: {
+    name: string;
+    options?: Record<string, unknown>;
+  }) => void;
+};
+interface AssistantProviderProps extends AssistantConfig {
+  children: ReactNode;
+  /** Function to get fresh context for each request */
+  getContext?: () => Record<string, unknown>;
+  /** Called when the assistant invokes an action */
+  onAction?: (action: {
+    name: string;
+    options?: Record<string, unknown>;
+  }) => void;
+  /** Called when an error occurs */
+  onError?: (error: Error) => void;
+}
+/**
+ * Provider component for assistant context
+ *
+ * Wraps your application (or a portion of it) to provide assistant
+ * functionality through context. Use `useAssistantContext` to access
+ * the assistant state and methods.
+ *
+ * @example Basic usage
+ * ```tsx
+ * function App() {
+ *   const [todos, setTodos] = useState([])
+ *
+ *   return (
+ *     <AssistantProvider
+ *       endUserId="user-123"
+ *       availableActions={myActions}
+ *       getContext={() => ({ todos })}
+ *       onAction={(action) => handleAction(action)}
+ *     >
+ *       <TodoList />
+ *       <AssistantPanel />
+ *     </AssistantProvider>
+ *   )
+ * }
+ *
+ * function AssistantPanel() {
+ *   const { messages, sendMessage, isReady } = useAssistantContext()
+ *
+ *   if (!isReady) return <div>Connecting...</div>
+ *
+ *   return (
+ *     <div>
+ *       {messages.map(msg => <Message key={msg.id} {...msg} />)}
+ *       <PromptInput onSubmit={sendMessage} />
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+declare function AssistantProvider({
+  children,
+  tokenEndpoint,
+  apiUrl,
+  endUserId,
+  availableActions,
+  getContext,
+  onAction,
+  onError
+}: AssistantProviderProps): react_jsx_runtime0.JSX.Element;
+/**
+ * Hook to access the assistant context
+ *
+ * Must be used within an AssistantProvider.
+ *
+ * @example
+ * ```tsx
+ * function ChatPanel() {
+ *   const {
+ *     messages,
+ *     sendMessage,
+ *     status,
+ *     isReady,
+ *     input,
+ *     setInput,
+ *     handleSubmit,
+ *   } = useAssistantContext()
+ *
+ *   if (!isReady) return <div>Loading...</div>
+ *
+ *   return (
+ *     <div>
+ *       {messages.map(msg => <Message key={msg.id} {...msg} />)}
+ *       <form onSubmit={handleSubmit}>
+ *         <input value={input} onChange={e => setInput(e.target.value)} />
+ *         <button type="submit">Send</button>
+ *       </form>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+declare function useAssistantContext(): AssistantContextValue;
+//#endregion
+//#region src/assistant/hooks/use-assistant.d.ts
+/**
+ * Main hook for integrating the AI assistant into your application
+ *
+ * Combines token management, chat functionality, and tool execution
+ * into a single, easy-to-use hook.
+ *
+ * @example Basic usage
+ * ```tsx
+ * function MyApp() {
+ *   const [todos, setTodos] = useState([])
+ *
+ *   const assistant = useAssistant({
+ *     endUserId: "user-123",
+ *     availableActions: [
+ *       { name: "addTodo", description: "Add a new todo" },
+ *       { name: "deleteTodo", description: "Delete a todo", approvalRequired: true },
+ *     ],
+ *     getContext: () => ({ todos }),
+ *     onAction: (action) => {
+ *       if (action.name === "addTodo") {
+ *         setTodos(prev => [...prev, { text: action.options.text }])
+ *       }
+ *     },
+ *   })
+ *
+ *   if (!assistant.isReady) {
+ *     return <div>Connecting...</div>
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       {assistant.messages.map(msg => (
+ *         <Message key={msg.id} {...msg} />
+ *       ))}
+ *       <PromptInput onSubmit={({ text }) => assistant.sendMessage({ text })} />
+ *     </div>
+ *   )
+ * }
+ * ```
+ *
+ * @example With custom token endpoint and API URL
+ * ```tsx
+ * const assistant = useAssistant({
+ *   tokenEndpoint: "/api/custom/token",
+ *   apiUrl: "https://custom-api.example.com",
+ *   endUserId: "user-123",
+ *   availableActions: myActions,
+ * })
+ * ```
+ */
+declare function useAssistant({
+  tokenEndpoint,
+  apiUrl,
+  endUserId,
+  availableActions,
+  getContext,
+  onAction,
+  onError
+}: UseAssistantOptions): UseAssistantReturn;
+//#endregion
+//#region src/assistant/hooks/use-dynamic-ui.d.ts
+interface UseDynamicUIOptions {
+  /** Storage key for localStorage persistence */
+  storageKey: string;
+}
+/**
+ * Hook for managing DynamicUI state with localStorage persistence
+ *
+ * Provides methods to add, remove, and update buttons and groups
+ * in a tree structure that persists across page reloads.
+ *
+ * @example
+ * ```tsx
+ * const dynamicUI = useDynamicUI({
+ *   storageKey: `mwai-dynamic-ui-${endUserId}`,
+ * })
+ *
+ * // Add a button
+ * dynamicUI.addButton({
+ *   id: "quick-add",
+ *   label: "Quick Add Todo",
+ *   actions: [{ name: "addTodo", options: { text: "New todo" } }],
+ * })
+ * ```
+ */
+declare function useDynamicUI({
+  storageKey
+}: UseDynamicUIOptions): UseDynamicUIReturn;
+//#endregion
+//#region src/assistant/hooks/use-dynamic-ui-tool-execution.d.ts
+interface UseDynamicUIToolExecutionOptions {
+  /** The messages array from useChat */
+  messages: UIMessage[];
+  /** The dynamicUI instance from useDynamicUI */
+  dynamicUI: UseDynamicUIReturn;
+}
+/**
+ * Hook for processing manageDynamicUI tool invocations from assistant messages
+ *
+ * Monitors the messages array for completed tool-manageDynamicUI invocations
+ * and applies the operations to the DynamicUI state.
+ *
+ * @example
+ * ```tsx
+ * function MyAssistant() {
+ *   const { messages } = useChat(...)
+ *   const dynamicUI = useDynamicUI({ storageKey: "my-app" })
+ *
+ *   useDynamicUIToolExecution({
+ *     messages,
+ *     dynamicUI,
+ *   })
+ *
+ *   return <DynamicUI tree={dynamicUI.tree} />
+ * }
+ * ```
+ */
+declare function useDynamicUIToolExecution({
+  messages,
+  dynamicUI
+}: UseDynamicUIToolExecutionOptions): void;
+//#endregion
+//#region src/assistant/hooks/use-token.d.ts
+/**
+ * Hook for managing assistant authentication tokens
+ *
+ * Handles token fetching, caching, and automatic refresh before expiration.
+ * Use this hook when you need direct control over token management,
+ * or use `useAssistant` which wraps this hook with chat functionality.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { token, isLoading, error, fetchToken } = useAssistantToken({
+ *     tokenEndpoint: "/api/mwai/token",
+ *     endUserId: "user-123",
+ *     availableActions: [
+ *       { name: "addTodo", description: "Add a new todo" },
+ *     ],
+ *     autoFetch: true,       // Fetch on mount (default)
+ *     refreshBuffer: 30000,  // Refresh 30s before expiry (default)
+ *   })
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *   if (error) return <div>Error: {error}</div>
+ *   if (!token) return <div>No token</div>
+ *
+ *   return <div>Token ready!</div>
+ * }
+ * ```
+ */
+declare function useAssistantToken({
+  tokenEndpoint,
+  endUserId,
+  availableActions,
+  autoFetch,
+  refreshBuffer
+}: UseAssistantTokenOptions): UseAssistantTokenReturn;
+//#endregion
+//#region src/assistant/hooks/use-tool-execution.d.ts
+interface UseToolExecutionOptions {
+  /** The messages array from useChat */
+  messages: UIMessage[];
+  /** Callback when an action should be executed */
+  onAction?: (action: ToolAction) => void;
+}
+/**
+ * Hook for processing tool invocations from assistant messages
+ *
+ * Monitors the messages array for completed tool-performActions invocations
+ * and calls onAction for each action that should be executed.
+ * Tracks processed tool calls to avoid duplicate executions.
+ *
+ * @example
+ * ```tsx
+ * function MyAssistant() {
+ *   const { messages } = useChat(...)
+ *
+ *   useToolExecution({
+ *     messages,
+ *     onAction: (action) => {
+ *       switch (action.name) {
+ *         case "addTodo":
+ *           addTodo(action.options.text)
+ *           break
+ *         case "deleteTodo":
+ *           deleteTodo(action.options.id)
+ *           break
+ *       }
+ *     },
+ *   })
+ *
+ *   return <ChatUI />
+ * }
+ * ```
+ */
+declare function useToolExecution({
+  messages,
+  onAction
+}: UseToolExecutionOptions): void;
+//#endregion
+//#region src/assistant/shadow/assistant-root.d.ts
+interface AssistantRootProps extends HTMLAttributes<HTMLDivElement> {
+  children: ReactNode;
+  /** Override theme. If undefined, inherits from host app's .dark class on documentElement */
+  theme?: "light" | "dark";
+}
+/**
+ * Shadow DOM wrapper for assistant components
+ *
+ * Provides complete CSS isolation:
+ * - Package styles don't leak into host app
+ * - Host app styles don't affect assistant components
+ * - No need for users to configure Tailwind to scan the package
+ *
+ * @example
+ * ```tsx
+ * <AssistantRoot className="h-full">
+ *   <Conversation>
+ *     <ConversationContent>
+ *       {messages.map((msg) => (
+ *         <Message key={msg.id} from={msg.role}>
+ *           <MessageContent>
+ *             <MessageResponse>{msg.content}</MessageResponse>
+ *           </MessageContent>
+ *         </Message>
+ *       ))}
+ *     </ConversationContent>
+ *   </Conversation>
+ *   <PromptInput onSubmit={handleSubmit}>
+ *     <PromptInputTextarea />
+ *     <PromptInputFooter>
+ *       <div />
+ *       <PromptInputSubmit status={status} />
+ *     </PromptInputFooter>
+ *   </PromptInput>
+ * </AssistantRoot>
+ * ```
+ */
+declare function AssistantRoot({
+  children,
+  className,
+  theme,
+  ...props
+}: AssistantRootProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/assistant/utils/cn.d.ts
+/**
+ * Utility function for merging Tailwind CSS classes with clsx
+ *
+ * Combines clsx for conditional class names with tailwind-merge
+ * to properly handle Tailwind CSS class conflicts.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * cn("px-2 py-1", "px-4") // => "py-1 px-4"
+ *
+ * // With conditionals
+ * cn("base-class", isActive && "active-class", className)
+ *
+ * // With objects
+ * cn("base", { "text-red-500": hasError, "text-green-500": isSuccess })
+ * ```
+ */
+declare function cn(...inputs: ClassValue[]): string;
+//#endregion
+export { MessageContentProps as $, PromptInputFooterProps as A, ConfirmationActions as At, DrawerContentProps as B, AssistantMessages as Bt, TaskProps as C, ConversationScrollButton as Ct, PromptInputButton as D, ConfirmationAcceptedProps as Dt, PromptInput as E, ConfirmationAccepted as Et, PromptInputTextarea as F, ConfirmationRequest as Ft, DrawerPortal as G, DrawerFooter as H, PromptInputTextareaProps as I, ConfirmationRequestProps as It, Collapsible as J, DrawerTitle as K, Drawer$1 as L, ConfirmationTitle as Lt, PromptInputProps as M, ConfirmationProps as Mt, PromptInputSubmit as N, ConfirmationRejected as Nt, PromptInputButtonProps as O, ConfirmationAction as Ot, PromptInputSubmitProps as P, ConfirmationRejectedProps as Pt, MessageContent as Q, DrawerClose as R, ConfirmationTitleProps as Rt, TaskItemProps as S, ConversationProps as St, TaskTriggerProps as T, Confirmation as Tt, DrawerHeader as U, DrawerDescription as V, AssistantMessagesProps as Vt, DrawerOverlay as W, CollapsibleTrigger as X, CollapsibleContent as Y, Message as Z, TaskContent as _, Conversation as _t, useToolExecution as a, DateFieldRenderer as at, TaskItemFile as b, ConversationEmptyState as bt, useDynamicUIToolExecution as c, TextFieldRenderer as ct, useAssistant as d, DynamicButtonRenderer as dt, MessageProps as et, AssistantContextValue as f, dynamicUIRegistry as ft, Task as g, DynamicActionModalProps as gt, useAssistantContext as h, DynamicActionModal as ht, UseToolExecutionOptions as i, AssistantFormRendererProps as it, PromptInputMessage as j, ConfirmationActionsProps as jt, PromptInputFooter as k, ConfirmationActionProps as kt, UseDynamicUIOptions as l, defaultFormRegistry as lt, AssistantProviderProps as m, DynamicUIProps as mt, AssistantRoot as n, MessageResponseProps as nt, useAssistantToken as o, FormRenderer as ot, AssistantProvider as p, DynamicUI as pt, DrawerTrigger as q, AssistantRootProps as r, AssistantFormRenderer as rt, UseDynamicUIToolExecutionOptions as s, TextAreaRenderer as st, cn as t, MessageResponse as tt, useDynamicUI as u, DynamicButtonGroupRenderer as ut, TaskContentProps as v, ConversationContent as vt, TaskTrigger as w, ConversationScrollButtonProps as wt, TaskItemFileProps as x, ConversationEmptyStateProps as xt, TaskItem as y, ConversationContentProps as yt, DrawerContent as z, ToolUIPartApproval as zt };