@contractspec/module.ai-chat 4.1.5 → 4.2.0

package/dist/presentation/components/ChainOfThought.d.ts

@@ -0,0 +1,30 @@
+import * as React from 'react';
+import { type LucideIcon } from 'lucide-react';
+export type ChainOfThoughtStepStatus = 'complete' | 'active' | 'pending';
+export interface ChainOfThoughtProps {
+    children: React.ReactNode;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    className?: string;
+}
+export declare function ChainOfThought({ children, open, defaultOpen, onOpenChange, className, }: ChainOfThoughtProps): import("react/jsx-runtime").JSX.Element;
+export interface ChainOfThoughtHeaderProps {
+    children?: React.ReactNode;
+    className?: string;
+}
+export declare function ChainOfThoughtHeader({ children, className, }: ChainOfThoughtHeaderProps): import("react/jsx-runtime").JSX.Element;
+export interface ChainOfThoughtStepProps {
+    label: string;
+    description?: string;
+    status?: ChainOfThoughtStepStatus;
+    icon?: LucideIcon;
+    children?: React.ReactNode;
+    className?: string;
+}
+export declare function ChainOfThoughtStep({ label, description, status, icon: Icon, children, className, }: ChainOfThoughtStepProps): import("react/jsx-runtime").JSX.Element;
+export interface ChainOfThoughtContentProps {
+    children: React.ReactNode;
+    className?: string;
+}
+export declare function ChainOfThoughtContent({ children, className, }: ChainOfThoughtContentProps): import("react/jsx-runtime").JSX.Element;

package/dist/presentation/components/ChatInput.d.ts

@@ -14,8 +14,7 @@ export interface ChatInputProps {
     showAttachments?: boolean;
     /** Max attachments allowed */
     maxAttachments?: number;
+    /** Max file size in bytes (default 5MB). Files exceeding this are rejected. */
+    maxFileSizeBytes?: number;
 }
