@aigne/cli 1.59.0-beta.2 → 1.59.0-beta.21

package/CHANGELOG.md

@@ -1,5 +1,375 @@
 # Changelog
 
+## [1.59.0-beta.21](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.20...cli-v1.59.0-beta.21) (2026-01-12)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.8
+    * @aigne/afs-history bumped to 1.2.0-beta.9
+    * @aigne/afs-local-fs bumped to 1.4.0-beta.17
+    * @aigne/agent-library bumped to 1.24.0-beta.18
+    * @aigne/agentic-memory bumped to 1.1.6-beta.16
+    * @aigne/aigne-hub bumped to 0.10.16-beta.21
+    * @aigne/core bumped to 1.72.0-beta.16
+    * @aigne/default-memory bumped to 1.4.0-beta.15
+    * @aigne/openai bumped to 0.16.16-beta.16
+    * @aigne/secrets bumped to 0.1.6-beta.16
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.16
+
+## [1.59.0-beta.20](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.19...cli-v1.59.0-beta.20) (2026-01-10)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-local-fs bumped to 1.4.0-beta.16
+    * @aigne/agent-library bumped to 1.24.0-beta.17
+    * @aigne/agentic-memory bumped to 1.1.6-beta.15
+    * @aigne/aigne-hub bumped to 0.10.16-beta.20
+    * @aigne/core bumped to 1.72.0-beta.15
+    * @aigne/default-memory bumped to 1.4.0-beta.14
+    * @aigne/openai bumped to 0.16.16-beta.15
+    * @aigne/secrets bumped to 0.1.6-beta.15
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.15
+
+## [1.59.0-beta.19](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.18...cli-v1.59.0-beta.19) (2026-01-09)
+
+
+### Bug Fixes
+
+* **cli:** cache approved commands in run-skill to avoid redundant prompts ([d07fe6d](https://github.com/AIGNE-io/aigne-framework/commit/d07fe6d049cd063e750e5b3fe231c74dae26bc9d))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-local-fs bumped to 1.4.0-beta.15
+    * @aigne/agent-library bumped to 1.24.0-beta.16
+    * @aigne/agentic-memory bumped to 1.1.6-beta.14
+    * @aigne/aigne-hub bumped to 0.10.16-beta.19
+    * @aigne/core bumped to 1.72.0-beta.14
+    * @aigne/default-memory bumped to 1.4.0-beta.13
+    * @aigne/openai bumped to 0.16.16-beta.14
+    * @aigne/secrets bumped to 0.1.6-beta.14
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.14
+
+## [1.59.0-beta.18](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.17...cli-v1.59.0-beta.18) (2026-01-08)
+
+
+### Bug Fixes
+
+* **cli:** ask user retry when model request respond error ([#884](https://github.com/AIGNE-io/aigne-framework/issues/884)) ([60aabbb](https://github.com/AIGNE-io/aigne-framework/commit/60aabbb34be6104f25f0383c2279f7f089268631))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/aigne-hub bumped to 0.10.16-beta.18
+
+## [1.59.0-beta.17](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.16...cli-v1.59.0-beta.17) (2026-01-08)
+
+
+### Features
+
+* **afs,bash:** add physical path mapping for AFS modules in bash execution ([#881](https://github.com/AIGNE-io/aigne-framework/issues/881)) ([50dbda2](https://github.com/AIGNE-io/aigne-framework/commit/50dbda224bd666d951494d2449779830d8db57fc))
+
+
+### Bug Fixes
+
+* bump version ([696560f](https://github.com/AIGNE-io/aigne-framework/commit/696560fa2673eddcb4d00ac0523fbbbde7273cb3))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.7
+    * @aigne/afs-history bumped to 1.2.0-beta.8
+    * @aigne/afs-local-fs bumped to 1.4.0-beta.14
+    * @aigne/agent-library bumped to 1.24.0-beta.15
+    * @aigne/agentic-memory bumped to 1.1.6-beta.13
+    * @aigne/aigne-hub bumped to 0.10.16-beta.17
+    * @aigne/core bumped to 1.72.0-beta.13
+    * @aigne/default-memory bumped to 1.4.0-beta.12
+    * @aigne/observability-api bumped to 0.11.14-beta.2
+    * @aigne/openai bumped to 0.16.16-beta.13
+    * @aigne/secrets bumped to 0.1.6-beta.13
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.13
+
+## [1.59.0-beta.16](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.15...cli-v1.59.0-beta.16) (2026-01-07)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-local-fs bumped to 1.4.0-beta.13
+
+## [1.59.0-beta.15](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.14...cli-v1.59.0-beta.15) (2026-01-07)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-local-fs bumped to 1.4.0-beta.12
+    * @aigne/agent-library bumped to 1.24.0-beta.14
+    * @aigne/agentic-memory bumped to 1.1.6-beta.12
+    * @aigne/aigne-hub bumped to 0.10.16-beta.16
+    * @aigne/core bumped to 1.72.0-beta.12
+    * @aigne/default-memory bumped to 1.4.0-beta.11
+    * @aigne/openai bumped to 0.16.16-beta.12
+    * @aigne/secrets bumped to 0.1.6-beta.12
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.12
+
+## [1.59.0-beta.14](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.13...cli-v1.59.0-beta.14) (2026-01-06)
+
+
+### Bug Fixes
+
+* **core:** preserve Agent Skill in session compact and support complex tool result content ([#876](https://github.com/AIGNE-io/aigne-framework/issues/876)) ([edb86ae](https://github.com/AIGNE-io/aigne-framework/commit/edb86ae2b9cfe56a8f08b276f843606e310566cf))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.6
+    * @aigne/afs-history bumped to 1.2.0-beta.7
+    * @aigne/afs-local-fs bumped to 1.4.0-beta.11
+    * @aigne/agent-library bumped to 1.24.0-beta.13
+    * @aigne/agentic-memory bumped to 1.1.6-beta.11
+    * @aigne/aigne-hub bumped to 0.10.16-beta.15
+    * @aigne/core bumped to 1.72.0-beta.11
+    * @aigne/default-memory bumped to 1.4.0-beta.10
+    * @aigne/openai bumped to 0.16.16-beta.11
+    * @aigne/secrets bumped to 0.1.6-beta.11
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.11
+
+## [1.59.0-beta.13](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.12...cli-v1.59.0-beta.13) (2026-01-06)
+
+
+### Features
+
+* **core:** add cross session user memory support ([#873](https://github.com/AIGNE-io/aigne-framework/issues/873)) ([f377aa1](https://github.com/AIGNE-io/aigne-framework/commit/f377aa17f2cf8004fd3225ade4a37fd90af1292f))
+
+
+### Bug Fixes
+
+* **cli:** add askUserQuestion for run-skill command ([9c621e7](https://github.com/AIGNE-io/aigne-framework/commit/9c621e7c55501d129e71966da79514717a4579ab))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-history bumped to 1.2.0-beta.6
+    * @aigne/afs-local-fs bumped to 1.4.0-beta.10
+    * @aigne/agent-library bumped to 1.24.0-beta.12
+    * @aigne/agentic-memory bumped to 1.1.6-beta.10
+    * @aigne/aigne-hub bumped to 0.10.16-beta.14
+    * @aigne/core bumped to 1.72.0-beta.10
+    * @aigne/default-memory bumped to 1.4.0-beta.9
+    * @aigne/openai bumped to 0.16.16-beta.10
+    * @aigne/secrets bumped to 0.1.6-beta.10
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.10
+
+## [1.59.0-beta.12](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.11...cli-v1.59.0-beta.12) (2026-01-02)
+
+
+### Features
+
+* **cli:** add run-skill command ([#868](https://github.com/AIGNE-io/aigne-framework/issues/868)) ([f62ffe2](https://github.com/AIGNE-io/aigne-framework/commit/f62ffe21acc49ec1a68349fbb35a13d0fadd239a))
+
+
+### Bug Fixes
+
+* **cli:** add chat aliases for interactive option ([#867](https://github.com/AIGNE-io/aigne-framework/issues/867)) ([91f27fd](https://github.com/AIGNE-io/aigne-framework/commit/91f27fd874b8c4b2ded2d7cd46e2821f70943c69))
+* **cli:** rename cmd option --chat to --interactive ([#865](https://github.com/AIGNE-io/aigne-framework/issues/865)) ([480eca4](https://github.com/AIGNE-io/aigne-framework/commit/480eca49a7381a330024f1f0026bbc5f89b57bbb))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-local-fs bumped to 1.4.0-beta.9
+    * @aigne/agent-library bumped to 1.24.0-beta.11
+    * @aigne/agentic-memory bumped to 1.1.6-beta.9
+    * @aigne/aigne-hub bumped to 0.10.16-beta.13
+    * @aigne/core bumped to 1.72.0-beta.9
+    * @aigne/default-memory bumped to 1.4.0-beta.8
+    * @aigne/openai bumped to 0.16.16-beta.9
+    * @aigne/secrets bumped to 0.1.6-beta.9
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.9
+
+## [1.59.0-beta.11](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.10...cli-v1.59.0-beta.11) (2025-12-31)
+
+
+### Features
+
+* add session compact support for AIAgent ([#863](https://github.com/AIGNE-io/aigne-framework/issues/863)) ([9010918](https://github.com/AIGNE-io/aigne-framework/commit/9010918cd3f18b02b5c60ddc9ed5c34b568d0b28))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.5
+    * @aigne/afs-history bumped to 1.2.0-beta.5
+    * @aigne/afs-local-fs bumped to 1.4.0-beta.8
+    * @aigne/agent-library bumped to 1.24.0-beta.10
+    * @aigne/agentic-memory bumped to 1.1.6-beta.8
+    * @aigne/aigne-hub bumped to 0.10.16-beta.12
+    * @aigne/core bumped to 1.72.0-beta.8
+    * @aigne/default-memory bumped to 1.4.0-beta.7
+    * @aigne/openai bumped to 0.16.16-beta.8
+    * @aigne/secrets bumped to 0.1.6-beta.8
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.8
+
+## [1.59.0-beta.10](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.9...cli-v1.59.0-beta.10) (2025-12-26)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/agent-library bumped to 1.24.0-beta.9
+    * @aigne/aigne-hub bumped to 0.10.16-beta.11
+
+## [1.59.0-beta.9](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.8...cli-v1.59.0-beta.9) (2025-12-26)
+
+
+### Features
+
+* **core:** add session history support ([#858](https://github.com/AIGNE-io/aigne-framework/issues/858)) ([28a070e](https://github.com/AIGNE-io/aigne-framework/commit/28a070ed33b821d1fd344b899706d817ca992b9f))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.4
+    * @aigne/afs-history bumped to 1.2.0-beta.4
+    * @aigne/afs-local-fs bumped to 1.4.0-beta.7
+    * @aigne/agent-library bumped to 1.24.0-beta.8
+    * @aigne/agentic-memory bumped to 1.1.6-beta.7
+    * @aigne/aigne-hub bumped to 0.10.16-beta.10
+    * @aigne/core bumped to 1.72.0-beta.7
+    * @aigne/default-memory bumped to 1.4.0-beta.6
+    * @aigne/openai bumped to 0.16.16-beta.7
+    * @aigne/secrets bumped to 0.1.6-beta.7
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.7
+
+## [1.59.0-beta.8](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.7...cli-v1.59.0-beta.8) (2025-12-25)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-local-fs bumped to 1.4.0-beta.6
+    * @aigne/agent-library bumped to 1.24.0-beta.7
+    * @aigne/agentic-memory bumped to 1.1.6-beta.6
+    * @aigne/aigne-hub bumped to 0.10.16-beta.9
+    * @aigne/core bumped to 1.72.0-beta.6
+    * @aigne/default-memory bumped to 1.3.6-beta.6
+    * @aigne/openai bumped to 0.16.16-beta.6
+    * @aigne/secrets bumped to 0.1.6-beta.6
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.6
+
+## [1.59.0-beta.7](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.6...cli-v1.59.0-beta.7) (2025-12-25)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/aigne-hub bumped to 0.10.16-beta.8
+
+## [1.59.0-beta.6](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.5...cli-v1.59.0-beta.6) (2025-12-25)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/agent-library bumped to 1.24.0-beta.6
+    * @aigne/aigne-hub bumped to 0.10.16-beta.7
+
+## [1.59.0-beta.5](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.4...cli-v1.59.0-beta.5) (2025-12-25)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-local-fs bumped to 1.4.0-beta.5
+    * @aigne/agent-library bumped to 1.24.0-beta.5
+    * @aigne/agentic-memory bumped to 1.1.6-beta.5
+    * @aigne/aigne-hub bumped to 0.10.16-beta.6
+    * @aigne/core bumped to 1.72.0-beta.5
+    * @aigne/default-memory bumped to 1.3.6-beta.5
+    * @aigne/openai bumped to 0.16.16-beta.5
+    * @aigne/secrets bumped to 0.1.6-beta.5
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.5
+
+## [1.59.0-beta.4](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.3...cli-v1.59.0-beta.4) (2025-12-24)
+
+
+### Features
+
+* add Agent Skill support ([#787](https://github.com/AIGNE-io/aigne-framework/issues/787)) ([f04fbe7](https://github.com/AIGNE-io/aigne-framework/commit/f04fbe76ec24cf3c59c74adf92d87b0c3784a8f7))
+
+
+### Bug Fixes
+
+* **cli:** improve terminal outputs ([#847](https://github.com/AIGNE-io/aigne-framework/issues/847)) ([329e91b](https://github.com/AIGNE-io/aigne-framework/commit/329e91bc3323f72fc8a2d278ff5e6bba9adbd6e0))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.3
+    * @aigne/afs-history bumped to 1.2.0-beta.3
+    * @aigne/afs-local-fs bumped to 1.4.0-beta.4
+    * @aigne/agent-library bumped to 1.24.0-beta.4
+    * @aigne/agentic-memory bumped to 1.1.6-beta.4
+    * @aigne/aigne-hub bumped to 0.10.16-beta.5
+    * @aigne/core bumped to 1.72.0-beta.4
+    * @aigne/default-memory bumped to 1.3.6-beta.4
+    * @aigne/openai bumped to 0.16.16-beta.4
+    * @aigne/secrets bumped to 0.1.6-beta.4
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.4
+
+## [1.59.0-beta.3](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.59.0-beta.2...cli-v1.59.0-beta.3) (2025-12-22)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/aigne-hub bumped to 0.10.16-beta.4
+
 ## [1.59.0-beta.2](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.58.1-beta.2...cli-v1.59.0-beta.2) (2025-12-19)
 
 

package/dist/commands/aigne.js

@@ -8,6 +8,7 @@ import { createEvalCommand } from "./eval.js";
 import { createHubCommand } from "./hub.js";
 import { createObservabilityCommand } from "./observe.js";
 import { createRunCommand } from "./run.js";
+import { createRunSkillCommand } from "./run-skill.js";
 import { createServeMCPCommand } from "./serve-mcp.js";
 import { createTestCommand } from "./test.js";
 export function createAIGNECommand(options) {
@@ -17,6 +18,7 @@ export function createAIGNECommand(options) {
         .version(AIGNE_CLI_VERSION)
         // default command: when user runs `aigne` without subcommand, behave like `aigne run`
         .command(createRunCommand(options))
+        .command(createRunSkillCommand())
         .command(createEvalCommand(options))
         .command(createTestCommand(options))
         .command(createCreateCommand())

package/dist/commands/app/agent.js

@@ -1,5 +1,7 @@
 import assert from "node:assert";
+import { DEFAULT_USER_ID } from "@aigne/cli/constants.js";
 import { logger } from "@aigne/core/utils/logger.js";
+import { v7 } from "@aigne/uuid";
 import { runAgentWithAIGNE } from "../../utils/run-with-aigne.js";
 import { parseAgentInput, withAgentInputSchema, } from "../../utils/yargs.js";
 import { serveMCPServerFromDir } from "../serve-mcp.js";
@@ -96,7 +98,9 @@ export async function invokeAgent(options) {
         await runAgentWithAIGNE(aigne, agent, {
             ...options.input,
             input,
-            chat: options.input.chat,
+            interactive: options.input.interactive,
+            sessionId: options.input.sessionId || v7(),
+            userId: DEFAULT_USER_ID,
         });
     }
     finally {

package/dist/commands/run-skill.d.ts

@@ -0,0 +1,6 @@
+import type { CommandModule } from "yargs";
+import { type AgentRunCommonOptions } from "../utils/yargs.js";
+export declare function createRunSkillCommand(): CommandModule<unknown, {
+    skill?: string[];
+    interactive?: boolean;
+} & AgentRunCommonOptions>;

package/dist/commands/run-skill.js

@@ -0,0 +1,102 @@
+import { basename, resolve } from "node:path";
+import { AFSHistory } from "@aigne/afs-history";
+import { LocalFS } from "@aigne/afs-local-fs";
+import AgentSkillManager from "@aigne/agent-library/agent-skill-manager";
+import AskUserQuestion from "@aigne/agent-library/ask-user-question";
+import BashAgent from "@aigne/agent-library/bash";
+import { AIGNE, FunctionAgent } from "@aigne/core";
+import { z } from "zod";
+import { loadChatModel } from "../utils/aigne-hub/model.js";
+import { withAgentInputSchema } from "../utils/yargs.js";
+import { invokeAgent } from "./app/agent.js";
+export function createRunSkillCommand() {
+    return {
+        command: ["run-skill"],
+        describe: "Run Agent Skill for the specified path",
+        builder: async (yargs) => {
+            return withAgentInputSchema(yargs
+                .option("skill", {
+                array: true,
+                type: "string",
+                describe: "Path to the Agent Skill directory",
+            })
+                .option("interactive", {
+                describe: "Run in interactive chat mode",
+                type: "boolean",
+                default: false,
+                alias: ["chat"],
+            })
+                .demandOption("skill"), {
+                inputSchema: z.object({
+                    message: z.string(),
+                }),
+                optionalInputs: ["message"],
+            });
+        },
+        handler: async (options) => {
+            if (!Array.isArray(options.skill) || options.skill.length === 0) {
+                throw new Error("At least one skill path must be provided.");
+            }
+            const model = await loadChatModel({
+                model: options.model || "aignehub/anthropic/claude-sonnet-4-5",
+            });
+            const aigne = new AIGNE({ model });
+            const approvedCmds = new Set();
+            const agent = new AgentSkillManager({
+                inputKey: "message",
+                taskRenderMode: "collapse",
+                skills: [
+                    new BashAgent({
+                        sandbox: false,
+                        permissions: {
+                            defaultMode: "ask",
+                            guard: FunctionAgent.from(async (input, options) => {
+                                if (approvedCmds.has(input.script || "")) {
+                                    return {
+                                        approved: true,
+                                    };
+                                }
+                                const confirm = options.prompts?.confirm;
+                                if (!confirm)
+                                    throw new Error("No confirm prompt available for permission guard.");
+                                const approved = await confirm({ message: `Run command ${input.script}?` });
+                                if (approved && input.script) {
+                                    approvedCmds.add(input.script);
+                                }
+                                return {
+                                    approved,
+                                };
+                            }),
+                        },
+                    }),
+                    new AskUserQuestion(),
+                ],
+                afs: {
+                    modules: [
+                        new AFSHistory({}),
+                        new LocalFS({
+                            name: "workspace",
+                            localPath: process.cwd(),
+                            description: `\
+Current working directory. All temporary files should be written here using absolute AFS paths (e.g., /modules/workspace/temp.py).
+Note: Bash is already running in this directory, so do NOT use 'cd /modules/workspace' in scripts. Use relative paths directly (e.g., python temp.py).`,
+                        }),
+                        ...options.skill.map((path) => new LocalFS({
+                            name: basename(resolve(path)),
+                            localPath: path,
+                            description: "Contains Agent Skills. Use 'Skill' tool to invoke skills from this module.",
+                            agentSkills: true,
+                        })),
+                    ],
+                },
+            });
+            await invokeAgent({
+                aigne,
+                agent,
+                input: {
+                    ...options,
+                },
+            });
+        },
+    };
+}

package/dist/commands/run.d.ts

@@ -5,5 +5,5 @@ export declare function createRunCommand({ aigneFilePath, }?: {
     version?: boolean;
     path?: string;
     entryAgent?: string;
-    chat?: boolean;
+    interactive?: boolean;
 }>;

package/dist/commands/run.js

@@ -38,10 +38,11 @@ export function createRunCommand({ aigneFilePath, } = {}) {
                 alias: "v",
                 describe: "Show version number",
             })
-                .option("chat", {
-                describe: "Run chat loop in terminal",
+                .option("interactive", {
+                describe: "Run in interactive chat mode",
                 type: "boolean",
                 default: false,
+                alias: ["chat"],
             })
                 .help(false)
                 .version(false)
@@ -60,15 +61,16 @@ export function createRunCommand({ aigneFilePath, } = {}) {
                 }
             }
             const path = aigneFilePath || options.path || ".";
-            if (!(await findAIGNEFile(path).catch((error) => {
-                if (options._[0] !== "run") {
-                    yargsInstance?.showHelp();
-                }
-                else {
-                    throw error;
-                }
-                return false;
-            }))) {
+            if (!isUrl(path) &&
+                !(await findAIGNEFile(path).catch((error) => {
+                    if (options._[0] !== "run") {
+                        yargsInstance?.showHelp();
+                    }
+                    else {
+                        throw error;
+                    }
+                    return false;
+                }))) {
                 return;
             }
             // Parse model options for loading application
@@ -88,7 +90,7 @@ export function createRunCommand({ aigneFilePath, } = {}) {
             // Allow user to run all of agents in the AIGNE instances
             const allAgents = flat(aigne.agents, aigne.skills, aigne.cli.chat, aigne.mcpServer.agents);
             for (const agent of allAgents) {
-                subYargs.command(agentCommandModule({ aigne, agent, chat: options.chat }));
+                subYargs.command(agentCommandModule({ aigne, agent, chat: options.interactive }));
             }
             for (const cliAgent of aigne.cli.agents ?? []) {
                 subYargs.command(cliAgentCommandModule({

package/dist/constants.d.ts

@@ -3,3 +3,4 @@ export declare const AIGNE_CLI_VERSION: any;
 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";

package/dist/constants.js

@@ -17,3 +17,4 @@ export const CHAT_MODEL_OPTIONS = [
     "preferInputFileType",
     "reasoningEffort",
 ];
+export const DEFAULT_USER_ID = "cli-user";

package/dist/tracer/terminal.js

@@ -154,6 +154,7 @@ export class TerminalTracer {
             }
             task.resolve();
         };
+        let retryPromptPromise;
         const onError = async ({ context, agent, error, ...event }) => {
             if ("type" in error && error.type === AIGNE_HUB_CREDITS_NOT_ENOUGH_ERROR_TYPE) {
                 if (!Object.hasOwn(error, CREDITS_ERROR_PROCESSED_FLAG)) {
@@ -168,6 +169,23 @@ export class TerminalTracer {
                     }
                 }
             }
+            if (agent instanceof ChatModel) {
+                retryPromptPromise ??= this.proxiedPrompts
+                    .select({
+                    message: chalk.red(`Error: ${error.message}`),
+                    choices: [
+                        { value: "retry", name: "Retry" },
+                        { value: "exit", name: "Exit" },
+                    ],
+                })
+                    .then((result) => ({ retry: result === "retry" }))
+                    .finally(() => {
+                    retryPromptPromise = undefined;
+                });
+                const { retry } = await retryPromptPromise;
+                if (retry)
+                    return { retry: true };
+            }
             const contextId = context.id;
             const task = this.tasks[contextId];
             if (!task)

package/dist/ui/utils/terminal-input.d.ts

@@ -6,6 +6,7 @@ export declare function terminalInput({ render: r, ...options }?: {
     required?: boolean;
     validate?: (input: string) => string | boolean | Promise<string | boolean>;
     render?: typeof render;
+    clear?: boolean;
 }): Promise<string>;
 export declare function TerminalInput(props: {
     message?: string;

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

@@ -12,10 +12,14 @@ export async function terminalInput({ render: r = render, ...options } = {}) {
         process.addListener("SIGINT", handleSigInt);
         const clean = () => process.removeListener("SIGINT", handleSigInt);
         const app = r(_jsx(TerminalInput, { ...options, onSubmit: (value) => {
+                if (options.clear)
+                    app.clear();
                 app.unmount();
                 resolve(value);
                 clean();
             }, onError: (error) => {
+                if (options.clear)
+                    app.clear();
                 app.unmount();
                 reject(error);
                 clean();

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

@@ -1,5 +1,5 @@
 import { logger } from "@aigne/core/utils/logger.js";
-import { AIGNE_ENV_FILE } from "../constants.js";
+import { AIGNE_ENV_FILE, isTest } from "../constants.js";
 import FileStore from "./file.js";
 import KeyringStore from "./keytar.js";
 import { migrateFileToKeyring } from "./migrate.js";
@@ -32,7 +32,7 @@ const getSecretStore = async () => {
         cachedSecretStore = await createSecretStore({
             filepath: AIGNE_ENV_FILE,
             serviceName: "aigne-hub",
-            // forceKeytarUnavailable: true,
+            forceKeytarUnavailable: Boolean(isTest),
         });
     }
     return cachedSecretStore;

package/dist/utils/listr.d.ts

@@ -1,4 +1,4 @@
-import type { AgentResponseStream, Message } from "@aigne/core";
+import { type AgentResponseStream, type Message } from "@aigne/core";
 import type { PromiseOrValue } from "@aigne/core/utils/type-utils.js";
 import { DefaultRenderer, Listr, type ListrDefaultRendererOptions, ListrLogger, type ListrSimpleRendererOptions, type ListrTaskWrapper, SimpleRenderer, Spinner } from "@aigne/listr2";
 import type { createLogUpdate } from "log-update";
@@ -22,7 +22,9 @@ export declare class AIGNEListr extends Listr<object, typeof AIGNEListrRenderer,
             renderImage?: boolean;
         }) => string | Promise<string>;
     }, ...[task, options, parentTask]: ConstructorParameters<typeof Listr<object, typeof AIGNEListrRenderer, typeof AIGNEListrFallbackRenderer>>);
+    private needLogResult;
     run(stream: () => PromiseOrValue<AgentResponseStream<Message>>): Promise<Message>;
+    private marked;
     private extractStream;
 }
 export interface AIGNEListrRendererOptions extends ListrDefaultRendererOptions {

package/dist/utils/listr.js

@@ -1,8 +1,12 @@
 import { EOL } from "node:os";
 import { format } from "node:util";
+import { isAgentResponseProgress } from "@aigne/core";
 import { LogLevel, logger } from "@aigne/core/utils/logger.js";
 import { mergeAgentResponseChunk } from "@aigne/core/utils/stream-utils.js";
 import { color, DefaultRenderer, figures, Listr, ListrDefaultRendererLogLevels, ListrLogger, SimpleRenderer, Spinner, } from "@aigne/listr2";
+import { markedTerminal } from "@aigne/marked-terminal";
+import chalk from "chalk";
+import { Marked } from "marked";
 import wrap from "wrap-ansi";
 export class AIGNEListr extends Listr {
     myOptions;
@@ -15,13 +19,12 @@ export class AIGNEListr extends Listr {
             getStdoutLogs: () => {
                 return this.logs.splice(0);
             },
-            getBottomBarLogs: (options) => {
-                if (!options?.running)
-                    return [];
-                const r = this.myOptions.formatResult(this.result);
-                if (typeof r !== "string")
-                    throw new Error("Must return a string result for running task");
-                return [r];
+            getBottomBarLogs: (_options) => {
+                // if (!options?.running) return [];
+                // const r = this.myOptions.formatResult(this.result);
+                // if (typeof r !== "string") throw new Error("Must return a string result for running task");
+                // return [r];
+                return [];
             },
         };
         super(task, {
@@ -55,6 +58,7 @@ export class AIGNEListr extends Listr {
         this.myOptions = myOptions;
         this.spinner = new Spinner();
     }
+    needLogResult = true;
     async run(stream) {
         const originalLog = logger.logMessage;
         const originalConsole = { ...console };
@@ -81,7 +85,9 @@ export class AIGNEListr extends Listr {
                     throw this.error;
                 return { ...this.result };
             });
-            console.log(await this.myOptions.formatResult(this.result, { running: false, renderImage: true }));
+            if (this.needLogResult) {
+                console.log(await this.myOptions.formatResult(this.result, { running: false, renderImage: true }));
+            }
             return result;
         }
         finally {
@@ -90,11 +96,56 @@ export class AIGNEListr extends Listr {
             this.spinner.stop();
         }
     }
+    marked = new Marked().use({
+        // marked-terminal does not support code block meta, so we need to strip it
+        walkTokens: (token) => {
+            if (token.type === "code") {
+                if (typeof token.lang === "string") {
+                    token.lang = token.lang.trim().split(/\s+/)[0];
+                }
+            }
+        },
+    }, markedTerminal({ forceHyperLink: false }, {
+        theme: {
+            string: chalk.green,
+        },
+    }));
     async extractStream(stream) {
         try {
             this.result = {};
             for await (const value of stream) {
                 mergeAgentResponseChunk(this.result, value);
+                if (isAgentResponseProgress(value) && value.progress.event === "message") {
+                    const { message } = value.progress;
+                    const rendered = [];
+                    if (message.role === "user" || message.role === "agent") {
+                        if (message.role === "agent" && message.toolCalls) {
+                            for (const call of message.toolCalls) {
+                                rendered.push(`${chalk.bold.gray(`[${call.function.name}]`)} ${chalk.gray(`${JSON.stringify(call.function.arguments).slice(0, 200)}...`)}`);
+                            }
+                        }
+                        else if (typeof message.content === "string") {
+                            rendered.push(this.marked.parse(message.content, { async: false }).trim());
+                        }
+                        else if (Array.isArray(message.content)) {
+                            for (const msg of message.content) {
+                                if (msg.type === "text") {
+                                    if (msg.isThinking) {
+                                        rendered.push(chalk.dim(chalk.grey(chalk.italic(`[Thinking] ${msg.text}`))));
+                                    }
+                                    else {
+                                        rendered.push(this.marked.parse(msg.text, { async: false }).trim());
+                                    }
+                                }
+                            }
+                        }
+                    }
+                    if (rendered.length) {
+                        const prefix = message.role === "user" ? chalk.blue.bold(">") : chalk.green.bold("•");
+                        console.log(`${prefix} ${rendered.join("\n")}\n`);
+                        this.needLogResult = false;
+                    }
+                }
             }
             return this.result;
         }

package/dist/utils/load-aigne.js

@@ -55,12 +55,12 @@ export async function loadAIGNE({ path, modelOptions, imageModelOptions, skipMod
                 availableModules: [
                     {
                         module: "history",
-                        create: (options) => import("@aigne/afs-history").then((m) => new m.AFSHistory(options)),
+                        load: (options) => import("@aigne/afs-history").then((m) => new m.AFSHistory(options.parsed)),
                     },
                     {
                         module: "local-fs",
                         alias: ["system-fs"],
-                        create: (options) => import("@aigne/afs-local-fs").then((m) => new m.LocalFS(options)),
+                        load: (options) => import("@aigne/afs-local-fs").then((m) => m.LocalFS.load(options)),
                     },
                 ],
             },

package/dist/utils/run-chat-loop.d.ts

@@ -1,6 +1,8 @@
 import { type Message, type UserAgent } from "@aigne/core";
 export declare const DEFAULT_CHAT_INPUT_KEY = "message";
 export interface ChatLoopOptions {
+    userId?: string;
+    sessionId?: string;
     initialCall?: Message | string;
     welcome?: string;
     defaultQuestion?: string;

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

@@ -19,6 +19,7 @@ export async function runChatLoopInTerminal(userAgent, options = {}) {
         const question = await terminalInput({
             message: "💬",
             default: i === 0 ? options?.defaultQuestion : undefined,
+            clear: true,
         });
         if (!question?.trim())
             continue;
@@ -74,7 +75,7 @@ async function callAgent(userAgent, input, options) {
     const tracer = new TerminalTracer(userAgent.context, options);
     await tracer.run(userAgent, typeof input === "string"
         ? { ...options.input, [options.inputKey || DEFAULT_CHAT_INPUT_KEY]: input }
-        : { ...options.input, ...input });
+        : { ...options.input, ...input }, { userContext: { sessionId: options.sessionId, userId: options.userId } });
 }
 const COMMANDS = {
     "/exit": () => ({ exit: true }),

package/dist/utils/run-with-aigne.d.ts

@@ -15,7 +15,9 @@ export declare function runWithAIGNE(agentCreator: ((aigne: AIGNE) => PromiseOrV
     modelOptions?: ChatModelInputOptions;
     outputKey?: string;
 }): Promise<void>;
-export declare function runAgentWithAIGNE(aigne: AIGNE, agent: Agent, { outputKey, outputFileKey, chatLoopOptions, ...options }?: {
+export declare function runAgentWithAIGNE(aigne: AIGNE, agent: Agent, { userId, sessionId, outputKey, outputFileKey, chatLoopOptions, ...options }?: {
+    userId?: string;
+    sessionId?: string;
     outputKey?: string;
     outputFileKey?: string;
     chatLoopOptions?: ChatLoopOptions;

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

@@ -84,7 +84,7 @@ export async function runWithAIGNE(agentCreator, { aigne, argv = process.argv, c
         process.exit(1);
     });
 }
-export async function runAgentWithAIGNE(aigne, agent, { outputKey, outputFileKey, chatLoopOptions, ...options } = {}) {
+export async function runAgentWithAIGNE(aigne, agent, { userId, sessionId, outputKey, outputFileKey, chatLoopOptions, ...options } = {}) {
     if (options.output) {
         const outputPath = isAbsolute(options.output)
             ? options.output
@@ -102,9 +102,9 @@ export async function runAgentWithAIGNE(aigne, agent, { outputKey, outputFileKey
         }
         await writeFile(outputPath, "", "utf8");
     }
-    if (options.chat) {
+    if (options.interactive) {
         if (!isatty(process.stdout.fd)) {
-            throw new Error("--chat mode requires a TTY terminal");
+            throw new Error("--interactive mode requires a TTY terminal");
         }
         const userAgent = agent instanceof UserAgent ? agent : aigne.invoke(agent);
         await runChatLoopInTerminal(userAgent, {
@@ -112,6 +112,8 @@ export async function runAgentWithAIGNE(aigne, agent, { outputKey, outputFileKey
             outputKey,
             inputFileKey: agent instanceof AIAgent ? agent.inputFileKey : undefined,
             input: options.input,
+            sessionId,
+            userId,
         });
         return;
     }

package/dist/utils/yargs.d.ts

@@ -4,7 +4,9 @@ import type { Argv } from "yargs";
 import { ZodType } from "zod";
 export type InferArgv<T> = T extends Argv<infer U> ? U : never;
 export declare const withRunAgentCommonOptions: (yargs: Argv) => Argv<{
-    chat: boolean;
+    interactive: boolean;
+} & {
+    "session-id": string | undefined;
 } & {
     model: string | undefined;
 } & {
@@ -55,7 +57,9 @@ export declare function inferZodType(type: ZodType, opts?: {
 export declare function withAgentInputSchema(yargs: Argv, options: Pick<Agent, "inputSchema"> & {
     optionalInputs?: string[];
 }): Argv<{
-    chat: boolean;
+    interactive: boolean;
+} & {
+    "session-id": string | undefined;
 } & {
     model: string | undefined;
 } & {

package/dist/utils/yargs.js

@@ -11,10 +11,15 @@ import { parse } from "yaml";
 import z, { ZodAny, ZodArray, ZodBoolean, ZodError, ZodNumber, ZodObject, ZodString, ZodType, ZodUnknown, } from "zod";
 const MODEL_OPTIONS_GROUP_NAME = "Model Options";
 export const withRunAgentCommonOptions = (yargs) => yargs
-    .option("chat", {
-    describe: "Run chat loop in terminal",
+    .option("interactive", {
+    describe: "Run in interactive chat mode",
     type: "boolean",
     default: false,
+    alias: ["chat"],
+})
+    .option("session-id", {
+    describe: "Session ID for chat-based agents to maintain context across interactions",
+    type: "string",
 })
     .option("model", {
     group: MODEL_OPTIONS_GROUP_NAME,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/cli",
-  "version": "1.59.0-beta.2",
+  "version": "1.59.0-beta.21",
   "description": "Your command center for agent development",
   "publishConfig": {
     "access": "public"
@@ -48,6 +48,7 @@
     "@aigne/json-schema-to-zod": "^1.3.3",
     "@aigne/listr2": "^1.0.10",
     "@aigne/marked-terminal": "^7.3.2",
+    "@aigne/uuid": "^13.0.1",
     "@fast-csv/format": "^5.0.5",
     "@inquirer/core": "^10.2.2",
     "@inquirer/figures": "^1.0.13",
@@ -89,17 +90,17 @@
     "yoctocolors-cjs": "^2.1.3",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.6",
-    "@aigne/afs": "^1.4.0-beta.2",
-    "@aigne/afs-local-fs": "^1.4.0-beta.3",
-    "@aigne/afs-history": "^1.2.0-beta.2",
-    "@aigne/agent-library": "^1.24.0-beta.3",
-    "@aigne/agentic-memory": "^1.1.6-beta.3",
-    "@aigne/core": "^1.72.0-beta.3",
-    "@aigne/default-memory": "^1.3.6-beta.3",
-    "@aigne/aigne-hub": "^0.10.16-beta.3",
-    "@aigne/observability-api": "^0.11.14-beta.1",
-    "@aigne/openai": "^0.16.16-beta.3",
-    "@aigne/secrets": "^0.1.6-beta.3"
+    "@aigne/afs": "^1.4.0-beta.8",
+    "@aigne/afs-history": "^1.2.0-beta.9",
+    "@aigne/agent-library": "^1.24.0-beta.18",
+    "@aigne/afs-local-fs": "^1.4.0-beta.17",
+    "@aigne/agentic-memory": "^1.1.6-beta.16",
+    "@aigne/aigne-hub": "^0.10.16-beta.21",
+    "@aigne/core": "^1.72.0-beta.16",
+    "@aigne/default-memory": "^1.4.0-beta.15",
+    "@aigne/openai": "^0.16.16-beta.16",
+    "@aigne/secrets": "^0.1.6-beta.16",
+    "@aigne/observability-api": "^0.11.14-beta.2"
   },
   "devDependencies": {
     "@inquirer/testing": "^2.1.50",
@@ -116,14 +117,14 @@
     "rimraf": "^6.0.1",
     "typescript": "^5.9.2",
     "ufo": "^1.6.1",
-    "@aigne/test-utils": "^0.5.69-beta.3"
+    "@aigne/test-utils": "^0.5.69-beta.16"
   },
   "scripts": {
     "lint": "tsc --noEmit",
     "build": "tsc --build tsconfig.build.json",
     "clean": "rimraf dist test/coverage templates/coverage",
-    "test": "run-s test:src test:templates",
-    "test:coverage": "run-s test:src:coverage test:templates:coverage",
+    "test": "npm run test:src && npm run test:templates",
+    "test:coverage": "npm run test:src:coverage && npm run test:templates:coverage",
     "test:src": "bun --cwd test test",
     "test:src:coverage": "bun --cwd test test --coverage --coverage-reporter=lcov --coverage-reporter=text",
     "test:templates": "cd templates && node --test",

package/templates/default/README.md

@@ -42,7 +42,7 @@ echo "Hello, what can you help me with?" | aigne run
 use the following command to start an interactive chat session:
 
 ```bash
-aigne run --chat
+aigne run --interactive
 ```
 
 help: