@aigne/cli 1.60.0-beta → 1.74.0-beta

package/dist/commands/observe.mjs

@@ -0,0 +1,46 @@
+import chalk from "chalk";
+import { tryOrThrow } from "@aigne/core/utils/type-utils";
+import { startObservabilityCLIServer } from "@aigne/observability-api/cli";
+import getObservabilityDbPath from "@aigne/observability-api/db-path";
+import detectPort from "detect-port";
+
+//#region src/commands/observe.ts
+const DEFAULT_PORT = () => tryOrThrow(() => {
+	const { PORT } = process.env;
+	if (!PORT) return 7890;
+	const port = Number.parseInt(PORT, 10);
+	if (!port || !Number.isInteger(port)) throw new Error(`Invalid PORT: ${PORT}`);
+	return port;
+}, (error) => /* @__PURE__ */ new Error(`parse PORT error ${error.message}`));
+function createObservabilityCommand() {
+	return {
+		command: "observe",
+		describe: "Start the observability server",
+		builder: (yargs) => {
+			return yargs.option("host", {
+				type: "string",
+				describe: "Host to run the observability server on, use 0.0.0.0 to publicly expose the server",
+				default: "localhost"
+			}).option("port", {
+				type: "number",
+				describe: "Port to run the observability server on"
+			});
+		},
+		handler: async (options) => {
+			const port = await detectPort(options.port || DEFAULT_PORT());
+			const dbUrl = getObservabilityDbPath();
+			process.once("SIGINT", async () => {
+				process.exit(0);
+			});
+			console.log("Observability database path:", chalk.greenBright(dbUrl));
+			await startObservabilityCLIServer({
+				port,
+				dbUrl
+			});
+		}
+	};
+}
+
+//#endregion
+export { createObservabilityCommand };
+//# sourceMappingURL=observe.mjs.map

package/dist/commands/observe.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.mjs","names":[],"sources":["../../src/commands/observe.ts"],"sourcesContent":["import { tryOrThrow } from \"@aigne/core/utils/type-utils\";\nimport { startObservabilityCLIServer } from \"@aigne/observability-api/cli\";\nimport getObservabilityDbPath from \"@aigne/observability-api/db-path\";\nimport chalk from \"chalk\";\nimport detectPort from \"detect-port\";\nimport type { CommandModule } from \"yargs\";\n\ninterface ServeMCPOptions {\n  host: string;\n  port?: number;\n}\n\nconst DEFAULT_PORT = () =>\n  tryOrThrow(\n    () => {\n      const { PORT } = process.env;\n      if (!PORT) return 7890;\n      const port = Number.parseInt(PORT, 10);\n      if (!port || !Number.isInteger(port)) throw new Error(`Invalid PORT: ${PORT}`);\n      return port;\n    },\n    (error) => new Error(`parse PORT error ${error.message}`),\n  );\n\nexport function createObservabilityCommand(): CommandModule<unknown, ServeMCPOptions> {\n  return {\n    command: \"observe\",\n    describe: \"Start the observability server\",\n    builder: (yargs) => {\n      return yargs\n        .option(\"host\", {\n          type: \"string\",\n          describe:\n            \"Host to run the observability server on, use 0.0.0.0 to publicly expose the server\",\n          default: \"localhost\",\n        })\n        .option(\"port\", {\n          type: \"number\",\n          describe: \"Port to run the observability server on\",\n        });\n    },\n    handler: async (options) => {\n      const port = await detectPort(options.port || DEFAULT_PORT());\n      const dbUrl = getObservabilityDbPath();\n\n      process.once(\"SIGINT\", async () => {\n        process.exit(0);\n      });\n\n      console.log(\"Observability database path:\", chalk.greenBright(dbUrl));\n      await startObservabilityCLIServer({ port, dbUrl });\n    },\n  };\n}\n"],"mappings":";;;;;;;AAYA,MAAM,qBACJ,iBACQ;CACJ,MAAM,EAAE,SAAS,QAAQ;AACzB,KAAI,CAAC,KAAM,QAAO;CAClB,MAAM,OAAO,OAAO,SAAS,MAAM,GAAG;AACtC,KAAI,CAAC,QAAQ,CAAC,OAAO,UAAU,KAAK,CAAE,OAAM,IAAI,MAAM,iBAAiB,OAAO;AAC9E,QAAO;IAER,0BAAU,IAAI,MAAM,oBAAoB,MAAM,UAAU,CAC1D;AAEH,SAAgB,6BAAsE;AACpF,QAAO;EACL,SAAS;EACT,UAAU;EACV,UAAU,UAAU;AAClB,UAAO,MACJ,OAAO,QAAQ;IACd,MAAM;IACN,UACE;IACF,SAAS;IACV,CAAC,CACD,OAAO,QAAQ;IACd,MAAM;IACN,UAAU;IACX,CAAC;;EAEN,SAAS,OAAO,YAAY;GAC1B,MAAM,OAAO,MAAM,WAAW,QAAQ,QAAQ,cAAc,CAAC;GAC7D,MAAM,QAAQ,wBAAwB;AAEtC,WAAQ,KAAK,UAAU,YAAY;AACjC,YAAQ,KAAK,EAAE;KACf;AAEF,WAAQ,IAAI,gCAAgC,MAAM,YAAY,MAAM,CAAC;AACrE,SAAM,4BAA4B;IAAE;IAAM;IAAO,CAAC;;EAErD"}

package/dist/commands/run-skill.cjs

