@aigne/cli 1.18.1 → 1.20.0

package/CHANGELOG.md

@@ -1,5 +1,57 @@
 # Changelog
 
+## [1.20.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.19.0...cli-v1.20.0) (2025-07-02)
+
+
+### Features
+
+* **cli:** support executing aigne.yaml via shebang (#!/usr/bin/env aigne) ([#211](https://github.com/AIGNE-io/aigne-framework/issues/211)) ([2a82c27](https://github.com/AIGNE-io/aigne-framework/commit/2a82c2754b5eab5c3d6e45a5cbe7f0c76d927967))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/agent-library bumped to 1.17.8
+    * @aigne/anthropic bumped to 0.5.3
+    * @aigne/bedrock bumped to 0.5.3
+    * @aigne/core bumped to 1.29.0
+    * @aigne/deepseek bumped to 0.4.3
+    * @aigne/gemini bumped to 0.4.3
+    * @aigne/ollama bumped to 0.4.3
+    * @aigne/open-router bumped to 0.4.3
+    * @aigne/openai bumped to 0.6.3
+    * @aigne/xai bumped to 0.4.3
+
+## [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/cli.js

@@ -1,10 +1,22 @@
 #!/usr/bin/env node
+import { existsSync, realpathSync, statSync } from "node:fs";
 import { config } from "dotenv-flow";
 import PrettyError from "pretty-error";
 import { createAIGNECommand } from "./commands/aigne.js";
 config({ silent: true });
-createAIGNECommand()
-    .parseAsync()
+function getAIGNEFilePath() {
+    let file = process.argv[2];
+    if (file) {
+        if (!existsSync(file))
+            return;
+        file = realpathSync(file);
+        if (statSync(file).isFile())
+            return file;
+    }
+}
+const aigneFilePath = getAIGNEFilePath();
+createAIGNECommand({ aigneFilePath })
+    .parseAsync(["", "", ...process.argv.slice(aigneFilePath ? 3 : 2)])
     .catch((error) => {
     console.error(new PrettyError().render(error));
     process.exit(1);

package/dist/commands/aigne.d.ts

@@ -1,2 +1,4 @@
 import { Command } from "commander";
-export declare function createAIGNECommand(): Command;
+export declare function createAIGNECommand(options?: {
+    aigneFilePath?: string;
+}): Command;

package/dist/commands/aigne.js

@@ -4,18 +4,18 @@ 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() {
+export function createAIGNECommand(options) {
     console.log(asciiLogo);
     return new Command()
         .name("aigne")
         .description("CLI for AIGNE framework")
         .version(AIGNE_CLI_VERSION)
-        .addCommand(createRunCommand())
-        .addCommand(createTestCommand())
+        .addCommand(createRunCommand(options))
+        .addCommand(createTestCommand(options))
         .addCommand(createCreateCommand())
-        .addCommand(createServeCommand())
+        .addCommand(createServeMCPCommand(options))
         .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/run.d.ts

@@ -1,2 +1,4 @@
 import type { Command } from "commander";
-export declare function createRunCommand(): Command;
+export declare function createRunCommand({ aigneFilePath }?: {
+    aigneFilePath?: string;
+}): Command;

package/dist/commands/run.js

@@ -12,14 +12,14 @@ import { availableMemories, availableModels } from "../constants.js";
 import { isV1Package, toAIGNEPackage } from "../utils/agent-v1.js";
 import { downloadAndExtract } from "../utils/download.js";
 import { createRunAIGNECommand, parseAgentInputByCommander, parseModelOption, runAgentWithAIGNE, } from "../utils/run-with-aigne.js";
-export function createRunCommand() {
+export function createRunCommand({ aigneFilePath } = {}) {
     return createRunAIGNECommand()
         .description("Run AIGNE from the specified agent")
         .option("--url, --path <path_or_url>", "Path to the agents directory or URL to aigne project", ".")
         .option("--entry-agent <entry-agent>", "Name of the agent to run (defaults to the first agent found)")
         .option("--cache-dir <dir>", "Directory to download the package to (defaults to the ~/.aigne/xxx)")
         .action(async (options) => {
-        const { path } = options;
+        const path = aigneFilePath || options.path;
         if (options.logLevel)
             logger.level = options.logLevel;
         const { cacheDir, dir } = prepareDirs(path, options);

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

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

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

@@ -13,31 +13,27 @@ 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({ aigneFilePath } = {}) {
+    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")
         .action(async (options) => {
-        const { path } = options;
+        const path = aigneFilePath || options.path;
         const absolutePath = isAbsolute(path) ? path : resolve(process.cwd(), path);
         const port = options.port || DEFAULT_PORT();
         const aigne = await AIGNE.load(absolutePath, {
             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/commands/test.d.ts

@@ -1,2 +1,4 @@
 import { Command } from "commander";
-export declare function createTestCommand(): Command;
+export declare function createTestCommand({ aigneFilePath }?: {
+    aigneFilePath?: string;
+}): Command;

package/dist/commands/test.js

@@ -1,12 +1,12 @@
 import { spawnSync } from "node:child_process";
 import { isAbsolute, resolve } from "node:path";
 import { Command } from "commander";
-export function createTestCommand() {
+export function createTestCommand({ aigneFilePath } = {}) {
     return new Command("test")
         .description("Run tests in the specified agents directory")
         .option("--url, --path <path_or_url>", "Path to the agents directory or URL to aigne project", ".")
         .action(async (options) => {
-        const { path } = options;
+        const path = aigneFilePath || options.path;
         const absolutePath = isAbsolute(path) ? path : resolve(process.cwd(), path);
         spawnSync("node", ["--test"], { cwd: absolutePath, stdio: "inherit" });
     })

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.20.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/agent-library": "^1.17.8",
+    "@aigne/anthropic": "^0.5.3",
+    "@aigne/bedrock": "^0.5.3",
+    "@aigne/deepseek": "^0.4.3",
+    "@aigne/core": "^1.29.0",
+    "@aigne/gemini": "^0.4.3",
+    "@aigne/observability-api": "^0.3.2",
+    "@aigne/ollama": "^0.4.3",
+    "@aigne/xai": "^0.4.3",
+    "@aigne/openai": "^0.6.3",
+    "@aigne/open-router": "^0.4.3"
   },
   "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;