react-ai-agent 1.6.7 → 1.6.8

package/index.d.ts

@@ -189,6 +189,7 @@ export interface ChatProviderProps {
   statusComponents?: any;
   forwardingHandlers?: ForwardingHandlers;
   enableHistory?: boolean;
+  loadHistory?: boolean; // Control initial history loading
   loadingComponent?: ComponentType<any>;
   headerComponent?: ComponentType<any>;
   allowThinking?: boolean;
@@ -196,11 +197,61 @@ export interface ChatProviderProps {
   agentId?: string; // Unique identifier for multi-instance support
   refreshTokenCallback?: (refreshToken: string) => Promise<any>;
   onError?: (error: any) => void; // Error handler callback
+  onSessionError?: (error: any) => Promise<void>; // Session error handler
   // Legacy support (deprecated)
   sessionData?: SessionData | null;
 }
 
-export function ChatProvider(props: ChatProviderProps): ReactElement;
+/**
+ * ChatProvider Controller Interface
+ * Provides imperative access to ChatProvider methods and state via ref
+ */
+export interface ChatProviderController {
+  // Message operations
+  sendMsg: (params?: SendMessageParams) => Promise<void>;
+  getHistory: () => Promise<void>;
+  loadMoreMessages: () => Promise<void>;
+  abort: () => void;
+  retryLastMessage: () => Promise<void>;
+  
+  // State getters
+  messages: any[];
+  isLoading: boolean;
+  isStreaming: boolean;
+  isResponseStarted: boolean;
+  isInitialLoading: boolean;
+  isLoadingMore: boolean;
+  hasMoreMessages: boolean;
+  error: any;
+  streamError: any;
+  sessionId: string | undefined;
+  instanceId: string;
+  
+  // Message manager
+  messageManager: {
+    addMessage: (msg: any) => any;
+    updateMessage: (id: string, updates: any, options?: { silent?: boolean }) => any;
+    removeMessage: (id: string) => boolean;
+    getMessage: (id: string) => any;
+    clear: () => void;
+  };
+  
+  // Config setters
+  setAuthConfig: (config: { sessionId?: string; accessToken?: string }) => void;
+  setLoadHistory: (load: boolean) => void;
+  setSessionId: (id: string | undefined) => void;
+  clearStreamError: () => void;
+  
+  // Status registry
+  statusRegistry: {
+    register: (action: string, handler: (data: any) => void) => () => void;
+    registerGlobal: (handler: (data: any) => void) => () => void;
+  };
+}
+
+export const ChatProvider: React.ForwardRefExoticComponent<
+  ChatProviderProps & React.RefAttributes<ChatProviderController>
+>;
 
 // ============================================================================
 // Components

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-ai-agent",
-  "version": "1.6.7",
+  "version": "1.6.8",
   "type": "module",
   "description": "React Chat Agent - A production-ready chat provider with WebSocket support",
   "main": "dist/index.cjs",