spectra-referee-mcp 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,71 @@
-# Temporary Holding Version
+# @spectra/mcp-server — Model Context Protocol Server
+
+> Dual-instrument visual referee for AI coding agents via stdio JSON-RPC 2.0.
+
+Spectra MCP Server enables AI coding agents (Muse Code, Claude Code, Cursor, Devin) to visually verify UI changes and catch subtle occlusions using Meta SAM 3.1 and deterministic pixel template matching.
+
+---
+
+## 1-Command Zero-Config Setup
+
+### Muse Code / Claude Code (stdio)
+Add to your project's `.mcp.json` (auto-detected when opening this workspace):
+
+```json
+{
+  "mcpServers": {
+    "spectra": {
+      "command": "node",
+      "args": ["packages/mcp-server/dist/index.js"],
+      "env": {
+        "SPECTRA_OFFLINE_DEFAULT": "true"
+      }
+    }
+  }
+}
+```
+
+Or register globally via Claude CLI:
+```bash
+claude mcp add spectra -- node /absolute/path/to/packages/mcp-server/dist/index.js
+```
+
+### Cursor IDE
+Add to `.cursor/mcp.json`:
+```json
+{
+  "mcpServers": {
+    "spectra": {
+      "command": "node",
+      "args": ["packages/mcp-server/dist/index.js"],
+      "env": {
+        "SPECTRA_OFFLINE_DEFAULT": "true"
+      }
+    }
+  }
+}
+```
+
+---
+
+## Exposed Bounded Tools (4)
+
+| Tool | Purpose | Key Arguments | Auto-Resolution |
+|---|---|---|---|
+| `spectra_verify` | Optical verification on video or frame pair | `targetLabel` + `videoPath` (or `t0FramePath` + `tkFramePath`) | Zero-BBox auto-detection from SAM Frame 0 |
+| `spectra_check` | Batch check against visual invariant suite | `invariantsPath`, `manifestPath`, `cachedSamDir` | Verifies full clip manifest |
+| `spectra_compile_invariant` | Natural language / audio into `.spectra/invariants.json` | `outputPath`, `transcriptText` or `audioPath` | Invariant compiler |
+| `spectra_closed_loop` | Autonomous 4-phase Reject -> Patch -> Re-Verify loop | `scenario` (`s1`, `s2`, `s3`, `all`) | S1 (Canvas), S2 (Mobile), S3 (Catch) |
+
+---
+
+## API Key & Economy Tiers ($0.00 Replay)
+
+| Mode | API Keys Needed | Cost | Latency |
+|---|---|---|---|
+| **Cached Mode (Default)** | **None ($0.00)** | **$0.00** | **~480ms** |
+| **Live Uncached SAM 3.1** | `META_API_KEY` | Per-token | ~4.5s |
+| **Live Baseten VLM** | `BASETEN_API_KEY` | Per-token | ~5.7s |
+
+All 45 benchmark clips and S1–S3 closed-loop demos replay with **zero API spend ($0.00)**.
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.

package/dist/__tests__/mcp-server.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-server.test.d.ts.map

package/dist/__tests__/mcp-server.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/mcp-server.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/mcp-server.test.js

