@antipopp/agno-client 0.10.0 → 0.12.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,4 +1,4 @@
-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';
 
@@ -13,8 +13,10 @@ declare class AgnoClient extends EventEmitter {
     private readonly eventProcessor;
     private readonly state;
     private readonly pendingUISpecs;
+    private readonly localAttachmentUrls;
     private runCompletedSuccessfully;
     private currentRunId;
+    private currentAbortController;
     constructor(config: AgnoClientConfig);
     /**
      * Get current messages
@@ -40,13 +42,18 @@ declare class AgnoClient extends EventEmitter {
      * 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
      */
@@ -55,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.
@@ -89,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
@@ -154,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,4 +1,4 @@
-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';
 
@@ -13,8 +13,10 @@ declare class AgnoClient extends EventEmitter {
     private readonly eventProcessor;
     private readonly state;
     private readonly pendingUISpecs;
+    private readonly localAttachmentUrls;
     private runCompletedSuccessfully;
     private currentRunId;
+    private currentAbortController;
     constructor(config: AgnoClientConfig);
     /**
      * Get current messages
@@ -40,13 +42,18 @@ declare class AgnoClient extends EventEmitter {
      * 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
      */
@@ -55,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.
@@ -89,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
@@ -154,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 };