@cryptoquant_official/mcp 0.0.5 → 0.0.6-alpha

package/dist/http/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * HTTP module - HTTP server and chat proxy
+ *
+ * Can be used as:
+ * 1. Standalone: node dist/http/index.js
+ * 2. Library: import { startHttpServer } from '@cryptoquant_official/mcp/http'
+ */
+export { startHttpServer, cleanupStaleSessions } from "./server.js";
+export { handleChat, getToolsSchema } from "./chat-proxy.js";
+export type { ChatRequest, ChatResponse, ToolCall } from "./chat-proxy.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG;AAKH,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/http/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/**
+ * HTTP module - HTTP server and chat proxy
+ *
+ * Can be used as:
+ * 1. Standalone: node dist/http/index.js
+ * 2. Library: import { startHttpServer } from '@cryptoquant_official/mcp/http'
+ */
+import { logger } from "../core/utils.js";
+// Re-exports for library usage
+export { startHttpServer, cleanupStaleSessions } from "./server.js";
+export { handleChat, getToolsSchema } from "./chat-proxy.js";
+/**
+ * HTTP server main entry point
+ */
+async function main() {
+    const { startHttpServer } = await import("./server.js");
+    await startHttpServer({
+        port: parseInt(process.env.MCP_HTTP_PORT ?? "3100", 10),
+        host: process.env.MCP_HTTP_HOST ?? "127.0.0.1",
+        corsOrigins: process.env.MCP_CORS_ORIGINS ?? "http://localhost:3000,http://localhost:5173",
+        enableLegacySse: process.env.MCP_ENABLE_LEGACY_SSE === "true",
+    });
+    logger.info("CryptoQuant HTTP Server started");
+}
+main().catch((error) => {
+    logger.error("Failed to start HTTP server:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,+BAA+B;AAC/B,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAG7D;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAExD,MAAM,eAAe,CAAC;QACpB,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,MAAM,EAAE,EAAE,CAAC;QACvD,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,WAAW;QAC9C,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,6CAA6C;QAC1F,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,MAAM;KAC9D,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;AACjD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/http/server.d.ts

@@ -0,0 +1,20 @@
+/**
+ * HTTP Transport Server for MCP
+ * Enables web applications to connect to the MCP server via HTTP/SSE
+ */
+interface HttpServerConfig {
+    port?: number;
+    host?: string;
+    corsOrigins?: string | string[];
+    enableLegacySse?: boolean;
+}
+/**
+ * Start HTTP server with Streamable HTTP transport
+ */
+export declare function startHttpServer(config?: HttpServerConfig): Promise<void>;
+/**
+ * Clean up stale sessions (older than 1 hour)
+ */
+export declare function cleanupStaleSessions(): void;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/http/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/http/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,UAAU,gBAAgB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAChC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA4BD;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqNlF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAW3C"}

package/dist/http/server.js

@@ -0,0 +1,231 @@
+/**
+ * HTTP Transport Server for MCP
+ * Enables web applications to connect to the MCP server via HTTP/SSE
+ */
+import express from "express";
+import cors from "cors";
+import rateLimit from "express-rate-limit";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import { randomUUID } from "crypto";
+import { registerAuthTools } from "../stdio/tools/auth.js";
+import { registerCoreTools } from "../stdio/tools/core.js";
+import { logger } from "../core/utils.js";
+import { handleChat, getToolsSchema } from "./chat-proxy.js";
+// Session storage for Streamable HTTP
+const sessions = new Map();
+// Legacy SSE transport storage - Map for multi-client support
+const legacySseSessions = new Map();
+/**
+ * Create and configure the MCP server instance
+ */
+function createMcpServer() {
+    const server = new McpServer({
+        name: "cryptoquant",
+        version: "1.0.0",
+    });
+    registerAuthTools(server);
+    registerCoreTools(server);
+    return server;
+}
+/**
+ * Start HTTP server with Streamable HTTP transport
+ */
+export async function startHttpServer(config = {}) {
+    const port = config.port ?? parseInt(process.env.MCP_HTTP_PORT ?? "3100", 10);
+    const host = config.host ?? process.env.MCP_HTTP_HOST ?? "127.0.0.1";
+    const corsOriginsRaw = config.corsOrigins ?? process.env.MCP_CORS_ORIGINS ?? "http://localhost:3000,http://localhost:5173";
+    // Parse comma-separated origins into array, or use as-is if already an array
+    const corsOrigins = Array.isArray(corsOriginsRaw)
+        ? corsOriginsRaw
+        : corsOriginsRaw.split(",").map((origin) => origin.trim());
+    const enableLegacySse = config.enableLegacySse ?? process.env.MCP_ENABLE_LEGACY_SSE === "true";
+    const app = express();
+    // Rate limiting - general limiter for all routes
+    const generalLimiter = rateLimit({
+        windowMs: 15 * 60 * 1000, // 15 minutes
+        max: 100, // 100 requests per 15 minutes
+        message: { error: "Too many requests, please try again later" },
+        standardHeaders: true,
+        legacyHeaders: false,
+    });
+    // Stricter rate limit for /chat endpoint (uses external API)
+    const chatLimiter = rateLimit({
+        windowMs: 15 * 60 * 1000, // 15 minutes
+        max: 30, // 30 requests per 15 minutes
+        message: { error: "Too many chat requests, please try again later" },
+        standardHeaders: true,
+        legacyHeaders: false,
+    });
+    // Middleware
+    app.use(generalLimiter);
+    app.use(cors({
+        origin: corsOrigins,
+        credentials: true,
+        exposedHeaders: ["mcp-session-id"],
+    }));
+    app.use(express.json());
+    // Health check endpoint - minimal info to avoid information disclosure
+    app.get("/health", (_req, res) => {
+        res.json({ status: "ok" });
+    });
+    // =========================================================================
+    // Chat Proxy Endpoints (Claude API Integration)
+    // =========================================================================
+    // POST /chat - Chat with Claude + automatic tool execution
+    app.post("/chat", chatLimiter, async (req, res) => {
+        const chatRequest = req.body;
+        if (!chatRequest.message) {
+            res.status(400).json({ error: "message is required" });
+            return;
+        }
+        if (!chatRequest.claude_api_key) {
+            res.status(400).json({ error: "claude_api_key is required" });
+            return;
+        }
+        try {
+            const result = await handleChat(chatRequest);
+            res.json(result);
+        }
+        catch (error) {
+            // Only log error message, not full error object to avoid leaking sensitive data
+            const errorMessage = error instanceof Error ? error.message : "Chat request failed";
+            logger.error("[/chat] error:", errorMessage);
+            res.status(500).json({
+                success: false,
+                error: errorMessage,
+            });
+        }
+    });
+    // GET /tools/schema - Get Claude-compatible tool definitions
+    app.get("/tools/schema", (_req, res) => {
+        res.json({
+            tools: getToolsSchema(),
+            usage: "Use these tool definitions with Claude API's tool_use feature",
+        });
+    });
+    // =========================================================================
+    // Streamable HTTP Transport (Modern)
+    // =========================================================================
+    // POST /mcp - Handle MCP requests
+    app.post("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        const session = sessionId ? sessions.get(sessionId) : undefined;
+        // Check if this is an initialization request
+        const isInit = isInitializeRequest(req.body);
+        if (isInit || !session) {
+            // Create new session
+            const newSessionId = randomUUID();
+            const server = createMcpServer();
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => newSessionId,
+                onsessioninitialized: (id) => {
+                    logger.info(`Session initialized: ${id}`);
+                    sessions.set(id, { transport, createdAt: Date.now() });
+                },
+            });
+            transport.onclose = () => {
+                logger.info(`Session closed: ${newSessionId}`);
+                sessions.delete(newSessionId);
+            };
+            await server.connect(transport);
+            await transport.handleRequest(req, res, req.body);
+        }
+        else {
+            // Use existing session
+            await session.transport.handleRequest(req, res, req.body);
+        }
+    });
+    // GET /mcp - SSE stream for server-to-client notifications
+    app.get("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        if (!sessionId) {
+            res.status(400).json({ error: "Missing mcp-session-id header" });
+            return;
+        }
+        const session = sessions.get(sessionId);
+        if (!session) {
+            res.status(404).json({ error: "Session not found" });
+            return;
+        }
+        await session.transport.handleRequest(req, res);
+    });
+    // DELETE /mcp - Close session
+    app.delete("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        if (!sessionId) {
+            res.status(400).json({ error: "Missing mcp-session-id header" });
+            return;
+        }
+        const session = sessions.get(sessionId);
+        if (!session) {
+            res.status(404).json({ error: "Session not found" });
+            return;
+        }
+        await session.transport.close();
+        sessions.delete(sessionId);
+        res.status(204).send();
+    });
+    // =========================================================================
+    // Legacy SSE Transport (for backwards compatibility)
+    // =========================================================================
+    if (enableLegacySse) {
+        // GET /sse - Establish SSE connection
+        app.get("/sse", async (_req, res) => {
+            const sessionId = randomUUID();
+            logger.info(`Legacy SSE connection requested: ${sessionId}`);
+            const server = createMcpServer();
+            // Include session ID in the messages endpoint path
+            const transport = new SSEServerTransport(`/messages?sessionId=${sessionId}`, res);
+            legacySseSessions.set(sessionId, transport);
+            transport.onclose = () => {
+                logger.info(`Legacy SSE connection closed: ${sessionId}`);
+                legacySseSessions.delete(sessionId);
+            };
+            await server.connect(transport);
+        });
+        // POST /messages - Handle client messages for legacy SSE
+        app.post("/messages", async (req, res) => {
+            const sessionId = req.query.sessionId;
+            if (!sessionId) {
+                res.status(400).json({ error: "Missing sessionId query parameter" });
+                return;
+            }
+            const transport = legacySseSessions.get(sessionId);
+            if (!transport) {
+                res.status(404).json({ error: "Session not found or expired" });
+                return;
+            }
+            await transport.handlePostMessage(req, res);
+        });
+    }
+    // Start server
+    app.listen(port, host, () => {
+        logger.info(`CryptoQuant MCP HTTP Server running at http://${host}:${port}`);
+        logger.info(`  - Chat Proxy: POST /chat`);
+        logger.info(`  - Tool Schema: GET /tools/schema`);
+        logger.info(`  - Streamable HTTP: POST/GET/DELETE /mcp`);
+        if (enableLegacySse) {
+            logger.info(`  - Legacy SSE: GET /sse, POST /messages`);
+        }
+    });
+}
+/**
+ * Clean up stale sessions (older than 1 hour)
+ */
+export function cleanupStaleSessions() {
+    const maxAge = 60 * 60 * 1000; // 1 hour
+    const now = Date.now();
+    for (const [id, session] of sessions) {
+        if (now - session.createdAt > maxAge) {
+            logger.info(`Cleaning up stale session: ${id}`);
+            session.transport.close();
+            sessions.delete(id);
+        }
+    }
+}
+// Run cleanup every 15 minutes
+setInterval(cleanupStaleSessions, 15 * 60 * 1000);
+//# sourceMappingURL=server.js.map

