@aigne/core 1.10.0 → 1.12.0

package/CHANGELOG.md

@@ -22,6 +22,34 @@
 * rename @aigne/core-next to @aigne/core ([3a81009](https://github.com/AIGNE-io/aigne-framework/commit/3a8100962c81813217b687ae28e8de604419c622))
 * use text resource from MCP correctly ([8b9eba8](https://github.com/AIGNE-io/aigne-framework/commit/8b9eba83352ec096a2a5d4f410d4c4bde7420bce))
 
+## [1.12.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.11.0...core-v1.12.0) (2025-04-27)
+
+
+### Features
+
+* add AIGNEServer/AIGNEClient api to serve agents via network ([#96](https://github.com/AIGNE-io/aigne-framework/issues/96)) ([1f2dfa3](https://github.com/AIGNE-io/aigne-framework/commit/1f2dfa3a6a2568373063cea3c874b573d0a248d3))
+* **core:** support streamable http transport for mcp agents ([#92](https://github.com/AIGNE-io/aigne-framework/issues/92)) ([37da490](https://github.com/AIGNE-io/aigne-framework/commit/37da490538298d882ec328e4b3304395a6cd8cf7))
+* support TeamAgent and finalize API naming ([#91](https://github.com/AIGNE-io/aigne-framework/issues/91)) ([033d1b6](https://github.com/AIGNE-io/aigne-framework/commit/033d1b6a7dc5460807476abb35a413ba89a2a664))
+
+
+### Bug Fixes
+
+* **core:** prioritize self model before falling back to context ([#97](https://github.com/AIGNE-io/aigne-framework/issues/97)) ([2a3d067](https://github.com/AIGNE-io/aigne-framework/commit/2a3d067442200657d8ef3b5314930cc14302f6bf))
+* upgrade to streamable api for serve mcp command ([#98](https://github.com/AIGNE-io/aigne-framework/issues/98)) ([ae32bda](https://github.com/AIGNE-io/aigne-framework/commit/ae32bda20e57c2a2eb8b49fad034b0b2a5ebb15e))
+
+## [1.11.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.10.0...core-v1.11.0) (2025-04-23)
+
+
+### Features
+
+* **core:** enhance ClaudeChatModel to support streaming responses ([#85](https://github.com/AIGNE-io/aigne-framework/issues/85)) ([5433240](https://github.com/AIGNE-io/aigne-framework/commit/5433240e7b663ec9e9f4a79dffa05038088d54fc))
+* support set memory in agent yaml ([#90](https://github.com/AIGNE-io/aigne-framework/issues/90)) ([215118f](https://github.com/AIGNE-io/aigne-framework/commit/215118f1dc55f02322d59a3f18395a459198e031))
+
+
+### Bug Fixes
+
+* **core:** router model should support streaming response ([#88](https://github.com/AIGNE-io/aigne-framework/issues/88)) ([4fb4d92](https://github.com/AIGNE-io/aigne-framework/commit/4fb4d92f8b36011437efba3265591b2477f2d680))
+
 ## [1.10.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.9.0...core-v1.10.0) (2025-04-22)
 
 

package/LICENSE

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/README.md

@@ -0,0 +1,90 @@
+# @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.zh.md)
+
+Core library of [AIGNE Framework](https://github.com/AIGNE-io/aigne-framework) for building AI-powered applications.
+
+## Introduction
+
+`@aigne/core` is the foundation component of [AIGNE Framework](https://github.com/AIGNE-io/aigne-framework), providing the essential modules and tools needed to build AI-driven applications. This package implements the core functionalities of the framework, including agent systems, aigne environment, model integrations, and workflow pattern support.
+
+## Features
+
+- **Multiple AI Model Support**: Built-in support for OpenAI, Gemini, Claude, and other mainstream AI models, easily extensible to support additional models
+- **Agent System**: Powerful agent abstractions supporting AI agents, function agents, MCP agents, and more
+- **AIGNE Environment**: Flexible handling communication between agents and workflow execution
+- **Workflow Patterns**: Support for sequential, concurrent, routing, handoff, and other workflow patterns
+- **MCP Protocol Integration**: Seamless integration with external systems through the Model Context Protocol
+- **TypeScript Support**: Comprehensive type definitions providing an excellent development experience
+
+## Installation
+
+```bash
+# Using npm
+npm install @aigne/core
+
+# Using yarn
+yarn add @aigne/core
+
+# Using pnpm
+pnpm add @aigne/core
+```
+
+## Basic Usage
+
+```typescript
+import { AIAgent, AIGNE } from "@aigne/core";
+import { OpenAIChatModel } from "@aigne/core/models/openai-chat-model.js";
+
+// Create AI model instance
+const model = new OpenAIChatModel({
+  apiKey: process.env.OPENAI_API_KEY,
+  model: process.env.DEFAULT_CHAT_MODEL || "gpt-4-turbo",
+});
+
+// Create AI agent
+const agent = AIAgent.from({
+  name: "Assistant",
+  instructions: "You are a helpful assistant.",
+});
+
+// Create AIGNE
+const aigne = new AIGNE({ model });
+
+// Use the AIGNE to invoke the agent
+const userAgent = await aigne.invoke(agent);
+
+// Send a message to the agent
+const response = await userAgent.invoke("Hello, can you help me write a short article?");
+console.log(response);
+```
+
+## Module Structure
+
+- `agents/`: Agent implementations, including AI agents, function agents, MCP agents, etc.
+- `aigne/`: AIGNE is agents execution environment
+- `loader/`: Loader-related functionality
+- `models/`: Integration with various AI models
+- `prompt/`: Prompt handling functionality
+- `utils/`: Utility functions and helper methods
+
+## Documentation
+
+For more detailed API documentation, please refer to:
+
+- [Agent API](../../docs/apis/agent-api.md)
+- [AI Agent API](../../docs/apis/ai-agent-api.md)
+- [Function Agent API](../../docs/apis/function-agent-api.md)
+- [MCP Agent API](../../docs/apis/mcp-agent-api.md)
+- [AIGNE API](../../docs/apis/aigne-api.md)
+- [Server/Client API](../../docs/apis/server-client-api.md)
+
+## License
+
+Elastic-2.0

package/README.zh.md

@@ -0,0 +1,90 @@
+# @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 框架](https://github.com/AIGNE-io/aigne-framework)的核心库，用于构建 AI 驱动的应用程序。
+
+## 简介
+
+`@aigne/core` 是 [AIGNE 框架](https://github.com/AIGNE-io/aigne-framework)的基础核心组件，提供了构建 AI 驱动应用程序所需的基本模块和工具。该包实现了框架的核心功能，包括代理系统、执行引擎、模型集成以及工作流模式支持等。
+
+## 特性
+
+- **多种 AI 模型支持**：内置支持 OpenAI、Gemini、Claude 等主流 AI 模型，可轻松扩展支持其他模型
+- **代理系统**：强大的代理抽象，支持 AI 代理、函数代理、MCP 代理等多种类型
+- **执行引擎**：灵活的执行引擎，处理代理之间的通信和工作流执行
+- **工作流模式**：支持顺序、并发、路由、交接等多种工作流模式
+- **MCP 协议集成**：通过模型上下文协议（Model Context Protocol）实现与外部系统的无缝集成
+- **TypeScript 支持**：完善的类型定义，提供良好的开发体验
+
+## 安装
+
+```bash
+# 使用 npm
+npm install @aigne/core
+
+# 使用 yarn
+yarn add @aigne/core
+
+# 使用 pnpm
+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: "助手",
+  instructions: "你是一个有帮助的助手。",
+});
+
+// 创建执行引擎
+const aigne = new AIGNE({ model });
+
+// 使用执行引擎调用代理
+const userAgent = await aigne.invoke(agent);
+
+// 向代理发送消息
+const response = await userAgent.invoke("你好，能帮我写一篇短文吗？");
+console.log(response);
+```
+
+## 模块结构
+
+- `agents/`: 代理相关的实现，包括 AI 代理、函数代理、MCP 代理等
+- `aigne/`: AIGNE 提供 Agents 执行环境
+- `loader/`: 加载器相关功能
+- `models/`: 各种 AI 模型的集成
+- `prompt/`: 提示词处理相关功能
+- `utils/`: 工具函数和辅助方法
+
+## 文档
+
+更多详细的 API 文档，请参考：
+
+- [Agent API](../../docs/apis/agent-api.zh.md)
+- [AI Agent API](../../docs/apis/ai-agent-api.zh.md)
+- [Function Agent API](../../docs/apis/function-agent-api.zh.md)
+- [MCP Agent API](../../docs/apis/mcp-agent-api.zh.md)
+- [AIGNE API](../../docs/apis/aigne-api.zh.md)
+- [服务器/客户端 API](../../docs/apis/server-client-api.zh.md)
+
+## 协议
+
+Elastic-2.0

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

@@ -1,6 +1,6 @@
 import { inspect } from "node:util";
 import { type ZodType } from "zod";
-import type { Context } from "../execution-engine/context.js";
+import type { Context } from "../aigne/context.js";
 import { type Nullish, type PromiseOrValue } from "../utils/type-utils.js";
 import { AgentMemory, type AgentMemoryOptions } from "./memory.js";
 import { type TransferAgentOutput } from "./types.js";
@@ -15,11 +15,11 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
     inputSchema?: AgentInputOutputSchema<I>;
     outputSchema?: AgentInputOutputSchema<O>;
     includeInputInOutput?: boolean;
-    tools?: (Agent | FunctionAgentFn)[];
+    skills?: (Agent | FunctionAgentFn)[];
     disableEvents?: boolean;
     memory?: AgentMemory | AgentMemoryOptions | true;
 }
-export interface AgentCallOptions {
+export interface AgentInvokeOptions {
     streaming?: boolean;
 }
 export declare abstract class Agent<I extends Message = Message, O extends Message = Message> {
@@ -38,52 +38,53 @@ export declare abstract class Agent<I extends Message = Message, O extends Messa
     readonly includeInputInOutput?: boolean;
     readonly subscribeTopic?: SubscribeTopic;
     readonly publishTopic?: PublishTopic<Message>;
-    readonly tools: Agent<Message, Message>[] & {
+    readonly skills: Agent<Message, Message>[] & {
         [key: string]: Agent<Message, Message>;
     };
     private disableEvents?;
     /**
      * Attach agent to context:
-     * - subscribe to topic and call process method when message received
+     * - subscribe to topic and invoke process method when message received
      * - subscribe to memory topic if memory is enabled
      * @param context Context to attach
      */
     attach(context: Pick<Context, "subscribe">): void;
-    addTool<I extends Message, O extends Message>(tool: Agent<I, O> | FunctionAgentFn<I, O>): void;
-    get isCallable(): boolean;
+    addSkill(...skills: (Agent | FunctionAgentFn)[]): void;
+    get isInvokable(): boolean;
     private checkContextStatus;
     private newDefaultContext;
-    call(input: I | string, context: Context | undefined, options: AgentCallOptions & {
+    invoke(input: I | string, context: Context | undefined, options: AgentInvokeOptions & {
         streaming: true;
     }): Promise<AgentResponseStream<O>>;
-    call(input: I | string, context?: Context, options?: AgentCallOptions & {
+    invoke(input: I | string, context?: Context, options?: AgentInvokeOptions & {
         streaming?: false;
     }): Promise<O>;
-    call(input: I | string, context?: Context, options?: AgentCallOptions): Promise<AgentResponse<O>>;
+    invoke(input: I | string, context?: Context, options?: AgentInvokeOptions): Promise<AgentResponse<O>>;
     private processAgentOutput;
     private processAgentError;
-    protected checkUsageAgentCalls(context: Context): void;
+    protected checkAgentInvokesUsage(context: Context): void;
     protected preprocess(_: I, context: Context): void;
     protected postprocess(input: I, output: O, context: Context): void;
-    abstract process(input: I, context: Context, options?: AgentCallOptions): AgentProcessResult<O | TransferAgentOutput>;
+    abstract process(input: I, context: Context, options?: AgentInvokeOptions): PromiseOrValue<AgentProcessResult<O>>;
     shutdown(): Promise<void>;
     [inspect.custom](): string;
 }
-export type AgentResponse<T> = T | AgentResponseStream<T>;
+export type AgentResponse<T> = T | TransferAgentOutput | AgentResponseStream<T>;
 export type AgentResponseStream<T> = ReadableStream<AgentResponseChunk<T>>;
 export type AgentResponseChunk<T> = AgentResponseDelta<T>;
+export declare function isEmptyChunk<T>(chunk: AgentResponseChunk<T>): boolean;
 export interface AgentResponseDelta<T> {
     delta: {
         text?: Partial<{
             [key in keyof T as Extract<T[key], string> extends string ? key : never]: string;
-        }> | {
+        }> | Partial<{
             [key: string]: string;
-        };
-        json?: Partial<T>;
+        }>;
+        json?: Partial<T | TransferAgentOutput>;
     };
 }
-export type AgentProcessAsyncGenerator<O extends Message> = AsyncGenerator<AgentResponseChunk<O>, Partial<O> | undefined | void>;
-export type AgentProcessResult<O extends Message> = Promise<AgentResponse<O>> | AgentProcessAsyncGenerator<O>;
+export type AgentProcessAsyncGenerator<O extends Message> = AsyncGenerator<AgentResponseChunk<O>, Partial<O | TransferAgentOutput> | undefined | void>;
+export type AgentProcessResult<O extends Message> = AgentResponse<O> | AgentProcessAsyncGenerator<O> | Agent;
 export type AgentInputOutputSchema<I extends Message = Message> = ZodType<I> | ((agent: Agent) => ZodType<I>);
 export interface FunctionAgentOptions<I extends Message = Message, O extends Message = Message> extends AgentOptions<I, O> {
     fn?: FunctionAgentFn<I, O>;
@@ -92,6 +93,6 @@ export declare class FunctionAgent<I extends Message = Message, O extends Messag
     static from<I extends Message, O extends Message>(options: FunctionAgentOptions<I, O> | FunctionAgentFn<I, O>): FunctionAgent<I, O>;
     constructor(options: FunctionAgentOptions<I, O>);
     fn: FunctionAgentFn<I, O>;
-    process(input: I, context: Context, options?: AgentCallOptions): Promise<AgentResponse<O | TransferAgentOutput>>;
+    process(input: I, context: Context): PromiseOrValue<AgentProcessResult<O>>;
 }
-export type FunctionAgentFn<I extends Message = Message, O extends Message = Message> = (input: I, context: Context) => O | Promise<O> | Agent | Promise<Agent>;
+export type FunctionAgentFn<I extends Message = any, O extends Message = any> = (input: I, context: Context) => PromiseOrValue<AgentProcessResult<O>>;

package/lib/cjs/agents/agent.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FunctionAgent = exports.Agent = void 0;
+exports.isEmptyChunk = isEmptyChunk;
 const node_util_1 = require("node:util");
 const zod_1 = require("zod");
 const prompt_builder_js_1 = require("../prompt/prompt-builder.js");
@@ -55,8 +56,8 @@ class Agent {
         this.includeInputInOutput = options.includeInputInOutput;
         this.subscribeTopic = options.subscribeTopic;
         this.publishTopic = options.publishTopic;
-        if (options.tools?.length)
-            this.tools.push(...options.tools.map(functionToAgent));
+        if (options.skills?.length)
+            this.skills.push(...options.skills.map(functionToAgent));
         this.disableEvents = options.disableEvents;
         if (options.memory) {
             this.memory =
@@ -93,11 +94,11 @@ class Agent {
     includeInputInOutput;
     subscribeTopic;
     publishTopic;
-    tools = (0, type_utils_js_1.createAccessorArray)([], (arr, name) => arr.find((t) => t.name === name));
+    skills = (0, type_utils_js_1.createAccessorArray)([], (arr, name) => arr.find((t) => t.name === name));
     disableEvents;
     /**
      * Attach agent to context:
-     * - subscribe to topic and call process method when message received
+     * - subscribe to topic and invoke process method when message received
      * - subscribe to memory topic if memory is enabled
      * @param context Context to attach
      */
@@ -106,7 +107,7 @@ class Agent {
         for (const topic of (0, type_utils_js_1.orArrayToArray)(this.subscribeTopic).concat(this.topic)) {
             context.subscribe(topic, async ({ message, context }) => {
                 try {
-                    await context.call(this, message);
+                    await context.invoke(this, message);
                 }
                 catch (error) {
                     context.emit("agentFailed", { agent: this, error });
@@ -114,34 +115,37 @@ class Agent {
             });
         }
     }
-    addTool(tool) {
-        this.tools.push(typeof tool === "function" ? functionToAgent(tool) : tool);
+    addSkill(...skills) {
+        this.skills.push(...skills.map((skill) => (typeof skill === "function" ? functionToAgent(skill) : skill)));
     }
-    get isCallable() {
+    get isInvokable() {
         return !!this.process;
     }
     checkContextStatus(context) {
         if (context) {
             const { status } = context;
             if (status === "timeout") {
-                throw new Error(`ExecutionEngine for agent ${this.name} has timed out`);
+                throw new Error(`AIGNE for agent ${this.name} has timed out`);
             }
         }
     }
     async newDefaultContext() {
-        return Promise.resolve().then(() => __importStar(require("../execution-engine/context.js"))).then((m) => new m.ExecutionContext());
+        return Promise.resolve().then(() => __importStar(require("../aigne/context.js"))).then((m) => new m.AIGNEContext());
     }
-    async call(input, context, options) {
+    async invoke(input, context, options) {
         const ctx = context ?? (await this.newDefaultContext());
         const message = typeof input === "string" ? (0, prompt_builder_js_1.createMessage)(input) : input;
-        logger_js_1.logger.core("Call agent %s started with input: %O", this.name, input);
+        logger_js_1.logger.core("Invoke agent %s started with input: %O", this.name, input);
         if (!this.disableEvents)
             ctx.emit("agentStarted", { agent: this, input: message });
         try {
             const parsedInput = (0, type_utils_js_1.checkArguments)(`Agent ${this.name} input`, this.inputSchema, message);
             this.preprocess(parsedInput, ctx);
             this.checkContextStatus(ctx);
-            const response = await this.process(parsedInput, ctx, options);
+            let response = await this.process(parsedInput, ctx, options);
+            if (response instanceof Agent) {
+                response = (0, types_js_1.transferToAgentOutput)(response);
+            }
             if (options?.streaming) {
                 const stream = response instanceof ReadableStream
                     ? response
@@ -175,27 +179,27 @@ class Agent {
         const parsedOutput = (0, type_utils_js_1.checkArguments)(`Agent ${this.name} output`, this.outputSchema, output);
         const finalOutput = this.includeInputInOutput ? { ...input, ...parsedOutput } : parsedOutput;
         this.postprocess(input, finalOutput, context);
-        logger_js_1.logger.core("Call agent %s succeed with output: %O", this.name, finalOutput);
+        logger_js_1.logger.core("Invoke agent %s succeed with output: %O", this.name, finalOutput);
         if (!this.disableEvents)
             context.emit("agentSucceed", { agent: this, output: finalOutput });
         return finalOutput;
     }
     processAgentError(error, context) {
-        logger_js_1.logger.core("Call agent %s failed with error: %O", this.name, error);
+        logger_js_1.logger.core("Invoke agent %s failed with error: %O", this.name, error);
         if (!this.disableEvents)
             context.emit("agentFailed", { agent: this, error });
         throw error;
     }
-    checkUsageAgentCalls(context) {
+    checkAgentInvokesUsage(context) {
         const { limits, usage } = context;
-        if (limits?.maxAgentCalls && usage.agentCalls >= limits.maxAgentCalls) {
-            throw new Error(`Exceeded max agent calls ${usage.agentCalls}/${limits.maxAgentCalls}`);
+        if (limits?.maxAgentInvokes && usage.agentCalls >= limits.maxAgentInvokes) {
+            throw new Error(`Exceeded max agent invokes ${usage.agentCalls}/${limits.maxAgentInvokes}`);
         }
         usage.agentCalls++;
     }
     preprocess(_, context) {
         this.checkContextStatus(context);
-        this.checkUsageAgentCalls(context);
+        this.checkAgentInvokesUsage(context);
     }
     postprocess(input, output, context) {
         this.checkContextStatus(context);
@@ -214,9 +218,12 @@ class Agent {
     }
 }
 exports.Agent = Agent;
+function isEmptyChunk(chunk) {
+    return (0, type_utils_js_1.isEmpty)(chunk.delta.json) && (0, type_utils_js_1.isEmpty)(chunk.delta.text);
+}
 function checkAgentInputOutputSchema(schema) {
     if (!(schema instanceof zod_1.ZodObject) && typeof schema !== "function") {
-        throw new Error("schema must be a zod object or function return a zod object ");
+        throw new Error(`schema must be a zod object or function return a zod object, got: ${typeof schema}`);
     }
 }
 class FunctionAgent extends Agent {
@@ -228,12 +235,8 @@ class FunctionAgent extends Agent {
         this.fn = options.fn ?? (() => ({}));
     }
     fn;
-    async process(input, context, options) {
-        let result = await this.fn(input, context);
-        if (result instanceof Agent) {
-            result = (0, types_js_1.transferToAgentOutput)(result);
-        }
-        return options?.streaming ? (0, stream_utils_js_1.objectToAgentResponseStream)(result) : result;
+    process(input, context) {
+        return this.fn(input, context);
     }
 }
 exports.FunctionAgent = FunctionAgent;

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

@@ -1,9 +1,9 @@
 import { z } from "zod";
-import type { Context } from "../execution-engine/context.js";
+import type { Context } from "../aigne/context.js";
 import { ChatModel } from "../models/chat-model.js";
+import type { ChatModelInput } from "../models/chat-model.js";
 import { PromptBuilder } from "../prompt/prompt-builder.js";
 import { Agent, type AgentOptions, type AgentProcessAsyncGenerator, type Message } from "./agent.js";
-import { type TransferAgentOutput } from "./types.js";
 export interface AIAgentOptions<I extends Message = Message, O extends Message = Message> extends AgentOptions<I, O> {
     model?: ChatModel;
     instructions?: string | PromptBuilder;
@@ -24,18 +24,18 @@ export declare const aiAgentOptionsSchema: z.ZodObject<{
     publishTopic: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">, z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>]>>;
     name: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
-    tools: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodType<Agent<Message, Message>, z.ZodTypeDef, Agent<Message, Message>>, z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>]>, "many">>;
+    skills: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodType<Agent<Message, Message>, z.ZodTypeDef, Agent<Message, Message>>, z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>]>, "many">>;
     disableLogging: z.ZodOptional<z.ZodBoolean>;
     memory: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodAny, z.ZodAny]>>;
 }, "strip", z.ZodTypeAny, {
     description?: string | undefined;
     memory?: any;
+    name?: string | undefined;
     includeInputInOutput?: boolean | undefined;
     subscribeTopic?: string | string[] | undefined;
     publishTopic?: string | string[] | ((...args: unknown[]) => unknown) | undefined;
-    tools?: (Agent<Message, Message> | ((...args: unknown[]) => unknown))[] | undefined;
+    skills?: (Agent<Message, Message> | ((...args: unknown[]) => unknown))[] | undefined;
     toolChoice?: Agent<Message, Message> | "auto" | "none" | "required" | "router" | undefined;
-    name?: string | undefined;
     model?: ChatModel | undefined;
     instructions?: string | PromptBuilder | undefined;
     outputKey?: string | undefined;
@@ -45,12 +45,12 @@ export declare const aiAgentOptionsSchema: z.ZodObject<{
 }, {
     description?: string | undefined;
     memory?: any;
+    name?: string | undefined;
     includeInputInOutput?: boolean | undefined;
     subscribeTopic?: string | string[] | undefined;
     publishTopic?: string | string[] | ((...args: unknown[]) => unknown) | undefined;
-    tools?: (Agent<Message, Message> | ((...args: unknown[]) => unknown))[] | undefined;
+    skills?: (Agent<Message, Message> | ((...args: unknown[]) => unknown))[] | undefined;
     toolChoice?: Agent<Message, Message> | "auto" | "none" | "required" | "router" | undefined;
-    name?: string | undefined;
     model?: ChatModel | undefined;
     instructions?: string | PromptBuilder | undefined;
     outputKey?: string | undefined;
@@ -65,5 +65,6 @@ export declare class AIAgent<I extends Message = Message, O extends Message = Me
     instructions: PromptBuilder;
     outputKey?: string;
     toolChoice?: AIAgentToolChoice;
-    process(input: I, context: Context): AgentProcessAsyncGenerator<O | TransferAgentOutput>;
+    process(input: I, context: Context): AgentProcessAsyncGenerator<O>;
+    processRouter(input: I, model: ChatModel, modelInput: ChatModelInput, context: Context, toolsMap: Map<string, Agent>): AgentProcessAsyncGenerator<O>;
 }