@zooique/memora 1.0.1 → 2.0.3

package/package.json

@@ -1,20 +1,36 @@
 {
   "name": "@zooique/memora",
-  "version": "1.0.1",
-  "description": "通用 Agent 架构（纯逻辑库）— 本地、私有、领域无关，万物皆记忆",
+  "version": "2.0.3",
+  "description": "Node.js 专用 Agent 架构 — 本地、私有、领域无关，万物皆记忆（零第三方运行时依赖，依赖 Node.js 内置模块）",
   "type": "module",
   "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "docs/memora-api-reference.md",
+    "docs/memora-接入指南.md"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "exports": {
     ".": {
       "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     }
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitee.com/zooique/memora.git"
+  },
+  "homepage": "https://gitee.com/zooique/memora#readme",
+  "bugs": {
+    "url": "https://gitee.com/zooique/memora/issues"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
     "test": "vitest run",
@@ -32,17 +48,27 @@
     "node": ">=22.0.0"
   },
   "keywords": [
+    "memora",
     "agent",
     "memory",
+    "agent-memory",
     "llm",
     "ai",
-    "local-first"
+    "local-first",
+    "local-ai",
+    "embedding",
+    "vector-search",
+    "rag",
+    "typescript",
+    "zero-dependency",
+    "semantic-search",
+    "knowledge-base",
+    "记忆",
+    "智能体",
+    "本地优先"
   ],
   "author": "Memora Contributors",
   "license": "MIT",
-  "dependencies": {
-    "zod": "^3.25.76"
-  },
   "peerDependencies": {
     "pino": ">=9.0.0"
   },
@@ -51,23 +77,24 @@
       "optional": true
     }
   },
-
   "devDependencies": {
-    "@commitlint/cli": "^21.0.2",
-    "@commitlint/config-conventional": "^21.0.2",
-    "@types/node": "^22.7.0",
-    "@typescript-eslint/eslint-plugin": "^8.8.0",
-    "@typescript-eslint/parser": "^8.8.0",
-    "@vitest/coverage-v8": "^4.1.8",
-    "eslint": "^9.12.0",
+    "@commitlint/cli": "^21.2.1",
+    "@commitlint/config-conventional": "^21.2.0",
+    "@types/node": "^22.20.1",
+    "@typescript-eslint/eslint-plugin": "^8.65.0",
+    "@typescript-eslint/parser": "^8.65.0",
+    "@vitest/coverage-v8": "^4.1.10",
+    "eslint": "^9.39.5",
     "lefthook": "^1.7.0",
-    "msw": "^2.4.0",
+    "msw": "^2.15.0",
+    "pino": "^9.7.0",
     "pino-pretty": "^11.2.0",
-    "prettier": "^3.3.0",
+    "prettier": "^3.9.6",
     "rimraf": "^6.1.3",
-    "tsc-alias": "^1.8.17",
-    "tsx": "^4.19.0",
+    "tsc-alias": "^1.9.1",
+    "tsx": "^4.23.1",
     "typescript": "^5.6.0",
-    "vitest": "^4.1.8"
-  }
+    "vitest": "^4.1.10"
+  },
+  "packageManager": "pnpm@10.29.2+sha512.bef43fa759d91fd2da4b319a5a0d13ef7a45bb985a3d7342058470f9d2051a3ba8674e629672654686ef9443ad13a82da2beb9eeb3e0221c87b8154fff9d74b8"
 }

package/dist/agent/managers/memoryMutator.d.ts

