@rodrigocoliveira/agno-react 1.0.1 → 1.0.3

package/dist/hooks/useAgnoChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgnoChat.d.ts","sourceRoot":"","sources":["../../src/hooks/useAgnoChat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAG7E;;;GAGG;AACH,wBAAgB,WAAW;;2BAyEP,MAAM,GAAG,QAAQ,YAAY;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;;;;;;;;;;EAgDrH"}

package/dist/hooks/useAgnoCustomEvents.d.ts

@@ -0,0 +1,38 @@
+import type { CustomEventData } from '@rodrigocoliveira/agno-types';
+/**
+ * React hook to subscribe to custom events emitted by the agent backend (yielding CustomEventData).
+ *
+ * Custom events are emitted when agent yeilds data not directly related to tool execution or chat messages,
+ * through the CustomEvent API event type.
+ *
+ * @param handler - Optional callback invoked for each custom event
+ * @returns Object containing accumulated custom events and a clear function
+ *
+ * @example
+ * // Collect all custom events
+ * const { events } = useAgnoCustomEvents();
+ *
+ * @example
+ * // Handle events as they arrive
+ * const { events } = useAgnoCustomEvents((event) => {
+ *   if (event.greeting) {
+ *     showToast(event.greeting);
+ *   }
+ * });
+ *
+ * @example
+ * // Filter for specific event types
+ * const { events } = useAgnoCustomEvents();
+ * const greetings = events.filter(e => 'greeting' in e);
+ *
+ * @example
+ * // Clear accumulated events
+ * const { events, clearEvents } = useAgnoCustomEvents();
+ * // Later...
+ * clearEvents();
+ */
+export declare function useAgnoCustomEvents(handler?: (event: CustomEventData) => void): {
+    events: CustomEventData[];
+    clearEvents: () => void;
+};
+//# sourceMappingURL=useAgnoCustomEvents.d.ts.map

package/dist/hooks/useAgnoCustomEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgnoCustomEvents.d.ts","sourceRoot":"","sources":["../../src/hooks/useAgnoCustomEvents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GACzC;IACD,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB,CA0BA"}

package/dist/hooks/useAgnoEvals.d.ts

@@ -0,0 +1,39 @@
+import type { EvalSchema, EvalRunsListResponse, ListEvalRunsParams, ExecuteEvalRequest, UpdateEvalRunRequest } from '@rodrigocoliveira/agno-types';
+/**
+ * Hook for evaluation management
+ */
+export declare function useAgnoEvals(): {
+    evalRuns: EvalSchema[];
+    pagination: import("@rodrigocoliveira/agno-types").PaginationInfo | undefined;
+    isLoading: boolean;
+    error: string | undefined;
+    listEvalRuns: (listParams?: ListEvalRunsParams, options?: {
+        params?: Record<string, string>;
+    }) => Promise<EvalRunsListResponse>;
+    getEvalRun: (evalRunId: string, options?: {
+        dbId?: string;
+        table?: string;
+        params?: Record<string, string>;
+    }) => Promise<EvalSchema>;
+    executeEval: (request: ExecuteEvalRequest, options?: {
+        dbId?: string;
+        table?: string;
+        params?: Record<string, string>;
+    }) => Promise<EvalSchema>;
+    updateEvalRun: (evalRunId: string, request: UpdateEvalRunRequest, options?: {
+        dbId?: string;
+        table?: string;
+        params?: Record<string, string>;
+    }) => Promise<EvalSchema>;
+    deleteEvalRuns: (evalRunIds: string[], options?: {
+        dbId?: string;
+        table?: string;
+        params?: Record<string, string>;
+    }) => Promise<void>;
+    renameEvalRun: (evalRunId: string, newName: string, options?: {
+        dbId?: string;
+        table?: string;
+        params?: Record<string, string>;
+    }) => Promise<EvalSchema>;
+};
+//# sourceMappingURL=useAgnoEvals.d.ts.map

