@aigne/core 1.28.2 → 1.29.0

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

@@ -33,6 +33,42 @@ export interface TeamAgentOptions<I extends Message, O extends Message> extends
      * @default {ProcessMode.sequential}
      */
     mode?: ProcessMode;
+    /**
+     * Specifies which input field should be treated as an array for iterative processing.
+     *
+     * When this property is set, the TeamAgent will iterate over the array values in the
+     * specified input field, processing each element individually through the team's agents.
+     * The results from each iteration are accumulated and returned as a streaming response.
+     *
+     * This is particularly useful for batch processing scenarios where you need to apply
+     * the same agent workflow to multiple similar data items.
+     *
+     * @remarks
+     * - The specified field must contain an array or array-like value
+     * - Each array element should be an object that can be merged with the base input
+     * - Non-array values will be treated as single-element arrays
+     * - The processing results are streamed incrementally as each iteration completes
+     */
+    iterateOn?: keyof I;
+    /**
+     * Controls whether to merge the output from each iteration back into the array items
+     * for subsequent iterations when using `iterateOn`.
+     *
+     * When set to `true`, the output from processing each array element is merged back
+     * into that element, making it available for the next iteration. This creates a
+     * cumulative effect where each iteration builds upon the results of previous ones.
+     *
+     * When set to `false` or undefined, each array element is processed independently
+     * without any cross-iteration data sharing.
+     *
+     * This is particularly useful for scenarios where:
+     * - You need to progressively enrich data across iterations
+     * - Later iterations depend on the results of earlier ones
+     * - You want to build a chain of transformations on array data
+     *
+     * @default false
+     */
+    iterateWithPreviousOutput?: boolean;
 }
 /**
  * TeamAgent coordinates a group of agents working together to accomplish tasks.
@@ -80,6 +116,25 @@ export declare class TeamAgent<I extends Message, O extends Message> extends Age
      * This can be either sequential (one after another) or parallel (all at once).
      */
     mode: ProcessMode;
+    /**
+     * The input field key to iterate over when processing array inputs.
+     *
+     * When set, this property enables the TeamAgent to process array values iteratively,
+     * where each array element is processed individually through the team's agent workflow.
+     * The accumulated results are returned via streaming response chunks.
+     *
+     * @see TeamAgentOptions.iterateOn for detailed documentation
+     */
+    iterateOn?: keyof I;
+    /**
+     * Controls whether to merge the output from each iteration back into the array items
+     * for subsequent iterations when using `iterateOn`.
+     *
+     * @see TeamAgentOptions.iterateWithPreviousOutput for detailed documentation
+     *
+     * @default false
+     */
+    iterateWithPreviousOutput?: boolean;
     /**
      * Process an input message by routing it through the team's agents.
      *
@@ -93,6 +148,8 @@ export declare class TeamAgent<I extends Message, O extends Message> extends Age
      * @returns A stream of message chunks that collectively form the response
      */
     process(input: I, options: AgentInvokeOptions): PromiseOrValue<AgentProcessResult<O>>;
+    private _processIterator;
+    private _process;
     /**
      * Process input sequentially through each agent in the team.
      *
@@ -108,7 +165,7 @@ export declare class TeamAgent<I extends Message, O extends Message> extends Age
      *
      * @private
      */
-    _processSequential(input: I, options: AgentInvokeOptions): PromiseOrValue<AgentProcessResult<O>>;
+    _processSequential(input: Message, options: AgentInvokeOptions): PromiseOrValue<AgentProcessResult<O>>;
     /**
      * Process input in parallel through all agents in the team.
      *
@@ -123,5 +180,5 @@ export declare class TeamAgent<I extends Message, O extends Message> extends Age
      *
      * @private
      */
-    _processParallel(input: I, options: AgentInvokeOptions): PromiseOrValue<AgentProcessResult<O>>;
+    _processParallel(input: Message, options: AgentInvokeOptions): PromiseOrValue<AgentProcessResult<O>>;
 }

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

@@ -1,6 +1,8 @@
+import assert from "node:assert";
+import { produce } from "immer";
 import { mergeAgentResponseChunk } from "../utils/stream-utils.js";
