@antipopp/agno-react 0.7.0 → 0.9.0

package/README.md

@@ -33,6 +33,12 @@ function App() {
         mode: 'agent',
         agentId: 'your-agent-id',
         userId: 'user-123', // Optional: Link sessions to a user
+        headers: {          // Optional: Global headers for all requests
+          'X-API-Version': 'v2'
+        },
+        params: {           // Optional: Global query params for all requests
+          locale: 'en-US'
+        }
       }}
     >
       <YourComponents />
@@ -134,6 +140,17 @@ await sendMessage(formData);
 await sendMessage('Hello!', {
   headers: { 'X-Custom': 'value' }
 });
+
+// Send with query parameters
+await sendMessage('Hello!', {
+  params: { temperature: '0.7', max_tokens: '500' }
+});
+
+// Send with both headers and params
+await sendMessage('Hello!', {
+  headers: { 'X-Request-ID': '12345' },
+  params: { debug: 'true' }
+});
 ```
 
 #### `clearMessages()`
@@ -164,14 +181,20 @@ function SessionList() {
   const { sessions, loadSession, fetchSessions } = useAgnoSession();
 
   useEffect(() => {
-    fetchSessions();
+    // Fetch sessions with optional query params
+    fetchSessions({ params: { limit: '50', status: 'active' } });
   }, [fetchSessions]);
 
+  const handleLoadSession = (sessionId: string) => {
+    // Load session with optional params
+    loadSession(sessionId, { params: { include_metadata: 'true' } });
+  };
+
   return (
     <ul>
       {sessions.map((session) => (
         <li key={session.session_id}>
-          <button onClick={() => loadSession(session.session_id)}>
+          <button onClick={() => handleLoadSession(session.session_id)}>
             {session.session_name}
           </button>
         </li>
@@ -201,13 +224,19 @@ const {
 
 ```tsx
 function InitComponent() {
-  const { initialize, updateConfig, isInitializing } = useAgnoActions();
+  const { initialize, fetchAgents, updateConfig, isInitializing } = useAgnoActions();
   const { state } = useAgnoChat();
 
   useEffect(() => {
-    initialize();
+    // Initialize with optional params
+    initialize({ params: { filter: 'active' } });
   }, [initialize]);
 
+  const loadMoreAgents = () => {
+    // Fetch agents with custom params
+    fetchAgents({ params: { page: '2', limit: '20' } });
+  };
+
   const switchAgent = (agentId: string) => {
     updateConfig({ agentId, mode: 'agent' });
   };
@@ -222,6 +251,7 @@ function InitComponent() {
           {agent.name}
         </button>
       ))}
+      <button onClick={loadMoreAgents}>Load More</button>
     </div>
   );
 }

package/dist/index.d.mts

@@ -71,7 +71,10 @@ declare function useAgnoToolExecution(handlers?: Record<string, ToolHandler>, au
     /** Execute specific tools and return results without continuing */
     executeTools: (tools: ToolCall[]) => Promise<ToolCall[]>;
     /** Continue the run with manually provided tool results */
-    continueWithResults: (tools: ToolCall[]) => Promise<void>;
+    continueWithResults: (tools: ToolCall[], options?: {
+        headers?: Record<string, string>;
+        params?: Record<string, string>;
+    }) => Promise<void>;
     /** Error from tool execution, if any */
     executionError: string | undefined;
 };
