@decispher/mcp-server 0.1.0

package/dist/decispher-client.js

@@ -0,0 +1,219 @@
+import { randomUUID } from 'node:crypto';
+export class DecispherClient {
+    baseUrl;
+    apiKey;
+    companyId;
+    sessionId;
+    /** Notices from the most recent envelope, surfaced by tools.ts in `_meta`. */
+    lastNotices = null;
+    constructor() {
+        this.baseUrl = process.env['DECISPHER_API_URL'] ?? 'http://localhost:3000';
+        this.apiKey = process.env['DECISPHER_API_KEY'] ?? '';
+        this.companyId = process.env['DECISPHER_COMPANY_ID'] ?? '';
+        this.sessionId = process.env['DECISPHER_SESSION_ID'] ?? randomUUID();
+        if (!this.apiKey || !this.companyId) {
+            throw new Error('DECISPHER_API_KEY and DECISPHER_COMPANY_ID environment variables are required');
+        }
+    }
+    async searchDecisions(query, options) {
+        const response = await this.post(`/api/companies/${this.companyId}/mcp/search-decisions`, {
+            query,
+            ...(options?.limit !== undefined ? { limit: options.limit } : {}),
+            ...(options?.types ? { types: options.types } : {}),
+        });
+        const data = await this.unwrap(response);
+        return data?.results ?? [];
+    }
+    async getConstraints(options) {
+        const response = await this.post(`/api/companies/${this.companyId}/mcp/get-constraints`, {
+            ...(options?.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),
+            ...(options?.cursor !== undefined ? { cursor: options.cursor } : {}),
+            ...(options?.expand ? { expand: options.expand } : {}),
+        });
+        const data = await this.unwrap(response);
+        return data?.constraints ?? [];
+    }
+    async getConventions(options) {
+        const response = await this.post(`/api/companies/${this.companyId}/mcp/check-conventions`, {
+            ...(options?.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),
+            ...(options?.cursor !== undefined ? { cursor: options.cursor } : {}),
+            ...(options?.expand ? { expand: options.expand } : {}),
+        });
+        const data = await this.unwrap(response);
+        return data?.conventions ?? [];
+    }
+    async ask(query) {
+        const response = await this.post(`/api/companies/${this.companyId}/mcp/ask-knowledge-base`, { query });
+        const data = await this.unwrap(response);
+        if (!data) {
+            const status = response.ok ? 'empty response' : `HTTP ${response.status}`;
+            throw new Error(`ask_knowledge_base: Decispher API unreachable or returned an error (${status}). Cannot answer from knowledge base.`);
+        }
+        return data;
+    }
+    async getDecision(decisionId) {
+        const response = await this.post(`/api/companies/${this.companyId}/mcp/get-decision`, { decisionId });
+        const data = await this.unwrap(response);
+        if (!data) {
+            const status = response.ok ? 'empty response' : `HTTP ${response.status}`;
+            throw new Error(`get_decision: Decispher API returned an error (${status}) for decision ${decisionId}.`);
+        }
+        return data;
+    }
+    async checkIntent(description, files) {
+        const response = await this.post(`/api/companies/${this.companyId}/mcp/check-intent`, { description, files });
+        const data = await this.unwrap(response);
+        if (!data) {
+            const status = response.ok ? 'empty response' : `HTTP ${response.status}`;
+            throw new Error(`check_intent: Decispher API unreachable or returned an error (${status}). Cannot verify intent — do not proceed without manual review.`);
+        }
+        return data;
+    }
+    async getContextForFiles(files, options) {
+        const response = await this.post(`/api/companies/${this.companyId}/mcp/get-context-for-file`, {
+            files: files.map((f) => ({
+                filePath: f.filePath,
+                ...(f.fileContent !== undefined ? { fileContent: f.fileContent } : {}),
+                ...(f.language !== undefined ? { language: f.language } : {}),
+            })),
+            ...(options?.limit !== undefined ? { limit: options.limit } : {}),
+        });
+        const data = await this.unwrap(response);
+        return data?.matches ?? [];
+    }
+    async getContextForFile(filePath, options) {
+        const response = await this.post(`/api/companies/${this.companyId}/mcp/get-context-for-file`, {
+            filePath,
+            ...(options?.fileContent !== undefined ? { fileContent: options.fileContent } : {}),
+            ...(options?.language !== undefined ? { language: options.language } : {}),
+            ...(options?.limit !== undefined ? { limit: options.limit } : {}),
+        });
+        const data = await this.unwrap(response);
+        return data?.matches ?? [];
+    }
+    async listTopics() {
+        const response = await this.post(`/api/companies/${this.companyId}/mcp/list-topics`, {});
+        const data = await this.unwrap(response);
+        return data?.topics ?? [];
+    }
+    async getContextForTopic(topic, options) {
+        const response = await this.post(`/api/companies/${this.companyId}/mcp/get-context-for-topic`, {
+            topic,
+            ...(options?.includeBodies !== undefined ? { includeBodies: options.includeBodies } : {}),
+            ...(options?.maxTokens !== undefined ? { maxTokens: options.maxTokens } : {}),
+        });
+        if (response.status === 404) {
+            throw new Error(`get_context_for_topic: topic "${topic}" not found in this project's scope. Call list_topics for the available set.`);
+        }
+        const data = await this.unwrap(response);
+        if (!data) {
+            const status = response.ok ? 'empty response' : `HTTP ${response.status}`;
+            throw new Error(`get_context_for_topic: Decispher API returned an error (${status}).`);
+        }
+        return data;
+    }
+    async captureDecision(input) {
+        const response = await this.post(`/api/companies/${this.companyId}/mcp/capture-decision`, input);
+        if (response.status === 403) {
+            throw new Error('capture_decision: agent capture is disabled by the company administrator.');
+        }
+        if (response.status === 429) {
+            const retryAfterMs = Number(response.headers.get('retry-after-ms') ?? '0');
+            throw new Error(`capture_decision: rate limit exceeded — retry in ~${Math.ceil(retryAfterMs / 1000)}s.`);
+        }
+        const data = await this.unwrap(response);
+        if (!data) {
+            const status = response.ok ? 'empty response' : `HTTP ${response.status}`;
+            throw new Error(`capture_decision: Decispher API returned an error (${status}).`);
+        }
+        return data;
+    }
+    /**
+     * Probe `/api/mcp/health` before the first tool call — no auth required.
+     * Returns null on any network/parse failure so the caller can fall through
+     * to the static tool list instead of crashing the MCP server at startup.
+     */
+    async fetchHealth() {
+        try {
+            const response = await fetch(`${this.baseUrl}/api/mcp/health`, { method: 'GET' });
+            if (!response.ok)
+                return null;
+            return (await response.json());
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Pull the tool registry from the server. Returns null if the request fails
+     * or the response shape is unrecognised — caller falls back to the embedded
+     * static tool list so the MCP server still works offline / against an older
+     * API that does not yet expose `/capabilities`.
+     */
+    async fetchCapabilities() {
+        try {
+            const response = await fetch(`${this.baseUrl}/api/companies/${this.companyId}/mcp/capabilities`, { method: 'GET', headers: this.headers() });
+            if (!response.ok)
+                return null;
+            const parsed = (await response.json());
+            if (!parsed || !Array.isArray(parsed.tools) || !parsed.apiKey || typeof parsed.apiVersion !== 'string') {
+                return null;
+            }
+            return parsed;
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Parse an MCP envelope; transparently passes through legacy un-wrapped responses. */
+    async unwrap(response) {
+        if (!response.ok) {
+            this.lastNotices = null;
+            return null;
+        }
+        let parsed;
+        try {
+            parsed = await response.json();
+        }
+        catch {
+            this.lastNotices = null;
+            return null;
+        }
+        if (this.isEnvelope(parsed)) {
+            this.lastNotices = {
+                truncated: parsed.budget?.truncated ?? false,
+                citationCount: parsed.citations?.length ?? 0,
+            };
+            return (parsed.data ?? null);
+        }
+        this.lastNotices = null;
+        return parsed;
+    }
+    isEnvelope(value) {
+        if (typeof value !== 'object' || value === null)
+            return false;
+        const v = value;
+        return 'data' in v && 'meta' in v && 'budget' in v;
+    }
+    async post(path, body) {
+        try {
+            return await fetch(`${this.baseUrl}${path}`, {
+                method: 'POST',
+                headers: this.headers(),
+                body: JSON.stringify(body),
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`Decispher API unreachable at ${this.baseUrl} — ${msg}`);
+        }
+    }
+    headers() {
+        return {
+            'Content-Type': 'application/json',
+            'x-api-key': this.apiKey,
+            'x-decispher-session-id': this.sessionId,
+        };
+    }
+}
+//# sourceMappingURL=decispher-client.js.map

package/dist/decispher-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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":""}

package/dist/index.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { DecispherClient } from './decispher-client.js';
+import { registerTools } from './tools.js';
+async function resolveRegistration(client) {
+    const caps = await client.fetchCapabilities();
+    if (!caps) {
+        process.stderr.write('Decispher MCP: /capabilities unreachable — registering embedded tool list.\n');
+        return {};
+    }
+    const enabledTools = new Set(caps.tools.map((t) => t.name));
+    const descriptions = Object.fromEntries(caps.tools.map((t) => [t.name, t.description]));
+    process.stderr.write(`Decispher MCP: loaded ${caps.tools.length} tools from /capabilities (apiVersion=${caps.apiVersion}).\n`);
+    return { enabledTools, descriptions };
+}
+async function main() {
+    const client = new DecispherClient();
+    const server = new McpServer({
+        name: 'decispher',
+        version: '0.1.0',
+    });
+    const options = await resolveRegistration(client);
+    registerTools(server, client, options);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    process.stderr.write(`Decispher MCP server error: ${String(error)}\n`);
+    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":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAA6B,MAAM,YAAY,CAAC;AAEtE,KAAK,UAAU,mBAAmB,CAAC,MAAuB;IACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,iBAAiB,EAAE,CAAC;IAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,OAAO,CAAC,MAAM,CAAC,KAAK,CAChB,8EAA8E,CACjF,CAAC;QACF,OAAO,EAAE,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACxF,OAAO,CAAC,MAAM,CAAC,KAAK,CAChB,yBAAyB,IAAI,CAAC,KAAK,CAAC,MAAM,yCAAyC,IAAI,CAAC,UAAU,MAAM,CAC3G,CAAC;IACF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;AAC1C,CAAC;AAED,KAAK,UAAU,IAAI;IACf,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IAErC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QACzB,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACnB,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAClD,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/lib/file-reader.d.ts

@@ -0,0 +1,29 @@
+/**
+ * WS-F — Client-side file reader for `get_context_for_file`.
+ *
+ * Reads the file from the developer's disk before calling the API so the
+ * server can embed the actual source (not just the path). Cap at 256 KB;
+ * over-cap files are sliced head-then-tail and flagged `truncated: true` so
+ * the server-side `FileSkeletonBuilder` (tree-sitter / regex extractors,
+ * WS-A) still has a representative chunk to extract symbols from.
+ *
+ * Binary files and unreadable paths return `null` — the caller passes only
+ * the path and the API falls back to path-only embedding (the legacy
+ * behaviour). We never throw out of this module: a bad file read should
+ * degrade gracefully, not surface as an MCP tool error to the agent.
+ */
+export declare const DEFAULT_FILE_READ_MAX_BYTES: number;
+export interface FileReadResult {
+    readonly content: string;
+    readonly language: string | null;
+    readonly truncated: boolean;
+    readonly bytesRead: number;
+}
+export interface FileReadOptions {
+    readonly maxBytes?: number;
+    /** Override the working directory used for resolving relative paths. */
+    readonly cwd?: string;
+}
+export declare function detectLanguage(filePath: string): string | null;
+export declare function readFileForContext(filePath: string, opts?: FileReadOptions): Promise<FileReadResult | null>;
+//# sourceMappingURL=file-reader.d.ts.map

package/dist/lib/file-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-reader.d.ts","sourceRoot":"","sources":["../../src/lib/file-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,eAAO,MAAM,2BAA2B,QAAa,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACzB;AAmCD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE9D;AAiBD,wBAAsB,kBAAkB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,eAAoB,GAC3B,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA4DhC"}

package/dist/lib/file-reader.js

@@ -0,0 +1,126 @@
+/**
+ * WS-F — Client-side file reader for `get_context_for_file`.
+ *
+ * Reads the file from the developer's disk before calling the API so the
+ * server can embed the actual source (not just the path). Cap at 256 KB;
+ * over-cap files are sliced head-then-tail and flagged `truncated: true` so
+ * the server-side `FileSkeletonBuilder` (tree-sitter / regex extractors,
+ * WS-A) still has a representative chunk to extract symbols from.
+ *
+ * Binary files and unreadable paths return `null` — the caller passes only
+ * the path and the API falls back to path-only embedding (the legacy
+ * behaviour). We never throw out of this module: a bad file read should
+ * degrade gracefully, not surface as an MCP tool error to the agent.
+ */
+import { promises as fs } from 'node:fs';
+import { resolve, extname } from 'node:path';
+export const DEFAULT_FILE_READ_MAX_BYTES = 256 * 1024;
+const TRUNCATION_MARKER = '\n\n/* … truncated by MCP file-reader … */\n\n';
+const TRUNCATION_MARKER_BYTES = Buffer.byteLength(TRUNCATION_MARKER, 'utf8');
+const HEAD_FRACTION = 0.75;
+const UTF8_BOM = '';
+// Extension → language tag understood by tree-sitter-wasms on the server.
+// Anything unknown returns null and the server falls back to regex extractors.
+const EXTENSION_TO_LANGUAGE = {
+    '.ts': 'typescript',
+    '.tsx': 'tsx',
+    '.cts': 'typescript',
+    '.mts': 'typescript',
+    '.js': 'javascript',
+    '.jsx': 'javascript',
+    '.cjs': 'javascript',
+    '.mjs': 'javascript',
+    '.py': 'python',
+    '.pyi': 'python',
+    '.go': 'go',
+    '.rs': 'rust',
+    '.java': 'java',
+    '.rb': 'ruby',
+    '.php': 'php',
+    '.cs': 'csharp',
+    '.kt': 'kotlin',
+    '.swift': 'swift',
+    '.c': 'c',
+    '.h': 'c',
+    '.cc': 'cpp',
+    '.cpp': 'cpp',
+    '.hpp': 'cpp',
+};
+export function detectLanguage(filePath) {
+    return EXTENSION_TO_LANGUAGE[extname(filePath).toLowerCase()] ?? null;
+}
+function looksBinary(sample) {
+    // Heuristic identical to git's: a NUL byte anywhere in the first 8 KB
+    // means it's binary. Catches images / archives / compiled binaries
+    // without misclassifying UTF-8 source code with multi-byte runes.
+    const probeLength = Math.min(sample.length, 8 * 1024);
+    for (let i = 0; i < probeLength; i++) {
+        if (sample[i] === 0x00)
+            return true;
+    }
+    return false;
+}
+function stripBom(text) {
+    return text.startsWith(UTF8_BOM) ? text.slice(UTF8_BOM.length) : text;
+}
+export async function readFileForContext(filePath, opts = {}) {
+    const maxBytes = opts.maxBytes ?? DEFAULT_FILE_READ_MAX_BYTES;
+    const absolute = resolve(opts.cwd ?? process.cwd(), filePath);
+    let stat;
+    try {
+        stat = await fs.stat(absolute);
+    }
+    catch {
+        return null;
+    }
+    if (!stat.isFile())
+        return null;
+    const size = stat.size;
+    const language = detectLanguage(filePath);
+    let handle;
+    try {
+        handle = await fs.open(absolute, 'r');
+    }
+    catch {
+        return null;
+    }
+    try {
+        if (size <= maxBytes) {
+            const buf = Buffer.alloc(size);
+            await handle.read(buf, 0, size, 0);
+            if (looksBinary(buf))
+                return null;
+            return {
+                content: stripBom(buf.toString('utf8')),
+                language,
+                truncated: false,
+                bytesRead: size,
+            };
+        }
+        // Reserve room for the marker so the emitted string stays ≤ maxBytes —
+        // the server route caps fileContent at exactly 256 KB and rejects more.
+        const budget = Math.max(maxBytes - TRUNCATION_MARKER_BYTES, 0);
+        const headBytes = Math.floor(budget * HEAD_FRACTION);
+        const tailBytes = budget - headBytes;
+        const head = Buffer.alloc(headBytes);
+        await handle.read(head, 0, headBytes, 0);
+        if (looksBinary(head))
+            return null;
+        const tail = Buffer.alloc(tailBytes);
+        await handle.read(tail, 0, tailBytes, size - tailBytes);
+        const content = stripBom(head.toString('utf8')) + TRUNCATION_MARKER + tail.toString('utf8');
+        return {
+            content,
+            language,
+            truncated: true,
+            bytesRead: Buffer.byteLength(content, 'utf8'),
+        };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        await handle.close().catch(() => { });
+    }
+}
+//# sourceMappingURL=file-reader.js.map

package/dist/lib/file-reader.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,41 @@
+import { type ZodTypeAny } from 'zod';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { DecispherClient } from './decispher-client.js';
+declare function buildResult(text: string, client: DecispherClient, extraMeta?: Record<string, unknown>): {
+    _meta?: Record<string, unknown> | undefined;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+type ToolHandler = (args: Record<string, unknown>, client: DecispherClient) => Promise<ReturnType<typeof buildResult>>;
+interface ToolDefinition {
+    readonly name: string;
+    readonly defaultDescription: string;
+    readonly inputSchema: Record<string, ZodTypeAny>;
+    readonly handler: ToolHandler;
+}
+/**
+ * Tool definitions — input schemas + handlers live here because the wire
+ * protocol with the MCP runtime is typed via Zod and the call body shapes
+ * are code-defined. Descriptions can be overridden at registration time by
+ * the server's /capabilities response (WS-E) so docs and gating live in
+ * one place server-side, but the executable bits stay client-side.
+ */
+export declare const TOOL_DEFINITIONS: ReadonlyArray<ToolDefinition>;
+export interface RegisterToolsOptions {
+    /**
+     * Filter to tools the server's /capabilities response advertised. When
+     * provided, any tool whose name isn't in this list is skipped. When
+     * omitted, all known tools are registered (offline-safe fallback).
+     */
+    readonly enabledTools?: ReadonlySet<string>;
+    /**
+     * Per-tool description override — server's /capabilities response wins so
+     * the agent sees the canonical copy maintained server-side.
+     */
+    readonly descriptions?: Readonly<Record<string, string>>;
+}
+export declare function registerTools(server: McpServer, client: DecispherClient, options?: RegisterToolsOptions): void;
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EACR,eAAe,EAElB,MAAM,uBAAuB,CAAC;AAQ/B,iBAAS,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;EAgB9F;AAED,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC;AAEvH,UAAU,cAAc;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CACjC;AAwDD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC,cAAc,CAuP1D,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACjC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5C;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5D;AAED,wBAAgB,aAAa,CACzB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,oBAAyB,GACnC,IAAI,CAiBN"}