@aigne/core 1.16.0 → 1.17.0

package/CHANGELOG.md

@@ -22,6 +22,13 @@
 * rename @aigne/core-next to @aigne/core ([3a81009](https://github.com/AIGNE-io/aigne-framework/commit/3a8100962c81813217b687ae28e8de604419c622))
 * use text resource from MCP correctly ([8b9eba8](https://github.com/AIGNE-io/aigne-framework/commit/8b9eba83352ec096a2a5d4f410d4c4bde7420bce))
 
+## [1.17.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.16.0...core-v1.17.0) (2025-05-25)
+
+
+### Features
+
+* 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.16.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.15.0...core-v1.16.0) (2025-05-23)
 
 

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

@@ -1,6 +1,6 @@
 import { inspect } from "node:util";
 import { ZodObject, type ZodType } from "zod";
-import type { Context } from "../aigne/context.js";
+import type { Context, UserContext } from "../aigne/context.js";
 import type { MessagePayload } from "../aigne/message-queue.js";
 import type { MemoryAgent } from "../memory/memory.js";
 import { type Nullish, type PromiseOrValue, type XOr } from "../utils/type-utils.js";
@@ -99,7 +99,21 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
 export declare const agentOptionsSchema: ZodObject<{
     [key in keyof AgentOptions]: ZodType<AgentOptions[key]>;
 }>;
-export interface AgentInvokeOptions {
+export interface AgentInvokeOptions<U extends UserContext = UserContext> {
+    /**
+     * The execution context for the agent
+     *
+     * The context provides the runtime environment for agent execution, including:
+     * - Event emission and subscription management
+     * - Inter-agent communication and message passing
+     * - Resource usage tracking and limits enforcement
+     * - Timeout and status management
+     * - Memory and state management across agent invocations
+     *
+     * Each agent invocation requires a context to coordinate with the broader
+     * agent system and maintain proper isolation and resource control.
+     */
+    context: Context<U>;
     /**
      * Whether to enable streaming response
      *
@@ -278,7 +292,7 @@ export declare abstract class Agent<I extends Message = Message, O extends Messa
     /**
      * Check context status to ensure it hasn't timed out
      *
-     * @param context The context to check
+     * @param options Invocation options containing context
      * @throws Error if the context has timed out
      */
     private checkContextStatus;
@@ -290,7 +304,6 @@ export declare abstract class Agent<I extends Message = Message, O extends Messa
      * suitable for scenarios where a complete result is needed at once.
      *
      * @param input Input message to the agent, can be a string or structured object
-     * @param context Execution context, providing environment and resource access
      * @param options Invocation options, must set streaming to false or leave unset
      * @returns Final JSON response
      *
@@ -298,7 +311,7 @@ export declare abstract class Agent<I extends Message = Message, O extends Messa
      * Here's an example of invoking an agent with regular mode:
      * {@includeCode ../../test/agents/agent.test.ts#example-invoke}
      */
-    invoke(input: I | string, context?: Context, options?: AgentInvokeOptions & {
+    invoke(input: I | string, options?: Partial<AgentInvokeOptions> & {
         streaming?: false;
     }): Promise<O>;
     /**
@@ -309,7 +322,6 @@ export declare abstract class Agent<I extends Message = Message, O extends Messa
      * chat bot typing effects.
      *
      * @param input Input message to the agent, can be a string or structured object
-     * @param context Execution context, providing environment and resource access
      * @param options Invocation options, must set streaming to true for this overload
      * @returns Streaming response object
      *
@@ -317,7 +329,7 @@ export declare abstract class Agent<I extends Message = Message, O extends Messa
      * Here's an example of invoking an agent with streaming response:
      * {@includeCode ../../test/agents/agent.test.ts#example-invoke-streaming}
      */
-    invoke(input: I | string, context: Context | undefined, options: {
+    invoke(input: I | string, options: Partial<AgentInvokeOptions> & {
         streaming: true;
     }): Promise<AgentResponseStream<O>>;
     /**
@@ -326,12 +338,11 @@ export declare abstract class Agent<I extends Message = Message, O extends Messa
      * Returns either streaming or regular response based on the streaming parameter in options
      *
      * @param input Input message to the agent
-     * @param context Execution context
      * @param options Invocation options
      * @returns Agent response (streaming or regular)
      */
-    invoke(input: I | string, context?: Context, options?: AgentInvokeOptions): Promise<AgentResponse<O>>;
-    protected invokeSkill<I extends Message, O extends Message>(skill: Agent<I, O>, input: I, context: Context): Promise<O>;
+    invoke(input: I | string, options?: Partial<AgentInvokeOptions>): Promise<AgentResponse<O>>;
+    protected invokeSkill<I extends Message, O extends Message>(skill: Agent<I, O>, input: I, options: AgentInvokeOptions): Promise<O>;
     /**
      * Process agent output
      *
@@ -339,7 +350,7 @@ export declare abstract class Agent<I extends Message = Message, O extends Messa
      *
      * @param input Original input message
      * @param output Raw output produced by the agent
-     * @param context Execution context
+     * @param options Invocation options
      * @returns Final processed output
      */
     private processAgentOutput;
@@ -349,7 +360,7 @@ export declare abstract class Agent<I extends Message = Message, O extends Messa
      * Logs error information, triggers failure events, and re-throws the error
      *
      * @param error Caught error
-     * @param context Execution context
+     * @param options Invocation options
      */
     private processAgentError;
     /**
@@ -358,10 +369,10 @@ export declare abstract class Agent<I extends Message = Message, O extends Messa
      * If the context has a maximum invocation limit set, checks if the limit
      * has been exceeded and increments the invocation counter
      *
-     * @param context Execution context
+     * @param options Invocation options containing context and limits
      * @throws Error if maximum invocation limit is exceeded
      */
-    protected checkAgentInvokesUsage(context: Context): void;
+    protected checkAgentInvokesUsage(options: AgentInvokeOptions): void;
     /**
      * Pre-processing operations before handling input
      *
@@ -370,9 +381,9 @@ export declare abstract class Agent<I extends Message = Message, O extends Messa
      * - Verifying invocation limits
      *
      * @param _ Input message (unused)
-     * @param context Execution context
+     * @param options Options for agent invocation
      */
-    protected preprocess(_: I, context: Context): PromiseOrValue<void>;
+    protected preprocess(_: I, options: AgentInvokeOptions): Promise<void>;
     private checkResponseByGuideRails;
     private runGuideRails;
     /**
@@ -400,10 +411,10 @@ export declare abstract class Agent<I extends Message = Message, O extends Messa
      *
      * @param input Input message
      * @param output Output message
-     * @param context Execution context
+     * @param options Options for agent invocation
      */
-    protected postprocess(input: I, output: O, context: Context): PromiseOrValue<void>;
-    protected publishToTopics(output: Message, context: Context): Promise<void>;
+    protected postprocess(input: I, output: O, options: AgentInvokeOptions): Promise<void>;
+    protected publishToTopics(output: Message, options: AgentInvokeOptions): Promise<void>;
     /**
      * Core processing method of the agent, must be implemented in subclasses
      *
@@ -415,7 +426,7 @@ export declare abstract class Agent<I extends Message = Message, O extends Messa
      * - Another agent instance (transfer agent)
      *
      * @param input Input message
-     * @param context Execution context
+     * @param options Options for agent invocation
      * @returns Processing result
      *
      * @example
@@ -434,7 +445,7 @@ export declare abstract class Agent<I extends Message = Message, O extends Messa
      * Example of transfer to another agent:
      * {@includeCode ../../test/agents/agent.test.ts#example-process-transfer}
      */
-    abstract process(input: I, context: Context): PromiseOrValue<AgentProcessResult<O>>;
+    abstract process(input: I, options: AgentInvokeOptions): PromiseOrValue<AgentProcessResult<O>>;
     /**
      * Shut down the agent and clean up resources
      *
@@ -484,6 +495,7 @@ export interface AgentHooks<I extends Message = Message, O extends Message = Mes
      * @param event Object containing the input message
      */
     onStart?: (event: {
+        context: Context;
         input: I;
     }) => PromiseOrValue<void>;
     /**
@@ -496,6 +508,7 @@ export interface AgentHooks<I extends Message = Message, O extends Message = Mes
      * @param event Object containing the input message and either output or error
      */
     onEnd?: (event: XOr<{
+        context: Context;
         input: I;
         output: O;
         error: Error;
@@ -509,6 +522,7 @@ export interface AgentHooks<I extends Message = Message, O extends Message = Mes
      * @param event Object containing the skill being used and input message
      */
     onSkillStart?: (event: {
+        context: Context;
         skill: Agent;
         input: I;
     }) => PromiseOrValue<void>;
@@ -522,6 +536,7 @@ export interface AgentHooks<I extends Message = Message, O extends Message = Mes
      * @param event Object containing the skill used, input message, and either output or error
      */
     onSkillEnd?: (event: XOr<{
+        context: Context;
         skill: Agent;
         input: I;
         output: O;
@@ -537,6 +552,7 @@ export interface AgentHooks<I extends Message = Message, O extends Message = Mes
      * @param event Object containing the source agent, target agent, and input message
      */
     onHandoff?: (event: {
+        context: Context;
         source: Agent;
         target: Agent;
         input: I;
@@ -587,7 +603,7 @@ export interface AgentResponseDelta<T> {
         }> | Partial<{
             [key: string]: string;
         }>;
-        json?: Partial<T | TransferAgentOutput>;
+        json?: Partial<T> | TransferAgentOutput;
     };
 }
 /**
@@ -619,7 +635,7 @@ export declare function jsonDelta<T extends Message>(jsonDelta: NonNullable<Agen
  *
  * @template O Agent output message type
  */
-export type AgentProcessAsyncGenerator<O extends Message> = AsyncGenerator<AgentResponseChunk<O>, Partial<O | TransferAgentOutput> | undefined | void>;
+export type AgentProcessAsyncGenerator<O extends Message> = AsyncGenerator<AgentResponseChunk<O>, Partial<O> | TransferAgentOutput | undefined | void>;
 /**
  * Result type for agent processing method, can be:
  * - Direct or streaming response
@@ -709,10 +725,10 @@ export declare class FunctionAgent<I extends Message = Message, O extends Messag
      * Process input implementation, calls the configured processing function
      *
      * @param input Input message
-     * @param context Execution context
+     * @param options Invocation options
      * @returns Processing result
      */
-    process(input: I, context: Context): PromiseOrValue<AgentProcessResult<O>>;
+    process(input: I, options: AgentInvokeOptions): PromiseOrValue<AgentProcessResult<O>>;
 }
 /**
  * Function type for function agents
@@ -725,4 +741,4 @@ export declare class FunctionAgent<I extends Message = Message, O extends Messag
  * @param context Execution context
  * @returns Processing result, can be synchronous or asynchronous
  */
-export type FunctionAgentFn<I extends Message = any, O extends Message = any> = (input: I, context: Context) => PromiseOrValue<AgentProcessResult<O>>;
+export type FunctionAgentFn<I extends Message = any, O extends Message = any> = (input: I, options: AgentInvokeOptions) => PromiseOrValue<AgentProcessResult<O>>;

package/lib/cjs/agents/agent.js

@@ -292,68 +292,70 @@ class Agent {
     /**
      * Check context status to ensure it hasn't timed out
      *
-     * @param context The context to check
+     * @param options Invocation options containing context
      * @throws Error if the context has timed out
      */
-    checkContextStatus(context) {
-        if (context) {
-            const { status } = context;
-            if (status === "timeout") {
-                throw new Error(`AIGNE for agent ${this.name} has timed out`);
-            }
+    checkContextStatus(options) {
+        const { status } = options.context;
+        if (status === "timeout") {
+            throw new Error(`AIGNE for agent ${this.name} has timed out`);
         }
     }
     async newDefaultContext() {
         return Promise.resolve().then(() => __importStar(require("../aigne/context.js"))).then((m) => new m.AIGNEContext());
     }
-    async invoke(input, context, options) {
-        const ctx = context ?? (await this.newDefaultContext());
+    async invoke(input, options = {}) {
+        const opts = {
+            ...options,
+            context: options.context ?? (await this.newDefaultContext()),
+        };
         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);
         if (!this.disableEvents)
-            ctx.emit("agentStarted", { agent: this, input: message });
+            opts.context.emit("agentStarted", { agent: this, input: message });
         try {
-            await this.hooks.onStart?.({ input: message });
+            await this.hooks.onStart?.({ context: opts.context, input: message });
             const parsedInput = (0, type_utils_js_1.checkArguments)(`Agent ${this.name} input`, this.inputSchema, message);
-            await this.preprocess(parsedInput, ctx);
-            this.checkContextStatus(ctx);
-            let response = await this.process(parsedInput, ctx);
+            await this.preprocess(parsedInput, opts);
+            this.checkContextStatus(opts);
+            let response = await this.process(parsedInput, opts);
             if (response instanceof Agent) {
                 response = (0, types_js_1.transferToAgentOutput)(response);
             }
-            if (options?.streaming) {
+            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(message, (0, stream_utils_js_1.onAgentResponseStreamEnd)(stream, async (result) => {
-                    return await this.processAgentOutput(parsedInput, result, ctx);
+                    return await this.processAgentOutput(parsedInput, result, opts);
                 }, {
                     errorCallback: async (error) => {
-                        return await this.processAgentError(message, error, ctx);
+                        return await this.processAgentError(message, error, opts);
                     },
-                }), ctx);
+                }), opts);
             }
             return await this.checkResponseByGuideRails(message, this.processAgentOutput(parsedInput, response instanceof ReadableStream
                 ? await (0, stream_utils_js_1.agentResponseStreamToObject)(response)
                 : (0, stream_utils_js_1.isAsyncGenerator)(response)
                     ? await (0, stream_utils_js_1.agentResponseStreamToObject)(response)
-                    : response, ctx), ctx);
+                    : response, opts), opts);
         }
         catch (error) {
-            throw await this.processAgentError(message, error, ctx);
+            throw await this.processAgentError(message, error, opts);
         }
     }
-    async invokeSkill(skill, input, context) {
-        await this.hooks.onSkillStart?.({ skill, input });
+    async invokeSkill(skill, input, options) {
+        const { context } = options;
+        await this.hooks.onSkillStart?.({ context, skill, input });
         try {
             const output = await context.invoke(skill, input);
-            await this.hooks.onSkillEnd?.({ skill, input, output });
+            await this.hooks.onSkillEnd?.({ context, skill, input, output });
             return output;
         }
         catch (error) {
-            await this.hooks.onSkillEnd?.({ skill, input, error });
+            await this.hooks.onSkillEnd?.({ context, skill, input, error });
             throw error;
         }
     }
@@ -364,17 +366,18 @@ class Agent {
      *
      * @param input Original input message
      * @param output Raw output produced by the agent
-     * @param context Execution context
+     * @param options Invocation options
      * @returns Final processed output
      */
-    async processAgentOutput(input, output, context) {
+    async processAgentOutput(input, output, options) {
+        const { context } = options;
         const parsedOutput = (0, type_utils_js_1.checkArguments)(`Agent ${this.name} output`, this.outputSchema, output);
         const finalOutput = this.includeInputInOutput ? { ...input, ...parsedOutput } : parsedOutput;
-        await this.postprocess(input, finalOutput, context);
+        await this.postprocess(input, finalOutput, options);
         logger_js_1.logger.debug("Invoke agent %s succeed with output: %O", this.name, finalOutput);
         if (!this.disableEvents)
             context.emit("agentSucceed", { agent: this, output: finalOutput });
-        await this.hooks.onEnd?.({ input, output: finalOutput });
+        await this.hooks.onEnd?.({ context, input, output: finalOutput });
         return finalOutput;
     }
     /**
@@ -383,13 +386,14 @@ class Agent {
      * Logs error information, triggers failure events, and re-throws the error
      *
      * @param error Caught error
-     * @param context Execution context
+     * @param options Invocation options
      */
-    async processAgentError(input, error, context) {
+    async processAgentError(input, error, options) {
         logger_js_1.logger.error("Invoke agent %s failed with error: %O", this.name, error);
         if (!this.disableEvents)
-            context.emit("agentFailed", { agent: this, error });
-        await this.hooks.onEnd?.({ input, error });
+            options.context.emit("agentFailed", { agent: this, error });
+        const { context } = options;
+        await this.hooks.onEnd?.({ context, input, error });
         return error;
     }
     /**
@@ -398,11 +402,11 @@ class Agent {
      * If the context has a maximum invocation limit set, checks if the limit
      * has been exceeded and increments the invocation counter
      *
-     * @param context Execution context
+     * @param options Invocation options containing context and limits
      * @throws Error if maximum invocation limit is exceeded
      */
-    checkAgentInvokesUsage(context) {
-        const { limits, usage } = context;
+    checkAgentInvokesUsage(options) {
+        const { limits, usage } = options.context;
         if (limits?.maxAgentInvokes && usage.agentCalls >= limits.maxAgentInvokes) {
             throw new Error(`Exceeded max agent invokes ${usage.agentCalls}/${limits.maxAgentInvokes}`);
         }
@@ -416,19 +420,19 @@ class Agent {
      * - Verifying invocation limits
      *
      * @param _ Input message (unused)
-     * @param context Execution context
+     * @param options Options for agent invocation
      */
-    preprocess(_, context) {
-        this.checkContextStatus(context);
-        this.checkAgentInvokesUsage(context);
+    async preprocess(_, options) {
+        this.checkContextStatus(options);
+        this.checkAgentInvokesUsage(options);
     }
-    async checkResponseByGuideRails(input, output, context) {
+    async checkResponseByGuideRails(input, output, options) {
         if (!this.guideRails?.length)
             return output;
         const result = await output;
         if (result instanceof ReadableStream) {
             return (0, stream_utils_js_1.onAgentResponseStreamEnd)(result, async (result) => {
-                const error = await this.runGuideRails(input, result, context);
+                const error = await this.runGuideRails(input, result, options);
                 if (error) {
                     return {
                         ...(await this.onGuideRailError(error)),
@@ -437,13 +441,13 @@ class Agent {
                 }
             });
         }
-        const error = await this.runGuideRails(input, result, context);
+        const error = await this.runGuideRails(input, result, options);
         if (!error)
             return output;
         return { ...(await this.onGuideRailError(error)), $status: "GuideRailError" };
     }
-    async runGuideRails(input, output, context) {
-        const result = await Promise.all((this.guideRails ?? []).map((i) => context.invoke(i, { input, output })));
+    async runGuideRails(input, output, options) {
+        const result = await Promise.all((this.guideRails ?? []).map((i) => options.context.invoke(i, { input, output })));
         return result.find((i) => !!i.abort);
     }
     /**
@@ -473,26 +477,26 @@ class Agent {
      *
      * @param input Input message
      * @param output Output message
-     * @param context Execution context
+     * @param options Options for agent invocation
      */
-    postprocess(input, output, context) {
-        this.checkContextStatus(context);
-        this.publishToTopics(output, context);
+    async postprocess(input, output, options) {
+        this.checkContextStatus(options);
+        this.publishToTopics(output, options);
         for (const memory of this.memories) {
             if (memory.autoUpdate) {
-                memory.record({
+                await memory.record({
                     content: [
                         { role: "user", content: input },
                         { role: "agent", content: (0, types_js_1.replaceTransferAgentToName)(output), source: this.name },
                     ],
-                }, context);
+                }, options.context);
             }
         }
     }
-    async publishToTopics(output, context) {
+    async publishToTopics(output, options) {
         const publishTopics = typeof this.publishTopic === "function" ? await this.publishTopic(output) : this.publishTopic;
         if (publishTopics?.length) {
-            context.publish(publishTopics, {
+            options.context.publish(publishTopics, {
                 role: this.constructor.name === "UserAgent" ? "user" : "agent",
                 source: this.name,
                 message: output,
@@ -645,11 +649,11 @@ class FunctionAgent extends Agent {
      * Process input implementation, calls the configured processing function
      *
      * @param input Input message
-     * @param context Execution context
+     * @param options Invocation options
      * @returns Processing result
      */
-    process(input, context) {
-        return this._process(input, context);
+    process(input, options) {
+        return this._process(input, options);
     }
 }
 exports.FunctionAgent = FunctionAgent;

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

@@ -1,8 +1,7 @@
 import { type ZodObject, type ZodType, z } from "zod";
-import type { Context } from "../aigne/context.js";
-import { type DefaultMemoryOptions } from "../memory/default-memory.js";
+import { type DefaultMemoryOptions } from "../memory/default-memory/index.js";
 import { PromptBuilder } from "../prompt/prompt-builder.js";
-import { Agent, type AgentOptions, type AgentProcessAsyncGenerator, type Message } from "./agent.js";
+import { Agent, type AgentInvokeOptions, type AgentOptions, type AgentProcessAsyncGenerator, type Message } from "./agent.js";
 import { ChatModel, type ChatModelInput } from "./chat-model.js";
 import type { GuideRailAgentOutput } from "./guide-rail-agent.js";
 /**
@@ -215,7 +214,7 @@ export declare class AIAgent<I extends Message = Message, O extends Message = Me
      *
      * @protected
      */
-    process(input: I, context: Context): AgentProcessAsyncGenerator<O>;
+    process(input: I, options: AgentInvokeOptions): AgentProcessAsyncGenerator<O>;
     protected onGuideRailError(error: GuideRailAgentOutput): Promise<O | GuideRailAgentOutput>;
     /**
      * Process router mode requests
@@ -225,5 +224,5 @@ export declare class AIAgent<I extends Message = Message, O extends Message = Me
      *
      * @protected
      */
-    _processRouter(input: I, model: ChatModel, modelInput: ChatModelInput, context: Context, toolsMap: Map<string, Agent>): AgentProcessAsyncGenerator<O>;
+    _processRouter(input: I, model: ChatModel, modelInput: ChatModelInput, options: AgentInvokeOptions, toolsMap: Map<string, Agent>): AgentProcessAsyncGenerator<O>;
 }

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

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AIAgent = exports.aiAgentOptionsSchema = exports.aiAgentToolChoiceSchema = exports.AIAgentToolChoice = void 0;
 const zod_1 = require("zod");
-const default_memory_js_1 = require("../memory/default-memory.js");
+const index_js_1 = require("../memory/default-memory/index.js");
 const memory_js_1 = require("../memory/memory.js");
 const prompt_builder_js_1 = require("../prompt/prompt-builder.js");
 const template_js_1 = require("../prompt/template.js");
@@ -107,7 +107,7 @@ class AIAgent extends agent_js_1.Agent {
                 ? undefined
                 : Array.isArray(options.memory) || options.memory instanceof memory_js_1.MemoryAgent
                     ? options.memory
-                    : new default_memory_js_1.DefaultMemory(options.memory === true ? {} : options.memory),
+                    : new index_js_1.DefaultMemory(options.memory === true ? {} : options.memory),
         });
         (0, type_utils_js_1.checkArguments)("AIAgent", exports.aiAgentOptionsSchema, options);
         this.model = options.model;
@@ -188,26 +188,26 @@ class AIAgent extends agent_js_1.Agent {
      *
      * @protected
      */
-    async *process(input, context) {
-        const model = this.model ?? context.model;
+    async *process(input, options) {
+        const model = this.model ?? options.context.model;
         if (!model)
             throw new Error("model is required to run AIAgent");
         const { toolAgents, ...modelInput } = await this.instructions.build({
             agent: this,
             input,
             model,
-            context,
+            context: options.context,
         });
         const toolsMap = new Map(toolAgents?.map((i) => [i.name, i]));
         if (this.toolChoice === "router") {
-            yield* this._processRouter(input, model, modelInput, context, toolsMap);
+            yield* this._processRouter(input, model, modelInput, options, toolsMap);
             return;
         }
         const toolCallMessages = [];
         const outputKey = this.outputKey || prompt_builder_js_1.MESSAGE_KEY;
         for (;;) {
             const modelOutput = {};
-            const stream = await context.invoke(model, { ...modelInput, messages: modelInput.messages.concat(toolCallMessages) }, { streaming: true });
+            const stream = await options.context.invoke(model, { ...modelInput, messages: modelInput.messages.concat(toolCallMessages) }, { streaming: true });
             for await (const value of stream) {
                 if (value.delta.text?.text) {
                     yield { delta: { text: { [outputKey]: value.delta.text.text } } };
@@ -225,7 +225,7 @@ class AIAgent extends agent_js_1.Agent {
                     if (!tool)
                         throw new Error(`Tool not found: ${call.function.name}`);
                     // NOTE: should pass both arguments (model generated) and input (user provided) to the tool
-                    const output = await this.invokeSkill(tool, { ...input, ...call.function.arguments }, context).catch((error) => {
+                    const output = await this.invokeSkill(tool, { ...input, ...call.function.arguments }, options).catch((error) => {
                         if (!this.catchToolsError) {
                             return Promise.reject(error);
                         }
@@ -275,15 +275,15 @@ class AIAgent extends agent_js_1.Agent {
      *
      * @protected
      */
-    async *_processRouter(input, model, modelInput, context, toolsMap) {
-        const { toolCalls: [call] = [], } = await context.invoke(model, modelInput);
+    async *_processRouter(input, model, modelInput, options, toolsMap) {
+        const { toolCalls: [call] = [], } = await options.context.invoke(model, modelInput);
         if (!call) {
             throw new Error("Router toolChoice requires exactly one tool to be executed");
         }
         const tool = toolsMap.get(call.function.name);
         if (!tool)
             throw new Error(`Tool not found: ${call.function.name}`);
-        const stream = await context.invoke(tool, { ...call.function.arguments, ...input }, { streaming: true, sourceAgent: this });
+        const stream = await options.context.invoke(tool, { ...call.function.arguments, ...input }, { streaming: true, sourceAgent: this });
         yield* stream;
     }
 }

package/lib/cjs/agents/chat-model.d.ts

@@ -1,6 +1,5 @@
-import type { Context } from "../aigne/context.js";
 import type { PromiseOrValue } from "../utils/type-utils.js";
-import { Agent, type AgentProcessResult, type Message } from "./agent.js";
+import { Agent, type AgentInvokeOptions, type AgentProcessResult, type Message } from "./agent.js";
 /**
  * ChatModel is an abstract base class for interacting with Large Language Models (LLMs).
  *
@@ -61,10 +60,10 @@ export declare abstract class ChatModel extends Agent<ChatModelInput, ChatModelO
      * Primarily checks if token usage exceeds limits, throwing an exception if limits are exceeded
      *
      * @param input Input message
-     * @param context Execution context
+     * @param options Options for invoking the agent
      * @throws Error if token usage exceeds maximum limit
      */
-    protected preprocess(input: ChatModelInput, context: Context): Promise<void>;
+    protected preprocess(input: ChatModelInput, options: AgentInvokeOptions): Promise<void>;
     /**
      * Performs postprocessing operations after handling output
      *
@@ -72,9 +71,9 @@ export declare abstract class ChatModel extends Agent<ChatModelInput, ChatModelO
      *
      * @param input Input message
      * @param output Output message
-     * @param context Execution context
+     * @param options Options for invoking the agent
      */
-    protected postprocess(input: ChatModelInput, output: ChatModelOutput, context: Context): void;
+    protected postprocess(input: ChatModelInput, output: ChatModelOutput, options: AgentInvokeOptions): Promise<void>;
     /**
      * Processes input messages and generates model responses
      *
@@ -92,10 +91,10 @@ export declare abstract class ChatModel extends Agent<ChatModelInput, ChatModelO
      * - Tool call processing if applicable
      *
      * @param input - The standardized input containing messages and model options
-     * @param context - The execution context with settings and state
+     * @param options - The options for invoking the agent, including context and limits
      * @returns A promise or direct value containing the model's response
      */
-    abstract process(input: ChatModelInput, context: Context): PromiseOrValue<AgentProcessResult<ChatModelOutput>>;
+    abstract process(input: ChatModelInput, options: AgentInvokeOptions): PromiseOrValue<AgentProcessResult<ChatModelOutput>>;
 }
 /**
  * Input message format for ChatModel