@antipopp/agno-react 0.10.0 → 0.12.0

package/README.md

@@ -38,6 +38,10 @@ function App() {
         },
         params: {           // Optional: Global query params for all requests
           locale: 'en-US'
+        },
+        dependencies: {     // Optional: Global run dependencies for sendMessage
+          tenantId: 'tenant-1',
+          locale: 'en-US'
         }
       }}
     >
@@ -133,9 +137,14 @@ await sendMessage('Hello!');
 // Send with FormData (for file uploads)
 const formData = new FormData();
 formData.append('message', 'Hello!');
-formData.append('file', file);
+formData.append('files', file);
 await sendMessage(formData);
 
+// Send with files option
+await sendMessage('Hello!', {
+  files: [file]
+});
+
 // Send with custom headers
 await sendMessage('Hello!', {
   headers: { 'X-Custom': 'value' }
@@ -151,6 +160,14 @@ await sendMessage('Hello!', {
   headers: { 'X-Request-ID': '12345' },
   params: { debug: 'true' }
 });
+
+// Send with per-request dependencies (merged with/override provider config)
+await sendMessage('Hello!', {
+  dependencies: {
+    locale: 'fr-FR', // overrides global dependency
+    feature: 'rag'   // merged as a new dependency key
+  }
+});
 ```
 
 #### `clearMessages()`
@@ -257,6 +274,51 @@ function InitComponent() {
 }
 ```
 
+### useAgnoToolExecution()
+
+Hook for Human-in-the-Loop (HITL) frontend tool execution.
+
+```tsx
+import {
+  createToolArgsValidatorFromSafeParse,
+  createValidatedToolHandler,
+  type ToolHandler,
+  useAgnoToolExecution,
+} from '@antipopp/agno-react';
+import { z } from 'zod';
+
+const navigateSchema = z.object({
+  url: z.string().url(),
+});
+
+const navigateValidator = createToolArgsValidatorFromSafeParse((args) =>
+  navigateSchema.safeParse(args)
+);
+
+const toolHandlers: Record<string, ToolHandler> = {
+  navigate_to_page: createValidatedToolHandler(navigateValidator, (args) => {
+    window.location.href = args.url;
+    return { success: true, url: args.url };
+  }),
+};
+
+function ChatWithTools() {
+  const { isPaused, isExecuting, pendingTools, executionError } =
+    useAgnoToolExecution(toolHandlers, true);
+
+  return <div>{isExecuting ? `Executing ${pendingTools.length} tools...` : null}</div>;
+}
+```
+
+Scope of this hook:
+- Listens to paused run events and tracks execution state for your UI
+- Executes local/global tool handlers and continues paused runs
+- Supports auto execution or manual approval flows
+- Hydrates tool-call UI components when sessions are loaded
+
+Validation note:
+- Tool arguments are runtime input. Prefer `createValidatedToolHandler()` with schema validation to avoid repeating manual guards.
+
 ## Complete Example
 
 ```tsx

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as _antipopp_agno_types from '@antipopp/agno-types';
 import { UIComponentSpec, AgnoClientConfig, ToolCall, CustomRenderFunction, AgentDetails, TeamDetails, ChatMessage, ClientState, SessionEntry, ChartComponentSpec, ArtifactComponentSpec, CardData, CardGridComponentSpec, TableColumn, MarkdownComponentSpec, TableComponentSpec, ToolHandlerResult } from '@antipopp/agno-types';
 export { AgentDetails, AgnoClientConfig, ArtifactComponentSpec, CardData, CardGridComponentSpec, ChartComponentSpec, ChartSeries, ChatMessage, ClientState, CustomComponentSpec, GenerativeUIData, MarkdownComponentSpec, RunEvent, SessionEntry, TableColumn, TableComponentSpec, TeamDetails, ToolCall, ToolHandlerResult, UIComponentSpec } from '@antipopp/agno-types';
-import React from 'react';
+import React, { ReactNode } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { AgnoClient } from '@antipopp/agno-client';
 
@@ -41,8 +41,14 @@ declare function useAgnoClient(): AgnoClient;
 
 /**
  * Tool handler function type (now supports generative UI)
+ * - Receives normalized object arguments
+ * - Can return sync or async values
  */
-type ToolHandler = (args: Record<string, any>) => Promise<any>;
+type MaybePromise$1<T> = T | Promise<T>;
+type ToolHandler<TArgs extends ToolCall["tool_args"] = ToolCall["tool_args"], TResult = unknown> = {
+    bivarianceHack(args: TArgs): MaybePromise$1<TResult>;
+}["bivarianceHack"];
+type ToolHandlers = Record<string, ToolHandler>;
 /**
  * Get a custom render function by key
  */
@@ -85,7 +91,7 @@ interface ToolExecutionEvent {
  * const { isPaused, isExecuting, pendingTools } = useAgnoToolExecution(toolHandlers);
  * ```
  */
-declare function useAgnoToolExecution(handlers?: Record<string, ToolHandler>, autoExecute?: boolean): {
+declare function useAgnoToolExecution(handlers?: ToolHandlers, autoExecute?: boolean): {
     /** Whether the run is currently paused awaiting tool execution */
     isPaused: boolean;
     /** Whether tools are currently being executed */
@@ -109,12 +115,12 @@ declare function useAgnoToolExecution(handlers?: Record<string, ToolHandler>, au
  * Context value for tool handler registry
  */
 interface ToolHandlerContextValue {
-    handlers: Record<string, ToolHandler>;
+    handlers: ToolHandlers;
     registerHandler: (name: string, handler: ToolHandler) => void;
     unregisterHandler: (name: string) => void;
 }
 interface ToolHandlerProviderProps {
-    handlers?: Record<string, ToolHandler>;
+    handlers?: ToolHandlers;
     children: React.ReactNode;
 }
 /**
@@ -177,10 +183,7 @@ declare function useAgnoActions(): {
  */
 declare function useAgnoChat(): {
     messages: ChatMessage[];
-    sendMessage: (message: string | FormData, options?: {
-        headers?: Record<string, string>;
-        params?: Record<string, string>;
-    }) => Promise<void>;
+    sendMessage: (message: string | FormData, options?: Parameters<(message: string | FormData, options?: _antipopp_agno_types.SendMessageOptions) => Promise<void>>[1]) => Promise<void>;
     clearMessages: () => void;
     cancelRun: () => Promise<void>;
     isStreaming: boolean;
@@ -214,10 +217,11 @@ declare function useAgnoSession(): {
  * Maps component specifications to actual React components.
  * Allows registering custom components at runtime.
  */
+
 /**
  * Component renderer function type
  */
-type ComponentRenderer = (props: any) => any;
+type ComponentRenderer = (props: Record<string, unknown>) => ReactNode;
 /**
  * Component registry class
  */
@@ -277,6 +281,49 @@ declare function registerChartComponent(name: string, renderer: ComponentRendere
  */
 declare function getChartComponent(name: string): ComponentRenderer | undefined;
 
+type MaybePromise<T> = T | Promise<T>;
+interface ToolArgsValidationSuccess<TArgs> {
+    success: true;
+    data: TArgs;
+}
+interface ToolArgsValidationFailure<TIssues = unknown> {
+    success: false;
+    message?: string;
+    issues?: TIssues;
+}
+type ToolArgsValidationResult<TArgs, TIssues = unknown> = ToolArgsValidationSuccess<TArgs> | ToolArgsValidationFailure<TIssues>;
+type ToolArgsValidator<TArgs, TIssues = unknown> = (args: Record<string, unknown>) => MaybePromise<ToolArgsValidationResult<TArgs, TIssues>>;
+interface ToolValidationError<TIssues = unknown> {
+    success: false;
+    code: "INVALID_TOOL_ARGS";
+    error: string;
+    issues?: TIssues;
+}
+interface CreateValidatedToolHandlerOptions<TIssues = unknown, TValidationError = ToolValidationError<TIssues>> {
+    errorMessage?: string;
+    mapValidationError?: (failure: ToolArgsValidationFailure<TIssues>, args: Record<string, unknown>) => TValidationError;
+}
+type SafeParseResult<TArgs, TIssues = unknown> = {
+    success: true;
+    data: TArgs;
+} | {
+    success: false;
+    error: TIssues;
+};
+interface CreateValidatorFromSafeParseOptions<TIssues = unknown> {
+    getErrorMessage?: (issues: TIssues) => string;
+}
+/**
+ * Create a ToolArgsValidator from libraries that expose safeParse-like APIs.
+ *
+ * This is validator-agnostic and works with Zod, Valibot, ArkType adapters, etc.
+ */
+declare function createToolArgsValidatorFromSafeParse<TArgs, TIssues = unknown>(safeParse: (args: Record<string, unknown>) => MaybePromise<SafeParseResult<TArgs, TIssues>>, options?: CreateValidatorFromSafeParseOptions<TIssues>): ToolArgsValidator<TArgs, TIssues>;
+/**
+ * Wrap a tool handler with runtime argument validation.
+ */
+declare function createValidatedToolHandler<TArgs, TResult = unknown, TIssues = unknown, TValidationError = ToolValidationError<TIssues>>(validator: ToolArgsValidator<TArgs, TIssues>, handler: (args: TArgs) => MaybePromise<TResult>, options?: CreateValidatedToolHandlerOptions<TIssues, TValidationError>): ToolHandler<Record<string, unknown>, TResult | TValidationError | ToolValidationError<TIssues>>;
+
 /**
  * Helper utilities for creating UI component specifications
  *
@@ -284,6 +331,12 @@ declare function getChartComponent(name: string): ComponentRenderer | undefined;
  * manually constructing the full specification object.
  */
 
+type DataRow = Record<string, unknown>;
+type SeriesInput = Array<{
+    key: string;
+    label?: string;
+    color?: string;
+}>;
 /**
  * Chart helper options
  */
@@ -306,33 +359,21 @@ interface ChartHelperOptions {
 /**
  * Create a bar chart specification
  */
-declare function createBarChart(data: any[], xKey: string, bars: Array<{
-    key: string;
-    label?: string;
-    color?: string;
-}>, options?: ChartHelperOptions): ChartComponentSpec;
+declare function createBarChart(data: DataRow[], xKey: string, bars: SeriesInput, options?: ChartHelperOptions): ChartComponentSpec;
 /**
  * Create a line chart specification
  */
-declare function createLineChart(data: any[], xKey: string, lines: Array<{
-    key: string;
-    label?: string;
-    color?: string;
-}>, options?: ChartHelperOptions): ChartComponentSpec;
+declare function createLineChart(data: DataRow[], xKey: string, lines: SeriesInput, options?: ChartHelperOptions): ChartComponentSpec;
 /**
  * Create a pie chart specification
  */
-declare function createPieChart(data: any[], dataKey: string, nameKey: string, options?: ChartHelperOptions & {
+declare function createPieChart(data: DataRow[], dataKey: string, nameKey: string, options?: ChartHelperOptions & {
     showLabel?: boolean;
 }): ChartComponentSpec;
 /**
  * Create an area chart specification
  */
-declare function createAreaChart(data: any[], xKey: string, areas: Array<{
-    key: string;
-    label?: string;
-    color?: string;
-}>, options?: ChartHelperOptions): ChartComponentSpec;
+declare function createAreaChart(data: DataRow[], xKey: string, areas: SeriesInput, options?: ChartHelperOptions): ChartComponentSpec;
 /**
  * Card grid helper options
  */
@@ -358,7 +399,7 @@ declare function createCardGrid(cards: CardData[], options?: CardGridHelperOptio
  */
 declare function createCard(id: string, title: string, description?: string, options?: {
     image?: string;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
     actions?: CardData["actions"];
 }): CardData;
 /**
@@ -379,7 +420,7 @@ interface TableHelperOptions {
 /**
  * Create a table specification
  */
-declare function createTable(data: Record<string, any>[], columns: TableColumn[], options?: TableHelperOptions): TableComponentSpec;
+declare function createTable(data: DataRow[], columns: TableColumn[], options?: TableHelperOptions): TableComponentSpec;
 /**
  * Create a table column definition
  */
@@ -409,7 +450,7 @@ declare function createArtifact(content: UIComponentSpec[], options?: {
 /**
  * Smart chart creator - automatically chooses the best chart type based on data
  */
-declare function createSmartChart(data: any[], options?: {
+declare function createSmartChart(data: DataRow[], options?: {
     title?: string;
     description?: string;
     layout?: "inline" | "artifact";
@@ -420,19 +461,15 @@ declare function createSmartChart(data: any[], options?: {
 /**
  * Wrap data and UI into a ToolHandlerResult
  */
-declare function createToolResult(data: any, ui: UIComponentSpec): ToolHandlerResult;
+declare function createToolResult(data: unknown, ui: UIComponentSpec): ToolHandlerResult;
 /**
  * Quick helper: create a tool result with a bar chart
  */
-declare function resultWithBarChart(data: any[], xKey: string, bars: Array<{
-    key: string;
-    label?: string;
-    color?: string;
-}>, options?: ChartHelperOptions): ToolHandlerResult;
+declare function resultWithBarChart(data: DataRow[], xKey: string, bars: SeriesInput, options?: ChartHelperOptions): ToolHandlerResult;
 /**
  * Quick helper: create a tool result with a smart chart
  */
-declare function resultWithSmartChart(data: any[], options?: Parameters<typeof createSmartChart>[1]): ToolHandlerResult;
+declare function resultWithSmartChart(data: DataRow[], options?: Parameters<typeof createSmartChart>[1]): ToolHandlerResult;
 /**
  * Quick helper: create a tool result with a card grid
  */
@@ -440,6 +477,6 @@ declare function resultWithCardGrid(cards: CardData[], options?: CardGridHelperO
 /**
  * Quick helper: create a tool result with a table
  */
-declare function resultWithTable(data: Record<string, any>[], columns: TableColumn[], options?: TableHelperOptions): ToolHandlerResult;
+declare function resultWithTable(data: DataRow[], columns: TableColumn[], options?: TableHelperOptions): ToolHandlerResult;
 
-export { AgnoProvider, type AgnoProviderProps, type CardGridHelperOptions, type ChartHelperOptions, ComponentRegistry, type ComponentRenderer, GenerativeUIRenderer, type GenerativeUIRendererProps, type TableHelperOptions, type ToolExecutionEvent, type ToolHandler, type ToolHandlerContextValue, ToolHandlerProvider, type ToolHandlerProviderProps, clearCustomRenderRegistry, createAreaChart, createArtifact, createBarChart, createCard, createCardGrid, createColumn, createLineChart, createMarkdown, createPieChart, createSmartChart, createTable, createToolResult, getChartComponent, getComponentRegistry, getCustomRender, registerChartComponent, resultWithBarChart, resultWithCardGrid, resultWithSmartChart, resultWithTable, useAgnoActions, useAgnoChat, useAgnoClient, useAgnoSession, useAgnoToolExecution, useToolHandlers };
+export { AgnoProvider, type AgnoProviderProps, type CardGridHelperOptions, type ChartHelperOptions, ComponentRegistry, type ComponentRenderer, type CreateValidatedToolHandlerOptions, type CreateValidatorFromSafeParseOptions, GenerativeUIRenderer, type GenerativeUIRendererProps, type SafeParseResult, type TableHelperOptions, type ToolArgsValidationFailure, type ToolArgsValidationResult, type ToolArgsValidationSuccess, type ToolArgsValidator, type ToolExecutionEvent, type ToolHandler, type ToolHandlerContextValue, ToolHandlerProvider, type ToolHandlerProviderProps, type ToolHandlers, type ToolValidationError, clearCustomRenderRegistry, createAreaChart, createArtifact, createBarChart, createCard, createCardGrid, createColumn, createLineChart, createMarkdown, createPieChart, createSmartChart, createTable, createToolArgsValidatorFromSafeParse, createToolResult, createValidatedToolHandler, getChartComponent, getComponentRegistry, getCustomRender, registerChartComponent, resultWithBarChart, resultWithCardGrid, resultWithSmartChart, resultWithTable, useAgnoActions, useAgnoChat, useAgnoClient, useAgnoSession, useAgnoToolExecution, useToolHandlers };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as _antipopp_agno_types from '@antipopp/agno-types';
 import { UIComponentSpec, AgnoClientConfig, ToolCall, CustomRenderFunction, AgentDetails, TeamDetails, ChatMessage, ClientState, SessionEntry, ChartComponentSpec, ArtifactComponentSpec, CardData, CardGridComponentSpec, TableColumn, MarkdownComponentSpec, TableComponentSpec, ToolHandlerResult } from '@antipopp/agno-types';
 export { AgentDetails, AgnoClientConfig, ArtifactComponentSpec, CardData, CardGridComponentSpec, ChartComponentSpec, ChartSeries, ChatMessage, ClientState, CustomComponentSpec, GenerativeUIData, MarkdownComponentSpec, RunEvent, SessionEntry, TableColumn, TableComponentSpec, TeamDetails, ToolCall, ToolHandlerResult, UIComponentSpec } from '@antipopp/agno-types';
-import React from 'react';
+import React, { ReactNode } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { AgnoClient } from '@antipopp/agno-client';
 
@@ -41,8 +41,14 @@ declare function useAgnoClient(): AgnoClient;
 
 /**
  * Tool handler function type (now supports generative UI)
+ * - Receives normalized object arguments
+ * - Can return sync or async values
  */
-type ToolHandler = (args: Record<string, any>) => Promise<any>;
+type MaybePromise$1<T> = T | Promise<T>;
+type ToolHandler<TArgs extends ToolCall["tool_args"] = ToolCall["tool_args"], TResult = unknown> = {
+    bivarianceHack(args: TArgs): MaybePromise$1<TResult>;
+}["bivarianceHack"];
+type ToolHandlers = Record<string, ToolHandler>;
 /**
  * Get a custom render function by key
  */
@@ -85,7 +91,7 @@ interface ToolExecutionEvent {
  * const { isPaused, isExecuting, pendingTools } = useAgnoToolExecution(toolHandlers);
  * ```
  */
-declare function useAgnoToolExecution(handlers?: Record<string, ToolHandler>, autoExecute?: boolean): {
+declare function useAgnoToolExecution(handlers?: ToolHandlers, autoExecute?: boolean): {
     /** Whether the run is currently paused awaiting tool execution */
     isPaused: boolean;
     /** Whether tools are currently being executed */
@@ -109,12 +115,12 @@ declare function useAgnoToolExecution(handlers?: Record<string, ToolHandler>, au
  * Context value for tool handler registry
  */
 interface ToolHandlerContextValue {
-    handlers: Record<string, ToolHandler>;
+    handlers: ToolHandlers;
     registerHandler: (name: string, handler: ToolHandler) => void;
     unregisterHandler: (name: string) => void;
 }
 interface ToolHandlerProviderProps {
-    handlers?: Record<string, ToolHandler>;
+    handlers?: ToolHandlers;
     children: React.ReactNode;
 }
 /**
@@ -177,10 +183,7 @@ declare function useAgnoActions(): {
  */
 declare function useAgnoChat(): {
     messages: ChatMessage[];
-    sendMessage: (message: string | FormData, options?: {
-        headers?: Record<string, string>;
-        params?: Record<string, string>;
-    }) => Promise<void>;
+    sendMessage: (message: string | FormData, options?: Parameters<(message: string | FormData, options?: _antipopp_agno_types.SendMessageOptions) => Promise<void>>[1]) => Promise<void>;
     clearMessages: () => void;
     cancelRun: () => Promise<void>;
     isStreaming: boolean;
@@ -214,10 +217,11 @@ declare function useAgnoSession(): {
  * Maps component specifications to actual React components.
  * Allows registering custom components at runtime.
  */
+
 /**
  * Component renderer function type
  */
-type ComponentRenderer = (props: any) => any;
+type ComponentRenderer = (props: Record<string, unknown>) => ReactNode;
 /**
  * Component registry class
  */
@@ -277,6 +281,49 @@ declare function registerChartComponent(name: string, renderer: ComponentRendere
  */
 declare function getChartComponent(name: string): ComponentRenderer | undefined;
 
+type MaybePromise<T> = T | Promise<T>;
+interface ToolArgsValidationSuccess<TArgs> {
+    success: true;
+    data: TArgs;
+}
+interface ToolArgsValidationFailure<TIssues = unknown> {
+    success: false;
+    message?: string;
+    issues?: TIssues;
+}
+type ToolArgsValidationResult<TArgs, TIssues = unknown> = ToolArgsValidationSuccess<TArgs> | ToolArgsValidationFailure<TIssues>;
+type ToolArgsValidator<TArgs, TIssues = unknown> = (args: Record<string, unknown>) => MaybePromise<ToolArgsValidationResult<TArgs, TIssues>>;
+interface ToolValidationError<TIssues = unknown> {
+    success: false;
+    code: "INVALID_TOOL_ARGS";
+    error: string;
+    issues?: TIssues;
+}
+interface CreateValidatedToolHandlerOptions<TIssues = unknown, TValidationError = ToolValidationError<TIssues>> {
+    errorMessage?: string;
+    mapValidationError?: (failure: ToolArgsValidationFailure<TIssues>, args: Record<string, unknown>) => TValidationError;
+}
+type SafeParseResult<TArgs, TIssues = unknown> = {
+    success: true;
+    data: TArgs;
+} | {
+    success: false;
+    error: TIssues;
+};
+interface CreateValidatorFromSafeParseOptions<TIssues = unknown> {
+    getErrorMessage?: (issues: TIssues) => string;
+}
+/**
+ * Create a ToolArgsValidator from libraries that expose safeParse-like APIs.
+ *
+ * This is validator-agnostic and works with Zod, Valibot, ArkType adapters, etc.
+ */
+declare function createToolArgsValidatorFromSafeParse<TArgs, TIssues = unknown>(safeParse: (args: Record<string, unknown>) => MaybePromise<SafeParseResult<TArgs, TIssues>>, options?: CreateValidatorFromSafeParseOptions<TIssues>): ToolArgsValidator<TArgs, TIssues>;
+/**
+ * Wrap a tool handler with runtime argument validation.
+ */
+declare function createValidatedToolHandler<TArgs, TResult = unknown, TIssues = unknown, TValidationError = ToolValidationError<TIssues>>(validator: ToolArgsValidator<TArgs, TIssues>, handler: (args: TArgs) => MaybePromise<TResult>, options?: CreateValidatedToolHandlerOptions<TIssues, TValidationError>): ToolHandler<Record<string, unknown>, TResult | TValidationError | ToolValidationError<TIssues>>;
+
 /**
  * Helper utilities for creating UI component specifications
  *
@@ -284,6 +331,12 @@ declare function getChartComponent(name: string): ComponentRenderer | undefined;
  * manually constructing the full specification object.
  */
 
+type DataRow = Record<string, unknown>;
+type SeriesInput = Array<{
+    key: string;
+    label?: string;
+    color?: string;
+}>;
 /**
  * Chart helper options
  */
@@ -306,33 +359,21 @@ interface ChartHelperOptions {
 /**
  * Create a bar chart specification
  */
-declare function createBarChart(data: any[], xKey: string, bars: Array<{
-    key: string;
-    label?: string;
-    color?: string;
-}>, options?: ChartHelperOptions): ChartComponentSpec;
+declare function createBarChart(data: DataRow[], xKey: string, bars: SeriesInput, options?: ChartHelperOptions): ChartComponentSpec;
 /**
  * Create a line chart specification
  */
-declare function createLineChart(data: any[], xKey: string, lines: Array<{
-    key: string;
-    label?: string;
-    color?: string;
-}>, options?: ChartHelperOptions): ChartComponentSpec;
+declare function createLineChart(data: DataRow[], xKey: string, lines: SeriesInput, options?: ChartHelperOptions): ChartComponentSpec;
 /**
  * Create a pie chart specification
  */
-declare function createPieChart(data: any[], dataKey: string, nameKey: string, options?: ChartHelperOptions & {
+declare function createPieChart(data: DataRow[], dataKey: string, nameKey: string, options?: ChartHelperOptions & {
     showLabel?: boolean;
 }): ChartComponentSpec;
 /**
  * Create an area chart specification
  */
-declare function createAreaChart(data: any[], xKey: string, areas: Array<{
-    key: string;
-    label?: string;
-    color?: string;
-}>, options?: ChartHelperOptions): ChartComponentSpec;
+declare function createAreaChart(data: DataRow[], xKey: string, areas: SeriesInput, options?: ChartHelperOptions): ChartComponentSpec;
 /**
  * Card grid helper options
  */
@@ -358,7 +399,7 @@ declare function createCardGrid(cards: CardData[], options?: CardGridHelperOptio
  */
 declare function createCard(id: string, title: string, description?: string, options?: {
     image?: string;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
     actions?: CardData["actions"];
 }): CardData;
 /**
@@ -379,7 +420,7 @@ interface TableHelperOptions {
 /**
  * Create a table specification
  */
-declare function createTable(data: Record<string, any>[], columns: TableColumn[], options?: TableHelperOptions): TableComponentSpec;
+declare function createTable(data: DataRow[], columns: TableColumn[], options?: TableHelperOptions): TableComponentSpec;
 /**
  * Create a table column definition
  */
@@ -409,7 +450,7 @@ declare function createArtifact(content: UIComponentSpec[], options?: {
 /**
  * Smart chart creator - automatically chooses the best chart type based on data
  */
-declare function createSmartChart(data: any[], options?: {
+declare function createSmartChart(data: DataRow[], options?: {
     title?: string;
     description?: string;
     layout?: "inline" | "artifact";
@@ -420,19 +461,15 @@ declare function createSmartChart(data: any[], options?: {
 /**
  * Wrap data and UI into a ToolHandlerResult
  */
-declare function createToolResult(data: any, ui: UIComponentSpec): ToolHandlerResult;
+declare function createToolResult(data: unknown, ui: UIComponentSpec): ToolHandlerResult;
 /**
  * Quick helper: create a tool result with a bar chart
  */
-declare function resultWithBarChart(data: any[], xKey: string, bars: Array<{
-    key: string;
-    label?: string;
-    color?: string;
-}>, options?: ChartHelperOptions): ToolHandlerResult;
+declare function resultWithBarChart(data: DataRow[], xKey: string, bars: SeriesInput, options?: ChartHelperOptions): ToolHandlerResult;
 /**
  * Quick helper: create a tool result with a smart chart
  */
-declare function resultWithSmartChart(data: any[], options?: Parameters<typeof createSmartChart>[1]): ToolHandlerResult;
+declare function resultWithSmartChart(data: DataRow[], options?: Parameters<typeof createSmartChart>[1]): ToolHandlerResult;
 /**
  * Quick helper: create a tool result with a card grid
  */
@@ -440,6 +477,6 @@ declare function resultWithCardGrid(cards: CardData[], options?: CardGridHelperO
 /**
  * Quick helper: create a tool result with a table
  */
-declare function resultWithTable(data: Record<string, any>[], columns: TableColumn[], options?: TableHelperOptions): ToolHandlerResult;
+declare function resultWithTable(data: DataRow[], columns: TableColumn[], options?: TableHelperOptions): ToolHandlerResult;
 
-export { AgnoProvider, type AgnoProviderProps, type CardGridHelperOptions, type ChartHelperOptions, ComponentRegistry, type ComponentRenderer, GenerativeUIRenderer, type GenerativeUIRendererProps, type TableHelperOptions, type ToolExecutionEvent, type ToolHandler, type ToolHandlerContextValue, ToolHandlerProvider, type ToolHandlerProviderProps, clearCustomRenderRegistry, createAreaChart, createArtifact, createBarChart, createCard, createCardGrid, createColumn, createLineChart, createMarkdown, createPieChart, createSmartChart, createTable, createToolResult, getChartComponent, getComponentRegistry, getCustomRender, registerChartComponent, resultWithBarChart, resultWithCardGrid, resultWithSmartChart, resultWithTable, useAgnoActions, useAgnoChat, useAgnoClient, useAgnoSession, useAgnoToolExecution, useToolHandlers };
+export { AgnoProvider, type AgnoProviderProps, type CardGridHelperOptions, type ChartHelperOptions, ComponentRegistry, type ComponentRenderer, type CreateValidatedToolHandlerOptions, type CreateValidatorFromSafeParseOptions, GenerativeUIRenderer, type GenerativeUIRendererProps, type SafeParseResult, type TableHelperOptions, type ToolArgsValidationFailure, type ToolArgsValidationResult, type ToolArgsValidationSuccess, type ToolArgsValidator, type ToolExecutionEvent, type ToolHandler, type ToolHandlerContextValue, ToolHandlerProvider, type ToolHandlerProviderProps, type ToolHandlers, type ToolValidationError, clearCustomRenderRegistry, createAreaChart, createArtifact, createBarChart, createCard, createCardGrid, createColumn, createLineChart, createMarkdown, createPieChart, createSmartChart, createTable, createToolArgsValidatorFromSafeParse, createToolResult, createValidatedToolHandler, getChartComponent, getComponentRegistry, getCustomRender, registerChartComponent, resultWithBarChart, resultWithCardGrid, resultWithSmartChart, resultWithTable, useAgnoActions, useAgnoChat, useAgnoClient, useAgnoSession, useAgnoToolExecution, useToolHandlers };