agent-swarm-kit 3.2.0 → 5.0.0

package/package.json

@@ -1,89 +1,89 @@
-{
-  "name": "agent-swarm-kit",
-  "version": "3.2.0",
-  "description": "A TypeScript library for building orchestrated framework-agnostic multi-agent AI systems",
-  "author": {
-    "name": "Petr Tripolsky",
-    "email": "tripolskypetr@gmail.com",
-    "url": "https://github.com/tripolskypetr"
-  },
-  "funding": {
-    "type": "individual",
-    "url": "http://paypal.me/tripolskypetr"
-  },
-  "license": "MIT",
-  "homepage": "https://agent-swarm.github.io/modules.html",
-  "keywords": [
-    "NVIDIA NIM",
-    "OpenAI",
-    "GPT4All",
-    "Ollama",
-    "LM Studio",
-    "llama",
-    "gpt",
-    "mistral"
-  ],
-  "files": [
-    "build",
-    "types.d.ts",
-    "README.md"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/tripolskypetr/agent-swarm-kit",
-    "documentation": "https://github.com/tripolskypetr/agent-swarm-kit/tree/master/docs"
-  },
-  "bugs": {
-    "url": "https://github.com/tripolskypetr/agent-swarm-kit/issues"
-  },
-  "scripts": {
-    "build": "rollup -c",
-    "test": "npm run build && node ./test/index.mjs",
-    "benchmark": "npm run build && node ./benchmark/index.mjs",
-    "build:docs": "rimraf docs && mkdir docs && node ./scripts/dts-docs.cjs ./types.d.ts ./docs",
-    "docs:gpt": "npm run build && node ./scripts/gpt-docs.mjs",
-    "docs:uml": "npm run build && node ./scripts/uml.mjs",
-    "docs:www": "rimraf docs/wwwroot && typedoc && node ./packages/typedoc-yandex-metrica/index.mjs",
-    "docs:demo:win": ".\\scripts\\win\\build_demo_docs.bat",
-    "docs:demo": "sh ./scripts/linux/build_demo_docs.sh",
-    "docs:demo:concat": "node ./packages/concat-demo-docs/index.mjs",
-    "repl": "dotenv -e .env -- npm run build && node -e \"import('./scripts/repl.mjs')\" --interactive"
-  },
-  "main": "build/index.cjs",
-  "module": "build/index.mjs",
-  "source": "src/index.ts",
-  "types": "./types.d.ts",
-  "exports": {
-    "require": "./build/index.cjs",
-    "types": "./types.d.ts",
-    "import": "./build/index.mjs",
-    "default": "./build/index.cjs"
-  },
-  "devDependencies": {
-    "@rollup/plugin-typescript": "11.1.6",
-    "@types/lodash-es": "4.17.12",
-    "@types/node": "22.9.0",
-    "@types/xml2js": "0.4.14",
-    "glob": "11.0.1",
-    "ollama": "0.5.14",
-    "rimraf": "6.0.1",
-    "rollup": "3.29.5",
-    "rollup-plugin-dts": "6.1.1",
-    "rollup-plugin-peer-deps-external": "2.2.4",
-    "tslib": "2.7.0",
-    "typedoc": "0.27.9",
-    "undici": "6.21.2",
-    "worker-testbed": "2.1.0"
-  },
-  "peerDependencies": {
-    "typescript": "^5.0.0"
-  },
-  "dependencies": {
-    "di-kit": "^1.1.1",
-    "di-scoped": "^1.0.21",
-    "functools-kit": "^3.0.0",
-    "get-moment-stamp": "^2.0.0",
-    "lodash-es": "4.17.21",
-    "xml2js": "0.6.2"
-  }
-}
+{
+  "name": "agent-swarm-kit",
+  "version": "5.0.0",
+  "description": "A TypeScript library for building orchestrated framework-agnostic multi-agent AI systems",
+  "author": {
+    "name": "Petr Tripolsky",
+    "email": "tripolskypetr@gmail.com",
+    "url": "https://github.com/tripolskypetr"
+  },
+  "funding": {
+    "type": "individual",
+    "url": "http://paypal.me/tripolskypetr"
+  },
+  "license": "MIT",
+  "homepage": "https://agent-swarm.github.io/modules.html",
+  "keywords": [
+    "NVIDIA NIM",
+    "OpenAI",
+    "GPT4All",
+    "Ollama",
+    "LM Studio",
+    "llama",
+    "gpt",
+    "mistral"
+  ],
+  "files": [
+    "build",
+    "types.d.ts",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tripolskypetr/agent-swarm-kit",
+    "documentation": "https://github.com/tripolskypetr/agent-swarm-kit/tree/master/docs"
+  },
+  "bugs": {
+    "url": "https://github.com/tripolskypetr/agent-swarm-kit/issues"
+  },
+  "scripts": {
+    "build": "rollup -c",
+    "test": "npm run build && node ./test/index.mjs",
+    "benchmark": "npm run build && node ./benchmark/index.mjs",
+    "build:docs": "rimraf docs && mkdir docs && node ./scripts/dts-docs.cjs ./types.d.ts ./docs",
+    "docs:gpt": "npm run build && node ./scripts/gpt-docs.mjs",
+    "docs:uml": "npm run build && node ./scripts/uml.mjs",
+    "docs:www": "rimraf docs/wwwroot && typedoc && node ./packages/typedoc-yandex-metrica/index.mjs",
+    "docs:demo:win": ".\\scripts\\win\\build_demo_docs.bat",
+    "docs:demo": "sh ./scripts/linux/build_demo_docs.sh",
+    "docs:demo:concat": "node ./packages/concat-demo-docs/index.mjs",
+    "repl": "dotenv -e .env -- npm run build && node -e \"import('./scripts/repl.mjs')\" --interactive"
+  },
+  "main": "build/index.cjs",
+  "module": "build/index.mjs",
+  "source": "src/index.ts",
+  "types": "./types.d.ts",
+  "exports": {
+    "require": "./build/index.cjs",
+    "types": "./types.d.ts",
+    "import": "./build/index.mjs",
+    "default": "./build/index.cjs"
+  },
+  "devDependencies": {
+    "@rollup/plugin-typescript": "11.1.6",
+    "@types/lodash-es": "4.17.12",
+    "@types/node": "22.9.0",
+    "@types/xml2js": "0.4.14",
+    "glob": "11.0.1",
+    "ollama": "0.5.14",
+    "rimraf": "6.0.1",
+    "rollup": "3.29.5",
+    "rollup-plugin-dts": "6.1.1",
+    "rollup-plugin-peer-deps-external": "2.2.4",
+    "tslib": "2.7.0",
+    "typedoc": "0.27.9",
+    "undici": "6.21.2",
+    "worker-testbed": "3.0.0"
+  },
+  "peerDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "di-kit": "^1.1.1",
+    "di-scoped": "^1.0.21",
+    "functools-kit": "^4.0.0",
+    "get-moment-stamp": "^2.0.0",
+    "lodash-es": "4.17.21",
+    "xml2js": "0.6.2"
+  }
+}

