@aigne/core 1.63.0-beta.3 → 1.63.0-beta.5

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.63.0-beta.5](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.63.0-beta.4...core-v1.63.0-beta.5) (2025-10-13)
+
+
+### Bug Fixes
+
+* **core:** auto merge multiple system messages ([#619](https://github.com/AIGNE-io/aigne-framework/issues/619)) ([e9e62c0](https://github.com/AIGNE-io/aigne-framework/commit/e9e62c03c45f5a9b75d44a07588b2b179e262aad))
+
+## [1.63.0-beta.4](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.63.0-beta.3...core-v1.63.0-beta.4) (2025-10-12)
+
+
+### Features
+
+* **afs:** add configurable history injection to AFS system ([#611](https://github.com/AIGNE-io/aigne-framework/issues/611)) ([689b5d7](https://github.com/AIGNE-io/aigne-framework/commit/689b5d76d8cc82f548e8be74e63f18e7a6216c31))
+
 ## [1.63.0-beta.3](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.63.0-beta.2...core-v1.63.0-beta.3) (2025-10-11)
 
 

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

@@ -122,6 +122,7 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
      */
     memory?: MemoryAgent | MemoryAgent[];
     afs?: true | AFSOptions | AFS | ((afs: AFS) => AFS);
+    afsConfig?: AFSConfig;
     asyncMemoryRecord?: boolean;
     /**
      * Maximum number of memory items to retrieve
@@ -130,6 +131,10 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
     hooks?: AgentHooks<I, O> | AgentHooks<I, O>[];
     retryOnError?: Agent<I, O>["retryOnError"] | boolean;
 }
+export interface AFSConfig {
+    injectHistory?: boolean;
+    historyWindowSize?: number;
+}
 export declare const agentOptionsSchema: ZodObject<{
     [key in keyof AgentOptions]: ZodType<AgentOptions[key]>;
 }>;
@@ -212,6 +217,7 @@ export declare abstract class Agent<I extends Message = any, O extends Message =
      */
     readonly memories: MemoryAgent[];
     afs?: AFS;
+    afsConfig?: AFSConfig;
     asyncMemoryRecord?: boolean;
     tag?: string;
     /**

package/lib/cjs/agents/agent.js

@@ -161,6 +161,7 @@ class Agent {
                     : options.afs instanceof afs_1.AFS
                         ? options.afs
                         : new afs_1.AFS(options.afs);
+        this.afsConfig = options.afsConfig;
         this.asyncMemoryRecord = options.asyncMemoryRecord;
         this.maxRetrieveMemoryCount = options.maxRetrieveMemoryCount;
         this.hooks = (0, type_utils_js_1.flat)(options.hooks);
@@ -179,6 +180,7 @@ class Agent {
      */
     memories = [];
     afs;
+    afsConfig;
     asyncMemoryRecord;
     tag;
     /**

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

@@ -1,6 +1,6 @@
 import type { AFSOptions } from "@aigne/afs";
 import { type ZodType, z } from "zod";
-import type { AgentHooks, FunctionAgentFn, TaskRenderMode } from "../agents/agent.js";
+import type { AFSConfig, AgentHooks, FunctionAgentFn, TaskRenderMode } from "../agents/agent.js";
 import { AIAgentToolChoice } from "../agents/ai-agent.js";
 import { type Role } from "../agents/chat-model.js";
 import { ProcessMode, type ReflectionMode } from "../agents/team-agent.js";
@@ -44,6 +44,7 @@ export interface BaseAgentSchema {
     afs?: boolean | (Omit<AFSOptions, "modules"> & {
         modules?: AFSModuleSchema[];
     });
+    afsConfig?: AFSConfig;
 }
 export type Instructions = {
     role: Exclude<Role, "tool">;

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

@@ -68,6 +68,10 @@ async function parseAgentFile(path, data) {
                     ]))),
                 })),
             ])),
+            afsConfig: (0, schema_js_1.optionalize)((0, schema_js_1.camelizeSchema)(zod_1.z.object({
+                injectHistory: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
+                historyWindowSize: (0, schema_js_1.optionalize)(zod_1.z.number().int().min(1)),
+            }))),
         });
         const instructionItemSchema = zod_1.z.union([
             zod_1.z.object({

package/lib/cjs/prompt/prompt-builder.d.ts

@@ -31,6 +31,7 @@ export declare class PromptBuilder {
         prompt: string;
     }>;
     private buildMessages;
+    private mergeSystemMessages;
     private convertMemoriesToMessages;
     private buildResponseFormat;
     private buildTools;

package/lib/cjs/prompt/prompt-builder.js

@@ -102,17 +102,19 @@ class PromptBuilder {
             memories.push(...options.context.memories);
         }
         if (options.agent?.afs) {
-            const history = await options.agent.afs.list(afs_1.AFSHistory.Path, {
-                limit: options.agent.maxRetrieveMemoryCount ?? 10,
-                orderBy: [["createdAt", "desc"]],
-            });
-            if (message) {
-                const result = await options.agent.afs.search("/", message);
-                const ms = result.list.map((entry) => ({ content: (0, yaml_1.stringify)(entry.content) }));
-                memories.push(...ms);
-            }
-            memories.push(...history.list.filter((i) => (0, type_utils_js_1.isNonNullable)(i.content)));
             messages.push(template_js_1.SystemMessageTemplate.from(await (0, afs_builtin_prompt_js_1.getAFSSystemPrompt)(options.agent.afs)));
+            if (options.agent.afsConfig?.injectHistory) {
+                const history = await options.agent.afs.list(afs_1.AFSHistory.Path, {
+                    limit: options.agent.afsConfig.historyWindowSize || 10,
+                    orderBy: [["createdAt", "desc"]],
+                });
+                if (message) {
+                    const result = await options.agent.afs.search("/", message);
+                    const ms = result.list.map((entry) => ({ content: (0, yaml_1.stringify)(entry.content) }));
+                    memories.push(...ms);
+                }
+                memories.push(...history.list.filter((i) => (0, type_utils_js_1.isNonNullable)(i.content)));
+            }
         }
         if (memories.length)
             messages.push(...(await this.convertMemoriesToMessages(memories, options)));
@@ -136,7 +138,25 @@ class PromptBuilder {
                 content.push(...files);
             messages.push({ role: "user", content });
         }
-        return messages;
+        return this.mergeSystemMessages(messages);
+    }
+    mergeSystemMessages(messages) {
+        const [systemMessages, otherMessages] = (0, type_utils_js_1.partition)(messages, (m) => m.role === "system");
+        const result = [];
+        if (systemMessages.length) {
+            result.push({
+                role: "system",
+                content: systemMessages
+                    .map((i) => typeof i.content === "string"
+                    ? i.content
+                    : i.content
+                        ?.map((c) => (c.type === "text" ? c.text : null))
+                        .filter(type_utils_js_1.isNonNullable)
+                        .join("\n"))
+                    .join("\n"),
+            });
+        }
+        return result.concat(otherMessages);
     }
     async convertMemoriesToMessages(memories, options) {
         const messages = [];

package/lib/cjs/utils/type-utils.d.ts

@@ -27,3 +27,4 @@ export declare function createAccessorArray<T>(array: T[], accessor: (array: T[]
 export declare function checkArguments<T extends ZodType>(prefix: string, schema: T, args: unknown): z.infer<T>;
 export declare function tryOrThrow<P extends PromiseOrValue<unknown>>(fn: () => P, error: string | Error | ((error: Error) => Error)): P;
 export declare function tryOrThrow<P extends PromiseOrValue<unknown>>(fn: () => P, error?: Nullish<string | Error | ((error: Error) => Nullish<Error>)>): P | undefined;
+export declare function partition<T>(array: T[], predicate: (item: T) => boolean): [T[], T[]];

package/lib/cjs/utils/type-utils.js

@@ -17,6 +17,7 @@ exports.flat = flat;
 exports.createAccessorArray = createAccessorArray;
 exports.checkArguments = checkArguments;
 exports.tryOrThrow = tryOrThrow;
+exports.partition = partition;
 const zod_1 = require("zod");
 function isNil(value) {
     return value === null || value === undefined;
@@ -196,3 +197,16 @@ function tryOrThrow(fn, error) {
             throw error;
     }
 }
+function partition(array, predicate) {
+    const pass = [];
+    const fail = [];
+    for (const item of array) {
+        if (predicate(item)) {
+            pass.push(item);
+        }
+        else {
+            fail.push(item);
+        }
+    }
+    return [pass, fail];
+}

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

@@ -122,6 +122,7 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
      */
     memory?: MemoryAgent | MemoryAgent[];
     afs?: true | AFSOptions | AFS | ((afs: AFS) => AFS);
+    afsConfig?: AFSConfig;
     asyncMemoryRecord?: boolean;
     /**
      * Maximum number of memory items to retrieve
@@ -130,6 +131,10 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
     hooks?: AgentHooks<I, O> | AgentHooks<I, O>[];
     retryOnError?: Agent<I, O>["retryOnError"] | boolean;
 }
+export interface AFSConfig {
+    injectHistory?: boolean;
+    historyWindowSize?: number;
+}
 export declare const agentOptionsSchema: ZodObject<{
     [key in keyof AgentOptions]: ZodType<AgentOptions[key]>;
 }>;
@@ -212,6 +217,7 @@ export declare abstract class Agent<I extends Message = any, O extends Message =
      */
     readonly memories: MemoryAgent[];
     afs?: AFS;
+    afsConfig?: AFSConfig;
     asyncMemoryRecord?: boolean;
     tag?: string;
     /**

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

@@ -1,6 +1,6 @@
 import type { AFSOptions } from "@aigne/afs";
 import { type ZodType, z } from "zod";
-import type { AgentHooks, FunctionAgentFn, TaskRenderMode } from "../agents/agent.js";
+import type { AFSConfig, AgentHooks, FunctionAgentFn, TaskRenderMode } from "../agents/agent.js";
 import { AIAgentToolChoice } from "../agents/ai-agent.js";
 import { type Role } from "../agents/chat-model.js";
 import { ProcessMode, type ReflectionMode } from "../agents/team-agent.js";
@@ -44,6 +44,7 @@ export interface BaseAgentSchema {
     afs?: boolean | (Omit<AFSOptions, "modules"> & {
         modules?: AFSModuleSchema[];
     });
+    afsConfig?: AFSConfig;
 }
 export type Instructions = {
     role: Exclude<Role, "tool">;

package/lib/dts/prompt/prompt-builder.d.ts

@@ -31,6 +31,7 @@ export declare class PromptBuilder {
         prompt: string;
     }>;
     private buildMessages;
+    private mergeSystemMessages;
     private convertMemoriesToMessages;
     private buildResponseFormat;
     private buildTools;

package/lib/dts/utils/type-utils.d.ts

@@ -27,3 +27,4 @@ export declare function createAccessorArray<T>(array: T[], accessor: (array: T[]
 export declare function checkArguments<T extends ZodType>(prefix: string, schema: T, args: unknown): z.infer<T>;
 export declare function tryOrThrow<P extends PromiseOrValue<unknown>>(fn: () => P, error: string | Error | ((error: Error) => Error)): P;
 export declare function tryOrThrow<P extends PromiseOrValue<unknown>>(fn: () => P, error?: Nullish<string | Error | ((error: Error) => Nullish<Error>)>): P | undefined;
+export declare function partition<T>(array: T[], predicate: (item: T) => boolean): [T[], T[]];

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

@@ -122,6 +122,7 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
      */
     memory?: MemoryAgent | MemoryAgent[];
     afs?: true | AFSOptions | AFS | ((afs: AFS) => AFS);
+    afsConfig?: AFSConfig;
     asyncMemoryRecord?: boolean;
     /**
      * Maximum number of memory items to retrieve
@@ -130,6 +131,10 @@ export interface AgentOptions<I extends Message = Message, O extends Message = M
     hooks?: AgentHooks<I, O> | AgentHooks<I, O>[];
     retryOnError?: Agent<I, O>["retryOnError"] | boolean;
 }
+export interface AFSConfig {
+    injectHistory?: boolean;
+    historyWindowSize?: number;
+}
 export declare const agentOptionsSchema: ZodObject<{
     [key in keyof AgentOptions]: ZodType<AgentOptions[key]>;
 }>;
@@ -212,6 +217,7 @@ export declare abstract class Agent<I extends Message = any, O extends Message =
      */
     readonly memories: MemoryAgent[];
     afs?: AFS;
+    afsConfig?: AFSConfig;
     asyncMemoryRecord?: boolean;
     tag?: string;
     /**

package/lib/esm/agents/agent.js

@@ -113,6 +113,7 @@ export class Agent {
                     : options.afs instanceof AFS
                         ? options.afs
                         : new AFS(options.afs);
+        this.afsConfig = options.afsConfig;
         this.asyncMemoryRecord = options.asyncMemoryRecord;
         this.maxRetrieveMemoryCount = options.maxRetrieveMemoryCount;
         this.hooks = flat(options.hooks);
@@ -131,6 +132,7 @@ export class Agent {
      */
     memories = [];
     afs;
+    afsConfig;
     asyncMemoryRecord;
     tag;
     /**

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

@@ -1,6 +1,6 @@
 import type { AFSOptions } from "@aigne/afs";
 import { type ZodType, z } from "zod";
-import type { AgentHooks, FunctionAgentFn, TaskRenderMode } from "../agents/agent.js";
+import type { AFSConfig, AgentHooks, FunctionAgentFn, TaskRenderMode } from "../agents/agent.js";
 import { AIAgentToolChoice } from "../agents/ai-agent.js";
 import { type Role } from "../agents/chat-model.js";
 import { ProcessMode, type ReflectionMode } from "../agents/team-agent.js";
@@ -44,6 +44,7 @@ export interface BaseAgentSchema {
     afs?: boolean | (Omit<AFSOptions, "modules"> & {
         modules?: AFSModuleSchema[];
     });
+    afsConfig?: AFSConfig;
 }
 export type Instructions = {
     role: Exclude<Role, "tool">;

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

@@ -64,6 +64,10 @@ export async function parseAgentFile(path, data) {
                     ]))),
                 })),
             ])),
+            afsConfig: optionalize(camelizeSchema(z.object({
+                injectHistory: optionalize(z.boolean()),
+                historyWindowSize: optionalize(z.number().int().min(1)),
+            }))),
         });
         const instructionItemSchema = z.union([
             z.object({

package/lib/esm/prompt/prompt-builder.d.ts

@@ -31,6 +31,7 @@ export declare class PromptBuilder {
         prompt: string;
     }>;
     private buildMessages;
+    private mergeSystemMessages;
     private convertMemoriesToMessages;
     private buildResponseFormat;
     private buildTools;

package/lib/esm/prompt/prompt-builder.js

@@ -8,7 +8,7 @@ import { DEFAULT_OUTPUT_FILE_KEY, DEFAULT_OUTPUT_KEY } from "../agents/ai-agent.
 import { fileUnionContentsSchema } from "../agents/model.js";
 import { optionalize } from "../loader/schema.js";
 import { outputSchemaToResponseFormatSchema } from "../utils/json-schema.js";
-import { checkArguments, flat, isNonNullable, isRecord, unique } from "../utils/type-utils.js";
+import { checkArguments, flat, isNonNullable, isRecord, partition, unique, } from "../utils/type-utils.js";
 import { getAFSSystemPrompt } from "./prompts/afs-builtin-prompt.js";
 import { MEMORY_MESSAGE_TEMPLATE } from "./prompts/memory-message-template.js";
 import { STRUCTURED_STREAM_INSTRUCTIONS } from "./prompts/structured-stream-instructions.js";
@@ -99,17 +99,19 @@ export class PromptBuilder {
             memories.push(...options.context.memories);
         }
         if (options.agent?.afs) {
-            const history = await options.agent.afs.list(AFSHistory.Path, {
-                limit: options.agent.maxRetrieveMemoryCount ?? 10,
-                orderBy: [["createdAt", "desc"]],
-            });
-            if (message) {
-                const result = await options.agent.afs.search("/", message);
-                const ms = result.list.map((entry) => ({ content: stringify(entry.content) }));
-                memories.push(...ms);
-            }
-            memories.push(...history.list.filter((i) => isNonNullable(i.content)));
             messages.push(SystemMessageTemplate.from(await getAFSSystemPrompt(options.agent.afs)));
+            if (options.agent.afsConfig?.injectHistory) {
+                const history = await options.agent.afs.list(AFSHistory.Path, {
+                    limit: options.agent.afsConfig.historyWindowSize || 10,
+                    orderBy: [["createdAt", "desc"]],
+                });
+                if (message) {
+                    const result = await options.agent.afs.search("/", message);
+                    const ms = result.list.map((entry) => ({ content: stringify(entry.content) }));
+                    memories.push(...ms);
+                }
+                memories.push(...history.list.filter((i) => isNonNullable(i.content)));
+            }
         }
         if (memories.length)
             messages.push(...(await this.convertMemoriesToMessages(memories, options)));
@@ -133,7 +135,25 @@ export class PromptBuilder {
                 content.push(...files);
             messages.push({ role: "user", content });
         }
-        return messages;
+        return this.mergeSystemMessages(messages);
+    }
+    mergeSystemMessages(messages) {
+        const [systemMessages, otherMessages] = partition(messages, (m) => m.role === "system");
+        const result = [];
+        if (systemMessages.length) {
+            result.push({
+                role: "system",
+                content: systemMessages
+                    .map((i) => typeof i.content === "string"
+                    ? i.content
+                    : i.content
+                        ?.map((c) => (c.type === "text" ? c.text : null))
+                        .filter(isNonNullable)
+                        .join("\n"))
+                    .join("\n"),
+            });
+        }
+        return result.concat(otherMessages);
     }
     async convertMemoriesToMessages(memories, options) {
         const messages = [];

package/lib/esm/utils/type-utils.d.ts

@@ -27,3 +27,4 @@ export declare function createAccessorArray<T>(array: T[], accessor: (array: T[]
 export declare function checkArguments<T extends ZodType>(prefix: string, schema: T, args: unknown): z.infer<T>;
 export declare function tryOrThrow<P extends PromiseOrValue<unknown>>(fn: () => P, error: string | Error | ((error: Error) => Error)): P;
 export declare function tryOrThrow<P extends PromiseOrValue<unknown>>(fn: () => P, error?: Nullish<string | Error | ((error: Error) => Nullish<Error>)>): P | undefined;
+export declare function partition<T>(array: T[], predicate: (item: T) => boolean): [T[], T[]];

package/lib/esm/utils/type-utils.js

@@ -177,3 +177,16 @@ export function tryOrThrow(fn, error) {
             throw error;
     }
 }
+export function partition(array, predicate) {
+    const pass = [];
+    const fail = [];
+    for (const item of array) {
+        if (predicate(item)) {
+            pass.push(item);
+        }
+        else {
+            fail.push(item);
+        }
+    }
+    return [pass, fail];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.63.0-beta.3",
+  "version": "1.63.0-beta.5",
   "description": "The functional core of agentic AI",
   "publishConfig": {
     "access": "public"
@@ -92,9 +92,9 @@
     "zod": "^3.25.67",
     "zod-from-json-schema": "^0.0.5",
     "zod-to-json-schema": "^3.24.6",
+    "@aigne/afs": "^1.1.0-beta",
     "@aigne/observability-api": "^0.11.2-beta.1",
-    "@aigne/platform-helpers": "^0.6.3",
-    "@aigne/afs": "^1.1.0-beta"
+    "@aigne/platform-helpers": "^0.6.3"
   },
   "devDependencies": {
     "@types/bun": "^1.2.22",