agent-swarm-kit 1.1.183 → 1.2.3

package/build/index.cjs

@@ -17308,10 +17308,10 @@ const dumpOutlineResult = beginContext(async (result, outputDir = "./dump/outlin
             summary += `**ResultId**: ${result.resultId}\n`;
             summary += `\n`;
         }
-        if (result.param) {
+        if (result.params) {
             summary += `## Input Parameters\n\n`;
             summary += "```json\n";
-            summary += JSON.stringify(result.param, null, 2);
+            summary += JSON.stringify(result.params, null, 2);
             summary += "\n```\n\n";
         }
         if (result.data) {
@@ -17357,10 +17357,10 @@ const dumpOutlineResult = beginContext(async (result, outputDir = "./dump/outlin
         const contentFilePath = path__namespace.join(subfolderPath, contentFileName);
         let content = `# Full Outline Result\n\n`;
         content += `**ResultId**: ${result.resultId}\n\n`;
-        if (result.param) {
+        if (result.params) {
             content += `## Completion Input Data\n\n`;
             content += "```json\n";
-            content += JSON.stringify(result.param, null, 2);
+            content += JSON.stringify(result.params, null, 2);
             content += "\n```\n\n";
         }
         if (result.data) {
@@ -20268,7 +20268,7 @@ class OutlineHistory {
  * @private
  * @async
  */
-const jsonInternal = beginContext(async (outlineName, param) => {
+const jsonInternal = beginContext(async (outlineName, ...params) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
         swarm$1.loggerService.log(METHOD_NAME$F, {});
     swarm$1.outlineValidationService.validate(outlineName, METHOD_NAME$F);
@@ -20309,13 +20309,12 @@ const jsonInternal = beginContext(async (outlineName, param) => {
         const inputArgs = {
             attempt,
             format,
-            param,
             history,
         };
         if (outlineCallbacks?.onAttempt) {
             outlineCallbacks.onAttempt(inputArgs);
         }
-        await getOutlineHistory(inputArgs);
+        await getOutlineHistory(inputArgs, ...params);
         const messages = await history.list();
         try {
             let output;
@@ -20358,7 +20357,7 @@ const jsonInternal = beginContext(async (outlineName, param) => {
             const result = {
                 isValid: true,
                 attempt,
-                param,
+                params,
                 history: await history.list(),
                 data,
                 resultId,
@@ -20380,7 +20379,7 @@ const jsonInternal = beginContext(async (outlineName, param) => {
         isValid: false,
         error: errorMessage ?? "Unknown error",
         attempt: maxAttempts,
-        param,
+        params,
         history: await history.list(),
         data: null,
         resultId,
@@ -20396,7 +20395,7 @@ const jsonInternal = beginContext(async (outlineName, param) => {
  * @async
  *
  * @param outlineName The outlineName parameter.
- * @param param The param parameter.
+ * @param params The spread params passed to getOutlineHistory.
  * @template Data - The type of the outline data, extending IOutlineData.
  * @template Param - The type of the input param, extending IOutlineParam.
  * @example
@@ -20404,8 +20403,8 @@ const jsonInternal = beginContext(async (outlineName, param) => {
  * const result = await json<"MyOutline", { query: string }>("MyOutline", { query: "example" });
  * console.log(result.isValid, result.data); // Logs validation status and data
  */
-async function json(outlineName, param = {}) {
-    return await jsonInternal(outlineName, param);
+async function json(outlineName, ...params) {
+    return await jsonInternal(outlineName, ...params);
 }
 
 const METHOD_NAME$E = "function.target.chat";

package/build/index.mjs

@@ -17288,10 +17288,10 @@ const dumpOutlineResult = beginContext(async (result, outputDir = "./dump/outlin
             summary += `**ResultId**: ${result.resultId}\n`;
             summary += `\n`;
         }
-        if (result.param) {
+        if (result.params) {
             summary += `## Input Parameters\n\n`;
             summary += "```json\n";
-            summary += JSON.stringify(result.param, null, 2);
+            summary += JSON.stringify(result.params, null, 2);
             summary += "\n```\n\n";
         }
         if (result.data) {
@@ -17337,10 +17337,10 @@ const dumpOutlineResult = beginContext(async (result, outputDir = "./dump/outlin
         const contentFilePath = path.join(subfolderPath, contentFileName);
         let content = `# Full Outline Result\n\n`;
         content += `**ResultId**: ${result.resultId}\n\n`;
-        if (result.param) {
+        if (result.params) {
             content += `## Completion Input Data\n\n`;
             content += "```json\n";
-            content += JSON.stringify(result.param, null, 2);
+            content += JSON.stringify(result.params, null, 2);
             content += "\n```\n\n";
         }
         if (result.data) {
@@ -20248,7 +20248,7 @@ class OutlineHistory {
  * @private
  * @async
  */
-const jsonInternal = beginContext(async (outlineName, param) => {
+const jsonInternal = beginContext(async (outlineName, ...params) => {
     GLOBAL_CONFIG.CC_LOGGER_ENABLE_LOG &&
         swarm$1.loggerService.log(METHOD_NAME$F, {});
     swarm$1.outlineValidationService.validate(outlineName, METHOD_NAME$F);
@@ -20289,13 +20289,12 @@ const jsonInternal = beginContext(async (outlineName, param) => {
         const inputArgs = {
             attempt,
             format,
-            param,
             history,
         };
         if (outlineCallbacks?.onAttempt) {
             outlineCallbacks.onAttempt(inputArgs);
         }
-        await getOutlineHistory(inputArgs);
+        await getOutlineHistory(inputArgs, ...params);
         const messages = await history.list();
         try {
             let output;
@@ -20338,7 +20337,7 @@ const jsonInternal = beginContext(async (outlineName, param) => {
             const result = {
                 isValid: true,
                 attempt,
-                param,
+                params,
                 history: await history.list(),
                 data,
                 resultId,
@@ -20360,7 +20359,7 @@ const jsonInternal = beginContext(async (outlineName, param) => {
         isValid: false,
         error: errorMessage ?? "Unknown error",
         attempt: maxAttempts,
-        param,
+        params,
         history: await history.list(),
         data: null,
         resultId,
@@ -20376,7 +20375,7 @@ const jsonInternal = beginContext(async (outlineName, param) => {
  * @async
  *
  * @param outlineName The outlineName parameter.
- * @param param The param parameter.
+ * @param params The spread params passed to getOutlineHistory.
  * @template Data - The type of the outline data, extending IOutlineData.
  * @template Param - The type of the input param, extending IOutlineParam.
  * @example
@@ -20384,8 +20383,8 @@ const jsonInternal = beginContext(async (outlineName, param) => {
  * const result = await json<"MyOutline", { query: string }>("MyOutline", { query: "example" });
  * console.log(result.isValid, result.data); // Logs validation status and data
  */
-async function json(outlineName, param = {}) {
-    return await jsonInternal(outlineName, param);
+async function json(outlineName, ...params) {
+    return await jsonInternal(outlineName, ...params);
 }
 
 const METHOD_NAME$E = "function.target.chat";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-swarm-kit",
-  "version": "1.1.183",
+  "version": "1.2.3",
   "description": "A TypeScript library for building orchestrated framework-agnostic multi-agent AI systems",
   "author": {
     "name": "Petr Tripolsky",
@@ -80,7 +80,7 @@
   },
   "dependencies": {
     "di-kit": "^1.0.18",
-    "di-scoped": "^1.0.20",
+    "di-scoped": "^1.0.21",
     "functools-kit": "^1.0.95",
     "get-moment-stamp": "^1.1.1",
     "lodash-es": "4.17.21",

package/types.d.ts

@@ -3899,27 +3899,27 @@ interface IOutlineObjectFormat {
  * @template Param - The type of the input param, defaults to IOutlineParam.
  * @interface IOutlineCallbacks
 */
-interface IOutlineCallbacks<Data extends IOutlineData = IOutlineData, Param extends IOutlineParam = IOutlineParam> {
+interface IOutlineCallbacks<Data extends IOutlineData = IOutlineData, Params extends IOutlineParam[] = IOutlineParam[]> {
     /**
      * Optional callback triggered when an outline attempt is initiated.
      * Useful for logging or tracking attempt starts.
      */
-    onAttempt?: (args: IOutlineArgs<Param>) => void;
+    onAttempt?: (args: IOutlineArgs) => void;
     /**
      * Optional callback triggered when an outline document is generated.
      * Useful for processing or logging the generated document.
      */
-    onDocument?: (result: IOutlineResult<Data, Param>) => void;
+    onDocument?: (result: IOutlineResult<Data, Params>) => void;
     /**
      * Optional callback triggered when a document passes validation.
      * Useful for handling successful validation outcomes.
      */
-    onValidDocument?: (result: IOutlineResult<Data, Param>) => void;
+    onValidDocument?: (result: IOutlineResult<Data, Params>) => void;
     /**
      * Optional callback triggered when a document fails validation.
      * Useful for handling failed validation outcomes or retries.
      */
-    onInvalidDocument?: (result: IOutlineResult<Data, Param>) => void;
+    onInvalidDocument?: (result: IOutlineResult<Data, Params>) => void;
 }
 /**
  * Interface representing the history management API for outline operations.
@@ -3948,12 +3948,7 @@ interface IOutlineHistory {
  * @template Param - The type of the input param, defaults to IOutlineParam.
  * @interface IOutlineArgs
 */
-interface IOutlineArgs<Param extends IOutlineParam = IOutlineParam> {
-    /**
-     * The input param for the outline operation.
-     * Contains the raw or structured param to be processed.
-     */
-    param: Param;
+interface IOutlineArgs {
     /**
      * The current attempt number for the outline operation.
      * Tracks the number of retries or iterations, useful for validation or retry logic.
@@ -3977,7 +3972,7 @@ interface IOutlineArgs<Param extends IOutlineParam = IOutlineParam> {
  * @interface IOutlineValidationArgs
  * @extends {IOutlineArgs<Param>}
 */
-interface IOutlineValidationArgs<Data extends IOutlineData = IOutlineData, Param extends IOutlineParam = IOutlineParam> extends IOutlineArgs<Param> {
+interface IOutlineValidationArgs<Data extends IOutlineData = IOutlineData> extends IOutlineArgs {
     /**
      * The data param generated by the outline operation.
      * Contains the result to be validated, typically structured param.
@@ -3990,8 +3985,8 @@ interface IOutlineValidationArgs<Data extends IOutlineData = IOutlineData, Param
  * @template Data - The type of the data param, defaults to IOutlineData.
  * @template Param - The type of the input param, defaults to IOutlineParam.
 */
-interface IOutlineValidationFn<Data extends IOutlineData = IOutlineData, Param extends IOutlineParam = IOutlineParam> {
-    (args: IOutlineValidationArgs<Data, Param>): void | Promise<void>;
+interface IOutlineValidationFn<Data extends IOutlineData = IOutlineData> {
+    (args: IOutlineValidationArgs<Data>): void | Promise<void>;
 }
 /**
  * Interface representing a validation configuration for outline operations.
@@ -4000,12 +3995,12 @@ interface IOutlineValidationFn<Data extends IOutlineData = IOutlineData, Param e
  * @template Param - The type of the input param, defaults to IOutlineParam.
  * @interface IOutlineValidation
 */
-interface IOutlineValidation<Data extends IOutlineData = IOutlineData, Param extends IOutlineParam = IOutlineParam> {
+interface IOutlineValidation<Data extends IOutlineData = IOutlineData> {
     /**
      * The validation function or configuration to apply to the outline data.
      * Can reference itself or another validation for chained or reusable logic.
      */
-    validate: IOutlineValidationFn<Data, Param>;
+    validate: IOutlineValidationFn<Data>;
     /**
      * Optional description for documentation purposes.
      * Aids in understanding the purpose or behavior of the validation.
@@ -4019,7 +4014,7 @@ interface IOutlineValidation<Data extends IOutlineData = IOutlineData, Param ext
  * @template Param - The type of the input param, defaults to IOutlineParam.
  * @interface IOutlineResult
 */
-interface IOutlineResult<Data extends IOutlineData = IOutlineData, Param extends IOutlineParam = IOutlineParam> {
+interface IOutlineResult<Data extends IOutlineData = IOutlineData, Params extends IOutlineParam[] = IOutlineParam[]> {
     /**
      * Indicates whether the outline data is valid based on validation checks.
      * True if all validations pass, false otherwise.
@@ -4041,10 +4036,10 @@ interface IOutlineResult<Data extends IOutlineData = IOutlineData, Param extends
      */
     error?: string | null;
     /**
-     * The input param used for the outline operation.
-     * Reflects the original param provided in the arguments.
+     * The input params used for the outline operation.
+     * Reflects the original params provided to json().
      */
-    param: Param;
+    params: Params;
     /**
      * The data param generated by the outline operation.
      * Null if the operation fails or no data is produced.
@@ -4063,7 +4058,7 @@ interface IOutlineResult<Data extends IOutlineData = IOutlineData, Param extends
  * @template Param - The type of the input param, defaults to IOutlineParam.
  * @interface IOutlineSchema
 */
-interface IOutlineSchema<Data extends IOutlineData = IOutlineData, Param extends IOutlineParam = IOutlineParam> {
+interface IOutlineSchema<Data extends IOutlineData = IOutlineData, Params extends IOutlineParam[] = IOutlineParam[]> {
     /** The name of the completion for JSON*/
     completion: CompletionName;
     /**
@@ -4091,14 +4086,14 @@ interface IOutlineSchema<Data extends IOutlineData = IOutlineData, Param extends
     outlineName: OutlineName;
     /**
      * Function to generate structured data for the outline operation.
-     * Processes input param and history to produce the desired data.
+     * Receives spread arguments: attempt, format, history, plus any additional params passed to json().
      */
-    getOutlineHistory(args: IOutlineArgs<Param>): Promise<void>;
+    getOutlineHistory(arg: IOutlineArgs, ...params: Params): Promise<void>;
     /**
      * Array of validation functions or configurations to apply to the outline data.
      * Supports both direct validation functions and structured validation configurations.
      */
-    validations?: (IOutlineValidation<Data, Param> | IOutlineValidationFn<Data, Param>)[];
+    validations?: (IOutlineValidation<Data> | IOutlineValidationFn<Data>)[];
     /**
      * The format/schema definition for the outline data.
      * Specifies the expected structure, required fields, and property metadata for validation and documentation.
@@ -9065,7 +9060,7 @@ declare class OutlineSchemaService {
      * Overrides an existing outline schema with partial updates for the specified key.
      * Logs the operation if `CC_LOGGER_ENABLE_INFO` is enabled and returns the updated schema.
      */
-    override: (key: OutlineName, value: Partial<IOutlineSchema>) => IOutlineSchema<any, any>;
+    override: (key: OutlineName, value: Partial<IOutlineSchema>) => IOutlineSchema<any, any[]>;
     /**
      * Retrieves an outline schema by its key from the active registry.
      * Logs the operation if `CC_LOGGER_ENABLE_INFO` is enabled.
@@ -9540,7 +9535,7 @@ declare const dumpClientPerformance: {
  *
  * @function
 */
-declare const dumpOutlineResult: (result: IOutlineResult<any, any>, outputDir?: any) => Promise<void>;
+declare const dumpOutlineResult: (result: IOutlineResult<any, any[]>, outputDir?: any) => Promise<void>;
 
 /**
  * Dumps the advisor result into a folder structure with markdown files.
@@ -10417,7 +10412,7 @@ declare function addPipeline<Payload extends object = any>(pipelineSchema: IPipe
  * @param outlineSchema Partial outline schema with updates to be applied to the existing outline configuration.
  * @param Param> The Param> parameter.
 */
-declare function addOutline<Data extends IOutlineData = IOutlineData, Param extends IOutlineParam = IOutlineParam>(outlineSchema: IOutlineSchema<Data, Param>): string;
+declare function addOutline<Data extends IOutlineData = IOutlineData, Params extends IOutlineParam[] = IOutlineParam[]>(outlineSchema: IOutlineSchema<Data, Params>): string;
 
 /**
  * Type representing a partial agent schema with required agentName.
@@ -10742,9 +10737,9 @@ 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<Data extends IOutlineData = IOutlineData, Param extends IOutlineParam = IOutlineParam> = {
-    outlineName: IOutlineSchema<Data, Param>["outlineName"];
-} & Partial<IOutlineSchema<Data, Param>>;
+type TOutlineSchema<Data extends IOutlineData = IOutlineData, Params extends IOutlineParam[] = IOutlineParam[]> = {
+    outlineName: IOutlineSchema<Data, Params>["outlineName"];
+} & Partial<IOutlineSchema<Data, Params>>;
 /**
  * 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.
@@ -10753,7 +10748,7 @@ type TOutlineSchema<Data extends IOutlineData = IOutlineData, Param extends IOut
  * @param outlineSchema Partial outline schema with updates to be applied to the existing outline configuration.
  * @param Param> The Param> parameter.
 */
-declare function overrideOutline<Data extends IOutlineData = IOutlineData, Param extends IOutlineParam = IOutlineParam>(outlineSchema: TOutlineSchema<Data, Param>): Promise<IOutlineSchema<any, any>>;
+declare function overrideOutline<Data extends IOutlineData = IOutlineData, Params extends IOutlineParam[] = IOutlineParam[]>(outlineSchema: TOutlineSchema<Data, Params>): Promise<IOutlineSchema<any, any[]>>;
 
 /**
  * Marks a client as online in the specified swarm.
@@ -11159,7 +11154,7 @@ declare function ask<T = string>(message: T, advisorName: AdvisorName): Promise<
  * @async
  *
  * @param outlineName The outlineName parameter.
- * @param param The param parameter.
+ * @param params The spread params passed to getOutlineHistory.
  * @template Data - The type of the outline data, extending IOutlineData.
  * @template Param - The type of the input param, extending IOutlineParam.
  * @example
@@ -11167,7 +11162,7 @@ declare function ask<T = string>(message: T, advisorName: AdvisorName): Promise<
  * const result = await json<"MyOutline", { query: string }>("MyOutline", { query: "example" });
  * console.log(result.isValid, result.data); // Logs validation status and data
  */
-declare function json<Data extends IOutlineData = IOutlineData, Param extends IOutlineParam = IOutlineParam>(outlineName: OutlineName, param?: Param): Promise<IOutlineResult<Data, Param>>;
+declare function json<Data extends IOutlineData = IOutlineData, Params extends IOutlineParam[] = IOutlineParam[]>(outlineName: OutlineName, ...params: Params): Promise<IOutlineResult<Data, Params>>;
 
 /**
  * Processes a chat completion request by sending messages to a specified completion service.