package/dist/hooks/useAgnoEvals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgnoEvals.d.ts","sourceRoot":"","sources":["../../src/hooks/useAgnoEvals.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AAGtC;;GAEG;AACH,wBAAgB,YAAY;;;;;gCAYV,kBAAkB,YACpB;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC5C,OAAO,CAAC,oBAAoB,CAAC;4BAwBnB,MAAM,YACP;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC3E,OAAO,CAAC,UAAU,CAAC;2BAqBX,kBAAkB,YACjB;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC3E,OAAO,CAAC,UAAU,CAAC;+BAwBT,MAAM,WACR,oBAAoB,YACnB;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC3E,OAAO,CAAC,UAAU,CAAC;iCA0BR,MAAM,EAAE,YACV;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC3E,OAAO,CAAC,IAAI,CAAC;+BAwBH,MAAM,WACR,MAAM,YACL;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC3E,OAAO,CAAC,UAAU,CAAC;EAqBzB"}

package/dist/hooks/useAgnoKnowledge.d.ts

@@ -0,0 +1,56 @@
+import type { KnowledgeConfigResponse, ContentResponse, ContentStatusResponse, ContentListResponse, ContentListOptions, VectorSearchRequest, VectorSearchResponse, ContentUpdateRequest } from '@rodrigocoliveira/agno-types';
+/**
+ * Hook for knowledge management
+ */
+export declare function useAgnoKnowledge(): {
+    config: KnowledgeConfigResponse | undefined;
+    content: ContentResponse[];
+    isLoading: boolean;
+    error: string | undefined;
+    getConfig: (options?: {
+        dbId?: string;
+        params?: Record<string, string>;
+    }) => Promise<KnowledgeConfigResponse>;
+    listContent: (listOptions?: ContentListOptions, options?: {
+        params?: Record<string, string>;
+    }) => Promise<ContentListResponse>;
+    getContent: (contentId: string, options?: {
+        dbId?: string;
+        params?: Record<string, string>;
+    }) => Promise<ContentResponse>;
+    getContentStatus: (contentId: string, options?: {
+        dbId?: string;
+        params?: Record<string, string>;
+    }) => Promise<ContentStatusResponse>;
+    search: (request: VectorSearchRequest, options?: {
+        params?: Record<string, string>;
+    }) => Promise<VectorSearchResponse>;
+    uploadContent: (data: FormData | {
+        name?: string;
+        description?: string;
+        url?: string;
+        metadata?: Record<string, unknown>;
+        file?: File;
+        text_content?: string;
+        reader_id?: string;
+        chunker?: string;
+        chunk_size?: number;
+        chunk_overlap?: number;
+    }, options?: {
+        dbId?: string;
+        params?: Record<string, string>;
+    }) => Promise<ContentResponse>;
+    updateContent: (contentId: string, request: ContentUpdateRequest, options?: {
+        dbId?: string;
+        params?: Record<string, string>;
+    }) => Promise<ContentResponse>;
+    deleteAllContent: (options?: {
+        dbId?: string;
+        params?: Record<string, string>;
+    }) => Promise<void>;
+    deleteContent: (contentId: string, options?: {
+        dbId?: string;
+        params?: Record<string, string>;
+    }) => Promise<ContentResponse>;
+};
+//# sourceMappingURL=useAgnoKnowledge.d.ts.map

package/dist/hooks/useAgnoKnowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgnoKnowledge.d.ts","sourceRoot":"","sources":["../../src/hooks/useAgnoKnowledge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AAGtC;;GAEG;AACH,wBAAgB,gBAAgB;;;;;0BAYhB;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC3D,OAAO,CAAC,uBAAuB,CAAC;gCAuBnB,kBAAkB,YACtB;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC5C,OAAO,CAAC,mBAAmB,CAAC;4BAuBlB,MAAM,YACP;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC3D,OAAO,CAAC,eAAe,CAAC;kCAqBd,MAAM,YACP;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC3D,OAAO,CAAC,qBAAqB,CAAC;sBAqBtB,mBAAmB,YAClB;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC5C,OAAO,CAAC,oBAAoB,CAAC;0BAsB1B,QAAQ,GACR;QACE,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,EAAE,IAAI,CAAC;QACZ,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,YACK;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC3D,OAAO,CAAC,eAAe,CAAC;+BAwBd,MAAM,WACR,oBAAoB,YACnB;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC3D,OAAO,CAAC,eAAe,CAAC;iCA4Bf;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC3D,OAAO,CAAC,IAAI,CAAC;+BAsBH,MAAM,YACP;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC3D,OAAO,CAAC,eAAe,CAAC;EAoC9B"}

