mcp-server-rocketchat-threads 1.0.0

package/dist/tools/user-tools.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * User Tools
+ * Tools for looking up user information
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMeTool = exports.listUsersTool = exports.lookupUserTool = void 0;
+const zod_1 = require("zod");
+const client_js_1 = require("../api/client.js");
+const message_formatter_js_1 = require("../formatters/message-formatter.js");
+const response_builder_js_1 = require("../formatters/response-builder.js");
+const token_counter_js_1 = require("../utils/token-counter.js");
+const base_js_1 = require("./base.js");
+/**
+ * rocketchat_lookup_user
+ * Get user information by ID or username
+ */
+const lookupUserSchema = zod_1.z.object({
+    userId: zod_1.z.string().optional()
+        .describe('User ID (provide either userId or username)'),
+    username: zod_1.z.string().optional()
+        .describe('Username without @ (provide either userId or username)')
+});
+exports.lookupUserTool = (0, base_js_1.defineTool)('rocketchat_lookup_user', `Look up a Rocket.Chat user by ID or username.
+
+Returns user information:
+- User ID and username
+- Display name
+- Email (if visible)
+- Status (online/away/busy/offline)
+- Roles (admin, user, etc.)
+
+Use this to get details about message authors or participants.
+
+Examples:
+- By ID: { "userId": "x3JG6uXJgE7YNHR3S" }
+- By username: { "username": "john.doe" }`, lookupUserSchema, async (params) => {
+    if (!params.userId && !params.username) {
+        return (0, base_js_1.createErrorResult)(base_js_1.ErrorCodes.VALIDATION_ERROR, 'Missing user identifier', 'Either userId or username must be provided');
+    }
+    try {
+        const client = (0, client_js_1.getClient)();
+        const response = await client.getUserInfo(params.userId, params.username);
+        if (!response.success) {
+            const identifier = params.userId || params.username || '';
+            return (0, base_js_1.createErrorResult)(base_js_1.ErrorCodes.NOT_FOUND, 'User not found', `No user found with identifier "${identifier}"`);
+        }
+        const formatted = (0, message_formatter_js_1.formatUser)(response.user);
+        const result = (0, response_builder_js_1.buildSuccessResponse)(formatted);
+        return (0, base_js_1.createToolResult)(result);
+    }
+    catch (error) {
+        return (0, base_js_1.createErrorResultFromException)(base_js_1.ErrorCodes.API_ERROR, 'Failed to lookup user', error);
+    }
+});
+/**
+ * rocketchat_list_users
+ * List users with pagination
+ */
+const listUsersSchema = zod_1.z.object({
+    limit: zod_1.z.number().min(1).max(100).default(50).optional()
+        .describe('Maximum number of users to return (1-100, default: 50)'),
+    offset: zod_1.z.number().min(0).default(0).optional()
+        .describe('Number of users to skip for pagination')
+});
+exports.listUsersTool = (0, base_js_1.defineTool)('rocketchat_list_users', `List Rocket.Chat users with pagination.
+
+Returns user list with basic information for each user.
+Use rocketchat_lookup_user for detailed information about a specific user.
+
+Examples:
+- List users: {}
+- Paginate: { "limit": 20, "offset": 40 }`, listUsersSchema, async (params) => {
+    try {
+        const client = (0, client_js_1.getClient)();
+        const limit = params.limit || 50;
+        const offset = params.offset || 0;
+        const response = await client.listUsers(limit, offset);
+        if (!response.success) {
+            return (0, base_js_1.createErrorResult)(base_js_1.ErrorCodes.API_ERROR, 'Failed to list users');
+        }
+        const formatted = (0, message_formatter_js_1.formatUsers)(response.users);
+        const { items, truncated } = token_counter_js_1.TokenCounter.truncateToFit(formatted);
+        const result = (0, response_builder_js_1.buildPaginatedResponse)(items, response.total, offset, truncated);
+        return (0, base_js_1.createToolResult)(result);
+    }
+    catch (error) {
+        return (0, base_js_1.createErrorResultFromException)(base_js_1.ErrorCodes.API_ERROR, 'Failed to list users', error);
+    }
+});
+/**
+ * rocketchat_get_me
+ * Get current authenticated user information
+ */
+const getMeSchema = zod_1.z.object({});
+exports.getMeTool = (0, base_js_1.defineTool)('rocketchat_get_me', `Get information about the current authenticated user.
+
+Returns the user information for the account used to authenticate with the MCP server.
+Useful for understanding the current context and permissions.
+
+Example: {}`, getMeSchema, async () => {
+    try {
+        const client = (0, client_js_1.getClient)();
+        const response = await client.getMe();
+        if (!response.success) {
+            return (0, base_js_1.createErrorResult)(base_js_1.ErrorCodes.API_ERROR, 'Failed to get current user');
+        }
+        const formatted = (0, message_formatter_js_1.formatUser)(response.user);
+        const result = (0, response_builder_js_1.buildSuccessResponse)(formatted);
+        return (0, base_js_1.createToolResult)(result);
+    }
+    catch (error) {
+        return (0, base_js_1.createErrorResultFromException)(base_js_1.ErrorCodes.API_ERROR, 'Failed to get current user', error);
+    }
+});
+// Register tools
+base_js_1.toolRegistry.register(exports.lookupUserTool);
+base_js_1.toolRegistry.register(exports.listUsersTool);
+base_js_1.toolRegistry.register(exports.getMeTool);
+//# sourceMappingURL=user-tools.js.map

