@easynet/agent-memory 0.0.2

package/README.md

@@ -0,0 +1,260 @@
+# agent-memory
+
+一个简单易用的 Agent 记忆管理 SDK，支持长期记忆存储、文档记忆和多模态文档处理。
+
+## 快速开始
+
+```bash
+npm install agent-memory
+```
+
+```typescript
+import { AgentMemory } from "agent-memory";
+
+const am = await AgentMemory.fromYaml("./agent-memory.yaml");
+
+// 记忆对话
+await am.remember({
+  messages: [
+    { role: "user", content: "发布流程：先 dc-dev-testing，再 dc-prod" }
+  ],
+  actor: { id: "U123", type: "user" },
+  scope: { projectId: "bds" },
+});
+
+// 记忆文档（支持多模态）
+await am.rememberDocument({
+  document: {
+    id: "doc_001",
+    type: "pdf",
+    text: "PDF提取的文本内容...",
+    metadata: { title: "技术文档", path: "/docs/tech.pdf" },
+  },
+  actor: { id: "system", type: "system" },
+  scope: { projectId: "main-project" },
+});
+
+// 召回
+const result = await am.recall({
+  query: "发布流程是什么？",
+  scope: { projectId: "bds" },
+});
+
+console.log(result.context);
+```
+
+## 主要特性
+
+- ✅ **双模式支持**：Platform API 模式 和 In-Memory 模式（SQLite + 向量索引）
+- ✅ **文档记忆**：支持文本、PDF、图片、Markdown、HTML、代码等多种文档类型
+- ✅ **多模态支持**：图片OCR文本、PDF分页、代码文档等
+- ✅ **自动分块**：大文档自动分块，支持重叠窗口
+- ✅ **MemoryGate**：脱敏、抽取、过滤、去重
+- ✅ **向量检索**：基于 Embedding 的语义搜索
+- ✅ **YAML配置**：简单易用的配置文件
+
+## 文档记忆
+
+支持多种文档类型：
+
+- `text` - 纯文本
+- `pdf` - PDF文档（支持分页）
+- `image` - 图片（支持OCR文本）
+- `markdown` - Markdown文档
+- `html` - HTML文档
+- `code` - 代码文件
+
+```typescript
+// 记忆PDF文档（自动分块）
+await am.rememberDocument({
+  document: {
+    id: "pdf_001",
+    type: "pdf",
+    text: "PDF内容...",
+    page: 1,
+    metadata: { title: "文档", pageCount: 50 },
+  },
+  autoChunk: true,
+  chunkSize: 1000,
+  extractMetadata: true,
+});
+
+// 记忆图片（带OCR）
+await am.rememberDocument({
+  document: {
+    id: "img_001",
+    type: "image",
+    text: "图片描述",
+    extractedText: "OCR提取的文字",
+    imageUrl: "https://example.com/image.png",
+  },
+});
+```
+
+详细文档请参考 [docs/DOCUMENT_MEMORY.md](./docs/DOCUMENT_MEMORY.md)
+
+## 配置
+
+创建 `agent-memory.yaml`：
+
+```yaml
+store:
+  mem0:
+    mode: in_memory  # 或 platform
+
+persistence:
+  sqlite:
+    path: ./data/memory.db
+
+embedding:
+  provider: ollama
+  model: embedding-gemma:latest
+
+memory:
+  gate:
+    enabled: true
+    redact:
+      enabled: true
+    dedupe:
+      enabled: true
+      similarity_threshold: 0.92
+```
+
+## 两种运行模式
+
+### 1. Platform 模式（Mem0 Platform API）
+
+使用 Mem0 Platform 作为后端：
+
+```yaml
+store:
+  mem0:
+    mode: platform
+    api_key: ${MEM0_API_KEY}
+    base_url: https://api.mem0.ai
+```
+
+### 2. In-Memory 模式（本地SQLite + 向量索引）
+
+完全本地运行，使用 SQLite 存储和内存向量索引：
+
+```yaml
+store:
+  mem0:
+    mode: in_memory
+
+persistence:
+  sqlite:
+    path: ./data/memory.db
+
+embedding:
+  provider: ollama
+  model: embedding-gemma:latest
+```
+
+## API
+
+### remember()
+
+记忆对话或文本：
+
+```typescript
+await am.remember({
+  messages: [{ role: "user", content: "..." }],
+  // 或
+  text: "...",
+  actor: { id: "U123", type: "user" },
+  scope: { projectId: "bds" },
+  hint: { types: ["policy", "episodic"] },
+});
+```
+
+### rememberDocument()
+
+记忆文档（支持多模态）：
+
+```typescript
+await am.rememberDocument({
+  document: DocumentChunk | DocumentChunk[],
+  actor?: Actor,
+  scope?: Scope,
+  autoChunk?: boolean,
+  chunkSize?: number,
+  extractMetadata?: boolean,
+  tags?: string[],
+});
+```
+
+### recall()
+
+召回记忆和文档：
+
+```typescript
+const result = await am.recall({
+  query: "发布流程是什么？",
+  actor: { id: "U123", type: "user" },
+  scope: { projectId: "bds" },
+  topK: 10,
+  includeMemory: true,
+  includeDocs: true,
+});
+```
+
+## 项目结构
+
+```
+src/
+├── core/                   # 核心类
+│   └── agent-memory.ts     # 主类
+├── adapters/               # 适配器（Mem0, RAG HTTP）
+├── storage/               
+│   ├── persistence/        # SQLite持久化
+│   └── indexing/          # In-Memory向量索引
+├── processing/
+│   ├── gate/              # MemoryGate
+│   ├── embedding/         # Embedding计算
+│   ├── recall/            # 召回引擎
+│   ├── ranker/            # 排序器
+│   ├── context/           # Context构建
+│   └── document/          # 文档处理
+├── boot/                   # 启动回灌
+├── config/                 # 配置加载
+├── types/                  # 类型定义
+└── cli/                    # Chat Console
+
+test-configs/               # 测试配置文件
+```
+
+**代码规范**:
+- ✅ 所有文件不超过 500 行
+- ✅ 文件命名使用 kebab-case
+- ✅ 清晰的模块职责分离
+
+详细结构说明请参考 [PROJECT_STRUCTURE.md](./PROJECT_STRUCTURE.md)
+
+## 开发
+
+```bash
+# 安装依赖
+npm install
+
+# 构建
+npm run build
+
+# 测试
+npm test
+
+# Chat Console
+npm run chat
+npm run chat:split
+```
+
+## 示例
+
+- `examples/basic-usage.ts` - 基本用法
+- `examples/document-memory.ts` - 文档记忆示例
+- `examples/chat-example.ts` - Chat Console 示例
+
+## License
+
+MIT

