@rodrigocoliveira/agno-react 1.0.2 → 1.1.0

package/README.md

@@ -655,10 +655,10 @@ To publish this package to npm:
 npm login
 
 # Build the package
-pnpm build
+bun run build
 
 # Publish (use --access public for scoped packages)
-pnpm publish --access public
+npm publish --access public
 ```
 
 **Publish order:** This package depends on both `@rodrigocoliveira/agno-types` and `@rodrigocoliveira/agno-client`, so publish them first:

package/dist/components/GenerativeUIRenderer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Generative UI Renderer
+ *
+ * Renders UI components based on specifications from the agent.
+ * Supports both registry-based components and custom render functions.
+ */
+import React from 'react';
+import type { UIComponentSpec } from '@rodrigocoliveira/agno-types';
+export interface GenerativeUIRendererProps {
+    /** The UI component specification to render */
+    spec: UIComponentSpec;
+    /** Optional className for styling */
+    className?: string;
+    /** Error boundary fallback */
+    onError?: (error: Error) => void;
+}
+/**
+ * Main Generative UI Renderer component
+ */
+export declare function GenerativeUIRenderer({ spec, className, onError, }: GenerativeUIRendererProps): React.ReactElement;
+//# sourceMappingURL=GenerativeUIRenderer.d.ts.map

package/dist/components/GenerativeUIRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GenerativeUIRenderer.d.ts","sourceRoot":"","sources":["../../src/components/GenerativeUIRenderer.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAIpE,MAAM,WAAW,yBAAyB;IACxC,+CAA+C;IAC/C,IAAI,EAAE,eAAe,CAAC;IACtB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAuCD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,IAAI,EACJ,SAAS,EACT,OAAO,GACR,EAAE,yBAAyB,GAAG,KAAK,CAAC,YAAY,CAmIhD"}

package/dist/context/AgnoContext.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import { AgnoClient } from '@rodrigocoliveira/agno-client';
+import type { AgnoClientConfig } from '@rodrigocoliveira/agno-types';
+export interface AgnoProviderProps {
+    config: AgnoClientConfig;
+    children: React.ReactNode;
+}
+/**
+ * Provider component that creates and manages an AgnoClient instance
+ */
+export declare function AgnoProvider({ config, children }: AgnoProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access the AgnoClient instance
+ */
+export declare function useAgnoClient(): AgnoClient;
+//# sourceMappingURL=AgnoContext.d.ts.map

package/dist/context/AgnoContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgnoContext.d.ts","sourceRoot":"","sources":["../../src/context/AgnoContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwD,MAAM,OAAO,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAOrE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,iBAAiB,2CAuBnE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAQ1C"}

package/dist/context/ToolHandlerContext.d.ts

@@ -0,0 +1,44 @@
+import React from 'react';
+import type { ToolHandler } from '../hooks/useAgnoToolExecution';
+/**
+ * Context value for tool handler registry
+ */
+export interface ToolHandlerContextValue {
+    handlers: Record<string, ToolHandler>;
+    registerHandler: (name: string, handler: ToolHandler) => void;
+    unregisterHandler: (name: string) => void;
+}
+export interface ToolHandlerProviderProps {
+    handlers?: Record<string, ToolHandler>;
+    children: React.ReactNode;
+}
+/**
+ * Provider component that manages global tool handlers
+ *
+ * @example
+ * ```tsx
+ * const globalHandlers = {
+ *   fill_form: async (args) => {
+ *     // Implementation
+ *     return { success: true };
+ *   }
+ * };
+ *
+ * <ToolHandlerProvider handlers={globalHandlers}>
+ *   <App />
+ * </ToolHandlerProvider>
+ * ```
+ */
+export declare function ToolHandlerProvider({ handlers: initialHandlers, children }: ToolHandlerProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access global tool handlers
+ *
+ * @returns Tool handler context value or null if not within ToolHandlerProvider
+ *
+ * @example
+ * ```tsx
+ * const { handlers, registerHandler } = useToolHandlers() || { handlers: {} };
+ * ```
+ */
+export declare function useToolHandlers(): ToolHandlerContextValue | null;
+//# sourceMappingURL=ToolHandlerContext.d.ts.map

package/dist/context/ToolHandlerContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolHandlerContext.d.ts","sourceRoot":"","sources":["../../src/context/ToolHandlerContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2D,MAAM,OAAO,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAC9D,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAOD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,eAAoB,EAAE,QAAQ,EAAE,EAAE,wBAAwB,2CA+BzG;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,IAAI,uBAAuB,GAAG,IAAI,CAEhE"}

package/dist/hooks/useAgnoActions.d.ts

@@ -0,0 +1,25 @@
+import type { AgentDetails, TeamDetails } from '@rodrigocoliveira/agno-types';
+/**
+ * Hook for common actions like initialization, fetching agents/teams
+ */
+export declare function useAgnoActions(): {
+    initialize: (options?: {
+        params?: Record<string, string>;
+    }) => Promise<{
+        agents: AgentDetails[];
+        teams: 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<import("@rodrigocoliveira/agno-types").AgnoClientConfig>) => void>[0]>) => void;
+    isInitializing: boolean;
+    error: string | undefined;
+};
+//# sourceMappingURL=useAgnoActions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAgnoActions.d.ts","sourceRoot":"","sources":["../../src/hooks/useAgnoActions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAG9E;;GAEG;AACH,wBAAgB,cAAc;2BAQoB;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAAG,OAAO,CAAC;QAC5F,MAAM,EAAE,YAAY,EAAE,CAAC;QACvB,KAAK,EAAE,WAAW,EAAE,CAAC;KACtB,CAAC;4BAkB+C;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAAG,OAAO,CAAC,OAAO,CAAC;4BActD;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAAG,OAAO,CAAC,YAAY,EAAE,CAAC;2BAc9D;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAAG,OAAO,CAAC,WAAW,EAAE,CAAC;4BAehG,OAAO,CAAC,UAAU,qFAA4B,CAAC,CAAC,CAAC,CAAC;;;EAe/D"}

package/dist/hooks/useAgnoChat.d.ts

@@ -0,0 +1,22 @@
+import type { ChatMessage, ClientState } from '@rodrigocoliveira/agno-types';
+/**
+ * Main hook for chat interactions
+ * Provides messages, state, and methods to interact with the agent
+ */
+export declare function useAgnoChat(): {
+    messages: ChatMessage[];
+    sendMessage: (message: string | FormData, options?: {
+        headers?: Record<string, string>;
+        params?: Record<string, string>;
+    }) => Promise<void>;
+    clearMessages: () => void;
+    cancelRun: () => Promise<void>;
+    isStreaming: boolean;
+    isRefreshing: boolean;
+    isPaused: boolean;
+    isCancelling: boolean | undefined;
+    currentRunId: string | undefined;
+    error: string | undefined;
+    state: ClientState;
+};
+//# sourceMappingURL=useAgnoChat.d.ts.map

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;;2BAkEP,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;;;;;;;;;;EAsCrH"}

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"}