@aigne/core 1.37.0 → 1.38.1

package/CHANGELOG.md

@@ -12,6 +12,28 @@
   * dependencies
     * @aigne/observability bumped to 0.1.0
 
+## [1.38.1](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.38.0...core-v1.38.1) (2025-07-24)
+
+
+### Bug Fixes
+
+* add missing dependencies ([#280](https://github.com/AIGNE-io/aigne-framework/issues/280)) ([5da315e](https://github.com/AIGNE-io/aigne-framework/commit/5da315e29dc02818293e74ad159294f137e2c7f7))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/observability-api bumped to 0.8.1
+
+## [1.38.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.37.0...core-v1.38.0) (2025-07-24)
+
+
+### Features
+
+* **cli:** support aigne hub connect and model use ([#267](https://github.com/AIGNE-io/aigne-framework/issues/267)) ([8e5a32a](https://github.com/AIGNE-io/aigne-framework/commit/8e5a32afc64593137153d7407bde13837312ac70))
+* **core:** support config reflection for TeamAgent in yaml file ([#276](https://github.com/AIGNE-io/aigne-framework/issues/276)) ([e6296a8](https://github.com/AIGNE-io/aigne-framework/commit/e6296a8aff313e8209c4fbb2878e7869cc672576))
+
 ## [1.37.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.36.0...core-v1.37.0) (2025-07-22)
 
 

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

@@ -45,19 +45,24 @@ export interface ReflectionMode {
      */
     reviewer: Agent;
     /**
-     * Function that determines whether the reviewer's output indicates approval.
+     * Function or field name that determines whether the reviewer's output indicates approval.
      *
-     * This function receives the reviewer agent's output message and should return:
-     * - `true` or truthy value: The output is approved and processing should stop
-     * - `false` or falsy value: The output needs improvement and another iteration should run
+     * This can be either:
+     * - A function that receives the reviewer agent's output message and should return:
+     *   - `true` or truthy value: The output is approved and processing should stop
+     *   - `false` or falsy value: The output needs improvement and another iteration should run
+     * - A string representing a field name in the reviewer's output message to check for approval
      *
-     * The function can be synchronous or asynchronous, allowing for complex approval logic
+     * When using a function, it can be synchronous or asynchronous, allowing for complex approval logic
      * including external validation, scoring systems, or human-in-the-loop approval.
      *
-     * @param output - The message output from the reviewer agent
-     * @returns A boolean or truthy/falsy value indicating approval status
+     * When using a string, the specified field in the reviewer's output will be evaluated for truthiness
+     * to determine approval status.
+     *
+     * @param output - The message output from the reviewer agent (when using function form)
+     * @returns A boolean or truthy/falsy value indicating approval status (when using function form)
      */
-    isApproved: (output: Message) => PromiseOrValue<boolean | unknown>;
+    isApproved: ((output: Message) => PromiseOrValue<boolean | unknown>) | string;
     /**
      * Maximum number of reflection iterations before giving up.
      *

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

@@ -151,7 +151,8 @@ class TeamAgent extends agent_js_1.Agent {
             Object.assign(previousOutput, output);
             const reviewOutput = await options.context.invoke(this.reflection.reviewer, previousOutput);
             Object.assign(previousOutput, reviewOutput);
-            const approved = await this.reflection.isApproved(reviewOutput);
+            const { isApproved } = this.reflection;
+            const approved = typeof isApproved === "string" ? reviewOutput[isApproved] : await isApproved(reviewOutput);
             if (approved)
                 return output;
             if (++iterations >= this.reflection.maxIterations) {

package/lib/cjs/loader/agent-yaml.d.ts

@@ -1,7 +1,7 @@
 import { type ZodType } from "zod";
 import type { FunctionAgentFn } from "../agents/agent.js";
 import { AIAgentToolChoice } from "../agents/ai-agent.js";
-import { ProcessMode } from "../agents/team-agent.js";
+import { ProcessMode, type ReflectionMode } from "../agents/team-agent.js";
 export interface HooksSchema {
     onStart?: NestAgentSchema;
     onSuccess?: NestAgentSchema;
@@ -46,6 +46,9 @@ export interface TeamAgentSchema extends BaseAgentSchema {
     type: "team";
     mode?: ProcessMode;
     iterateOn?: string;
+    reflection?: Omit<ReflectionMode, "reviewer"> & {
+        reviewer: NestAgentSchema;
+    };
 }
 export interface TransformAgentSchema extends BaseAgentSchema {
     type: "transform";

package/lib/cjs/loader/agent-yaml.js

@@ -77,6 +77,12 @@ async function parseAgentFile(path, data) {
                 type: zod_1.z.literal("team"),
                 mode: (0, schema_js_1.optionalize)(zod_1.z.nativeEnum(team_agent_js_1.ProcessMode)),
                 iterateOn: (0, schema_js_1.optionalize)(zod_1.z.string()),
+                reflection: (0, schema_js_1.camelizeSchema)((0, schema_js_1.optionalize)(zod_1.z.object({
+                    reviewer: nestAgentSchema,
+                    isApproved: zod_1.z.string(),
+                    maxIterations: (0, schema_js_1.optionalize)(zod_1.z.number().int().min(1)),
+                    returnLastOnMaxIterations: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
+                }))),
             })
                 .extend(baseAgentSchema.shape),
             zod_1.z

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

@@ -12,9 +12,12 @@ interface LoadableModelClass {
 }
 export interface LoadableModel {
     name: string;
+    apiKeyEnvName?: string;
     create: (options: {
         model?: string;
         modelOptions?: ChatModelOptions;
+        accessKey?: string;
+        url?: string;
     }) => ChatModel;
 }
 export interface LoadOptions {
@@ -26,7 +29,10 @@ export interface LoadOptions {
 }
 export declare function load(options: LoadOptions): Promise<AIGNEOptions>;
 export declare function loadAgent(path: string, options?: LoadOptions, agentOptions?: AgentOptions): Promise<Agent>;
-export declare function loadModel(models: LoadableModel[], model?: Camelize<z.infer<typeof aigneFileSchema>["model"]>, modelOptions?: ChatModelOptions): Promise<ChatModel | undefined>;
+export declare function loadModel(models: LoadableModel[], model?: Camelize<z.infer<typeof aigneFileSchema>["model"]>, modelOptions?: ChatModelOptions, accessKeyOptions?: {
+    accessKey?: string;
+    url?: string;
+}): Promise<ChatModel | undefined>;
 declare const aigneFileSchema: z.ZodObject<{
     name: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
     description: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;

package/lib/cjs/loader/index.js

@@ -125,6 +125,12 @@ async function parseAgent(path, agent, options, agentOptions) {
         case "team": {
             return team_agent_js_1.TeamAgent.from({
                 ...baseOptions,
+                mode: agent.mode,
+                iterateOn: agent.iterateOn,
+                reflection: agent.reflection && {
+                    ...agent.reflection,
+                    reviewer: await loadNestAgent(path, agent.reflection.reviewer, options),
+                },
             });
         }
         case "transform": {
@@ -151,7 +157,7 @@ async function loadMemory(memories, provider, options) {
 }
 const { MODEL_PROVIDER, MODEL_NAME } = index_js_1.nodejs.env;
 const DEFAULT_MODEL_PROVIDER = "openai";
-async function loadModel(models, model, modelOptions) {
+async function loadModel(models, model, modelOptions, accessKeyOptions) {
     const params = {
         model: MODEL_NAME ?? model?.name ?? undefined,
         temperature: model?.temperature ?? undefined,
@@ -159,12 +165,13 @@ async function loadModel(models, model, modelOptions) {
         frequencyPenalty: model?.frequencyPenalty ?? undefined,
         presencePenalty: model?.presencePenalty ?? undefined,
     };
-    const m = models.find((m) => m.name
-        .toLowerCase()
-        .includes((MODEL_PROVIDER ?? model?.provider ?? DEFAULT_MODEL_PROVIDER).toLowerCase()));
+    const providerName = MODEL_PROVIDER ?? model?.provider ?? DEFAULT_MODEL_PROVIDER;
+    const provider = providerName.replace(/-/g, "");
+    const m = models.find((m) => m.name.toLowerCase().includes(provider.toLowerCase()));
     if (!m)
         throw new Error(`Unsupported model: ${model?.provider} ${model?.name}`);
     return m.create({
+        ...(accessKeyOptions || {}),
         model: params.model,
         modelOptions: { ...params, ...modelOptions },
     });

package/lib/dts/agents/team-agent.d.ts

@@ -45,19 +45,24 @@ export interface ReflectionMode {
      */
     reviewer: Agent;
     /**
-     * Function that determines whether the reviewer's output indicates approval.
+     * Function or field name that determines whether the reviewer's output indicates approval.
      *
-     * This function receives the reviewer agent's output message and should return:
-     * - `true` or truthy value: The output is approved and processing should stop
-     * - `false` or falsy value: The output needs improvement and another iteration should run
+     * This can be either:
+     * - A function that receives the reviewer agent's output message and should return:
+     *   - `true` or truthy value: The output is approved and processing should stop
+     *   - `false` or falsy value: The output needs improvement and another iteration should run
+     * - A string representing a field name in the reviewer's output message to check for approval
      *
-     * The function can be synchronous or asynchronous, allowing for complex approval logic
+     * When using a function, it can be synchronous or asynchronous, allowing for complex approval logic
      * including external validation, scoring systems, or human-in-the-loop approval.
      *
-     * @param output - The message output from the reviewer agent
-     * @returns A boolean or truthy/falsy value indicating approval status
+     * When using a string, the specified field in the reviewer's output will be evaluated for truthiness
+     * to determine approval status.
+     *
+     * @param output - The message output from the reviewer agent (when using function form)
+     * @returns A boolean or truthy/falsy value indicating approval status (when using function form)
      */
-    isApproved: (output: Message) => PromiseOrValue<boolean | unknown>;
+    isApproved: ((output: Message) => PromiseOrValue<boolean | unknown>) | string;
     /**
      * Maximum number of reflection iterations before giving up.
      *

package/lib/dts/loader/agent-yaml.d.ts

@@ -1,7 +1,7 @@
 import { type ZodType } from "zod";
 import type { FunctionAgentFn } from "../agents/agent.js";
 import { AIAgentToolChoice } from "../agents/ai-agent.js";
-import { ProcessMode } from "../agents/team-agent.js";
+import { ProcessMode, type ReflectionMode } from "../agents/team-agent.js";
 export interface HooksSchema {
     onStart?: NestAgentSchema;
     onSuccess?: NestAgentSchema;
@@ -46,6 +46,9 @@ export interface TeamAgentSchema extends BaseAgentSchema {
     type: "team";
     mode?: ProcessMode;
     iterateOn?: string;
+    reflection?: Omit<ReflectionMode, "reviewer"> & {
+        reviewer: NestAgentSchema;
+    };
 }
 export interface TransformAgentSchema extends BaseAgentSchema {
     type: "transform";

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

@@ -12,9 +12,12 @@ interface LoadableModelClass {
 }
 export interface LoadableModel {
     name: string;
+    apiKeyEnvName?: string;
     create: (options: {
         model?: string;
         modelOptions?: ChatModelOptions;
+        accessKey?: string;
+        url?: string;
     }) => ChatModel;
 }
 export interface LoadOptions {
@@ -26,7 +29,10 @@ export interface LoadOptions {
 }
 export declare function load(options: LoadOptions): Promise<AIGNEOptions>;
 export declare function loadAgent(path: string, options?: LoadOptions, agentOptions?: AgentOptions): Promise<Agent>;
-export declare function loadModel(models: LoadableModel[], model?: Camelize<z.infer<typeof aigneFileSchema>["model"]>, modelOptions?: ChatModelOptions): Promise<ChatModel | undefined>;
+export declare function loadModel(models: LoadableModel[], model?: Camelize<z.infer<typeof aigneFileSchema>["model"]>, modelOptions?: ChatModelOptions, accessKeyOptions?: {
+    accessKey?: string;
+    url?: string;
+}): Promise<ChatModel | undefined>;
 declare const aigneFileSchema: z.ZodObject<{
     name: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
     description: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;

package/lib/esm/agents/team-agent.d.ts

@@ -45,19 +45,24 @@ export interface ReflectionMode {
      */
     reviewer: Agent;
     /**
-     * Function that determines whether the reviewer's output indicates approval.
+     * Function or field name that determines whether the reviewer's output indicates approval.
      *
-     * This function receives the reviewer agent's output message and should return:
-     * - `true` or truthy value: The output is approved and processing should stop
-     * - `false` or falsy value: The output needs improvement and another iteration should run
+     * This can be either:
+     * - A function that receives the reviewer agent's output message and should return:
+     *   - `true` or truthy value: The output is approved and processing should stop
+     *   - `false` or falsy value: The output needs improvement and another iteration should run
+     * - A string representing a field name in the reviewer's output message to check for approval
      *
-     * The function can be synchronous or asynchronous, allowing for complex approval logic
+     * When using a function, it can be synchronous or asynchronous, allowing for complex approval logic
      * including external validation, scoring systems, or human-in-the-loop approval.
      *
-     * @param output - The message output from the reviewer agent
-     * @returns A boolean or truthy/falsy value indicating approval status
+     * When using a string, the specified field in the reviewer's output will be evaluated for truthiness
+     * to determine approval status.
+     *
+     * @param output - The message output from the reviewer agent (when using function form)
+     * @returns A boolean or truthy/falsy value indicating approval status (when using function form)
      */
-    isApproved: (output: Message) => PromiseOrValue<boolean | unknown>;
+    isApproved: ((output: Message) => PromiseOrValue<boolean | unknown>) | string;
     /**
      * Maximum number of reflection iterations before giving up.
      *

package/lib/esm/agents/team-agent.js

@@ -145,7 +145,8 @@ export class TeamAgent extends Agent {
             Object.assign(previousOutput, output);
             const reviewOutput = await options.context.invoke(this.reflection.reviewer, previousOutput);
             Object.assign(previousOutput, reviewOutput);
-            const approved = await this.reflection.isApproved(reviewOutput);
+            const { isApproved } = this.reflection;
+            const approved = typeof isApproved === "string" ? reviewOutput[isApproved] : await isApproved(reviewOutput);
             if (approved)
                 return output;
             if (++iterations >= this.reflection.maxIterations) {

package/lib/esm/loader/agent-yaml.d.ts

@@ -1,7 +1,7 @@
 import { type ZodType } from "zod";
 import type { FunctionAgentFn } from "../agents/agent.js";
 import { AIAgentToolChoice } from "../agents/ai-agent.js";
-import { ProcessMode } from "../agents/team-agent.js";
+import { ProcessMode, type ReflectionMode } from "../agents/team-agent.js";
 export interface HooksSchema {
     onStart?: NestAgentSchema;
     onSuccess?: NestAgentSchema;
@@ -46,6 +46,9 @@ export interface TeamAgentSchema extends BaseAgentSchema {
     type: "team";
     mode?: ProcessMode;
     iterateOn?: string;
+    reflection?: Omit<ReflectionMode, "reviewer"> & {
+        reviewer: NestAgentSchema;
+    };
 }
 export interface TransformAgentSchema extends BaseAgentSchema {
     type: "transform";

package/lib/esm/loader/agent-yaml.js

@@ -73,6 +73,12 @@ export async function parseAgentFile(path, data) {
                 type: z.literal("team"),
                 mode: optionalize(z.nativeEnum(ProcessMode)),
                 iterateOn: optionalize(z.string()),
+                reflection: camelizeSchema(optionalize(z.object({
+                    reviewer: nestAgentSchema,
+                    isApproved: z.string(),
+                    maxIterations: optionalize(z.number().int().min(1)),
+                    returnLastOnMaxIterations: optionalize(z.boolean()),
+                }))),
             })
                 .extend(baseAgentSchema.shape),
             z

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

@@ -12,9 +12,12 @@ interface LoadableModelClass {
 }
 export interface LoadableModel {
     name: string;
+    apiKeyEnvName?: string;
     create: (options: {
         model?: string;
         modelOptions?: ChatModelOptions;
+        accessKey?: string;
+        url?: string;
     }) => ChatModel;
 }
 export interface LoadOptions {
@@ -26,7 +29,10 @@ export interface LoadOptions {
 }
 export declare function load(options: LoadOptions): Promise<AIGNEOptions>;
 export declare function loadAgent(path: string, options?: LoadOptions, agentOptions?: AgentOptions): Promise<Agent>;
-export declare function loadModel(models: LoadableModel[], model?: Camelize<z.infer<typeof aigneFileSchema>["model"]>, modelOptions?: ChatModelOptions): Promise<ChatModel | undefined>;
+export declare function loadModel(models: LoadableModel[], model?: Camelize<z.infer<typeof aigneFileSchema>["model"]>, modelOptions?: ChatModelOptions, accessKeyOptions?: {
+    accessKey?: string;
+    url?: string;
+}): Promise<ChatModel | undefined>;
 declare const aigneFileSchema: z.ZodObject<{
     name: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
     description: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;

package/lib/esm/loader/index.js

@@ -116,6 +116,12 @@ async function parseAgent(path, agent, options, agentOptions) {
         case "team": {
             return TeamAgent.from({
                 ...baseOptions,
+                mode: agent.mode,
+                iterateOn: agent.iterateOn,
+                reflection: agent.reflection && {
+                    ...agent.reflection,
+                    reviewer: await loadNestAgent(path, agent.reflection.reviewer, options),
+                },
             });
         }
         case "transform": {
@@ -142,7 +148,7 @@ async function loadMemory(memories, provider, options) {
 }
 const { MODEL_PROVIDER, MODEL_NAME } = nodejs.env;
 const DEFAULT_MODEL_PROVIDER = "openai";
-export async function loadModel(models, model, modelOptions) {
+export async function loadModel(models, model, modelOptions, accessKeyOptions) {
     const params = {
         model: MODEL_NAME ?? model?.name ?? undefined,
         temperature: model?.temperature ?? undefined,
@@ -150,12 +156,13 @@ export async function loadModel(models, model, modelOptions) {
         frequencyPenalty: model?.frequencyPenalty ?? undefined,
         presencePenalty: model?.presencePenalty ?? undefined,
     };
-    const m = models.find((m) => m.name
-        .toLowerCase()
-        .includes((MODEL_PROVIDER ?? model?.provider ?? DEFAULT_MODEL_PROVIDER).toLowerCase()));
+    const providerName = MODEL_PROVIDER ?? model?.provider ?? DEFAULT_MODEL_PROVIDER;
+    const provider = providerName.replace(/-/g, "");
+    const m = models.find((m) => m.name.toLowerCase().includes(provider.toLowerCase()));
     if (!m)
         throw new Error(`Unsupported model: ${model?.provider} ${model?.name}`);
     return m.create({
+        ...(accessKeyOptions || {}),
         model: params.model,
         modelOptions: { ...params, ...modelOptions },
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.37.0",
+  "version": "1.38.1",
   "description": "AIGNE core library for building AI-powered applications",
   "publishConfig": {
     "access": "public"
@@ -64,6 +64,8 @@
   "dependencies": {
     "@aigne/json-schema-to-zod": "^1.3.3",
     "@modelcontextprotocol/sdk": "^1.15.0",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/sdk-trace-base": "^2.0.1",
     "@types/debug": "^4.1.12",
     "camelize-ts": "^3.0.0",
     "content-type": "^1.0.5",
@@ -83,7 +85,7 @@
     "yaml": "^2.8.0",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.6",
-    "@aigne/observability-api": "^0.8.0",
+    "@aigne/observability-api": "^0.8.1",
     "@aigne/platform-helpers": "^0.4.0"
   },
   "devDependencies": {