@@ -0,0 +1,312 @@
+import path from 'node:path';
+import readline from 'node:readline';
+import { PassThrough } from 'node:stream';
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { SpectraMcpServer, extractBBoxFromSamFrame0, findRepoRoot } from '../index.js';
+function findProjectRoot() {
+    return findRepoRoot();
+}
+class McpTestClient {
+    inStream;
+    outStream;
+    server;
+    pending = new Map();
+    nextId = 1;
+    constructor() {
+        this.inStream = new PassThrough();
+        this.outStream = new PassThrough();
+        this.server = new SpectraMcpServer();
+        this.server.listen(this.inStream, this.outStream);
+        const rl = readline.createInterface({ input: this.outStream, terminal: false });
+        rl.on('line', (line) => {
+            const trimmed = line.trim();
+            if (!trimmed)
+                return;
+            try {
+                const parsed = JSON.parse(trimmed);
+                if (typeof parsed.id === 'number' && this.pending.has(parsed.id)) {
+                    const resolver = this.pending.get(parsed.id);
+                    this.pending.delete(parsed.id);
+                    resolver(parsed);
+                }
+            }
+            catch {
+                // ignore unparseable lines in stream listener
+            }
+        });
+    }
+    request(method, params) {
+        const id = this.nextId++;
+        return new Promise((resolve) => {
+            this.pending.set(id, resolve);
+            this.inStream.write(JSON.stringify({ jsonrpc: '2.0', id, method, params }) + '\n');
+        });
+    }
+    notify(method, params) {
+        this.inStream.write(JSON.stringify({ jsonrpc: '2.0', method, params }) + '\n');
+    }
+    sendRaw(raw) {
+        return new Promise((resolve) => {
+            this.outStream.once('data', (d) => {
+                resolve(d.toString());
+            });
+            this.inStream.write(raw + '\n');
+        });
+    }
+    close() {
+        this.server.close();
+        this.inStream.end();
+        this.outStream.end();
+    }
+}
+describe('@spectra/mcp-server - End-to-End Stdio Protocol Integration Tests ($0.00 Spend)', () => {
+    const root = findProjectRoot();
+    let client;
+    beforeEach(() => {
+        client = new McpTestClient();
+    });
+    afterEach(() => {
+        client.close();
+    });
+    describe('Protocol Lifecycle & Discovery', () => {
+        it('handles initialize handshake with server capabilities and protocol version', async () => {
+            const res = await client.request('initialize', {
+                protocolVersion: '2024-11-05',
+                capabilities: {},
+                clientInfo: { name: 'test-agent', version: '1.0' },
+            });
+            expect(res.jsonrpc).toBe('2.0');
+            expect(res.error).toBeUndefined();
+            expect(res.result).toBeDefined();
+            expect(res.result?.protocolVersion).toBe('2024-11-05');
+            expect(res.result?.serverInfo.name).toBe('spectra-mcp');
+            expect(res.result?.capabilities.tools).toBeDefined();
+        });
+        it('acknowledges notifications/initialized without errors', () => {
+            expect(() => {
+                client.notify('notifications/initialized');
+            }).not.toThrow();
+        });
+        it('lists all 4 bounded Spectra tools with schemas in tools/list', async () => {
+            const res = await client.request('tools/list');
+            expect(res.error).toBeUndefined();
+            expect(res.result?.tools).toBeDefined();
+            expect(res.result?.tools).toHaveLength(4);
+            const toolNames = res.result?.tools.map((t) => t.name);
+            expect(toolNames).toContain('spectra_verify');
+            expect(toolNames).toContain('spectra_check');
+            expect(toolNames).toContain('spectra_compile_invariant');
+            expect(toolNames).toContain('spectra_closed_loop');
+            const verifyTool = res.result?.tools.find((t) => t.name === 'spectra_verify');
+            expect(verifyTool?.description).toContain('Dual-Instrument Referee');
+            expect(verifyTool?.inputSchema.properties.t0FramePath).toBeDefined();
+            expect(verifyTool?.inputSchema.properties.tkFramePath).toBeDefined();
+            expect(verifyTool?.inputSchema.properties.targetBBox).toBeDefined();
+            expect(verifyTool?.inputSchema.properties.videoPath).toBeDefined();
+            expect(verifyTool?.inputSchema.required).toEqual(['targetLabel']);
+        });
+    });
+    describe('tools/call: spectra_verify', () => {
+        it('verifies canvas_000_v1 (0% clean control) returning verdict === "pass" and pixelLossCount === 0', async () => {
+            const t0Path = path.join(root, 'benchmark/clips/canvas_000_v1_t0.png');
+            const tkPath = path.join(root, 'benchmark/clips/canvas_000_v1_tk.png');
+            const samPath = path.join(root, 'benchmark/responses/phase2-smoke/canvas_000_v1_sam.json');
+            const res = await client.request('tools/call', {
+                name: 'spectra_verify',
+                arguments: {
+                    clipId: 'canvas_000_v1',
+                    t0FramePath: t0Path,
+                    tkFramePath: tkPath,
+                    targetLabel: 'Revenue Series Legend',
+                    targetBBox: { x: 820, y: 240, width: 220, height: 48 },
+                    cachedSamResponsePath: samPath,
+                },
+            });
+            expect(res.error).toBeUndefined();
+            expect(res.result?.isError).toBe(false);
+            expect(res.result?.content[0]?.type).toBe('text');
+            const data = JSON.parse(res.result?.content[0]?.text || '{}');
+            expect(data.verdict).toBe('pass');
+            expect(data.rSam).toBeGreaterThan(0.98);
+            expect(data.visRatio).toBe(1.0);
+            expect(data.pixelLossCount).toBe(0);
+            expect(data.threshold).toBeCloseTo(0.0135, 4);
+            expect(data.calibrated).toBe(true);
+            expect(data.reason).toContain('VERIFIED:');
+            expect(data.resolvedBBox).toBeDefined();
+            expect(data.decisionExplanation).toBeDefined();
+            expect(data.decisionExplanation.ruleFired).toBe('RULE_4_THREE_SIGMA_CLEAN_PASS');
+            expect(data.decisionExplanation.marginToThreshold).toBeLessThanOrEqual(0);
+        });
+        it('catches dom_catch_010_v1 (10% occlusion) returning verdict === "fail" and pixelLossCount > 0', async () => {
+            const t0Path = path.join(root, 'benchmark/clips/dom_catch_010_v1_t0.png');
+            const tkPath = path.join(root, 'benchmark/clips/dom_catch_010_v1_tk.png');
+            const samPath = path.join(root, 'benchmark/responses/phase2-smoke/dom_catch_010_v1_sam.json');
+            const res = await client.request('tools/call', {
+                name: 'spectra_verify',
+                arguments: {
+                    clipId: 'dom_catch_010_v1',
+                    t0FramePath: t0Path,
+                    tkFramePath: tkPath,
+                    targetLabel: 'Complete Checkout',
+                    targetBBox: { x: 910, y: 600, width: 340, height: 50 },
+                    cachedSamResponsePath: samPath,
+                },
+            });
+            expect(res.error).toBeUndefined();
+            expect(res.result?.isError).toBe(false);
+            const data = JSON.parse(res.result?.content[0]?.text || '{}');
+            expect(data.verdict).toBe('fail');
+            expect(data.pixelLossCount).toBe(1700);
+            expect(data.pixelLossCount).toBeGreaterThan(0);
+            expect(data.visRatio).toBe(0.9);
+            expect(data.rSam).toBeCloseTo(0.908, 2);
+            expect(data.reason).toContain('REJECTED: Visibility loss 9.60% exceeds threshold');
+            expect(data.repairActionRequired).toBe(true);
+            expect(data.decisionExplanation).toBeDefined();
+            expect(data.decisionExplanation.ruleFired).toBe('RULE_3_THREE_SIGMA_OCCLUSION_REJECT');
+            expect(data.decisionExplanation.marginToThreshold).toBeGreaterThan(0);
+        });
+        // Test 1: Zero-BBox and Zero-PNG resolution with videoPath only (canvas_000_v1)
+        it('verifies canvas_000_v1 with ONLY videoPath and targetLabel (zero-bbox auto-resolution)', async () => {
+            const res = await client.request('tools/call', {
+                name: 'spectra_verify',
+                arguments: {
+                    videoPath: 'benchmark/clips/canvas_000_v1.mp4',
+                    targetLabel: 'Revenue Series Legend',
+                },
+            });
+            expect(res.error).toBeUndefined();
+            expect(res.result?.isError).toBe(false);
+            const data = JSON.parse(res.result?.content[0]?.text || '{}');
+            expect(data.verdict).toBe('pass');
+            expect(data.rSam).toBeCloseTo(0.9912, 3);
+            expect(data.resolvedBBox).toBeDefined();
+            expect(data.resolvedBBox.x).toBe(820);
+            expect(data.resolvedBBox.y).toBe(240);
+            expect(data.resolvedBBox.width).toBe(220);
+            expect(data.resolvedBBox.height).toBe(48);
+            expect(data.bboxSource).toBe('manifest');
+        });
+        // Test 2: Zero-BBox and Zero-PNG resolution with videoPath only (dom_catch_010_v1)
+        it('catches dom_catch_010_v1 with ONLY videoPath and targetLabel returning fail and pixelLossCount === 1700', async () => {
+            const res = await client.request('tools/call', {
+                name: 'spectra_verify',
+                arguments: {
+                    videoPath: 'benchmark/clips/dom_catch_010_v1.mp4',
+                    targetLabel: 'Complete Checkout',
+                },
+            });
+            expect(res.error).toBeUndefined();
+            expect(res.result?.isError).toBe(false);
+            const data = JSON.parse(res.result?.content[0]?.text || '{}');
+            expect(data.verdict).toBe('fail');
+            expect(data.pixelLossCount).toBe(1700);
+            expect(data.repairActionRequired).toBe(true);
+            expect(data.resolvedBBox).toBeDefined();
+            expect(data.resolvedBBox.x).toBe(910);
+            expect(data.resolvedBBox.y).toBe(600);
+            expect(data.resolvedBBox.width).toBe(340);
+            expect(data.resolvedBBox.height).toBe(50);
+            expect(data.bboxSource).toBe('manifest');
+        });
+    });
+    describe('SAM Frame 0 Bounding Box Extraction', () => {
+        // Test 3: Direct unit test for extractBBoxFromSamFrame0
+        it('extracts valid non-empty bounding box from SAM 3.1 Frame 0 raster mask directly', () => {
+            const samPath = path.join(root, 'benchmark/responses/phase2-smoke/dom_catch_010_v1_sam.json');
+            const bbox = extractBBoxFromSamFrame0(samPath);
+            expect(bbox).not.toBeNull();
+            expect(bbox?.x).toBeGreaterThan(0);
+            expect(bbox?.y).toBeGreaterThan(0);
+            expect(bbox?.width).toBeGreaterThan(0);
+            expect(bbox?.height).toBeGreaterThan(0);
+            expect(bbox?.x).toBe(909);
+            expect(bbox?.y).toBe(600);
+            expect(bbox?.width).toBe(342);
+            expect(bbox?.height).toBe(51);
+        });
+    });
+    describe('tools/call: spectra_closed_loop', () => {
+        // Test 4: Closed-loop referee invocation over MCP stdio
+        it('executes closed loop referee over stdio for scenario s3 returning closedLoopSuccess === true', async () => {
+            const res = await client.request('tools/call', {
+                name: 'spectra_closed_loop',
+                arguments: {
+                    scenario: 's3',
+                },
+            });
+            expect(res.error).toBeUndefined();
+            expect(res.result?.isError).toBe(false);
+            const data = JSON.parse(res.result?.content[0]?.text || '{}');
+            expect(data.closedLoopSuccess).toBe(true);
+            expect(data.scenario).toBe('s3');
+            expect(data.pass1).toBeDefined();
+            expect(data.pass1.combinedVerdict).toBe('fail');
+            expect(data.repair).toBeDefined();
+            expect(data.pass2).toBeDefined();
+            expect(data.pass2.combinedVerdict).toBe('pass');
+        });
+    });
+    describe('tools/call: spectra_compile_invariant and spectra_check', () => {
+        it('compiles voice expectation from cached voice smoke directory', async () => {
+            const cachedDir = path.join(root, 'benchmark/responses/voice-smoke');
+            const res = await client.request('tools/call', {
+                name: 'spectra_compile_invariant',
+                arguments: {
+                    cachedDir,
+                },
+            });
+            expect(res.error).toBeUndefined();
+            expect(res.result?.isError).toBe(false);
+            const data = JSON.parse(res.result?.content[0]?.text || '{}');
+            expect(data.success).toBe(true);
+            expect(data.invariantsCount).toBe(2);
+            expect(data.document.invariants[0].id).toBe('complete-checkout-button-visible');
+        });
+        it('checks invariants across manifest returning BenchmarkReport', async () => {
+            const invariantsPath = path.join(root, '.spectra/invariants.json');
+            const manifestPath = path.join(root, 'benchmark/manifest.json');
+            const cachedSamDir = path.join(root, 'benchmark/responses/phase2-smoke');
+            const res = await client.request('tools/call', {
+                name: 'spectra_check',
+                arguments: {
+                    invariantsPath,
+                    manifestPath,
+                    cachedSamDir,
+                },
+            });
+            expect(res.error).toBeUndefined();
+            expect(res.result?.isError).toBe(false);
+            const data = JSON.parse(res.result?.content[0]?.text || '{}');
+            expect(data.overallVerdict).toBe('fail');
+            expect(data.results.length).toBe(45);
+            expect(data.passed).toBeGreaterThan(0);
+            expect(data.failed).toBeGreaterThan(0);
+        });
+    });
+    describe('Error Handling', () => {
+        it('returns JSON-RPC error -32601 for unknown methods', async () => {
+            const res = await client.request('unknown/method');
+            expect(res.error).toBeDefined();
+            expect(res.error?.code).toBe(-32601);
+            expect(res.error?.message).toContain('Method not found');
+        });
+        it('returns isError: true when a tool call fails (e.g. unknown tool or missing file)', async () => {
+            const res = await client.request('tools/call', {
+                name: 'non_existent_tool',
+                arguments: {},
+            });
+            expect(res.result?.isError).toBe(true);
+            const data = JSON.parse(res.result?.content[0]?.text || '{}');
+            expect(data.error).toContain('Unknown tool');
+        });
+        it('handles raw invalid JSON with parse error -32700', async () => {
+            const rawRes = await client.sendRaw('INVALID_JSON_LINE');
+            const parsed = JSON.parse(rawRes);
+            expect(parsed.error.code).toBe(-32700);
+            expect(parsed.error.message).toContain('Parse error');
+        });
+    });
+});
+//# sourceMappingURL=mcp-server.test.js.map

