agent-swarm-kit 1.0.176 → 1.0.178

package/build/index.cjs

@@ -4535,6 +4535,10 @@ const WAIT_FOR_OUTPUT_FN = async (self) => {
         agentName,
         output: await agent.waitForOutput(),
     }))
+        .concat(self._emitSubject.toPromise().then(async (output) => ({
+        agentName: await self.getAgentName(),
+        output,
+    })))
         .concat(self._cancelOutputSubject.toPromise())));
     const handleOutput = () => {
         getOutput.cancel();
@@ -4611,6 +4615,13 @@ class ClientSwarm {
          * @type {AgentName[] | typeof STACK_NEED_FETCH}
          */
         this._navigationStack = STACK_NEED_FETCH;
+        /**
+         * Subject for emitting output messages to subscribers, used by emit and connect methods.
+         * Provides an asynchronous stream of validated messages, supporting real-time updates to external connectors.
+         * @type {Subject<string>}
+         * @readonly
+         */
+        this._emitSubject = new functoolsKit.Subject();
         /**
          * Subject that emits to cancel output waiting, providing an empty output string and agent name.
          * Triggered by cancelOutput to interrupt waitForOutput, ensuring responsive cancellation.
@@ -4628,6 +4639,30 @@ class ClientSwarm {
                 params,
             });
     }
+    /**
+     * Emits a message to subscribers via _emitSubject after validating it against the policy (ClientPolicy).
+     * Emits the ban message if validation fails, notifying subscribers and logging via BusService.
+     * Supports SwarmConnectionService by broadcasting session outputs within the swarm.
+     * @param {string} message - The message to emit, typically an agent response or tool output.
+     * @returns {Promise<void>} Resolves when the message (or ban message) is emitted and the event is logged.
+     */
+    async emit(message) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            this.params.logger.debug(`ClientSwarm swarmName=${this.params.swarmName} clientId=${this.params.clientId} emit`);
+        await this._emitSubject.next(message);
+        await this.params.bus.emit(this.params.clientId, {
+            type: "emit",
+            source: "session-bus",
+            input: {
+                message,
+            },
+            output: {},
+            context: {
+                swarmName: this.params.swarmName,
+            },
+            clientId: this.params.clientId,
+        });
+    }
     /**
      * Pops the most recent agent from the navigation stack, falling back to the default agent if empty.
      * Updates and persists the stack via params.setNavigationStack, supporting ClientSession’s agent navigation.
@@ -4861,6 +4896,18 @@ class SwarmConnectionService {
                 callbacks,
             });
         });
+        /**
+         * Emits a message to the session, typically for asynchronous communication.
+         * Delegates to ClientSession.emit, using context from MethodContextService to identify the session, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
+         * Mirrors SessionPublicService’s emit, supporting ClientAgent’s output handling and SwarmPublicService’s messaging.
+         * @param {string} content - The content to emit to the session.
+         * @returns {Promise<void>} A promise resolving when the message is emitted.
+         */
+        this.emit = async (message) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info(`swarmConnectionService emit`, { message });
+            return await this.getSwarm(this.methodContextService.context.clientId, this.methodContextService.context.swarmName).emit(message);
+        };
         /**
          * Pops the navigation stack or returns the default agent if the stack is empty.
          * Delegates to ClientSwarm.navigationPop, using context from MethodContextService to identify the swarm, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
@@ -5150,13 +5197,6 @@ class ClientSession {
      */
     constructor(params) {
         this.params = params;
-        /**
-         * Subject for emitting output messages to subscribers, used by emit and connect methods.
-         * Provides an asynchronous stream of validated messages, supporting real-time updates to external connectors.
-         * @type {Subject<string>}
-         * @readonly
-         */
-        this._emitSubject = new functoolsKit.Subject();
         GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
             this.params.logger.debug(`ClientSession clientId=${this.params.clientId} CTOR`, {
                 params,
@@ -5164,7 +5204,7 @@ class ClientSession {
         this.params.onInit && this.params.onInit(params.clientId, params.swarmName);
     }
     /**
-     * Emits a message to subscribers via _emitSubject after validating it against the policy (ClientPolicy).
+     * Emits a message to subscribers via swarm _emitSubject after validating it against the policy (ClientPolicy).
      * Emits the ban message if validation fails, notifying subscribers and logging via BusService.
      * Supports SwarmConnectionService by broadcasting session outputs within the swarm.
      * @param {string} message - The message to emit, typically an agent response or tool output.
@@ -5180,12 +5220,12 @@ class ClientSession {
                 this.params.logger.debug(`ClientSession clientId=${this.params.clientId} emit method canceled due to the banhammer of a client`, {
                     message,
                 });
-            await this._emitSubject.next(await this.params.policy.getBanMessage(this.params.clientId, this.params.swarmName));
+            await this.params.swarm.emit(await this.params.policy.getBanMessage(this.params.clientId, this.params.swarmName));
             return;
         }
         this.params.onEmit &&
             this.params.onEmit(this.params.clientId, this.params.swarmName, message);
-        await this._emitSubject.next(message);
+        await this.params.swarm.emit(message);
         await this.params.bus.emit(this.params.clientId, {
             type: "emit",
             source: "session-bus",
@@ -5452,11 +5492,6 @@ class ClientSession {
             this.params.logger.debug(`ClientSession clientId=${this.params.clientId} connect`);
         this.params.onConnect &&
             this.params.onConnect(this.params.clientId, this.params.swarmName);
-        this._emitSubject.subscribe(async (data) => await connector({
-            data,
-            agentName: await this.params.swarm.getAgentName(),
-            clientId: this.params.clientId,
-        }));
         this.params.bus.emit(this.params.clientId, {
             type: "connect",
             source: "session-bus",
@@ -6980,6 +7015,36 @@ class SwarmPublicService {
          * @private
          */
         this.swarmConnectionService = inject(TYPES.swarmConnectionService);
+        /**
+         * Emits a message to the session for a specific client and swarm.
+         * Wraps SessionConnectionService.emit with MethodContextService for scoping, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
+         * Used in ClientAgent (e.g., session-level messaging) and AgentPublicService (e.g., swarm context emission).
+         * @param {string} content - The message content to emit to the session.
+         * @param {string} methodName - The name of the method invoking the operation, logged and scoped in context.
+         * @param {string} clientId - The client ID, tying to ClientAgent sessions and PerfService tracking.
+         * @param {SwarmName} swarmName - The swarm name, sourced from Swarm.interface, used in SwarmMetaService context.
+         * @returns {Promise<void>} A promise resolving when the message is emitted.
+         */
+        this.emit = async (content, methodName, clientId, swarmName) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info("swarmPublicService emit", {
+                    content,
+                    clientId,
+                    methodName,
+                    swarmName,
+                });
+            return await MethodContextService.runInContext(async () => {
+                return await this.swarmConnectionService.emit(content);
+            }, {
+                methodName,
+                clientId,
+                swarmName,
+                policyName: "",
+                agentName: "",
+                storageName: "",
+                stateName: "",
+            });
+        };
         /**
          * Pops the navigation stack or returns the default agent for the swarm, scoped to a client.
          * Wraps SwarmConnectionService.navigationPop with MethodContextService for scoping, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
@@ -13979,11 +14044,6 @@ const emitForce = beginContext(async (content, clientId) => {
             content,
             clientId,
         });
-    // Check if the session mode is "makeConnection"
-    if (swarm$1.sessionValidationService.getSessionMode(clientId) !==
-        "makeConnection") {
-        throw new Error(`agent-swarm-kit emitForce session is not makeConnection clientId=${clientId}`);
-    }
     // Validate the session and swarm
     swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$q);
     const swarmName = swarm$1.sessionValidationService.getSwarm(clientId);
@@ -14296,11 +14356,6 @@ const emit = beginContext(async (content, clientId, agentName) => {
             clientId,
             agentName,
         });
-    // Check if the session mode is "makeConnection"
-    if (swarm$1.sessionValidationService.getSessionMode(clientId) !==
-        "makeConnection") {
-        throw new Error(`agent-swarm-kit emit session is not makeConnection clientId=${clientId}`);
-    }
     // Validate the agent, session, and swarm
     swarm$1.agentValidationService.validate(agentName, METHOD_NAME$l);
     swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$l);
@@ -14760,7 +14815,7 @@ const METHOD_NAME$g = "function.target.session";
  * @param {SwarmName} swarmName - The name of the swarm to connect to.
  * @returns {Object} An object containing `complete` and `dispose` methods for session management.
  */
-const sessionInternal = (clientId, swarmName) => {
+const sessionInternal = (clientId, swarmName, { onDispose = () => { } } = {}) => {
     const executionId = functoolsKit.randomString();
     // Log the operation details if logging is enabled in GLOBAL_CONFIG
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
@@ -14799,7 +14854,10 @@ const sessionInternal = (clientId, swarmName) => {
         complete: (async (content) => {
             return await complete(content);
         }),
-        dispose: async () => await disposeConnection(clientId, swarmName, METHOD_NAME$g),
+        dispose: async () => {
+            await disposeConnection(clientId, swarmName, METHOD_NAME$g);
+            await onDispose();
+        },
     };
 };
 /**
@@ -14818,8 +14876,10 @@ const sessionInternal = (clientId, swarmName) => {
  * console.log(result); // Outputs the swarm's response
  * await dispose();
  */
-const session = (clientId, swarmName) => {
-    const { complete, dispose } = sessionInternal(clientId, swarmName);
+const session = (clientId, swarmName, { onDispose } = {}) => {
+    const { complete, dispose } = sessionInternal(clientId, swarmName, {
+        onDispose,
+    });
     let isMounted = true;
     const online = functoolsKit.singleshot(async () => {
         await markOnline(clientId, swarmName);
@@ -14863,8 +14923,10 @@ const session = (clientId, swarmName) => {
  * console.log(result);
  * await dispose();
  */
-session.scheduled = (clientId, swarmName, { delay = SCHEDULED_DELAY } = {}) => {
-    const { complete, dispose } = sessionInternal(clientId, swarmName);
+session.scheduled = (clientId, swarmName, { delay = SCHEDULED_DELAY, onDispose } = {}) => {
+    const { complete, dispose } = sessionInternal(clientId, swarmName, {
+        onDispose,
+    });
     let isMounted = true;
     const online = functoolsKit.singleshot(async () => {
         await markOnline(clientId, swarmName);
@@ -14928,8 +14990,10 @@ session.scheduled = (clientId, swarmName, { delay = SCHEDULED_DELAY } = {}) => {
  * console.log(result);
  * await dispose();
  */
-session.rate = (clientId, swarmName, { delay = SCHEDULED_DELAY } = {}) => {
-    const { complete, dispose } = sessionInternal(clientId, swarmName);
+session.rate = (clientId, swarmName, { delay = SCHEDULED_DELAY, onDispose } = {}) => {
+    const { complete, dispose } = sessionInternal(clientId, swarmName, {
+        onDispose,
+    });
     let isMounted = true;
     const online = functoolsKit.singleshot(async () => {
         await markOnline(clientId, swarmName);

package/build/index.mjs

@@ -4533,6 +4533,10 @@ const WAIT_FOR_OUTPUT_FN = async (self) => {
         agentName,
         output: await agent.waitForOutput(),
     }))
+        .concat(self._emitSubject.toPromise().then(async (output) => ({
+        agentName: await self.getAgentName(),
+        output,
+    })))
         .concat(self._cancelOutputSubject.toPromise())));
     const handleOutput = () => {
         getOutput.cancel();
@@ -4609,6 +4613,13 @@ class ClientSwarm {
          * @type {AgentName[] | typeof STACK_NEED_FETCH}
          */
         this._navigationStack = STACK_NEED_FETCH;
+        /**
+         * Subject for emitting output messages to subscribers, used by emit and connect methods.
+         * Provides an asynchronous stream of validated messages, supporting real-time updates to external connectors.
+         * @type {Subject<string>}
+         * @readonly
+         */
+        this._emitSubject = new Subject();
         /**
          * Subject that emits to cancel output waiting, providing an empty output string and agent name.
          * Triggered by cancelOutput to interrupt waitForOutput, ensuring responsive cancellation.
@@ -4626,6 +4637,30 @@ class ClientSwarm {
                 params,
             });
     }
+    /**
+     * Emits a message to subscribers via _emitSubject after validating it against the policy (ClientPolicy).
+     * Emits the ban message if validation fails, notifying subscribers and logging via BusService.
+     * Supports SwarmConnectionService by broadcasting session outputs within the swarm.
+     * @param {string} message - The message to emit, typically an agent response or tool output.
+     * @returns {Promise<void>} Resolves when the message (or ban message) is emitted and the event is logged.
+     */
+    async emit(message) {
+        GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
+            this.params.logger.debug(`ClientSwarm swarmName=${this.params.swarmName} clientId=${this.params.clientId} emit`);
+        await this._emitSubject.next(message);
+        await this.params.bus.emit(this.params.clientId, {
+            type: "emit",
+            source: "session-bus",
+            input: {
+                message,
+            },
+            output: {},
+            context: {
+                swarmName: this.params.swarmName,
+            },
+            clientId: this.params.clientId,
+        });
+    }
     /**
      * Pops the most recent agent from the navigation stack, falling back to the default agent if empty.
      * Updates and persists the stack via params.setNavigationStack, supporting ClientSession’s agent navigation.
@@ -4859,6 +4894,18 @@ class SwarmConnectionService {
                 callbacks,
             });
         });
+        /**
+         * Emits a message to the session, typically for asynchronous communication.
+         * Delegates to ClientSession.emit, using context from MethodContextService to identify the session, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
+         * Mirrors SessionPublicService’s emit, supporting ClientAgent’s output handling and SwarmPublicService’s messaging.
+         * @param {string} content - The content to emit to the session.
+         * @returns {Promise<void>} A promise resolving when the message is emitted.
+         */
+        this.emit = async (message) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info(`swarmConnectionService emit`, { message });
+            return await this.getSwarm(this.methodContextService.context.clientId, this.methodContextService.context.swarmName).emit(message);
+        };
         /**
          * Pops the navigation stack or returns the default agent if the stack is empty.
          * Delegates to ClientSwarm.navigationPop, using context from MethodContextService to identify the swarm, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
@@ -5148,13 +5195,6 @@ class ClientSession {
      */
     constructor(params) {
         this.params = params;
-        /**
-         * Subject for emitting output messages to subscribers, used by emit and connect methods.
-         * Provides an asynchronous stream of validated messages, supporting real-time updates to external connectors.
-         * @type {Subject<string>}
-         * @readonly
-         */
-        this._emitSubject = new Subject();
         GLOBAL_CONFIG.CC_LOGGER_ENABLE_DEBUG &&
             this.params.logger.debug(`ClientSession clientId=${this.params.clientId} CTOR`, {
                 params,
@@ -5162,7 +5202,7 @@ class ClientSession {
         this.params.onInit && this.params.onInit(params.clientId, params.swarmName);
     }
     /**
-     * Emits a message to subscribers via _emitSubject after validating it against the policy (ClientPolicy).
+     * Emits a message to subscribers via swarm _emitSubject after validating it against the policy (ClientPolicy).
      * Emits the ban message if validation fails, notifying subscribers and logging via BusService.
      * Supports SwarmConnectionService by broadcasting session outputs within the swarm.
      * @param {string} message - The message to emit, typically an agent response or tool output.
@@ -5178,12 +5218,12 @@ class ClientSession {
                 this.params.logger.debug(`ClientSession clientId=${this.params.clientId} emit method canceled due to the banhammer of a client`, {
                     message,
                 });
-            await this._emitSubject.next(await this.params.policy.getBanMessage(this.params.clientId, this.params.swarmName));
+            await this.params.swarm.emit(await this.params.policy.getBanMessage(this.params.clientId, this.params.swarmName));
             return;
         }
         this.params.onEmit &&
             this.params.onEmit(this.params.clientId, this.params.swarmName, message);
-        await this._emitSubject.next(message);
+        await this.params.swarm.emit(message);
         await this.params.bus.emit(this.params.clientId, {
             type: "emit",
             source: "session-bus",
@@ -5450,11 +5490,6 @@ class ClientSession {
             this.params.logger.debug(`ClientSession clientId=${this.params.clientId} connect`);
         this.params.onConnect &&
             this.params.onConnect(this.params.clientId, this.params.swarmName);
-        this._emitSubject.subscribe(async (data) => await connector({
-            data,
-            agentName: await this.params.swarm.getAgentName(),
-            clientId: this.params.clientId,
-        }));
         this.params.bus.emit(this.params.clientId, {
             type: "connect",
             source: "session-bus",
@@ -6978,6 +7013,36 @@ class SwarmPublicService {
          * @private
          */
         this.swarmConnectionService = inject(TYPES.swarmConnectionService);
+        /**
+         * Emits a message to the session for a specific client and swarm.
+         * Wraps SessionConnectionService.emit with MethodContextService for scoping, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
+         * Used in ClientAgent (e.g., session-level messaging) and AgentPublicService (e.g., swarm context emission).
+         * @param {string} content - The message content to emit to the session.
+         * @param {string} methodName - The name of the method invoking the operation, logged and scoped in context.
+         * @param {string} clientId - The client ID, tying to ClientAgent sessions and PerfService tracking.
+         * @param {SwarmName} swarmName - The swarm name, sourced from Swarm.interface, used in SwarmMetaService context.
+         * @returns {Promise<void>} A promise resolving when the message is emitted.
+         */
+        this.emit = async (content, methodName, clientId, swarmName) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info("swarmPublicService emit", {
+                    content,
+                    clientId,
+                    methodName,
+                    swarmName,
+                });
+            return await MethodContextService.runInContext(async () => {
+                return await this.swarmConnectionService.emit(content);
+            }, {
+                methodName,
+                clientId,
+                swarmName,
+                policyName: "",
+                agentName: "",
+                storageName: "",
+                stateName: "",
+            });
+        };
         /**
          * Pops the navigation stack or returns the default agent for the swarm, scoped to a client.
          * Wraps SwarmConnectionService.navigationPop with MethodContextService for scoping, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
@@ -13977,11 +14042,6 @@ const emitForce = beginContext(async (content, clientId) => {
             content,
             clientId,
         });
-    // Check if the session mode is "makeConnection"
-    if (swarm$1.sessionValidationService.getSessionMode(clientId) !==
-        "makeConnection") {
-        throw new Error(`agent-swarm-kit emitForce session is not makeConnection clientId=${clientId}`);
-    }
     // Validate the session and swarm
     swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$q);
     const swarmName = swarm$1.sessionValidationService.getSwarm(clientId);
@@ -14294,11 +14354,6 @@ const emit = beginContext(async (content, clientId, agentName) => {
             clientId,
             agentName,
         });
-    // Check if the session mode is "makeConnection"
-    if (swarm$1.sessionValidationService.getSessionMode(clientId) !==
-        "makeConnection") {
-        throw new Error(`agent-swarm-kit emit session is not makeConnection clientId=${clientId}`);
-    }
     // Validate the agent, session, and swarm
     swarm$1.agentValidationService.validate(agentName, METHOD_NAME$l);
     swarm$1.sessionValidationService.validate(clientId, METHOD_NAME$l);
@@ -14758,7 +14813,7 @@ const METHOD_NAME$g = "function.target.session";
  * @param {SwarmName} swarmName - The name of the swarm to connect to.
  * @returns {Object} An object containing `complete` and `dispose` methods for session management.
  */
-const sessionInternal = (clientId, swarmName) => {
+const sessionInternal = (clientId, swarmName, { onDispose = () => { } } = {}) => {
     const executionId = randomString();
     // Log the operation details if logging is enabled in GLOBAL_CONFIG
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
@@ -14797,7 +14852,10 @@ const sessionInternal = (clientId, swarmName) => {
         complete: (async (content) => {
             return await complete(content);
         }),
-        dispose: async () => await disposeConnection(clientId, swarmName, METHOD_NAME$g),
+        dispose: async () => {
+            await disposeConnection(clientId, swarmName, METHOD_NAME$g);
+            await onDispose();
+        },
     };
 };
 /**
@@ -14816,8 +14874,10 @@ const sessionInternal = (clientId, swarmName) => {
  * console.log(result); // Outputs the swarm's response
  * await dispose();
  */
-const session = (clientId, swarmName) => {
-    const { complete, dispose } = sessionInternal(clientId, swarmName);
+const session = (clientId, swarmName, { onDispose } = {}) => {
+    const { complete, dispose } = sessionInternal(clientId, swarmName, {
+        onDispose,
+    });
     let isMounted = true;
     const online = singleshot(async () => {
         await markOnline(clientId, swarmName);
@@ -14861,8 +14921,10 @@ const session = (clientId, swarmName) => {
  * console.log(result);
  * await dispose();
  */
-session.scheduled = (clientId, swarmName, { delay = SCHEDULED_DELAY } = {}) => {
-    const { complete, dispose } = sessionInternal(clientId, swarmName);
+session.scheduled = (clientId, swarmName, { delay = SCHEDULED_DELAY, onDispose } = {}) => {
+    const { complete, dispose } = sessionInternal(clientId, swarmName, {
+        onDispose,
+    });
     let isMounted = true;
     const online = singleshot(async () => {
         await markOnline(clientId, swarmName);
@@ -14926,8 +14988,10 @@ session.scheduled = (clientId, swarmName, { delay = SCHEDULED_DELAY } = {}) => {
  * console.log(result);
  * await dispose();
  */
-session.rate = (clientId, swarmName, { delay = SCHEDULED_DELAY } = {}) => {
-    const { complete, dispose } = sessionInternal(clientId, swarmName);
+session.rate = (clientId, swarmName, { delay = SCHEDULED_DELAY, onDispose } = {}) => {
+    const { complete, dispose } = sessionInternal(clientId, swarmName, {
+        onDispose,
+    });
     let isMounted = true;
     const online = singleshot(async () => {
         await markOnline(clientId, swarmName);

package/package.json

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

package/types.d.ts

@@ -1131,6 +1131,13 @@ interface ISwarm {
      * @throws {Error} If setting the agent fails (e.g., due to persistence issues or invalid name).
      */
     setAgentName(agentName: AgentName): Promise<void>;
+    /**
+     * Emits a message to the session's communication channel.
+     * @param {string} message - The message content to emit.
+     * @returns {Promise<void>} A promise that resolves when the message is successfully emitted.
+     * @throws {Error} If the emission fails due to connection issues or invalid message format.
+     */
+    emit(message: string): Promise<void>;
 }
 /**
  * Type representing the unique name of a swarm within the system.
@@ -3894,6 +3901,13 @@ declare class ClientSwarm implements ISwarm {
      * @type {AgentName[] | typeof STACK_NEED_FETCH}
      */
     _navigationStack: AgentName[] | typeof STACK_NEED_FETCH;
+    /**
+     * Subject for emitting output messages to subscribers, used by emit and connect methods.
+     * Provides an asynchronous stream of validated messages, supporting real-time updates to external connectors.
+     * @type {Subject<string>}
+     * @readonly
+     */
+    readonly _emitSubject: Subject<string>;
     /**
      * Subject that emits to cancel output waiting, providing an empty output string and agent name.
      * Triggered by cancelOutput to interrupt waitForOutput, ensuring responsive cancellation.
@@ -3915,6 +3929,14 @@ declare class ClientSwarm implements ISwarm {
      * @param {ISwarmParams} params - The parameters for initializing the swarm, including clientId, swarmName, agentMap, getActiveAgent, etc.
      */
     constructor(params: ISwarmParams);
+    /**
+     * Emits a message to subscribers via _emitSubject after validating it against the policy (ClientPolicy).
+     * Emits the ban message if validation fails, notifying subscribers and logging via BusService.
+     * Supports SwarmConnectionService by broadcasting session outputs within the swarm.
+     * @param {string} message - The message to emit, typically an agent response or tool output.
+     * @returns {Promise<void>} Resolves when the message (or ban message) is emitted and the event is logged.
+     */
+    emit(message: string): Promise<void>;
     /**
      * Pops the most recent agent from the navigation stack, falling back to the default agent if empty.
      * Updates and persists the stack via params.setNavigationStack, supporting ClientSession’s agent navigation.
@@ -4017,6 +4039,14 @@ declare class SwarmConnectionService implements ISwarm {
      * @returns {ClientSwarm} The memoized ClientSwarm instance configured for the client and swarm.
      */
     getSwarm: ((clientId: string, swarmName: string) => ClientSwarm) & functools_kit.IClearableMemoize<string> & functools_kit.IControlMemoize<string, ClientSwarm>;
+    /**
+     * Emits a message to the session, typically for asynchronous communication.
+     * Delegates to ClientSession.emit, using context from MethodContextService to identify the session, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
+     * Mirrors SessionPublicService’s emit, supporting ClientAgent’s output handling and SwarmPublicService’s messaging.
+     * @param {string} content - The content to emit to the session.
+     * @returns {Promise<void>} A promise resolving when the message is emitted.
+     */
+    emit: (message: string) => Promise<void>;
     /**
      * Pops the navigation stack or returns the default agent if the stack is empty.
      * Delegates to ClientSwarm.navigationPop, using context from MethodContextService to identify the swarm, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
@@ -4196,13 +4226,6 @@ declare class CompletionSchemaService {
  */
 declare class ClientSession implements ISession {
     readonly params: ISessionParams;
-    /**
-     * Subject for emitting output messages to subscribers, used by emit and connect methods.
-     * Provides an asynchronous stream of validated messages, supporting real-time updates to external connectors.
-     * @type {Subject<string>}
-     * @readonly
-     */
-    readonly _emitSubject: Subject<string>;
     /**
      * Constructs a new ClientSession instance with the provided parameters.
      * Invokes the onInit callback if defined and logs construction if debugging is enabled.
@@ -4210,7 +4233,7 @@ declare class ClientSession implements ISession {
      */
     constructor(params: ISessionParams);
     /**
-     * Emits a message to subscribers via _emitSubject after validating it against the policy (ClientPolicy).
+     * Emits a message to subscribers via swarm _emitSubject after validating it against the policy (ClientPolicy).
      * Emits the ban message if validation fails, notifying subscribers and logging via BusService.
      * Supports SwarmConnectionService by broadcasting session outputs within the swarm.
      * @param {string} message - The message to emit, typically an agent response or tool output.
@@ -4940,6 +4963,17 @@ declare class SwarmPublicService implements TSwarmConnectionService {
      * @private
      */
     private readonly swarmConnectionService;
+    /**
+     * Emits a message to the session for a specific client and swarm.
+     * Wraps SessionConnectionService.emit with MethodContextService for scoping, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
+     * Used in ClientAgent (e.g., session-level messaging) and AgentPublicService (e.g., swarm context emission).
+     * @param {string} content - The message content to emit to the session.
+     * @param {string} methodName - The name of the method invoking the operation, logged and scoped in context.
+     * @param {string} clientId - The client ID, tying to ClientAgent sessions and PerfService tracking.
+     * @param {SwarmName} swarmName - The swarm name, sourced from Swarm.interface, used in SwarmMetaService context.
+     * @returns {Promise<void>} A promise resolving when the message is emitted.
+     */
+    emit: (content: string, methodName: string, clientId: string, swarmName: SwarmName) => Promise<void>;
     /**
      * Pops the navigation stack or returns the default agent for the swarm, scoped to a client.
      * Wraps SwarmConnectionService.navigationPop with MethodContextService for scoping, logging via LoggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is true.
@@ -8734,7 +8768,7 @@ declare const complete: <Payload extends object = object>(content: string, clien
  * await dispose();
  */
 declare const session: {
-    <Payload extends object = object>(clientId: string, swarmName: SwarmName): {
+    <Payload extends object = object>(clientId: string, swarmName: SwarmName, { onDispose }?: Partial<Omit<ISessionConfig, "delay">>): {
         complete: (content: string, payload?: Payload) => Promise<string>;
         dispose: () => Promise<void>;
     };
@@ -8755,7 +8789,7 @@ declare const session: {
      * console.log(result);
      * await dispose();
      */
-    scheduled<Payload extends object = object>(clientId: string, swarmName: SwarmName, { delay }?: Partial<ISessionConfig>): {
+    scheduled<Payload extends object = object>(clientId: string, swarmName: SwarmName, { delay, onDispose }?: Partial<ISessionConfig>): {
         complete: (content: string, payload?: Payload) => Promise<string>;
         dispose: () => Promise<void>;
     };
@@ -8776,7 +8810,7 @@ declare const session: {
      * console.log(result);
      * await dispose();
      */
-    rate<Payload extends object = object>(clientId: string, swarmName: SwarmName, { delay }?: Partial<ISessionConfig>): {
+    rate<Payload extends object = object>(clientId: string, swarmName: SwarmName, { delay, onDispose }?: Partial<ISessionConfig>): {
         complete(content: string, payload?: Payload): Promise<string>;
         dispose: () => Promise<void>;
     };
@@ -8789,6 +8823,7 @@ declare const session: {
  */
 interface ISessionConfig {
     delay?: number;
+    onDispose?: () => void;
 }
 
 /**