agent-swarm-kit 1.0.235 → 1.0.237

package/build/index.cjs

@@ -2763,6 +2763,8 @@ const Logger = LoggerAdapter;
 const OPERATOR_INSTANCE_METHOD_NAME_CTOR = "OperatorInstance.CTOR";
 /** @private Constant for logging the connectAnswer method in OperatorInstance */
 const OPERATOR_INSTANCE_METHOD_NAME_CONNECT_ANSWER = "OperatorInstance.connectAnswer";
+/** @private Constant for logging the init method in OperatorInstance */
+const OPERATOR_INSTANCE_METHOD_NAME_INIT = "OperatorInstance.init";
 /** @private Constant for logging the notify method in OperatorInstance */
 const OPERATOR_INSTANCE_METHOD_NAME_NOTIFY = "OperatorInstance.notify";
 /** @private Constant for logging the answer method in OperatorInstance */
@@ -2806,9 +2808,6 @@ const OperatorInstance = functoolsKit.makeExtendable(class {
                 clientId: this.clientId,
                 agentName,
             });
-        if (this.callbacks.onInit) {
-            this.callbacks.onInit(clientId, agentName);
-        }
     }
     /**
      * Connects an answer subscription
@@ -2823,6 +2822,20 @@ const OperatorInstance = functoolsKit.makeExtendable(class {
         this._answerSubject.unsubscribeAll();
         this._answerSubject.subscribe(next);
     }
+    /**
+     * Init the operator connection
+     * @returns {Promise<void>}
+     */
+    async init() {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            swarm$1.loggerService.debug(OPERATOR_INSTANCE_METHOD_NAME_INIT, {
+                clientId: this.clientId,
+                agentName: this.agentName,
+            });
+        if (this.callbacks.onInit) {
+            this.callbacks.onInit(this.clientId, this.agentName);
+        }
+    }
     /**
      * Sends a notification
      * @param {string} content - Notification content
@@ -2945,7 +2958,9 @@ class OperatorUtils {
                 clientId,
                 agentName,
             });
+        const isInitial = this.getOperator.has(`${clientId}-${agentName}`);
         const operator = this.getOperator(clientId, agentName);
+        isInitial && operator.init();
         return (message, next) => {
             operator.connectAnswer(next);
             operator.recieveMessage(message);
@@ -3059,6 +3074,10 @@ const CC_DEFAULT_WRITE_EMBEDDING_CACHE = (embeddings, embeddingName, stringHash)
  * @returns {(message: string, next: (answer: string) => void) => DisposeFn}
  */
 const CC_DEFAULT_CONNECT_OPERATOR = (clientId, agentName) => OperatorAdapter.connectOperator(clientId, agentName);
