@aigne/afs-user-profile-memory 1.3.0-beta.2 → 1.3.0-beta.21

package/CHANGELOG.md

@@ -1,5 +1,222 @@
 # Changelog
 
+## [1.3.0-beta.21](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.20...afs-user-profile-memory-v1.3.0-beta.21) (2026-01-15)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.72.0-beta.21
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.21
+
+## [1.3.0-beta.20](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.19...afs-user-profile-memory-v1.3.0-beta.20) (2026-01-15)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.72.0-beta.20
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.20
+
+## [1.3.0-beta.19](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.18...afs-user-profile-memory-v1.3.0-beta.19) (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/afs-history bumped to 1.2.0-beta.10
+    * @aigne/core bumped to 1.72.0-beta.19
+  * devDependencies
+    * @aigne/test-utils bumped to 0.5.69-beta.19
+
+## [1.3.0-beta.18](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.17...afs-user-profile-memory-v1.3.0-beta.18) (2026-01-13)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.72.0-beta.18
+
+## [1.3.0-beta.17](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.16...afs-user-profile-memory-v1.3.0-beta.17) (2026-01-12)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.72.0-beta.17
+
+## [1.3.0-beta.16](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.15...afs-user-profile-memory-v1.3.0-beta.16) (2026-01-12)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.8
+    * @aigne/afs-history bumped to 1.2.0-beta.9
+    * @aigne/core bumped to 1.72.0-beta.16
+
+## [1.3.0-beta.15](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.14...afs-user-profile-memory-v1.3.0-beta.15) (2026-01-10)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.72.0-beta.15
+
+## [1.3.0-beta.14](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.13...afs-user-profile-memory-v1.3.0-beta.14) (2026-01-09)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.72.0-beta.14
+
+## [1.3.0-beta.13](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.12...afs-user-profile-memory-v1.3.0-beta.13) (2026-01-08)
+
+
+### Bug Fixes
+
+* bump version ([696560f](https://github.com/AIGNE-io/aigne-framework/commit/696560fa2673eddcb4d00ac0523fbbbde7273cb3))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.7
+    * @aigne/afs-history bumped to 1.2.0-beta.8
+    * @aigne/core bumped to 1.72.0-beta.13
+
+## [1.3.0-beta.12](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.11...afs-user-profile-memory-v1.3.0-beta.12) (2026-01-07)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.72.0-beta.12
+
+## [1.3.0-beta.11](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.10...afs-user-profile-memory-v1.3.0-beta.11) (2026-01-06)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.6
+    * @aigne/afs-history bumped to 1.2.0-beta.7
+    * @aigne/core bumped to 1.72.0-beta.11
+
+## [1.3.0-beta.10](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.9...afs-user-profile-memory-v1.3.0-beta.10) (2026-01-06)
+
+
+### Features
+
+* **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))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs-history bumped to 1.2.0-beta.6
+    * @aigne/core bumped to 1.72.0-beta.10
+
+## [1.3.0-beta.9](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.8...afs-user-profile-memory-v1.3.0-beta.9) (2026-01-02)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.72.0-beta.9
+
+## [1.3.0-beta.8](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.7...afs-user-profile-memory-v1.3.0-beta.8) (2025-12-31)
+
+
+### 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))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.5
+    * @aigne/afs-history bumped to 1.2.0-beta.5
+    * @aigne/core bumped to 1.72.0-beta.8
+
+## [1.3.0-beta.7](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.6...afs-user-profile-memory-v1.3.0-beta.7) (2025-12-26)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.4
+    * @aigne/afs-history bumped to 1.2.0-beta.4
+    * @aigne/core bumped to 1.72.0-beta.7
+
+## [1.3.0-beta.6](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.5...afs-user-profile-memory-v1.3.0-beta.6) (2025-12-25)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.72.0-beta.6
+
+## [1.3.0-beta.5](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.4...afs-user-profile-memory-v1.3.0-beta.5) (2025-12-25)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.72.0-beta.5
+
+## [1.3.0-beta.4](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.3...afs-user-profile-memory-v1.3.0-beta.4) (2025-12-24)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.4.0-beta.3
+    * @aigne/afs-history bumped to 1.2.0-beta.3
+    * @aigne/core bumped to 1.72.0-beta.4
+
+## [1.3.0-beta.3](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.2...afs-user-profile-memory-v1.3.0-beta.3) (2025-12-19)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.72.0-beta.3
+
 ## [1.3.0-beta.2](https://github.com/AIGNE-io/aigne-framework/compare/afs-user-profile-memory-v1.3.0-beta.1...afs-user-profile-memory-v1.3.0-beta.2) (2025-12-19)
 
 