@@ -0,0 +1,84 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_utils_aigne_hub_model = require('../utils/aigne-hub/model.cjs');
+const require_utils_yargs = require('../utils/yargs.cjs');
+const require_agent = require('./app/agent.cjs');
+let node_path = require("node:path");
+let _aigne_core = require("@aigne/core");
+let zod = require("zod");
+let _aigne_afs_history = require("@aigne/afs-history");
+let _aigne_afs_local_fs = require("@aigne/afs-local-fs");
+let _aigne_agent_library_agent_skill_manager = require("@aigne/agent-library/agent-skill-manager");
+_aigne_agent_library_agent_skill_manager = require_rolldown_runtime.__toESM(_aigne_agent_library_agent_skill_manager);
+let _aigne_agent_library_ask_user_question = require("@aigne/agent-library/ask-user-question");
+_aigne_agent_library_ask_user_question = require_rolldown_runtime.__toESM(_aigne_agent_library_ask_user_question);
+let _aigne_agent_library_bash = require("@aigne/agent-library/bash");
+_aigne_agent_library_bash = require_rolldown_runtime.__toESM(_aigne_agent_library_bash);
+
+//#region src/commands/run-skill.ts
+function createRunSkillCommand() {
+	return {
+		command: ["run-skill"],
+		describe: "Run Agent Skill for the specified path",
+		builder: async (yargs) => {
+			return require_utils_yargs.withAgentInputSchema(yargs.option("skill", {
+				array: true,
+				type: "string",
+				describe: "Path to the Agent Skill directory"
+			}).option("interactive", {
+				describe: "Run in interactive chat mode",
+				type: "boolean",
+				default: false,
+				alias: ["chat"]
+			}).demandOption("skill"), {
+				inputSchema: zod.z.object({ message: zod.z.string() }),
+				optionalInputs: ["message"]
+			});
+		},
+		handler: async (options) => {
+			if (!Array.isArray(options.skill) || options.skill.length === 0) throw new Error("At least one skill path must be provided.");
+			const aigne = new _aigne_core.AIGNE({ model: await require_utils_aigne_hub_model.loadChatModel({ model: options.model || "aignehub/anthropic/claude-sonnet-4-5" }) });
+			const approvedCmds = /* @__PURE__ */ new Set();
+			await require_agent.invokeAgent({
+				aigne,
+				agent: new _aigne_agent_library_agent_skill_manager.default({
+					inputKey: "message",
+					taskRenderMode: "collapse",
+					skills: [new _aigne_agent_library_bash.default({
+						sandbox: false,
+						permissions: {
+							defaultMode: "ask",
+							guard: _aigne_core.FunctionAgent.from(async (input, options$1) => {
+								if (approvedCmds.has(input.script || "")) return { approved: true };
+								const confirm = options$1.prompts?.confirm;
+								if (!confirm) throw new Error("No confirm prompt available for permission guard.");
+								const approved = await confirm({ message: `Run command ${input.script}?` });
+								if (approved && input.script) approvedCmds.add(input.script);
+								return { approved };
+							})
+						}
+					}), new _aigne_agent_library_ask_user_question.default()],
+					afs: { modules: [
+						new _aigne_afs_history.AFSHistory({}),
+						new _aigne_afs_local_fs.LocalFS({
+							name: "workspace",
+							localPath: process.cwd(),
+							description: `\
+Current working directory. All temporary files should be written here using absolute AFS paths (e.g., /modules/workspace/temp.py).
+Note: Bash is already running in this directory, so do NOT use 'cd /modules/workspace' in scripts. Use relative paths directly (e.g., python temp.py).`
+						}),
+						...options.skill.map((path) => new _aigne_afs_local_fs.LocalFS({
+							name: (0, node_path.basename)((0, node_path.resolve)(path)),
+							localPath: path,
+							description: "Contains Agent Skills. Use 'Skill' tool to invoke skills from this module.",
+							agentSkills: true
+						}))
+					] }
+				}),
+				input: { ...options }
+			});
+		}
+	};
+}
+
+//#endregion
+exports.createRunSkillCommand = createRunSkillCommand;

package/dist/commands/run-skill.mjs

@@ -0,0 +1,81 @@
+import { loadChatModel } from "../utils/aigne-hub/model.mjs";
+import { withAgentInputSchema } from "../utils/yargs.mjs";
+import { invokeAgent } from "./app/agent.mjs";
+import { basename, resolve } from "node:path";
+import { AIGNE, FunctionAgent } from "@aigne/core";
+import { z as z$1 } from "zod";
+import { AFSHistory } from "@aigne/afs-history";
+import { LocalFS } from "@aigne/afs-local-fs";
+import AgentSkillManager from "@aigne/agent-library/agent-skill-manager";
+import AskUserQuestion from "@aigne/agent-library/ask-user-question";
+import BashAgent from "@aigne/agent-library/bash";
+
+//#region src/commands/run-skill.ts
+function createRunSkillCommand() {
+	return {
+		command: ["run-skill"],
+		describe: "Run Agent Skill for the specified path",
+		builder: async (yargs) => {
+			return withAgentInputSchema(yargs.option("skill", {
+				array: true,
+				type: "string",
+				describe: "Path to the Agent Skill directory"
+			}).option("interactive", {
+				describe: "Run in interactive chat mode",
+				type: "boolean",
+				default: false,
+				alias: ["chat"]
+			}).demandOption("skill"), {
+				inputSchema: z$1.object({ message: z$1.string() }),
+				optionalInputs: ["message"]
+			});
+		},
+		handler: async (options) => {
+			if (!Array.isArray(options.skill) || options.skill.length === 0) throw new Error("At least one skill path must be provided.");
+			const aigne = new AIGNE({ model: await loadChatModel({ model: options.model || "aignehub/anthropic/claude-sonnet-4-5" }) });
+			const approvedCmds = /* @__PURE__ */ new Set();
+			await invokeAgent({
+				aigne,
+				agent: new AgentSkillManager({
+					inputKey: "message",
+					taskRenderMode: "collapse",
+					skills: [new BashAgent({
+						sandbox: false,
+						permissions: {
+							defaultMode: "ask",
+							guard: FunctionAgent.from(async (input, options$1) => {
+								if (approvedCmds.has(input.script || "")) return { approved: true };
+								const confirm = options$1.prompts?.confirm;
+								if (!confirm) throw new Error("No confirm prompt available for permission guard.");
+								const approved = await confirm({ message: `Run command ${input.script}?` });
+								if (approved && input.script) approvedCmds.add(input.script);
+								return { approved };
+							})
+						}
+					}), new AskUserQuestion()],
+					afs: { modules: [
+						new AFSHistory({}),
+						new LocalFS({
+							name: "workspace",
+							localPath: process.cwd(),
+							description: `\
+Current working directory. All temporary files should be written here using absolute AFS paths (e.g., /modules/workspace/temp.py).
+Note: Bash is already running in this directory, so do NOT use 'cd /modules/workspace' in scripts. Use relative paths directly (e.g., python temp.py).`
+						}),
+						...options.skill.map((path$1) => new LocalFS({
+							name: basename(resolve(path$1)),
+							localPath: path$1,
+							description: "Contains Agent Skills. Use 'Skill' tool to invoke skills from this module.",
+							agentSkills: true
+						}))
+					] }
+				}),
+				input: { ...options }
+			});
+		}
+	};
+}
+
+//#endregion
+export { createRunSkillCommand };
+//# sourceMappingURL=run-skill.mjs.map

