agent-swarm-kit 1.0.209 → 1.0.211

package/build/index.cjs

@@ -10603,7 +10603,7 @@ class DocService {
          * @returns {Promise<void>} A promise resolving when the swarm documentation file is written.
          * @private
          */
-        this.writeSwarmDoc = functoolsKit.execpool(async (swarmSchema, dirName) => {
+        this.writeSwarmDoc = functoolsKit.execpool(async (swarmSchema, prefix, dirName) => {
             GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
                 this.loggerService.info("docService writeSwarmDoc", {
                     swarmSchema,
@@ -10611,11 +10611,8 @@ class DocService {
             const result = [];
             {
                 result.push("---");
-                result.push(`title: ${swarmSchema.swarmName}.md`);
-                result.push(`children:`);
-                swarmSchema.agentList.forEach((agentName) => {
-                    result.push(`    - ./agent/${agentName}.md`);
-                });
+                result.push(`title: ${prefix}/${swarmSchema.swarmName}`);
+                result.push(`group: ${prefix}`);
                 result.push("---");
                 result.push("");
             }
@@ -10706,7 +10703,7 @@ class DocService {
          * @returns {Promise<void>} A promise resolving when the agent documentation file is written.
          * @private
          */
-        this.writeAgentDoc = functoolsKit.execpool(async (agentSchema, dirName) => {
+        this.writeAgentDoc = functoolsKit.execpool(async (agentSchema, prefix, dirName) => {
             GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
                 this.loggerService.info("docService writeAgentDoc", {
                     agentSchema,
@@ -10714,7 +10711,8 @@ class DocService {
             const result = [];
             {
                 result.push("---");
-                result.push(`title: ${agentSchema.agentName}.md`);
+                result.push(`title: ${prefix}/${agentSchema.agentName}.md`);
+                result.push(`group: ${prefix}`);
                 result.push("---");
                 result.push("");
             }
@@ -10929,7 +10927,7 @@ class DocService {
          * @param {string} [dirName=join(process.cwd(), "docs/chat")] - The base directory for documentation output, defaults to "docs/chat" in the current working directory.
          * @returns {Promise<void>} A promise resolving when all documentation files are written.
          */
-        this.dumpDocs = async (dirName = path.join(process.cwd(), "docs/chat")) => {
+        this.dumpDocs = async (prefix = "swarm", dirName = path.join(process.cwd(), "docs/chat")) => {
             GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
                 this.loggerService.info("docService dumpDocs", {
                     dirName,
@@ -10944,13 +10942,13 @@ class DocService {
                 this.loggerService.info("docService dumpDocs building swarm docs");
             await Promise.all(this.swarmValidationService.getSwarmList().map(async (swarmName) => {
                 const swarmSchema = this.swarmSchemaService.get(swarmName);
-                await this.writeSwarmDoc(swarmSchema, dirName);
+                await this.writeSwarmDoc(swarmSchema, prefix, dirName);
             }));
             GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
                 this.loggerService.info("docService dumpDocs building agent docs");
             await Promise.all(this.agentValidationService.getAgentList().map(async (agentName) => {
                 const agentSchema = this.agentSchemaService.get(agentName);
-                await this.writeAgentDoc(agentSchema, dirName);
+                await this.writeAgentDoc(agentSchema, prefix, dirName);
             }));
         };
         /**
@@ -13179,7 +13177,7 @@ const METHOD_NAME$U = "cli.dumpDocs";
  * @param {function} [PlantUML] - An optional function to process PlantUML diagrams.
  * @returns {Promise<void>} - A promise that resolves when the documentation has been dumped.
  */
-const dumpDocs = beginContext((dirName = "./docs/chat", PlantUML) => {
+const dumpDocs = beginContext((prefix = "swarm", dirName = "./docs/chat", PlantUML) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
         swarm$1.loggerService.log(METHOD_NAME$U, {
             dirName,
@@ -13201,7 +13199,7 @@ const dumpDocs = beginContext((dirName = "./docs/chat", PlantUML) => {
             console.error(`agent-swarm missing dependsOn for agentName=${agentName}`);
         }
     });
-    return swarm$1.docService.dumpDocs(dirName);
+    return swarm$1.docService.dumpDocs(prefix, dirName);
 });
 
 const METHOD_NAME$T = "cli.dumpAgent";

package/build/index.mjs

@@ -10601,7 +10601,7 @@ class DocService {
          * @returns {Promise<void>} A promise resolving when the swarm documentation file is written.
          * @private
          */
-        this.writeSwarmDoc = execpool(async (swarmSchema, dirName) => {
+        this.writeSwarmDoc = execpool(async (swarmSchema, prefix, dirName) => {
             GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
                 this.loggerService.info("docService writeSwarmDoc", {
                     swarmSchema,
@@ -10609,11 +10609,8 @@ class DocService {
             const result = [];
             {
                 result.push("---");
-                result.push(`title: ${swarmSchema.swarmName}.md`);
-                result.push(`children:`);
-                swarmSchema.agentList.forEach((agentName) => {
-                    result.push(`    - ./agent/${agentName}.md`);
-                });
+                result.push(`title: ${prefix}/${swarmSchema.swarmName}`);
+                result.push(`group: ${prefix}`);
                 result.push("---");
                 result.push("");
             }
@@ -10704,7 +10701,7 @@ class DocService {
          * @returns {Promise<void>} A promise resolving when the agent documentation file is written.
          * @private
          */
-        this.writeAgentDoc = execpool(async (agentSchema, dirName) => {
+        this.writeAgentDoc = execpool(async (agentSchema, prefix, dirName) => {
             GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
                 this.loggerService.info("docService writeAgentDoc", {
                     agentSchema,
@@ -10712,7 +10709,8 @@ class DocService {
             const result = [];
             {
                 result.push("---");
-                result.push(`title: ${agentSchema.agentName}.md`);
+                result.push(`title: ${prefix}/${agentSchema.agentName}.md`);
+                result.push(`group: ${prefix}`);
                 result.push("---");
                 result.push("");
             }
@@ -10927,7 +10925,7 @@ class DocService {
          * @param {string} [dirName=join(process.cwd(), "docs/chat")] - The base directory for documentation output, defaults to "docs/chat" in the current working directory.
          * @returns {Promise<void>} A promise resolving when all documentation files are written.
          */
-        this.dumpDocs = async (dirName = join(process.cwd(), "docs/chat")) => {
+        this.dumpDocs = async (prefix = "swarm", dirName = join(process.cwd(), "docs/chat")) => {
             GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
                 this.loggerService.info("docService dumpDocs", {
                     dirName,
@@ -10942,13 +10940,13 @@ class DocService {
                 this.loggerService.info("docService dumpDocs building swarm docs");
             await Promise.all(this.swarmValidationService.getSwarmList().map(async (swarmName) => {
                 const swarmSchema = this.swarmSchemaService.get(swarmName);
-                await this.writeSwarmDoc(swarmSchema, dirName);
+                await this.writeSwarmDoc(swarmSchema, prefix, dirName);
             }));
             GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO &&
                 this.loggerService.info("docService dumpDocs building agent docs");
             await Promise.all(this.agentValidationService.getAgentList().map(async (agentName) => {
                 const agentSchema = this.agentSchemaService.get(agentName);
-                await this.writeAgentDoc(agentSchema, dirName);
+                await this.writeAgentDoc(agentSchema, prefix, dirName);
             }));
         };
         /**
@@ -13177,7 +13175,7 @@ const METHOD_NAME$U = "cli.dumpDocs";
  * @param {function} [PlantUML] - An optional function to process PlantUML diagrams.
  * @returns {Promise<void>} - A promise that resolves when the documentation has been dumped.
  */
-const dumpDocs = beginContext((dirName = "./docs/chat", PlantUML) => {
+const dumpDocs = beginContext((prefix = "swarm", dirName = "./docs/chat", PlantUML) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
         swarm$1.loggerService.log(METHOD_NAME$U, {
             dirName,
@@ -13199,7 +13197,7 @@ const dumpDocs = beginContext((dirName = "./docs/chat", PlantUML) => {
             console.error(`agent-swarm missing dependsOn for agentName=${agentName}`);
         }
     });
-    return swarm$1.docService.dumpDocs(dirName);
+    return swarm$1.docService.dumpDocs(prefix, dirName);
 });
 
 const METHOD_NAME$T = "cli.dumpAgent";

package/package.json

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

package/types.d.ts

@@ -6893,7 +6893,7 @@ declare class DocService {
      * @param {string} [dirName=join(process.cwd(), "docs/chat")] - The base directory for documentation output, defaults to "docs/chat" in the current working directory.
      * @returns {Promise<void>} A promise resolving when all documentation files are written.
      */
-    dumpDocs: (dirName?: string) => Promise<void>;
+    dumpDocs: (prefix?: string, dirName?: string) => Promise<void>;
     /**
      * Dumps system-wide performance data to a JSON file using PerfService.toRecord.
      * Ensures the output directory exists, then writes a timestamped file, logging the process if GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO is enabled.
@@ -8197,7 +8197,7 @@ declare const swarm: {
  * @param {function} [PlantUML] - An optional function to process PlantUML diagrams.
  * @returns {Promise<void>} - A promise that resolves when the documentation has been dumped.
  */
-declare const dumpDocs: (dirName?: any, PlantUML?: (uml: string) => Promise<string>) => Promise<void>;
+declare const dumpDocs: (prefix?: any, dirName?: any, PlantUML?: (uml: string) => Promise<string>) => Promise<void>;
 
 /**
  * The config for UML generation