agent-swarm-kit 1.1.113 → 1.1.115

package/build/index.cjs

@@ -13211,6 +13211,13 @@ class DocService {
          * @private
          */
         this.agentValidationService = inject(TYPES.agentValidationService);
+        /**
+         * Outline validation service instance, injected via DI.
+         * Used for validating and managing agent outline schemas, ensuring agent outlines conform to expected structure and constraints.
+         * @type {OutlineValidationService}
+         * @private
+         */
+        this.outlineValidationService = inject(TYPES.outlineValidationService);
         /**
          * Swarm schema service instance, injected via DI.
          * Retrieves ISwarmSchema objects for writeSwarmDoc, supplying swarm details like agents and policies.
@@ -13225,6 +13232,13 @@ class DocService {
          * @private
          */
         this.agentSchemaService = inject(TYPES.agentSchemaService);
+        /**
+         * Outline schema service instance, injected via DI.
+         * Retrieves and manages outline schema objects for agents, supporting documentation and validation of agent outlines.
+         * @type {OutlineSchemaService}
+         * @private
+         */
+        this.outlineSchemaService = inject(TYPES.outlineSchemaService);
         /**
          * Model context protocol service instance, injected via DI.
          * Retrieves IMCPSchema objects for writeAgentDoc and agent descriptions in writeSwarmDoc, providing details like tools and prompts.
@@ -13396,6 +13410,142 @@ class DocService {
             maxExec: THREAD_POOL_SIZE,
             delay: THREAD_POOL_DELAY,
         });
+        /**
+         * Writes Markdown documentation for an outline schema, detailing its name, description, main prompt, output format, and callbacks.
+         * Executes in a thread pool (THREAD_POOL_SIZE) to manage concurrency, logging via loggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is enabled.
+         * Outputs to dirName/[outlineName].md, sourced from outlineSchemaService.
+         *
+         * - The Markdown includes YAML frontmatter, outline name, description, prompt(s), output format (with types, descriptions, enums, and required fields), and callbacks.
+         * - Handles both string and function-based prompts, and supports array or string prompt types.
+         * - Output format section documents each property, its type, description, enum values, and required status.
+         * - Callback section lists all callback names used by the outline.
+         *
+         * @param {IOutlineSchema} outlineSchema - The outline schema to document, including properties like prompt, format, and callbacks.
+         * @param {string} prefix - The documentation group or prefix for organizing output.
+         * @param {string} dirName - The base directory for documentation output.
+         * @param {(text: string) => string} [sanitizeMarkdown=(t) => t] - Optional function to sanitize Markdown text.
+         * @returns {Promise<void>} A promise resolving when the outline documentation file is written.
+         * @private
+         */
+        this.writeOutlineDoc = functoolsKit.execpool(async (outlineSchema, prefix, dirName, sanitizeMarkdown = (t) => t) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info("docService writeOutlineDoc", {
+                    outlineSchema,
+                });
+            const result = [];
+            {
+                result.push("---");
+                result.push(`title: ${prefix}/${sanitizeMarkdown(outlineSchema.outlineName)}`);
+                result.push(`group: ${prefix}`);
+                result.push("---");
+                result.push("");
+            }
+            {
+                result.push(`# ${sanitizeMarkdown(outlineSchema.outlineName)}`);
+                if (outlineSchema.docDescription) {
+                    result.push("");
+                    result.push(`> ${sanitizeMarkdown(outlineSchema.docDescription)}`);
+                }
+                result.push("");
+            }
+            const getPrompt = async () => {
+                try {
+                    if (typeof outlineSchema.prompt === "string") {
+                        return outlineSchema.prompt;
+                    }
+                    if (typeof outlineSchema.prompt === "function") {
+                        return await outlineSchema.prompt(outlineSchema.outlineName);
+                    }
+                    return null;
+                }
+                catch {
+                    return null;
+                }
+            };
+            const prompt = await getPrompt();
+            if (Array.isArray(prompt)) {
+                result.push(`## Main prompt`);
+                result.push("");
+                for (let i = 0; i !== prompt.length; i++) {
+                    if (!prompt[i]) {
+                        continue;
+                    }
+                    result.push(`${i + 1}. \`${sanitizeMarkdown(prompt[i])}\``);
+                    result.push("");
+                }
+            }
+            if (typeof prompt === "string") {
+                result.push(`## Main prompt`);
+                result.push("");
+                result.push("```");
+                result.push(sanitizeMarkdown(prompt));
+                result.push("```");
+                result.push("");
+            }
+            if (outlineSchema.format) {
+                result.push("");
+                result.push("## Output format");
+                const entries = Object.entries(outlineSchema.format.properties);
+                entries.forEach(([key, { type, description, enum: e }], idx) => {
+                    result.push("");
+                    result.push(`> **${idx + 1}. ${sanitizeMarkdown(key)}**`);
+                    {
+                        result.push("");
+                        result.push(`*Type:* \`${sanitizeMarkdown(type)}\``);
+                    }
+                    {
+                        result.push("");
+                        result.push(`*Description:* \`${sanitizeMarkdown(description)}\``);
+                    }
+                    if (e) {
+                        result.push("");
+                        result.push(`*Enum:* \`${e.map(sanitizeMarkdown).join(", ")}\``);
+                    }
+                    {
+                        result.push("");
+                        result.push(`*Required:* [${outlineSchema.format.required.includes(key) ? "x" : " "}]`);
+                    }
+                });
+                if (!entries.length) {
+                    result.push("");
+                    result.push(`*Empty parameters*`);
+                }
+                result.push("");
+            }
+            const getValidations = () => {
+                if (outlineSchema.validations) {
+                    return outlineSchema.validations
+                        .filter((validation) => typeof validation === "object")
+                        .filter((validation) => !!validation.docDescription);
+                }
+                return [];
+            };
+            const validations = getValidations();
+            if (validations.length) {
+                result.push(`## Validations`);
+                result.push("");
+                for (let i = 0; i !== prompt.length; i++) {
+                    if (!validations[i].docDescription) {
+                        continue;
+                    }
+                    result.push(`${i + 1}. \`${sanitizeMarkdown(validations[i].docDescription)}\``);
+                    result.push("");
+                }
+            }
+            if (outlineSchema.callbacks) {
+                result.push(`## Used callbacks`);
+                result.push("");
+                const callbackList = Object.keys(outlineSchema.callbacks);
+                for (let i = 0; i !== callbackList.length; i++) {
+                    result.push(`${i + 1}. \`${sanitizeMarkdown(callbackList[i])}\``);
+                }
+                result.push("");
+            }
+            await writeFileAtomic(path.join(dirName, `./${outlineSchema.outlineName}.md`), result.join("\n"));
+        }, {
+            maxExec: THREAD_POOL_SIZE,
+            delay: THREAD_POOL_DELAY,
+        });
         /**
          * Writes Markdown documentation for an agent schema, detailing its name, description, UML diagram, prompts, tools, storages, states, and callbacks.
          * Executes in a thread pool (THREAD_POOL_SIZE) to manage concurrency, logging via loggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is enabled.
@@ -13787,6 +13937,14 @@ class DocService {
                 const agentSchema = this.agentSchemaService.get(agentName);
                 await this.writeAgentDoc(agentSchema, prefix, dirName, sanitizeMarkdown);
             }));
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info("docService dumpDocs building outline docs");
+            await Promise.all(this.outlineValidationService
+                .getOutlineList()
+                .map(async (outlineName) => {
+                const outlineSchema = this.outlineSchemaService.get(outlineName);
+                await this.writeOutlineDoc(outlineSchema, prefix, dirName, sanitizeMarkdown);
+            }));
         };
         /**
          * Dumps system-wide performance data to a JSON file using PerfService.toRecord.
@@ -18197,6 +18355,16 @@ class OutlineValidationService {
             }
             this._outlineMap.set(outlineName, outlineSchema);
         };
+        /**
+         * Retrieves a list of all registered outline names.
+         * Logs the retrieval operation if info logging is enabled.
+         * @returns {OutlineName[]} An array of registered outline names.
+         */
+        this.getOutlineList = () => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info("outlineValidationService getOutlineList");
+            return [...this._outlineMap.keys()];
+        };
         /**
          * Validates the existence of an outline schema for the given outline name.
          * Memoized to cache results based on the outline name for performance.
@@ -18424,6 +18592,9 @@ const dumpDocs = beginContext((prefix = "swarm", dirName = "./docs/chat", PlantU
             console.error(`agent-swarm missing dependsOn for agentName=${agentName}`);
         }
     });
+    swarm$1.outlineValidationService
+        .getOutlineList()
+        .forEach((swarmName) => swarm$1.outlineValidationService.validate(swarmName, METHOD_NAME$1x));
     return swarm$1.docService.dumpDocs(prefix, dirName, sanitizeMarkdown);
 });
 
@@ -20954,9 +21125,18 @@ const MAX_ATTEMPTS = 5;
  * @implements {IOutlineHistory }
  */
 class OutlineHistory {
-    constructor() {
+    /**
+     * Constructs an OutlineHistory instance, optionally initializing with a system prompt.
+     * @param {string} [prompt] - An optional system prompt to initialize the history with.
+     * @constructor
+     */
+    constructor(prompt) {
         /** @private */
         this.messages = [];
+        prompt && this.messages.push({
+            role: "system",
+            content: prompt
+        });
     }
     /**
      * Appends one or more messages to the history.
@@ -20997,14 +21177,17 @@ class OutlineHistory {
 const jsonInternal = beginContext(async (outlineName, param) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
         swarm$1.loggerService.log(METHOD_NAME$D, {});
+    swarm$1.outlineValidationService.validate(outlineName, METHOD_NAME$D);
     const resultId = functoolsKit.randomString();
-    const { getStructuredOutput, validations = [], maxAttempts = MAX_ATTEMPTS, callbacks, } = swarm$1.outlineSchemaService.get(outlineName);
+    const { getStructuredOutput, validations = [], maxAttempts = MAX_ATTEMPTS, format, prompt, callbacks, } = swarm$1.outlineSchemaService.get(outlineName);
     let errorMessage = "";
     let history;
+    const systemPrompt = functoolsKit.str.newline(typeof prompt === "function" ? await prompt(outlineName) : prompt);
     for (let attempt = 0; attempt < maxAttempts; attempt++) {
-        history = new OutlineHistory();
+        history = new OutlineHistory(systemPrompt);
         const inputArgs = {
             attempt,
+            format,
             param,
             history,
         };

package/build/index.mjs

@@ -13209,6 +13209,13 @@ class DocService {
          * @private
          */
         this.agentValidationService = inject(TYPES.agentValidationService);
+        /**
+         * Outline validation service instance, injected via DI.
+         * Used for validating and managing agent outline schemas, ensuring agent outlines conform to expected structure and constraints.
+         * @type {OutlineValidationService}
+         * @private
+         */
+        this.outlineValidationService = inject(TYPES.outlineValidationService);
         /**
          * Swarm schema service instance, injected via DI.
          * Retrieves ISwarmSchema objects for writeSwarmDoc, supplying swarm details like agents and policies.
@@ -13223,6 +13230,13 @@ class DocService {
          * @private
          */
         this.agentSchemaService = inject(TYPES.agentSchemaService);
+        /**
+         * Outline schema service instance, injected via DI.
+         * Retrieves and manages outline schema objects for agents, supporting documentation and validation of agent outlines.
+         * @type {OutlineSchemaService}
+         * @private
+         */
+        this.outlineSchemaService = inject(TYPES.outlineSchemaService);
         /**
          * Model context protocol service instance, injected via DI.
          * Retrieves IMCPSchema objects for writeAgentDoc and agent descriptions in writeSwarmDoc, providing details like tools and prompts.
@@ -13394,6 +13408,142 @@ class DocService {
             maxExec: THREAD_POOL_SIZE,
             delay: THREAD_POOL_DELAY,
         });
+        /**
+         * Writes Markdown documentation for an outline schema, detailing its name, description, main prompt, output format, and callbacks.
+         * Executes in a thread pool (THREAD_POOL_SIZE) to manage concurrency, logging via loggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is enabled.
+         * Outputs to dirName/[outlineName].md, sourced from outlineSchemaService.
+         *
+         * - The Markdown includes YAML frontmatter, outline name, description, prompt(s), output format (with types, descriptions, enums, and required fields), and callbacks.
+         * - Handles both string and function-based prompts, and supports array or string prompt types.
+         * - Output format section documents each property, its type, description, enum values, and required status.
+         * - Callback section lists all callback names used by the outline.
+         *
+         * @param {IOutlineSchema} outlineSchema - The outline schema to document, including properties like prompt, format, and callbacks.
+         * @param {string} prefix - The documentation group or prefix for organizing output.
+         * @param {string} dirName - The base directory for documentation output.
+         * @param {(text: string) => string} [sanitizeMarkdown=(t) => t] - Optional function to sanitize Markdown text.
+         * @returns {Promise<void>} A promise resolving when the outline documentation file is written.
+         * @private
+         */
+        this.writeOutlineDoc = execpool(async (outlineSchema, prefix, dirName, sanitizeMarkdown = (t) => t) => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info("docService writeOutlineDoc", {
+                    outlineSchema,
+                });
+            const result = [];
+            {
+                result.push("---");
+                result.push(`title: ${prefix}/${sanitizeMarkdown(outlineSchema.outlineName)}`);
+                result.push(`group: ${prefix}`);
+                result.push("---");
+                result.push("");
+            }
+            {
+                result.push(`# ${sanitizeMarkdown(outlineSchema.outlineName)}`);
+                if (outlineSchema.docDescription) {
+                    result.push("");
+                    result.push(`> ${sanitizeMarkdown(outlineSchema.docDescription)}`);
+                }
+                result.push("");
+            }
+            const getPrompt = async () => {
+                try {
+                    if (typeof outlineSchema.prompt === "string") {
+                        return outlineSchema.prompt;
+                    }
+                    if (typeof outlineSchema.prompt === "function") {
+                        return await outlineSchema.prompt(outlineSchema.outlineName);
+                    }
+                    return null;
+                }
+                catch {
+                    return null;
+                }
+            };
+            const prompt = await getPrompt();
+            if (Array.isArray(prompt)) {
+                result.push(`## Main prompt`);
+                result.push("");
+                for (let i = 0; i !== prompt.length; i++) {
+                    if (!prompt[i]) {
+                        continue;
+                    }
+                    result.push(`${i + 1}. \`${sanitizeMarkdown(prompt[i])}\``);
+                    result.push("");
+                }
+            }
+            if (typeof prompt === "string") {
+                result.push(`## Main prompt`);
+                result.push("");
+                result.push("```");
+                result.push(sanitizeMarkdown(prompt));
+                result.push("```");
+                result.push("");
+            }
+            if (outlineSchema.format) {
+                result.push("");
+                result.push("## Output format");
+                const entries = Object.entries(outlineSchema.format.properties);
+                entries.forEach(([key, { type, description, enum: e }], idx) => {
+                    result.push("");
+                    result.push(`> **${idx + 1}. ${sanitizeMarkdown(key)}**`);
+                    {
+                        result.push("");
+                        result.push(`*Type:* \`${sanitizeMarkdown(type)}\``);
+                    }
+                    {
+                        result.push("");
+                        result.push(`*Description:* \`${sanitizeMarkdown(description)}\``);
+                    }
+                    if (e) {
+                        result.push("");
+                        result.push(`*Enum:* \`${e.map(sanitizeMarkdown).join(", ")}\``);
+                    }
+                    {
+                        result.push("");
+                        result.push(`*Required:* [${outlineSchema.format.required.includes(key) ? "x" : " "}]`);
+                    }
+                });
+                if (!entries.length) {
+                    result.push("");
+                    result.push(`*Empty parameters*`);
+                }
+                result.push("");
+            }
+            const getValidations = () => {
+                if (outlineSchema.validations) {
+                    return outlineSchema.validations
+                        .filter((validation) => typeof validation === "object")
+                        .filter((validation) => !!validation.docDescription);
+                }
+                return [];
+            };
+            const validations = getValidations();
+            if (validations.length) {
+                result.push(`## Validations`);
+                result.push("");
+                for (let i = 0; i !== prompt.length; i++) {
+                    if (!validations[i].docDescription) {
+                        continue;
+                    }
+                    result.push(`${i + 1}. \`${sanitizeMarkdown(validations[i].docDescription)}\``);
+                    result.push("");
+                }
+            }
+            if (outlineSchema.callbacks) {
+                result.push(`## Used callbacks`);
+                result.push("");
+                const callbackList = Object.keys(outlineSchema.callbacks);
+                for (let i = 0; i !== callbackList.length; i++) {
+                    result.push(`${i + 1}. \`${sanitizeMarkdown(callbackList[i])}\``);
+                }
+                result.push("");
+            }
+            await writeFileAtomic(join(dirName, `./${outlineSchema.outlineName}.md`), result.join("\n"));
+        }, {
+            maxExec: THREAD_POOL_SIZE,
+            delay: THREAD_POOL_DELAY,
+        });
         /**
          * Writes Markdown documentation for an agent schema, detailing its name, description, UML diagram, prompts, tools, storages, states, and callbacks.
          * Executes in a thread pool (THREAD_POOL_SIZE) to manage concurrency, logging via loggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is enabled.
@@ -13785,6 +13935,14 @@ class DocService {
                 const agentSchema = this.agentSchemaService.get(agentName);
                 await this.writeAgentDoc(agentSchema, prefix, dirName, sanitizeMarkdown);
             }));
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info("docService dumpDocs building outline docs");
+            await Promise.all(this.outlineValidationService
+                .getOutlineList()
+                .map(async (outlineName) => {
+                const outlineSchema = this.outlineSchemaService.get(outlineName);
+                await this.writeOutlineDoc(outlineSchema, prefix, dirName, sanitizeMarkdown);
+            }));
         };
         /**
          * Dumps system-wide performance data to a JSON file using PerfService.toRecord.
@@ -18195,6 +18353,16 @@ class OutlineValidationService {
             }
             this._outlineMap.set(outlineName, outlineSchema);
         };
+        /**
+         * Retrieves a list of all registered outline names.
+         * Logs the retrieval operation if info logging is enabled.
+         * @returns {OutlineName[]} An array of registered outline names.
+         */
+        this.getOutlineList = () => {
+            GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
+                this.loggerService.info("outlineValidationService getOutlineList");
+            return [...this._outlineMap.keys()];
+        };
         /**
          * Validates the existence of an outline schema for the given outline name.
          * Memoized to cache results based on the outline name for performance.
@@ -18422,6 +18590,9 @@ const dumpDocs = beginContext((prefix = "swarm", dirName = "./docs/chat", PlantU
             console.error(`agent-swarm missing dependsOn for agentName=${agentName}`);
         }
     });
+    swarm$1.outlineValidationService
+        .getOutlineList()
+        .forEach((swarmName) => swarm$1.outlineValidationService.validate(swarmName, METHOD_NAME$1x));
     return swarm$1.docService.dumpDocs(prefix, dirName, sanitizeMarkdown);
 });
 
@@ -20952,9 +21123,18 @@ const MAX_ATTEMPTS = 5;
  * @implements {IOutlineHistory }
  */
 class OutlineHistory {
-    constructor() {
+    /**
+     * Constructs an OutlineHistory instance, optionally initializing with a system prompt.
+     * @param {string} [prompt] - An optional system prompt to initialize the history with.
+     * @constructor
+     */
+    constructor(prompt) {
         /** @private */
         this.messages = [];
+        prompt && this.messages.push({
+            role: "system",
+            content: prompt
+        });
     }
     /**
      * Appends one or more messages to the history.
@@ -20995,14 +21175,17 @@ class OutlineHistory {
 const jsonInternal = beginContext(async (outlineName, param) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
         swarm$1.loggerService.log(METHOD_NAME$D, {});
+    swarm$1.outlineValidationService.validate(outlineName, METHOD_NAME$D);
     const resultId = randomString();
-    const { getStructuredOutput, validations = [], maxAttempts = MAX_ATTEMPTS, callbacks, } = swarm$1.outlineSchemaService.get(outlineName);
+    const { getStructuredOutput, validations = [], maxAttempts = MAX_ATTEMPTS, format, prompt, callbacks, } = swarm$1.outlineSchemaService.get(outlineName);
     let errorMessage = "";
     let history;
+    const systemPrompt = str.newline(typeof prompt === "function" ? await prompt(outlineName) : prompt);
     for (let attempt = 0; attempt < maxAttempts; attempt++) {
-        history = new OutlineHistory();
+        history = new OutlineHistory(systemPrompt);
         const inputArgs = {
             attempt,
+            format,
             param,
             history,
         };

package/package.json

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

package/types.d.ts

@@ -4736,6 +4736,41 @@ type IOutlineParam = any;
  * @typedef {any} IOutlineData
  */
 type IOutlineData = any;
+/**
+ * Interface representing the format/schema definition for outline data.
+ * Specifies the structure, required fields, and property metadata for outline operations.
+ * Used to enforce and document the expected shape of outline data.
+ */
+interface IOutlineFormat {
+    /**
+     * The root type of the outline format (e.g., "object").
+     */
+    type: string;
+    /**
+     * Array of property names that are required in the outline data.
+     */
+    required: string[];
+    /**
+     * An object mapping property names to their type, description, and optional enum values.
+     * Each property describes a field in the outline data.
+     */
+    properties: {
+        [key: string]: {
+            /**
+             * The type of the property (e.g., "string", "number", "boolean", etc.).
+             */
+            type: string;
+            /**
+             * A human-readable description of the property.
+             */
+            description: string;
+            /**
+             * Optional array of allowed values for the property.
+             */
+            enum?: string[];
+        };
+    };
+}
 /**
  * Interface defining callbacks for outline lifecycle events.
  * Provides hooks for handling attempt initiation, document generation, and validation outcomes.
@@ -4832,6 +4867,10 @@ interface IOutlineArgs<Param extends IOutlineParam = IOutlineParam> {
      * @type {number}
      */
     attempt: number;
+    /**
+     * Format of output taken from outline schema
+     */
+    format: IOutlineFormat;
     /**
      * The history management API for the outline operation.
      * Provides access to message history for context or logging.
@@ -4947,6 +4986,14 @@ interface IOutlineResult<Data extends IOutlineData = IOutlineData, Param extends
  * @interface IOutlineSchema
  */
 interface IOutlineSchema<Data extends IOutlineData = IOutlineData, Param extends IOutlineParam = IOutlineParam> {
+    /**
+     * The prompt or prompt generator for the outline operation.
+     * Can be a string, an array of strings, or a function that returns a string, array of strings, or a promise resolving to either.
+     * If a function is provided, it receives the outline name and can return a prompt dynamically.
+     * Used as the initial instruction or context for the outline process.
+     * @type {string | string[] | ((outlineName: OutlineName) => (string | string[] | Promise<string | string[]>))}
+     */
+    prompt: string | string[] | ((outlineName: OutlineName) => (string | string[] | Promise<string | string[]>));
     /**
      * Optional description for documentation purposes.
      * Aids in understanding the purpose or behavior of the outline.
@@ -4972,6 +5019,12 @@ interface IOutlineSchema<Data extends IOutlineData = IOutlineData, Param extends
      * @type {(IOutlineValidation<Data, Param> | IOutlineValidationFn<Data, Param>)[]}
      */
     validations?: (IOutlineValidation<Data, Param> | IOutlineValidationFn<Data, Param>)[];
+    /**
+     * The format/schema definition for the outline data.
+     * Specifies the expected structure, required fields, and property metadata for validation and documentation.
+     * @type {IOutlineFormat}
+     */
+    format: IOutlineFormat;
     /**
      * Optional maximum number of attempts for the outline operation.
      * Limits the number of retries if validations fail.
@@ -8457,6 +8510,13 @@ declare class DocService {
      * @private
      */
     private readonly agentValidationService;
+    /**
+     * Outline validation service instance, injected via DI.
+     * Used for validating and managing agent outline schemas, ensuring agent outlines conform to expected structure and constraints.
+     * @type {OutlineValidationService}
+     * @private
+     */
+    private readonly outlineValidationService;
     /**
      * Swarm schema service instance, injected via DI.
      * Retrieves ISwarmSchema objects for writeSwarmDoc, supplying swarm details like agents and policies.
@@ -8471,6 +8531,13 @@ declare class DocService {
      * @private
      */
     private readonly agentSchemaService;
+    /**
+     * Outline schema service instance, injected via DI.
+     * Retrieves and manages outline schema objects for agents, supporting documentation and validation of agent outlines.
+     * @type {OutlineSchemaService}
+     * @private
+     */
+    private readonly outlineSchemaService;
     /**
      * Model context protocol service instance, injected via DI.
      * Retrieves IMCPSchema objects for writeAgentDoc and agent descriptions in writeSwarmDoc, providing details like tools and prompts.
@@ -8551,6 +8618,24 @@ declare class DocService {
      * @private
      */
     private writeSwarmDoc;
+    /**
+     * Writes Markdown documentation for an outline schema, detailing its name, description, main prompt, output format, and callbacks.
+     * Executes in a thread pool (THREAD_POOL_SIZE) to manage concurrency, logging via loggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is enabled.
+     * Outputs to dirName/[outlineName].md, sourced from outlineSchemaService.
+     *
+     * - The Markdown includes YAML frontmatter, outline name, description, prompt(s), output format (with types, descriptions, enums, and required fields), and callbacks.
+     * - Handles both string and function-based prompts, and supports array or string prompt types.
+     * - Output format section documents each property, its type, description, enum values, and required status.
+     * - Callback section lists all callback names used by the outline.
+     *
+     * @param {IOutlineSchema} outlineSchema - The outline schema to document, including properties like prompt, format, and callbacks.
+     * @param {string} prefix - The documentation group or prefix for organizing output.
+     * @param {string} dirName - The base directory for documentation output.
+     * @param {(text: string) => string} [sanitizeMarkdown=(t) => t] - Optional function to sanitize Markdown text.
+     * @returns {Promise<void>} A promise resolving when the outline documentation file is written.
+     * @private
+     */
+    private writeOutlineDoc;
     /**
      * Writes Markdown documentation for an agent schema, detailing its name, description, UML diagram, prompts, tools, storages, states, and callbacks.
      * Executes in a thread pool (THREAD_POOL_SIZE) to manage concurrency, logging via loggerService if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is enabled.
@@ -11151,6 +11236,12 @@ declare class OutlineValidationService {
      * @throws {Error} If an outline with the given name already exists in the map.
      */
     addOutline: (outlineName: OutlineName, outlineSchema: IOutlineSchema) => void;
+    /**
+     * Retrieves a list of all registered outline names.
+     * Logs the retrieval operation if info logging is enabled.
+     * @returns {OutlineName[]} An array of registered outline names.
+     */
+    getOutlineList: () => OutlineName[];
     /**
      * Validates the existence of an outline schema for the given outline name.
      * Memoized to cache results based on the outline name for performance.
@@ -11960,7 +12051,7 @@ declare function addPipeline<Payload extends object = any>(pipelineSchema: IPipe
  * @param {IOutlineSchema} outlineSchema - The outline schema to register, containing the outline name and configuration.
  * @returns {string} The name of the registered outline.
  */
-declare function addOutline(outlineSchema: IOutlineSchema): string;
+declare function addOutline<Data extends IOutlineData = IOutlineData, Param extends IOutlineParam = IOutlineParam>(outlineSchema: IOutlineSchema<Data, Param>): string;
 
 type TAgentSchema = {
     agentName: IAgentSchema["agentName"];
@@ -15557,4 +15648,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 IOutlineHistory, type IOutlineMessage, type IOutlineResult, type IOutlineSchema, 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, 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 };
+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 IOutlineResult, type IOutlineSchema, 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, 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 };