@aigne/core 1.32.2 → 1.33.1

package/CHANGELOG.md

@@ -12,6 +12,30 @@
   * dependencies
     * @aigne/observability bumped to 0.1.0
 
+## [1.33.1](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.33.0...core-v1.33.1) (2025-07-14)
+
+
+### Bug Fixes
+
+* **cli:** print pretty error message for cli ([#249](https://github.com/AIGNE-io/aigne-framework/issues/249)) ([d68e0f7](https://github.com/AIGNE-io/aigne-framework/commit/d68e0f7151259a05696de77d9f00793b6f5b36b2))
+* **core:** check if skills is empty before TeamAgent processes ([#250](https://github.com/AIGNE-io/aigne-framework/issues/250)) ([f0fff7e](https://github.com/AIGNE-io/aigne-framework/commit/f0fff7e41512cf06f106a0d7fe03a7d98206f136))
+* **deps:** update deps to latest version ([#247](https://github.com/AIGNE-io/aigne-framework/issues/247)) ([3972f88](https://github.com/AIGNE-io/aigne-framework/commit/3972f887a9abff20c26da6b51c1071cbd54c0bf1))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/observability-api bumped to 0.7.2
+    * @aigne/platform-helpers bumped to 0.3.1
+
+## [1.33.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.32.2...core-v1.33.0) (2025-07-10)
+
+
+### Features
+
+* **core:** support external files as agent input/output schema ([#242](https://github.com/AIGNE-io/aigne-framework/issues/242)) ([58f8de6](https://github.com/AIGNE-io/aigne-framework/commit/58f8de63008b78ea1b404ba7721c3a242c330113))
+
 ## [1.32.2](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.32.1...core-v1.32.2) (2025-07-09)
 
 

package/README.md

@@ -6,8 +6,6 @@
 [![NPM Version](https://img.shields.io/npm/v/@aigne/core)](https://www.npmjs.com/package/@aigne/core)
 [![Elastic-2.0 licensed](https://img.shields.io/npm/l/@aigne/core)](https://github.com/AIGNE-io/aigne-framework/blob/main/LICENSE)
 
-**English** | [中文](./README.zh.md)
-
 Core library of [AIGNE Framework](https://github.com/AIGNE-io/aigne-framework) for building AI-powered applications.
 
 ## Introduction

package/lib/cjs/agents/chat-model.js

@@ -155,7 +155,7 @@ const chatModelInputMessageSchema = zod_1.z.object({
         type: zod_1.z.literal("function"),
         function: zod_1.z.object({
             name: zod_1.z.string(),
-            arguments: zod_1.z.record(zod_1.z.unknown()),
+            arguments: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
         }),
     }))
         .optional(),
@@ -169,7 +169,7 @@ const chatModelInputResponseFormatSchema = zod_1.z.discriminatedUnion("type", [
         jsonSchema: zod_1.z.object({
             name: zod_1.z.string(),
             description: zod_1.z.string().optional(),
-            schema: zod_1.z.record(zod_1.z.unknown()),
+            schema: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
             strict: zod_1.z.boolean().optional(),
         }),
     }),
@@ -179,7 +179,7 @@ const chatModelInputToolSchema = zod_1.z.object({
     function: zod_1.z.object({
         name: zod_1.z.string(),
         description: zod_1.z.string().optional(),
-        parameters: zod_1.z.record(zod_1.z.unknown()),
+        parameters: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
     }),
 });
 const chatModelInputToolChoiceSchema = zod_1.z.union([
@@ -208,7 +208,7 @@ const chatModelOutputToolCallSchema = zod_1.z.object({
     type: zod_1.z.literal("function"),
     function: zod_1.z.object({
         name: zod_1.z.string(),
-        arguments: zod_1.z.record(zod_1.z.unknown()),
+        arguments: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
     }),
 });
 const chatModelOutputUsageSchema = zod_1.z.object({
@@ -217,7 +217,7 @@ const chatModelOutputUsageSchema = zod_1.z.object({
 });
 const chatModelOutputSchema = zod_1.z.object({
     text: zod_1.z.string().optional(),
-    json: zod_1.z.record(zod_1.z.unknown()).optional(),
+    json: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
     toolCalls: zod_1.z.array(chatModelOutputToolCallSchema).optional(),
     usage: chatModelOutputUsageSchema.optional(),
     model: zod_1.z.string().optional(),

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

@@ -313,6 +313,6 @@ const mcpAgentOptionsSchema = zod_1.z.union([
     zod_1.z.object({
         command: zod_1.z.string(),
         args: zod_1.z.array(zod_1.z.string()).optional(),
-        env: zod_1.z.record(zod_1.z.string()).optional(),
+        env: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
     }),
 ]);

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

@@ -117,6 +117,8 @@ class TeamAgent extends agent_js_1.Agent {
      * @returns A stream of message chunks that collectively form the response
      */
     process(input, options) {
+        if (!this.skills.length)
+            throw new Error("TeamAgent must have at least one skill defined.");
         if (this.iterateOn) {
             return this._processIterator(this.iterateOn, input, options);
         }

package/lib/cjs/aigne/aigne.d.ts

@@ -10,6 +10,11 @@ import type { ContextLimits } from "./usage.js";
  * Options for the AIGNE class.
  */
 export interface AIGNEOptions {
+    /**
+     * Optional root directory for this AIGNE instance.
+     * This is used to resolve relative paths for agents and skills.
+     */
+    rootDir?: string;
     /**
      * The name of the AIGNE instance.
      */
@@ -67,6 +72,10 @@ export declare class AIGNE<U extends UserContext = UserContext> {
      * @param options - Configuration options for the AIGNE instance including name, description, model, and agents.
      */
     constructor(options?: AIGNEOptions);
+    /**
+     * Optional root directory for this AIGNE instance.
+     */
+    rootDir?: string;
     /**
      * Optional name identifier for this AIGNE instance.
      */

package/lib/cjs/aigne/aigne.js

@@ -29,9 +29,10 @@ class AIGNE {
      * @returns A fully initialized AIGNE instance with configured agents and skills.
      */
     static async load(path, options) {
-        const { model, agents, skills, ...aigne } = await (0, index_js_1.load)({ ...options, path });
+        const { model, agents = [], skills = [], ...aigne } = await (0, index_js_1.load)({ ...options, path });
         return new AIGNE({
             ...options,
+            rootDir: aigne.rootDir,
             model: options?.model || model,
             name: options?.name || aigne.name || undefined,
             description: options?.description || aigne.description || undefined,
@@ -47,6 +48,7 @@ class AIGNE {
     constructor(options) {
         if (options)
             (0, type_utils_js_1.checkArguments)("AIGNE", aigneOptionsSchema, options);
+        this.rootDir = options?.rootDir;
         this.name = options?.name;
         this.description = options?.description;
         this.model = options?.model;
@@ -62,6 +64,10 @@ class AIGNE {
         this.observer?.serve();
         this.initProcessExitHandler();
     }
+    /**
+     * Optional root directory for this AIGNE instance.
+     */
+    rootDir;
     /**
      * Optional name identifier for this AIGNE instance.
      */

package/lib/cjs/aigne/context.js

@@ -388,6 +388,6 @@ async function* withAbortSignal(signal, error, fn) {
 }
 const aigneContextInvokeArgsSchema = zod_1.z.object({
     agent: zod_1.z.union([zod_1.z.custom(), zod_1.z.custom()]),
-    message: zod_1.z.union([zod_1.z.record(zod_1.z.unknown()), zod_1.z.string()]).optional(),
+    message: zod_1.z.union([zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()), zod_1.z.string()]).optional(),
     options: zod_1.z.object({ returnActiveAgent: zod_1.z.boolean().optional() }).optional(),
 });

package/lib/cjs/aigne/message-queue.js

@@ -92,18 +92,18 @@ function once(events, event, listener) {
 }
 const subscribeArgsSchema = zod_1.z.object({
     topic: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]),
-    listener: zod_1.z.function(zod_1.z.tuple([zod_1.z.any()]), zod_1.z.any()).optional(),
+    listener: zod_1.z.custom().optional(),
 });
 const unsubscribeArgsSchema = zod_1.z.object({
     topic: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]),
-    listener: zod_1.z.function(zod_1.z.tuple([zod_1.z.any()]), zod_1.z.any()),
+    listener: zod_1.z.custom(),
 });
 const publishArgsSchema = zod_1.z.object({
     topic: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]),
     payload: zod_1.z.object({
         role: zod_1.z.union([zod_1.z.literal("user"), zod_1.z.literal("agent")]),
         source: zod_1.z.string().optional(),
-        message: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.unknown())]),
+        message: zod_1.z.union([zod_1.z.string(), zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())]),
         context: zod_1.z.any(),
     }),
 });

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

@@ -43,21 +43,21 @@ const zod_1 = require("zod");
 const agent_js_1 = require("../agents/agent.js");
 const type_utils_js_1 = require("../utils/type-utils.js");
 const schema_js_1 = require("./schema.js");
-const agentJsFileSchema = zod_1.z.object({
-    name: zod_1.z.string(),
-    description: (0, schema_js_1.optionalize)(zod_1.z.string()),
-    inputSchema: (0, schema_js_1.optionalize)(schema_js_1.inputOutputSchema).transform((v) => v ? (0, json_schema_to_zod_1.jsonSchemaToZod)(v) : undefined),
-    outputSchema: (0, schema_js_1.optionalize)(schema_js_1.inputOutputSchema).transform((v) => v ? (0, json_schema_to_zod_1.jsonSchemaToZod)(v) : undefined),
-    process: zod_1.z.custom(),
-});
 async function loadAgentFromJsFile(path) {
+    const agentJsFileSchema = zod_1.z.object({
+        name: zod_1.z.string(),
+        description: (0, schema_js_1.optionalize)(zod_1.z.string()),
+        inputSchema: (0, schema_js_1.optionalize)((0, schema_js_1.inputOutputSchema)({ path })).transform((v) => v ? (0, json_schema_to_zod_1.jsonSchemaToZod)(v) : undefined),
+        outputSchema: (0, schema_js_1.optionalize)((0, schema_js_1.inputOutputSchema)({ path })).transform((v) => v ? (0, json_schema_to_zod_1.jsonSchemaToZod)(v) : undefined),
+        process: zod_1.z.custom(),
+    });
     const { default: agent } = await (0, type_utils_js_1.tryOrThrow)(() => Promise.resolve(`${path}`).then(s => __importStar(require(s))), (error) => new Error(`Failed to load agent definition from ${path}: ${error.message}`));
     if (agent instanceof agent_js_1.Agent)
         return agent;
     if (typeof agent !== "function") {
         throw new Error(`Agent file ${path} must export a default function, but got ${typeof agent}`);
     }
-    return (0, type_utils_js_1.tryOrThrow)(() => agentJsFileSchema.parse((0, camelize_ts_1.default)({
+    return (0, type_utils_js_1.tryOrThrow)(() => agentJsFileSchema.parseAsync((0, camelize_ts_1.default)({
         ...agent,
         name: agent.agent_name || agent.agentName || agent.name,
         process: agent,

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

@@ -4,8 +4,8 @@ import { ProcessMode } from "../agents/team-agent.js";
 interface BaseAgentSchema {
     name?: string;
     description?: string;
-    inputSchema?: ZodType<Record<string, ZodType>>;
-    outputSchema?: ZodType<Record<string, ZodType>>;
+    inputSchema?: ZodType<Record<string, any>>;
+    outputSchema?: ZodType<Record<string, any>>;
     skills?: (string | AgentSchema)[];
     memory?: boolean | {
         provider: string;

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

@@ -18,8 +18,8 @@ async function loadAgentFromYamlFile(path) {
         const baseAgentSchema = zod_1.z.object({
             name: (0, schema_js_1.optionalize)(zod_1.z.string()),
             description: (0, schema_js_1.optionalize)(zod_1.z.string()),
-            inputSchema: (0, schema_js_1.optionalize)(schema_js_1.inputOutputSchema).transform((v) => v ? (0, json_schema_to_zod_1.jsonSchemaToZod)(v) : undefined),
-            outputSchema: (0, schema_js_1.optionalize)(schema_js_1.inputOutputSchema).transform((v) => v ? (0, json_schema_to_zod_1.jsonSchemaToZod)(v) : undefined),
+            inputSchema: (0, schema_js_1.optionalize)((0, schema_js_1.inputOutputSchema)({ path })).transform((v) => v ? (0, json_schema_to_zod_1.jsonSchemaToZod)(v) : undefined),
+            outputSchema: (0, schema_js_1.optionalize)((0, schema_js_1.inputOutputSchema)({ path })).transform((v) => v ? (0, json_schema_to_zod_1.jsonSchemaToZod)(v) : undefined),
             skills: (0, schema_js_1.optionalize)(zod_1.z.array(zod_1.z.union([zod_1.z.string(), agentSchema]))),
             memory: (0, schema_js_1.optionalize)(zod_1.z.union([
                 zod_1.z.boolean(),
@@ -68,11 +68,11 @@ async function loadAgentFromYamlFile(path) {
         ]);
     });
     const raw = await (0, type_utils_js_1.tryOrThrow)(() => index_js_1.nodejs.fs.readFile(path, "utf8"), (error) => new Error(`Failed to load agent definition from ${path}: ${error.message}`));
-    const json = await (0, type_utils_js_1.tryOrThrow)(() => (0, yaml_1.parse)(raw), (error) => new Error(`Failed to parse agent definition from ${path}: ${error.message}`));
-    const agent = await (0, type_utils_js_1.tryOrThrow)(async () => await agentSchema.parseAsync((0, camelize_ts_1.default)({
+    const json = (0, type_utils_js_1.tryOrThrow)(() => (0, camelize_ts_1.default)((0, yaml_1.parse)(raw)), (error) => new Error(`Failed to parse agent definition from ${path}: ${error.message}`));
+    const agent = await (0, type_utils_js_1.tryOrThrow)(async () => await agentSchema.parseAsync({
         ...json,
         type: json.type ?? "ai",
         skills: json.skills ?? json.tools,
-    })), (error) => new Error(`Failed to validate agent definition from ${path}: ${error.message}`));
+    }), (error) => new Error(`Failed to validate agent definition from ${path}: ${error.message}`));
     return agent;
 }

package/lib/cjs/loader/index.d.ts

@@ -2,6 +2,7 @@ import type { Camelize } from "camelize-ts";
 import { z } from "zod";
 import { Agent } from "../agents/agent.js";
 import type { ChatModel, ChatModelOptions } from "../agents/chat-model.js";
+import type { AIGNEOptions } from "../aigne/aigne.js";
 import type { MemoryAgent, MemoryAgentOptions } from "../memory/memory.js";
 interface LoadableModelClass {
     new (parameters: {
@@ -23,103 +24,72 @@ export interface LoadOptions {
     }[];
     path: string;
 }
-export declare function load(options: LoadOptions): Promise<{
-    model: ChatModel | undefined;
-    agents: Agent<any, any>[];
-    skills: Agent<any, any>[];
-    name?: string | null | undefined;
-    description?: string | null | undefined;
-    chat_model?: {
-        name?: string | null | undefined;
-        temperature?: number | null | undefined;
-        provider?: string | null | undefined;
-        top_p?: number | null | undefined;
-        frequency_penalty?: number | null | undefined;
-        presence_penalty?: number | null | undefined;
-    } | null | undefined;
-}>;
+export declare function load(options: LoadOptions): Promise<AIGNEOptions>;
 export declare function loadAgent(path: string, options?: LoadOptions): Promise<Agent>;
-export declare function loadModel(models: LoadableModel[], model?: Camelize<z.infer<typeof aigneFileSchema>["chat_model"]>, modelOptions?: ChatModelOptions): Promise<ChatModel | undefined>;
+export declare function loadModel(models: LoadableModel[], model?: Camelize<z.infer<typeof aigneFileSchema>["model"]>, modelOptions?: ChatModelOptions): Promise<ChatModel | undefined>;
 declare const aigneFileSchema: z.ZodObject<{
-    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    chat_model: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodObject<{
-        provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        temperature: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-        top_p: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-        frequency_penalty: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-        presence_penalty: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    }, "strip", z.ZodTypeAny, {
+    name: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
+    description: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
+    model: z.ZodEffects<z.ZodType<string | {
         name?: string | null | undefined;
         temperature?: number | null | undefined;
+        topP?: number | null | undefined;
+        frequencyPenalty?: number | null | undefined;
+        presencePenalty?: number | null | undefined;
         provider?: string | null | undefined;
-        top_p?: number | null | undefined;
-        frequency_penalty?: number | null | undefined;
-        presence_penalty?: number | null | undefined;
-    }, {
+    } | undefined, z.ZodTypeDef, string | {
         name?: string | null | undefined;
         temperature?: number | null | undefined;
+        topP?: number | null | undefined;
+        frequencyPenalty?: number | null | undefined;
+        presencePenalty?: number | null | undefined;
         provider?: string | null | undefined;
-        top_p?: number | null | undefined;
-        frequency_penalty?: number | null | undefined;
-        presence_penalty?: number | null | undefined;
-    }>]>>>, {
+    } | undefined>, {
         name?: string | null | undefined;
         temperature?: number | null | undefined;
+        topP?: number | null | undefined;
+        frequencyPenalty?: number | null | undefined;
+        presencePenalty?: number | null | undefined;
         provider?: string | null | undefined;
-        top_p?: number | null | undefined;
-        frequency_penalty?: number | null | undefined;
-        presence_penalty?: number | null | undefined;
-    } | null | undefined, string | {
+    } | undefined, string | {
         name?: string | null | undefined;
         temperature?: number | null | undefined;
+        topP?: number | null | undefined;
+        frequencyPenalty?: number | null | undefined;
+        presencePenalty?: number | null | undefined;
         provider?: string | null | undefined;
-        top_p?: number | null | undefined;
-        frequency_penalty?: number | null | undefined;
-        presence_penalty?: number | null | undefined;
-    } | null | undefined>;
-    agents: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
-    skills: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+    } | undefined>;
+    agents: z.ZodType<string[] | undefined, z.ZodTypeDef, string[] | undefined>;
+    skills: z.ZodType<string[] | undefined, z.ZodTypeDef, string[] | undefined>;
 }, "strip", z.ZodTypeAny, {
-    name?: string | null | undefined;
-    description?: string | null | undefined;
-    skills?: string[] | null | undefined;
-    chat_model?: {
+    name?: string | undefined;
+    description?: string | undefined;
+    skills?: string[] | undefined;
+    model?: {
         name?: string | null | undefined;
         temperature?: number | null | undefined;
+        topP?: number | null | undefined;
+        frequencyPenalty?: number | null | undefined;
+        presencePenalty?: number | null | undefined;
         provider?: string | null | undefined;
-        top_p?: number | null | undefined;
-        frequency_penalty?: number | null | undefined;
-        presence_penalty?: number | null | undefined;
-    } | null | undefined;
-    agents?: string[] | null | undefined;
+    } | undefined;
+    agents?: string[] | undefined;
 }, {
-    name?: string | null | undefined;
-    description?: string | null | undefined;
-    skills?: string[] | null | undefined;
-    chat_model?: string | {
+    name?: string | undefined;
+    description?: string | undefined;
+    skills?: string[] | undefined;
+    model?: string | {
         name?: string | null | undefined;
         temperature?: number | null | undefined;
+        topP?: number | null | undefined;
+        frequencyPenalty?: number | null | undefined;
+        presencePenalty?: number | null | undefined;
         provider?: string | null | undefined;
-        top_p?: number | null | undefined;
-        frequency_penalty?: number | null | undefined;
-        presence_penalty?: number | null | undefined;
-    } | null | undefined;
-    agents?: string[] | null | undefined;
+    } | undefined;
+    agents?: string[] | undefined;
 }>;
 export declare function loadAIGNEFile(path: string): Promise<{
-    name?: string | null | undefined;
-    description?: string | null | undefined;
-    skills?: string[] | null | undefined;
-    chat_model?: {
-        name?: string | null | undefined;
-        temperature?: number | null | undefined;
-        provider?: string | null | undefined;
-        top_p?: number | null | undefined;
-        frequency_penalty?: number | null | undefined;
-        presence_penalty?: number | null | undefined;
-    } | null | undefined;
-    agents?: string[] | null | undefined;
+    aigne: z.infer<typeof aigneFileSchema>;
+    rootDir: string;
 }>;
 export {};

package/lib/cjs/loader/index.js

@@ -1,10 +1,14 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.load = load;
 exports.loadAgent = loadAgent;
 exports.loadModel = loadModel;
 exports.loadAIGNEFile = loadAIGNEFile;
 const index_js_1 = require("@aigne/platform-helpers/nodejs/index.js");
+const camelize_ts_1 = __importDefault(require("camelize-ts"));
 const yaml_1 = require("yaml");
 const zod_1 = require("zod");
 const agent_js_1 = require("../agents/agent.js");
@@ -16,21 +20,21 @@ const prompt_builder_js_1 = require("../prompt/prompt-builder.js");
 const type_utils_js_1 = require("../utils/type-utils.js");
 const agent_js_js_1 = require("./agent-js.js");
 const agent_yaml_js_1 = require("./agent-yaml.js");
+const schema_js_1 = require("./schema.js");
 const AIGNE_FILE_NAME = ["aigne.yaml", "aigne.yml"];
 async function load(options) {
-    const aigneFilePath = await getAIGNEFilePath(options.path);
-    const rootDir = index_js_1.nodejs.path.dirname(aigneFilePath);
-    const aigne = await loadAIGNEFile(aigneFilePath);
+    const { aigne, rootDir } = await loadAIGNEFile(options.path);
     const agents = await Promise.all((aigne.agents ?? []).map((filename) => loadAgent(index_js_1.nodejs.path.join(rootDir, filename), options)));
     const skills = await Promise.all((aigne.skills ?? []).map((filename) => loadAgent(index_js_1.nodejs.path.join(rootDir, filename), options)));
     return {
         ...aigne,
+        rootDir,
         model: await loadModel(options.models.map((i) => typeof i === "function"
             ? {
                 name: i.name,
                 create: (options) => new i(options),
             }
-            : i), aigne.chat_model),
+            : i), aigne.model),
         agents,
         skills,
     };
@@ -127,39 +131,44 @@ async function loadModel(models, model, modelOptions) {
     });
 }
 const aigneFileSchema = zod_1.z.object({
-    name: zod_1.z.string().nullish(),
-    description: zod_1.z.string().nullish(),
-    chat_model: zod_1.z
-        .union([
+    name: (0, schema_js_1.optionalize)(zod_1.z.string()),
+    description: (0, schema_js_1.optionalize)(zod_1.z.string()),
+    model: (0, schema_js_1.optionalize)(zod_1.z.union([
         zod_1.z.string(),
         zod_1.z.object({
             provider: zod_1.z.string().nullish(),
             name: zod_1.z.string().nullish(),
             temperature: zod_1.z.number().min(0).max(2).nullish(),
-            top_p: zod_1.z.number().min(0).nullish(),
-            frequency_penalty: zod_1.z.number().min(-2).max(2).nullish(),
-            presence_penalty: zod_1.z.number().min(-2).max(2).nullish(),
+            topP: zod_1.z.number().min(0).nullish(),
+            frequencyPenalty: zod_1.z.number().min(-2).max(2).nullish(),
+            presencePenalty: zod_1.z.number().min(-2).max(2).nullish(),
         }),
-    ])
-        .nullish()
-        .transform((v) => (typeof v === "string" ? { name: v } : v)),
-    agents: zod_1.z.array(zod_1.z.string()).nullish(),
-    skills: zod_1.z.array(zod_1.z.string()).nullish(),
+    ])).transform((v) => (typeof v === "string" ? { name: v } : v)),
+    agents: (0, schema_js_1.optionalize)(zod_1.z.array(zod_1.z.string())),
+    skills: (0, schema_js_1.optionalize)(zod_1.z.array(zod_1.z.string())),
 });
 async function loadAIGNEFile(path) {
-    const raw = await (0, type_utils_js_1.tryOrThrow)(() => index_js_1.nodejs.fs.readFile(path, "utf8"), (error) => new Error(`Failed to load aigne.yaml from ${path}: ${error.message}`));
-    const json = await (0, type_utils_js_1.tryOrThrow)(() => (0, yaml_1.parse)(raw), (error) => new Error(`Failed to parse aigne.yaml from ${path}: ${error.message}`));
-    const agent = (0, type_utils_js_1.tryOrThrow)(() => aigneFileSchema.parse({ ...json, skills: json.skills ?? json.tools }), (error) => new Error(`Failed to validate aigne.yaml from ${path}: ${error.message}`));
-    return agent;
+    const file = await findAIGNEFile(path);
+    const raw = await (0, type_utils_js_1.tryOrThrow)(() => index_js_1.nodejs.fs.readFile(file, "utf8"), (error) => new Error(`Failed to load aigne.yaml from ${file}: ${error.message}`));
+    const json = (0, type_utils_js_1.tryOrThrow)(() => (0, camelize_ts_1.default)((0, yaml_1.parse)(raw)), (error) => new Error(`Failed to parse aigne.yaml from ${file}: ${error.message}`));
+    const aigne = (0, type_utils_js_1.tryOrThrow)(() => aigneFileSchema.parse({
+        ...json,
+        model: json.model ?? json.chatModel,
+        skills: json.skills ?? json.tools,
+    }), (error) => new Error(`Failed to validate aigne.yaml from ${file}: ${error.message}`));
+    return { aigne, rootDir: index_js_1.nodejs.path.dirname(file) };
 }
-async function getAIGNEFilePath(path) {
-    const s = await index_js_1.nodejs.fs.stat(path);
-    if (s.isDirectory()) {
-        for (const file of AIGNE_FILE_NAME) {
-            const filePath = index_js_1.nodejs.path.join(path, file);
-            if ((await index_js_1.nodejs.fs.stat(filePath)).isFile())
-                return filePath;
+async function findAIGNEFile(path) {
+    const possibleFiles = AIGNE_FILE_NAME.includes(index_js_1.nodejs.path.basename(path))
+        ? [path]
+        : AIGNE_FILE_NAME.map((name) => index_js_1.nodejs.path.join(path, name));
+    for (const file of possibleFiles) {
+        try {
+            const stat = await index_js_1.nodejs.fs.stat(file);
+            if (stat.isFile())
+                return file;
         }
+        catch { }
     }
-    return path;
+    throw new Error(`aigne.yaml not found in ${path}. Please ensure you are in the correct directory or provide a valid path.`);
 }

package/lib/cjs/loader/schema.d.ts

@@ -1,5 +1,7 @@
 import { type ZodType, z } from "zod";
-export declare const inputOutputSchema: z.ZodObject<{
+export declare const inputOutputSchema: ({ path }: {
+    path: string;
+}) => z.ZodUnion<[ZodType<any, z.ZodTypeDef, any>, z.ZodEffects<z.ZodObject<{
     type: z.ZodLiteral<"object">;
     properties: z.ZodRecord<z.ZodString, z.ZodAny>;
     required: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -14,5 +16,10 @@ export declare const inputOutputSchema: z.ZodObject<{
     properties: Record<string, any>;
     required?: string[] | undefined;
     additionalProperties?: boolean | undefined;
-}>;
+}>, any, {
+    type: "object";
+    properties: Record<string, any>;
+    required?: string[] | undefined;
+    additionalProperties?: boolean | undefined;
+}>]>;
 export declare function optionalize<T>(schema: ZodType<T>): ZodType<T | undefined>;

package/lib/cjs/loader/schema.js

@@ -2,13 +2,50 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.inputOutputSchema = void 0;
 exports.optionalize = optionalize;
+const index_js_1 = require("@aigne/platform-helpers/nodejs/index.js");
+const yaml_1 = require("yaml");
 const zod_1 = require("zod");
-exports.inputOutputSchema = zod_1.z.object({
-    type: zod_1.z.literal("object"),
-    properties: zod_1.z.record(zod_1.z.any()),
-    required: zod_1.z.array(zod_1.z.string()).optional(),
-    additionalProperties: zod_1.z.boolean().optional(),
-});
+const inputOutputSchema = ({ path }) => {
+    const jsonSchemaSchema = zod_1.z
+        .object({
+        type: zod_1.z.literal("object"),
+        properties: zod_1.z.record(zod_1.z.any()),
+        required: zod_1.z.array(zod_1.z.string()).optional(),
+        additionalProperties: zod_1.z.boolean().optional(),
+    })
+        .transform((v) => {
+        const t = async (schema) => {
+            if (schema?.type === "object" && schema.properties) {
+                return {
+                    ...schema,
+                    properties: Object.fromEntries(await Promise.all(Object.entries(schema.properties).map(async ([key, value]) => [
+                        key,
+                        await t(value),
+                    ]))),
+                };
+            }
+            if (schema?.type === "array" && schema.items) {
+                return { ...schema, items: await t(schema.items) };
+            }
+            // Load nested schemas from file
+            if (typeof schema === "string") {
+                const raw = await index_js_1.nodejs.fs.readFile(index_js_1.nodejs.path.join(index_js_1.nodejs.path.dirname(path), schema), "utf8");
+                return jsonSchemaSchema.parseAsync((0, yaml_1.parse)(raw));
+            }
+            return schema;
+        };
+        return t(v);
+    });
+    return zod_1.z.union([
+        zod_1.z
+            .string()
+            .transform((v) => index_js_1.nodejs.fs
+            .readFile(index_js_1.nodejs.path.join(index_js_1.nodejs.path.dirname(path), v), "utf8")
+            .then((raw) => jsonSchemaSchema.parseAsync((0, yaml_1.parse)(raw)))),
+        jsonSchemaSchema,
+    ]);
+};
+exports.inputOutputSchema = inputOutputSchema;
 function optionalize(schema) {
     return schema.nullish().transform((v) => v ?? undefined);
 }

package/lib/cjs/prompt/template.js

@@ -167,7 +167,7 @@ const chatModelOutputToolCallSchema = zod_1.z.object({
     type: zod_1.z.literal("function"),
     function: zod_1.z.object({
         name: zod_1.z.string(),
-        arguments: zod_1.z.record(zod_1.z.unknown()),
+        arguments: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
     }),
 });
 const agentChatMessageSchema = zod_1.z.object({
@@ -179,7 +179,7 @@ const agentChatMessageSchema = zod_1.z.object({
 const toolChatMessageSchema = zod_1.z.object({
     role: zod_1.z.literal("tool"),
     content: zod_1.z
-        .union([zod_1.z.string(), zod_1.z.record(zod_1.z.unknown())])
+        .union([zod_1.z.string(), zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())])
         .transform((val) => (typeof val !== "string" ? JSON.stringify(val) : val)),
     toolCallId: zod_1.z.string(),
     name: zod_1.z.string().optional(),

package/lib/dts/aigne/aigne.d.ts

@@ -10,6 +10,11 @@ import type { ContextLimits } from "./usage.js";
  * Options for the AIGNE class.
  */
 export interface AIGNEOptions {
+    /**
+     * Optional root directory for this AIGNE instance.
+     * This is used to resolve relative paths for agents and skills.
+     */
+    rootDir?: string;
     /**
      * The name of the AIGNE instance.
      */
@@ -67,6 +72,10 @@ export declare class AIGNE<U extends UserContext = UserContext> {
      * @param options - Configuration options for the AIGNE instance including name, description, model, and agents.
      */
     constructor(options?: AIGNEOptions);
+    /**
+     * Optional root directory for this AIGNE instance.
+     */
+    rootDir?: string;
     /**
      * Optional name identifier for this AIGNE instance.
      */