package/dist/commands/run-skill.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-skill.mjs","names":["z","options","path"],"sources":["../../src/commands/run-skill.ts"],"sourcesContent":["import { basename, resolve } from \"node:path\";\nimport { AFSHistory } from \"@aigne/afs-history\";\nimport { LocalFS } from \"@aigne/afs-local-fs\";\nimport AgentSkillManager from \"@aigne/agent-library/agent-skill-manager\";\nimport AskUserQuestion from \"@aigne/agent-library/ask-user-question\";\nimport BashAgent from \"@aigne/agent-library/bash\";\nimport { AIGNE, FunctionAgent } from \"@aigne/core\";\nimport type { CommandModule } from \"yargs\";\nimport { z } from \"zod\";\nimport { loadChatModel } from \"../utils/aigne-hub/model.js\";\nimport { type AgentRunCommonOptions, withAgentInputSchema } from \"../utils/yargs.js\";\nimport { invokeAgent } from \"./app/agent.js\";\n\nexport function createRunSkillCommand(): CommandModule<\n  unknown,\n  { skill?: string[]; interactive?: boolean } & AgentRunCommonOptions\n> {\n  return {\n    command: [\"run-skill\"],\n    describe: \"Run Agent Skill for the specified path\",\n    builder: async (yargs) => {\n      return withAgentInputSchema(\n        yargs\n          .option(\"skill\", {\n            array: true,\n            type: \"string\",\n            describe: \"Path to the Agent Skill directory\",\n          })\n          .option(\"interactive\", {\n            describe: \"Run in interactive chat mode\",\n            type: \"boolean\",\n            default: false,\n            alias: [\"chat\"],\n          })\n          .demandOption(\"skill\"),\n        {\n          inputSchema: z.object({\n            message: z.string(),\n          }),\n          optionalInputs: [\"message\"],\n        },\n      );\n    },\n    handler: async (options) => {\n      if (!Array.isArray(options.skill) || options.skill.length === 0) {\n        throw new Error(\"At least one skill path must be provided.\");\n      }\n\n      const model = await loadChatModel({\n        model: options.model || \"aignehub/anthropic/claude-sonnet-4-5\",\n      });\n\n      const aigne = new AIGNE({ model });\n\n      const approvedCmds = new Set<string>();\n\n      const agent = new AgentSkillManager({\n        inputKey: \"message\",\n        taskRenderMode: \"collapse\",\n        skills: [\n          new BashAgent({\n            sandbox: false,\n            permissions: {\n              defaultMode: \"ask\",\n              guard: FunctionAgent.from(async (input, options) => {\n                if (approvedCmds.has(input.script || \"\")) {\n                  return {\n                    approved: true,\n                  };\n                }\n\n                const confirm = options.prompts?.confirm;\n                if (!confirm) throw new Error(\"No confirm prompt available for permission guard.\");\n\n                const approved = await confirm({ message: `Run command ${input.script}?` });\n\n                if (approved && input.script) {\n                  approvedCmds.add(input.script);\n                }\n\n                return {\n                  approved,\n                };\n              }),\n            },\n          }),\n          new AskUserQuestion(),\n        ],\n        afs: {\n          modules: [\n            new AFSHistory({}),\n            new LocalFS({\n              name: \"workspace\",\n              localPath: process.cwd(),\n              description: `\\\nCurrent working directory. All temporary files should be written here using absolute AFS paths (e.g., /modules/workspace/temp.py).\nNote: Bash is already running in this directory, so do NOT use 'cd /modules/workspace' in scripts. Use relative paths directly (e.g., python temp.py).`,\n            }),\n            ...options.skill.map(\n              (path) =>\n                new LocalFS({\n                  name: basename(resolve(path)),\n                  localPath: path,\n                  description:\n                    \"Contains Agent Skills. Use 'Skill' tool to invoke skills from this module.\",\n                  agentSkills: true,\n                }),\n            ),\n          ],\n        },\n      });\n\n      await invokeAgent({\n        aigne,\n        agent,\n        input: {\n          ...options,\n        },\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,SAAgB,wBAGd;AACA,QAAO;EACL,SAAS,CAAC,YAAY;EACtB,UAAU;EACV,SAAS,OAAO,UAAU;AACxB,UAAO,qBACL,MACG,OAAO,SAAS;IACf,OAAO;IACP,MAAM;IACN,UAAU;IACX,CAAC,CACD,OAAO,eAAe;IACrB,UAAU;IACV,MAAM;IACN,SAAS;IACT,OAAO,CAAC,OAAO;IAChB,CAAC,CACD,aAAa,QAAQ,EACxB;IACE,aAAaA,IAAE,OAAO,EACpB,SAASA,IAAE,QAAQ,EACpB,CAAC;IACF,gBAAgB,CAAC,UAAU;IAC5B,CACF;;EAEH,SAAS,OAAO,YAAY;AAC1B,OAAI,CAAC,MAAM,QAAQ,QAAQ,MAAM,IAAI,QAAQ,MAAM,WAAW,EAC5D,OAAM,IAAI,MAAM,4CAA4C;GAO9D,MAAM,QAAQ,IAAI,MAAM,EAAE,OAJZ,MAAM,cAAc,EAChC,OAAO,QAAQ,SAAS,wCACzB,CAAC,EAE+B,CAAC;GAElC,MAAM,+BAAe,IAAI,KAAa;AA0DtC,SAAM,YAAY;IAChB;IACA,OA1DY,IAAI,kBAAkB;KAClC,UAAU;KACV,gBAAgB;KAChB,QAAQ,CACN,IAAI,UAAU;MACZ,SAAS;MACT,aAAa;OACX,aAAa;OACb,OAAO,cAAc,KAAK,OAAO,OAAO,cAAY;AAClD,YAAI,aAAa,IAAI,MAAM,UAAU,GAAG,CACtC,QAAO,EACL,UAAU,MACX;QAGH,MAAM,UAAUC,UAAQ,SAAS;AACjC,YAAI,CAAC,QAAS,OAAM,IAAI,MAAM,oDAAoD;QAElF,MAAM,WAAW,MAAM,QAAQ,EAAE,SAAS,eAAe,MAAM,OAAO,IAAI,CAAC;AAE3E,YAAI,YAAY,MAAM,OACpB,cAAa,IAAI,MAAM,OAAO;AAGhC,eAAO,EACL,UACD;SACD;OACH;MACF,CAAC,EACF,IAAI,iBAAiB,CACtB;KACD,KAAK,EACH,SAAS;MACP,IAAI,WAAW,EAAE,CAAC;MAClB,IAAI,QAAQ;OACV,MAAM;OACN,WAAW,QAAQ,KAAK;OACxB,aAAa;;;OAGd,CAAC;MACF,GAAG,QAAQ,MAAM,KACd,WACC,IAAI,QAAQ;OACV,MAAM,SAAS,QAAQC,OAAK,CAAC;OAC7B,WAAWA;OACX,aACE;OACF,aAAa;OACd,CAAC,CACL;MACF,EACF;KACF,CAAC;IAKA,OAAO,EACL,GAAG,SACJ;IACF,CAAC;;EAEL"}

