@doderasoftware/restify-ai 0.2.0-beta.1 → 0.2.0-beta.3

package/README.md

@@ -15,6 +15,7 @@ A production-ready AI chatbot component for Vue 3 with real-time SSE streaming,
 
 - 🌊 **Real-time SSE Streaming** - Smooth character-by-character response streaming
 - 📎 **File Attachments** - Upload and process documents, images, and more
+- 🎤 **Audio Input** - Voice recording with visual feedback and wave animation
 - 👥 **@Mentions System** - Reference entities from your application (employees, jobs, projects, etc.)
 - 💡 **Context-Aware Suggestions** - Smart prompts based on current page/route
 - 💬 **Chat History** - Persistent conversation memory with configurable limits
@@ -251,10 +252,13 @@ export function setupRestifyAi(app: App) {
     },
 
     // ═══════════════════════════════════════════════════════════════
-    // LIMITS
+    // LIMITS & AI MODEL
     // ═══════════════════════════════════════════════════════════════
     
     chatHistoryLimit: 20,  // Maximum user messages per conversation
+    model: 'gpt-4',        // AI model to use (passed to backend)
+    temperature: 0.7,      // AI temperature (0-1)
+    maxTokens: 2048,       // Maximum tokens per response
     maxAttachments: 5,
     maxFileSize: 10 * 1024 * 1024, // 10MB
     acceptedFileTypes: 'image/*,.pdf,.txt,.doc,.docx,.xls,.xlsx,.csv',