package/dist/hooks/useAgnoMemory.d.ts

@@ -0,0 +1,42 @@
+import type { UserMemory, MemoriesListResponse, ListMemoriesParams, CreateMemoryRequest, UpdateMemoryRequest, UserMemoryStatsResponse, UserMemoryStatsParams } from '@rodrigocoliveira/agno-types';
+/**
+ * Hook for memory management
+ */
+export declare function useAgnoMemory(): {
+    memories: UserMemory[];
+    topics: string[];
+    isLoading: boolean;
+    error: string | undefined;
+    fetchMemories: (queryParams?: ListMemoriesParams, options?: {
+        params?: Record<string, string>;
+    }) => Promise<MemoriesListResponse>;
+    getMemoryById: (memoryId: string, options?: {
+        params?: Record<string, string>;
+        table?: string;
+    }) => Promise<UserMemory>;
+    getMemoryTopics: (options?: {
+        params?: Record<string, string>;
+        table?: string;
+    }) => Promise<string[]>;
+    getUserMemoryStats: (queryParams?: UserMemoryStatsParams, options?: {
+        params?: Record<string, string>;
+    }) => Promise<UserMemoryStatsResponse>;
+    createMemory: (request: CreateMemoryRequest, options?: {
+        params?: Record<string, string>;
+        table?: string;
+    }) => Promise<UserMemory>;
+    updateMemory: (memoryId: string, request: UpdateMemoryRequest, options?: {
+        params?: Record<string, string>;
+        table?: string;
+    }) => Promise<UserMemory>;
+    deleteMemory: (memoryId: string, options?: {
+        params?: Record<string, string>;
+        table?: string;
+    }) => Promise<void>;
+    deleteMultipleMemories: (memoryIds: string[], options?: {
+        params?: Record<string, string>;
+        table?: string;
+        userId?: string;
+    }) => Promise<void>;
+};
+//# sourceMappingURL=useAgnoMemory.d.ts.map

package/dist/hooks/useAgnoMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgnoMemory.d.ts","sourceRoot":"","sources":["../../src/hooks/useAgnoMemory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,8BAA8B,CAAC;AAGtC;;GAEG;AACH,wBAAgB,aAAa;;;;;kCA2DT,kBAAkB,YACtB;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC5C,OAAO,CAAC,oBAAoB,CAAC;8BAuBpB,MAAM,YACN;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAC5D,OAAO,CAAC,UAAU,CAAC;gCAqBV;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAC5D,OAAO,CAAC,MAAM,EAAE,CAAC;uCAuBJ,qBAAqB,YACzB;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC5C,OAAO,CAAC,uBAAuB,CAAC;4BAqBxB,mBAAmB,YAClB;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAC5D,OAAO,CAAC,UAAU,CAAC;6BAqBV,MAAM,WACP,mBAAmB,YAClB;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAC5D,OAAO,CAAC,UAAU,CAAC;6BAqBV,MAAM,YACN;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAC5D,OAAO,CAAC,IAAI,CAAC;wCAqBH,MAAM,EAAE,YACT;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAC7E,OAAO,CAAC,IAAI,CAAC;EA8BnB"}

package/dist/hooks/useAgnoMetrics.d.ts

