@contractspec/module.ai-chat 4.0.3 → 4.1.0

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

@@ -4,8 +4,10 @@ export interface ChatContainerProps {
     className?: string;
     /** Show scroll-to-bottom button when scrolled up */
     showScrollButton?: boolean;
+    /** Optional header content (e.g. export toolbar) */
+    headerContent?: React.ReactNode;
 }
 /**
  * Container component for chat messages with scrolling
  */
-export declare function ChatContainer({ children, className, showScrollButton, }: ChatContainerProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChatContainer({ children, className, showScrollButton, headerContent, }: ChatContainerProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,25 @@
+import type { ChatMessage, ChatConversation } from '../../core/message-types';
+export type ExportFormat = 'markdown' | 'txt' | 'json';
+export interface ChatExportToolbarProps {
+    messages: ChatMessage[];
+    conversation?: ChatConversation | null;
+    selectedIds: Set<string>;
+    /** Called after export (for feedback/analytics) */
+    onExported?: (format: ExportFormat, count: number) => void;
+    /** Optional: show selection summary (e.g. "3 selected") */
+    showSelectionSummary?: boolean;
+    /** Optional: select all / clear selection buttons */
+    onSelectAll?: () => void;
+    onClearSelection?: () => void;
+    selectedCount?: number;
+    totalCount?: number;
+    /** New conversation callback */
+    onCreateNew?: () => void;
+    /** Fork conversation callback (optional messageId to fork from) */
+    onFork?: (upToMessageId?: string) => Promise<string | null>;
+}
+/**
+ * Toolbar for exporting chat conversations to Markdown, TXT, or JSON.
+ * Exports selected messages when any are selected; otherwise exports all.
+ */
+export declare function ChatExportToolbar({ messages, conversation, selectedIds, onExported, showSelectionSummary, onSelectAll, onClearSelection, selectedCount, totalCount, onCreateNew, onFork, }: ChatExportToolbarProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { ChatMessage as ChatMessageType } from '../../core/message-types';
 export interface ChatMessageProps {
     message: ChatMessageType;
@@ -6,8 +7,22 @@ export interface ChatMessageProps {
     showCopy?: boolean;
     /** Show avatar */
     showAvatar?: boolean;
+    /** Enable selection checkbox */
+    selectable?: boolean;
+    /** Whether this message is selected */
+    selected?: boolean;
+    /** Called when selection is toggled */
+    onSelect?: (id: string) => void;
+    /** Enable edit (user messages only) */
+    editable?: boolean;
+    /** Called when message is edited */
+    onEdit?: (messageId: string, newContent: string) => void | Promise<void>;
+    /** Host-provided renderer for tool results with presentationKey */
+    presentationRenderer?: (key: string, data?: unknown) => React.ReactNode;
+    /** Host-provided renderer for tool results with formKey */
+    formRenderer?: (key: string, defaultValues?: Record<string, unknown>) => React.ReactNode;
 }
 /**
  * Chat message component
  */
-export declare function ChatMessage({ message, className, showCopy, showAvatar, }: ChatMessageProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChatMessage({ message, className, showCopy, showAvatar, selectable, selected, onSelect, editable, onEdit, presentationRenderer, formRenderer, }: ChatMessageProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,26 @@
+import type { ChatConversation } from '../../core/message-types';
+import type { ConversationStore } from '../../core/conversation-store';
+export interface ChatSidebarProps {
+    store: ConversationStore;
+    selectedConversationId: string | null;
+    onSelectConversation: (id: string | null) => void;
+    onCreateNew: () => void;
+    projectId?: string;
+    tags?: string[];
+    limit?: number;
+    className?: string;
+    /** Collapsible on mobile */
+    collapsed?: boolean;
+    /** Optional: update conversation (for project/tags edit) */
+    onUpdateConversation?: (id: string, updates: {
+        projectId?: string;
+        projectName?: string;
+        tags?: string[];
+    }) => Promise<void>;
+    /** Selected conversation for meta display */
+    selectedConversation?: ChatConversation | null;
+}
+/**
+ * Sidebar listing conversations with new/delete actions
+ */
+export declare function ChatSidebar({ store, selectedConversationId, onSelectConversation, onCreateNew, projectId, tags, limit, className, collapsed, onUpdateConversation, selectedConversation, }: ChatSidebarProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,34 @@
+import * as React from 'react';
+import type { ChatMessage as ChatMessageType, ChatConversation } from '../../core/message-types';
+import type { ThinkingLevel } from '../../core/thinking-levels';
+export interface ChatWithExportProps {
+    messages: ChatMessageType[];
+    conversation?: ChatConversation | null;
+    children?: React.ReactNode;
+    className?: string;
+    /** Show export toolbar */
+    showExport?: boolean;
+    /** Show message selection checkboxes */
+    showMessageSelection?: boolean;
+    /** Show scroll-to-bottom button */
+    showScrollButton?: boolean;
+    /** New conversation callback */
+    onCreateNew?: () => void;
+    /** Fork conversation callback */
+    onFork?: (upToMessageId?: string) => Promise<string | null>;
+    /** Edit message callback */
+    onEditMessage?: (messageId: string, newContent: string) => Promise<void>;
+    /** Thinking level (instant, thinking, extra_thinking, max) */
+    thinkingLevel?: ThinkingLevel;
+    /** Called when thinking level changes */
+    onThinkingLevelChange?: (level: ThinkingLevel) => void;
+    /** Host-provided renderer for tool results with presentationKey */
+    presentationRenderer?: (key: string, data?: unknown) => React.ReactNode;
+    /** Host-provided renderer for tool results with formKey */
+    formRenderer?: (key: string, defaultValues?: Record<string, unknown>) => React.ReactNode;
+}
+/**
+ * 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;

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

@@ -0,0 +1,19 @@
+import * as React from 'react';
+import { type ConversationStore } from '../../core/conversation-store';
+import type { UseChatOptions } from '../hooks/useChat';
+export interface ChatWithSidebarProps extends Omit<UseChatOptions, 'store' | 'conversationId'> {
+    /** Optional store (defaults to LocalStorage) */
+    store?: ConversationStore;
+    projectId?: string;
+    tags?: string[];
+    className?: string;
+    /** Host-provided renderer for tool results with presentationKey */
+    presentationRenderer?: (key: string, data?: unknown) => React.ReactNode;
+    /** Host-provided renderer for tool results with formKey */
+    formRenderer?: (key: string, defaultValues?: Record<string, unknown>) => React.ReactNode;
+}
+/**
+ * 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;

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

@@ -0,0 +1,16 @@
+import { type ThinkingLevel } from '../../core/thinking-levels';
+export interface ThinkingLevelPickerProps {
+    /** Currently selected level */
+    value: ThinkingLevel;
+    /** Called when selection changes */
+    onChange: (value: ThinkingLevel) => void;
+    /** Additional class name */
+    className?: string;
+    /** Compact mode (smaller) */
+    compact?: boolean;
+}
+/**
+ * Picker for thinking level: instant, thinking, extra thinking, max.
+ * Maps to provider-specific reasoning options (Anthropic budgetTokens, OpenAI reasoningEffort).
+ */
+export declare function ThinkingLevelPicker({ value, onChange, className, compact, }: ThinkingLevelPickerProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,33 @@
+import * as React from 'react';
+/** Tool result shape for presentation rendering */
+export interface PresentationToolResult {
+    presentationKey: string;
+    data?: unknown;
+}
+/** Tool result shape for form rendering */
+export interface FormToolResult {
+    formKey: string;
+    defaultValues?: Record<string, 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;
+export interface ToolResultRendererProps {
+    /** Tool name */
+    toolName: string;
+    /** Tool result from AI */
+    result: unknown;
+    /** Host-provided presentation renderer */
+    presentationRenderer?: (key: string, data?: unknown) => React.ReactNode;
+    /** Host-provided form renderer */
+    formRenderer?: (key: string, defaultValues?: Record<string, unknown>) => React.ReactNode;
+    /** Fallback: render raw JSON when no custom renderer */
+    showRawFallback?: boolean;
+}
+/**
+ * Renders tool results with optional host-driven presentation or form components.
+ * When result has presentationKey/formKey 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;

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

@@ -4,6 +4,12 @@
 export { ChatContainer } from './ChatContainer';
 export { ChatMessage } from './ChatMessage';
 export { ChatInput } from './ChatInput';
+export { ChatExportToolbar } from './ChatExportToolbar';
+export { ChatWithExport } from './ChatWithExport';
+export { ChatSidebar } from './ChatSidebar';
+export { ChatWithSidebar } from './ChatWithSidebar';
 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';