package/dist/tools/user-tools.js.map

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

package/dist/tools/write-tools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Write Tools
+ * Tools for sending messages (requires explicit enablement)
+ */
+export declare const sendMessageTool: import("./base.js").ToolDefinition<{
+    roomId: string;
+    text: string;
+    threadId?: string | undefined;
+}>;
+export declare const reactTool: import("./base.js").ToolDefinition<{
+    emoji: string;
+    messageId: string;
+}>;
+export declare const getWriteStatusTool: import("./base.js").ToolDefinition<{}>;
+//# sourceMappingURL=write-tools.d.ts.map

package/dist/tools/write-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-tools.d.ts","sourceRoot":"","sources":["../../src/tools/write-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8BH,eAAO,MAAM,eAAe;;;;EAwE3B,CAAC;AAaF,eAAO,MAAM,SAAS;;;EAyDrB,CAAC;AAQF,eAAO,MAAM,kBAAkB,wCAoC9B,CAAC"}

package/dist/tools/write-tools.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * Write Tools
+ * Tools for sending messages (requires explicit enablement)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWriteStatusTool = exports.reactTool = exports.sendMessageTool = void 0;
+const zod_1 = require("zod");
+const client_js_1 = require("../api/client.js");
+const message_formatter_js_1 = require("../formatters/message-formatter.js");
+const response_builder_js_1 = require("../formatters/response-builder.js");
+const write_guard_js_1 = require("../guards/write-guard.js");
+const sanitizer_js_1 = require("../guards/sanitizer.js");
+const base_js_1 = require("./base.js");
+/**
+ * rocketchat_send_message
+ * Send a message to a channel
+ */
+const sendMessageSchema = zod_1.z.object({
+    roomId: zod_1.z.string()
+        .describe('Channel/room ID to send message to'),
+    text: zod_1.z.string().min(1).max(10000)
+        .describe('Message text to send (max 10000 characters)'),
+    threadId: zod_1.z.string().optional()
+        .describe('Thread ID (tmid) to reply to. If provided, message will be a thread reply.')
+});
+exports.sendMessageTool = (0, base_js_1.defineTool)('rocketchat_send_message', `Send a message to a Rocket.Chat channel.
+
+**IMPORTANT - Check First:**
+1. Call rocketchat_get_write_status to verify write is enabled
+2. If disabled, inform user that ROCKETCHAT_WRITE_ENABLED=true is required
+
+**Requirements:**
+- ROCKETCHAT_WRITE_ENABLED=true (server configuration)
+- Room must be in whitelist (if configured) or not in blacklist
+
+**Safety Features (automatic):**
+- @all, @here, @channel mentions are neutralized to prevent mass notifications
+- Messages to unauthorized rooms are blocked
+- Message length limited to 10000 characters
+
+**Error Handling:**
+- "Write disabled": Server not configured for writes
+- "Room not allowed": Room not in whitelist or is blacklisted
+- "API error": Check roomId is valid
+
+Returns:
+- Sent message details
+- Whether sanitization was applied
+- List of neutralized patterns (if any)
+
+Examples:
+- Send to channel: { "roomId": "GENERAL", "text": "Hello team!" }
+- Reply to thread: { "roomId": "GENERAL", "text": "I agree", "threadId": "abc123" }`, sendMessageSchema, async (params) => {
+    // Check write permissions
+    const writeGuard = (0, write_guard_js_1.getWriteGuard)();
+    const writeCheck = writeGuard.checkWrite(params.roomId);
+    if (!writeCheck.allowed) {
+        return (0, base_js_1.createErrorResult)(base_js_1.ErrorCodes.WRITE_DISABLED, writeCheck.reason || 'Write operation not allowed', 'Write operations are controlled by ROCKETCHAT_WRITE_ENABLED and ROCKETCHAT_WRITE_ROOMS');
+    }
+    // Sanitize message text
+    const sanitizer = (0, sanitizer_js_1.getSanitizer)();
+    const sanitized = sanitizer.sanitize(params.text);
+    try {
+        const client = (0, client_js_1.getClient)();
+        const response = await client.sendMessage({
+            roomId: params.roomId,
+            text: sanitized.text,
+            tmid: params.threadId
+        });
+        if (!response.success) {
+            return (0, base_js_1.createErrorResult)(base_js_1.ErrorCodes.API_ERROR, 'Failed to send message');
+        }
+        const formatted = (0, message_formatter_js_1.formatMessages)([response.message])[0];
+        const result = (0, response_builder_js_1.buildSuccessResponse)({
+            message: formatted,
+            sanitized: sanitized.modified,
+            neutralizedPatterns: sanitized.neutralized
+        });
+        return (0, base_js_1.createToolResult)(result);
+    }
+    catch (error) {
+        return (0, base_js_1.createErrorResultFromException)(base_js_1.ErrorCodes.API_ERROR, 'Failed to send message', error);
+    }
+});
+/**
+ * rocketchat_react
+ * Add a reaction to a message
+ */
+const reactSchema = zod_1.z.object({
+    messageId: zod_1.z.string()
+        .describe('Message ID to react to'),
+    emoji: zod_1.z.string()
+        .describe('Emoji to react with (e.g., ":thumbsup:", ":check:", ":eyes:")')
+});
+exports.reactTool = (0, base_js_1.defineTool)('rocketchat_react', `Add a reaction emoji to a message.
+
+Requires ROCKETCHAT_WRITE_ENABLED=true.
+
+Emoji format:
+- With colons: ":thumbsup:"
+- Without colons: "thumbsup" (will be normalized)
+
+Common reactions:
+- :thumbsup: - Agreement/approval
+- :eyes: - Looking into it
+- :white_check_mark: - Done/completed
+- :hourglass: - In progress
+- :question: - Needs clarification
+
+Examples:
+- Add thumbsup: { "messageId": "abc123", "emoji": ":thumbsup:" }
+- Mark as done: { "messageId": "abc123", "emoji": "white_check_mark" }`, reactSchema, async (params) => {
+    // Reactions require write access
+    const writeGuard = (0, write_guard_js_1.getWriteGuard)();
+    if (!writeGuard.isEnabled()) {
+        return (0, base_js_1.createErrorResult)(base_js_1.ErrorCodes.WRITE_DISABLED, 'Write operations are disabled', 'Set ROCKETCHAT_WRITE_ENABLED=true to enable reactions');
+    }
+    try {
+        const client = (0, client_js_1.getClient)();
+        // Normalize emoji format
+        let emoji = params.emoji;
+        if (!emoji.startsWith(':'))
+            emoji = ':' + emoji;
+        if (!emoji.endsWith(':'))
+            emoji = emoji + ':';
+        const response = await client.reactToMessage(params.messageId, emoji);
+        if (!response.success) {
+            return (0, base_js_1.createErrorResult)(base_js_1.ErrorCodes.API_ERROR, 'Failed to add reaction');
+        }
+        const result = (0, response_builder_js_1.buildSuccessResponse)({
+            messageId: params.messageId,
+            emoji,
+            success: true
+        });
+        return (0, base_js_1.createToolResult)(result);
+    }
+    catch (error) {
+        return (0, base_js_1.createErrorResultFromException)(base_js_1.ErrorCodes.API_ERROR, 'Failed to add reaction', error);
+    }
+});
+/**
+ * rocketchat_get_write_status
+ * Check if write operations are enabled and get configuration
+ */
+const getWriteStatusSchema = zod_1.z.object({});
+exports.getWriteStatusTool = (0, base_js_1.defineTool)('rocketchat_get_write_status', `Check if write operations are enabled and get the current configuration.
+
+**Call this BEFORE using rocketchat_send_message or rocketchat_react.**
+
+Returns:
+- enabled: Whether write operations are allowed
+- whitelist: Rooms where writes are allowed (if configured)
+- blacklist: Rooms where writes are blocked
+- description: Human-readable status summary
+
+**Decision Tree:**
+1. If enabled=false → Inform user writes are disabled
+2. If enabled=true + whitelist → Check if target room is in whitelist
+3. If enabled=true + no whitelist → All rooms allowed except blacklist
+
+Example: {}`, getWriteStatusSchema, async () => {
+    const writeGuard = (0, write_guard_js_1.getWriteGuard)();
+    const config = writeGuard.getConfig();
+    const result = (0, response_builder_js_1.buildSuccessResponse)({
+        enabled: config.enabled,
+        whitelist: config.whitelist,
+        blacklist: config.blacklist,
+        description: config.enabled
+            ? config.whitelist.length > 0
+                ? `Write enabled for rooms: ${config.whitelist.join(', ')}`
+                : 'Write enabled for all rooms (except blacklisted)'
+            : 'Write operations are disabled'
+    });
+    return (0, base_js_1.createToolResult)(result);
+});
+// Register tools
+base_js_1.toolRegistry.register(exports.sendMessageTool);
+base_js_1.toolRegistry.register(exports.reactTool);
+base_js_1.toolRegistry.register(exports.getWriteStatusTool);
+//# sourceMappingURL=write-tools.js.map