package/dist/__tests__/mcp-server.test.js.map

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

package/dist/__tests__/resolver-validation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolver-validation.test.d.ts.map

package/dist/__tests__/resolver-validation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver-validation.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/resolver-validation.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/resolver-validation.test.js

@@ -0,0 +1,38 @@
+import { describe, it, expect } from 'vitest';
+import { normalizeBBox, resolveVerifyInputs } from '../auto-resolver.js';
+describe('@spectra/mcp-server - resolver input validation ($0.00 Spend)', () => {
+    it('accepts valid bboxes and rounds fractional pixels', () => {
+        expect(normalizeBBox([10.4, 20.5, 30.6, 40.1])).toEqual({
+            x: 10,
+            y: 21,
+            width: 31,
+            height: 40,
+        });
+        expect(normalizeBBox({ x: 1, y: 2, width: 3, height: 4 })).toEqual({
+            x: 1,
+            y: 2,
+            width: 3,
+            height: 4,
+        });
+    });
+    it('rejects non-finite, negative, and malformed bboxes', () => {
+        expect(() => normalizeBBox([0, 0, Number.POSITIVE_INFINITY, 10])).toThrow('Invalid targetBBox');
+        expect(() => normalizeBBox([0, 0, Number.NaN, 10])).toThrow('Invalid targetBBox');
+        expect(() => normalizeBBox([-1, 0, 10, 10])).toThrow('Invalid targetBBox');
+        expect(() => normalizeBBox([0, 0, 10])).toThrow('Invalid targetBBox');
+    });
+    it('rejects non-finite and negative tolerance', () => {
+        const base = {
+            t0FramePath: 'a_t0.png',
+            tkFramePath: 'a_tk.png',
+            targetLabel: 'btn',
+            targetBBox: [0, 0, 10, 10],
+        };
+        expect(() => resolveVerifyInputs({ ...base, tolerance: Number.NaN })).toThrow('Invalid tolerance');
+        expect(() => resolveVerifyInputs({ ...base, tolerance: -1 })).toThrow('Invalid tolerance');
+        expect(() => resolveVerifyInputs({ ...base, tolerance: Number.POSITIVE_INFINITY })).toThrow('Invalid tolerance');
+        const ok = resolveVerifyInputs({ ...base, tolerance: 5 });
+        expect(ok.tolerance).toBe(5);
+    });
+});
+//# sourceMappingURL=resolver-validation.test.js.map