package/dist/commands/run.cjs

@@ -0,0 +1,172 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_constants = require('../constants.cjs');
+const require_utils_download = require('../utils/download.cjs');
+const require_utils_load_aigne = require('../utils/load-aigne.cjs');
+const require_utils_agent_v1 = require('../utils/agent-v1.cjs');
+const require_utils_url = require('../utils/url.cjs');
+const require_utils_yargs = require('../utils/yargs.cjs');
+const require_agent = require('./app/agent.cjs');
+let _aigne_core_utils_logger = require("@aigne/core/utils/logger");
+let dotenv_flow = require("dotenv-flow");
+let yargs = require("yargs");
+yargs = require_rolldown_runtime.__toESM(yargs);
+let node_path = require("node:path");
+let node_fs_promises = require("node:fs/promises");
+let _aigne_listr2 = require("@aigne/listr2");
+let _aigne_core_utils_type_utils = require("@aigne/core/utils/type-utils");
+let node_os = require("node:os");
+let _aigne_agent_library_utils_fs = require("@aigne/agent-library/utils/fs");
+let _aigne_core_loader = require("@aigne/core/loader");
+
+//#region src/commands/run.ts
+let yargsInstance = null;
+function createRunCommand({ aigneFilePath } = {}) {
+	return {
+		command: ["run [path] [entry-agent]", "$0"],
+		describe: "Run AIGNE for the specified path",
+		builder: async (yargs$2) => {
+			yargsInstance = yargs$2;
+			return yargs$2.positional("path", {
+				type: "string",
+				describe: "Path to the agents directory or URL to an aigne project",
+				default: "."
+			}).positional("entry-agent", {
+				type: "string",
+				describe: "Name of the agent to run (defaults to the entry agent if not specified)"
+			}).option("version", {
+				type: "boolean",
+				alias: "v",
+				describe: "Show version number"
+			}).option("interactive", {
+				describe: "Run in interactive chat mode",
+				type: "boolean",
+				default: false,
+				alias: ["chat"]
+			}).help(false).version(false).strict(false);
+		},
+		handler: async (options) => {
+			if (options.version) {
+				console.log(require_constants.AIGNE_CLI_VERSION);
+				process.exit(0);
+				return;
+			}
+			if (!options.entryAgent && options.path) {
+				if (!await (0, _aigne_agent_library_utils_fs.exists)(options.path) && !require_utils_url.isUrl(options.path)) {
+					options.entryAgent = options.path;
+					options.path = void 0;
+				}
+			}
+			const path = aigneFilePath || options.path || ".";
+			if (!require_utils_url.isUrl(path) && !await (0, _aigne_core_loader.findAIGNEFile)(path).catch((error) => {
+				if (options._[0] !== "run") yargsInstance?.showHelp();
+				else throw error;
+				return false;
+			})) return;
+			const opts = require_utils_yargs.withRunAgentCommonOptions((0, yargs.default)(process.argv).help(false).version(false).strict(false)).parseSync();
+			_aigne_core_utils_logger.logger.level = opts.logLevel;
+			const { aigne } = await loadApplication(path, {
+				modelOptions: (0, _aigne_core_utils_type_utils.pick)(opts, require_constants.CHAT_MODEL_OPTIONS),
+				imageModelOptions: { model: opts.imageModel }
+			});
+			const subYargs = (0, yargs.default)().scriptName("").usage("aigne run <path> <agent> [...options]");
+			if (aigne.cli.chat) subYargs.command({
+				...require_agent.agentCommandModule({
+					aigne,
+					agent: aigne.cli.chat,
+					interactive: true
+				}),
+				command: "$0"
+			});
+			const allAgents = (0, _aigne_core_utils_type_utils.flat)(aigne.agents, aigne.skills, aigne.cli.chat, aigne.mcpServer.agents);
+			for (const agent of allAgents) subYargs.command(require_agent.agentCommandModule({
+				aigne,
+				agent,
+				interactive: options.interactive
+			}));
+			for (const cliAgent of aigne.cli.agents ?? []) subYargs.command(require_agent.cliAgentCommandModule({
+				aigne,
+				cliAgent
+			}));
+			const argv = process.argv.slice(aigneFilePath ? 3 : 2);
+			if (argv[0] === "run") argv.shift();
+			if (argv[0] === "--path" || argv[0] === "--url") argv.shift();
+			if (argv[0] === options.path) argv.shift();
+			if (argv[0] === "--entry-agent") argv.shift();
+			const firstAgent = aigne.agents[0]?.name;
+			if (!options.entryAgent && firstAgent && !argv.some((i) => ["-h", "--help"].includes(i))) argv.unshift(firstAgent);
+			await subYargs.strict().demandCommand().alias("h", "help").alias("v", "version").fail((message, error, yargs$2) => {
+				if (!error) {
+					yargs$2.showHelp();
+					console.error(`\n${message}`);
+					process.exit(1);
+				}
+			}).parseAsync(argv);
+		}
+	};
+}
+async function loadApplication(path, options = {}) {
+	const { cacheDir, dir } = prepareDirs(path);
+	if (cacheDir) await new _aigne_listr2.Listr([{
+		title: "Download package",
+		task: () => downloadPackage(path, cacheDir)
+	}, {
+		title: "Extract package",
+		task: () => extractPackage(cacheDir, dir)
+	}], { rendererOptions: {
+		collapseSubtasks: false,
+		showErrorMessage: false,
+		timer: _aigne_listr2.PRESET_TIMER
+	} }).run();
+	(0, dotenv_flow.config)({
+		path: dir,
+		silent: true
+	});
+	return {
+		aigne: await require_utils_load_aigne.loadAIGNE({
+			...options,
+			path: dir
+		}),
+		path: dir
+	};
+}
+async function downloadPackage(url, cacheDir) {
+	await (0, node_fs_promises.rm)(cacheDir, {
+		recursive: true,
+		force: true
+	});
+	await (0, node_fs_promises.mkdir)(cacheDir, { recursive: true });
+	await require_utils_download.downloadAndExtract(url, cacheDir);
+}
+async function extractPackage(cacheDir, dir) {
+	await (0, node_fs_promises.mkdir)(dir, { recursive: true });
+	if (await require_utils_agent_v1.isV1Package(cacheDir)) await require_utils_agent_v1.toAIGNEPackage(cacheDir, dir);
+	else await (0, node_fs_promises.cp)(cacheDir, dir, {
+		recursive: true,
+		force: true
+	});
+}
+function prepareDirs(path) {
+	let dir;
+	let cacheDir;
+	if (!path.startsWith("http")) dir = (0, node_path.isAbsolute)(path) ? path : (0, node_path.resolve)(process.cwd(), path);
+	else {
+		dir = getLocalPackagePathFromUrl(path);
+		cacheDir = getLocalPackagePathFromUrl(path, { subdir: ".download" });
+	}
+	return {
+		cacheDir,
+		dir
+	};
+}
+function getLocalPackagePathFromUrl(url, { subdir } = {}) {
+	const root = [
+		(0, node_os.homedir)(),
+		".aigne",
+		subdir
+	].filter(_aigne_core_utils_type_utils.isNonNullable);
+	const u = new URL(url);
+	return (0, node_path.join)(...root, u.hostname, u.pathname);
+}
+
+//#endregion
+exports.createRunCommand = createRunCommand;

