observability-toolkit 1.0.0

package/README.md

@@ -0,0 +1,107 @@
+# @alyshia/observability-toolkit
+
+MCP server for observability tooling - query traces, metrics, and logs from local JSONL files or SigNoz Cloud for Claude Code sessions.
+
+## Installation
+
+```bash
+claude mcp add observability-toolkit -- npx -y @alyshia/observability-toolkit
+```
+
+Or for local development:
+
+```bash
+claude mcp add observability-toolkit -- node ~/.claude/mcp-servers/observability-toolkit/dist/server.js
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `obs_query_traces` | Query traces from local JSONL or SigNoz |
+| `obs_query_metrics` | Query metrics with aggregation support |
+| `obs_query_logs` | Query logs by severity, search text, trace ID |
+| `obs_health_check` | Check telemetry system health |
+| `obs_context_stats` | Get context window utilization stats |
+| `obs_get_trace_url` | Get SigNoz trace viewer URL |
+
+## Configuration
+
+Environment variables:
+
+- `TELEMETRY_DIR` - Local telemetry directory (default: `~/.claude/telemetry`)
+- `SIGNOZ_URL` - SigNoz instance URL (e.g., `https://ingest.us.signoz.cloud`)
+- `SIGNOZ_API_KEY` - SigNoz API key for authentication
+
+## Usage Examples
+
+### Query traces
+
+```
+obs_query_traces({ backend: "local", limit: 10 })
+obs_query_traces({ traceId: "abc123..." })
+obs_query_traces({ serviceName: "claude-code", minDurationMs: 100 })
+```
+
+### Query logs
+
+```
+obs_query_logs({ severity: "ERROR", limit: 20 })
+obs_query_logs({ search: "timeout", startDate: "2026-01-28" })
+obs_query_logs({ traceId: "abc123..." })
+```
+
+### Query metrics
+
+```
+obs_query_metrics({ metricName: "session.context.size" })
+obs_query_metrics({ metricName: "gen_ai.client.token.usage", aggregation: "sum" })
+```
+
+### Health check
+
+```
+obs_health_check({ verbose: true })
+```
+
+### Context stats
+
+```
+obs_context_stats({})
+obs_context_stats({ sessionId: "abc123...", includeCost: true })
+```
+
+### Get trace URL
+
+```
+obs_get_trace_url({ traceId: "abc123..." })
+```
+
+## Data Sources
+
+### Local JSONL
+
+Reads telemetry data from `~/.claude/telemetry/`:
+- `traces-YYYY-MM-DD.jsonl` - Trace spans
+- `logs-YYYY-MM-DD.jsonl` - Log records
+- `metrics-YYYY-MM-DD.jsonl` - Metric data points
+
+### SigNoz Cloud
+
+Queries SigNoz Cloud API when configured:
+- Traces: `/api/v3/traces`
+- Logs: `/api/v3/logs`
+- Metrics: `/api/v3/query_range`
+
+## Development
+
+```bash
+cd ~/.claude/mcp-servers/observability-toolkit
+npm install
+npm run build
+npm run start
+```
+
+## License
+
+MIT

