@ideascol/agents-generator-sdk 0.3.3 → 0.3.5

package/README.md

@@ -4,6 +4,8 @@ agents-generator-sdk
 
 ## Usage as library
 
+### Basic Usage - Get Agents
+
 ```ts
 import { useEffect, useState } from 'react';
 import {
@@ -39,6 +41,100 @@ export function Agents() {
 }
 ```
 
+### Send Message with Transfer Detection (Synchronous)
+
+The `sendMessage` method now uses streaming internally to detect agent transfers (handoffs). It returns a promise with the complete response including any transfers that occurred.
+
+```ts
+import { AgentClient, SendMessageResponse } from '@ideascol/agents-generator-sdk';
+
+const client = new AgentClient({
+  apiUrl: 'https://api.agentsgenerator.dev',
+  apiToken: 'YOUR_API_TOKEN',
+});
+
+// Send a message and get the complete response with transfers
+const response: SendMessageResponse = await client.sendMessage(
+  'conversation-id',
+  { content: 'Hello, I need help with billing' }
+);
+
+console.log('Message:', response.message);
+console.log('Message ID:', response.message_id);
+
+// Check if there were any transfers
+if (response.transfers && response.transfers.length > 0) {
+  console.log('Transfers detected:');
+  response.transfers.forEach(transfer => {
+    console.log(`  From: ${transfer.from_agent}`);
+    console.log(`  To: ${transfer.to_agent}`);
+    console.log(`  Reason: ${transfer.reason}`);
+  });
+}
+```
+
+### Send Message with Streaming (Real-time updates)
+
+For real-time updates and custom handling of events, use `sendMessageWithStreaming`:
+
+```ts
+import { AgentClient, TransferEvent } from '@ideascol/agents-generator-sdk';
+
+const client = new AgentClient({
+  apiUrl: 'https://api.agentsgenerator.dev',
+  apiToken: 'YOUR_API_TOKEN',
+});
+
+const abort = client.sendMessageWithStreaming(
+  'conversation-id',
+  { content: 'Hello!' },
+  {
+    onMessage: (content: string) => {
+      console.log('Message update:', content);
+    },
+    onDone: (messageId: string) => {
+      console.log('Message completed:', messageId);
+    },
+    onTransfer: (transfer: TransferEvent) => {
+      console.log('Transfer detected!');
+      console.log(`  From: ${transfer.from_agent}`);
+      console.log(`  To: ${transfer.to_agent}`);
+      console.log(`  Reason: ${transfer.reason}`);
+    },
+    onError: (error: Error) => {
+      console.error('Error:', error);
+    }
+  }
+);
+
+// To abort the stream:
+// abort();
+```
+
+### TypeScript Types
+
+```ts
+interface SendMessageResponse {
+  status: string;
+  message: string;
+  message_id?: string;
+  transfers?: TransferEvent[];
+}
+
+interface TransferEvent {
+  from_agent?: string;
+  to_agent?: string;
+  reason?: string;
+}
+
+interface StreamCallbacks {
+  onMessage?: (content: string) => void;
+  onDone?: (messageId: string) => void;
+  onError?: (error: Error) => void;
+  onTransfer?: (transfer: TransferEvent) => void;
+}
+```
+
 ## Quick start
 ```bash
 # Using npm

package/dist/bin/cli.js

@@ -910,6 +910,18 @@ class AdminAgentsService {
       }
     });
   }
+  static getWorkspaceConversationsTotal(workspaceId) {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/agents/conversations/total",
+      query: {
+        workspace_id: workspaceId
+      },
+      errors: {
+        422: `Validation Error`
+      }
+    });
+  }
   static initializeAgent(agentId) {
     return request(OpenAPI, {
       method: "POST",
@@ -955,6 +967,21 @@ class AdminAgentsService {
       }
     });
   }
+  static getAgentConversationsTotal(agentId, workspaceId) {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/agents/{agent_id}/conversations/total",
+      path: {
+        agent_id: agentId
+      },
+      query: {
+        workspace_id: workspaceId
+      },
+      errors: {
+        422: `Validation Error`
+      }
+    });
+  }
   static visualizeAgent(agentId, userId, format = "png") {
     return request(OpenAPI, {
       method: "GET",
@@ -1502,6 +1529,18 @@ class AgentService {
       }
     });
   }
+  static getWorkspaceConversationsTotal(workspaceId) {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/agents/conversations/total",
+      query: {
+        workspace_id: workspaceId
+      },
+      errors: {
+        422: `Validation Error`
+      }
+    });
+  }
   static initializeAgent(agentId) {
     return request(OpenAPI, {
       method: "POST",
@@ -1547,6 +1586,21 @@ class AgentService {
       }
     });
   }
+  static getAgentConversationsTotal(agentId, workspaceId) {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/agents/{agent_id}/conversations/total",
+      path: {
+        agent_id: agentId
+      },
+      query: {
+        workspace_id: workspaceId
+      },
+      errors: {
+        422: `Validation Error`
+      }
+    });
+  }
   static visualizeAgent(agentId, userId, format = "png") {
     return request(OpenAPI, {
       method: "GET",
@@ -2229,7 +2283,7 @@ class AgentClient {
     return ConversationsServiceStream.addMessageConversationsConversationIdMessagesPostStream(conversationId, requestBody, callbacks);
   }
   sendMessage(conversationId, requestBody) {
-    return ConversationsServiceStream.addMessage(conversationId, requestBody, "text/plain");
+    return PublicConversationsServiceExtended.sendMessage(conversationId, requestBody);
   }
 }
 var ConversationsServiceStream, PublicConversationsServiceExtended, lib_default;
@@ -2360,6 +2414,8 @@ var init_lib = __esm(() => {
                       callbacks.onMessage(fullMessage);
                     } else if (data.type === "done" && data.message_id && callbacks.onDone) {
                       callbacks.onDone(data.message_id);
+                    } else if (data.type === "transfer" && data.transfer && callbacks.onTransfer) {
+                      callbacks.onTransfer(data.transfer);
                     }
                   } catch (e) {
                     console.error("Error al parsear JSON del evento:", e);
@@ -2417,7 +2473,46 @@ var init_lib = __esm(() => {
       return ConversationsServiceStream.addMessageConversationsConversationIdMessagesPostStream(conversationId, requestBody, callbacks);
     }
     static sendMessage(conversationId, requestBody) {
-      return ConversationsServiceStream.addMessage(conversationId, requestBody);
+      return new Promise((resolve2, reject) => {
+        let fullMessage = "";
+        let messageId = "";
+        const transfers = [];
+        let streamCompleted = false;
+        let timeoutId;
+        const abort = ConversationsServiceStream.addMessageConversationsConversationIdMessagesPostStream(conversationId, requestBody, {
+          onMessage: (content) => {
+            fullMessage = content;
+          },
+          onDone: (id) => {
+            messageId = id;
+            streamCompleted = true;
+            if (timeoutId) {
+              clearTimeout(timeoutId);
+            }
+            resolve2({
+              status: "success",
+              message: fullMessage,
+              message_id: messageId || undefined,
+              transfers: transfers.length > 0 ? transfers : undefined
+            });
+          },
+          onTransfer: (transfer) => {
+            transfers.push(transfer);
+          },
+          onError: (error) => {
+            if (timeoutId) {
+              clearTimeout(timeoutId);
+            }
+            reject(error);
+          }
+        });
+        timeoutId = setTimeout(() => {
+          if (!streamCompleted) {
+            abort();
+            reject(new Error("Message send timeout after 60 seconds"));
+          }
+        }, 60000);
+      });
     }
   };
   lib_default = AgentClient;

package/dist/index.js

@@ -478,6 +478,18 @@ class AdminAgentsService {
       }
     });
   }
+  static getWorkspaceConversationsTotal(workspaceId) {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/agents/conversations/total",
+      query: {
+        workspace_id: workspaceId
+      },
+      errors: {
+        422: `Validation Error`
+      }
+    });
+  }
   static initializeAgent(agentId) {
     return request(OpenAPI, {
       method: "POST",
@@ -523,6 +535,21 @@ class AdminAgentsService {
       }
     });
   }
+  static getAgentConversationsTotal(agentId, workspaceId) {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/agents/{agent_id}/conversations/total",
+      path: {
+        agent_id: agentId
+      },
+      query: {
+        workspace_id: workspaceId
+      },
+      errors: {
+        422: `Validation Error`
+      }
+    });
+  }
   static visualizeAgent(agentId, userId, format = "png") {
     return request(OpenAPI, {
       method: "GET",
@@ -1070,6 +1097,18 @@ class AgentService {
       }
     });
   }
+  static getWorkspaceConversationsTotal(workspaceId) {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/agents/conversations/total",
+      query: {
+        workspace_id: workspaceId
+      },
+      errors: {
+        422: `Validation Error`
+      }
+    });
+  }
   static initializeAgent(agentId) {
     return request(OpenAPI, {
       method: "POST",
@@ -1115,6 +1154,21 @@ class AgentService {
       }
     });
   }
+  static getAgentConversationsTotal(agentId, workspaceId) {
+    return request(OpenAPI, {
+      method: "GET",
+      url: "/agents/{agent_id}/conversations/total",
+      path: {
+        agent_id: agentId
+      },
+      query: {
+        workspace_id: workspaceId
+      },
+      errors: {
+        422: `Validation Error`
+      }
+    });
+  }
   static visualizeAgent(agentId, userId, format = "png") {
     return request(OpenAPI, {
       method: "GET",
@@ -1797,7 +1851,7 @@ class AgentClient {
     return ConversationsServiceStream.addMessageConversationsConversationIdMessagesPostStream(conversationId, requestBody, callbacks);
   }
   sendMessage(conversationId, requestBody) {
-    return ConversationsServiceStream.addMessage(conversationId, requestBody, "text/plain");
+    return PublicConversationsServiceExtended.sendMessage(conversationId, requestBody);
   }
 }
 var ConversationsServiceStream, PublicConversationsServiceExtended, lib_default;
@@ -1928,6 +1982,8 @@ var init_lib = __esm(() => {
                       callbacks.onMessage(fullMessage);
                     } else if (data.type === "done" && data.message_id && callbacks.onDone) {
                       callbacks.onDone(data.message_id);
+                    } else if (data.type === "transfer" && data.transfer && callbacks.onTransfer) {
+                      callbacks.onTransfer(data.transfer);
                     }
                   } catch (e) {
                     console.error("Error al parsear JSON del evento:", e);
@@ -1985,7 +2041,46 @@ var init_lib = __esm(() => {
       return ConversationsServiceStream.addMessageConversationsConversationIdMessagesPostStream(conversationId, requestBody, callbacks);
     }
     static sendMessage(conversationId, requestBody) {
-      return ConversationsServiceStream.addMessage(conversationId, requestBody);
+      return new Promise((resolve2, reject) => {
+        let fullMessage = "";
+        let messageId = "";
+        const transfers = [];
+        let streamCompleted = false;
+        let timeoutId;
+        const abort = ConversationsServiceStream.addMessageConversationsConversationIdMessagesPostStream(conversationId, requestBody, {
+          onMessage: (content) => {
+            fullMessage = content;
+          },
+          onDone: (id) => {
+            messageId = id;
+            streamCompleted = true;
+            if (timeoutId) {
+              clearTimeout(timeoutId);
+            }
+            resolve2({
+              status: "success",
+              message: fullMessage,
+              message_id: messageId || undefined,
+              transfers: transfers.length > 0 ? transfers : undefined
+            });
+          },
+          onTransfer: (transfer) => {
+            transfers.push(transfer);
+          },
+          onError: (error) => {
+            if (timeoutId) {
+              clearTimeout(timeoutId);
+            }
+            reject(error);
+          }
+        });
+        timeoutId = setTimeout(() => {
+          if (!streamCompleted) {
+            abort();
+            reject(new Error("Message send timeout after 60 seconds"));
+          }
+        }, 60000);
+      });
     }
   };
   lib_default = AgentClient;

package/dist/lib/clients/agents-generator/services/AdminAgentsService.d.ts

@@ -48,6 +48,14 @@ export declare class AdminAgentsService {
      * @throws ApiError
      */
     static deleteAgent(agentId: string, workspaceId?: (string | null)): CancelablePromise<Record<string, any>>;
+    /**
+     * Get Workspace Conversations Total
+     * Get the total count of conversations for all agents in a workspace.
+     * @param workspaceId
+     * @returns any Successful Response
+     * @throws ApiError
+     */
+    static getWorkspaceConversationsTotal(workspaceId?: (string | null)): CancelablePromise<Record<string, any>>;
     /**
      * Initialize Agent
      * @param agentId
@@ -75,6 +83,15 @@ export declare class AdminAgentsService {
      * @throws ApiError
      */
     static getAgentStructure(agentId: string, userId?: (string | null)): CancelablePromise<Record<string, any>>;
+    /**
+     * Get Agent Conversations Total
+     * Get the total count of conversations for a specific agent.
+     * @param agentId
+     * @param workspaceId
+     * @returns any Successful Response
+     * @throws ApiError
+     */
+    static getAgentConversationsTotal(agentId: string, workspaceId?: (string | null)): CancelablePromise<Record<string, any>>;
     /**
      * Visualize Agent
      * @param agentId

package/dist/lib/clients/agents-generator/services/AgentService.d.ts

@@ -48,6 +48,14 @@ export declare class AgentService {
      * @throws ApiError
      */
     static deleteAgent(agentId: string, workspaceId?: (string | null)): CancelablePromise<Record<string, any>>;
+    /**
+     * Get Workspace Conversations Total
+     * Get the total count of conversations for all agents in a workspace.
+     * @param workspaceId
+     * @returns any Successful Response
+     * @throws ApiError
+     */
+    static getWorkspaceConversationsTotal(workspaceId?: (string | null)): CancelablePromise<Record<string, any>>;
     /**
      * Initialize Agent
      * @param agentId
@@ -75,6 +83,15 @@ export declare class AgentService {
      * @throws ApiError
      */
     static getAgentStructure(agentId: string, userId?: (string | null)): CancelablePromise<Record<string, any>>;
+    /**
+     * Get Agent Conversations Total
+     * Get the total count of conversations for a specific agent.
+     * @param agentId
+     * @param workspaceId
+     * @returns any Successful Response
+     * @throws ApiError
+     */
+    static getAgentConversationsTotal(agentId: string, workspaceId?: (string | null)): CancelablePromise<Record<string, any>>;
     /**
      * Visualize Agent
      * @param agentId

package/dist/lib/index.d.ts

@@ -4,11 +4,24 @@ export interface StreamEvent {
     type: string;
     content?: string;
     message_id?: string;
+    transfer?: TransferEvent;
+}
+export interface TransferEvent {
+    from_agent?: string;
+    to_agent?: string;
+    reason?: string;
 }
 export interface StreamCallbacks {
     onMessage?: (content: string) => void;
     onDone?: (messageId: string) => void;
     onError?: (error: Error) => void;
+    onTransfer?: (transfer: TransferEvent) => void;
+}
+export interface SendMessageResponse {
+    status: string;
+    message: string;
+    message_id?: string;
+    transfers?: TransferEvent[];
 }
 declare class ConversationsServiceStream extends ConversationsService {
     constructor();
@@ -23,11 +36,13 @@ declare class ConversationsServiceStream extends ConversationsService {
 }
 declare class PublicConversationsServiceExtended extends PublicConversationsService {
     static sendMessageWithStreaming(conversationId: string, requestBody: MessageCreate, callbacks: StreamCallbacks): () => void;
-    static sendMessage(conversationId: string, requestBody: MessageCreate): CancelablePromise<{
-        status: string;
-        message: string;
-        message_id?: string;
-    }>;
+    /**
+     * Send a message synchronously using streaming internally to capture transfers
+     * @param conversationId The ID of the conversation
+     * @param requestBody The message data to send
+     * @returns Promise with the complete response including transfers
+     */
+    static sendMessage(conversationId: string, requestBody: MessageCreate): Promise<SendMessageResponse>;
 }
 export declare class AgentClient {
     admin: {
@@ -82,14 +97,11 @@ export declare class AgentClient {
      */
     sendMessageWithStreaming(conversationId: string, requestBody: MessageCreate, callbacks: StreamCallbacks): () => void;
     /**
-     * sendMessage: Sends a message to a conversation without streaming
-     * @returns CancelablePromise with the response
+     * sendMessage: Sends a message to a conversation with transfer detection
+     * Uses streaming internally to capture transfer events
+     * @returns Promise with the complete response including transfers
      * Use client.public.conversations.sendMessage instead
      */
-    sendMessage(conversationId: string, requestBody: MessageCreate): CancelablePromise<{
-        status: string;
-        message: string;
-        message_id?: string;
-    }>;
+    sendMessage(conversationId: string, requestBody: MessageCreate): Promise<SendMessageResponse>;
 }
 export default AgentClient;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ideascol/agents-generator-sdk",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "main": "dist/index.js",
   "scripts": {
     "test": "bun test",