agent-swarm-kit 1.1.147 → 1.1.149

package/README.md

@@ -1,3 +1,5 @@
+<img src="./assets/saturn.svg" height="85px" align="right">
+
 # 🐝 Agent Swarm Kit
 
 > **A lightweight TypeScript library for building orchestrated, framework-agnostic multi-agent AI systems.**

package/build/index.cjs

@@ -10,6 +10,26 @@ var crypto = require('crypto');
 var os = require('os');
 var getMomentStamp = require('get-moment-stamp');
 
+function _interopNamespaceDefault(e) {
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
+        });
+    }
+    n.default = e;
+    return Object.freeze(n);
+}
+
+var fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
+var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
+
 /**
  * Scoped service class providing method call context information in the swarm system.
  * Stores and exposes an IMethodContext object (clientId, methodName, agentName, etc.) via dependency injection, scoped using di-scoped for method-specific instances.
@@ -19166,6 +19186,101 @@ dumpClientPerformance.runAfterExecute = beginContext(async (dirName = "./logs/cl
     });
 });
 
+/**
+ * Dumps the outline result into a folder structure with markdown files.
+ *
+ * - Skips dumping if the result is invalid.
+ * - Creates a subfolder for each result using its resultId.
+ * - Writes a summary file including input parameters, generated data, and system messages.
+ * - Writes each user message to a separate markdown file.
+ * - Writes the full outline result to a markdown file.
+ *
+ * @function
+ * @param {IOutlineResult} result - The outline result object to dump.
+ * @param {string} [outputDir="./dump/outline"] - The base directory to dump results into.
+ * @returns {Promise<void>}
+ */
+const dumpOutlineResult = beginContext(async (result, outputDir = "./dump/outline") => {
+    if (!result.isValid) {
+        return;
+    }
+    // Extract system messages and system reminders from existing data
+    const systemMessages = result.history.filter((m) => m.role === "system");
+    const userMessages = result.history.filter((m) => m.role === "user");
+    const subfolderPath = path__namespace.join(outputDir, result.resultId);
+    try {
+        await fs__namespace.access(subfolderPath);
+        return;
+    }
+    catch {
+        await fs__namespace.mkdir(subfolderPath, { recursive: true });
+    }
+    {
+        let summary = `# Outline Result Summary\n`;
+        {
+            summary += `\n`;
+            summary += `**ResultId**: ${result.resultId}\n`;
+            summary += `**Generation Date**: ${new Date().toISOString()}\n`;
+            summary += `\n`;
+        }
+        if (result.param) {
+            summary += `## Input Parameters\n\n`;
+            summary += "```json\n";
+            summary += JSON.stringify(result.param, null, 2);
+            summary += "\n```\n\n";
+        }
+        if (result.data) {
+            summary += `## Generated Data\n\n`;
+            summary += "```json\n";
+            summary += JSON.stringify(result.data, null, 2);
+            summary += "\n```\n\n";
+        }
+        // Add system messages to summary
+        if (systemMessages.length > 0) {
+            summary += `## System Messages\n\n`;
+            systemMessages.forEach((msg, idx) => {
+                summary += `### System Message ${idx + 1}\n\n`;
+                summary += msg.content;
+                summary += "\n";
+            });
+        }
+        const summaryFile = path__namespace.join(subfolderPath, "00_system_prompt.md");
+        await fs__namespace.writeFile(summaryFile, summary, "utf8");
+    }
+    {
+        await Promise.all(Array.from(userMessages.entries()).map(async ([idx, message]) => {
+            const messageNum = String(idx + 1).padStart(2, "0");
+            const contentFileName = `${messageNum}_user_message.md`;
+            const contentFilePath = path__namespace.join(subfolderPath, contentFileName);
+            let content = `# User Input ${idx + 1}\n\n`;
+            content += `**ResultId**: ${result.resultId}\n\n`;
+            content += message.content;
+            content += "\n";
+            await fs__namespace.writeFile(contentFilePath, content, "utf8");
+        }));
+    }
+    {
+        const messageNum = String(userMessages.length + 1).padStart(2, "0");
+        const contentFileName = `${messageNum}_llm_output.md`;
+        const contentFilePath = path__namespace.join(subfolderPath, contentFileName);
+        let content = `# Full Outline Result\n\n`;
+        content += `**ResultId**: ${result.resultId}\n\n`;
+        if (result.param) {
+            content += `## Completion Input Data\n\n`;
+            content += "```json\n";
+            content += JSON.stringify(result.param, null, 2);
+            content += "\n```\n\n";
+        }
+        if (result.data) {
+            content += `## Completion Output Data\n\n`;
+            content += "```json\n";
+            content += JSON.stringify(result.data, null, 2);
+            content += "\n```\n";
+        }
+        await fs__namespace.writeFile(contentFilePath, content, "utf8");
+    }
+});
+
 /** @private Constant defining the method name for logging and validation context */
 const METHOD_NAME$1v = "function.commit.commitFlushForce";
 /**
@@ -26442,6 +26557,7 @@ exports.disposeConnection = disposeConnection;
 exports.dumpAgent = dumpAgent;
 exports.dumpClientPerformance = dumpClientPerformance;
 exports.dumpDocs = dumpDocs;
+exports.dumpOutlineResult = dumpOutlineResult;
 exports.dumpPerfomance = dumpPerfomance;
 exports.dumpSwarm = dumpSwarm;
 exports.emit = emit;

package/build/index.mjs

@@ -2,8 +2,10 @@ import { scoped } from 'di-scoped';
 import { createActivator } from 'di-kit';
 import { trycatch, makeExtendable, singleshot, getErrorMessage, not, queued, memoize, retry, Subject, str, randomString, ToolRegistry, createAwaiter, sleep, errorData, isObject as isObject$1, cancelable, CANCELED_PROMISE_SYMBOL, SortedArray, execpool, ttl, compose, LimitedSet, Source, and, singlerun, schedule, rate, fetchApi } from 'functools-kit';
 import xml2js from 'xml2js';
-import fs, { access, mkdir } from 'fs/promises';
-import path, { join } from 'path';
+import * as fs from 'fs/promises';
+import fs__default, { access, mkdir } from 'fs/promises';
+import * as path from 'path';
+import path__default, { join } from 'path';
 import crypto, { createHash } from 'crypto';
 import os from 'os';
 import { getMomentStamp, getTimeStamp } from 'get-moment-stamp';
@@ -382,7 +384,7 @@ async function writeFileAtomic(file, data, options = {}) {
     if (IS_WINDOWS || GLOBAL_CONFIG.CC_SKIP_POSIX_RENAME) {
         try {
             // Create and write to temporary file
-            fileHandle = await fs.open(file, "w", mode);
+            fileHandle = await fs__default.open(file, "w", mode);
             // Write data to the temp file
             await fileHandle.writeFile(data, { encoding });
             // Ensure data is flushed to disk
@@ -400,12 +402,12 @@ async function writeFileAtomic(file, data, options = {}) {
         return;
     }
     // Create a temporary filename in the same directory
-    const dir = path.dirname(file);
-    const filename = path.basename(file);
-    const tmpFile = path.join(dir, `${tmpPrefix}${crypto.randomBytes(6).toString("hex")}-${filename}`);
+    const dir = path__default.dirname(file);
+    const filename = path__default.basename(file);
+    const tmpFile = path__default.join(dir, `${tmpPrefix}${crypto.randomBytes(6).toString("hex")}-${filename}`);
     try {
         // Create and write to temporary file
-        fileHandle = await fs.open(tmpFile, "w", mode);
+        fileHandle = await fs__default.open(tmpFile, "w", mode);
         // Write data to the temp file
         await fileHandle.writeFile(data, { encoding });
         // Ensure data is flushed to disk
@@ -414,7 +416,7 @@ async function writeFileAtomic(file, data, options = {}) {
         await fileHandle.close();
         fileHandle = null;
         // Atomically replace the target file with our temp file
-        await fs.rename(tmpFile, file);
+        await fs__default.rename(tmpFile, file);
     }
     catch (error) {
         // Clean up if something went wrong
@@ -423,7 +425,7 @@ async function writeFileAtomic(file, data, options = {}) {
         }
         // Try to remove the temporary file
         try {
-            await fs.unlink(tmpFile).catch(() => { });
+            await fs__default.unlink(tmpFile).catch(() => { });
         }
         catch (_) {
             // Ignore errors during cleanup
@@ -544,7 +546,7 @@ const BASE_UNLINK_RETRY_DELAY = 1000;
  */
 const BASE_WAIT_FOR_INIT_UNLINK_FN = async (filePath) => trycatch(retry(async () => {
     try {
-        await fs.unlink(filePath);
+        await fs__default.unlink(filePath);
         return true;
     }
     catch (error) {
@@ -568,7 +570,7 @@ const BASE_WAIT_FOR_INIT_FN = async (self) => {
             entityName: self.entityName,
             directory: self._directory,
         });
-    await fs.mkdir(self._directory, { recursive: true });
+    await fs__default.mkdir(self._directory, { recursive: true });
     for await (const key of self.keys()) {
         try {
             await self.readValue(key);
@@ -727,7 +729,7 @@ const PersistBase = makeExtendable(class {
      * @throws {Error} If reading the directory fails (e.g., permissions or directory not found).
      */
     async getCount() {
-        const files = await fs.readdir(this._directory);
+        const files = await fs__default.readdir(this._directory);
         const { length } = files.filter((file) => file.endsWith(".json"));
         return length;
     }
@@ -747,7 +749,7 @@ const PersistBase = makeExtendable(class {
             });
         try {
             const filePath = this._getFilePath(entityId);
-            const fileContent = await fs.readFile(filePath, "utf-8");
+            const fileContent = await fs__default.readFile(filePath, "utf-8");
             return JSON.parse(fileContent);
         }
         catch (error) {
@@ -772,7 +774,7 @@ const PersistBase = makeExtendable(class {
             });
         try {
             const filePath = this._getFilePath(entityId);
-            await fs.access(filePath);
+            await fs__default.access(filePath);
             return true;
         }
         catch (error) {
@@ -821,7 +823,7 @@ const PersistBase = makeExtendable(class {
             });
         try {
             const filePath = this._getFilePath(entityId);
-            await fs.unlink(filePath);
+            await fs__default.unlink(filePath);
         }
         catch (error) {
             if (error?.code === "ENOENT") {
@@ -842,10 +844,10 @@ const PersistBase = makeExtendable(class {
                 entityName: this.entityName,
             });
         try {
-            const files = await fs.readdir(this._directory);
+            const files = await fs__default.readdir(this._directory);
             const entityFiles = files.filter((file) => file.endsWith(".json"));
             for (const file of entityFiles) {
-                await fs.unlink(join(this._directory, file));
+                await fs__default.unlink(join(this._directory, file));
             }
         }
         catch (error) {
@@ -865,7 +867,7 @@ const PersistBase = makeExtendable(class {
                 entityName: this.entityName,
             });
         try {
-            const files = await fs.readdir(this._directory);
+            const files = await fs__default.readdir(this._directory);
             const entityIds = files
                 .filter((file) => file.endsWith(".json"))
                 .map((file) => file.slice(0, -5))
@@ -894,7 +896,7 @@ const PersistBase = makeExtendable(class {
                 entityName: this.entityName,
             });
         try {
-            const files = await fs.readdir(this._directory);
+            const files = await fs__default.readdir(this._directory);
             const entityIds = files
                 .filter((file) => file.endsWith(".json"))
                 .map((file) => file.slice(0, -5))
@@ -19164,6 +19166,101 @@ dumpClientPerformance.runAfterExecute = beginContext(async (dirName = "./logs/cl
     });
 });
 
+/**
+ * Dumps the outline result into a folder structure with markdown files.
+ *
+ * - Skips dumping if the result is invalid.
+ * - Creates a subfolder for each result using its resultId.
+ * - Writes a summary file including input parameters, generated data, and system messages.
+ * - Writes each user message to a separate markdown file.
+ * - Writes the full outline result to a markdown file.
+ *
+ * @function
+ * @param {IOutlineResult} result - The outline result object to dump.
+ * @param {string} [outputDir="./dump/outline"] - The base directory to dump results into.
+ * @returns {Promise<void>}
+ */
+const dumpOutlineResult = beginContext(async (result, outputDir = "./dump/outline") => {
+    if (!result.isValid) {
+        return;
+    }
+    // Extract system messages and system reminders from existing data
+    const systemMessages = result.history.filter((m) => m.role === "system");
+    const userMessages = result.history.filter((m) => m.role === "user");
+    const subfolderPath = path.join(outputDir, result.resultId);
+    try {
+        await fs.access(subfolderPath);
+        return;
+    }
+    catch {
+        await fs.mkdir(subfolderPath, { recursive: true });
+    }
+    {
+        let summary = `# Outline Result Summary\n`;
+        {
+            summary += `\n`;
+            summary += `**ResultId**: ${result.resultId}\n`;
+            summary += `**Generation Date**: ${new Date().toISOString()}\n`;
+            summary += `\n`;
+        }
+        if (result.param) {
+            summary += `## Input Parameters\n\n`;
+            summary += "```json\n";
+            summary += JSON.stringify(result.param, null, 2);
+            summary += "\n```\n\n";
+        }
+        if (result.data) {
+            summary += `## Generated Data\n\n`;
+            summary += "```json\n";
+            summary += JSON.stringify(result.data, null, 2);
+            summary += "\n```\n\n";
+        }
+        // Add system messages to summary
+        if (systemMessages.length > 0) {
+            summary += `## System Messages\n\n`;
+            systemMessages.forEach((msg, idx) => {
+                summary += `### System Message ${idx + 1}\n\n`;
+                summary += msg.content;
+                summary += "\n";
+            });
+        }
+        const summaryFile = path.join(subfolderPath, "00_system_prompt.md");
+        await fs.writeFile(summaryFile, summary, "utf8");
+    }
+    {
+        await Promise.all(Array.from(userMessages.entries()).map(async ([idx, message]) => {
+            const messageNum = String(idx + 1).padStart(2, "0");
+            const contentFileName = `${messageNum}_user_message.md`;
+            const contentFilePath = path.join(subfolderPath, contentFileName);
+            let content = `# User Input ${idx + 1}\n\n`;
+            content += `**ResultId**: ${result.resultId}\n\n`;
+            content += message.content;
+            content += "\n";
+            await fs.writeFile(contentFilePath, content, "utf8");
+        }));
+    }
+    {
+        const messageNum = String(userMessages.length + 1).padStart(2, "0");
+        const contentFileName = `${messageNum}_llm_output.md`;
+        const contentFilePath = path.join(subfolderPath, contentFileName);
+        let content = `# Full Outline Result\n\n`;
+        content += `**ResultId**: ${result.resultId}\n\n`;
+        if (result.param) {
+            content += `## Completion Input Data\n\n`;
+            content += "```json\n";
+            content += JSON.stringify(result.param, null, 2);
+            content += "\n```\n\n";
+        }
+        if (result.data) {
+            content += `## Completion Output Data\n\n`;
+            content += "```json\n";
+            content += JSON.stringify(result.data, null, 2);
+            content += "\n```\n";
+        }
+        await fs.writeFile(contentFilePath, content, "utf8");
+    }
+});
+
 /** @private Constant defining the method name for logging and validation context */
 const METHOD_NAME$1v = "function.commit.commitFlushForce";
 /**
@@ -26362,4 +26459,4 @@ const Utils = {
     PersistEmbeddingUtils,
 };
 
-export { Adapter, Chat, ChatInstance, Compute, ExecutionContextService, History, HistoryMemoryInstance, HistoryPersistInstance, Logger, LoggerInstance, MCP, MethodContextService, Operator, OperatorInstance, PayloadContextService, PersistAlive, PersistBase, PersistEmbedding, PersistList, PersistMemory, PersistPolicy, PersistState, PersistStorage, PersistSwarm, Policy, RoundRobin, Schema, SchemaContextService, SharedCompute, SharedState, SharedStorage, State, Storage, Utils, addAgent, addAgentNavigation, addCompletion, addCompute, addEmbedding, addMCP, addOutline, addPipeline, addPolicy, addState, addStorage, addSwarm, addTool, addTriageNavigation, addWiki, beginContext, cancelOutput, cancelOutputForce, changeToAgent, changeToDefaultAgent, changeToPrevAgent, commitAssistantMessage, commitAssistantMessageForce, commitDeveloperMessage, commitDeveloperMessageForce, commitFlush, commitFlushForce, commitStopTools, commitStopToolsForce, commitSystemMessage, commitSystemMessageForce, commitToolOutput, commitToolOutputForce, commitToolRequest, commitToolRequestForce, commitUserMessage, commitUserMessageForce, complete, createNavigateToAgent, createNavigateToTriageAgent, disposeConnection, dumpAgent, dumpClientPerformance, dumpDocs, dumpPerfomance, dumpSwarm, emit, emitForce, event, execute, executeForce, fork, 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, getWiki, 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, overrideAgent, overrideCompletion, overrideCompute, overrideEmbeding, overrideMCP, overrideOutline, overridePipeline, overridePolicy, overrideState, overrideStorage, overrideSwarm, overrideTool, overrideWiki, question, questionForce, runStateless, runStatelessForce, scope, session, setConfig, startPipeline, swarm, toJsonSchema, validate, validateToolArguments };
+export { Adapter, Chat, ChatInstance, Compute, ExecutionContextService, History, HistoryMemoryInstance, HistoryPersistInstance, Logger, LoggerInstance, MCP, MethodContextService, Operator, OperatorInstance, PayloadContextService, PersistAlive, PersistBase, PersistEmbedding, PersistList, PersistMemory, PersistPolicy, PersistState, PersistStorage, PersistSwarm, Policy, RoundRobin, Schema, SchemaContextService, SharedCompute, SharedState, SharedStorage, State, Storage, Utils, addAgent, addAgentNavigation, addCompletion, addCompute, addEmbedding, addMCP, addOutline, addPipeline, addPolicy, addState, addStorage, addSwarm, addTool, addTriageNavigation, addWiki, beginContext, cancelOutput, cancelOutputForce, changeToAgent, changeToDefaultAgent, changeToPrevAgent, commitAssistantMessage, commitAssistantMessageForce, commitDeveloperMessage, commitDeveloperMessageForce, commitFlush, commitFlushForce, commitStopTools, commitStopToolsForce, commitSystemMessage, commitSystemMessageForce, commitToolOutput, commitToolOutputForce, commitToolRequest, commitToolRequestForce, commitUserMessage, commitUserMessageForce, complete, createNavigateToAgent, createNavigateToTriageAgent, disposeConnection, dumpAgent, dumpClientPerformance, dumpDocs, dumpOutlineResult, dumpPerfomance, dumpSwarm, emit, emitForce, event, execute, executeForce, fork, 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, getWiki, 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, overrideAgent, overrideCompletion, overrideCompute, overrideEmbeding, overrideMCP, overrideOutline, overridePipeline, overridePolicy, overrideState, overrideStorage, overrideSwarm, overrideTool, overrideWiki, question, questionForce, runStateless, runStatelessForce, scope, session, setConfig, startPipeline, swarm, toJsonSchema, validate, validateToolArguments };

package/package.json

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

package/types.d.ts

@@ -11885,6 +11885,22 @@ declare const dumpClientPerformance: {
     runAfterExecute: (dirName?: any) => Promise<() => void>;
 };
 
+/**
+ * Dumps the outline result into a folder structure with markdown files.
+ *
+ * - Skips dumping if the result is invalid.
+ * - Creates a subfolder for each result using its resultId.
+ * - Writes a summary file including input parameters, generated data, and system messages.
+ * - Writes each user message to a separate markdown file.
+ * - Writes the full outline result to a markdown file.
+ *
+ * @function
+ * @param {IOutlineResult} result - The outline result object to dump.
+ * @param {string} [outputDir="./dump/outline"] - The base directory to dump results into.
+ * @returns {Promise<void>}
+ */
+declare const dumpOutlineResult: (result: IOutlineResult<any, any>, outputDir?: any) => Promise<void>;
+
 /**
  * Configuration parameters for creating a navigation handler to a triage agent.
  * Defines optional messages or functions to handle flush, execution, and tool output scenarios during navigation.
@@ -12464,9 +12480,9 @@ type TSwarmSchema = {
  */
 declare function overrideSwarm(swarmSchema: TSwarmSchema): ISwarmSchema;
 
-type TAgentTool = {
-    toolName: IAgentTool["toolName"];
-} & Partial<IAgentTool>;
+type TAgentTool<T extends any = Record<string, ToolValue>> = {
+    toolName: IAgentTool<T>["toolName"];
+} & Partial<IAgentTool<T>>;
 /**
  * Overrides an existing tool schema in the swarm system with a new or partial schema.
  * This function updates the configuration of a tool identified by its `toolName`, applying the provided schema properties.
@@ -12488,7 +12504,7 @@ type TAgentTool = {
  * });
  * // Logs the operation (if enabled) and updates the tool schema in the swarm.
  */
-declare function overrideTool(toolSchema: TAgentTool): IAgentTool<Record<string, ToolValue>>;
+declare function overrideTool<T extends any = Record<string, ToolValue>>(toolSchema: TAgentTool<T>): IAgentTool<Record<string, ToolValue>>;
 
 /**
  * Type definition for a partial MCP schema, requiring at least an mcpName.
@@ -12538,15 +12554,15 @@ declare function overrideWiki(wikiSchema: TWikiSchema): IWikiSchema;
  * @type TComputeSchema
  * @description Type for partial compute schema updates, requiring computeName and allowing other IComputeSchema properties.
  */
-type TComputeSchema = {
-    computeName: IComputeSchema["computeName"];
-} & Partial<IComputeSchema>;
+type TComputeSchema<T extends IComputeData = any> = {
+    computeName: IComputeSchema<T>["computeName"];
+} & Partial<IComputeSchema<T>>;
 /**
  * Overrides an existing compute schema with provided partial updates.
  * @param {TComputeSchema} computeSchema - The partial compute schema with updates.
  * @returns {IComputeSchema} The updated compute schema.
  */
-declare function overrideCompute(computeSchema: TComputeSchema): IComputeSchema<any>;
+declare function overrideCompute<T extends IComputeData = any>(computeSchema: TComputeSchema<T>): IComputeSchema<any>;
 
 /**
  * @module overridePipeline
@@ -12568,16 +12584,16 @@ declare function overridePipeline<Payload extends object = any>(pipelineSchema:
  * @property {IOutlineSchema["outlineName"]} outlineName - The unique name of the outline to override.
  * @property {Partial<IOutlineSchema>} [partial] - Optional partial properties of the `IOutlineSchema` to override.
  */
-type TOutlineSchema = {
-    outlineName: IOutlineSchema["outlineName"];
-} & Partial<IOutlineSchema>;
+type TOutlineSchema<Data extends IOutlineData = IOutlineData, Param extends IOutlineParam = IOutlineParam> = {
+    outlineName: IOutlineSchema<Data, Param>["outlineName"];
+} & Partial<IOutlineSchema<Data, Param>>;
 /**
  * Overrides an existing outline schema in the swarm system by updating it with the provided partial schema.
  * Ensures the operation runs in a clean context using `beginContext` to avoid interference from existing method or execution contexts.
  * Logs the operation if logging is enabled in the global configuration.
  * @param {TOutlineSchema} outlineSchema - The partial outline schema containing the outline name and optional schema properties to override.
  */
-declare function overrideOutline(outlineSchema: TOutlineSchema): IOutlineSchema<any, any>;
+declare function overrideOutline<Data extends IOutlineData = IOutlineData, Param extends IOutlineParam = IOutlineParam>(outlineSchema: TOutlineSchema<Data, Param>): IOutlineSchema<any, any>;
 
 /**
  * Marks a client as online in the specified swarm.
@@ -15975,4 +15991,4 @@ declare const Utils: {
     PersistEmbeddingUtils: typeof PersistEmbeddingUtils;
 };
 
-export { Adapter, Chat, ChatInstance, Compute, type EventSource, ExecutionContextService, History, HistoryMemoryInstance, HistoryPersistInstance, type IAgentSchemaInternal, type IAgentTool, type IBaseEvent, type IBusEvent, type IBusEventContext, type IChatArgs, type IChatInstance, type IChatInstanceCallbacks, type ICompletionArgs, type ICompletionSchema, type IComputeSchema, type ICustomEvent, type IEmbeddingSchema, 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 IModelMessage, type INavigateToAgentParams, type INavigateToTriageParams, type IOutgoingMessage, 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 ISessionConfig, type IStateSchema, type IStorageData, type IStorageSchema, type ISwarmSchema, type ITool, type IToolCall, type IWikiSchema, Logger, LoggerInstance, MCP, type MCPToolProperties, MethodContextService, Operator, OperatorInstance, PayloadContextService, PersistAlive, PersistBase, PersistEmbedding, PersistList, PersistMemory, PersistPolicy, PersistState, PersistStorage, PersistSwarm, Policy, type ReceiveMessageFn, RoundRobin, Schema, SchemaContextService, type SendMessageFn, SharedCompute, SharedState, SharedStorage, State, Storage, type THistoryInstanceCtor, type THistoryMemoryInstance, type THistoryPersistInstance, type TLoggerInstance, type TOperatorInstance, type TPersistBase, type TPersistBaseCtor, type TPersistList, type ToolValue, Utils, addAgent, addAgentNavigation, addCompletion, addCompute, addEmbedding, addMCP, addOutline, addPipeline, addPolicy, addState, addStorage, addSwarm, addTool, addTriageNavigation, addWiki, beginContext, cancelOutput, cancelOutputForce, changeToAgent, changeToDefaultAgent, changeToPrevAgent, commitAssistantMessage, commitAssistantMessageForce, commitDeveloperMessage, commitDeveloperMessageForce, commitFlush, commitFlushForce, commitStopTools, commitStopToolsForce, commitSystemMessage, commitSystemMessageForce, commitToolOutput, commitToolOutputForce, commitToolRequest, commitToolRequestForce, commitUserMessage, commitUserMessageForce, complete, createNavigateToAgent, createNavigateToTriageAgent, disposeConnection, dumpAgent, dumpClientPerformance, dumpDocs, dumpPerfomance, dumpSwarm, emit, emitForce, event, execute, executeForce, fork, 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, getWiki, 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, overrideAgent, overrideCompletion, overrideCompute, overrideEmbeding, overrideMCP, overrideOutline, overridePipeline, overridePolicy, overrideState, overrideStorage, overrideSwarm, overrideTool, overrideWiki, question, questionForce, runStateless, runStatelessForce, scope, session, setConfig, startPipeline, swarm, toJsonSchema, validate, validateToolArguments };
+export { Adapter, Chat, ChatInstance, Compute, type EventSource, ExecutionContextService, History, HistoryMemoryInstance, HistoryPersistInstance, type IAgentSchemaInternal, type IAgentTool, type IBaseEvent, type IBusEvent, type IBusEventContext, type IChatArgs, type IChatInstance, type IChatInstanceCallbacks, type ICompletionArgs, type ICompletionSchema, type IComputeSchema, type ICustomEvent, type IEmbeddingSchema, 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 IModelMessage, type INavigateToAgentParams, type INavigateToTriageParams, type IOutgoingMessage, 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 ISessionConfig, type IStateSchema, type IStorageData, type IStorageSchema, type ISwarmSchema, type ITool, type IToolCall, type IWikiSchema, Logger, LoggerInstance, MCP, type MCPToolProperties, MethodContextService, Operator, OperatorInstance, PayloadContextService, PersistAlive, PersistBase, PersistEmbedding, PersistList, PersistMemory, PersistPolicy, PersistState, PersistStorage, PersistSwarm, Policy, type ReceiveMessageFn, RoundRobin, Schema, SchemaContextService, type SendMessageFn, SharedCompute, SharedState, SharedStorage, State, Storage, type THistoryInstanceCtor, type THistoryMemoryInstance, type THistoryPersistInstance, type TLoggerInstance, type TOperatorInstance, type TPersistBase, type TPersistBaseCtor, type TPersistList, type ToolValue, Utils, addAgent, addAgentNavigation, addCompletion, addCompute, addEmbedding, addMCP, addOutline, addPipeline, addPolicy, addState, addStorage, addSwarm, addTool, addTriageNavigation, addWiki, beginContext, cancelOutput, cancelOutputForce, changeToAgent, changeToDefaultAgent, changeToPrevAgent, commitAssistantMessage, commitAssistantMessageForce, commitDeveloperMessage, commitDeveloperMessageForce, commitFlush, commitFlushForce, commitStopTools, commitStopToolsForce, commitSystemMessage, commitSystemMessageForce, commitToolOutput, commitToolOutputForce, commitToolRequest, commitToolRequestForce, commitUserMessage, commitUserMessageForce, complete, createNavigateToAgent, createNavigateToTriageAgent, disposeConnection, dumpAgent, dumpClientPerformance, dumpDocs, dumpOutlineResult, dumpPerfomance, dumpSwarm, emit, emitForce, event, execute, executeForce, fork, 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, getWiki, 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, overrideAgent, overrideCompletion, overrideCompute, overrideEmbeding, overrideMCP, overrideOutline, overridePipeline, overridePolicy, overrideState, overrideStorage, overrideSwarm, overrideTool, overrideWiki, question, questionForce, runStateless, runStatelessForce, scope, session, setConfig, startPipeline, swarm, toJsonSchema, validate, validateToolArguments };