@@ -0,0 +1,51 @@
+import type { MetricsResponse, DayAggregatedMetrics, MetricsOptions, RefreshMetricsOptions } from '@rodrigocoliveira/agno-types';
+/**
+ * Hook for metrics management
+ *
+ * Provides methods to fetch and refresh AgentOS metrics.
+ *
+ * @example
+ * ```tsx
+ * function MetricsDashboard() {
+ *   const {
+ *     metrics,
+ *     fetchMetrics,
+ *     refreshMetrics,
+ *     isLoading,
+ *     isRefreshing,
+ *     error,
+ *   } = useAgnoMetrics();
+ *
+ *   useEffect(() => {
+ *     fetchMetrics({
+ *       startingDate: '2024-01-01',
+ *       endingDate: '2024-01-31',
+ *     });
+ *   }, [fetchMetrics]);
+ *
+ *   if (isLoading) return <div>Loading metrics...</div>;
+ *   if (error) return <div>Error: {error}</div>;
+ *
+ *   return (
+ *     <div>
+ *       {metrics?.metrics.map((day) => (
+ *         <div key={day.id}>
+ *           <h3>{day.date}</h3>
+ *           <p>Agent Runs: {day.agent_runs_count}</p>
+ *         </div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useAgnoMetrics(): {
+    metrics: MetricsResponse | undefined;
+    fetchMetrics: (options?: MetricsOptions) => Promise<MetricsResponse>;
+    refreshMetrics: (options?: RefreshMetricsOptions) => Promise<DayAggregatedMetrics[]>;
+    clearMetrics: () => void;
+    isLoading: boolean;
+    isRefreshing: boolean;
+    error: string | undefined;
+};
+//# sourceMappingURL=useAgnoMetrics.d.ts.map

package/dist/hooks/useAgnoMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgnoMetrics.d.ts","sourceRoot":"","sources":["../../src/hooks/useAgnoMetrics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACtB,MAAM,8BAA8B,CAAC;AAGtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,cAAc;;6BAcT,cAAc,KAAG,OAAO,CAAC,eAAe,CAAC;+BAyBzC,qBAAqB,KAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;;;;;EAuC3E"}

package/dist/hooks/useAgnoSession.d.ts

@@ -0,0 +1,38 @@
+import type { SessionEntry, ChatMessage, AgentSessionDetailSchema, TeamSessionDetailSchema, RunSchema, TeamRunSchema, CreateSessionRequest, UpdateSessionRequest } from '@rodrigocoliveira/agno-types';
+/**
+ * Hook for session management
+ */
+export declare function useAgnoSession(): {
+    sessions: SessionEntry[];
+    currentSessionId: string | undefined;
+    loadSession: (sessionId: string, options?: {
+        params?: Record<string, string>;
+    }) => Promise<ChatMessage[]>;
+    fetchSessions: (options?: {
+        params?: Record<string, string>;
+    }) => Promise<SessionEntry[]>;
+    getSessionById: (sessionId: string, options?: {
+        params?: Record<string, string>;
+    }) => Promise<AgentSessionDetailSchema | TeamSessionDetailSchema>;
+    getRunById: (sessionId: string, runId: string, options?: {
+        params?: Record<string, string>;
+    }) => Promise<RunSchema | TeamRunSchema>;
+    createSession: (request?: CreateSessionRequest, options?: {
+        params?: Record<string, string>;
+    }) => Promise<AgentSessionDetailSchema | TeamSessionDetailSchema>;
+    updateSession: (sessionId: string, request: UpdateSessionRequest, options?: {
+        params?: Record<string, string>;
+    }) => Promise<AgentSessionDetailSchema | TeamSessionDetailSchema>;
+    renameSession: (sessionId: string, newName: string, options?: {
+        params?: Record<string, string>;
+    }) => Promise<AgentSessionDetailSchema | TeamSessionDetailSchema>;
+    deleteSession: (sessionId: string, options?: {
+        params?: Record<string, string>;
+    }) => Promise<void>;
+    deleteMultipleSessions: (sessionIds: string[], options?: {
+        params?: Record<string, string>;
+    }) => Promise<void>;
+    isLoading: boolean;
+    error: string | undefined;
+};
+//# sourceMappingURL=useAgnoSession.d.ts.map

