@cadraos/sdk 0.1.10 → 0.1.12

package/dist/chat/index.d.cts

@@ -3,28 +3,6 @@ import { Components } from 'react-markdown';
 import * as React$1 from 'react';
 import React__default from 'react';
 
-interface MarkdownContentProps {
-    /** Markdown content to render */
-    content: string;
-    /** Additional CSS classes */
-    className?: string;
-    /** Custom React-Markdown component overrides (merged with defaults, user wins) */
-    components?: Partial<Components>;
-    /** Custom URL transform for React-Markdown (e.g., to preserve custom protocols like artifact:) */
-    urlTransform?: (url: string) => string;
-    /** Transform content string before rendering (e.g., strip certain patterns) */
-    contentTransform?: (content: string) => string;
-}
-/**
- * Renders markdown content with chat-appropriate styling
- *
- * @example
- * ```tsx
- * <MarkdownContent content="# Hello\n\nThis is **bold** text." />
- * ```
- */
-declare function MarkdownContent({ content, className, components: customComponents, urlTransform, contentTransform, }: MarkdownContentProps): react_jsx_runtime.JSX.Element;
-
 /**
  * Type definitions for @cadraos/sdk/chat
  *
@@ -49,7 +27,11 @@ interface ChatMessage$1 {
     /** Tool calls made during this message */
     toolCalls?: ToolCall[];
     /** Thinking blocks (for models that support extended thinking) */
-    thinkingBlocks?: ThinkingBlock[];
+    thinkingBlocks?: ThinkingBlock$1[];
+    /** Images extracted from tool results (convenience projection, derived from toolCalls) */
+    images?: ImageData[];
+    /** Delegation events for team execution (orchestrator → specialist handoffs) */
+    delegationEvents?: DelegationEvent[];
 }
 /**
  * Attachment data for files sent with messages
@@ -94,7 +76,7 @@ interface ToolCall {
 /**
  * Thinking block for extended thinking models
  */
