@aigne/core 1.32.2 → 1.33.0

package/CHANGELOG.md

@@ -12,6 +12,13 @@
   * dependencies
     * @aigne/observability bumped to 0.1.0
 
+## [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/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(),

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/dts/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/dts/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/esm/loader/agent-js.js

@@ -4,21 +4,21 @@ import { z } from "zod";
 import { Agent } from "../agents/agent.js";
 import { tryOrThrow } from "../utils/type-utils.js";
 import { inputOutputSchema, optionalize } from "./schema.js";
-const agentJsFileSchema = z.object({
-    name: z.string(),
-    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 agentJsFileSchema = z.object({
+        name: z.string(),
+        description: optionalize(z.string()),
+        inputSchema: optionalize(inputOutputSchema({ path })).transform((v) => v ? jsonSchemaToZod(v) : undefined),
+        outputSchema: optionalize(inputOutputSchema({ path })).transform((v) => v ? jsonSchemaToZod(v) : undefined),
+        process: z.custom(),
+    });
     const { default: agent } = await tryOrThrow(() => import(/* @vite-ignore */ path), (error) => new Error(`Failed to load agent definition from ${path}: ${error.message}`));
     if (agent instanceof Agent)
         return agent;
     if (typeof agent !== "function") {
         throw new Error(`Agent file ${path} must export a default function, but got ${typeof agent}`);
     }
-    return tryOrThrow(() => agentJsFileSchema.parse(camelize({
+    return tryOrThrow(() => agentJsFileSchema.parseAsync(camelize({
         ...agent,
         name: agent.agent_name || agent.agentName || agent.name,
         process: agent,

package/lib/esm/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/esm/loader/agent-yaml.js

@@ -12,8 +12,8 @@ export async function loadAgentFromYamlFile(path) {
         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),
+            inputSchema: optionalize(inputOutputSchema({ path })).transform((v) => v ? jsonSchemaToZod(v) : undefined),
+            outputSchema: optionalize(inputOutputSchema({ path })).transform((v) => v ? jsonSchemaToZod(v) : undefined),
             skills: optionalize(z.array(z.union([z.string(), agentSchema]))),
             memory: optionalize(z.union([
                 z.boolean(),

package/lib/esm/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/esm/loader/schema.js

@@ -1,10 +1,46 @@
+import { nodejs } from "@aigne/platform-helpers/nodejs/index.js";
+import { parse } from "yaml";
 import { z } from "zod";
-export const inputOutputSchema = z.object({
-    type: z.literal("object"),
-    properties: z.record(z.any()),
-    required: z.array(z.string()).optional(),
-    additionalProperties: z.boolean().optional(),
-});
+export const inputOutputSchema = ({ path }) => {
+    const jsonSchemaSchema = z
+        .object({
+        type: z.literal("object"),
+        properties: z.record(z.any()),
+        required: z.array(z.string()).optional(),
+        additionalProperties: 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 nodejs.fs.readFile(nodejs.path.join(nodejs.path.dirname(path), schema), "utf8");
+                return jsonSchemaSchema.parseAsync(parse(raw));
+            }
+            return schema;
+        };
+        return t(v);
+    });
+    return z.union([
+        z
+            .string()
+            .transform((v) => nodejs.fs
+            .readFile(nodejs.path.join(nodejs.path.dirname(path), v), "utf8")
+            .then((raw) => jsonSchemaSchema.parseAsync(parse(raw)))),
+        jsonSchemaSchema,
+    ]);
+};
 export function optionalize(schema) {
     return schema.nullish().transform((v) => v ?? undefined);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.32.2",
+  "version": "1.33.0",
   "description": "AIGNE core library for building AI-powered applications",
   "publishConfig": {
     "access": "public"

package/README.zh.md

@@ -1,79 +0,0 @@
-# @aigne/core
-
-[![GitHub star chart](https://img.shields.io/github/stars/AIGNE-io/aigne-framework?style=flat-square)](https://star-history.com/#AIGNE-io/aigne-framework)
-[![Open Issues](https://img.shields.io/github/issues-raw/AIGNE-io/aigne-framework?style=flat-square)](https://github.com/AIGNE-io/aigne-framework/issues)
-[![codecov](https://codecov.io/gh/AIGNE-io/aigne-framework/graph/badge.svg?token=DO07834RQL)](https://codecov.io/gh/AIGNE-io/aigne-framework)
-[![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.md) | **中文**
-
-[AIGNE Framework](https://github.com/AIGNE-io/aigne-framework) 的核心库，用于构建 AI 驱动的应用程序。
-
-## 简介
-
-`@aigne/core` 是 [AIGNE Framework](https://github.com/AIGNE-io/aigne-framework) 的基础组件，提供构建 AI 驱动应用程序所需的核心模块和工具。该包实现了框架的核心功能，包括代理系统、aigne 环境、模型集成和工作流模式支持。
-
-## 特性
-
-* **多 AI 模型支持**：内置支持 OpenAI、Gemini、Claude、Nova 等主流 AI 模型，可轻松扩展支持其他模型
-* **代理系统**：强大的代理抽象，支持 AI 代理、功能代理、MCP 代理等
-* **AIGNE 环境**：灵活处理代理之间的通信和工作流执行
-* **工作流模式**：支持顺序、并发、路由、交接等多种工作流模式
-* **MCP 协议集成**：通过模型上下文协议与外部系统无缝集成
-* **TypeScript 支持**：全面的类型定义，提供出色的开发体验
-
-## 安装
-
-### 使用 npm
-
-```bash
-npm install @aigne/core
-```
-
-### 使用 yarn
-
-```bash
-yarn add @aigne/core
-```
-
-### 使用 pnpm
-
-```bash
-pnpm add @aigne/core
-```
-
-## 基本用法
-
-```typescript
-import { AIAgent, AIGNE } from "@aigne/core";
-import { OpenAIChatModel } from "@aigne/core/models/openai-chat-model.js";
-
-// 创建 AI 模型实例
-const model = new OpenAIChatModel({
-  apiKey: process.env.OPENAI_API_KEY,
-  model: process.env.DEFAULT_CHAT_MODEL || "gpt-4-turbo",
-});
-
-// 创建 AI 代理
-const agent = AIAgent.from({
-  name: "Assistant",
-  instructions: "You are a helpful assistant.",
-});
-
-// AIGNE: AIGNE Framework 的主要执行引擎
-const aigne = new AIGNE({ model });
-
-// 使用 AIGNE 调用代理
-const userAgent = await aigne.invoke(agent);
-
-// 向代理发送消息
-const response = await userAgent.invoke(
-  "Hello, can you help me write a short article?",
-);
-console.log(response);
-```
-
-## 许可证
-
-Elastic-2.0