@aigne/cli 1.51.0-beta.9 → 1.52.0-beta

package/CHANGELOG.md

@@ -1,5 +1,140 @@
 # Changelog
 
+## [1.52.0-beta](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.51.0...cli-v1.52.0-beta) (2025-10-21)
+
+
+### Features
+
+* **cli:** add metadata traces including CLI version, app name, and version ([#646](https://github.com/AIGNE-io/aigne-framework/issues/646)) ([c64bd76](https://github.com/AIGNE-io/aigne-framework/commit/c64bd761ba4c9f3854be5feee208c711bff7a170))
+
+
+### Bug Fixes
+
+* **cli:** prevent potential crashes when environment configurations are incomplete ([#645](https://github.com/AIGNE-io/aigne-framework/issues/645)) ([8ab3a1e](https://github.com/AIGNE-io/aigne-framework/commit/8ab3a1e208a2774987d5d23c7239971c41edfd25))
+* **observability:** support time line as background ([#642](https://github.com/AIGNE-io/aigne-framework/issues/642)) ([6f47870](https://github.com/AIGNE-io/aigne-framework/commit/6f478702090e8106ddcfe318a4766e1246257503))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-system-fs bumped to 1.0.2-beta
+    * @aigne/agent-library bumped to 1.21.49-beta
+    * @aigne/agentic-memory bumped to 1.0.49-beta
+    * @aigne/aigne-hub bumped to 0.10.3-beta
+    * @aigne/core bumped to 1.64.0-beta
+    * @aigne/default-memory bumped to 1.2.12-beta
+    * @aigne/observability-api bumped to 0.11.3-beta
+    * @aigne/openai bumped to 0.16.3-beta
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.56-beta
+
+## [1.51.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.51.0-beta.14...cli-v1.51.0) (2025-10-19)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-system-fs bumped to 1.0.1
+    * @aigne/agent-library bumped to 1.21.48
+    * @aigne/agentic-memory bumped to 1.0.48
+    * @aigne/aigne-hub bumped to 0.10.2
+    * @aigne/core bumped to 1.63.0
+    * @aigne/default-memory bumped to 1.2.11
+    * @aigne/observability-api bumped to 0.11.2
+    * @aigne/openai bumped to 0.16.2
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.55
+
+## [1.51.0-beta.14](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.51.0-beta.13...cli-v1.51.0-beta.14) (2025-10-17)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-system-fs bumped to 1.0.1-beta.8
+    * @aigne/agent-library bumped to 1.21.48-beta.12
+    * @aigne/agentic-memory bumped to 1.0.48-beta.12
+    * @aigne/aigne-hub bumped to 0.10.2-beta.12
+    * @aigne/core bumped to 1.63.0-beta.12
+    * @aigne/default-memory bumped to 1.2.11-beta.12
+    * @aigne/openai bumped to 0.16.2-beta.12
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.55-beta.12
+
+## [1.51.0-beta.13](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.51.0-beta.12...cli-v1.51.0-beta.13) (2025-10-17)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-system-fs bumped to 1.0.1-beta.7
+    * @aigne/agent-library bumped to 1.21.48-beta.11
+    * @aigne/agentic-memory bumped to 1.0.48-beta.11
+    * @aigne/aigne-hub bumped to 0.10.2-beta.11
+    * @aigne/core bumped to 1.63.0-beta.11
+    * @aigne/default-memory bumped to 1.2.11-beta.11
+    * @aigne/openai bumped to 0.16.2-beta.11
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.55-beta.11
+
+## [1.51.0-beta.12](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.51.0-beta.11...cli-v1.51.0-beta.12) (2025-10-16)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-system-fs bumped to 1.0.1-beta.6
+    * @aigne/agent-library bumped to 1.21.48-beta.10
+    * @aigne/agentic-memory bumped to 1.0.48-beta.10
+    * @aigne/aigne-hub bumped to 0.10.2-beta.10
+    * @aigne/core bumped to 1.63.0-beta.10
+    * @aigne/default-memory bumped to 1.2.11-beta.10
+    * @aigne/observability-api bumped to 0.11.2-beta.5
+    * @aigne/openai bumped to 0.16.2-beta.10
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.55-beta.10
+
+## [1.51.0-beta.11](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.51.0-beta.10...cli-v1.51.0-beta.11) (2025-10-16)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-system-fs bumped to 1.0.1-beta.5
+    * @aigne/agent-library bumped to 1.21.48-beta.9
+    * @aigne/agentic-memory bumped to 1.0.48-beta.9
+    * @aigne/aigne-hub bumped to 0.10.2-beta.9
+    * @aigne/core bumped to 1.63.0-beta.9
+    * @aigne/default-memory bumped to 1.2.11-beta.9
+    * @aigne/observability-api bumped to 0.11.2-beta.4
+    * @aigne/openai bumped to 0.16.2-beta.9
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.55-beta.9
+
+## [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)
 
 

package/dist/commands/app.d.ts

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

package/dist/commands/app.js

@@ -7,6 +7,7 @@ import { logger } from "@aigne/core/utils/logger.js";
 import { jsonSchemaToZod } from "@aigne/json-schema-to-zod";
 import { Listr, PRESET_TIMER } from "@aigne/listr2";
 import { joinURL } from "ufo";
+import { AIGNE_CLI_VERSION } from "../constants.js";
 import { downloadAndExtract } from "../utils/download.js";
 import { withSpinner } from "../utils/spinner.js";
 import { runAIGNEInChildProcess, } from "../utils/workers/run-aigne-in-child-process.js";
@@ -50,17 +51,23 @@ export function createAppCommands({ argv } = {}) {
                 });
                 if (aigne.cli?.chat) {
                     y.command({
-                        ...agentCommandModule({ dir, agent: aigne.cli.chat, chat: true }),
+                        ...agentCommandModule({
+                            dir,
+                            agent: aigne.cli.chat,
+                            chat: true,
+                            version,
+                            packageName: app.name,
+                        }),
                         command: "$0",
                     });
                 }
                 for (const cliAgent of aigne.cli?.agents ?? []) {
-                    y.command(cliAgentCommandModule({ dir, cliAgent }));
+                    y.command(cliAgentCommandModule({ dir, cliAgent, version, packageName: app.name }));
                 }
                 y.option("model", {
                     type: "string",
                     description: "Model to use for the application, example: openai:gpt-4.1 or google:gemini-2.5-flash",
-                }).command(serveMcpCommandModule({ name: app.name, dir }));
+                }).command(serveMcpCommandModule({ name: app.name, version, dir }));
                 y.version(`${app.name} v${version}`).alias("version", "v");
             }
             return y.demandCommand();
@@ -68,7 +75,7 @@ export function createAppCommands({ argv } = {}) {
         handler: () => { },
     }));
 }
