@antipopp/agno-react 0.10.0 → 0.11.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()`

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';
 
@@ -42,7 +42,7 @@ declare function useAgnoClient(): AgnoClient;
 /**
  * Tool handler function type (now supports generative UI)
  */
-type ToolHandler = (args: Record<string, any>) => Promise<any>;
+type ToolHandler = (args: Record<string, unknown> | string) => Promise<unknown>;
 /**
  * Get a custom render function by key
  */
@@ -177,10 +177,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 +211,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
  */
@@ -284,6 +282,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 +310,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 +350,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 +371,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 +401,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 +412,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 +428,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 };

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';
 
@@ -42,7 +42,7 @@ declare function useAgnoClient(): AgnoClient;
 /**
  * Tool handler function type (now supports generative UI)
  */
-type ToolHandler = (args: Record<string, any>) => Promise<any>;
+type ToolHandler = (args: Record<string, unknown> | string) => Promise<unknown>;
 /**
  * Get a custom render function by key
  */
@@ -177,10 +177,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 +211,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
  */
@@ -284,6 +282,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 +310,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 +350,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 +371,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 +401,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 +412,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 +428,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 };