@@ -1,92 +0,0 @@
-/**
- * 记忆写入器 — 统一的记忆写操作代理
- *
- * 从 MemoryInspector 拆分出来，专职负责 IMemoryStorage + IMemoryRelationStore 的写操作。
- *
- * 设计原则：
- *   - 与 MemoryInspector 严格分工：本类只写不读，MemoryInspector 只读不写
- *   - 薄层代理——所有方法直接透传到 IMemoryStorage / IMemoryRelationStore，
- *     不增加业务逻辑，仅提供"宿主通过 agent.memoryMutator 访问写操作"的分层入口
- *   - 静默降级——relationStore 未注入时关系写方法静默 no-op（ADR-014 降级优先）
- *
- * 与 MemoryInspector 的分工（P1-2 拆分，1.0 接口稳定化）：
- *   - agent.memory（MemoryInspector）：snapshot / search / stats / 关系查询 / getById / list 等
- *   - agent.memoryMutator（MemoryMutator）：upsert / delete / restore / purge / purgeExpired /
- *     addRelation / removeRelation
- *
- * 详见 ADR-010（Agent 门面）+ 迭代文档 P1-2
- */
-import type { Memory, MemoryRelation } from '../../memory/types.js';
-import type { IMemoryStorage } from '../../memory/storageInterface.js';
-import type { IMemoryRelationStore } from '../../memory/relationStore.js';
-/**
- * 记忆写入器类
- *
- * 宿主项目通过 agent.memoryMutator 访问写操作，无需绕过 inspector 直接访问 agent.storage
- * （后者已废弃，详见 agent.ts）。
- */
-export declare class MemoryMutator {
-    private readonly index;
-    /** 关系存储侧车（可选，ADR-014，未注入时关系写方法静默 no-op） */
-    private readonly relationStore;
-    /**
-     * @param index - 记忆存储（用于 upsert/delete/restore/purge/purgeExpired）
-     * @param relationStore - 关系存储侧车（可选，用于 addRelation/removeRelation）
-     */
-    constructor(index: IMemoryStorage, relationStore?: IMemoryRelationStore | null);
-    /**
-     * 插入或更新记忆
-     *
-     * @param memory 完整记忆对象
-     */
-    upsert(memory: Memory): void;
-    /**
-     * 软删除记忆（写入 deletedAt）
-     *
-     * @param id 记忆唯一标识（${source}:${name} 格式）
-     */
-    delete(id: string): void;
-    /**
-     * 恢复软删除的记忆（清除 deletedAt）
-     *
-     * @param id 记忆唯一标识
-     */
-    restore(id: string): void;
-    /**
-     * 物理删除记忆（不可恢复，用于回收站彻底删除）
-     *
-     * @param id 记忆唯一标识
-     */
-    purge(id: string): void;
-    /**
-     * 清理过期的软删除记忆
-     *
-     * 物理删除所有 deletedAt 早于 before 的记忆。
-     * 由宿主项目的定时器调用（默认 30 天保留期）。
-     *
-     * @param before 时间阈值，deletedAt 早于此值的记忆将被物理删除
-     * @returns 被清理的记忆数量
-     */
-    purgeExpired(before: Date): number;
-    /**
-     * 添加记忆关系（透传 relationStore）
-     *
-     * 用于宿主 UI 手动创建关系（关系图右键菜单 → 连线 → 创建关系）。
-     * relationStore 未注入时静默降级（不阻塞）。
-     *
-     * @param relation 关系边数据
-     */
-    addRelation(relation: MemoryRelation): void;
-    /**
-     * 删除记忆关系（透传 relationStore）
-     *
-     * 用于宿主 UI 手动删除关系（关系图右键菜单 → 编辑关系 → 删除）。
-     * relationStore 未注入时静默降级（不阻塞）。
-     *
-     * @param sourceId 关系起点
-     * @param targetId 关系终点
-     * @param type 关系类型
-     */
-    removeRelation(sourceId: string, targetId: string, type: string): void;
-}
-//# sourceMappingURL=memoryMutator.d.ts.map

package/dist/agent/managers/memoryMutator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memoryMutator.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/memoryMutator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE;;;;;GAKG;AACH,qBAAa,aAAa;IAStB,OAAO,CAAC,QAAQ,CAAC,KAAK;IARxB,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8B;IAE5D;;;OAGG;gBAEgB,KAAK,EAAE,cAAc,EACtC,aAAa,GAAE,oBAAoB,GAAG,IAAW;IAOnD;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIzB;;;;OAIG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIvB;;;;;;;;OAQG;IACH,YAAY,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM;IAMlC;;;;;;;OAOG;IACH,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAK3C;;;;;;;;;OASG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CAIvE"}

package/dist/agent/managers/memoryMutator.js

