@aigne/cli 1.57.3 → 1.58.0-beta.1

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # Changelog
 
+## [1.58.0-beta.1](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.58.0-beta...cli-v1.58.0-beta.1) (2025-12-08)
+
+
+### Bug Fixes
+
+* correct run example & doc improvements ([#707](https://github.com/AIGNE-io/aigne-framework/issues/707)) ([f98fc5d](https://github.com/AIGNE-io/aigne-framework/commit/f98fc5df28fd6ce6134128c2f0e5395c1554b740))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-local-fs bumped to 1.3.0-beta.1
+    * @aigne/agent-library bumped to 1.23.0-beta.1
+    * @aigne/agentic-memory bumped to 1.1.5-beta.1
+    * @aigne/aigne-hub bumped to 0.10.15-beta.1
+    * @aigne/core bumped to 1.71.0-beta.1
+    * @aigne/default-memory bumped to 1.3.5-beta.1
+    * @aigne/openai bumped to 0.16.15-beta.1
+    * @aigne/secrets bumped to 0.1.5-beta.1
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.68-beta.1
+
+## [1.58.0-beta](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.57.3...cli-v1.58.0-beta) (2025-12-07)
+
+
+### Features
+
+* support define agent by third library & orchestrator agent refactor ([#799](https://github.com/AIGNE-io/aigne-framework/issues/799)) ([7264b11](https://github.com/AIGNE-io/aigne-framework/commit/7264b11ab6eed787e928367f09aa08d254968d40))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.3.0-beta
+    * @aigne/afs-history bumped to 1.1.3-beta
+    * @aigne/afs-local-fs bumped to 1.3.0-beta
+    * @aigne/agent-library bumped to 1.23.0-beta
+    * @aigne/agentic-memory bumped to 1.1.5-beta
+    * @aigne/aigne-hub bumped to 0.10.15-beta
+    * @aigne/core bumped to 1.71.0-beta
+    * @aigne/default-memory bumped to 1.3.5-beta
+    * @aigne/openai bumped to 0.16.15-beta
+    * @aigne/secrets bumped to 0.1.5-beta
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.68-beta
+
 ## [1.57.3](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.57.3-beta...cli-v1.57.3) (2025-12-06)
 
 

package/dist/commands/aigne.js

@@ -11,10 +11,11 @@ import { createRunCommand } from "./run.js";
 import { createServeMCPCommand } from "./serve-mcp.js";
 import { createTestCommand } from "./test.js";
 export function createAIGNECommand(options) {
-    return yargs()
+    return (yargs()
         .scriptName("aigne")
         .usage(`${asciiLogo}\n$0 <command> [options]`)
         .version(AIGNE_CLI_VERSION)
+        // default command: when user runs `aigne` without subcommand, behave like `aigne run`
         .command(createRunCommand(options))
         .command(createEvalCommand(options))
         .command(createTestCommand(options))
@@ -25,8 +26,8 @@ export function createAIGNECommand(options) {
         .command(createHubCommand())
         .command(createDeployCommands())
         .demandCommand()
+        .version(false)
         .alias("help", "h")
-        .alias("version", "v")
         .wrap(null)
-        .strict();
+        .strict());
 }

package/dist/commands/hub.js

@@ -278,8 +278,8 @@ async function deleteHub(url) {
         if (isDefaultHub) {
             await secretStore.deleteDefault();
             const remainingHubs = await getHubs();
-            if (remainingHubs.length > 0) {
-                const nextHub = remainingHubs[0];
+            const nextHub = remainingHubs[0];
+            if (nextHub) {
                 await secretStore.setDefault(nextHub?.apiUrl);
                 console.log(chalk.green(`✓ Hub ${getUrlOrigin(url)} removed, switched to ${getUrlOrigin(nextHub?.apiUrl)}`));
                 return;

package/dist/commands/run.d.ts

@@ -2,6 +2,7 @@ import type { CommandModule } from "yargs";
 export declare function createRunCommand({ aigneFilePath, }?: {
     aigneFilePath?: string;
 }): CommandModule<unknown, {
+    version?: boolean;
     path?: string;
     entryAgent?: string;
 }>;

package/dist/commands/run.js

@@ -2,23 +2,27 @@ import { cp, mkdir, rm } from "node:fs/promises";
 import { homedir } from "node:os";
 import { isAbsolute, join, resolve } from "node:path";
 import { exists } from "@aigne/agent-library/utils/fs.js";
+import { findAIGNEFile } from "@aigne/core/loader/index.js";
 import { logger } from "@aigne/core/utils/logger.js";
 import { flat, isNonNullable, pick } from "@aigne/core/utils/type-utils.js";
 import { Listr, PRESET_TIMER } from "@aigne/listr2";
 import { config } from "dotenv-flow";
 import yargs from "yargs";
-import { CHAT_MODEL_OPTIONS } from "../constants.js";
+import { AIGNE_CLI_VERSION, CHAT_MODEL_OPTIONS } from "../constants.js";
 import { isV1Package, toAIGNEPackage } from "../utils/agent-v1.js";
 import { downloadAndExtract } from "../utils/download.js";
 import { loadAIGNE } from "../utils/load-aigne.js";
 import { isUrl } from "../utils/url.js";
 import { withRunAgentCommonOptions } from "../utils/yargs.js";
 import { agentCommandModule, cliAgentCommandModule } from "./app/agent.js";
+let yargsInstance = null;
 export function createRunCommand({ aigneFilePath, } = {}) {
     return {
-        command: "run [path] [entry-agent]",
+        // $0 must place after 'run' to make positional args work correctly
+        command: ["run [path] [entry-agent]", "$0"],
         describe: "Run AIGNE for the specified path",
         builder: async (yargs) => {
+            yargsInstance = yargs;
             return yargs
                 .positional("path", {
                 type: "string",
@@ -28,22 +32,44 @@ export function createRunCommand({ aigneFilePath, } = {}) {
                 .positional("entry-agent", {
                 type: "string",
                 describe: "Name of the agent to run (defaults to the entry agent if not specified)",
+            })
+                .option("version", {
+                type: "boolean",
+                alias: "v",
+                describe: "Show version number",
             })
                 .help(false)
                 .version(false)
                 .strict(false);
         },
         handler: async (options) => {
+            if (options.version) {
+                console.log(AIGNE_CLI_VERSION);
+                process.exit(0);
+                return;
+            }
             if (!options.entryAgent && options.path) {
                 if (!(await exists(options.path)) && !isUrl(options.path)) {
                     options.entryAgent = options.path;
                     options.path = undefined;
                 }
             }
+            const path = aigneFilePath || options.path || ".";
+            if (!(await findAIGNEFile(path).catch((error) => {
+                if (options._[0] !== "run") {
+                    yargsInstance?.showHelp();
+                }
+                else {
+                    throw error;
+                }
+                return false;
+            }))) {
+                return;
+            }
             // Parse model options for loading application
             const opts = withRunAgentCommonOptions(yargs(process.argv).help(false).version(false).strict(false)).parseSync();
             logger.level = opts.logLevel;
-            const { aigne } = await loadApplication(aigneFilePath || options.path || ".", {
+            const { aigne } = await loadApplication(path, {
                 modelOptions: pick(opts, CHAT_MODEL_OPTIONS),
                 imageModelOptions: { model: opts.imageModel },
             });

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

@@ -175,7 +175,7 @@ export async function loadAIGNEHubCredential(options) {
                     aigneHubUrl = customUrl;
                 }
                 else if (subscribe === "manual") {
-                    console.log("You chose to configure your own LLM API Keys. Exiting...");
+                    console.log("You chose to configure your own LLM API Keys. Please follow the instructions in the documentation: https://www.arcblock.io/docs/aigne-framework/models-configuration-9dc03e");
                     process.exit(0);
                 }
             }

package/dist/utils/load-aigne.js

@@ -1,3 +1,4 @@
+import { createRequire } from "node:module";
 import { AIGNE, } from "@aigne/core";
 import { isNil, omitBy } from "@aigne/core/utils/type-utils.js";
 import boxen from "boxen";
@@ -25,6 +26,12 @@ export async function loadAIGNE({ path, modelOptions, imageModelOptions, skipMod
     let aigne;
     if (path) {
         aigne = await AIGNE.load(path, {
+            require: async (modulePath, options) => {
+                if (!options.parent || modulePath.startsWith("@aigne/"))
+                    return import(modulePath);
+                const require = createRequire(options.parent);
+                return require(modulePath);
+            },
             memories: availableMemories,
             model: (options) => {
                 if (skipModelLoading)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/cli",
-  "version": "1.57.3",
+  "version": "1.58.0-beta.1",
   "description": "Your command center for agent development",
   "publishConfig": {
     "access": "public"
@@ -89,17 +89,17 @@
     "yoctocolors-cjs": "^2.1.3",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.6",
-    "@aigne/afs": "^1.2.3",
-    "@aigne/afs-history": "^1.1.2",
-    "@aigne/agent-library": "^1.22.4",
-    "@aigne/agentic-memory": "^1.1.4",
-    "@aigne/afs-local-fs": "^1.2.4",
-    "@aigne/core": "^1.70.1",
-    "@aigne/aigne-hub": "^0.10.14",
+    "@aigne/afs": "^1.3.0-beta",
+    "@aigne/afs-history": "^1.1.3-beta",
+    "@aigne/afs-local-fs": "^1.3.0-beta.1",
+    "@aigne/agent-library": "^1.23.0-beta.1",
+    "@aigne/agentic-memory": "^1.1.5-beta.1",
+    "@aigne/aigne-hub": "^0.10.15-beta.1",
+    "@aigne/core": "^1.71.0-beta.1",
     "@aigne/observability-api": "^0.11.12",
-    "@aigne/openai": "^0.16.14",
-    "@aigne/default-memory": "^1.3.4",
-    "@aigne/secrets": "^0.1.4"
+    "@aigne/default-memory": "^1.3.5-beta.1",
+    "@aigne/secrets": "^0.1.5-beta.1",
+    "@aigne/openai": "^0.16.15-beta.1"
   },
   "devDependencies": {
     "@inquirer/testing": "^2.1.50",
@@ -116,7 +116,7 @@
     "rimraf": "^6.0.1",
     "typescript": "^5.9.2",
     "ufo": "^1.6.1",
-    "@aigne/test-utils": "^0.5.67"
+    "@aigne/test-utils": "^0.5.68-beta.1"
   },
   "scripts": {
     "lint": "tsc --noEmit",