@aigne/agent-library 1.8.1 → 1.10.0

package/CHANGELOG.md

@@ -2,6 +2,34 @@
 
 - chore: release 1.2.0
 
+## [1.10.0](https://github.com/AIGNE-io/aigne-framework/compare/agent-library-v1.9.0...agent-library-v1.10.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))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.17.0
+
+## [1.9.0](https://github.com/AIGNE-io/aigne-framework/compare/agent-library-v1.8.1...agent-library-v1.9.0) (2025-05-23)
+
+
+### Features
+
+* **models:** publish model adapters as standalone packages ([#126](https://github.com/AIGNE-io/aigne-framework/issues/126)) ([588b8ae](https://github.com/AIGNE-io/aigne-framework/commit/588b8aea6abcee5fa87def1358bf51f84021c6ef))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.16.0
+
 ## [1.8.1](https://github.com/AIGNE-io/aigne-framework/compare/agent-library-v1.8.0...agent-library-v1.8.1) (2025-05-15)
 
 

package/README.md

@@ -16,11 +16,11 @@ Collection of agent libraries for [AIGNE Framework](https://github.com/AIGNE-io/
 
 ## Features
 
-- **Orchestrator Agent**: Provides OrchestratorAgent implementation for coordinating workflows between multiple agents
-- **Task Concurrency**: Supports parallel execution of multiple tasks to improve processing efficiency
-- **Planning & Execution**: Automatically generates execution plans and executes them step by step
-- **Result Synthesis**: Intelligently synthesizes results from multiple steps and tasks
-- **TypeScript Support**: Complete type definitions providing an excellent development experience
+* **Orchestrator Agent**: Provides OrchestratorAgent implementation for coordinating workflows between multiple agents
+* **Task Concurrency**: Supports parallel execution of multiple tasks to improve processing efficiency
+* **Planning & Execution**: Automatically generates execution plans and executes them step by step
+* **Result Synthesis**: Intelligently synthesizes results from multiple steps and tasks
+* **TypeScript Support**: Complete type definitions providing an excellent development experience
 
 ## Installation
 
@@ -61,12 +61,16 @@ const aigne = new AIGNE({ model });
 // Create orchestrator agent
 const orchestrator = new OrchestratorAgent({
   name: "MainOrchestrator",
-  instructions: "You are a task orchestrator responsible for coordinating multiple specialized agents to complete complex tasks.",
+  instructions:
+    "You are a task orchestrator responsible for coordinating multiple specialized agents to complete complex tasks.",
   // Configure sub-agents and tools...
 });
 
 // Execute orchestration task
-const result = await aigne.invoke(orchestrator, "Analyze this article and generate a summary and keywords");
+const result = await aigne.invoke(
+  orchestrator,
+  "Analyze this article and generate a summary and keywords",
+);
 console.log(result);
 ```
 
@@ -74,7 +78,7 @@ console.log(result);
 
 The library currently provides one specialized agent implementation:
 
-- **Orchestrator Agent (OrchestratorAgent)**: Responsible for coordinating work between multiple agents and managing complex workflows. It can automatically plan task steps, distribute and execute tasks across multiple agents, and finally synthesize the results.
+* **Orchestrator Agent (OrchestratorAgent)**: Responsible for coordinating work between multiple agents and managing complex workflows. It can automatically plan task steps, distribute and execute tasks across multiple agents, and finally synthesize the results.
 
 ## Advanced Usage
 
@@ -93,36 +97,43 @@ const model = new OpenAIChatModel({
 // Create specialized sub-agents
 const researchAgent = AIAgent.from({
   name: "Researcher",
-  instructions: "You are a professional researcher responsible for collecting and analyzing information.",
+  instructions:
+    "You are a professional researcher responsible for collecting and analyzing information.",
   outputKey: "research",
 });
 
 const writerAgent = AIAgent.from({
   name: "Writer",
-  instructions: "You are a professional writer responsible for creating high-quality content.",
+  instructions:
+    "You are a professional writer responsible for creating high-quality content.",
   outputKey: "content",
 });
 
 const editorAgent = AIAgent.from({
   name: "Editor",
-  instructions: "You are a strict editor responsible for checking content quality and formatting.",
+  instructions:
+    "You are a strict editor responsible for checking content quality and formatting.",
   outputKey: "edited",
 });
 
 // Create orchestrator agent
 const orchestrator = new OrchestratorAgent({
   name: "WorkflowOrchestrator",
-  instructions: "You are responsible for coordinating research, writing, and editing processes.",
+  instructions:
+    "You are responsible for coordinating research, writing, and editing processes.",
   skills: [researchAgent, writerAgent, editorAgent],
   // Optional configuration
-  maxIterations: 30,      // Maximum number of iterations
-  tasksConcurrency: 5,    // Task concurrency
+  maxIterations: 30, // Maximum number of iterations
+  tasksConcurrency: 5, // Task concurrency
 });
 
 // Use the orchestrator agent
 const aigne = new AIGNE({ model });
 
-const result = await aigne.invoke(orchestrator, "Applications of artificial intelligence in healthcare");
+const result = await aigne.invoke(
+  orchestrator,
+  "Applications of artificial intelligence in healthcare",
+);
 
 console.log(result);
 ```

package/README.zh.md

@@ -16,11 +16,11 @@
 
 ## 特性
 
-- **编排代理**：提供 OrchestratorAgent 实现，用于协调多个代理之间的工作流
-- **任务并发**：支持并行执行多个任务，提高处理效率
-- **计划与执行**：自动生成执行计划并逐步执行
-- **结果合成**：智能合成多个步骤和任务的结果
-- **TypeScript 支持**：完整的类型定义，提供优秀的开发体验
+* **编排代理**：提供 OrchestratorAgent 实现，用于协调多个代理之间的工作流
+* **任务并发**：支持并行执行多个任务，提高处理效率
+* **计划与执行**：自动生成执行计划并逐步执行
+* **结果合成**：智能合成多个步骤和任务的结果
+* **TypeScript 支持**：完整的类型定义，提供优秀的开发体验
 
 ## 安装
 
@@ -66,7 +66,10 @@ const orchestrator = new OrchestratorAgent({
 });
 
 // 执行编排任务
-const result = await aigne.invoke(orchestrator, "分析这篇文章并生成摘要和关键词");
+const result = await aigne.invoke(
+  orchestrator,
+  "分析这篇文章并生成摘要和关键词",
+);
 
 console.log(result);
 ```
@@ -75,7 +78,7 @@ console.log(result);
 
 该库目前提供了一种专业化的代理实现：
 
-- **编排代理（OrchestratorAgent）**：负责协调多个代理之间的工作，管理复杂工作流。它能够自动规划任务步骤，并在多个代理之间分配和执行任务，最后合成结果。
+* **编排代理（OrchestratorAgent）**：负责协调多个代理之间的工作，管理复杂工作流。它能够自动规划任务步骤，并在多个代理之间分配和执行任务，最后合成结果。
 
 ## 高级用法
 
@@ -116,8 +119,8 @@ const orchestrator = new OrchestratorAgent({
   instructions: "你负责协调研究、写作和编辑流程。",
   skills: [researchAgent, writerAgent, editorAgent],
   // 可选配置
-  maxIterations: 30,      // 最大迭代次数
-  tasksConcurrency: 5,    // 任务并发数
+  maxIterations: 30, // 最大迭代次数
+  tasksConcurrency: 5, // 任务并发数
 });
 
 // 使用编排代理

package/lib/cjs/fs-memory/index.js

@@ -64,11 +64,11 @@ class FSMemoryRetriever extends index_js_1.MemoryRetriever {
         });
     }
     agent;
-    async process(input, context) {
+    async process(input, options) {
         if (!(await (0, fs_js_1.exists)(this.options.memoryFileName)))
             return { memories: [] };
         const allMemory = await (0, promises_1.readFile)(this.options.memoryFileName, "utf-8");
-        const { memories } = await context.invoke(this.agent, { ...input, allMemory });
+        const { memories } = await options.context.invoke(this.agent, { ...input, allMemory });
         const result = memories.map((memory) => ({
             id: (0, index_js_1.newMemoryId)(),
             content: memory.content,
@@ -97,11 +97,11 @@ class FSMemoryRecorder extends index_js_1.MemoryRecorder {
         });
     }
     agent;
-    async process(input, context) {
+    async process(input, options) {
         const allMemory = (await (0, fs_js_1.exists)(this.options.memoryFileName))
             ? await (0, promises_1.readFile)(this.options.memoryFileName, "utf-8")
             : "";
-        const { memories } = await context.invoke(this.agent, { ...input, allMemory });
+        const { memories } = await options.context.invoke(this.agent, { ...input, allMemory });
         const raw = (0, yaml_1.stringify)(memories.map((i) => ({
             content: i.content,
         })));

package/lib/cjs/orchestrator/index.d.ts

@@ -1,4 +1,4 @@
-import { Agent, type AgentOptions, type Context, type Message } from "@aigne/core";
+import { Agent, type AgentInvokeOptions, type AgentOptions, type Message } from "@aigne/core";
 import { type FullPlanOutput, type StepWithResult } from "./orchestrator-prompts.js";
 /**
  * Re-export orchestrator prompt templates and related types
@@ -95,10 +95,10 @@ export declare class OrchestratorAgent<I extends Message = Message, O extends Me
      *    c. Otherwise, execute steps in the plan
      *
      * @param input - Input message containing the objective
-     * @param context - Execution context with model and other necessary info
+     * @param options - Agent invocation options
      * @returns Processing result
      */
-    process(input: I, context: Context): Promise<O>;
+    process(input: I, options: AgentInvokeOptions): Promise<O>;
     private getFullPlanInput;
     private getFullPlan;
     private synthesizePlanResult;

package/lib/cjs/orchestrator/index.js

@@ -102,11 +102,11 @@ class OrchestratorAgent extends core_1.Agent {
      *    c. Otherwise, execute steps in the plan
      *
      * @param input - Input message containing the objective
-     * @param context - Execution context with model and other necessary info
+     * @param options - Agent invocation options
      * @returns Processing result
      */
-    async process(input, context) {
-        const { model } = context;
+    async process(input, options) {
+        const { model } = options.context;
         if (!model)
             throw new Error("model is required to run OrchestratorAgent");
         const objective = (0, core_1.getMessage)(input);
@@ -119,13 +119,13 @@ class OrchestratorAgent extends core_1.Agent {
         let iterations = 0;
         const maxIterations = this.maxIterations ?? DEFAULT_MAX_ITERATIONS;
         while (iterations++ < maxIterations) {
-            const plan = await this.getFullPlan(result, context);
+            const plan = await this.getFullPlan(result, options.context);
             result.plan = plan;
             if (plan.isComplete) {
-                return this.synthesizePlanResult(result, context);
+                return this.synthesizePlanResult(result, options.context);
             }
             for (const step of plan.steps) {
-                const stepResult = await this.executeStep(result, step, context);
+                const stepResult = await this.executeStep(result, step, options.context);
                 result.steps.push(stepResult);
             }
         }

package/lib/dts/orchestrator/index.d.ts

@@ -1,4 +1,4 @@
-import { Agent, type AgentOptions, type Context, type Message } from "@aigne/core";
+import { Agent, type AgentInvokeOptions, type AgentOptions, type Message } from "@aigne/core";
 import { type FullPlanOutput, type StepWithResult } from "./orchestrator-prompts.js";
 /**
  * Re-export orchestrator prompt templates and related types
@@ -95,10 +95,10 @@ export declare class OrchestratorAgent<I extends Message = Message, O extends Me
      *    c. Otherwise, execute steps in the plan
      *
      * @param input - Input message containing the objective
-     * @param context - Execution context with model and other necessary info
+     * @param options - Agent invocation options
      * @returns Processing result
      */
-    process(input: I, context: Context): Promise<O>;
+    process(input: I, options: AgentInvokeOptions): Promise<O>;
     private getFullPlanInput;
     private getFullPlan;
     private synthesizePlanResult;

package/lib/esm/fs-memory/index.js

@@ -60,11 +60,11 @@ class FSMemoryRetriever extends MemoryRetriever {
         });
     }
     agent;
-    async process(input, context) {
+    async process(input, options) {
         if (!(await exists(this.options.memoryFileName)))
             return { memories: [] };
         const allMemory = await readFile(this.options.memoryFileName, "utf-8");
-        const { memories } = await context.invoke(this.agent, { ...input, allMemory });
+        const { memories } = await options.context.invoke(this.agent, { ...input, allMemory });
         const result = memories.map((memory) => ({
             id: newMemoryId(),
             content: memory.content,
@@ -93,11 +93,11 @@ class FSMemoryRecorder extends MemoryRecorder {
         });
     }
     agent;
-    async process(input, context) {
+    async process(input, options) {
         const allMemory = (await exists(this.options.memoryFileName))
             ? await readFile(this.options.memoryFileName, "utf-8")
             : "";
-        const { memories } = await context.invoke(this.agent, { ...input, allMemory });
+        const { memories } = await options.context.invoke(this.agent, { ...input, allMemory });
         const raw = stringify(memories.map((i) => ({
             content: i.content,
         })));

package/lib/esm/orchestrator/index.d.ts

@@ -1,4 +1,4 @@
-import { Agent, type AgentOptions, type Context, type Message } from "@aigne/core";
+import { Agent, type AgentInvokeOptions, type AgentOptions, type Message } from "@aigne/core";
 import { type FullPlanOutput, type StepWithResult } from "./orchestrator-prompts.js";
 /**
  * Re-export orchestrator prompt templates and related types
@@ -95,10 +95,10 @@ export declare class OrchestratorAgent<I extends Message = Message, O extends Me
      *    c. Otherwise, execute steps in the plan
      *
      * @param input - Input message containing the objective
-     * @param context - Execution context with model and other necessary info
+     * @param options - Agent invocation options
      * @returns Processing result
      */
-    process(input: I, context: Context): Promise<O>;
+    process(input: I, options: AgentInvokeOptions): Promise<O>;
     private getFullPlanInput;
     private getFullPlan;
     private synthesizePlanResult;

package/lib/esm/orchestrator/index.js

@@ -82,11 +82,11 @@ export class OrchestratorAgent extends Agent {
      *    c. Otherwise, execute steps in the plan
      *
      * @param input - Input message containing the objective
-     * @param context - Execution context with model and other necessary info
+     * @param options - Agent invocation options
      * @returns Processing result
      */
-    async process(input, context) {
-        const { model } = context;
+    async process(input, options) {
+        const { model } = options.context;
         if (!model)
             throw new Error("model is required to run OrchestratorAgent");
         const objective = getMessage(input);
@@ -99,13 +99,13 @@ export class OrchestratorAgent extends Agent {
         let iterations = 0;
         const maxIterations = this.maxIterations ?? DEFAULT_MAX_ITERATIONS;
         while (iterations++ < maxIterations) {
-            const plan = await this.getFullPlan(result, context);
+            const plan = await this.getFullPlan(result, options.context);
             result.plan = plan;
             if (plan.isComplete) {
-                return this.synthesizePlanResult(result, context);
+                return this.synthesizePlanResult(result, options.context);
             }
             for (const step of plan.steps) {
-                const stepResult = await this.executeStep(result, step, context);
+                const stepResult = await this.executeStep(result, step, options.context);
                 result.steps.push(stepResult);
             }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/agent-library",
-  "version": "1.8.1",
+  "version": "1.10.0",
   "description": "Collection of agent libraries for AIGNE framework",
   "publishConfig": {
     "access": "public"
@@ -42,7 +42,7 @@
     "fastq": "^1.19.1",
     "yaml": "^2.7.1",
     "zod": "^3.24.4",
-    "@aigne/core": "^1.15.0"
+    "@aigne/core": "^1.17.0"
   },
   "devDependencies": {
     "@types/bun": "^1.2.12",