-/**
- * Chat input component with attachment support
- */
-export declare function ChatInput({ onSend, disabled, isLoading, placeholder, className, showAttachments, maxAttachments, }: ChatInputProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChatInput({ onSend, disabled, isLoading, placeholder, className, showAttachments, maxAttachments, maxFileSizeBytes, }: ChatInputProps): import("react/jsx-runtime").JSX.Element;

package/dist/presentation/components/ChatMessage.d.ts

@@ -1,5 +1,6 @@
 import * as React from 'react';
 import type { ChatMessage as ChatMessageType } from '../../core/message-types';
+import type { ChatMessageComponents } from './component-types';
 export interface ChatMessageProps {
     message: ChatMessageType;
     className?: string;
@@ -21,8 +22,9 @@ export interface ChatMessageProps {
     presentationRenderer?: (key: string, data?: unknown) => React.ReactNode;
     /** Host-provided renderer for tool results with formKey */
     formRenderer?: (key: string, defaultValues?: Record<string, unknown>) => React.ReactNode;
+    /** Host-provided renderer for tool results with dataViewKey */
+    dataViewRenderer?: (key: string, items?: unknown[]) => React.ReactNode;
+    /** Override components (e.g. from ai-elements) for Reasoning, Sources, ChainOfThought */
+    components?: ChatMessageComponents;
 }
-/**
- * Chat message component
- */
-export declare function ChatMessage({ message, className, showCopy, showAvatar, selectable, selected, onSelect, editable, onEdit, presentationRenderer, formRenderer, }: ChatMessageProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChatMessage({ message, className, showCopy, showAvatar, selectable, selected, onSelect, editable, onEdit, presentationRenderer, formRenderer, dataViewRenderer, components: comps, }: ChatMessageProps): import("react/jsx-runtime").JSX.Element;

package/dist/presentation/components/ChatWithExport.d.ts

@@ -1,6 +1,7 @@
 import * as React from 'react';
 import type { ChatMessage as ChatMessageType, ChatConversation } from '../../core/message-types';
 import type { ThinkingLevel } from '../../core/thinking-levels';
+import type { ChatMessageComponents, SuggestionComponents } from './component-types';
 export interface ChatWithExportProps {
     messages: ChatMessageType[];
     conversation?: ChatConversation | null;
@@ -26,9 +27,21 @@ export interface ChatWithExportProps {
     presentationRenderer?: (key: string, data?: unknown) => React.ReactNode;
     /** Host-provided renderer for tool results with formKey */
     formRenderer?: (key: string, defaultValues?: Record<string, unknown>) => React.ReactNode;
+    /** Host-provided renderer for tool results with dataViewKey */
+    dataViewRenderer?: (key: string, items?: unknown[]) => React.ReactNode;
+    /** Override components for ChatMessage (Reasoning, Sources, ChainOfThought) */
+    components?: ChatMessageComponents;
+    /** Clickable suggestion chips (e.g. empty state) */
+    suggestions?: string[];
+    /** Called when a suggestion is clicked */
+    onSuggestionClick?: (suggestion: string) => void;
+    /** Override Suggestion components */
+    suggestionComponents?: SuggestionComponents;
+    /** Show suggestions when no messages (default true when suggestions provided) */
+    showSuggestionsWhenEmpty?: boolean;
 }
 /**
  * Chat container with export and message selection.
  * Composes ChatContainer, ChatExportToolbar, and useMessageSelection.
  */
-export declare function ChatWithExport({ messages, conversation, children, className, showExport, showMessageSelection, showScrollButton, onCreateNew, onFork, onEditMessage, thinkingLevel, onThinkingLevelChange, presentationRenderer, formRenderer, }: ChatWithExportProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChatWithExport({ messages, conversation, children, className, showExport, showMessageSelection, showScrollButton, onCreateNew, onFork, onEditMessage, thinkingLevel, onThinkingLevelChange, presentationRenderer, formRenderer, dataViewRenderer, components, suggestions, onSuggestionClick, suggestionComponents: suggestionComps, showSuggestionsWhenEmpty, }: ChatWithExportProps): import("react/jsx-runtime").JSX.Element;

package/dist/presentation/components/ChatWithSidebar.d.ts

@@ -1,6 +1,7 @@
 import * as React from 'react';
 import { type ConversationStore } from '../../core/conversation-store';
 import type { UseChatOptions } from '../hooks/useChat';
+import type { ChatMessageComponents, SuggestionComponents } from './component-types';
 export interface ChatWithSidebarProps extends Omit<UseChatOptions, 'store' | 'conversationId'> {
     /** Optional store (defaults to LocalStorage) */
     store?: ConversationStore;
@@ -11,9 +12,19 @@ export interface ChatWithSidebarProps extends Omit<UseChatOptions, 'store' | 'co
     presentationRenderer?: (key: string, data?: unknown) => React.ReactNode;
     /** Host-provided renderer for tool results with formKey */
     formRenderer?: (key: string, defaultValues?: Record<string, unknown>) => React.ReactNode;
+    /** Host-provided renderer for tool results with dataViewKey */
+    dataViewRenderer?: (key: string, items?: unknown[]) => React.ReactNode;
+    /** Override components for ChatMessage */
+    components?: ChatMessageComponents;
+    /** Clickable suggestion chips */
+    suggestions?: string[];
+    /** Override Suggestion components */
+    suggestionComponents?: SuggestionComponents;
+    /** Show suggestions when chat has messages (default false) */
+    showSuggestionsWhenEmpty?: boolean;
 }
 /**
  * Full chat layout with sidebar (conversation history) and main chat area.
  * Uses a shared store for persistence.
  */
-export declare function ChatWithSidebar({ store, projectId, tags, className, thinkingLevel: initialThinkingLevel, presentationRenderer, formRenderer, ...useChatOptions }: ChatWithSidebarProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChatWithSidebar({ store, projectId, tags, className, thinkingLevel: initialThinkingLevel, presentationRenderer, formRenderer, dataViewRenderer, components, suggestions, suggestionComponents, showSuggestionsWhenEmpty, ...useChatOptions }: ChatWithSidebarProps): import("react/jsx-runtime").JSX.Element;

package/dist/presentation/components/Reasoning.d.ts

@@ -0,0 +1,24 @@
+import * as React from 'react';
+export interface ReasoningProps {
+    isStreaming?: boolean;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    children: React.ReactNode;
+    className?: string;
+}
+/**
+ * Collapsible reasoning display. Auto-opens during streaming, closes when done.
+ */
+export declare function Reasoning({ isStreaming, open, defaultOpen, onOpenChange, children, className, }: ReasoningProps): import("react/jsx-runtime").JSX.Element;
+export interface ReasoningTriggerProps {
+    children?: React.ReactNode;
+    isStreaming?: boolean;
+    className?: string;
+}
+export declare function ReasoningTrigger({ children, isStreaming, className, }: ReasoningTriggerProps): import("react/jsx-runtime").JSX.Element;
+export interface ReasoningContentProps {
+    children: React.ReactNode;
+    className?: string;
+}
+export declare function ReasoningContent({ children, className, }: ReasoningContentProps): import("react/jsx-runtime").JSX.Element;

package/dist/presentation/components/Sources.d.ts

@@ -0,0 +1,22 @@
+import * as React from 'react';
+export interface SourcesProps {
+    children: React.ReactNode;
+    className?: string;
+}
+export declare function Sources({ children, className }: SourcesProps): import("react/jsx-runtime").JSX.Element;
+export interface SourcesTriggerProps {
+    count: number;
+    children?: React.ReactNode;
+    className?: string;
+}
+export declare function SourcesTrigger({ count, children, className, }: SourcesTriggerProps): import("react/jsx-runtime").JSX.Element;
+export interface SourcesContentProps {
+    children: React.ReactNode;
+    className?: string;
+}
+export declare function SourcesContent({ children, className }: SourcesContentProps): import("react/jsx-runtime").JSX.Element;
+export interface SourceProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
+    href: string;
+    title?: string;
+}
+export declare function Source({ href, title, className, children, ...props }: SourceProps): import("react/jsx-runtime").JSX.Element;

package/dist/presentation/components/Suggestion.d.ts

@@ -0,0 +1,12 @@
+import * as React from 'react';
+export interface SuggestionsProps {
+    children: React.ReactNode;
+    className?: string;
+}
+export declare function Suggestions({ children, className }: SuggestionsProps): import("react/jsx-runtime").JSX.Element;
+export interface SuggestionProps {
+    suggestion: string;
+    onClick?: (suggestion: string) => void;
+    className?: string;
+}
+export declare function Suggestion({ suggestion, onClick, className, }: SuggestionProps): import("react/jsx-runtime").JSX.Element;

package/dist/presentation/components/ToolResultRenderer.d.ts

@@ -1,4 +1,10 @@
 import * as React from 'react';
+/** UIMessage-like shape (subagent output with parts) */
+export interface UIMessageLike {
+    parts?: unknown[];
+}
+/** Type guard for UIMessage-like (nested subagent output) */
+export declare function isUIMessageLike(result: unknown): result is UIMessageLike;
 /** Tool result shape for presentation rendering */
 export interface PresentationToolResult {
     presentationKey: string;
@@ -9,10 +15,17 @@ export interface FormToolResult {
     formKey: string;
     defaultValues?: Record<string, unknown>;
 }
+/** Tool result shape for data view rendering */
+export interface DataViewToolResult {
+    dataViewKey: string;
+    items?: unknown[];
+}
 /** Type guard for presentation tool result */
 export declare function isPresentationToolResult(result: unknown): result is PresentationToolResult;
 /** Type guard for form tool result */
 export declare function isFormToolResult(result: unknown): result is FormToolResult;
+/** Type guard for data view tool result */
+export declare function isDataViewToolResult(result: unknown): result is DataViewToolResult;
 export interface ToolResultRendererProps {
     /** Tool name */
     toolName: string;
@@ -22,12 +35,16 @@ export interface ToolResultRendererProps {
     presentationRenderer?: (key: string, data?: unknown) => React.ReactNode;
     /** Host-provided form renderer */
     formRenderer?: (key: string, defaultValues?: Record<string, unknown>) => React.ReactNode;
+    /** Host-provided data view renderer */
+    dataViewRenderer?: (key: string, items?: unknown[]) => React.ReactNode;
     /** Fallback: render raw JSON when no custom renderer */
     showRawFallback?: boolean;
+    /** Render nested UIMessage (subagent output) recursively */
+    renderNestedUIMessage?: boolean;
 }
 /**
- * Renders tool results with optional host-driven presentation or form components.
- * When result has presentationKey/formKey and host provides a renderer, uses it.
+ * Renders tool results with optional host-driven presentation, form, or data view components.
+ * When result has presentationKey/formKey/dataViewKey and host provides a renderer, uses it.
  * Otherwise falls back to raw JSON display.
  */
-export declare function ToolResultRenderer({ toolName, result, presentationRenderer, formRenderer, showRawFallback, }: ToolResultRendererProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ToolResultRenderer({ toolName: _toolName, result, presentationRenderer, formRenderer, dataViewRenderer, showRawFallback, renderNestedUIMessage, }: ToolResultRendererProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/presentation/components/component-types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Component override types for AI Elements-style UX.
+ * Hosts with ai-elements can pass enhanced components; otherwise native implementations are used.
+ */
+import type * as React from 'react';
+export interface ReasoningComponentProps {
+    isStreaming?: boolean;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    children: React.ReactNode;
+}
+export interface ChatMessageComponents {
+    Reasoning?: React.ComponentType<ReasoningComponentProps>;
+    ReasoningTrigger?: React.ComponentType<{
+        children?: React.ReactNode;
+    }>;
+    ReasoningContent?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    Sources?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    SourcesTrigger?: React.ComponentType<{
+        count: number;
+    }>;
+    Source?: React.ComponentType<{
+        href: string;
+        title?: string;
+    } & React.AnchorHTMLAttributes<HTMLAnchorElement>>;
+    ChainOfThought?: React.ComponentType<{
+        children: React.ReactNode;
+        open?: boolean;
+        defaultOpen?: boolean;
+        className?: string;
+    }>;
+    ChainOfThoughtStep?: React.ComponentType<{
+        label: string;
+        description?: string;
+        status?: 'complete' | 'active' | 'pending';
+        children?: React.ReactNode;
+    }>;
+}
+export interface SuggestionComponents {
+    Suggestions?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    Suggestion?: React.ComponentType<{
+        suggestion: string;
+        onClick?: (suggestion: string) => void;
+    }>;
+}

package/dist/presentation/components/index.d.ts

@@ -12,4 +12,9 @@ export { ModelPicker } from './ModelPicker';
 export { ThinkingLevelPicker } from './ThinkingLevelPicker';
 export { ContextIndicator } from './ContextIndicator';
 export { CodePreview } from './CodePreview';
-export { ToolResultRenderer, isPresentationToolResult, isFormToolResult, type PresentationToolResult, type FormToolResult, } from './ToolResultRenderer';
+export { Reasoning, ReasoningTrigger, ReasoningContent } from './Reasoning';
+export { Sources, SourcesTrigger, SourcesContent, Source } from './Sources';
+export { Suggestions, Suggestion } from './Suggestion';
+export { ChainOfThought, ChainOfThoughtHeader, ChainOfThoughtStep, ChainOfThoughtContent, } from './ChainOfThought';
+export type { ChatMessageComponents, SuggestionComponents, } from './component-types';
+export { ToolResultRenderer, isPresentationToolResult, isFormToolResult, isDataViewToolResult, type PresentationToolResult, type FormToolResult, type DataViewToolResult, } from './ToolResultRenderer';