@aigne/core 1.45.0 → 1.46.1

package/CHANGELOG.md

@@ -12,6 +12,33 @@
   * dependencies
     * @aigne/observability bumped to 0.1.0
 
+## [1.46.1](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.46.0...core-v1.46.1) (2025-08-08)
+
+
+### Bug Fixes
+
+* **core:** auto trim trailing whitespace for AIAgent with structuredStreamMode enabled ([#334](https://github.com/AIGNE-io/aigne-framework/issues/334)) ([342eb49](https://github.com/AIGNE-io/aigne-framework/commit/342eb493995809f01da02fca6975ea6e52ecbd3a))
+* **core:** hide internal prop toolsMap from trace logs ([#335](https://github.com/AIGNE-io/aigne-framework/issues/335)) ([bcec317](https://github.com/AIGNE-io/aigne-framework/commit/bcec317bf436988e5f43af05f649196bdbd6ac55))
+
+## [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/README.md

@@ -6,6 +6,8 @@
     <source srcset="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/logo.svg" media="(prefers-color-scheme: light)">
     <img src="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/logo.svg" alt="AIGNE Logo" width="400" />
   </picture>
+
+  <center>The functional core of agentic AI</center>
 </p>
 
 [![GitHub star chart](https://img.shields.io/github/stars/AIGNE-io/aigne-framework?style=flat-square)](https://star-history.com/#AIGNE-io/aigne-framework)
@@ -14,12 +16,16 @@
 [![NPM Version](https://img.shields.io/npm/v/@aigne/core)](https://www.npmjs.com/package/@aigne/core)
 [![Elastic-2.0 licensed](https://img.shields.io/npm/l/@aigne/core)](https://github.com/AIGNE-io/aigne-framework/blob/main/LICENSE)
 
-Core library of [AIGNE Framework](https://github.com/AIGNE-io/aigne-framework) for building AI-powered applications.
-
 ## Introduction
 
 `@aigne/core` is the foundation component of [AIGNE Framework](https://github.com/AIGNE-io/aigne-framework), providing the essential modules and tools needed to build AI-driven applications. This package implements the core functionalities of the framework, including agent systems, aigne environment, model integrations, and workflow pattern support.
 
+<picture>
+  <source srcset="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/assets/aigne-framework-dark.png" media="(prefers-color-scheme: dark)">
+  <source srcset="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/assets/aigne-framework.png" media="(prefers-color-scheme: light)">
+  <img src="https://raw.githubusercontent.com/AIGNE-io/aigne-framework/main/aigne-framework.png" alt="AIGNE Arch" />
+</picture>
+
 ## Features
 
 * **Multiple AI Model Support**: Built-in support for OpenAI, Gemini, Claude, Nova, and other mainstream AI models, easily extensible to support additional models

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/agents/chat-model.js

@@ -103,7 +103,11 @@ class ChatModel extends agent_js_1.Agent {
                 toolsMap[name] = originalTool;
             }
             this.validateToolNames(tools);
-            Object.assign(input, { _toolsMap: toolsMap, tools });
+            Object.assign(input, { tools });
+            Object.defineProperty(input, "_toolsMap", {
+                value: toolsMap,
+                enumerable: false,
+            });
         }
     }
     /**

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/cjs/utils/structured-stream-extractor.js

@@ -16,9 +16,17 @@ class ExtractMetadataTransform extends TransformStream {
                         if (this.state === "none") {
                             const found = findMatchIndex(this.buffer, this.cursor, start);
                             if (found.start > this.cursor) {
-                                const text = this.buffer.slice(this.cursor, found.start);
+                                let text = this.buffer.slice(this.cursor, found.start);
                                 this.cursor = found.start;
-                                controller.enqueue({ delta: { text: { text } } });
+                                // Trim trailing whitespace from the text
+                                const whitespace = text.match(/(?<whitespace>\s+)$/)?.groups?.whitespace;
+                                if (whitespace) {
+                                    text = text.slice(0, -whitespace.length);
+                                    this.cursor -= whitespace.length;
+                                }
+                                if (text) {
+                                    controller.enqueue({ delta: { text: { text } } });
+                                }
                             }
                             if (found.end) {
                                 this.state = "start";

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/agents/chat-model.js

@@ -100,7 +100,11 @@ export class ChatModel extends Agent {
                 toolsMap[name] = originalTool;
             }
             this.validateToolNames(tools);
-            Object.assign(input, { _toolsMap: toolsMap, tools });
+            Object.assign(input, { tools });
+            Object.defineProperty(input, "_toolsMap", {
+                value: toolsMap,
+                enumerable: false,
+            });
         }
     }
     /**

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/lib/esm/utils/structured-stream-extractor.js

@@ -13,9 +13,17 @@ export class ExtractMetadataTransform extends TransformStream {
                         if (this.state === "none") {
                             const found = findMatchIndex(this.buffer, this.cursor, start);
                             if (found.start > this.cursor) {
-                                const text = this.buffer.slice(this.cursor, found.start);
+                                let text = this.buffer.slice(this.cursor, found.start);
                                 this.cursor = found.start;
-                                controller.enqueue({ delta: { text: { text } } });
+                                // Trim trailing whitespace from the text
+                                const whitespace = text.match(/(?<whitespace>\s+)$/)?.groups?.whitespace;
+                                if (whitespace) {
+                                    text = text.slice(0, -whitespace.length);
+                                    this.cursor -= whitespace.length;
+                                }
+                                if (text) {
+                                    controller.enqueue({ delta: { text: { text } } });
+                                }
                             }
                             if (found.end) {
                                 this.state = "start";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aigne/core",
-  "version": "1.45.0",
-  "description": "AIGNE core library for building AI-powered applications",
+  "version": "1.46.1",
+  "description": "The functional core of agentic AI",
   "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",