@aigne/cli 1.30.4 → 1.31.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## [1.31.0](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.30.4...cli-v1.31.0) (2025-08-06)
+
+
+### Features
+
+* **cli:** support custom task title of agent in cli ([#328](https://github.com/AIGNE-io/aigne-framework/issues/328)) ([128d75f](https://github.com/AIGNE-io/aigne-framework/commit/128d75fb42ca470b47a2793d79c92d7bb64cfedb))
+
+
+### Bug Fixes
+
+* **cli:** nunjucks should import as cjs module ([432b9e1](https://github.com/AIGNE-io/aigne-framework/commit/432b9e1e436bd5b02427a5effea907be1f589c31))
+* **core:** improve hook handling in agent and context ([#325](https://github.com/AIGNE-io/aigne-framework/issues/325)) ([c858fec](https://github.com/AIGNE-io/aigne-framework/commit/c858fecb08453c2daca9708f4b8a9c135fac40b0))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/agent-library bumped to 1.21.14
+    * @aigne/agentic-memory bumped to 1.0.14
+    * @aigne/aigne-hub bumped to 0.4.5
+    * @aigne/core bumped to 1.46.0
+    * @aigne/default-memory bumped to 1.0.14
+    * @aigne/openai bumped to 0.10.14
+
 ## [1.30.4](https://github.com/AIGNE-io/aigne-framework/compare/cli-v1.30.3...cli-v1.30.4) (2025-08-06)
 
 

package/dist/tracer/terminal.d.ts

@@ -20,10 +20,11 @@ export declare class TerminalTracer {
         [key: string]: string;
     }): string;
     formatTimeUsage(startTime: number, endTime: number): string;
-    formatTaskTitle(agent: Agent, { task, usage, time }?: {
+    formatTaskTitle(agent: Agent, { task, usage, time, input }: {
         task?: Task;
         usage?: boolean;
         time?: boolean;
+        input: Message;
     }): string;
     private marked;
     get outputKey(): string;

package/dist/tracer/terminal.js

@@ -1,6 +1,6 @@
 import { EOL } from "node:os";
 import { inspect } from "node:util";
-import { AIAgent, ChatModel, DEFAULT_OUTPUT_KEY, } from "@aigne/core";
+import { AIAgent, ChatModel, DEFAULT_OUTPUT_KEY, UserAgent, } from "@aigne/core";
 import { LogLevel, logger } from "@aigne/core/utils/logger.js";
 import { promiseWithResolvers } from "@aigne/core/utils/promise.js";
 import { flat, omit } from "@aigne/core/utils/type-utils.js";
@@ -9,6 +9,7 @@ import { markedTerminal } from "@aigne/marked-terminal";
 import * as prompts from "@inquirer/prompts";
 import chalk from "chalk";
 import { Marked } from "marked";
+import nunjucks from "nunjucks";
 import { AIGNEListr, AIGNEListrRenderer } from "../utils/listr.js";
 import { parseDuration } from "../utils/time.js";
 export class TerminalTracer {
@@ -28,7 +29,9 @@ export class TerminalTracer {
                 : undefined,
             formatResult: (result, options) => [this.formatResult(agent, context, result, options)].filter(Boolean),
         }, [], { concurrent: true });
-        const onStart = async ({ context, agent }) => {
+        const onStart = async ({ context, agent, ...event }) => {
+            if (agent instanceof UserAgent)
+                return;
             const contextId = context.id;
             const parentContextId = context.parentId;
             const task = {
@@ -38,7 +41,7 @@ export class TerminalTracer {
             };
             this.tasks[contextId] = task;
             const listrTask = {
-                title: this.formatTaskTitle(agent),
+                title: this.formatTaskTitle(agent, { ...event }),
                 task: (ctx, taskWrapper) => {
                     const subtask = taskWrapper.newListr([{ task: () => task.promise }]);
                     task.listr.resolve({ subtask, taskWrapper, ctx });
@@ -82,7 +85,7 @@ export class TerminalTracer {
                 },
             };
         };
-        const onSuccess = async ({ context, agent, output }) => {
+        const onSuccess = async ({ context, agent, output, ...event }) => {
             const contextId = context.id;
             const parentContextId = context.parentId;
             const task = this.tasks[contextId];
@@ -97,20 +100,20 @@ export class TerminalTracer {
                 if (model)
                     task.extraTitleMetadata.model = model;
             }
-            taskWrapper.title = this.formatTaskTitle(agent, { task, usage: true, time: true });
+            taskWrapper.title = this.formatTaskTitle(agent, { ...event, task, usage: true, time: true });
             if (!parentContextId || !this.tasks[parentContextId]) {
                 Object.assign(ctx, output);
             }
             task.resolve();
         };
-        const onError = async ({ context, agent, error }) => {
+        const onError = async ({ context, agent, error, ...event }) => {
             const contextId = context.id;
             const task = this.tasks[contextId];
             if (!task)
                 return;
             task.endTime = Date.now();
             const { taskWrapper } = await task.listr.promise;
-            taskWrapper.title = this.formatTaskTitle(agent, { task, usage: true, time: true });
+            taskWrapper.title = this.formatTaskTitle(agent, { ...event, task, usage: true, time: true });
             task.reject(error);
         };
         const result = await listr.run(() => context.invoke(agent, input, {
@@ -143,8 +146,11 @@ export class TerminalTracer {
         const duration = endTime - startTime;
         return chalk.grey(`[${parseDuration(duration)}]`);
     }
-    formatTaskTitle(agent, { task, usage, time } = {}) {
-        let title = `invoke agent ${agent.name}`;
+    formatTaskTitle(agent, { task, usage, time, input }) {
+        let title = agent.name;
+        if (agent.taskTitle) {
+            title += ` ${chalk.cyan(nunjucks.renderString(agent.taskTitle, { ...input }))}`;
+        }
         if (usage && task?.usage)
             title += ` ${this.formatTokenUsage(task.usage, task.extraTitleMetadata)}`;
         if (time && task?.startTime && task.endTime)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/cli",
-  "version": "1.30.4",
+  "version": "1.31.0",
   "description": "Command-line interface for AIGNE Framework - A functional AI application development framework for building scalable AI-powered applications with workflow patterns, MCP protocol integration, and multi-model support",
   "publishConfig": {
     "access": "public"
@@ -64,6 +64,7 @@
     "inquirer": "^12.7.0",
     "log-update": "^6.1.0",
     "marked": "^16.0.0",
+    "nunjucks": "^3.2.4",
     "open": "10.1.2",
     "openai": "^5.8.3",
     "p-wait-for": "^5.0.2",
@@ -73,13 +74,13 @@
     "yaml": "^2.8.0",
     "yargs": "^18.0.0",
     "zod": "^3.25.67",
-    "@aigne/agent-library": "^1.21.13",
-    "@aigne/aigne-hub": "^0.4.4",
-    "@aigne/agentic-memory": "^1.0.13",
-    "@aigne/openai": "^0.10.13",
-    "@aigne/core": "^1.45.0",
-    "@aigne/default-memory": "^1.0.13",
-    "@aigne/observability-api": "^0.9.0"
+    "@aigne/agent-library": "^1.21.14",
+    "@aigne/agentic-memory": "^1.0.14",
+    "@aigne/aigne-hub": "^0.4.5",
+    "@aigne/core": "^1.46.0",
+    "@aigne/default-memory": "^1.0.14",
+    "@aigne/observability-api": "^0.9.0",
+    "@aigne/openai": "^0.10.14"
   },
   "devDependencies": {
     "@types/archiver": "^6.0.3",
@@ -88,6 +89,7 @@
     "@types/glob": "^9.0.0",
     "@types/gradient-string": "^1.1.6",
     "@types/node": "^24.0.12",
+    "@types/nunjucks": "^3.2.6",
     "@types/yargs": "^17.0.33",
     "archiver": "^7.0.1",
     "hono": "4.8.4",