@aigne/core 1.45.0 → 1.46.0

package/CHANGELOG.md

@@ -12,6 +12,25 @@
   * dependencies
     * @aigne/observability bumped to 0.1.0
 
+## [1.46.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.45.0...core-v1.46.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
+
+* **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/platform-helpers bumped to 0.6.0
+
 ## [1.45.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.44.0...core-v1.45.0) (2025-08-06)
 
 

package/lib/cjs/agents/agent.d.ts

@@ -72,6 +72,7 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
      * for documentation and debugging
      */
     description?: string;
+    taskTitle?: string;
     /**
      * Zod schema defining the input message structure
      *
@@ -256,6 +257,7 @@ export declare abstract class Agent<I extends Message = any, O extends Message =
      * each other's roles in a multi-agent system
      */
     readonly description?: string;
+    taskTitle?: string;
     private readonly _inputSchema?;
     defaultInput?: Partial<{
         [key in keyof I]: {

package/lib/cjs/agents/agent.js

@@ -104,6 +104,7 @@ class Agent {
         this.name = options.name || this.constructor.name;
         this.alias = options.alias;
         this.description = options.description;
+        this.taskTitle = options.taskTitle;
         if (inputSchema)
             checkAgentInputOutputSchema(inputSchema);
         if (outputSchema)
@@ -193,6 +194,7 @@ class Agent {
      * each other's roles in a multi-agent system
      */
     description;
+    taskTitle;
     _inputSchema;
     defaultInput;
     _outputSchema;
@@ -388,7 +390,7 @@ class Agent {
     async callHooks(hook, input, options) {
         const { context } = options;
         const result = {};
-        for (const hooks of (0, type_utils_js_1.flat)(options.hooks, this.hooks)) {
+        for (const hooks of (0, type_utils_js_1.flat)(options.hooks, options.context.hooks, this.hooks)) {
             const h = hooks[hook];
             if (!h)
                 continue;

package/lib/cjs/aigne/context.d.ts

@@ -1,7 +1,7 @@
 import type { AIGNEObserver } from "@aigne/observability-api";
 import type { Span } from "@opentelemetry/api";
 import { Emitter } from "strict-event-emitter";
-import { type Agent, type AgentInvokeOptions, type AgentProcessAsyncGenerator, type AgentResponse, type AgentResponseStream, type Message } from "../agents/agent.js";
+import { type Agent, type AgentHooks, type AgentInvokeOptions, type AgentProcessAsyncGenerator, type AgentResponse, type AgentResponseStream, type Message } from "../agents/agent.js";
 import type { ChatModel } from "../agents/chat-model.js";
 import { UserAgent } from "../agents/user-agent.js";
 import type { Memory } from "../memory/memory.js";
@@ -80,6 +80,7 @@ export interface Context<U extends UserContext = UserContext> extends TypedEvent
     limits?: ContextLimits;
     status?: "normal" | "timeout";
     userContext: U;
+    hooks?: AgentHooks[];
     memories: Pick<Memory, "content">[];
     /**
      * Create a user agent to consistently invoke an agent
@@ -164,11 +165,14 @@ export declare class AIGNEContext implements Context {
     set userContext(userContext: Context["userContext"]);
     get memories(): Context["memories"];
     set memories(memories: Context["memories"]);
+    get hooks(): AgentHooks[];
+    set hooks(hooks: AgentHooks[]);
     newContext({ reset }?: {
         reset?: boolean;
     }): AIGNEContext;
     invoke: Context["invoke"];
     private onInvocationResult;
+    private processOptions;
     publish: Context["publish"];
     subscribe: Context["subscribe"];
     unsubscribe: Context["unsubscribe"];
@@ -197,6 +201,7 @@ declare class AIGNEContextShared {
     usage: ContextUsage;
     userContext: Context["userContext"];
     memories: Context["memories"];
+    hooks: AgentHooks[];
     private abortController;
     private timer?;
     private initTimeout;

package/lib/cjs/aigne/context.js

@@ -94,6 +94,12 @@ class AIGNEContext {
     set memories(memories) {
         this.internal.memories = memories;
     }
+    get hooks() {
+        return this.internal.hooks;
+    }
+    set hooks(hooks) {
+        this.internal.hooks = hooks;
+    }
     newContext({ reset } = {}) {
         return new AIGNEContext(this, { reset });
     }
@@ -103,14 +109,7 @@ class AIGNEContext {
             message,
             options,
         });
-        if (options?.userContext) {
-            Object.assign(this.userContext, options.userContext);
-            options.userContext = undefined;
-        }
-        if (options?.memories?.length) {
-            this.memories.push(...options.memories);
-            options.memories = undefined;
-        }
+        this.processOptions(options);
         if ((0, type_utils_js_1.isNil)(message)) {
             return user_agent_js_1.UserAgent.from({
                 context: this,
@@ -176,7 +175,7 @@ class AIGNEContext {
             },
         };
     }
-    publish = ((topic, payload, options) => {
+    processOptions(options) {
         if (options?.userContext) {
             Object.assign(this.userContext, options.userContext);
             options.userContext = undefined;
@@ -185,6 +184,13 @@ class AIGNEContext {
             this.memories.push(...options.memories);
             options.memories = undefined;
         }
+        if (options?.hooks) {
+            this.hooks.push(...(0, type_utils_js_1.flat)(options.hooks));
+            options.hooks = undefined;
+        }
+    }
+    publish = ((topic, payload, options) => {
+        this.processOptions(options);
         const newContext = options?.newContext === false ? this : this.newContext();
         return this.internal.messageQueue.publish(topic, {
             ...(0, message_queue_js_1.toMessagePayload)(payload),
@@ -318,6 +324,7 @@ class AIGNEContextShared {
     usage = (0, usage_js_1.newEmptyContextUsage)();
     userContext = {};
     memories = [];
+    hooks = [];
     abortController = new AbortController();
     timer;
     initTimeout() {

package/lib/cjs/loader/agent-yaml.d.ts

@@ -19,6 +19,7 @@ export type NestAgentSchema = string | {
 export interface BaseAgentSchema {
     name?: string;
     description?: string;
+    taskTitle?: string;
     inputSchema?: ZodType<Record<string, any>>;
     defaultInput?: Record<string, any>;
     outputSchema?: ZodType<Record<string, any>>;

package/lib/cjs/loader/agent-yaml.js

@@ -34,6 +34,7 @@ async function parseAgentFile(path, data) {
             name: (0, schema_js_1.optionalize)(zod_1.z.string()),
             alias: (0, schema_js_1.optionalize)(zod_1.z.array(zod_1.z.string())),
             description: (0, schema_js_1.optionalize)(zod_1.z.string()),
+            taskTitle: (0, schema_js_1.optionalize)(zod_1.z.string()),
             inputSchema: (0, schema_js_1.optionalize)((0, schema_js_1.inputOutputSchema)({ path })).transform((v) => v ? (0, json_schema_to_zod_1.jsonSchemaToZod)(v) : undefined),
             defaultInput: (0, schema_js_1.optionalize)(schema_js_1.defaultInputSchema),
             outputSchema: (0, schema_js_1.optionalize)((0, schema_js_1.inputOutputSchema)({ path })).transform((v) => v ? (0, json_schema_to_zod_1.jsonSchemaToZod)(v) : undefined),

package/lib/dts/agents/agent.d.ts

@@ -72,6 +72,7 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
      * for documentation and debugging
      */
     description?: string;
+    taskTitle?: string;
     /**
      * Zod schema defining the input message structure
      *
@@ -256,6 +257,7 @@ export declare abstract class Agent<I extends Message = any, O extends Message =
      * each other's roles in a multi-agent system
      */
     readonly description?: string;
+    taskTitle?: string;
     private readonly _inputSchema?;
     defaultInput?: Partial<{
         [key in keyof I]: {

package/lib/dts/aigne/context.d.ts

@@ -1,7 +1,7 @@
 import type { AIGNEObserver } from "@aigne/observability-api";
 import type { Span } from "@opentelemetry/api";
 import { Emitter } from "strict-event-emitter";
-import { type Agent, type AgentInvokeOptions, type AgentProcessAsyncGenerator, type AgentResponse, type AgentResponseStream, type Message } from "../agents/agent.js";
+import { type Agent, type AgentHooks, type AgentInvokeOptions, type AgentProcessAsyncGenerator, type AgentResponse, type AgentResponseStream, type Message } from "../agents/agent.js";
 import type { ChatModel } from "../agents/chat-model.js";
 import { UserAgent } from "../agents/user-agent.js";
 import type { Memory } from "../memory/memory.js";
@@ -80,6 +80,7 @@ export interface Context<U extends UserContext = UserContext> extends TypedEvent
     limits?: ContextLimits;
     status?: "normal" | "timeout";
     userContext: U;
+    hooks?: AgentHooks[];
     memories: Pick<Memory, "content">[];
     /**
      * Create a user agent to consistently invoke an agent
@@ -164,11 +165,14 @@ export declare class AIGNEContext implements Context {
     set userContext(userContext: Context["userContext"]);
     get memories(): Context["memories"];
     set memories(memories: Context["memories"]);
+    get hooks(): AgentHooks[];
+    set hooks(hooks: AgentHooks[]);
     newContext({ reset }?: {
         reset?: boolean;
     }): AIGNEContext;
     invoke: Context["invoke"];
     private onInvocationResult;
+    private processOptions;
     publish: Context["publish"];
     subscribe: Context["subscribe"];
     unsubscribe: Context["unsubscribe"];
@@ -197,6 +201,7 @@ declare class AIGNEContextShared {
     usage: ContextUsage;
     userContext: Context["userContext"];
     memories: Context["memories"];
+    hooks: AgentHooks[];
     private abortController;
     private timer?;
     private initTimeout;

package/lib/dts/loader/agent-yaml.d.ts

@@ -19,6 +19,7 @@ export type NestAgentSchema = string | {
 export interface BaseAgentSchema {
     name?: string;
     description?: string;
+    taskTitle?: string;
     inputSchema?: ZodType<Record<string, any>>;
     defaultInput?: Record<string, any>;
     outputSchema?: ZodType<Record<string, any>>;

package/lib/esm/agents/agent.d.ts

@@ -72,6 +72,7 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
      * for documentation and debugging
      */
     description?: string;
+    taskTitle?: string;
     /**
      * Zod schema defining the input message structure
      *
@@ -256,6 +257,7 @@ export declare abstract class Agent<I extends Message = any, O extends Message =
      * each other's roles in a multi-agent system
      */
     readonly description?: string;
+    taskTitle?: string;
     private readonly _inputSchema?;
     defaultInput?: Partial<{
         [key in keyof I]: {

package/lib/esm/agents/agent.js

@@ -59,6 +59,7 @@ export class Agent {
         this.name = options.name || this.constructor.name;
         this.alias = options.alias;
         this.description = options.description;
+        this.taskTitle = options.taskTitle;
         if (inputSchema)
             checkAgentInputOutputSchema(inputSchema);
         if (outputSchema)
@@ -148,6 +149,7 @@ export class Agent {
      * each other's roles in a multi-agent system
      */
     description;
+    taskTitle;
     _inputSchema;
     defaultInput;
     _outputSchema;
@@ -343,7 +345,7 @@ export class Agent {
     async callHooks(hook, input, options) {
         const { context } = options;
         const result = {};
-        for (const hooks of flat(options.hooks, this.hooks)) {
+        for (const hooks of flat(options.hooks, options.context.hooks, this.hooks)) {
             const h = hooks[hook];
             if (!h)
                 continue;

package/lib/esm/aigne/context.d.ts

@@ -1,7 +1,7 @@
 import type { AIGNEObserver } from "@aigne/observability-api";
 import type { Span } from "@opentelemetry/api";
 import { Emitter } from "strict-event-emitter";
-import { type Agent, type AgentInvokeOptions, type AgentProcessAsyncGenerator, type AgentResponse, type AgentResponseStream, type Message } from "../agents/agent.js";
+import { type Agent, type AgentHooks, type AgentInvokeOptions, type AgentProcessAsyncGenerator, type AgentResponse, type AgentResponseStream, type Message } from "../agents/agent.js";
 import type { ChatModel } from "../agents/chat-model.js";
 import { UserAgent } from "../agents/user-agent.js";
 import type { Memory } from "../memory/memory.js";
@@ -80,6 +80,7 @@ export interface Context<U extends UserContext = UserContext> extends TypedEvent
     limits?: ContextLimits;
     status?: "normal" | "timeout";
     userContext: U;
+    hooks?: AgentHooks[];
     memories: Pick<Memory, "content">[];
     /**
      * Create a user agent to consistently invoke an agent
@@ -164,11 +165,14 @@ export declare class AIGNEContext implements Context {
     set userContext(userContext: Context["userContext"]);
     get memories(): Context["memories"];
     set memories(memories: Context["memories"]);
+    get hooks(): AgentHooks[];
+    set hooks(hooks: AgentHooks[]);
     newContext({ reset }?: {
         reset?: boolean;
     }): AIGNEContext;
     invoke: Context["invoke"];
     private onInvocationResult;
+    private processOptions;
     publish: Context["publish"];
     subscribe: Context["subscribe"];
     unsubscribe: Context["unsubscribe"];
@@ -197,6 +201,7 @@ declare class AIGNEContextShared {
     usage: ContextUsage;
     userContext: Context["userContext"];
     memories: Context["memories"];
+    hooks: AgentHooks[];
     private abortController;
     private timer?;
     private initTimeout;

package/lib/esm/aigne/context.js

@@ -88,6 +88,12 @@ export class AIGNEContext {
     set memories(memories) {
         this.internal.memories = memories;
     }
+    get hooks() {
+        return this.internal.hooks;
+    }
+    set hooks(hooks) {
+        this.internal.hooks = hooks;
+    }
     newContext({ reset } = {}) {
         return new AIGNEContext(this, { reset });
     }
@@ -97,14 +103,7 @@ export class AIGNEContext {
             message,
             options,
         });
-        if (options?.userContext) {
-            Object.assign(this.userContext, options.userContext);
-            options.userContext = undefined;
-        }
-        if (options?.memories?.length) {
-            this.memories.push(...options.memories);
-            options.memories = undefined;
-        }
+        this.processOptions(options);
         if (isNil(message)) {
             return UserAgent.from({
                 context: this,
@@ -170,7 +169,7 @@ export class AIGNEContext {
             },
         };
     }
-    publish = ((topic, payload, options) => {
+    processOptions(options) {
         if (options?.userContext) {
             Object.assign(this.userContext, options.userContext);
             options.userContext = undefined;
@@ -179,6 +178,13 @@ export class AIGNEContext {
             this.memories.push(...options.memories);
             options.memories = undefined;
         }
+        if (options?.hooks) {
+            this.hooks.push(...flat(options.hooks));
+            options.hooks = undefined;
+        }
+    }
+    publish = ((topic, payload, options) => {
+        this.processOptions(options);
         const newContext = options?.newContext === false ? this : this.newContext();
         return this.internal.messageQueue.publish(topic, {
             ...toMessagePayload(payload),
@@ -311,6 +317,7 @@ class AIGNEContextShared {
     usage = newEmptyContextUsage();
     userContext = {};
     memories = [];
+    hooks = [];
     abortController = new AbortController();
     timer;
     initTimeout() {

package/lib/esm/loader/agent-yaml.d.ts

@@ -19,6 +19,7 @@ export type NestAgentSchema = string | {
 export interface BaseAgentSchema {
     name?: string;
     description?: string;
+    taskTitle?: string;
     inputSchema?: ZodType<Record<string, any>>;
     defaultInput?: Record<string, any>;
     outputSchema?: ZodType<Record<string, any>>;

package/lib/esm/loader/agent-yaml.js

@@ -30,6 +30,7 @@ export async function parseAgentFile(path, data) {
             name: optionalize(z.string()),
             alias: optionalize(z.array(z.string())),
             description: optionalize(z.string()),
+            taskTitle: optionalize(z.string()),
             inputSchema: optionalize(inputOutputSchema({ path })).transform((v) => v ? jsonSchemaToZod(v) : undefined),
             defaultInput: optionalize(defaultInputSchema),
             outputSchema: optionalize(inputOutputSchema({ path })).transform((v) => v ? jsonSchemaToZod(v) : undefined),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.45.0",
+  "version": "1.46.0",
   "description": "AIGNE core library for building AI-powered applications",
   "publishConfig": {
     "access": "public"
@@ -80,7 +80,6 @@
     "immer": "^10.1.1",
     "jaison": "^2.0.2",
     "jsonata": "^2.0.6",
-    "mustache": "^4.2.0",
     "nunjucks": "^3.2.4",
     "p-retry": "^6.2.1",
     "raw-body": "^3.0.0",
@@ -91,14 +90,13 @@
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.6",
     "@aigne/observability-api": "^0.9.0",
-    "@aigne/platform-helpers": "^0.5.1"
+    "@aigne/platform-helpers": "^0.6.0"
   },
   "devDependencies": {
     "@types/bun": "^1.2.18",
     "@types/compression": "^1.8.1",
     "@types/content-type": "^1.1.9",
     "@types/express": "^5.0.3",
-    "@types/mustache": "^4.2.6",
     "@types/node": "^24.0.12",
     "@types/nunjucks": "^3.2.6",
     "compression": "^1.8.0",