@aigne/core 1.72.0-beta.3 → 1.72.0-beta.4

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [1.72.0-beta.4](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.72.0-beta.3...core-v1.72.0-beta.4) (2025-12-24)
+
+
+### Features
+
+* add Agent Skill support ([#787](https://github.com/AIGNE-io/aigne-framework/issues/787)) ([f04fbe7](https://github.com/AIGNE-io/aigne-framework/commit/f04fbe76ec24cf3c59c74adf92d87b0c3784a8f7))
+
+
+### Bug Fixes
+
+* **cli:** improve terminal outputs ([#847](https://github.com/AIGNE-io/aigne-framework/issues/847)) ([329e91b](https://github.com/AIGNE-io/aigne-framework/commit/329e91bc3323f72fc8a2d278ff5e6bba9adbd6e0))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.3
+    * @aigne/afs-history bumped to 1.2.0-beta.3
+
 ## [1.72.0-beta.3](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.72.0-beta.2...core-v1.72.0-beta.3) (2025-12-19)
 
 

package/lib/cjs/agents/agent.d.ts

@@ -1,7 +1,7 @@
 import { AFS, type AFSExecOptions, type AFSExecResult, type AFSListOptions, type AFSListResult, type AFSModule, type AFSOptions, type AFSReadResult, type AFSSearchOptions } from "@aigne/afs";
 import { nodejs } from "@aigne/platform-helpers/nodejs/index.js";
 import type * as prompts from "@inquirer/prompts";
-import { type ZodObject, type ZodType } from "zod";
+import { type ZodObject, type ZodType, z } from "zod";
 import type { AgentEvent, Context, UserContext } from "../aigne/context.js";
 import type { MessagePayload } from "../aigne/message-queue.js";
 import type { ContextUsage } from "../aigne/usage.js";
@@ -783,6 +783,25 @@ export interface AgentResponseProgress {
     } | {
         event: "agentFailed";
         error: Error;
+    } | {
+        event: "message";
+        role: "user" | "agent";
+        message: ({
+            type: "text";
+            content: string;
+        } | {
+            type: "thinking";
+            thoughts: string;
+        } | {
+            type: "tool_use";
+            toolUseId: string;
+            name: string;
+            input: unknown;
+        } | {
+            type: "tool_result";
+            toolUseId: string;
+            content: unknown;
+        })[];
     }) & Omit<AgentEvent, "agent"> & {
         agent: {
             name: string;
@@ -870,6 +889,17 @@ export interface FunctionAgentOptions<I extends Message = Message, O extends Mes
  */
 export declare class FunctionAgent<I extends Message = Message, O extends Message = Message> extends Agent<I, O> {
     tag: string;
+    static schema(): ZodObject<{
+        process: ZodType<FunctionAgentFn>;
+    }, "strip", z.ZodTypeAny, {
+        process: FunctionAgentFn<any, any, FunctionAgent<any, any>>;
+    }, {
+        process: FunctionAgentFn<any, any, FunctionAgent<any, any>>;
+    }>;
+    static load<I extends Message = any, O extends Message = any>(options: {
+        filepath: string;
+        parsed: object;
+    }): Promise<Agent<I, O>>;
     /**
      * Create a function agent from a function or options
      *

package/lib/cjs/agents/agent.js

@@ -53,6 +53,7 @@ const nunjucks_1 = __importDefault(require("nunjucks"));
 const ufo_1 = require("ufo");
 const zod_1 = require("zod");
 const zod_to_json_schema_1 = require("zod-to-json-schema");
+const function_agent_js_1 = require("../loader/function-agent.js");
 const agent_utils_js_1 = require("../utils/agent-utils.js");
 const json_schema_js_1 = require("../utils/json-schema.js");
 const logger_js_1 = require("../utils/logger.js");
@@ -873,6 +874,18 @@ function checkAgentInputOutputSchema(schema) {
  */
 class FunctionAgent extends Agent {
     tag = "FunctionAgent";
+    static schema() {
+        return zod_1.z.object({
+            process: zod_1.z.preprocess((v) => (typeof v === "string" ? (0, function_agent_js_1.codeToFunctionAgentFn)(v) : v), zod_1.z.custom()),
+        });
+    }
+    static async load(options) {
+        const valid = await FunctionAgent.schema().parseAsync(options.parsed);
+        return new FunctionAgent({
+            ...options.parsed,
+            process: valid.process,
+        });
+    }
     /**
      * Create a function agent from a function or options
      *

package/lib/cjs/agents/ai-agent.d.ts

@@ -188,6 +188,13 @@ export declare const aiAgentOptionsSchema: ZodObject<{
  */
 export declare class AIAgent<I extends Message = any, O extends Message = any> extends Agent<I, O> {
     tag: string;
+    static schema<T>({ filepath }: {
+        filepath: string;
+    }): ZodType<T>;
+    static load<I extends Message = any, O extends Message = any>(options: {
+        filepath: string;
+        parsed: object;
+    }): Promise<Agent<I, O>>;
     /**
      * Create an AIAgent with the specified options
      *

package/lib/cjs/agents/ai-agent.js

@@ -35,10 +35,12 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AIAgent = exports.aiAgentOptionsSchema = exports.aiAgentToolChoiceSchema = exports.AIAgentToolChoice = exports.DEFAULT_OUTPUT_FILE_KEY = exports.DEFAULT_OUTPUT_KEY = void 0;
 const zod_1 = require("zod");
+const schema_js_1 = require("../loader/schema.js");
 const prompt_builder_js_1 = require("../prompt/prompt-builder.js");
 const structured_stream_instructions_js_1 = require("../prompt/prompts/structured-stream-instructions.js");
 const template_js_1 = require("../prompt/template.js");
 const fastq = __importStar(require("../utils/queue.js"));
+const stream_utils_js_1 = require("../utils/stream-utils.js");
 const structured_stream_extractor_js_1 = require("../utils/structured-stream-extractor.js");
 const type_utils_js_1 = require("../utils/type-utils.js");
 const agent_js_1 = require("./agent.js");
@@ -120,6 +122,32 @@ exports.aiAgentOptionsSchema = agent_js_1.agentOptionsSchema.extend({
  */
 class AIAgent extends agent_js_1.Agent {
     tag = "AIAgent";
+    static schema({ filepath }) {
+        const instructionsSchema = (0, schema_js_1.getInstructionsSchema)({ filepath });
+        return (0, schema_js_1.camelizeSchema)(zod_1.z.object({
+            instructions: (0, schema_js_1.optionalize)(instructionsSchema),
+            autoReorderSystemMessages: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
+            autoMergeSystemMessages: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
+            inputKey: (0, schema_js_1.optionalize)(zod_1.z.string()),
+            outputKey: (0, schema_js_1.optionalize)(zod_1.z.string()),
+            inputFileKey: (0, schema_js_1.optionalize)(zod_1.z.string()),
+            outputFileKey: (0, schema_js_1.optionalize)(zod_1.z.string()),
+            toolChoice: (0, schema_js_1.optionalize)(zod_1.z.nativeEnum(AIAgentToolChoice)),
+            toolCallsConcurrency: (0, schema_js_1.optionalize)(zod_1.z.number().int().min(0)),
+            keepTextInToolUses: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
+            catchToolsError: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
+            structuredStreamMode: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
+        }));
+    }
+    static async load(options) {
+        const schema = AIAgent.schema(options);
+        const valid = await schema.parseAsync(options.parsed);
+        return new AIAgent({
+            ...options.parsed,
+            ...valid,
+            instructions: valid.instructions && (0, schema_js_1.instructionsToPromptBuilder)(valid.instructions),
+        });
+    }
     /**
      * Create an AIAgent with the specified options
      *
@@ -316,6 +344,16 @@ class AIAgent extends agent_js_1.Agent {
         }
         const toolCallMessages = [];
         const outputKey = this.outputKey;
+        const inputMessage = this.inputKey ? input[this.inputKey] : undefined;
+        if (inputMessage) {
+            yield {
+                progress: {
+                    event: "message",
+                    role: "user",
+                    message: [{ type: "text", content: inputMessage }],
+                },
+            };
+        }
         for (;;) {
             const modelOutput = {};
             let stream = await this.invokeChildAgent(model, { ...modelInput, messages: modelInput.messages.concat(toolCallMessages) }, { ...options, streaming: true });
@@ -325,12 +363,12 @@ class AIAgent extends agent_js_1.Agent {
             }
             let isTextIgnored = false;
             for await (const value of stream) {
+                (0, stream_utils_js_1.mergeAgentResponseChunk)(modelOutput, value);
                 if ((0, agent_js_1.isAgentResponseDelta)(value)) {
                     if (!isTextIgnored && value.delta.text?.text) {
                         yield { delta: { text: { [outputKey]: value.delta.text.text } } };
                     }
                     if (value.delta.json) {
-                        Object.assign(modelOutput, value.delta.json);
                         if (this.structuredStreamMode) {
                             yield { delta: { json: value.delta.json.json } };
                             if (!isTextIgnored && modelOutput.json && this.ignoreTextOfStructuredStreamMode) {
@@ -340,13 +378,23 @@ class AIAgent extends agent_js_1.Agent {
                     }
                 }
             }
-            const { toolCalls, json, text, files } = modelOutput;
+            const { toolCalls, json, text, thoughts, files } = modelOutput;
+            if (text) {
+                yield {
+                    progress: { event: "message", role: "agent", message: [{ type: "text", content: text }] },
+                };
+            }
+            if (thoughts) {
+                yield {
+                    progress: { event: "message", role: "agent", message: [{ type: "thinking", thoughts }] },
+                };
+            }
             if (toolCalls?.length) {
                 if (this.keepTextInToolUses !== true) {
                     yield { delta: { json: { [outputKey]: "" } } };
                 }
                 else {
-                    yield { delta: { text: { [outputKey]: "\n" } } };
+                    yield { delta: { text: { [outputKey]: "\n\n" } } };
                 }
                 const executedToolCalls = [];
                 let error;
@@ -376,6 +424,20 @@ class AIAgent extends agent_js_1.Agent {
                     const tool = toolsMap.get(call.function.name);
                     if (!tool)
                         throw new Error(`Tool not found: ${call.function.name}`);
+                    yield {
+                        progress: {
+                            event: "message",
+                            role: "agent",
+                            message: [
+                                {
+                                    type: "tool_use",
+                                    name: call.function.name,
+                                    input: call.function.arguments,
+                                    toolUseId: call.id,
+                                },
+                            ],
+                        },
+                    };
                     queue.push({ tool, call });
                 }
                 await queue.drained();
@@ -383,6 +445,21 @@ class AIAgent extends agent_js_1.Agent {
                     throw error;
                 // Continue LLM function calling loop if any tools were executed
                 if (executedToolCalls.length) {
+                    for (const { call, output } of executedToolCalls) {
+                        yield {
+                            progress: {
+                                event: "message",
+                                role: "agent",
+                                message: [
+                                    {
+                                        type: "tool_result",
+                                        toolUseId: call.id,
+                                        content: output,
+                                    },
+                                ],
+                            },
+                        };
+                    }
                     const transferOutput = executedToolCalls.find((i) => (0, types_js_1.isTransferAgentOutput)(i.output))?.output;
                     if (transferOutput)
                         return transferOutput;
@@ -403,6 +480,11 @@ class AIAgent extends agent_js_1.Agent {
             if (!(0, type_utils_js_1.isEmpty)(result)) {
                 yield { delta: { json: result } };
             }
+            if (text) {
+                yield {
+                    progress: { event: "message", role: "agent", message: [{ type: "text", content: text }] },
+                };
+            }
             return;
         }
     }

package/lib/cjs/agents/image-agent.d.ts

@@ -1,4 +1,4 @@
-import { type ZodObject, type ZodType } from "zod";
+import z, { type ZodObject, type ZodType } from "zod";
 import { PromptBuilder } from "../prompt/prompt-builder.js";
 import { Agent, type AgentInvokeOptions, type AgentOptions, type Message } from "./agent.js";
 import { type ImageModelOutput } from "./image-model.js";
@@ -13,6 +13,22 @@ export declare const imageAgentOptionsSchema: ZodObject<{
 }>;
 export declare class ImageAgent<I extends Message = any, O extends ImageModelOutput = any> extends Agent<I, O> {
     tag: string;
+    static schema({ filepath }: {
+        filepath: string;
+    }): z.ZodObject<{
+        instructions: z.ZodType<import("../loader/schema.js").Instructions, z.ZodTypeDef, import("../loader/schema.js").Instructions>;
+        inputFileKey: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
+    }, "strip", z.ZodTypeAny, {
+        instructions: import("../loader/schema.js").Instructions;
+        inputFileKey?: string | undefined;
+    }, {
+        instructions: import("../loader/schema.js").Instructions;
+        inputFileKey?: string | undefined;
+    }>;
+    static load<I extends Message = any, O extends Message = any>(options: {
+        filepath: string;
+        parsed: object;
+    }): Promise<Agent<I, O>>;
     static from<I extends Message = any, O extends ImageModelOutput = any>(options: ImageAgentOptions<I, O>): ImageAgent<I, O>;
     constructor(options: ImageAgentOptions<I, O>);
     instructions: PromptBuilder;

package/lib/cjs/agents/image-agent.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ImageAgent = exports.imageAgentOptionsSchema = void 0;
 const zod_1 = __importDefault(require("zod"));
+const schema_js_1 = require("../loader/schema.js");
 const prompt_builder_js_1 = require("../prompt/prompt-builder.js");
 const type_utils_js_1 = require("../utils/type-utils.js");
 const agent_js_1 = require("./agent.js");
@@ -16,6 +17,21 @@ exports.imageAgentOptionsSchema = agent_js_1.agentOptionsSchema.extend({
 });
 class ImageAgent extends agent_js_1.Agent {
     tag = "ImageAgent";
+    static schema({ filepath }) {
+        const instructionsSchema = (0, schema_js_1.getInstructionsSchema)({ filepath });
+        return (0, schema_js_1.camelizeSchema)(zod_1.default.object({
+            instructions: instructionsSchema,
+            inputFileKey: (0, schema_js_1.optionalize)(zod_1.default.string()),
+        }));
+    }
+    static async load(options) {
+        const valid = await ImageAgent.schema({ filepath: options.filepath }).parseAsync(options.parsed);
+        return new ImageAgent({
+            ...options.parsed,
+            ...valid,
+            instructions: (0, schema_js_1.instructionsToPromptBuilder)(valid.instructions),
+        });
+    }
     static from(options) {
         return new ImageAgent(options);
     }

package/lib/cjs/agents/image-model.d.ts

@@ -91,6 +91,7 @@ export declare const imageModelInputSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     prompt: string;
     modelOptions?: Record<string, unknown> | undefined;
+    outputFileType?: "local" | "url" | "file" | undefined;
     image?: ({
         type: "url";
         url: string;
@@ -107,11 +108,11 @@ export declare const imageModelInputSchema: z.ZodObject<{
         filename?: string | undefined;
         mimeType?: string | undefined;
     })[] | undefined;
-    outputFileType?: "local" | "file" | "url" | undefined;
     n?: number | undefined;
 }, {
     prompt: string;
     modelOptions?: Record<string, unknown> | undefined;
+    outputFileType?: "local" | "url" | "file" | undefined;
     image?: ({
         type: "url";
         url: string;
@@ -128,7 +129,6 @@ export declare const imageModelInputSchema: z.ZodObject<{
         filename?: string | undefined;
         mimeType?: string | undefined;
     })[] | undefined;
-    outputFileType?: "local" | "file" | "url" | undefined;
     n?: number | undefined;
 }>;
 export interface ImageModelOutput extends Message {
@@ -232,7 +232,6 @@ export declare const imageModelOutputSchema: z.ZodObject<{
         filename?: string | undefined;
         mimeType?: string | undefined;
     })[];
-    model?: string | undefined;
     usage?: {
         inputTokens: number;
         outputTokens: number;
@@ -241,6 +240,7 @@ export declare const imageModelOutputSchema: z.ZodObject<{
         cacheReadInputTokens?: number | undefined;
         creditPrefix?: "$" | "€" | "¥" | undefined;
     } | undefined;
+    model?: string | undefined;
 }, {
     images: ({
         type: "url";
@@ -258,7 +258,6 @@ export declare const imageModelOutputSchema: z.ZodObject<{
         filename?: string | undefined;
         mimeType?: string | undefined;
     })[];
-    model?: string | undefined;
     usage?: {
         inputTokens: number;
         outputTokens: number;
@@ -267,4 +266,5 @@ export declare const imageModelOutputSchema: z.ZodObject<{
         cacheReadInputTokens?: number | undefined;
         creditPrefix?: "$" | "€" | "¥" | undefined;
     } | undefined;
+    model?: string | undefined;
 }>;

package/lib/cjs/agents/mcp-agent.d.ts

@@ -58,6 +58,23 @@ export type SSEServerParameters = {
  */
 export declare class MCPAgent extends Agent {
     tag: string;
+    static schema(): z.ZodObject<{
+        url: ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
+        command: ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
+        args: ZodType<string[] | undefined, z.ZodTypeDef, string[] | undefined>;
+    }, "strip", z.ZodTypeAny, {
+        url?: string | undefined;
+        args?: string[] | undefined;
+        command?: string | undefined;
+    }, {
+        url?: string | undefined;
+        args?: string[] | undefined;
+        command?: string | undefined;
+    }>;
+    static load<I extends Message = any, O extends Message = any>(options: {
+        filepath: string;
+        parsed: object;
+    }): Promise<Agent<I, O>>;
     /**
      * Create an MCPAgent from a connection to an SSE server.
      *

package/lib/cjs/agents/mcp-agent.js

@@ -41,6 +41,7 @@ const sse_js_1 = require("@modelcontextprotocol/sdk/client/sse.js");
 const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
 const uriTemplate_js_1 = require("@modelcontextprotocol/sdk/shared/uriTemplate.js");
 const zod_1 = require("zod");
+const schema_js_1 = require("../loader/schema.js");
 const logger_js_1 = require("../utils/logger.js");
 const mcp_utils_js_1 = require("../utils/mcp-utils.js");
 const type_utils_js_1 = require("../utils/type-utils.js");
@@ -85,6 +86,23 @@ function getMCPServerString(options) {
  */
 class MCPAgent extends agent_js_1.Agent {
     tag = "MCPAgent";
+    static schema() {
+        return zod_1.z.object({
+            url: (0, schema_js_1.optionalize)(zod_1.z.string()),
+            command: (0, schema_js_1.optionalize)(zod_1.z.string()),
+            args: (0, schema_js_1.optionalize)(zod_1.z.array(zod_1.z.string())),
+        });
+    }
+    static async load(options) {
+        const valid = await MCPAgent.schema().parseAsync(options.parsed);
+        if (!valid.url && !valid.command) {
+            throw new Error(`Missing url or command in mcp agent: ${options.filepath}`);
+        }
+        return MCPAgent.from({
+            ...options.parsed,
+            ...valid,
+        });
+    }
     static from(options) {
         (0, type_utils_js_1.checkArguments)("MCPAgent.from", mcpAgentOptionsSchema, options);
         if (isSSEServerParameters(options)) {

package/lib/cjs/agents/team-agent.d.ts

@@ -1,3 +1,5 @@
+import { z } from "zod";
+import type { AgentLoadOptions } from "../loader/index.js";
 import { type PromiseOrValue } from "../utils/type-utils.js";
 import { Agent, type AgentInvokeOptions, type AgentOptions, type AgentProcessResult, type Message } from "./agent.js";
 /**
@@ -200,6 +202,59 @@ export interface TeamAgentOptions<I extends Message, O extends Message> extends
  */
 export declare class TeamAgent<I extends Message, O extends Message> extends Agent<I, O> {
     tag: string;
+    static schema({ filepath }: {
+        filepath: string;
+    }): z.ZodObject<{
+        mode: z.ZodType<ProcessMode | undefined, z.ZodTypeDef, ProcessMode | undefined>;
+        iterateOn: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
+        concurrency: z.ZodType<number | undefined, z.ZodTypeDef, number | undefined>;
+        iterateWithPreviousOutput: z.ZodType<boolean | undefined, z.ZodTypeDef, boolean | undefined>;
+        includeAllStepsOutput: z.ZodType<boolean | undefined, z.ZodTypeDef, boolean | undefined>;
+        reflection: z.ZodType<{
+            reviewer: import("../loader/agent-yaml.js").NestAgentSchema;
+            isApproved: string;
+            maxIterations?: number | undefined;
+            returnLastOnMaxIterations?: boolean | undefined;
+            customErrorMessage?: string | undefined;
+        } | undefined, z.ZodTypeDef, {
+            reviewer: import("../loader/agent-yaml.js").NestAgentSchema;
+            isApproved: string;
+            maxIterations?: number | undefined;
+            returnLastOnMaxIterations?: boolean | undefined;
+            customErrorMessage?: string | undefined;
+        } | undefined>;
+    }, "strip", z.ZodTypeAny, {
+        mode?: ProcessMode | undefined;
+        reflection?: {
+            reviewer: import("../loader/agent-yaml.js").NestAgentSchema;
+            isApproved: string;
+            maxIterations?: number | undefined;
+            returnLastOnMaxIterations?: boolean | undefined;
+            customErrorMessage?: string | undefined;
+        } | undefined;
+        iterateOn?: string | undefined;
+        concurrency?: number | undefined;
+        iterateWithPreviousOutput?: boolean | undefined;
+        includeAllStepsOutput?: boolean | undefined;
+    }, {
+        mode?: ProcessMode | undefined;
+        reflection?: {
+            reviewer: import("../loader/agent-yaml.js").NestAgentSchema;
+            isApproved: string;
+            maxIterations?: number | undefined;
+            returnLastOnMaxIterations?: boolean | undefined;
+            customErrorMessage?: string | undefined;
+        } | undefined;
+        iterateOn?: string | undefined;
+        concurrency?: number | undefined;
+        iterateWithPreviousOutput?: boolean | undefined;
+        includeAllStepsOutput?: boolean | undefined;
+    }>;
+    static load<I extends Message = any, O extends Message = any>(options: {
+        filepath: string;
+        parsed: object;
+        options: AgentLoadOptions;
+    }): Promise<Agent<I, O>>;
     /**
      * Create a TeamAgent from the provided options.
      *

package/lib/cjs/agents/team-agent.js

@@ -39,6 +39,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TeamAgent = exports.DEFAULT_REFLECTION_MAX_ITERATIONS = exports.ProcessMode = void 0;
 const node_assert_1 = __importDefault(require("node:assert"));
 const immer_1 = require("immer");
+const zod_1 = require("zod");
+const agent_yaml_js_1 = require("../loader/agent-yaml.js");
+const schema_js_1 = require("../loader/schema.js");
 const fastq = __importStar(require("../utils/queue.js"));
 const stream_utils_js_1 = require("../utils/stream-utils.js");
 const type_utils_js_1 = require("../utils/type-utils.js");
@@ -86,6 +89,34 @@ exports.DEFAULT_REFLECTION_MAX_ITERATIONS = 3;
  */
 class TeamAgent extends agent_js_1.Agent {
     tag = "TeamAgent";
+    static schema({ filepath }) {
+        const nestAgentSchema = (0, agent_yaml_js_1.getNestAgentSchema)({ filepath });
+        return zod_1.z.object({
+            mode: (0, schema_js_1.optionalize)(zod_1.z.nativeEnum(ProcessMode)),
+            iterateOn: (0, schema_js_1.optionalize)(zod_1.z.string()),
+            concurrency: (0, schema_js_1.optionalize)(zod_1.z.number().int().min(1)),
+            iterateWithPreviousOutput: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
+            includeAllStepsOutput: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
+            reflection: (0, schema_js_1.camelizeSchema)((0, schema_js_1.optionalize)(zod_1.z.object({
+                reviewer: nestAgentSchema,
+                isApproved: zod_1.z.string(),
+                maxIterations: (0, schema_js_1.optionalize)(zod_1.z.number().int().min(1)),
+                returnLastOnMaxIterations: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
+                customErrorMessage: (0, schema_js_1.optionalize)(zod_1.z.string()),
+            }))),
+        });
+    }
+    static async load(options) {
+        const valid = await TeamAgent.schema({ filepath: options.filepath }).parseAsync(options.parsed);
+        return TeamAgent.from({
+            ...options.parsed,
+            ...valid,
+            reflection: valid.reflection && {
+                ...valid.reflection,
+                reviewer: await options.options.loadNestAgent(options.filepath, valid.reflection.reviewer, options.options),
+            },
+        });
+    }
     /**
      * Create a TeamAgent from the provided options.
      *

package/lib/cjs/agents/transform-agent.d.ts

@@ -1,3 +1,4 @@
+import { z } from "zod";
 import { Agent, type AgentOptions, type Message } from "./agent.js";
 /**
  * Configuration options for TransformAgent
@@ -47,6 +48,17 @@ export interface TransformAgentOptions<I extends Message, O extends Message> ext
  */
 export declare class TransformAgent<I extends Message = Message, O extends Message = Message> extends Agent<I, O> {
     static type: string;
+    static schema(): z.ZodObject<{
+        jsonata: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        jsonata: string;
+    }, {
+        jsonata: string;
+    }>;
+    static load<I extends Message = any, O extends Message = any>(options: {
+        filepath: string;
+        parsed: object;
+    }): Promise<Agent<I, O>>;
     /**
      * Factory method to create a new TransformAgent instance
      *

package/lib/cjs/agents/transform-agent.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TransformAgent = void 0;
 const jsonata_1 = __importDefault(require("jsonata"));
+const zod_1 = require("zod");
 const agent_js_1 = require("./agent.js");
 /**
  * TransformAgent - A specialized agent for data transformation using JSONata expressions
@@ -23,6 +24,18 @@ const agent_js_1 = require("./agent.js");
  */
 class TransformAgent extends agent_js_1.Agent {
     static type = "TransformAgent";
+    static schema() {
+        return zod_1.z.object({
+            jsonata: zod_1.z.string(),
+        });
+    }
+    static async load(options) {
+        const parsed = await TransformAgent.schema().parseAsync(options.parsed);
+        return TransformAgent.from({
+            ...options.parsed,
+            ...parsed,
+        });
+    }
     /**
      * Factory method to create a new TransformAgent instance
      *

package/lib/cjs/agents/video-model.d.ts

@@ -94,6 +94,7 @@ export declare const videoModelInputSchema: z.ZodObject<{
     prompt: string;
     model?: string | undefined;
     modelOptions?: Record<string, unknown> | undefined;
+    outputFileType?: "local" | "url" | "file" | undefined;
     image?: {
         type: "url";
         url: string;
@@ -110,13 +111,13 @@ export declare const videoModelInputSchema: z.ZodObject<{
         filename?: string | undefined;
         mimeType?: string | undefined;
     } | undefined;
-    outputFileType?: "local" | "file" | "url" | undefined;
     size?: string | undefined;
     seconds?: string | undefined;
 }, {
     prompt: string;
     model?: string | undefined;
     modelOptions?: Record<string, unknown> | undefined;
+    outputFileType?: "local" | "url" | "file" | undefined;
     image?: {
         type: "url";
         url: string;
@@ -133,7 +134,6 @@ export declare const videoModelInputSchema: z.ZodObject<{
         filename?: string | undefined;
         mimeType?: string | undefined;
     } | undefined;
-    outputFileType?: "local" | "file" | "url" | undefined;
     size?: string | undefined;
     seconds?: string | undefined;
 }>;
@@ -240,7 +240,6 @@ export declare const videoModelOutputSchema: z.ZodObject<{
         filename?: string | undefined;
         mimeType?: string | undefined;
     })[];
-    model?: string | undefined;
     usage?: {
         inputTokens: number;
         outputTokens: number;
@@ -249,6 +248,7 @@ export declare const videoModelOutputSchema: z.ZodObject<{
         cacheReadInputTokens?: number | undefined;
         creditPrefix?: "$" | "€" | "¥" | undefined;
     } | undefined;
+    model?: string | undefined;
     seconds?: number | undefined;
 }, {
     videos: ({
@@ -267,7 +267,6 @@ export declare const videoModelOutputSchema: z.ZodObject<{
         filename?: string | undefined;
         mimeType?: string | undefined;
     })[];
-    model?: string | undefined;
     usage?: {
         inputTokens: number;
         outputTokens: number;
@@ -276,5 +275,6 @@ export declare const videoModelOutputSchema: z.ZodObject<{
         cacheReadInputTokens?: number | undefined;
         creditPrefix?: "$" | "€" | "¥" | undefined;
     } | undefined;
+    model?: string | undefined;
     seconds?: number | undefined;
 }>;