@aigne/agentic-memory 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## 1.0.0 (2025-07-15)
+
+
+### Features
+
+* **memory:** support did space memory adapter ([#229](https://github.com/AIGNE-io/aigne-framework/issues/229)) ([6f69b64](https://github.com/AIGNE-io/aigne-framework/commit/6f69b64e98b963db9d6ab5357306b445385eaa68))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.34.0
+    * @aigne/default-memory bumped to 1.0.0
+    * @aigne/openai bumped to 0.10.0

package/LICENSE.md

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/README.md

@@ -0,0 +1,128 @@
+# @aigne/agentic-memory
+
+[![GitHub star chart](https://img.shields.io/github/stars/AIGNE-io/aigne-framework?style=flat-square)](https://star-history.com/#AIGNE-io/aigne-framework)
+[![Open Issues](https://img.shields.io/github/issues-raw/AIGNE-io/aigne-framework?style=flat-square)](https://github.com/AIGNE-io/aigne-framework/issues)
+[![codecov](https://codecov.io/gh/AIGNE-io/aigne-framework/graph/badge.svg?token=DO07834RQL)](https://codecov.io/gh/AIGNE-io/aigne-framework)
+[![NPM Version](https://img.shields.io/npm/v/@aigne/agentic-memory)](https://www.npmjs.com/package/@aigne/agentic-memory)
+[![Elastic-2.0 licensed](https://img.shields.io/npm/l/@aigne/agentic-memory)](https://github.com/AIGNE-io/aigne-framework/blob/main/LICENSE)
+
+Agentic memory system component for [AIGNE Framework](https://github.com/AIGNE-io/aigne-framework), providing AI-powered memory management capabilities.
+
+## Introduction
+
+`@aigne/agentic-memory` is an intelligent memory system component of [AIGNE Framework](https://github.com/AIGNE-io/aigne-framework), providing AI agent-based memory management functionality. This component uses intelligent agents to handle memory recording, retrieval, and management, providing smarter memory capabilities for AI applications.
+
+## Features
+
+* **Intelligent Memory Management**: Uses AI agents to manage memory recording and retrieval processes
+* **Automatic Memory Updates**: Supports automatic memory update mechanisms
+* **Storage Adaptation**: Compatible with multiple storage backends, including default SQLite storage
+* **Memory Filtering**: Intelligent filtering and organization of memory content
+* **TypeScript Support**: Complete type definitions providing an excellent development experience
+
+## Installation
+
+### Using npm
+
+```bash
+npm install @aigne/agentic-memory
+```
+
+### Using yarn
+
+```bash
+yarn add @aigne/agentic-memory
+```
+
+### Using pnpm
+
+```bash
+pnpm add @aigne/agentic-memory
+```
+
+## Basic Usage
+
+```typescript
+import { AIAgent, AIGNE } from "@aigne/core";
+import { AgenticMemory } from "@aigne/agentic-memory";
+import { OpenAIChatModel } from "@aigne/openai";
+
+// Create AI model instance
+const model = new OpenAIChatModel({
+  apiKey: process.env.OPENAI_API_KEY,
+  model: "gpt-4-turbo",
+});
+
+// Create intelligent memory system
+const memory = new AgenticMemory({
+  storage: {
+    url: "file:memory.db",
+  },
+  autoUpdate: true,
+});
+
+// Create AI agent with intelligent memory
+const agent = AIAgent.from({
+  name: "SmartAssistant",
+  instructions: "You are a helpful assistant with intelligent memory capabilities.",
+  memory: memory,
+  inputKey: "message",
+});
+
+// Use AIGNE execution engine
+const aigne = new AIGNE({ model });
+
+// Invoke agent
+const userAgent = await aigne.invoke(agent);
+
+// Send message
+const response = await userAgent.invoke({
+  message: "Remember that I like to drink coffee in the morning",
+});
+
+console.log(response.message);
+
+// Query memory later
+const response2 = await userAgent.invoke({
+  message: "What do you know about my morning routine?",
+});
+
+console.log(response2.message);
+```
+
+## Advanced Configuration
+
+### Custom Storage Options
+
+```typescript
+import { AgenticMemory } from "@aigne/agentic-memory";
+import { DefaultMemoryStorage } from "@aigne/default-memory";
+
+const customStorage = new DefaultMemoryStorage({
+  url: "file:custom-memory.db",
+  // Other storage configurations
+});
+
+const memory = new AgenticMemory({
+  storage: customStorage,
+  autoUpdate: true,
+});
+```
+
+### Configure Memory Agent Options
+
+```typescript
+const memory = new AgenticMemory({
+  storage: {
+    url: "file:memory.db",
+  },
+  // Custom memory recorder options
+  name: "CustomMemoryAgent",
+  instructions: "Custom memory management instructions",
+  // Other agent configurations
+});
+```
+
+## License
+
+Elastic-2.0

package/lib/cjs/index.d.ts

@@ -0,0 +1 @@
+export * from "./memory.js";

package/lib/cjs/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./memory.js"), exports);

package/lib/cjs/memory.d.ts

@@ -0,0 +1,36 @@
+import { type AgentInvokeOptions, type AgentOptions, AIAgent, MemoryAgent, type MemoryAgentOptions, MemoryRecorder, type MemoryRecorderInput, type MemoryRecorderOutput, type Message, type PromptBuilder } from "@aigne/core";
+import { DefaultMemoryRetriever, type DefaultMemoryRetrieverOptions, type DefaultMemoryStorageOptions, MemoryStorage } from "@aigne/default-memory";
+export interface AgenticMemoryOptions extends Partial<MemoryAgentOptions>, Omit<AgenticMemoryRecorderOptions, "storage" | keyof AgentOptions>, Omit<AgenticMemoryRetrieverOptions, "storage" | keyof AgentOptions> {
+    storage?: MemoryStorage | DefaultMemoryStorageOptions;
+}
+export declare class AgenticMemory extends MemoryAgent {
+    constructor(options?: AgenticMemoryOptions);
+    storage: MemoryStorage;
+}
+export interface AgenticMemoryRetrieverOptions extends DefaultMemoryRetrieverOptions {
+}
+export declare class AgenticMemoryRetriever extends DefaultMemoryRetriever {
+}
+export interface AgenticMemoryRecorderOptions extends AgentOptions<MemoryRecorderInput, MemoryRecorderOutput> {
+    storage: MemoryStorage;
+    instructions?: string | PromptBuilder;
+    agent?: AIAgent<AgenticMemoryExtractorInput, AgenticMemoryExtractorOutput>;
+    inputKey?: string | string[];
+    outputKey?: string | string[];
+}
+export interface AgenticMemoryExtractorInput extends Message {
+    content: unknown;
+}
+export interface AgenticMemoryExtractorOutput extends Message {
+    newMemories: {
+        content: string;
+    }[];
+}
+export declare class AgenticMemoryRecorder extends MemoryRecorder {
+    constructor(options: AgenticMemoryRecorderOptions);
+    private storage;
+    private inputKey?;
+    private outputKey?;
+    private agent;
+    process(input: MemoryRecorderInput, options: AgentInvokeOptions): Promise<MemoryRecorderOutput>;
+}

package/lib/cjs/memory.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgenticMemoryRecorder = exports.AgenticMemoryRetriever = exports.AgenticMemory = void 0;
+const core_1 = require("@aigne/core");
+const type_utils_js_1 = require("@aigne/core/utils/type-utils.js");
+const default_memory_1 = require("@aigne/default-memory");
+const zod_1 = require("zod");
+const prompt_js_1 = require("./prompt.js");
+class AgenticMemory extends core_1.MemoryAgent {
+    constructor(options = {}) {
+        const storage = options.storage instanceof default_memory_1.MemoryStorage
+            ? options.storage
+            : new default_memory_1.DefaultMemoryStorage(options.storage);
+        super({
+            ...options,
+            recorder: options.recorder ?? new AgenticMemoryRecorder({ ...options, storage }),
+            retriever: options.retriever ?? new AgenticMemoryRetriever({ ...options, storage }),
+            autoUpdate: options.autoUpdate ?? true,
+        });
+        this.storage = storage;
+    }
+    storage;
+}
+exports.AgenticMemory = AgenticMemory;
+class AgenticMemoryRetriever extends default_memory_1.DefaultMemoryRetriever {
+}
+exports.AgenticMemoryRetriever = AgenticMemoryRetriever;
+class AgenticMemoryRecorder extends core_1.MemoryRecorder {
+    constructor(options) {
+        super(options);
+        this.storage = options.storage;
+        this.inputKey = (0, type_utils_js_1.flat)(options.inputKey);
+        this.outputKey = (0, type_utils_js_1.flat)(options.outputKey);
+        this.agent =
+            options.agent ??
+                core_1.AIAgent.from({
+                    name: "agentic_memory_extractor",
+                    description: "Records memories in files by AI agent",
+                    instructions: options.instructions || prompt_js_1.DEFAULT_AGENTIC_MEMORY_RECORDER_INSTRUCTIONS,
+                    outputSchema: zod_1.z.object({
+                        newMemories: zod_1.z
+                            .array(zod_1.z.object({
+                            content: zod_1.z.string().describe("Content of the memory"),
+                        }))
+                            .describe("Newly created memories"),
+                    }),
+                });
+    }
+    storage;
+    inputKey;
+    outputKey;
+    agent;
+    async process(input, options) {
+        const agenticMemories = await options.context.invoke(this.agent, {
+            content: input.content.map((item) => ({
+                input: item.input && this.inputKey?.length ? (0, type_utils_js_1.pick)(item.input, this.inputKey) : item.input,
+                output: item.output && this.outputKey?.length ? (0, type_utils_js_1.pick)(item.output, this.outputKey) : item.output,
+                source: item.source,
+            })),
+        });
+        const newMemories = [];
+        for (const item of agenticMemories.newMemories) {
+            const { result } = await this.storage.create({ content: item.content }, options);
+            newMemories.push(result);
+        }
+        return {
+            memories: newMemories,
+        };
+    }
+}
+exports.AgenticMemoryRecorder = AgenticMemoryRecorder;

package/lib/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/lib/cjs/prompt.d.ts

@@ -0,0 +1 @@
+export declare const DEFAULT_AGENTIC_MEMORY_RECORDER_INSTRUCTIONS = "You manage memory based on conversation analysis and the existing memories.\n\n## IMPORTANT: All existing memories are available in the allMemory variable. DO NOT call any tools.\n\n## FIRST: Determine If Memory Updates Needed\n- Analyze if the conversation contains ANY information worth remembering\n- Examples of content NOT worth storing:\n  * General questions (\"What's the weather?\", \"How do I do X?\")\n  * Greetings and small talk (\"Hello\", \"How are you?\", \"Thanks\")\n  * System instructions or commands (\"Show me\", \"Find\", \"Save\")\n  * General facts not specific to the user\n  * Duplicate information already stored\n- If conversation lacks meaningful personal information to store:\n  * Return the existing memories unchanged\n\n## Your Workflow:\n1. Read the existing memories from the allMemory variable\n2. Extract key topics from the conversation\n3. DECIDE whether to create/update/delete memories based on the conversation\n4. Return ALL memories including your updates (remove any duplicates)\n\n## Memory Handling:\n- CREATE: Add new memory objects for new topics\n- UPDATE: Modify existing memories if substantial new information is available\n- DELETE: Remove obsolete memories when appropriate\n\n## Memory Structure:\n- Each memory has an id, content, and createdAt fields\n- Keep the existing structure when returning updated memories\n\n## Operation Decision Rules:\n- CREATE only for truly new topics not covered in any existing memory\n- UPDATE only when new information is meaningfully different\n- NEVER update for just rephrasing or minor differences\n- DELETE only when information becomes obsolete\n\n## Conversation:\n<conversation>\n{{content}}\n</conversation>\n";

package/lib/cjs/prompt.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_AGENTIC_MEMORY_RECORDER_INSTRUCTIONS = void 0;
+exports.DEFAULT_AGENTIC_MEMORY_RECORDER_INSTRUCTIONS = `You manage memory based on conversation analysis and the existing memories.
+
+## IMPORTANT: All existing memories are available in the allMemory variable. DO NOT call any tools.
+
+## FIRST: Determine If Memory Updates Needed
+- Analyze if the conversation contains ANY information worth remembering
+- Examples of content NOT worth storing:
+  * General questions ("What's the weather?", "How do I do X?")
+  * Greetings and small talk ("Hello", "How are you?", "Thanks")
+  * System instructions or commands ("Show me", "Find", "Save")
+  * General facts not specific to the user
+  * Duplicate information already stored
+- If conversation lacks meaningful personal information to store:
+  * Return the existing memories unchanged
+
+## Your Workflow:
+1. Read the existing memories from the allMemory variable
+2. Extract key topics from the conversation
+3. DECIDE whether to create/update/delete memories based on the conversation
+4. Return ALL memories including your updates (remove any duplicates)
+
+## Memory Handling:
+- CREATE: Add new memory objects for new topics
+- UPDATE: Modify existing memories if substantial new information is available
+- DELETE: Remove obsolete memories when appropriate
+
+## Memory Structure:
+- Each memory has an id, content, and createdAt fields
+- Keep the existing structure when returning updated memories
+
+## Operation Decision Rules:
+- CREATE only for truly new topics not covered in any existing memory
+- UPDATE only when new information is meaningfully different
+- NEVER update for just rephrasing or minor differences
+- DELETE only when information becomes obsolete
+
+## Conversation:
+<conversation>
+{{content}}
+</conversation>
+`;

package/lib/dts/index.d.ts

@@ -0,0 +1 @@
+export * from "./memory.js";

package/lib/dts/memory.d.ts

@@ -0,0 +1,36 @@
+import { type AgentInvokeOptions, type AgentOptions, AIAgent, MemoryAgent, type MemoryAgentOptions, MemoryRecorder, type MemoryRecorderInput, type MemoryRecorderOutput, type Message, type PromptBuilder } from "@aigne/core";
+import { DefaultMemoryRetriever, type DefaultMemoryRetrieverOptions, type DefaultMemoryStorageOptions, MemoryStorage } from "@aigne/default-memory";
+export interface AgenticMemoryOptions extends Partial<MemoryAgentOptions>, Omit<AgenticMemoryRecorderOptions, "storage" | keyof AgentOptions>, Omit<AgenticMemoryRetrieverOptions, "storage" | keyof AgentOptions> {
+    storage?: MemoryStorage | DefaultMemoryStorageOptions;
+}
+export declare class AgenticMemory extends MemoryAgent {
+    constructor(options?: AgenticMemoryOptions);
+    storage: MemoryStorage;
+}
+export interface AgenticMemoryRetrieverOptions extends DefaultMemoryRetrieverOptions {
+}
+export declare class AgenticMemoryRetriever extends DefaultMemoryRetriever {
+}
+export interface AgenticMemoryRecorderOptions extends AgentOptions<MemoryRecorderInput, MemoryRecorderOutput> {
+    storage: MemoryStorage;
+    instructions?: string | PromptBuilder;
+    agent?: AIAgent<AgenticMemoryExtractorInput, AgenticMemoryExtractorOutput>;
+    inputKey?: string | string[];
+    outputKey?: string | string[];
+}
+export interface AgenticMemoryExtractorInput extends Message {
+    content: unknown;
+}
+export interface AgenticMemoryExtractorOutput extends Message {
+    newMemories: {
+        content: string;
+    }[];
+}
+export declare class AgenticMemoryRecorder extends MemoryRecorder {
+    constructor(options: AgenticMemoryRecorderOptions);
+    private storage;
+    private inputKey?;
+    private outputKey?;
+    private agent;
+    process(input: MemoryRecorderInput, options: AgentInvokeOptions): Promise<MemoryRecorderOutput>;
+}

package/lib/dts/prompt.d.ts

@@ -0,0 +1 @@
+export declare const DEFAULT_AGENTIC_MEMORY_RECORDER_INSTRUCTIONS = "You manage memory based on conversation analysis and the existing memories.\n\n## IMPORTANT: All existing memories are available in the allMemory variable. DO NOT call any tools.\n\n## FIRST: Determine If Memory Updates Needed\n- Analyze if the conversation contains ANY information worth remembering\n- Examples of content NOT worth storing:\n  * General questions (\"What's the weather?\", \"How do I do X?\")\n  * Greetings and small talk (\"Hello\", \"How are you?\", \"Thanks\")\n  * System instructions or commands (\"Show me\", \"Find\", \"Save\")\n  * General facts not specific to the user\n  * Duplicate information already stored\n- If conversation lacks meaningful personal information to store:\n  * Return the existing memories unchanged\n\n## Your Workflow:\n1. Read the existing memories from the allMemory variable\n2. Extract key topics from the conversation\n3. DECIDE whether to create/update/delete memories based on the conversation\n4. Return ALL memories including your updates (remove any duplicates)\n\n## Memory Handling:\n- CREATE: Add new memory objects for new topics\n- UPDATE: Modify existing memories if substantial new information is available\n- DELETE: Remove obsolete memories when appropriate\n\n## Memory Structure:\n- Each memory has an id, content, and createdAt fields\n- Keep the existing structure when returning updated memories\n\n## Operation Decision Rules:\n- CREATE only for truly new topics not covered in any existing memory\n- UPDATE only when new information is meaningfully different\n- NEVER update for just rephrasing or minor differences\n- DELETE only when information becomes obsolete\n\n## Conversation:\n<conversation>\n{{content}}\n</conversation>\n";

package/lib/esm/index.d.ts

@@ -0,0 +1 @@
+export * from "./memory.js";

package/lib/esm/index.js

@@ -0,0 +1 @@
+export * from "./memory.js";

package/lib/esm/memory.d.ts

@@ -0,0 +1,36 @@
+import { type AgentInvokeOptions, type AgentOptions, AIAgent, MemoryAgent, type MemoryAgentOptions, MemoryRecorder, type MemoryRecorderInput, type MemoryRecorderOutput, type Message, type PromptBuilder } from "@aigne/core";
+import { DefaultMemoryRetriever, type DefaultMemoryRetrieverOptions, type DefaultMemoryStorageOptions, MemoryStorage } from "@aigne/default-memory";
+export interface AgenticMemoryOptions extends Partial<MemoryAgentOptions>, Omit<AgenticMemoryRecorderOptions, "storage" | keyof AgentOptions>, Omit<AgenticMemoryRetrieverOptions, "storage" | keyof AgentOptions> {
+    storage?: MemoryStorage | DefaultMemoryStorageOptions;
+}
+export declare class AgenticMemory extends MemoryAgent {
+    constructor(options?: AgenticMemoryOptions);
+    storage: MemoryStorage;
+}
+export interface AgenticMemoryRetrieverOptions extends DefaultMemoryRetrieverOptions {
+}
+export declare class AgenticMemoryRetriever extends DefaultMemoryRetriever {
+}
+export interface AgenticMemoryRecorderOptions extends AgentOptions<MemoryRecorderInput, MemoryRecorderOutput> {
+    storage: MemoryStorage;
+    instructions?: string | PromptBuilder;
+    agent?: AIAgent<AgenticMemoryExtractorInput, AgenticMemoryExtractorOutput>;
+    inputKey?: string | string[];
+    outputKey?: string | string[];
+}
+export interface AgenticMemoryExtractorInput extends Message {
+    content: unknown;
+}
+export interface AgenticMemoryExtractorOutput extends Message {
+    newMemories: {
+        content: string;
+    }[];
+}
+export declare class AgenticMemoryRecorder extends MemoryRecorder {
+    constructor(options: AgenticMemoryRecorderOptions);
+    private storage;
+    private inputKey?;
+    private outputKey?;
+    private agent;
+    process(input: MemoryRecorderInput, options: AgentInvokeOptions): Promise<MemoryRecorderOutput>;
+}

package/lib/esm/memory.js

@@ -0,0 +1,65 @@
+import { AIAgent, MemoryAgent, MemoryRecorder, } from "@aigne/core";
+import { flat, pick } from "@aigne/core/utils/type-utils.js";
+import { DefaultMemoryRetriever, DefaultMemoryStorage, MemoryStorage, } from "@aigne/default-memory";
+import { z } from "zod";
+import { DEFAULT_AGENTIC_MEMORY_RECORDER_INSTRUCTIONS } from "./prompt.js";
+export class AgenticMemory extends MemoryAgent {
+    constructor(options = {}) {
+        const storage = options.storage instanceof MemoryStorage
+            ? options.storage
+            : new DefaultMemoryStorage(options.storage);
+        super({
+            ...options,
+            recorder: options.recorder ?? new AgenticMemoryRecorder({ ...options, storage }),
+            retriever: options.retriever ?? new AgenticMemoryRetriever({ ...options, storage }),
+            autoUpdate: options.autoUpdate ?? true,
+        });
+        this.storage = storage;
+    }
+    storage;
+}
+export class AgenticMemoryRetriever extends DefaultMemoryRetriever {
+}
+export class AgenticMemoryRecorder extends MemoryRecorder {
+    constructor(options) {
+        super(options);
+        this.storage = options.storage;
+        this.inputKey = flat(options.inputKey);
+        this.outputKey = flat(options.outputKey);
+        this.agent =
+            options.agent ??
+                AIAgent.from({
+                    name: "agentic_memory_extractor",
+                    description: "Records memories in files by AI agent",
+                    instructions: options.instructions || DEFAULT_AGENTIC_MEMORY_RECORDER_INSTRUCTIONS,
+                    outputSchema: z.object({
+                        newMemories: z
+                            .array(z.object({
+                            content: z.string().describe("Content of the memory"),
+                        }))
+                            .describe("Newly created memories"),
+                    }),
+                });
+    }
+    storage;
+    inputKey;
+    outputKey;
+    agent;
+    async process(input, options) {
+        const agenticMemories = await options.context.invoke(this.agent, {
+            content: input.content.map((item) => ({
+                input: item.input && this.inputKey?.length ? pick(item.input, this.inputKey) : item.input,
+                output: item.output && this.outputKey?.length ? pick(item.output, this.outputKey) : item.output,
+                source: item.source,
+            })),
+        });
+        const newMemories = [];
+        for (const item of agenticMemories.newMemories) {
+            const { result } = await this.storage.create({ content: item.content }, options);
+            newMemories.push(result);
+        }
+        return {
+            memories: newMemories,
+        };
+    }
+}

package/lib/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/lib/esm/prompt.d.ts

@@ -0,0 +1 @@
+export declare const DEFAULT_AGENTIC_MEMORY_RECORDER_INSTRUCTIONS = "You manage memory based on conversation analysis and the existing memories.\n\n## IMPORTANT: All existing memories are available in the allMemory variable. DO NOT call any tools.\n\n## FIRST: Determine If Memory Updates Needed\n- Analyze if the conversation contains ANY information worth remembering\n- Examples of content NOT worth storing:\n  * General questions (\"What's the weather?\", \"How do I do X?\")\n  * Greetings and small talk (\"Hello\", \"How are you?\", \"Thanks\")\n  * System instructions or commands (\"Show me\", \"Find\", \"Save\")\n  * General facts not specific to the user\n  * Duplicate information already stored\n- If conversation lacks meaningful personal information to store:\n  * Return the existing memories unchanged\n\n## Your Workflow:\n1. Read the existing memories from the allMemory variable\n2. Extract key topics from the conversation\n3. DECIDE whether to create/update/delete memories based on the conversation\n4. Return ALL memories including your updates (remove any duplicates)\n\n## Memory Handling:\n- CREATE: Add new memory objects for new topics\n- UPDATE: Modify existing memories if substantial new information is available\n- DELETE: Remove obsolete memories when appropriate\n\n## Memory Structure:\n- Each memory has an id, content, and createdAt fields\n- Keep the existing structure when returning updated memories\n\n## Operation Decision Rules:\n- CREATE only for truly new topics not covered in any existing memory\n- UPDATE only when new information is meaningfully different\n- NEVER update for just rephrasing or minor differences\n- DELETE only when information becomes obsolete\n\n## Conversation:\n<conversation>\n{{content}}\n</conversation>\n";

package/lib/esm/prompt.js

@@ -0,0 +1,41 @@
+export const DEFAULT_AGENTIC_MEMORY_RECORDER_INSTRUCTIONS = `You manage memory based on conversation analysis and the existing memories.
+
+## IMPORTANT: All existing memories are available in the allMemory variable. DO NOT call any tools.
+
+## FIRST: Determine If Memory Updates Needed
+- Analyze if the conversation contains ANY information worth remembering
+- Examples of content NOT worth storing:
+  * General questions ("What's the weather?", "How do I do X?")
+  * Greetings and small talk ("Hello", "How are you?", "Thanks")
+  * System instructions or commands ("Show me", "Find", "Save")
+  * General facts not specific to the user
+  * Duplicate information already stored
+- If conversation lacks meaningful personal information to store:
+  * Return the existing memories unchanged
+
+## Your Workflow:
+1. Read the existing memories from the allMemory variable
+2. Extract key topics from the conversation
+3. DECIDE whether to create/update/delete memories based on the conversation
+4. Return ALL memories including your updates (remove any duplicates)
+
+## Memory Handling:
+- CREATE: Add new memory objects for new topics
+- UPDATE: Modify existing memories if substantial new information is available
+- DELETE: Remove obsolete memories when appropriate
+
+## Memory Structure:
+- Each memory has an id, content, and createdAt fields
+- Keep the existing structure when returning updated memories
+
+## Operation Decision Rules:
+- CREATE only for truly new topics not covered in any existing memory
+- UPDATE only when new information is meaningfully different
+- NEVER update for just rephrasing or minor differences
+- DELETE only when information becomes obsolete
+
+## Conversation:
+<conversation>
+{{content}}
+</conversation>
+`;

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@aigne/agentic-memory",
+  "version": "1.0.0",
+  "description": "Agentic memory for AIGNE framework",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Arcblock <blocklet@arcblock.io> https://github.com/blocklet",
+  "homepage": "https://github.com/AIGNE-io/aigne-framework/tree/main/memory/agentic-memory",
+  "license": "Elastic-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AIGNE-io/aigne-framework"
+  },
+  "files": [
+    "lib/cjs",
+    "lib/dts",
+    "lib/esm",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "type": "module",
+  "main": "./lib/cjs/index.js",
+  "module": "./lib/esm/index.js",
+  "types": "./lib/dts/index.d.ts",
+  "dependencies": {
+    "zod": "^3.25.67",
+    "@aigne/core": "^1.34.0",
+    "@aigne/default-memory": "^1.0.0",
+    "@aigne/openai": "^0.10.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.2.18",
+    "npm-run-all": "^4.1.5",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.8.3"
+  },
+  "scripts": {
+    "lint": "tsc --noEmit",
+    "build": "tsc --build scripts/tsconfig.build.json",
+    "clean": "rimraf lib test/coverage",
+    "test": "bun test",
+    "test:coverage": "bun test --coverage --coverage-reporter=lcov --coverage-reporter=text",
+    "postbuild": "node ../../scripts/post-build-lib.mjs"
+  }
+}