mcp-paike 1.0.0

package/dist/tools/finance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finance.d.ts","sourceRoot":"","sources":["../../src/tools/finance.ts"],"names":[],"mappings":"AAaA,UAAU,UAAU;IAClB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAiDD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;oBAqBR;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,KAAG,OAAO,CAAC,UAAU,CAAC;CA8IxB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;oBAahB;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,UAAU,CAAC;CAmDlE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;mBAUd,OAAO,CAAC,UAAU,CAAC;CAwEvC,CAAC;AAYF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;oBA1UD;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,KAAG,OAAO,CAAC,UAAU,CAAC;;;;;;;;;;;;;;oBAwKD;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,UAAU,CAAC;;;;;;;;;;mBA0E9C,OAAO,CAAC,UAAU,CAAC;IAwFvC,CAAC"}

package/dist/tools/finance.js

@@ -0,0 +1,319 @@
+import { apiClient } from '../api/client.js';
+import { tokenManager } from '../auth/tokenManager.js';
+import { logger } from '../utils/logger.js';
+/** Maximum records per API page (matches backend limit) */
+const PAGE_SIZE = 10000;
+/** Maximum pages to fetch as safety limit */
+const MAX_PAGES = 20;
+/**
+ * Query teacher sales and session fees by date range
+ *
+ * Access Control:
+ * - STAFF: Can only query their own data
+ * - ADMIN/SUPER_ADMIN: Can query any teacher's data
+ *
+ * @returns Formatted report with:
+ * - Total sessions count
+ * - Total sales amount (课销)
+ * - Total session fees (课次费)
+ * - Session-by-session breakdown
+ */
+export const getTeacherSalesTool = {
+    name: 'get_teacher_sales',
+    description: '查询教师课销与课次费 - 按日期范围查询课销金额、课次费（员工只能查自己）',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            startDate: {
+                type: 'string',
+                description: '开始日期 (YYYY-MM-DD)，必填',
+            },
+            endDate: {
+                type: 'string',
+                description: '结束日期 (YYYY-MM-DD)，必填',
+            },
+            teacherId: {
+                type: 'string',
+                description: '教师ID（可选，管理员可查询所有教师，员工只能查自己）',
+            },
+        },
+        required: ['startDate', 'endDate'],
+    },
+    handler: async (args) => {
+        try {
+            logger.debug('查询教师课销', args);
+            // Get current user for STAFF role restriction
+            const user = tokenManager.getUser();
+            const isAdmin = user?.role === 'ADMIN' || user?.role === 'SUPER_ADMIN';
+            // Build query params - use pagination to fetch all data
+            const params = {
+                startDate: args.startDate,
+                endDate: args.endDate,
+                pageSize: PAGE_SIZE,
+                page: 1,
+            };
+            // STAFF can only query their own data
+            if (!isAdmin) {
+                if (args.teacherId && args.teacherId !== user?.id) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: '权限不足：员工只能查询自己的课销数据。',
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                if (user?.id) {
+                    params.teacherIds = user.id;
+                }
+            }
+            else if (args.teacherId) {
+                params.teacherIds = args.teacherId;
+            }
+            // Fetch all pages of data
+            const allSessions = [];
+            let currentPage = 1;
+            let totalPages = 1;
+            do {
+                params.page = currentPage;
+                const result = await apiClient.get('/api/teachers/attendance-export', params);
+                if (result.data && result.data.length > 0) {
+                    allSessions.push(...result.data);
+                }
+                totalPages = result.pagination?.totalPages || 1;
+                currentPage++;
+            } while (currentPage <= totalPages && currentPage <= MAX_PAGES);
+            if (allSessions.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `查询期间 ${args.startDate} 至 ${args.endDate} 无课程数据。`,
+                        },
+                    ],
+                };
+            }
+            // Aggregate by teacher
+            const teacherStats = new Map();
+            allSessions.forEach((session) => {
+                const teacherName = session.teacherName || '未分配';
+                if (!teacherStats.has(teacherName)) {
+                    teacherStats.set(teacherName, {
+                        name: teacherName,
+                        department: session.teacherDepartment || '-',
+                        sessionCount: 0,
+                        totalSales: 0,
+                        totalSessionFee: 0,
+                        presentCount: 0,
+                    });
+                }
+                const stats = teacherStats.get(teacherName);
+                stats.sessionCount += 1;
+                stats.presentCount += session.presentCount || 0;
+                // Parse currency strings like "¥12,345.67" (use global replace for commas)
+                const salesAmount = parseFloat((session.totalSales || '¥0').replace('¥', '').replace(/,/g, '')) || 0;
+                const feeAmount = parseFloat((session.totalSessionFee || '¥0').replace('¥', '').replace(/,/g, '')) || 0;
+                stats.totalSales += salesAmount;
+                stats.totalSessionFee += feeAmount;
+            });
+            // Format output
+            let output = `教师课销报表\n`;
+            output += `查询期间: ${args.startDate} 至 ${args.endDate}\n`;
+            output += `共 ${allSessions.length} 节课\n`;
+            output += `${'='.repeat(50)}\n\n`;
+            for (const [name, stats] of teacherStats.entries()) {
+                output += `【${name}】${stats.department !== '-' ? ` (${stats.department})` : ''}\n`;
+                output += `  课程节数: ${stats.sessionCount} 节\n`;
+                output += `  实到学生: ${stats.presentCount} 人次\n`;
+                output += `  课销总额: ¥${stats.totalSales.toFixed(2)}\n`;
+                output += `  课次费: ¥${stats.totalSessionFee.toFixed(2)}\n\n`;
+            }
+            // Calculate grand totals
+            const grandTotals = Array.from(teacherStats.values()).reduce((acc, stats) => ({
+                sessionCount: acc.sessionCount + stats.sessionCount,
+                totalSales: acc.totalSales + stats.totalSales,
+                totalSessionFee: acc.totalSessionFee + stats.totalSessionFee,
+            }), { sessionCount: 0, totalSales: 0, totalSessionFee: 0 });
+            output += `${'='.repeat(50)}\n`;
+            output += `总计: ${grandTotals.sessionCount} 节课 | 课销 ¥${grandTotals.totalSales.toFixed(2)} | 课次费 ¥${grandTotals.totalSessionFee.toFixed(2)}`;
+            return {
+                content: [{ type: 'text', text: output }],
+            };
+        }
+        catch (error) {
+            logger.error('查询教师课销失败:', error.message);
+            return {
+                content: [{ type: 'text', text: `查询失败: ${error.message}` }],
+                isError: true,
+            };
+        }
+    },
+};
+/**
+ * Query student session balance details
+ *
+ * Access Control:
+ * - All authenticated users can query
+ *
+ * @returns Student info with:
+ * - Name, status, type
+ * - Balance per course category
+ * - Used vs total sessions breakdown
+ */
+export const getStudentBalanceDetailTool = {
+    name: 'get_student_balance_detail',
+    description: '查询学员课次余额详情 - 获取学员各类型课程的余额',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            studentId: {
+                type: 'string',
+                description: '学员ID，必填',
+            },
+        },
+        required: ['studentId'],
+    },
+    handler: async (args) => {
+        try {
+            logger.debug('查询学员余额详情', args);
+            // Get student info first
+            const student = await apiClient.get(`/api/students/${args.studentId}`);
+            // Get category balances
+            const balances = await apiClient.get(`/api/students/${args.studentId}/category-balances`);
+            if (!balances || balances.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `学员「${student.name}」暂无任何课次余额记录。`,
+                        },
+                    ],
+                };
+            }
+            let output = `学员课次余额\n`;
+            output += `${'='.repeat(40)}\n\n`;
+            output += `姓名: ${student.name}\n`;
+            output += `状态: ${formatStudentStatus(student.status)}\n`;
+            output += `类型: ${student.studentType === 'FORMAL' ? '正式学员' : '意向学员'}\n\n`;
+            output += `各类型余额:\n`;
+            let totalRemaining = 0;
+            balances.forEach((balance) => {
+                output += `  - ${balance.categoryName}: ${balance.remainingSessions} 课次`;
+                output += ` (已用 ${balance.usedSessions || 0}/${balance.totalSessions || balance.remainingSessions})\n`;
+                totalRemaining += balance.remainingSessions;
+            });
+            output += `\n${'='.repeat(40)}\n`;
+            output += `总剩余: ${totalRemaining} 课次`;
+            return {
+                content: [{ type: 'text', text: output }],
+            };
+        }
+        catch (error) {
+            logger.error('查询学员余额详情失败:', error.message);
+            return {
+                content: [{ type: 'text', text: `查询失败: ${error.message}` }],
+                isError: true,
+            };
+        }
+    },
+};
+/**
+ * Query session fee rules for all course categories
+ *
+ * Access Control:
+ * - ADMIN/SUPER_ADMIN only (requiredRole: 'ADMIN')
+ *
+ * @returns List of fee rules organized by category:
+ * - Category name
+ * - Student count ranges (min-max)
+ * - Session rate per student count tier
+ */
+export const getSessionFeeRulesTool = {
+    name: 'get_session_fee_rules',
+    description: '查询课次费规则 - 查看不同人数对应的课次费率（仅管理员可用）',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: [],
+    },
+    // CRITICAL: Admin-only tool
+    requiredRole: 'ADMIN',
+    handler: async () => {
+        try {
+            logger.debug('查询课次费规则');
+            const rules = await apiClient.get('/api/teacher-session-rates');
+            if (!rules || rules.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: '暂无课次费规则配置。\n请在管理后台添加课次费规则。',
+                        },
+                    ],
+                };
+            }
+            // Group by category
+            const categoryRules = new Map();
+            rules.forEach((rule) => {
+                const categoryName = rule.category?.name || '未分类';
+                if (!categoryRules.has(categoryName)) {
+                    categoryRules.set(categoryName, []);
+                }
+                categoryRules.get(categoryName).push(rule);
+            });
+            let output = `课次费规则配置\n`;
+            output += `${'='.repeat(50)}\n\n`;
+            for (const [category, categoryRuleList] of categoryRules.entries()) {
+                output += `【${category}】\n`;
+                // Sort by minStudents
+                categoryRuleList.sort((a, b) => a.minStudents - b.minStudents);
+                categoryRuleList.forEach((rule) => {
+                    const rate = typeof rule.sessionRate === 'object' ? Number(rule.sessionRate) : rule.sessionRate;
+                    output += `  ${rule.minStudents}-${rule.maxStudents}人: ¥${Number(rate).toFixed(2)}/节\n`;
+                });
+                output += '\n';
+            }
+            output += `${'='.repeat(50)}\n`;
+            output += `共 ${rules.length} 条规则`;
+            return {
+                content: [{ type: 'text', text: output }],
+            };
+        }
+        catch (error) {
+            logger.error('查询课次费规则失败:', error.message);
+            // Handle 403 specifically
+            if (error.message.includes('403') || error.message.includes('权限')) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: '权限不足：此操作需要管理员权限。',
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            return {
+                content: [{ type: 'text', text: `查询失败: ${error.message}` }],
+                isError: true,
+            };
+        }
+    },
+};
+// Helper functions
+function formatStudentStatus(status) {
+    const statusMap = {
+        ACTIVE: '学习中',
+        PAUSED: '暂停',
+        GRADUATED: '毕业',
+    };
+    return statusMap[status] || status;
+}
+export const financeTools = [
+    getTeacherSalesTool,
+    getStudentBalanceDetailTool,
+    getSessionFeeRulesTool,
+];
+//# sourceMappingURL=finance.js.map

