tiddlywiki-mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Petru Paler <petru@paler.net>
+
+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,242 @@
+# TiddlyWiki MCP Server
+
+A Model Context Protocol (MCP) server that provides AI assistants with access to TiddlyWiki wikis via the HTTP API. Supports semantic search using Ollama embeddings.
+
+## Features
+
+### MCP Tools
+
+- **search_tiddlers** - Search tiddlers using TiddlyWiki filter syntax, semantic similarity, or hybrid (both combined)
+- **create_tiddler** - Create new tiddlers with custom fields
+- **update_tiddler** - Update existing tiddlers with diff preview
+- **delete_tiddler** - Delete tiddlers with content preview
+
+### MCP Resources
+
+- **filter-reference://syntax** - Complete TiddlyWiki filter syntax reference
+
+### Semantic Search
+
+When Ollama is available, the server provides semantic search capabilities:
+
+- Natural language queries find conceptually related tiddlers
+- Uses `nomic-embed-text` embeddings model
+- SQLite-vec for efficient vector similarity search
+- Background sync keeps embeddings up-to-date
+- Hybrid mode combines filter results with semantic reranking
+
+## Requirements
+
+- Node.js 22+
+- TiddlyWiki with HTTP API enabled (e.g., TiddlyWiki on Node.js with `listen` command)
+- Ollama (optional, for semantic search)
+
+### Build Prerequisites
+
+This project uses native SQLite modules that require compilation. You'll need:
+
+- **Linux**: `build-essential`, Python 3
+- **macOS**: Xcode Command Line Tools (`xcode-select --install`)
+- **Windows**: Visual Studio Build Tools, Python 3
+
+## Installation
+
+```bash
+npm install
+npm run build
+```
+
+## Quick Start
+
+### 1. Start TiddlyWiki with HTTP API
+
+```bash
+# Install TiddlyWiki if you haven't already
+npm install -g tiddlywiki
+
+# Create a new wiki and start it with HTTP API
+tiddlywiki mywiki --init server
+tiddlywiki mywiki --listen port=8080
+```
+
+### 2. (Optional) Set up Ollama for Semantic Search
+
+```bash
+# Install Ollama from https://ollama.ai
+# Then pull the embedding model:
+ollama pull nomic-embed-text
+```
+
+### 3. Start the MCP Server
+
+```bash
+TIDDLYWIKI_URL=http://localhost:8080 node dist/index.js
+```
+
+## Configuration
+
+All configuration is via environment variables. See `.env.example` for a complete reference.
+
+### Required
+
+| Variable | Description |
+|----------|-------------|
+| `TIDDLYWIKI_URL` | URL of your TiddlyWiki server (e.g., `http://localhost:8080`) |
+
+### Optional
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MCP_TRANSPORT` | `stdio` | Transport mode: `stdio` or `http` |
+| `MCP_PORT` | `3000` | HTTP server port (when using http transport) |
+| `OLLAMA_URL` | `http://localhost:11434` | Ollama API URL |
+| `OLLAMA_MODEL` | `nomic-embed-text` | Embedding model name |
+| `EMBEDDINGS_ENABLED` | `true` | Enable/disable semantic search |
+| `EMBEDDINGS_DB_PATH` | `./embeddings.db` | SQLite database path for embeddings |
+| `AUTH_HEADER` | `X-Oidc-Username` | HTTP header for authentication (can be any header your TiddlyWiki expects) |
+| `AUTH_USER` | `mcp-user` | Username for TiddlyWiki API requests |
+
+## Usage
+
+### stdio Mode (Claude Desktop)
+
+Add to your Claude Desktop configuration (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "tiddlywiki": {
+      "command": "node",
+      "args": ["/path/to/tiddlywiki-mcp/dist/index.js"],
+      "env": {
+        "TIDDLYWIKI_URL": "http://localhost:8080"
+      }
+    }
+  }
+}
+```
+
+### HTTP Mode
+
+Start the server:
+
+```bash
+TIDDLYWIKI_URL=http://localhost:8080 MCP_TRANSPORT=http MCP_PORT=3000 node dist/index.js
+```
+
+The server exposes:
+- `GET /health` - Health check endpoint
+- `POST /mcp` - MCP JSON-RPC endpoint (stateless mode)
+
+### Example Tool Usage
+
+**Filter search** (TiddlyWiki filter syntax):
+```json
+{
+  "name": "search_tiddlers",
+  "arguments": {
+    "filter": "[tag[Journal]prefix[2025-01]]",
+    "includeText": true
+  }
+}
+```
+
+**Semantic search** (natural language):
+```json
+{
+  "name": "search_tiddlers",
+  "arguments": {
+    "semantic": "times I felt anxious about work",
+    "limit": 10
+  }
+}
+```
+
+**Hybrid search** (filter + semantic reranking):
+```json
+{
+  "name": "search_tiddlers",
+  "arguments": {
+    "filter": "[tag[Journal]]",
+    "semantic": "productivity tips",
+    "limit": 20
+  }
+}
+```
+
+## Development
+
+### Setup
+
+```bash
+npm install
+```
+
+### Running Tests
+
+```bash
+npm test
+```
+
+Tests run quickly (~1s) and include unit tests for all tool handlers.
+
+### Linting
+
+```bash
+npm run lint        # Check for issues
+npm run format      # Fix formatting
+npm run format:check # Check formatting only
+```
+
+### Type Checking
+
+```bash
+npm run typecheck
+```
+
+### Pre-commit Hooks
+
+Pre-commit hooks are configured with lefthook and run automatically:
+
+1. Format check (Prettier)
+2. Lint (ESLint)
+3. Tests (Vitest)
+4. Type check (TypeScript)
+
+### Building
+
+```bash
+npm run build
+```
+
+## Architecture
+
+```
+src/
+├── index.ts              # Entry point, transport setup, server lifecycle
+├── tiddlywiki-http.ts    # TiddlyWiki HTTP API client
+├── service-discovery.ts  # URL resolution (direct URLs, Consul SRV, hostname:port)
+├── filter-reference.ts   # Filter syntax documentation
+├── logger.ts             # Structured logging
+├── tools/                # MCP tool handlers
+│   ├── types.ts          # Shared types and Zod schemas
+│   ├── search-tiddlers.ts
+│   ├── create-tiddler.ts
+│   ├── update-tiddler.ts
+│   └── delete-tiddler.ts
+└── embeddings/           # Semantic search infrastructure
+    ├── database.ts       # SQLite-vec database
+    ├── ollama-client.ts  # Ollama API client
+    └── sync-worker.ts    # Background embedding sync
+```
+
+### Key Design Decisions
+
+- **Stateless HTTP mode**: Each request gets its own Server/Transport instance to prevent request ID collisions with concurrent clients
+- **Graceful degradation**: Semantic search is optional; the server works without Ollama
+- **Token-aware responses**: Search results are validated against token limits with pagination suggestions
+- **Background sync**: Embeddings are updated periodically without blocking requests
+
+## License
+
+MIT

package/dist/embeddings/database.d.ts

@@ -0,0 +1,53 @@
+export interface EmbeddingMetadata {
+    created: string;
+    modified: string;
+    tags: string;
+}
+export interface SearchResult {
+    tiddler_title: string;
+    chunk_id: number;
+    chunk_text: string;
+    created: string;
+    modified: string;
+    tags: string;
+    distance: number;
+}
+export interface SyncStatus {
+    tiddler_title: string;
+    last_modified: string;
+    last_indexed: string;
+    total_chunks: number;
+    status: string;
+    error_message: string | null;
+}
+export declare class EmbeddingsDB {
+    private db;
+    private dbPath;
+    constructor(dbPath?: string);
+    private initSchema;
+    /**
+     * Migrate existing empty timestamps to sentinel value
+     * Fixes infinite re-indexing bug for tiddlers without modified timestamps
+     */
+    private migrateEmptyTimestamps;
+    /**
+     * Add status and error_message columns to sync_status table
+     * Enables tracking of empty/error tiddlers to prevent infinite re-indexing
+     */
+    private migrateAddStatusColumns;
+    insertEmbedding(tiddlerTitle: string, chunkId: number, embedding: number[], chunkText: string, metadata: EmbeddingMetadata): void;
+    searchSimilar(queryEmbedding: number[], limit?: number): SearchResult[];
+    updateSyncStatus(tiddlerTitle: string, lastModified: string, totalChunks: number, status?: string, errorMessage?: string | null): void;
+    getSyncStatus(tiddlerTitle: string): SyncStatus | null;
+    getAllSyncStatuses(): SyncStatus[];
+    getUnindexedTiddlers(tiddlerTitles: string[]): string[];
+    getOutdatedTiddlers(tiddlersWithModified: Array<{
+        title: string;
+        modified: string;
+    }>): string[];
+    deleteEmbeddingsForTiddler(tiddlerTitle: string): void;
+    getEmbeddingsCount(): number;
+    getIndexedTiddlersCount(): number;
+    close(): void;
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/embeddings/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/embeddings/database.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,GAAE,MAA4D;IAiBhF,OAAO,CAAC,UAAU;IAiClB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAmB/B,eAAe,CACb,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,iBAAiB,GAC1B,IAAI;IA2BP,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,KAAK,GAAE,MAAW,GAAG,YAAY,EAAE;IAqB3E,gBAAgB,CACd,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,MAAkB,EAC1B,YAAY,GAAE,MAAM,GAAG,IAAW,GACjC,IAAI;IASP,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAUtD,kBAAkB,IAAI,UAAU,EAAE;IAUlC,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAmBvD,mBAAmB,CAAC,oBAAoB,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,MAAM,EAAE;IAc/F,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IA8BtD,kBAAkB,IAAI,MAAM;IAQ5B,uBAAuB,IAAI,MAAM;IAQjC,KAAK,IAAI,IAAI;CAGd"}

package/dist/embeddings/database.js

@@ -0,0 +1,212 @@
+// ABOUTME: SQLite database for storing and querying vector embeddings
+// ABOUTME: Uses sqlite-vec for efficient similarity search operations
+import Database from 'better-sqlite3';
+import * as sqliteVec from 'sqlite-vec';
+export class EmbeddingsDB {
+    db;
+    dbPath;
+    constructor(dbPath = process.env.EMBEDDINGS_DB_PATH || './embeddings.db') {
+        this.dbPath = dbPath;
+        this.db = new Database(dbPath);
+        // Load sqlite-vec extension
+        sqliteVec.load(this.db);
+        // Initialize schema
+        this.initSchema();
+        // Migrate any existing empty timestamps to sentinel value
+        this.migrateEmptyTimestamps();
+        // Add status tracking columns if they don't exist
+        this.migrateAddStatusColumns();
+    }
+    initSchema() {
+        // Create vec0 virtual table for embeddings (vectors only)
+        this.db.exec(`
+      CREATE VIRTUAL TABLE IF NOT EXISTS entry_embeddings USING vec0(
+        embedding float[768]
+      );
+
+      CREATE TABLE IF NOT EXISTS embedding_metadata (
+        id INTEGER PRIMARY KEY,
+        tiddler_title TEXT NOT NULL,
+        chunk_id NOT NULL,
+        chunk_text TEXT NOT NULL,
+        created TEXT,
+        modified TEXT,
+        tags TEXT
+      );
+
+      CREATE TABLE IF NOT EXISTS sync_status (
+        tiddler_title TEXT PRIMARY KEY,
+        last_modified TEXT NOT NULL,
+        last_indexed TEXT NOT NULL,
+        total_chunks INTEGER NOT NULL DEFAULT 1,
+        indexed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_sync_status_modified
+        ON sync_status(last_modified);
+
+      CREATE INDEX IF NOT EXISTS idx_embedding_metadata_tiddler
+        ON embedding_metadata(tiddler_title);
+    `);
+    }
+    /**
+     * Migrate existing empty timestamps to sentinel value
+     * Fixes infinite re-indexing bug for tiddlers without modified timestamps
+     */
+    migrateEmptyTimestamps() {
+        const MISSING_TIMESTAMP = '00000000000000000';
+        const stmt = this.db.prepare(`
+      UPDATE sync_status
+      SET last_modified = ?
+      WHERE last_modified = ''
+    `);
+        const result = stmt.run(MISSING_TIMESTAMP);
+        if (result.changes > 0) {
+            console.log(`[DB Migration] Updated ${result.changes} entries with missing timestamps`);
+        }
+    }
+    /**
+     * Add status and error_message columns to sync_status table
+     * Enables tracking of empty/error tiddlers to prevent infinite re-indexing
+     */
+    migrateAddStatusColumns() {
+        // Check if status column exists
+        const tableInfo = this.db.prepare('PRAGMA table_info(sync_status)').all();
+        const hasStatus = tableInfo.some((col) => col.name === 'status');
+        if (!hasStatus) {
+            console.log('[DB Migration] Adding status and error_message columns to sync_status table');
+            this.db.exec(`
+        ALTER TABLE sync_status ADD COLUMN status TEXT NOT NULL DEFAULT 'indexed';
+        ALTER TABLE sync_status ADD COLUMN error_message TEXT;
+      `);
+            console.log('[DB Migration] Status columns added successfully');
+        }
+    }
+    insertEmbedding(tiddlerTitle, chunkId, embedding, chunkText, metadata) {
+        const embeddingArray = new Float32Array(embedding);
+        // Insert embedding into vec0 table
+        const embStmt = this.db.prepare(`
+      INSERT INTO entry_embeddings(rowid, embedding)
+      VALUES (NULL, ?)
+    `);
+        const embResult = embStmt.run(Buffer.from(embeddingArray.buffer));
+        const rowid = embResult.lastInsertRowid;
+        // Insert metadata into regular table with same rowid
+        const metaStmt = this.db.prepare(`
+      INSERT INTO embedding_metadata(id, tiddler_title, chunk_id, chunk_text, created, modified, tags)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `);
+        metaStmt.run(rowid, tiddlerTitle, chunkId, chunkText, metadata.created, metadata.modified, metadata.tags);
+    }
+    searchSimilar(queryEmbedding, limit = 10) {
+        const embeddingArray = new Float32Array(queryEmbedding);
+        const stmt = this.db.prepare(`
+      SELECT
+        m.tiddler_title,
+        m.chunk_id,
+        m.chunk_text,
+        m.created,
+        m.modified,
+        m.tags,
+        e.distance
+      FROM entry_embeddings e
+      JOIN embedding_metadata m ON e.rowid = m.id
+      WHERE e.embedding MATCH ?
+        AND k = ?
+    `);
+        return stmt.all(Buffer.from(embeddingArray.buffer), limit);
+    }
+    updateSyncStatus(tiddlerTitle, lastModified, totalChunks, status = 'indexed', errorMessage = null) {
+        const stmt = this.db.prepare(`
+      INSERT OR REPLACE INTO sync_status(tiddler_title, last_modified, last_indexed, total_chunks, status, error_message)
+      VALUES (?, ?, datetime('now'), ?, ?, ?)
+    `);
+        stmt.run(tiddlerTitle, lastModified, totalChunks, status, errorMessage);
+    }
+    getSyncStatus(tiddlerTitle) {
+        const stmt = this.db.prepare(`
+      SELECT tiddler_title, last_modified, last_indexed, total_chunks, status, error_message
+      FROM sync_status
+      WHERE tiddler_title = ?
+    `);
+        return stmt.get(tiddlerTitle);
+    }
+    getAllSyncStatuses() {
+        const stmt = this.db.prepare(`
+      SELECT tiddler_title, last_modified, last_indexed, total_chunks, status, error_message
+      FROM sync_status
+      ORDER BY tiddler_title
+    `);
+        return stmt.all();
+    }
+    getUnindexedTiddlers(tiddlerTitles) {
+        if (tiddlerTitles.length === 0) {
+            return [];
+        }
+        const _placeholders = tiddlerTitles.map(() => '?').join(',');
+        const stmt = this.db.prepare(`
+      SELECT ? as title
+      FROM (SELECT ? as title ${tiddlerTitles
+            .slice(1)
+            .map(() => 'UNION ALL SELECT ?')
+            .join(' ')})
+      WHERE title NOT IN (SELECT tiddler_title FROM sync_status)
+    `);
+        const results = stmt.all(...tiddlerTitles);
+        return results.map((r) => r.title);
+    }
+    getOutdatedTiddlers(tiddlersWithModified) {
+        const outdated = [];
+        for (const tiddler of tiddlersWithModified) {
+            const syncStatus = this.getSyncStatus(tiddler.title);
+            if (!syncStatus || syncStatus.last_modified !== tiddler.modified) {
+                outdated.push(tiddler.title);
+            }
+        }
+        return outdated;
+    }
+    deleteEmbeddingsForTiddler(tiddlerTitle) {
+        // Get all rowids for this tiddler from metadata table
+        const getRowids = this.db.prepare(`
+      SELECT id FROM embedding_metadata WHERE tiddler_title = ?
+    `);
+        const rows = getRowids.all(tiddlerTitle);
+        // Delete from embedding_metadata
+        const deleteMetadata = this.db.prepare(`
+      DELETE FROM embedding_metadata WHERE tiddler_title = ?
+    `);
+        deleteMetadata.run(tiddlerTitle);
+        // Delete from entry_embeddings using rowids
+        if (rows.length > 0) {
+            const deleteEmbeddings = this.db.prepare(`
+        DELETE FROM entry_embeddings WHERE rowid = ?
+      `);
+            for (const row of rows) {
+                deleteEmbeddings.run(row.id);
+            }
+        }
+        // Delete sync status
+        const deleteSyncStatus = this.db.prepare(`
+      DELETE FROM sync_status WHERE tiddler_title = ?
+    `);
+        deleteSyncStatus.run(tiddlerTitle);
+    }
+    getEmbeddingsCount() {
+        const stmt = this.db.prepare(`
+      SELECT COUNT(*) as count FROM entry_embeddings
+    `);
+        const result = stmt.get();
+        return result.count;
+    }
+    getIndexedTiddlersCount() {
+        const stmt = this.db.prepare(`
+      SELECT COUNT(*) as count FROM sync_status
+    `);
+        const result = stmt.get();
+        return result.count;
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=database.js.map

package/dist/embeddings/database.js.map

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

package/dist/embeddings/ollama-client.d.ts

@@ -0,0 +1,39 @@
+export declare class OllamaClient {
+    private serviceUrl;
+    private model;
+    private resolvedBaseUrl;
+    constructor(serviceUrl?: string, model?: string);
+    /**
+     * Get the resolved base URL, using service discovery if needed.
+     * Caches the result for subsequent calls.
+     */
+    private getBaseUrl;
+    generateEmbeddings(texts: string[]): Promise<number[][]>;
+    generateEmbedding(text: string): Promise<number[]>;
+    /**
+     * Generate embedding for a document with proper task prefix.
+     * Uses "search_document:" prefix as required by nomic-embed-text for RAG.
+     */
+    generateDocumentEmbedding(text: string): Promise<number[]>;
+    /**
+     * Generate embeddings for multiple documents with proper task prefix.
+     * Uses "search_document:" prefix as required by nomic-embed-text for RAG.
+     */
+    generateDocumentEmbeddings(texts: string[]): Promise<number[][]>;
+    /**
+     * Generate embedding for a query with proper task prefix.
+     * Uses "search_query:" prefix as required by nomic-embed-text for RAG.
+     */
+    generateQueryEmbedding(text: string): Promise<number[]>;
+    healthCheck(): Promise<boolean>;
+    /**
+     * Chunk text if it exceeds token limit.
+     * Splits at paragraph boundaries to maintain semantic coherence.
+     */
+    chunkText(text: string, maxTokens?: number): string[];
+    /**
+     * Count tokens in text using gpt-tokenizer (approximation for nomic-embed-text)
+     */
+    countTokens(text: string): number;
+}
+//# sourceMappingURL=ollama-client.d.ts.map

package/dist/embeddings/ollama-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-client.d.ts","sourceRoot":"","sources":["../../src/embeddings/ollama-client.ts"],"names":[],"mappings":"AA+CA,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,eAAe,CAAuB;gBAG5C,UAAU,GAAE,MAA2D,EACvE,KAAK,GAAE,MAAuD;IAMhE;;;OAGG;YACW,UAAU;IAQlB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAiCxD,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKxD;;;OAGG;IACG,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKhE;;;OAGG;IACG,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAKtE;;;OAGG;IACG,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKvD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAqBrC;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG,MAAM,EAAE;IAyE3D;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAGlC"}