package/dist/http/server.js.map

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

package/dist/shared/metrics-data.generated.d.ts

@@ -0,0 +1,176 @@
+/**
+ * AUTO-GENERATED FILE - DO NOT EDIT DIRECTLY
+ *
+ * Generated by: npm run sync-skills
+ * Source files:
+ *   - skills/crypto/INTERPRETATION.md
+ *   - data/metrics.toon
+ *
+ * To update, edit the source files and run: npm run sync-skills
+ */
+export interface MetricThreshold {
+    range: string;
+    signal: "bullish" | "neutral" | "caution" | "bearish";
+    emoji: string;
+    meaning: string;
+}
+export interface ScoringRule {
+    condition: (value: number) => boolean;
+    score: number;
+}
+export interface MetricScoring {
+    weight: number;
+    rules: ScoringRule[];
+}
+export interface MetricDefinition {
+    id: string;
+    name: string;
+    category: string;
+    asset: string;
+    definition: string;
+    interpretation: string;
+    thresholds: MetricThreshold[];
+    keyInsights: string[];
+    endpoint: string;
+    scoring?: MetricScoring;
+}
+export declare const SIGNAL_LEGEND: {
+    readonly bullish: {
+        readonly emoji: "🟢";
+        readonly label: "Bullish / Buy opportunity";
+        readonly action: "Consider accumulating";
+    };
+    readonly neutral: {
+        readonly emoji: "🟡";
+        readonly label: "Neutral";
+        readonly action: "Hold / Wait for clearer signal";
+    };
+    readonly caution: {
+        readonly emoji: "🟠";
+        readonly label: "Caution";
+        readonly action: "Be cautious, potential reversal";
+    };
+    readonly bearish: {
+        readonly emoji: "🔴";
+        readonly label: "Bearish / Sell signal";
+        readonly action: "Consider reducing exposure";
+    };
+};
+export declare const METRIC_DEFINITIONS: Record<string, MetricDefinition>;
+export declare const SCORING_RULES: Record<string, MetricScoring>;
+/**
+ * Get metric definition by ID
+ */
+export declare function getMetricDefinition(metricId: string): MetricDefinition | undefined;
+/**
+ * Get all available metric IDs
+ */
+export declare function getAvailableMetrics(): string[];
+/**
+ * Calculate score for a metric value
+ */
+export declare function calculateScore(metricId: string, value: number): number;
+/**
+ * Calculate weighted trading signal score
+ */
+export declare function calculateTradingSignal(metrics: Record<string, number>): {
+    score: number;
+    signal: string;
+    confidence: number;
+};
+/**
+ * Get signal for a metric value
+ */
+export declare function getMetricSignal(metricId: string, value: number): {
+    signal: string;
+    emoji: string;
+    meaning: string;
+} | null;
+export declare const MARKET_THRESHOLDS: {
+    mvrv: {
+        bullish: {
+            max: number;
+        };
+        neutral: {
+            min: number;
+            max: number;
+        };
+        bearish: {
+            min: number;
+        };
+    };
+    sopr: {
+        bullish: {
+            max: number;
+        };
+        neutral: {
+            min: number;
+            max: number;
+        };
+        bearish: {
+            min: number;
+        };
+    };
+    netflow: {
+        bullish: {
+            max: number;
+        };
+        neutral: {
+            min: number;
+            max: number;
+        };
+        bearish: {
+            min: number;
+        };
+    };
+};
+export declare const WHALE_THRESHOLDS: {
+    ratio: {
+        retail: {
+            max: number;
+        };
+        mixed: {
+            min: number;
+            max: number;
+        };
+        whaleHeavy: {
+            min: number;
+            max: number;
+        };
+        whaleDominated: {
+            min: number;
+            max: number;
+        };
+        extreme: {
+            min: number;
+        };
+    };
+};
+export declare const CYCLE_PHASES: {
+    accumulation: {
+        name: string;
+        mvrv: string;
+        sopr: string;
+        netflow: string;
+    };
+    markupEarlyBull: {
+        name: string;
+        mvrv: string;
+        sopr: string;
+        netflow: string;
+    };
+    distribution: {
+        name: string;
+        mvrv: string;
+        sopr: string;
+        netflow: string;
+    };
+    markdownBear: {
+        name: string;
+        mvrv: string;
+        sopr: string;
+        netflow: string;
+    };
+};
+export declare const INTERPRETATION_SYSTEM_PROMPT = "\nYou are a crypto market analyst with access to CryptoQuant on-chain data.\n\n## Key Metrics Interpretation\n\n### Valuation (MVRV)\n- < 1.0: \uD83D\uDFE2 Undervalued (buy zone)\n- 1.0-2.5: \uD83D\uDFE1 Fair value\n- > 3.5: \uD83D\uDD34 Overheated (sell zone)\n\n### Profit Behavior (SOPR)\n- < 0.95: \uD83D\uDFE2 Capitulation (contrarian buy)\n- 0.95-1.05: \uD83D\uDFE1 Normal\n- > 1.10: \uD83D\uDD34 Heavy profit taking\n\n### Exchange Flows (Netflow)\n- < -1,000 BTC: \uD83D\uDFE2 Accumulation\n- \u00B11,000 BTC: \uD83D\uDFE1 Neutral\n- > +5,000 BTC: \uD83D\uDD34 Distribution\n\n### Funding Rate\n- < -0.03%: \uD83D\uDFE2 Shorts overcrowded\n- \u00B10.01%: \uD83D\uDFE1 Neutral\n- > 0.05%: \uD83D\uDD34 Longs overcrowded\n\n## Trading Signal Weights\n- MVRV: 30%\n- SOPR: 25%\n- Netflow: 25%\n- Funding: 20%\n\nScore > 70: BUY | 40-70: HOLD | < 40: SELL\n\n## Important Notes\n- No single metric is definitive - use multiple confirmations\n- Context matters - same values mean different things in bull vs bear\n- This is not financial advice - metrics are informational only\n";
+//# sourceMappingURL=metrics-data.generated.d.ts.map

package/dist/shared/metrics-data.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-data.generated.d.ts","sourceRoot":"","sources":["../../src/shared/metrics-data.generated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAMD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;CAKhB,CAAC;AAMX,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CA8yF/D,CAAC;AAWF,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CA0CvD,CAAC;AAMF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAElF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUtE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAwBvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO3D;AAMD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAI7B,CAAC;AAMF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;CAQ5B,CAAC;AAMF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;CAKxB,CAAC;AAMF,eAAO,MAAM,4BAA4B,+jCAqCxC,CAAC"}