@aigne/core 1.18.4 → 1.18.5

package/CHANGELOG.md

@@ -5,6 +5,13 @@
 
 * 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)
 
 

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

@@ -54,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: {} });
@@ -65,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,
@@ -107,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,
@@ -150,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>
@@ -165,6 +184,7 @@ class AIGNEContextShared {
     }
     usage = (0, usage_js_1.newEmptyContextUsage)();
     userContext;
+    memories;
     abortController = new AbortController();
     timer;
     initTimeout() {

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

@@ -48,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: {} });
@@ -59,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,
@@ -101,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,
@@ -143,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>
@@ -158,6 +177,7 @@ class AIGNEContextShared {
     }
     usage = newEmptyContextUsage();
     userContext;
+    memories;
     abortController = new AbortController();
     timer;
     initTimeout() {

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.4",
+  "version": "1.18.5",
   "description": "AIGNE core library for building AI-powered applications",
   "publishConfig": {
     "access": "public"