@cadraos/sdk 0.1.11-test → 0.1.12

package/dist/chat/index.d.ts

@@ -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
  */
@@ -176,14 +212,6 @@ interface ExecutionStreamEvent {
         [key: string]: unknown;
     };
 }
-/**
- * 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";
 /**
  * Theme mode options
  */
@@ -212,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;
@@ -235,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
@@ -253,7 +332,7 @@ interface ChatMessageProps {
  * />
  * ```
  */
-declare function ChatMessage({ message, enableMarkdown, showToolCalls, toolCallVerbosity, 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 */
@@ -297,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.
@@ -319,7 +414,7 @@ interface MessageListProps {
  * />
  * ```
  */
-declare function MessageList({ messages, welcomeMessage, renderWelcome, isLoading, isStreaming, isLoadingHistory, enableMarkdown, showToolCalls, toolCallVerbosity, 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
@@ -1234,12 +1329,18 @@ 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 */
@@ -1268,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
@@ -1290,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, toolCallVerbosity, 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
@@ -2938,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
@@ -2961,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 */
@@ -3188,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
@@ -3206,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 */
@@ -3294,6 +3454,84 @@ interface ToolCallEntryProps {
  */
 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 */
     question: string;
@@ -3412,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, INTERNAL_TOOL_NAMES, 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 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 };
+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 };