package/bin/chat

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+/**
+ * Chat Console entry point
+ * Usage: node bin/chat [config-path]
+ */
+
+const path = require("path");
+const chatModule = require(path.join(__dirname, "../dist/cli/chat.js"));
+
+// The main function is already called in chat.ts when executed directly

package/dist/adapters/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Adapter factory
+ */
+import { MemoryStore, DocRetriever } from "./types";
+import { Config } from "../types/config";
+export declare function createMemoryStore(config: Config): MemoryStore;
+export declare function createDocRetriever(config: Config): DocRetriever | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAIzC,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAO7D;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAWtE"}

package/dist/adapters/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Adapter factory
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMemoryStore = createMemoryStore;
+exports.createDocRetriever = createDocRetriever;
+const mem0_store_1 = require("./mem0/mem0-store");
+const rag_http_retriever_1 = require("./rag-http/rag-http-retriever");
+function createMemoryStore(config) {
+    switch (config.store.provider) {
+        case "mem0":
+            return new mem0_store_1.Mem0Store(config);
+        default:
+            throw new Error(`Unsupported memory store provider: ${config.store.provider}`);
+    }
+}
+function createDocRetriever(config) {
+    if (!config.docs?.enabled) {
+        return null;
+    }
+    switch (config.docs.retriever) {
+        case "rag_http":
+            return new rag_http_retriever_1.RagHttpRetriever(config);
+        default:
+            throw new Error(`Unsupported doc retriever: ${config.docs.retriever}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAOH,8CAOC;AAED,gDAWC;AAvBD,kDAA8C;AAC9C,sEAAiE;AAEjE,SAAgB,iBAAiB,CAAC,MAAc;IAC9C,QAAQ,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC9B,KAAK,MAAM;YACT,OAAO,IAAI,sBAAS,CAAC,MAAM,CAAC,CAAC;QAC/B;YACE,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnF,CAAC;AACH,CAAC;AAED,SAAgB,kBAAkB,CAAC,MAAc;IAC/C,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAC9B,KAAK,UAAU;YACb,OAAO,IAAI,qCAAgB,CAAC,MAAM,CAAC,CAAC;QACtC;YACE,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC"}

package/dist/adapters/mem0/mem0-store.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Mem0 Platform Store Adapter
+ */
+import { MemoryStore } from "../types";
+import { MemoryItem, Actor, Scope } from "../../types";
+import { Config } from "../../types/config";
+export declare class Mem0Store implements MemoryStore {
+    private apiKey;
+    private baseUrl;
+    private namespaceConfig?;
+    constructor(config: Config);
+    /**
+     * Build namespace from scope and actor
+     */
+    private buildNamespace;
+    add(items: MemoryItem[], opts: {
+        actor?: Actor;
+        scope?: Scope;
+    }): Promise<void>;
+    search(query: string, opts: {
+        actor?: Actor;
+        scope?: Scope;
+        topK?: number;
+        filters?: any;
+    }): Promise<MemoryItem[]>;
+    delete(id: string): Promise<void>;
+    updateUtility(id: string, delta: number): Promise<void>;
+}
+//# sourceMappingURL=mem0-store.d.ts.map

package/dist/adapters/mem0/mem0-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem0-store.d.ts","sourceRoot":"","sources":["../../../src/adapters/mem0/mem0-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,qBAAa,SAAU,YAAW,WAAW;IAC3C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAAC,CAItB;gBAEU,MAAM,EAAE,MAAM;IAU1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAyChB,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiD/E,MAAM,CACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,GACnE,OAAO,CAAC,UAAU,EAAE,CAAC;IAkDlB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBjC,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAK9D"}

package/dist/adapters/mem0/mem0-store.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * Mem0 Platform Store Adapter
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Mem0Store = void 0;
+class Mem0Store {
+    constructor(config) {
+        const mem0Config = config.store.mem0;
+        if (!mem0Config.api_key) {
+            throw new Error("Mem0 API key is required for platform mode");
+        }
+        this.apiKey = mem0Config.api_key;
+        this.baseUrl = mem0Config.base_url || "https://api.mem0.ai";
+        this.namespaceConfig = mem0Config.namespace;
+    }
+    /**
+     * Build namespace from scope and actor
+     */
+    buildNamespace(actor, scope) {
+        const namespace = {};
+        if (this.namespaceConfig) {
+            if (this.namespaceConfig.project_from && scope?.projectId) {
+                namespace.project = scope.projectId;
+            }
+            if (this.namespaceConfig.run_from) {
+                // Support patterns like "scope.channelId:scope.threadId"
+                const parts = this.namespaceConfig.run_from.split(":");
+                const runParts = [];
+                for (const part of parts) {
+                    if (part.startsWith("scope.")) {
+                        const key = part.replace("scope.", "");
+                        if (scope?.[key]) {
+                            runParts.push(scope[key]);
+                        }
+                    }
+                }
+                if (runParts.length > 0) {
+                    namespace.run = runParts.join(":");
+                }
+            }
+            if (this.namespaceConfig.user_from && actor?.id) {
+                // Support patterns like "actor.id"
+                if (this.namespaceConfig.user_from.startsWith("actor.")) {
+                    const key = this.namespaceConfig.user_from.replace("actor.", "");
+                    if (actor[key]) {
+                        namespace.user = String(actor[key]);
+                    }
+                }
+                else {
+                    namespace.user = actor.id;
+                }
+            }
+        }
+        return namespace;
+    }
+    async add(items, opts) {
+        const namespace = this.buildNamespace(opts.actor, opts.scope);
+        for (const item of items) {
+            try {
+                const response = await fetch(`${this.baseUrl}/v1/memories`, {
+                    method: "POST",
+                    headers: {
+                        "Authorization": `Bearer ${this.apiKey}`,
+                        "Content-Type": "application/json",
+                    },
+                    body: JSON.stringify({
+                        messages: [
+                            {
+                                role: "user",
+                                content: item.content,
+                            }
+                        ],
+                        agent_id: namespace.user || "default",
+                        user_id: namespace.user || "default",
+                        metadata: {
+                            type: item.type,
+                            tags: item.tags || [],
+                            confidence: item.confidence,
+                            utility: item.utility,
+                            source: item.source,
+                            scope: opts.scope,
+                            ...namespace,
+                        },
+                    }),
+                });
+                if (!response.ok) {
+                    const error = await response.text();
+                    throw new Error(`Mem0 API error: ${response.status} ${error}`);
+                }
+                const result = await response.json();
+                // Update item.id with the returned memory ID if available
+                if (result.id) {
+                    item.id = result.id;
+                }
+            }
+            catch (error) {
+                console.error(`Failed to add memory item: ${item.content.substring(0, 50)}...`, error);
+                throw error;
+            }
+        }
+    }
+    async search(query, opts) {
+        const namespace = this.buildNamespace(opts.actor, opts.scope);
+        const topK = opts.topK || 10;
+        try {
+            const response = await fetch(`${this.baseUrl}/v1/memories/search`, {
+                method: "POST",
+                headers: {
+                    "Authorization": `Bearer ${this.apiKey}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({
+                    query,
+                    agent_id: namespace.user || "default",
+                    user_id: namespace.user || "default",
+                    limit: topK,
+                    metadata: {
+                        ...namespace,
+                        ...opts.filters,
+                    },
+                }),
+            });
+            if (!response.ok) {
+                const error = await response.text();
+                throw new Error(`Mem0 API error: ${response.status} ${error}`);
+            }
+            const result = await response.json();
+            // Transform Mem0 response to MemoryItem[]
+            return (result.results || []).map((mem) => ({
+                id: mem.id || mem.memory_id || String(Date.now()),
+                type: (mem.metadata?.type || "episodic"),
+                content: mem.memory || mem.content || "",
+                actor: opts.actor,
+                scope: opts.scope,
+                tags: mem.metadata?.tags || [],
+                confidence: mem.score || mem.metadata?.confidence,
+                utility: mem.metadata?.utility,
+                source: mem.metadata?.source,
+                createdAt: mem.created_at || new Date().toISOString(),
+                updatedAt: mem.updated_at,
+            }));
+        }
+        catch (error) {
+            console.error("Failed to search memories:", error);
+            throw error;
+        }
+    }
+    async delete(id) {
+        try {
+            const response = await fetch(`${this.baseUrl}/v1/memories/${id}`, {
+                method: "DELETE",
+                headers: {
+                    "Authorization": `Bearer ${this.apiKey}`,
+                },
+            });
+            if (!response.ok) {
+                const error = await response.text();
+                throw new Error(`Mem0 API error: ${response.status} ${error}`);
+            }
+        }
+        catch (error) {
+            console.error(`Failed to delete memory ${id}:`, error);
+            throw error;
+        }
+    }
+    async updateUtility(id, delta) {
+        // Mem0 may not support utility updates directly
+        // This could be implemented via metadata updates if supported
+        console.warn("updateUtility not fully implemented for Mem0Store");
+    }
+}
+exports.Mem0Store = Mem0Store;
+//# sourceMappingURL=mem0-store.js.map

