@aigne/afs-history 1.2.0-beta.9 → 1.3.0-beta

package/CHANGELOG.md

@@ -6,6 +6,94 @@
   * dependencies
     * @aigne/afs bumped to 1.2.0
 
+## [1.3.0-beta](https://github.com/AIGNE-io/aigne-framework/compare/afs-history-v1.2.0...afs-history-v1.3.0-beta) (2026-01-20)
+
+
+### Features
+
+* **afs:** add @aigne/afs-utils package ([#927](https://github.com/AIGNE-io/aigne-framework/issues/927)) ([3922635](https://github.com/AIGNE-io/aigne-framework/commit/3922635981aab4578607c5bf1fb882c8e45725ce))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-utils bumped to 1.0.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)
 
 

package/lib/cjs/index.d.ts

@@ -1,12 +1,33 @@
-import type { AFSDeleteOptions, AFSDeleteResult, AFSListOptions, AFSListResult, AFSModule, AFSReadOptions, AFSReadResult, AFSRoot, AFSWriteEntryPayload, AFSWriteResult } from "@aigne/afs";
-import { SharedAFSStorage, type SharedAFSStorageOptions } from "./storage/index.js";
+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 { type AFSStorage, type AFSStorageSQLiteOptions } from "./storage/index.js";
 export * from "./storage/index.js";
 export interface AFSHistoryOptions {
-    storage?: SharedAFSStorage | SharedAFSStorageOptions;
+    storage?: AFSStorage | AFSStorageSQLiteOptions;
+    /**
+     * Access mode for this module.
+     * @default "readwrite"
+     */
+    accessMode?: AFSAccessMode;
 }
 export declare class AFSHistory implements AFSModule {
+    static schema(): z.ZodEffects<z.ZodObject<{
+        storage: z.ZodType<any, z.ZodTypeDef, any>;
+        accessMode: z.ZodOptional<z.ZodEnum<["readonly", "readwrite"]>>;
+    }, "strip", z.ZodTypeAny, {
+        storage?: any;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }, {
+        storage?: any;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }>, {
+        storage?: any;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }, any>;
+    static load({ parsed }: AFSModuleLoadParams): Promise<AFSHistory>;
     constructor(options?: AFSHistoryOptions);
     readonly name: string;
+    readonly accessMode: AFSAccessMode;
     private storage;
     private afs?;
     private router;
@@ -14,7 +35,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,38 @@ 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 index_js_1 = require("@aigne/afs-utils/zod/index.js");
 const uuid_1 = require("@aigne/uuid");
 const radix3_1 = require("radix3");
 const ufo_1 = require("ufo");
-const index_js_1 = require("./storage/index.js");
+const zod_1 = require("zod");
+const index_js_2 = require("./storage/index.js");
 __exportStar(require("./storage/index.js"), exports);
+const afsStorageOptionsSchema = (0, index_js_1.camelize)(zod_1.z.object({
+    url: (0, index_js_1.optionalize)(zod_1.z.string().describe("Database URL for storage")),
+}));
+const afsHistoryOptionsSchema = (0, index_js_1.camelize)(zod_1.z.object({
+    storage: (0, index_js_1.optionalize)(zod_1.z.union([zod_1.z.custom((v) => (0, index_js_2.isAFSStorage)(v)), afsStorageOptionsSchema])),
+    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);
+        (0, index_js_1.zodParse)((0, index_js_1.optionalize)(afsHistoryOptionsSchema), options);
+        this.storage = (0, index_js_2.isAFSStorage)(options?.storage)
+            ? options.storage
+            : new index_js_2.AFSStorageSQLite(this, options?.storage);
+        this.accessMode = options?.accessMode ?? "readwrite";
     }
     name = "history";
+    accessMode;
     storage;
     afs;
     router = (0, radix3_1.createRouter)({
@@ -176,7 +195,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 +216,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 +271,4 @@ class AFSHistory {
     }
 }
 exports.AFSHistory = AFSHistory;
+const _typeCheck = AFSHistory;

package/lib/cjs/storage/index.d.ts

@@ -1,21 +1,13 @@
 import type { AFSEntry, AFSModule } from "@aigne/afs";
-import { initDatabase } from "@aigne/sqlite";
 import type { AFSStorage, AFSStorageCreateOptions, AFSStorageCreatePayload, AFSStorageDeleteOptions, AFSStorageListOptions, AFSStorageReadOptions } from "./type.js";
 export * from "./type.js";
-export interface SharedAFSStorageOptions {
+export interface AFSStorageSQLiteOptions {
     url?: string;
 }
-export declare class SharedAFSStorage {
-    options?: SharedAFSStorageOptions | undefined;
-    constructor(options?: SharedAFSStorageOptions | undefined);
-    private _db;
-    get db(): Promise<import("drizzle-orm/sqlite-proxy/driver.js").SqliteRemoteDatabase<Record<string, never>>>;
-    withModule(module: AFSModule): AFSStorage;
-}
-export declare class AFSStorageWithModule implements AFSStorage {
-    private db;
-    private module;
-    constructor(db: ReturnType<typeof initDatabase>, module: AFSModule);
+export declare class AFSStorageSQLite implements AFSStorage {
+    module: AFSModule;
+    options?: AFSStorageSQLiteOptions | undefined;
+    constructor(module: AFSModule, options?: AFSStorageSQLiteOptions | undefined);
     private _tables?;
     private get tables();
     list(options?: AFSStorageListOptions): Promise<{

package/lib/cjs/storage/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AFSStorageWithModule = exports.SharedAFSStorage = void 0;
+exports.AFSStorageSQLite = void 0;
 const sqlite_1 = require("@aigne/sqlite");
 const migrate_js_1 = require("./migrate.js");
 const compact_js_1 = require("./models/compact.js");
@@ -22,32 +22,17 @@ const entries_js_1 = require("./models/entries.js");
 const memory_js_1 = require("./models/memory.js");
 __exportStar(require("./type.js"), exports);
 const DEFAULT_AFS_STORAGE_LIST_LIMIT = 10;
-class SharedAFSStorage {
-    options;
-    constructor(options) {
-        this.options = options;
-    }
-    _db;
-    get db() {
-        this._db ??= (0, sqlite_1.initDatabase)({ url: this.options?.url });
-        return this._db;
-    }
-    withModule(module) {
-        return new AFSStorageWithModule(this.db, module);
-    }
-}
-exports.SharedAFSStorage = SharedAFSStorage;
-class AFSStorageWithModule {
-    db;
+class AFSStorageSQLite {
     module;
-    constructor(db, module) {
-        this.db = db;
+    options;
+    constructor(module, options) {
         this.module = module;
+        this.options = options;
     }
     _tables;
     get tables() {
         if (!this._tables) {
-            this._tables = this.db.then((db) => (0, migrate_js_1.migrate)(db, this.module).then(() => ({
+            this._tables = (0, sqlite_1.initDatabase)({ url: this.options?.url }).then((db) => (0, migrate_js_1.migrate)(db, this.module).then(() => ({
                 db,
                 entries: (0, entries_js_1.entriesTable)(this.module),
                 compact: (0, compact_js_1.compactTable)(this.module),
@@ -130,4 +115,4 @@ class AFSStorageWithModule {
         return { deletedCount: result.length };
     }
 }
-exports.AFSStorageWithModule = AFSStorageWithModule;
+exports.AFSStorageSQLite = AFSStorageSQLite;

package/lib/cjs/storage/type.d.ts

@@ -45,6 +45,7 @@ export interface AFSStorage {
         deletedCount: number;
     }>;
 }
+export declare function isAFSStorage(value: any): value is AFSStorage;
 export type AFSStorageMigrations = {
     hash: string;
     sql: (module: AFSModule) => SQL[];

package/lib/cjs/storage/type.js

@@ -1,2 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAFSStorage = isAFSStorage;
+function isAFSStorage(value) {
+    return (!!value &&
+        typeof value === "object" &&
+        typeof value.create === "function" &&
+        typeof value.list === "function" &&
+        typeof value.read === "function" &&
+        typeof value.delete === "function");
+}

package/lib/dts/index.d.ts

@@ -1,12 +1,33 @@
-import type { AFSDeleteOptions, AFSDeleteResult, AFSListOptions, AFSListResult, AFSModule, AFSReadOptions, AFSReadResult, AFSRoot, AFSWriteEntryPayload, AFSWriteResult } from "@aigne/afs";
-import { SharedAFSStorage, type SharedAFSStorageOptions } from "./storage/index.js";
+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 { type AFSStorage, type AFSStorageSQLiteOptions } from "./storage/index.js";
 export * from "./storage/index.js";
 export interface AFSHistoryOptions {
-    storage?: SharedAFSStorage | SharedAFSStorageOptions;
+    storage?: AFSStorage | AFSStorageSQLiteOptions;
+    /**
+     * Access mode for this module.
+     * @default "readwrite"
+     */
+    accessMode?: AFSAccessMode;
 }
 export declare class AFSHistory implements AFSModule {
+    static schema(): z.ZodEffects<z.ZodObject<{
+        storage: z.ZodType<any, z.ZodTypeDef, any>;
+        accessMode: z.ZodOptional<z.ZodEnum<["readonly", "readwrite"]>>;
+    }, "strip", z.ZodTypeAny, {
+        storage?: any;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }, {
+        storage?: any;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }>, {
+        storage?: any;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }, any>;
+    static load({ parsed }: AFSModuleLoadParams): Promise<AFSHistory>;
     constructor(options?: AFSHistoryOptions);
     readonly name: string;
+    readonly accessMode: AFSAccessMode;
     private storage;
     private afs?;
     private router;
@@ -14,7 +35,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/dts/storage/index.d.ts

@@ -1,23 +1,13 @@
 import type { AFSEntry, AFSModule } from "@aigne/afs";
-import { initDatabase } from "@aigne/sqlite";
 import type { AFSStorage, AFSStorageCreateOptions, AFSStorageCreatePayload, AFSStorageDeleteOptions, AFSStorageListOptions, AFSStorageReadOptions } from "./type.js";
 export * from "./type.js";
-export interface SharedAFSStorageOptions {
+export interface AFSStorageSQLiteOptions {
     url?: string;
 }
-export declare class SharedAFSStorage {
-    options?: SharedAFSStorageOptions | undefined;
-    constructor(options?: SharedAFSStorageOptions | undefined);
-    private _db;
-    get db(): Promise<import("drizzle-orm/libsql").LibSQLDatabase<Record<string, never>> & {
-        vacuum?: () => Promise<void>;
-    }>;
-    withModule(module: AFSModule): AFSStorage;
-}
-export declare class AFSStorageWithModule implements AFSStorage {
-    private db;
-    private module;
-    constructor(db: ReturnType<typeof initDatabase>, module: AFSModule);
+export declare class AFSStorageSQLite implements AFSStorage {
+    module: AFSModule;
+    options?: AFSStorageSQLiteOptions | undefined;
+    constructor(module: AFSModule, options?: AFSStorageSQLiteOptions | undefined);
     private _tables?;
     private get tables();
     list(options?: AFSStorageListOptions): Promise<{

package/lib/dts/storage/type.d.ts

@@ -45,6 +45,7 @@ export interface AFSStorage {
         deletedCount: number;
     }>;
 }
+export declare function isAFSStorage(value: any): value is AFSStorage;
 export type AFSStorageMigrations = {
     hash: string;
     sql: (module: AFSModule) => SQL[];

package/lib/esm/index.d.ts

@@ -1,12 +1,33 @@
-import type { AFSDeleteOptions, AFSDeleteResult, AFSListOptions, AFSListResult, AFSModule, AFSReadOptions, AFSReadResult, AFSRoot, AFSWriteEntryPayload, AFSWriteResult } from "@aigne/afs";
-import { SharedAFSStorage, type SharedAFSStorageOptions } from "./storage/index.js";
+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 { type AFSStorage, type AFSStorageSQLiteOptions } from "./storage/index.js";
 export * from "./storage/index.js";
 export interface AFSHistoryOptions {
-    storage?: SharedAFSStorage | SharedAFSStorageOptions;
+    storage?: AFSStorage | AFSStorageSQLiteOptions;
+    /**
+     * Access mode for this module.
+     * @default "readwrite"
+     */
+    accessMode?: AFSAccessMode;
 }
 export declare class AFSHistory implements AFSModule {
+    static schema(): z.ZodEffects<z.ZodObject<{
+        storage: z.ZodType<any, z.ZodTypeDef, any>;
+        accessMode: z.ZodOptional<z.ZodEnum<["readonly", "readwrite"]>>;
+    }, "strip", z.ZodTypeAny, {
+        storage?: any;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }, {
+        storage?: any;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }>, {
+        storage?: any;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }, any>;
+    static load({ parsed }: AFSModuleLoadParams): Promise<AFSHistory>;
     constructor(options?: AFSHistoryOptions);
     readonly name: string;
+    readonly accessMode: AFSAccessMode;
     private storage;
     private afs?;
     private router;
@@ -14,7 +35,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,35 @@
+import { accessModeSchema, } from "@aigne/afs";
+import { camelize, optionalize, zodParse } from "@aigne/afs-utils/zod/index.js";
 import { v7 } from "@aigne/uuid";
 import { createRouter } from "radix3";
 import { joinURL } from "ufo";
-import { SharedAFSStorage, } from "./storage/index.js";
+import { z } from "zod";
+import { AFSStorageSQLite, isAFSStorage, } from "./storage/index.js";
 export * from "./storage/index.js";
+const afsStorageOptionsSchema = camelize(z.object({
+    url: optionalize(z.string().describe("Database URL for storage")),
+}));
+const afsHistoryOptionsSchema = camelize(z.object({
+    storage: optionalize(z.union([z.custom((v) => isAFSStorage(v)), afsStorageOptionsSchema])),
+    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);
+        zodParse(optionalize(afsHistoryOptionsSchema), options);
+        this.storage = isAFSStorage(options?.storage)
+            ? options.storage
+            : new AFSStorageSQLite(this, options?.storage);
+        this.accessMode = options?.accessMode ?? "readwrite";
     }
     name = "history";
+    accessMode;
     storage;
     afs;
     router = createRouter({
@@ -159,7 +178,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 +199,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 +253,4 @@ export class AFSHistory {
         return joinURL("/", prefix, scopeId, entry.id);
     }
 }
+const _typeCheck = AFSHistory;

package/lib/esm/storage/index.d.ts

@@ -1,23 +1,13 @@
 import type { AFSEntry, AFSModule } from "@aigne/afs";
-import { initDatabase } from "@aigne/sqlite";
 import type { AFSStorage, AFSStorageCreateOptions, AFSStorageCreatePayload, AFSStorageDeleteOptions, AFSStorageListOptions, AFSStorageReadOptions } from "./type.js";
 export * from "./type.js";
-export interface SharedAFSStorageOptions {
+export interface AFSStorageSQLiteOptions {
     url?: string;
 }
-export declare class SharedAFSStorage {
-    options?: SharedAFSStorageOptions | undefined;
-    constructor(options?: SharedAFSStorageOptions | undefined);
-    private _db;
-    get db(): Promise<import("drizzle-orm/libsql").LibSQLDatabase<Record<string, never>> & {
-        vacuum?: () => Promise<void>;
-    }>;
-    withModule(module: AFSModule): AFSStorage;
-}
-export declare class AFSStorageWithModule implements AFSStorage {
-    private db;
-    private module;
-    constructor(db: ReturnType<typeof initDatabase>, module: AFSModule);
+export declare class AFSStorageSQLite implements AFSStorage {
+    module: AFSModule;
+    options?: AFSStorageSQLiteOptions | undefined;
+    constructor(module: AFSModule, options?: AFSStorageSQLiteOptions | undefined);
     private _tables?;
     private get tables();
     list(options?: AFSStorageListOptions): Promise<{

package/lib/esm/storage/index.js

@@ -5,31 +5,17 @@ import { entriesTable } from "./models/entries.js";
 import { memoryTable } from "./models/memory.js";
 export * from "./type.js";
 const DEFAULT_AFS_STORAGE_LIST_LIMIT = 10;
-export class SharedAFSStorage {
-    options;
-    constructor(options) {
-        this.options = options;
-    }
-    _db;
-    get db() {
-        this._db ??= initDatabase({ url: this.options?.url });
-        return this._db;
-    }
-    withModule(module) {
-        return new AFSStorageWithModule(this.db, module);
-    }
-}
-export class AFSStorageWithModule {
-    db;
+export class AFSStorageSQLite {
     module;
-    constructor(db, module) {
-        this.db = db;
+    options;
+    constructor(module, options) {
         this.module = module;
+        this.options = options;
     }
     _tables;
     get tables() {
         if (!this._tables) {
-            this._tables = this.db.then((db) => migrate(db, this.module).then(() => ({
+            this._tables = initDatabase({ url: this.options?.url }).then((db) => migrate(db, this.module).then(() => ({
                 db,
                 entries: entriesTable(this.module),
                 compact: compactTable(this.module),

package/lib/esm/storage/type.d.ts

@@ -45,6 +45,7 @@ export interface AFSStorage {
         deletedCount: number;
     }>;
 }
+export declare function isAFSStorage(value: any): value is AFSStorage;
 export type AFSStorageMigrations = {
     hash: string;
     sql: (module: AFSModule) => SQL[];

package/lib/esm/storage/type.js

@@ -1 +1,8 @@
-export {};
+export function isAFSStorage(value) {
+    return (!!value &&
+        typeof value === "object" &&
+        typeof value.create === "function" &&
+        typeof value.list === "function" &&
+        typeof value.read === "function" &&
+        typeof value.delete === "function");
+}

package/package.json

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