package/types.d.ts

@@ -3197,6 +3197,35 @@ declare class ClientAgent implements IAgent {
      * @readonly
      */
     readonly _toolAbortController: ToolAbortController;
+    /**
+     * Count of tool calls currently executing for this agent.
+     * Non-zero while any targetFn.call promise is pending; ClientSession uses it to
+     * detect nested tool-mode executions that must join the parent output waiter.
+     */
+    _runningToolCalls: number;
+    /**
+     * Count of EXECUTE_FN tool status chains still consuming tool events.
+     * While non-zero, tool errors are handled by the chain (stop + resurrect);
+     * once it drops to zero a late tool error must recover on its own in
+     * createToolCall, or the pending execution output would never be emitted.
+     */
+    _activeToolChains: number;
+    /**
+     * Count of EXECUTE_FN executions currently in flight for this agent instance.
+     * dispose() checks it: tearing the instance down mid-execution (e.g. a
+     * server-side changeToAgent while the completion is still running) must
+     * resolve the pending output waiter with an empty result — otherwise the
+     * waiter and the session busy lock would hang forever.
+     */
+    _activeExecutions: number;
+    /**
+     * Generation counter for output emissions. Bumped by commitCancelOutput and by
+     * swarm-level output substitution (emit). Executions capture the epoch at start
+     * and _emitOutput drops their result when the epoch moved on — otherwise the
+     * stale output of a cancelled/substituted execution would resolve the waiter
+     * of the NEXT message, poisoning that exchange.
+     */
+    _outputEpoch: number;
     /**
      * Subject for signaling agent changes, halting subsequent tool executions via commitAgentChange.
      * @readonly
@@ -3259,13 +3288,19 @@ declare class ClientAgent implements IAgent {
      * Supports SwarmConnectionService by broadcasting agent outputs within the swarm.
      * @throws {Error} If validation fails after model resurrection, indicating an unrecoverable state.
      **/
-    _emitOutput(mode: ExecutionMode, rawResult: string): Promise<void>;
+    _emitOutput(mode: ExecutionMode, rawResult: string, outputEpoch?: number): Promise<void>;
     /**
      * Resurrects the model in case of failures using configured strategies (flush, recomplete, custom).
      * Updates history with failure details and returns a placeholder or transformed result, signaling via _resqueSubject.
      * Supports error recovery for CompletionSchemaService’s getCompletion calls.
       */
     _resurrectModel(mode: ExecutionMode, reason?: string): Promise<string>;
+    /**
+     * Marks in-flight executions as substituted: the swarm emitted a replacement
+     * output (ClientSwarm.emit), so results of executions started earlier must not
+     * reach _outputSubject — they would pair with the next waiter otherwise.
+     */
+    commitOutputSubstituted(): void;
     /**
      * Waits for the next output to be emitted via _outputSubject, typically after execute or run.
      * Useful for external consumers (e.g., SwarmConnectionService) awaiting agent responses.
@@ -4483,10 +4518,32 @@ declare class ClientSwarm implements ISwarm {
      */
     cancelOutput(): Promise<void>;
     /**
-     * Waits for output from the active agent in a queued manner, delegating to WAIT_FOR_OUTPUT_FN.
-     * Ensures only one wait operation runs at a time, handling cancellation and agent changes, supporting ClientSession's output retrieval.
+     * Chain of pending waitForOutput calls, reset to a resolved promise whenever
+     * the most recently started waiter settles. See waitForOutput for the rationale.
+     */
+    private _lastOutputAwaiter;
+    /**
+     * Waiters created by waitForOutput that have not settled yet, in creation order.
+     * joinOutput attaches nested tool executions to the head of this list.
+     */
+    private _pendingOutputAwaiters;
+    /**
+     * Waits for output from the active agent, delegating to WAIT_FOR_OUTPUT_FN.
+     * Pending waiters run in FIFO order so each one consumes the next emitted output,
+     * but once a started waiter settles the chain is reset: a waiter that subscribed
+     * too late to observe its output stays pending without blocking waiters created
+     * afterwards. Strict sequential queueing must be avoided here — a nested tool
+     * execute whose output was already consumed would deadlock every later completion.
      */
     waitForOutput: () => Promise<string>;
+    /**
+     * Awaits the same output as the oldest pending waitForOutput call, or starts a
+     * fresh wait when none is pending. Nested executions triggered from inside a tool
+     * (execute/executeForce with "tool" mode) must use this instead of waitForOutput:
+     * their emitted output resolves the parent waiter, so queueing behind it would
+     * leave the nested caller pending forever and skip the tool's onAfterCall.
+     */
+    joinOutput: () => Promise<string>;
     /**
      * Retrieves the name of the active agent, lazily fetching it via params.getActiveAgent if not loaded.
      * Emits an event via BusService with the result, supporting ClientSession's agent identification.
@@ -6082,8 +6139,18 @@ declare class ClientStorage<T extends IStorageData = IStorageData> implements IS
      */
     constructor(params: IStorageParams<T>);
     /**
-     * Dispatches a storage action (upsert, remove, or clear) in a queued manner, delegating to DISPATCH_FN.
-     * Ensures sequential execution of storage operations, supporting thread-safe updates from ClientAgent or tools.
+     * Queued core of dispatch. The wrapped function must never reject: queued()
+     * chains every call on the previous promise, so a rejection inside the queue
+     * (e.g. a throwing createIndex/createEmbedding/setData) would reject every
+     * already-queued dispatch with this foreign error WITHOUT running it — a
+     * concurrent upsert/remove/clear would be silently dropped. Errors are boxed
+     * here and rethrown outside the queue, so only the failing caller observes them.
+     */
+    private _dispatchQueue;
+    /**
+     * Dispatches a storage action (upsert, remove, or clear) through the serialized
+     * queue, delegating to DISPATCH_FN. Ensures sequential execution of storage
+     * operations, supporting thread-safe updates from ClientAgent or tools.
      */
     dispatch: (action: Action$1, payload: Partial<Payload<T>>) => Promise<void>;
     /**
@@ -6425,14 +6492,38 @@ type Action = "read" | "write";
 declare class ClientState<State extends IStateData = IStateData> implements IState<State>, IStateChangeEvent {
     readonly params: IStateParams<State>;
     readonly stateChanged: Subject<string>;
+    /**
+     * Marks the async execution context of a running dispatch (read/write).
+     * getState checks it to serve reentrant reads (getState called from INSIDE a
+     * setState dispatchFn/middleware) without re-entering the queue, which would
+     * deadlock. Scoping this per async-context — instead of a plain instance flag —
+     * ensures an UNRELATED concurrent getState still queues and observes writes in
+     * order, rather than reading a stale field while some other write is in flight.
+     */
+    private _dispatchContext;
+    /**
+     * True only while the caller runs inside the async context of an active
+     * dispatch on this instance (i.e. a reentrant call from within a dispatchFn).
+     */
+    get _inDispatch(): boolean;
     /**
      * The current state data, initialized as null and set during waitForInit.
      * Updated by setState and clearState, persisted via params.setState if provided.
      */
     _state: State;
     /**
-     * Queued dispatch function to read or write the state, delegating to DISPATCH_FN.
-     * Ensures thread-safe state operations, supporting concurrent access from ClientAgent or tools.
+     * Queued core of dispatch. The wrapped function must never reject: queued()
+     * chains every call on the previous promise, so a rejection inside the queue
+     * would reject every already-queued dispatch with this foreign error WITHOUT
+     * running it — a concurrent setState would be silently dropped. Errors (e.g.
+     * a throwing user dispatchFn or middleware) are boxed here and rethrown
+     * outside the queue, so only the caller whose operation failed observes them.
+     */
+    private _dispatchQueue;
+    /**
+     * Dispatches a read or write of the state through the serialized queue,
+     * delegating to DISPATCH_FN. Ensures thread-safe state operations, supporting
+     * concurrent access from ClientAgent or tools.
      */
     dispatch: (action: Action, payload?: DispatchFn<State>) => Promise<State>;
     /**
@@ -7804,7 +7895,6 @@ declare class PolicyValidationService {
     validate: (policyName: PolicyName, source: string) => void;
 }
 
-declare const BAN_NEED_FETCH: unique symbol;
 /**
  * Class representing a client policy in the swarm system, implementing the IPolicy interface.
  * Manages client bans, input/output validation, and restrictions, with lazy-loaded ban lists and event emission via BusService.
@@ -7815,11 +7905,40 @@ declare const BAN_NEED_FETCH: unique symbol;
 declare class ClientPolicy implements IPolicy {
     readonly params: IPolicyParams;
     /**
-     * Set of banned client IDs or a symbol indicating the ban list needs to be fetched.
-     * Initialized as BAN_NEED_FETCH, lazily populated via params.getBannedClients on first use in hasBan, validateInput, etc.
-     * Updated by banClient and unbanClient, persisted if params.setBannedClients is provided.
+     * Ban sets keyed by swarm name, lazily populated via params.getBannedClients.
+     * A ClientPolicy instance is memoized per policyName and shared by every swarm
+     * that lists the policy, while bans are persisted per (policy, swarm) — a
+     * single shared set would leak bans of one swarm into another and persist
+     * the mixed set into the wrong store.
+     */
+    _banSetBySwarm: Map<string, Set<string>>;
+    /**
+     * Returns the ban set of the given swarm, fetching it on first access.
+     * Re-checks the map after the await: a ban committed through _banQueue while
+     * the fetch was in flight must not be overwritten by the stale fetch result.
      */
-    _banSet: Set<SessionId> | typeof BAN_NEED_FETCH;
+    private _getBanSet;
+    /**
+     * Serializes the read-modify-write of _banSet shared by banClient/unbanClient.
+     * Without it two concurrent bans of different clients both read the same ban
+     * set, each adds only its own client, and the later setBannedClients overwrites
+     * the earlier one — one ban is silently lost in memory and in the persisted
+     * store. queued() runs the mutations one at a time so each observes the result
+     * of the previous one.
+     *
+     * The wrapped function must never reject: queued() chains every call on the
+     * previous promise, so a rejection inside the queue (e.g. a throwing
+     * setBannedClients adapter) would reject every already-queued ban/unban with
+     * this foreign error WITHOUT running it — a concurrent ban of another client
+     * would be silently lost. Errors are boxed here and rethrown by the caller
+     * outside the queue.
+     */
+    private _banQueue;
+    /**
+     * Runs a ban-set mutation through _banQueue, rethrowing its boxed error
+     * outside the queue so only the failing caller observes it.
+     */
+    private _runBanQueue;
     /**
      * Constructs a ClientPolicy instance with the provided parameters.
      * Invokes the onInit callback if defined and logs construction if debugging is enabled.
@@ -10521,7 +10640,7 @@ type TEmbeddingSchema = {
  *
  * @example
  * // Override an embedding’s schema with new properties
- * overrideEmbeding({
+ * overrideEmbedding({
  *   embeddingName: "TextEmbedding",
  *   persist: true,
  *   callbacks: {
@@ -10530,7 +10649,7 @@ type TEmbeddingSchema = {
  * });
  * // Logs the operation (if enabled) and updates the embedding schema in the swarm.
 */
-declare function overrideEmbeding(embeddingSchema: TEmbeddingSchema): Promise<IEmbeddingSchema>;
+declare function overrideEmbedding(embeddingSchema: TEmbeddingSchema): Promise<IEmbeddingSchema>;
 
 /**
  * Type representing a partial policy schema with required policyName.
@@ -11113,16 +11232,16 @@ declare function commitToolRequestForce(request: IToolRequest[], clientId: strin
  * Emits a string as model output without executing an incoming message or checking the active agent.
  *
  * This function directly emits a provided string as output from the swarm session, bypassing message execution and agent activity checks.
- * It is designed exclusively for sessions established via `makeConnection`, ensuring compatibility with its connection model.
- * The execution is wrapped in `beginContext` for a clean environment, validates the session and swarm, and throws an error if the session mode
- * is not "makeConnection". The operation is logged if enabled, and resolves when the content is successfully emitted.
+ * Unlike `emit`, it does not verify that a specific agent is still active, ensuring emission even after navigation.
+ * The execution is wrapped in `beginContext` for a clean environment, validates the session and swarm,
+ * logs the operation if enabled, and resolves when the content is successfully emitted. Works for any session mode.
  *
  *
  * @param {string} content - The content to be processed or stored.
  * @param {string} clientId - The unique identifier of the client session.
- * @throws {Error} If the session mode is not "makeConnection", or if session or swarm validation fails.
+ * @throws {Error} If session or swarm validation fails.
  * @example
- * await emitForce("Direct output", "client-123"); // Emits "Direct output" in a makeConnection session
+ * await emitForce("Direct output", "client-123"); // Emits "Direct output" regardless of the active agent
 */
 declare function emitForce(content: string, clientId: string): Promise<void>;
 
@@ -11263,16 +11382,16 @@ declare function execute(content: string, clientId: string, agentName: AgentName
 /**
  * Emits a string as model output without executing an incoming message, with agent activity validation.
  *
- * This function directly emits a provided string as output from the swarm session, bypassing message execution, and is designed exclusively
- * for sessions established via `makeConnection`. It validates the session, swarm, and specified agent, ensuring the agent is still active
- * before emitting. If the active agent has changed, the operation is skipped. The execution is wrapped in `beginContext` for a clean environment,
- * logs the operation if enabled, and throws an error if the session mode is not "makeConnection".
+ * This function directly emits a provided string as output from the swarm session, bypassing message execution.
+ * It validates the session, swarm, and specified agent, ensuring the agent is still active before emitting.
+ * If the active agent has changed, the operation is skipped. The execution is wrapped in `beginContext` for a
+ * clean environment and logs the operation if enabled. Works for any session mode.
  *
  *
  * @param {string} content - The content to be processed or stored.
  * @param {string} clientId - The unique identifier of the client session.
  * @param {AgentName} agentName - The name of the agent to use or reference.
- * @throws {Error} If the session mode is not "makeConnection", or if agent, session, or swarm validation fails.
+ * @throws {Error} If agent, session, or swarm validation fails.
  * @example
  * await emit("Direct output", "client-123", "AgentX"); // Emits "Direct output" if AgentX is active
 */
@@ -11796,6 +11915,22 @@ declare function getLastAssistantMessage(clientId: string): Promise<string>;
 */
 declare function getLastSystemMessage(clientId: string): Promise<string>;
 
+/**
+ * Retrieves the content of the most recent tool message from a client's session history.
+ *
+ * This function fetches the raw history for a specified client using `getRawHistory` and finds the last entry where the role is "tool".
+ * It is wrapped in `beginContext` for a clean execution environment and logs the operation if enabled via `GLOBAL_CONFIG`. The result is the content
+ * of the last tool message as a string, or `null` if no tool message exists in the history.
+ *
+ *
+ * @param {string} clientId - The unique identifier of the client session.
+ * @throws {Error} If `getRawHistory` fails due to session validation or history retrieval issues.
+ * @example
+ * const lastMessage = await getLastToolMessage("client-123");
+ * console.log(lastMessage); // Outputs the last tool message or null
+*/
+declare function getLastToolMessage(clientId: string): Promise<string>;
+
 /**
  * Retrieves an agent schema by its name from the swarm's agent schema service.
  * Logs the operation if logging is enabled in the global configuration.
@@ -11830,7 +11965,7 @@ declare function getCompute(computeName: ComputeName): IComputeSchema<any>;
  * @function getEmbedding
  * @param {EmbeddingName} embeddingName - The name of the embedding.
 */
-declare function getEmbeding(embeddingName: EmbeddingName): IEmbeddingSchema;
+declare function getEmbedding(embeddingName: EmbeddingName): IEmbeddingSchema;
 
 /**
  * Retrieves an MCP (Model Context Protocol) schema by its name from the swarm's MCP schema service.
@@ -12874,6 +13009,19 @@ interface IGlobalConfig {
      * Flag to enable operator timeout, used in `ClientOperator` for message processing.
      */
     CC_ENABLE_OPERATOR_TIMEOUT: boolean;
+    /**
+     * Timeout in milliseconds for operator signal waiting in `ClientOperator.waitForOutput`.
+     * Applied only when CC_ENABLE_OPERATOR_TIMEOUT is true; expired wait resolves with an empty output.
+     */
+    CC_OPERATOR_SIGNAL_TIMEOUT: number;
+    /**
+     * Interval in milliseconds between chat inactivity sweeps in `ChatUtils`.
+     */
+    CC_CHAT_INACTIVITY_CHECK: number;
+    /**
+     * Inactivity duration in milliseconds after which an idle chat instance is disposed by `ChatUtils`.
+     */
+    CC_CHAT_INACTIVITY_TIMEOUT: number;
     /**
      * Disable fetch of data from all storages. Quite usefull for unit tests
      */
@@ -13189,7 +13337,7 @@ declare class SharedComputeUtils {
      * Retrieves shared compute data with validation and context management.
      * @async
      */
-    getComputeData: <T extends IComputeData = any>(clientId: string, computeName: ComputeName) => Promise<T>;
+    getComputeData: <T extends IComputeData = any>(computeName: ComputeName) => Promise<T>;
 }
 /**
  * @constant {SharedComputeUtils} SharedCompute
@@ -13627,6 +13775,12 @@ declare class SchemaUtils {
 */
 declare const Schema: SchemaUtils;
 
+/**
+ * Prompt template for instructing models on how to format tool calls in responses.
+ * Uses XML-like `<tool_call>` tags containing JSON objects with function name and arguments.
+ * @see https://github.com/ollama/ollama/blob/86a622cbdc69e9fd501764ff7565e977fc98f00a/server/model.go#L158
+*/
+declare const TOOL_PROTOCOL_PROMPT: string;
 /**
  * Function type for completing AI model requests.
  * Takes completion arguments and returns a promise resolving to a model message response.
@@ -13912,4 +14066,4 @@ declare const Utils: {
     PersistEmbeddingUtils: typeof PersistEmbeddingUtils;
 };
 
-export { Adapter, type BaseMessageRole, Chat, ChatInstance, Compute, type EventSource, ExecutionContextService, History, HistoryMemoryInstance, HistoryPersistInstance, type IAdvisorSchema, type IAgentSchemaInternal, type IAgentTool, type IBaseCompletionArgs, type IBaseEvent, type IBaseMessage, type IBusEvent, type IBusEventContext, type IChatInstance, type IChatInstanceCallbacks, type ICommitActionParams, type ICompletionSchema, type IComputeSchema, type ICustomEvent, type IEmbeddingSchema, type IFetchInfoParams, type IGlobalConfig, type IHistoryAdapter, type IHistoryControl, type IHistoryInstance, type IHistoryInstanceCallbacks, type IIncomingMessage, type ILoggerAdapter, type ILoggerInstance, type ILoggerInstanceCallbacks, type IMCPSchema, type IMCPTool, type IMCPToolCallDto, type IMakeConnectionConfig, type IMakeDisposeParams, type INavigateToAgentParams, type INavigateToTriageParams, type IOutgoingMessage, type IOutlineCompletionArgs, type IOutlineFormat, type IOutlineHistory, type IOutlineMessage, type IOutlineObjectFormat, type IOutlineResult, type IOutlineSchema, type IOutlineSchemaFormat, type IOutlineValidationFn, type IPersistActiveAgentData, type IPersistAliveData, type IPersistBase, type IPersistEmbeddingData, type IPersistMemoryData, type IPersistNavigationStackData, type IPersistPolicyData, type IPersistStateData, type IPersistStorageData, type IPipelineSchema, type IPolicySchema, type IScopeOptions, type ISessionConfig, type ISessionContext, type IStateSchema, type IStorageData, type IStorageSchema, type ISwarmCompletionArgs, type ISwarmMessage, type ISwarmSchema, type ITool, type IToolCall, Logger, LoggerInstance, MCP, type MCPToolProperties, MethodContextService, Operator, OperatorInstance, type OutlineMessageRole, PayloadContextService, PersistAlive, PersistBase, PersistEmbedding, PersistList, PersistMemory, PersistPolicy, PersistState, PersistStorage, PersistSwarm, Policy, type ReceiveMessageFn, RoundRobin, Schema, SchemaContextService, type SendMessageFn, SharedCompute, SharedState, SharedStorage, State, Storage, type SwarmMessageRole, type THistoryInstanceCtor, type THistoryMemoryInstance, type THistoryPersistInstance, type TLoggerInstance, type TOperatorInstance, type TPersistBase, type TPersistBaseCtor, type TPersistList, type ToolValue, Utils, addAdvisor, addAgent, addAgentNavigation, addCommitAction, addCompletion, addCompute, addEmbedding, addFetchInfo, addMCP, addOutline, addPipeline, addPolicy, addState, addStorage, addSwarm, addTool, addTriageNavigation, ask, beginContext, cancelOutput, cancelOutputForce, changeToAgent, changeToDefaultAgent, changeToPrevAgent, chat, commitAssistantMessage, commitAssistantMessageForce, commitDeveloperMessage, commitDeveloperMessageForce, commitFlush, commitFlushForce, commitStopTools, commitStopToolsForce, commitSystemMessage, commitSystemMessageForce, commitToolOutput, commitToolOutputForce, commitToolRequest, commitToolRequestForce, commitUserMessage, commitUserMessageForce, complete, createCommitAction, createFetchInfo, createNavigateToAgent, createNavigateToTriageAgent, disposeConnection, dumpAdvisorResult, dumpAgent, dumpClientPerformance, dumpDocs, dumpOutlineResult, dumpPerfomance, dumpSwarm, emit, emitForce, event, execute, executeForce, fork, getAdvisor, getAgent, getAgentHistory, getAgentName, getAssistantHistory, getCheckBusy, getCompletion, getCompute, getEmbeding, getLastAssistantMessage, getLastSystemMessage, getLastUserMessage, getMCP, getNavigationRoute, getPayload, getPipeline, getPolicy, getRawHistory, getSessionContext, getSessionMode, getState, getStorage, getSwarm, getTool, getToolNameForModel, getUserHistory, hasNavigation, hasSession, json, listenAgentEvent, listenAgentEventOnce, listenEvent, listenEventOnce, listenExecutionEvent, listenExecutionEventOnce, listenHistoryEvent, listenHistoryEventOnce, listenPolicyEvent, listenPolicyEventOnce, listenSessionEvent, listenSessionEventOnce, listenStateEvent, listenStateEventOnce, listenStorageEvent, listenStorageEventOnce, listenSwarmEvent, listenSwarmEventOnce, makeAutoDispose, makeConnection, markOffline, markOnline, notify, notifyForce, overrideAdvisor, overrideAgent, overrideCompletion, overrideCompute, overrideEmbeding, overrideMCP, overrideOutline, overridePipeline, overridePolicy, overrideState, overrideStorage, overrideSwarm, overrideTool, runStateless, runStatelessForce, scope, session, setConfig, startPipeline, swarm, toJsonSchema, validate, validateToolArguments };
+export { Adapter, type BaseMessageRole, Chat, ChatInstance, Compute, type EventSource, ExecutionContextService, History, HistoryMemoryInstance, HistoryPersistInstance, type IAdvisorSchema, type IAgentSchemaInternal, type IAgentTool, type IBaseCompletionArgs, type IBaseEvent, type IBaseMessage, type IBusEvent, type IBusEventContext, type IChatInstance, type IChatInstanceCallbacks, type ICommitActionParams, type ICompletionSchema, type IComputeSchema, type ICustomEvent, type IEmbeddingSchema, type IFetchInfoParams, type IGlobalConfig, type IHistoryAdapter, type IHistoryControl, type IHistoryInstance, type IHistoryInstanceCallbacks, type IIncomingMessage, type ILoggerAdapter, type ILoggerInstance, type ILoggerInstanceCallbacks, type IMCPSchema, type IMCPTool, type IMCPToolCallDto, type IMakeConnectionConfig, type IMakeDisposeParams, type INavigateToAgentParams, type INavigateToTriageParams, type IOutgoingMessage, type IOutlineCompletionArgs, type IOutlineFormat, type IOutlineHistory, type IOutlineMessage, type IOutlineObjectFormat, type IOutlineResult, type IOutlineSchema, type IOutlineSchemaFormat, type IOutlineValidationFn, type IPersistActiveAgentData, type IPersistAliveData, type IPersistBase, type IPersistEmbeddingData, type IPersistMemoryData, type IPersistNavigationStackData, type IPersistPolicyData, type IPersistStateData, type IPersistStorageData, type IPipelineSchema, type IPolicySchema, type IScopeOptions, type ISessionConfig, type ISessionContext, type IStateSchema, type IStorageData, type IStorageSchema, type ISwarmCompletionArgs, type ISwarmMessage, type ISwarmSchema, type ITool, type IToolCall, Logger, LoggerInstance, MCP, type MCPToolProperties, MethodContextService, Operator, OperatorInstance, type OutlineMessageRole, PayloadContextService, PersistAlive, PersistBase, PersistEmbedding, PersistList, PersistMemory, PersistPolicy, PersistState, PersistStorage, PersistSwarm, Policy, type ReceiveMessageFn, RoundRobin, Schema, SchemaContextService, type SendMessageFn, SharedCompute, SharedState, SharedStorage, State, Storage, type SwarmMessageRole, type THistoryInstanceCtor, type THistoryMemoryInstance, type THistoryPersistInstance, type TLoggerInstance, TOOL_PROTOCOL_PROMPT, type TOperatorInstance, type TPersistBase, type TPersistBaseCtor, type TPersistList, type ToolValue, Utils, addAdvisor, addAgent, addAgentNavigation, addCommitAction, addCompletion, addCompute, addEmbedding, addFetchInfo, addMCP, addOutline, addPipeline, addPolicy, addState, addStorage, addSwarm, addTool, addTriageNavigation, ask, beginContext, cancelOutput, cancelOutputForce, changeToAgent, changeToDefaultAgent, changeToPrevAgent, chat, commitAssistantMessage, commitAssistantMessageForce, commitDeveloperMessage, commitDeveloperMessageForce, commitFlush, commitFlushForce, commitStopTools, commitStopToolsForce, commitSystemMessage, commitSystemMessageForce, commitToolOutput, commitToolOutputForce, commitToolRequest, commitToolRequestForce, commitUserMessage, commitUserMessageForce, complete, createCommitAction, createFetchInfo, createNavigateToAgent, createNavigateToTriageAgent, disposeConnection, dumpAdvisorResult, dumpAgent, dumpClientPerformance, dumpDocs, dumpOutlineResult, dumpPerfomance, dumpSwarm, emit, emitForce, event, execute, executeForce, fork, getAdvisor, getAgent, getAgentHistory, getAgentName, getAssistantHistory, getCheckBusy, getCompletion, getCompute, getEmbedding, getLastAssistantMessage, getLastSystemMessage, getLastToolMessage, getLastUserMessage, getMCP, getNavigationRoute, getPayload, getPipeline, getPolicy, getRawHistory, getSessionContext, getSessionMode, getState, getStorage, getSwarm, getTool, getToolNameForModel, getUserHistory, hasNavigation, hasSession, json, listenAgentEvent, listenAgentEventOnce, listenEvent, listenEventOnce, listenExecutionEvent, listenExecutionEventOnce, listenHistoryEvent, listenHistoryEventOnce, listenPolicyEvent, listenPolicyEventOnce, listenSessionEvent, listenSessionEventOnce, listenStateEvent, listenStateEventOnce, listenStorageEvent, listenStorageEventOnce, listenSwarmEvent, listenSwarmEventOnce, makeAutoDispose, makeConnection, markOffline, markOnline, notify, notifyForce, overrideAdvisor, overrideAgent, overrideCompletion, overrideCompute, overrideEmbedding, overrideMCP, overrideOutline, overridePipeline, overridePolicy, overrideState, overrideStorage, overrideSwarm, overrideTool, runStateless, runStatelessForce, scope, session, setConfig, startPipeline, swarm, toJsonSchema, validate, validateToolArguments };