package/dist/commands/run.mjs

@@ -0,0 +1,171 @@
+import { AIGNE_CLI_VERSION, CHAT_MODEL_OPTIONS } from "../constants.mjs";
+import { downloadAndExtract } from "../utils/download.mjs";
+import { loadAIGNE } from "../utils/load-aigne.mjs";
+import { isV1Package, toAIGNEPackage } from "../utils/agent-v1.mjs";
+import { isUrl } from "../utils/url.mjs";
+import { withRunAgentCommonOptions } from "../utils/yargs.mjs";
+import { agentCommandModule, cliAgentCommandModule } from "./app/agent.mjs";
+import { logger } from "@aigne/core/utils/logger";
+import { config } from "dotenv-flow";
+import yargs from "yargs";
+import { isAbsolute, join, resolve } from "node:path";
+import { cp, mkdir, rm } from "node:fs/promises";
+import { Listr, PRESET_TIMER } from "@aigne/listr2";
+import { flat, isNonNullable, pick } from "@aigne/core/utils/type-utils";
+import { homedir } from "node:os";
+import { exists } from "@aigne/agent-library/utils/fs";
+import { findAIGNEFile } from "@aigne/core/loader";
+
+//#region src/commands/run.ts
+let yargsInstance = null;
+function createRunCommand({ aigneFilePath } = {}) {
+	return {
+		command: ["run [path] [entry-agent]", "$0"],
+		describe: "Run AIGNE for the specified path",
+		builder: async (yargs$1) => {
+			yargsInstance = yargs$1;
+			return yargs$1.positional("path", {
+				type: "string",
+				describe: "Path to the agents directory or URL to an aigne project",
+				default: "."
+			}).positional("entry-agent", {
+				type: "string",
+				describe: "Name of the agent to run (defaults to the entry agent if not specified)"
+			}).option("version", {
+				type: "boolean",
+				alias: "v",
+				describe: "Show version number"
+			}).option("interactive", {
+				describe: "Run in interactive chat mode",
+				type: "boolean",
+				default: false,
+				alias: ["chat"]
+			}).help(false).version(false).strict(false);
+		},
+		handler: async (options) => {
+			if (options.version) {
+				console.log(AIGNE_CLI_VERSION);
+				process.exit(0);
+				return;
+			}
+			if (!options.entryAgent && options.path) {
+				if (!await exists(options.path) && !isUrl(options.path)) {
+					options.entryAgent = options.path;
+					options.path = void 0;
+				}
+			}
+			const path$1 = aigneFilePath || options.path || ".";
+			if (!isUrl(path$1) && !await findAIGNEFile(path$1).catch((error) => {
+				if (options._[0] !== "run") yargsInstance?.showHelp();
+				else throw error;
+				return false;
+			})) return;
+			const opts = withRunAgentCommonOptions(yargs(process.argv).help(false).version(false).strict(false)).parseSync();
+			logger.level = opts.logLevel;
+			const { aigne } = await loadApplication(path$1, {
+				modelOptions: pick(opts, CHAT_MODEL_OPTIONS),
+				imageModelOptions: { model: opts.imageModel }
+			});
+			const subYargs = yargs().scriptName("").usage("aigne run <path> <agent> [...options]");
+			if (aigne.cli.chat) subYargs.command({
+				...agentCommandModule({
+					aigne,
+					agent: aigne.cli.chat,
+					interactive: true
+				}),
+				command: "$0"
+			});
+			const allAgents = flat(aigne.agents, aigne.skills, aigne.cli.chat, aigne.mcpServer.agents);
+			for (const agent of allAgents) subYargs.command(agentCommandModule({
+				aigne,
+				agent,
+				interactive: options.interactive
+			}));
+			for (const cliAgent of aigne.cli.agents ?? []) subYargs.command(cliAgentCommandModule({
+				aigne,
+				cliAgent
+			}));
+			const argv = process.argv.slice(aigneFilePath ? 3 : 2);
+			if (argv[0] === "run") argv.shift();
+			if (argv[0] === "--path" || argv[0] === "--url") argv.shift();
+			if (argv[0] === options.path) argv.shift();
+			if (argv[0] === "--entry-agent") argv.shift();
+			const firstAgent = aigne.agents[0]?.name;
+			if (!options.entryAgent && firstAgent && !argv.some((i) => ["-h", "--help"].includes(i))) argv.unshift(firstAgent);
+			await subYargs.strict().demandCommand().alias("h", "help").alias("v", "version").fail((message, error, yargs$1) => {
+				if (!error) {
+					yargs$1.showHelp();
+					console.error(`\n${message}`);
+					process.exit(1);
+				}
+			}).parseAsync(argv);
+		}
+	};
+}
+async function loadApplication(path$1, options = {}) {
+	const { cacheDir, dir } = prepareDirs(path$1);
+	if (cacheDir) await new Listr([{
+		title: "Download package",
+		task: () => downloadPackage(path$1, cacheDir)
+	}, {
+		title: "Extract package",
+		task: () => extractPackage(cacheDir, dir)
+	}], { rendererOptions: {
+		collapseSubtasks: false,
+		showErrorMessage: false,
+		timer: PRESET_TIMER
+	} }).run();
+	config({
+		path: dir,
+		silent: true
+	});
+	return {
+		aigne: await loadAIGNE({
+			...options,
+			path: dir
+		}),
+		path: dir
+	};
+}
+async function downloadPackage(url, cacheDir) {
+	await rm(cacheDir, {
+		recursive: true,
+		force: true
+	});
+	await mkdir(cacheDir, { recursive: true });
+	await downloadAndExtract(url, cacheDir);
+}
+async function extractPackage(cacheDir, dir) {
+	await mkdir(dir, { recursive: true });
+	if (await isV1Package(cacheDir)) await toAIGNEPackage(cacheDir, dir);
+	else await cp(cacheDir, dir, {
+		recursive: true,
+		force: true
+	});
+}
+function prepareDirs(path$1) {
+	let dir;
+	let cacheDir;
+	if (!path$1.startsWith("http")) dir = isAbsolute(path$1) ? path$1 : resolve(process.cwd(), path$1);
+	else {
+		dir = getLocalPackagePathFromUrl(path$1);
+		cacheDir = getLocalPackagePathFromUrl(path$1, { subdir: ".download" });
+	}
+	return {
+		cacheDir,
+		dir
+	};
+}
+function getLocalPackagePathFromUrl(url, { subdir } = {}) {
+	const root = [
+		homedir(),
+		".aigne",
+		subdir
+	].filter(isNonNullable);
+	const u = new URL(url);
+	return join(...root, u.hostname, u.pathname);
+}
+
+//#endregion
+export { createRunCommand };
+//# sourceMappingURL=run.mjs.map

