@antipopp/agno-client 0.9.0 → 0.11.0

package/README.md

@@ -70,6 +70,7 @@ new AgnoClient(config: AgnoClientConfig)
 - `userId` (string, optional) - User ID to link sessions to a specific user
 - `headers` (Record<string, string>, optional) - Global custom headers for all API requests
 - `params` (Record<string, string>, optional) - Global query parameters for all API requests
+- `dependencies` (Record<string, unknown>, optional) - Global run dependencies merged into all `sendMessage` requests
 
 ### Methods
 
@@ -83,9 +84,33 @@ await client.sendMessage('Hello!');
 // With FormData (for file uploads)
 const formData = new FormData();
 formData.append('message', 'Hello!');
-formData.append('file', fileBlob);
+formData.append('files', fileBlob);
 await client.sendMessage(formData);
 
+// With per-request files option
+await client.sendMessage('Hello!', {
+  files: [fileBlob]
+});
+
+// With global dependencies from config
+const dependencyClient = new AgnoClient({
+  endpoint: 'http://localhost:7777',
+  agentId: 'agent-123',
+  dependencies: {
+    tenantId: 'tenant-1',
+    locale: 'en-US'
+  }
+});
+await dependencyClient.sendMessage('Hello!');
+
+// Override/extend dependencies per request
+await dependencyClient.sendMessage('Hello!', {
+  dependencies: {
+    locale: 'fr-FR', // overrides global
+    feature: 'rag'   // merged new key
+  }
+});
+
 // With custom headers
 await client.sendMessage('Hello!', {
   headers: { 'X-Custom-Header': 'value' }
@@ -314,6 +339,10 @@ await client.continueRun(tools, {
 1. Global params from `config.params` (lowest precedence)
 2. Per-request params (highest precedence - overrides global)
 
+**Dependencies (`sendMessage` only):**
+1. Global dependencies from `config.dependencies` (lowest precedence)
+2. Per-request dependencies from `sendMessage(..., { dependencies })` (highest precedence - overrides global)
+
 ```typescript
 const client = new AgnoClient({
   endpoint: 'http://localhost:7777',

package/dist/index.d.mts

@@ -1,19 +1,22 @@
-import EventEmitter from 'eventemitter3';
-import { AgnoClientConfig, ChatMessage, ClientState, SessionEntry, ToolCall, AgentDetails, TeamDetails } from '@antipopp/agno-types';
+import { AgnoClientConfig, ChatMessage, ClientState, SendMessageOptions, SessionEntry, ToolCall, UIComponentSpec, AgentDetails, TeamDetails } from '@antipopp/agno-types';
 export { AgentDetails, AgnoClientConfig, AudioData, ChatMessage, ClientState, ImageData, MessageExtraData, ResponseAudioData, RunEvent, RunResponse, RunResponseContent, SessionEntry, TeamDetails, ToolCall, VideoData } from '@antipopp/agno-types';
+import EventEmitter from 'eventemitter3';
 
 /**
  * Main Agno client class
  * Provides stateful management of agent/team interactions with streaming support
  */
 declare class AgnoClient extends EventEmitter {
-    private messageStore;
-    private configManager;
-    private sessionManager;
-    private eventProcessor;
-    private state;
-    private pendingUISpecs;
+    private readonly messageStore;
+    private readonly configManager;
+    private readonly sessionManager;
+    private readonly eventProcessor;
+    private readonly state;
+    private readonly pendingUISpecs;
+    private readonly localAttachmentUrls;
     private runCompletedSuccessfully;
+    private currentRunId;
+    private currentAbortController;
     constructor(config: AgnoClientConfig);
     /**
      * Get current messages
@@ -35,13 +38,22 @@ declare class AgnoClient extends EventEmitter {
      * Clear all messages
      */
     clearMessages(): void;
+    /**
+     * Cancel an active or paused run
+     */
+    cancelRun(): Promise<void>;
+    private logMissingRunIdForCancel;
+    private requestBackendCancel;
+    /**
+     * Abort the active stream without calling the backend cancel endpoint.
+     * Since streamResponse handles AbortError by returning silently
+     * (no onComplete/onError called), state cleanup is done here.
+     */
+    abortStream(): void;
     /**
      * Send a message to the agent/team (streaming)
      */
-    sendMessage(message: string | FormData, options?: {
-        headers?: Record<string, string>;
-        params?: Record<string, string>;
-    }): Promise<void>;
+    sendMessage(message: string | FormData, options?: SendMessageOptions): Promise<void>;
     /**
      * Handle streaming chunk
      */
@@ -50,6 +62,12 @@ declare class AgnoClient extends EventEmitter {
      * Handle error
      */
     private handleError;
+    private trackAttachmentUrls;
+    private collectAttachmentUrls;
+    private revokeAttachmentUrls;
+    private revokeAttachmentUrlsFromMessages;
+    private collectExistingUIComponents;
+    private restoreUIComponents;
     /**
      * Refresh messages from the session API after run completion.
      * Replaces streamed messages with authoritative session data.
@@ -84,7 +102,7 @@ declare class AgnoClient extends EventEmitter {
      * Hydrate a specific tool call with its UI component
      * If tool call doesn't exist yet, stores UI spec as pending
      */
-    hydrateToolCallUI(toolCallId: string, uiSpec: any): void;
+    hydrateToolCallUI(toolCallId: string, uiSpec: UIComponentSpec): void;
     /**
      * Apply any pending UI specs to tool calls that have just been added
      * Called after message updates to attach UI to newly arrived tool calls
@@ -134,6 +152,12 @@ declare class AgnoClient extends EventEmitter {
         agents: AgentDetails[];
         teams: TeamDetails[];
     }>;
+    /**
+     * Dispose of the client and clean up all resources.
+     * Call this method when the client is no longer needed to prevent memory leaks.
+     * After calling dispose(), the client instance should not be reused.
+     */
+    dispose(): void;
 }
 
 /**
@@ -143,23 +167,23 @@ declare class AgnoClient extends EventEmitter {
 /**
  * Logger class with sanitization and environment-aware logging
  */
-declare class Logger {
+declare const Logger: {
     /**
      * Log debug information (only in development)
      */
-    static debug(message: string, data?: unknown): void;
+    debug(message: string, data?: unknown): void;
     /**
      * Log informational messages (only in development)
      */
-    static info(message: string, data?: unknown): void;
+    info(message: string, data?: unknown): void;
     /**
      * Log warnings (always logs)
      */
-    static warn(message: string, data?: unknown): void;
+    warn(message: string, data?: unknown): void;
     /**
      * Log errors (always logs)
      */
-    static error(message: string, data?: unknown): void;
-}
+    error(message: string, data?: unknown): void;
+};
 
 export { AgnoClient, Logger };

package/dist/index.d.ts

@@ -1,19 +1,22 @@
-import EventEmitter from 'eventemitter3';
-import { AgnoClientConfig, ChatMessage, ClientState, SessionEntry, ToolCall, AgentDetails, TeamDetails } from '@antipopp/agno-types';
+import { AgnoClientConfig, ChatMessage, ClientState, SendMessageOptions, SessionEntry, ToolCall, UIComponentSpec, AgentDetails, TeamDetails } from '@antipopp/agno-types';
 export { AgentDetails, AgnoClientConfig, AudioData, ChatMessage, ClientState, ImageData, MessageExtraData, ResponseAudioData, RunEvent, RunResponse, RunResponseContent, SessionEntry, TeamDetails, ToolCall, VideoData } from '@antipopp/agno-types';
+import EventEmitter from 'eventemitter3';
 
 /**
  * Main Agno client class
  * Provides stateful management of agent/team interactions with streaming support
  */
 declare class AgnoClient extends EventEmitter {
-    private messageStore;
-    private configManager;
-    private sessionManager;
-    private eventProcessor;
-    private state;
-    private pendingUISpecs;
+    private readonly messageStore;
+    private readonly configManager;
+    private readonly sessionManager;
+    private readonly eventProcessor;
+    private readonly state;
+    private readonly pendingUISpecs;
+    private readonly localAttachmentUrls;
     private runCompletedSuccessfully;
+    private currentRunId;
+    private currentAbortController;
     constructor(config: AgnoClientConfig);
     /**
      * Get current messages
@@ -35,13 +38,22 @@ declare class AgnoClient extends EventEmitter {
      * Clear all messages
      */
     clearMessages(): void;
+    /**
+     * Cancel an active or paused run
+     */
+    cancelRun(): Promise<void>;
+    private logMissingRunIdForCancel;
+    private requestBackendCancel;
+    /**
+     * Abort the active stream without calling the backend cancel endpoint.
+     * Since streamResponse handles AbortError by returning silently
+     * (no onComplete/onError called), state cleanup is done here.
+     */
+    abortStream(): void;
     /**
      * Send a message to the agent/team (streaming)
      */
-    sendMessage(message: string | FormData, options?: {
-        headers?: Record<string, string>;
-        params?: Record<string, string>;
-    }): Promise<void>;
+    sendMessage(message: string | FormData, options?: SendMessageOptions): Promise<void>;
     /**
      * Handle streaming chunk
      */
@@ -50,6 +62,12 @@ declare class AgnoClient extends EventEmitter {
      * Handle error
      */
     private handleError;
+    private trackAttachmentUrls;
+    private collectAttachmentUrls;
+    private revokeAttachmentUrls;
+    private revokeAttachmentUrlsFromMessages;
+    private collectExistingUIComponents;
+    private restoreUIComponents;
     /**
      * Refresh messages from the session API after run completion.
      * Replaces streamed messages with authoritative session data.
@@ -84,7 +102,7 @@ declare class AgnoClient extends EventEmitter {
      * Hydrate a specific tool call with its UI component
      * If tool call doesn't exist yet, stores UI spec as pending
      */
-    hydrateToolCallUI(toolCallId: string, uiSpec: any): void;
+    hydrateToolCallUI(toolCallId: string, uiSpec: UIComponentSpec): void;
     /**
      * Apply any pending UI specs to tool calls that have just been added
      * Called after message updates to attach UI to newly arrived tool calls
@@ -134,6 +152,12 @@ declare class AgnoClient extends EventEmitter {
         agents: AgentDetails[];
         teams: TeamDetails[];
     }>;
+    /**
+     * Dispose of the client and clean up all resources.
+     * Call this method when the client is no longer needed to prevent memory leaks.
+     * After calling dispose(), the client instance should not be reused.
+     */
+    dispose(): void;
 }
 
 /**
@@ -143,23 +167,23 @@ declare class AgnoClient extends EventEmitter {
 /**
  * Logger class with sanitization and environment-aware logging
  */
-declare class Logger {
+declare const Logger: {
     /**
      * Log debug information (only in development)
      */
-    static debug(message: string, data?: unknown): void;
+    debug(message: string, data?: unknown): void;
     /**
      * Log informational messages (only in development)
      */
-    static info(message: string, data?: unknown): void;
+    info(message: string, data?: unknown): void;
     /**
      * Log warnings (always logs)
      */
-    static warn(message: string, data?: unknown): void;
+    warn(message: string, data?: unknown): void;
     /**
      * Log errors (always logs)
      */
-    static error(message: string, data?: unknown): void;
-}
+    error(message: string, data?: unknown): void;
+};
 
 export { AgnoClient, Logger };