@aigne/cli 1.50.1-beta.2 → 1.51.0-beta.10

package/CHANGELOG.md

@@ -1,5 +1,161 @@
 # Changelog
 
+## [1.51.0-beta.10](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.51.0-beta.9...cli-v1.51.0-beta.10) (2025-10-16)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-system-fs bumped to 1.0.1-beta.4
+    * @aigne/agent-library bumped to 1.21.48-beta.8
+    * @aigne/agentic-memory bumped to 1.0.48-beta.8
+    * @aigne/aigne-hub bumped to 0.10.2-beta.8
+    * @aigne/core bumped to 1.63.0-beta.8
+    * @aigne/default-memory bumped to 1.2.11-beta.8
+    * @aigne/observability-api bumped to 0.11.2-beta.3
+    * @aigne/openai bumped to 0.16.2-beta.8
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.55-beta.8
+
+## [1.51.0-beta.9](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.51.0-beta.8...cli-v1.51.0-beta.9) (2025-10-16)
+
+
+### Bug Fixes
+
+* ensure tips are only printed once during AIGNE loading ([#628](https://github.com/AIGNE-io/aigne-framework/issues/628)) ([7d49508](https://github.com/AIGNE-io/aigne-framework/commit/7d4950882436169986eedab75c232db2c0a30732))
+
+## [1.51.0-beta.8](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.51.0-beta.7...cli-v1.51.0-beta.8) (2025-10-15)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-system-fs bumped to 1.0.1-beta.3
+    * @aigne/agent-library bumped to 1.21.48-beta.7
+    * @aigne/agentic-memory bumped to 1.0.48-beta.7
+    * @aigne/aigne-hub bumped to 0.10.2-beta.7
+    * @aigne/core bumped to 1.63.0-beta.7
+    * @aigne/default-memory bumped to 1.2.11-beta.7
+    * @aigne/openai bumped to 0.16.2-beta.7
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.55-beta.7
+
+## [1.51.0-beta.7](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.51.0-beta.6...cli-v1.51.0-beta.7) (2025-10-15)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-system-fs bumped to 1.0.1-beta.2
+    * @aigne/agent-library bumped to 1.21.48-beta.6
+    * @aigne/agentic-memory bumped to 1.0.48-beta.6
+    * @aigne/aigne-hub bumped to 0.10.2-beta.6
+    * @aigne/core bumped to 1.63.0-beta.6
+    * @aigne/default-memory bumped to 1.2.11-beta.6
+    * @aigne/observability-api bumped to 0.11.2-beta.2
+    * @aigne/openai bumped to 0.16.2-beta.6
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.55-beta.6
+
+## [1.51.0-beta.6](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.51.0-beta.5...cli-v1.51.0-beta.6) (2025-10-13)
+
+
+### Bug Fixes
+
+* add copy and download  in observability detail and optimize the detail rendering ([#610](https://github.com/AIGNE-io/aigne-framework/issues/610)) ([b1885f2](https://github.com/AIGNE-io/aigne-framework/commit/b1885f2b969d7ca28a0cb1ac2b4707e7c785308b))
+* **cli:** suppress error message for CTRL+C ([#617](https://github.com/AIGNE-io/aigne-framework/issues/617)) ([01f0ea7](https://github.com/AIGNE-io/aigne-framework/commit/01f0ea74affa5653dd94048e68b62b7d7e649d4a))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-system-fs bumped to 1.0.1-beta.1
+    * @aigne/agent-library bumped to 1.21.48-beta.5
+    * @aigne/agentic-memory bumped to 1.0.48-beta.5
+    * @aigne/aigne-hub bumped to 0.10.2-beta.5
+    * @aigne/core bumped to 1.63.0-beta.5
+    * @aigne/default-memory bumped to 1.2.11-beta.5
+    * @aigne/openai bumped to 0.16.2-beta.5
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.55-beta.5
+
+## [1.51.0-beta.5](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.51.0-beta.4...cli-v1.51.0-beta.5) (2025-10-12)
+
+
+### Bug Fixes
+
+* correct loading aigne with AFS config for `upgrade` command ([#613](https://github.com/AIGNE-io/aigne-framework/issues/613)) ([db1db97](https://github.com/AIGNE-io/aigne-framework/commit/db1db97b6305009d302a782dbc7fa3147900af47))
+
+## [1.51.0-beta.4](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.51.0-beta.3...cli-v1.51.0-beta.4) (2025-10-12)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-system-fs bumped to 1.0.1-beta
+    * @aigne/agent-library bumped to 1.21.48-beta.4
+    * @aigne/agentic-memory bumped to 1.0.48-beta.4
+    * @aigne/aigne-hub bumped to 0.10.2-beta.4
+    * @aigne/core bumped to 1.63.0-beta.4
+    * @aigne/default-memory bumped to 1.2.11-beta.4
+    * @aigne/openai bumped to 0.16.2-beta.4
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.55-beta.4
+
+## [1.51.0-beta.3](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.50.1-beta.3...cli-v1.51.0-beta.3) (2025-10-11)
+
+
+### Features
+
+* **afs:** add module system fs for afs ([#594](https://github.com/AIGNE-io/aigne-framework/issues/594)) ([83c7b65](https://github.com/AIGNE-io/aigne-framework/commit/83c7b6555d21c606a5005eb05f6686882fb8ffa3))
+
+
+### Bug Fixes
+
+* improve exit event handling for cli ([#609](https://github.com/AIGNE-io/aigne-framework/issues/609)) ([00211f8](https://github.com/AIGNE-io/aigne-framework/commit/00211f8ad4686ea673ea8e2eac5b850bcbd8c1f6))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-system-fs bumped to 1.0.0
+    * @aigne/agent-library bumped to 1.21.48-beta.3
+    * @aigne/agentic-memory bumped to 1.0.48-beta.3
+    * @aigne/aigne-hub bumped to 0.10.2-beta.3
+    * @aigne/core bumped to 1.63.0-beta.3
+    * @aigne/default-memory bumped to 1.2.11-beta.3
+    * @aigne/observability-api bumped to 0.11.2-beta.1
+    * @aigne/openai bumped to 0.16.2-beta.3
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.55-beta.3
+
+## [1.50.1-beta.3](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.50.1-beta.2...cli-v1.50.1-beta.3) (2025-10-09)
+
+
+### Bug Fixes
+
+* input schema of AI agent should includes input key and input file key ([#600](https://github.com/AIGNE-io/aigne-framework/issues/600)) ([b4ca076](https://github.com/AIGNE-io/aigne-framework/commit/b4ca076d6b4a1a1ecb8d4ebb008abd0d7561aadd))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/agent-library bumped to 1.21.48-beta.2
+    * @aigne/agentic-memory bumped to 1.0.48-beta.2
+    * @aigne/aigne-hub bumped to 0.10.2-beta.2
+    * @aigne/core bumped to 1.63.0-beta.2
+    * @aigne/default-memory bumped to 1.2.11-beta.2
+    * @aigne/openai bumped to 0.16.2-beta.2
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.55-beta.2
+
 ## [1.50.1-beta.2](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.50.1-beta.1...cli-v1.50.1-beta.2) (2025-10-09)
 
 

package/dist/cli.js

@@ -28,7 +28,9 @@ export default createAIGNECommand({ argv, aigneFilePath })
 })
     .parseAsync(argv)
     .catch((error) => {
-    console.log(""); // Add an empty line for better readability
-    console.error(`${chalk.red("Error:")} ${highlightUrl(error.message)}`);
+    if (error.name !== "ExitPromptError") {
+        console.log(""); // Add an empty line for better readability
+        console.error(`${chalk.red("Error:")} ${highlightUrl(error.message)}`);
+    }
     process.exit(1);
 });

package/dist/commands/app.d.ts

@@ -4,9 +4,10 @@ import { type AgentRunCommonOptions } from "../utils/yargs.js";
 export declare function createAppCommands({ argv }?: {
     argv?: string[];
 }): CommandModule[];
-export declare const agentCommandModule: ({ dir, agent, }: {
+export declare const agentCommandModule: ({ dir, agent, chat, }: {
     dir: string;
     agent: AgentInChildProcess;
+    chat?: boolean;
 }) => CommandModule<unknown, AgentRunCommonOptions>;
 export declare const cliAgentCommandModule: ({ dir, parent, cliAgent, }: {
     dir: string;

package/dist/commands/app.js

@@ -50,7 +50,7 @@ export function createAppCommands({ argv } = {}) {
                 });
                 if (aigne.cli?.chat) {
                     y.command({
-                        ...agentCommandModule({ dir, agent: aigne.cli.chat }),
+                        ...agentCommandModule({ dir, agent: aigne.cli.chat, chat: true }),
                         command: "$0",
                     });
                 }
@@ -133,7 +133,7 @@ const upgradeCommandModule = ({ packageName, dir, }) => ({
         console.log(`\n✅ ${packageName} is already at the latest version (${app.version})`);
     },
 });
-export const agentCommandModule = ({ dir, agent, }) => {
+export const agentCommandModule = ({ dir, agent, chat, }) => {
     return {
         command: agent.name,
         aliases: agent.alias || [],
@@ -147,7 +147,7 @@ export const agentCommandModule = ({ dir, agent, }) => {
             await runAIGNEInChildProcess("invokeCLIAgentFromDir", {
                 dir,
                 agent: agent.name,
-                input: options,
+                input: { ...options, chat: chat ?? options.chat },
             });
             process.exit(0);
         },
@@ -193,7 +193,10 @@ export async function loadApplication(options) {
     const { dir, packageName } = options;
     const check = await checkInstallation(dir);
     if (check && !check.expired) {
-        const aigne = await runAIGNEInChildProcess("loadAIGNE", dir).catch(async (error) => {
+        const aigne = await runAIGNEInChildProcess("loadAIGNE", {
+            path: dir,
+            skipModelLoading: true,
+        }).catch(async (error) => {
             logger.error(`⚠️ Failed to load ${packageName}, trying to reinstall:`, error.message);
             await withSpinner("", async () => {
                 await rm(options.dir, { recursive: true, force: true });
@@ -208,7 +211,7 @@ export async function loadApplication(options) {
         return null;
     const result = await installApp({ dir, packageName, beta: check?.version?.includes("beta") });
     return {
-        aigne: await runAIGNEInChildProcess("loadAIGNE", dir),
+        aigne: await runAIGNEInChildProcess("loadAIGNE", { path: dir, skipModelLoading: true }),
         version: result.version,
     };
 }

package/dist/commands/run.js

@@ -43,7 +43,7 @@ export function createRunCommand({ aigneFilePath, } = {}) {
             const subYargs = yargs().scriptName("").usage("aigne run <path> <agent> [...options]");
             if (aigne.cli.chat) {
                 subYargs.command({
-                    ...agentCommandModule({ dir: path, agent: serializeAgent(aigne.cli.chat) }),
+                    ...agentCommandModule({ dir: path, agent: serializeAgent(aigne.cli.chat), chat: true }),
                     command: "$0",
                 });
             }
@@ -111,7 +111,7 @@ async function loadApplication(path) {
     }
     // Load env files in the aigne directory
     config({ path: dir, silent: true });
-    const aigne = await loadAIGNE({ path: dir, printTips: false });
+    const aigne = await loadAIGNE({ path: dir });
     return { aigne, path: dir };
 }
 async function downloadPackage(url, cacheDir) {

package/dist/ui/utils/terminal-input.js

@@ -1,8 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ExitPromptError } from "@inquirer/core";
 import chalk from "chalk";
 import { Box, render, Text, useInput } from "ink";
 import { useState } from "react";
-import { SIGINTError } from "./error.js";
 import { useTextBuffer } from "./text-buffer.js";
 export async function terminalInput(options = {}) {
     return new Promise((resolve, reject) => {
@@ -30,7 +30,7 @@ function Input(props) {
         if (character === "c" && key.ctrl) {
             setStatus("error");
             setTimeout(() => {
-                props.onError(new SIGINTError("Input aborted by user"));
+                props.onError(new ExitPromptError("Input aborted by user"));
             });
             return;
         }

package/dist/utils/aigne-hub/model.js

@@ -1,5 +1,5 @@
-import { readFile } from "node:fs/promises";
-import { AIGNE_HUB_DEFAULT_MODEL, findImageModel, findModel } from "@aigne/aigne-hub";
+import { readFile, writeFile } from "node:fs/promises";
+import { AIGNE_HUB_DEFAULT_MODEL, AIGNE_HUB_URL, findImageModel, findModel, } from "@aigne/aigne-hub";
 import { flat, omit } from "@aigne/core/utils/type-utils.js";
 import chalk from "chalk";
 import inquirer from "inquirer";
@@ -56,6 +56,13 @@ export const formatModelName = async (model, inquirerPrompt) => {
         console.log(chalk.yellow(`You can use command "export ${requireEnvs[0]}=xxx" to set API Key in your shell. Or you can set environment variables in .env file.`));
         process.exit(0);
     }
+    if (!envs.default?.AIGNE_HUB_API_URL) {
+        const host = new URL(AIGNE_HUB_URL).host;
+        const defaultEnv = envs[host]?.AIGNE_HUB_API_URL
+            ? envs[host]
+            : Object.values(envs)[0] || { AIGNE_HUB_API_URL: "" };
+        await writeFile(AIGNE_ENV_FILE, stringify({ ...envs, default: { AIGNE_HUB_API_URL: defaultEnv?.AIGNE_HUB_API_URL } }));
+    }
     return { provider: AIGNE_HUB_PROVIDER, model: `${provider}/${name}` };
 };
 export async function loadChatModel(options) {

package/dist/utils/load-aigne.d.ts

@@ -7,9 +7,10 @@ export interface RunOptions extends AgentRunCommonOptions {
     cacheDir?: string;
     aigneHubUrl?: string;
 }
-export declare function loadAIGNE({ path, modelOptions, imageModelOptions, printTips, }: {
+export declare function loadAIGNE({ path, modelOptions, imageModelOptions, printTips, skipModelLoading, }: {
     path?: string;
     modelOptions?: ChatModelInputOptions & LoadCredentialOptions;
     imageModelOptions?: ImageModelInputOptions & LoadCredentialOptions;
     printTips?: boolean;
+    skipModelLoading?: boolean;
 }): Promise<AIGNE<import("@aigne/core").UserContext>>;

package/dist/utils/load-aigne.js

@@ -21,21 +21,37 @@ async function printChatModelInfoBox(model) {
     console.log(boxen(lines.join("\n"), { padding: 1, borderStyle: "classic", borderColor: "cyan" }));
     console.log("");
 }
-export async function loadAIGNE({ path, modelOptions, imageModelOptions, printTips = true, }) {
+export async function loadAIGNE({ path, modelOptions, imageModelOptions, printTips = false, skipModelLoading = false, }) {
     let aigne;
     if (path) {
         aigne = await AIGNE.load(path, {
             memories: availableMemories,
-            model: (options) => loadChatModel({
-                ...options,
-                ...omitBy(modelOptions ?? {}, (v) => isNil(v)),
-                model: modelOptions?.model || process.env.MODEL || options?.model,
-            }),
-            imageModel: (options) => loadImageModel({
-                ...options,
-                ...omitBy(imageModelOptions ?? {}, (v) => isNil(v)),
-                model: imageModelOptions?.model || process.env.IMAGE_MODEL || options?.model,
-            }),
+            model: (options) => {
+                if (skipModelLoading)
+                    return undefined;
+                return loadChatModel({
+                    ...options,
+                    ...omitBy(modelOptions ?? {}, (v) => isNil(v)),
+                    model: modelOptions?.model || process.env.MODEL || options?.model,
+                });
+            },
+            imageModel: (options) => {
+                if (skipModelLoading)
+                    return undefined;
+                return loadImageModel({
+                    ...options,
+                    ...omitBy(imageModelOptions ?? {}, (v) => isNil(v)),
+                    model: imageModelOptions?.model || process.env.IMAGE_MODEL || options?.model,
+                });
+            },
+            afs: {
+                availableModules: [
+                    {
+                        module: "system-fs",
+                        create: (options) => import("@aigne/afs-system-fs").then((m) => new m.SystemFS(options)),
+                    },
+                ],
+            },
         });
     }
     else {

package/dist/utils/workers/run-aigne-in-child-process-worker.d.ts

@@ -1,7 +1,8 @@
-import { AIGNE, type Message } from "@aigne/core";
+import type { Message } from "@aigne/core";
+import { loadAIGNE } from "../load-aigne.js";
 import { type AgentRunCommonOptions } from "../yargs.js";
 import { type AgentInChildProcess, type CLIAgentInChildProcess } from "./run-aigne-in-child-process.js";
-export declare function loadAIGNEInChildProcess(...args: Parameters<typeof AIGNE.load>): Promise<{
+export declare function loadAIGNEInChildProcess(options: Parameters<typeof loadAIGNE>[0]): Promise<{
     agents?: AgentInChildProcess[];
     cli?: {
         chat?: AgentInChildProcess;

package/dist/utils/workers/run-aigne-in-child-process-worker.js

@@ -1,5 +1,4 @@
 import assert from "node:assert";
-import { AIGNE } from "@aigne/core";
 import { findCliAgent, mapCliAgent } from "@aigne/core/utils/agent-utils.js";
 import { logger } from "@aigne/core/utils/logger.js";
 import { loadAIGNE } from "../load-aigne.js";
@@ -30,14 +29,14 @@ process.on("message", async ({ method, args, ...options }) => {
         await send({ method, result });
     }
     catch (error) {
-        await send({ method, error: { message: error.message } });
+        await send({ method, error: { name: error.name, message: error.message } });
     }
     finally {
         process.exit(0);
     }
 });
-export async function loadAIGNEInChildProcess(...args) {
-    const aigne = await AIGNE.load(...args);
+export async function loadAIGNEInChildProcess(options) {
+    const aigne = await loadAIGNE(options);
     return {
         agents: aigne.agents.map(serializeAgent),
         cli: {
@@ -53,6 +52,7 @@ export async function invokeCLIAgentFromDirInChildProcess(options) {
     const aigne = await loadAIGNE({
         path: options.dir,
         modelOptions: options.input,
+        printTips: true,
         imageModelOptions: {
             model: options.input.imageModel,
         },
@@ -78,7 +78,7 @@ export async function invokeCLIAgentFromDirInChildProcess(options) {
         await runAgentWithAIGNE(aigne, agent, {
             ...options.input,
             input,
-            chat: agent === chat || options.input.chat,
+            chat: options.input.chat,
         });
     }
     finally {

package/dist/utils/workers/run-aigne-in-child-process.js

@@ -14,16 +14,25 @@ export function serializeAgent(agent) {
 }
 export async function runAIGNEInChildProcess(method, ...args) {
     return await new Promise((resolve, reject) => {
+        let completed = false;
         const child = fork(join(dirname(fileURLToPath(import.meta.url)), "./run-aigne-in-child-process-worker.js"));
         child.on("message", (event) => {
-            if (event.method !== method)
+            if (event.method !== method) {
                 reject(new Error(`Unknown method: ${event.method} expected: ${method}`));
-            else if (event.error)
-                reject(new Error(event.error.message));
-            else
+            }
+            else if (event.error) {
+                const e = new Error(event.error.message);
+                e.name = event.error.name;
+                reject(e);
+            }
+            else {
                 resolve(event.result);
+            }
+            completed = true;
         });
         child.on("exit", (code) => {
+            if (!completed)
+                process.exit(code);
             reject(new Error(`Child process exited with code ${code}`));
         });
         child.send({ method, args, logLevel: logger.level });

package/dist/utils/yargs.js

@@ -6,7 +6,7 @@ import { promisify } from "node:util";
 import { availableImageModels, availableModels, } from "@aigne/aigne-hub";
 import { AIAgent, ChatModel, DEFAULT_OUTPUT_KEY, readAllString, } from "@aigne/core";
 import { getLevelFromEnv, LogLevel, logger } from "@aigne/core/utils/logger.js";
-import { pick, tryOrThrow } from "@aigne/core/utils/type-utils.js";
+import { flat, pick, tryOrThrow } from "@aigne/core/utils/type-utils.js";
 import { parse } from "yaml";
 import z, { ZodAny, ZodArray, ZodBoolean, ZodError, ZodNumber, ZodObject, ZodString, ZodType, ZodUnknown, } from "zod";
 const MODEL_OPTIONS_GROUP_NAME = "Model Options";
@@ -149,7 +149,7 @@ export async function parseAgentInput(i, agent) {
     })));
     if (agent instanceof AIAgent && agent.inputFileKey) {
         const files = [];
-        for (const file of i.inputFile ?? []) {
+        for (const file of flat(i.inputFile, i[agent.inputFileKey]) ?? []) {
             const raw = await readFile(file.replace(/^@/, ""), "base64");
             const filename = basename(file);
             const mimeType = (await ChatModel.getMimeType(filename)) || "application/octet-stream";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/cli",
-  "version": "1.50.1-beta.2",
+  "version": "1.51.0-beta.10",
   "description": "Your command center for agent development",
   "publishConfig": {
     "access": "public"
@@ -89,13 +89,14 @@
     "yoctocolors-cjs": "^2.1.3",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.6",
-    "@aigne/agentic-memory": "^1.0.48-beta.1",
-    "@aigne/agent-library": "^1.21.48-beta.1",
-    "@aigne/aigne-hub": "^0.10.2-beta.1",
-    "@aigne/default-memory": "^1.2.11-beta.1",
-    "@aigne/core": "^1.63.0-beta.1",
-    "@aigne/observability-api": "^0.11.2-beta",
-    "@aigne/openai": "^0.16.2-beta.1"
+    "@aigne/afs-system-fs": "^1.0.1-beta.4",
+    "@aigne/agent-library": "^1.21.48-beta.8",
+    "@aigne/aigne-hub": "^0.10.2-beta.8",
+    "@aigne/agentic-memory": "^1.0.48-beta.8",
+    "@aigne/core": "^1.63.0-beta.8",
+    "@aigne/default-memory": "^1.2.11-beta.8",
+    "@aigne/observability-api": "^0.11.2-beta.3",
+    "@aigne/openai": "^0.16.2-beta.8"
   },
   "devDependencies": {
     "@inquirer/testing": "^2.1.50",
@@ -112,7 +113,7 @@
     "rimraf": "^6.0.1",
     "typescript": "^5.9.2",
     "ufo": "^1.6.1",
-    "@aigne/test-utils": "^0.5.55-beta.1"
+    "@aigne/test-utils": "^0.5.55-beta.8"
   },
   "scripts": {
     "lint": "tsc --noEmit",

package/dist/ui/utils/error.d.ts

@@ -1,2 +0,0 @@
-export declare class SIGINTError extends Error {
-}

package/dist/ui/utils/error.js

@@ -1,2 +0,0 @@
-export class SIGINTError extends Error {
-}