+/**
+ * Flag to enable operator timeout, used in `ClientOperator` for message processing.
+ */
+const CC_ENABLE_OPERATOR_TIMEOUT = false;
 const GLOBAL_CONFIG = {
     CC_TOOL_CALL_EXCEPTION_FLUSH_PROMPT,
     CC_TOOL_CALL_EXCEPTION_RECOMPLETE_PROMPT,
@@ -3108,6 +3127,7 @@ const GLOBAL_CONFIG = {
     CC_DEFAULT_AGENT_TOOL_VALIDATE,
     CC_THROW_WHEN_NAVIGATION_RECURSION,
     CC_DEFAULT_CONNECT_OPERATOR,
+    CC_ENABLE_OPERATOR_TIMEOUT,
 };
 GLOBAL_CONFIG.CC_RESQUE_STRATEGY = "flush";
 /**
@@ -4418,6 +4438,9 @@ class ClientOperator {
     async waitForOutput() {
         GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
             this.params.logger.debug(`ClientOperator agentName=${this.params.agentName} clientId=${this.params.clientId} waitForOutput begin`);
+        if (!GLOBAL_CONFIG.CC_ENABLE_OPERATOR_TIMEOUT) {
+            return await this._outgoingSubject.toPromise();
+        }
         const result = await Promise.race([
             this._outgoingSubject.toPromise(),
             functoolsKit.sleep(OPERATOR_SIGNAL_TIMEOUT).then(() => OPERATOR_SIGNAL_SYMBOL),
@@ -4428,8 +4451,6 @@ class ClientOperator {
             await this._operatorSignal.dispose();
             return "";
         }
-        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
-            this.params.logger.debug(`ClientOperator agentName=${this.params.agentName} clientId=${this.params.clientId} waitForOutput end`, { result });
         return result;
     }
     /**

package/build/index.mjs

@@ -2761,6 +2761,8 @@ const Logger = LoggerAdapter;
 const OPERATOR_INSTANCE_METHOD_NAME_CTOR = "OperatorInstance.CTOR";
 /** @private Constant for logging the connectAnswer method in OperatorInstance */
 const OPERATOR_INSTANCE_METHOD_NAME_CONNECT_ANSWER = "OperatorInstance.connectAnswer";
+/** @private Constant for logging the init method in OperatorInstance */
+const OPERATOR_INSTANCE_METHOD_NAME_INIT = "OperatorInstance.init";
 /** @private Constant for logging the notify method in OperatorInstance */
 const OPERATOR_INSTANCE_METHOD_NAME_NOTIFY = "OperatorInstance.notify";
 /** @private Constant for logging the answer method in OperatorInstance */
@@ -2804,9 +2806,6 @@ const OperatorInstance = makeExtendable(class {
                 clientId: this.clientId,
                 agentName,
             });
-        if (this.callbacks.onInit) {
-            this.callbacks.onInit(clientId, agentName);
-        }
     }
     /**
      * Connects an answer subscription
@@ -2821,6 +2820,20 @@ const OperatorInstance = makeExtendable(class {
         this._answerSubject.unsubscribeAll();
         this._answerSubject.subscribe(next);
     }
+    /**
+     * Init the operator connection
+     * @returns {Promise<void>}
+     */
+    async init() {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            swarm$1.loggerService.debug(OPERATOR_INSTANCE_METHOD_NAME_INIT, {
+                clientId: this.clientId,
+                agentName: this.agentName,
+            });
+        if (this.callbacks.onInit) {
+            this.callbacks.onInit(this.clientId, this.agentName);
+        }
+    }
     /**
      * Sends a notification
      * @param {string} content - Notification content
@@ -2943,7 +2956,9 @@ class OperatorUtils {
                 clientId,
                 agentName,
             });
+        const isInitial = this.getOperator.has(`${clientId}-${agentName}`);
         const operator = this.getOperator(clientId, agentName);
+        isInitial && operator.init();
         return (message, next) => {
             operator.connectAnswer(next);
             operator.recieveMessage(message);
@@ -3057,6 +3072,10 @@ const CC_DEFAULT_WRITE_EMBEDDING_CACHE = (embeddings, embeddingName, stringHash)
  * @returns {(message: string, next: (answer: string) => void) => DisposeFn}
  */
 const CC_DEFAULT_CONNECT_OPERATOR = (clientId, agentName) => OperatorAdapter.connectOperator(clientId, agentName);
+/**
+ * Flag to enable operator timeout, used in `ClientOperator` for message processing.
+ */
+const CC_ENABLE_OPERATOR_TIMEOUT = false;
 const GLOBAL_CONFIG = {
     CC_TOOL_CALL_EXCEPTION_FLUSH_PROMPT,
     CC_TOOL_CALL_EXCEPTION_RECOMPLETE_PROMPT,
@@ -3106,6 +3125,7 @@ const GLOBAL_CONFIG = {
     CC_DEFAULT_AGENT_TOOL_VALIDATE,
     CC_THROW_WHEN_NAVIGATION_RECURSION,
     CC_DEFAULT_CONNECT_OPERATOR,
+    CC_ENABLE_OPERATOR_TIMEOUT,
 };
 GLOBAL_CONFIG.CC_RESQUE_STRATEGY = "flush";
 /**
@@ -4416,6 +4436,9 @@ class ClientOperator {
     async waitForOutput() {
         GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
             this.params.logger.debug(`ClientOperator agentName=${this.params.agentName} clientId=${this.params.clientId} waitForOutput begin`);
+        if (!GLOBAL_CONFIG.CC_ENABLE_OPERATOR_TIMEOUT) {
+            return await this._outgoingSubject.toPromise();
+        }
         const result = await Promise.race([
             this._outgoingSubject.toPromise(),
             sleep(OPERATOR_SIGNAL_TIMEOUT).then(() => OPERATOR_SIGNAL_SYMBOL),
@@ -4426,8 +4449,6 @@ class ClientOperator {
             await this._operatorSignal.dispose();
             return "";
         }
-        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
-            this.params.logger.debug(`ClientOperator agentName=${this.params.agentName} clientId=${this.params.clientId} waitForOutput end`, { result });
         return result;
     }
     /**

package/package.json

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

package/types.d.ts

@@ -11008,6 +11008,10 @@ interface IGlobalConfig {
      * and answers to be received via a callback mechanism.
      */
     CC_DEFAULT_CONNECT_OPERATOR: (clientId: string, agentName: AgentName) => (message: string, next: (answer: string) => void) => DisposeFn$1;
+    /**
+     * Flag to enable operator timeout, used in `ClientOperator` for message processing.
+     */
+    CC_ENABLE_OPERATOR_TIMEOUT: boolean;
 }
 
 declare const GLOBAL_CONFIG: IGlobalConfig;
