@aigne/core 1.40.0 → 1.42.0

package/CHANGELOG.md

@@ -12,6 +12,29 @@
   * dependencies
     * @aigne/observability bumped to 0.1.0
 
+## [1.42.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.41.0...core-v1.42.0) (2025-08-01)
+
+
+### Features
+
+* **cli:** add `--model` option for aigne applications ([#302](https://github.com/AIGNE-io/aigne-framework/issues/302)) ([5d63743](https://github.com/AIGNE-io/aigne-framework/commit/5d63743b8a47be64fd49245983f4f2f9da3197a0))
+* support google model and skip check mode when connected to Hub ([#300](https://github.com/AIGNE-io/aigne-framework/issues/300)) ([e992c0f](https://github.com/AIGNE-io/aigne-framework/commit/e992c0f3335a7c512fa807d5b8ad10c9c3bf2351))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/observability-api bumped to 0.9.0
+    * @aigne/platform-helpers bumped to 0.5.0
+
+## [1.41.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.40.0...core-v1.41.0) (2025-07-31)
+
+
+### Features
+
+* **cli:** add alias support for agent ([#297](https://github.com/AIGNE-io/aigne-framework/issues/297)) ([fa166ab](https://github.com/AIGNE-io/aigne-framework/commit/fa166ab66d19e89ddd32c34e1470450eb4fbdbbd))
+
 ## [1.40.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.39.0...core-v1.40.0) (2025-07-31)
 
 

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

@@ -61,6 +61,10 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
      * if not specified
      */
     name?: string;
+    /**
+     * Alias for the agent, can be used to refer to the agent by multiple names, especially in AIGNE CLI
+     */
+    alias?: string[];
     /**
      * Description of the agent
      *
@@ -232,6 +236,10 @@ export declare abstract class Agent<I extends Message = any, O extends Message =
      * Defaults to the class constructor name if not specified in options
      */
     readonly name: string;
+    /**
+     * Alias for the agent, can be used to refer to the agent by multiple names, especially in AIGNE CLI
+     */
+    readonly alias?: string[];
     /**
      * Default topic this agent subscribes to
      *

package/lib/cjs/agents/agent.js

@@ -102,6 +102,7 @@ class Agent {
     constructor(options = {}) {
         const { inputSchema, outputSchema } = options;
         this.name = options.name || this.constructor.name;
+        this.alias = options.alias;
         this.description = options.description;
         if (inputSchema)
             checkAgentInputOutputSchema(inputSchema);
@@ -170,6 +171,10 @@ class Agent {
      * Defaults to the class constructor name if not specified in options
      */
     name;
+    /**
+     * Alias for the agent, can be used to refer to the agent by multiple names, especially in AIGNE CLI
+     */
+    alias;
     /**
      * Default topic this agent subscribes to
      *

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

@@ -32,6 +32,7 @@ async function parseAgentFile(path, data) {
         }));
         const baseAgentSchema = zod_1.z.object({
             name: (0, schema_js_1.optionalize)(zod_1.z.string()),
+            alias: (0, schema_js_1.optionalize)(zod_1.z.array(zod_1.z.string())),
             description: (0, schema_js_1.optionalize)(zod_1.z.string()),
             inputSchema: (0, schema_js_1.optionalize)((0, schema_js_1.inputOutputSchema)({ path })).transform((v) => v ? (0, json_schema_to_zod_1.jsonSchemaToZod)(v) : undefined),
             defaultInput: (0, schema_js_1.optionalize)(schema_js_1.defaultInputSchema),

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

@@ -1,27 +1,12 @@
 import type { Camelize } from "camelize-ts";
 import { z } from "zod";
 import { Agent, type AgentOptions } from "../agents/agent.js";
-import type { ChatModel, ChatModelOptions } from "../agents/chat-model.js";
+import type { ChatModel } from "../agents/chat-model.js";
 import type { AIGNEOptions } from "../aigne/aigne.js";
 import type { MemoryAgent, MemoryAgentOptions } from "../memory/memory.js";
-interface LoadableModelClass {
-    new (parameters: {
-        model?: string;
-        modelOptions?: ChatModelOptions;
-    }): ChatModel;
-}
-export interface LoadableModel {
-    name: string;
-    apiKeyEnvName?: string;
-    create: (options: {
-        model?: string;
-        modelOptions?: ChatModelOptions;
-        accessKey?: string;
-        url?: string;
-    }) => ChatModel;
-}
+import { type PromiseOrValue } from "../utils/type-utils.js";
 export interface LoadOptions {
-    models: (LoadableModel | LoadableModelClass)[];
+    loadModel: (model?: Camelize<z.infer<typeof aigneFileSchema>["model"]>) => PromiseOrValue<ChatModel | undefined>;
     memories?: {
         new (parameters?: MemoryAgentOptions): MemoryAgent;
     }[];
@@ -29,10 +14,6 @@ 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, 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

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.load = load;
 exports.loadAgent = loadAgent;
-exports.loadModel = loadModel;
 exports.loadAIGNEFile = loadAIGNEFile;
 const index_js_1 = require("@aigne/platform-helpers/nodejs/index.js");
 const yaml_1 = require("yaml");
@@ -26,12 +25,7 @@ async function load(options) {
     return {
         ...aigne,
         rootDir,
-        model: await loadModel(options.models.map((i) => typeof i === "function"
-            ? {
-                name: i.name,
-                create: (options) => new i(options),
-            }
-            : i), aigne.model),
+        model: await options.loadModel(aigne.model),
         agents: pickAgents(aigne.agents ?? []),
         skills: pickAgents(aigne.skills ?? []),
         mcpServer: {
@@ -158,27 +152,6 @@ async function loadMemory(memories, provider, options) {
         throw new Error(`Unsupported memory: ${provider}`);
     return new M(options);
 }
-const { MODEL_PROVIDER, MODEL_NAME } = index_js_1.nodejs.env;
-const DEFAULT_MODEL_PROVIDER = "openai";
-async function loadModel(models, model, modelOptions, accessKeyOptions) {
-    const params = {
-        model: MODEL_NAME ?? model?.name ?? undefined,
-        temperature: model?.temperature ?? undefined,
-        topP: model?.topP ?? undefined,
-        frequencyPenalty: model?.frequencyPenalty ?? undefined,
-        presencePenalty: model?.presencePenalty ?? undefined,
-    };
-    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 },
-    });
-}
 const aigneFileSchema = (0, schema_js_1.camelizeSchema)(zod_1.z.object({
     name: (0, schema_js_1.optionalize)(zod_1.z.string()),
     description: (0, schema_js_1.optionalize)(zod_1.z.string()),

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

@@ -61,6 +61,10 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
      * if not specified
      */
     name?: string;
+    /**
+     * Alias for the agent, can be used to refer to the agent by multiple names, especially in AIGNE CLI
+     */
+    alias?: string[];
     /**
      * Description of the agent
      *
@@ -232,6 +236,10 @@ export declare abstract class Agent<I extends Message = any, O extends Message =
      * Defaults to the class constructor name if not specified in options
      */
     readonly name: string;
+    /**
+     * Alias for the agent, can be used to refer to the agent by multiple names, especially in AIGNE CLI
+     */
+    readonly alias?: string[];
     /**
      * Default topic this agent subscribes to
      *

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

@@ -1,27 +1,12 @@
 import type { Camelize } from "camelize-ts";
 import { z } from "zod";
 import { Agent, type AgentOptions } from "../agents/agent.js";
-import type { ChatModel, ChatModelOptions } from "../agents/chat-model.js";
+import type { ChatModel } from "../agents/chat-model.js";
 import type { AIGNEOptions } from "../aigne/aigne.js";
 import type { MemoryAgent, MemoryAgentOptions } from "../memory/memory.js";
-interface LoadableModelClass {
-    new (parameters: {
-        model?: string;
-        modelOptions?: ChatModelOptions;
-    }): ChatModel;
-}
-export interface LoadableModel {
-    name: string;
-    apiKeyEnvName?: string;
-    create: (options: {
-        model?: string;
-        modelOptions?: ChatModelOptions;
-        accessKey?: string;
-        url?: string;
-    }) => ChatModel;
-}
+import { type PromiseOrValue } from "../utils/type-utils.js";
 export interface LoadOptions {
-    models: (LoadableModel | LoadableModelClass)[];
+    loadModel: (model?: Camelize<z.infer<typeof aigneFileSchema>["model"]>) => PromiseOrValue<ChatModel | undefined>;
     memories?: {
         new (parameters?: MemoryAgentOptions): MemoryAgent;
     }[];
@@ -29,10 +14,6 @@ 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, 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/agent.d.ts

@@ -61,6 +61,10 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
      * if not specified
      */
     name?: string;
+    /**
+     * Alias for the agent, can be used to refer to the agent by multiple names, especially in AIGNE CLI
+     */
+    alias?: string[];
     /**
      * Description of the agent
      *
@@ -232,6 +236,10 @@ export declare abstract class Agent<I extends Message = any, O extends Message =
      * Defaults to the class constructor name if not specified in options
      */
     readonly name: string;
+    /**
+     * Alias for the agent, can be used to refer to the agent by multiple names, especially in AIGNE CLI
+     */
+    readonly alias?: string[];
     /**
      * Default topic this agent subscribes to
      *

package/lib/esm/agents/agent.js

@@ -57,6 +57,7 @@ export class Agent {
     constructor(options = {}) {
         const { inputSchema, outputSchema } = options;
         this.name = options.name || this.constructor.name;
+        this.alias = options.alias;
         this.description = options.description;
         if (inputSchema)
             checkAgentInputOutputSchema(inputSchema);
@@ -125,6 +126,10 @@ export class Agent {
      * Defaults to the class constructor name if not specified in options
      */
     name;
+    /**
+     * Alias for the agent, can be used to refer to the agent by multiple names, especially in AIGNE CLI
+     */
+    alias;
     /**
      * Default topic this agent subscribes to
      *

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

@@ -28,6 +28,7 @@ export async function parseAgentFile(path, data) {
         }));
         const baseAgentSchema = z.object({
             name: optionalize(z.string()),
+            alias: optionalize(z.array(z.string())),
             description: optionalize(z.string()),
             inputSchema: optionalize(inputOutputSchema({ path })).transform((v) => v ? jsonSchemaToZod(v) : undefined),
             defaultInput: optionalize(defaultInputSchema),

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

@@ -1,27 +1,12 @@
 import type { Camelize } from "camelize-ts";
 import { z } from "zod";
 import { Agent, type AgentOptions } from "../agents/agent.js";
-import type { ChatModel, ChatModelOptions } from "../agents/chat-model.js";
+import type { ChatModel } from "../agents/chat-model.js";
 import type { AIGNEOptions } from "../aigne/aigne.js";
 import type { MemoryAgent, MemoryAgentOptions } from "../memory/memory.js";
-interface LoadableModelClass {
-    new (parameters: {
-        model?: string;
-        modelOptions?: ChatModelOptions;
-    }): ChatModel;
-}
-export interface LoadableModel {
-    name: string;
-    apiKeyEnvName?: string;
-    create: (options: {
-        model?: string;
-        modelOptions?: ChatModelOptions;
-        accessKey?: string;
-        url?: string;
-    }) => ChatModel;
-}
+import { type PromiseOrValue } from "../utils/type-utils.js";
 export interface LoadOptions {
-    models: (LoadableModel | LoadableModelClass)[];
+    loadModel: (model?: Camelize<z.infer<typeof aigneFileSchema>["model"]>) => PromiseOrValue<ChatModel | undefined>;
     memories?: {
         new (parameters?: MemoryAgentOptions): MemoryAgent;
     }[];
@@ -29,10 +14,6 @@ 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, 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

@@ -20,12 +20,7 @@ export async function load(options) {
     return {
         ...aigne,
         rootDir,
-        model: await loadModel(options.models.map((i) => typeof i === "function"
-            ? {
-                name: i.name,
-                create: (options) => new i(options),
-            }
-            : i), aigne.model),
+        model: await options.loadModel(aigne.model),
         agents: pickAgents(aigne.agents ?? []),
         skills: pickAgents(aigne.skills ?? []),
         mcpServer: {
@@ -152,27 +147,6 @@ async function loadMemory(memories, provider, options) {
         throw new Error(`Unsupported memory: ${provider}`);
     return new M(options);
 }
-const { MODEL_PROVIDER, MODEL_NAME } = nodejs.env;
-const DEFAULT_MODEL_PROVIDER = "openai";
-export async function loadModel(models, model, modelOptions, accessKeyOptions) {
-    const params = {
-        model: MODEL_NAME ?? model?.name ?? undefined,
-        temperature: model?.temperature ?? undefined,
-        topP: model?.topP ?? undefined,
-        frequencyPenalty: model?.frequencyPenalty ?? undefined,
-        presencePenalty: model?.presencePenalty ?? undefined,
-    };
-    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 },
-    });
-}
 const aigneFileSchema = camelizeSchema(z.object({
     name: optionalize(z.string()),
     description: optionalize(z.string()),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.40.0",
+  "version": "1.42.0",
   "description": "AIGNE core library for building AI-powered applications",
   "publishConfig": {
     "access": "public"
@@ -86,8 +86,8 @@
     "yaml": "^2.8.0",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.6",
-    "@aigne/observability-api": "^0.8.2",
-    "@aigne/platform-helpers": "^0.4.0"
+    "@aigne/observability-api": "^0.9.0",
+    "@aigne/platform-helpers": "^0.5.0"
   },
   "devDependencies": {
     "@types/bun": "^1.2.18",