@aigne/cli 1.27.1-1 → 1.28.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## [1.28.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.27.0...cli-v1.28.0) (2025-07-31)
+
+
+### Features
+
+* **cli:** support dynamic download and execution of doc-smith app ([#293](https://github.com/AIGNE-io/aigne-framework/issues/293)) ([4c40077](https://github.com/AIGNE-io/aigne-framework/commit/4c40077bacef076bc4b098879e948ef866218e39))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/agent-library bumped to 1.21.7
+    * @aigne/agentic-memory bumped to 1.0.7
+    * @aigne/aigne-hub bumped to 0.3.1
+    * @aigne/anthropic bumped to 0.10.3
+    * @aigne/bedrock bumped to 0.8.7
+    * @aigne/core bumped to 1.40.0
+    * @aigne/deepseek bumped to 0.7.7
+    * @aigne/default-memory bumped to 1.0.7
+    * @aigne/gemini bumped to 0.8.7
+    * @aigne/ollama bumped to 0.7.7
+    * @aigne/open-router bumped to 0.7.7
+    * @aigne/openai bumped to 0.10.7
+    * @aigne/xai bumped to 0.7.7
+
 ## [1.27.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.26.0...cli-v1.27.0) (2025-07-30)
 
 

package/dist/commands/app.d.ts

@@ -1,2 +1,19 @@
+import { AIGNE, type Message } from "@aigne/core";
 import type { CommandModule } from "yargs";
 export declare function createAppCommands(): CommandModule[];
+export declare function invokeCLIAgentFromDir(options: {
+    dir: string;
+    agent: string;
+    input: Message & {
+        input?: string[];
+        format?: "yaml" | "json";
+    };
+}): Promise<void>;
+export declare function loadApplication({ name, dir, }: {
+    name: string;
+    dir?: string;
+}): Promise<{
+    aigne: AIGNE;
+    dir: string;
+    version: string;
+}>;

package/dist/commands/app.js

@@ -1,6 +1,6 @@
 import assert from "node:assert";
 import { spawnSync } from "node:child_process";
-import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import { readFile, stat, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { extname, join } from "node:path";
 import { isatty } from "node:tty";
@@ -9,11 +9,12 @@ import { pick } from "@aigne/core/utils/type-utils.js";
 import { Listr, PRESET_TIMER } from "@aigne/listr2";
 import { joinURL } from "ufo";
 import { parse } from "yaml";
-import { ZodObject } from "zod";
+import { ZodObject, ZodString } from "zod";
 import { availableModels } from "../constants.js";
 import { downloadAndExtract } from "../utils/download.js";
 import { loadAIGNE } from "../utils/load-aigne.js";
 import { runAgentWithAIGNE, stdinHasData } from "../utils/run-with-aigne.js";
+import { serveMCPServerFromDir } from "./serve-mcp.js";
 const NPM_PACKAGE_CACHE_TIME_MS = 1000 * 60 * 60 * 24; // 1 day
 const builtinApps = [
     {
@@ -28,72 +29,10 @@ export function createAppCommands() {
         describe: app.describe,
         aliases: app.aliases,
         builder: async (yargs) => {
-            const { aigne, dir, version } = await loadApplication({ name: "doc-smith" });
-            for (const agent of aigne.agents) {
-                const inputSchema = Object.entries(agent.inputSchema instanceof ZodObject ? agent.inputSchema.shape : {});
-                yargs.command(agent.name, agent.description || "", (yargs) => {
-                    for (const [option, config] of inputSchema) {
-                        yargs.option(option, {
-                            // TODO: support more types
-                            type: "string",
-                            description: config.description,
-                        });
-                        if (!(config.isNullable() || config.isOptional())) {
-                            yargs.demandOption(option);
-                        }
-                    }
-                    yargs
-                        .option("input", {
-                        type: "array",
-                        description: "Input to the agent, use @<file> to read from a file",
-                        alias: ["i"],
-                    })
-                        .option("format", {
-                        type: "string",
-                        description: 'Input format, can be "json" or "yaml"',
-                        choices: ["json", "yaml"],
-                    });
-                }, async (argv) => {
-                    try {
-                        const aigne = await loadAIGNE(dir);
-                        const _agent = aigne.agents[agent.name];
-                        assert(_agent, `Agent ${agent.name} not found in ${app.name}`);
-                        const input = pick(argv, inputSchema.map(([key]) => key));
-                        const rawInput = argv.input ||
-                            (isatty(process.stdin.fd) || !(await stdinHasData())
-                                ? null
-                                : [await readAllString(process.stdin)].filter(Boolean));
-                        if (rawInput) {
-                            for (let raw of rawInput) {
-                                let format = argv.format;
-                                if (raw.startsWith("@")) {
-                                    raw = await readFile(raw.slice(1), "utf8");
-                                    if (!format) {
-                                        const ext = extname(raw);
-                                        if (ext === ".json")
-                                            format = "json";
-                                        else if (ext === ".yaml" || ext === ".yml")
-                                            format = "yaml";
-                                    }
-                                }
-                                const inputKey = agent instanceof AIAgent ? agent.inputKey : undefined;
-                                if (format === "json") {
-                                    Object.assign(input, JSON.parse(raw));
-                                }
-                                else if (format === "yaml") {
-                                    Object.assign(input, parse(raw));
-                                }
-                                else if (inputKey) {
-                                    Object.assign(input, { [inputKey]: raw });
-                                }
-                            }
-                        }
-                        await runAgentWithAIGNE(aigne, _agent, { input });
-                    }
-                    finally {
-                        await aigne.shutdown();
-                    }
-                });
+            const { aigne, dir, version } = await loadApplication({ name: app.name });
+            yargs.command(serveMcpCommandModule({ name: app.name, dir }));
+            for (const agent of aigne.cli?.agents ?? []) {
+                yargs.command(agentCommandModule({ dir, agent }));
             }
             yargs.version(`${app.name} v${version}`);
             return yargs.demandCommand();
@@ -101,9 +40,126 @@ export function createAppCommands() {
         handler: () => { },
     }));
 }
-async function loadApplication({ name, }) {
+const serveMcpCommandModule = ({ name, dir, }) => ({
+    command: "serve-mcp",
+    describe: `Serve ${name} a MCP server (streamable http)`,
+    builder: (yargs) => {
+        return yargs
+            .option("host", {
+            describe: "Host to run the MCP server on, use 0.0.0.0 to publicly expose the server",
+            type: "string",
+            default: "localhost",
+        })
+            .option("port", {
+            describe: "Port to run the MCP server on",
+            type: "number",
+        })
+            .option("pathname", {
+            describe: "Pathname to the service",
+            type: "string",
+            default: "/mcp",
+        });
+    },
+    handler: async (options) => {
+        await serveMCPServerFromDir({ ...options, dir });
+    },
+});
+const agentCommandModule = ({ dir, agent, }) => {
+    const inputSchema = agent.inputSchema instanceof ZodObject ? agent.inputSchema.shape : {};
+    return {
+        command: agent.name,
+        describe: agent.description || "",
+        builder: (yargs) => {
+            for (const [option, config] of Object.entries(inputSchema)) {
+                yargs.option(option, {
+                    // TODO: support more types
+                    type: "string",
+                    description: config.description,
+                });
+                if (!(config.isNullable() || config.isOptional())) {
+                    yargs.demandOption(option);
+                }
+            }
+            return yargs
+                .option("input", {
+                type: "array",
+                description: "Input to the agent, use @<file> to read from a file",
+                alias: ["i"],
+            })
+                .option("format", {
+                type: "string",
+                description: 'Input format, can be "json" or "yaml"',
+                choices: ["json", "yaml"],
+            });
+        },
+        handler: async (input) => {
+            await invokeCLIAgentFromDir({ dir, agent: agent.name, input });
+        },
+    };
+};
+export async function invokeCLIAgentFromDir(options) {
+    const aigne = await loadAIGNE(options.dir);
+    try {
+        const agent = aigne.cli.agents[options.agent];
+        assert(agent, `Agent ${options.agent} not found in ${options.dir}`);
+        const inputSchema = agent.inputSchema instanceof ZodObject ? agent.inputSchema.shape : {};
+        const input = Object.fromEntries(await Promise.all(Object.entries(pick(options.input, Object.keys(inputSchema))).map(async ([key, val]) => {
+            if (typeof val === "string" && val.startsWith("@")) {
+                const schema = inputSchema[key];
+                val = await readFileAsInput(val, {
+                    format: schema instanceof ZodString ? "raw" : undefined,
+                });
+            }
+            return [key, val];
+        })));
+        const rawInput = options.input.input ||
+            (isatty(process.stdin.fd) || !(await stdinHasData())
+                ? null
+                : [await readAllString(process.stdin)].filter(Boolean));
+        if (rawInput) {
+            for (const raw of rawInput) {
+                const parsed = raw.startsWith("@")
+                    ? await readFileAsInput(raw, { format: options.input.format })
+                    : raw;
+                if (typeof parsed !== "string") {
+                    Object.assign(input, parsed);
+                }
+                else {
+                    const inputKey = agent instanceof AIAgent ? agent.inputKey : undefined;
+                    if (inputKey) {
+                        Object.assign(input, { [inputKey]: parsed });
+                    }
+                }
+            }
+        }
+        await runAgentWithAIGNE(aigne, agent, { input });
+    }
+    finally {
+        await aigne.shutdown();
+    }
+}
+async function readFileAsInput(value, { format } = {}) {
+    if (value.startsWith("@")) {
+        const ext = extname(value);
+        value = await readFile(value.slice(1), "utf8");
+        if (!format) {
+            if (ext === ".json")
+                format = "json";
+            else if (ext === ".yaml" || ext === ".yml")
+                format = "yaml";
+        }
+    }
+    if (format === "json") {
+        return JSON.parse(value);
+    }
+    else if (format === "yaml") {
+        return parse(value);
+    }
+    return value;
+}
+export async function loadApplication({ name, dir, }) {
     name = `@aigne/${name}`;
-    const dir = join(homedir(), ".aigne", "registry.npmjs.org", name);
+    dir ??= join(homedir(), ".aigne", "registry.npmjs.org", name);
     const check = await isInstallationAvailable(dir);
     if (check?.available) {
         return {
@@ -124,7 +180,7 @@ async function loadApplication({ name, }) {
             title: "Downloading application",
             skip: (ctx) => ctx.version === check?.version,
             task: async (ctx) => {
-                await downloadApplication({ url: ctx.url, dir });
+                await downloadAndExtract(ctx.url, dir, { strip: 1 });
             },
         },
         {
@@ -148,12 +204,7 @@ async function loadApplication({ name, }) {
     };
 }
 async function isInstallationAvailable(dir, { cacheTimeMs = NPM_PACKAGE_CACHE_TIME_MS } = {}) {
-    const s = await stat(join(dir, "package.json")).catch((error) => {
-        if (error.code === "ENOENT") {
-            return null;
-        }
-        throw error;
-    });
+    const s = await stat(join(dir, "package.json")).catch(() => null);
     if (!s)
         return null;
     const version = safeParseJSON(await readFile(join(dir, "package.json"), "utf-8"))?.version;
@@ -166,10 +217,6 @@ async function isInstallationAvailable(dir, { cacheTimeMs = NPM_PACKAGE_CACHE_TI
     const available = installedAt ? now - installedAt < cacheTimeMs : false;
     return { version, available };
 }
-async function downloadApplication({ url, dir }) {
-    await mkdir(dir, { recursive: true });
-    await downloadAndExtract(url, dir, { strip: 1 });
-}
 async function installDependencies(dir) {
     const { stderr, status } = spawnSync("npm", ["install", "--omit", "dev"], {
         cwd: dir,
@@ -197,7 +244,5 @@ function safeParseJSON(raw) {
     try {
         return JSON.parse(raw);
     }
-    catch {
-        return null;
-    }
+    catch { }
 }

package/dist/commands/run.js

@@ -31,7 +31,8 @@ export function createRunCommand({ aigneFilePath, } = {}) {
                 .option("cache-dir", {
                 describe: "Directory to download the package to (defaults to the ~/.aigne/xxx)",
                 type: "string",
-            });
+            })
+                .strict(false);
         },
         handler: async (argv) => {
             const options = argv;

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

@@ -5,7 +5,14 @@ interface ServeMCPOptions {
     port?: number;
     pathname: string;
 }
+export declare const DEFAULT_PORT: () => number;
 export declare function createServeMCPCommand({ aigneFilePath, }?: {
     aigneFilePath?: string;
 }): CommandModule<unknown, ServeMCPOptions>;
+export declare function serveMCPServerFromDir(options: {
+    dir: string;
+    host: string;
+    port?: number;
+    pathname: string;
+}): Promise<void>;
 export {};

package/dist/commands/serve-mcp.js

@@ -2,7 +2,7 @@ import { isAbsolute, resolve } from "node:path";
 import { tryOrThrow } from "@aigne/core/utils/type-utils.js";
 import { loadAIGNE } from "../utils/load-aigne.js";
 import { serveMCPServer } from "../utils/serve-mcp.js";
-const DEFAULT_PORT = () => tryOrThrow(() => {
+export const DEFAULT_PORT = () => tryOrThrow(() => {
     const { PORT } = process.env;
     if (!PORT)
         return 3000;
@@ -41,15 +41,18 @@ export function createServeMCPCommand({ aigneFilePath, } = {}) {
         handler: async (options) => {
             const path = aigneFilePath || options.path;
             const absolutePath = isAbsolute(path) ? path : resolve(process.cwd(), path);
-            const port = options.port || DEFAULT_PORT();
-            const aigne = await loadAIGNE(absolutePath);
-            await serveMCPServer({
-                aigne,
-                host: options.host,
-                port,
-                pathname: options.pathname,
-            });
-            console.log(`MCP server is running on http://${options.host}:${port}${options.pathname}`);
+            await serveMCPServerFromDir({ ...options, dir: absolutePath });
         },
     };
 }
+export async function serveMCPServerFromDir(options) {
+    const port = options.port || DEFAULT_PORT();
+    const aigne = await loadAIGNE(options.dir);
+    await serveMCPServer({
+        aigne,
+        host: options.host,
+        port,
+        pathname: options.pathname,
+    });
+    console.log(`MCP server is running on http://${options.host}:${port}${options.pathname}`);
+}

package/dist/utils/download.js

@@ -1,3 +1,4 @@
+import { mkdir } from "node:fs/promises";
 import { Readable } from "node:stream";
 import { finished } from "node:stream/promises";
 import { x } from "tar";
@@ -12,6 +13,7 @@ export async function downloadAndExtract(url, dir, options = {}) {
         throw new Error(`Failed to download package from ${url}: Unexpected to get empty response`);
     }
     try {
+        await mkdir(dir, { recursive: true });
         await finished(Readable.fromWeb(response.body).pipe(x({ C: dir, ...options })));
     }
     catch (error) {

package/dist/utils/serve-mcp.js

@@ -72,7 +72,7 @@ export function createMcpServer(aigne) {
         capabilities: { tools: {} },
         instructions: aigne.description,
     });
-    for (const agent of aigne.agents) {
+    for (const agent of aigne.mcpServer?.agents ?? []) {
         const schema = agent.inputSchema;
         if (!(schema instanceof ZodObject))
             throw new Error("Agent input schema must be a ZodObject");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/cli",
-  "version": "1.27.1-1",
+  "version": "1.28.0",
   "description": "cli for AIGNE framework",
   "publishConfig": {
     "access": "public"
@@ -70,20 +70,20 @@
     "yaml": "^2.8.0",
     "yargs": "^18.0.0",
     "zod": "^3.25.67",
-    "@aigne/agentic-memory": "^1.0.6",
-    "@aigne/agent-library": "^1.21.6",
-    "@aigne/bedrock": "^0.8.6",
-    "@aigne/aigne-hub": "^0.3.0",
-    "@aigne/core": "^1.39.0",
-    "@aigne/deepseek": "^0.7.6",
-    "@aigne/anthropic": "^0.10.2",
-    "@aigne/default-memory": "^1.0.6",
-    "@aigne/gemini": "^0.8.6",
+    "@aigne/agentic-memory": "^1.0.7",
+    "@aigne/agent-library": "^1.21.7",
+    "@aigne/aigne-hub": "^0.3.1",
+    "@aigne/anthropic": "^0.10.3",
+    "@aigne/bedrock": "^0.8.7",
+    "@aigne/core": "^1.40.0",
+    "@aigne/default-memory": "^1.0.7",
+    "@aigne/gemini": "^0.8.7",
+    "@aigne/deepseek": "^0.7.7",
     "@aigne/observability-api": "^0.8.2",
-    "@aigne/open-router": "^0.7.6",
-    "@aigne/openai": "^0.10.6",
-    "@aigne/xai": "^0.7.6",
-    "@aigne/ollama": "^0.7.6"
+    "@aigne/ollama": "^0.7.7",
+    "@aigne/open-router": "^0.7.7",
+    "@aigne/openai": "^0.10.7",
+    "@aigne/xai": "^0.7.7"
   },
   "devDependencies": {
     "@types/archiver": "^6.0.3",

package/templates/default/aigne.yaml

@@ -4,6 +4,6 @@ chat_model:
   temperature: 0.8
 agents:
   - chat.yaml
-tools:
+skills:
   - sandbox.js
   - filesystem.yaml

package/templates/default/chat.yaml

@@ -5,5 +5,5 @@ instructions: |
   Your goal is to assist users in finding the information they need and to engage in friendly conversation.
 input_key: message
 memory: true
-tools:
+skills:
   - sandbox.js