package/dist/commands/run.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.mjs","names":["yargs","path"],"sources":["../../src/commands/run.ts"],"sourcesContent":["import { cp, mkdir, rm } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { isAbsolute, join, resolve } from \"node:path\";\nimport { exists } from \"@aigne/agent-library/utils/fs\";\nimport { findAIGNEFile } from \"@aigne/core/loader\";\nimport { logger } from \"@aigne/core/utils/logger\";\nimport { flat, isNonNullable, pick } from \"@aigne/core/utils/type-utils\";\nimport { Listr, PRESET_TIMER } from \"@aigne/listr2\";\nimport { config } from \"dotenv-flow\";\nimport type { Argv, CommandModule } from \"yargs\";\nimport yargs from \"yargs\";\nimport { AIGNE_CLI_VERSION, CHAT_MODEL_OPTIONS } from \"../constants.js\";\nimport { isV1Package, toAIGNEPackage } from \"../utils/agent-v1.js\";\nimport { downloadAndExtract } from \"../utils/download.js\";\nimport { loadAIGNE } from \"../utils/load-aigne.js\";\nimport { isUrl } from \"../utils/url.js\";\nimport { withRunAgentCommonOptions } from \"../utils/yargs.js\";\nimport { agentCommandModule, cliAgentCommandModule } from \"./app/agent.js\";\n\nlet yargsInstance: Argv | null = null;\n\nexport function createRunCommand({\n  aigneFilePath,\n}: {\n  aigneFilePath?: string;\n} = {}): CommandModule<\n  unknown,\n  { version?: boolean; path?: string; entryAgent?: string; interactive?: boolean }\n> {\n  return {\n    // $0 must place after 'run' to make positional args work correctly\n    command: [\"run [path] [entry-agent]\", \"$0\"],\n    describe: \"Run AIGNE for the specified path\",\n    builder: async (yargs) => {\n      yargsInstance = yargs;\n\n      return yargs\n        .positional(\"path\", {\n          type: \"string\",\n          describe: \"Path to the agents directory or URL to an aigne project\",\n          default: \".\",\n        })\n        .positional(\"entry-agent\", {\n          type: \"string\",\n          describe: \"Name of the agent to run (defaults to the entry agent if not specified)\",\n        })\n        .option(\"version\", {\n          type: \"boolean\",\n          alias: \"v\",\n          describe: \"Show version number\",\n        })\n        .option(\"interactive\", {\n          describe: \"Run in interactive chat mode\",\n          type: \"boolean\",\n          default: false,\n          alias: [\"chat\"],\n        })\n        .help(false)\n        .version(false)\n        .strict(false);\n    },\n    handler: async (options) => {\n      if (options.version) {\n        console.log(AIGNE_CLI_VERSION);\n        process.exit(0);\n        return;\n      }\n\n      if (!options.entryAgent && options.path) {\n        if (!(await exists(options.path)) && !isUrl(options.path)) {\n          options.entryAgent = options.path;\n          options.path = undefined;\n        }\n      }\n\n      const path = aigneFilePath || options.path || \".\";\n      if (\n        !isUrl(path) &&\n        !(await findAIGNEFile(path).catch((error) => {\n          if (options._[0] !== \"run\") {\n            yargsInstance?.showHelp();\n          } else {\n            throw error;\n          }\n          return false;\n        }))\n      ) {\n        return;\n      }\n\n      // Parse model options for loading application\n      const opts = withRunAgentCommonOptions(\n        yargs(process.argv).help(false).version(false).strict(false),\n      ).parseSync();\n      logger.level = opts.logLevel;\n\n      const { aigne } = await loadApplication(path, {\n        modelOptions: pick(opts, CHAT_MODEL_OPTIONS),\n        imageModelOptions: { model: opts.imageModel },\n      });\n\n      const subYargs = yargs().scriptName(\"\").usage(\"aigne run <path> <agent> [...options]\");\n\n      if (aigne.cli.chat) {\n        subYargs.command({\n          ...agentCommandModule({ aigne, agent: aigne.cli.chat, interactive: true }),\n          command: \"$0\",\n        });\n      }\n\n      // Allow user to run all of agents in the AIGNE instances\n      const allAgents = flat(aigne.agents, aigne.skills, aigne.cli.chat, aigne.mcpServer.agents);\n      for (const agent of allAgents) {\n        subYargs.command(agentCommandModule({ aigne, agent, interactive: options.interactive }));\n      }\n\n      for (const cliAgent of aigne.cli.agents ?? []) {\n        subYargs.command(\n          cliAgentCommandModule({\n            aigne,\n            cliAgent,\n          }),\n        );\n      }\n\n      const argv = process.argv.slice(aigneFilePath ? 3 : 2);\n      if (argv[0] === \"run\") argv.shift(); // remove 'run' command\n\n      // For compatibility with old `run` command like: `aigne run --path /xx/xx --entry-agent xx --xx`\n      if (argv[0] === \"--path\" || argv[0] === \"--url\") argv.shift(); // remove --path flag\n      if (argv[0] === options.path) argv.shift(); // remove path/url args\n      if (argv[0] === \"--entry-agent\") argv.shift();\n\n      const firstAgent = aigne.agents[0]?.name;\n      if (!options.entryAgent && firstAgent && !argv.some((i) => [\"-h\", \"--help\"].includes(i))) {\n        argv.unshift(firstAgent);\n      }\n\n      await subYargs\n        .strict()\n        .demandCommand()\n        .alias(\"h\", \"help\")\n        .alias(\"v\", \"version\")\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    },\n  };\n}\n\nasync function loadApplication(path: string, options: Parameters<typeof loadAIGNE>[0] = {}) {\n  const { cacheDir, dir } = prepareDirs(path);\n\n  if (cacheDir) {\n    await new Listr(\n      [\n        {\n          title: \"Download package\",\n          task: () => downloadPackage(path, cacheDir),\n        },\n        {\n          title: \"Extract package\",\n          task: () => extractPackage(cacheDir, dir),\n        },\n      ],\n      {\n        rendererOptions: {\n          collapseSubtasks: false,\n          showErrorMessage: false,\n          timer: PRESET_TIMER,\n        },\n      },\n    ).run();\n  }\n\n  // Load env files in the aigne directory\n  config({ path: dir, silent: true });\n\n  const aigne = await loadAIGNE({ ...options, path: dir });\n\n  return { aigne, path: dir };\n}\n\nasync function downloadPackage(url: string, cacheDir: string) {\n  await rm(cacheDir, { recursive: true, force: true });\n\n  await mkdir(cacheDir, { recursive: true });\n\n  await downloadAndExtract(url, cacheDir);\n}\n\nasync function extractPackage(cacheDir: string, dir: string) {\n  await mkdir(dir, { recursive: true });\n\n  if (await isV1Package(cacheDir)) {\n    await toAIGNEPackage(cacheDir, dir);\n  } else {\n    await cp(cacheDir, dir, { recursive: true, force: true });\n  }\n}\n\nfunction prepareDirs(path: string) {\n  let dir: string;\n  let cacheDir: string | undefined;\n\n  if (!path.startsWith(\"http\")) {\n    dir = isAbsolute(path) ? path : resolve(process.cwd(), path);\n  } else {\n    dir = getLocalPackagePathFromUrl(path);\n    cacheDir = getLocalPackagePathFromUrl(path, { subdir: \".download\" });\n  }\n\n  return { cacheDir, dir };\n}\n\nfunction getLocalPackagePathFromUrl(url: string, { subdir }: { subdir?: string } = {}) {\n  const root = [homedir(), \".aigne\", subdir].filter(isNonNullable);\n  const u = new URL(url);\n  return join(...root, u.hostname, u.pathname);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,IAAI,gBAA6B;AAEjC,SAAgB,iBAAiB,EAC/B,kBAGE,EAAE,EAGJ;AACA,QAAO;EAEL,SAAS,CAAC,4BAA4B,KAAK;EAC3C,UAAU;EACV,SAAS,OAAO,YAAU;AACxB,mBAAgBA;AAEhB,UAAOA,QACJ,WAAW,QAAQ;IAClB,MAAM;IACN,UAAU;IACV,SAAS;IACV,CAAC,CACD,WAAW,eAAe;IACzB,MAAM;IACN,UAAU;IACX,CAAC,CACD,OAAO,WAAW;IACjB,MAAM;IACN,OAAO;IACP,UAAU;IACX,CAAC,CACD,OAAO,eAAe;IACrB,UAAU;IACV,MAAM;IACN,SAAS;IACT,OAAO,CAAC,OAAO;IAChB,CAAC,CACD,KAAK,MAAM,CACX,QAAQ,MAAM,CACd,OAAO,MAAM;;EAElB,SAAS,OAAO,YAAY;AAC1B,OAAI,QAAQ,SAAS;AACnB,YAAQ,IAAI,kBAAkB;AAC9B,YAAQ,KAAK,EAAE;AACf;;AAGF,OAAI,CAAC,QAAQ,cAAc,QAAQ,MACjC;QAAI,CAAE,MAAM,OAAO,QAAQ,KAAK,IAAK,CAAC,MAAM,QAAQ,KAAK,EAAE;AACzD,aAAQ,aAAa,QAAQ;AAC7B,aAAQ,OAAO;;;GAInB,MAAMC,SAAO,iBAAiB,QAAQ,QAAQ;AAC9C,OACE,CAAC,MAAMA,OAAK,IACZ,CAAE,MAAM,cAAcA,OAAK,CAAC,OAAO,UAAU;AAC3C,QAAI,QAAQ,EAAE,OAAO,MACnB,gBAAe,UAAU;QAEzB,OAAM;AAER,WAAO;KACP,CAEF;GAIF,MAAM,OAAO,0BACX,MAAM,QAAQ,KAAK,CAAC,KAAK,MAAM,CAAC,QAAQ,MAAM,CAAC,OAAO,MAAM,CAC7D,CAAC,WAAW;AACb,UAAO,QAAQ,KAAK;GAEpB,MAAM,EAAE,UAAU,MAAM,gBAAgBA,QAAM;IAC5C,cAAc,KAAK,MAAM,mBAAmB;IAC5C,mBAAmB,EAAE,OAAO,KAAK,YAAY;IAC9C,CAAC;GAEF,MAAM,WAAW,OAAO,CAAC,WAAW,GAAG,CAAC,MAAM,wCAAwC;AAEtF,OAAI,MAAM,IAAI,KACZ,UAAS,QAAQ;IACf,GAAG,mBAAmB;KAAE;KAAO,OAAO,MAAM,IAAI;KAAM,aAAa;KAAM,CAAC;IAC1E,SAAS;IACV,CAAC;GAIJ,MAAM,YAAY,KAAK,MAAM,QAAQ,MAAM,QAAQ,MAAM,IAAI,MAAM,MAAM,UAAU,OAAO;AAC1F,QAAK,MAAM,SAAS,UAClB,UAAS,QAAQ,mBAAmB;IAAE;IAAO;IAAO,aAAa,QAAQ;IAAa,CAAC,CAAC;AAG1F,QAAK,MAAM,YAAY,MAAM,IAAI,UAAU,EAAE,CAC3C,UAAS,QACP,sBAAsB;IACpB;IACA;IACD,CAAC,CACH;GAGH,MAAM,OAAO,QAAQ,KAAK,MAAM,gBAAgB,IAAI,EAAE;AACtD,OAAI,KAAK,OAAO,MAAO,MAAK,OAAO;AAGnC,OAAI,KAAK,OAAO,YAAY,KAAK,OAAO,QAAS,MAAK,OAAO;AAC7D,OAAI,KAAK,OAAO,QAAQ,KAAM,MAAK,OAAO;AAC1C,OAAI,KAAK,OAAO,gBAAiB,MAAK,OAAO;GAE7C,MAAM,aAAa,MAAM,OAAO,IAAI;AACpC,OAAI,CAAC,QAAQ,cAAc,cAAc,CAAC,KAAK,MAAM,MAAM,CAAC,MAAM,SAAS,CAAC,SAAS,EAAE,CAAC,CACtF,MAAK,QAAQ,WAAW;AAG1B,SAAM,SACH,QAAQ,CACR,eAAe,CACf,MAAM,KAAK,OAAO,CAClB,MAAM,KAAK,UAAU,CACrB,MAAM,SAAS,OAAO,YAAU;AAE/B,QAAI,CAAC,OAAO;AACV,aAAM,UAAU;AAEhB,aAAQ,MAAM,KAAK,UAAU;AAC7B,aAAQ,KAAK,EAAE;;KAEjB,CACD,WAAW,KAAK;;EAEtB;;AAGH,eAAe,gBAAgB,QAAc,UAA2C,EAAE,EAAE;CAC1F,MAAM,EAAE,UAAU,QAAQ,YAAYA,OAAK;AAE3C,KAAI,SACF,OAAM,IAAI,MACR,CACE;EACE,OAAO;EACP,YAAY,gBAAgBA,QAAM,SAAS;EAC5C,EACD;EACE,OAAO;EACP,YAAY,eAAe,UAAU,IAAI;EAC1C,CACF,EACD,EACE,iBAAiB;EACf,kBAAkB;EAClB,kBAAkB;EAClB,OAAO;EACR,EACF,CACF,CAAC,KAAK;AAIT,QAAO;EAAE,MAAM;EAAK,QAAQ;EAAM,CAAC;AAInC,QAAO;EAAE,OAFK,MAAM,UAAU;GAAE,GAAG;GAAS,MAAM;GAAK,CAAC;EAExC,MAAM;EAAK;;AAG7B,eAAe,gBAAgB,KAAa,UAAkB;AAC5D,OAAM,GAAG,UAAU;EAAE,WAAW;EAAM,OAAO;EAAM,CAAC;AAEpD,OAAM,MAAM,UAAU,EAAE,WAAW,MAAM,CAAC;AAE1C,OAAM,mBAAmB,KAAK,SAAS;;AAGzC,eAAe,eAAe,UAAkB,KAAa;AAC3D,OAAM,MAAM,KAAK,EAAE,WAAW,MAAM,CAAC;AAErC,KAAI,MAAM,YAAY,SAAS,CAC7B,OAAM,eAAe,UAAU,IAAI;KAEnC,OAAM,GAAG,UAAU,KAAK;EAAE,WAAW;EAAM,OAAO;EAAM,CAAC;;AAI7D,SAAS,YAAY,QAAc;CACjC,IAAI;CACJ,IAAI;AAEJ,KAAI,CAACA,OAAK,WAAW,OAAO,CAC1B,OAAM,WAAWA,OAAK,GAAGA,SAAO,QAAQ,QAAQ,KAAK,EAAEA,OAAK;MACvD;AACL,QAAM,2BAA2BA,OAAK;AACtC,aAAW,2BAA2BA,QAAM,EAAE,QAAQ,aAAa,CAAC;;AAGtE,QAAO;EAAE;EAAU;EAAK;;AAG1B,SAAS,2BAA2B,KAAa,EAAE,WAAgC,EAAE,EAAE;CACrF,MAAM,OAAO;EAAC,SAAS;EAAE;EAAU;EAAO,CAAC,OAAO,cAAc;CAChE,MAAM,IAAI,IAAI,IAAI,IAAI;AACtB,QAAO,KAAK,GAAG,MAAM,EAAE,UAAU,EAAE,SAAS"}

