@aigne/core 1.18.4 → 1.18.6

package/CHANGELOG.md

@@ -5,6 +5,21 @@
 
 * 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.6](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.18.5...core-v1.18.6) (2025-06-11)
+
+
+### Bug Fixes
+
+* **core:** add async generator polyfill for ReadableStream on safari ([#158](https://github.com/AIGNE-io/aigne-framework/issues/158)) ([70ef026](https://github.com/AIGNE-io/aigne-framework/commit/70ef026f413726c369f6a0781efc7f0333735406))
+* **core:** exclude nested skills from final tool list in invokable skill ([#156](https://github.com/AIGNE-io/aigne-framework/issues/156)) ([91645f1](https://github.com/AIGNE-io/aigne-framework/commit/91645f12e79110a00f8f2db8ebc19401ddbd5a80))
+
+## [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/index.d.ts

@@ -10,3 +10,4 @@ export * from "./aigne/index.js";
 export * from "./memory/index.js";
 export * from "./prompt/prompt-builder.js";
 export * from "./prompt/template.js";
+export * from "./utils/stream-utils.js";

package/lib/cjs/index.js

@@ -26,3 +26,4 @@ __exportStar(require("./aigne/index.js"), exports);
 __exportStar(require("./memory/index.js"), exports);
 __exportStar(require("./prompt/prompt-builder.js"), exports);
 __exportStar(require("./prompt/template.js"), exports);
+__exportStar(require("./utils/stream-utils.js"), exports);

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));
@@ -128,8 +128,7 @@ class PromptBuilder {
         const toolAgents = (0, type_utils_js_1.unique)((options.context?.skills ?? [])
             .concat(options.agent?.skills ?? [])
             .concat(options.agent?.memoryAgentsAsTools ? options.agent.memories : [])
-            // TODO: support nested tools?
-            .flatMap((i) => (i.isInvokable ? i.skills.concat(i) : i.skills)), (i) => i.name);
+            .flatMap((i) => (i.isInvokable ? i : i.skills)), (i) => i.name);
         const tools = toolAgents.map((i) => ({
             type: "function",
             function: {

package/lib/cjs/utils/stream-polyfill.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+ReadableStream.prototype.values ??= function ({ preventCancel = false } = {}) {
+    const reader = this.getReader();
+    return {
+        async next() {
+            try {
+                const result = await reader.read();
+                if (result.done) {
+                    reader.releaseLock();
+                }
+                return result;
+            }
+            catch (e) {
+                reader.releaseLock();
+                throw e;
+            }
+        },
+        async return(value) {
+            if (!preventCancel) {
+                const cancelPromise = reader.cancel(value);
+                reader.releaseLock();
+                await cancelPromise;
+            }
+            else {
+                reader.releaseLock();
+            }
+            return { done: true, value };
+        },
+        [Symbol.asyncIterator]() {
+            return this;
+        },
+        async [Symbol.asyncDispose]() {
+            reader.releaseLock();
+        },
+    };
+};
+ReadableStream.prototype[Symbol.asyncIterator] ??= ReadableStream.prototype.values;

package/lib/cjs/utils/stream-utils.d.ts

@@ -1,6 +1,7 @@
 import { type AgentProcessAsyncGenerator, type AgentResponseChunk, type AgentResponseStream, type Message } from "../agents/agent.js";
 import type { MESSAGE_KEY } from "../prompt/prompt-builder.js";
 import { type PromiseOrValue } from "./type-utils.js";
+import "./stream-polyfill.js";
 export declare function objectToAgentResponseStream<T extends Message>(json: T): AgentResponseStream<T>;
 export declare function mergeAgentResponseChunk<T extends Message>(output: T, chunk: AgentResponseChunk<T>): T;
 export declare function agentResponseStreamToObject<T extends Message>(stream: AgentResponseStream<T> | AgentProcessAsyncGenerator<T>): Promise<T>;

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

@@ -18,6 +18,7 @@ exports.readAllString = readAllString;
 const fast_deep_equal_1 = __importDefault(require("fast-deep-equal"));
 const agent_js_1 = require("../agents/agent.js");
 const type_utils_js_1 = require("./type-utils.js");
+require("./stream-polyfill.js");
 function objectToAgentResponseStream(json) {
     return new ReadableStream({
         pull(controller) {

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/index.d.ts

@@ -10,3 +10,4 @@ export * from "./aigne/index.js";
 export * from "./memory/index.js";
 export * from "./prompt/prompt-builder.js";
 export * from "./prompt/template.js";
+export * from "./utils/stream-utils.js";

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/dts/utils/stream-polyfill.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/dts/utils/stream-utils.d.ts

@@ -1,6 +1,7 @@
 import { type AgentProcessAsyncGenerator, type AgentResponseChunk, type AgentResponseStream, type Message } from "../agents/agent.js";
 import type { MESSAGE_KEY } from "../prompt/prompt-builder.js";
 import { type PromiseOrValue } from "./type-utils.js";
+import "./stream-polyfill.js";
 export declare function objectToAgentResponseStream<T extends Message>(json: T): AgentResponseStream<T>;
 export declare function mergeAgentResponseChunk<T extends Message>(output: T, chunk: AgentResponseChunk<T>): T;
 export declare function agentResponseStreamToObject<T extends Message>(stream: AgentResponseStream<T> | AgentProcessAsyncGenerator<T>): Promise<T>;

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/index.d.ts

@@ -10,3 +10,4 @@ export * from "./aigne/index.js";
 export * from "./memory/index.js";
 export * from "./prompt/prompt-builder.js";
 export * from "./prompt/template.js";
+export * from "./utils/stream-utils.js";

package/lib/esm/index.js

@@ -10,3 +10,4 @@ export * from "./aigne/index.js";
 export * from "./memory/index.js";
 export * from "./prompt/prompt-builder.js";
 export * from "./prompt/template.js";
+export * from "./utils/stream-utils.js";

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));
@@ -123,8 +123,7 @@ export class PromptBuilder {
         const toolAgents = unique((options.context?.skills ?? [])
             .concat(options.agent?.skills ?? [])
             .concat(options.agent?.memoryAgentsAsTools ? options.agent.memories : [])
-            // TODO: support nested tools?
-            .flatMap((i) => (i.isInvokable ? i.skills.concat(i) : i.skills)), (i) => i.name);
+            .flatMap((i) => (i.isInvokable ? i : i.skills)), (i) => i.name);
         const tools = toolAgents.map((i) => ({
             type: "function",
             function: {

package/lib/esm/utils/stream-polyfill.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,37 @@
+ReadableStream.prototype.values ??= function ({ preventCancel = false } = {}) {
+    const reader = this.getReader();
+    return {
+        async next() {
+            try {
+                const result = await reader.read();
+                if (result.done) {
+                    reader.releaseLock();
+                }
+                return result;
+            }
+            catch (e) {
+                reader.releaseLock();
+                throw e;
+            }
+        },
+        async return(value) {
+            if (!preventCancel) {
+                const cancelPromise = reader.cancel(value);
+                reader.releaseLock();
+                await cancelPromise;
+            }
+            else {
+                reader.releaseLock();
+            }
+            return { done: true, value };
+        },
+        [Symbol.asyncIterator]() {
+            return this;
+        },
+        async [Symbol.asyncDispose]() {
+            reader.releaseLock();
+        },
+    };
+};
+ReadableStream.prototype[Symbol.asyncIterator] ??= ReadableStream.prototype.values;
+export {};

package/lib/esm/utils/stream-utils.d.ts

@@ -1,6 +1,7 @@
 import { type AgentProcessAsyncGenerator, type AgentResponseChunk, type AgentResponseStream, type Message } from "../agents/agent.js";
 import type { MESSAGE_KEY } from "../prompt/prompt-builder.js";
 import { type PromiseOrValue } from "./type-utils.js";
+import "./stream-polyfill.js";
 export declare function objectToAgentResponseStream<T extends Message>(json: T): AgentResponseStream<T>;
 export declare function mergeAgentResponseChunk<T extends Message>(output: T, chunk: AgentResponseChunk<T>): T;
 export declare function agentResponseStreamToObject<T extends Message>(stream: AgentResponseStream<T> | AgentProcessAsyncGenerator<T>): Promise<T>;

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

@@ -1,6 +1,7 @@
 import equal from "fast-deep-equal";
 import { isEmptyChunk, } from "../agents/agent.js";
 import { omitBy } from "./type-utils.js";
+import "./stream-polyfill.js";
 export function objectToAgentResponseStream(json) {
     return new ReadableStream({
         pull(controller) {

package/package.json

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