@aigne/afs-history 1.2.0-beta.8 → 1.2.0

package/CHANGELOG.md

@@ -6,6 +6,89 @@
   * dependencies
     * @aigne/afs bumped to 1.2.0
 
+## [1.2.0](https://github.com/AIGNE-io/aigne-framework/compare/afs-history-v1.2.0-beta.12...afs-history-v1.2.0) (2026-01-16)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0
+    * @aigne/sqlite bumped to 0.4.9
+
+## [1.2.0-beta.12](https://github.com/AIGNE-io/aigne-framework/compare/afs-history-v1.2.0-beta.11...afs-history-v1.2.0-beta.12) (2026-01-16)
+
+
+### Features
+
+* add session compact support for AIAgent ([#863](https://github.com/AIGNE-io/aigne-framework/issues/863)) ([9010918](https://github.com/AIGNE-io/aigne-framework/commit/9010918cd3f18b02b5c60ddc9ed5c34b568d0b28))
+* **afs:** add module access control and schema validation support ([#904](https://github.com/AIGNE-io/aigne-framework/issues/904)) ([d0b279a](https://github.com/AIGNE-io/aigne-framework/commit/d0b279aac07ebe2bcc1fd4148498fc3f6bbcd561))
+* **afs:** support expand context into prompt template by call `$afs.xxx` ([#830](https://github.com/AIGNE-io/aigne-framework/issues/830)) ([5616acd](https://github.com/AIGNE-io/aigne-framework/commit/5616acd6ea257c91aa0b766608f45c5ce17f0345))
+* **core:** add cross session user memory support ([#873](https://github.com/AIGNE-io/aigne-framework/issues/873)) ([f377aa1](https://github.com/AIGNE-io/aigne-framework/commit/f377aa17f2cf8004fd3225ade4a37fd90af1292f))
+* **core:** add session history support ([#858](https://github.com/AIGNE-io/aigne-framework/issues/858)) ([28a070e](https://github.com/AIGNE-io/aigne-framework/commit/28a070ed33b821d1fd344b899706d817ca992b9f))
+* support mount mcp agent into AFS ([#740](https://github.com/AIGNE-io/aigne-framework/issues/740)) ([6d474fc](https://github.com/AIGNE-io/aigne-framework/commit/6d474fc05845a15e2c3e8fa97727b409bdd70945))
+
+
+### Bug Fixes
+
+* **afs:** support read binary file as base64 string ([3480f9f](https://github.com/AIGNE-io/aigne-framework/commit/3480f9fe90647eba3bf2ff37e22c334599b72e35))
+* bump version ([696560f](https://github.com/AIGNE-io/aigne-framework/commit/696560fa2673eddcb4d00ac0523fbbbde7273cb3))
+* bump version ([70d217c](https://github.com/AIGNE-io/aigne-framework/commit/70d217c8360dd0dda7f5f17011c4e92ec836e801))
+* bump version ([af04b69](https://github.com/AIGNE-io/aigne-framework/commit/af04b6931951afa35d52065430acc7fef4b10087))
+* bump version ([ba7ad18](https://github.com/AIGNE-io/aigne-framework/commit/ba7ad184fcf32b49bf0507a3cb638d20fb00690d))
+* bump version ([93a1c10](https://github.com/AIGNE-io/aigne-framework/commit/93a1c10cf35f88eaafe91092481f5d087bd5b3a9))
+* improve test coverage tracking and reporting ([#903](https://github.com/AIGNE-io/aigne-framework/issues/903)) ([031144e](https://github.com/AIGNE-io/aigne-framework/commit/031144e74f29e882cffe52ffda8f7a18c76ace7f))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.11
+
+## [1.2.0-beta.11](https://github.com/AIGNE-io/aigne-framework/compare/afs-history-v1.2.0-beta.10...afs-history-v1.2.0-beta.11) (2026-01-16)
+
+
+### Bug Fixes
+
+* **afs:** support read binary file as base64 string ([3480f9f](https://github.com/AIGNE-io/aigne-framework/commit/3480f9fe90647eba3bf2ff37e22c334599b72e35))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.10
+
+## [1.2.0-beta.10](https://github.com/AIGNE-io/aigne-framework/compare/afs-history-v1.2.0-beta.9...afs-history-v1.2.0-beta.10) (2026-01-14)
+
+
+### Features
+
+* **afs:** add module access control and schema validation support ([#904](https://github.com/AIGNE-io/aigne-framework/issues/904)) ([d0b279a](https://github.com/AIGNE-io/aigne-framework/commit/d0b279aac07ebe2bcc1fd4148498fc3f6bbcd561))
+
+
+### Bug Fixes
+
+* improve test coverage tracking and reporting ([#903](https://github.com/AIGNE-io/aigne-framework/issues/903)) ([031144e](https://github.com/AIGNE-io/aigne-framework/commit/031144e74f29e882cffe52ffda8f7a18c76ace7f))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.9
+    * @aigne/sqlite bumped to 0.4.9-beta.2
+
+## [1.2.0-beta.9](https://github.com/AIGNE-io/aigne-framework/compare/afs-history-v1.2.0-beta.8...afs-history-v1.2.0-beta.9) (2026-01-12)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.8
+
 ## [1.2.0-beta.8](https://github.com/AIGNE-io/aigne-framework/compare/afs-history-v1.2.0-beta.7...afs-history-v1.2.0-beta.8) (2026-01-08)
 
 

package/lib/cjs/index.d.ts

@@ -1,12 +1,40 @@
-import type { AFSDeleteOptions, AFSDeleteResult, AFSListOptions, AFSListResult, AFSModule, AFSReadOptions, AFSReadResult, AFSRoot, AFSWriteEntryPayload, AFSWriteResult } from "@aigne/afs";
+import { type AFSAccessMode, type AFSDeleteOptions, type AFSDeleteResult, type AFSListOptions, type AFSListResult, type AFSModule, type AFSModuleLoadParams, type AFSReadOptions, type AFSReadResult, type AFSRoot, type AFSWriteEntryPayload, type AFSWriteOptions, type AFSWriteResult } from "@aigne/afs";
+import { z } from "zod";
 import { SharedAFSStorage, type SharedAFSStorageOptions } from "./storage/index.js";
 export * from "./storage/index.js";
 export interface AFSHistoryOptions {
     storage?: SharedAFSStorage | SharedAFSStorageOptions;
+    /**
+     * Access mode for this module.
+     * @default "readwrite"
+     */
+    accessMode?: AFSAccessMode;
 }
 export declare class AFSHistory implements AFSModule {
+    static schema(): z.ZodObject<{
+        storage: z.ZodOptional<z.ZodObject<{
+            url: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            url?: string | undefined;
+        }, {
+            url?: string | undefined;
+        }>>;
+        accessMode: z.ZodOptional<z.ZodEnum<["readonly", "readwrite"]>>;
+    }, "strip", z.ZodTypeAny, {
+        storage?: {
+            url?: string | undefined;
+        } | undefined;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }, {
+        storage?: {
+            url?: string | undefined;
+        } | undefined;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }>;
+    static load({ parsed }: AFSModuleLoadParams): Promise<AFSHistory>;
     constructor(options?: AFSHistoryOptions);
     readonly name: string;
+    readonly accessMode: AFSAccessMode;
     private storage;
     private afs?;
     private router;
@@ -14,7 +42,7 @@ export declare class AFSHistory implements AFSModule {
     onMount(afs: AFSRoot): void;
     list(path: string, options?: AFSListOptions): Promise<AFSListResult>;
     read(path: string, options?: AFSReadOptions): Promise<AFSReadResult>;
-    write(path: string, content: AFSWriteEntryPayload): Promise<AFSWriteResult>;
+    write(path: string, content: AFSWriteEntryPayload, options: AFSWriteOptions): Promise<AFSWriteResult>;
     delete(path: string, _options?: AFSDeleteOptions): Promise<AFSDeleteResult>;
     private normalizePath;
 }

package/lib/cjs/index.js

@@ -15,19 +15,42 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AFSHistory = void 0;
+const afs_1 = require("@aigne/afs");
 const uuid_1 = require("@aigne/uuid");
 const radix3_1 = require("radix3");
 const ufo_1 = require("ufo");
+const zod_1 = require("zod");
 const index_js_1 = require("./storage/index.js");
 __exportStar(require("./storage/index.js"), exports);
+const sharedAFSStorageOptionsSchema = zod_1.z.object({
+    url: zod_1.z.string().describe("Database URL for storage").optional(),
+});
+const afsHistoryOptionsSchema = preprocessSchema((v) => {
+    if (!v || typeof v !== "object") {
+        return v;
+    }
+    return { ...v, accessMode: v.accessMode || v.access_mode };
+}, zod_1.z.object({
+    storage: sharedAFSStorageOptionsSchema.optional(),
+    accessMode: afs_1.accessModeSchema,
+}));
 class AFSHistory {
+    static schema() {
+        return afsHistoryOptionsSchema;
+    }
+    static async load({ parsed }) {
+        const valid = await AFSHistory.schema().parseAsync(parsed);
+        return new AFSHistory(valid);
+    }
     constructor(options) {
         this.storage =
             options?.storage instanceof index_js_1.SharedAFSStorage
                 ? options.storage.withModule(this)
                 : new index_js_1.SharedAFSStorage(options?.storage).withModule(this);
+        this.accessMode = options?.accessMode ?? "readwrite";
     }
     name = "history";
+    accessMode;
     storage;
     afs;
     router = (0, radix3_1.createRouter)({
@@ -176,7 +199,7 @@ class AFSHistory {
             },
         };
     }
-    async write(path, content) {
+    async write(path, content, options) {
         const id = (0, uuid_1.v7)();
         const match = this.router.lookup(path);
         if (!match || match.action !== "create") {
@@ -197,7 +220,7 @@ class AFSHistory {
         }, { type, scope });
         // Emit event for history entries
         if (type === "history") {
-            this.afs?.emit("historyCreated", { entry });
+            this.afs?.emit("historyCreated", { entry }, options);
         }
         return {
             data: {
@@ -252,3 +275,7 @@ class AFSHistory {
     }
 }
 exports.AFSHistory = AFSHistory;
+const _typeCheck = AFSHistory;
+function preprocessSchema(fn, schema) {
+    return zod_1.z.preprocess(fn, schema);
+}

package/lib/dts/index.d.ts

@@ -1,12 +1,40 @@
-import type { AFSDeleteOptions, AFSDeleteResult, AFSListOptions, AFSListResult, AFSModule, AFSReadOptions, AFSReadResult, AFSRoot, AFSWriteEntryPayload, AFSWriteResult } from "@aigne/afs";
+import { type AFSAccessMode, type AFSDeleteOptions, type AFSDeleteResult, type AFSListOptions, type AFSListResult, type AFSModule, type AFSModuleLoadParams, type AFSReadOptions, type AFSReadResult, type AFSRoot, type AFSWriteEntryPayload, type AFSWriteOptions, type AFSWriteResult } from "@aigne/afs";
+import { z } from "zod";
 import { SharedAFSStorage, type SharedAFSStorageOptions } from "./storage/index.js";
 export * from "./storage/index.js";
 export interface AFSHistoryOptions {
     storage?: SharedAFSStorage | SharedAFSStorageOptions;
+    /**
+     * Access mode for this module.
+     * @default "readwrite"
+     */
+    accessMode?: AFSAccessMode;
 }
 export declare class AFSHistory implements AFSModule {
+    static schema(): z.ZodObject<{
+        storage: z.ZodOptional<z.ZodObject<{
+            url: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            url?: string | undefined;
+        }, {
+            url?: string | undefined;
+        }>>;
+        accessMode: z.ZodOptional<z.ZodEnum<["readonly", "readwrite"]>>;
+    }, "strip", z.ZodTypeAny, {
+        storage?: {
+            url?: string | undefined;
+        } | undefined;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }, {
+        storage?: {
+            url?: string | undefined;
+        } | undefined;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }>;
+    static load({ parsed }: AFSModuleLoadParams): Promise<AFSHistory>;
     constructor(options?: AFSHistoryOptions);
     readonly name: string;
+    readonly accessMode: AFSAccessMode;
     private storage;
     private afs?;
     private router;
@@ -14,7 +42,7 @@ export declare class AFSHistory implements AFSModule {
     onMount(afs: AFSRoot): void;
     list(path: string, options?: AFSListOptions): Promise<AFSListResult>;
     read(path: string, options?: AFSReadOptions): Promise<AFSReadResult>;
-    write(path: string, content: AFSWriteEntryPayload): Promise<AFSWriteResult>;
+    write(path: string, content: AFSWriteEntryPayload, options: AFSWriteOptions): Promise<AFSWriteResult>;
     delete(path: string, _options?: AFSDeleteOptions): Promise<AFSDeleteResult>;
     private normalizePath;
 }

package/lib/esm/index.d.ts

@@ -1,12 +1,40 @@
-import type { AFSDeleteOptions, AFSDeleteResult, AFSListOptions, AFSListResult, AFSModule, AFSReadOptions, AFSReadResult, AFSRoot, AFSWriteEntryPayload, AFSWriteResult } from "@aigne/afs";
+import { type AFSAccessMode, type AFSDeleteOptions, type AFSDeleteResult, type AFSListOptions, type AFSListResult, type AFSModule, type AFSModuleLoadParams, type AFSReadOptions, type AFSReadResult, type AFSRoot, type AFSWriteEntryPayload, type AFSWriteOptions, type AFSWriteResult } from "@aigne/afs";
+import { z } from "zod";
 import { SharedAFSStorage, type SharedAFSStorageOptions } from "./storage/index.js";
 export * from "./storage/index.js";
 export interface AFSHistoryOptions {
     storage?: SharedAFSStorage | SharedAFSStorageOptions;
+    /**
+     * Access mode for this module.
+     * @default "readwrite"
+     */
+    accessMode?: AFSAccessMode;
 }
 export declare class AFSHistory implements AFSModule {
+    static schema(): z.ZodObject<{
+        storage: z.ZodOptional<z.ZodObject<{
+            url: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            url?: string | undefined;
+        }, {
+            url?: string | undefined;
+        }>>;
+        accessMode: z.ZodOptional<z.ZodEnum<["readonly", "readwrite"]>>;
+    }, "strip", z.ZodTypeAny, {
+        storage?: {
+            url?: string | undefined;
+        } | undefined;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }, {
+        storage?: {
+            url?: string | undefined;
+        } | undefined;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }>;
+    static load({ parsed }: AFSModuleLoadParams): Promise<AFSHistory>;
     constructor(options?: AFSHistoryOptions);
     readonly name: string;
+    readonly accessMode: AFSAccessMode;
     private storage;
     private afs?;
     private router;
@@ -14,7 +42,7 @@ export declare class AFSHistory implements AFSModule {
     onMount(afs: AFSRoot): void;
     list(path: string, options?: AFSListOptions): Promise<AFSListResult>;
     read(path: string, options?: AFSReadOptions): Promise<AFSReadResult>;
-    write(path: string, content: AFSWriteEntryPayload): Promise<AFSWriteResult>;
+    write(path: string, content: AFSWriteEntryPayload, options: AFSWriteOptions): Promise<AFSWriteResult>;
     delete(path: string, _options?: AFSDeleteOptions): Promise<AFSDeleteResult>;
     private normalizePath;
 }

package/lib/esm/index.js

@@ -1,16 +1,39 @@
+import { accessModeSchema, } from "@aigne/afs";
 import { v7 } from "@aigne/uuid";
 import { createRouter } from "radix3";
 import { joinURL } from "ufo";
+import { z } from "zod";
 import { SharedAFSStorage, } from "./storage/index.js";
 export * from "./storage/index.js";
+const sharedAFSStorageOptionsSchema = z.object({
+    url: z.string().describe("Database URL for storage").optional(),
+});
+const afsHistoryOptionsSchema = preprocessSchema((v) => {
+    if (!v || typeof v !== "object") {
+        return v;
+    }
+    return { ...v, accessMode: v.accessMode || v.access_mode };
+}, z.object({
+    storage: sharedAFSStorageOptionsSchema.optional(),
+    accessMode: accessModeSchema,
+}));
 export class AFSHistory {
+    static schema() {
+        return afsHistoryOptionsSchema;
+    }
+    static async load({ parsed }) {
+        const valid = await AFSHistory.schema().parseAsync(parsed);
+        return new AFSHistory(valid);
+    }
     constructor(options) {
         this.storage =
             options?.storage instanceof SharedAFSStorage
                 ? options.storage.withModule(this)
                 : new SharedAFSStorage(options?.storage).withModule(this);
+        this.accessMode = options?.accessMode ?? "readwrite";
     }
     name = "history";
+    accessMode;
     storage;
     afs;
     router = createRouter({
@@ -159,7 +182,7 @@ export class AFSHistory {
             },
         };
     }
-    async write(path, content) {
+    async write(path, content, options) {
         const id = v7();
         const match = this.router.lookup(path);
         if (!match || match.action !== "create") {
@@ -180,7 +203,7 @@ export class AFSHistory {
         }, { type, scope });
         // Emit event for history entries
         if (type === "history") {
-            this.afs?.emit("historyCreated", { entry });
+            this.afs?.emit("historyCreated", { entry }, options);
         }
         return {
             data: {
@@ -234,3 +257,7 @@ export class AFSHistory {
         return joinURL("/", prefix, scopeId, entry.id);
     }
 }
+const _typeCheck = AFSHistory;
+function preprocessSchema(fn, schema) {
+    return z.preprocess(fn, schema);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/afs-history",
-  "version": "1.2.0-beta.8",
+  "version": "1.2.0",
   "description": "AIGNE AFS module for managing chat history",
   "publishConfig": {
     "access": "public"
@@ -50,8 +50,9 @@
     "@aigne/uuid": "^13.0.1",
     "radix3": "^1.1.2",
     "ufo": "^1.6.1",
-    "@aigne/sqlite": "^0.4.9-beta.1",
-    "@aigne/afs": "^1.4.0-beta.7"
+    "zod": "^3.25.67",
+    "@aigne/afs": "^1.4.0",
+    "@aigne/sqlite": "^0.4.9"
   },
   "devDependencies": {
     "@types/bun": "^1.2.22",