@aigne/agent-library 1.3.1 → 1.4.0

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 - chore: release 1.2.0
 
+## [1.4.0](https://github.com/AIGNE-io/aigne-framework/compare/agent-library-v1.3.2...agent-library-v1.4.0) (2025-04-08)
+
+
+### Features
+
+* add `serve` command for @aigne/cli ([#54](https://github.com/AIGNE-io/aigne-framework/issues/54)) ([1cca843](https://github.com/AIGNE-io/aigne-framework/commit/1cca843f1760abe832b6651108fa858130f47355))
+* add agent library support ([#51](https://github.com/AIGNE-io/aigne-framework/issues/51)) ([1f0d34d](https://github.com/AIGNE-io/aigne-framework/commit/1f0d34ddda3154283a4bc958ddb9b68b4ac106b0))
+* support token/call/time limits for ExecutionEngine ([#44](https://github.com/AIGNE-io/aigne-framework/issues/44)) ([5a2ca0a](https://github.com/AIGNE-io/aigne-framework/commit/5a2ca0a033267dd4765f574b53dca71e932e53d4))
+
+## [1.3.2](https://github.com/AIGNE-io/aigne-framework/compare/agent-library-v1.3.1...agent-library-v1.3.2) (2025-03-27)
+
+
+### Bug Fixes
+
+* **dx:** export models/utils in submodules ([#43](https://github.com/AIGNE-io/aigne-framework/issues/43)) ([bd561b3](https://github.com/AIGNE-io/aigne-framework/commit/bd561b397de816f04c2d63d58538e81fba82fc7f))
+
 ## [1.3.1](https://github.com/AIGNE-io/aigne-framework/compare/agent-library-v1.3.0...agent-library-v1.3.1) (2025-03-26)
 
 

package/lib/cjs/index.d.ts

@@ -1 +1 @@
-export * from "./orchestrator/index.js";
+export {};

package/lib/cjs/index.js

@@ -1,17 +1,2 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./orchestrator/index.js"), exports);

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

@@ -19,7 +19,7 @@ export declare class OrchestratorAgent<I extends Message = Message, O extends Me
     private completer;
     maxIterations?: number;
     tasksConcurrency?: number;
-    process(input: I, context?: Context): Promise<O>;
+    process(input: I, context: Context): Promise<O>;
     private getFullPlanInput;
     private getFullPlan;
     private synthesizePlanResult;

package/lib/cjs/orchestrator/index.js

@@ -19,7 +19,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OrchestratorAgent = void 0;
 const core_1 = require("@aigne/core");
+const type_utils_js_1 = require("@aigne/core/utils/type-utils.js");
 const fastq_1 = __importDefault(require("fastq"));
+const zod_1 = require("zod");
 const orchestrator_prompts_js_1 = require("./orchestrator-prompts.js");
 const DEFAULT_MAX_ITERATIONS = 30;
 const DEFAULT_TASK_CONCURRENCY = 5;
@@ -29,6 +31,7 @@ class OrchestratorAgent extends core_1.Agent {
         return new OrchestratorAgent(options);
     }
     constructor(options) {
+        (0, type_utils_js_1.checkArguments)("OrchestratorAgent", orchestratorAgentOptionsSchema, options);
         super({ ...options });
         this.maxIterations = options.maxIterations;
         this.tasksConcurrency = options.tasksConcurrency;
@@ -48,7 +51,7 @@ class OrchestratorAgent extends core_1.Agent {
     maxIterations;
     tasksConcurrency;
     async process(input, context) {
-        const model = context?.model;
+        const { model } = context;
         if (!model)
             throw new Error("model is required to run OrchestratorAgent");
         const objective = (0, core_1.getMessage)(input);
@@ -99,7 +102,7 @@ class OrchestratorAgent extends core_1.Agent {
     }
     async executeStep(planResult, step, context) {
         const concurrency = this.tasksConcurrency ?? DEFAULT_TASK_CONCURRENCY;
-        const model = context?.model;
+        const { model } = context;
         if (!model)
             throw new Error("model is required to run OrchestratorAgent");
         const queue = fastq_1.default.promise(async (task) => {
@@ -156,3 +159,7 @@ function getMessageOrJsonString(output) {
     }
     return JSON.stringify(output);
 }
+const orchestratorAgentOptionsSchema = zod_1.z.object({
+    maxIterations: zod_1.z.number().optional(),
+    tasksConcurrency: zod_1.z.number().optional(),
+});

package/lib/cjs/orchestrator/orchestrator-prompts.d.ts

@@ -1,4 +1,4 @@
-import { type Agent, type Message } from "@aigne/core";
+import type { Agent, Message } from "@aigne/core";
 import { z } from "zod";
 export declare const SYNTHESIZE_PLAN_USER_PROMPT_TEMPLATE = "Synthesize the results of executing all steps in the plan into a cohesive result\n";
 export declare function getFullPlanSchema(agents: Agent[]): z.ZodObject<{

package/lib/cjs/orchestrator/orchestrator-prompts.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SYNTHESIZE_STEP_PROMPT_TEMPLATE = exports.TASK_PROMPT_TEMPLATE = exports.FULL_PLAN_PROMPT_TEMPLATE = exports.SYNTHESIZE_PLAN_USER_PROMPT_TEMPLATE = void 0;
 exports.getFullPlanSchema = getFullPlanSchema;
-const core_1 = require("@aigne/core");
-const lodash_es_1 = require("lodash-es");
+const json_schema_js_1 = require("@aigne/core/utils/json-schema.js");
+const type_utils_js_1 = require("@aigne/core/utils/type-utils.js");
 const zod_1 = require("zod");
 exports.SYNTHESIZE_PLAN_USER_PROMPT_TEMPLATE = `\
 Synthesize the results of executing all steps in the plan into a cohesive result
@@ -11,13 +11,13 @@ Synthesize the results of executing all steps in the plan into a cohesive result
 function getFullPlanSchema(agents) {
     const agentNames = agents.map((i) => i.name);
     if (new Set(agentNames).size !== agentNames.length) {
-        const duplicates = (0, lodash_es_1.pickBy)((0, lodash_es_1.groupBy)(agentNames), (x) => x.length > 1);
-        throw new Error(`Tools name must be unique for orchestrator: ${Object.keys(duplicates).join(",")}`);
+        const dup = (0, type_utils_js_1.duplicates)(agentNames);
+        throw new Error(`Duplicate agent names found in orchestrator: ${dup.join(",")}`);
     }
     const TaskSchema = zod_1.z.object({
         description: zod_1.z.string().describe("Detailed description of the task"),
         agent: zod_1.z
-            .union((0, core_1.ensureZodUnionArray)(agents.map((i) => zod_1.z.literal(i.name))))
+            .union((0, json_schema_js_1.ensureZodUnionArray)(agents.map((i) => zod_1.z.literal(i.name))))
             .describe("Name of the agent to execute the task"),
     });
     const StepSchema = zod_1.z.object({

package/lib/dts/index.d.ts

@@ -1 +1 @@
-export * from "./orchestrator/index.js";
+export {};

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

@@ -19,7 +19,7 @@ export declare class OrchestratorAgent<I extends Message = Message, O extends Me
     private completer;
     maxIterations?: number;
     tasksConcurrency?: number;
-    process(input: I, context?: Context): Promise<O>;
+    process(input: I, context: Context): Promise<O>;
     private getFullPlanInput;
     private getFullPlan;
     private synthesizePlanResult;

package/lib/dts/orchestrator/orchestrator-prompts.d.ts

@@ -1,4 +1,4 @@
-import { type Agent, type Message } from "@aigne/core";
+import type { Agent, Message } from "@aigne/core";
 import { z } from "zod";
 export declare const SYNTHESIZE_PLAN_USER_PROMPT_TEMPLATE = "Synthesize the results of executing all steps in the plan into a cohesive result\n";
 export declare function getFullPlanSchema(agents: Agent[]): z.ZodObject<{

package/lib/esm/index.d.ts

@@ -1 +1 @@
-export * from "./orchestrator/index.js";
+export {};

package/lib/esm/index.js

@@ -1 +1 @@
-export * from "./orchestrator/index.js";
+export {};

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

@@ -19,7 +19,7 @@ export declare class OrchestratorAgent<I extends Message = Message, O extends Me
     private completer;
     maxIterations?: number;
     tasksConcurrency?: number;
-    process(input: I, context?: Context): Promise<O>;
+    process(input: I, context: Context): Promise<O>;
     private getFullPlanInput;
     private getFullPlan;
     private synthesizePlanResult;

package/lib/esm/orchestrator/index.js

@@ -1,5 +1,7 @@
 import { AIAgent, Agent, PromptTemplate, createMessage, getMessage, } from "@aigne/core";
+import { checkArguments } from "@aigne/core/utils/type-utils.js";
 import fastq from "fastq";
+import { z } from "zod";
 import { FULL_PLAN_PROMPT_TEMPLATE, SYNTHESIZE_PLAN_USER_PROMPT_TEMPLATE, SYNTHESIZE_STEP_PROMPT_TEMPLATE, TASK_PROMPT_TEMPLATE, getFullPlanSchema, } from "./orchestrator-prompts.js";
 const DEFAULT_MAX_ITERATIONS = 30;
 const DEFAULT_TASK_CONCURRENCY = 5;
@@ -9,6 +11,7 @@ export class OrchestratorAgent extends Agent {
         return new OrchestratorAgent(options);
     }
     constructor(options) {
+        checkArguments("OrchestratorAgent", orchestratorAgentOptionsSchema, options);
         super({ ...options });
         this.maxIterations = options.maxIterations;
         this.tasksConcurrency = options.tasksConcurrency;
@@ -28,7 +31,7 @@ export class OrchestratorAgent extends Agent {
     maxIterations;
     tasksConcurrency;
     async process(input, context) {
-        const model = context?.model;
+        const { model } = context;
         if (!model)
             throw new Error("model is required to run OrchestratorAgent");
         const objective = getMessage(input);
@@ -79,7 +82,7 @@ export class OrchestratorAgent extends Agent {
     }
     async executeStep(planResult, step, context) {
         const concurrency = this.tasksConcurrency ?? DEFAULT_TASK_CONCURRENCY;
-        const model = context?.model;
+        const { model } = context;
         if (!model)
             throw new Error("model is required to run OrchestratorAgent");
         const queue = fastq.promise(async (task) => {
@@ -135,3 +138,7 @@ function getMessageOrJsonString(output) {
     }
     return JSON.stringify(output);
 }
+const orchestratorAgentOptionsSchema = z.object({
+    maxIterations: z.number().optional(),
+    tasksConcurrency: z.number().optional(),
+});

package/lib/esm/orchestrator/orchestrator-prompts.d.ts

@@ -1,4 +1,4 @@
-import { type Agent, type Message } from "@aigne/core";
+import type { Agent, Message } from "@aigne/core";
 import { z } from "zod";
 export declare const SYNTHESIZE_PLAN_USER_PROMPT_TEMPLATE = "Synthesize the results of executing all steps in the plan into a cohesive result\n";
 export declare function getFullPlanSchema(agents: Agent[]): z.ZodObject<{

package/lib/esm/orchestrator/orchestrator-prompts.js

@@ -1,5 +1,5 @@
-import { ensureZodUnionArray } from "@aigne/core";
-import { groupBy, pickBy } from "lodash-es";
+import { ensureZodUnionArray } from "@aigne/core/utils/json-schema.js";
+import { duplicates } from "@aigne/core/utils/type-utils.js";
 import { z } from "zod";
 export const SYNTHESIZE_PLAN_USER_PROMPT_TEMPLATE = `\
 Synthesize the results of executing all steps in the plan into a cohesive result
@@ -7,8 +7,8 @@ Synthesize the results of executing all steps in the plan into a cohesive result
 export function getFullPlanSchema(agents) {
     const agentNames = agents.map((i) => i.name);
     if (new Set(agentNames).size !== agentNames.length) {
-        const duplicates = pickBy(groupBy(agentNames), (x) => x.length > 1);
-        throw new Error(`Tools name must be unique for orchestrator: ${Object.keys(duplicates).join(",")}`);
+        const dup = duplicates(agentNames);
+        throw new Error(`Duplicate agent names found in orchestrator: ${dup.join(",")}`);
     }
     const TaskSchema = z.object({
         description: z.string().describe("Detailed description of the task"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/agent-library",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "Collection of agent libraries for AIGNE framework",
   "publishConfig": {
     "access": "public"
@@ -25,20 +25,26 @@
   "module": "./lib/esm/index.js",
   "types": "./lib/dts/index.d.ts",
   "exports": {
-    ".": {
-      "import": "./lib/esm/index.js",
-      "require": "./lib/cjs/index.js",
-      "types": "./lib/dts/index.d.ts"
+    "./*": {
+      "import": "./lib/esm/*",
+      "require": "./lib/cjs/*",
+      "types": "./lib/dts/*"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "./lib/dts/*"
+      ]
     }
   },
   "dependencies": {
     "fastq": "^1.19.1",
-    "lodash-es": "^4.17.21",
     "zod": "^3.24.2",
-    "@aigne/core": "^1.4.0"
+    "@aigne/core": "^1.6.0"
   },
   "devDependencies": {
-    "@types/bun": "^1.2.5",
+    "@types/bun": "^1.2.8",
     "npm-run-all": "^4.1.5",
     "rimraf": "^6.0.1",
     "typescript": "^5.8.2"
@@ -46,9 +52,9 @@
   "scripts": {
     "lint": "tsc --noEmit",
     "build": "tsc --build scripts/tsconfig.build.json",
-    "clean": "rimraf lib coverage",
-    "test": "bun test",
-    "test:coverage": "bun test --coverage --coverage-reporter=lcov --coverage-reporter=text",
+    "clean": "rimraf lib test/coverage",
+    "test": "bun --cwd test test",
+    "test:coverage": "bun --cwd test test --coverage --coverage-reporter=lcov --coverage-reporter=text",
     "postbuild": "echo '{\"type\": \"module\"}' > lib/esm/package.json && echo '{\"type\": \"commonjs\"}' > lib/cjs/package.json"
   }
 }