agent-swarm-kit 1.0.63 → 1.0.65

package/build/index.cjs

@@ -446,6 +446,8 @@ var HistoryInstance = /** @class */ (function () {
                     clientId: this.clientId,
                     agentName: agentName,
                 });
+                this.callbacks.onPush &&
+                    this.callbacks.onPush(value, this.clientId, agentName);
                 this._array.push(value);
                 this.callbacks.onChange &&
                     this.callbacks.onChange(this._array, this.clientId, agentName);
@@ -690,7 +692,7 @@ var HistoryUtils = /** @class */ (function () {
          */
         this.useHistoryCallbacks = function (Callbacks) {
             swarm.loggerService.log("HistoryUtils useHistoryCallbacks");
-            _this.HistoryCallbacks = Callbacks;
+            Object.assign(_this.HistoryCallbacks, Callbacks);
         };
         /**
          * Push a new message to the history.
@@ -908,7 +910,7 @@ var setConfig = function (config) {
     Object.assign(GLOBAL_CONFIG, config);
 };
 
-var AGENT_CHANGE_SYMBOL = Symbol('agent-change');
+var AGENT_CHANGE_SYMBOL = Symbol("agent-change");
 var getPlaceholder = function () {
     return GLOBAL_CONFIG.CC_EMPTY_OUTPUT_PLACEHOLDERS[Math.floor(Math.random() * GLOBAL_CONFIG.CC_EMPTY_OUTPUT_PLACEHOLDERS.length)];
 };
@@ -1295,6 +1297,13 @@ var ClientAgent = /** @class */ (function () {
                                         })
                                             .catch(function (error) {
                                             var _a, _b;
+                                            console.error("agent-swarm tool call error functionName=".concat(tool.function.name, " error=").concat(functoolsKit.getErrorMessage(error)), {
+                                                clientId: _this.params.clientId,
+                                                agentName: _this.params.agentName,
+                                                tool_call_id: tool.id,
+                                                arguments: tool.function.arguments,
+                                                error: functoolsKit.errorData(error),
+                                            });
                                             ((_a = targetFn.callbacks) === null || _a === void 0 ? void 0 : _a.onCallError) &&
                                                 ((_b = targetFn.callbacks) === null || _b === void 0 ? void 0 : _b.onCallError(tool.id, _this.params.clientId, _this.params.agentName, tool.function.arguments, error));
                                             _this._toolErrorSubject.next();

package/build/index.mjs

@@ -1,5 +1,5 @@
 import { scoped } from 'di-scoped';
-import { ToolRegistry, trycatch, singleshot, memoize, sleep, Subject, queued, not, randomString, createAwaiter, cancelable, CANCELED_PROMISE_SYMBOL, execpool, SortedArray, schedule, ttl, Source } from 'functools-kit';
+import { ToolRegistry, trycatch, singleshot, memoize, sleep, Subject, queued, getErrorMessage, errorData, not, randomString, createAwaiter, cancelable, CANCELED_PROMISE_SYMBOL, execpool, SortedArray, schedule, ttl, Source } from 'functools-kit';
 import { createActivator } from 'di-kit';
 import { omit } from 'lodash-es';
 import xml2js from 'xml2js';
@@ -444,6 +444,8 @@ var HistoryInstance = /** @class */ (function () {
                     clientId: this.clientId,
                     agentName: agentName,
                 });
+                this.callbacks.onPush &&
+                    this.callbacks.onPush(value, this.clientId, agentName);
                 this._array.push(value);
                 this.callbacks.onChange &&
                     this.callbacks.onChange(this._array, this.clientId, agentName);
@@ -688,7 +690,7 @@ var HistoryUtils = /** @class */ (function () {
          */
         this.useHistoryCallbacks = function (Callbacks) {
             swarm.loggerService.log("HistoryUtils useHistoryCallbacks");
-            _this.HistoryCallbacks = Callbacks;
+            Object.assign(_this.HistoryCallbacks, Callbacks);
         };
         /**
          * Push a new message to the history.
@@ -906,7 +908,7 @@ var setConfig = function (config) {
     Object.assign(GLOBAL_CONFIG, config);
 };
 
-var AGENT_CHANGE_SYMBOL = Symbol('agent-change');
+var AGENT_CHANGE_SYMBOL = Symbol("agent-change");
 var getPlaceholder = function () {
     return GLOBAL_CONFIG.CC_EMPTY_OUTPUT_PLACEHOLDERS[Math.floor(Math.random() * GLOBAL_CONFIG.CC_EMPTY_OUTPUT_PLACEHOLDERS.length)];
 };
@@ -1293,6 +1295,13 @@ var ClientAgent = /** @class */ (function () {
                                         })
                                             .catch(function (error) {
                                             var _a, _b;
+                                            console.error("agent-swarm tool call error functionName=".concat(tool.function.name, " error=").concat(getErrorMessage(error)), {
+                                                clientId: _this.params.clientId,
+                                                agentName: _this.params.agentName,
+                                                tool_call_id: tool.id,
+                                                arguments: tool.function.arguments,
+                                                error: errorData(error),
+                                            });
                                             ((_a = targetFn.callbacks) === null || _a === void 0 ? void 0 : _a.onCallError) &&
                                                 ((_b = targetFn.callbacks) === null || _b === void 0 ? void 0 : _b.onCallError(tool.id, _this.params.clientId, _this.params.agentName, tool.function.arguments, error));
                                             _this._toolErrorSubject.next();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-swarm-kit",
-  "version": "1.0.63",
+  "version": "1.0.65",
   "description": "A TypeScript library for building orchestrated framework-agnostic multi-agent AI systems",
   "author": {
     "name": "Petr Tripolsky",

package/types.d.ts

@@ -400,6 +400,13 @@ interface IHistoryInstanceCallbacks {
      * @param agentName - The agent name.
      */
     onChange: (data: IModelMessage[], clientId: string, agentName: AgentName) => void;
+    /**
+     * Callback for when the history get the new message
+     * @param data - The array of model messages.
+     * @param clientId - The client ID.
+     * @param agentName - The agent name.
+     */
+    onPush: (data: IModelMessage, clientId: string, agentName: AgentName) => void;
     /**
      * Callback for when the history is read. Will be called for each message
      * @param message - The model message.
@@ -726,35 +733,136 @@ interface IEmbeddingSchema {
 type EmbeddingName = string;
 
 type StorageId = string | number;
+/**
+ * Interface representing the data stored in the storage.
+ */
 interface IStorageData {
     id: StorageId;
 }
+/**
+ * Interface representing the schema of the storage.
+ * @template T - Type of the storage data.
+ */
 interface IStorageSchema<T extends IStorageData = IStorageData> {
+    /**
+     * Function to get data from the storage.
+     * @param clientId - The client ID.
+     * @param storageName - The name of the storage.
+     * @returns A promise that resolves to an array of storage data or an array of storage data.
+     */
     getData?: (clientId: string, storageName: StorageName) => Promise<T[]> | T[];
+    /**
+     * Function to create an index for an item.
+     * @param item - The item to index.
+     * @returns A promise that resolves to a string or a string.
+     */
     createIndex(item: T): Promise<string> | string;
+    /**
+     * The name of the embedding.
+     */
     embedding: EmbeddingName;
+    /**
+     * The name of the storage.
+     */
     storageName: StorageName;
+    /**
+     * Optional callbacks for storage events.
+     */
     callbacks?: Partial<IStorageCallbacks<T>>;
 }
+/**
+ * Interface representing the callbacks for storage events.
+ * @template T - Type of the storage data.
+ */
 interface IStorageCallbacks<T extends IStorageData = IStorageData> {
+    /**
+     * Callback function for update events.
+     * @param items - The updated items.
+     * @param clientId - The client ID.
+     * @param storageName - The name of the storage.
+     */
     onUpdate: (items: T[], clientId: string, storageName: StorageName) => void;
+    /**
+     * Callback function for search events.
+     * @param search - The search query.
+     * @param index - The sorted array of storage data.
+     * @param clientId - The client ID.
+     * @param storageName - The name of the storage.
+     */
     onSearch: (search: string, index: SortedArray<T>, clientId: string, storageName: StorageName) => void;
 }
+/**
+ * Interface representing the parameters for storage.
+ * @template T - Type of the storage data.
+ */
 interface IStorageParams<T extends IStorageData = IStorageData> extends IStorageSchema<T>, Partial<IEmbeddingCallbacks> {
+    /**
+     * The client ID.
+     */
     clientId: string;
+    /**
+     * Function to calculate similarity.
+     */
     calculateSimilarity: IEmbeddingSchema["calculateSimilarity"];
+    /**
+     * Function to create an embedding.
+     */
     createEmbedding: IEmbeddingSchema["createEmbedding"];
+    /**
+     * The name of the storage.
+     */
     storageName: StorageName;
+    /**
+     * Logger instance.
+     */
     logger: ILogger;
 }
+/**
+ * Interface representing the storage.
+ * @template T - Type of the storage data.
+ */
 interface IStorage<T extends IStorageData = IStorageData> {
+    /**
+     * Function to take items from the storage.
+     * @param search - The search query.
+     * @param total - The total number of items to take.
+     * @param score - Optional score parameter.
+     * @returns A promise that resolves to an array of storage data.
+     */
     take(search: string, total: number, score?: number): Promise<T[]>;
+    /**
+     * Function to upsert an item in the storage.
+     * @param item - The item to upsert.
+     * @returns A promise that resolves when the operation is complete.
+     */
     upsert(item: T): Promise<void>;
+    /**
+     * Function to remove an item from the storage.
+     * @param itemId - The ID of the item to remove.
+     * @returns A promise that resolves when the operation is complete.
+     */
     remove(itemId: IStorageData["id"]): Promise<void>;
+    /**
+     * Function to get an item from the storage.
+     * @param itemId - The ID of the item to get.
+     * @returns A promise that resolves to the item or null if not found.
+     */
     get(itemId: IStorageData["id"]): Promise<T | null>;
+    /**
+     * Function to list items from the storage.
+     * @param filter - Optional filter function.
+     * @returns A promise that resolves to an array of storage data.
+     */
     list(filter?: (item: T) => boolean): Promise<T[]>;
+    /**
+     * Function to clear the storage.
+     * @returns A promise that resolves when the operation is complete.
+     */
     clear(): Promise<void>;
 }
+/**
+ * Type representing the name of the storage.
+ */
 type StorageName = string;
 
 /**