@@ -374,9 +377,11 @@ declare function useAgnoChat(): {
     messages: ChatMessage[];
     sendMessage: (message: string | FormData, options?: {
         headers?: Record<string, string>;
+        params?: Record<string, string>;
     }) => Promise<void>;
     clearMessages: () => void;
     isStreaming: boolean;
+    isRefreshing: boolean;
     isPaused: boolean;
     error: string | undefined;
     state: ClientState;
@@ -388,8 +393,12 @@ declare function useAgnoChat(): {
 declare function useAgnoSession(): {
     sessions: SessionEntry[];
     currentSessionId: string | undefined;
-    loadSession: (sessionId: string) => Promise<ChatMessage[]>;
-    fetchSessions: () => Promise<SessionEntry[]>;
+    loadSession: (sessionId: string, options?: {
+        params?: Record<string, string>;
+    }) => Promise<ChatMessage[]>;
+    fetchSessions: (options?: {
+        params?: Record<string, string>;
+    }) => Promise<SessionEntry[]>;
     isLoading: boolean;
     error: string | undefined;
 };
@@ -398,13 +407,21 @@ declare function useAgnoSession(): {
  * Hook for common actions like initialization, fetching agents/teams
  */
 declare function useAgnoActions(): {
-    initialize: () => Promise<{
+    initialize: (options?: {
+        params?: Record<string, string>;
+    }) => Promise<{
         agents: AgentDetails[];
         teams: TeamDetails[];
     }>;
-    checkStatus: () => Promise<boolean>;
-    fetchAgents: () => Promise<AgentDetails[]>;
-    fetchTeams: () => Promise<TeamDetails[]>;
+    checkStatus: (options?: {
+        params?: Record<string, string>;
+    }) => Promise<boolean>;
+    fetchAgents: (options?: {
+        params?: Record<string, string>;
+    }) => Promise<AgentDetails[]>;
+    fetchTeams: (options?: {
+        params?: Record<string, string>;
+    }) => Promise<TeamDetails[]>;
     updateConfig: (updates: Partial<Parameters<(updates: Partial<_antipopp_agno_types.AgnoClientConfig>) => void>[0]>) => void;
     isInitializing: boolean;
     error: string | undefined;

package/dist/index.d.ts

@@ -71,7 +71,10 @@ declare function useAgnoToolExecution(handlers?: Record<string, ToolHandler>, au
     /** Execute specific tools and return results without continuing */
     executeTools: (tools: ToolCall[]) => Promise<ToolCall[]>;
     /** Continue the run with manually provided tool results */
-    continueWithResults: (tools: ToolCall[]) => Promise<void>;
+    continueWithResults: (tools: ToolCall[], options?: {
+        headers?: Record<string, string>;
+        params?: Record<string, string>;
+    }) => Promise<void>;
     /** Error from tool execution, if any */
     executionError: string | undefined;
 };
@@ -374,9 +377,11 @@ declare function useAgnoChat(): {
     messages: ChatMessage[];
     sendMessage: (message: string | FormData, options?: {
         headers?: Record<string, string>;
+        params?: Record<string, string>;
     }) => Promise<void>;
     clearMessages: () => void;
     isStreaming: boolean;
+    isRefreshing: boolean;
     isPaused: boolean;
     error: string | undefined;
     state: ClientState;
@@ -388,8 +393,12 @@ declare function useAgnoChat(): {
 declare function useAgnoSession(): {
     sessions: SessionEntry[];
     currentSessionId: string | undefined;
-    loadSession: (sessionId: string) => Promise<ChatMessage[]>;
-    fetchSessions: () => Promise<SessionEntry[]>;
+    loadSession: (sessionId: string, options?: {
+        params?: Record<string, string>;
+    }) => Promise<ChatMessage[]>;
+    fetchSessions: (options?: {
+        params?: Record<string, string>;
+    }) => Promise<SessionEntry[]>;
     isLoading: boolean;
     error: string | undefined;
 };
@@ -398,13 +407,21 @@ declare function useAgnoSession(): {
  * Hook for common actions like initialization, fetching agents/teams
  */
 declare function useAgnoActions(): {
-    initialize: () => Promise<{
+    initialize: (options?: {
+        params?: Record<string, string>;
+    }) => Promise<{
         agents: AgentDetails[];
         teams: TeamDetails[];
     }>;
-    checkStatus: () => Promise<boolean>;
-    fetchAgents: () => Promise<AgentDetails[]>;
-    fetchTeams: () => Promise<TeamDetails[]>;
+    checkStatus: (options?: {
+        params?: Record<string, string>;
+    }) => Promise<boolean>;
+    fetchAgents: (options?: {
+        params?: Record<string, string>;
+    }) => Promise<AgentDetails[]>;
+    fetchTeams: (options?: {
+        params?: Record<string, string>;
+    }) => Promise<TeamDetails[]>;
     updateConfig: (updates: Partial<Parameters<(updates: Partial<_antipopp_agno_types.AgnoClientConfig>) => void>[0]>) => void;
     isInitializing: boolean;
     error: string | undefined;

package/dist/index.js

@@ -399,13 +399,13 @@ function useAgnoToolExecution(handlers = {}, autoExecute = true) {
     [mergedHandlers]
   );
   const continueWithResults = (0, import_react3.useCallback)(
-    async (tools) => {
+    async (tools, options) => {
       if (!isPaused) {
         throw new Error("No paused run to continue");
       }
       setIsExecuting(true);
       try {
-        await client.continueRun(tools);
+        await client.continueRun(tools, options);
       } catch (error) {
         setIsExecuting(false);
         throw error;
@@ -788,6 +788,9 @@ function useAgnoChat() {
     const handleMessageComplete = (updatedMessages) => {
       setMessages(updatedMessages);
     };
+    const handleMessageRefreshed = (updatedMessages) => {
+      setMessages(updatedMessages);
+    };
     const handleMessageError = (errorMessage) => {
       setError(errorMessage);
     };
@@ -804,6 +807,7 @@ function useAgnoChat() {
     };
     client.on("message:update", handleMessageUpdate);
     client.on("message:complete", handleMessageComplete);
+    client.on("message:refreshed", handleMessageRefreshed);
     client.on("message:error", handleMessageError);
     client.on("state:change", handleStateChange);
     client.on("ui:render", handleUIRender);
@@ -812,6 +816,7 @@ function useAgnoChat() {
     return () => {
       client.off("message:update", handleMessageUpdate);
       client.off("message:complete", handleMessageComplete);
+      client.off("message:refreshed", handleMessageRefreshed);
       client.off("message:error", handleMessageError);
       client.off("state:change", handleStateChange);
       client.off("ui:render", handleUIRender);
@@ -840,6 +845,7 @@ function useAgnoChat() {
     sendMessage,
     clearMessages,
     isStreaming: state.isStreaming,
+    isRefreshing: state.isRefreshing,
     isPaused: state.isPaused,
     error,
     state
@@ -881,11 +887,11 @@ function useAgnoSession() {
     };
   }, [client]);
   const loadSession = (0, import_react6.useCallback)(
-    async (sessionId) => {
+    async (sessionId, options) => {
       setIsLoading(true);
       setError(void 0);
       try {
-        const messages = await client.loadSession(sessionId);
+        const messages = await client.loadSession(sessionId, options);
         setCurrentSessionId(sessionId);
         return messages;
       } catch (err) {
@@ -898,11 +904,11 @@ function useAgnoSession() {
     },
     [client]
   );
-  const fetchSessions = (0, import_react6.useCallback)(async () => {
+  const fetchSessions = (0, import_react6.useCallback)(async (options) => {
     setIsLoading(true);
     setError(void 0);
     try {
-      const fetchedSessions = await client.fetchSessions();
+      const fetchedSessions = await client.fetchSessions(options);
       setSessions(fetchedSessions);
       return fetchedSessions;
     } catch (err) {
@@ -929,11 +935,11 @@ function useAgnoActions() {
   const client = useAgnoClient();
   const [isInitializing, setIsInitializing] = (0, import_react7.useState)(false);
   const [error, setError] = (0, import_react7.useState)();
-  const initialize = (0, import_react7.useCallback)(async () => {
+  const initialize = (0, import_react7.useCallback)(async (options) => {
     setIsInitializing(true);
     setError(void 0);
     try {
-      const result = await client.initialize();
+      const result = await client.initialize(options);
       return result;
     } catch (err) {
       const errorMessage = err instanceof Error ? err.message : String(err);
@@ -943,30 +949,30 @@ function useAgnoActions() {
       setIsInitializing(false);
     }
   }, [client]);
-  const checkStatus = (0, import_react7.useCallback)(async () => {
+  const checkStatus = (0, import_react7.useCallback)(async (options) => {
     setError(void 0);
     try {
-      return await client.checkStatus();
+      return await client.checkStatus(options);
     } catch (err) {
       const errorMessage = err instanceof Error ? err.message : String(err);
       setError(errorMessage);
       return false;
     }
   }, [client]);
-  const fetchAgents = (0, import_react7.useCallback)(async () => {
+  const fetchAgents = (0, import_react7.useCallback)(async (options) => {
     setError(void 0);
     try {
-      return await client.fetchAgents();
+      return await client.fetchAgents(options);
     } catch (err) {
       const errorMessage = err instanceof Error ? err.message : String(err);
       setError(errorMessage);
       throw err;
     }
   }, [client]);
-  const fetchTeams = (0, import_react7.useCallback)(async () => {
+  const fetchTeams = (0, import_react7.useCallback)(async (options) => {
     setError(void 0);
     try {
-      return await client.fetchTeams();
+      return await client.fetchTeams(options);
     } catch (err) {
       const errorMessage = err instanceof Error ? err.message : String(err);
       setError(errorMessage);

package/dist/index.mjs

@@ -334,13 +334,13 @@ function useAgnoToolExecution(handlers = {}, autoExecute = true) {
     [mergedHandlers]
   );
   const continueWithResults = useCallback2(
-    async (tools) => {
+    async (tools, options) => {
       if (!isPaused) {
         throw new Error("No paused run to continue");
       }
       setIsExecuting(true);
       try {
-        await client.continueRun(tools);
+        await client.continueRun(tools, options);
       } catch (error) {
         setIsExecuting(false);
         throw error;
@@ -723,6 +723,9 @@ function useAgnoChat() {
     const handleMessageComplete = (updatedMessages) => {
       setMessages(updatedMessages);
     };
+    const handleMessageRefreshed = (updatedMessages) => {
+      setMessages(updatedMessages);
+    };
     const handleMessageError = (errorMessage) => {
       setError(errorMessage);
     };
@@ -739,6 +742,7 @@ function useAgnoChat() {
     };
     client.on("message:update", handleMessageUpdate);
     client.on("message:complete", handleMessageComplete);
+    client.on("message:refreshed", handleMessageRefreshed);
     client.on("message:error", handleMessageError);
     client.on("state:change", handleStateChange);
     client.on("ui:render", handleUIRender);
@@ -747,6 +751,7 @@ function useAgnoChat() {
     return () => {
       client.off("message:update", handleMessageUpdate);
       client.off("message:complete", handleMessageComplete);
+      client.off("message:refreshed", handleMessageRefreshed);
       client.off("message:error", handleMessageError);
       client.off("state:change", handleStateChange);
       client.off("ui:render", handleUIRender);
@@ -775,6 +780,7 @@ function useAgnoChat() {
     sendMessage,
     clearMessages,
     isStreaming: state.isStreaming,
+    isRefreshing: state.isRefreshing,
     isPaused: state.isPaused,
     error,
     state
@@ -816,11 +822,11 @@ function useAgnoSession() {
     };
   }, [client]);
   const loadSession = useCallback4(
-    async (sessionId) => {
+    async (sessionId, options) => {
       setIsLoading(true);
       setError(void 0);
       try {
-        const messages = await client.loadSession(sessionId);
+        const messages = await client.loadSession(sessionId, options);
         setCurrentSessionId(sessionId);
         return messages;
       } catch (err) {
@@ -833,11 +839,11 @@ function useAgnoSession() {
     },
     [client]
   );
-  const fetchSessions = useCallback4(async () => {
+  const fetchSessions = useCallback4(async (options) => {
     setIsLoading(true);
     setError(void 0);
     try {
-      const fetchedSessions = await client.fetchSessions();
+      const fetchedSessions = await client.fetchSessions(options);
       setSessions(fetchedSessions);
       return fetchedSessions;
     } catch (err) {
@@ -864,11 +870,11 @@ function useAgnoActions() {
   const client = useAgnoClient();
   const [isInitializing, setIsInitializing] = useState5(false);
   const [error, setError] = useState5();
-  const initialize = useCallback5(async () => {
+  const initialize = useCallback5(async (options) => {
     setIsInitializing(true);
     setError(void 0);
     try {
-      const result = await client.initialize();
+      const result = await client.initialize(options);
       return result;
     } catch (err) {
       const errorMessage = err instanceof Error ? err.message : String(err);
@@ -878,30 +884,30 @@ function useAgnoActions() {
       setIsInitializing(false);
     }
   }, [client]);
-  const checkStatus = useCallback5(async () => {
+  const checkStatus = useCallback5(async (options) => {
     setError(void 0);
     try {
-      return await client.checkStatus();
+      return await client.checkStatus(options);
     } catch (err) {
       const errorMessage = err instanceof Error ? err.message : String(err);
       setError(errorMessage);
       return false;
     }
   }, [client]);
-  const fetchAgents = useCallback5(async () => {
+  const fetchAgents = useCallback5(async (options) => {
     setError(void 0);
     try {
-      return await client.fetchAgents();
+      return await client.fetchAgents(options);
     } catch (err) {
       const errorMessage = err instanceof Error ? err.message : String(err);
       setError(errorMessage);
       throw err;
     }
   }, [client]);
-  const fetchTeams = useCallback5(async () => {
+  const fetchTeams = useCallback5(async (options) => {
     setError(void 0);
     try {
-      return await client.fetchTeams();
+      return await client.fetchTeams(options);
     } catch (err) {
       const errorMessage = err instanceof Error ? err.message : String(err);
       setError(errorMessage);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antipopp/agno-react",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "React hooks for Agno client with frontend tool execution (HITL) support",
   "author": "antipopp",
   "license": "MIT",
@@ -34,8 +34,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@antipopp/agno-client": "0.7.0",
-    "@antipopp/agno-types": "0.7.0"
+    "@antipopp/agno-client": "0.9.0",
+    "@antipopp/agno-types": "0.9.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"