@aalis/plugin-vectorstore-api 0.1.0

package/README.md

@@ -0,0 +1,25 @@
+# @aalis/plugin-vectorstore-api
+
+类型/接口/能力声明包（只导出 `type` 与 `*Capabilities`，不含运行时逻辑）
+
+## 角色
+
+类型/接口/能力声明包（只导出 `type` 与 `*Capabilities`，不含运行时逻辑）
+
+## 安装
+
+```bash
+pnpm add @aalis/plugin-vectorstore-api
+```
+
+## 使用
+
+```ts
+import type { /* ... */ } from '@aalis/plugin-vectorstore-api';
+```
+
+本包为 *-api 类型包；实现见对应的运行时插件。
+
+## 许可
+
+见仓库根目录 LICENSE。

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/** 向量搜索结果条目 */
+export interface VectorSearchResult {
+    /** 余弦相似度分数 */
+    score: number;
+    /** 存储时附带的元数据 */
+    metadata: Record<string, unknown>;
+}
+/** 向量数据库服务——由 vectorstore 插件提供 */
+export interface VectorStoreService {
+    /** 添加一条向量及其元数据 */
+    add(vector: number[], metadata: Record<string, unknown>): Promise<void>;
+    /** 搜索最近邻，返回 [分数, 元数据][] */
+    search(queryVector: number[], topK: number): Promise<VectorSearchResult[]>;
+    /** 当前存储的向量总数 */
+    size(): Promise<number>;
+    /** 清空所有向量数据 */
+    clear(): Promise<void>;
+    /** 按 metadata 字段过滤删除（如 { sessionId: 'xxx' }） */
+    deleteByFilter?(filter: Record<string, unknown>): Promise<number>;
+    /** 持久化（由调用方或 dispose 触发） */
+    save(): Promise<void>;
+}
+declare module '@aalis/core' {
+    interface ServiceTypeMap {
+        vectorstore: VectorStoreService;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,eAAe;AACf,MAAM,WAAW,kBAAkB;IACjC,cAAc;IACd,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,kBAAkB;IAClB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,2BAA2B;IAC3B,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC3E,gBAAgB;IAChB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,eAAe;IACf,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,gDAAgD;IAChD,cAAc,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,4BAA4B;IAC5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAGD,OAAO,QAAQ,aAAa,CAAC;IAC3B,UAAU,cAAc;QACtB,WAAW,EAAE,kBAAkB,CAAC;KACjC;CACF"}

package/dist/index.js

@@ -0,0 +1,3 @@
+// ----- 向量数据库服务接口 -----
+export {};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wBAAwB"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@aalis/plugin-vectorstore-api",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "@aalis/core": "0.1.0"
+  },
+  "aalis": {
+    "types": true
+  },
+  "peerDependencies": {
+    "@aalis/core": "^0.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}