@aigne/cli 1.6.0 → 1.8.0

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## [1.8.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.7.0...cli-v1.8.0) (2025-04-27)
+
+
+### Features
+
+* 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
+
+* 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))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.12.0
+
+## [1.7.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.6.0...cli-v1.7.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))
+* **tests:** add example tests and update the ci configuration ([#81](https://github.com/AIGNE-io/aigne-framework/issues/81)) ([777bb8d](https://github.com/AIGNE-io/aigne-framework/commit/777bb8d184c21e74b3eb9bbb4a1003708409a338))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.11.0
+
 ## [1.6.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.5.1...cli-v1.6.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,135 @@
+# @aigne/cli
+
+[![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/cli)](https://www.npmjs.com/package/@aigne/cli)
+[![Elastic-2.0 licensed](https://img.shields.io/npm/l/@aigne/cli)](https://github.com/AIGNE-io/aigne-framework/blob/main/LICENSE)
+
+**English** | [中文](README.zh.md)
+
+Command-line tool for [AIGNE Framework](https://github.com/AIGNE-io/aigne-framework), providing convenient development and management capabilities.
+
+## Introduction
+
+`@aigne/cli` is the official command-line tool for [AIGNE Framework](https://github.com/AIGNE-io/aigne-framework), designed to simplify the development, testing, and deployment processes for AIGNE applications. It provides a series of useful commands to help developers quickly create projects, run agents, test code, and deploy applications.
+
+## Features
+
+- **Project Creation**: Quickly create new AIGNE projects with predefined file structures and configurations
+- **Agent Running**: Easily run and test AIGNE agents
+- **Testing Support**: Built-in test command for unit testing and integration testing
+- **MCP Services**: Support for launching agents as MCP servers for integration with external systems
+- **Interactive Interface**: Beautiful command-line interface providing an intuitive user experience
+- **Multi-model Support**: Support for OpenAI, Claude, XAI, and other model providers
+
+## Installation
+
+```bash
+# Using npm
+npm install -g @aigne/cli
+
+# Using yarn
+yarn global add @aigne/cli
+
+# Using pnpm
+pnpm add -g @aigne/cli
+```
+
+## Basic Commands
+
+AIGNE CLI provides the following main commands:
+
+```bash
+# Display help information
+aigne --help
+
+# Create a new project
+aigne create [path]
+
+# Run an agent
+aigne run [path]
+
+# Run tests
+aigne test [path]
+
+# Start MCP server
+aigne serve [path] --mcp
+```
+
+## Create Command
+
+Create a new AIGNE project with agent configuration files.
+
+```bash
+# Create a project in the current directory (will prompt for project name)
+aigne create
+
+# Create a project at the specified path
+aigne create my-project
+```
+
+The interactive creation process will ask for:
+- Project name
+- Project template (currently supports the default template)
+
+## Run Command
+
+Launch a chat loop with the specified agent.
+
+```bash
+# Run the agent in the current directory
+aigne run
+
+# Run the agent at the specified path
+aigne run path/to/agents
+
+# Run the agent from a remote URL
+aigne run https://example.com/aigne-project
+```
+
+Available options:
+- `--agent <agent>` - Specify the agent name to use (defaults to the first agent found)
+- `--download-dir <dir>` - Specify the directory to download the package to (used in URL mode)
+- `--model-provider <provider>` - Specify the model provider (openai, claude, xai)
+- `--model-name <model>` - Specify the model name
+- `--verbose` - Enable verbose logging
+
+## Test Command
+
+Run tests in the specified agents directory.
+
+```bash
+# Test the agents in the current directory
+aigne test
+
+# Test the agents at the specified path
+aigne test path/to/agents
+```
+
+## Serve Command
+
+Serve the agents in the specified directory as a MCP server.
+
+```bash
+# Start MCP server on default port 3000
+aigne serve --mcp
+
+# Start MCP server on specified port
+aigne serve --mcp --port 3001
+
+# Start MCP server for agents at specified path
+aigne serve path/to/agents --mcp
+```
+
+## Documentation
+
+For more detailed CLI usage guides, please refer to:
+
+- [CLI Guide](../../docs/cli.md)
+- [Agent Development Guide](../../docs/agent-development.md)
+- [Cookbook](../../docs/cookbook.md)
+
+## License
+
+Elastic-2.0

package/README.zh.md

@@ -0,0 +1,135 @@
+# @aigne/cli
+
+[![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/cli)](https://www.npmjs.com/package/@aigne/cli)
+[![Elastic-2.0 licensed](https://img.shields.io/npm/l/@aigne/cli)](https://github.com/AIGNE-io/aigne-framework/blob/main/LICENSE)
+
+[English](README.md) | **中文**
+
+[AIGNE 框架](https://github.com/AIGNE-io/aigne-framework)的命令行工具，提供便捷的开发和管理功能。
+
+## 简介
+
+`@aigne/cli` 是 [AIGNE 框架](https://github.com/AIGNE-io/aigne-framework)的官方命令行工具，旨在简化 AIGNE 应用的开发、测试和部署流程。它提供了一系列实用命令，帮助开发者快速创建项目、运行代理、测试代码，以及部署应用等。
+
+## 特性
+
+- **项目创建**：快速创建新的 AIGNE 项目，包含预设的文件结构和配置
+- **代理运行**：轻松运行和测试 AIGNE 代理
+- **测试支持**：内置测试命令，方便进行单元测试和集成测试
+- **MCP 服务**：支持将代理作为 MCP 服务器启动，与外部系统集成
+- **交互式界面**：美观的命令行界面，提供直观的使用体验
+- **多模型支持**：支持 OpenAI、Claude、XAI 等多种模型提供商
+
+## 安装
+
+```bash
+# 使用 npm
+npm install -g @aigne/cli
+
+# 使用 yarn
+yarn global add @aigne/cli
+
+# 使用 pnpm
+pnpm add -g @aigne/cli
+```
+
+## 基本命令
+
+AIGNE CLI 提供了以下主要命令：
+
+```bash
+# 显示帮助信息
+aigne --help
+
+# 创建新项目
+aigne create [path]
+
+# 运行代理
+aigne run [path]
+
+# 运行测试
+aigne test [path]
+
+# 启动 MCP 服务器
+aigne serve [path] --mcp
+```
+
+## 创建命令 (create)
+
+创建一个带有代理配置文件的新 AIGNE 项目。
+
+```bash
+# 在当前目录创建项目（会提示输入项目名称）
+aigne create
+
+# 在指定路径创建项目
+aigne create my-project
+```
+
+交互式创建过程会询问：
+- 项目名称
+- 项目模板（目前支持 default 模板）
+
+## 运行命令 (run)
+
+启动与指定代理的聊天循环。
+
+```bash
+# 运行当前目录中的代理
+aigne run
+
+# 运行指定路径中的代理
+aigne run path/to/agents
+
+# 运行远程 URL 中的代理
+aigne run https://example.com/aigne-project
+```
+
+可用选项：
+- `--agent <agent>` - 指定要使用的代理名称（默认为找到的第一个代理）
+- `--download-dir <dir>` - 指定下载包的目录（URL模式下使用）
+- `--model-provider <provider>` - 指定模型提供商（openai、claude、xai）
+- `--model-name <model>` - 指定模型名称
+- `--verbose` - 启用详细日志记录
+
+## 测试命令 (test)
+
+在指定的代理目录中运行测试。
+
+```bash
+# 测试当前目录中的代理
+aigne test
+
+# 测试指定路径中的代理
+aigne test path/to/agents
+```
+
+## 服务命令 (serve)
+
+将指定目录中的代理作为 MCP 服务器提供服务。
+
+```bash
+# 在默认端口 3000 启动 MCP 服务器
+aigne serve --mcp
+
+# 在指定端口启动 MCP 服务器
+aigne serve --mcp --port 3001
+
+# 为指定路径的代理启动 MCP 服务器
+aigne serve path/to/agents --mcp
+```
+
+## 文档
+
+更多详细的 CLI 使用指南，请参考：
+
+- [CLI 指南](../../docs/cli.zh.md)
+- [代理开发指南](../../docs/agent-development.zh.md)
+- [Cookbook](../../docs/cookbook.zh.md)
+
+## 协议
+
+Elastic-2.0

package/dist/commands/aigne.js

@@ -1,5 +1,5 @@
 import { Command } from "commander";
-import pkg from "../../package.json" with { type: "json" };
+import { AIGNE_CLI_VERSION } from "../constants.js";
 import { asciiLogo } from "../utils/ascii-logo.js";
 import { createCreateCommand } from "./create.js";
 import { createRunCommand } from "./run.js";
@@ -10,7 +10,7 @@ export function createAIGNECommand() {
     return new Command()
         .name("aigne")
         .description("CLI for AIGNE framework")
-        .version(pkg.version)
+        .version(AIGNE_CLI_VERSION)
         .addCommand(createRunCommand())
         .addCommand(createTestCommand())
         .addCommand(createCreateCommand())

package/dist/commands/run.js

@@ -2,7 +2,7 @@ import assert from "node:assert";
 import { cp, mkdir, rm } from "node:fs/promises";
 import { homedir } from "node:os";
 import { isAbsolute, join, resolve } from "node:path";
-import { ExecutionEngine } from "@aigne/core";
+import { AIGNE } from "@aigne/core";
 import { loadModel } from "@aigne/core/loader/index.js";
 import { logger } from "@aigne/core/utils/logger.js";
 import { isNonNullable } from "@aigne/core/utils/type-utils.js";
@@ -24,7 +24,7 @@ export function createRunCommand() {
         if (options.verbose)
             logger.enable("*");
         const { downloadDir, dir } = prepareDirs(path, options);
-        const { engine, agent } = await new Listr([
+        const { aigne, agent } = await new Listr([
             {
                 title: "Prepare environment",
                 task: (_, task) => {
@@ -43,30 +43,30 @@ export function createRunCommand() {
                 },
             },
             {
-                title: "Initialize execution engine",
+                title: "Initialize AIGNE",
                 task: async (ctx) => {
-                    const engine = await runEngine(dir, options);
-                    ctx.engine = engine;
+                    const aigne = await loadAIGNE(dir, options);
+                    ctx.aigne = aigne;
                 },
             },
             {
                 task: (ctx) => {
-                    const { engine } = ctx;
-                    assert(engine);
+                    const { aigne } = ctx;
+                    assert(aigne);
                     let agent;
                     if (options.agent) {
-                        agent = engine.agents[options.agent];
+                        agent = aigne.agents[options.agent];
                         if (!agent) {
                             console.error(`Agent "${options.agent}" not found in ${path}`);
                             console.log("Available agents:");
-                            for (const agent of engine.agents) {
+                            for (const agent of aigne.agents) {
                                 console.log(`- ${agent.name}`);
                             }
                             throw new Error(`Agent "${options.agent}" not found in ${path}`);
                         }
                     }
                     else {
-                        agent = engine.agents[0];
+                        agent = aigne.agents[0];
                         if (!agent)
                             throw new Error(`No agents found in ${path}`);
                     }
@@ -79,23 +79,23 @@ export function createRunCommand() {
                 timer: PRESET_TIMER,
             },
         }).run();
-        assert(engine);
+        assert(aigne);
         assert(agent);
-        const user = engine.call(agent);
+        const user = aigne.invoke(agent);
         await runChatLoopInTerminal(user);
-        await engine.shutdown();
+        await aigne.shutdown();
     })
         .showHelpAfterError(true)
         .showSuggestionAfterError(true);
 }
-async function runEngine(path, options) {
+async function loadAIGNE(path, options) {
     if (options.modelName && !options.modelProvider) {
         throw new Error("please specify --model-provider when using the --model-name option");
     }
     const model = options.modelProvider
         ? await loadModel({ provider: options.modelProvider, name: options.modelName })
         : undefined;
-    return await ExecutionEngine.load({ path, model });
+    return await AIGNE.load({ path, model });
 }
 async function downloadPackage(url, downloadDir) {
     await rm(downloadDir, { recursive: true, force: true });

package/dist/commands/serve.js

@@ -1,5 +1,5 @@
 import { isAbsolute, resolve } from "node:path";
-import { ExecutionEngine } from "@aigne/core";
+import { AIGNE } from "@aigne/core";
 import { tryOrThrow } from "@aigne/core/utils/type-utils.js";
 import { Command } from "commander";
 import { serveMCPServer } from "../utils/serve-mcp.js";
@@ -17,15 +17,23 @@ export function createServeCommand() {
         .description("Serve the agents in the specified directory as a MCP server")
         .argument("[path]", "Path to the agents directory", ".")
         .option("--mcp", "Serve the agents as a MCP server")
+        .option("--host <host>", "Host to run the MCP server on, use 0.0.0.0 to publicly expose the server", "localhost")
         .option("--port <port>", "Port to run the MCP server on", (s) => Number.parseInt(s))
+        .option("--pathname <pathname>", "Pathname to the service", "/mcp")
         .action(async (path, options) => {
         const absolutePath = isAbsolute(path) ? path : resolve(process.cwd(), path);
         const port = options.port || DEFAULT_PORT();
-        const engine = await ExecutionEngine.load({ path: absolutePath });
+        const aigne = await AIGNE.load({ path: absolutePath });
         if (options.mcp)
-            await serveMCPServer({ engine, port });
+            await serveMCPServer({
+                aigne,
+                host: options.host,
+                port,
+                pathname: options.pathname,
+            });
         else
             throw new Error("Default server is not supported yet. Please use --mcp option");
+        console.log(`MCP server is running on http://${options.host}:${port}${options.pathname}`);
     })
         .showHelpAfterError(true)
         .showSuggestionAfterError(true);

package/dist/constants.d.ts

@@ -0,0 +1 @@
+export declare const AIGNE_CLI_VERSION: string;

package/dist/constants.js

@@ -0,0 +1,2 @@
+import pkg from "../package.json" with { type: "json" };
+export const AIGNE_CLI_VERSION = pkg.version;

package/dist/tracer/terminal.d.ts

@@ -1,5 +1,4 @@
-import { type Agent, type Context, MESSAGE_KEY, type Message } from "@aigne/core";
-import type { ContextUsage } from "@aigne/core/execution-engine/usage";
+import { type Agent, type Context, type ContextUsage, MESSAGE_KEY, type Message } from "@aigne/core";
 import { type DefaultRenderer, Listr, type ListrRenderer, type ListrTaskWrapper } from "@aigne/listr2";
 import { promiseWithResolvers } from "../utils/promise-with-resolvers.js";
 export interface TerminalTracerOptions {

package/dist/tracer/terminal.js

@@ -28,7 +28,6 @@ export class TerminalTracer {
             },
         }, [], {
             concurrent: true,
-            forceTTY: true,
             rendererOptions: {
                 collapseSubtasks: false,
                 writeBottomBarDirectly: true,
@@ -100,7 +99,7 @@ export class TerminalTracer {
         context.on("agentSucceed", onAgentSucceed);
         context.on("agentFailed", onAgentFailed);
         try {
-            const stream = await context.call(agent, input, { streaming: true });
+            const stream = await context.invoke(agent, input, { streaming: true });
             const result = await listr.run(stream);
             return { result, context };
         }
@@ -130,7 +129,7 @@ export class TerminalTracer {
         return chalk.grey(`[${parseDuration(duration)}]`);
     }
     formatTaskTitle(agent, { task, usage, time } = {}) {
-        let title = `call agent ${agent.name}`;
+        let title = `invoke agent ${agent.name}`;
         if (usage && task?.usage)
             title += ` ${this.formatTokenUsage(task.usage, task.extraTitleMetadata)}`;
         if (time && task?.startTime && task.endTime)

package/dist/utils/agent-v1.js

@@ -43,15 +43,15 @@ async function loadAgentV1Package(path) {
     return definition;
 }
 function assistantToAigneV2(agent, project) {
-    const converter = RUNNABLE_MAP[agent.type];
+    const converter = AGENT_MAP[agent.type];
     if (!converter)
-        throw new Error(`Unsupported runnable type: ${agent.type}`);
+        throw new Error(`Unsupported agent type: ${agent.type}`);
     return converter(agent, project);
 }
-const RUNNABLE_MAP = {
+const AGENT_MAP = {
     prompt: (agent) => {
         if (agent.type !== "prompt")
-            throw new Error(`Expected runnable type 'prompt', but got '${agent.type}'`);
+            throw new Error(`Expected agent type 'prompt', but got '${agent.type}'`);
         const obj = {
             name: agent.name || agent.id,
             description: agent.description,
@@ -68,7 +68,7 @@ const RUNNABLE_MAP = {
     },
     function: async (agent) => {
         if (agent.type !== "function")
-            throw new Error(`Expected runnable type 'function', but got '${agent.type}'`);
+            throw new Error(`Expected agent type 'function', but got '${agent.type}'`);
         const inputNames = agent.parameters?.map((i) => i.key).filter(Boolean) ?? [];
         return {
             content: await formatCode(`\
@@ -88,7 +88,7 @@ agent.output_schema = ${JSON.stringify(convertOutputSchema(agent))};
     },
     router: (agent, project) => {
         if (agent.type !== "router")
-            throw new Error(`Expected runnable type 'router', but got '${agent.type}'`);
+            throw new Error(`Expected agent type 'router', but got '${agent.type}'`);
         return {
             content: stringify({
                 name: agent.name || agent.id,
@@ -96,7 +96,7 @@ agent.output_schema = ${JSON.stringify(convertOutputSchema(agent))};
                 instructions: agent.prompt,
                 input_schema: convertInputSchema(agent),
                 output_schema: convertOutputSchema(agent),
-                tools: agent.routes?.map((i) => {
+                skills: agent.routes?.map((i) => {
                     const tool = project.agents.find((j) => j.id === i.id);
                     if (!tool)
                         throw new Error(`Tool ${i.id} not found in project definition`);

package/dist/utils/serve-mcp.d.ts

@@ -1,5 +1,9 @@
-import { type ExecutionEngine } from "@aigne/core";
-export declare function serveMCPServer({ engine, port }: {
-    engine: ExecutionEngine;
+import { type AIGNE } from "@aigne/core";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function serveMCPServer({ pathname, aigne, host, port, }: {
+    pathname?: string;
+    aigne: AIGNE;
+    host?: string;
     port: number;
 }): Promise<import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>>;
+export declare function createMcpServer(aigne: AIGNE): McpServer;

package/dist/utils/serve-mcp.js

@@ -1,23 +1,83 @@
 import { getMessage } from "@aigne/core";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
-import express from "express";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import express, { Router, json } from "express";
 import { ZodObject } from "zod";
+import { AIGNE_CLI_VERSION } from "../constants.js";
 import { promiseWithResolvers } from "./promise-with-resolvers.js";
-export async function serveMCPServer({ engine, port }) {
+export async function serveMCPServer({ pathname = "/mcp", aigne, host = "localhost", port, }) {
+    const app = express();
+    app.use(json());
+    const router = Router();
+    app.use(router);
+    router.post(pathname, async (req, res) => {
+        try {
+            const server = createMcpServer(aigne);
+            const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+            await server.connect(transport);
+            await transport.handleRequest(req, res, req.body);
+            res.on("close", async () => {
+                await transport.close();
+                await server.close();
+            });
+        }
+        catch (error) {
+            console.error("Error handling MCP request:", error);
+            if (!res.headersSent) {
+                res.status(500).json({
+                    jsonrpc: "2.0",
+                    error: {
+                        code: -32603,
+                        message: error.message,
+                    },
+                    id: null,
+                });
+            }
+        }
+    });
+    router.get(pathname, async (_, res) => {
+        res.writeHead(405).end(JSON.stringify({
+            jsonrpc: "2.0",
+            error: {
+                code: -32000,
+                message: "Method not allowed.",
+            },
+            id: null,
+        }));
+    });
+    router.delete(pathname, async (_, res) => {
+        res.writeHead(405).end(JSON.stringify({
+            jsonrpc: "2.0",
+            error: {
+                code: -32000,
+                message: "Method not allowed.",
+            },
+            id: null,
+        }));
+    });
+    const { promise, resolve, reject } = promiseWithResolvers();
+    const httpServer = app.listen(port, host, (error) => {
+        if (error)
+            reject(error);
+        resolve();
+    });
+    await promise;
+    return httpServer;
+}
+export function createMcpServer(aigne) {
     const server = new McpServer({
-        name: engine.name || "aigne-mcp-server",
-        version: "1.0.0",
+        name: aigne.name || "aigne-mcp-server",
+        version: AIGNE_CLI_VERSION,
     }, {
         capabilities: { tools: {} },
-        instructions: engine.description,
+        instructions: aigne.description,
     });
-    for (const agent of engine.agents) {
+    for (const agent of aigne.agents) {
         const schema = agent.inputSchema;
         if (!(schema instanceof ZodObject))
             throw new Error("Agent input schema must be a ZodObject");
         server.tool(agent.name, agent.description || "", schema.shape, async (input) => {
-            const result = await engine.call(agent, input);
+            const result = await aigne.invoke(agent, input);
             return {
                 content: [
                     {
@@ -28,45 +88,5 @@ export async function serveMCPServer({ engine, port }) {
             };
         });
     }
-    const app = express();
-    const transports = {};
-    app.get("/sse", async (req, res) => {
-        const transport = new SSEServerTransport("/messages", res);
-        transports[transport.sessionId] = transport;
-        req.on("close", () => {
-            delete transports[transport.sessionId];
-        });
-        await server.connect(transport);
-    });
-    app.post("/messages", async (req, res) => {
-        const sessionId = req.query.sessionId;
-        const transport = transports[sessionId];
-        if (transport) {
-            await transport.handlePostMessage(req, res);
-        }
-        else {
-            throw new HttpError(400, "No transport found for sessionId");
-        }
-    });
-    app.use(((error, _req, res, _next) => {
-        console.error("handle route error", { error });
-        res
-            .status(error instanceof HttpError ? error.status : 500)
-            .json({ error: { message: error.message } });
-    }));
-    const { promise, resolve, reject } = promiseWithResolvers();
-    const httpServer = app.listen(port, (error) => {
-        if (error)
-            reject(error);
-        resolve();
-    });
-    await promise;
-    return httpServer;
-}
-class HttpError extends Error {
-    status;
-    constructor(status, message) {
-        super(message);
-        this.status = status;
-    }
+    return server;
 }

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@aigne/cli",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "cli for AIGNE framework",
   "publishConfig": {
     "access": "public"
   },
   "author": "Arcblock <blocklet@arcblock.io> https://github.com/blocklet",
   "homepage": "https://github.com/AIGNE-io/aigne-framework",
-  "license": "ISC",
+  "license": "Elastic-2.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/AIGNE-io/aigne-framework"
@@ -50,7 +50,7 @@
     "pretty-error": "^4.0.0",
     "tar": "^7.4.3",
     "zod": "^3.24.2",
-    "@aigne/core": "^1.10.0"
+    "@aigne/core": "^1.12.0"
   },
   "devDependencies": {
     "@types/archiver": "^6.0.3",

package/templates/default/README.md

@@ -5,7 +5,7 @@ This is the default project template for the Aigne framework, providing a basic
 ## Template Structure
 
 - `aigne.yaml` - Project configuration file that defines the chat model used and references to agents
-- `chat.yaml` - Chat agent configuration, including agent instructions and tools used
+- `chat.yaml` - Chat agent configuration, including agent instructions and skills used
 - `sandbox.js` - JavaScript code execution tool for running JavaScript code within conversations
 - `sandbox.test.js` - Test file to verify the functionality of the code execution tool
 

package/templates/default/chat.yaml

@@ -3,5 +3,6 @@ description: Chat agent
 instructions: |
   You are a helpful assistant that can answer questions and provide information on a wide range of topics.
   Your goal is to assist users in finding the information they need and to engage in friendly conversation.
+memory: true
 tools:
   - sandbox.js