@aigne/core 1.53.0 → 1.55.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## [1.55.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.54.0...core-v1.55.0) (2025-08-21)
+
+
+### Features
+
+* **blocklet:** support agent runtime blocklet ([#396](https://github.com/AIGNE-io/aigne-framework/issues/396)) ([baaae69](https://github.com/AIGNE-io/aigne-framework/commit/baaae691d552b7c7d313c4964a135a1b245943f9))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/observability-api bumped to 0.10.0
+
+## [1.54.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.53.0...core-v1.54.0) (2025-08-21)
+
+
+### Features
+
+* **cli:** add chat mode support for cli ([#389](https://github.com/AIGNE-io/aigne-framework/issues/389)) ([d7dc138](https://github.com/AIGNE-io/aigne-framework/commit/d7dc138719dd638ddb12c4625abdf42746baf35d))
+
+
+### Bug Fixes
+
+* **cli:** force reimport of agent modules with cache busting ([#392](https://github.com/AIGNE-io/aigne-framework/issues/392)) ([c372cb9](https://github.com/AIGNE-io/aigne-framework/commit/c372cb9600a9d78ad1808a045bcddfc285e9c6f0))
+
 ## [1.53.0](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.52.0...core-v1.53.0) (2025-08-20)
 
 

package/lib/cjs/aigne/aigne.d.ts

@@ -44,6 +44,7 @@ export interface AIGNEOptions {
         agents?: Agent[];
     };
     cli?: {
+        chat?: Agent;
         agents?: Agent[];
     };
     /**
@@ -133,6 +134,7 @@ export declare class AIGNE<U extends UserContext = UserContext> {
         };
     };
     readonly cli: {
+        chat: Agent | undefined;
         agents: Agent<any, any>[] & {
             [key: string]: Agent<any, any>;
         };

package/lib/cjs/aigne/aigne.js

@@ -65,6 +65,8 @@ class AIGNE {
             this.mcpServer.agents.push(...options.mcpServer.agents);
         if (options?.cli?.agents?.length)
             this.cli.agents.push(...options.cli.agents);
+        if (options?.cli?.chat)
+            this.cli.chat = options.cli.chat;
         this.observer?.serve();
         this.initProcessExitHandler();
     }
@@ -112,6 +114,7 @@ class AIGNE {
         agents: (0, type_utils_js_1.createAccessorArray)([], (arr, name) => arr.find((i) => i.name === name)),
     };
     cli = {
+        chat: undefined,
         agents: (0, type_utils_js_1.createAccessorArray)([], (arr, name) => arr.find((i) => i.name === name)),
     };
     /**

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

@@ -1,2 +1,3 @@
 import { Agent } from "../agents/agent.js";
-export declare function loadAgentFromJsFile(path: string): Promise<Agent<any, any> | import("./agent-yaml.js").AgentSchema>;
+import type { LoadOptions } from "./index.js";
+export declare function loadAgentFromJsFile(path: string, options?: LoadOptions): Promise<Agent<any, any> | import("./agent-yaml.js").AgentSchema>;

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

@@ -1,44 +1,15 @@
 "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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadAgentFromJsFile = loadAgentFromJsFile;
+const ufo_1 = require("ufo");
 const agent_js_1 = require("../agents/agent.js");
 const type_utils_js_1 = require("../utils/type-utils.js");
 const agent_yaml_js_1 = require("./agent-yaml.js");
-async function loadAgentFromJsFile(path) {
-    const { default: agent } = await (0, type_utils_js_1.tryOrThrow)(() => Promise.resolve(`${path}`).then(s => __importStar(require(s))), (error) => new Error(`Failed to load agent definition from ${path}: ${error.message}`));
+const importFn = new Function("path", "return import(path)");
+async function loadAgentFromJsFile(path, options) {
+    if (options?.key)
+        path = (0, ufo_1.withQuery)(path, { key: options?.key });
+    const { default: agent } = await (0, type_utils_js_1.tryOrThrow)(() => importFn(path), (error) => new Error(`Failed to load agent definition from ${path}: ${error.message}`));
     if (agent instanceof agent_js_1.Agent)
         return agent;
     if (typeof agent !== "function") {

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

@@ -11,6 +11,7 @@ export interface LoadOptions {
     }[];
     model?: ChatModel | ((model?: z.infer<typeof aigneFileSchema>["chatModel"]) => PromiseOrValue<ChatModel | undefined>);
     imageModel?: ImageModel | ((model?: z.infer<typeof aigneFileSchema>["imageModel"]) => PromiseOrValue<ImageModel | undefined>);
+    key?: string | number;
 }
 export declare function load(path: string, options?: LoadOptions): Promise<AIGNEOptions>;
 export declare function loadAgent(path: string, options?: LoadOptions, agentOptions?: AgentOptions): Promise<Agent>;
@@ -60,8 +61,10 @@ declare const aigneFileSchema: z.ZodObject<{
     } | undefined>;
     cli: z.ZodType<{
         agents?: string[] | undefined;
+        chat?: string | undefined;
     } | undefined, z.ZodTypeDef, {
         agents?: string[] | undefined;
+        chat?: string | undefined;
     } | undefined>;
 }, "strip", z.ZodTypeAny, {
     name?: string | undefined;
@@ -83,6 +86,7 @@ declare const aigneFileSchema: z.ZodObject<{
     } | undefined;
     cli?: {
         agents?: string[] | undefined;
+        chat?: string | undefined;
     } | undefined;
 }, {
     name?: string | undefined;
@@ -98,6 +102,7 @@ declare const aigneFileSchema: z.ZodObject<{
     } | undefined;
     cli?: {
         agents?: string[] | undefined;
+        chat?: string | undefined;
     } | undefined;
 }>;
 export declare function loadAIGNEFile(path: string): Promise<{

package/lib/cjs/loader/index.js

@@ -19,8 +19,9 @@ const agent_yaml_js_1 = require("./agent-yaml.js");
 const schema_js_1 = require("./schema.js");
 const AIGNE_FILE_NAME = ["aigne.yaml", "aigne.yml"];
 async function load(path, options = {}) {
+    options.key ??= Date.now();
     const { aigne, rootDir } = await loadAIGNEFile(path);
-    const allAgentPaths = new Set((0, type_utils_js_1.flat)(aigne.agents, aigne.skills, aigne.mcpServer?.agents, aigne.cli?.agents).map((i) => index_js_1.nodejs.path.join(rootDir, i)));
+    const allAgentPaths = new Set((0, type_utils_js_1.flat)(aigne.agents, aigne.skills, aigne.mcpServer?.agents, aigne.cli?.agents, aigne.cli?.chat).map((i) => index_js_1.nodejs.path.join(rootDir, i)));
     const allAgents = Object.fromEntries(await Promise.all(Array.from(allAgentPaths).map(async (path) => [path, await loadAgent(path, options)])));
     const pickAgents = (paths) => paths.map((filename) => allAgents[index_js_1.nodejs.path.join(rootDir, filename)]).filter(type_utils_js_1.isNonNullable);
     return {
@@ -36,13 +37,14 @@ async function load(path, options = {}) {
             agents: pickAgents(aigne.mcpServer?.agents ?? []),
         },
         cli: {
+            chat: aigne.cli?.chat ? pickAgents([aigne.cli.chat])[0] : undefined,
             agents: pickAgents(aigne.cli?.agents ?? []),
         },
     };
 }
 async function loadAgent(path, options, agentOptions) {
     if ([".js", ".mjs", ".ts", ".mts"].includes(index_js_1.nodejs.path.extname(path))) {
-        const agent = await (0, agent_js_js_1.loadAgentFromJsFile)(path);
+        const agent = await (0, agent_js_js_1.loadAgentFromJsFile)(path, options);
         if (agent instanceof agent_js_1.Agent)
             return agent;
         return parseAgent(path, agent, options, agentOptions);
@@ -196,6 +198,7 @@ const aigneFileSchema = (0, schema_js_1.camelizeSchema)(zod_1.z.object({
         agents: (0, schema_js_1.optionalize)(zod_1.z.array(zod_1.z.string())),
     })),
     cli: (0, schema_js_1.optionalize)(zod_1.z.object({
+        chat: (0, schema_js_1.optionalize)(zod_1.z.string()),
         agents: (0, schema_js_1.optionalize)(zod_1.z.array(zod_1.z.string())),
     })),
 }));

package/lib/dts/aigne/aigne.d.ts

@@ -44,6 +44,7 @@ export interface AIGNEOptions {
         agents?: Agent[];
     };
     cli?: {
+        chat?: Agent;
         agents?: Agent[];
     };
     /**
@@ -133,6 +134,7 @@ export declare class AIGNE<U extends UserContext = UserContext> {
         };
     };
     readonly cli: {
+        chat: Agent | undefined;
         agents: Agent<any, any>[] & {
             [key: string]: Agent<any, any>;
         };

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

@@ -1,2 +1,3 @@
 import { Agent } from "../agents/agent.js";
-export declare function loadAgentFromJsFile(path: string): Promise<Agent<any, any> | import("./agent-yaml.js").AgentSchema>;
+import type { LoadOptions } from "./index.js";
+export declare function loadAgentFromJsFile(path: string, options?: LoadOptions): Promise<Agent<any, any> | import("./agent-yaml.js").AgentSchema>;

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

@@ -11,6 +11,7 @@ export interface LoadOptions {
     }[];
     model?: ChatModel | ((model?: z.infer<typeof aigneFileSchema>["chatModel"]) => PromiseOrValue<ChatModel | undefined>);
     imageModel?: ImageModel | ((model?: z.infer<typeof aigneFileSchema>["imageModel"]) => PromiseOrValue<ImageModel | undefined>);
+    key?: string | number;
 }
 export declare function load(path: string, options?: LoadOptions): Promise<AIGNEOptions>;
 export declare function loadAgent(path: string, options?: LoadOptions, agentOptions?: AgentOptions): Promise<Agent>;
@@ -60,8 +61,10 @@ declare const aigneFileSchema: z.ZodObject<{
     } | undefined>;
     cli: z.ZodType<{
         agents?: string[] | undefined;
+        chat?: string | undefined;
     } | undefined, z.ZodTypeDef, {
         agents?: string[] | undefined;
+        chat?: string | undefined;
     } | undefined>;
 }, "strip", z.ZodTypeAny, {
     name?: string | undefined;
@@ -83,6 +86,7 @@ declare const aigneFileSchema: z.ZodObject<{
     } | undefined;
     cli?: {
         agents?: string[] | undefined;
+        chat?: string | undefined;
     } | undefined;
 }, {
     name?: string | undefined;
@@ -98,6 +102,7 @@ declare const aigneFileSchema: z.ZodObject<{
     } | undefined;
     cli?: {
         agents?: string[] | undefined;
+        chat?: string | undefined;
     } | undefined;
 }>;
 export declare function loadAIGNEFile(path: string): Promise<{

package/lib/esm/aigne/aigne.d.ts

@@ -44,6 +44,7 @@ export interface AIGNEOptions {
         agents?: Agent[];
     };
     cli?: {
+        chat?: Agent;
         agents?: Agent[];
     };
     /**
@@ -133,6 +134,7 @@ export declare class AIGNE<U extends UserContext = UserContext> {
         };
     };
     readonly cli: {
+        chat: Agent | undefined;
         agents: Agent<any, any>[] & {
             [key: string]: Agent<any, any>;
         };

package/lib/esm/aigne/aigne.js

@@ -62,6 +62,8 @@ export class AIGNE {
             this.mcpServer.agents.push(...options.mcpServer.agents);
         if (options?.cli?.agents?.length)
             this.cli.agents.push(...options.cli.agents);
+        if (options?.cli?.chat)
+            this.cli.chat = options.cli.chat;
         this.observer?.serve();
         this.initProcessExitHandler();
     }
@@ -109,6 +111,7 @@ export class AIGNE {
         agents: createAccessorArray([], (arr, name) => arr.find((i) => i.name === name)),
     };
     cli = {
+        chat: undefined,
         agents: createAccessorArray([], (arr, name) => arr.find((i) => i.name === name)),
     };
     /**

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

@@ -1,2 +1,3 @@
 import { Agent } from "../agents/agent.js";
-export declare function loadAgentFromJsFile(path: string): Promise<Agent<any, any> | import("./agent-yaml.js").AgentSchema>;
+import type { LoadOptions } from "./index.js";
+export declare function loadAgentFromJsFile(path: string, options?: LoadOptions): Promise<Agent<any, any> | import("./agent-yaml.js").AgentSchema>;

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

@@ -1,8 +1,12 @@
+import { withQuery } from "ufo";
 import { Agent } from "../agents/agent.js";
 import { tryOrThrow } from "../utils/type-utils.js";
 import { parseAgentFile } from "./agent-yaml.js";
-export async function loadAgentFromJsFile(path) {
-    const { default: agent } = await tryOrThrow(() => import(/* @vite-ignore */ path), (error) => new Error(`Failed to load agent definition from ${path}: ${error.message}`));
+const importFn = new Function("path", "return import(path)");
+export async function loadAgentFromJsFile(path, options) {
+    if (options?.key)
+        path = withQuery(path, { key: options?.key });
+    const { default: agent } = await tryOrThrow(() => importFn(path), (error) => new Error(`Failed to load agent definition from ${path}: ${error.message}`));
     if (agent instanceof Agent)
         return agent;
     if (typeof agent !== "function") {

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

@@ -11,6 +11,7 @@ export interface LoadOptions {
     }[];
     model?: ChatModel | ((model?: z.infer<typeof aigneFileSchema>["chatModel"]) => PromiseOrValue<ChatModel | undefined>);
     imageModel?: ImageModel | ((model?: z.infer<typeof aigneFileSchema>["imageModel"]) => PromiseOrValue<ImageModel | undefined>);
+    key?: string | number;
 }
 export declare function load(path: string, options?: LoadOptions): Promise<AIGNEOptions>;
 export declare function loadAgent(path: string, options?: LoadOptions, agentOptions?: AgentOptions): Promise<Agent>;
@@ -60,8 +61,10 @@ declare const aigneFileSchema: z.ZodObject<{
     } | undefined>;
     cli: z.ZodType<{
         agents?: string[] | undefined;
+        chat?: string | undefined;
     } | undefined, z.ZodTypeDef, {
         agents?: string[] | undefined;
+        chat?: string | undefined;
     } | undefined>;
 }, "strip", z.ZodTypeAny, {
     name?: string | undefined;
@@ -83,6 +86,7 @@ declare const aigneFileSchema: z.ZodObject<{
     } | undefined;
     cli?: {
         agents?: string[] | undefined;
+        chat?: string | undefined;
     } | undefined;
 }, {
     name?: string | undefined;
@@ -98,6 +102,7 @@ declare const aigneFileSchema: z.ZodObject<{
     } | undefined;
     cli?: {
         agents?: string[] | undefined;
+        chat?: string | undefined;
     } | undefined;
 }>;
 export declare function loadAIGNEFile(path: string): Promise<{

package/lib/esm/loader/index.js

@@ -14,8 +14,9 @@ import { loadAgentFromYamlFile } from "./agent-yaml.js";
 import { camelizeSchema, optionalize } from "./schema.js";
 const AIGNE_FILE_NAME = ["aigne.yaml", "aigne.yml"];
 export async function load(path, options = {}) {
+    options.key ??= Date.now();
     const { aigne, rootDir } = await loadAIGNEFile(path);
-    const allAgentPaths = new Set(flat(aigne.agents, aigne.skills, aigne.mcpServer?.agents, aigne.cli?.agents).map((i) => nodejs.path.join(rootDir, i)));
+    const allAgentPaths = new Set(flat(aigne.agents, aigne.skills, aigne.mcpServer?.agents, aigne.cli?.agents, aigne.cli?.chat).map((i) => nodejs.path.join(rootDir, i)));
     const allAgents = Object.fromEntries(await Promise.all(Array.from(allAgentPaths).map(async (path) => [path, await loadAgent(path, options)])));
     const pickAgents = (paths) => paths.map((filename) => allAgents[nodejs.path.join(rootDir, filename)]).filter(isNonNullable);
     return {
@@ -31,13 +32,14 @@ export async function load(path, options = {}) {
             agents: pickAgents(aigne.mcpServer?.agents ?? []),
         },
         cli: {
+            chat: aigne.cli?.chat ? pickAgents([aigne.cli.chat])[0] : undefined,
             agents: pickAgents(aigne.cli?.agents ?? []),
         },
     };
 }
 export async function loadAgent(path, options, agentOptions) {
     if ([".js", ".mjs", ".ts", ".mts"].includes(nodejs.path.extname(path))) {
-        const agent = await loadAgentFromJsFile(path);
+        const agent = await loadAgentFromJsFile(path, options);
         if (agent instanceof Agent)
             return agent;
         return parseAgent(path, agent, options, agentOptions);
@@ -191,6 +193,7 @@ const aigneFileSchema = camelizeSchema(z.object({
         agents: optionalize(z.array(z.string())),
     })),
     cli: optionalize(z.object({
+        chat: optionalize(z.string()),
         agents: optionalize(z.array(z.string())),
     })),
 }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.53.0",
+  "version": "1.55.0",
   "description": "The functional core of agentic AI",
   "publishConfig": {
     "access": "public"
@@ -89,7 +89,7 @@
     "yaml": "^2.8.0",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.6",
-    "@aigne/observability-api": "^0.9.1",
+    "@aigne/observability-api": "^0.10.0",
     "@aigne/platform-helpers": "^0.6.2"
   },
   "devDependencies": {