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

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [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.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)));

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/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.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)));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.63.0-beta.3",
+  "version": "1.63.0-beta.4",
   "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",