@aigne/core 1.72.0-beta.13 → 1.72.0-beta.15

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [1.72.0-beta.15](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.72.0-beta.14...core-v1.72.0-beta.15) (2026-01-10)
+
+
+### Bug Fixes
+
+* **core:** simplify token-estimator logic for remaining characters ([45d43cc](https://github.com/AIGNE-io/aigne-framework/commit/45d43ccd3afd636cfb459eea2e6551e8f9c53765))
+
+## [1.72.0-beta.14](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.72.0-beta.13...core-v1.72.0-beta.14) (2026-01-09)
+
+
+### Bug Fixes
+
+* **core:** correct session schema for AIAgent ([30b1deb](https://github.com/AIGNE-io/aigne-framework/commit/30b1deb54ac20287580e0a85ef150b95010f8201))
+* **core:** default enable auto breakpoints for chat model ([d4a6b83](https://github.com/AIGNE-io/aigne-framework/commit/d4a6b8323d6c83be45669885b32febb545bdf797))
+
 ## [1.72.0-beta.13](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.72.0-beta.12...core-v1.72.0-beta.13) (2026-01-08)
 
 

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

@@ -126,7 +126,7 @@ class AIAgent extends agent_js_1.Agent {
     static schema({ filepath }) {
         const instructionsSchema = (0, schema_js_1.getInstructionsSchema)({ filepath });
         const nestAgentSchema = (0, agent_yaml_js_1.getNestAgentSchema)({ filepath });
-        return (0, schema_js_1.camelizeSchema)(zod_1.z.object({
+        const schema = (0, schema_js_1.camelizeSchema)(zod_1.z.object({
             instructions: (0, schema_js_1.optionalize)(instructionsSchema),
             inputKey: (0, schema_js_1.optionalize)(zod_1.z.string()),
             outputKey: (0, schema_js_1.optionalize)(zod_1.z.string()),
@@ -137,14 +137,32 @@ class AIAgent extends agent_js_1.Agent {
             keepTextInToolUses: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
             catchToolsError: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
             structuredStreamMode: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
-            compact: (0, schema_js_1.camelizeSchema)((0, schema_js_1.optionalize)(zod_1.z.object({
+            session: (0, schema_js_1.optionalize)((0, schema_js_1.camelizeSchema)(zod_1.z.object({
                 mode: (0, schema_js_1.optionalize)(zod_1.z.enum(["auto", "disabled"])),
-                maxTokens: zod_1.z.number().int().min(0).optional(),
-                keepRecentRatio: (0, schema_js_1.optionalize)(zod_1.z.number().min(0).max(1)),
-                async: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
-                compactor: (0, schema_js_1.optionalize)(nestAgentSchema),
+                sessionMemory: (0, schema_js_1.optionalize)((0, schema_js_1.camelizeSchema)(zod_1.z.object({
+                    mode: (0, schema_js_1.optionalize)(zod_1.z.enum(["auto", "disabled"])),
+                    memoryRatio: (0, schema_js_1.optionalize)(zod_1.z.number().min(0).max(1)),
+                    queryLimit: (0, schema_js_1.optionalize)(zod_1.z.number().int().min(0)),
+                    async: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
+                    extractor: (0, schema_js_1.optionalize)(nestAgentSchema),
+                }))),
+                userMemory: (0, schema_js_1.optionalize)((0, schema_js_1.camelizeSchema)(zod_1.z.object({
+                    mode: (0, schema_js_1.optionalize)(zod_1.z.enum(["auto", "disabled"])),
+                    memoryRatio: (0, schema_js_1.optionalize)(zod_1.z.number().min(0).max(1)),
+                    queryLimit: (0, schema_js_1.optionalize)(zod_1.z.number().int().min(0)),
+                    async: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
+                    extractor: (0, schema_js_1.optionalize)(nestAgentSchema),
+                }))),
+                compact: (0, schema_js_1.optionalize)((0, schema_js_1.camelizeSchema)(zod_1.z.object({
+                    mode: (0, schema_js_1.optionalize)(zod_1.z.enum(["auto", "disabled"])),
+                    maxTokens: zod_1.z.number().int().min(0).optional(),
+                    keepRecentRatio: (0, schema_js_1.optionalize)(zod_1.z.number().min(0).max(1)),
+                    async: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
+                    compactor: (0, schema_js_1.optionalize)(nestAgentSchema),
+                }))),
             }))),
         }));
+        return schema;
     }
     static async load(options) {
         const schema = AIAgent.schema(options);

package/lib/cjs/agents/chat-model.d.ts

@@ -57,7 +57,9 @@ export declare abstract class ChatModel extends Model<ChatModelInput, ChatModelO
     getModelCapabilities(): {
         supportsParallelToolCalls: boolean;
     };
+    getModelOptions(input: Message, options: AgentInvokeOptions): Promise<ChatModelInputOptions>;
     private validateToolNames;
+    countTokens(input: ChatModelInput): Promise<number>;
     /**
      * Normalizes tool names to ensure compatibility with language models
      *

package/lib/cjs/agents/chat-model.js

@@ -40,6 +40,7 @@ const zod_from_json_schema_1 = require("zod-from-json-schema");
 const schema_js_1 = require("../loader/schema.js");
 const json_schema_js_1 = require("../utils/json-schema.js");
 const logger_js_1 = require("../utils/logger.js");
+const token_estimator_js_1 = require("../utils/token-estimator.js");
 const type_utils_js_1 = require("../utils/type-utils.js");
 const agent_js_1 = require("./agent.js");
 const model_js_1 = require("./model.js");
@@ -117,6 +118,19 @@ class ChatModel extends model_js_1.Model {
             supportsParallelToolCalls: this.supportsParallelToolCalls,
         };
     }
+    async getModelOptions(input, options) {
+        const modelOptions = (await super.getModelOptions(input, options));
+        return {
+            ...modelOptions,
+            cacheConfig: {
+                ...modelOptions.cacheConfig,
+                autoBreakpoints: {
+                    ...modelOptions.cacheConfig?.autoBreakpoints,
+                    lastMessage: modelOptions.cacheConfig?.autoBreakpoints?.lastMessage ?? true,
+                },
+            },
+        };
+    }
     validateToolNames(tools) {
         for (const tool of tools ?? []) {
             if (!/^[a-zA-Z0-9_]+$/.test(tool.function.name)) {
@@ -124,6 +138,9 @@ class ChatModel extends model_js_1.Model {
             }
         }
     }
+    async countTokens(input) {
+        return (0, token_estimator_js_1.estimateTokens)(JSON.stringify(input));
+    }
     /**
      * Normalizes tool names to ensure compatibility with language models
      *
@@ -238,7 +255,7 @@ class ChatModel extends model_js_1.Model {
             const files = zod_1.z.array(model_js_1.fileUnionContentSchema).parse(output.files);
             output = {
                 ...output,
-                files: await Promise.all(files.map((file) => this.transformFileType(input.outputFileType, file, options))),
+                files: await Promise.all(files.map((file) => this.transformFileType(input.outputFileType, file))),
             };
         }
         // Remove fields with `null` value for validation

package/lib/cjs/agents/image-model.js

@@ -70,7 +70,7 @@ class ImageModel extends model_js_1.Model {
             const images = zod_1.z.array(model_js_1.fileUnionContentSchema).parse(output.images);
             output = {
                 ...output,
-                images: await Promise.all(images.map((image) => this.transformFileType(input.outputFileType, image, options))),
+                images: await Promise.all(images.map((image) => this.transformFileType(input.outputFileType, image))),
             };
         }
         return super.processAgentOutput(input, output, options);

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

@@ -17,9 +17,9 @@ export declare abstract class Model<I extends Message = any, O extends Message =
      */
     getModelOptions(input: Message, options: AgentInvokeOptions): Promise<Record<string, unknown>>;
     protected preprocess(input: I, options: AgentInvokeOptions): Promise<void>;
-    transformFileType(fileType: "file", data: FileUnionContent, options: AgentInvokeOptions): Promise<FileContent>;
-    transformFileType(fileType: "local" | undefined, data: FileUnionContent, options: AgentInvokeOptions): Promise<LocalContent>;
-    transformFileType(fileType: FileType | undefined, data: FileUnionContent, options: AgentInvokeOptions): Promise<FileUnionContent>;
+    transformFileType(fileType: "file", data: FileUnionContent): Promise<FileContent>;
+    transformFileType(fileType: "local" | undefined, data: FileUnionContent): Promise<LocalContent>;
+    transformFileType(fileType: FileType | undefined, data: FileUnionContent): Promise<FileUnionContent>;
     static getFileExtension(type: string): Promise<string | undefined>;
     static getMimeType(filename: string): Promise<string | undefined>;
     downloadFile(url: string): Promise<Response>;

package/lib/cjs/agents/model.js

@@ -89,13 +89,13 @@ class Model extends agent_js_1.Agent {
         Object.assign(input, { modelOptions: await this.getModelOptions(input, options) });
         return super.preprocess(input, options);
     }
-    async transformFileType(fileType = "local", data, options) {
+    async transformFileType(fileType = "local", data) {
         if (fileType === data.type)
             return data;
         const common = (0, type_utils_js_1.pick)(data, "filename", "mimeType");
         switch (fileType) {
             case "local": {
-                const dir = index_js_1.nodejs.path.join(index_js_1.nodejs.os.tmpdir(), options.context.id);
+                const dir = index_js_1.nodejs.path.join(index_js_1.nodejs.os.tmpdir(), (0, uuid_1.v7)());
                 await index_js_1.nodejs.fs.mkdir(dir, { recursive: true });
                 const ext = await Model.getFileExtension(data.mimeType || data.filename || "");
                 const id = (0, uuid_1.v7)();

package/lib/cjs/agents/video-model.js

@@ -43,7 +43,7 @@ class VideoModel extends model_js_1.Model {
             const videos = zod_1.z.array(model_js_1.fileUnionContentSchema).parse(output.videos);
             output = {
                 ...output,
-                videos: await Promise.all(videos.map((video) => this.transformFileType(input.outputFileType, video, options))),
+                videos: await Promise.all(videos.map((video) => this.transformFileType(input.outputFileType, video))),
             };
         }
         return super.processAgentOutput(input, output, options);

package/lib/cjs/utils/token-estimator.js

@@ -8,7 +8,7 @@ exports.estimateTokens = estimateTokens;
 const CHAR_TYPE_RATIOS = {
     chinese: 1.5, // Chinese characters: ~1.5 characters per token
     word: 0.75, // English words: ~0.75 tokens per word (accounting for subword tokenization)
-    other: 4, // Other characters (punctuation, numbers, etc.): ~4 characters per token
+    other: 1, // Other characters (punctuation, numbers, etc.): ~1 character per token
 };
 /**
  * Regular expressions for character type detection

package/lib/dts/agents/chat-model.d.ts

@@ -57,7 +57,9 @@ export declare abstract class ChatModel extends Model<ChatModelInput, ChatModelO
     getModelCapabilities(): {
         supportsParallelToolCalls: boolean;
     };
+    getModelOptions(input: Message, options: AgentInvokeOptions): Promise<ChatModelInputOptions>;
     private validateToolNames;
+    countTokens(input: ChatModelInput): Promise<number>;
     /**
      * Normalizes tool names to ensure compatibility with language models
      *

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

@@ -17,9 +17,9 @@ export declare abstract class Model<I extends Message = any, O extends Message =
      */
     getModelOptions(input: Message, options: AgentInvokeOptions): Promise<Record<string, unknown>>;
     protected preprocess(input: I, options: AgentInvokeOptions): Promise<void>;
-    transformFileType(fileType: "file", data: FileUnionContent, options: AgentInvokeOptions): Promise<FileContent>;
-    transformFileType(fileType: "local" | undefined, data: FileUnionContent, options: AgentInvokeOptions): Promise<LocalContent>;
-    transformFileType(fileType: FileType | undefined, data: FileUnionContent, options: AgentInvokeOptions): Promise<FileUnionContent>;
+    transformFileType(fileType: "file", data: FileUnionContent): Promise<FileContent>;
+    transformFileType(fileType: "local" | undefined, data: FileUnionContent): Promise<LocalContent>;
+    transformFileType(fileType: FileType | undefined, data: FileUnionContent): Promise<FileUnionContent>;
     static getFileExtension(type: string): Promise<string | undefined>;
     static getMimeType(filename: string): Promise<string | undefined>;
     downloadFile(url: string): Promise<Response>;

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

@@ -90,7 +90,7 @@ export class AIAgent extends Agent {
     static schema({ filepath }) {
         const instructionsSchema = getInstructionsSchema({ filepath });
         const nestAgentSchema = getNestAgentSchema({ filepath });
-        return camelizeSchema(z.object({
+        const schema = camelizeSchema(z.object({
             instructions: optionalize(instructionsSchema),
             inputKey: optionalize(z.string()),
             outputKey: optionalize(z.string()),
@@ -101,14 +101,32 @@ export class AIAgent extends Agent {
             keepTextInToolUses: optionalize(z.boolean()),
             catchToolsError: optionalize(z.boolean()),
             structuredStreamMode: optionalize(z.boolean()),
-            compact: camelizeSchema(optionalize(z.object({
+            session: optionalize(camelizeSchema(z.object({
                 mode: optionalize(z.enum(["auto", "disabled"])),
-                maxTokens: z.number().int().min(0).optional(),
-                keepRecentRatio: optionalize(z.number().min(0).max(1)),
-                async: optionalize(z.boolean()),
-                compactor: optionalize(nestAgentSchema),
+                sessionMemory: optionalize(camelizeSchema(z.object({
+                    mode: optionalize(z.enum(["auto", "disabled"])),
+                    memoryRatio: optionalize(z.number().min(0).max(1)),
+                    queryLimit: optionalize(z.number().int().min(0)),
+                    async: optionalize(z.boolean()),
+                    extractor: optionalize(nestAgentSchema),
+                }))),
+                userMemory: optionalize(camelizeSchema(z.object({
+                    mode: optionalize(z.enum(["auto", "disabled"])),
+                    memoryRatio: optionalize(z.number().min(0).max(1)),
+                    queryLimit: optionalize(z.number().int().min(0)),
+                    async: optionalize(z.boolean()),
+                    extractor: optionalize(nestAgentSchema),
+                }))),
+                compact: optionalize(camelizeSchema(z.object({
+                    mode: optionalize(z.enum(["auto", "disabled"])),
+                    maxTokens: z.number().int().min(0).optional(),
+                    keepRecentRatio: optionalize(z.number().min(0).max(1)),
+                    async: optionalize(z.boolean()),
+                    compactor: optionalize(nestAgentSchema),
+                }))),
             }))),
         }));
+        return schema;
     }
     static async load(options) {
         const schema = AIAgent.schema(options);

package/lib/esm/agents/chat-model.d.ts

@@ -57,7 +57,9 @@ export declare abstract class ChatModel extends Model<ChatModelInput, ChatModelO
     getModelCapabilities(): {
         supportsParallelToolCalls: boolean;
     };
+    getModelOptions(input: Message, options: AgentInvokeOptions): Promise<ChatModelInputOptions>;
     private validateToolNames;
+    countTokens(input: ChatModelInput): Promise<number>;
     /**
      * Normalizes tool names to ensure compatibility with language models
      *

package/lib/esm/agents/chat-model.js

@@ -4,6 +4,7 @@ import { convertJsonSchemaToZod } from "zod-from-json-schema";
 import { optionalize } from "../loader/schema.js";
 import { wrapAutoParseJsonSchema } from "../utils/json-schema.js";
 import { logger } from "../utils/logger.js";
+import { estimateTokens } from "../utils/token-estimator.js";
 import { checkArguments, isNil, omitByDeep } from "../utils/type-utils.js";
 import { agentOptionsSchema, getterSchema, } from "./agent.js";
 import { fileContentSchema, fileUnionContentSchema, localContentSchema, Model, urlContentSchema, } from "./model.js";
@@ -80,6 +81,19 @@ export class ChatModel extends Model {
             supportsParallelToolCalls: this.supportsParallelToolCalls,
         };
     }
+    async getModelOptions(input, options) {
+        const modelOptions = (await super.getModelOptions(input, options));
+        return {
+            ...modelOptions,
+            cacheConfig: {
+                ...modelOptions.cacheConfig,
+                autoBreakpoints: {
+                    ...modelOptions.cacheConfig?.autoBreakpoints,
+                    lastMessage: modelOptions.cacheConfig?.autoBreakpoints?.lastMessage ?? true,
+                },
+            },
+        };
+    }
     validateToolNames(tools) {
         for (const tool of tools ?? []) {
             if (!/^[a-zA-Z0-9_]+$/.test(tool.function.name)) {
@@ -87,6 +101,9 @@ export class ChatModel extends Model {
             }
         }
     }
+    async countTokens(input) {
+        return estimateTokens(JSON.stringify(input));
+    }
     /**
      * Normalizes tool names to ensure compatibility with language models
      *
@@ -201,7 +218,7 @@ export class ChatModel extends Model {
             const files = z.array(fileUnionContentSchema).parse(output.files);
             output = {
                 ...output,
-                files: await Promise.all(files.map((file) => this.transformFileType(input.outputFileType, file, options))),
+                files: await Promise.all(files.map((file) => this.transformFileType(input.outputFileType, file))),
             };
         }
         // Remove fields with `null` value for validation

package/lib/esm/agents/image-model.js

@@ -67,7 +67,7 @@ export class ImageModel extends Model {
             const images = z.array(fileUnionContentSchema).parse(output.images);
             output = {
                 ...output,
-                images: await Promise.all(images.map((image) => this.transformFileType(input.outputFileType, image, options))),
+                images: await Promise.all(images.map((image) => this.transformFileType(input.outputFileType, image))),
             };
         }
         return super.processAgentOutput(input, output, options);

package/lib/esm/agents/model.d.ts

@@ -17,9 +17,9 @@ export declare abstract class Model<I extends Message = any, O extends Message =
      */
     getModelOptions(input: Message, options: AgentInvokeOptions): Promise<Record<string, unknown>>;
     protected preprocess(input: I, options: AgentInvokeOptions): Promise<void>;
-    transformFileType(fileType: "file", data: FileUnionContent, options: AgentInvokeOptions): Promise<FileContent>;
-    transformFileType(fileType: "local" | undefined, data: FileUnionContent, options: AgentInvokeOptions): Promise<LocalContent>;
-    transformFileType(fileType: FileType | undefined, data: FileUnionContent, options: AgentInvokeOptions): Promise<FileUnionContent>;
+    transformFileType(fileType: "file", data: FileUnionContent): Promise<FileContent>;
+    transformFileType(fileType: "local" | undefined, data: FileUnionContent): Promise<LocalContent>;
+    transformFileType(fileType: FileType | undefined, data: FileUnionContent): Promise<FileUnionContent>;
     static getFileExtension(type: string): Promise<string | undefined>;
     static getMimeType(filename: string): Promise<string | undefined>;
     downloadFile(url: string): Promise<Response>;

package/lib/esm/agents/model.js

@@ -53,13 +53,13 @@ export class Model extends Agent {
         Object.assign(input, { modelOptions: await this.getModelOptions(input, options) });
         return super.preprocess(input, options);
     }
-    async transformFileType(fileType = "local", data, options) {
+    async transformFileType(fileType = "local", data) {
         if (fileType === data.type)
             return data;
         const common = pick(data, "filename", "mimeType");
         switch (fileType) {
             case "local": {
-                const dir = nodejs.path.join(nodejs.os.tmpdir(), options.context.id);
+                const dir = nodejs.path.join(nodejs.os.tmpdir(), v7());
                 await nodejs.fs.mkdir(dir, { recursive: true });
                 const ext = await Model.getFileExtension(data.mimeType || data.filename || "");
                 const id = v7();

package/lib/esm/agents/video-model.js

@@ -40,7 +40,7 @@ export class VideoModel extends Model {
             const videos = z.array(fileUnionContentSchema).parse(output.videos);
             output = {
                 ...output,
-                videos: await Promise.all(videos.map((video) => this.transformFileType(input.outputFileType, video, options))),
+                videos: await Promise.all(videos.map((video) => this.transformFileType(input.outputFileType, video))),
             };
         }
         return super.processAgentOutput(input, output, options);

package/lib/esm/utils/token-estimator.js

@@ -5,7 +5,7 @@
 const CHAR_TYPE_RATIOS = {
     chinese: 1.5, // Chinese characters: ~1.5 characters per token
     word: 0.75, // English words: ~0.75 tokens per word (accounting for subword tokenization)
-    other: 4, // Other characters (punctuation, numbers, etc.): ~4 characters per token
+    other: 1, // Other characters (punctuation, numbers, etc.): ~1 character per token
 };
 /**
  * Regular expressions for character type detection

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.72.0-beta.13",
+  "version": "1.72.0-beta.15",
   "description": "The functional core of agentic AI",
   "publishConfig": {
     "access": "public"
@@ -93,10 +93,10 @@
     "zod": "^3.25.67",
     "zod-from-json-schema": "^0.0.5",
     "zod-to-json-schema": "^3.24.6",
-    "@aigne/afs": "^1.4.0-beta.7",
-    "@aigne/afs-history": "^1.2.0-beta.8",
     "@aigne/observability-api": "^0.11.14-beta.2",
-    "@aigne/platform-helpers": "^0.6.7-beta.1"
+    "@aigne/platform-helpers": "^0.6.7-beta.1",
+    "@aigne/afs": "^1.4.0-beta.7",
+    "@aigne/afs-history": "^1.2.0-beta.8"
   },
   "devDependencies": {
     "@types/bun": "^1.2.22",