@aigne/core 1.40.0 → 1.41.0

package/CHANGELOG.md

@@ -12,6 +12,13 @@
   * dependencies
     * @aigne/observability bumped to 0.1.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/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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.40.0",
+  "version": "1.41.0",
   "description": "AIGNE core library for building AI-powered applications",
   "publishConfig": {
     "access": "public"