mcp-server-db2i 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ström Capital
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,252 @@
+# mcp-server-db2i
+
+A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for IBM DB2 for i (DB2i). This server enables AI assistants like Claude and Cursor to query and inspect IBM i databases using the JT400 JDBC driver.
+
+## Features
+
+- **Read-only SQL queries** - Execute SELECT statements safely with automatic result limiting
+- **Schema inspection** - List all schemas/libraries with optional filtering
+- **Table metadata** - List tables, describe columns, view indexes and constraints
+- **View inspection** - List and explore database views
+- **Secure by design** - Only SELECT queries allowed, credentials via environment variables
+- **Docker support** - Run as a container for easy deployment
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `execute_query` | Execute read-only SELECT queries |
+| `list_schemas` | List schemas/libraries (with optional filter) |
+| `list_tables` | List tables in a schema (with optional filter) |
+| `describe_table` | Get detailed column information |
+| `list_views` | List views in a schema (with optional filter) |
+| `list_indexes` | List indexes for a table |
+| `get_table_constraints` | Get primary keys, foreign keys, unique constraints |
+
+### Filter Syntax
+
+The list tools support pattern matching:
+- `CUST` - Contains "CUST"
+- `CUST*` - Starts with "CUST"
+- `*LOG` - Ends with "LOG"
+- `ORD*FILE` - Starts with "ORD", ends with "FILE"
+
+## Installation
+
+### Prerequisites
+
+- Node.js 18 or higher
+- Java Runtime Environment (JRE) 11 or higher (for JDBC)
+- Access to an IBM i system
+
+### Option 1: npm (recommended)
+
+```bash
+npm install -g mcp-server-db2i
+```
+
+### Option 2: From source
+
+```bash
+git clone https://github.com/Strom-Capital/mcp-server-db2i.git
+cd mcp-server-db2i
+npm install
+npm run build
+```
+
+### Option 3: Docker
+
+```bash
+docker build -t mcp-server-db2i .
+```
+
+## Configuration
+
+Create a `.env` file or set environment variables:
+
+```env
+# Required
+DB2I_HOSTNAME=your-ibm-i-host.com
+DB2I_USERNAME=your-username
+DB2I_PASSWORD=your-password
+
+# Optional
+DB2I_PORT=446                              # Default: 446
+DB2I_DATABASE=*LOCAL                       # Default: *LOCAL
+DB2I_SCHEMA=your-default-schema            # Default schema for all tools (can be overridden per-call)
+DB2I_JDBC_OPTIONS=naming=system;date format=iso
+```
+
+### Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `DB2I_HOSTNAME` | Yes | - | IBM i hostname or IP address |
+| `DB2I_USERNAME` | Yes | - | IBM i user profile |
+| `DB2I_PASSWORD` | Yes | - | User password |
+| `DB2I_PORT` | No | `446` | JDBC port (446 is standard for IBM i) |
+| `DB2I_DATABASE` | No | `*LOCAL` | Database name |
+| `DB2I_SCHEMA` | No | - | Default schema/library for tools. If set, you don't need to specify schema in each tool call. |
+| `DB2I_JDBC_OPTIONS` | No | - | Additional JDBC options (semicolon-separated) |
+
+### JDBC Options
+
+Common JDBC options for IBM i (JT400/JTOpen driver):
+
+| Option | Values | Description |
+|--------|--------|-------------|
+| `naming` | `system`, `sql` | `system` uses `/` for library separator, `sql` uses `.` for schema separator |
+| `libraries` | `LIB1,LIB2,...` | Library list for resolving unqualified names |
+| `date format` | `iso`, `usa`, `eur`, `jis`, `mdy`, `dmy`, `ymd` | Date format for date fields |
+| `time format` | `iso`, `usa`, `eur`, `jis`, `hms` | Time format for time fields |
+| `errors` | `full`, `basic` | Level of detail in error messages (`full` helps debugging) |
+| `translate binary` | `true`, `false` | Whether to translate binary/CCSID data |
+| `secure` | `true`, `false` | Enable SSL/TLS encryption |
+
+Example: `naming=system;date format=iso;errors=full`
+
+## Usage with Cursor
+
+Add to your Cursor MCP settings (`~/.cursor/mcp.json`):
+
+### Using Docker (recommended)
+
+```json
+{
+  "mcpServers": {
+    "db2i": {
+      "command": "docker",
+      "args": [
+        "run", "-i", "--rm",
+        "-e", "DB2I_HOSTNAME=your-host",
+        "-e", "DB2I_USERNAME=your-user",
+        "-e", "DB2I_PASSWORD=your-password",
+        "mcp-server-db2i:latest"
+      ]
+    }
+  }
+}
+```
+
+### Using Docker with env file
+
+```json
+{
+  "mcpServers": {
+    "db2i": {
+      "command": "docker",
+      "args": [
+        "run", "-i", "--rm",
+        "--env-file", "/path/to/your/.env",
+        "mcp-server-db2i:latest"
+      ]
+    }
+  }
+}
+```
+
+### Using docker-compose
+
+Create a `.env` file in the project root, then:
+
+```json
+{
+  "mcpServers": {
+    "db2i": {
+      "command": "docker-compose",
+      "args": ["run", "--rm", "mcp-server-db2i"],
+      "cwd": "/path/to/mcp-server-db2i"
+    }
+  }
+}
+```
+
+The `docker-compose.yml` automatically reads from `.env` in the same directory.
+
+### Using npx (after npm install)
+
+```json
+{
+  "mcpServers": {
+    "db2i": {
+      "command": "npx",
+      "args": ["mcp-server-db2i"],
+      "env": {
+        "DB2I_HOSTNAME": "your-host",
+        "DB2I_USERNAME": "your-user",
+        "DB2I_PASSWORD": "your-password"
+      }
+    }
+  }
+}
+```
+
+### Local development
+
+```json
+{
+  "mcpServers": {
+    "db2i": {
+      "command": "npx",
+      "args": ["tsx", "/path/to/mcp-server-db2i/src/index.ts"],
+      "env": {
+        "DB2I_HOSTNAME": "your-host",
+        "DB2I_USERNAME": "your-user",
+        "DB2I_PASSWORD": "your-password"
+      }
+    }
+  }
+}
+```
+
+## Example Queries
+
+Once connected, you can ask the AI assistant:
+
+- "List all schemas that contain 'PROD'"
+- "Show me the tables in schema MYLIB"
+- "Describe the columns in MYLIB/CUSTOMERS"
+- "What indexes exist on the ORDERS table?"
+- "Run this query: SELECT * FROM MYLIB.CUSTOMERS WHERE STATUS = 'A'"
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run in development mode
+npm run dev
+
+# Build for production
+npm run build
+
+# Run production build
+npm start
+```
+
+## Security
+
+- **Read-only access**: Only SELECT statements are permitted
+- **No credentials in code**: All sensitive data via environment variables
+- **Query validation**: Dangerous SQL keywords are blocked
+- **Result limiting**: Default limit of 1000 rows prevents large result sets
+
+## Compatibility
+
+- IBM i V7R3 and later (V7R5 recommended)
+- Works with any IBM i system accessible via JDBC over TCP/IP
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Acknowledgments
+
+- [node-jt400](https://www.npmjs.com/package/node-jt400) - JT400 JDBC driver wrapper for Node.js
+- [Model Context Protocol](https://modelcontextprotocol.io/) - The protocol specification
+- [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk) - Official TypeScript SDK

package/dist/config.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Configuration module for IBM DB2i MCP Server
+ * Handles environment variables and JDBC connection options
+ */
+export interface DB2iConfig {
+    hostname: string;
+    port: number;
+    username: string;
+    password: string;
+    database: string;
+    schema: string;
+    jdbcOptions: Record<string, string>;
+}
+/**
+ * Load configuration from environment variables
+ */
+export declare function loadConfig(): DB2iConfig;
+/**
+ * Build JDBC connection configuration for node-jt400
+ */
+export declare function buildConnectionConfig(config: DB2iConfig): {
+    host: string;
+    user: string;
+    password: string;
+    [key: string]: string;
+};
+/**
+ * Get the default schema from config
+ */
+export declare function getDefaultSchema(config: DB2iConfig): string | undefined;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AA6BD;;GAEG;AACH,wBAAgB,UAAU,IAAI,UAAU,CAwBvC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB,CA4BA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAEvE"}

package/dist/config.js

@@ -0,0 +1,83 @@
+/**
+ * Configuration module for IBM DB2i MCP Server
+ * Handles environment variables and JDBC connection options
+ */
+/**
+ * Parse JDBC options from a semicolon-separated string
+ * Format: "key1=value1;key2=value2"
+ */
+function parseJdbcOptions(optionsString) {
+    if (!optionsString) {
+        return {};
+    }
+    const options = {};
+    const pairs = optionsString.split(';');
+    for (const pair of pairs) {
+        const trimmed = pair.trim();
+        if (!trimmed)
+            continue;
+        const eqIndex = trimmed.indexOf('=');
+        if (eqIndex > 0) {
+            const key = trimmed.substring(0, eqIndex).trim();
+            const value = trimmed.substring(eqIndex + 1).trim();
+            options[key] = value;
+        }
+    }
+    return options;
+}
+/**
+ * Load configuration from environment variables
+ */
+export function loadConfig() {
+    const hostname = process.env.DB2I_HOSTNAME;
+    const username = process.env.DB2I_USERNAME;
+    const password = process.env.DB2I_PASSWORD;
+    if (!hostname) {
+        throw new Error('DB2I_HOSTNAME environment variable is required');
+    }
+    if (!username) {
+        throw new Error('DB2I_USERNAME environment variable is required');
+    }
+    if (!password) {
+        throw new Error('DB2I_PASSWORD environment variable is required');
+    }
+    return {
+        hostname,
+        port: parseInt(process.env.DB2I_PORT || '446', 10),
+        username,
+        password,
+        database: process.env.DB2I_DATABASE || '*LOCAL',
+        schema: process.env.DB2I_SCHEMA || '',
+        jdbcOptions: parseJdbcOptions(process.env.DB2I_JDBC_OPTIONS),
+    };
+}
+/**
+ * Build JDBC connection configuration for node-jt400
+ */
+export function buildConnectionConfig(config) {
+    const connectionConfig = {
+        host: config.hostname,
+        user: config.username,
+        password: config.password,
+    };
+    // Add default naming convention (system naming uses / for library separator)
+    if (!config.jdbcOptions['naming']) {
+        connectionConfig['naming'] = 'system';
+    }
+    // Add date format if not specified
+    if (!config.jdbcOptions['date format']) {
+        connectionConfig['date format'] = 'iso';
+    }
+    // Merge additional JDBC options
+    for (const [key, value] of Object.entries(config.jdbcOptions)) {
+        connectionConfig[key] = value;
+    }
+    return connectionConfig;
+}
+/**
+ * Get the default schema from config
+ */
+export function getDefaultSchema(config) {
+    return config.schema || undefined;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/db/connection.d.ts

@@ -0,0 +1,42 @@
+/**
+ * JDBC Connection Manager for IBM DB2i using node-jt400
+ */
+import { pool } from 'node-jt400';
+import type { DB2iConfig } from '../config.js';
+export interface QueryResult {
+    rows: Record<string, unknown>[];
+    metadata?: {
+        columnCount: number;
+        columns: Array<{
+            name: string;
+            type: string;
+            precision: number;
+            scale: number;
+        }>;
+    };
+}
+/**
+ * Initialize the connection pool
+ */
+export declare function initializePool(config: DB2iConfig): void;
+/**
+ * Get the connection pool instance
+ */
+export declare function getPool(): ReturnType<typeof pool>;
+/**
+ * Execute a query and return results
+ */
+export declare function executeQuery(sql: string, params?: unknown[]): Promise<QueryResult>;
+/**
+ * Execute a query with metadata about columns
+ */
+export declare function executeQueryWithMetadata(sql: string, params?: unknown[]): Promise<QueryResult>;
+/**
+ * Test the database connection
+ */
+export declare function testConnection(): Promise<boolean>;
+/**
+ * Close the connection pool
+ */
+export declare function closePool(): Promise<void>;
+//# sourceMappingURL=connection.d.ts.map

package/dist/db/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/db/connection.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE;QACT,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,KAAK,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,MAAM,CAAC;YAClB,KAAK,EAAE,MAAM,CAAC;SACf,CAAC,CAAC;KACJ,CAAC;CACH;AAID;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAGvD;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,UAAU,CAAC,OAAO,IAAI,CAAC,CAKjD;AAkBD;;GAEG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,OAAO,EAAO,GACrB,OAAO,CAAC,WAAW,CAAC,CActB;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,OAAO,EAAO,GACrB,OAAO,CAAC,WAAW,CAAC,CActB;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAOvD;AAED;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAK/C"}

package/dist/db/connection.js

@@ -0,0 +1,97 @@
+/**
+ * JDBC Connection Manager for IBM DB2i using node-jt400
+ */
+import { pool } from 'node-jt400';
+import { buildConnectionConfig } from '../config.js';
+let connectionPool = null;
+/**
+ * Initialize the connection pool
+ */
+export function initializePool(config) {
+    const connectionConfig = buildConnectionConfig(config);
+    connectionPool = pool(connectionConfig);
+}
+/**
+ * Get the connection pool instance
+ */
+export function getPool() {
+    if (!connectionPool) {
+        throw new Error('Connection pool not initialized. Call initializePool first.');
+    }
+    return connectionPool;
+}
+/**
+ * Convert unknown params to Param type, filtering out undefined
+ */
+function toParams(params) {
+    return params
+        .filter((p) => p !== undefined)
+        .map((p) => {
+        if (p === null)
+            return null;
+        if (typeof p === 'string')
+            return p;
+        if (typeof p === 'number')
+            return p;
+        if (p instanceof Date)
+            return p;
+        // Convert other types to string
+        return String(p);
+    });
+}
+/**
+ * Execute a query and return results
+ */
+export async function executeQuery(sql, params = []) {
+    const db = getPool();
+    try {
+        const typedParams = toParams(params);
+        const results = await db.query(sql, typedParams);
+        return {
+            rows: results,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown database error';
+        throw new Error(`Database query failed: ${message}`);
+    }
+}
+/**
+ * Execute a query with metadata about columns
+ */
+export async function executeQueryWithMetadata(sql, params = []) {
+    const db = getPool();
+    try {
+        const typedParams = toParams(params);
+        const results = await db.query(sql, typedParams);
+        return {
+            rows: results,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown database error';
+        throw new Error(`Database query failed: ${message}`);
+    }
+}
+/**
+ * Test the database connection
+ */
+export async function testConnection() {
+    try {
+        await executeQuery('SELECT 1 FROM SYSIBM.SYSDUMMY1');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Close the connection pool
+ */
+export async function closePool() {
+    if (connectionPool) {
+        // node-jt400 pool doesn't have explicit close, but we can clear the reference
+        connectionPool = null;
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/db/connection.js.map

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

package/dist/db/queries.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Query helpers for IBM DB2i metadata and data access
+ */
+/**
+ * Convert a filter pattern to SQL LIKE pattern
+ * Supports:
+ * - "term" -> "%term%" (contains)
+ * - "term*" -> "term%" (starts with)
+ * - "*term" -> "%term" (ends with)
+ * - "term*suffix" -> "term%suffix" (pattern)
+ */
+export declare function filterToLikePattern(filter: string | undefined): string;
+/**
+ * Validate that a query is read-only (SELECT only)
+ */
+export declare function isReadOnlyQuery(sql: string): boolean;
+/**
+ * List all schemas/libraries
+ */
+export declare function listSchemas(filter?: string): Promise<Array<{
+    schema_name: string;
+    schema_text: string | null;
+}>>;
+/**
+ * List tables in a schema
+ */
+export declare function listTables(schema: string, filter?: string): Promise<Array<{
+    table_name: string;
+    table_type: string;
+    table_text: string | null;
+}>>;
+/**
+ * Describe a table's columns
+ */
+export declare function describeTable(schema: string, table: string): Promise<Array<{
+    column_name: string;
+    ordinal_position: number;
+    data_type: string;
+    length: number | null;
+    numeric_scale: number | null;
+    is_nullable: string;
+    column_default: string | null;
+    column_text: string | null;
+    system_column_name: string;
+    ccsid: number | null;
+}>>;
+/**
+ * List views in a schema
+ */
+export declare function listViews(schema: string, filter?: string): Promise<Array<{
+    view_name: string;
+    view_text: string | null;
+}>>;
+/**
+ * List indexes for a table
+ */
+export declare function listIndexes(schema: string, table: string): Promise<Array<{
+    index_name: string;
+    index_schema: string;
+    is_unique: string;
+    column_names: string;
+}>>;
+/**
+ * Get table constraints (primary keys, foreign keys, unique constraints)
+ */
+export declare function getTableConstraints(schema: string, table: string): Promise<Array<{
+    constraint_name: string;
+    constraint_type: string;
+    column_name: string;
+    ordinal_position: number;
+    referenced_table_schema: string | null;
+    referenced_table_name: string | null;
+    referenced_column_name: string | null;
+}>>;
+//# sourceMappingURL=queries.d.ts.map

package/dist/db/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/db/queries.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAiBtE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAgCpD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC,CAkBtH;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC,CAqBvF;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,KAAK,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC,CAAC,CAiCF;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC,CAoBjE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,KAAK,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC,CAqBF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,KAAK,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC,CAAC,CAAC,CAqCF"}