@cicctencent/agent-server 0.1.1 → 0.1.2

package/dist/cjs/spi/examples/typeorm-example.d.ts

@@ -0,0 +1,208 @@
+import type { ChatStoreProvider, BaseThreadEntity, BaseMessageEntity, BaseSettingsEntity, ListStorageAdapter } from '../types.js';
+/**
+ * BI 项目的 Thread 实体（TypeORM）
+ * 注意：字段可能与 agent-server 默认实体不同
+ */
+interface BIThreadEntity extends BaseThreadEntity {
+    id: number;
+    workspaceId?: number;
+    userId?: number;
+    agentType?: string;
+    modelConfig?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * BI 项目的 Message 实体（TypeORM）
+ */
+interface BIMessageEntity extends BaseMessageEntity {
+    id: number;
+    threadId: number;
+    tokens?: number;
+    latency?: number;
+    model?: string;
+    createdAt: Date;
+}
+/**
+ * BI 项目的 Settings 实体
+ */
+interface BISettingsEntity extends BaseSettingsEntity {
+    id: number;
+    userId: number;
+    theme: string;
+    language: string;
+    modelProviders: Array<{
+        id: string;
+        name: string;
+        provider: string;
+        model: string;
+        apiKey?: string;
+        baseUrl?: string;
+    }>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * TypeORM 列表存储适配器
+ * 将 TypeORM Repository 包装为 ListStorageAdapter
+ */
+declare class TypeORMListStorage<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>;
+}
+/**
+ * BI 项目的 ChatStoreProvider 实现
+ * 使用 TypeORM Repository 作为底层存储
+ */
+declare class TypeORMChatStoreProvider implements ChatStoreProvider<BIThreadEntity, BIMessageEntity> {
+    private threadStorage;
+    private messageStorages;
+    constructor();
+    private getMessageStorage;
+    getThreads(workspaceId?: number | string): Promise<BIThreadEntity[]>;
+    getThread(id: number | string): Promise<BIThreadEntity | undefined>;
+    createThread(data: Partial<BIThreadEntity>): Promise<BIThreadEntity>;
+    updateThread(id: number | string, data: Partial<BIThreadEntity>): Promise<BIThreadEntity | undefined>;
+    deleteThread(id: number | string): Promise<boolean>;
+    getMessages(threadId: number | string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        items: BIMessageEntity[];
+        total: number;
+        hasMore: boolean;
+    }>;
+    addMessage(data: Partial<BIMessageEntity> & {
+        threadId: number | string;
+        role: string;
+        content: string;
+    }): Promise<BIMessageEntity>;
+    updateMessage(threadId: number | string, id: number | string, data: Partial<BIMessageEntity>): Promise<BIMessageEntity | undefined>;
+    deleteMessage(threadId: number | string, id: number | string): Promise<boolean>;
+    clearThreadMessages(threadId: number | string): Promise<void>;
+    buildThreadHistory(threadId: number | string, limit?: number): Promise<any[]>;
+}
+/**
+ * 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, BIThreadEntity, BIMessageEntity, BISettingsEntity, };
+/**
+ * ## 使用说明
+ *
+ * ### 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.d.ts.map

package/dist/cjs/spi/examples/typeorm-example.d.ts.map

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

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,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/cjs/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"}