@aigne/cli 1.59.0-beta.29 → 1.59.0-beta.30

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## [1.59.0-beta.30](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.29...cli-v1.59.0-beta.30) (2026-01-16)
+
+
+### Features
+
+* **afs:** add AFSJSON module support mount a JSON/yaml file to AFS ([6adedc6](https://github.com/AIGNE-io/aigne-framework/commit/6adedc624bedb1bc741da8534f2fbb41e1bc6623))
+* **cli:** start AFS explorer when agent running ([d532ff6](https://github.com/AIGNE-io/aigne-framework/commit/d532ff65d08fb295b3b68390f303f23cd9c266db))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.10
+    * @aigne/afs-explorer bumped to 1.0.0
+    * @aigne/afs-history bumped to 1.2.0-beta.11
+    * @aigne/afs-local-fs bumped to 1.4.0-beta.25
+    * @aigne/agent-library bumped to 1.24.0-beta.26
+    * @aigne/agentic-memory bumped to 1.1.6-beta.24
+    * @aigne/aigne-hub bumped to 0.10.16-beta.30
+    * @aigne/core bumped to 1.72.0-beta.24
+    * @aigne/default-memory bumped to 1.4.0-beta.23
+    * @aigne/openai bumped to 0.16.16-beta.24
+    * @aigne/secrets bumped to 0.1.6-beta.24
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.24
+
 ## [1.59.0-beta.29](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.28...cli-v1.59.0-beta.29) (2026-01-15)
 
 

package/dist/constants.d.ts

@@ -4,3 +4,4 @@ export declare const availableMemories: (typeof DefaultMemory)[];
 export declare const AIGNE_HUB_CREDITS_NOT_ENOUGH_ERROR_TYPE = "NOT_ENOUGH";
 export declare const CHAT_MODEL_OPTIONS: string[];
 export declare const DEFAULT_USER_ID = "cli-user";
+export declare const DEFAULT_AFS_EXPLORER_PORT = 9670;

package/dist/constants.js

@@ -18,3 +18,4 @@ export const CHAT_MODEL_OPTIONS = [
     "reasoningEffort",
 ];
 export const DEFAULT_USER_ID = "cli-user";
+export const DEFAULT_AFS_EXPLORER_PORT = 9670;

package/dist/utils/aigne-hub/store/index.d.ts

@@ -1,4 +1,5 @@
 import FileStore from "./file.js";
 import KeyringStore from "./keytar.js";
 declare const getSecretStore: () => Promise<FileStore | KeyringStore>;
+export declare const resetSecretStoreCache: () => void;
 export default getSecretStore;

package/dist/utils/aigne-hub/store/index.js

@@ -37,4 +37,7 @@ const getSecretStore = async () => {
     }
     return cachedSecretStore;
 };
+export const resetSecretStoreCache = () => {
+    cachedSecretStore = undefined;
+};
 export default getSecretStore;

package/dist/utils/inquirer/checkbox.js

@@ -153,7 +153,6 @@ export default createPrompt((config, done) => {
                 let next = active;
                 do {
                     next = (next + offset + items.length) % items.length;
-                    // biome-ignore lint/style/noNonNullAssertion: we need to access items dynamically
                 } while (!isSelectable(items[next]));
                 setActive(next);
             }

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

@@ -1,4 +1,4 @@
-import { AIGNE, type ChatModelInputOptions, type ImageModelInputOptions } from "@aigne/core";
+import { AIGNE, type ChatModel, 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";
@@ -8,6 +8,7 @@ export interface RunOptions extends AgentRunCommonOptions {
     cacheDir?: string;
     aigneHubUrl?: string;
 }
+export declare function printChatModelInfoBox(model: ChatModel, otherLines?: string[]): Promise<void>;
 export declare function loadAIGNE({ path, modelOptions, imageModelOptions, skipModelLoading, metadata, }: {
     path?: string;
     modelOptions?: ChatModelInputOptions & LoadCredentialOptions;

package/dist/utils/load-aigne.js

@@ -6,8 +6,8 @@ import chalk from "chalk";
 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;
-async function printChatModelInfoBox(model) {
+export async function printChatModelInfoBox(model, otherLines) {
+    console.log(`${chalk.grey("TIPS:")} run ${chalk.cyan("aigne observe")} to start the observability server.\n`);
     const credential = await model.credential;
     const lines = [`${chalk.cyan("Provider")}: ${chalk.green(model.name.replace("ChatModel", ""))}`];
     if (credential?.model) {
@@ -19,6 +19,8 @@ async function printChatModelInfoBox(model) {
     if (credential?.apiKey) {
         lines.push(`${chalk.cyan("API Key")}: ${chalk.green(maskApiKey(credential?.apiKey))}`);
     }
+    if (otherLines?.length)
+        lines.push(...otherLines);
     console.log(boxen(lines.join("\n"), { padding: 1, borderStyle: "classic", borderColor: "cyan" }));
     console.log("");
 }
@@ -74,12 +76,5 @@ export async function loadAIGNE({ path, modelOptions, imageModelOptions, skipMod
             metadata: { ...metadata, cliVersion: AIGNE_CLI_VERSION },
         });
     }
-    if (!skipModelLoading && !printed) {
-        printed = true;
-        console.log(`${chalk.grey("TIPS:")} run ${chalk.cyan("aigne observe")} to start the observability server.\n`);
-        if (aigne.model) {
-            await printChatModelInfoBox(aigne.model);
-        }
-    }
     return aigne;
 }

package/dist/utils/run-chat-loop.js

@@ -7,8 +7,6 @@ import { terminalInput } from "../ui/utils/terminal-input.js";
 export const DEFAULT_CHAT_INPUT_KEY = "message";
 export async function runChatLoopInTerminal(userAgent, options = {}) {
     const { initialCall } = options;
-    if (options?.welcome)
-        console.log(options.welcome);
     if (initialCall) {
         await callAgent(userAgent, initialCall, options);
         if (options.input && options.inputFileKey) {

package/dist/utils/run-with-aigne.js

@@ -1,17 +1,20 @@
 import { mkdir, stat, writeFile } from "node:fs/promises";
 import { dirname, isAbsolute, join } from "node:path";
 import { isatty } from "node:tty";
+import { fileURLToPath } from "node:url";
+import { startExplorer } from "@aigne/afs-explorer";
 import { exists } from "@aigne/agent-library/utils/fs.js";
 import { AIAgent, DEFAULT_OUTPUT_KEY, UserAgent, } from "@aigne/core";
 import { logger } from "@aigne/core/utils/logger.js";
 import { isEmpty, isNil, omitBy, pick } from "@aigne/core/utils/type-utils.js";
 import { v7 } from "@aigne/uuid";
 import chalk from "chalk";
+import { detect } from "detect-port";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
-import { DEFAULT_USER_ID } from "../constants.js";
+import { DEFAULT_AFS_EXPLORER_PORT, DEFAULT_USER_ID } from "../constants.js";
 import { TerminalTracer } from "../tracer/terminal.js";
-import { loadAIGNE } from "./load-aigne.js";
+import { loadAIGNE, printChatModelInfoBox } from "./load-aigne.js";
 import { DEFAULT_CHAT_INPUT_KEY, runChatLoopInTerminal, } from "./run-chat-loop.js";
 import { parseAgentInput, withAgentInputSchema, withRunAgentCommonOptions, } from "./yargs.js";
 export async function parseAgentInputByCommander(agent, options = {}) {
@@ -54,6 +57,8 @@ export async function runWithAIGNE(agentCreator, { aigne, argv = process.argv, c
                 ...omitBy(pick(options, "model", "temperature", "topP", "presencePenalty", "frequencyPenalty"), (v) => isNil(v)),
             },
         });
+        let explorerServer;
+        let explorerServerURL;
         try {
             const agent = typeof agentCreator === "function" ? await agentCreator(aigne) : agentCreator;
             const input = await parseAgentInputByCommander(agent, {
@@ -61,6 +66,23 @@ export async function runWithAIGNE(agentCreator, { aigne, argv = process.argv, c
                 inputKey: chatLoopOptions?.inputKey,
                 defaultInput: chatLoopOptions?.initialCall || chatLoopOptions?.defaultQuestion,
             });
+            if (agent.afs) {
+                const port = await detect(DEFAULT_AFS_EXPLORER_PORT);
+                explorerServer = await startExplorer(agent.afs, {
+                    port,
+                    distPath: dirname(fileURLToPath(import.meta.resolve("@aigne/afs-explorer/index.html"))),
+                });
+                explorerServerURL = `http://localhost:${port}`;
+            }
+            if (aigne.model) {
+                const lines = [];
+                if (explorerServerURL) {
+                    lines.push(`${chalk.cyan("AFS Explorer")}: ${chalk.green(explorerServerURL)}`);
+                }
+                await printChatModelInfoBox(aigne.model, lines);
+            }
+            if (chatLoopOptions?.welcome)
+                console.log(chatLoopOptions.welcome);
             await runAgentWithAIGNE(aigne, agent, {
                 ...options,
                 outputKey: outputKey || options.outputKey,
@@ -71,6 +93,7 @@ export async function runWithAIGNE(agentCreator, { aigne, argv = process.argv, c
             });
         }
         finally {
+            await explorerServer?.stop();
             await aigne.shutdown();
         }
     })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/cli",
-  "version": "1.59.0-beta.29",
+  "version": "1.59.0-beta.30",
   "description": "Your command center for agent development",
   "publishConfig": {
     "access": "public"
@@ -90,17 +90,18 @@
     "yoctocolors-cjs": "^2.1.3",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.6",
-    "@aigne/afs": "^1.4.0-beta.9",
-    "@aigne/afs-history": "^1.2.0-beta.10",
-    "@aigne/agent-library": "^1.24.0-beta.25",
-    "@aigne/afs-local-fs": "^1.4.0-beta.24",
-    "@aigne/agentic-memory": "^1.1.6-beta.23",
-    "@aigne/core": "^1.72.0-beta.23",
-    "@aigne/aigne-hub": "^0.10.16-beta.29",
-    "@aigne/default-memory": "^1.4.0-beta.22",
-    "@aigne/openai": "^0.16.16-beta.23",
-    "@aigne/secrets": "^0.1.6-beta.23",
-    "@aigne/observability-api": "^0.11.14-beta.6"
+    "@aigne/afs": "^1.4.0-beta.10",
+    "@aigne/afs-explorer": "^1.0.0",
+    "@aigne/afs-history": "^1.2.0-beta.11",
+    "@aigne/afs-local-fs": "^1.4.0-beta.25",
+    "@aigne/agent-library": "^1.24.0-beta.26",
+    "@aigne/agentic-memory": "^1.1.6-beta.24",
+    "@aigne/aigne-hub": "^0.10.16-beta.30",
+    "@aigne/core": "^1.72.0-beta.24",
+    "@aigne/observability-api": "^0.11.14-beta.6",
+    "@aigne/openai": "^0.16.16-beta.24",
+    "@aigne/secrets": "^0.1.6-beta.24",
+    "@aigne/default-memory": "^1.4.0-beta.23"
   },
   "devDependencies": {
     "@inquirer/testing": "^2.1.50",
@@ -118,7 +119,7 @@
     "rimraf": "^6.0.1",
     "typescript": "^5.9.2",
     "ufo": "^1.6.1",
-    "@aigne/test-utils": "^0.5.69-beta.23"
+    "@aigne/test-utils": "^0.5.69-beta.24"
   },
   "scripts": {
     "lint": "tsc --noEmit",