package/dist/adapters/mem0/mem0-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem0-store.js","sourceRoot":"","sources":["../../../src/adapters/mem0/mem0-store.ts"],"names":[],"mappings":"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"}

package/dist/adapters/rag-http/rag-http-retriever.d.ts

@@ -0,0 +1,18 @@
+/**
+ * RAG HTTP Retriever Adapter
+ */
+import { DocRetriever } from "../types";
+import { DocChunk, Scope } from "../../types";
+import { Config } from "../../types/config";
+export declare class RagHttpRetriever implements DocRetriever {
+    private baseUrl;
+    private searchEndpoint;
+    private timeoutMs;
+    private defaultTopK;
+    constructor(config: Config);
+    search(query: string, opts: {
+        scope?: Scope;
+        topK?: number;
+    }): Promise<DocChunk[]>;
+}
+//# sourceMappingURL=rag-http-retriever.d.ts.map

package/dist/adapters/rag-http/rag-http-retriever.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-http-retriever.d.ts","sourceRoot":"","sources":["../../../src/adapters/rag-http/rag-http-retriever.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,MAAM;IAepB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAsDzF"}

package/dist/adapters/rag-http/rag-http-retriever.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * RAG HTTP Retriever Adapter
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RagHttpRetriever = void 0;
+class RagHttpRetriever {
+    constructor(config) {
+        if (!config.docs?.enabled) {
+            throw new Error("docs.enabled must be true to use RagHttpRetriever");
+        }
+        const ragConfig = config.docs.rag_http;
+        if (!ragConfig) {
+            throw new Error("rag_http configuration is required when docs.enabled is true");
+        }
+        this.baseUrl = ragConfig.base_url;
+        this.searchEndpoint = ragConfig.endpoints?.search || "/search";
+        this.timeoutMs = ragConfig.timeout_ms || 8000;
+        this.defaultTopK = ragConfig.top_k || 6;
+    }
+    async search(query, opts) {
+        const topK = opts.topK || this.defaultTopK;
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+            const response = await fetch(`${this.baseUrl}${this.searchEndpoint}`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({
+                    query,
+                    topK,
+                    scope: opts.scope,
+                }),
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const error = await response.text();
+                throw new Error(`RAG HTTP error: ${response.status} ${error}`);
+            }
+            const result = await response.json();
+            // Transform response to DocChunk[]
+            // Expected format: { chunks: DocChunk[] } or DocChunk[]
+            const chunks = result.chunks || result || [];
+            return chunks.map((chunk, index) => ({
+                id: chunk.id || `doc_${Date.now()}_${index}`,
+                text: chunk.text || chunk.content || "",
+                score: chunk.score || chunk.similarity,
+                source: chunk.source || {
+                    title: chunk.title,
+                    url: chunk.url,
+                    path: chunk.path,
+                    page: chunk.page,
+                    section: chunk.section,
+                },
+                citations: chunk.citations,
+            }));
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "AbortError") {
+                throw new Error(`RAG HTTP request timeout after ${this.timeoutMs}ms`);
+            }
+            console.error("Failed to search documents:", error);
+            throw error;
+        }
+    }
+}
+exports.RagHttpRetriever = RagHttpRetriever;
+//# sourceMappingURL=rag-http-retriever.js.map

package/dist/adapters/rag-http/rag-http-retriever.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-http-retriever.js","sourceRoot":"","sources":["../../../src/adapters/rag-http/rag-http-retriever.ts"],"names":[],"mappings":"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"}

package/dist/adapters/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Adapter interfaces
+ */
+import { MemoryItem, DocChunk, Actor, Scope } from "../types";
+export interface MemoryStore {
+    add(items: MemoryItem[], opts: {
+        actor?: Actor;
+        scope?: Scope;
+    }): Promise<void>;
+    search(query: string, opts: {
+        actor?: Actor;
+        scope?: Scope;
+        topK?: number;
+        filters?: any;
+    }): Promise<MemoryItem[]>;
+    delete?(id: string): Promise<void>;
+    updateUtility?(id: string, delta: number): Promise<void>;
+}
+export interface DocRetriever {
+    search(query: string, opts: {
+        scope?: Scope;
+        topK?: number;
+    }): Promise<DocChunk[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACnH,MAAM,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,aAAa,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;CACpF"}

package/dist/adapters/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Adapter interfaces
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map