@@ -1,94 +0,0 @@
-/**
- * 记忆写入器类
- *
- * 宿主项目通过 agent.memoryMutator 访问写操作，无需绕过 inspector 直接访问 agent.storage
- * （后者已废弃，详见 agent.ts）。
- */
-export class MemoryMutator {
-    index;
-    /** 关系存储侧车（可选，ADR-014，未注入时关系写方法静默 no-op） */
-    relationStore;
-    /**
-     * @param index - 记忆存储（用于 upsert/delete/restore/purge/purgeExpired）
-     * @param relationStore - 关系存储侧车（可选，用于 addRelation/removeRelation）
-     */
-    constructor(index, relationStore = null) {
-        this.index = index;
-        this.relationStore = relationStore;
-    }
-    // ─── 记忆写入（IMemoryStorage 代理） ───────────────────
-    /**
-     * 插入或更新记忆
-     *
-     * @param memory 完整记忆对象
-     */
-    upsert(memory) {
-        this.index.upsert(memory);
-    }
-    /**
-     * 软删除记忆（写入 deletedAt）
-     *
-     * @param id 记忆唯一标识（${source}:${name} 格式）
-     */
-    delete(id) {
-        this.index.delete(id);
-    }
-    /**
-     * 恢复软删除的记忆（清除 deletedAt）
-     *
-     * @param id 记忆唯一标识
-     */
-    restore(id) {
-        this.index.restore(id);
-    }
-    /**
-     * 物理删除记忆（不可恢复，用于回收站彻底删除）
-     *
-     * @param id 记忆唯一标识
-     */
-    purge(id) {
-        this.index.purge(id);
-    }
-    /**
-     * 清理过期的软删除记忆
-     *
-     * 物理删除所有 deletedAt 早于 before 的记忆。
-     * 由宿主项目的定时器调用（默认 30 天保留期）。
-     *
-     * @param before 时间阈值，deletedAt 早于此值的记忆将被物理删除
-     * @returns 被清理的记忆数量
-     */
-    purgeExpired(before) {
-        return this.index.purgeExpired(before);
-    }
-    // ─── 关系写入（IMemoryRelationStore 代理，ADR-014 侧车） ───
-    /**
-     * 添加记忆关系（透传 relationStore）
-     *
-     * 用于宿主 UI 手动创建关系（关系图右键菜单 → 连线 → 创建关系）。
-     * relationStore 未注入时静默降级（不阻塞）。
-     *
-     * @param relation 关系边数据
-     */
-    addRelation(relation) {
-        if (!this.relationStore)
-            return;
-        this.relationStore.addRelation(relation);
-    }
-    /**
-     * 删除记忆关系（透传 relationStore）
-     *
-     * 用于宿主 UI 手动删除关系（关系图右键菜单 → 编辑关系 → 删除）。
-     * relationStore 未注入时静默降级（不阻塞）。
-     *
-     * @param sourceId 关系起点
-     * @param targetId 关系终点
-     * @param type 关系类型
-     */
-    removeRelation(sourceId, targetId, type) {
-        if (!this.relationStore)
-            return;
-        this.relationStore.removeRelation(sourceId, targetId, type);
-    }
-}
-//# sourceMappingURL=memoryMutator.js.map

package/dist/agent/managers/memoryMutator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"memoryMutator.js","sourceRoot":"","sources":["../../../src/agent/managers/memoryMutator.ts"],"names":[],"mappings":"AAsBA;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IASL;IARnB,2CAA2C;IAC1B,aAAa,CAA8B;IAE5D;;;OAGG;IACH,YACmB,KAAqB,EACtC,gBAA6C,IAAI;QADhC,UAAK,GAAL,KAAK,CAAgB;QAGtC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED,kDAAkD;IAElD;;;;OAIG;IACH,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,EAAU;QACf,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,EAAU;QAChB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,EAAU;QACd,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY,CAAC,MAAY;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,mDAAmD;IAEnD;;;;;;;OAOG;IACH,WAAW,CAAC,QAAwB;QAClC,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,OAAO;QAChC,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;;OASG;IACH,cAAc,CAAC,QAAgB,EAAE,QAAgB,EAAE,IAAY;QAC7D,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,OAAO;QAChC,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;CACF"}