@aigne/core 1.47.0 → 1.49.0

package/CHANGELOG.md

@@ -1,16 +1,30 @@
-## [1.22.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.21.0...core-v1.22.0) (2025-06-24)
+# Changelog
+
+## [1.49.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.48.0...core-v1.49.0) (2025-08-12)
 
 
 ### Features
 
-* support observability for cli and blocklet ([#155](https://github.com/AIGNE-io/aigne-framework/issues/155)) ([5baa705](https://github.com/AIGNE-io/aigne-framework/commit/5baa705a33cfdba1efc5ccbe18674c27513ca97d))
+* **cli:** add retry functionality and improve error handling for AIGNE Hub ([#348](https://github.com/AIGNE-io/aigne-framework/issues/348)) ([672c93a](https://github.com/AIGNE-io/aigne-framework/commit/672c93abbba8b4b234f6d810536ff4b603a97e1e))
+
+
+### Bug Fixes
+
+* **core:** examples cases that failed when using aigne-hub ([#337](https://github.com/AIGNE-io/aigne-framework/issues/337)) ([0d4a31c](https://github.com/AIGNE-io/aigne-framework/commit/0d4a31c24d9e7d26f00d1accb80719d9ad79a4c6))
 
 
 ### Dependencies
 
 * The following workspace dependencies were updated
   * dependencies
-    * @aigne/observability bumped to 0.1.0
+    * @aigne/platform-helpers bumped to 0.6.1
+
+## [1.48.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.47.0...core-v1.48.0) (2025-08-12)
+
+
+### Features
+
+* enhance task title functionality to support dynamic generation ([#346](https://github.com/AIGNE-io/aigne-framework/issues/346)) ([fff098c](https://github.com/AIGNE-io/aigne-framework/commit/fff098c9828beca9d99e4b2ebaebdf6b92efb84e))
 
 ## [1.47.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.46.1...core-v1.47.0) (2025-08-11)
 
@@ -445,6 +459,21 @@
   * dependencies
     * @aigne/observability bumped to 0.1.1
 
+## [1.22.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.21.0...core-v1.22.0) (2025-06-24)
+
+
+### Features
+
+* support observability for cli and blocklet ([#155](https://github.com/AIGNE-io/aigne-framework/issues/155)) ([5baa705](https://github.com/AIGNE-io/aigne-framework/commit/5baa705a33cfdba1efc5ccbe18674c27513ca97d))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/observability bumped to 0.1.0
+
+
 ## [1.21.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.20.1...core-v1.21.0) (2025-06-20)
 
 

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

@@ -72,7 +72,7 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
      * for documentation and debugging
      */
     description?: string;
-    taskTitle?: string;
+    taskTitle?: string | ((input: I) => PromiseOrValue<string | undefined>);
     /**
      * Zod schema defining the input message structure
      *
@@ -257,8 +257,8 @@ 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;
-    renderTaskTitle(input: I): string | undefined;
+    taskTitle?: string | ((input: Message) => PromiseOrValue<string | undefined>);
+    renderTaskTitle(input: I): Promise<string | undefined>;
     private readonly _inputSchema?;
     defaultInput?: Partial<{
         [key in keyof I]: {
@@ -405,6 +405,7 @@ export declare abstract class Agent<I extends Message = any, O extends Message =
      * @returns Agent response (streaming or regular)
      */
     invoke(input: I & Message, options?: Partial<AgentInvokeOptions>): Promise<AgentResponse<O>>;
+    private processStreamingAndRetry;
     private callHooks;
     private mergeDefaultInput;
     protected invokeSkill<I extends Message, O extends Message>(skill: Agent<I, O>, input: I & Message, options: AgentInvokeOptions): Promise<O>;
@@ -582,12 +583,14 @@ export interface AgentHooks<I extends Message = Message, O extends Message = Mes
         error: Error;
     }, "output", "error">) => PromiseOrValue<void | {
         output?: O;
+        retry?: boolean;
     }>) | Agent<XOr<{
         input: I;
         output: O;
         error: Error;
     }, "output", "error">, {
         output?: O;
+        retry?: boolean;
     }>;
     onSuccess?: ((event: {
         context: Context;
@@ -607,9 +610,13 @@ export interface AgentHooks<I extends Message = Message, O extends Message = Mes
         agent: Agent;
         input: I;
         error: Error;
-    }) => void) | Agent<{
+    }) => PromiseOrValue<void | {
+        retry?: boolean;
+    }>) | Agent<{
         input: I;
         error: Error;
+    }, {
+        retry?: boolean;
     }>;
     /**
      * Called before a skill (sub-agent) is invoked

package/lib/cjs/agents/agent.js

@@ -47,6 +47,7 @@ exports.textDelta = textDelta;
 exports.jsonDelta = jsonDelta;
 exports.agentProcessResultToObject = agentProcessResultToObject;
 const index_js_1 = require("@aigne/platform-helpers/nodejs/index.js");
+const fast_deep_equal_1 = __importDefault(require("fast-deep-equal"));
 const nunjucks_1 = __importDefault(require("nunjucks"));
 const zod_1 = require("zod");
 const logger_js_1 = require("../utils/logger.js");
@@ -199,10 +200,13 @@ class Agent {
      */
     description;
     taskTitle;
-    renderTaskTitle(input) {
+    async renderTaskTitle(input) {
         if (!this.taskTitle)
             return;
-        return nunjucks_1.default.renderString(this.taskTitle, { ...input });
+        const s = typeof this.taskTitle === "function" ? await this.taskTitle(input) : this.taskTitle;
+        if (!s)
+            return;
+        return nunjucks_1.default.renderString(s, { ...input });
     }
     _inputSchema;
     defaultInput;
@@ -360,7 +364,6 @@ class Agent {
         if (!this.disableEvents)
             opts.context.emit("agentStarted", { agent: this, input });
         try {
-            let response;
             const s = await this.callHooks("onStart", { input }, opts);
             if (s?.input)
                 input = s.input;
@@ -369,31 +372,47 @@ class Agent {
             input = (0, type_utils_js_1.checkArguments)(`Agent ${this.name} input`, this.inputSchema, input);
             await this.preprocess(input, opts);
             this.checkContextStatus(opts);
-            if (!response) {
-                response = await this.process(input, opts);
-                if (response instanceof Agent) {
-                    response = (0, types_js_1.transferToAgentOutput)(response);
+            const response = (0, stream_utils_js_1.asyncGeneratorToReadableStream)(this.processStreamingAndRetry(input, opts));
+            return await this.checkResponseByGuideRails(input, options.streaming ? response : await agentProcessResultToObject(response), opts);
+        }
+        catch (error) {
+            throw (await this.processAgentError(input, error, opts)).error ?? error;
+        }
+    }
+    async *processStreamingAndRetry(input, options) {
+        let output = {};
+        for (;;) {
+            // Reset output to avoid accumulating old data
+            const resetOutput = Object.fromEntries(Object.entries(output).map(([key]) => [key, null]));
+            if (!(0, type_utils_js_1.isEmpty)(resetOutput)) {
+                yield { delta: { json: resetOutput } };
+                output = {};
+            }
+            let response = await this.process(input, options);
+            if (response instanceof Agent)
+                response = (0, types_js_1.transferToAgentOutput)(response);
+            const stream = response instanceof ReadableStream
+                ? response
+                : (0, stream_utils_js_1.isAsyncGenerator)(response)
+                    ? (0, stream_utils_js_1.asyncGeneratorToReadableStream)(response)
+                    : (0, stream_utils_js_1.objectToAgentResponseStream)(response);
+            try {
+                for await (const chunk of stream) {
+                    (0, stream_utils_js_1.mergeAgentResponseChunk)(output, chunk);
+                    yield chunk;
+                }
+                const result = await this.processAgentOutput(input, output, options);
+                if (result && !(0, fast_deep_equal_1.default)(result, output)) {
+                    yield { delta: { json: result } };
                 }
+                // Close the stream after processing
+                break;
             }
-            if (opts.streaming) {
-                const stream = response instanceof ReadableStream
-                    ? response
-                    : (0, stream_utils_js_1.isAsyncGenerator)(response)
-                        ? (0, stream_utils_js_1.asyncGeneratorToReadableStream)(response)
-                        : (0, stream_utils_js_1.objectToAgentResponseStream)(response);
-                return this.checkResponseByGuideRails(input, (0, stream_utils_js_1.onAgentResponseStreamEnd)(stream, {
-                    onResult: async (result) => {
-                        return await this.processAgentOutput(input, result, opts);
-                    },
-                    onError: async (error) => {
-                        return await this.processAgentError(input, error, opts);
-                    },
-                }), opts);
+            catch (error) {
+                const res = await this.processAgentError(input, error, options);
+                if (!res.retry)
+                    throw res.error ?? error;
             }
-            return await this.checkResponseByGuideRails(input, this.processAgentOutput(input, await agentProcessResultToObject(response), opts), opts);
-        }
-        catch (error) {
-            throw await this.processAgentError(input, error, opts);
         }
     }
     async callHooks(hook, input, options) {
@@ -480,12 +499,15 @@ class Agent {
      * @param options Invocation options
      */
     async processAgentError(input, error, options) {
+        if ("$error_has_been_processed" in error && error.$error_has_been_processed)
+            return {};
+        Object.defineProperty(error, "$error_has_been_processed", { value: true, enumerable: false });
         logger_js_1.logger.error("Invoke agent %s failed with error: %O", this.name, error);
         if (!this.disableEvents)
             options.context.emit("agentFailed", { agent: this, error });
-        await this.callHooks("onError", { input, error }, options);
-        await this.callHooks("onEnd", { input, error }, options);
-        return error;
+        const res = (await this.callHooks("onError", { input, error }, options)) ?? {};
+        Object.assign(res, await this.callHooks("onEnd", { input, error }, options));
+        return { ...res };
     }
     /**
      * Check agent invocation usage to prevent exceeding limits

package/lib/cjs/loader/index.d.ts

@@ -11,6 +11,7 @@ export interface LoadOptions {
         new (parameters?: MemoryAgentOptions): MemoryAgent;
     }[];
     path: string;
+    model?: ChatModel;
 }
 export declare function load(options: LoadOptions): Promise<AIGNEOptions>;
 export declare function loadAgent(path: string, options?: LoadOptions, agentOptions?: AgentOptions): Promise<Agent>;

package/lib/cjs/loader/index.js

@@ -25,7 +25,7 @@ async function load(options) {
     return {
         ...aigne,
         rootDir,
-        model: await options.loadModel(aigne.model),
+        model: options?.model || (await options.loadModel(aigne.model)),
         agents: pickAgents(aigne.agents ?? []),
         skills: pickAgents(aigne.skills ?? []),
         mcpServer: {

package/lib/cjs/utils/event-stream.js

@@ -131,8 +131,8 @@ class AgentResponseProgressStream extends ReadableStream {
                     context.off("agentFailed", onAgentFailed);
                     controller.close();
                 };
-                const onAgentStarted = (event) => {
-                    const taskTitle = event.agent.renderTaskTitle(event.input);
+                const onAgentStarted = async (event) => {
+                    const taskTitle = await event.agent.renderTaskTitle(event.input);
                     writeEvent("agentStarted", { ...event, taskTitle });
                 };
                 const onAgentSucceed = (event) => {

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

@@ -72,7 +72,7 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
      * for documentation and debugging
      */
     description?: string;
-    taskTitle?: string;
+    taskTitle?: string | ((input: I) => PromiseOrValue<string | undefined>);
     /**
      * Zod schema defining the input message structure
      *
@@ -257,8 +257,8 @@ 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;
-    renderTaskTitle(input: I): string | undefined;
+    taskTitle?: string | ((input: Message) => PromiseOrValue<string | undefined>);
+    renderTaskTitle(input: I): Promise<string | undefined>;
     private readonly _inputSchema?;
     defaultInput?: Partial<{
         [key in keyof I]: {
@@ -405,6 +405,7 @@ export declare abstract class Agent<I extends Message = any, O extends Message =
      * @returns Agent response (streaming or regular)
      */
     invoke(input: I & Message, options?: Partial<AgentInvokeOptions>): Promise<AgentResponse<O>>;
+    private processStreamingAndRetry;
     private callHooks;
     private mergeDefaultInput;
     protected invokeSkill<I extends Message, O extends Message>(skill: Agent<I, O>, input: I & Message, options: AgentInvokeOptions): Promise<O>;
@@ -582,12 +583,14 @@ export interface AgentHooks<I extends Message = Message, O extends Message = Mes
         error: Error;
     }, "output", "error">) => PromiseOrValue<void | {
         output?: O;
+        retry?: boolean;
     }>) | Agent<XOr<{
         input: I;
         output: O;
         error: Error;
     }, "output", "error">, {
         output?: O;
+        retry?: boolean;
     }>;
     onSuccess?: ((event: {
         context: Context;
@@ -607,9 +610,13 @@ export interface AgentHooks<I extends Message = Message, O extends Message = Mes
         agent: Agent;
         input: I;
         error: Error;
-    }) => void) | Agent<{
+    }) => PromiseOrValue<void | {
+        retry?: boolean;
+    }>) | Agent<{
         input: I;
         error: Error;
+    }, {
+        retry?: boolean;
     }>;
     /**
      * Called before a skill (sub-agent) is invoked

package/lib/dts/loader/index.d.ts

@@ -11,6 +11,7 @@ export interface LoadOptions {
         new (parameters?: MemoryAgentOptions): MemoryAgent;
     }[];
     path: string;
+    model?: ChatModel;
 }
 export declare function load(options: LoadOptions): Promise<AIGNEOptions>;
 export declare function loadAgent(path: string, options?: LoadOptions, agentOptions?: AgentOptions): Promise<Agent>;

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

@@ -72,7 +72,7 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
      * for documentation and debugging
      */
     description?: string;
-    taskTitle?: string;
+    taskTitle?: string | ((input: I) => PromiseOrValue<string | undefined>);
     /**
      * Zod schema defining the input message structure
      *
@@ -257,8 +257,8 @@ 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;
-    renderTaskTitle(input: I): string | undefined;
+    taskTitle?: string | ((input: Message) => PromiseOrValue<string | undefined>);
+    renderTaskTitle(input: I): Promise<string | undefined>;
     private readonly _inputSchema?;
     defaultInput?: Partial<{
         [key in keyof I]: {
@@ -405,6 +405,7 @@ export declare abstract class Agent<I extends Message = any, O extends Message =
      * @returns Agent response (streaming or regular)
      */
     invoke(input: I & Message, options?: Partial<AgentInvokeOptions>): Promise<AgentResponse<O>>;
+    private processStreamingAndRetry;
     private callHooks;
     private mergeDefaultInput;
     protected invokeSkill<I extends Message, O extends Message>(skill: Agent<I, O>, input: I & Message, options: AgentInvokeOptions): Promise<O>;
@@ -582,12 +583,14 @@ export interface AgentHooks<I extends Message = Message, O extends Message = Mes
         error: Error;
     }, "output", "error">) => PromiseOrValue<void | {
         output?: O;
+        retry?: boolean;
     }>) | Agent<XOr<{
         input: I;
         output: O;
         error: Error;
     }, "output", "error">, {
         output?: O;
+        retry?: boolean;
     }>;
     onSuccess?: ((event: {
         context: Context;
@@ -607,9 +610,13 @@ export interface AgentHooks<I extends Message = Message, O extends Message = Mes
         agent: Agent;
         input: I;
         error: Error;
-    }) => void) | Agent<{
+    }) => PromiseOrValue<void | {
+        retry?: boolean;
+    }>) | Agent<{
         input: I;
         error: Error;
+    }, {
+        retry?: boolean;
     }>;
     /**
      * Called before a skill (sub-agent) is invoked

package/lib/esm/agents/agent.js

@@ -1,8 +1,9 @@
 import { nodejs } from "@aigne/platform-helpers/nodejs/index.js";
+import equal from "fast-deep-equal";
 import nunjucks from "nunjucks";
 import { ZodObject, z } from "zod";
 import { logger } from "../utils/logger.js";
-import { agentResponseStreamToObject, asyncGeneratorToReadableStream, isAsyncGenerator, objectToAgentResponseStream, onAgentResponseStreamEnd, } from "../utils/stream-utils.js";
+import { agentResponseStreamToObject, asyncGeneratorToReadableStream, isAsyncGenerator, mergeAgentResponseChunk, objectToAgentResponseStream, onAgentResponseStreamEnd, } from "../utils/stream-utils.js";
 import { checkArguments, createAccessorArray, flat, isEmpty, isNil, isRecord, } from "../utils/type-utils.js";
 import { replaceTransferAgentToName, transferToAgentOutput, } from "./types.js";
 export * from "./types.js";
@@ -151,10 +152,13 @@ export class Agent {
      */
     description;
     taskTitle;
-    renderTaskTitle(input) {
+    async renderTaskTitle(input) {
         if (!this.taskTitle)
             return;
-        return nunjucks.renderString(this.taskTitle, { ...input });
+        const s = typeof this.taskTitle === "function" ? await this.taskTitle(input) : this.taskTitle;
+        if (!s)
+            return;
+        return nunjucks.renderString(s, { ...input });
     }
     _inputSchema;
     defaultInput;
@@ -312,7 +316,6 @@ export class Agent {
         if (!this.disableEvents)
             opts.context.emit("agentStarted", { agent: this, input });
         try {
-            let response;
             const s = await this.callHooks("onStart", { input }, opts);
             if (s?.input)
                 input = s.input;
@@ -321,31 +324,47 @@ export class Agent {
             input = checkArguments(`Agent ${this.name} input`, this.inputSchema, input);
             await this.preprocess(input, opts);
             this.checkContextStatus(opts);
-            if (!response) {
-                response = await this.process(input, opts);
-                if (response instanceof Agent) {
-                    response = transferToAgentOutput(response);
+            const response = asyncGeneratorToReadableStream(this.processStreamingAndRetry(input, opts));
+            return await this.checkResponseByGuideRails(input, options.streaming ? response : await agentProcessResultToObject(response), opts);
+        }
+        catch (error) {
+            throw (await this.processAgentError(input, error, opts)).error ?? error;
+        }
+    }
+    async *processStreamingAndRetry(input, options) {
+        let output = {};
+        for (;;) {
+            // Reset output to avoid accumulating old data
+            const resetOutput = Object.fromEntries(Object.entries(output).map(([key]) => [key, null]));
+            if (!isEmpty(resetOutput)) {
+                yield { delta: { json: resetOutput } };
+                output = {};
+            }
+            let response = await this.process(input, options);
+            if (response instanceof Agent)
+                response = transferToAgentOutput(response);
+            const stream = response instanceof ReadableStream
+                ? response
+                : isAsyncGenerator(response)
+                    ? asyncGeneratorToReadableStream(response)
+                    : objectToAgentResponseStream(response);
+            try {
+                for await (const chunk of stream) {
+                    mergeAgentResponseChunk(output, chunk);
+                    yield chunk;
+                }
+                const result = await this.processAgentOutput(input, output, options);
+                if (result && !equal(result, output)) {
+                    yield { delta: { json: result } };
                 }
+                // Close the stream after processing
+                break;
             }
-            if (opts.streaming) {
-                const stream = response instanceof ReadableStream
-                    ? response
-                    : isAsyncGenerator(response)
-                        ? asyncGeneratorToReadableStream(response)
-                        : objectToAgentResponseStream(response);
-                return this.checkResponseByGuideRails(input, onAgentResponseStreamEnd(stream, {
-                    onResult: async (result) => {
-                        return await this.processAgentOutput(input, result, opts);
-                    },
-                    onError: async (error) => {
-                        return await this.processAgentError(input, error, opts);
-                    },
-                }), opts);
+            catch (error) {
+                const res = await this.processAgentError(input, error, options);
+                if (!res.retry)
+                    throw res.error ?? error;
             }
-            return await this.checkResponseByGuideRails(input, this.processAgentOutput(input, await agentProcessResultToObject(response), opts), opts);
-        }
-        catch (error) {
-            throw await this.processAgentError(input, error, opts);
         }
     }
     async callHooks(hook, input, options) {
@@ -432,12 +451,15 @@ export class Agent {
      * @param options Invocation options
      */
     async processAgentError(input, error, options) {
+        if ("$error_has_been_processed" in error && error.$error_has_been_processed)
+            return {};
+        Object.defineProperty(error, "$error_has_been_processed", { value: true, enumerable: false });
         logger.error("Invoke agent %s failed with error: %O", this.name, error);
         if (!this.disableEvents)
             options.context.emit("agentFailed", { agent: this, error });
-        await this.callHooks("onError", { input, error }, options);
-        await this.callHooks("onEnd", { input, error }, options);
-        return error;
+        const res = (await this.callHooks("onError", { input, error }, options)) ?? {};
+        Object.assign(res, await this.callHooks("onEnd", { input, error }, options));
+        return { ...res };
     }
     /**
      * Check agent invocation usage to prevent exceeding limits

package/lib/esm/loader/index.d.ts

@@ -11,6 +11,7 @@ export interface LoadOptions {
         new (parameters?: MemoryAgentOptions): MemoryAgent;
     }[];
     path: string;
+    model?: ChatModel;
 }
 export declare function load(options: LoadOptions): Promise<AIGNEOptions>;
 export declare function loadAgent(path: string, options?: LoadOptions, agentOptions?: AgentOptions): Promise<Agent>;

package/lib/esm/loader/index.js

@@ -20,7 +20,7 @@ export async function load(options) {
     return {
         ...aigne,
         rootDir,
-        model: await options.loadModel(aigne.model),
+        model: options?.model || (await options.loadModel(aigne.model)),
         agents: pickAgents(aigne.agents ?? []),
         skills: pickAgents(aigne.skills ?? []),
         mcpServer: {

package/lib/esm/utils/event-stream.js

@@ -125,8 +125,8 @@ export class AgentResponseProgressStream extends ReadableStream {
                     context.off("agentFailed", onAgentFailed);
                     controller.close();
                 };
-                const onAgentStarted = (event) => {
-                    const taskTitle = event.agent.renderTaskTitle(event.input);
+                const onAgentStarted = async (event) => {
+                    const taskTitle = await event.agent.renderTaskTitle(event.input);
                     writeEvent("agentStarted", { ...event, taskTitle });
                 };
                 const onAgentSucceed = (event) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.47.0",
+  "version": "1.49.0",
   "description": "The functional core of agentic AI",
   "publishConfig": {
     "access": "public"
@@ -90,7 +90,7 @@
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.6",
     "@aigne/observability-api": "^0.9.0",
-    "@aigne/platform-helpers": "^0.6.0"
+    "@aigne/platform-helpers": "^0.6.1"
   },
   "devDependencies": {
     "@types/bun": "^1.2.18",