package/dist/commands/serve-mcp.cjs

@@ -0,0 +1,68 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_utils_load_aigne = require('../utils/load-aigne.cjs');
+const require_utils_serve_mcp = require('../utils/serve-mcp.cjs');
+let node_path = require("node:path");
+let _aigne_core_utils_type_utils = require("@aigne/core/utils/type-utils");
+
+//#region src/commands/serve-mcp.ts
+const DEFAULT_PORT = () => (0, _aigne_core_utils_type_utils.tryOrThrow)(() => {
+	const { PORT } = process.env;
+	if (!PORT) return 3e3;
+	const port = Number.parseInt(PORT, 10);
+	if (!port || !Number.isInteger(port)) throw new Error(`Invalid PORT: ${PORT}`);
+	return port;
+}, (error) => /* @__PURE__ */ new Error(`parse PORT error ${error.message}`));
+function createServeMCPCommand({ aigneFilePath } = {}) {
+	return {
+		command: "serve-mcp",
+		describe: "Serve the agents in the specified directory as a MCP server (streamable http)",
+		builder: (yargs) => {
+			return yargs.option("path", {
+				describe: "Path to the agents directory or URL to aigne project",
+				type: "string",
+				default: ".",
+				alias: ["url"]
+			}).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"
+			}).option("aigne-hub-url", {
+				describe: "Custom AIGNE Hub service URL. Used to fetch remote agent definitions or models. ",
+				type: "string"
+			});
+		},
+		handler: async (options) => {
+			const path = aigneFilePath || options.path;
+			const aigne = await require_utils_load_aigne.loadAIGNE({
+				path: (0, node_path.isAbsolute)(path) ? path : (0, node_path.resolve)(process.cwd(), path),
+				modelOptions: { aigneHubUrl: options.aigneHubUrl }
+			});
+			await serveMCPServerFromDir({
+				...options,
+				aigne
+			});
+		}
+	};
+}
+async function serveMCPServerFromDir(options) {
+	const port = options.port || DEFAULT_PORT();
+	await require_utils_serve_mcp.serveMCPServer({
+		aigne: options.aigne,
+		host: options.host,
+		port,
+		pathname: options.pathname
+	});
+	console.log(`MCP server is running on http://${options.host}:${port}${options.pathname}`);
+	if (!process.env.CI && process.env.NODE_ENV !== "test") await new Promise(() => {});
+}
+
+//#endregion
+exports.createServeMCPCommand = createServeMCPCommand;
+exports.serveMCPServerFromDir = serveMCPServerFromDir;