@hsayed21/wikijs-mcp 2.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Markus Michalski
+
+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,87 @@
+# Wiki.js MCP Server
+
+**Read-only Model Context Protocol server for Wiki.js** - Search, list, browse, and retrieve published Wiki.js knowledge base pages from your AI assistant.
+
+## v2.0.0 - Major Refactoring
+
+This version includes a complete rewrite following MCP Best Practices:
+
+- **TypeScript** - Full type safety with strict mode
+- **Modern SDK** - Uses MCP SDK v1.24+ with `McpServer.tool()` API
+- **Zod Validation** - Runtime input validation for all tools
+- **Service-Prefixed Tools** - All tools use `wikijs_` prefix for namespace clarity
+- **Tool Annotations** - Proper `readOnlyHint`, `destructiveHint`, etc.
+- **Pagination Support** - List operations return `has_more`, `next_offset`, `total_count`
+- **Character Limits** - Large content is truncated with clear notices
+
+## Quick Start
+
+```bash
+# 1. Install package
+npm install -g @hsayed21/wikijs-mcp
+
+# 2. Configure your MCP client with WIKIJS_API_URL and WIKIJS_API_TOKEN
+```
+
+## Requirements
+
+- **Node.js 18+**
+- **Wiki.js instance** (v2.x or v3.x)
+- **Wiki.js API Token** with read permissions
+
+## Available Tools
+
+| Tool | Description | Annotations |
+|------|-------------|-------------|
+| `wikijs_get_page` | Retrieve full page content and metadata | `readOnlyHint: true` |
+| `wikijs_list_pages` | List pages with pagination and filtering | `readOnlyHint: true` |
+| `wikijs_get_tree` | Retrieve the hierarchical Wiki.js page tree | `readOnlyHint: true` |
+| `wikijs_search_pages` | Full-text search across wiki pages | `readOnlyHint: true` |
+
+## Development
+
+```bash
+# Development with hot-reload
+npm run dev
+
+# Build for production
+npm run build
+
+# Type checking
+npm run typecheck
+```
+
+## Project Structure
+
+```
+wikijs-mcp/
+├── src/
+│   ├── index.ts           # Main server entry point
+│   ├── constants.ts       # Shared constants (CHARACTER_LIMIT, etc.)
+│   ├── types.ts           # TypeScript type definitions
+│   ├── schemas/           # Zod validation schemas
+│   ├── services/          # API client and error handling
+│   └── tools/             # Tool implementations
+├── dist/                  # Compiled JavaScript
+├── evaluation.xml         # MCP evaluation test questions
+└── package.json
+```
+
+## License
+
+MIT License - See [LICENSE](./LICENSE) for details
+
+## Author
+**Markus Michalski**
+- Website: [markus-michalski.net](https://markus-michalski.net)
+- GitHub: [@markus-michalski](https://github.com/markus-michalski)
+
+## Attribution
+
+Originally authored by [@markus-michalski](https://github.com/markus-michalski). This package was updated by **hsayed21** to fit a read-only Wiki.js MCP workflow for AI support agents.
+
+## Links
+
+- **[Full Documentation](https://faq.markus-michalski.net/en/mcp/wikijs)** (English)
+- **[Vollstaendige Dokumentation](https://faq.markus-michalski.net/de/mcp/wikijs)** (Deutsch)
+- [Changelog](./CHANGELOG.md)

package/dist/constants.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Wiki.js MCP Server Constants
+ */
+export declare const CHARACTER_LIMIT = 100000;
+export declare const MAX_CONTENT_SIZE = 500000;
+export declare const DEFAULT_PAGE_LIMIT = 50;
+export declare const MAX_PAGE_LIMIT = 200;
+export declare const MAX_TAG_LENGTH = 100;
+export declare const MAX_TAGS_PER_PAGE = 50;
+export declare const API_TIMEOUT = 30000;
+export declare enum ResponseFormat {
+    JSON = "json",
+    MARKDOWN = "markdown"
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,eAAe,SAAS,CAAC;AAGtC,eAAO,MAAM,gBAAgB,SAAU,CAAC;AAGxC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,cAAc,MAAM,CAAC;AAGlC,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAGpC,eAAO,MAAM,WAAW,QAAQ,CAAC;AAGjC,oBAAY,cAAc;IACxB,IAAI,SAAS;IACb,QAAQ,aAAa;CACtB"}

package/dist/constants.js

@@ -0,0 +1,22 @@
+/**
+ * Wiki.js MCP Server Constants
+ */
+// Maximum response size in characters to prevent overwhelming LLM context
+export const CHARACTER_LIMIT = 100000;
+// Maximum content size in characters for write operations
+export const MAX_CONTENT_SIZE = 500_000;
+// Default pagination settings
+export const DEFAULT_PAGE_LIMIT = 50;
+export const MAX_PAGE_LIMIT = 200;
+// Tag limits
+export const MAX_TAG_LENGTH = 100;
+export const MAX_TAGS_PER_PAGE = 50;
+// API timeout in milliseconds
+export const API_TIMEOUT = 30000;
+// Response formats
+export var ResponseFormat;
+(function (ResponseFormat) {
+    ResponseFormat["JSON"] = "json";
+    ResponseFormat["MARKDOWN"] = "markdown";
+})(ResponseFormat || (ResponseFormat = {}));
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAExC,8BAA8B;AAC9B,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAElC,aAAa;AACb,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,8BAA8B;AAC9B,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC;AAEjC,mBAAmB;AACnB,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,+BAAa,CAAA;IACb,uCAAqB,CAAA;AACvB,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * Wiki.js MCP Server
+ *
+ * Provides Model Context Protocol (MCP) tools for interacting with Wiki.js GraphQL API
+ *
+ * @author Markus Michalski
+ * @license MIT
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG"}

package/dist/index.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+/**
+ * Wiki.js MCP Server
+ *
+ * Provides Model Context Protocol (MCP) tools for interacting with Wiki.js GraphQL API
+ *
+ * @author Markus Michalski
+ * @license MIT
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import dotenv from 'dotenv';
+import { homedir } from 'os';
+import { join } from 'path';
+import { existsSync } from 'fs';
+import { WikiJsClient } from './services/client.js';
+import { getPageToolDefinition, handleGetPage, getTreeToolDefinition, handleGetTree, listPagesToolDefinition, handleListPages, searchPagesToolDefinition, handleSearchPages, } from './tools/index.js';
+// Load environment variables from deployment directory
+const envPath = join(homedir(), '.claude', 'mcp-servers', 'wikijs', '.env');
+if (existsSync(envPath)) {
+    dotenv.config({ path: envPath });
+}
+else {
+    // Fallback to CWD for development
+    dotenv.config();
+}
+// Validate required environment variables
+const WIKIJS_API_URL = process.env.WIKIJS_API_URL;
+const WIKIJS_API_TOKEN = process.env.WIKIJS_API_TOKEN;
+if (!WIKIJS_API_URL || !WIKIJS_API_TOKEN) {
+    console.error('Error: Missing required environment variables');
+    console.error('Please ensure WIKIJS_API_URL and WIKIJS_API_TOKEN are set in .env file');
+    process.exit(1);
+}
+// Initialize Wiki.js client
+const wikiClient = new WikiJsClient(WIKIJS_API_URL, WIKIJS_API_TOKEN);
+// Create MCP server with modern API
+const server = new McpServer({
+    name: 'wikijs-mcp-server',
+    version: '2.0.0',
+});
+// Register tools using modern registerTool API
+server.tool(getPageToolDefinition.name, getPageToolDefinition.description, getPageToolDefinition.inputSchema.shape, async (args) => handleGetPage(wikiClient, args));
+server.tool(listPagesToolDefinition.name, listPagesToolDefinition.description, listPagesToolDefinition.inputSchema.shape, async (args) => handleListPages(wikiClient, args));
+server.tool(getTreeToolDefinition.name, getTreeToolDefinition.description, getTreeToolDefinition.inputSchema.shape, async (args) => handleGetTree(wikiClient, args));
+server.tool(searchPagesToolDefinition.name, searchPagesToolDefinition.description, searchPagesToolDefinition.inputSchema.shape, async (args) => handleSearchPages(wikiClient, args));
+// Graceful shutdown handling
+let isShuttingDown = false;
+async function shutdown(signal) {
+    if (isShuttingDown)
+        return;
+    isShuttingDown = true;
+    console.error(`Received ${signal}, shutting down gracefully...`);
+    try {
+        await server.close();
+        console.error('Wiki.js MCP Server shutdown complete');
+        process.exit(0);
+    }
+    catch (error) {
+        console.error('Error during shutdown:', error);
+        process.exit(1);
+    }
+}
+// Setup signal handlers
+process.on('SIGINT', () => shutdown('SIGINT'));
+process.on('SIGTERM', () => shutdown('SIGTERM'));
+process.on('uncaughtException', (error) => {
+    // Don't log EPIPE errors (broken pipe when client disconnects)
+    if (error.code !== 'EPIPE') {
+        console.error('Uncaught exception:', error);
+    }
+    shutdown('uncaughtException');
+});
+process.on('unhandledRejection', (reason) => {
+    console.error('Unhandled rejection:', reason);
+    shutdown('unhandledRejection');
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    const host = new URL(WIKIJS_API_URL).hostname;
+    console.error('Wiki.js MCP Server v2.0.0 running on stdio');
+    console.error(`Connected to: ${host}`);
+}
+main().catch((error) => {
+    console.error('Server error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/schemas/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Zod Schemas for Wiki.js MCP Server Tools
+ *
+ * All input validation schemas with proper constraints and descriptions
+ */
+import { z } from 'zod';
+export declare const getPageSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodNumber>;
+    path: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    locale: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    locale: string;
+    id?: number | undefined;
+    path?: string | undefined;
+}, {
+    id?: number | undefined;
+    path?: string | undefined;
+    locale?: string | undefined;
+}>;
+export type GetPageInput = z.infer<typeof getPageSchema>;
+export declare const listPagesSchema: z.ZodObject<{
+    locale: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    path?: string | undefined;
+    locale?: string | undefined;
+}, {
+    path?: string | undefined;
+    locale?: string | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export type ListPagesInput = z.infer<typeof listPagesSchema>;
+export declare const searchPagesSchema: z.ZodObject<{
+    query: z.ZodString;
+    locale: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    path?: string | undefined;
+    locale?: string | undefined;
+}, {
+    query: string;
+    path?: string | undefined;
+    locale?: string | undefined;
+}>;
+export type SearchPagesInput = z.infer<typeof searchPagesSchema>;
+export declare const getTreeSchema: z.ZodObject<{
+    parent_path: z.ZodOptional<z.ZodString>;
+    parent_id: z.ZodOptional<z.ZodNumber>;
+    mode: z.ZodDefault<z.ZodEnum<["ALL", "FOLDERS", "PAGES"]>>;
+    locale: z.ZodDefault<z.ZodString>;
+    includeAncestors: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    locale: string;
+    mode: "ALL" | "FOLDERS" | "PAGES";
+    includeAncestors: boolean;
+    parent_path?: string | undefined;
+    parent_id?: number | undefined;
+}, {
+    locale?: string | undefined;
+    mode?: "ALL" | "FOLDERS" | "PAGES" | undefined;
+    includeAncestors?: boolean | undefined;
+    parent_path?: string | undefined;
+    parent_id?: number | undefined;
+}>;
+export type GetTreeInput = z.infer<typeof getTreeSchema>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA6CxB,eAAO,MAAM,aAAa;;;;;;;;;;;;EAIxB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAGzD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;EAoB1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAG7D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAY5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAGjE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;EAqBxB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,98 @@
+/**
+ * Zod Schemas for Wiki.js MCP Server Tools
+ *
+ * All input validation schemas with proper constraints and descriptions
+ */
+import { z } from 'zod';
+import { DEFAULT_PAGE_LIMIT, MAX_PAGE_LIMIT } from '../constants.js';
+// Common schemas
+const localeSchema = z
+    .string()
+    .regex(/^[a-z]{2}(-[A-Z]{2})?$/, 'Locale must be a valid language code (e.g., "en", "de", "en-US")')
+    .default('en')
+    .describe('Page locale (e.g., "en", "de")');
+const pageIdSchema = z
+    .number()
+    .int()
+    .positive()
+    .describe('Page ID (positive integer)');
+const pagePathSchema = z
+    .string()
+    .min(1)
+    .max(500)
+    .regex(/^[a-zA-Z0-9][a-zA-Z0-9\-_/]*[a-zA-Z0-9]$|^[a-zA-Z0-9]$/, 'Path must contain only alphanumeric characters, hyphens, underscores, and forward slashes')
+    .refine((path) => !path.includes('..') && !path.includes('//'), 'Path must not contain ".." or "//"')
+    .describe('Page path without leading slash (e.g., "osticket/plugin-name" or "home")');
+const pathFilterSchema = z
+    .string()
+    .min(1)
+    .max(500)
+    .regex(/^[a-zA-Z0-9][a-zA-Z0-9\-_/]*$/, 'Path must contain only alphanumeric characters, hyphens, underscores, and forward slashes')
+    .refine((path) => !path.includes('..') && !path.includes('//'), 'Path must not contain ".." or "//"')
+    .describe('Only return pages where the path starts with this value (e.g., "osticket/" or "support")');
+// Get Page Schema
+export const getPageSchema = z.object({
+    id: pageIdSchema.optional().describe('Page ID (optional if path is provided)'),
+    path: pagePathSchema.optional().describe('Page path (optional if id is provided)'),
+    locale: localeSchema,
+});
+// List Pages Schema
+export const listPagesSchema = z.object({
+    locale: z
+        .string()
+        .regex(/^[a-z]{2}(-[A-Z]{2})?$/, 'Locale must be a valid language code')
+        .optional()
+        .describe('Filter by locale (optional, e.g., "en", "de")'),
+    path: pathFilterSchema.optional(),
+    limit: z
+        .number()
+        .int()
+        .min(-1)
+        .max(MAX_PAGE_LIMIT)
+        .default(DEFAULT_PAGE_LIMIT)
+        .describe(`Maximum number of pages to return (default: ${DEFAULT_PAGE_LIMIT}, max: ${MAX_PAGE_LIMIT}). Use -1 to return all matching pages.`),
+    offset: z
+        .number()
+        .int()
+        .min(0)
+        .default(0)
+        .describe('Number of pages to skip for pagination (default: 0)'),
+});
+// Search Pages Schema
+export const searchPagesSchema = z.object({
+    query: z
+        .string()
+        .min(2)
+        .max(200)
+        .describe('Search query string (minimum 2 characters)'),
+    locale: z
+        .string()
+        .regex(/^[a-z]{2}(-[A-Z]{2})?$/, 'Locale must be a valid language code')
+        .optional()
+        .describe('Filter results by locale (optional)'),
+    path: pathFilterSchema.optional(),
+});
+// Get Page Tree Schema
+export const getTreeSchema = z.object({
+    parent_path: z
+        .string()
+        .max(500)
+        .optional()
+        .describe('Optional parent path to start the tree from. Use empty/omit for the wiki root.'),
+    parent_id: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Optional parent tree node ID to start from. Usually path is easier for agents.'),
+    mode: z
+        .enum(['ALL', 'FOLDERS', 'PAGES'])
+        .default('ALL')
+        .describe('Tree mode: ALL returns folders and pages, FOLDERS returns folders only, PAGES returns pages only.'),
+    locale: localeSchema,
+    includeAncestors: z
+        .boolean()
+        .default(false)
+        .describe('Whether to include ancestor nodes for the selected path/parent.'),
+});
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

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

package/dist/services/client.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Wiki.js GraphQL API Client
+ *
+ * Provides methods to interact with the Wiki.js GraphQL API
+ */
+import type { WikiPage, WikiPageListItem, SearchResponse, WikiPageTreeNode } from '../types.js';
+export declare class WikiJsClient {
+    private apiUrl;
+    private apiToken;
+    constructor(apiUrl: string, apiToken: string);
+    /**
+     * Execute a GraphQL query
+     */
+    query<T>(query: string, variables?: Record<string, unknown>): Promise<T>;
+    /**
+     * List all pages with optional filtering
+     */
+    listPages(locale?: string | null, limit?: number, offset?: number, path?: string | null): Promise<{
+        pages: WikiPageListItem[];
+        total: number;
+    }>;
+    /**
+     * Get a single page by ID
+     */
+    getPageById(id: number): Promise<WikiPage | null>;
+    /**
+     * Get a single page by path
+     */
+    getPageByPath(path: string, locale?: string): Promise<WikiPage | null>;
+    /**
+     * Search pages
+     */
+    searchPages(searchQuery: string, locale?: string | null, path?: string | null): Promise<SearchResponse>;
+    /**
+     * Get the hierarchical Wiki.js page tree
+     */
+    getPageTree(path?: string | null, parent?: number | null, mode?: 'ALL' | 'FOLDERS' | 'PAGES', locale?: string, includeAncestors?: boolean): Promise<WikiPageTreeNode[]>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/services/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/services/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAsBrB,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAK5C;;OAEG;IACG,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IA2ClF;;OAEG;IACG,SAAS,CACb,MAAM,GAAE,MAAM,GAAG,IAAW,EAC5B,KAAK,GAAE,MAAY,EACnB,MAAM,GAAE,MAAU,EAClB,IAAI,GAAE,MAAM,GAAG,IAAW,GACzB,OAAO,CAAC;QAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IA6CxD;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAiCvD;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAiClF;;OAEG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,MAAM,GAAG,IAAW,EAC5B,IAAI,GAAE,MAAM,GAAG,IAAW,GACzB,OAAO,CAAC,cAAc,CAAC;IA+B1B;;OAEG;IACG,WAAW,CACf,IAAI,GAAE,MAAM,GAAG,IAAW,EAC1B,MAAM,GAAE,MAAM,GAAG,IAAW,EAC5B,IAAI,GAAE,KAAK,GAAG,SAAS,GAAG,OAAe,EACzC,MAAM,GAAE,MAAa,EACrB,gBAAgB,GAAE,OAAe,GAChC,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAwC/B"}