package/dist/__tests__/resolver-validation.test.js.map

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

package/dist/auto-resolver.d.ts

@@ -0,0 +1,29 @@
+import type { BoundingBox } from '@spectra/core';
+export interface RawVerifyToolArgs {
+    videoPath?: string;
+    t0FramePath?: string;
+    tkFramePath?: string;
+    targetLabel: string;
+    targetBBox?: BoundingBox | [number, number, number, number];
+    cachedSamResponsePath?: string;
+    tolerance?: number;
+}
+export interface ResolvedVerifyInputs {
+    videoPath?: string;
+    t0FramePath: string;
+    tkFramePath: string;
+    targetLabel: string;
+    targetBBox: BoundingBox;
+    bboxSource: 'caller' | 'sam-frame-0' | 'manifest';
+    cachedSamResponsePath?: string;
+    tolerance?: number;
+    cleanupTempFrames: () => void;
+}
+export declare function findRepoRoot(startDir?: string): string;
+export declare function normalizeBBox(input: BoundingBox | [number, number, number, number]): BoundingBox;
+/**
+ * Extracts tight pixel bounding box { x, y, width, height } from Frame 0 of a SAM 3.1 response JSON.
+ */
+export declare function extractBBoxFromSamFrame0(samJsonPath: string): BoundingBox | null;
+export declare function resolveVerifyInputs(args: RawVerifyToolArgs): ResolvedVerifyInputs;
+//# sourceMappingURL=auto-resolver.d.ts.map

package/dist/auto-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-resolver.d.ts","sourceRoot":"","sources":["../src/auto-resolver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5D,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,WAAW,CAAC;IACxB,UAAU,EAAE,QAAQ,GAAG,aAAa,GAAG,UAAU,CAAC;IAClD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED,wBAAgB,YAAY,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAcrE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,CAmBhG;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA+GhF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,oBAAoB,CA2JjF"}