package/lib/cjs/index.d.ts

@@ -1,18 +1,34 @@
-import type { AFSEntry, AFSListOptions, AFSListResult, AFSModule, AFSReadResult, AFSRoot, AFSSearchOptions, AFSSearchResult, AFSWriteEntryPayload, AFSWriteResult } from "@aigne/afs";
+import type { AFSAccessMode, AFSEntry, AFSListOptions, AFSListResult, AFSModule, AFSModuleLoadParams, AFSOperationOptions, AFSReadResult, AFSRoot, AFSSearchOptions, AFSSearchResult, AFSWriteEntryPayload, AFSWriteResult } from "@aigne/afs";
 import { SharedAFSStorage, type SharedAFSStorageOptions } from "@aigne/afs-history";
-import { AIAgent, type Context } from "@aigne/core";
-import type { z } from "zod";
+import { AIAgent } from "@aigne/core";
+import { z } from "zod";
 import { userProfileJsonPathSchema } from "./schema.js";
 export interface UserProfileMemoryOptions {
-    context: Context;
     storage?: SharedAFSStorage | SharedAFSStorageOptions;
     description?: string;
+    /**
+     * Access mode for this module.
+     * @default "readwrite"
+     */
+    accessMode?: AFSAccessMode;
 }
 export declare class UserProfileMemory implements AFSModule {
     options: UserProfileMemoryOptions;
+    static schema(): z.ZodObject<{
+        description: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
+        accessMode: z.ZodType<"readonly" | "readwrite" | undefined, z.ZodTypeDef, "readonly" | "readwrite" | undefined>;
+    }, "strip", z.ZodTypeAny, {
+        description?: string | undefined;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }, {
+        description?: string | undefined;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }>;
+    static load({ parsed }: AFSModuleLoadParams): Promise<UserProfileMemory>;
     constructor(options: UserProfileMemoryOptions);
     private storage;
     readonly name: string;
+    readonly accessMode: AFSAccessMode;
     description?: string | undefined;
     extractor: AIAgent<{
         schema: any;
@@ -20,7 +36,7 @@ export declare class UserProfileMemory implements AFSModule {
         entry: AFSEntry;
     }, z.infer<typeof userProfileJsonPathSchema>>;
     onMount(afs: AFSRoot): void;
-    updateProfile(entry: AFSEntry): Promise<AFSWriteResult>;
+    updateProfile(entry: AFSEntry, options?: AFSOperationOptions): Promise<AFSWriteResult>;
     list(_path: string, _options?: AFSListOptions): Promise<AFSListResult>;
     read(path: string): Promise<AFSReadResult>;
     write(path: string, entry: AFSWriteEntryPayload): Promise<AFSWriteResult>;

package/lib/cjs/index.js

@@ -3,11 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UserProfileMemory = void 0;
 const afs_history_1 = require("@aigne/afs-history");
 const core_1 = require("@aigne/core");
+const schema_js_1 = require("@aigne/core/loader/schema.js");
 const logger_js_1 = require("@aigne/core/utils/logger.js");
+const uuid_1 = require("@aigne/uuid");
 const fast_json_patch_1 = require("fast-json-patch");
+const zod_1 = require("zod");
 const zod_to_json_schema_1 = require("zod-to-json-schema");
 const prompt_js_1 = require("./prompt.js");
-const schema_js_1 = require("./schema.js");
+const schema_js_2 = require("./schema.js");
 const DEFAULT_DESCRIPTION = `\
 User Profile Memory: This contains structured information about the user that has been \
 automatically extracted from previous conversations. It includes personal details such as name, \
@@ -15,8 +18,19 @@ location, interests, family members, projects, and other relevant information th
 Use this memory to personalize responses and maintain context about the user across conversations. \
 The profile is continuously updated as new information is learned.
 `;
+const userProfileMemoryOptionsSchema = (0, schema_js_1.camelizeSchema)(zod_1.z.object({
+    description: (0, schema_js_1.optionalize)(zod_1.z.string().describe("Description of the user profile memory")),
+    accessMode: (0, schema_js_1.optionalize)(zod_1.z.enum(["readonly", "readwrite"]).describe("Access mode for this module")),
+}));
 class UserProfileMemory {
     options;
+    static schema() {
+        return userProfileMemoryOptionsSchema;
+    }
+    static async load({ parsed }) {
+        const valid = await UserProfileMemory.schema().parseAsync(parsed);
+        return new UserProfileMemory(valid);
+    }
     constructor(options) {
         this.options = options;
         this.storage =
@@ -24,28 +38,35 @@ class UserProfileMemory {
                 ? options.storage.withModule(this)
                 : new afs_history_1.SharedAFSStorage(options?.storage).withModule(this);
         this.description = options.description || DEFAULT_DESCRIPTION;
+        this.accessMode = options.accessMode ?? "readwrite";
     }
     storage;
     name = "user-profile-memory";
+    accessMode;
     description;
     extractor = core_1.AIAgent.from({
         instructions: prompt_js_1.USER_PROFILE_MEMORY_EXTRACTOR_PROMPT,
-        outputSchema: schema_js_1.userProfileJsonPathSchema,
+        outputSchema: schema_js_2.userProfileJsonPathSchema,
     });
     onMount(afs) {
-        afs.on("historyCreated", async ({ entry }) => {
+        afs.on("historyCreated", async ({ entry }, options) => {
             try {
-                await this.updateProfile(entry);
+                await this.updateProfile(entry, options);
             }
             catch (error) {
                 logger_js_1.logger.error("Failed to update user profile memory", error);
             }
         });
     }
-    async updateProfile(entry) {
+    async updateProfile(entry, options) {
         const { data: previous } = await this.read("/");
-        const { ops } = await this.options.context.newContext({ reset: true }).invoke(this.extractor, {
-            schema: (0, zod_to_json_schema_1.zodToJsonSchema)(schema_js_1.userProfileSchema),
+        if (typeof options?.context?.newContext !== "function") {
+            throw new Error("Context is not valid for user profile extraction");
+        }
+        const { ops } = await (options?.context)
+            .newContext({ reset: true })
+            .invoke(this.extractor, {
+            schema: (0, zod_to_json_schema_1.zodToJsonSchema)(schema_js_2.userProfileSchema),
             profile: previous?.content,
             entry,
         });
@@ -60,13 +81,24 @@ class UserProfileMemory {
         return { data: profile ? [profile] : [] };
     }
     async read(path) {
-        const data = await this.storage.read(path);
+        if (path !== "/")
+            return {};
+        const data = (await this.storage.list({
+            orderBy: [["createdAt", "desc"]],
+            limit: 1,
+        })).data.at(0);
         if (data)
             data.description = this.description;
         return { data };
     }
     async write(path, entry) {
-        const data = await this.storage.create({ ...entry, path });
+        const { data: previous } = await this.read("/");
+        const data = await this.storage.create({
+            ...previous,
+            ...entry,
+            id: previous?.id || (0, uuid_1.v7)(),
+            path,
+        });
         if (data)
             data.description = this.description;
         return { data };

package/lib/dts/index.d.ts

@@ -1,18 +1,34 @@
-import type { AFSEntry, AFSListOptions, AFSListResult, AFSModule, AFSReadResult, AFSRoot, AFSSearchOptions, AFSSearchResult, AFSWriteEntryPayload, AFSWriteResult } from "@aigne/afs";
+import type { AFSAccessMode, AFSEntry, AFSListOptions, AFSListResult, AFSModule, AFSModuleLoadParams, AFSOperationOptions, AFSReadResult, AFSRoot, AFSSearchOptions, AFSSearchResult, AFSWriteEntryPayload, AFSWriteResult } from "@aigne/afs";
 import { SharedAFSStorage, type SharedAFSStorageOptions } from "@aigne/afs-history";
-import { AIAgent, type Context } from "@aigne/core";
-import type { z } from "zod";
+import { AIAgent } from "@aigne/core";
+import { z } from "zod";
 import { userProfileJsonPathSchema } from "./schema.js";
 export interface UserProfileMemoryOptions {
-    context: Context;
     storage?: SharedAFSStorage | SharedAFSStorageOptions;
     description?: string;
+    /**
+     * Access mode for this module.
+     * @default "readwrite"
+     */
+    accessMode?: AFSAccessMode;
 }
 export declare class UserProfileMemory implements AFSModule {
     options: UserProfileMemoryOptions;
+    static schema(): z.ZodObject<{
+        description: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
+        accessMode: z.ZodType<"readonly" | "readwrite" | undefined, z.ZodTypeDef, "readonly" | "readwrite" | undefined>;
+    }, "strip", z.ZodTypeAny, {
+        description?: string | undefined;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }, {
+        description?: string | undefined;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }>;
+    static load({ parsed }: AFSModuleLoadParams): Promise<UserProfileMemory>;
     constructor(options: UserProfileMemoryOptions);
     private storage;
     readonly name: string;
+    readonly accessMode: AFSAccessMode;
     description?: string | undefined;
     extractor: AIAgent<{
         schema: any;
@@ -20,7 +36,7 @@ export declare class UserProfileMemory implements AFSModule {
         entry: AFSEntry;
     }, z.infer<typeof userProfileJsonPathSchema>>;
     onMount(afs: AFSRoot): void;
-    updateProfile(entry: AFSEntry): Promise<AFSWriteResult>;
+    updateProfile(entry: AFSEntry, options?: AFSOperationOptions): Promise<AFSWriteResult>;
     list(_path: string, _options?: AFSListOptions): Promise<AFSListResult>;
     read(path: string): Promise<AFSReadResult>;
     write(path: string, entry: AFSWriteEntryPayload): Promise<AFSWriteResult>;

package/lib/esm/index.d.ts

@@ -1,18 +1,34 @@
-import type { AFSEntry, AFSListOptions, AFSListResult, AFSModule, AFSReadResult, AFSRoot, AFSSearchOptions, AFSSearchResult, AFSWriteEntryPayload, AFSWriteResult } from "@aigne/afs";
+import type { AFSAccessMode, AFSEntry, AFSListOptions, AFSListResult, AFSModule, AFSModuleLoadParams, AFSOperationOptions, AFSReadResult, AFSRoot, AFSSearchOptions, AFSSearchResult, AFSWriteEntryPayload, AFSWriteResult } from "@aigne/afs";
 import { SharedAFSStorage, type SharedAFSStorageOptions } from "@aigne/afs-history";
-import { AIAgent, type Context } from "@aigne/core";
-import type { z } from "zod";
+import { AIAgent } from "@aigne/core";
+import { z } from "zod";
 import { userProfileJsonPathSchema } from "./schema.js";
 export interface UserProfileMemoryOptions {
-    context: Context;
     storage?: SharedAFSStorage | SharedAFSStorageOptions;
     description?: string;
+    /**
+     * Access mode for this module.
+     * @default "readwrite"
+     */
+    accessMode?: AFSAccessMode;
 }
 export declare class UserProfileMemory implements AFSModule {
     options: UserProfileMemoryOptions;
+    static schema(): z.ZodObject<{
+        description: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
+        accessMode: z.ZodType<"readonly" | "readwrite" | undefined, z.ZodTypeDef, "readonly" | "readwrite" | undefined>;
+    }, "strip", z.ZodTypeAny, {
+        description?: string | undefined;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }, {
+        description?: string | undefined;
+        accessMode?: "readonly" | "readwrite" | undefined;
+    }>;
+    static load({ parsed }: AFSModuleLoadParams): Promise<UserProfileMemory>;
     constructor(options: UserProfileMemoryOptions);
     private storage;
     readonly name: string;
+    readonly accessMode: AFSAccessMode;
     description?: string | undefined;
     extractor: AIAgent<{
         schema: any;
@@ -20,7 +36,7 @@ export declare class UserProfileMemory implements AFSModule {
         entry: AFSEntry;
     }, z.infer<typeof userProfileJsonPathSchema>>;
     onMount(afs: AFSRoot): void;
-    updateProfile(entry: AFSEntry): Promise<AFSWriteResult>;
+    updateProfile(entry: AFSEntry, options?: AFSOperationOptions): Promise<AFSWriteResult>;
     list(_path: string, _options?: AFSListOptions): Promise<AFSListResult>;
     read(path: string): Promise<AFSReadResult>;
     write(path: string, entry: AFSWriteEntryPayload): Promise<AFSWriteResult>;

package/lib/esm/index.js

@@ -1,7 +1,10 @@
 import { SharedAFSStorage, } from "@aigne/afs-history";
 import { AIAgent } from "@aigne/core";
+import { camelizeSchema, optionalize } from "@aigne/core/loader/schema.js";
 import { logger } from "@aigne/core/utils/logger.js";
+import { v7 } from "@aigne/uuid";
 import { applyPatch } from "fast-json-patch";
+import { z } from "zod";
 import { zodToJsonSchema } from "zod-to-json-schema";
 import { USER_PROFILE_MEMORY_EXTRACTOR_PROMPT } from "./prompt.js";
 import { userProfileJsonPathSchema, userProfileSchema } from "./schema.js";
@@ -12,8 +15,19 @@ location, interests, family members, projects, and other relevant information th
 Use this memory to personalize responses and maintain context about the user across conversations. \
 The profile is continuously updated as new information is learned.
 `;
+const userProfileMemoryOptionsSchema = camelizeSchema(z.object({
+    description: optionalize(z.string().describe("Description of the user profile memory")),
+    accessMode: optionalize(z.enum(["readonly", "readwrite"]).describe("Access mode for this module")),
+}));
 export class UserProfileMemory {
     options;
+    static schema() {
+        return userProfileMemoryOptionsSchema;
+    }
+    static async load({ parsed }) {
+        const valid = await UserProfileMemory.schema().parseAsync(parsed);
+        return new UserProfileMemory(valid);
+    }
     constructor(options) {
         this.options = options;
         this.storage =
@@ -21,27 +35,34 @@ export class UserProfileMemory {
                 ? options.storage.withModule(this)
                 : new SharedAFSStorage(options?.storage).withModule(this);
         this.description = options.description || DEFAULT_DESCRIPTION;
+        this.accessMode = options.accessMode ?? "readwrite";
     }
     storage;
     name = "user-profile-memory";
+    accessMode;
     description;
     extractor = AIAgent.from({
         instructions: USER_PROFILE_MEMORY_EXTRACTOR_PROMPT,
         outputSchema: userProfileJsonPathSchema,
     });
     onMount(afs) {
-        afs.on("historyCreated", async ({ entry }) => {
+        afs.on("historyCreated", async ({ entry }, options) => {
             try {
-                await this.updateProfile(entry);
+                await this.updateProfile(entry, options);
             }
             catch (error) {
                 logger.error("Failed to update user profile memory", error);
             }
         });
     }
-    async updateProfile(entry) {
+    async updateProfile(entry, options) {
         const { data: previous } = await this.read("/");
-        const { ops } = await this.options.context.newContext({ reset: true }).invoke(this.extractor, {
+        if (typeof options?.context?.newContext !== "function") {
+            throw new Error("Context is not valid for user profile extraction");
+        }
+        const { ops } = await (options?.context)
+            .newContext({ reset: true })
+            .invoke(this.extractor, {
             schema: zodToJsonSchema(userProfileSchema),
             profile: previous?.content,
             entry,
@@ -57,13 +78,24 @@ export class UserProfileMemory {
         return { data: profile ? [profile] : [] };
     }
     async read(path) {
-        const data = await this.storage.read(path);
+        if (path !== "/")
+            return {};
+        const data = (await this.storage.list({
+            orderBy: [["createdAt", "desc"]],
+            limit: 1,
+        })).data.at(0);
         if (data)
             data.description = this.description;
         return { data };
     }
     async write(path, entry) {
-        const data = await this.storage.create({ ...entry, path });
+        const { data: previous } = await this.read("/");
+        const data = await this.storage.create({
+            ...previous,
+            ...entry,
+            id: previous?.id || v7(),
+            path,
+        });
         if (data)
             data.description = this.description;
         return { data };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/afs-user-profile-memory",
-  "version": "1.3.0-beta.2",
+  "version": "1.3.0-beta.21",
   "description": "AIGNE AFS module for user profile memory",
   "publishConfig": {
     "access": "public"
@@ -47,18 +47,20 @@
     }
   },
   "dependencies": {
+    "@aigne/uuid": "^13.0.1",
     "fast-json-patch": "^3.1.1",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.6",
-    "@aigne/afs-history": "^1.2.0-beta.2",
-    "@aigne/afs": "^1.4.0-beta.2",
-    "@aigne/core": "^1.72.0-beta.2"
+    "@aigne/afs": "^1.4.0-beta.9",
+    "@aigne/afs-history": "^1.2.0-beta.10",
+    "@aigne/core": "^1.72.0-beta.21"
   },
   "devDependencies": {
     "@types/bun": "^1.2.22",
     "npm-run-all": "^4.1.5",
     "rimraf": "^6.0.1",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.2",
+    "@aigne/test-utils": "^0.5.69-beta.21"
   },
   "scripts": {
     "lint": "tsc --noEmit",