@curaious/uno-converse 0.1.15 → 0.1.17

package/dist/index.d.ts

@@ -1,3 +1,12 @@
+import { ReactNode, ReactElement } from 'react';
+import { AxiosInstance } from 'axios';
+
+interface Agent {
+    id: string;
+    agent_id: string;
+    name: string;
+    version: number;
+}
 declare enum Role {
     User = "user",
     Developer = "developer",
@@ -276,12 +285,6 @@ type GetHeadersFn = () => Record<string, string> | Promise<Record<string, string
 interface UseConversationOptions {
     /** The namespace for conversations */
     namespace: string;
-    /** Base URL of the Uno Agent Server (e.g., 'https://api.example.com/api/agent-server') */
-    baseUrl: string;
-    /** Project Name used to fetch the project ID */
-    projectName: string;
-    /** Optional function to get custom headers for requests (e.g., for authentication) */
-    getHeaders?: GetHeadersFn;
     /** Auto-load conversations on mount (default: true) */
     autoLoad?: boolean;
 }
@@ -289,10 +292,6 @@ interface UseConversationOptions {
  * Return type for the useConversation hook
  */
 interface UseConversationReturn {
-    /** The fetched project ID */
-    projectId: string;
-    /** Whether the project ID is being fetched */
-    projectLoading: boolean;
     /** List of all conversations */
     conversations: Conversation[];
     /** Whether conversations are being loaded */
@@ -348,11 +347,6 @@ interface UseConversationReturn {
  *     startNewChat,
  *   } = useConversation({
  *     namespace: 'my-app',
- *     projectName: 'my-project',
- *     baseUrl: 'https://my-uno-server.com/api/agent-server',
- *     getHeaders: () => ({
- *       'Authorization': `Bearer ${getToken()}`,
- *     }),
  *   });
  *
  *   const handleSend = async (text: string) => {
@@ -378,6 +372,132 @@ interface UseConversationReturn {
  */
 declare function useConversation(options: UseConversationOptions): UseConversationReturn;
 
+/**
+ * Options for the useAgent hook
+ */
+interface UseAgentOptions {
+    /** The name of the agent */
+    name: string;
+}
+/**
+ * Return type for the useAgent hook
+ */
+interface UseAgentReturn {
+    agent: Agent | null;
+    /** Whether the agent is being loaded */
+    agentLoading: boolean;
+}
+declare function useAgent(options: UseAgentOptions): UseAgentReturn;
+
+/**
+ * Options for the useProject hook
+ */
+interface UseProjectOptions {
+    /** Base URL of the Uno Agent Server (e.g., 'https://api.example.com/api/agent-server') */
+    baseUrl: string;
+    /** Project Name used to fetch the project ID */
+    projectName: string;
+    /** Optional function to get custom headers for requests (e.g., for authentication) */
+    getHeaders?: GetHeadersFn;
+    /** Auto-load conversations on mount (default: true) */
+    autoLoad?: boolean;
+}
+/**
+ * Return type for the useProject hook
+ */
+interface UseProjectReturn {
+    /** The fetched project ID */
+    projectId: string;
+    /** Whether the project ID is being fetched */
+    projectLoading: boolean;
+    /** Axios instance configured with baseUrl and custom headers */
+    axiosInstance: AxiosInstance;
+    /** Function to build query params with project_id automatically added */
+    buildParams: (params?: Record<string, string>) => Record<string, string>;
+    /** Function to get request headers (combines default + custom headers) */
+    getRequestHeaders: () => Promise<Record<string, string>>;
+    /** Base URL used for the axios instance */
+    baseUrl: string;
+}
+
+/**
+ * Context value for ProjectProvider
+ */
+interface ProjectContextValue extends UseProjectReturn {
+}
+/**
+ * Props for ProjectProvider component
+ */
+interface ProjectProviderProps {
+    /** Base URL of the Uno Agent Server (e.g., 'https://api.example.com/api/agent-server') */
+    baseUrl: string;
+    /** Project Name used to fetch the project ID */
+    projectName: string;
+    /** Optional function to get custom headers for requests (e.g., for authentication) */
+    getHeaders?: UseProjectOptions['getHeaders'];
+    /** Auto-load project on mount (default: true) */
+    autoLoad?: boolean;
+    /** Child components */
+    children: ReactNode;
+}
+/**
+ * ProjectProvider component that manages project state using React Context.
+ *
+ * This provider wraps the useProject hook and makes the project state available
+ * to all child components through context.
+ *
+ * @example
+ * ```tsx
+ * import { ProjectProvider, useProjectContext } from '@praveen001/uno-converse';
+ *
+ * function App() {
+ *   return (
+ *     <ProjectProvider
+ *       baseUrl="https://api.example.com/api/agent-server"
+ *       projectName="my-project"
+ *       getHeaders={() => ({
+ *         'Authorization': `Bearer ${getToken()}`,
+ *       })}
+ *     >
+ *       <YourApp />
+ *     </ProjectProvider>
+ *   );
+ * }
+ *
+ * function YourApp() {
+ *   const { projectId, projectLoading } = useProjectContext();
+ *
+ *   if (projectLoading) {
+ *     return <div>Loading project...</div>;
+ *   }
+ *
+ *   return <div>Project ID: {projectId}</div>;
+ * }
+ * ```
+ */
+declare const ProjectProvider: ({ baseUrl, projectName, getHeaders, autoLoad, children, }: ProjectProviderProps) => ReactElement;
+/**
+ * Hook to access the project context.
+ *
+ * Must be used within a ProjectProvider component.
+ *
+ * @throws {Error} If used outside of ProjectProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { projectId, projectLoading } = useProjectContext();
+ *
+ *   return (
+ *     <div>
+ *       {projectLoading ? 'Loading...' : `Project ID: ${projectId}`}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare const useProjectContext: () => ProjectContextValue;
+
 /**
  * Callback invoked when the conversation state changes
  */
@@ -469,5 +589,5 @@ interface SSEStreamOptions {
  */
 declare function streamSSE(url: string, requestOptions: RequestInit, callbacks: SSEStreamOptions, abortSignal?: AbortSignal): Promise<void>;
 
-export { ChunkProcessor, ChunkType, ContentType, MessageType, Role, isEasyMessage, isFunctionCallMessage, isFunctionCallOutputMessage, isImageGenerationCallMessage, isInputMessage, isReasoningMessage, streamSSE, useConversation };
-export type { ChunkOutputItemData, ChunkResponseData, ChunkResponseUsage, ChunkRunData, Conversation, ConversationMessage, ConverseConfig, EasyInputContentUnion, EasyMessage, FunctionCallApprovalResponseMessage, FunctionCallMessage, FunctionCallOutputContentUnion, FunctionCallOutputMessage, GetHeadersFn, ImageGenerationCallMessage, InputContentUnion, InputImageContent, InputMessage, InputTextContent, MessageUnion, OnChangeCallback, OutputContentUnion, OutputMessage, OutputMessageUnion, OutputTextContent, ReasoningMessage, ResponseChunk, SSEStreamOptions, SummaryTextContent, Thread, Usage, UseConversationOptions, UseConversationReturn };
+export { ChunkProcessor, ChunkType, ContentType, MessageType, ProjectProvider, Role, isEasyMessage, isFunctionCallMessage, isFunctionCallOutputMessage, isImageGenerationCallMessage, isInputMessage, isReasoningMessage, streamSSE, useAgent, useConversation, useProjectContext };
+export type { ChunkOutputItemData, ChunkResponseData, ChunkResponseUsage, ChunkRunData, Conversation, ConversationMessage, ConverseConfig, EasyInputContentUnion, EasyMessage, FunctionCallApprovalResponseMessage, FunctionCallMessage, FunctionCallOutputContentUnion, FunctionCallOutputMessage, GetHeadersFn, ImageGenerationCallMessage, InputContentUnion, InputImageContent, InputMessage, InputTextContent, MessageUnion, OnChangeCallback, OutputContentUnion, OutputMessage, OutputMessageUnion, OutputTextContent, ProjectContextValue, ProjectProviderProps, ReasoningMessage, ResponseChunk, SSEStreamOptions, SummaryTextContent, Thread, Usage, UseAgentOptions, UseAgentReturn, UseConversationOptions, UseConversationReturn };

package/dist/index.js

@@ -1,5 +1,6 @@
+import { useState, useRef, useEffect, useMemo, useCallback, createContext, useContext } from 'react';
+import { jsx } from 'react/jsx-runtime';
 import axios from 'axios';
-import { useMemo, useState, useRef, useCallback, useEffect } from 'react';
 
 // Message Roles
 var Role;
@@ -398,6 +399,203 @@ async function streamSSE(url, requestOptions, callbacks, abortSignal) {
     }
 }
 
+function useProject(options) {
+    const { projectName, baseUrl, getHeaders, autoLoad = true } = options;
+    // Project state
+    const [projectId, setProjectId] = useState('');
+    const [projectLoading, setProjectLoading] = useState(false);
+    // Use ref to store current projectId for interceptor access
+    const projectIdRef = useRef('');
+    // Update ref whenever projectId changes
+    useEffect(() => {
+        projectIdRef.current = projectId;
+    }, [projectId]);
+    // Create axios instance with request interceptor for custom headers and project_id
+    const axiosInstance = useMemo(() => {
+        const instance = axios.create({
+            baseURL: baseUrl,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        // Add request interceptor to inject custom headers and project_id
+        instance.interceptors.request.use(async (config) => {
+            // Add custom headers if getHeaders function is provided
+            if (getHeaders) {
+                const customHeaders = await getHeaders();
+                Object.assign(config.headers, customHeaders);
+            }
+            // Automatically add project_id to query params if available
+            const currentProjectId = projectIdRef.current;
+            if (currentProjectId) {
+                if (config.params) {
+                    config.params = {
+                        ...config.params,
+                        project_id: currentProjectId,
+                    };
+                }
+                else {
+                    config.params = { project_id: currentProjectId };
+                }
+            }
+            return config;
+        });
+        return instance;
+    }, [baseUrl, getHeaders]);
+    // ============================================
+    // API Helper Functions
+    // ============================================
+    /**
+     * Build query params (project_id is automatically added by axios interceptor)
+     */
+    const buildParams = useCallback((params) => {
+        return params || {};
+    }, []);
+    /**
+     * Get headers for streaming requests (combines default + custom headers)
+     */
+    const getRequestHeaders = useCallback(async () => {
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        // Add custom headers if getHeaders function is provided
+        if (getHeaders) {
+            const customHeaders = await getHeaders();
+            Object.assign(headers, customHeaders);
+        }
+        return headers;
+    }, [getHeaders]);
+    // ============================================
+    // Project Management
+    // ============================================
+    /**
+     * Fetch the project ID using the project name
+     */
+    const fetchProjectId = useCallback(async () => {
+        if (!projectName) {
+            return;
+        }
+        setProjectLoading(true);
+        try {
+            const response = await axiosInstance.get('/project/id', {
+                params: { name: projectName },
+            });
+            const id = typeof response.data === 'string' ? response.data : response.data.data;
+            setProjectId(id || '');
+        }
+        catch (error) {
+            console.error('Failed to fetch project ID:', error);
+            throw error;
+        }
+        finally {
+            setProjectLoading(false);
+        }
+    }, [axiosInstance, projectName]);
+    // ============================================
+    // Effects for auto-loading
+    // ============================================
+    // Fetch project ID on mount
+    useEffect(() => {
+        if (autoLoad && projectName) {
+            fetchProjectId();
+        }
+    }, [autoLoad, projectName, fetchProjectId]);
+    return {
+        // Project state
+        projectId,
+        projectLoading,
+        // API client
+        axiosInstance,
+        buildParams,
+        getRequestHeaders,
+        baseUrl,
+    };
+}
+
+// Create the context with undefined as default to ensure it's used within provider
+const ProjectContext = createContext(undefined);
+/**
+ * ProjectProvider component that manages project state using React Context.
+ *
+ * This provider wraps the useProject hook and makes the project state available
+ * to all child components through context.
+ *
+ * @example
+ * ```tsx
+ * import { ProjectProvider, useProjectContext } from '@praveen001/uno-converse';
+ *
+ * function App() {
+ *   return (
+ *     <ProjectProvider
+ *       baseUrl="https://api.example.com/api/agent-server"
+ *       projectName="my-project"
+ *       getHeaders={() => ({
+ *         'Authorization': `Bearer ${getToken()}`,
+ *       })}
+ *     >
+ *       <YourApp />
+ *     </ProjectProvider>
+ *   );
+ * }
+ *
+ * function YourApp() {
+ *   const { projectId, projectLoading } = useProjectContext();
+ *
+ *   if (projectLoading) {
+ *     return <div>Loading project...</div>;
+ *   }
+ *
+ *   return <div>Project ID: {projectId}</div>;
+ * }
+ * ```
+ */
+const ProjectProvider = ({ baseUrl, projectName, getHeaders, autoLoad = true, children, }) => {
+    // Use the useProject hook to manage project state
+    const projectState = useProject({
+        baseUrl,
+        projectName,
+        getHeaders,
+        autoLoad,
+    });
+    // Memoize the context value to prevent unnecessary re-renders
+    const contextValue = useMemo(() => projectState, [
+        projectState.projectId,
+        projectState.projectLoading,
+        projectState.axiosInstance,
+        projectState.buildParams,
+        projectState.getRequestHeaders,
+        projectState.baseUrl,
+    ]);
+    return (jsx(ProjectContext.Provider, { value: contextValue, children: children }));
+};
+/**
+ * Hook to access the project context.
+ *
+ * Must be used within a ProjectProvider component.
+ *
+ * @throws {Error} If used outside of ProjectProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { projectId, projectLoading } = useProjectContext();
+ *
+ *   return (
+ *     <div>
+ *       {projectLoading ? 'Loading...' : `Project ID: ${projectId}`}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+const useProjectContext = () => {
+    const context = useContext(ProjectContext);
+    if (context === undefined) {
+        throw new Error('useProjectContext must be used within a ProjectProvider');
+    }
+    return context;
+};
+
 /**
  * Simple ID generator for message IDs
  */
@@ -420,11 +618,6 @@ function generateId() {
  *     startNewChat,
  *   } = useConversation({
  *     namespace: 'my-app',
- *     projectName: 'my-project',
- *     baseUrl: 'https://my-uno-server.com/api/agent-server',
- *     getHeaders: () => ({
- *       'Authorization': `Bearer ${getToken()}`,
- *     }),
  *   });
  *
  *   const handleSend = async (text: string) => {
@@ -449,28 +642,9 @@ function generateId() {
  * ```
  */
 function useConversation(options) {
-    const { namespace, projectName, baseUrl, getHeaders, autoLoad = true } = options;
-    // Create axios instance with request interceptor for custom headers
-    const axiosInstance = useMemo(() => {
-        const instance = axios.create({
-            baseURL: baseUrl,
-            headers: {
-                'Content-Type': 'application/json',
-            },
-        });
-        // Add request interceptor to inject custom headers
-        if (getHeaders) {
-            instance.interceptors.request.use(async (config) => {
-                const customHeaders = await getHeaders();
-                Object.assign(config.headers, customHeaders);
-                return config;
-            });
-        }
-        return instance;
-    }, [baseUrl, getHeaders]);
-    // Project state
-    const [projectId, setProjectId] = useState('');
-    const [projectLoading, setProjectLoading] = useState(false);
+    const { namespace, autoLoad = true } = options;
+    // Get project context (axios instance, projectId, etc.)
+    const { axiosInstance, projectId, projectLoading, buildParams, getRequestHeaders, baseUrl, } = useProjectContext();
     // Conversation list state
     const [conversations, setConversations] = useState([]);
     const [conversationsLoading, setConversationsLoading] = useState(false);
@@ -493,59 +667,7 @@ function useConversation(options) {
     // ============================================
     // API Helper Functions
     // ============================================
-    /**
-     * Build query params with project_id if available
-     */
-    const buildParams = useCallback((params) => {
-        const result = {};
-        if (projectId) {
-            result.project_id = projectId;
-        }
-        if (params) {
-            Object.assign(result, params);
-        }
-        return result;
-    }, [projectId]);
-    /**
-     * Get headers for streaming requests (combines default + custom headers)
-     */
-    const getRequestHeaders = useCallback(async () => {
-        const headers = {
-            'Content-Type': 'application/json',
-        };
-        // Add custom headers if getHeaders function is provided
-        if (getHeaders) {
-            const customHeaders = await getHeaders();
-            Object.assign(headers, customHeaders);
-        }
-        return headers;
-    }, [getHeaders]);
-    // ============================================
-    // Project Management
-    // ============================================
-    /**
-     * Fetch the project ID using the project name
-     */
-    const fetchProjectId = useCallback(async () => {
-        if (!projectName) {
-            return;
-        }
-        setProjectLoading(true);
-        try {
-            const response = await axiosInstance.get('/project/id', {
-                params: { name: projectName },
-            });
-            const id = typeof response.data === 'string' ? response.data : response.data.data;
-            setProjectId(id || '');
-        }
-        catch (error) {
-            console.error('Failed to fetch project ID:', error);
-            throw error;
-        }
-        finally {
-            setProjectLoading(false);
-        }
-    }, [axiosInstance, projectName]);
+    // Note: buildParams and getRequestHeaders are now provided by ProjectProvider
     // ============================================
     // Conversation Management
     // ============================================
@@ -790,12 +912,6 @@ function useConversation(options) {
     // ============================================
     // Effects for auto-loading
     // ============================================
-    // Fetch project ID on mount
-    useEffect(() => {
-        if (autoLoad && projectName) {
-            fetchProjectId();
-        }
-    }, [autoLoad, projectName, fetchProjectId]);
     // Load conversations after project ID is fetched
     useEffect(() => {
         if (autoLoad && projectId) {
@@ -822,9 +938,6 @@ function useConversation(options) {
         ? [...messages, streamingMessage]
         : messages;
     return {
-        // Project state
-        projectId,
-        projectLoading,
         // Conversation list state
         conversations,
         conversationsLoading,
@@ -856,5 +969,43 @@ function useConversation(options) {
     };
 }
 
-export { ChunkProcessor, ChunkType, ContentType, MessageType, Role, isEasyMessage, isFunctionCallMessage, isFunctionCallOutputMessage, isImageGenerationCallMessage, isInputMessage, isReasoningMessage, streamSSE, useConversation };
+function useAgent(options) {
+    const { name } = options;
+    // Get project context (axios instance, projectId, etc.)
+    const { axiosInstance, projectId, buildParams, } = useProjectContext();
+    // Agents state
+    const [agent, setAgent] = useState(null);
+    const [agentLoading, setAgentLoading] = useState(false);
+    // ============================================
+    // Agent Management
+    // ============================================
+    /**
+     * Fetch the agent
+     */
+    const loadAgent = useCallback(async () => {
+        setAgentLoading(true);
+        try {
+            const response = await axiosInstance.get('/agent-configs/by-name', {
+                params: buildParams({ name }),
+            });
+            setAgent(response.data.data);
+        }
+        catch (error) {
+            console.error('Failed to load agent:', error);
+            throw error;
+        }
+        finally {
+            setAgentLoading(false);
+        }
+    }, [axiosInstance, name]);
+    // Fetch agent after project is fetched
+    useEffect(() => {
+        if (projectId) {
+            loadAgent();
+        }
+    }, [projectId, loadAgent]);
+    return { agent, agentLoading };
+}
+
+export { ChunkProcessor, ChunkType, ContentType, MessageType, ProjectProvider, Role, isEasyMessage, isFunctionCallMessage, isFunctionCallOutputMessage, isImageGenerationCallMessage, isInputMessage, isReasoningMessage, streamSSE, useAgent, useConversation, useProjectContext };
 //# sourceMappingURL=index.js.map