@contentgrowth/llm-service 0.8.2 → 0.8.4

package/dist/ui/react/components/index.d.ts

@@ -0,0 +1,291 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React, { RefObject, ReactNode } from 'react';
+
+interface ChatBubbleProps {
+    onClick: () => void;
+}
+declare function ChatBubble({ onClick }: ChatBubbleProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Types for interactive messages in the chat system
+ */
+type InteractiveFunction = 'chat' | 'confirm' | 'select' | 'form' | 'present';
+interface InteractiveMessage {
+    interactive: boolean;
+    function: InteractiveFunction;
+    parameters: Record<string, any>;
+}
+interface ChatInteractionParams {
+    prompt: string;
+    placeholder?: string;
+}
+interface ConfirmInteractionParams {
+    message: string;
+    yesPrompt: string;
+    noPrompt: string;
+}
+interface SelectInteractionParams {
+    question: string;
+    options: string[];
+    placeholder?: string;
+}
+interface FormField {
+    name: string;
+    label: string;
+    type: 'string' | 'number' | 'email' | 'textarea' | 'select' | 'checkbox' | 'radio' | 'password';
+    required?: boolean;
+    options?: string[];
+    placeholder?: string;
+    defaultValue?: any;
+}
+interface FormInteractionParams {
+    title: string;
+    label?: string;
+    description?: string;
+    fields: FormField[];
+    submitText?: string;
+    cancelText?: string;
+}
+interface PresentInteractionParams {
+    title?: string;
+    content: string;
+    level?: string;
+    format?: 'text' | 'markdown' | 'html';
+}
+
+/**
+ * Types related to chat functionality
+ */
+
+/**
+ * ChatMessage represents a single message in the chat history
+ */
+interface ChatMessage {
+    role: 'user' | 'assistant' | 'system' | 'error';
+    content: string;
+    id: string | number;
+    timestamp?: number;
+    interactive?: boolean;
+    request?: string;
+    interactiveData?: InteractiveMessage;
+    isResponseSubmitted?: boolean;
+    responseValue?: any;
+    rawContent?: string;
+    diff?: {
+        oldContent: string;
+        newContent: string;
+    };
+    actionResult?: {
+        type: 'link';
+        url: string;
+        label: string;
+        target?: string;
+    };
+}
+/**
+ * ChatTask represents a multi-step task being performed by the chat assistant
+ */
+interface ChatTask {
+    complete: boolean;
+    steps: number;
+    currentStep: number;
+}
+/**
+ * Possible connection status values for the SSE connection
+ */
+type ConnectionState = 'connected' | 'disconnected' | 'reconnecting';
+/**
+ * Animation states for the chat UI
+ */
+type AnimationState = 'closed' | 'opening' | 'open' | 'closing';
+/**
+ * Custom EventSource interface that matches what chatApi.createChatStream returns
+ */
+interface CustomEventSource {
+    close: () => void;
+}
+/**
+ * Result type returned by the connectToSSE function
+ * Contains the connectionId that can be used immediately without waiting for state updates
+ */
+interface SSEConnectionResult {
+    connectionId: string | null;
+}
+/**
+ * Options for configuring the message submit handler
+ */
+interface MessageSubmitOptions {
+    contextType: 'schedule' | 'tasks' | 'general';
+    enableNavigation?: boolean;
+    processNavigationIntent?: (text: string) => boolean;
+    handlePageSpecificCommand?: (text: string) => boolean;
+}
+/**
+ * Options for configuring the navigation handler
+ */
+interface NavigationHandlerOptions {
+    onSwitchContext?: (contextType: 'schedule' | 'tasks' | 'general') => void;
+    onNavigationStart?: (action: string) => void;
+    onNavigationComplete?: () => void;
+}
+/**
+ * Options for configuring the chat trigger handler
+ */
+interface ChatTriggerOptions {
+    contextType: 'schedule' | 'tasks' | 'general';
+    enabled?: boolean;
+}
+/**
+ * Configuration for voice input functionality
+ */
+interface VoiceConfig {
+    mode: 'native' | 'custom';
+    onAudioCapture?: (blob: Blob) => Promise<string>;
+    onVoiceStart?: () => void;
+    onVoiceEnd?: () => void;
+    language?: string;
+}
+
+interface MessageBubbleProps {
+    message: ChatMessage;
+    isUser: boolean;
+    userAvatarUrl?: string;
+    onViewChanges?: (diff: {
+        oldContent: string;
+        newContent: string;
+    }) => void;
+}
+declare const MessageBubble: React.FC<MessageBubbleProps>;
+
+interface ChatHeaderProps {
+    contextTitle: string;
+    currentTask: ChatTask | null;
+    onClose: () => void;
+}
+declare function ChatHeader({ contextTitle, currentTask, onClose }: ChatHeaderProps): react_jsx_runtime.JSX.Element;
+
+interface ChatInputAreaProps {
+    onSubmit: (message: string) => void;
+    isSending: boolean;
+    showInputForm: boolean;
+    currentTask: ChatTask | null;
+    lastInteractiveMessage?: ChatMessage | null;
+    voiceConfig?: VoiceConfig;
+    onStop?: () => void;
+    hintText?: string;
+    placeholder?: string;
+    value?: string;
+    onChange?: (e: React.ChangeEvent<HTMLTextAreaElement>) => void;
+}
+interface ChatInputAreaHandle {
+    focus: () => void;
+    setValue: (value: string) => void;
+}
+declare const ChatInputArea: React.ForwardRefExoticComponent<ChatInputAreaProps & React.RefAttributes<ChatInputAreaHandle>>;
+
+interface ChatMessageListProps {
+    chatHistory: ChatMessage[];
+    isProcessing: boolean;
+    processingHint: string;
+    currentTask: ChatTask | null;
+    getContextExample: () => string;
+    onInteractiveResponse?: (messageId: string | number, response: any) => void;
+}
+/**
+ * ChatMessageList component displays the chat messages and handles scrolling
+ * Features:
+ * - Displays user and system messages with different styling
+ * - Shows a typing indicator when the system is processing
+ * - Displays a welcome message when the chat is empty
+ * - Auto-scrolls to the bottom when new messages arrive
+ * - Handles interactive messages with different UI components
+ */
+declare const ChatMessageList: React.FC<ChatMessageListProps>;
+
+interface ConnectionStatusProps {
+    connectionStatus: 'connected' | 'disconnected' | 'reconnecting';
+    onReconnect: () => void;
+}
+declare const ConnectionStatus: React.FC<ConnectionStatusProps>;
+
+interface SpinnerProps {
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+    className?: string;
+    color?: string;
+}
+declare const Spinner: React.FC<SpinnerProps>;
+
+/**
+ * A hook that proactively resizes a textarea based on the content of a hidden measurement element.
+ * This avoids the flickering often seen with standard "height: auto" approaches by measuring
+ * the content in a hidden span first, then applying the height to the textarea.
+ */
+declare function useProactiveResize(textareaRef: RefObject<HTMLTextAreaElement>, measurementRef: RefObject<HTMLSpanElement>, value: string, disabled: boolean): void;
+
+interface SpeechRecognitionHook {
+    isListening: boolean;
+    transcript: string;
+    start: () => void;
+    stop: () => void;
+    resetTranscript: () => void;
+    isSupported: boolean;
+    error: string | null;
+}
+declare const useSpeechRecognition: (onResult?: (text: string, isFinal: boolean) => void, onEnd?: () => void, language?: string) => SpeechRecognitionHook;
+
+interface AudioRecorderHook {
+    isRecording: boolean;
+    start: () => Promise<void>;
+    stop: () => void;
+    blob: Blob | null;
+    error: string | null;
+}
+declare const useAudioRecorder: (onStop?: (blob: Blob) => void) => AudioRecorderHook;
+
+interface ChatConfig {
+    user?: {
+        avatarUrl?: string;
+        name?: string;
+    };
+    voice?: {
+        enabled: boolean;
+        config?: VoiceConfig;
+    };
+}
+declare const ChatConfigProvider: React.FC<{
+    config: ChatConfig;
+    children: ReactNode;
+}>;
+declare const useChatConfig: () => ChatConfig;
+
+/**
+ * Lightweight client for sending audio to a backend transcription endpoint.
+ * This keeps the API key secret on the server.
+ */
+interface TranscriptionConfig {
+    endpoint: string;
+    language?: string;
+    headers?: Record<string, string>;
+}
+interface TranscriptionResult {
+    text: string;
+    error?: string;
+}
+/**
+ * Transcribe audio blob by sending it to the configured backend endpoint.
+ */
+declare function transcribeAudio(audioBlob: Blob, config: TranscriptionConfig): Promise<string>;
+
+/**
+ * Helper to create a VoiceConfig that uses the backend Whisper transcription service.
+ *
+ * @param config - Configuration for the transcription endpoint
+ * @param callbacks - Optional callbacks for voice events
+ * @returns VoiceConfig ready to be used in ChatInputArea
+ */
+declare function createWhisperVoiceConfig(config: TranscriptionConfig, callbacks?: {
+    onVoiceStart?: () => void;
+    onVoiceEnd?: () => void;
+}): VoiceConfig;
+
+export { type AnimationState, type AudioRecorderHook, ChatBubble, type ChatConfig, ChatConfigProvider, ChatHeader, ChatInputArea, type ChatInputAreaHandle, type ChatInteractionParams, type ChatMessage, ChatMessageList, type ChatTask, type ChatTriggerOptions, type ConfirmInteractionParams, type ConnectionState, ConnectionStatus, type CustomEventSource, type FormField, type FormInteractionParams, type InteractiveFunction, type InteractiveMessage, MessageBubble, type MessageBubbleProps, type MessageSubmitOptions, type NavigationHandlerOptions, type PresentInteractionParams, type SSEConnectionResult, type SelectInteractionParams, type SpeechRecognitionHook, Spinner, type TranscriptionConfig, type TranscriptionResult, type VoiceConfig, createWhisperVoiceConfig, transcribeAudio, useAudioRecorder, useChatConfig, useProactiveResize, useSpeechRecognition };