@aigne/core 1.63.0-beta.6 → 1.63.0-beta.7

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.63.0-beta.7](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.63.0-beta.6...core-v1.63.0-beta.7) (2025-10-15)
+
+
+### Bug Fixes
+
+* add options for system message reordering and merging ([#624](https://github.com/AIGNE-io/aigne-framework/issues/624)) ([8ca466d](https://github.com/AIGNE-io/aigne-framework/commit/8ca466d49d1e4ed08bc90922f39c0d3ed60c4fd5))
+
 ## [1.63.0-beta.6](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.63.0-beta.5...core-v1.63.0-beta.6) (2025-10-15)
 
 

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

@@ -23,6 +23,8 @@ export interface AIAgentOptions<I extends Message = Message, O extends Message =
      * more complex prompt templates
      */
     instructions?: string | PromptBuilder;
+    autoReorderSystemMessages?: boolean;
+    autoMergeSystemMessages?: boolean;
     /**
      * Pick a message from input to use as the user's message
      */
@@ -216,6 +218,8 @@ export declare class AIAgent<I extends Message = any, O extends Message = any> e
      * {@includeCode ../../test/agents/ai-agent.test.ts#example-ai-agent-prompt-builder}
      */
     instructions: PromptBuilder;
+    autoReorderSystemMessages?: boolean;
+    autoMergeSystemMessages?: boolean;
     /**
      * Pick a message from input to use as the user's message
      */

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

@@ -117,6 +117,8 @@ class AIAgent extends agent_js_1.Agent {
             typeof options.instructions === "string"
                 ? prompt_builder_js_1.PromptBuilder.from(options.instructions)
                 : (options.instructions ?? new prompt_builder_js_1.PromptBuilder());
+        this.autoReorderSystemMessages = options.autoReorderSystemMessages ?? false;
+        this.autoMergeSystemMessages = options.autoMergeSystemMessages ?? false;
         this.inputKey = options.inputKey;
         this.inputFileKey = options.inputFileKey;
         this.outputKey = options.outputKey || exports.DEFAULT_OUTPUT_KEY;
@@ -153,6 +155,8 @@ class AIAgent extends agent_js_1.Agent {
      * {@includeCode ../../test/agents/ai-agent.test.ts#example-ai-agent-prompt-builder}
      */
     instructions;
+    autoReorderSystemMessages;
+    autoMergeSystemMessages;
     /**
      * Pick a message from input to use as the user's message
      */

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

@@ -54,6 +54,8 @@ export type Instructions = {
 export interface AIAgentSchema extends BaseAgentSchema {
     type: "ai";
     instructions?: Instructions;
+    autoReorderSystemMessages?: boolean;
+    autoMergeSystemMessages?: boolean;
     inputKey?: string;
     inputFileKey?: string;
     outputKey?: string;

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

@@ -112,6 +112,8 @@ async function parseAgentFile(path, data) {
                 .object({
                 type: zod_1.z.literal("ai"),
                 instructions: (0, schema_js_1.optionalize)(instructionsSchema),
+                autoReorderSystemMessages: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
+                autoMergeSystemMessages: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
                 inputKey: (0, schema_js_1.optionalize)(zod_1.z.string()),
                 outputKey: (0, schema_js_1.optionalize)(zod_1.z.string()),
                 inputFileKey: (0, schema_js_1.optionalize)(zod_1.z.string()),

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

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

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

@@ -138,10 +138,16 @@ class PromptBuilder {
                 content.push(...files);
             messages.push({ role: "user", content });
         }
-        return this.mergeSystemMessages(messages);
+        return this.refineMessages(options, messages);
     }
-    mergeSystemMessages(messages) {
+    refineMessages(options, messages) {
+        const { autoReorderSystemMessages, autoMergeSystemMessages } = options.agent ?? {};
+        if (!autoReorderSystemMessages && !autoMergeSystemMessages)
+            return messages;
         const [systemMessages, otherMessages] = (0, type_utils_js_1.partition)(messages, (m) => m.role === "system");
+        if (!autoMergeSystemMessages) {
+            return systemMessages.concat(otherMessages);
+        }
         const result = [];
         if (systemMessages.length) {
             result.push({

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

@@ -23,6 +23,8 @@ export interface AIAgentOptions<I extends Message = Message, O extends Message =
      * more complex prompt templates
      */
     instructions?: string | PromptBuilder;
+    autoReorderSystemMessages?: boolean;
+    autoMergeSystemMessages?: boolean;
     /**
      * Pick a message from input to use as the user's message
      */
@@ -216,6 +218,8 @@ export declare class AIAgent<I extends Message = any, O extends Message = any> e
      * {@includeCode ../../test/agents/ai-agent.test.ts#example-ai-agent-prompt-builder}
      */
     instructions: PromptBuilder;
+    autoReorderSystemMessages?: boolean;
+    autoMergeSystemMessages?: boolean;
     /**
      * Pick a message from input to use as the user's message
      */

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

@@ -54,6 +54,8 @@ export type Instructions = {
 export interface AIAgentSchema extends BaseAgentSchema {
     type: "ai";
     instructions?: Instructions;
+    autoReorderSystemMessages?: boolean;
+    autoMergeSystemMessages?: boolean;
     inputKey?: string;
     inputFileKey?: string;
     outputKey?: string;

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

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

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

@@ -23,6 +23,8 @@ export interface AIAgentOptions<I extends Message = Message, O extends Message =
      * more complex prompt templates
      */
     instructions?: string | PromptBuilder;
+    autoReorderSystemMessages?: boolean;
+    autoMergeSystemMessages?: boolean;
     /**
      * Pick a message from input to use as the user's message
      */
@@ -216,6 +218,8 @@ export declare class AIAgent<I extends Message = any, O extends Message = any> e
      * {@includeCode ../../test/agents/ai-agent.test.ts#example-ai-agent-prompt-builder}
      */
     instructions: PromptBuilder;
+    autoReorderSystemMessages?: boolean;
+    autoMergeSystemMessages?: boolean;
     /**
      * Pick a message from input to use as the user's message
      */

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

@@ -111,6 +111,8 @@ export class AIAgent extends Agent {
             typeof options.instructions === "string"
                 ? PromptBuilder.from(options.instructions)
                 : (options.instructions ?? new PromptBuilder());
+        this.autoReorderSystemMessages = options.autoReorderSystemMessages ?? false;
+        this.autoMergeSystemMessages = options.autoMergeSystemMessages ?? false;
         this.inputKey = options.inputKey;
         this.inputFileKey = options.inputFileKey;
         this.outputKey = options.outputKey || DEFAULT_OUTPUT_KEY;
@@ -147,6 +149,8 @@ export class AIAgent extends Agent {
      * {@includeCode ../../test/agents/ai-agent.test.ts#example-ai-agent-prompt-builder}
      */
     instructions;
+    autoReorderSystemMessages;
+    autoMergeSystemMessages;
     /**
      * Pick a message from input to use as the user's message
      */

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

@@ -54,6 +54,8 @@ export type Instructions = {
 export interface AIAgentSchema extends BaseAgentSchema {
     type: "ai";
     instructions?: Instructions;
+    autoReorderSystemMessages?: boolean;
+    autoMergeSystemMessages?: boolean;
     inputKey?: string;
     inputFileKey?: string;
     outputKey?: string;

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

@@ -108,6 +108,8 @@ export async function parseAgentFile(path, data) {
                 .object({
                 type: z.literal("ai"),
                 instructions: optionalize(instructionsSchema),
+                autoReorderSystemMessages: optionalize(z.boolean()),
+                autoMergeSystemMessages: optionalize(z.boolean()),
                 inputKey: optionalize(z.string()),
                 outputKey: optionalize(z.string()),
                 inputFileKey: optionalize(z.string()),

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

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

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

@@ -135,10 +135,16 @@ export class PromptBuilder {
                 content.push(...files);
             messages.push({ role: "user", content });
         }
-        return this.mergeSystemMessages(messages);
+        return this.refineMessages(options, messages);
     }
-    mergeSystemMessages(messages) {
+    refineMessages(options, messages) {
+        const { autoReorderSystemMessages, autoMergeSystemMessages } = options.agent ?? {};
+        if (!autoReorderSystemMessages && !autoMergeSystemMessages)
+            return messages;
         const [systemMessages, otherMessages] = partition(messages, (m) => m.role === "system");
+        if (!autoMergeSystemMessages) {
+            return systemMessages.concat(otherMessages);
+        }
         const result = [];
         if (systemMessages.length) {
             result.push({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.63.0-beta.6",
+  "version": "1.63.0-beta.7",
   "description": "The functional core of agentic AI",
   "publishConfig": {
     "access": "public"
@@ -92,8 +92,8 @@
     "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.2",
+    "@aigne/afs": "^1.1.0-beta",
     "@aigne/platform-helpers": "^0.6.3"
   },
   "devDependencies": {