@@ -272,6 +276,11 @@ export function setupRestifyAi(app: App) {
     
     keyboardShortcut: 'mod+g',  // 'mod' = Cmd on Mac, Ctrl on Windows
     enableSupportMode: true,
+    useQuota: true,            // Enable quota management
+    useHeadersRateLimiter: true, // Use rate limit headers instead of quota endpoint
+    useConversationId: true,   // Enable conversation ID tracking
+    useConversationHistory: true, // Enable conversation history sidebar
+    maxConversationHistory: 10,   // Max conversations to store (default: 10)
     canToggle: () => true,
 
     // ═══════════════════════════════════════════════════════════════
@@ -291,6 +300,7 @@ export function setupRestifyAi(app: App) {
     onResponseReceived: (message) => console.log('Response:', message),
     onDrawerToggle: (isOpen) => console.log('Drawer:', isOpen),
     onNewChat: () => console.log('New chat started'),
+    onSetupComplete: () => console.log('Setup completed'),
     
     // Stream lifecycle hooks
     onStreamStart: () => console.log('Stream started'),
@@ -318,7 +328,7 @@ export function setupRestifyAi(app: App) {
 | `topOffset` | `string` | `"0"` | Top offset for fixed headers |
 | `position` | `"left" \| "right"` | `"right"` | Drawer position |
 | `showBackdrop` | `boolean` | `false` | Show backdrop overlay |
-| `closeOnBackdropClick` | `boolean` | `false` | Close when clicking backdrop |
+| `closeOnBackdropClick` | `boolean` | `true` | Close when clicking backdrop |
 | `closeOnEscape` | `boolean` | `true` | Close on Escape key |
 | `showQuota` | `boolean` | `true` | Show quota display (API usage remaining) |
 | `showMessageCount` | `boolean` | `true` | Show message count badge (X/20 format) |
@@ -327,6 +337,9 @@ export function setupRestifyAi(app: App) {
 | `showCloseButton` | `boolean` | `true` | Show close button |
 | `showNewChatButton` | `boolean` | `true` | Show new chat button |
 | `confirmClose` | `boolean` | `true` | Confirm before clearing history |
+| `enableAudioInput` | `boolean` | `false` | Enable voice recording button |
+| `isRecording` | `boolean` | `false` | Audio recording state (controlled) |
+| `inputValue` | `string` | `''` | Input text value (v-model:inputValue) |
 | `autoFetchQuota` | `boolean` | `true` | Auto-fetch quota when opened |
 | `historyLimit` | `HistoryLimitConfig` | - | History limit configuration |
 | `loadingText` | `LoadingTextConfig` | - | Loading text configuration |
@@ -369,14 +382,84 @@ function handleContactSupport() {
 </script>
 ```
 
+### Audio Input Example
+
+Enable voice recording with the `enableAudioInput` prop and handle the recording state:
+
+```vue
+<template>
+  <AiChatDrawer
+    v-model="aiStore.showChat"
+    v-model:input-value="audioInput"
+    :enable-audio-input="true"
+    :is-recording="isRecording"
+    @toggle-audio-recording="toggleRecording"
+  />
+</template>
+
+<script setup lang="ts">
+import { ref } from 'vue'
+import { AiChatDrawer, useRestifyAiStore } from '@doderasoftware/restify-ai'
+
+const aiStore = useRestifyAiStore()
+const isRecording = ref(false)
+const audioInput = ref('')
+let mediaRecorder: MediaRecorder | null = null
+
+async function toggleRecording() {
+  if (isRecording.value) {
+    // Stop recording
+    mediaRecorder?.stop()
+    isRecording.value = false
+  } else {
+    // Start recording
+    try {
+      const stream = await navigator.mediaDevices.getUserMedia({ audio: true })
+      mediaRecorder = new MediaRecorder(stream)
+      
+      const chunks: Blob[] = []
+      mediaRecorder.ondataavailable = (e) => chunks.push(e.data)
+      mediaRecorder.onstop = async () => {
+        const audioBlob = new Blob(chunks, { type: 'audio/webm' })
+        // Process the audio (e.g., send to transcription API)
+        const transcription = await transcribeAudio(audioBlob)
+        audioInput.value = transcription
+        stream.getTracks().forEach(track => track.stop())
+      }
+      
+      mediaRecorder.start()
+      isRecording.value = true
+    } catch (error) {
+      console.error('Failed to start recording:', error)
+    }
+  }
+}
+
+async function transcribeAudio(blob: Blob): Promise<string> {
+  // Implement your transcription logic here
+  // e.g., send to OpenAI Whisper, Google Speech-to-Text, etc.
+  return 'Transcribed text...'
+}
+</script>
+```
+
+**Features:**
+- 🎤 Microphone button appears when `enableAudioInput` is enabled
+- 📊 Animated wave indicator shows when recording is active
+- 🔴 Visual feedback with red styling during recording
+- 🎨 Customizable via `audioButton`, `audioButtonRecording`, and `audioRecordingIndicator` UI classes
+- 🌐 Text labels customizable via `startRecording`, `stopRecording`, and `recording` texts
+
 ## 📡 Events
 
 | Event | Payload | Description |
 |-------|---------|-------------|
 | `update:modelValue` | `boolean` | Drawer state changed |
+| `update:inputValue` | `string` | Input text value changed |
 | `close` | - | Drawer was closed |
 | `contact-support` | - | Support mode activated |
 | `new-chat` | - | New chat started |
+| `toggle-audio-recording` | - | Audio recording toggled |
 
 ## 🎰 Slots
 
@@ -385,7 +468,7 @@ function handleContactSupport() {
 | `header` | `HeaderSlotProps` | Custom header content |
 | `quota` | `{ quota: ChatQuota }` | Custom quota display |
 | `setup` | - | Custom setup guide |
-| `empty-state` | `{ suggestions, onClick }` | Custom empty state |
+| `empty-state` | `EmptyStateSlotProps` | Custom empty state |
 | `message` | `MessageSlotProps` | Custom message bubble |
 | `input` | `InputSlotProps` | Custom input area |
 | `context-link` | - | Custom context link below input |
@@ -403,6 +486,11 @@ interface HeaderSlotProps {
   onToggleFullscreen: () => void
 }
 
+interface EmptyStateSlotProps {
+  suggestions: AISuggestion[]
+  onSuggestionClick: (suggestion: AISuggestion) => void
+}
+
 interface MessageSlotProps {
   message: ChatMessage
   isUser: boolean
@@ -430,15 +518,22 @@ const store = useRestifyAiStore()
 // STATE
 // ═══════════════════════════════════════════════════════════════
 
+store.chatHistoryLimit    // number - Maximum messages allowed
 store.chatHistory         // ChatMessage[] - All messages
+store.uploadedFiles       // Record<string, ChatAttachment> - Uploaded files by ID
 store.showChat            // boolean - Drawer visibility
 store.sending             // boolean - Message being sent
 store.loading             // boolean - Loading state
 store.isFullscreen        // boolean - Fullscreen mode
 store.quota               // { limit, used, remaining }
-store.error               // { message, failedQuestion, failedAttachments, timestamp }
+store.error               // { message, failedQuestion, failedAttachments, timestamp, quotaExceeded }
 store.supportRequestMode  // boolean - Support mode active
 store.pageContext         // PageContext | null - Current page context
+store.setupState          // SetupState - Setup wizard state
+store.conversationId      // string | null - Current conversation ID from backend
+store.conversationName    // string | null - Current conversation name
+store.conversationHistory // ConversationHistoryItem[] - List of saved conversations
+store.showHistorySidebar  // boolean - History sidebar visibility
 
 // ═══════════════════════════════════════════════════════════════
 // GETTERS
@@ -464,7 +559,21 @@ store.toggleSupportMode()       // Toggle support mode
 store.fetchQuota()              // Fetch quota from server
 store.uploadFile(file)          // Upload file
 store.setPageContext(context)   // Set page context
-store.scrollToBottom()          // Scroll chat to bottom
+store.scrollToBottom(delay?)    // Scroll chat to bottom
+
+// Conversation History Actions
+store.toggleHistorySidebar()    // Toggle history sidebar
+store.loadConversation(id)      // Load a saved conversation
+store.renameConversation(id, title) // Rename a conversation
+store.deleteConversation(id)    // Delete a saved conversation
+store.saveCurrentConversation() // Save current conversation
+
+// Setup Mode Actions
+store.startSetupMode()          // Start setup wizard
+store.setSetupStep(step)        // Set current setup step
+store.testConnection()          // Test backend connection
+store.completeSetup()           // Complete setup
+store.skipSetup()               // Skip setup wizard
 ```
 
 ## 🪝 Composables
@@ -521,7 +630,44 @@ Get suggestions for current context:
 ```typescript
 import { useAiSuggestions } from '@doderasoftware/restify-ai'
 
-const { suggestions, resolvePrompt } = useAiSuggestions()
+const { suggestions, hasContextualSuggestions, resolvePrompt } = useAiSuggestions()
+```
+
+### useLoadingText
+
+Manage dynamic loading text messages:
+
+```typescript
+import { useLoadingText } from '@doderasoftware/restify-ai'
+
+const { 
+  loadingMessage, 
+  startLoadingText, 
+  resetLoadingText 
+} = useLoadingText(
+  () => isSending.value,
+  () => ({ 
+    messages: ['Thinking...', 'Analyzing...', 'Crafting response...'],
+    intervals: [0, 2000, 5000]
+  })
+)
+```
+
+### useHistoryLimit
+
+Handle chat history limits with warnings:
+
+```typescript
+import { useHistoryLimit } from '@doderasoftware/restify-ai'
+
+const historyLimit = useHistoryLimit({
+  getHistoryLength: () => chatHistory.length,
+  getStoreLimit: () => store.chatHistoryLimit,
+  getConfig: () => historyLimitConfig,
+  getTexts: () => texts,
+  onStartNewChat: () => store.clearChatHistory(),
+  onNewChatEmit: () => emit('new-chat'),
+})
 ```
 
 ## 🏷️ Mention Providers
@@ -757,26 +903,41 @@ interface AISuggestion {
 
 ## 🎨 UI Customization
 
-Override CSS classes for any component:
+Override CSS classes for any component. The `ui` prop on `AiChatDrawer` allows you to customize all components in one place - it extends all child component UI interfaces, so you can customize the drawer, input, messages, empty state, and mentions all from a single object.
 
 ```vue
 <AiChatDrawer
   v-model="isOpen"
   :ui="{
+    // Drawer customization
     backdrop: 'bg-black/50 backdrop-blur-sm',
     drawer: 'shadow-2xl',
     panel: 'bg-gray-50 dark:bg-gray-900',
     header: 'border-b-2 border-primary-500',
     body: 'custom-scrollbar',
     footer: 'border-t border-gray-200',
+    
+    // ChatInput customization (automatically passed down)
+    textarea: 'rounded-xl',
+    sendButton: 'bg-blue-500 hover:bg-blue-600',
+    
+    // ChatMessage customization (automatically passed down)
+    userBubble: 'bg-blue-500 text-white',
+    assistantBubble: 'bg-gray-100 dark:bg-gray-800',
+    
+    // AiEmptyState customization (automatically passed down)
+    suggestionCard: 'border-2 border-primary-500',
   }"
 />
 ```
 
 ### AiChatDrawerUI
 
+The main UI interface that combines all component UI interfaces. Pass this to the `ui` prop to customize all components:
+
 ```typescript
-interface AiChatDrawerUI {
+interface AiChatDrawerUI extends ChatInputUI, ChatMessageUI, AiEmptyStateUI, MentionListUI {
+  // Drawer-specific
   backdrop?: string              // Backdrop overlay
   drawer?: string                // Main drawer container
   panel?: string                 // Inner panel
@@ -786,17 +947,24 @@ interface AiChatDrawerUI {
   headerActionButton?: string    // Header buttons
   body?: string                  // Messages container
   footer?: string                // Footer container
+  
+  // Dialogs
+  closeConfirmModal?: string     // Confirm modal
+  closeConfirmButton?: string    // Confirm button
+  cancelButton?: string          // Cancel button
+  historyLimitModal?: string     // History limit modal
+  historyLimitButton?: string    // History limit button
+  
+  // Header elements
   quotaDisplay?: string          // Quota display
   messageCountBadge?: string     // Message count badge
   newChatButton?: string         // New chat button
+  
+  // Error display
   errorContainer?: string        // Error container
   errorMessage?: string          // Error message
   retryButton?: string           // Retry button
-  closeConfirmModal?: string     // Confirm modal
-  closeConfirmButton?: string    // Confirm button
-  cancelButton?: string          // Cancel button
-  historyLimitModal?: string     // History limit modal
-  historyLimitButton?: string    // History limit button
+  contactSupportButton?: string  // Contact support button
 }
 ```
 
@@ -824,6 +992,10 @@ interface ChatInputUI {
   suggestionItem?: string        // Suggestion item
   suggestionItemSelected?: string // Selected suggestion
   contextLink?: string           // Context link
+  // Audio input
+  audioButton?: string           // Audio button
+  audioButtonRecording?: string  // Audio button when recording
+  audioRecordingIndicator?: string // Recording indicator
 }
 ```
 
@@ -847,6 +1019,66 @@ interface ChatMessageUI {
 }
 ```
 
+### AiEmptyStateUI
+
+```typescript
+interface AiEmptyStateUI {
+  root?: string                  // Root container
+  content?: string               // Content container
+  header?: string                // Header container
+  badge?: string                 // AI badge
+  title?: string                 // Title
+  description?: string           // Description
+  grid?: string                  // Suggestions grid
+  suggestionCard?: string        // Suggestion card
+  suggestionIconContainer?: string // Icon container
+  suggestionIcon?: string        // Icon
+  suggestionTitle?: string       // Suggestion title
+  suggestionDescription?: string // Suggestion description
+}
+```
+
+### MentionListUI
+
+```typescript
+interface MentionListUI {
+  root?: string                  // Root container
+  container?: string             // List container
+  groupHeader?: string           // Group header
+  item?: string                  // Item
+  itemSelected?: string          // Selected item
+  itemIcon?: string              // Item icon
+  itemContent?: string           // Item content
+  itemName?: string              // Item name
+  itemSubtitle?: string          // Item subtitle
+}
+```
+
+### AiAvatarUI / UserAvatarUI
+
+```typescript
+interface AiAvatarUI {
+  container?: string             // Container
+  icon?: string                  // Icon
+}
+
+interface UserAvatarUI {
+  container?: string             // Container
+  icon?: string                  // Icon
+}
+```
+
+### ChatMessageActionsUI
+
+```typescript
+interface ChatMessageActionsUI {
+  container?: string             // Container
+  button?: string                // Action button
+  copyButton?: string            // Copy button
+  successState?: string          // Success state
+}
+```
+
 ## 📝 TypeScript Types
 
 All types are exported:
@@ -866,6 +1098,8 @@ import type {
   ChatAttachment,
   ChatRole,
   SubmitPayload,
+  Mention,
+  ConversationHistoryItem,
   
   // Context
   PageContext,
@@ -873,7 +1107,8 @@ import type {
   // Providers
   MentionProvider,
   MentionItem,
-  Mention,
+  MentionContext,
+  MentionParseResult,
   SuggestionProvider,
   AISuggestion,
   
@@ -881,17 +1116,30 @@ import type {
   HistoryLimitConfig,
   LoadingTextConfig,
   
+  // Setup
+  SetupStep,
+  SetupState,
+  
+  // Store
+  AiStoreState,
+  
   // UI Customization
   AiChatDrawerUI,
   ChatInputUI,
   ChatMessageUI,
   AiEmptyStateUI,
   MentionListUI,
+  AiAvatarUI,
+  UserAvatarUI,
+  ChatMessageActionsUI,
   
   // Text Customization
   AiChatDrawerTexts,
   ChatInputTexts,
   ChatMessageTexts,
+  AiEmptyStateTexts,
+  MentionListTexts,
+  ChatMessageActionsTexts,
   
   // Slot Props
   HeaderSlotProps,
@@ -899,15 +1147,26 @@ import type {
   InputSlotProps,
   EmptyStateSlotProps,
   
-  // Hooks
+  // API Hooks
+  AiRequestPayload,
+  AiStreamChunk,
   BeforeSendHook,
   AfterResponseHook,
   OnStreamStartHook,
   OnStreamEndHook,
   OnStreamChunkHook,
   StreamParserFunction,
+  RequestInterceptor,
+  ResponseInterceptor,
   RetryConfig,
+  
+  // Functions
+  TranslateFunction,
+  PermissionCheckFunction,
 } from '@doderasoftware/restify-ai'
+
+// Constants
+import { ChatRoles } from '@doderasoftware/restify-ai'
 ```
 
 ## 🔌 Backend Integration
@@ -924,25 +1183,101 @@ Route::post('/ask', [AiController::class, 'ask']);
 **Request:**
 ```json
 {
-  "question": "Who is available today?",
+  "message": "Who is available today?",
   "history": [
-    { "role": "user", "message": "Hello" },
-    { "role": "assistant", "message": "Hi! How can I help?" }
+    { "role": "user", "content": "Hello" },
+    { "role": "assistant", "content": "Hi! How can I help?" }
   ],
   "stream": true,
-  "files": [{ "id": "file-123", "name": "report.pdf" }],
+  "files": [{ "id": "file-123", "name": "report.pdf", "backendFileId": 456 }],
+  "attachment_ids": [456],
   "mentions": [{ "id": "emp-1", "type": "employee", "name": "John Doe" }],
-  "contact_support": false
+  "contact_support": false,
+  "conversation_id": "conv-abc123"
 }
 ```
 
+> **Note:** The `conversation_id` field is only sent when `useConversationId: true` is configured. The `attachment_ids` array contains backend file IDs returned from the upload endpoint.
+
 **Response (SSE):**
 ```
+event: start
+data: {"conversation_id":"conv-abc123"}
+
 data: {"choices":[{"delta":{"content":"Based on"}}]}
 data: {"choices":[{"delta":{"content":" the schedule..."}}]}
 data: [DONE]
 ```
 
+### Conversation ID Tracking
+
+When `useConversationId: true` is enabled in the plugin configuration, the package will:
+
+1. **Receive** the conversation ID from the backend via the `start` SSE event
+2. **Store** it in the Pinia store (`store.conversationId`)
+3. **Send** it back with subsequent requests in the same conversation
+4. **Clear** it when starting a new chat
+
+This is useful for:
+- Tracking conversations across multiple requests
+- Maintaining context on the backend
+- Analytics and logging
+- Multi-turn conversation management
+
+### Conversation History
+
+When `useConversationHistory: true` is enabled, users can access a sidebar showing their previous conversations:
+
+**Features:**
+- 📜 **View past conversations** - Browse through saved chats
+- ✏️ **Rename conversations** - Give meaningful titles to chats
+- 🗑️ **Delete conversations** - Remove unwanted history
+- 🔄 **Switch conversations** - Seamlessly load previous chats
+- 💾 **Automatic saving** - Conversations save automatically
+
+**Configuration:**
+```typescript
+app.use(RestifyAiPlugin, {
+  useConversationId: true,      // Required for history
+  useConversationHistory: true, // Enable history sidebar
+  maxConversationHistory: 10,   // Max conversations to keep (default: 10)
+})
+```
+
+**How it works:**
+1. When `useConversationHistory` is enabled, a history button appears in the drawer header
+2. Clicking the button opens a sidebar showing past conversations
+3. Conversations are automatically saved to `localStorage` when completed
+4. Each conversation shows: title (from first message or backend), date, message count
+5. Users can rename, delete, or switch between conversations
+
+**Backend Integration:**
+
+The backend can provide a conversation name via the `start` SSE event:
+
+```
+event: start
+data: {"conversation_id":"conv-abc123","conversation_name":"Budget Analysis Q1"}
+```
+
+If no name is provided, the title defaults to a truncated version of the first user message.
+
+**Storage:**
+- Conversation list: `restify_ai_conversation_history`
+- Conversation messages: `restify_ai_conv_{conversationId}`
+- Current conversation ID: `restify_ai_current_conversation`
+
+**ConversationHistoryItem Interface:**
+```typescript
+interface ConversationHistoryItem {
+  id: string           // Conversation ID from backend
+  title: string        // Display title
+  createdAt: number    // Timestamp when created
+  updatedAt: number    // Timestamp of last update
+  messageCount: number // Number of messages
+}
+```
+
 ### Quota Endpoint
 
 ```php
@@ -961,6 +1296,27 @@ Route::get('/ai/quota', [AiController::class, 'quota']);
 }
 ```
 
+### Rate Limiting via Headers
+
+As an alternative to the quota endpoint, you can enable headers-based rate limiting. When `useHeadersRateLimiter` is enabled, the package will extract rate limit information directly from response headers instead of making separate quota endpoint calls.
+
+**Configuration:**
+```typescript
+app.use(RestifyAi, {
+  useQuota: true,
+  useHeadersRateLimiter: true, // Enable headers-based rate limiting
+})
+```
+
+**Required Response Headers:**
+
+Your chat endpoint should return these headers with each response:
+
+```
+x-ratelimit-limit: 100      // Total allowed requests
+x-ratelimit-remaining: 75   // Remaining requests
+```
+
 ### Upload Endpoint
 
 ```php
@@ -972,15 +1328,41 @@ Route::post('/ai/upload', [AiController::class, 'upload']);
 ```json
 {
   "data": {
-    "id": "file-123",
+    "id": 456,
     "name": "document.pdf",
     "url": "/storage/uploads/document.pdf",
     "type": "application/pdf",
-    "size": 102400
+    "size": 102400,
+    "extracted_text": "Optional extracted text content..."
   }
 }
 ```
 
+### Backend File ID Support
+
+When files are uploaded, the backend can return an ID that will be automatically tracked and sent with subsequent requests. This enables the backend to reference pre-processed files.
+
+**Supported ID field names in upload response:**
+- `id` (recommended)
+- `file_id`
+- `attachment_id`
+- `openai_file_id`
+
+The package automatically:
+1. **Stores** the backend file ID when received from upload response
+2. **Includes** all backend file IDs in the `attachment_ids` array in ask requests
+3. **Preserves** the ID through the entire conversation
+
+**Example flow:**
+```
+1. User uploads file.pdf
+2. Backend returns: { "id": 456, "name": "file.pdf", ... }
+3. Package stores backendFileId: 456
+4. User sends message with attachment
+5. Request includes: { "attachment_ids": [456], "files": [...] }
+6. Backend can use attachment_ids to reference stored/processed files
+```
+
 ## ⌨️ Keyboard Shortcuts
 
 | Shortcut | Action |
@@ -1002,7 +1384,17 @@ Chat history persists in `sessionStorage` by default:
 
 ```typescript
 // Components
-export { AiChatDrawer } from './components'
+export { 
+  AiChatDrawer,
+  AiEmptyState,
+  ChatInput,
+  ChatMessage,
+  ChatMessageActions,
+  MentionList,
+  AiAvatar,
+  UserAvatar,
+  ErrorBoundary,
+} from './components'
 
 // Store
 export { useRestifyAiStore } from './store'
@@ -1010,20 +1402,42 @@ export { useRestifyAiStore } from './store'
 // Composables
 export { 
   useAiDrawerShortcut,
+  useKeyboardShortcut,
   usePageAiContext,
   useAiContext,
-  useAiSuggestions 
+  useAiSuggestions,
+  useMentionParsing,
+  useChatMarkdown,
+  useChatScroll,
+  useChatErrorHandling,
+  useLoadingText,
+  useHistoryLimit,
+  useSuggestionFilter,
+  useAutoScroll,
+  formatMentionsForApi,
+  groupMentionsByType,
 } from './composables'
 
 // Config
 export { 
-  initRestifyAi, 
-  getConfig, 
-  getLabels, 
-  getUI,
-  RestifyAiPlugin 
+  RestifyAiPlugin,
+  getRestifyAiConfig,
+  setRestifyAiConfig,
+  getLabel,
+  getConfigValue,
+  isConfigured,
+  defaultLabels,
 } from './config'
 
+// Suggestions
+export {
+  registerSuggestionProvider,
+  getSuggestionsForPath,
+} from './suggestions'
+
+// Utilities
+export { isImageFile, formatFileSize } from './utils'
+
 // Types
 export * from './types'
 ```
@@ -1039,7 +1453,7 @@ export * from './types'
 - [📖 Laravel Restify Documentation](https://laravel-restify.com)
 - [📦 npm Package](https://www.npmjs.com/package/@doderasoftware/restify-ai)
 - [🏢 BinarCode](https://binarcode.com)
-- [💻 GitHub](https://github.com/BinarCode/laravel-restify)
+- [💻 GitHub](https://github.com/BinarCode/restify-chatbot)
 
 ## 📄 License
 
@@ -1047,4 +1461,4 @@ MIT © [BinarCode](https://binarcode.com)
 
 ---
 
-Built with ❤️ by the [BinarCode](https://binarcode.com) team · Published by [Dodera Software](https://doderasoft.com)
+Built with ❤️ by the [BinarCode](https://binarcode.com) team.