package/dist/tools/finance.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,29 @@
+interface ToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+interface Tool {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, any>;
+        required: string[];
+    };
+    handler: (args: any) => Promise<ToolResult>;
+    requiredRole?: 'ADMIN';
+}
+declare class ToolRegistry {
+    private tools;
+    constructor();
+    getTool(name: string): Tool | undefined;
+    getAllTools(): Tool[];
+    getToolsForRole(userRole: string | null): Tool[];
+    getToolNames(): string[];
+}
+export declare const toolRegistry: ToolRegistry;
+export type { Tool, ToolResult };
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAOA,UAAU,UAAU;IAClB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,IAAI;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAYD,cAAM,YAAY;IAChB,OAAO,CAAC,KAAK,CAAgC;;IAQ7C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIvC,WAAW,IAAI,IAAI,EAAE;IAIrB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,EAAE;IAchD,YAAY,IAAI,MAAM,EAAE;CAGzB;AAED,eAAO,MAAM,YAAY,cAAqB,CAAC;AAC/C,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,46 @@
+import { authTools } from './auth.js';
+import { studentTools } from './students.js';
+import { classTools } from './classes.js';
+import { sessionTools } from './sessions.js';
+import { attendanceTools } from './attendances.js';
+import { financeTools } from './finance.js';
+// Combine all tools
+const allTools = [
+    ...authTools,
+    ...studentTools,
+    ...classTools,
+    ...sessionTools,
+    ...attendanceTools,
+    ...financeTools,
+];
+class ToolRegistry {
+    tools = new Map();
+    constructor() {
+        for (const tool of allTools) {
+            this.tools.set(tool.name, tool);
+        }
+    }
+    getTool(name) {
+        return this.tools.get(name);
+    }
+    getAllTools() {
+        return Array.from(this.tools.values());
+    }
+    getToolsForRole(userRole) {
+        return Array.from(this.tools.values()).filter((tool) => {
+            // No role requirement = available to all authenticated users
+            if (!tool.requiredRole)
+                return true;
+            // ADMIN requirement: Only ADMIN or SUPER_ADMIN
+            if (tool.requiredRole === 'ADMIN') {
+                return userRole === 'ADMIN' || userRole === 'SUPER_ADMIN';
+            }
+            return false;
+        });
+    }
+    getToolNames() {
+        return Array.from(this.tools.keys());
+    }
+}
+export const toolRegistry = new ToolRegistry();
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAmB5C,oBAAoB;AACpB,MAAM,QAAQ,GAAW;IACvB,GAAG,SAAS;IACZ,GAAG,YAAY;IACf,GAAG,UAAU;IACb,GAAG,YAAY;IACf,GAAG,eAAe;IAClB,GAAG,YAAY;CAChB,CAAC;AAEF,MAAM,YAAY;IACR,KAAK,GAAsB,IAAI,GAAG,EAAE,CAAC;IAE7C;QACE,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,WAAW;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,eAAe,CAAC,QAAuB;QACrC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YACrD,6DAA6D;YAC7D,IAAI,CAAC,IAAI,CAAC,YAAY;gBAAE,OAAO,IAAI,CAAC;YAEpC,+CAA+C;YAC/C,IAAI,IAAI,CAAC,YAAY,KAAK,OAAO,EAAE,CAAC;gBAClC,OAAO,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,aAAa,CAAC;YAC5D,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IAED,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC"}

