@aigne/cli 1.59.1-beta → 1.74.0-beta

package/README.md

@@ -2,30 +2,30 @@
 
 <p align="center">
   <picture>
-    <source srcset="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/packages/cli/logo-dark.svg" media="(prefers-color-scheme: dark)">
-    <source srcset="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/packages/cli/logo.svg" media="(prefers-color-scheme: light)">
-    <img src="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/packages/cli/logo.svg" alt="AIGNE Logo" width="400" />
+    <source srcset="https://raw.githubusercontent.com/ArcBlock/aigne-framework/main/packages/cli/logo-dark.svg" media="(prefers-color-scheme: dark)">
+    <source srcset="https://raw.githubusercontent.com/ArcBlock/aigne-framework/main/packages/cli/logo.svg" media="(prefers-color-scheme: light)">
+    <img src="https://raw.githubusercontent.com/ArcBlock/aigne-framework/main/packages/cli/logo.svg" alt="AIGNE Logo" width="400" />
   </picture>
 
   <center>Your command center for agent development</center>
 </p>
 
-[![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)
+[![GitHub star chart](https://img.shields.io/github/stars/ArcBlock/aigne-framework?style=flat-square)](https://star-history.com/#ArcBlock/aigne-framework)
+[![Open Issues](https://img.shields.io/github/issues-raw/ArcBlock/aigne-framework?style=flat-square)](https://github.com/ArcBlock/aigne-framework/issues)
+[![codecov](https://codecov.io/gh/ArcBlock/aigne-framework/graph/badge.svg?token=DO07834RQL)](https://codecov.io/gh/ArcBlock/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)
+[![Elastic-2.0 licensed](https://img.shields.io/npm/l/@aigne/cli)](https://github.com/ArcBlock/aigne-framework/blob/main/LICENSE)
 
-Command-line tool for [AIGNE Framework](https://github.com/AIGNE-io/aigne-framework), providing convenient development and management capabilities.
+Command-line tool for [AIGNE Framework](https://github.com/ArcBlock/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.
+`@aigne/cli` is the official command-line tool for [AIGNE Framework](https://github.com/ArcBlock/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.
 
 <picture>
-  <source srcset="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/assets/aigne-cli-dark.png" media="(prefers-color-scheme: dark)">
-  <source srcset="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/assets/aigne-cli.png" media="(prefers-color-scheme: light)">
-  <img src="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/aigne-cli.png" alt="AIGNE Arch" />
+  <source srcset="https://raw.githubusercontent.com/ArcBlock/aigne-framework/main/assets/aigne-cli-dark.png" media="(prefers-color-scheme: dark)">
+  <source srcset="https://raw.githubusercontent.com/ArcBlock/aigne-framework/main/assets/aigne-cli.png" media="(prefers-color-scheme: light)">
+  <img src="https://raw.githubusercontent.com/ArcBlock/aigne-framework/main/aigne-cli.png" alt="AIGNE Arch" />
 </picture>
 
 ## Features

package/dist/_virtual/rolldown_runtime.cjs

@@ -0,0 +1,29 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+exports.__toESM = __toESM;

package/dist/bunwrapper.cjs

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+let node_child_process = require("node:child_process");
+let node_process = require("node:process");
+
+//#region src/bunwrapper.ts
+if (!getBunVersion()) (0, node_child_process.spawnSync)("npx", [
+	"-y",
+	"bun",
+	...node_process.argv.slice(2)
+], { stdio: "inherit" });
+else (0, node_child_process.spawnSync)("bun", node_process.argv.slice(2), { stdio: "inherit" });
+function getBunVersion() {
+	try {
+		const { stdout } = (0, node_child_process.spawnSync)("bun", ["--version"], { stdio: "pipe" });
+		return stdout.toString().trim() || void 0;
+	} catch {
+		return false;
+	}
+}
+
+//#endregion

package/dist/bunwrapper.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/bunwrapper.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/bunwrapper.mjs

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { argv } from "node:process";
+
+//#region src/bunwrapper.ts
+if (!getBunVersion()) spawnSync("npx", [
+	"-y",
+	"bun",
+	...argv.slice(2)
+], { stdio: "inherit" });
+else spawnSync("bun", argv.slice(2), { stdio: "inherit" });
+function getBunVersion() {
+	try {
+		const { stdout } = spawnSync("bun", ["--version"], { stdio: "pipe" });
+		return stdout.toString().trim() || void 0;
+	} catch {
+		return false;
+	}
+}
+
+//#endregion
+export {  };
+//# sourceMappingURL=bunwrapper.mjs.map

package/dist/bunwrapper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bunwrapper.mjs","names":[],"sources":["../src/bunwrapper.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { spawnSync } from \"node:child_process\";\nimport { argv } from \"node:process\";\n\nif (!getBunVersion()) {\n  spawnSync(\"npx\", [\"-y\", \"bun\", ...argv.slice(2)], { stdio: \"inherit\" });\n} else {\n  spawnSync(\"bun\", argv.slice(2), { stdio: \"inherit\" });\n}\n\nfunction getBunVersion() {\n  try {\n    const { stdout } = spawnSync(\"bun\", [\"--version\"], { stdio: \"pipe\" });\n    return stdout.toString().trim() || undefined;\n  } catch {\n    return false;\n  }\n}\n"],"mappings":";;;;;AAKA,IAAI,CAAC,eAAe,CAClB,WAAU,OAAO;CAAC;CAAM;CAAO,GAAG,KAAK,MAAM,EAAE;CAAC,EAAE,EAAE,OAAO,WAAW,CAAC;IAEvE,WAAU,OAAO,KAAK,MAAM,EAAE,EAAE,EAAE,OAAO,WAAW,CAAC;AAGvD,SAAS,gBAAgB;AACvB,KAAI;EACF,MAAM,EAAE,WAAW,UAAU,OAAO,CAAC,YAAY,EAAE,EAAE,OAAO,QAAQ,CAAC;AACrE,SAAO,OAAO,UAAU,CAAC,MAAM,IAAI;SAC7B;AACN,SAAO"}

package/dist/cli.cjs

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_utils_string_utils = require('./utils/string-utils.cjs');
+const require_aigne = require('./commands/aigne.cjs');
+let node_fs = require("node:fs");
+let _aigne_core_utils_logger = require("@aigne/core/utils/logger");
+let chalk = require("chalk");
+chalk = require_rolldown_runtime.__toESM(chalk);
+let dotenv_flow = require("dotenv-flow");
+
+//#region src/cli.ts
+(0, dotenv_flow.config)({ silent: true });
+function getAIGNEFilePath() {
+	let file = process.argv[2];
+	if (file) {
+		if (!(0, node_fs.existsSync)(file)) return;
+		file = (0, node_fs.realpathSync)(file);
+		if ((0, node_fs.statSync)(file).isFile()) return file;
+	}
+}
+const aigneFilePath = getAIGNEFilePath();
+const argv = process.argv.slice(aigneFilePath ? 3 : 2);
+var cli_default = require_aigne.createAIGNECommand({
+	argv,
+	aigneFilePath
+}).fail((message, error, yargs) => {
+	if (!error) {
+		yargs.showHelp();
+		console.error(`\n${message}`);
+		process.exit(1);
+	}
+}).parseAsync(argv).catch((error) => {
+	if (error.name !== "ExitPromptError") {
+		console.log("");
+		if (_aigne_core_utils_logger.logger.enabled(_aigne_core_utils_logger.LogLevel.ERROR)) console.error(chalk.default.red(error.stack));
+		else console.error(`${chalk.default.red("Error:")} ${require_utils_string_utils.highlightUrl(error.message)}`);
+	}
+	process.exit(1);
+});
+
+//#endregion
+module.exports = cli_default;

package/dist/cli.d.cts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+//#region src/cli.d.ts
+declare const _default: Promise<{
+  [x: string]: unknown;
+  _: (string | number)[];
+  $0: string;
+}>;
+export = _default;
+//# sourceMappingURL=cli.d.cts.map

package/dist/cli.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.cts","names":[],"sources":["../src/cli.ts"],"mappings":""}

package/dist/cli.d.mts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+//#region src/cli.d.ts
+declare const _default: Promise<{
+  [x: string]: unknown;
+  _: (string | number)[];
+  $0: string;
+}>;
+//#endregion
+export { _default as default };
+//# sourceMappingURL=cli.d.mts.map

package/dist/cli.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.mts","names":[],"sources":["../src/cli.ts"],"mappings":""}

package/dist/cli.mjs

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+import { highlightUrl } from "./utils/string-utils.mjs";
+import { createAIGNECommand } from "./commands/aigne.mjs";
+import { existsSync, realpathSync, statSync } from "node:fs";
+import { LogLevel, logger } from "@aigne/core/utils/logger";
+import chalk from "chalk";
+import { config } from "dotenv-flow";
+
+//#region src/cli.ts
+config({ silent: true });
+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();
+const argv = process.argv.slice(aigneFilePath ? 3 : 2);
+var cli_default = createAIGNECommand({
+	argv,
+	aigneFilePath
+}).fail((message, error, yargs) => {
+	if (!error) {
+		yargs.showHelp();
+		console.error(`\n${message}`);
+		process.exit(1);
+	}
+}).parseAsync(argv).catch((error) => {
+	if (error.name !== "ExitPromptError") {
+		console.log("");
+		if (logger.enabled(LogLevel.ERROR)) console.error(chalk.red(error.stack));
+		else console.error(`${chalk.red("Error:")} ${highlightUrl(error.message)}`);
+	}
+	process.exit(1);
+});
+
+//#endregion
+export { cli_default as default };
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { existsSync, realpathSync, statSync } from \"node:fs\";\nimport { LogLevel, logger } from \"@aigne/core/utils/logger\";\nimport chalk from \"chalk\";\nimport { config } from \"dotenv-flow\";\nimport { createAIGNECommand } from \"./commands/aigne.js\";\nimport { highlightUrl } from \"./utils/string-utils.js\";\n\nconfig({ silent: true });\n\nfunction getAIGNEFilePath() {\n  let file = process.argv[2];\n  if (file) {\n    if (!existsSync(file)) return;\n    file = realpathSync(file);\n    if (statSync(file).isFile()) return file;\n  }\n}\n\nconst aigneFilePath = getAIGNEFilePath();\n\nconst argv = process.argv.slice(aigneFilePath ? 3 : 2);\n\nexport default createAIGNECommand({ argv, aigneFilePath })\n  .fail((message, error, yargs) => {\n    // We catch all errors below, here just print the help message non-error case like demandCommand\n    if (!error) {\n      yargs.showHelp();\n\n      console.error(`\\n${message}`);\n      process.exit(1);\n    }\n  })\n  .parseAsync(argv)\n  .catch((error: Error) => {\n    if (error.name !== \"ExitPromptError\") {\n      console.log(\"\"); // Add an empty line for better readability\n\n      if (logger.enabled(LogLevel.ERROR)) {\n        console.error(chalk.red(error.stack));\n      } else {\n        console.error(`${chalk.red(\"Error:\")} ${highlightUrl(error.message)}`);\n      }\n    }\n    process.exit(1);\n  });\n"],"mappings":";;;;;;;;;AASA,OAAO,EAAE,QAAQ,MAAM,CAAC;AAExB,SAAS,mBAAmB;CAC1B,IAAI,OAAO,QAAQ,KAAK;AACxB,KAAI,MAAM;AACR,MAAI,CAAC,WAAW,KAAK,CAAE;AACvB,SAAO,aAAa,KAAK;AACzB,MAAI,SAAS,KAAK,CAAC,QAAQ,CAAE,QAAO;;;AAIxC,MAAM,gBAAgB,kBAAkB;AAExC,MAAM,OAAO,QAAQ,KAAK,MAAM,gBAAgB,IAAI,EAAE;AAEtD,kBAAe,mBAAmB;CAAE;CAAM;CAAe,CAAC,CACvD,MAAM,SAAS,OAAO,UAAU;AAE/B,KAAI,CAAC,OAAO;AACV,QAAM,UAAU;AAEhB,UAAQ,MAAM,KAAK,UAAU;AAC7B,UAAQ,KAAK,EAAE;;EAEjB,CACD,WAAW,KAAK,CAChB,OAAO,UAAiB;AACvB,KAAI,MAAM,SAAS,mBAAmB;AACpC,UAAQ,IAAI,GAAG;AAEf,MAAI,OAAO,QAAQ,SAAS,MAAM,CAChC,SAAQ,MAAM,MAAM,IAAI,MAAM,MAAM,CAAC;MAErC,SAAQ,MAAM,GAAG,MAAM,IAAI,SAAS,CAAC,GAAG,aAAa,MAAM,QAAQ,GAAG;;AAG1E,SAAQ,KAAK,EAAE;EACf"}

package/dist/commands/aigne.cjs

@@ -0,0 +1,23 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_constants = require('../constants.cjs');
+const require_utils_ascii_logo = require('../utils/ascii-logo.cjs');
+const require_app = require('./app.cjs');
+const require_create = require('./create.cjs');
+const require_deploy = require('./deploy.cjs');
+const require_eval = require('./eval.cjs');
+const require_hub = require('./hub.cjs');
+const require_observe = require('./observe.cjs');
+const require_serve_mcp = require('./serve-mcp.cjs');
+const require_run = require('./run.cjs');
+const require_run_skill = require('./run-skill.cjs');
+const require_test = require('./test.cjs');
+let yargs = require("yargs");
+yargs = require_rolldown_runtime.__toESM(yargs);
+
+//#region src/commands/aigne.ts
+function createAIGNECommand(options) {
+	return (0, yargs.default)().scriptName("aigne").usage(`${require_utils_ascii_logo.asciiLogo}\n$0 <command> [options]`).version(require_constants.AIGNE_CLI_VERSION).command(require_run.createRunCommand(options)).command(require_run_skill.createRunSkillCommand()).command(require_eval.createEvalCommand(options)).command(require_test.createTestCommand(options)).command(require_create.createCreateCommand()).command(require_serve_mcp.createServeMCPCommand(options)).command(require_observe.createObservabilityCommand()).command(require_app.createAppCommands(options)).command(require_hub.createHubCommand()).command(require_deploy.createDeployCommands()).demandCommand().version(false).alias("help", "h").wrap(null).strict();
+}
+
+//#endregion
+exports.createAIGNECommand = createAIGNECommand;

package/dist/commands/aigne.mjs

@@ -0,0 +1,22 @@
+import { AIGNE_CLI_VERSION } from "../constants.mjs";
+import { asciiLogo } from "../utils/ascii-logo.mjs";
+import { createAppCommands } from "./app.mjs";
+import { createCreateCommand } from "./create.mjs";
+import { createDeployCommands } from "./deploy.mjs";
+import { createEvalCommand } from "./eval.mjs";
+import { createHubCommand } from "./hub.mjs";
+import { createObservabilityCommand } from "./observe.mjs";
+import { createServeMCPCommand } from "./serve-mcp.mjs";
+import { createRunCommand } from "./run.mjs";
+import { createRunSkillCommand } from "./run-skill.mjs";
+import { createTestCommand } from "./test.mjs";
+import yargs from "yargs";
+
+//#region src/commands/aigne.ts
+function createAIGNECommand(options) {
+	return yargs().scriptName("aigne").usage(`${asciiLogo}\n$0 <command> [options]`).version(AIGNE_CLI_VERSION).command(createRunCommand(options)).command(createRunSkillCommand()).command(createEvalCommand(options)).command(createTestCommand(options)).command(createCreateCommand()).command(createServeMCPCommand(options)).command(createObservabilityCommand()).command(createAppCommands(options)).command(createHubCommand()).command(createDeployCommands()).demandCommand().version(false).alias("help", "h").wrap(null).strict();
+}
+
+//#endregion
+export { createAIGNECommand };
+//# sourceMappingURL=aigne.mjs.map

package/dist/commands/aigne.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aigne.mjs","names":[],"sources":["../../src/commands/aigne.ts"],"sourcesContent":["import yargs from \"yargs\";\nimport { AIGNE_CLI_VERSION } from \"../constants.js\";\nimport { asciiLogo } from \"../utils/ascii-logo.js\";\nimport { createAppCommands } from \"./app.js\";\nimport { createCreateCommand } from \"./create.js\";\nimport { createDeployCommands } from \"./deploy.js\";\nimport { createEvalCommand } from \"./eval.js\";\nimport { createHubCommand } from \"./hub.js\";\nimport { createObservabilityCommand } from \"./observe.js\";\nimport { createRunCommand } from \"./run.js\";\nimport { createRunSkillCommand } from \"./run-skill.js\";\nimport { createServeMCPCommand } from \"./serve-mcp.js\";\nimport { createTestCommand } from \"./test.js\";\n\nexport function createAIGNECommand(options?: { argv?: string[]; aigneFilePath?: string }) {\n  return (\n    yargs()\n      .scriptName(\"aigne\")\n      .usage(`${asciiLogo}\\n$0 <command> [options]`)\n      .version(AIGNE_CLI_VERSION)\n      // default command: when user runs `aigne` without subcommand, behave like `aigne run`\n      .command(createRunCommand(options))\n      .command(createRunSkillCommand())\n      .command(createEvalCommand(options))\n      .command(createTestCommand(options))\n      .command(createCreateCommand())\n      .command(createServeMCPCommand(options))\n      .command(createObservabilityCommand())\n      .command(createAppCommands(options))\n      .command(createHubCommand())\n      .command(createDeployCommands())\n      .demandCommand()\n      .version(false)\n      .alias(\"help\", \"h\")\n      .wrap(null)\n      .strict()\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;AAcA,SAAgB,mBAAmB,SAAuD;AACxF,QACE,OAAO,CACJ,WAAW,QAAQ,CACnB,MAAM,GAAG,UAAU,0BAA0B,CAC7C,QAAQ,kBAAkB,CAE1B,QAAQ,iBAAiB,QAAQ,CAAC,CAClC,QAAQ,uBAAuB,CAAC,CAChC,QAAQ,kBAAkB,QAAQ,CAAC,CACnC,QAAQ,kBAAkB,QAAQ,CAAC,CACnC,QAAQ,qBAAqB,CAAC,CAC9B,QAAQ,sBAAsB,QAAQ,CAAC,CACvC,QAAQ,4BAA4B,CAAC,CACrC,QAAQ,kBAAkB,QAAQ,CAAC,CACnC,QAAQ,kBAAkB,CAAC,CAC3B,QAAQ,sBAAsB,CAAC,CAC/B,eAAe,CACf,QAAQ,MAAM,CACd,MAAM,QAAQ,IAAI,CAClB,KAAK,KAAK,CACV,QAAQ"}

package/dist/commands/app/agent.cjs

@@ -0,0 +1,117 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_constants = require('../../constants.cjs');
+const require_utils_yargs = require('../../utils/yargs.cjs');
+const require_utils_run_with_aigne = require('../../utils/run-with-aigne.cjs');
+const require_serve_mcp = require('../serve-mcp.cjs');
+let _aigne_core_utils_logger = require("@aigne/core/utils/logger");
+let node_assert = require("node:assert");
+node_assert = require_rolldown_runtime.__toESM(node_assert);
+let _aigne_uuid = require("@aigne/uuid");
+
+//#region src/commands/app/agent.ts
+const serveMcpCommandModule = ({ aigne, name }) => ({
+	command: "serve-mcp",
+	describe: `Serve ${name} a MCP server (streamable http)`,
+	builder: (yargs) => {
+		return yargs.option("host", {
+			describe: "Host to run the MCP server on, use 0.0.0.0 to publicly expose the server",
+			type: "string",
+			default: "localhost"
+		}).option("port", {
+			describe: "Port to run the MCP server on",
+			type: "number"
+		}).option("pathname", {
+			describe: "Pathname to the service",
+			type: "string",
+			default: "/mcp"
+		});
+	},
+	handler: async (options) => {
+		await require_serve_mcp.serveMCPServerFromDir({
+			...options,
+			aigne
+		});
+	}
+});
+const agentCommandModule = ({ aigne, agent, interactive }) => {
+	return {
+		command: agent.name,
+		aliases: agent.alias || [],
+		describe: agent.description || "",
+		builder: async (yargs) => {
+			return require_utils_yargs.withAgentInputSchema(yargs, {
+				inputSchema: agent.inputSchema,
+				optionalInputs: interactive && "inputKey" in agent && typeof agent.inputKey === "string" ? [agent.inputKey] : []
+			});
+		},
+		handler: async (options) => {
+			if (options.logLevel) _aigne_core_utils_logger.logger.level = options.logLevel;
+			await invokeAgent({
+				aigne,
+				agent,
+				input: {
+					...options,
+					interactive: interactive ?? options.interactive
+				}
+			});
+		}
+	};
+};
+const cliAgentCommandModule = ({ aigne, cliAgent }) => {
+	const { agent, agents } = cliAgent;
+	const name = cliAgent.name || agent?.name;
+	(0, node_assert.default)(name, "CLI agent must have a name");
+	return {
+		command: name,
+		aliases: cliAgent.alias || agent?.alias || [],
+		describe: cliAgent.description || agent?.description || "",
+		builder: async (yargs) => {
+			if (agent) require_utils_yargs.withAgentInputSchema(yargs, { inputSchema: agent.inputSchema });
+			if (agents?.length) for (const cmd of agents) yargs.command(cliAgentCommandModule({
+				aigne,
+				cliAgent: cmd
+			}));
+			if (!agent) yargs.demandCommand();
+			return yargs;
+		},
+		handler: async (options) => {
+			if (!agent) throw new Error("CLI agent is not defined");
+			if (options.logLevel) _aigne_core_utils_logger.logger.level = options.logLevel;
+			await invokeAgent({
+				aigne,
+				agent,
+				input: options
+			});
+		}
+	};
+};
+async function invokeAgent(options) {
+	const { agent, aigne } = options;
+	try {
+		const input = await require_utils_yargs.parseAgentInput(options.input, agent);
+		const sessionId = options.input.sessionId || (0, _aigne_uuid.v7)();
+		const userId = require_constants.DEFAULT_USER_ID;
+		if (aigne.cli.init) await require_utils_run_with_aigne.runAgentWithAIGNE(aigne, aigne.cli.init, {
+			...options.input,
+			input,
+			interactive: false,
+			sessionId,
+			userId
+		});
+		await require_utils_run_with_aigne.runAgentWithAIGNE(aigne, agent, {
+			...options.input,
+			input,
+			interactive: options.input.interactive,
+			sessionId,
+			userId
+		});
+	} finally {
+		await aigne.shutdown();
+	}
+}
+
+//#endregion
+exports.agentCommandModule = agentCommandModule;
+exports.cliAgentCommandModule = cliAgentCommandModule;
+exports.invokeAgent = invokeAgent;
+exports.serveMcpCommandModule = serveMcpCommandModule;

package/dist/commands/app/agent.mjs

@@ -0,0 +1,113 @@
+import { DEFAULT_USER_ID } from "../../constants.mjs";
+import { parseAgentInput, withAgentInputSchema } from "../../utils/yargs.mjs";
+import { runAgentWithAIGNE } from "../../utils/run-with-aigne.mjs";
+import { serveMCPServerFromDir } from "../serve-mcp.mjs";
+import { logger } from "@aigne/core/utils/logger";
+import assert from "node:assert";
+import { v7 } from "@aigne/uuid";
+
+//#region src/commands/app/agent.ts
+const serveMcpCommandModule = ({ aigne, name }) => ({
+	command: "serve-mcp",
+	describe: `Serve ${name} a MCP server (streamable http)`,
+	builder: (yargs) => {
+		return yargs.option("host", {
+			describe: "Host to run the MCP server on, use 0.0.0.0 to publicly expose the server",
+			type: "string",
+			default: "localhost"
+		}).option("port", {
+			describe: "Port to run the MCP server on",
+			type: "number"
+		}).option("pathname", {
+			describe: "Pathname to the service",
+			type: "string",
+			default: "/mcp"
+		});
+	},
+	handler: async (options) => {
+		await serveMCPServerFromDir({
+			...options,
+			aigne
+		});
+	}
+});
+const agentCommandModule = ({ aigne, agent, interactive }) => {
+	return {
+		command: agent.name,
+		aliases: agent.alias || [],
+		describe: agent.description || "",
+		builder: async (yargs) => {
+			return withAgentInputSchema(yargs, {
+				inputSchema: agent.inputSchema,
+				optionalInputs: interactive && "inputKey" in agent && typeof agent.inputKey === "string" ? [agent.inputKey] : []
+			});
+		},
+		handler: async (options) => {
+			if (options.logLevel) logger.level = options.logLevel;
+			await invokeAgent({
+				aigne,
+				agent,
+				input: {
+					...options,
+					interactive: interactive ?? options.interactive
+				}
+			});
+		}
+	};
+};
+const cliAgentCommandModule = ({ aigne, cliAgent }) => {
+	const { agent, agents } = cliAgent;
+	const name = cliAgent.name || agent?.name;
+	assert(name, "CLI agent must have a name");
+	return {
+		command: name,
+		aliases: cliAgent.alias || agent?.alias || [],
+		describe: cliAgent.description || agent?.description || "",
+		builder: async (yargs) => {
+			if (agent) withAgentInputSchema(yargs, { inputSchema: agent.inputSchema });
+			if (agents?.length) for (const cmd of agents) yargs.command(cliAgentCommandModule({
+				aigne,
+				cliAgent: cmd
+			}));
+			if (!agent) yargs.demandCommand();
+			return yargs;
+		},
+		handler: async (options) => {
+			if (!agent) throw new Error("CLI agent is not defined");
+			if (options.logLevel) logger.level = options.logLevel;
+			await invokeAgent({
+				aigne,
+				agent,
+				input: options
+			});
+		}
+	};
+};
+async function invokeAgent(options) {
+	const { agent, aigne } = options;
+	try {
+		const input = await parseAgentInput(options.input, agent);
+		const sessionId = options.input.sessionId || v7();
+		const userId = DEFAULT_USER_ID;
+		if (aigne.cli.init) await runAgentWithAIGNE(aigne, aigne.cli.init, {
+			...options.input,
+			input,
+			interactive: false,
+			sessionId,
+			userId
+		});
+		await runAgentWithAIGNE(aigne, agent, {
+			...options.input,
+			input,
+			interactive: options.input.interactive,
+			sessionId,
+			userId
+		});
+	} finally {
+		await aigne.shutdown();
+	}
+}
+
+//#endregion
+export { agentCommandModule, cliAgentCommandModule, invokeAgent, serveMcpCommandModule };
+//# sourceMappingURL=agent.mjs.map

package/dist/commands/app/agent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.mjs","names":[],"sources":["../../../src/commands/app/agent.ts"],"sourcesContent":["import assert from \"node:assert\";\nimport { DEFAULT_USER_ID } from \"@aigne/cli/constants.js\";\nimport type { Agent, AIGNE, Message } from \"@aigne/core\";\nimport type { CLIAgent } from \"@aigne/core/utils/agent-utils\";\nimport { logger } from \"@aigne/core/utils/logger\";\nimport { v7 } from \"@aigne/uuid\";\nimport type { CommandModule } from \"yargs\";\nimport { runAgentWithAIGNE } from \"../../utils/run-with-aigne.js\";\nimport {\n  type AgentRunCommonOptions,\n  parseAgentInput,\n  withAgentInputSchema,\n} from \"../../utils/yargs.js\";\nimport { serveMCPServerFromDir } from \"../serve-mcp.js\";\n\nexport const serveMcpCommandModule = ({\n  aigne,\n  name,\n}: {\n  aigne: AIGNE;\n  name: string;\n}): CommandModule<unknown, { host: string; port?: number; pathname: string }> => ({\n  command: \"serve-mcp\",\n  describe: `Serve ${name} a MCP server (streamable http)`,\n  builder: (yargs) => {\n    return yargs\n      .option(\"host\", {\n        describe: \"Host to run the MCP server on, use 0.0.0.0 to publicly expose the server\",\n        type: \"string\",\n        default: \"localhost\",\n      })\n      .option(\"port\", {\n        describe: \"Port to run the MCP server on\",\n        type: \"number\",\n      })\n      .option(\"pathname\", {\n        describe: \"Pathname to the service\",\n        type: \"string\",\n        default: \"/mcp\",\n      });\n  },\n  handler: async (options) => {\n    await serveMCPServerFromDir({\n      ...options,\n      aigne,\n    });\n  },\n});\n\nexport const agentCommandModule = ({\n  aigne,\n  agent,\n  interactive,\n}: {\n  aigne: AIGNE;\n  agent: Agent;\n  interactive?: boolean;\n}): CommandModule<unknown, AgentRunCommonOptions> => {\n  return {\n    command: agent.name,\n    aliases: agent.alias || [],\n    describe: agent.description || \"\",\n    builder: async (yargs) => {\n      return withAgentInputSchema(yargs, {\n        inputSchema: agent.inputSchema,\n        optionalInputs:\n          interactive && \"inputKey\" in agent && typeof agent.inputKey === \"string\"\n            ? [agent.inputKey]\n            : [],\n      });\n    },\n    handler: async (options) => {\n      if (options.logLevel) logger.level = options.logLevel;\n\n      await invokeAgent({\n        aigne,\n        agent,\n        input: { ...options, interactive: interactive ?? options.interactive },\n      });\n    },\n  };\n};\n\nexport const cliAgentCommandModule = ({\n  aigne,\n  cliAgent,\n}: {\n  aigne: AIGNE;\n  cliAgent: CLIAgent<Agent>;\n}): CommandModule<unknown, AgentRunCommonOptions> => {\n  const { agent, agents } = cliAgent;\n\n  const name = cliAgent.name || agent?.name;\n  assert(name, \"CLI agent must have a name\");\n\n  return {\n    command: name,\n    aliases: cliAgent.alias || agent?.alias || [],\n    describe: cliAgent.description || agent?.description || \"\",\n    builder: async (yargs) => {\n      if (agent) {\n        withAgentInputSchema(yargs, { inputSchema: agent.inputSchema });\n      }\n      if (agents?.length) {\n        for (const cmd of agents) {\n          yargs.command(\n            cliAgentCommandModule({\n              aigne,\n              cliAgent: cmd,\n            }),\n          );\n        }\n      }\n\n      if (!agent) yargs.demandCommand();\n\n      return yargs;\n    },\n    handler: async (options) => {\n      if (!agent) throw new Error(\"CLI agent is not defined\");\n\n      if (options.logLevel) logger.level = options.logLevel;\n\n      await invokeAgent({\n        aigne,\n        agent,\n        input: options,\n      });\n    },\n  };\n};\n\nexport async function invokeAgent(options: {\n  aigne: AIGNE;\n  agent: Agent;\n  input: Message & AgentRunCommonOptions;\n}) {\n  const { agent, aigne } = options;\n\n  try {\n    const input = await parseAgentInput(options.input, agent);\n\n    const sessionId = options.input.sessionId || v7();\n    const userId = DEFAULT_USER_ID;\n\n    if (aigne.cli.init) {\n      await runAgentWithAIGNE(aigne, aigne.cli.init, {\n        ...options.input,\n        input,\n        interactive: false,\n        sessionId,\n        userId,\n      });\n    }\n\n    await runAgentWithAIGNE(aigne, agent, {\n      ...options.input,\n      input,\n      interactive: options.input.interactive,\n      sessionId,\n      userId,\n    });\n  } finally {\n    await aigne.shutdown();\n  }\n}\n"],"mappings":";;;;;;;;;AAeA,MAAa,yBAAyB,EACpC,OACA,YAIgF;CAChF,SAAS;CACT,UAAU,SAAS,KAAK;CACxB,UAAU,UAAU;AAClB,SAAO,MACJ,OAAO,QAAQ;GACd,UAAU;GACV,MAAM;GACN,SAAS;GACV,CAAC,CACD,OAAO,QAAQ;GACd,UAAU;GACV,MAAM;GACP,CAAC,CACD,OAAO,YAAY;GAClB,UAAU;GACV,MAAM;GACN,SAAS;GACV,CAAC;;CAEN,SAAS,OAAO,YAAY;AAC1B,QAAM,sBAAsB;GAC1B,GAAG;GACH;GACD,CAAC;;CAEL;AAED,MAAa,sBAAsB,EACjC,OACA,OACA,kBAKmD;AACnD,QAAO;EACL,SAAS,MAAM;EACf,SAAS,MAAM,SAAS,EAAE;EAC1B,UAAU,MAAM,eAAe;EAC/B,SAAS,OAAO,UAAU;AACxB,UAAO,qBAAqB,OAAO;IACjC,aAAa,MAAM;IACnB,gBACE,eAAe,cAAc,SAAS,OAAO,MAAM,aAAa,WAC5D,CAAC,MAAM,SAAS,GAChB,EAAE;IACT,CAAC;;EAEJ,SAAS,OAAO,YAAY;AAC1B,OAAI,QAAQ,SAAU,QAAO,QAAQ,QAAQ;AAE7C,SAAM,YAAY;IAChB;IACA;IACA,OAAO;KAAE,GAAG;KAAS,aAAa,eAAe,QAAQ;KAAa;IACvE,CAAC;;EAEL;;AAGH,MAAa,yBAAyB,EACpC,OACA,eAImD;CACnD,MAAM,EAAE,OAAO,WAAW;CAE1B,MAAM,OAAO,SAAS,QAAQ,OAAO;AACrC,QAAO,MAAM,6BAA6B;AAE1C,QAAO;EACL,SAAS;EACT,SAAS,SAAS,SAAS,OAAO,SAAS,EAAE;EAC7C,UAAU,SAAS,eAAe,OAAO,eAAe;EACxD,SAAS,OAAO,UAAU;AACxB,OAAI,MACF,sBAAqB,OAAO,EAAE,aAAa,MAAM,aAAa,CAAC;AAEjE,OAAI,QAAQ,OACV,MAAK,MAAM,OAAO,OAChB,OAAM,QACJ,sBAAsB;IACpB;IACA,UAAU;IACX,CAAC,CACH;AAIL,OAAI,CAAC,MAAO,OAAM,eAAe;AAEjC,UAAO;;EAET,SAAS,OAAO,YAAY;AAC1B,OAAI,CAAC,MAAO,OAAM,IAAI,MAAM,2BAA2B;AAEvD,OAAI,QAAQ,SAAU,QAAO,QAAQ,QAAQ;AAE7C,SAAM,YAAY;IAChB;IACA;IACA,OAAO;IACR,CAAC;;EAEL;;AAGH,eAAsB,YAAY,SAI/B;CACD,MAAM,EAAE,OAAO,UAAU;AAEzB,KAAI;EACF,MAAM,QAAQ,MAAM,gBAAgB,QAAQ,OAAO,MAAM;EAEzD,MAAM,YAAY,QAAQ,MAAM,aAAa,IAAI;EACjD,MAAM,SAAS;AAEf,MAAI,MAAM,IAAI,KACZ,OAAM,kBAAkB,OAAO,MAAM,IAAI,MAAM;GAC7C,GAAG,QAAQ;GACX;GACA,aAAa;GACb;GACA;GACD,CAAC;AAGJ,QAAM,kBAAkB,OAAO,OAAO;GACpC,GAAG,QAAQ;GACX;GACA,aAAa,QAAQ,MAAM;GAC3B;GACA;GACD,CAAC;WACM;AACR,QAAM,MAAM,UAAU"}

package/dist/commands/app/app.cjs

@@ -0,0 +1,92 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_constants = require('../../constants.cjs');
+const require_upgrade = require('./upgrade.cjs');
+const require_utils_yargs = require('../../utils/yargs.cjs');
+const require_utils_string_utils = require('../../utils/string-utils.cjs');
+const require_agent = require('./agent.cjs');
+let _aigne_core_utils_logger = require("@aigne/core/utils/logger");
+let chalk = require("chalk");
+chalk = require_rolldown_runtime.__toESM(chalk);
+let yargs = require("yargs");
+yargs = require_rolldown_runtime.__toESM(yargs);
+let node_path = require("node:path");
+let _aigne_core_utils_type_utils = require("@aigne/core/utils/type-utils");
+let node_os = require("node:os");
+let yargs_helpers = require("yargs/helpers");
+
+//#region src/commands/app/app.ts
+async function runAppCLI({ appName = process.env.AIGNE_APP_NAME, appPackageName = process.env.AIGNE_APP_PACKAGE_NAME, appDescription = process.env.AIGNE_APP_DESCRIPTION, appUseBetaVersion = process.env.AIGNE_APP_USE_BETA_APPS === "1" ? true : void 0, ...options } = {}) {
+	const [scriptName, ...argv] = options.argv || (0, yargs_helpers.hideBin)(process.argv);
+	if (!appName || !appPackageName) throw new Error("AIGNE_APP_NAME or AIGNE_APP_PACKAGE_NAME is not defined");
+	try {
+		const options$1 = require_utils_yargs.withRunAgentCommonOptions((0, yargs.default)(argv).help(false).version(false).strict(false)).parseSync();
+		_aigne_core_utils_logger.logger.level = options$1.logLevel;
+		const dir = (0, node_path.join)((0, node_os.homedir)(), ".aigne", "registry.npmjs.org", appPackageName);
+		const y = (0, yargs.default)().scriptName(`aigne ${scriptName}`).usage(`aigne ${scriptName}\n\n${appDescription || ""}`).command(require_upgrade.upgradeCommandModule({
+			packageName: appPackageName,
+			dir
+		}));
+		if (!isUpgradeCommand(argv)) {
+			const { aigne, version } = await require_upgrade.loadApplication({
+				packageName: appPackageName,
+				beta: appUseBetaVersion,
+				dir,
+				install: true,
+				modelOptions: (0, _aigne_core_utils_type_utils.pick)(options$1, require_constants.CHAT_MODEL_OPTIONS),
+				imageModelOptions: { model: options$1.imageModel },
+				skipModelLoading: (options$1.help || options$1.h || options$1.version || options$1.v) === true
+			});
+			if (aigne.cli?.chat) y.command({
+				...require_agent.agentCommandModule({
+					aigne,
+					agent: aigne.cli.chat,
+					interactive: true
+				}),
+				command: "$0"
+			});
+			for (const cliAgent of aigne.cli?.agents ?? []) y.command(require_agent.cliAgentCommandModule({
+				aigne,
+				cliAgent
+			}));
+			y.option("model", {
+				type: "string",
+				description: "Model to use for the application, example: openai:gpt-4.1 or google:gemini-2.5-flash"
+			}).command(require_agent.serveMcpCommandModule({
+				aigne,
+				name: appName
+			}));
+			y.version(`${appName} v${version}`);
+		}
+		await y.alias("v", "version").alias("h", "help").demandCommand().fail((message, error, yargs$2) => {
+			if (!error) {
+				yargs$2.showHelp();
+				console.error(`\n${message}`);
+				process.exit(1);
+			}
+		}).parseAsync(argv);
+		process.exit(0);
+	} catch (error) {
+		if (error instanceof require_upgrade.NeedReinstallError || error instanceof require_upgrade.NeedReinstallBetaError) {
+			_aigne_core_utils_logger.logger.warn(error.message);
+			process.exit(error instanceof require_upgrade.NeedReinstallBetaError ? require_upgrade.NeedReinstallBetaError.code : require_upgrade.NeedReinstallError.code);
+		}
+		if (error.name !== "ExitPromptError") {
+			console.log("");
+			if (_aigne_core_utils_logger.logger.enabled(_aigne_core_utils_logger.LogLevel.ERROR)) console.error(chalk.default.red(error.stack));
+			else console.error(`${chalk.default.red("Error:")} ${require_utils_string_utils.highlightUrl(error.message)}`);
+		}
+		process.exit(1);
+	}
+}
+function isUpgradeCommand(argv) {
+	const skipGlobalOptions = [
+		"-v",
+		"--version",
+		"-h",
+		"--help"
+	];
+	return argv[0] === "upgrade" && !argv.some((arg) => skipGlobalOptions.includes(arg));
+}
+
+//#endregion
+exports.runAppCLI = runAppCLI;