@aigne/cli 1.74.0-beta → 1.74.0-beta.2

package/dist/commands/observe.mjs

@@ -1,3 +1,5 @@
+import { formatJSON, formatLLMDSL } from "../utils/output.mjs";
+import { createViewContext, detectView } from "../utils/view.mjs";
 import chalk from "chalk";
 import { tryOrThrow } from "@aigne/core/utils/type-utils";
 import { startObservabilityCLIServer } from "@aigne/observability-api/cli";
@@ -24,15 +26,56 @@ function createObservabilityCommand() {
 			}).option("port", {
 				type: "number",
 				describe: "Port to run the observability server on"
+			}).option("json", {
+				type: "boolean",
+				describe: "Output in JSON format",
+				default: false
+			}).option("view", {
+				type: "string",
+				describe: "Output view type (human, json, llm, default)",
+				choices: [
+					"default",
+					"json",
+					"llm",
+					"human"
+				]
 			});
 		},
 		handler: async (options) => {
 			const port = await detectPort(options.port || DEFAULT_PORT());
 			const dbUrl = getObservabilityDbPath();
+			const view = detectView({
+				view: options.view,
+				json: options.json
+			}, {}, createViewContext());
 			process.once("SIGINT", async () => {
 				process.exit(0);
 			});
-			console.log("Observability database path:", chalk.greenBright(dbUrl));
+			const serverInfo = {
+				status: "running",
+				url: `http://${options.host}:${port}`,
+				host: options.host,
+				port,
+				dbPath: dbUrl
+			};
+			switch (view) {
+				case "json":
+					console.log(formatJSON(serverInfo));
+					break;
+				case "llm":
+				case "default":
+					console.log(formatLLMDSL(serverInfo, [
+						"status",
+						"url",
+						"host",
+						"port",
+						"dbPath"
+					]));
+					break;
+				default:
+					console.log("Observability database path:", chalk.greenBright(dbUrl));
+					break;
+			}
 			await startObservabilityCLIServer({
 				port,
 				dbUrl

package/dist/commands/observe.mjs.map

@@ -1 +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"}
+{"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\";\nimport { formatJSON, formatLLMDSL } from \"../utils/output.js\";\nimport { createViewContext, detectView, type ViewType } from \"../utils/view.js\";\n\ninterface ServeMCPOptions {\n  host: string;\n  port?: number;\n  json?: boolean;\n  view?: ViewType;\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        .option(\"json\", {\n          type: \"boolean\",\n          describe: \"Output in JSON format\",\n          default: false,\n        })\n        .option(\"view\", {\n          type: \"string\",\n          describe: \"Output view type (human, json, llm, default)\",\n          choices: [\"default\", \"json\", \"llm\", \"human\"] as const,\n        });\n    },\n    handler: async (options) => {\n      const port = await detectPort(options.port || DEFAULT_PORT());\n      const dbUrl = getObservabilityDbPath();\n\n      // Detect view based on options and context\n      const view = detectView(\n        { view: options.view as ViewType, json: options.json },\n        {},\n        createViewContext(),\n      );\n\n      process.once(\"SIGINT\", async () => {\n        process.exit(0);\n      });\n\n      const serverInfo = {\n        status: \"running\",\n        url: `http://${options.host}:${port}`,\n        host: options.host,\n        port,\n        dbPath: dbUrl,\n      };\n\n      switch (view) {\n        case \"json\":\n          console.log(formatJSON(serverInfo));\n          break;\n        case \"llm\":\n        case \"default\":\n          console.log(formatLLMDSL(serverInfo, [\"status\", \"url\", \"host\", \"port\", \"dbPath\"]));\n          break;\n        default:\n          console.log(\"Observability database path:\", chalk.greenBright(dbUrl));\n          break;\n      }\n\n      await startObservabilityCLIServer({ port, dbUrl });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AAgBA,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,CACD,OAAO,QAAQ;IACd,MAAM;IACN,UAAU;IACV,SAAS;IACV,CAAC,CACD,OAAO,QAAQ;IACd,MAAM;IACN,UAAU;IACV,SAAS;KAAC;KAAW;KAAQ;KAAO;KAAQ;IAC7C,CAAC;;EAEN,SAAS,OAAO,YAAY;GAC1B,MAAM,OAAO,MAAM,WAAW,QAAQ,QAAQ,cAAc,CAAC;GAC7D,MAAM,QAAQ,wBAAwB;GAGtC,MAAM,OAAO,WACX;IAAE,MAAM,QAAQ;IAAkB,MAAM,QAAQ;IAAM,EACtD,EAAE,EACF,mBAAmB,CACpB;AAED,WAAQ,KAAK,UAAU,YAAY;AACjC,YAAQ,KAAK,EAAE;KACf;GAEF,MAAM,aAAa;IACjB,QAAQ;IACR,KAAK,UAAU,QAAQ,KAAK,GAAG;IAC/B,MAAM,QAAQ;IACd;IACA,QAAQ;IACT;AAED,WAAQ,MAAR;IACE,KAAK;AACH,aAAQ,IAAI,WAAW,WAAW,CAAC;AACnC;IACF,KAAK;IACL,KAAK;AACH,aAAQ,IAAI,aAAa,YAAY;MAAC;MAAU;MAAO;MAAQ;MAAQ;MAAS,CAAC,CAAC;AAClF;IACF;AACE,aAAQ,IAAI,gCAAgC,MAAM,YAAY,MAAM,CAAC;AACrE;;AAGJ,SAAM,4BAA4B;IAAE;IAAM;IAAO,CAAC;;EAErD"}

package/dist/commands/run-skill.cjs

@@ -2,9 +2,10 @@ 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 _aigne_core_utils_logger = require("@aigne/core/utils/logger");
 let node_path = require("node:path");
-let _aigne_core = require("@aigne/core");
 let zod = require("zod");
+let _aigne_core = require("@aigne/core");
 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");
@@ -15,28 +16,43 @@ 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
+/**
+* Creates the 'run skill' subcommand for running Agent Skills.
+*
+* Usage:
+*   aigne run skill <path...> [options]
+*
+* Examples:
+*   aigne run skill ./my-skill
+*   aigne run skill ./skill1 ./skill2 --interactive
+*   aigne run skill ./skill -i "hello"
+*/
 function createRunSkillCommand() {
 	return {
-		command: ["run-skill"],
-		describe: "Run Agent Skill for the specified path",
+		command: "skill <paths..>",
+		describe: "Run Agent Skills from specified directories",
 		builder: async (yargs) => {
-			return require_utils_yargs.withAgentInputSchema(yargs.option("skill", {
-				array: true,
+			return require_utils_yargs.withAgentInputSchema(yargs.positional("paths", {
 				type: "string",
-				describe: "Path to the Agent Skill directory"
+				array: true,
+				describe: "Paths to Agent Skill directories"
 			}).option("interactive", {
 				describe: "Run in interactive chat mode",
 				type: "boolean",
 				default: false,
 				alias: ["chat"]
-			}).demandOption("skill"), {
-				inputSchema: zod.z.object({ message: zod.z.string() }),
+			}).example("$0 run skill ./my-skill", "Run a single skill").example("$0 run skill ./skill1 ./skill2", "Run multiple skills").example("$0 run skill ./skill --interactive", "Run skill in interactive mode").example("$0 run skill ./skill -i \"hello world\"", "Run skill with input"), {
+				inputSchema: zod.z.object({ message: zod.z.string().describe("Input message for the skill") }),
 				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" }) });
+			if (!Array.isArray(options.paths) || options.paths.length === 0) throw new Error("At least one skill path must be provided.");
+			if (options.logLevel) _aigne_core_utils_logger.logger.level = options.logLevel;
+			const aigne = new _aigne_core.AIGNE({ model: await require_utils_aigne_hub_model.loadChatModel({
+				model: options.model || "aignehub/anthropic/claude-sonnet-4-5",
+				aigneHubUrl: options.aigneHubUrl
+			}) });
 			const approvedCmds = /* @__PURE__ */ new Set();
 			await require_agent.invokeAgent({
 				aigne,
@@ -47,9 +63,9 @@ function createRunSkillCommand() {
 						sandbox: false,
 						permissions: {
 							defaultMode: "ask",
-							guard: _aigne_core.FunctionAgent.from(async (input, options$1) => {
+							guard: _aigne_core.FunctionAgent.from(async (input, ctx) => {
 								if (approvedCmds.has(input.script || "")) return { approved: true };
-								const confirm = options$1.prompts?.confirm;
+								const confirm = ctx.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);
@@ -66,7 +82,7 @@ function createRunSkillCommand() {
 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({
+						...options.paths.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.",

package/dist/commands/run-skill.mjs

@@ -1,9 +1,10 @@
 import { loadChatModel } from "../utils/aigne-hub/model.mjs";
 import { withAgentInputSchema } from "../utils/yargs.mjs";
 import { invokeAgent } from "./app/agent.mjs";
+import { logger } from "@aigne/core/utils/logger";
 import { basename, resolve } from "node:path";
-import { AIGNE, FunctionAgent } from "@aigne/core";
 import { z as z$1 } from "zod";
+import { AIGNE, FunctionAgent } from "@aigne/core";
 import { AFSHistory } from "@aigne/afs-history";
 import { LocalFS } from "@aigne/afs-local-fs";
 import AgentSkillManager from "@aigne/agent-library/agent-skill-manager";
@@ -11,28 +12,43 @@ import AskUserQuestion from "@aigne/agent-library/ask-user-question";
 import BashAgent from "@aigne/agent-library/bash";
 
 //#region src/commands/run-skill.ts
+/**
+* Creates the 'run skill' subcommand for running Agent Skills.
+*
+* Usage:
+*   aigne run skill <path...> [options]
+*
+* Examples:
+*   aigne run skill ./my-skill
+*   aigne run skill ./skill1 ./skill2 --interactive
+*   aigne run skill ./skill -i "hello"
+*/
 function createRunSkillCommand() {
 	return {
-		command: ["run-skill"],
-		describe: "Run Agent Skill for the specified path",
+		command: "skill <paths..>",
+		describe: "Run Agent Skills from specified directories",
 		builder: async (yargs) => {
-			return withAgentInputSchema(yargs.option("skill", {
-				array: true,
+			return withAgentInputSchema(yargs.positional("paths", {
 				type: "string",
-				describe: "Path to the Agent Skill directory"
+				array: true,
+				describe: "Paths to Agent Skill directories"
 			}).option("interactive", {
 				describe: "Run in interactive chat mode",
 				type: "boolean",
 				default: false,
 				alias: ["chat"]
-			}).demandOption("skill"), {
-				inputSchema: z$1.object({ message: z$1.string() }),
+			}).example("$0 run skill ./my-skill", "Run a single skill").example("$0 run skill ./skill1 ./skill2", "Run multiple skills").example("$0 run skill ./skill --interactive", "Run skill in interactive mode").example("$0 run skill ./skill -i \"hello world\"", "Run skill with input"), {
+				inputSchema: z$1.object({ message: z$1.string().describe("Input message for the skill") }),
 				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" }) });
+			if (!Array.isArray(options.paths) || options.paths.length === 0) throw new Error("At least one skill path must be provided.");
+			if (options.logLevel) logger.level = options.logLevel;
+			const aigne = new AIGNE({ model: await loadChatModel({
+				model: options.model || "aignehub/anthropic/claude-sonnet-4-5",
+				aigneHubUrl: options.aigneHubUrl
+			}) });
 			const approvedCmds = /* @__PURE__ */ new Set();
 			await invokeAgent({
 				aigne,
@@ -43,9 +59,9 @@ function createRunSkillCommand() {
 						sandbox: false,
 						permissions: {
 							defaultMode: "ask",
-							guard: FunctionAgent.from(async (input, options$1) => {
+							guard: FunctionAgent.from(async (input, ctx) => {
 								if (approvedCmds.has(input.script || "")) return { approved: true };
-								const confirm = options$1.prompts?.confirm;
+								const confirm = ctx.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);
@@ -62,7 +78,7 @@ function createRunSkillCommand() {
 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({
+						...options.paths.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.",

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

@@ -1 +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"}
+{"version":3,"file":"run-skill.mjs","names":["z","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 { logger } from \"@aigne/core/utils/logger\";\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\n/**\n * Creates the 'run skill' subcommand for running Agent Skills.\n *\n * Usage:\n *   aigne run skill <path...> [options]\n *\n * Examples:\n *   aigne run skill ./my-skill\n *   aigne run skill ./skill1 ./skill2 --interactive\n *   aigne run skill ./skill -i \"hello\"\n */\nexport function createRunSkillCommand(): CommandModule<\n  unknown,\n  { paths?: string[]; interactive?: boolean } & AgentRunCommonOptions\n> {\n  return {\n    command: \"skill <paths..>\",\n    describe: \"Run Agent Skills from specified directories\",\n    builder: async (yargs) => {\n      return withAgentInputSchema(\n        yargs\n          .positional(\"paths\", {\n            type: \"string\",\n            array: true,\n            describe: \"Paths to Agent Skill directories\",\n          })\n          .option(\"interactive\", {\n            describe: \"Run in interactive chat mode\",\n            type: \"boolean\",\n            default: false,\n            alias: [\"chat\"],\n          })\n          .example(\"$0 run skill ./my-skill\", \"Run a single skill\")\n          .example(\"$0 run skill ./skill1 ./skill2\", \"Run multiple skills\")\n          .example(\"$0 run skill ./skill --interactive\", \"Run skill in interactive mode\")\n          .example('$0 run skill ./skill -i \"hello world\"', \"Run skill with input\"),\n        {\n          inputSchema: z.object({\n            message: z.string().describe(\"Input message for the skill\"),\n          }),\n          optionalInputs: [\"message\"],\n        },\n      );\n    },\n    handler: async (options) => {\n      if (!Array.isArray(options.paths) || options.paths.length === 0) {\n        throw new Error(\"At least one skill path must be provided.\");\n      }\n\n      if (options.logLevel) logger.level = options.logLevel;\n\n      const model = await loadChatModel({\n        model: options.model || \"aignehub/anthropic/claude-sonnet-4-5\",\n        aigneHubUrl: options.aigneHubUrl,\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, ctx) => {\n                if (approvedCmds.has(input.script || \"\")) {\n                  return {\n                    approved: true,\n                  };\n                }\n\n                const confirm = ctx.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.paths.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":";;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,wBAGd;AACA,QAAO;EACL,SAAS;EACT,UAAU;EACV,SAAS,OAAO,UAAU;AACxB,UAAO,qBACL,MACG,WAAW,SAAS;IACnB,MAAM;IACN,OAAO;IACP,UAAU;IACX,CAAC,CACD,OAAO,eAAe;IACrB,UAAU;IACV,MAAM;IACN,SAAS;IACT,OAAO,CAAC,OAAO;IAChB,CAAC,CACD,QAAQ,2BAA2B,qBAAqB,CACxD,QAAQ,kCAAkC,sBAAsB,CAChE,QAAQ,sCAAsC,gCAAgC,CAC9E,QAAQ,2CAAyC,uBAAuB,EAC3E;IACE,aAAaA,IAAE,OAAO,EACpB,SAASA,IAAE,QAAQ,CAAC,SAAS,8BAA8B,EAC5D,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;AAG9D,OAAI,QAAQ,SAAU,QAAO,QAAQ,QAAQ;GAO7C,MAAM,QAAQ,IAAI,MAAM,EAAE,OALZ,MAAM,cAAc;IAChC,OAAO,QAAQ,SAAS;IACxB,aAAa,QAAQ;IACtB,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,QAAQ;AAC9C,YAAI,aAAa,IAAI,MAAM,UAAU,GAAG,CACtC,QAAO,EACL,UAAU,MACX;QAGH,MAAM,UAAU,IAAI,SAAS;AAC7B,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

@@ -1,21 +1,22 @@
 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_download = require('../utils/download.cjs');
 const require_utils_url = require('../utils/url.cjs');
 const require_utils_yargs = require('../utils/yargs.cjs');
 const require_agent = require('./app/agent.cjs');
+const require_run_skill = require('./run-skill.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 node_path = require("node:path");
+let _aigne_agent_library_utils_fs = require("@aigne/agent-library/utils/fs");
 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
@@ -42,7 +43,7 @@ function createRunCommand({ aigneFilePath } = {}) {
 				type: "boolean",
 				default: false,
 				alias: ["chat"]
-			}).help(false).version(false).strict(false);
+			}).command(require_run_skill.createRunSkillCommand()).help(false).version(false).strict(false);
 		},
 		handler: async (options) => {
 			if (options.version) {

package/dist/commands/run.mjs

@@ -1,19 +1,20 @@
 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 { downloadAndExtract } from "../utils/download.mjs";
 import { isUrl } from "../utils/url.mjs";
 import { withRunAgentCommonOptions } from "../utils/yargs.mjs";
 import { agentCommandModule, cliAgentCommandModule } from "./app/agent.mjs";
+import { createRunSkillCommand } from "./run-skill.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 { isAbsolute, join, resolve } from "node:path";
+import { exists } from "@aigne/agent-library/utils/fs";
 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
@@ -40,7 +41,7 @@ function createRunCommand({ aigneFilePath } = {}) {
 				type: "boolean",
 				default: false,
 				alias: ["chat"]
-			}).help(false).version(false).strict(false);
+			}).command(createRunSkillCommand()).help(false).version(false).strict(false);
 		},
 		handler: async (options) => {
 			if (options.version) {

package/dist/commands/run.mjs.map

@@ -1 +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":"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"}
+{"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\";\nimport { createRunSkillCommand } from \"./run-skill.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        .command(createRunSkillCommand())\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":"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"}

package/dist/commands/serve-mcp.cjs

@@ -1,5 +1,7 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_utils_output = require('../utils/output.cjs');
 const require_utils_load_aigne = require('../utils/load-aigne.cjs');
+const require_utils_view = require('../utils/view.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");
@@ -36,6 +38,19 @@ function createServeMCPCommand({ aigneFilePath } = {}) {
 			}).option("aigne-hub-url", {
 				describe: "Custom AIGNE Hub service URL. Used to fetch remote agent definitions or models. ",
 				type: "string"
+			}).option("json", {
+				type: "boolean",
+				describe: "Output in JSON format",
+				default: false
+			}).option("view", {
+				type: "string",
+				describe: "Output view type (human, json, llm, default)",
+				choices: [
+					"default",
+					"json",
+					"llm",
+					"human"
+				]
 			});
 		},
 		handler: async (options) => {
@@ -44,25 +59,55 @@ function createServeMCPCommand({ aigneFilePath } = {}) {
 				path: (0, node_path.isAbsolute)(path) ? path : (0, node_path.resolve)(process.cwd(), path),
 				modelOptions: { aigneHubUrl: options.aigneHubUrl }
 			});
+			const view = require_utils_view.detectView({
+				view: options.view,
+				json: options.json
+			}, {}, require_utils_view.createViewContext());
 			await serveMCPServerFromDir({
 				...options,
-				aigne
+				aigne,
+				view
 			});
 		}
 	};
 }
 async function serveMCPServerFromDir(options) {
 	const port = options.port || DEFAULT_PORT();
+	const view = options.view ?? "human";
 	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}`);
+	const url = `http://${options.host}:${port}${options.pathname}`;
+	const serverInfo = {
+		status: "running",
+		url,
+		host: options.host,
+		port,
+		pathname: options.pathname
+	};
+	switch (view) {
+		case "json":
+			console.log(require_utils_output.formatJSON(serverInfo));
+			break;
+		case "llm":
+		case "default":
+			console.log(require_utils_output.formatLLMDSL(serverInfo, [
+				"status",
+				"url",
+				"host",
+				"port",
+				"pathname"
+			]));
+			break;
+		default:
+			console.log(`MCP server is running on ${url}`);
+			break;
+	}
 	if (!process.env.CI && process.env.NODE_ENV !== "test") await new Promise(() => {});
 }
 
 //#endregion
-exports.createServeMCPCommand = createServeMCPCommand;
-exports.serveMCPServerFromDir = serveMCPServerFromDir;
+exports.createServeMCPCommand = createServeMCPCommand;

package/dist/commands/serve-mcp.mjs

@@ -1,4 +1,6 @@
+import { formatJSON, formatLLMDSL } from "../utils/output.mjs";
 import { loadAIGNE } from "../utils/load-aigne.mjs";
+import { createViewContext, detectView } from "../utils/view.mjs";
 import { serveMCPServer } from "../utils/serve-mcp.mjs";
 import { isAbsolute, resolve } from "node:path";
 import { tryOrThrow } from "@aigne/core/utils/type-utils";
@@ -35,6 +37,19 @@ function createServeMCPCommand({ aigneFilePath } = {}) {
 			}).option("aigne-hub-url", {
 				describe: "Custom AIGNE Hub service URL. Used to fetch remote agent definitions or models. ",
 				type: "string"
+			}).option("json", {
+				type: "boolean",
+				describe: "Output in JSON format",
+				default: false
+			}).option("view", {
+				type: "string",
+				describe: "Output view type (human, json, llm, default)",
+				choices: [
+					"default",
+					"json",
+					"llm",
+					"human"
+				]
 			});
 		},
 		handler: async (options) => {
@@ -43,25 +58,56 @@ function createServeMCPCommand({ aigneFilePath } = {}) {
 				path: isAbsolute(path$1) ? path$1 : resolve(process.cwd(), path$1),
 				modelOptions: { aigneHubUrl: options.aigneHubUrl }
 			});
+			const view = detectView({
+				view: options.view,
+				json: options.json
+			}, {}, createViewContext());
 			await serveMCPServerFromDir({
 				...options,
-				aigne
+				aigne,
+				view
 			});
 		}
 	};
 }
 async function serveMCPServerFromDir(options) {
 	const port = options.port || DEFAULT_PORT();
+	const view = options.view ?? "human";
 	await serveMCPServer({
 		aigne: options.aigne,
 		host: options.host,
 		port,
 		pathname: options.pathname
 	});
-	console.log(`MCP server is running on http://${options.host}:${port}${options.pathname}`);
+	const url = `http://${options.host}:${port}${options.pathname}`;
+	const serverInfo = {
+		status: "running",
+		url,
+		host: options.host,
+		port,
+		pathname: options.pathname
+	};
+	switch (view) {
+		case "json":
+			console.log(formatJSON(serverInfo));
+			break;
+		case "llm":
+		case "default":
+			console.log(formatLLMDSL(serverInfo, [
+				"status",
+				"url",
+				"host",
+				"port",
+				"pathname"
+			]));
+			break;
+		default:
+			console.log(`MCP server is running on ${url}`);
+			break;
+	}
 	if (!process.env.CI && process.env.NODE_ENV !== "test") await new Promise(() => {});
 }
 
 //#endregion
-export { createServeMCPCommand, serveMCPServerFromDir };
+export { createServeMCPCommand };
 //# sourceMappingURL=serve-mcp.mjs.map

package/dist/commands/serve-mcp.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"serve-mcp.mjs","names":["path"],"sources":["../../src/commands/serve-mcp.ts"],"sourcesContent":["import { isAbsolute, resolve } from \"node:path\";\nimport type { AIGNE } from \"@aigne/core\";\nimport { tryOrThrow } from \"@aigne/core/utils/type-utils\";\nimport type { CommandModule } from \"yargs\";\nimport { loadAIGNE } from \"../utils/load-aigne.js\";\nimport { serveMCPServer } from \"../utils/serve-mcp.js\";\n\ninterface ServeMCPOptions {\n  path: string;\n  host: string;\n  port?: number;\n  pathname: string;\n  aigneHubUrl?: string;\n}\n\nexport const DEFAULT_PORT = () =>\n  tryOrThrow(\n    () => {\n      const { PORT } = process.env;\n      if (!PORT) return 3000;\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 createServeMCPCommand({\n  aigneFilePath,\n}: {\n  aigneFilePath?: string;\n} = {}): CommandModule<unknown, ServeMCPOptions> {\n  return {\n    command: \"serve-mcp\",\n    describe: \"Serve the agents in the specified directory as a MCP server (streamable http)\",\n    builder: (yargs) => {\n      return yargs\n        .option(\"path\", {\n          describe: \"Path to the agents directory or URL to aigne project\",\n          type: \"string\",\n          default: \".\",\n          alias: [\"url\"],\n        })\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        .option(\"aigne-hub-url\", {\n          describe:\n            \"Custom AIGNE Hub service URL. Used to fetch remote agent definitions or models. \",\n          type: \"string\",\n        });\n    },\n    handler: async (options) => {\n      const path = aigneFilePath || options.path;\n      const absolutePath = isAbsolute(path) ? path : resolve(process.cwd(), path);\n\n      const aigne = await loadAIGNE({\n        path: absolutePath,\n        modelOptions: { aigneHubUrl: options.aigneHubUrl },\n      });\n\n      await serveMCPServerFromDir({ ...options, aigne });\n    },\n  };\n}\n\nexport async function serveMCPServerFromDir(options: {\n  aigne: AIGNE;\n  host: string;\n  port?: number;\n  pathname: string;\n}) {\n  const port = options.port || DEFAULT_PORT();\n\n  await serveMCPServer({\n    aigne: options.aigne,\n    host: options.host,\n    port,\n    pathname: options.pathname,\n  });\n\n  console.log(`MCP server is running on http://${options.host}:${port}${options.pathname}`);\n\n  if (!process.env.CI && process.env.NODE_ENV !== \"test\") await new Promise(() => {}); // Keep the server running\n}\n"],"mappings":";;;;;;AAeA,MAAa,qBACX,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,sBAAsB,EACpC,kBAGE,EAAE,EAA2C;AAC/C,QAAO;EACL,SAAS;EACT,UAAU;EACV,UAAU,UAAU;AAClB,UAAO,MACJ,OAAO,QAAQ;IACd,UAAU;IACV,MAAM;IACN,SAAS;IACT,OAAO,CAAC,MAAM;IACf,CAAC,CACD,OAAO,QAAQ;IACd,UAAU;IACV,MAAM;IACN,SAAS;IACV,CAAC,CACD,OAAO,QAAQ;IACd,UAAU;IACV,MAAM;IACP,CAAC,CACD,OAAO,YAAY;IAClB,UAAU;IACV,MAAM;IACN,SAAS;IACV,CAAC,CACD,OAAO,iBAAiB;IACvB,UACE;IACF,MAAM;IACP,CAAC;;EAEN,SAAS,OAAO,YAAY;GAC1B,MAAMA,SAAO,iBAAiB,QAAQ;GAGtC,MAAM,QAAQ,MAAM,UAAU;IAC5B,MAHmB,WAAWA,OAAK,GAAGA,SAAO,QAAQ,QAAQ,KAAK,EAAEA,OAAK;IAIzE,cAAc,EAAE,aAAa,QAAQ,aAAa;IACnD,CAAC;AAEF,SAAM,sBAAsB;IAAE,GAAG;IAAS;IAAO,CAAC;;EAErD;;AAGH,eAAsB,sBAAsB,SAKzC;CACD,MAAM,OAAO,QAAQ,QAAQ,cAAc;AAE3C,OAAM,eAAe;EACnB,OAAO,QAAQ;EACf,MAAM,QAAQ;EACd;EACA,UAAU,QAAQ;EACnB,CAAC;AAEF,SAAQ,IAAI,mCAAmC,QAAQ,KAAK,GAAG,OAAO,QAAQ,WAAW;AAEzF,KAAI,CAAC,QAAQ,IAAI,MAAM,QAAQ,IAAI,aAAa,OAAQ,OAAM,IAAI,cAAc,GAAG"}
+{"version":3,"file":"serve-mcp.mjs","names":["path"],"sources":["../../src/commands/serve-mcp.ts"],"sourcesContent":["import { isAbsolute, resolve } from \"node:path\";\nimport type { AIGNE } from \"@aigne/core\";\nimport { tryOrThrow } from \"@aigne/core/utils/type-utils\";\nimport type { CommandModule } from \"yargs\";\nimport { loadAIGNE } from \"../utils/load-aigne.js\";\nimport { formatJSON, formatLLMDSL } from \"../utils/output.js\";\nimport { serveMCPServer } from \"../utils/serve-mcp.js\";\nimport { createViewContext, detectView, type ViewType } from \"../utils/view.js\";\n\ninterface ServeMCPOptions {\n  path: string;\n  host: string;\n  port?: number;\n  pathname: string;\n  aigneHubUrl?: string;\n  json?: boolean;\n  view?: ViewType;\n}\n\nexport const DEFAULT_PORT = () =>\n  tryOrThrow(\n    () => {\n      const { PORT } = process.env;\n      if (!PORT) return 3000;\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 createServeMCPCommand({\n  aigneFilePath,\n}: {\n  aigneFilePath?: string;\n} = {}): CommandModule<unknown, ServeMCPOptions> {\n  return {\n    command: \"serve-mcp\",\n    describe: \"Serve the agents in the specified directory as a MCP server (streamable http)\",\n    builder: (yargs) => {\n      return yargs\n        .option(\"path\", {\n          describe: \"Path to the agents directory or URL to aigne project\",\n          type: \"string\",\n          default: \".\",\n          alias: [\"url\"],\n        })\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        .option(\"aigne-hub-url\", {\n          describe:\n            \"Custom AIGNE Hub service URL. Used to fetch remote agent definitions or models. \",\n          type: \"string\",\n        })\n        .option(\"json\", {\n          type: \"boolean\",\n          describe: \"Output in JSON format\",\n          default: false,\n        })\n        .option(\"view\", {\n          type: \"string\",\n          describe: \"Output view type (human, json, llm, default)\",\n          choices: [\"default\", \"json\", \"llm\", \"human\"] as const,\n        });\n    },\n    handler: async (options) => {\n      const path = aigneFilePath || options.path;\n      const absolutePath = isAbsolute(path) ? path : resolve(process.cwd(), path);\n\n      const aigne = await loadAIGNE({\n        path: absolutePath,\n        modelOptions: { aigneHubUrl: options.aigneHubUrl },\n      });\n\n      // Detect view based on options and context\n      const view = detectView(\n        { view: options.view as ViewType, json: options.json },\n        {},\n        createViewContext(),\n      );\n\n      await serveMCPServerFromDir({ ...options, aigne, view });\n    },\n  };\n}\n\nexport async function serveMCPServerFromDir(options: {\n  aigne: AIGNE;\n  host: string;\n  port?: number;\n  pathname: string;\n  view?: ViewType;\n}) {\n  const port = options.port || DEFAULT_PORT();\n  const view = options.view ?? \"human\";\n\n  await serveMCPServer({\n    aigne: options.aigne,\n    host: options.host,\n    port,\n    pathname: options.pathname,\n  });\n\n  const url = `http://${options.host}:${port}${options.pathname}`;\n  const serverInfo = {\n    status: \"running\",\n    url,\n    host: options.host,\n    port,\n    pathname: options.pathname,\n  };\n\n  switch (view) {\n    case \"json\":\n      console.log(formatJSON(serverInfo));\n      break;\n    case \"llm\":\n    case \"default\":\n      console.log(formatLLMDSL(serverInfo, [\"status\", \"url\", \"host\", \"port\", \"pathname\"]));\n      break;\n    default:\n      console.log(`MCP server is running on ${url}`);\n      break;\n  }\n\n  if (!process.env.CI && process.env.NODE_ENV !== \"test\") await new Promise(() => {}); // Keep the server running\n}\n"],"mappings":";;;;;;;;AAmBA,MAAa,qBACX,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,sBAAsB,EACpC,kBAGE,EAAE,EAA2C;AAC/C,QAAO;EACL,SAAS;EACT,UAAU;EACV,UAAU,UAAU;AAClB,UAAO,MACJ,OAAO,QAAQ;IACd,UAAU;IACV,MAAM;IACN,SAAS;IACT,OAAO,CAAC,MAAM;IACf,CAAC,CACD,OAAO,QAAQ;IACd,UAAU;IACV,MAAM;IACN,SAAS;IACV,CAAC,CACD,OAAO,QAAQ;IACd,UAAU;IACV,MAAM;IACP,CAAC,CACD,OAAO,YAAY;IAClB,UAAU;IACV,MAAM;IACN,SAAS;IACV,CAAC,CACD,OAAO,iBAAiB;IACvB,UACE;IACF,MAAM;IACP,CAAC,CACD,OAAO,QAAQ;IACd,MAAM;IACN,UAAU;IACV,SAAS;IACV,CAAC,CACD,OAAO,QAAQ;IACd,MAAM;IACN,UAAU;IACV,SAAS;KAAC;KAAW;KAAQ;KAAO;KAAQ;IAC7C,CAAC;;EAEN,SAAS,OAAO,YAAY;GAC1B,MAAMA,SAAO,iBAAiB,QAAQ;GAGtC,MAAM,QAAQ,MAAM,UAAU;IAC5B,MAHmB,WAAWA,OAAK,GAAGA,SAAO,QAAQ,QAAQ,KAAK,EAAEA,OAAK;IAIzE,cAAc,EAAE,aAAa,QAAQ,aAAa;IACnD,CAAC;GAGF,MAAM,OAAO,WACX;IAAE,MAAM,QAAQ;IAAkB,MAAM,QAAQ;IAAM,EACtD,EAAE,EACF,mBAAmB,CACpB;AAED,SAAM,sBAAsB;IAAE,GAAG;IAAS;IAAO;IAAM,CAAC;;EAE3D;;AAGH,eAAsB,sBAAsB,SAMzC;CACD,MAAM,OAAO,QAAQ,QAAQ,cAAc;CAC3C,MAAM,OAAO,QAAQ,QAAQ;AAE7B,OAAM,eAAe;EACnB,OAAO,QAAQ;EACf,MAAM,QAAQ;EACd;EACA,UAAU,QAAQ;EACnB,CAAC;CAEF,MAAM,MAAM,UAAU,QAAQ,KAAK,GAAG,OAAO,QAAQ;CACrD,MAAM,aAAa;EACjB,QAAQ;EACR;EACA,MAAM,QAAQ;EACd;EACA,UAAU,QAAQ;EACnB;AAED,SAAQ,MAAR;EACE,KAAK;AACH,WAAQ,IAAI,WAAW,WAAW,CAAC;AACnC;EACF,KAAK;EACL,KAAK;AACH,WAAQ,IAAI,aAAa,YAAY;IAAC;IAAU;IAAO;IAAQ;IAAQ;IAAW,CAAC,CAAC;AACpF;EACF;AACE,WAAQ,IAAI,4BAA4B,MAAM;AAC9C;;AAGJ,KAAI,CAAC,QAAQ,IAAI,MAAM,QAAQ,IAAI,aAAa,OAAQ,OAAM,IAAI,cAAc,GAAG"}