@cicctencent/agent-server 0.1.1 → 0.2.0

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

@@ -0,0 +1,274 @@
+"use strict";
+// ============================================================
+// TypeORM SPI 实现示例 — BI 项目可参考此实现
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeORMChatStoreProvider = exports.TypeORMListStorage = void 0;
+// ============================================================
+// 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;
+    }
+}
+exports.TypeORMListStorage = TypeORMListStorage;
+// ============================================================
+// 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,
+        }));
+    }
+}
+exports.TypeORMChatStoreProvider = 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/cjs/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/cjs/spi/index.d.ts

@@ -0,0 +1,194 @@
+/**
+ * # agent-server SPI (Service Provider Interface)
+ *
+ * ## 核心设计原则
+ *
+ * 1. **接口优先**：agent-server 核心只定义能力接口，不依赖具体实现
+ * 2. **参考实现可选**：提供常见框架的参考实现，业务层可选择使用或自己实现
+ * 3. **业务层自主**：完全控制实现细节，不受 agent-server 限制
+ *
+ * ## 使用方式
+ *
+ * ### 方式 1：直接使用参考实现（最简单）
+ *
+ * ```typescript
+ * import { KoaSSEAdapter, createAgentServer } from '@cicctencent/agent-server';
+ *
+ * const server = createAgentServer({ llmProvider: myProvider });
+ *
+ * // MidwayJS/Koa 项目
+ * @Get('/chat/stream')
+ * async chatStream(@Ctx() ctx: Context) {
+ *   const adapter = new KoaSSEAdapter(ctx);
+ *   await server.runAgentStream(adapter, { content: 'Hello' });
+ * }
+ * ```
+ *
+ * ### 方式 2：实现 SPI 接口（自定义存储）
+ *
+ * ```typescript
+ * import {
+ *   createAgentServer,
+ *   type ChatStoreProvider,
+ *   type BaseThreadEntity,
+ *   type BaseMessageEntity,
+ * } from '@cicctencent/agent-server';
+ *
+ * // 定义你的实体类型（可以自定义字段）
+ * interface MyThread extends BaseThreadEntity {
+ *   userId: string;
+ *   applicationId: number;
+ * }
+ *
+ * // 实现 ChatStoreProvider 接口
+ * class MyChatStore implements ChatStoreProvider<MyThread, MyMessage> {
+ *   async getThreads(userId?: string): Promise<MyThread[]> {
+ *     // 使用任意存储技术：TypeORM / Prisma / Mongoose / ...
+ *     return this.database.query('SELECT * FROM threads WHERE userId = ?', [userId]);
+ *   }
+ *
+ *   // ... 实现其他方法
+ * }
+ *
+ * // 注入自定义实现
+ * const server = createAgentServer({
+ *   llmProvider: myProvider,
+ *   chatStoreProvider: new MyChatStore(),
+ * });
+ * ```
+ *
+ * ### 方式 3：只使用组件（不使用工厂）
+ *
+ * ```typescript
+ * import {
+ *   KoaSSEAdapter,
+ *   writeSSE,
+ *   createBuiltinTools,
+ *   MemoryService,
+ * } from '@cicctencent/agent-server';
+ *
+ * // 只使用需要的组件，不依赖 createAgentServer
+ * const tools = createBuiltinTools();
+ * const memoryService = new MemoryService('./data');
+ *
+ * @Get('/stream')
+ * async stream(@Ctx() ctx: Context) {
+ *   const adapter = new KoaSSEAdapter(ctx);
+ *   writeSSE(adapter, 'start', { message: 'Hello' });
+ * }
+ * ```
+ *
+ * ## 完整文档
+ *
+ * 详见 [README.md](./README.md)
+ */
+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/cjs/spi/index.d.ts.map

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