@@ -11045,6 +11049,8 @@ interface IOperatorInstance {
     connectAnswer(next: (answer: string) => void): void;
     /** Sends an answer */
     answer(content: string): Promise<void>;
+    /** Init the connection */
+    init(): Promise<void>;
     /** Sends a notification */
     notify(content: string): Promise<void>;
     /** Receives a message */
@@ -11078,6 +11084,11 @@ declare const OperatorInstance: {
          * @param {(answer: string) => void} next - Answer handler callback
          */
         connectAnswer(next: (answer: string) => void): void;
+        /**
+         * Init the operator connection
+         * @returns {Promise<void>}
+         */
+        init(): Promise<void>;
         /**
          * Sends a notification
          * @param {string} content - Notification content
@@ -11103,6 +11114,10 @@ declare const OperatorInstance: {
         dispose(): Promise<void>;
     };
 };
+/**
+ * Type alias for an instance of OperatorInstance.
+ */
+type TOperatorInstance = InstanceType<typeof OperatorInstance>;
 /**
  * Operator control interface
  * @interface IOperatorControl
@@ -11882,4 +11897,4 @@ declare const Utils: {
     PersistEmbeddingUtils: typeof PersistEmbeddingUtils;
 };
 
-export { Adapter, Chat, type EventSource, ExecutionContextService, History, HistoryMemoryInstance, HistoryPersistInstance, type IAgentSchema, type IAgentTool, type IBaseEvent, type IBusEvent, type IBusEventContext, type IChatArgs, type IChatInstance, type IChatInstanceCallbacks, type ICompletionArgs, type ICompletionSchema, type ICustomEvent, type IEmbeddingSchema, type IGlobalConfig, type IHistoryAdapter, type IHistoryControl, type IHistoryInstance, type IHistoryInstanceCallbacks, type IIncomingMessage, type ILoggerAdapter, type ILoggerInstance, type ILoggerInstanceCallbacks, type IMakeConnectionConfig, type IMakeDisposeParams, type IModelMessage, type IOutgoingMessage, type IPersistActiveAgentData, type IPersistAliveData, type IPersistBase, type IPersistEmbeddingData, type IPersistMemoryData, type IPersistNavigationStackData, type IPersistPolicyData, type IPersistStateData, type IPersistStorageData, type IPolicySchema, type ISessionConfig, type IStateSchema, type IStorageData, type IStorageSchema, type ISwarmSchema, type ITool, type IToolCall, type IWikiSchema, Logger, LoggerInstance, MethodContextService, Operator, OperatorInstance, PayloadContextService, PersistAlive, PersistBase, PersistEmbedding, PersistList, PersistMemory, PersistPolicy, PersistState, PersistStorage, PersistSwarm, Policy, type ReceiveMessageFn, RoundRobin, Schema, type SendMessageFn, SharedState, SharedStorage, State, Storage, type THistoryInstanceCtor, type THistoryMemoryInstance, type THistoryPersistInstance, type TLoggerInstance, type TPersistBase, type TPersistBaseCtor, type TPersistList, type ToolValue, Utils, addAgent, addCompletion, addEmbedding, addPolicy, addState, addStorage, addSwarm, addTool, addWiki, beginContext, cancelOutput, cancelOutputForce, changeToAgent, changeToDefaultAgent, changeToPrevAgent, commitAssistantMessage, commitAssistantMessageForce, commitFlush, commitFlushForce, commitStopTools, commitStopToolsForce, commitSystemMessage, commitSystemMessageForce, commitToolOutput, commitToolOutputForce, commitUserMessage, commitUserMessageForce, complete, disposeConnection, dumpAgent, dumpClientPerformance, dumpDocs, dumpPerfomance, dumpSwarm, emit, emitForce, event, execute, executeForce, getAgentHistory, getAgentName, getAssistantHistory, getLastAssistantMessage, getLastSystemMessage, getLastUserMessage, getNavigationRoute, getPayload, getRawHistory, getSessionContext, getSessionMode, getUserHistory, hasNavigation, hasSession, listenAgentEvent, listenAgentEventOnce, listenEvent, listenEventOnce, listenExecutionEvent, listenExecutionEventOnce, listenHistoryEvent, listenHistoryEventOnce, listenPolicyEvent, listenPolicyEventOnce, listenSessionEvent, listenSessionEventOnce, listenStateEvent, listenStateEventOnce, listenStorageEvent, listenStorageEventOnce, listenSwarmEvent, listenSwarmEventOnce, makeAutoDispose, makeConnection, markOffline, markOnline, notify, notifyForce, question, questionForce, runStateless, runStatelessForce, session, setConfig, swarm };
+export { Adapter, Chat, type EventSource, ExecutionContextService, History, HistoryMemoryInstance, HistoryPersistInstance, type IAgentSchema, type IAgentTool, type IBaseEvent, type IBusEvent, type IBusEventContext, type IChatArgs, type IChatInstance, type IChatInstanceCallbacks, type ICompletionArgs, type ICompletionSchema, type ICustomEvent, type IEmbeddingSchema, type IGlobalConfig, type IHistoryAdapter, type IHistoryControl, type IHistoryInstance, type IHistoryInstanceCallbacks, type IIncomingMessage, type ILoggerAdapter, type ILoggerInstance, type ILoggerInstanceCallbacks, type IMakeConnectionConfig, type IMakeDisposeParams, type IModelMessage, type IOutgoingMessage, type IPersistActiveAgentData, type IPersistAliveData, type IPersistBase, type IPersistEmbeddingData, type IPersistMemoryData, type IPersistNavigationStackData, type IPersistPolicyData, type IPersistStateData, type IPersistStorageData, type IPolicySchema, type ISessionConfig, type IStateSchema, type IStorageData, type IStorageSchema, type ISwarmSchema, type ITool, type IToolCall, type IWikiSchema, Logger, LoggerInstance, MethodContextService, Operator, OperatorInstance, PayloadContextService, PersistAlive, PersistBase, PersistEmbedding, PersistList, PersistMemory, PersistPolicy, PersistState, PersistStorage, PersistSwarm, Policy, type ReceiveMessageFn, RoundRobin, Schema, type SendMessageFn, SharedState, SharedStorage, State, Storage, type THistoryInstanceCtor, type THistoryMemoryInstance, type THistoryPersistInstance, type TLoggerInstance, type TOperatorInstance, type TPersistBase, type TPersistBaseCtor, type TPersistList, type ToolValue, Utils, addAgent, addCompletion, addEmbedding, addPolicy, addState, addStorage, addSwarm, addTool, addWiki, beginContext, cancelOutput, cancelOutputForce, changeToAgent, changeToDefaultAgent, changeToPrevAgent, commitAssistantMessage, commitAssistantMessageForce, commitFlush, commitFlushForce, commitStopTools, commitStopToolsForce, commitSystemMessage, commitSystemMessageForce, commitToolOutput, commitToolOutputForce, commitUserMessage, commitUserMessageForce, complete, disposeConnection, dumpAgent, dumpClientPerformance, dumpDocs, dumpPerfomance, dumpSwarm, emit, emitForce, event, execute, executeForce, getAgentHistory, getAgentName, getAssistantHistory, getLastAssistantMessage, getLastSystemMessage, getLastUserMessage, getNavigationRoute, getPayload, getRawHistory, getSessionContext, getSessionMode, getUserHistory, hasNavigation, hasSession, listenAgentEvent, listenAgentEventOnce, listenEvent, listenEventOnce, listenExecutionEvent, listenExecutionEventOnce, listenHistoryEvent, listenHistoryEventOnce, listenPolicyEvent, listenPolicyEventOnce, listenSessionEvent, listenSessionEventOnce, listenStateEvent, listenStateEventOnce, listenStorageEvent, listenStorageEventOnce, listenSwarmEvent, listenSwarmEventOnce, makeAutoDispose, makeConnection, markOffline, markOnline, notify, notifyForce, question, questionForce, runStateless, runStatelessForce, session, setConfig, swarm };