package/dist/hooks/useAgnoSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgnoSession.d.ts","sourceRoot":"","sources":["../../src/hooks/useAgnoSession.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,wBAAwB,EACxB,uBAAuB,EACvB,SAAS,EACT,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AAGtC;;GAEG;AACH,wBAAgB,cAAc;;;6BA6CR,MAAM,YAAY;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAAG,OAAO,CAAC,WAAW,EAAE,CAAC;8BAqB/C;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAAG,OAAO,CAAC,YAAY,EAAE,CAAC;gCAqBjG,MAAM,YACP;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC5C,OAAO,CAAC,wBAAwB,GAAG,uBAAuB,CAAC;4BAqBjD,MAAM,SACV,MAAM,YACH;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC5C,OAAO,CAAC,SAAS,GAAG,aAAa,CAAC;8BAqBzB,oBAAoB,YACpB;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC5C,OAAO,CAAC,wBAAwB,GAAG,uBAAuB,CAAC;+BAsBjD,MAAM,WACR,oBAAoB,YACnB;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC5C,OAAO,CAAC,wBAAwB,GAAG,uBAAuB,CAAC;+BAqBjD,MAAM,WACR,MAAM,YACL;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC5C,OAAO,CAAC,wBAAwB,GAAG,uBAAuB,CAAC;+BAqBjD,MAAM,YACP;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC5C,OAAO,CAAC,IAAI,CAAC;yCAqBF,MAAM,EAAE,YACV;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC5C,OAAO,CAAC,IAAI,CAAC;;;EA+BnB"}

package/dist/hooks/useAgnoToolExecution.d.ts

@@ -0,0 +1,70 @@
+import type { ToolCall, CustomRenderFunction } from '@rodrigocoliveira/agno-types';
+/**
+ * Tool handler function type (now supports generative UI)
+ */
+export type ToolHandler = (args: Record<string, any>) => Promise<any>;
+/**
+ * Get a custom render function by key
+ */
+export declare function getCustomRender(key: string): CustomRenderFunction | undefined;
+/**
+ * Process tool handler result and extract data/UI
+ * Exported for use in session loading UI hydration
+ */
+export declare function processToolResult(result: any, _tool: ToolCall): {
+    resultData: string;
+    uiComponent?: any;
+};
+/**
+ * Tool execution event payload
+ */
+export interface ToolExecutionEvent {
+    runId?: string;
+    sessionId?: string;
+    tools: ToolCall[];
+}
+/**
+ * Hook for handling frontend tool execution (HITL)
+ *
+ * **Note:** HITL (Human-in-the-Loop) frontend tool execution is only supported for agents.
+ * Teams do not support the continue endpoint. This hook will log a warning and no-op if used with team mode.
+ *
+ * @param handlers - Map of tool names to handler functions (local handlers)
+ * @param autoExecute - Whether to automatically execute tools when paused (default: true)
+ *
+ * @example
+ * ```tsx
+ * const toolHandlers = {
+ *   navigate_to_page: async (args) => {
+ *     window.location.href = args.url;
+ *     return { success: true };
+ *   },
+ *   fill_form: async (args) => {
+ *     document.querySelector(args.selector).value = args.value;
+ *     return { filled: true };
+ *   }
+ * };
+ *
+ * const { isPaused, isExecuting, pendingTools } = useAgnoToolExecution(toolHandlers);
+ * ```
+ */
+export declare function useAgnoToolExecution(handlers?: Record<string, ToolHandler>, autoExecute?: boolean): {
+    /** Whether the run is currently paused awaiting tool execution */
+    isPaused: boolean;
+    /** Whether tools are currently being executed */
+    isExecuting: boolean;
+    /** Tools awaiting execution */
+    pendingTools: ToolCall[];
+    /** Execute all pending tools and continue the run */
+    executeAndContinue: () => Promise<void>;
+    /** Execute specific tools and return results without continuing */
+    executeTools: (tools: ToolCall[]) => Promise<ToolCall[]>;
+    /** Continue the run with manually provided tool results */
+    continueWithResults: (tools: ToolCall[], options?: {
+        headers?: Record<string, string>;
+        params?: Record<string, string>;
+    }) => Promise<void>;
+    /** Error from tool execution, if any */
+    executionError: string | undefined;
+};
+//# sourceMappingURL=useAgnoToolExecution.d.ts.map