package/dist/backends/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Backend interface for telemetry data sources
+ */
+export interface TraceSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind?: string;
+    startTimeUnixNano: number;
+    endTimeUnixNano?: number;
+    durationMs?: number;
+    status?: {
+        code: number;
+        message?: string;
+    };
+    attributes?: Record<string, unknown>;
+    events?: Array<{
+        name: string;
+        timestamp: number;
+        attributes?: Record<string, unknown>;
+    }>;
+}
+export interface LogRecord {
+    timestamp: string;
+    severity: string;
+    body: string;
+    traceId?: string;
+    spanId?: string;
+    attributes?: Record<string, unknown>;
+}
+export interface MetricDataPoint {
+    timestamp: string;
+    name: string;
+    value: number;
+    unit?: string;
+    attributes?: Record<string, unknown>;
+}
+export interface QueryOptions {
+    startDate?: string;
+    endDate?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface TraceQueryOptions extends QueryOptions {
+    traceId?: string;
+    serviceName?: string;
+    spanName?: string;
+    minDurationMs?: number;
+    maxDurationMs?: number;
+}
+export interface LogQueryOptions extends QueryOptions {
+    severity?: string;
+    search?: string;
+    traceId?: string;
+}
+export interface MetricQueryOptions extends QueryOptions {
+    metricName?: string;
+    aggregation?: 'sum' | 'avg' | 'min' | 'max' | 'count';
+    groupBy?: string[];
+}
+export interface TelemetryBackend {
+    name: string;
+    queryTraces(options: TraceQueryOptions): Promise<TraceSpan[]>;
+    queryLogs(options: LogQueryOptions): Promise<LogRecord[]>;
+    queryMetrics(options: MetricQueryOptions): Promise<MetricDataPoint[]>;
+    healthCheck(): Promise<{
+        status: 'ok' | 'error';
+        message?: string;
+    }>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;CAC3F;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IAEb,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC9D,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1D,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACtE,WAAW,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE"}

package/dist/backends/index.js

@@ -0,0 +1,5 @@
+/**
+ * Backend interface for telemetry data sources
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/backends/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backends/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/backends/local-jsonl.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Local JSONL backend for reading telemetry data from ~/.claude/telemetry/
+ *
+ * The local telemetry files use a flat JSONL format where each line is a complete
+ * span or log record, not the batched OpenTelemetry export format.
+ */
+import { TelemetryBackend, TraceSpan, LogRecord, MetricDataPoint, TraceQueryOptions, LogQueryOptions, MetricQueryOptions } from './index.js';
+export declare class LocalJsonlBackend implements TelemetryBackend {
+    name: string;
+    private telemetryDir;
+    constructor(telemetryDir?: string);
+    queryTraces(options: TraceQueryOptions): Promise<TraceSpan[]>;
+    queryLogs(options: LogQueryOptions): Promise<LogRecord[]>;
+    queryMetrics(options: MetricQueryOptions): Promise<MetricDataPoint[]>;
+    private aggregate;
+    healthCheck(): Promise<{
+        status: 'ok' | 'error';
+        message?: string;
+    }>;
+}
+//# sourceMappingURL=local-jsonl.d.ts.map

package/dist/backends/local-jsonl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-jsonl.d.ts","sourceRoot":"","sources":["../../src/backends/local-jsonl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAwKpB,qBAAa,iBAAkB,YAAW,gBAAgB;IACxD,IAAI,SAAiB;IACrB,OAAO,CAAC,YAAY,CAAS;gBAEjB,YAAY,CAAC,EAAE,MAAM;IAI3B,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAyC7D,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAoCzD,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAyC3E,OAAO,CAAC,SAAS;IAyDX,WAAW,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAqB3E"}

package/dist/backends/local-jsonl.js

@@ -0,0 +1,281 @@
+/**
+ * Local JSONL backend for reading telemetry data from ~/.claude/telemetry/
+ *
+ * The local telemetry files use a flat JSONL format where each line is a complete
+ * span or log record, not the batched OpenTelemetry export format.
+ */
+import { join } from 'path';
+import { TELEMETRY_DIR } from '../lib/constants.js';
+import { listFiles, readJsonlSync, parseDateFromFilename, getDateString, } from '../lib/file-utils.js';
+import { existsSync } from 'fs';
+/**
+ * Convert flat span to normalized TraceSpan
+ */
+function normalizeSpan(raw) {
+    if (!raw.traceId || !raw.spanId || !raw.name)
+        return null;
+    // Convert [seconds, nanoseconds] to nanoseconds
+    const startTimeUnixNano = raw.startTime
+        ? raw.startTime[0] * 1_000_000_000 + raw.startTime[1]
+        : 0;
+    const endTimeUnixNano = raw.endTime
+        ? raw.endTime[0] * 1_000_000_000 + raw.endTime[1]
+        : undefined;
+    // Calculate duration in ms
+    let durationMs;
+    if (raw.duration) {
+        durationMs = (raw.duration[0] * 1000) + (raw.duration[1] / 1_000_000);
+    }
+    else if (endTimeUnixNano) {
+        durationMs = (endTimeUnixNano - startTimeUnixNano) / 1_000_000;
+    }
+    // Add service name to attributes if present in resource
+    const attributes = { ...raw.attributes };
+    if (raw.resource?.serviceName) {
+        attributes['service.name'] = raw.resource.serviceName;
+    }
+    if (raw.resource?.serviceVersion) {
+        attributes['service.version'] = raw.resource.serviceVersion;
+    }
+    return {
+        traceId: raw.traceId,
+        spanId: raw.spanId,
+        parentSpanId: raw.parentSpanId,
+        name: raw.name,
+        kind: raw.kind !== undefined ? ['INTERNAL', 'SERVER', 'CLIENT', 'PRODUCER', 'CONSUMER'][raw.kind] : undefined,
+        startTimeUnixNano,
+        endTimeUnixNano,
+        durationMs,
+        status: raw.status?.code !== undefined ? { code: raw.status.code, message: raw.status.message } : undefined,
+        attributes,
+    };
+}
+/**
+ * Convert flat log to normalized LogRecord
+ */
+function normalizeLog(raw) {
+    const attributes = { ...raw.attributes };
+    if (raw.resource?.serviceName) {
+        attributes['service.name'] = raw.resource.serviceName;
+    }
+    // Handle timestamp: either ISO string or [seconds, nanoseconds] array
+    let timestamp;
+    if (Array.isArray(raw.timestamp)) {
+        const ms = raw.timestamp[0] * 1000 + Math.floor(raw.timestamp[1] / 1_000_000);
+        timestamp = new Date(ms).toISOString();
+    }
+    else {
+        timestamp = raw.timestamp;
+    }
+    return {
+        timestamp,
+        severity: raw.severityText || raw.severity || 'INFO',
+        body: raw.body || '',
+        traceId: raw.traceId,
+        spanId: raw.spanId,
+        attributes,
+    };
+}
+/**
+ * Convert flat metric to normalized MetricDataPoint
+ */
+function normalizeMetric(raw) {
+    const attributes = { ...raw.attributes };
+    if (raw.resource?.serviceName) {
+        attributes['service.name'] = raw.resource.serviceName;
+    }
+    return {
+        timestamp: raw.timestamp,
+        name: raw.name,
+        value: raw.value,
+        unit: raw.unit,
+        attributes,
+    };
+}
+/**
+ * Get files within date range
+ */
+function getFilesInRange(dir, pattern, startDate, endDate) {
+    const files = listFiles(dir, pattern);
+    if (!startDate && !endDate) {
+        // Default to today only
+        const today = getDateString();
+        return files.filter(f => {
+            const date = parseDateFromFilename(f);
+            return date === today;
+        });
+    }
+    return files.filter(f => {
+        const date = parseDateFromFilename(f);
+        if (!date)
+            return false;
+        if (startDate && date < startDate)
+            return false;
+        if (endDate && date > endDate)
+            return false;
+        return true;
+    });
+}
+export class LocalJsonlBackend {
+    name = 'local-jsonl';
+    telemetryDir;
+    constructor(telemetryDir) {
+        this.telemetryDir = telemetryDir || TELEMETRY_DIR;
+    }
+    async queryTraces(options) {
+        const files = getFilesInRange(this.telemetryDir, /traces-\d{4}-\d{2}-\d{2}\.jsonl$/, options.startDate, options.endDate);
+        const results = [];
+        const limit = options.limit || 100;
+        const offset = options.offset || 0;
+        for (const file of files) {
+            // Read flat span records (one per line)
+            const spans = readJsonlSync(file);
+            for (const raw of spans) {
+                const span = normalizeSpan(raw);
+                if (!span)
+                    continue;
+                // Apply filters
+                if (options.traceId && span.traceId !== options.traceId)
+                    continue;
+                if (options.spanName && !span.name.includes(options.spanName))
+                    continue;
+                if (options.minDurationMs && (span.durationMs || 0) < options.minDurationMs)
+                    continue;
+                if (options.maxDurationMs && (span.durationMs || Infinity) > options.maxDurationMs)
+                    continue;
+                if (options.serviceName) {
+                    const svc = span.attributes?.['service.name'];
+                    if (svc !== options.serviceName)
+                        continue;
+                }
+                results.push(span);
+                if (results.length >= offset + limit) {
+                    return results.slice(offset, offset + limit);
+                }
+            }
+        }
+        return results.slice(offset, offset + limit);
+    }
+    async queryLogs(options) {
+        const files = getFilesInRange(this.telemetryDir, /logs-\d{4}-\d{2}-\d{2}\.jsonl$/, options.startDate, options.endDate);
+        const results = [];
+        const limit = options.limit || 100;
+        const offset = options.offset || 0;
+        for (const file of files) {
+            // Read flat log records (one per line)
+            const logs = readJsonlSync(file);
+            for (const raw of logs) {
+                const log = normalizeLog(raw);
+                if (!log)
+                    continue;
+                // Apply filters
+                if (options.severity && log.severity.toUpperCase() !== options.severity.toUpperCase())
+                    continue;
+                if (options.traceId && log.traceId !== options.traceId)
+                    continue;
+                if (options.search && !log.body.toLowerCase().includes(options.search.toLowerCase()))
+                    continue;
+                results.push(log);
+                if (results.length >= offset + limit) {
+                    return results.slice(offset, offset + limit);
+                }
+            }
+        }
+        return results.slice(offset, offset + limit);
+    }
+    async queryMetrics(options) {
+        const files = getFilesInRange(this.telemetryDir, /metrics-\d{4}-\d{2}-\d{2}\.jsonl$/, options.startDate, options.endDate);
+        const results = [];
+        const limit = options.limit || 100;
+        const offset = options.offset || 0;
+        for (const file of files) {
+            // Read flat metric records (one per line)
+            const metrics = readJsonlSync(file);
+            for (const raw of metrics) {
+                const point = normalizeMetric(raw);
+                if (!point)
+                    continue;
+                // Apply filters
+                if (options.metricName && !point.name.includes(options.metricName))
+                    continue;
+                results.push(point);
+                if (results.length >= offset + limit) {
+                    break;
+                }
+            }
+            if (results.length >= offset + limit)
+                break;
+        }
+        // Apply aggregation if requested
+        if (options.aggregation && results.length > 0) {
+            return this.aggregate(results, options.aggregation, options.groupBy);
+        }
+        return results.slice(offset, offset + limit);
+    }
+    aggregate(points, aggregation, groupBy) {
+        // Group by metric name and optional attributes
+        const groups = new Map();
+        for (const point of points) {
+            let key = point.name;
+            if (groupBy) {
+                for (const attr of groupBy) {
+                    const val = point.attributes?.[attr];
+                    if (val !== undefined)
+                        key += `|${attr}=${val}`;
+                }
+            }
+            const group = groups.get(key) || [];
+            group.push(point);
+            groups.set(key, group);
+        }
+        // Aggregate each group
+        const results = [];
+        for (const [, group] of groups) {
+            const values = group.map(p => p.value);
+            let value;
+            switch (aggregation) {
+                case 'sum':
+                    value = values.reduce((a, b) => a + b, 0);
+                    break;
+                case 'avg':
+                    value = values.reduce((a, b) => a + b, 0) / values.length;
+                    break;
+                case 'min':
+                    value = Math.min(...values);
+                    break;
+                case 'max':
+                    value = Math.max(...values);
+                    break;
+                case 'count':
+                    value = values.length;
+                    break;
+            }
+            results.push({
+                timestamp: group[group.length - 1].timestamp,
+                name: group[0].name,
+                value,
+                unit: group[0].unit,
+                attributes: group[0].attributes,
+            });
+        }
+        return results;
+    }
+    async healthCheck() {
+        if (!existsSync(this.telemetryDir)) {
+            return { status: 'error', message: `Telemetry directory not found: ${this.telemetryDir}` };
+        }
+        const today = getDateString();
+        const tracesFile = join(this.telemetryDir, `traces-${today}.jsonl`);
+        const logsFile = join(this.telemetryDir, `logs-${today}.jsonl`);
+        const hasTraces = existsSync(tracesFile);
+        const hasLogs = existsSync(logsFile);
+        if (!hasTraces && !hasLogs) {
+            return { status: 'ok', message: `No telemetry files for today (${today})` };
+        }
+        return {
+            status: 'ok',
+            message: `Found: ${hasTraces ? 'traces' : ''}${hasTraces && hasLogs ? ', ' : ''}${hasLogs ? 'logs' : ''} for ${today}`,
+        };
+    }
+}
+//# sourceMappingURL=local-jsonl.js.map

package/dist/backends/local-jsonl.js.map

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

package/dist/backends/signoz-api.d.ts

@@ -0,0 +1,28 @@
+/**
+ * SigNoz Cloud API backend for querying traces, metrics, and logs
+ */
+import { TelemetryBackend, TraceSpan, LogRecord, MetricDataPoint, TraceQueryOptions, LogQueryOptions, MetricQueryOptions } from './index.js';
+export declare class SigNozApiBackend implements TelemetryBackend {
+    name: string;
+    private baseUrl;
+    private apiKey;
+    private circuitBreaker;
+    constructor(baseUrl?: string, apiKey?: string);
+    private fetch;
+    /**
+     * Get nanosecond timestamp for SigNoz queries
+     */
+    private getNanoTime;
+    queryTraces(options: TraceQueryOptions): Promise<TraceSpan[]>;
+    queryLogs(options: LogQueryOptions): Promise<LogRecord[]>;
+    queryMetrics(options: MetricQueryOptions): Promise<MetricDataPoint[]>;
+    healthCheck(): Promise<{
+        status: 'ok' | 'error';
+        message?: string;
+    }>;
+    /**
+     * Get SigNoz trace viewer URL for a trace ID
+     */
+    getTraceUrl(traceId: string): string;
+}
+//# sourceMappingURL=signoz-api.d.ts.map

package/dist/backends/signoz-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signoz-api.d.ts","sourceRoot":"","sources":["../../src/backends/signoz-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAkDpB,qBAAa,gBAAiB,YAAW,gBAAgB;IACvD,IAAI,SAAgB;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAA2B;gBAErC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;YAK/B,KAAK;IAkCnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOb,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAuF7D,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAsEzD,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA+DrE,WAAW,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAyB1E;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CASrC"}