@aigne/core 1.18.3 → 1.18.5

package/CHANGELOG.md

@@ -5,6 +5,20 @@
 
 * add user context support ([#131](https://github.com/AIGNE-io/aigne-framework/issues/131)) ([4dd9d20](https://github.com/AIGNE-io/aigne-framework/commit/4dd9d20953f6ac33933723db56efd9b44bafeb02))
 
+## [1.18.5](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.18.4...core-v1.18.5) (2025-06-06)
+
+
+### Bug Fixes
+
+* **core:** should pass memories from invocation options to nested agents ([#153](https://github.com/AIGNE-io/aigne-framework/issues/153)) ([57629a5](https://github.com/AIGNE-io/aigne-framework/commit/57629a5da6cf2a295356dfe32ecbb15154e098fe))
+
+## [1.18.4](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.18.3...core-v1.18.4) (2025-06-05)
+
+
+### Bug Fixes
+
+* **core:** prioritize returning json chunks ([#151](https://github.com/AIGNE-io/aigne-framework/issues/151)) ([8bf49a1](https://github.com/AIGNE-io/aigne-framework/commit/8bf49a18c083b33d2e0b35e8d0f22f68d9d6effa))
+
 ## [1.18.3](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.18.2...core-v1.18.3) (2025-06-05)
 
 

package/lib/cjs/agents/agent.js

@@ -336,6 +336,11 @@ class Agent {
         };
         if (options.userContext) {
             Object.assign(opts.context.userContext, options.userContext);
+            options.userContext = undefined;
+        }
+        if (options.memories?.length) {
+            opts.context.memories.push(...options.memories);
+            options.memories = undefined;
         }
         const message = typeof input === "string" ? (0, prompt_builder_js_1.createMessage)(input) : input;
         logger_js_1.logger.debug("Invoke agent %s started with input: %O", this.name, input);

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

@@ -2,6 +2,7 @@ import { Emitter } from "strict-event-emitter";
 import { Agent, 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";
 import { type OmitPropertiesFromArrayFirstElement } from "../utils/type-utils.js";
 import type { Args, Listener, TypedEventEmitter } from "../utils/typed-event-emtter.js";
 import { type MessagePayload, MessageQueue, type MessageQueueListener, type Unsubscribe } from "./message-queue.js";
@@ -58,6 +59,7 @@ export interface Context<U extends UserContext = UserContext> extends TypedEvent
     limits?: ContextLimits;
     status?: "normal" | "timeout";
     userContext: U;
+    memories: Pick<Memory, "content">[];
     /**
      * Create a user agent to consistently invoke an agent
      * @param agent Agent to invoke
@@ -131,6 +133,8 @@ export declare class AIGNEContext implements Context {
     get usage(): ContextUsage;
     get userContext(): Context["userContext"];
     set userContext(userContext: Context["userContext"]);
+    get memories(): Context["memories"];
+    set memories(memories: Context["memories"]);
     newContext({ reset }?: {
         reset?: boolean;
     }): AIGNEContext;
@@ -155,6 +159,7 @@ declare class AIGNEContextShared {
     get limits(): ContextLimits | undefined;
     usage: ContextUsage;
     userContext: Context["userContext"];
+    memories: Context["memories"];
     private abortController;
     private timer?;
     private initTimeout;

package/lib/cjs/aigne/context.js

@@ -1,6 +1,10 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AIGNEContext = void 0;
+const fast_deep_equal_1 = __importDefault(require("fast-deep-equal"));
 const strict_event_emitter_1 = require("strict-event-emitter");
 const uuid_1 = require("uuid");
 const zod_1 = require("zod");
@@ -50,6 +54,12 @@ class AIGNEContext {
     set userContext(userContext) {
         this.internal.userContext = userContext;
     }
+    get memories() {
+        return this.internal.memories;
+    }
+    set memories(memories) {
+        this.internal.memories = memories;
+    }
     newContext({ reset } = {}) {
         if (reset)
             return new AIGNEContext(this, { userContext: {} });
@@ -61,8 +71,14 @@ class AIGNEContext {
             message,
             options,
         });
-        if (options?.userContext)
+        if (options?.userContext) {
             Object.assign(this.userContext, options.userContext);
+            options.userContext = undefined;
+        }
+        if (options?.memories?.length) {
+            this.memories.push(...options.memories);
+            options.memories = undefined;
+        }
         if ((0, type_utils_js_1.isNil)(message)) {
             return user_agent_js_1.UserAgent.from({
                 context: this,
@@ -103,8 +119,14 @@ class AIGNEContext {
         });
     });
     publish = ((topic, payload, options) => {
-        if (options?.userContext)
+        if (options?.userContext) {
             Object.assign(this.userContext, options.userContext);
+            options.userContext = undefined;
+        }
+        if (options?.memories?.length) {
+            this.memories.push(...options.memories);
+            options.memories = undefined;
+        }
         return this.internal.messageQueue.publish(topic, {
             ...(0, message_queue_js_1.toMessagePayload)(payload),
             context: this,
@@ -146,6 +168,7 @@ class AIGNEContextShared {
         this.parent = parent;
         this.messageQueue = this.parent?.messageQueue ?? new message_queue_js_1.MessageQueue();
         this.userContext = overrides?.userContext ?? {};
+        this.memories = overrides?.memories ?? [];
     }
     messageQueue;
     // biome-ignore lint/suspicious/noExplicitAny: <explanation>
@@ -161,6 +184,7 @@ class AIGNEContextShared {
     }
     usage = (0, usage_js_1.newEmptyContextUsage)();
     userContext;
+    memories;
     abortController = new AbortController();
     timer;
     initTimeout() {
@@ -182,7 +206,6 @@ class AIGNEContextShared {
     }
     async *invokeAgent(agent, input, context, options) {
         let activeAgent = agent;
-        let output;
         for (;;) {
             const result = {};
             if (options?.sourceAgent && activeAgent !== options.sourceAgent) {
@@ -195,12 +218,14 @@ class AIGNEContextShared {
             }
             const stream = await activeAgent.invoke(input, { ...options, context, streaming: true });
             for await (const value of stream) {
-                if (value.delta.text) {
-                    yield { delta: { text: value.delta.text } };
-                }
                 if (value.delta.json) {
+                    value.delta.json = omitExistsProperties(result, value.delta.json);
                     Object.assign(result, value.delta.json);
                 }
+                delete value.delta.json?.[types_js_1.transferAgentOutputKey];
+                if ((0, agent_js_1.isEmptyChunk)(value))
+                    continue;
+                yield value;
             }
             if (!options?.disableTransfer) {
                 const transferToAgent = (0, types_js_1.isTransferAgentOutput)(result)
@@ -211,21 +236,22 @@ class AIGNEContextShared {
                     continue;
                 }
             }
-            output = result;
             break;
         }
-        if (!output)
-            throw new Error("Unexpected empty output");
         yield {
             delta: {
-                json: {
-                    ...output,
-                    __activeAgent__: activeAgent,
-                },
+                json: { __activeAgent__: activeAgent },
             },
         };
     }
 }
+function omitExistsProperties(result, { ...delta }) {
+    for (const [key, val] of Object.entries(delta)) {
+        if ((0, fast_deep_equal_1.default)(result[key], val))
+            delete delta[key];
+    }
+    return (0, type_utils_js_1.isEmpty)(delta) ? undefined : delta;
+}
 async function* withAbortSignal(signal, error, fn) {
     const iterator = fn();
     const timeoutPromise = (0, promise_js_1.promiseWithResolvers)();

package/lib/cjs/prompt/prompt-builder.d.ts

@@ -15,7 +15,7 @@ export declare function getMessage(input: Message): string | undefined;
 export interface PromptBuilderOptions {
     instructions?: string | ChatMessagesTemplate;
 }
-export interface PromptBuildOptions extends AgentInvokeOptions {
+export interface PromptBuildOptions extends Pick<AgentInvokeOptions, "context"> {
     agent?: AIAgent;
     input?: Message;
     model?: ChatModel;

package/lib/cjs/prompt/prompt-builder.js

@@ -87,8 +87,8 @@ class PromptBuilder {
         if (options.agent) {
             memories.push(...(await options.agent.retrieveMemories({ search: options.input }, options)));
         }
-        if (options.memories?.length) {
-            memories.push(...options.memories);
+        if (options.context.memories?.length) {
+            memories.push(...options.context.memories);
         }
         if (memories.length)
             messages.push(...this.convertMemoriesToMessages(memories, options));

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

@@ -2,6 +2,7 @@ import { Emitter } from "strict-event-emitter";
 import { Agent, 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";
 import { type OmitPropertiesFromArrayFirstElement } from "../utils/type-utils.js";
 import type { Args, Listener, TypedEventEmitter } from "../utils/typed-event-emtter.js";
 import { type MessagePayload, MessageQueue, type MessageQueueListener, type Unsubscribe } from "./message-queue.js";
@@ -58,6 +59,7 @@ export interface Context<U extends UserContext = UserContext> extends TypedEvent
     limits?: ContextLimits;
     status?: "normal" | "timeout";
     userContext: U;
+    memories: Pick<Memory, "content">[];
     /**
      * Create a user agent to consistently invoke an agent
      * @param agent Agent to invoke
@@ -131,6 +133,8 @@ export declare class AIGNEContext implements Context {
     get usage(): ContextUsage;
     get userContext(): Context["userContext"];
     set userContext(userContext: Context["userContext"]);
+    get memories(): Context["memories"];
+    set memories(memories: Context["memories"]);
     newContext({ reset }?: {
         reset?: boolean;
     }): AIGNEContext;
@@ -155,6 +159,7 @@ declare class AIGNEContextShared {
     get limits(): ContextLimits | undefined;
     usage: ContextUsage;
     userContext: Context["userContext"];
+    memories: Context["memories"];
     private abortController;
     private timer?;
     private initTimeout;

package/lib/dts/prompt/prompt-builder.d.ts

@@ -15,7 +15,7 @@ export declare function getMessage(input: Message): string | undefined;
 export interface PromptBuilderOptions {
     instructions?: string | ChatMessagesTemplate;
 }
-export interface PromptBuildOptions extends AgentInvokeOptions {
+export interface PromptBuildOptions extends Pick<AgentInvokeOptions, "context"> {
     agent?: AIAgent;
     input?: Message;
     model?: ChatModel;

package/lib/esm/agents/agent.js

@@ -294,6 +294,11 @@ export class Agent {
         };
         if (options.userContext) {
             Object.assign(opts.context.userContext, options.userContext);
+            options.userContext = undefined;
+        }
+        if (options.memories?.length) {
+            opts.context.memories.push(...options.memories);
+            options.memories = undefined;
         }
         const message = typeof input === "string" ? createMessage(input) : input;
         logger.debug("Invoke agent %s started with input: %O", this.name, input);

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

@@ -2,6 +2,7 @@ import { Emitter } from "strict-event-emitter";
 import { Agent, 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";
 import { type OmitPropertiesFromArrayFirstElement } from "../utils/type-utils.js";
 import type { Args, Listener, TypedEventEmitter } from "../utils/typed-event-emtter.js";
 import { type MessagePayload, MessageQueue, type MessageQueueListener, type Unsubscribe } from "./message-queue.js";
@@ -58,6 +59,7 @@ export interface Context<U extends UserContext = UserContext> extends TypedEvent
     limits?: ContextLimits;
     status?: "normal" | "timeout";
     userContext: U;
+    memories: Pick<Memory, "content">[];
     /**
      * Create a user agent to consistently invoke an agent
      * @param agent Agent to invoke
@@ -131,6 +133,8 @@ export declare class AIGNEContext implements Context {
     get usage(): ContextUsage;
     get userContext(): Context["userContext"];
     set userContext(userContext: Context["userContext"]);
+    get memories(): Context["memories"];
+    set memories(memories: Context["memories"]);
     newContext({ reset }?: {
         reset?: boolean;
     }): AIGNEContext;
@@ -155,6 +159,7 @@ declare class AIGNEContextShared {
     get limits(): ContextLimits | undefined;
     usage: ContextUsage;
     userContext: Context["userContext"];
+    memories: Context["memories"];
     private abortController;
     private timer?;
     private initTimeout;

package/lib/esm/aigne/context.js

@@ -1,13 +1,14 @@
+import equal from "fast-deep-equal";
 import { Emitter } from "strict-event-emitter";
 import { v7 } from "uuid";
 import { z } from "zod";
-import { Agent, } from "../agents/agent.js";
+import { Agent, isEmptyChunk, } from "../agents/agent.js";
 import { isTransferAgentOutput, transferAgentOutputKey, } from "../agents/types.js";
 import { UserAgent } from "../agents/user-agent.js";
 import { createMessage } from "../prompt/prompt-builder.js";
 import { promiseWithResolvers } from "../utils/promise.js";
 import { agentResponseStreamToObject, asyncGeneratorToReadableStream, onAgentResponseStreamEnd, } from "../utils/stream-utils.js";
-import { checkArguments, isNil, omitBy, } from "../utils/type-utils.js";
+import { checkArguments, isEmpty, isNil, omitBy, } from "../utils/type-utils.js";
 import { MessageQueue, toMessagePayload, } from "./message-queue.js";
 import { newEmptyContextUsage } from "./usage.js";
 /**
@@ -47,6 +48,12 @@ export class AIGNEContext {
     set userContext(userContext) {
         this.internal.userContext = userContext;
     }
+    get memories() {
+        return this.internal.memories;
+    }
+    set memories(memories) {
+        this.internal.memories = memories;
+    }
     newContext({ reset } = {}) {
         if (reset)
             return new AIGNEContext(this, { userContext: {} });
@@ -58,8 +65,14 @@ export class AIGNEContext {
             message,
             options,
         });
-        if (options?.userContext)
+        if (options?.userContext) {
             Object.assign(this.userContext, options.userContext);
+            options.userContext = undefined;
+        }
+        if (options?.memories?.length) {
+            this.memories.push(...options.memories);
+            options.memories = undefined;
+        }
         if (isNil(message)) {
             return UserAgent.from({
                 context: this,
@@ -100,8 +113,14 @@ export class AIGNEContext {
         });
     });
     publish = ((topic, payload, options) => {
-        if (options?.userContext)
+        if (options?.userContext) {
             Object.assign(this.userContext, options.userContext);
+            options.userContext = undefined;
+        }
+        if (options?.memories?.length) {
+            this.memories.push(...options.memories);
+            options.memories = undefined;
+        }
         return this.internal.messageQueue.publish(topic, {
             ...toMessagePayload(payload),
             context: this,
@@ -142,6 +161,7 @@ class AIGNEContextShared {
         this.parent = parent;
         this.messageQueue = this.parent?.messageQueue ?? new MessageQueue();
         this.userContext = overrides?.userContext ?? {};
+        this.memories = overrides?.memories ?? [];
     }
     messageQueue;
     // biome-ignore lint/suspicious/noExplicitAny: <explanation>
@@ -157,6 +177,7 @@ class AIGNEContextShared {
     }
     usage = newEmptyContextUsage();
     userContext;
+    memories;
     abortController = new AbortController();
     timer;
     initTimeout() {
@@ -178,7 +199,6 @@ class AIGNEContextShared {
     }
     async *invokeAgent(agent, input, context, options) {
         let activeAgent = agent;
-        let output;
         for (;;) {
             const result = {};
             if (options?.sourceAgent && activeAgent !== options.sourceAgent) {
@@ -191,12 +211,14 @@ class AIGNEContextShared {
             }
             const stream = await activeAgent.invoke(input, { ...options, context, streaming: true });
             for await (const value of stream) {
-                if (value.delta.text) {
-                    yield { delta: { text: value.delta.text } };
-                }
                 if (value.delta.json) {
+                    value.delta.json = omitExistsProperties(result, value.delta.json);
                     Object.assign(result, value.delta.json);
                 }
+                delete value.delta.json?.[transferAgentOutputKey];
+                if (isEmptyChunk(value))
+                    continue;
+                yield value;
             }
             if (!options?.disableTransfer) {
                 const transferToAgent = isTransferAgentOutput(result)
@@ -207,21 +229,22 @@ class AIGNEContextShared {
                     continue;
                 }
             }
-            output = result;
             break;
         }
-        if (!output)
-            throw new Error("Unexpected empty output");
         yield {
             delta: {
-                json: {
-                    ...output,
-                    __activeAgent__: activeAgent,
-                },
+                json: { __activeAgent__: activeAgent },
             },
         };
     }
 }
+function omitExistsProperties(result, { ...delta }) {
+    for (const [key, val] of Object.entries(delta)) {
+        if (equal(result[key], val))
+            delete delta[key];
+    }
+    return isEmpty(delta) ? undefined : delta;
+}
 async function* withAbortSignal(signal, error, fn) {
     const iterator = fn();
     const timeoutPromise = promiseWithResolvers();

package/lib/esm/prompt/prompt-builder.d.ts

@@ -15,7 +15,7 @@ export declare function getMessage(input: Message): string | undefined;
 export interface PromptBuilderOptions {
     instructions?: string | ChatMessagesTemplate;
 }
-export interface PromptBuildOptions extends AgentInvokeOptions {
+export interface PromptBuildOptions extends Pick<AgentInvokeOptions, "context"> {
     agent?: AIAgent;
     input?: Message;
     model?: ChatModel;

package/lib/esm/prompt/prompt-builder.js

@@ -82,8 +82,8 @@ export class PromptBuilder {
         if (options.agent) {
             memories.push(...(await options.agent.retrieveMemories({ search: options.input }, options)));
         }
-        if (options.memories?.length) {
-            memories.push(...options.memories);
+        if (options.context.memories?.length) {
+            memories.push(...options.context.memories);
         }
         if (memories.length)
             messages.push(...this.convertMemoriesToMessages(memories, options));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.18.3",
+  "version": "1.18.5",
   "description": "AIGNE core library for building AI-powered applications",
   "publishConfig": {
     "access": "public"