package/dist/hooks/useAgnoToolExecution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgnoToolExecution.d.ts","sourceRoot":"","sources":["../../src/hooks/useAgnoToolExecution.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EAGR,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AAItC;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAiBtE;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAE7E;AAgBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,GAAG;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB,CAoDA;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAM,EAC1C,WAAW,GAAE,OAAc;IAwOzB,kEAAkE;;IAElE,iDAAiD;;IAEjD,+BAA+B;;IAE/B,qDAAqD;;IAErD,mEAAmE;0BAlErD,QAAQ,EAAE,KAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAoE9C,2DAA2D;iCAjC7C,QAAQ,EAAE,YAAY;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;IAmCzG,wCAAwC;;EAG3C"}

package/dist/hooks/useAgnoTraces.d.ts

@@ -0,0 +1,51 @@
+import type { TraceSummary, TraceDetail, TraceNode, TraceSessionStats, ListTracesOptions, GetTraceOptions, GetTraceSessionStatsOptions } from '@rodrigocoliveira/agno-types';
+import type { PaginatedTracesResult, PaginatedTraceSessionStatsResult } from '@rodrigocoliveira/agno-client';
+export type { PaginatedTracesResult, PaginatedTraceSessionStatsResult };
+/**
+ * Hook for traces management
+ *
+ * Provides methods to:
+ * - List traces with filters (fetchTraces)
+ * - Get trace detail or specific span (getTraceDetail)
+ * - Get trace session statistics (fetchTraceSessionStats)
+ *
+ * @example
+ * ```tsx
+ * const { traces, fetchTraces, isLoading, error } = useAgnoTraces();
+ *
+ * // Fetch traces for a specific session
+ * useEffect(() => {
+ *   fetchTraces({ session_id: 'my-session-id' });
+ * }, []);
+ *
+ * // Fetch traces with pagination
+ * const result = await fetchTraces({ page: 1, limit: 10 });
+ * console.log(result.pagination.total_count);
+ * ```
+ */
+export declare function useAgnoTraces(): {
+    /** Current list of traces (from last fetchTraces call) */
+    traces: TraceSummary[];
+    /** Current trace session statistics (from last fetchTraceSessionStats call) */
+    traceSessionStats: TraceSessionStats[];
+    /** Fetch traces with optional filters and pagination */
+    fetchTraces: (options?: ListTracesOptions, requestOptions?: {
+        headers?: Record<string, string>;
+        params?: Record<string, string>;
+    }) => Promise<PaginatedTracesResult>;
+    /** Get trace detail or specific span */
+    getTraceDetail: (traceId: string, options?: GetTraceOptions, requestOptions?: {
+        headers?: Record<string, string>;
+        params?: Record<string, string>;
+    }) => Promise<TraceDetail | TraceNode>;
+    /** Fetch trace session statistics */
+    fetchTraceSessionStats: (options?: GetTraceSessionStatsOptions, requestOptions?: {
+        headers?: Record<string, string>;
+        params?: Record<string, string>;
+    }) => Promise<PaginatedTraceSessionStatsResult>;
+    /** Loading state */
+    isLoading: boolean;
+    /** Error message if last operation failed */
+    error: string | undefined;
+};
+//# sourceMappingURL=useAgnoTraces.d.ts.map

package/dist/hooks/useAgnoTraces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgnoTraces.d.ts","sourceRoot":"","sources":["../../src/hooks/useAgnoTraces.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,2BAA2B,EAC5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,qBAAqB,EACrB,gCAAgC,EACjC,MAAM,+BAA+B,CAAC;AAIvC,YAAY,EAAE,qBAAqB,EAAE,gCAAgC,EAAE,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa;IAmHzB,0DAA0D;;IAE1D,+EAA+E;;IAE/E,wDAAwD;4BAnF7C,iBAAiB,mBACT;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KACrF,OAAO,CAAC,qBAAqB,CAAC;IAmFjC,wCAAwC;8BAvD7B,MAAM,YACN,eAAe,mBACP;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KACrF,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAsDnC,qCAAqC;uCA7B1B,2BAA2B,mBACnB;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KACrF,OAAO,CAAC,gCAAgC,CAAC;IA6B5C,oBAAoB;;IAEpB,6CAA6C;;EAGhD"}