package/dist/tools/write-tools.js.map

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

package/dist/utils/cache.d.ts

@@ -0,0 +1,47 @@
+/**
+ * LRU Cache implementation for API response caching
+ * Reduces redundant API calls and improves response time
+ */
+export declare class LRUCache<T> {
+    private cache;
+    private readonly maxSize;
+    private readonly ttlMs;
+    constructor(maxSize?: number, ttlMs?: number);
+    /**
+     * Get value from cache
+     */
+    get(key: string): T | undefined;
+    /**
+     * Set value in cache
+     */
+    set(key: string, value: T): void;
+    /**
+     * Check if key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Delete entry from cache
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear all entries
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        size: number;
+        maxSize: number;
+        ttlMs: number;
+    };
+    /**
+     * Remove expired entries
+     */
+    prune(): number;
+}
+/**
+ * Create cache key from parameters
+ */
+export declare function createCacheKey(prefix: string, params: Record<string, unknown>): string;
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,qBAAa,QAAQ,CAAC,CAAC;IACnB,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,GAAE,MAAY,EAAE,KAAK,GAAE,MAAe;IAMzD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAqB/B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAgBhC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAczB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAQ5D;;OAEG;IACH,KAAK,IAAI,MAAM;CAalB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAOtF"}

package/dist/utils/cache.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * LRU Cache implementation for API response caching
+ * Reduces redundant API calls and improves response time
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LRUCache = void 0;
+exports.createCacheKey = createCacheKey;
+class LRUCache {
+    cache;
+    maxSize;
+    ttlMs;
+    constructor(maxSize = 100, ttlMs = 300000) {
+        this.cache = new Map();
+        this.maxSize = maxSize;
+        this.ttlMs = ttlMs;
+    }
+    /**
+     * Get value from cache
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return undefined;
+        }
+        // Check if expired
+        if (Date.now() - entry.timestamp > this.ttlMs) {
+            this.cache.delete(key);
+            return undefined;
+        }
+        // Update access count and move to end (most recently used)
+        entry.accessCount++;
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        return entry.value;
+    }
+    /**
+     * Set value in cache
+     */
+    set(key, value) {
+        // Remove oldest entries if at capacity
+        if (this.cache.size >= this.maxSize) {
+            const oldestKey = this.cache.keys().next().value;
+            if (oldestKey) {
+                this.cache.delete(oldestKey);
+            }
+        }
+        this.cache.set(key, {
+            value,
+            timestamp: Date.now(),
+            accessCount: 1
+        });
+    }
+    /**
+     * Check if key exists and is not expired
+     */
+    has(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return false;
+        }
+        if (Date.now() - entry.timestamp > this.ttlMs) {
+            this.cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Delete entry from cache
+     */
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    /**
+     * Clear all entries
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        return {
+            size: this.cache.size,
+            maxSize: this.maxSize,
+            ttlMs: this.ttlMs
+        };
+    }
+    /**
+     * Remove expired entries
+     */
+    prune() {
+        const now = Date.now();
+        let removed = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            if (now - entry.timestamp > this.ttlMs) {
+                this.cache.delete(key);
+                removed++;
+            }
+        }
+        return removed;
+    }
+}
+exports.LRUCache = LRUCache;
+/**
+ * Create cache key from parameters
+ */
+function createCacheKey(prefix, params) {
+    const sortedParams = Object.keys(params)
+        .sort()
+        .map(key => `${key}=${JSON.stringify(params[key])}`)
+        .join('&');
+    return `${prefix}:${sortedParams}`;
+}
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

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

