@aigne/core 1.62.0-beta.4 → 1.62.0-beta.5

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [1.62.0-beta.5](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.62.0-beta.4...core-v1.62.0-beta.5) (2025-10-02)
+
+
+### Features
+
+* **core:** add `keepTextInToolUses` option for AI Agent ([#585](https://github.com/AIGNE-io/aigne-framework/issues/585)) ([6c6be9e](https://github.com/AIGNE-io/aigne-framework/commit/6c6be9eee8e96294921b676a1982a18c93b2f66d))
+
+
+### Bug Fixes
+
+* **core:** agent should not emit error event if retried ([#583](https://github.com/AIGNE-io/aigne-framework/issues/583)) ([04edcbf](https://github.com/AIGNE-io/aigne-framework/commit/04edcbfd71aa2746dad98140e20e0b718701fa0a))
+
 ## [1.62.0-beta.4](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.62.0-beta.3...core-v1.62.0-beta.4) (2025-10-01)
 
 

package/lib/cjs/agents/agent.js

@@ -551,9 +551,11 @@ class Agent {
      */
     async processAgentError(input, error, options) {
         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 });
         const res = (await this.callHooks(["onError", "onEnd"], { input, error }, options)) ?? {};
+        if (!res.retry) {
+            if (!this.disableEvents)
+                options.context.emit("agentFailed", { agent: this, error });
+        }
         return { ...res };
     }
     /**

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

@@ -42,6 +42,10 @@ export interface AIAgentOptions<I extends Message = Message, O extends Message =
      * @default AIAgentToolChoice.auto
      */
     toolChoice?: AIAgentToolChoice | Agent;
+    /**
+     * Whether to preserve text generated during tool usage in the final output
+     */
+    keepTextInToolUses?: boolean;
     /**
      * Whether to catch errors from tool execution and continue processing.
      * If set to false, the agent will throw an error if a tool fails.
@@ -233,6 +237,10 @@ export declare class AIAgent<I extends Message = any, O extends Message = any> e
      * {@includeCode ../../test/agents/ai-agent.test.ts#example-ai-agent-router}
      */
     toolChoice?: AIAgentToolChoice | Agent;
+    /**
+     * Whether to preserve text generated during tool usage in the final output
+     */
+    keepTextInToolUses?: boolean;
     /**
      * Whether to include memory agents as tools for the AI model
      *

package/lib/cjs/agents/ai-agent.js

@@ -58,6 +58,7 @@ exports.aiAgentOptionsSchema = agent_js_1.agentOptionsSchema.extend({
     inputKey: zod_1.z.string().optional(),
     outputKey: zod_1.z.string().optional(),
     toolChoice: exports.aiAgentToolChoiceSchema.optional(),
+    keepTextInToolUses: zod_1.z.boolean().optional(),
     memoryAgentsAsTools: zod_1.z.boolean().optional(),
     memoryPromptTemplate: zod_1.z.string().optional(),
 });
@@ -116,6 +117,7 @@ class AIAgent extends agent_js_1.Agent {
         this.outputFileKey = options.outputFileKey || exports.DEFAULT_OUTPUT_FILE_KEY;
         this.outputFileType = options.outputFileType;
         this.toolChoice = options.toolChoice;
+        this.keepTextInToolUses = options.keepTextInToolUses;
         this.memoryAgentsAsTools = options.memoryAgentsAsTools;
         this.memoryPromptTemplate = options.memoryPromptTemplate;
         this.useMemoriesFromContext = options.useMemoriesFromContext;
@@ -171,6 +173,10 @@ class AIAgent extends agent_js_1.Agent {
      * {@includeCode ../../test/agents/ai-agent.test.ts#example-ai-agent-router}
      */
     toolChoice;
+    /**
+     * Whether to preserve text generated during tool usage in the final output
+     */
+    keepTextInToolUses;
     /**
      * Whether to include memory agents as tools for the AI model
      *
@@ -271,6 +277,12 @@ class AIAgent extends agent_js_1.Agent {
             }
             const { toolCalls, json, text, files } = modelOutput;
             if (toolCalls?.length) {
+                if (!this.keepTextInToolUses) {
+                    yield { delta: { json: { [outputKey]: "" } } };
+                }
+                else {
+                    yield { delta: { text: { [outputKey]: "\n" } } };
+                }
                 const executedToolCalls = [];
                 // Execute tools
                 for (const call of toolCalls) {

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

@@ -48,6 +48,7 @@ export interface AIAgentSchema extends BaseAgentSchema {
     inputKey?: string;
     outputKey?: string;
     toolChoice?: AIAgentToolChoice;
+    keepTextInToolUses?: boolean;
 }
 export interface ImageAgentSchema extends BaseAgentSchema {
     type: "image";

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

@@ -96,6 +96,7 @@ async function parseAgentFile(path, data) {
                 inputKey: (0, schema_js_1.optionalize)(zod_1.z.string()),
                 outputKey: (0, schema_js_1.optionalize)(zod_1.z.string()),
                 toolChoice: (0, schema_js_1.optionalize)(zod_1.z.nativeEnum(ai_agent_js_1.AIAgentToolChoice)),
+                keepTextInToolUses: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
                 structuredStreamMode: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
             })
                 .extend(baseAgentSchema.shape),

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

@@ -42,6 +42,10 @@ export interface AIAgentOptions<I extends Message = Message, O extends Message =
      * @default AIAgentToolChoice.auto
      */
     toolChoice?: AIAgentToolChoice | Agent;
+    /**
+     * Whether to preserve text generated during tool usage in the final output
+     */
+    keepTextInToolUses?: boolean;
     /**
      * Whether to catch errors from tool execution and continue processing.
      * If set to false, the agent will throw an error if a tool fails.
@@ -233,6 +237,10 @@ export declare class AIAgent<I extends Message = any, O extends Message = any> e
      * {@includeCode ../../test/agents/ai-agent.test.ts#example-ai-agent-router}
      */
     toolChoice?: AIAgentToolChoice | Agent;
+    /**
+     * Whether to preserve text generated during tool usage in the final output
+     */
+    keepTextInToolUses?: boolean;
     /**
      * Whether to include memory agents as tools for the AI model
      *

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

@@ -48,6 +48,7 @@ export interface AIAgentSchema extends BaseAgentSchema {
     inputKey?: string;
     outputKey?: string;
     toolChoice?: AIAgentToolChoice;
+    keepTextInToolUses?: boolean;
 }
 export interface ImageAgentSchema extends BaseAgentSchema {
     type: "image";

package/lib/esm/agents/agent.js

@@ -503,9 +503,11 @@ export class Agent {
      */
     async processAgentError(input, error, options) {
         logger.error("Invoke agent %s failed with error: %O", this.name, error);
-        if (!this.disableEvents)
-            options.context.emit("agentFailed", { agent: this, error });
         const res = (await this.callHooks(["onError", "onEnd"], { input, error }, options)) ?? {};
+        if (!res.retry) {
+            if (!this.disableEvents)
+                options.context.emit("agentFailed", { agent: this, error });
+        }
         return { ...res };
     }
     /**

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

@@ -42,6 +42,10 @@ export interface AIAgentOptions<I extends Message = Message, O extends Message =
      * @default AIAgentToolChoice.auto
      */
     toolChoice?: AIAgentToolChoice | Agent;
+    /**
+     * Whether to preserve text generated during tool usage in the final output
+     */
+    keepTextInToolUses?: boolean;
     /**
      * Whether to catch errors from tool execution and continue processing.
      * If set to false, the agent will throw an error if a tool fails.
@@ -233,6 +237,10 @@ export declare class AIAgent<I extends Message = any, O extends Message = any> e
      * {@includeCode ../../test/agents/ai-agent.test.ts#example-ai-agent-router}
      */
     toolChoice?: AIAgentToolChoice | Agent;
+    /**
+     * Whether to preserve text generated during tool usage in the final output
+     */
+    keepTextInToolUses?: boolean;
     /**
      * Whether to include memory agents as tools for the AI model
      *

package/lib/esm/agents/ai-agent.js

@@ -55,6 +55,7 @@ export const aiAgentOptionsSchema = agentOptionsSchema.extend({
     inputKey: z.string().optional(),
     outputKey: z.string().optional(),
     toolChoice: aiAgentToolChoiceSchema.optional(),
+    keepTextInToolUses: z.boolean().optional(),
     memoryAgentsAsTools: z.boolean().optional(),
     memoryPromptTemplate: z.string().optional(),
 });
@@ -113,6 +114,7 @@ export class AIAgent extends Agent {
         this.outputFileKey = options.outputFileKey || DEFAULT_OUTPUT_FILE_KEY;
         this.outputFileType = options.outputFileType;
         this.toolChoice = options.toolChoice;
+        this.keepTextInToolUses = options.keepTextInToolUses;
         this.memoryAgentsAsTools = options.memoryAgentsAsTools;
         this.memoryPromptTemplate = options.memoryPromptTemplate;
         this.useMemoriesFromContext = options.useMemoriesFromContext;
@@ -168,6 +170,10 @@ export class AIAgent extends Agent {
      * {@includeCode ../../test/agents/ai-agent.test.ts#example-ai-agent-router}
      */
     toolChoice;
+    /**
+     * Whether to preserve text generated during tool usage in the final output
+     */
+    keepTextInToolUses;
     /**
      * Whether to include memory agents as tools for the AI model
      *
@@ -268,6 +274,12 @@ export class AIAgent extends Agent {
             }
             const { toolCalls, json, text, files } = modelOutput;
             if (toolCalls?.length) {
+                if (!this.keepTextInToolUses) {
+                    yield { delta: { json: { [outputKey]: "" } } };
+                }
+                else {
+                    yield { delta: { text: { [outputKey]: "\n" } } };
+                }
                 const executedToolCalls = [];
                 // Execute tools
                 for (const call of toolCalls) {

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

@@ -48,6 +48,7 @@ export interface AIAgentSchema extends BaseAgentSchema {
     inputKey?: string;
     outputKey?: string;
     toolChoice?: AIAgentToolChoice;
+    keepTextInToolUses?: boolean;
 }
 export interface ImageAgentSchema extends BaseAgentSchema {
     type: "image";

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

@@ -92,6 +92,7 @@ export async function parseAgentFile(path, data) {
                 inputKey: optionalize(z.string()),
                 outputKey: optionalize(z.string()),
                 toolChoice: optionalize(z.nativeEnum(AIAgentToolChoice)),
+                keepTextInToolUses: optionalize(z.boolean()),
                 structuredStreamMode: optionalize(z.boolean()),
             })
                 .extend(baseAgentSchema.shape),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.62.0-beta.4",
+  "version": "1.62.0-beta.5",
   "description": "The functional core of agentic AI",
   "publishConfig": {
     "access": "public"