@aigne/cli 1.18.1 → 1.19.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## [1.19.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.18.1...cli-v1.19.0) (2025-07-01)
+
+
+### Features
+
+* rename command serve to serve-mcp ([#206](https://github.com/AIGNE-io/aigne-framework/issues/206)) ([f3dfc93](https://github.com/AIGNE-io/aigne-framework/commit/f3dfc932b4eeb8ff956bf2d4b1b71b36bd05056e))
+
+
+### Bug Fixes
+
+* fix: compatible with node 20.0 & polish example defintions ([#209](https://github.com/AIGNE-io/aigne-framework/issues/209)) ([9752b96](https://github.com/AIGNE-io/aigne-framework/commit/9752b96dc54a44c6f710f056fe9205c0f2b0a73e))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/agent-library bumped to 1.17.7
+    * @aigne/anthropic bumped to 0.5.2
+    * @aigne/bedrock bumped to 0.5.2
+    * @aigne/core bumped to 1.28.2
+    * @aigne/deepseek bumped to 0.4.2
+    * @aigne/gemini bumped to 0.4.2
+    * @aigne/observability-api bumped to 0.3.2
+    * @aigne/ollama bumped to 0.4.2
+    * @aigne/open-router bumped to 0.4.2
+    * @aigne/openai bumped to 0.6.2
+    * @aigne/xai bumped to 0.4.2
+
 ## [1.18.1](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.18.0...cli-v1.18.1) (2025-07-01)
 
 

package/README.md

@@ -61,7 +61,7 @@ aigne run --path xxx
 aigne test --path xxx
 
 # Start MCP server
-aigne serve --path xxx --mcp
+aigne serve-mcp --path xxx
 
 # Start observability server
 aigne observe [option]
@@ -121,19 +121,19 @@ aigne test
 aigne test path/to/agents
 ```
 
-## Serve Command
+## Serve MCP Command
 
 Serve the agents in the specified directory as a MCP server.
 
 ```bash
 # Start MCP server on default port 3000
-aigne serve --mcp
+aigne serve-mcp
 
 # Start MCP server on specified port
-aigne serve --mcp --port 3001
+aigne serve-mcp --port 3001
 
 # Start MCP server for agents at specified path
-aigne serve --path path/to/agents --mcp
+aigne serve-mcp --path path/to/agents
 ```
 
 ## Serve Command (observability)

package/README.zh.md

@@ -61,7 +61,7 @@ aigne run --path xxx
 aigne test --path xxx
 
 # 启动 MCP 服务器
-aigne serve --path xxx --mcp
+aigne serve-mcp --path xxx
 
 # 启动 observability 服务器
 aigne observe [option]
@@ -121,19 +121,19 @@ aigne test
 aigne test path/to/agents
 ```
 
-## 服务命令 (serve)
+## 服务命令 (serve-mcp)
 
 将指定目录中的代理作为 MCP 服务器提供服务。
 
 ```bash
 # 在默认端口 3000 启动 MCP 服务器
-aigne serve --mcp
+aigne serve-mcp
 
 # 在指定端口启动 MCP 服务器
-aigne serve --mcp --port 3001
+aigne serve-mcp --port 3001
 
 # 为指定路径的代理启动 MCP 服务器
-aigne serve -- path path/to/agents --mcp
+aigne serve-mcp --path path/to/agents
 ```
 
 ## 服务命令 (observability)

package/dist/commands/aigne.js

@@ -4,7 +4,7 @@ import { asciiLogo } from "../utils/ascii-logo.js";
 import { createCreateCommand } from "./create.js";
 import { createObservabilityCommand } from "./observe.js";
 import { createRunCommand } from "./run.js";
-import { createServeCommand } from "./serve.js";
+import { createServeMCPCommand } from "./serve-mcp.js";
 import { createTestCommand } from "./test.js";
 export function createAIGNECommand() {
     console.log(asciiLogo);
@@ -15,7 +15,7 @@ export function createAIGNECommand() {
         .addCommand(createRunCommand())
         .addCommand(createTestCommand())
         .addCommand(createCreateCommand())
-        .addCommand(createServeCommand())
+        .addCommand(createServeMCPCommand())
         .addCommand(createObservabilityCommand())
         .showHelpAfterError(true)
         .showSuggestionAfterError(true);

package/dist/commands/observe.js

@@ -1,6 +1,7 @@
 import { tryOrThrow } from "@aigne/core/utils/type-utils.js";
 import { startObservabilityCLIServer } from "@aigne/observability-api/cli";
 import getObservabilityDbPath from "@aigne/observability-api/db-path";
+import chalk from "chalk";
 import { Command } from "commander";
 import detectPort from "detect-port";
 const DEFAULT_PORT = () => tryOrThrow(() => {
@@ -20,7 +21,7 @@ export function createObservabilityCommand() {
         .action(async (options) => {
         const port = await detectPort(options.port || DEFAULT_PORT());
         const dbUrl = getObservabilityDbPath();
-        console.log("Observability database path:", dbUrl);
+        console.log("Observability database path:", chalk.greenBright(dbUrl));
         await startObservabilityCLIServer({ port, dbUrl });
     })
         .showHelpAfterError(true)

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

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function createServeMCPCommand(): Command;

package/dist/commands/{serve.js → serve-mcp.js}

@@ -13,11 +13,10 @@ const DEFAULT_PORT = () => tryOrThrow(() => {
         throw new Error(`Invalid PORT: ${PORT}`);
     return port;
 }, (error) => new Error(`parse PORT error ${error.message}`));
-export function createServeCommand() {
-    return new Command("serve")
-        .description("Serve the agents in the specified directory as a MCP server")
+export function createServeMCPCommand() {
+    return new Command("serve-mcp")
+        .description("Serve the agents in the specified directory as a MCP server (streamable http)")
         .option("--url, --path <path_or_url>", "Path to the agents directory or URL to aigne project", ".")
-        .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")
@@ -29,15 +28,12 @@ export function createServeCommand() {
             models: availableModels(),
             memories: availableMemories,
         });
-        if (options.mcp)
-            await serveMCPServer({
-                aigne,
-                host: options.host,
-                port,
-                pathname: options.pathname,
-            });
-        else
-            throw new Error("Default server is not supported yet. Please use --mcp option");
+        await serveMCPServer({
+            aigne,
+            host: options.host,
+            port,
+            pathname: options.pathname,
+        });
         console.log(`MCP server is running on http://${options.host}:${port}${options.pathname}`);
     })
         .showHelpAfterError(true)

package/dist/constants.d.ts

@@ -1,5 +1,5 @@
 import { DefaultMemory } from "@aigne/agent-library/default-memory/index.js";
 import type { LoadableModel } from "@aigne/core/loader/index.js";
-export declare const AIGNE_CLI_VERSION: string;
+export declare const AIGNE_CLI_VERSION: any;
 export declare function availableModels(): LoadableModel[];
 export declare const availableMemories: (typeof DefaultMemory)[];

package/dist/constants.js

@@ -1,3 +1,4 @@
+import { createRequire } from "node:module";
 import { DefaultMemory } from "@aigne/agent-library/default-memory/index.js";
 import { AnthropicChatModel } from "@aigne/anthropic";
 import { BedrockChatModel } from "@aigne/bedrock";
@@ -9,8 +10,8 @@ import { OpenAIChatModel } from "@aigne/openai";
 import { XAIChatModel } from "@aigne/xai";
 import { NodeHttpHandler, streamCollector } from "@smithy/node-http-handler";
 import { HttpsProxyAgent } from "https-proxy-agent";
-import pkg from "../package.json" with { type: "json" };
-export const AIGNE_CLI_VERSION = pkg.version;
+const require = createRequire(import.meta.url);
+export const AIGNE_CLI_VERSION = require("../package.json").version;
 export function availableModels() {
     const proxy = ["HTTPS_PROXY", "https_proxy", "HTTP_PROXY", "http_proxy", "ALL_PROXY", "all_proxy"]
         .map((i) => process.env[i])

package/dist/utils/ascii-logo.js

@@ -1,6 +1,6 @@
 import chalk from "chalk";
 import gradient from "gradient-string";
-import pkg from "../../package.json" with { type: "json" };
+import { AIGNE_CLI_VERSION } from "../constants.js";
 const modernGradient = gradient(["#4facfe", "#7367f0", "#f86aad"]);
 const logo = `
      _    ___ ____ _   _ _____
@@ -9,7 +9,7 @@ const logo = `
   / ___ \\ | | |_| | |\\  | |___
  /_/   \\_\\___\\____|_| \\_|_____|
 `;
-const frameworkInfo = `v${pkg.version}`;
+const frameworkInfo = `v${AIGNE_CLI_VERSION}`;
 const logoLines = logo.split("\n");
 const maxLength = Math.max(...logoLines.filter((line) => line.trim()).map((line) => line.length));
 const versionText = frameworkInfo;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/cli",
-  "version": "1.18.1",
+  "version": "1.19.0",
   "description": "cli for AIGNE framework",
   "publishConfig": {
     "access": "public"
@@ -55,17 +55,17 @@
     "wrap-ansi": "^9.0.0",
     "yaml": "^2.7.1",
     "zod": "^3.24.4",
-    "@aigne/agent-library": "^1.17.6",
-    "@aigne/anthropic": "^0.5.1",
-    "@aigne/bedrock": "^0.5.1",
-    "@aigne/core": "^1.28.1",
-    "@aigne/gemini": "^0.4.1",
-    "@aigne/deepseek": "^0.4.1",
-    "@aigne/ollama": "^0.4.1",
-    "@aigne/observability-api": "^0.3.1",
-    "@aigne/open-router": "^0.4.1",
-    "@aigne/openai": "^0.6.1",
-    "@aigne/xai": "^0.4.1"
+    "@aigne/anthropic": "^0.5.2",
+    "@aigne/bedrock": "^0.5.2",
+    "@aigne/core": "^1.28.2",
+    "@aigne/deepseek": "^0.4.2",
+    "@aigne/agent-library": "^1.17.7",
+    "@aigne/gemini": "^0.4.2",
+    "@aigne/observability-api": "^0.3.2",
+    "@aigne/ollama": "^0.4.2",
+    "@aigne/open-router": "^0.4.2",
+    "@aigne/openai": "^0.6.2",
+    "@aigne/xai": "^0.4.2"
   },
   "devDependencies": {
     "@types/archiver": "^6.0.3",

package/dist/commands/serve.d.ts

@@ -1,2 +0,0 @@
-import { Command } from "commander";
-export declare function createServeCommand(): Command;