-import { isEmpty } from "../utils/type-utils.js";
-import { Agent, isAgentResponseDelta, } from "./agent.js";
+import { isEmpty, isNil, isRecord, omit } from "../utils/type-utils.js";
+import { Agent, agentProcessResultToObject, isAgentResponseDelta, } from "./agent.js";
 /**
  * Defines the processing modes available for a TeamAgent.
  *
@@ -68,6 +70,8 @@ export class TeamAgent extends Agent {
     constructor(options) {
         super(options);
         this.mode = options.mode ?? ProcessMode.sequential;
+        this.iterateOn = options.iterateOn;
+        this.iterateWithPreviousOutput = options.iterateWithPreviousOutput;
     }
     /**
      * The processing mode that determines how agents in the team are executed.
@@ -75,6 +79,25 @@ export class TeamAgent extends Agent {
      * This can be either sequential (one after another) or parallel (all at once).
      */
     mode;
+    /**
+     * The input field key to iterate over when processing array inputs.
+     *
+     * When set, this property enables the TeamAgent to process array values iteratively,
+     * where each array element is processed individually through the team's agent workflow.
+     * The accumulated results are returned via streaming response chunks.
+     *
+     * @see TeamAgentOptions.iterateOn for detailed documentation
+     */
+    iterateOn;
+    /**
+     * Controls whether to merge the output from each iteration back into the array items
+     * for subsequent iterations when using `iterateOn`.
+     *
+     * @see TeamAgentOptions.iterateWithPreviousOutput for detailed documentation
+     *
+     * @default false
+     */
+    iterateWithPreviousOutput;
     /**
      * Process an input message by routing it through the team's agents.
      *
@@ -88,6 +111,34 @@ export class TeamAgent extends Agent {
      * @returns A stream of message chunks that collectively form the response
      */
     process(input, options) {
+        if (this.iterateOn) {
+            return this._processIterator(this.iterateOn, input, options);
+        }
+        return this._process(input, options);
+    }
+    async *_processIterator(key, input, options) {
+        assert(this.iterateOn, "iterateInputKey must be defined for iterator processing");
+        let arr = input[this.iterateOn];
+        arr = Array.isArray(arr) ? [...arr] : isNil(arr) ? [arr] : [];
+        const result = [];
+        for (let i = 0; i < arr.length; i++) {
+            const item = arr[i];
+            if (!isRecord(item))
+                throw new TypeError(`Expected ${String(key)} to be an object, got ${typeof item}`);
+            const res = await agentProcessResultToObject(await this._process({ ...input, [key]: arr, ...item }, { ...options, streaming: false }));
+            // Merge the item result with the original item used for next iteration
+            if (this.iterateWithPreviousOutput) {
+                arr = produce(arr, (draft) => {
+                    const item = draft[i];
+                    assert(item);
+                    Object.assign(item, res);
+                });
+            }
+            result.push(omit(res, key));
+            yield { delta: { json: { [key]: result } } };
+        }
+    }
+    _process(input, options) {
         switch (this.mode) {
             case ProcessMode.sequential:
                 return this._processSequential(input, options);

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

@@ -0,0 +1,82 @@
+import { Agent, type AgentOptions, type Message } from "./agent.js";
+/**
+ * Configuration options for TransformAgent
+ *
+ * TransformAgent is a specialized agent that transforms input data to output data
+ * using [JSONata](https://jsonata.org/) expressions. It's particularly useful for:
+ * - Data format conversion (e.g., snake_case to camelCase)
+ * - Field mapping and renaming
+ * - Data structure transformation
+ * - Simple data processing without complex logic
+ * - API response normalization
+ * - Configuration data transformation
+ */
+export interface TransformAgentOptions<I extends Message, O extends Message> extends AgentOptions<I, O> {
+    /**
+     * JSONata expression string for data transformation
+     *
+     * JSONata is a lightweight query and transformation language for JSON data.
+     * The expression defines how input data should be transformed into output data.
+     *
+     * Common JSONata patterns:
+     * - Field mapping: `{ "newField": oldField }`
+     * - Array transformation: `items.{ "name": product_name, "price": price }`
+     * - Calculations: `$sum(items.price)`, `$count(items)`
+     * - Conditional logic: `condition ? value1 : value2`
+     * - String operations: `$uppercase(name)`, `$substring(text, 0, 10)`
+     *
+     * @see https://jsonata.org/ for complete JSONata syntax documentation
+     * @see https://try.jsonata.org/ for interactive JSONata playground
+     */
+    jsonata: string;
+}
+/**
+ * TransformAgent - A specialized agent for data transformation using JSONata expressions
+ *
+ * This agent provides a declarative way to transform structured data without writing
+ * custom processing logic. It leverages the power of JSONata, a lightweight query and
+ * transformation language, to handle complex data manipulations through simple expressions.
+ *
+ * Common Use Cases:
+ * - API response normalization and field mapping
+ * - Database query result transformation
+ * - Configuration data restructuring
+ * - Data format conversion (snake_case ↔ camelCase)
+ * - Aggregation and calculation operations
+ * - Filtering and conditional data processing
+ */
+export declare class TransformAgent<I extends Message = Message, O extends Message = Message> extends Agent<I, O> {
+    static type: string;
+    /**
+     * Factory method to create a new TransformAgent instance
+     *
+     * Provides a convenient way to create TransformAgent instances with proper typing
+     *
+     * @param options Configuration options for the TransformAgent
+     * @returns A new TransformAgent instance
+     */
+    static from<I extends Message, O extends Message>(options: TransformAgentOptions<I, O>): TransformAgent<I, O>;
+    /**
+     * Create a new TransformAgent instance
+     *
+     * @param options Configuration options including the JSONata expression
+     */
+    constructor(options: TransformAgentOptions<I, O>);
+    /**
+     * The JSONata expression string used for data transformation
+     *
+     * This expression is compiled and executed against input data to produce
+     * the transformed output. The expression is stored as a string and compiled
+     * on each invocation for maximum flexibility.
+     */
+    private jsonata;
+    /**
+     * Process input data using the configured JSONata expression
+     *
+     * This method compiles the JSONata expression and evaluates it against the input data.
+     *
+     * @param input The input message to transform
+     * @returns Promise resolving to the transformed output message
+     */
+    process(input: I): Promise<O>;
+}

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

@@ -0,0 +1,60 @@
+import jsonata from "jsonata";
+import { Agent } from "./agent.js";
+/**
+ * TransformAgent - A specialized agent for data transformation using JSONata expressions
+ *
+ * This agent provides a declarative way to transform structured data without writing
+ * custom processing logic. It leverages the power of JSONata, a lightweight query and
+ * transformation language, to handle complex data manipulations through simple expressions.
+ *
+ * Common Use Cases:
+ * - API response normalization and field mapping
+ * - Database query result transformation
+ * - Configuration data restructuring
+ * - Data format conversion (snake_case ↔ camelCase)
+ * - Aggregation and calculation operations
+ * - Filtering and conditional data processing
+ */
+export class TransformAgent extends Agent {
+    static type = "TransformAgent";
+    /**
+     * Factory method to create a new TransformAgent instance
+     *
+     * Provides a convenient way to create TransformAgent instances with proper typing
+     *
+     * @param options Configuration options for the TransformAgent
+     * @returns A new TransformAgent instance
+     */
+    static from(options) {
+        return new TransformAgent(options);
+    }
+    /**
+     * Create a new TransformAgent instance
+     *
+     * @param options Configuration options including the JSONata expression
+     */
+    constructor(options) {
+        super(options);
+        this.jsonata = options.jsonata;
+    }
+    /**
+     * The JSONata expression string used for data transformation
+     *
+     * This expression is compiled and executed against input data to produce
+     * the transformed output. The expression is stored as a string and compiled
+     * on each invocation for maximum flexibility.
+     */
+    jsonata;
+    /**
+     * Process input data using the configured JSONata expression
+     *
+     * This method compiles the JSONata expression and evaluates it against the input data.
+     *
+     * @param input The input message to transform
+     * @returns Promise resolving to the transformed output message
+     */
+    async process(input) {
+        const expression = jsonata(this.jsonata);
+        return await expression.evaluate(input);
+    }
+}

package/lib/esm/index.d.ts

@@ -4,6 +4,7 @@ export * from "./agents/chat-model.js";
 export * from "./agents/guide-rail-agent.js";
 export * from "./agents/mcp-agent.js";
 export * from "./agents/team-agent.js";
+export * from "./agents/transform-agent.js";
 export * from "./agents/types.js";
 export * from "./agents/user-agent.js";
 export * from "./aigne/index.js";

package/lib/esm/index.js

@@ -4,6 +4,7 @@ export * from "./agents/chat-model.js";
 export * from "./agents/guide-rail-agent.js";
 export * from "./agents/mcp-agent.js";
 export * from "./agents/team-agent.js";
+export * from "./agents/transform-agent.js";
 export * from "./agents/types.js";
 export * from "./agents/user-agent.js";
 export * from "./aigne/index.js";

package/lib/esm/loader/agent-js.d.ts

@@ -1,7 +1,7 @@
 import { type ZodObject, type ZodType, z } from "zod";
-import { Agent, type Message } from "../agents/agent.js";
+import { Agent, type FunctionAgentFn } from "../agents/agent.js";
 export declare function loadAgentFromJsFile(path: string): Promise<Agent<any, any> | {
-    process: (args_0: Message) => Message;
+    process: FunctionAgentFn;
     name: string;
     description?: string | undefined;
     inputSchema?: ZodObject<Record<string, ZodType<any, z.ZodTypeDef, any>>, z.UnknownKeysParam, z.ZodTypeAny, {

package/lib/esm/loader/agent-js.js

@@ -1,22 +1,15 @@
 import { jsonSchemaToZod } from "@aigne/json-schema-to-zod";
+import camelize from "camelize-ts";
 import { z } from "zod";
 import { Agent } from "../agents/agent.js";
-import { customCamelize } from "../utils/camelize.js";
 import { tryOrThrow } from "../utils/type-utils.js";
-import { inputOutputSchema } from "./schema.js";
+import { inputOutputSchema, optionalize } from "./schema.js";
 const agentJsFileSchema = z.object({
     name: z.string(),
-    description: z
-        .string()
-        .nullish()
-        .transform((v) => v ?? undefined),
-    input_schema: inputOutputSchema
-        .nullish()
-        .transform((v) => (v ? jsonSchemaToZod(v) : undefined)),
-    output_schema: inputOutputSchema
-        .nullish()
-        .transform((v) => (v ? jsonSchemaToZod(v) : undefined)),
-    process: z.function(),
+    description: optionalize(z.string()),
+    inputSchema: optionalize(inputOutputSchema).transform((v) => v ? jsonSchemaToZod(v) : undefined),
+    outputSchema: optionalize(inputOutputSchema).transform((v) => v ? jsonSchemaToZod(v) : undefined),
+    process: z.custom(),
 });
 export async function loadAgentFromJsFile(path) {
     const { default: agent } = await tryOrThrow(() => import(path), (error) => new Error(`Failed to load agent definition from ${path}: ${error.message}`));
@@ -25,9 +18,9 @@ export async function loadAgentFromJsFile(path) {
     if (typeof agent !== "function") {
         throw new Error(`Agent file ${path} must export a default function, but got ${typeof agent}`);
     }
-    return tryOrThrow(() => customCamelize(agentJsFileSchema.parse({
+    return tryOrThrow(() => agentJsFileSchema.parse(camelize({
         ...agent,
-        name: agent.agent_name || agent.name,
+        name: agent.agent_name || agent.agentName || agent.name,
         process: agent,
-    }), { shallowKeys: ["input_schema", "output_schema"] }), (error) => new Error(`Failed to parse agent from ${path}: ${error.message}`));
+    })), (error) => new Error(`Failed to parse agent from ${path}: ${error.message}`));
 }

package/lib/esm/loader/agent-yaml.d.ts

@@ -1,48 +1,39 @@
-import { type ZodObject, type ZodType, z } from "zod";
+import { type ZodType } from "zod";
 import { AIAgentToolChoice } from "../agents/ai-agent.js";
 import { ProcessMode } from "../agents/team-agent.js";
-export declare function loadAgentFromYamlFile(path: string): Promise<{
+interface BaseAgentSchema {
+    name?: string;
+    description?: string;
+    inputSchema?: ZodType<Record<string, ZodType>>;
+    outputSchema?: ZodType<Record<string, ZodType>>;
+    skills?: (string | AgentSchema)[];
+    memory?: boolean | {
+        provider: string;
+        subscribeTopic?: string[];
+    };
+}
+interface AIAgentSchema extends BaseAgentSchema {
+    type: "ai";
+    instructions?: string;
+    inputKey?: string;
+    outputKey?: string;
+    toolChoice?: AIAgentToolChoice;
+}
+interface MCPAgentSchema {
     type: "mcp";
-    url?: string | undefined;
-    command?: string | undefined;
-    args?: string[] | undefined;
-} | {
+    url?: string;
+    command?: string;
+    args?: string[];
+}
+interface TeamAgentSchema extends BaseAgentSchema {
     type: "team";
-    name: string;
-    description?: string | undefined;
-    skills?: string[] | undefined;
-    mode?: ProcessMode | undefined;
-    inputSchema?: ZodObject<Record<string, ZodType<any, z.ZodTypeDef, any>>, z.UnknownKeysParam, z.ZodTypeAny, {
-        [x: string]: any;
-    }, {
-        [x: string]: any;
-    }> | undefined;
-    outputSchema?: ZodObject<Record<string, ZodType<any, z.ZodTypeDef, any>>, z.UnknownKeysParam, z.ZodTypeAny, {
-        [x: string]: any;
-    }, {
-        [x: string]: any;
-    }> | undefined;
-} | {
-    instructions: string | undefined;
-    type: "ai";
-    name: string;
-    description?: string | undefined;
-    skills?: string[] | undefined;
-    memory?: true | {
-        provider: string;
-        subscribeTopic?: string[] | undefined;
-    } | undefined;
-    inputSchema?: ZodObject<Record<string, ZodType<any, z.ZodTypeDef, any>>, z.UnknownKeysParam, z.ZodTypeAny, {
-        [x: string]: any;
-    }, {
-        [x: string]: any;
-    }> | undefined;
-    outputSchema?: ZodObject<Record<string, ZodType<any, z.ZodTypeDef, any>>, z.UnknownKeysParam, z.ZodTypeAny, {
-        [x: string]: any;
-    }, {
-        [x: string]: any;
-    }> | undefined;
-    inputKey?: string | undefined;
-    outputKey?: string | undefined;
-    toolChoice?: AIAgentToolChoice | undefined;
-}>;
+    mode?: ProcessMode;
+    iterateOn?: string;
+}
+interface TransformAgentSchema extends BaseAgentSchema {
+    type: "transform";
+    jsonata: string;
+}
+type AgentSchema = AIAgentSchema | MCPAgentSchema | TeamAgentSchema | TransformAgentSchema;
+export declare function loadAgentFromYamlFile(path: string): Promise<AgentSchema>;
+export {};

package/lib/esm/loader/agent-yaml.js

@@ -1,120 +1,72 @@
 import { jsonSchemaToZod } from "@aigne/json-schema-to-zod";
 import { nodejs } from "@aigne/platform-helpers/nodejs/index.js";
+import camelize from "camelize-ts";
 import { parse } from "yaml";
 import { z } from "zod";
 import { AIAgentToolChoice } from "../agents/ai-agent.js";
 import { ProcessMode } from "../agents/team-agent.js";
-import { customCamelize } from "../utils/camelize.js";
 import { tryOrThrow } from "../utils/type-utils.js";
-import { inputOutputSchema } from "./schema.js";
-const agentFileSchema = z.discriminatedUnion("type", [
-    z.object({
-        type: z.literal("ai"),
-        name: z.string(),
-        description: z
-            .string()
-            .nullish()
-            .transform((v) => v ?? undefined),
-        instructions: z
-            .union([
-            z.string(),
-            z.object({
-                url: z.string(),
-            }),
-        ])
-            .nullish()
-            .transform((v) => v ?? undefined),
-        input_key: z
-            .string()
-            .nullish()
-            .transform((v) => v ?? undefined),
-        input_schema: inputOutputSchema
-            .nullish()
-            .transform((v) => (v ? jsonSchemaToZod(v) : undefined)),
-        output_schema: inputOutputSchema
-            .nullish()
-            .transform((v) => (v ? jsonSchemaToZod(v) : undefined)),
-        output_key: z
-            .string()
-            .nullish()
-            .transform((v) => v ?? undefined),
-        skills: z
-            .array(z.string())
-            .nullish()
-            .transform((v) => v ?? undefined),
-        tool_choice: z
-            .nativeEnum(AIAgentToolChoice)
-            .nullish()
-            .transform((v) => v ?? undefined),
-        memory: z
-            .union([
-            z.boolean(),
+import { inputOutputSchema, optionalize } from "./schema.js";
+export async function loadAgentFromYamlFile(path) {
+    const agentSchema = z.lazy(() => {
+        const baseAgentSchema = z.object({
+            name: optionalize(z.string()),
+            description: optionalize(z.string()),
+            inputSchema: optionalize(inputOutputSchema).transform((v) => v ? jsonSchemaToZod(v) : undefined),
+            outputSchema: optionalize(inputOutputSchema).transform((v) => v ? jsonSchemaToZod(v) : undefined),
+            skills: optionalize(z.array(z.union([z.string(), agentSchema]))),
+            memory: optionalize(z.union([
+                z.boolean(),
+                z.object({
+                    provider: z.string(),
+                    subscribeTopic: optionalize(z.array(z.string())),
+                }),
+            ])),
+        });
+        return z.discriminatedUnion("type", [
+            z
+                .object({
+                type: z.literal("ai"),
+                instructions: optionalize(z.union([
+                    z.string(),
+                    z.object({
+                        url: z.string(),
+                    }),
+                ])).transform((v) => typeof v === "string"
+                    ? v
+                    : v && nodejs.fs.readFile(nodejs.path.join(nodejs.path.dirname(path), v.url), "utf8")),
+                inputKey: optionalize(z.string()),
+                outputKey: optionalize(z.string()),
+                toolChoice: optionalize(z.nativeEnum(AIAgentToolChoice)),
+            })
+                .extend(baseAgentSchema.shape),
             z.object({
-                provider: z.string(),
-                subscribe_topic: z
-                    .array(z.string())
-                    .nullish()
-                    .transform((v) => v ?? undefined),
+                type: z.literal("mcp"),
+                url: optionalize(z.string()),
+                command: optionalize(z.string()),
+                args: optionalize(z.array(z.string())),
             }),
-        ])
-            .nullish()
-            .transform((v) => v || undefined),
-    }),
-    z.object({
-        type: z.literal("mcp"),
-        url: z
-            .string()
-            .nullish()
-            .transform((v) => v ?? undefined),
-        command: z
-            .string()
-            .nullish()
-            .transform((v) => v ?? undefined),
-        args: z
-            .array(z.string())
-            .nullish()
-            .transform((v) => v ?? undefined),
-    }),
-    z.object({
-        type: z.literal("team"),
-        name: z.string(),
-        description: z
-            .string()
-            .nullish()
-            .transform((v) => v ?? undefined),
-        input_schema: inputOutputSchema
-            .nullish()
-            .transform((v) => (v ? jsonSchemaToZod(v) : undefined)),
-        output_schema: inputOutputSchema
-            .nullish()
-            .transform((v) => (v ? jsonSchemaToZod(v) : undefined)),
-        skills: z
-            .array(z.string())
-            .nullish()
-            .transform((v) => v ?? undefined),
-        mode: z
-            .nativeEnum(ProcessMode)
-            .nullish()
-            .transform((v) => v ?? undefined),
-    }),
-]);
-export async function loadAgentFromYamlFile(path) {
+            z
+                .object({
+                type: z.literal("team"),
+                mode: optionalize(z.nativeEnum(ProcessMode)),
+                iterateOn: optionalize(z.string()),
+            })
+                .extend(baseAgentSchema.shape),
+            z
+                .object({
+                type: z.literal("transform"),
+                jsonata: z.string(),
+            })
+                .extend(baseAgentSchema.shape),
+        ]);
+    });
     const raw = await tryOrThrow(() => nodejs.fs.readFile(path, "utf8"), (error) => new Error(`Failed to load agent definition from ${path}: ${error.message}`));
     const json = await tryOrThrow(() => parse(raw), (error) => new Error(`Failed to parse agent definition from ${path}: ${error.message}`));
-    const agent = await tryOrThrow(async () => customCamelize(await agentFileSchema.parseAsync({
+    const agent = await tryOrThrow(async () => await agentSchema.parseAsync(camelize({
         ...json,
         type: json.type ?? "ai",
         skills: json.skills ?? json.tools,
-    }), {
-        shallowKeys: ["input_schema", "output_schema"],
-    }), (error) => new Error(`Failed to validate agent definition from ${path}: ${error.message}`));
-    if (agent.type === "ai") {
-        return {
-            ...agent,
-            instructions: typeof agent.instructions === "object" && "url" in agent.instructions
-                ? await nodejs.fs.readFile(nodejs.path.join(nodejs.path.dirname(path), agent.instructions.url), "utf8")
-                : agent.instructions,
-        };
-    }
+    })), (error) => new Error(`Failed to validate agent definition from ${path}: ${error.message}`));
     return agent;
 }