-interface ThinkingBlock {
+interface ThinkingBlock$1 {
     /** Unique identifier */
     id: string;
     /** Thinking content */
@@ -102,6 +84,52 @@ interface ThinkingBlock {
     /** When the thinking block was created */
     timestamp: Date;
 }
+/**
+ * Image data extracted from tool results.
+ * Always derived from toolCalls[] (single source of truth).
+ */
+interface ImageData {
+    /** Image URL */
+    url: string;
+    /** Alt text for accessibility */
+    alt?: string;
+    /** Original filename */
+    filename?: string;
+    /** Image width in pixels */
+    width?: number;
+    /** Image height in pixels */
+    height?: number;
+    /** ID of the tool call that produced this image */
+    sourceToolCallId?: string;
+}
+/**
+ * Delegation event for team execution (orchestrator → specialist handoffs).
+ * Uses wire types: delegation_started / delegation_completed.
+ */
+interface DelegationEvent {
+    /** Event type matching the wire protocol */
+    type: "delegation_started" | "delegation_completed";
+    /** Unique handoff ID linking start/complete pairs */
+    handoffId?: string;
+    /** Orchestrator agent name */
+    fromAgent?: string;
+    /** Target specialist agent name */
+    toAgent?: string;
+    /** Target agent UUID (raw from wire event) */
+    targetAgentUuid?: string;
+    /** Sub-execution ID */
+    executionId?: string;
+    /** Preview of the delegated task (from delegation_started) */
+    taskPreview?: string;
+    /** Preview of the result (from delegation_completed) */
+    resultPreview?: string;
+    /** When the event occurred */
+    timestamp: Date;
+    /** Current status */
+    status?: "active" | "completed" | "failed";
+    /** Duration in milliseconds (from delegation_completed) */
+    durationMs?: number;
+}
 /**
  * Chat error information
  */
@@ -137,6 +165,14 @@ interface TodoItem {
     /** Present continuous form for active display */
     activeForm: string;
 }
+/**
+ * Tool call verbosity levels for controlling which tool calls are displayed
+ *
+ * - `"compact"` (default) — Hide internal/orchestration tools, show user-facing tools in compact style
+ * - `"verbose"` — Show all tools including internal ones (useful for debugging)
+ * - `"hidden"` — Hide all tool calls entirely
+ */
+type ToolCallVerbosity = "compact" | "verbose" | "hidden";
 /**
  * SSE stream event from agent execution
  */
@@ -204,6 +240,43 @@ interface AttachmentFile {
     actualSize?: number;
 }
 
+interface MarkdownContentProps {
+    /** Markdown content to render */
+    content: string;
+    /** Additional CSS classes */
+    className?: string;
+    /** Custom React-Markdown component overrides (merged with defaults, user wins) */
+    components?: Partial<Components>;
+    /** Custom URL transform for React-Markdown (e.g., to preserve custom protocols like artifact:) */
+    urlTransform?: (url: string) => string;
+    /** Transform content string before rendering (e.g., strip certain patterns) */
+    contentTransform?: (content: string) => string;
+}
+/**
+ * Renders markdown content with chat-appropriate styling
+ *
+ * @example
+ * ```tsx
+ * <MarkdownContent content="# Hello\n\nThis is **bold** text." />
+ * ```
+ */
+declare function MarkdownContent({ content, className, components: customComponents, urlTransform, contentTransform, }: MarkdownContentProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * CSS custom properties supported by ChatMessage for theming:
+ *
+ * --chat-user-bg: User message bubble background (default: #3b82f6)
+ * --chat-user-text: User message text color (default: white)
+ * --chat-user-avatar-bg: User avatar background (default: #3b82f6)
+ * --chat-user-avatar-text: User avatar text color (default: white)
+ * --chat-assistant-bg: Assistant message bubble background (default: #f3f4f6)
+ * --chat-assistant-text: Assistant message text color (default: #111827)
+ * --chat-assistant-avatar-bg: Assistant avatar background (default: #e5e7eb)
+ * --chat-assistant-avatar-text: Assistant avatar text color (default: #4b5563)
+ * --chat-meta-text: Timestamp and metadata text color (default: #6b7280)
+ *
+ * Set these on a parent element (e.g., .cadra-chat-container) to theme the chat.
+ */
 interface ChatMessageProps {
     /** Message data */
     message: ChatMessage$1;
@@ -211,6 +284,8 @@ interface ChatMessageProps {
     enableMarkdown?: boolean;
     /** Whether to show tool calls */
     showToolCalls?: boolean;
+    /** Tool call verbosity level (overrides showToolCalls when set) */
+    toolCallVerbosity?: ToolCallVerbosity;
     /** Additional CSS classes */
     className?: string;
     /** Custom markdown component overrides */
@@ -225,6 +300,20 @@ interface ChatMessageProps {
         alt?: string;
         filename?: string;
     }) => void;
+    /** Show thinking blocks (default true) */
+    showThinking?: boolean;
+    /** Show delegation progress (default true) */
+    showDelegation?: boolean;
+    /** Show images from tool results (default true) */
+    showImages?: boolean;
+    /** Custom tool call rendering override */
+    renderToolCall?: (toolCall: ToolCall, defaultRender: () => React.ReactNode) => React.ReactNode;
+    /**
+     * Visual variant for the message layout.
+     * - "bubble" (default): Chat bubble style with colored backgrounds and right-aligned user messages.
+     * - "flat": Full-width flat layout (like Claude AI). Both roles left-aligned, no bubble backgrounds.
+     */
+    variant?: "bubble" | "flat";
 }
 /**
  * Renders a single chat message with appropriate styling
@@ -243,7 +332,7 @@ interface ChatMessageProps {
  * />
  * ```
  */
-declare function ChatMessage({ message, enableMarkdown, showToolCalls, className, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, }: ChatMessageProps): react_jsx_runtime.JSX.Element;
+declare function ChatMessage({ message, enableMarkdown, showToolCalls, toolCallVerbosity: _toolCallVerbosity, className, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, showThinking, showDelegation, showImages, renderToolCall, variant, }: ChatMessageProps): react_jsx_runtime.JSX.Element;
 
 interface MessageListProps {
     /** Array of messages to display */
@@ -271,6 +360,8 @@ interface MessageListProps {
     enableMarkdown?: boolean;
     /** Whether to show tool calls */
     showToolCalls?: boolean;
+    /** Tool call verbosity level */
+    toolCallVerbosity?: ToolCallVerbosity;
     /** Additional CSS classes */
     className?: string;
     /** Custom markdown component overrides */
@@ -285,6 +376,22 @@ interface MessageListProps {
         alt?: string;
         filename?: string;
     }) => void;
+    /** Show thinking blocks (default true) */
+    showThinking?: boolean;
+    /** Show delegation progress (default true) */
+    showDelegation?: boolean;
+    /** Show images from tool results (default true) */
+    showImages?: boolean;
+    /** Custom message rendering override */
+    renderMessage?: (message: ChatMessage$1, defaultRender: () => React.ReactNode) => React.ReactNode;
+    /** Custom tool call rendering override */
+    renderToolCall?: (toolCall: ToolCall, defaultRender: () => React.ReactNode) => React.ReactNode;
+    /**
+     * Visual variant for message rendering.
+     * - "bubble" (default): Chat bubble style with colored backgrounds.
+     * - "flat": Full-width flat layout (like Claude AI).
+     */
+    messageVariant?: "bubble" | "flat";
     /**
      * Send message function passed from parent (AgentChat).
      * Used to forward to renderWelcome render function for suggestion chips.
@@ -307,7 +414,7 @@ interface MessageListProps {
  * />
  * ```
  */
-declare function MessageList({ messages, welcomeMessage, renderWelcome, isLoading, isStreaming, isLoadingHistory, enableMarkdown, showToolCalls, className, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, sendMessage, }: MessageListProps): react_jsx_runtime.JSX.Element;
+declare function MessageList({ messages, welcomeMessage, renderWelcome, isLoading, isStreaming, isLoadingHistory, enableMarkdown, showToolCalls, toolCallVerbosity, className, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, showThinking, showDelegation, showImages, renderMessage, renderToolCall, messageVariant, sendMessage, }: MessageListProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Common types shared across all resources
@@ -1222,18 +1329,34 @@ interface AgentChatProps {
     renderWelcome?: React.ReactNode | ((props: {
         sendMessage: (text: string) => void;
     }) => React.ReactNode);
-    /** Maximum height of the chat container */
+    /** Maximum height of the chat container (only used in "fixed" layout) */
     maxHeight?: string | number;
     /** Additional CSS class for the container */
     className?: string;
     /** Theme mode */
     theme?: ThemeMode;
+    /**
+     * Layout mode for the chat container.
+     * - "fixed" (default): Widget-style with maxHeight constraint.
+     * - "fill": Fills parent flex container. Use for full-page layouts.
+     */
+    layout?: "fixed" | "fill";
     /** Enable file attachments */
     enableAttachments?: boolean;
     /** Enable markdown rendering */
     enableMarkdown?: boolean;
     /** Show tool call visualization */
     showToolCalls?: boolean;
+    /**
+     * Tool call verbosity level
+     *
+     * - `"compact"` (default) — Hide internal tools, show user-facing tools in compact style when completed
+     * - `"verbose"` — Show all tools including internal ones (debugging)
+     * - `"hidden"` — Hide all tool calls
+     *
+     * When `showToolCalls={false}`, this is automatically set to `"hidden"`.
+     */
+    toolCallVerbosity?: ToolCallVerbosity;
     /** Custom markdown component overrides (e.g., for artifact rendering) */
     markdownComponents?: MessageListProps["markdownComponents"];
     /** Custom URL transform for markdown (e.g., to preserve artifact: protocol) */
@@ -1246,6 +1369,40 @@ interface AgentChatProps {
         alt?: string;
         filename?: string;
     }) => void;
+    /** Hide the default chat header when true */
+    hideHeader?: boolean;
+    /** Render slot above the chat input (e.g., config pills, action buttons) */
+    renderAboveInput?: () => React.ReactNode;
+    /** Render slot below the message list (e.g., image carousel) */
+    renderBelowMessages?: () => React.ReactNode;
+    /**
+     * Custom message rendering override.
+     * Receives the message and a defaultRender function for selective override.
+     */
+    renderMessage?: (message: ChatMessage$1, defaultRender: () => React.ReactNode) => React.ReactNode;
+    /**
+     * Custom tool call rendering override.
+     * Receives the tool call and a defaultRender function for selective override.
+     */
+    renderToolCall?: (toolCall: ToolCall, defaultRender: () => React.ReactNode) => React.ReactNode;
+    /**
+     * Visual variant for message rendering.
+     * - "bubble" (default): Chat bubble style with colored backgrounds.
+     * - "flat": Full-width flat layout (like Claude AI).
+     */
+    messageVariant?: "bubble" | "flat";
+    /** Show thinking blocks (default true) */
+    showThinking?: boolean;
+    /** Show delegation progress (default true) */
+    showDelegation?: boolean;
+    /** Show images from tool results (default true) */
+    showImages?: boolean;
+    /** Polling interval in ms (default 2000) */
+    pollingInterval?: number;
+    /** Enable polling fallback (default true) */
+    pollingEnabled?: boolean;
+    /** Callback fired when a delegation event occurs */
+    onDelegation?: (event: DelegationEvent) => void;
 }
 /**
  * Complete chat interface for interacting with AI agents
@@ -1268,7 +1425,7 @@ interface AgentChatProps {
  * />
  * ```
  */
-declare function AgentChat({ agentId, teamId, sessionId, adapter, onMessage, onError, onSessionCreated, onSessionStart, onToolCall, onToolResult, onClarification, initialMessages, placeholder, welcomeMessage, renderWelcome, maxHeight, className, theme, enableAttachments, enableMarkdown, showToolCalls, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, }: AgentChatProps): react_jsx_runtime.JSX.Element;
+declare function AgentChat({ agentId, teamId, sessionId, adapter, onMessage, onError, onSessionCreated, onSessionStart, onToolCall, onToolResult, onClarification, initialMessages, placeholder, welcomeMessage, renderWelcome, maxHeight, className, theme, layout, enableAttachments, enableMarkdown, showToolCalls, toolCallVerbosity, markdownComponents, markdownUrlTransform, markdownContentTransform, onImageClick, hideHeader, renderAboveInput, renderBelowMessages, renderMessage, renderToolCall, messageVariant, showThinking, showDelegation, showImages, pollingInterval, pollingEnabled, onDelegation, }: AgentChatProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Retry utility with exponential backoff
@@ -2622,17 +2779,17 @@ declare class SessionsAPI extends BaseResourceAPI {
 }
 
 /**
- * AI SaaS Client
+ * Cadra Client
  *
  * Main entry point for the SDK. Provides access to all resource APIs.
  *
  * @example
  * ```typescript
- * import { AISaaSClient } from '@cadraos/sdk';
+ * import { CadraClient } from '@cadraos/sdk';
  *
- * const client = new AISaaSClient({
- *   apiKey: process.env.AISAAS_API_KEY,
- *   orgId: Number(process.env.AISAAS_ORG_ID),
+ * const client = new CadraClient({
+ *   apiKey: process.env.CADRA_API_KEY,
+ *   orgId: Number(process.env.CADRA_ORG_ID),
  * });
  *
  * // List agents
@@ -2658,12 +2815,12 @@ declare class SessionsAPI extends BaseResourceAPI {
 /**
  * Client options for API key authentication
  */
-interface AISaaSClientOptionsApiKey {
+interface CadraClientOptionsApiKey {
     /** API key for authentication */
     apiKey: string;
     /** Organization ID */
     orgId: number;
-    /** Base URL for API (default: https://api.aisaas.com/v1) */
+    /** Base URL for API (default: https://api.cadraos.com) */
     baseUrl?: string;
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
@@ -2675,12 +2832,12 @@ interface AISaaSClientOptionsApiKey {
 /**
  * Client options for OAuth token authentication
  */
-interface AISaaSClientOptionsToken {
+interface CadraClientOptionsToken {
     /** OAuth token for authentication */
     token: string;
     /** Organization ID */
     orgId: number;
-    /** Base URL for API (default: https://api.aisaas.com/v1) */
+    /** Base URL for API (default: https://api.cadraos.com) */
     baseUrl?: string;
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
@@ -2692,12 +2849,12 @@ interface AISaaSClientOptionsToken {
 /**
  * Client options for token provider authentication
  */
-interface AISaaSClientOptionsTokenProvider {
+interface CadraClientOptionsTokenProvider {
     /** Token provider callback (called before each request) */
     tokenProvider: () => Promise<string>;
     /** Organization ID */
     orgId: number;
-    /** Base URL for API (default: https://api.aisaas.com/v1) */
+    /** Base URL for API (default: https://api.cadraos.com) */
     baseUrl?: string;
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
@@ -2709,14 +2866,14 @@ interface AISaaSClientOptionsTokenProvider {
 /**
  * All client options
  */
-type AISaaSClientOptions = AISaaSClientOptionsApiKey | AISaaSClientOptionsToken | AISaaSClientOptionsTokenProvider;
+type CadraClientOptions = CadraClientOptionsApiKey | CadraClientOptionsToken | CadraClientOptionsTokenProvider;
 /**
  * AI SaaS Client
  *
  * Main class for interacting with the AI SaaS API.
  * Provides access to all resource APIs (agents, skills, tools, artifacts, sessions).
  */
-declare class AISaaSClient {
+declare class CadraClient {
     private readonly httpClient;
     private readonly config;
     /**
@@ -2747,25 +2904,25 @@ declare class AISaaSClient {
      * @example
      * ```typescript
      * // API key authentication
-     * const client = new AISaaSClient({
+     * const client = new CadraClient({
      *   apiKey: 'sk_...',
      *   orgId: 123,
      * });
      *
      * // OAuth token authentication
-     * const client = new AISaaSClient({
+     * const client = new CadraClient({
      *   token: 'eyJ...',
      *   orgId: 123,
      * });
      *
      * // Token provider (for automatic refresh)
-     * const client = new AISaaSClient({
+     * const client = new CadraClient({
      *   tokenProvider: async () => myAuth.getAccessToken(),
      *   orgId: 123,
      * });
      * ```
      */
-    constructor(options: AISaaSClientOptions);
+    constructor(options: CadraClientOptions);
     /**
      * Validate client options
      */
@@ -2788,7 +2945,7 @@ interface DefaultAdapterConfig {
     /**
      * Pre-constructed CadraClient (takes priority over individual options)
      */
-    client?: AISaaSClient;
+    client?: CadraClient;
     /**
      * Base URL for the API
      * @example "https://api.example.com/v1"
@@ -2916,6 +3073,20 @@ interface UseAgentChatOptions {
     onToolResult?: (toolName: string, result: unknown, durationMs?: number) => void;
     /** Callback fired when clarification is needed */
     onClarification?: (data: ClarificationData) => void;
+    /** Callback fired when a delegation event occurs (team execution) */
+    onDelegation?: (event: DelegationEvent) => void;
+    /**
+     * Polling interval in milliseconds for the polling fallback.
+     * Used when SSE connection fails and falls back to polling.
+     * Default: 2000ms
+     */
+    pollingInterval?: number;
+    /**
+     * Whether polling fallback is enabled.
+     * When false, SSE failure will result in an error instead of falling back to polling.
+     * Default: true
+     */
+    pollingEnabled?: boolean;
 }
 /**
  * Options for sendMessage
@@ -2939,6 +3110,8 @@ interface UseAgentChatResult {
     sessionId: string | null;
     /** Current clarification request if any */
     clarification: ClarificationData | null;
+    /** Currently active delegation event (team execution) */
+    activeDelegation: DelegationEvent | null;
     /** Send a message to the agent */
     sendMessage: (content: string, options?: SendMessageOptions) => Promise<void>;
     /** Respond to a clarification request */
@@ -3166,12 +3339,21 @@ declare function useFileAttachments(options: UseFileAttachmentsOptions): UseFile
 interface ChatContainerProps {
     /** Child components (MessageList, ChatInput, etc.) */
     children: React$1.ReactNode;
-    /** Maximum height of the container */
+    /**
+     * Maximum height of the container (only used in "fixed" layout).
+     * Ignored when layout is "fill".
+     */
     maxHeight?: string | number;
     /** Additional CSS classes */
     className?: string;
     /** Theme mode */
     theme?: ThemeMode;
+    /**
+     * Layout mode for the container.
+     * - "fixed" (default): Uses maxHeight for a widget-style bounded container.
+     * - "fill": Uses flex-1/min-h-0 to fill parent container. Ideal for full-page layouts.
+     */
+    layout?: "fixed" | "fill";
 }
 /**
  * Container component for the chat interface
@@ -3184,7 +3366,7 @@ interface ChatContainerProps {
  * </ChatContainer>
  * ```
  */
-declare function ChatContainer({ children, maxHeight, className, theme, }: ChatContainerProps): react_jsx_runtime.JSX.Element;
+declare function ChatContainer({ children, maxHeight, className, theme, layout, }: ChatContainerProps): react_jsx_runtime.JSX.Element;
 
 interface ChatInputProps {
     /** Callback when user sends a message */
@@ -3226,6 +3408,17 @@ interface ChatInputProps {
  */
 declare function ChatInput({ onSend, onStop, placeholder, disabled, isLoading, enableAttachments, attachments, onRemoveAttachment, dropZoneRef, isUploadingAttachments, className, }: ChatInputProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Tool name patterns for internal/orchestration tools that should be hidden
+ * in compact verbosity mode. These are matched after stripping common prefixes
+ * (e.g., `team_api_handoff_to_agent` → `handoff_to_agent`).
+ */
+declare const INTERNAL_TOOL_NAMES: Set<string>;
+/**
+ * Check if a tool name is an internal/orchestration tool.
+ * Strips common prefixes before matching (e.g., `team_api_handoff_to_agent` → matches `handoff_to_agent`).
+ */
+declare function isInternalTool(toolName: string): boolean;
 interface ToolCallEntryProps {
     /** Tool call data */
     toolCall: ToolCall;
@@ -3239,6 +3432,8 @@ interface ToolCallEntryProps {
         alt?: string;
         filename?: string;
     }) => void;
+    /** Render in compact single-line style (for completed tools in compact verbosity) */
+    compact?: boolean;
 }
 /**
  * Displays a single tool call with status and expandable details
@@ -3257,7 +3452,85 @@ interface ToolCallEntryProps {
  * />
  * ```
  */
-declare function ToolCallEntry({ toolCall, className, showFullJson, onImageClick, }: ToolCallEntryProps): react_jsx_runtime.JSX.Element;
+declare function ToolCallEntry({ toolCall, className, showFullJson, onImageClick, compact, }: ToolCallEntryProps): react_jsx_runtime.JSX.Element;
+
+interface ThinkingBlockProps {
+    /** Thinking block data */
+    block: ThinkingBlock$1;
+    /** Whether the block starts expanded */
+    defaultExpanded?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+interface ThinkingBlockListProps {
+    /** Array of thinking blocks to display */
+    blocks: ThinkingBlock$1[];
+    /** Whether blocks start expanded */
+    defaultExpanded?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Renders a single collapsible thinking/reasoning block
+ */
+declare function ThinkingBlock({ block, defaultExpanded, className, }: ThinkingBlockProps): react_jsx_runtime.JSX.Element;
+/**
+ * Renders a list of thinking blocks
+ */
+declare function ThinkingBlockList({ blocks, defaultExpanded, className, }: ThinkingBlockListProps): react_jsx_runtime.JSX.Element | null;
+
+interface DelegationProgressProps {
+    /** Delegation event data */
+    event: DelegationEvent;
+    /** Additional CSS classes */
+    className?: string;
+}
+interface DelegationProgressListProps {
+    /** Array of delegation events to display */
+    events: DelegationEvent[];
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Renders a single delegation progress indicator
+ */
+declare function DelegationProgress({ event, className, }: DelegationProgressProps): react_jsx_runtime.JSX.Element;
+/**
+ * Renders a list of delegation progress indicators
+ */
+declare function DelegationProgressList({ events, className, }: DelegationProgressListProps): react_jsx_runtime.JSX.Element | null;
+
+interface ImageGalleryProps {
+    /** Array of images to display */
+    images: ImageData[];
+    /** Callback when an image is clicked. Overrides default lightbox behavior. */
+    onImageClick?: (image: ImageData) => void;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Renders images in a responsive grid with optional lightbox
+ */
+declare function ImageGallery({ images, onImageClick, className, }: ImageGalleryProps): react_jsx_runtime.JSX.Element | null;
+
+interface ImageLightboxProps {
+    /** Array of images */
+    images: ImageData[];
+    /** Current image index */
+    currentIndex: number;
+    /** Close the lightbox */
+    onClose: () => void;
+    /** Navigate to previous image */
+    onPrev: () => void;
+    /** Navigate to next image */
+    onNext: () => void;
+    /** Additional CSS classes for the overlay */
+    className?: string;
+}
+/**
+ * Fullscreen image viewer with prev/next navigation
+ */
+declare function ImageLightbox({ images, currentIndex, onClose, onPrev, onNext, className, }: ImageLightboxProps): react_jsx_runtime.JSX.Element | null;
 
 interface AskUserPromptProps {
     /** The question to display to the user */
@@ -3377,4 +3650,4 @@ declare function ClockIcon({ className, ...props }: IconProps): react_jsx_runtim
  */
 declare function compressImage(file: File, targetSizeKB?: number): Promise<File>;
 
-export { AgentChat, type AgentChatProps, AlertCircleIcon, type Artifact$1 as Artifact, AskUserPrompt, type AskUserPromptProps, type AttachmentData, type AttachmentFile, BotIcon, type ChatAdapter, ChatConfigProvider, type ChatConfigProviderProps, ChatContainer, type ChatContainerProps, type ChatError, ChatInput, type ChatInputProps, ChatMessage, type ChatMessageProps, type ChatMessage$1 as ChatMessageType, CheckCircleIcon, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, CircleIcon, type ClarificationData, ClockIcon, CodeIcon, CopyIcon, DatabaseIcon, type DefaultAdapterConfig, DownloadIcon, type Execution, type ExecutionResult, type ExecutionStreamEvent, ExternalLinkIcon, FileDropZone, type FileDropZoneProps, type FileDropZoneRef, FileIcon, FileTextIcon, HelpCircleIcon, type HistoryMessage, type IconProps, ImageIcon, ImagesIcon, type ListSessionsInput, ListTodoIcon, LoadingSpinner, MarkdownContent, type MarkdownContentProps, Maximize2Icon, MessageCircleIcon, MessageList, type MessageListProps, Minimize2Icon, PaperclipIcon, SendIcon, type SendMessageInput$1 as SendMessageInput, type SendMessageOptions, type SessionHistory$1 as SessionHistory, type SessionList, type SessionListItem, SparklesIcon, type StartExecutionInput, StopCircleIcon, type ThemeMode, type ThinkingBlock, type TodoItem, TodoList, type TodoListProps, type ToolCall, ToolCallEntry, type ToolCallEntryProps, type UploadUrlInput, type UploadUrlResult, type UseAgentChatOptions, type UseAgentChatResult, type UseExecutionStreamOptions, type UseExecutionStreamResult, type UseFileAttachmentsOptions, type UseFileAttachmentsResult, UserIcon, XIcon, ZoomInIcon, ZoomOutIcon, compressImage, createDefaultAdapter, useAgentChat, useChatConfig, useChatConfigOptional, useExecutionStream, useFileAttachments };
+export { AgentChat, type AgentChatProps, AlertCircleIcon, type Artifact$1 as Artifact, AskUserPrompt, type AskUserPromptProps, type AttachmentData, type AttachmentFile, BotIcon, type ChatAdapter, ChatConfigProvider, type ChatConfigProviderProps, ChatContainer, type ChatContainerProps, type ChatError, ChatInput, type ChatInputProps, ChatMessage, type ChatMessageProps, type ChatMessage$1 as ChatMessageType, CheckCircleIcon, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, CircleIcon, type ClarificationData, ClockIcon, CodeIcon, CopyIcon, DatabaseIcon, type DefaultAdapterConfig, type DelegationEvent, DelegationProgress, DelegationProgressList, type DelegationProgressListProps, type DelegationProgressProps, DownloadIcon, type Execution, type ExecutionResult, type ExecutionStreamEvent, ExternalLinkIcon, FileDropZone, type FileDropZoneProps, type FileDropZoneRef, FileIcon, FileTextIcon, HelpCircleIcon, type HistoryMessage, INTERNAL_TOOL_NAMES, type IconProps, type ImageData, ImageGallery, type ImageGalleryProps, ImageIcon, ImageLightbox, type ImageLightboxProps, ImagesIcon, type ListSessionsInput, ListTodoIcon, LoadingSpinner, MarkdownContent, type MarkdownContentProps, Maximize2Icon, MessageCircleIcon, MessageList, type MessageListProps, Minimize2Icon, PaperclipIcon, SendIcon, type SendMessageInput$1 as SendMessageInput, type SendMessageOptions, type SessionHistory$1 as SessionHistory, type SessionList, type SessionListItem, SparklesIcon, type StartExecutionInput, StopCircleIcon, type ThemeMode, ThinkingBlock, ThinkingBlockList, type ThinkingBlockListProps, type ThinkingBlockProps, type ThinkingBlock$1 as ThinkingBlockType, type TodoItem, TodoList, type TodoListProps, type ToolCall, ToolCallEntry, type ToolCallEntryProps, type ToolCallVerbosity, type UploadUrlInput, type UploadUrlResult, type UseAgentChatOptions, type UseAgentChatResult, type UseExecutionStreamOptions, type UseExecutionStreamResult, type UseFileAttachmentsOptions, type UseFileAttachmentsResult, UserIcon, XIcon, ZoomInIcon, ZoomOutIcon, compressImage, createDefaultAdapter, isInternalTool, useAgentChat, useChatConfig, useChatConfigOptional, useExecutionStream, useFileAttachments };