agent-swarm-kit 1.0.64 → 1.0.66

package/build/index.cjs

@@ -478,6 +478,9 @@ var HistoryInstance = /** @class */ (function () {
         if (callbacks.onInit) {
             callbacks.onInit(clientId);
         }
+        if (callbacks.onRef) {
+            callbacks.onRef(this);
+        }
         if (callbacks.filterCondition) {
             this.iterate = function (agentName) {
                 return __asyncGenerator(this, arguments, function () {
@@ -910,7 +913,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)];
 };
@@ -1297,6 +1300,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';
@@ -476,6 +476,9 @@ var HistoryInstance = /** @class */ (function () {
         if (callbacks.onInit) {
             callbacks.onInit(clientId);
         }
+        if (callbacks.onRef) {
+            callbacks.onRef(this);
+        }
         if (callbacks.filterCondition) {
             this.iterate = function (agentName) {
                 return __asyncGenerator(this, arguments, function () {
@@ -908,7 +911,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 +1298,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.64",
+  "version": "1.0.66",
   "description": "A TypeScript library for building orchestrated framework-agnostic multi-agent AI systems",
   "author": {
     "name": "Petr Tripolsky",

package/types.d.ts

@@ -436,6 +436,11 @@ interface IHistoryInstanceCallbacks {
      * @param clientId - The client ID.
      */
     onInit: (clientId: string) => void;
+    /**
+     * Callback to obtain history ref
+     * @param clientId - The client ID.
+     */
+    onRef: (history: HistoryInstance) => void;
 }
 /**
  * Interface for History Adapter
@@ -733,35 +738,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;
 
 /**