package/dist/utils/error-handler.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Centralized Error Handling Utilities
+ * Provides consistent error handling across all MCP tools
+ */
+/**
+ * Error codes used across the MCP server
+ */
+export declare const ErrorCodes: {
+    readonly API_ERROR: "API_ERROR";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly PERMISSION_DENIED: "PERMISSION_DENIED";
+    readonly RATE_LIMITED: "RATE_LIMITED";
+    readonly WRITE_DISABLED: "WRITE_DISABLED";
+    readonly ROOM_NOT_ALLOWED: "ROOM_NOT_ALLOWED";
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+};
+export type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];
+/**
+ * Standardized error result structure
+ */
+export interface ErrorInfo {
+    code: ErrorCode;
+    message: string;
+    details?: string;
+    suggestion?: string;
+}
+/**
+ * Extract a meaningful error message from any error type
+ */
+export declare function extractErrorMessage(error: unknown): string;
+/**
+ * Extract error details (stack trace or additional info)
+ */
+export declare function extractErrorDetails(error: unknown): string | undefined;
+/**
+ * Create an error info object from any error
+ */
+export declare function createErrorInfo(code: ErrorCode, defaultMessage: string, error?: unknown): ErrorInfo;
+/**
+ * Map HTTP status codes to error codes
+ */
+export declare function httpStatusToErrorCode(status: number): ErrorCode;
+/**
+ * Wrapper for async handler functions with consistent error handling
+ * @param handler - The async handler function to wrap
+ * @param errorCode - Default error code to use
+ * @param errorMessage - Default error message
+ * @returns A wrapped function that catches errors and returns error results
+ */
+export declare function withErrorHandling<TParams, TResult>(handler: (params: TParams) => Promise<TResult>, errorCode: ErrorCode, errorMessage: string): (params: TParams) => Promise<TResult | ErrorInfo>;
+/**
+ * Helper to check if a result is an error info
+ */
+export declare function isErrorInfo(result: unknown): result is ErrorInfo;
+/**
+ * Standard suggestions for common errors
+ */
+export declare const ErrorSuggestions: Record<ErrorCode, string>;
+/**
+ * Add suggestion to error info based on error code
+ */
+export declare function enrichErrorInfo(errorInfo: ErrorInfo): ErrorInfo;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/utils/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;CASb,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAW1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAgBtE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC3B,IAAI,EAAE,SAAS,EACf,cAAc,EAAE,MAAM,EACtB,KAAK,CAAC,EAAE,OAAO,GAChB,SAAS,CASX;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAc/D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAC9C,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,EAC9C,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,MAAM,GACrB,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAQnD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,SAAS,CAShE;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAStD,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAQ/D"}