package/dist/tools/sessions.d.ts

@@ -0,0 +1,126 @@
+interface ToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare const listSessionsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            startDate: {
+                type: string;
+                description: string;
+            };
+            endDate: {
+                type: string;
+                description: string;
+            };
+            teacherId: {
+                type: string;
+                description: string;
+            };
+            classId: {
+                type: string;
+                description: string;
+            };
+            page: {
+                type: string;
+                description: string;
+            };
+            pageSize: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+    handler: (args: {
+        startDate?: string;
+        endDate?: string;
+        teacherId?: string;
+        classId?: string;
+        page?: number;
+        pageSize?: number;
+    }) => Promise<ToolResult>;
+};
+export declare const getSessionTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            sessionId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (args: {
+        sessionId: string;
+    }) => Promise<ToolResult>;
+};
+export declare const sessionTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            startDate: {
+                type: string;
+                description: string;
+            };
+            endDate: {
+                type: string;
+                description: string;
+            };
+            teacherId: {
+                type: string;
+                description: string;
+            };
+            classId: {
+                type: string;
+                description: string;
+            };
+            page: {
+                type: string;
+                description: string;
+            };
+            pageSize: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+    handler: (args: {
+        startDate?: string;
+        endDate?: string;
+        teacherId?: string;
+        classId?: string;
+        page?: number;
+        pageSize?: number;
+    }) => Promise<ToolResult>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            sessionId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (args: {
+        sessionId: string;
+    }) => Promise<ToolResult>;
+})[];
+export {};
+//# sourceMappingURL=sessions.d.ts.map

package/dist/tools/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/tools/sessions.ts"],"names":[],"mappings":"AAGA,UAAU,UAAU;IAClB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAGD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAiCL;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,KAAG,OAAO,CAAC,UAAU,CAAC;CA2DxB,CAAC;AAGF,eAAO,MAAM,cAAc;;;;;;;;;;;;;oBAaH;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,UAAU,CAAC;CAkClE,CAAC;AAmCF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAvJD;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,KAAG,OAAO,CAAC,UAAU,CAAC;;;;;;;;;;;;;;oBA2ED;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,KAAG,OAAO,CAAC,UAAU,CAAC;IAwElE,CAAC"}