-const serveMcpCommandModule = ({ name, dir, }) => ({
+const serveMcpCommandModule = ({ name, dir, version, }) => ({
     command: "serve-mcp",
     describe: `Serve ${name} a MCP server (streamable http)`,
     builder: (yargs) => {
@@ -89,7 +96,14 @@ const serveMcpCommandModule = ({ name, dir, }) => ({
         });
     },
     handler: async (options) => {
-        await serveMCPServerFromDir({ ...options, dir });
+        await serveMCPServerFromDir({
+            ...options,
+            dir,
+            metadata: {
+                appName: name,
+                appVersion: version,
+            },
+        });
     },
 });
 function isUpgradeCommand(argv) {
@@ -133,7 +147,7 @@ const upgradeCommandModule = ({ packageName, dir, }) => ({
         console.log(`\n✅ ${packageName} is already at the latest version (${app.version})`);
     },
 });
-export const agentCommandModule = ({ dir, agent, chat, }) => {
+export const agentCommandModule = ({ dir, agent, chat, version, packageName, }) => {
     return {
         command: agent.name,
         aliases: agent.alias || [],
@@ -148,12 +162,17 @@ export const agentCommandModule = ({ dir, agent, chat, }) => {
                 dir,
                 agent: agent.name,
                 input: { ...options, chat: chat ?? options.chat },
+                metadata: {
+                    cliVersion: AIGNE_CLI_VERSION,
+                    appName: packageName,
+                    appVersion: version,
+                },
             });
             process.exit(0);
         },
     };
 };
-export const cliAgentCommandModule = ({ dir, parent, cliAgent, }) => {
+export const cliAgentCommandModule = ({ dir, parent, cliAgent, version, packageName, }) => {
     const { agent, agents } = cliAgent;
     const name = cliAgent.name || agent?.name;
     assert(name, "CLI agent must have a name");
@@ -167,7 +186,13 @@ export const cliAgentCommandModule = ({ dir, parent, cliAgent, }) => {
             }
             if (agents?.length) {
                 for (const cmd of agents) {
-                    yargs.command(cliAgentCommandModule({ dir, parent: (parent ?? []).concat(name), cliAgent: cmd }));
+                    yargs.command(cliAgentCommandModule({
+                        dir,
+                        parent: (parent ?? []).concat(name),
+                        cliAgent: cmd,
+                        version,
+                        packageName,
+                    }));
                 }
             }
             if (!agent)
@@ -184,6 +209,11 @@ export const cliAgentCommandModule = ({ dir, parent, cliAgent, }) => {
                 parent,
                 agent: name,
                 input: options,
+                metadata: {
+                    cliVersion: AIGNE_CLI_VERSION,
+                    appName: packageName,
+                    appVersion: version,
+                },
             });
             process.exit(0);
         },
@@ -196,6 +226,10 @@ export async function loadApplication(options) {
         const aigne = await runAIGNEInChildProcess("loadAIGNE", {
             path: dir,
             skipModelLoading: true,
+            metadata: {
+                appName: packageName,
+                appVersion: check?.version,
+            },
         }).catch(async (error) => {
             logger.error(`⚠️ Failed to load ${packageName}, trying to reinstall:`, error.message);
             await withSpinner("", async () => {
@@ -211,7 +245,14 @@ export async function loadApplication(options) {
         return null;
     const result = await installApp({ dir, packageName, beta: check?.version?.includes("beta") });
     return {
-        aigne: await runAIGNEInChildProcess("loadAIGNE", { path: dir, skipModelLoading: true }),
+        aigne: await runAIGNEInChildProcess("loadAIGNE", {
+            path: dir,
+            skipModelLoading: true,
+            metadata: {
+                appName: packageName,
+                appVersion: result.version,
+            },
+        }),
         version: result.version,
     };
 }

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

@@ -1,3 +1,4 @@
+import type { AIGNEMetadata } from "@aigne/core/aigne/type.js";
 import type { CommandModule } from "yargs";
 interface ServeMCPOptions {
     path: string;
@@ -15,5 +16,6 @@ export declare function serveMCPServerFromDir(options: {
     port?: number;
     pathname: string;
     aigneHubUrl?: string;
+    metadata?: AIGNEMetadata;
 }): Promise<void>;
 export {};

package/dist/commands/serve-mcp.js

@@ -54,6 +54,7 @@ export async function serveMCPServerFromDir(options) {
     const aigne = await loadAIGNE({
         path: options.dir,
         modelOptions: { aigneHubUrl: options.aigneHubUrl },
+        metadata: options.metadata,
     });
     await serveMCPServer({
         aigne,

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

@@ -56,7 +56,7 @@ 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) {
+    if (envs && Object.keys(envs).length > 0 && !envs.default?.AIGNE_HUB_API_URL) {
         const host = new URL(AIGNE_HUB_URL).host;
         const defaultEnv = envs[host]?.AIGNE_HUB_API_URL
             ? envs[host]

package/dist/utils/evaluation/type.d.ts

@@ -18,6 +18,7 @@ export interface Dataset {
 export interface RunOptions {
     timeoutMs?: number;
     concurrency?: number;
+    iterations?: number;
     hooks?: {
         onBeforeRun?: (item: DatasetItem) => void;
         onAfterRun?: (result: RunResult) => void;

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

@@ -1,4 +1,5 @@
 import { AIGNE, type ChatModelInputOptions, type ImageModelInputOptions } from "@aigne/core";
+import type { AIGNEMetadata } from "@aigne/core/aigne/type.js";
 import type { LoadCredentialOptions } from "./aigne-hub/type.js";
 import type { AgentRunCommonOptions } from "./yargs.js";
 export interface RunOptions extends AgentRunCommonOptions {
@@ -7,10 +8,11 @@ export interface RunOptions extends AgentRunCommonOptions {
     cacheDir?: string;
     aigneHubUrl?: string;
 }
-export declare function loadAIGNE({ path, modelOptions, imageModelOptions, printTips, skipModelLoading, }: {
+export declare function loadAIGNE({ path, modelOptions, imageModelOptions, printTips, skipModelLoading, metadata, }: {
     path?: string;
     modelOptions?: ChatModelInputOptions & LoadCredentialOptions;
     imageModelOptions?: ImageModelInputOptions & LoadCredentialOptions;
     printTips?: boolean;
     skipModelLoading?: boolean;
+    metadata?: AIGNEMetadata;
 }): Promise<AIGNE<import("@aigne/core").UserContext>>;

package/dist/utils/load-aigne.js

@@ -2,7 +2,7 @@ import { AIGNE, } from "@aigne/core";
 import { isNil, omitBy } from "@aigne/core/utils/type-utils.js";
 import boxen from "boxen";
 import chalk from "chalk";
-import { availableMemories } from "../constants.js";
+import { AIGNE_CLI_VERSION, availableMemories } from "../constants.js";
 import { loadChatModel, loadImageModel, maskApiKey } from "./aigne-hub/model.js";
 import { getUrlOrigin } from "./get-url-origin.js";
 let printed = false;
@@ -21,7 +21,7 @@ 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 = false, skipModelLoading = false, }) {
+export async function loadAIGNE({ path, modelOptions, imageModelOptions, printTips = false, skipModelLoading = false, metadata, }) {
     let aigne;
     if (path) {
         aigne = await AIGNE.load(path, {
@@ -52,11 +52,15 @@ export async function loadAIGNE({ path, modelOptions, imageModelOptions, printTi
                     },
                 ],
             },
+            metadata: { ...metadata, cliVersion: AIGNE_CLI_VERSION },
         });
     }
     else {
         const chatModel = await loadChatModel({ ...modelOptions });
-        aigne = new AIGNE({ model: chatModel });
+        aigne = new AIGNE({
+            model: chatModel,
+            metadata: { ...metadata, cliVersion: AIGNE_CLI_VERSION },
+        });
     }
     if (printTips && !printed) {
         printed = true;

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

@@ -1,4 +1,5 @@
 import type { Message } from "@aigne/core";
+import type { AIGNEMetadata } from "@aigne/core/aigne/type.js";
 import { loadAIGNE } from "../load-aigne.js";
 import { type AgentRunCommonOptions } from "../yargs.js";
 import { type AgentInChildProcess, type CLIAgentInChildProcess } from "./run-aigne-in-child-process.js";
@@ -17,4 +18,5 @@ export declare function invokeCLIAgentFromDirInChildProcess(options: {
     parent?: string[];
     agent: string;
     input: Message & AgentRunCommonOptions;
+    metadata?: AIGNEMetadata;
 }): Promise<void>;

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

@@ -53,9 +53,8 @@ export async function invokeCLIAgentFromDirInChildProcess(options) {
         path: options.dir,
         modelOptions: options.input,
         printTips: true,
-        imageModelOptions: {
-            model: options.input.imageModel,
-        },
+        imageModelOptions: { model: options.input.imageModel },
+        metadata: options.metadata,
     });
     try {
         const { chat } = aigne.cli;

package/package.json

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