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

package/lib/cjs/prompt/skills/afs/read.js

@@ -3,26 +3,51 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AFSReadAgent = void 0;
 const zod_1 = require("zod");
 const base_js_1 = require("./base.js");
+const DEFAULT_LINE_LIMIT = 2000;
+const MAX_LINE_LENGTH = 2000;
 class AFSReadAgent extends base_js_1.AFSSkillBase {
     constructor(options) {
         super({
             name: "afs_read",
-            description: "Read complete file contents. Use when you need to review, analyze, or understand file content before making changes.",
+            description: `Read file contents from the Agentic File System (AFS)
+- Returns the content of a file at the specified AFS path
+- By default reads up to ${DEFAULT_LINE_LIMIT} lines, use offset/limit for large files
+- Lines longer than ${MAX_LINE_LENGTH} characters will be truncated
+
+Usage:
+- The path must be an absolute AFS path starting with "/" (e.g., "/docs/readme.md")
+- Use offset to start reading from a specific line (0-based)
+- Use limit to control number of lines returned (default: ${DEFAULT_LINE_LIMIT})
+- Check truncated field to know if file was partially returned`,
             ...options,
             inputSchema: zod_1.z.object({
-                path: zod_1.z.string().describe("Absolute file path to read"),
-                withLineNumbers: zod_1.z
-                    .boolean()
+                path: zod_1.z
+                    .string()
+                    .describe("Absolute AFS path to the file to read (e.g., '/docs/readme.md'). Must start with '/'"),
+                offset: zod_1.z
+                    .number()
+                    .int()
+                    .min(0)
                     .optional()
-                    .describe("Include line numbers in output (required when planning to edit the file)"),
+                    .describe("Line number to start reading from (0-based, default: 0)"),
+                limit: zod_1.z
+                    .number()
+                    .int()
+                    .min(1)
+                    .max(DEFAULT_LINE_LIMIT)
+                    .optional()
+                    .describe(`Maximum number of lines to read (default: ${DEFAULT_LINE_LIMIT})`),
             }),
             outputSchema: zod_1.z.object({
                 status: zod_1.z.string(),
                 tool: zod_1.z.string(),
                 path: zod_1.z.string(),
-                withLineNumbers: zod_1.z.boolean().optional(),
                 data: zod_1.z.custom().optional(),
                 message: zod_1.z.string().optional(),
+                totalLines: zod_1.z.number().optional(),
+                returnedLines: zod_1.z.number().optional(),
+                truncated: zod_1.z.boolean().optional(),
+                offset: zod_1.z.number().optional(),
             }),
         });
     }
@@ -30,22 +55,44 @@ class AFSReadAgent extends base_js_1.AFSSkillBase {
         if (!this.afs)
             throw new Error("AFS is not configured for this agent.");
         const result = await this.afs.read(input.path);
-        let content = result.data?.content;
-        if (input.withLineNumbers && typeof content === "string") {
-            content = content
-                .split("\n")
-                .map((line, idx) => `${idx + 1}| ${line}`)
-                .join("\n");
+        if (!result.data?.content || typeof result.data.content !== "string") {
+            return {
+                status: "success",
+                tool: "afs_read",
+                path: input.path,
+                ...result,
+            };
+        }
+        const offset = input.offset ?? 0;
+        const limit = input.limit ?? DEFAULT_LINE_LIMIT;
+        const allLines = result.data.content.split("\n");
+        const totalLines = allLines.length;
+        // Apply offset and limit
+        const selectedLines = allLines.slice(offset, offset + limit);
+        // Truncate long lines
+        const processedLines = selectedLines.map((line) => line.length > MAX_LINE_LENGTH ? `${line.substring(0, MAX_LINE_LENGTH)}... [truncated]` : line);
+        const returnedLines = processedLines.length;
+        const truncated = offset > 0 || offset + limit < totalLines;
+        const processedContent = processedLines.join("\n");
+        let message;
+        if (truncated) {
+            const startLine = offset + 1;
+            const endLine = offset + returnedLines;
+            message = `Showing lines ${startLine}-${endLine} of ${totalLines}. Use offset/limit to read more.`;
         }
         return {
             status: "success",
             tool: "afs_read",
             path: input.path,
-            withLineNumbers: input.withLineNumbers,
+            totalLines,
+            returnedLines,
+            truncated,
+            offset,
+            message,
             ...result,
-            data: result.data && {
+            data: {
                 ...result.data,
-                content,
+                content: processedContent,
             },
         };
     }

package/lib/cjs/prompt/skills/afs/rename.js

@@ -7,16 +7,30 @@ class AFSRenameAgent extends base_js_1.AFSSkillBase {
     constructor(options) {
         super({
             name: "afs_rename",
-            description: "Rename or move files and directories. Use when reorganizing files, changing names, or moving to different locations.",
+            description: `Rename or move files and directories within the Agentic File System (AFS)
+- Renames a file or directory to a new name
+- Can also move files/directories to a different location
+- Optionally overwrites existing files at the destination
+
+Usage:
+- Both paths must be absolute AFS paths starting with "/" (e.g., "/docs/old-name.md" -> "/docs/new-name.md")
+- This is NOT a local system file path - it operates within the AFS virtual file system
+- To move a file, specify a different directory in newPath (e.g., "/docs/file.md" -> "/archive/file.md")
+- If newPath already exists, the operation will fail unless overwrite=true
+- Moving directories moves all contents recursively`,
             ...options,
             inputSchema: zod_1.z.object({
-                oldPath: zod_1.z.string().describe("Absolute current file or directory path"),
-                newPath: zod_1.z.string().describe("Absolute new file or directory path"),
+                oldPath: zod_1.z
+                    .string()
+                    .describe("Current absolute AFS path (e.g., '/docs/old-name.md'). Must start with '/'"),
+                newPath: zod_1.z
+                    .string()
+                    .describe("New absolute AFS path (e.g., '/docs/new-name.md'). Must start with '/'"),
                 overwrite: zod_1.z
                     .boolean()
                     .optional()
                     .default(false)
-                    .describe("Overwrite if destination exists (default: false)"),
+                    .describe("Set to true to overwrite if destination already exists. Default: false (fails if exists)"),
             }),
             outputSchema: zod_1.z.object({
                 status: zod_1.z.string(),

package/lib/cjs/prompt/skills/afs/search.js

@@ -7,18 +7,34 @@ class AFSSearchAgent extends base_js_1.AFSSkillBase {
     constructor(options) {
         super({
             name: "afs_search",
-            description: "Search file contents by keywords. Use when finding files containing specific text or code patterns.",
+            description: `Search file contents within the Agentic File System (AFS)
+- Searches for files containing specific text, keywords, or patterns
+- Returns matching entries with their content and metadata
+- Supports case-sensitive and case-insensitive search modes
+- Use this tool when you need to find files by their content
+
+Usage:
+- The path must be an absolute AFS path starting with "/" (e.g., "/", "/docs", "/memory")
+- This is NOT a local system file path - it operates within the AFS virtual file system
+- The query can be keywords, phrases, or text patterns to search for
+- Use limit to control the number of results returned
+- Search is case-insensitive by default; set caseSensitive to true for exact case matching`,
             ...options,
             inputSchema: zod_1.z.object({
-                path: zod_1.z.string().describe("Absolute directory path to search in"),
-                query: zod_1.z.string().describe("Search keywords or patterns"),
+                path: zod_1.z
+                    .string()
+                    .describe("Absolute AFS path to search in (e.g., '/', '/docs', '/memory'). Must start with '/'"),
+                query: zod_1.z.string().describe("Text, keywords, or patterns to search for in file contents"),
                 options: zod_1.z
                     .object({
-                    limit: zod_1.z.number().optional().describe("Max results to return"),
+                    limit: zod_1.z
+                        .number()
+                        .optional()
+                        .describe("Maximum number of results to return. Useful for limiting output size"),
                     caseSensitive: zod_1.z
                         .boolean()
                         .optional()
-                        .describe("Case-sensitive search (default: false)"),
+                        .describe("Set to true for case-sensitive matching. Default: false (case-insensitive)"),
                 })
                     .optional(),
             }),

package/lib/cjs/prompt/skills/afs/write.js

@@ -7,16 +7,30 @@ class AFSWriteAgent extends base_js_1.AFSSkillBase {
     constructor(options) {
         super({
             name: "afs_write",
-            description: "Create new file or append content to existing file. Use when creating files, rewriting entire files, or appending to files.",
+            description: `Write or create files in the Agentic File System (AFS)
+- Creates a new file or overwrites an existing file with the provided content
+- Supports append mode to add content to the end of existing files
+- Use this tool when creating new files or completely replacing file contents
+
+Usage:
+- The path must be an absolute AFS path starting with "/" (e.g., "/docs/new-file.md", "/memory/user/notes")
+- This is NOT a local system file path - it operates within the AFS virtual file system
+- By default, this tool overwrites the entire file content
+- Use append mode to add content to the end of an existing file without replacing it
+- For partial edits to existing files, prefer using afs_edit instead`,
             ...options,
             inputSchema: zod_1.z.object({
-                path: zod_1.z.string().describe("Absolute file path to write"),
-                content: zod_1.z.string().describe("Complete file content or content to append"),
+                path: zod_1.z
+                    .string()
+                    .describe("Absolute AFS path for the file to write (e.g., '/docs/new-file.md'). Must start with '/'"),
+                content: zod_1.z
+                    .string()
+                    .describe("The content to write to the file. In overwrite mode, this replaces the entire file"),
                 append: zod_1.z
                     .boolean()
                     .optional()
                     .default(false)
-                    .describe("Append mode: add content to end of file (default: false, overwrites file)"),
+                    .describe("Set to true to append content to the end of an existing file. Default: false (overwrites entire file)"),
             }),
             outputSchema: zod_1.z.object({
                 status: zod_1.z.string(),
@@ -29,7 +43,7 @@ class AFSWriteAgent extends base_js_1.AFSSkillBase {
     async process(input, _options) {
         if (!this.afs)
             throw new Error("AFS is not configured for this agent.");
-        const result = await this.afs.write(input.path, {
+        const _result = await this.afs.write(input.path, {
             content: input.content,
         }, {
             append: input.append ?? false,
@@ -38,7 +52,7 @@ class AFSWriteAgent extends base_js_1.AFSSkillBase {
             status: "success",
             tool: "afs_write",
             path: input.path,
-            ...result,
+            message: "File written successfully",
         };
     }
 }

package/lib/cjs/prompt/template.d.ts

@@ -42,7 +42,7 @@ export declare class AgentMessageTemplate extends ChatMessageTemplate {
     static from(template?: ChatModelInputMessage["content"], toolCalls?: ChatModelOutputToolCall[], name?: string, options?: FormatOptions, cacheControl?: ChatModelInputMessage["cacheControl"]): AgentMessageTemplate;
     constructor(content?: ChatModelInputMessage["content"], toolCalls?: ChatModelOutputToolCall[] | undefined, name?: string, options?: FormatOptions, cacheControl?: ChatModelInputMessage["cacheControl"]);
     format(_variables?: Record<string, unknown>, _options?: FormatOptions): Promise<{
-        role: "agent" | "system" | "user" | "tool";
+        role: "system" | "user" | "agent" | "tool";
         name: string | undefined;
         content: ChatModelInputMessageContent | undefined;
         toolCalls: ChatModelOutputToolCall[] | undefined;
@@ -54,7 +54,7 @@ export declare class ToolMessageTemplate extends ChatMessageTemplate {
     static from(content: object | string, toolCallId: string, name?: string, options?: FormatOptions, cacheControl?: ChatModelInputMessage["cacheControl"]): ToolMessageTemplate;
     constructor(content: object | string, toolCallId: string, name?: string, options?: FormatOptions, cacheControl?: ChatModelInputMessage["cacheControl"]);
     format(_variables?: Record<string, unknown>, _options?: FormatOptions): Promise<{
-        role: "agent" | "system" | "user" | "tool";
+        role: "system" | "user" | "agent" | "tool";
         name: string | undefined;
         content: ChatModelInputMessageContent | undefined;
         toolCallId: string;
@@ -83,21 +83,21 @@ declare const chatMessageSchema: z.ZodUnion<[z.ZodObject<{
         ttl?: "5m" | "1h" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    role: "system";
     content: string;
-    name?: string | undefined;
+    role: "system";
     cacheControl?: {
         type: "ephemeral";
         ttl?: "5m" | "1h" | undefined;
     } | undefined;
+    name?: string | undefined;
 }, {
-    role: "system";
     content: string;
-    name?: string | undefined;
+    role: "system";
     cacheControl?: {
         type: "ephemeral";
         ttl?: "5m" | "1h" | undefined;
     } | undefined;
+    name?: string | undefined;
 }>, z.ZodObject<{
     role: z.ZodLiteral<"user">;
     content: z.ZodString;
@@ -113,21 +113,21 @@ declare const chatMessageSchema: z.ZodUnion<[z.ZodObject<{
         ttl?: "5m" | "1h" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    role: "user";
     content: string;
-    name?: string | undefined;
+    role: "user";
     cacheControl?: {
         type: "ephemeral";
         ttl?: "5m" | "1h" | undefined;
     } | undefined;
+    name?: string | undefined;
 }, {
-    role: "user";
     content: string;
-    name?: string | undefined;
+    role: "user";
     cacheControl?: {
         type: "ephemeral";
         ttl?: "5m" | "1h" | undefined;
     } | undefined;
+    name?: string | undefined;
 }>, z.ZodObject<{
     role: z.ZodLiteral<"agent">;
     content: z.ZodOptional<z.ZodString>;
@@ -172,8 +172,11 @@ declare const chatMessageSchema: z.ZodUnion<[z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     role: "agent";
-    name?: string | undefined;
     content?: string | undefined;
+    cacheControl?: {
+        type: "ephemeral";
+        ttl?: "5m" | "1h" | undefined;
+    } | undefined;
     toolCalls?: {
         function: {
             name: string;
@@ -182,14 +185,14 @@ declare const chatMessageSchema: z.ZodUnion<[z.ZodObject<{
         type: "function";
         id: string;
     }[] | undefined;
+    name?: string | undefined;
+}, {
+    role: "agent";
+    content?: string | undefined;
     cacheControl?: {
         type: "ephemeral";
         ttl?: "5m" | "1h" | undefined;
     } | undefined;
-}, {
-    role: "agent";
-    name?: string | undefined;
-    content?: string | undefined;
     toolCalls?: {
         function: {
             name: string;
@@ -198,10 +201,7 @@ declare const chatMessageSchema: z.ZodUnion<[z.ZodObject<{
         type: "function";
         id: string;
     }[] | undefined;
-    cacheControl?: {
-        type: "ephemeral";
-        ttl?: "5m" | "1h" | undefined;
-    } | undefined;
+    name?: string | undefined;
 }>, z.ZodObject<{
     role: z.ZodLiteral<"tool">;
     content: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>, string, string | Record<string, unknown>>;
@@ -218,23 +218,23 @@ declare const chatMessageSchema: z.ZodUnion<[z.ZodObject<{
         ttl?: "5m" | "1h" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    role: "tool";
     content: string;
+    role: "tool";
     toolCallId: string;
-    name?: string | undefined;
     cacheControl?: {
         type: "ephemeral";
         ttl?: "5m" | "1h" | undefined;
     } | undefined;
+    name?: string | undefined;
 }, {
-    role: "tool";
     content: string | Record<string, unknown>;
+    role: "tool";
     toolCallId: string;
-    name?: string | undefined;
     cacheControl?: {
         type: "ephemeral";
         ttl?: "5m" | "1h" | undefined;
     } | undefined;
+    name?: string | undefined;
 }>]>;
 export declare function safeParseChatMessages(messages: unknown): ChatMessageTemplate[] | undefined;
 export declare function parseChatMessages(messages: (z.infer<typeof chatMessageSchema> & {

package/lib/dts/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/dts/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/dts/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/dts/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/dts/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/dts/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/dts/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
      *