@cicctencent/agent-server 0.1.1 → 0.1.2

package/dist/esm/spi/examples/typeorm-example.js

@@ -0,0 +1,315 @@
+// ============================================================
+// TypeORM SPI 实现示例 — BI 项目可参考此实现
+// ============================================================
+// ============================================================
+// TypeORM 存储适配器实现
+// ============================================================
+/**
+ * TypeORM 列表存储适配器
+ * 将 TypeORM Repository 包装为 ListStorageAdapter
+ */
+class TypeORMListStorage {
+    // 在实际项目中，这里会是 TypeORM Repository
+    // constructor(private repository: Repository<T>) {}
+    // 模拟 TypeORM Repository（示例）
+    data = [];
+    async list() {
+        // 实际实现: return this.repository.find();
+        return this.data;
+    }
+    async findById(id) {
+        // 实际实现: return this.repository.findOne({ where: { id } });
+        return this.data.find(item => item.id === id) ?? null;
+    }
+    async add(entity) {
+        // 实际实现: return this.repository.save(entity);
+        this.data.push(entity);
+        return entity;
+    }
+    async update(id, data) {
+        // 实际实现: 
+        // const entity = await this.repository.findOne({ where: { id } });
+        // if (!entity) return null;
+        // Object.assign(entity, data);
+        // return this.repository.save(entity);
+        const idx = this.data.findIndex(item => item.id === id);
+        if (idx === -1)
+            return null;
+        this.data[idx] = { ...this.data[idx], ...data };
+        return this.data[idx];
+    }
+    async remove(id) {
+        // 实际实现: 
+        // const result = await this.repository.delete(id);
+        // return result.affected > 0;
+        const idx = this.data.findIndex(item => item.id === id);
+        if (idx === -1)
+            return false;
+        this.data.splice(idx, 1);
+        return true;
+    }
+}
+// ============================================================
+// TypeORM ChatStoreProvider 实现
+// ============================================================
+/**
+ * BI 项目的 ChatStoreProvider 实现
+ * 使用 TypeORM Repository 作为底层存储
+ */
+class TypeORMChatStoreProvider {
+    // 在实际项目中，这里会是 TypeORM Repository
+    threadStorage;
+    messageStorages = new Map();
+    constructor(
+    // threadRepository: Repository<BIThreadEntity>,
+    // messageRepository: Repository<BIMessageEntity>
+    ) {
+        this.threadStorage = new TypeORMListStorage();
+    }
+    getMessageStorage(threadId) {
+        if (!this.messageStorages.has(threadId)) {
+            this.messageStorages.set(threadId, new TypeORMListStorage());
+        }
+        return this.messageStorages.get(threadId);
+    }
+    // ===== Thread CRUD =====
+    // 注意：TypeORM 实现使用异步方法
+    async getThreads(workspaceId) {
+        // 实际 TypeORM 实现:
+        // if (workspaceId) {
+        //   return this.threadRepository.find({ where: { workspaceId } });
+        // }
+        // return this.threadRepository.find();
+        const all = await this.threadStorage.list();
+        return all;
+    }
+    async getThread(id) {
+        // 实际 TypeORM 实现: 
+        // return this.threadRepository.findOne({ where: { id } });
+        const result = await this.threadStorage.findById(id);
+        return result;
+    }
+    async createThread(data) {
+        // 实际 TypeORM 实现:
+        // const thread = this.threadRepository.create(data);
+        // return this.threadRepository.save(thread);
+        const now = new Date();
+        const thread = {
+            id: Date.now(),
+            title: data.title || '新对话',
+            workspaceId: data.workspaceId,
+            userId: data.userId,
+            status: 'active',
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.threadStorage.add(thread);
+        return thread;
+    }
+    async updateThread(id, data) {
+        // 实际 TypeORM 实现:
+        // const thread = await this.threadRepository.findOne({ where: { id } });
+        // if (!thread) return null;
+        // Object.assign(thread, data, { updatedAt: new Date() });
+        // return this.threadRepository.save(thread);
+        const result = await this.threadStorage.update(id, { ...data, updatedAt: new Date() });
+        return result;
+    }
+    async deleteThread(id) {
+        // 实际 TypeORM 实现:
+        // const result = await this.threadRepository.delete(id);
+        // return result.affected > 0;
+        return this.threadStorage.remove(id);
+    }
+    // ===== Message CRUD =====
+    async getMessages(threadId, options) {
+        // 实际 TypeORM 实现:
+        // const [items, total] = await this.messageRepository.findAndCount({
+        //   where: { threadId },
+        //   order: { createdAt: 'DESC' },
+        //   skip: options?.offset || 0,
+        //   take: options?.limit || 50,
+        // });
+        // return { items, total, hasMore: (options?.offset || 0) + items.length < total };
+        const storage = this.getMessageStorage(Number(threadId));
+        const all = await storage.list();
+        const limit = options?.limit || 50;
+        const offset = options?.offset || 0;
+        const items = all.slice(offset, offset + limit);
+        return { items, total: all.length, hasMore: offset + items.length < all.length };
+    }
+    async addMessage(data) {
+        // 实际 TypeORM 实现:
+        // const msg = this.messageRepository.create({
+        //   threadId: data.threadId,
+        //   role: data.role,
+        //   content: data.content,
+        //   createdAt: new Date(),
+        // });
+        // return this.messageRepository.save(msg);
+        const storage = this.getMessageStorage(Number(data.threadId));
+        const msg = {
+            id: Date.now(),
+            threadId: Number(data.threadId),
+            role: data.role,
+            content: data.content,
+            createdAt: new Date(),
+        };
+        await storage.add(msg);
+        return msg;
+    }
+    async updateMessage(threadId, id, data) {
+        // 实际 TypeORM 实现:
+        // const msg = await this.messageRepository.findOne({ where: { id, threadId } });
+        // if (!msg) return null;
+        // Object.assign(msg, data);
+        // return this.messageRepository.save(msg);
+        const storage = this.getMessageStorage(Number(threadId));
+        const result = await storage.update(id, data);
+        return result;
+    }
+    async deleteMessage(threadId, id) {
+        // 实际 TypeORM 实现:
+        // const result = await this.messageRepository.delete({ id, threadId });
+        // return result.affected > 0;
+        const storage = this.getMessageStorage(Number(threadId));
+        return storage.remove(id);
+    }
+    async clearThreadMessages(threadId) {
+        // 实际 TypeORM 实现:
+        // await this.messageRepository.delete({ threadId });
+        this.messageStorages.delete(Number(threadId));
+    }
+    // ===== 历史重建 =====
+    async buildThreadHistory(threadId, limit) {
+        const { items } = await this.getMessages(threadId, { limit: limit || 20 });
+        return items.map(msg => ({
+            role: msg.role,
+            content: msg.content,
+        }));
+    }
+}
+// ============================================================
+// MidwayJS 服务实现示例
+// ============================================================
+/**
+ * MidwayJS Agent 服务示例
+ * 使用 SPI 适配到 MidwayJS + TypeORM
+ *
+ * 在实际项目中，这会是：
+ *
+ * @Provide()
+ * @Scope(ScopeEnum.Singleton)
+ * export class AgentService {
+ *   @Inject()
+ *   threadRepository: Repository<BIThreadEntity>;
+ *
+ *   @Inject()
+ *   messageRepository: Repository<BIMessageEntity>;
+ *
+ *   private server: AgentServer;
+ *
+ *   @Init()
+ *   async init() {
+ *     const chatStoreProvider = new TypeORMChatStoreProvider(
+ *       this.threadRepository,
+ *       this.messageRepository
+ *     );
+ *
+ *     this.server = createAgentServer({
+ *       llmProvider: await this.createLLMProvider(),
+ *       chatStoreProvider,
+ *       // 使用 Koa 适配器
+ *       createSSEResponseAdapter: (ctx) => new KoaSSEAdapter(ctx),
+ *     });
+ *   }
+ *
+ *   @Get('/chat/stream')
+ *   async chatStream(@Ctx() ctx: Context, @Query() query: { message: string }) {
+ *     const adapter = new KoaSSEAdapter(ctx);
+ *     await this.server.runAgentStream(adapter, { content: query.message });
+ *   }
+ * }
+ */
+// ============================================================
+// 导出示例实现
+// ============================================================
+export { TypeORMListStorage, TypeORMChatStoreProvider, };
+/**
+ * ## 使用说明
+ *
+ * ### 1. 在 MidwayJS 项目中使用 agent-server
+ *
+ * ```typescript
+ * // src/service/agent.service.ts
+ * import { Provide, Scope, ScopeEnum, Inject, Init, Get, Ctx, Query } from '@midwayjs/core';
+ * import { Context } from '@midwayjs/koa';
+ * import { createAgentServer, KoaSSEAdapter, type AgentServer } from '@cicctencent/agent-server';
+ * import { TypeORMChatStoreProvider } from './spi/typeorm-chat-provider';
+ *
+ * @Provide()
+ * @Scope(ScopeEnum.Singleton)
+ * export class AgentService {
+ *   @Inject()
+ *   threadRepository: Repository<ThreadEntity>;
+ *
+ *   @Inject()
+ *   messageRepository: Repository<MessageEntity>;
+ *
+ *   private server: AgentServer;
+ *
+ *   @Init()
+ *   async init() {
+ *     // 使用 TypeORM 存储适配器
+ *     const chatStoreProvider = new TypeORMChatStoreProvider(
+ *       this.threadRepository,
+ *       this.messageRepository
+ *     );
+ *
+ *     this.server = createAgentServer({
+ *       llmProvider: await this.createLLMProvider(),
+ *       chatStoreProvider, // 替换默认 JSON 文件存储
+ *     });
+ *   }
+ *
+ *   @Get('/chat/stream')
+ *   async chatStream(@Ctx() ctx: Context, @Query() query: { message: string }) {
+ *     // 使用 Koa/MidwayJS SSE 适配器
+ *     const adapter = new KoaSSEAdapter(ctx);
+ *     await this.server.runAgentStream(adapter, { content: query.message });
+ *   }
+ * }
+ * ```
+ *
+ * ### 2. 自定义实体字段
+ *
+ * agent-server 现在支持泛型实体类型，你可以：
+ * - 使用自己的实体结构（如 TypeORM 实体）
+ * - 自定义字段（如 userId, modelConfig 等）
+ * - 使用不同的 ID 类型（number / string / UUID）
+ *
+ * ### 3. 组件级使用（不依赖工厂）
+ *
+ * 如果不想使用 createAgentServer 工厂，可以只导入需要的组件：
+ *
+ * ```typescript
+ * import {
+ *   MemoryService,
+ *   writeSSE,
+ *   createBuiltinTools,
+ *   KoaSSEAdapter
+ * } from '@cicctencent/agent-server';
+ *
+ * // 只使用需要的组件
+ * const memoryService = new MemoryService('./data');
+ * const tools = createBuiltinTools();
+ *
+ * // 在 MidwayJS 中使用 SSE
+ * @Get('/stream')
+ * async stream(@Ctx() ctx: Context) {
+ *   const adapter = new KoaSSEAdapter(ctx);
+ *   writeSSE(adapter, 'start', { message: 'Hello' });
+ * }
+ * ```
+ */ 
+//# sourceMappingURL=typeorm-example.js.map

package/dist/esm/spi/examples/typeorm-example.js.map

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

package/dist/esm/spi/index.d.ts

@@ -0,0 +1,110 @@
+export type { BaseThreadEntity, BaseMessageEntity, BaseWorkspaceEntity, BaseAgentProfileEntity, BaseSettingsEntity, KVStorageAdapter, ListStorageAdapter, QueryOptions, SettingsProvider, ChatStoreProvider, AgentProfileProvider, PromptBuilderProvider, ModelConfigResolver, SSEResponseAdapter, RequestContextAdapter, AgentServerSPIOptions, ThreadEntity, MessageEntity, WorkspaceEntity, AgentProfileEntity, SettingsEntity, } from './types.js';
+export { JsonFileKVStorage, JsonFileListStorage, InMemoryKVStorage, InMemoryListStorage, DatabaseListStorage, createJsonFileStorage, createInMemoryStorage, } from './storage.js';
+export { ExpressSSEAdapter, KoaSSEAdapter, FastifySSEAdapter, NativeHttpSSEAdapter, adaptSSE, ExpressRequestAdapter, KoaRequestAdapter, adaptRequest, CustomSSEAdapter, } from './adapters.js';
+/**
+ * ## SPI 使用示例
+ *
+ * ### 1. 使用默认 JSON 文件存储
+ *
+ * ```typescript
+ * import { createAgentServer } from '@cicctencent/agent-server';
+ *
+ * const server = createAgentServer({
+ *   llmProvider: myProvider,
+ *   dataDir: './data', // 使用默认 JSON 文件存储
+ * });
+ * ```
+ *
+ * ### 2. 自定义存储（数据库）
+ *
+ * ```typescript
+ * import { createAgentServer, DatabaseListStorage, type ChatStoreProvider } from '@cicctencent/agent-server';
+ *
+ * // 实现数据库存储
+ * class TypeORMThreadStorage extends DatabaseListStorage<ThreadEntity> {
+ *   constructor(private repository: Repository<ThreadEntity>) {
+ *     super();
+ *   }
+ *   async list() { return this.repository.find(); }
+ *   async findById(id) { return this.repository.findOne({ where: { id } }); }
+ *   async add(entity) { return this.repository.save(entity); }
+ *   // ...
+ * }
+ *
+ * // 实现 ChatStoreProvider
+ * class TypeORMChatStoreProvider implements ChatStoreProvider {
+ *   constructor(private threadRepo: Repository<ThreadEntity>, private msgRepo: Repository<MessageEntity>) {}
+ *   getThreads() { return this.threadRepo.find(); }
+ *   // ...
+ * }
+ *
+ * const server = createAgentServer({
+ *   llmProvider: myProvider,
+ *   chatStoreProvider: new TypeORMChatStoreProvider(threadRepo, msgRepo),
+ * });
+ * ```
+ *
+ * ### 3. 自定义框架适配（MidwayJS）
+ *
+ * ```typescript
+ * import { createAgentServer, KoaSSEAdapter } from '@cicctencent/agent-server';
+ *
+ * @Provide()
+ * @Scope(ScopeEnum.Singleton)
+ * export class AgentService {
+ *   private server: AgentServer;
+ *
+ *   @Init()
+ *   async init() {
+ *     this.server = createAgentServer({
+ *       llmProvider: await this.createProvider(),
+ *       // 使用 Koa 适配器
+ *       createSSEResponseAdapter: (ctx) => new KoaSSEAdapter(ctx),
+ *     });
+ *   }
+ *
+ *   @Get('/chat/stream')
+ *   async chatStream(@Ctx() ctx: Context) {
+ *     const adapter = new KoaSSEAdapter(ctx);
+ *     await this.server.runAgentStream(adapter, { content: ctx.query.message });
+ *   }
+ * }
+ * ```
+ *
+ * ### 4. 自定义 Prompt 构建
+ *
+ * ```typescript
+ * import { createAgentServer, type PromptBuilderProvider } from '@cicctencent/agent-server';
+ *
+ * class CustomPromptBuilder implements PromptBuilderProvider {
+ *   buildDefaultPrompt(profile, tools, memory) {
+ *     // 自定义 Prompt 构建逻辑
+ *     return `你是一个专业的 BI 分析助手...\n${memory || ''}`;
+ *   }
+ *   // ...
+ * }
+ *
+ * const server = createAgentServer({
+ *   llmProvider: myProvider,
+ *   promptBuilder: new CustomPromptBuilder(),
+ * });
+ * ```
+ *
+ * ### 5. 组件级使用（不使用工厂）
+ *
+ * ```typescript
+ * import { MemoryService, writeSSE, createBuiltinTools, KoaSSEAdapter } from '@cicctencent/agent-server';
+ *
+ * // 只使用需要的组件，不依赖 createAgentServer
+ * const memoryService = new MemoryService('./data');
+ * const tools = createBuiltinTools();
+ *
+ * // 在 MidwayJS 中使用 SSE
+ * @Get('/stream')
+ * async stream(@Ctx() ctx: Context) {
+ *   const adapter = new KoaSSEAdapter(ctx);
+ *   writeSSE(adapter, 'start', { message: 'Hello' });
+ * }
+ * ```
+ */ 
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/spi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/spi/index.ts"],"names":[],"mappings":"AAKA,YAAY,EAEV,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAElB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EAEZ,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EAEnB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EAErB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EAEL,iBAAiB,EACjB,mBAAmB,EAEnB,iBAAiB,EACjB,mBAAmB,EAEnB,mBAAmB,EAEnB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAEL,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,QAAQ,EAER,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EAEZ,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAMvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyGG"}

package/dist/esm/spi/index.js

@@ -0,0 +1,131 @@
+// ============================================================
+// SPI 模块导出
+// ============================================================
+// ---- 存储适配器 ----
+export { 
+// JSON 文件存储
+JsonFileKVStorage, JsonFileListStorage, 
+// 内存存储
+InMemoryKVStorage, InMemoryListStorage, 
+// 数据库存储基类
+DatabaseListStorage, 
+// 工厂函数
+createJsonFileStorage, createInMemoryStorage, } from "./storage.js";
+// ---- 框架适配器 ----
+export { 
+// SSE 适配器
+ExpressSSEAdapter, KoaSSEAdapter, FastifySSEAdapter, NativeHttpSSEAdapter, adaptSSE, 
+// 请求适配器
+ExpressRequestAdapter, KoaRequestAdapter, adaptRequest, 
+// 自定义适配器示例
+CustomSSEAdapter, } from "./adapters.js";
+// ============================================================
+// SPI 使用指南
+// ============================================================
+/**
+ * ## SPI 使用示例
+ *
+ * ### 1. 使用默认 JSON 文件存储
+ *
+ * ```typescript
+ * import { createAgentServer } from '@cicctencent/agent-server';
+ *
+ * const server = createAgentServer({
+ *   llmProvider: myProvider,
+ *   dataDir: './data', // 使用默认 JSON 文件存储
+ * });
+ * ```
+ *
+ * ### 2. 自定义存储（数据库）
+ *
+ * ```typescript
+ * import { createAgentServer, DatabaseListStorage, type ChatStoreProvider } from '@cicctencent/agent-server';
+ *
+ * // 实现数据库存储
+ * class TypeORMThreadStorage extends DatabaseListStorage<ThreadEntity> {
+ *   constructor(private repository: Repository<ThreadEntity>) {
+ *     super();
+ *   }
+ *   async list() { return this.repository.find(); }
+ *   async findById(id) { return this.repository.findOne({ where: { id } }); }
+ *   async add(entity) { return this.repository.save(entity); }
+ *   // ...
+ * }
+ *
+ * // 实现 ChatStoreProvider
+ * class TypeORMChatStoreProvider implements ChatStoreProvider {
+ *   constructor(private threadRepo: Repository<ThreadEntity>, private msgRepo: Repository<MessageEntity>) {}
+ *   getThreads() { return this.threadRepo.find(); }
+ *   // ...
+ * }
+ *
+ * const server = createAgentServer({
+ *   llmProvider: myProvider,
+ *   chatStoreProvider: new TypeORMChatStoreProvider(threadRepo, msgRepo),
+ * });
+ * ```
+ *
+ * ### 3. 自定义框架适配（MidwayJS）
+ *
+ * ```typescript
+ * import { createAgentServer, KoaSSEAdapter } from '@cicctencent/agent-server';
+ *
+ * @Provide()
+ * @Scope(ScopeEnum.Singleton)
+ * export class AgentService {
+ *   private server: AgentServer;
+ *
+ *   @Init()
+ *   async init() {
+ *     this.server = createAgentServer({
+ *       llmProvider: await this.createProvider(),
+ *       // 使用 Koa 适配器
+ *       createSSEResponseAdapter: (ctx) => new KoaSSEAdapter(ctx),
+ *     });
+ *   }
+ *
+ *   @Get('/chat/stream')
+ *   async chatStream(@Ctx() ctx: Context) {
+ *     const adapter = new KoaSSEAdapter(ctx);
+ *     await this.server.runAgentStream(adapter, { content: ctx.query.message });
+ *   }
+ * }
+ * ```
+ *
+ * ### 4. 自定义 Prompt 构建
+ *
+ * ```typescript
+ * import { createAgentServer, type PromptBuilderProvider } from '@cicctencent/agent-server';
+ *
+ * class CustomPromptBuilder implements PromptBuilderProvider {
+ *   buildDefaultPrompt(profile, tools, memory) {
+ *     // 自定义 Prompt 构建逻辑
+ *     return `你是一个专业的 BI 分析助手...\n${memory || ''}`;
+ *   }
+ *   // ...
+ * }
+ *
+ * const server = createAgentServer({
+ *   llmProvider: myProvider,
+ *   promptBuilder: new CustomPromptBuilder(),
+ * });
+ * ```
+ *
+ * ### 5. 组件级使用（不使用工厂）
+ *
+ * ```typescript
+ * import { MemoryService, writeSSE, createBuiltinTools, KoaSSEAdapter } from '@cicctencent/agent-server';
+ *
+ * // 只使用需要的组件，不依赖 createAgentServer
+ * const memoryService = new MemoryService('./data');
+ * const tools = createBuiltinTools();
+ *
+ * // 在 MidwayJS 中使用 SSE
+ * @Get('/stream')
+ * async stream(@Ctx() ctx: Context) {
+ *   const adapter = new KoaSSEAdapter(ctx);
+ *   writeSSE(adapter, 'start', { message: 'Hello' });
+ * }
+ * ```
+ */ 
+//# sourceMappingURL=index.js.map

package/dist/esm/spi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/spi/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,WAAW;AACX,+DAA+D;AAgC/D,kBAAkB;AAClB,OAAO;AACL,YAAY;AACZ,iBAAiB,EACjB,mBAAmB;AACnB,OAAO;AACP,iBAAiB,EACjB,mBAAmB;AACnB,UAAU;AACV,mBAAmB;AACnB,OAAO;AACP,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,kBAAkB;AAClB,OAAO;AACL,UAAU;AACV,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,QAAQ;AACR,QAAQ;AACR,qBAAqB,EACrB,iBAAiB,EACjB,YAAY;AACZ,WAAW;AACX,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,+DAA+D;AAC/D,WAAW;AACX,+DAA+D;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyGG"}

package/dist/esm/spi/storage.d.ts

@@ -0,0 +1,109 @@
+import type { KVStorageAdapter, ListStorageAdapter, QueryOptions } from './types.js';
+/**
+ * JSON 文件键值存储
+ * 适用于小型应用、本地开发
+ */
+export declare class JsonFileKVStorage implements KVStorageAdapter {
+    private filePath;
+    private cache;
+    constructor(filePath: string);
+    private load;
+    private save;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    keys(prefix?: string): Promise<string[]>;
+    /** 清除缓存（用于重新加载） */
+    clearCache(): void;
+}
+/**
+ * JSON 文件列表存储
+ * 支持实体 CRUD 操作
+ */
+export declare class JsonFileListStorage<T extends {
+    id: number | string;
+}> implements ListStorageAdapter<T> {
+    private filePath;
+    private data;
+    constructor(filePath: string);
+    private load;
+    private save;
+    list(): Promise<T[]>;
+    findById(id: number | string): Promise<T | null>;
+    add(entity: T): Promise<T>;
+    update(id: number | string, data: Partial<T>): Promise<T | null>;
+    remove(id: number | string): Promise<boolean>;
+    batch(operations: Array<{
+        type: 'add' | 'update' | 'delete';
+        data: T | Partial<T>;
+        id?: number | string;
+    }>): Promise<void>;
+    /** 获取最大 ID */
+    maxId(): number;
+    /** 清除缓存 */
+    clearCache(): void;
+    /** 获取文件路径 */
+    getPath(): string;
+}
+/**
+ * 内存键值存储
+ * 适用于测试、临时数据
+ */
+export declare class InMemoryKVStorage implements KVStorageAdapter {
+    private data;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    keys(prefix?: string): Promise<string[]>;
+    /** 清空所有数据 */
+    clear(): void;
+}
+/**
+ * 内存列表存储
+ */
+export declare class InMemoryListStorage<T extends {
+    id: number | string;
+}> implements ListStorageAdapter<T> {
+    private data;
+    list(): Promise<T[]>;
+    findById(id: number | string): Promise<T | null>;
+    add(entity: T): Promise<T>;
+    update(id: number | string, data: Partial<T>): Promise<T | null>;
+    remove(id: number | string): Promise<boolean>;
+    /** 清空所有数据 */
+    clear(): void;
+}
+/**
+ * 数据库存储基类
+ * 应用层继承并实现具体的数据库操作（TypeORM / Prisma / Sequelize 等）
+ */
+export declare abstract class DatabaseListStorage<T extends {
+    id: number | string;
+}> implements ListStorageAdapter<T> {
+    abstract list(): Promise<T[]>;
+    abstract findById(id: number | string): Promise<T | null>;
+    abstract add(entity: T): Promise<T>;
+    abstract update(id: number | string, data: Partial<T>): Promise<T | null>;
+    abstract remove(id: number | string): Promise<boolean>;
+    /** 扩展：带查询条件的列表 */
+    query(options: QueryOptions): Promise<{
+        items: T[];
+        total: number;
+        hasMore: boolean;
+    }>;
+}
+/**
+ * 创建 JSON 文件存储
+ */
+export declare function createJsonFileStorage(filePath: string, type: 'kv' | 'list'): KVStorageAdapter | ListStorageAdapter<{
+    id: number | string;
+}>;
+/**
+ * 创建内存存储
+ */
+export declare function createInMemoryStorage(type: 'kv' | 'list'): KVStorageAdapter | ListStorageAdapter<{
+    id: number | string;
+}>;
+//# sourceMappingURL=storage.d.ts.map