evidential-protocol 1.0.0

package/dist/tests/protocol.test.js

@@ -0,0 +1,374 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { CONFIDENCE_FLOORS, CLASS_STRENGTH, CLASS_WEIGHTS, evidence, claim, response, mcpTag, weakerClass, strongerClass, degradedClass, isExpired, computeTrustScore, parseContentMarker, extractMarkers, formatTrustDisplay, classifyTool, validateEvidence, validateResponse, validateMcpTag, wrapToolResult, buildAgentResponse, directClaim, inferredClaim, reportedClaim, conjectureClaim, inheritClaim, verifyClaim, checkDegradation, applyDegradation, } from "../index.js";
+// ---------------------------------------------------------------------------
+// Types & Constants
+// ---------------------------------------------------------------------------
+describe("Constants", () => {
+    it("confidence floors are ordered correctly", () => {
+        assert.ok(CONFIDENCE_FLOORS.direct > CONFIDENCE_FLOORS.inferred);
+        assert.ok(CONFIDENCE_FLOORS.inferred > CONFIDENCE_FLOORS.reported);
+        assert.ok(CONFIDENCE_FLOORS.reported > CONFIDENCE_FLOORS.conjecture);
+    });
+    it("class strength is ordered correctly", () => {
+        assert.ok(CLASS_STRENGTH.direct > CLASS_STRENGTH.inferred);
+        assert.ok(CLASS_STRENGTH.inferred > CLASS_STRENGTH.reported);
+        assert.ok(CLASS_STRENGTH.reported > CLASS_STRENGTH.conjecture);
+    });
+    it("class weights are ordered correctly", () => {
+        assert.ok(CLASS_WEIGHTS.direct > CLASS_WEIGHTS.inferred);
+        assert.ok(CLASS_WEIGHTS.inferred > CLASS_WEIGHTS.reported);
+        assert.ok(CLASS_WEIGHTS.reported > CLASS_WEIGHTS.conjecture);
+    });
+});
+// ---------------------------------------------------------------------------
+// Schema Builders
+// ---------------------------------------------------------------------------
+describe("evidence()", () => {
+    it("builds with defaults", () => {
+        const ev = evidence("direct", "solana-rpc");
+        assert.equal(ev.class, "direct");
+        assert.equal(ev.source, "solana-rpc");
+        assert.equal(ev.confidence, 0.9);
+        assert.ok(ev.timestamp);
+    });
+    it("accepts overrides", () => {
+        const ev = evidence("inferred", "log-analysis", {
+            confidence: 0.8,
+            reasoning: "pattern match",
+        });
+        assert.equal(ev.confidence, 0.8);
+        assert.equal(ev.reasoning, "pattern match");
+    });
+});
+describe("claim()", () => {
+    it("builds a claim with evidence", () => {
+        const c = claim("balance is 2.5 SOL", evidence("direct", "rpc"));
+        assert.equal(c.claim, "balance is 2.5 SOL");
+        assert.equal(c.evidence.class, "direct");
+    });
+    it("includes refs when provided", () => {
+        const c = claim("test", evidence("direct", "rpc"), ["ref1", "ref2"]);
+        assert.deepEqual(c.refs, ["ref1", "ref2"]);
+    });
+});
+describe("response()", () => {
+    it("builds a full response with aggregates", () => {
+        const claims = [
+            directClaim("fact A", "rpc"),
+            conjectureClaim("guess B", "model", "no data"),
+        ];
+        const resp = response("test-agent", { ok: true }, claims);
+        assert.equal(resp.ep_version, "1.0");
+        assert.equal(resp.producer, "test-agent");
+        assert.equal(resp.aggregate_class, "conjecture"); // lowest wins
+        assert.equal(resp.claims.length, 2);
+    });
+});
+describe("mcpTag()", () => {
+    it("builds an MCP evidence tag", () => {
+        const tag = mcpTag("direct", "solana-rpc:getBalance", { ttl: 30 });
+        assert.equal(tag.ep_version, "1.0");
+        assert.equal(tag.class, "direct");
+        assert.equal(tag.ttl, 30);
+    });
+});
+// ---------------------------------------------------------------------------
+// Class Utilities
+// ---------------------------------------------------------------------------
+describe("weakerClass()", () => {
+    it("returns the weaker class", () => {
+        assert.equal(weakerClass("direct", "conjecture"), "conjecture");
+        assert.equal(weakerClass("inferred", "reported"), "reported");
+        assert.equal(weakerClass("direct", "direct"), "direct");
+    });
+});
+describe("strongerClass()", () => {
+    it("returns the stronger class", () => {
+        assert.equal(strongerClass("direct", "conjecture"), "direct");
+        assert.equal(strongerClass("reported", "inferred"), "inferred");
+    });
+});
+// ---------------------------------------------------------------------------
+// Degradation
+// ---------------------------------------------------------------------------
+describe("degradedClass()", () => {
+    it("does not degrade fresh direct evidence", () => {
+        const ev = evidence("direct", "rpc", { ttl: 3600 });
+        assert.equal(degradedClass(ev), "direct");
+    });
+    it("degrades expired direct to reported", () => {
+        const past = new Date(Date.now() - 120_000).toISOString(); // 2min ago
+        const ev = evidence("direct", "rpc", { ttl: 60, timestamp: past }); // 60s TTL
+        assert.equal(degradedClass(ev), "reported");
+    });
+    it("degrades 25h-old direct to reported", () => {
+        const past = new Date(Date.now() - 25 * 3600_000).toISOString();
+        const ev = evidence("direct", "rpc", { timestamp: past });
+        assert.equal(degradedClass(ev), "reported");
+    });
+    it("degrades 25h-old reported to conjecture", () => {
+        const past = new Date(Date.now() - 25 * 3600_000).toISOString();
+        const ev = evidence("reported", "api", {
+            confidence: 0.5,
+            timestamp: past,
+        });
+        assert.equal(degradedClass(ev), "conjecture");
+    });
+});
+describe("isExpired()", () => {
+    it("returns false when no TTL", () => {
+        assert.equal(isExpired(evidence("direct", "rpc")), false);
+    });
+    it("returns true when past TTL", () => {
+        const past = new Date(Date.now() - 120_000).toISOString();
+        assert.equal(isExpired(evidence("direct", "rpc", { ttl: 60, timestamp: past })), true);
+    });
+});
+// ---------------------------------------------------------------------------
+// Trust Score
+// ---------------------------------------------------------------------------
+describe("computeTrustScore()", () => {
+    it("returns 0 for empty claims", () => {
+        const score = computeTrustScore([]);
+        assert.equal(score.score, 0);
+        assert.equal(score.requires_review, true);
+    });
+    it("computes high score for all-direct claims", () => {
+        const claims = [directClaim("a", "rpc"), directClaim("b", "rpc")];
+        const score = computeTrustScore(claims);
+        assert.ok(score.score > 0.8);
+        assert.equal(score.requires_review, false);
+    });
+    it("flags low-trust responses for review", () => {
+        const claims = [
+            conjectureClaim("guess", "model", "no data"),
+            conjectureClaim("another guess", "model", "still no data"),
+        ];
+        const score = computeTrustScore(claims);
+        assert.ok(score.score < 0.5);
+        assert.equal(score.requires_review, true);
+    });
+});
+describe("formatTrustDisplay()", () => {
+    it("formats a trust score display string", () => {
+        const score = computeTrustScore([
+            directClaim("a", "rpc"),
+            inferredClaim("b", "logs", "pattern"),
+            conjectureClaim("c", "model", "guess"),
+        ]);
+        const display = formatTrustDisplay(score);
+        assert.ok(display.includes("●"));
+        assert.ok(display.includes("Trust:"));
+    });
+});
+// ---------------------------------------------------------------------------
+// Content Markers
+// ---------------------------------------------------------------------------
+describe("parseContentMarker()", () => {
+    it("parses a valid marker", () => {
+        const m = parseContentMarker("[ev:direct|solana-rpc|0.95]");
+        assert.deepEqual(m, {
+            class: "direct",
+            source: "solana-rpc",
+            confidence: 0.95,
+        });
+    });
+    it("returns null for invalid markers", () => {
+        assert.equal(parseContentMarker("[ev:invalid|x|0.5]"), null);
+        assert.equal(parseContentMarker("not a marker"), null);
+    });
+});
+describe("extractMarkers()", () => {
+    it("extracts multiple markers from content", () => {
+        const text = "Price is $100 [ev:direct|coingecko|0.9] and trending up [ev:inferred|analysis|0.6]";
+        const markers = extractMarkers(text);
+        assert.equal(markers.length, 2);
+        assert.equal(markers[0].class, "direct");
+        assert.equal(markers[1].class, "inferred");
+    });
+});
+// ---------------------------------------------------------------------------
+// Tool Classification
+// ---------------------------------------------------------------------------
+describe("classifyTool()", () => {
+    it("matches exact tool names", () => {
+        const c = classifyTool("Read");
+        assert.equal(c?.default_class, "direct");
+    });
+    it("matches wildcard patterns", () => {
+        const c = classifyTool("solana-rpc:getBalance");
+        assert.equal(c?.default_class, "direct");
+        assert.equal(c?.default_ttl, 30);
+    });
+    it("returns undefined for unknown tools", () => {
+        assert.equal(classifyTool("unknown-tool"), undefined);
+    });
+});
+// ---------------------------------------------------------------------------
+// Validation
+// ---------------------------------------------------------------------------
+describe("validateEvidence()", () => {
+    it("passes for valid direct evidence", () => {
+        const errors = validateEvidence(evidence("direct", "rpc", { ttl: 30 }));
+        const hard = errors.filter((e) => e.severity === "error");
+        assert.equal(hard.length, 0);
+    });
+    it("fails when confidence below floor", () => {
+        const ev = { ...evidence("direct", "rpc"), confidence: 0.5 };
+        const errors = validateEvidence(ev);
+        assert.ok(errors.some((e) => e.rule === "confidence-floor"));
+    });
+    it("fails conjecture without reasoning", () => {
+        const ev = evidence("conjecture", "model", { confidence: 0.2 });
+        const errors = validateEvidence(ev);
+        assert.ok(errors.some((e) => e.rule === "conjecture-reasoning"));
+    });
+    it("warns direct without TTL", () => {
+        const ev = evidence("direct", "rpc");
+        const warnings = validateEvidence(ev).filter((e) => e.severity === "warning");
+        assert.ok(warnings.some((e) => e.rule === "direct-ttl"));
+    });
+});
+describe("validateResponse()", () => {
+    it("passes for a valid response", () => {
+        const resp = response("test", { ok: true }, [
+            directClaim("fact", "rpc"),
+        ]);
+        const result = validateResponse(resp);
+        assert.equal(result.valid, true);
+    });
+    it("fails with no claims", () => {
+        const resp = response("test", {}, []);
+        // Manually set empty claims to bypass builder
+        resp.claims = [];
+        const result = validateResponse(resp);
+        assert.equal(result.valid, false);
+        assert.ok(result.errors.some((e) => e.rule === "claims-required"));
+    });
+    it("detects aggregate class mismatch", () => {
+        const resp = response("test", {}, [
+            directClaim("a", "rpc"),
+            conjectureClaim("b", "model", "guess"),
+        ]);
+        resp.aggregate_class = "direct"; // wrong — should be conjecture
+        const result = validateResponse(resp);
+        assert.ok(result.errors.some((e) => e.rule === "aggregate-class-consistency"));
+    });
+});
+describe("validateMcpTag()", () => {
+    it("passes for valid tag", () => {
+        const tag = mcpTag("direct", "rpc", { ttl: 30 });
+        const result = validateMcpTag(tag);
+        assert.equal(result.valid, true);
+    });
+});
+// ---------------------------------------------------------------------------
+// Middleware
+// ---------------------------------------------------------------------------
+describe("wrapToolResult()", () => {
+    it("wraps with correct class for known tools", () => {
+        const wrapped = wrapToolResult("Read", { content: "hello" });
+        assert.equal(wrapped._evidence.class, "direct");
+    });
+    it("defaults to reported for unknown tools", () => {
+        const wrapped = wrapToolResult("mystery-tool", 42);
+        assert.equal(wrapped._evidence.class, "reported");
+    });
+    it("respects class override", () => {
+        const wrapped = wrapToolResult("Read", "x", {
+            classOverride: "conjecture",
+        });
+        assert.equal(wrapped._evidence.class, "conjecture");
+    });
+});
+describe("buildAgentResponse()", () => {
+    it("builds a valid response", () => {
+        const resp = buildAgentResponse("agent-1", { count: 3 }, [
+            directClaim("3 items found", "db-query"),
+        ]);
+        assert.equal(resp.producer, "agent-1");
+        assert.equal(resp.aggregate_class, "direct");
+    });
+});
+describe("Claim shorthand builders", () => {
+    it("directClaim sets class and TTL", () => {
+        const c = directClaim("fact", "rpc");
+        assert.equal(c.evidence.class, "direct");
+        assert.ok(c.evidence.ttl);
+    });
+    it("inferredClaim includes reasoning", () => {
+        const c = inferredClaim("deduction", "logs", "pattern match");
+        assert.equal(c.evidence.class, "inferred");
+        assert.equal(c.evidence.reasoning, "pattern match");
+    });
+    it("conjectureClaim requires reasoning", () => {
+        const c = conjectureClaim("guess", "model", "no data available");
+        assert.equal(c.evidence.class, "conjecture");
+        assert.equal(c.evidence.reasoning, "no data available");
+    });
+});
+// ---------------------------------------------------------------------------
+// Inter-Agent Propagation
+// ---------------------------------------------------------------------------
+describe("inheritClaim()", () => {
+    it("does not upgrade evidence class", () => {
+        const original = reportedClaim("data from API", "external-api");
+        const inherited = inheritClaim(original, "agent-B");
+        assert.equal(inherited.evidence.class, "reported"); // stays reported, not upgraded
+    });
+    it("applies confidence penalty", () => {
+        const original = directClaim("fact", "rpc", { confidence: 0.95 });
+        const inherited = inheritClaim(original, "agent-B");
+        assert.ok(inherited.evidence.confidence < 0.95);
+    });
+    it("cites the original source", () => {
+        const original = directClaim("fact", "rpc");
+        const inherited = inheritClaim(original, "agent-B");
+        assert.ok(inherited.evidence.source.includes("rpc"));
+        assert.ok(inherited.evidence.source.includes("agent-B"));
+    });
+});
+describe("verifyClaim()", () => {
+    it("allows upgrade with independent verification", () => {
+        const original = reportedClaim("token supply is 1M", "coingecko");
+        const verified = verifyClaim(original, "verifier-agent", "solana-rpc:getTokenSupply", "direct");
+        assert.equal(verified.evidence.class, "direct");
+        assert.ok(verified.refs?.includes("verified-by:verifier-agent"));
+    });
+});
+// ---------------------------------------------------------------------------
+// Degradation Engine
+// ---------------------------------------------------------------------------
+describe("checkDegradation()", () => {
+    it("returns empty for fresh evidence", () => {
+        const resp = response("test", {}, [directClaim("fact", "rpc")]);
+        const events = checkDegradation(resp);
+        assert.equal(events.length, 0);
+    });
+    it("detects TTL expiry", () => {
+        const past = new Date(Date.now() - 120_000).toISOString();
+        const claims = [
+            claim("stale fact", evidence("direct", "rpc", { ttl: 60, timestamp: past })),
+        ];
+        const resp = response("test", {}, claims);
+        const events = checkDegradation(resp);
+        assert.equal(events.length, 1);
+        assert.equal(events[0].from_class, "direct");
+        assert.equal(events[0].to_class, "reported");
+    });
+});
+describe("applyDegradation()", () => {
+    it("returns degraded copy without mutating original", () => {
+        const past = new Date(Date.now() - 120_000).toISOString();
+        const claims = [
+            claim("stale", evidence("direct", "rpc", { ttl: 60, timestamp: past })),
+        ];
+        const original = response("test", {}, claims);
+        const degraded = applyDegradation(original);
+        assert.equal(original.claims[0].evidence.class, "direct"); // unchanged
+        assert.equal(degraded.claims[0].evidence.class, "reported"); // degraded
+        assert.equal(degraded.aggregate_class, "reported");
+    });
+});
+//# sourceMappingURL=protocol.test.js.map

package/dist/tests/protocol.test.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Evidential Protocol v1.0 (EP-1)
+ *
+ * Matsés-inspired evidential metadata for AI systems.
+ * Every claim must declare its epistemic basis.
+ */
+/** The four evidence classes, ordered by strength. */
+export type EvidenceClass = "direct" | "inferred" | "reported" | "conjecture";
+/** Minimum confidence floors per class. */
+export declare const CONFIDENCE_FLOORS: Record<EvidenceClass, number>;
+/** Weights for trust score computation. */
+export declare const CLASS_WEIGHTS: Record<EvidenceClass, number>;
+/** Class strength ordering (higher = stronger). */
+export declare const CLASS_STRENGTH: Record<EvidenceClass, number>;
+/** A supporting source within compound evidence. */
+export interface EvidenceSource {
+    /** Evidence class of this source. */
+    class: EvidenceClass;
+    /** What produced this evidence. */
+    source: string;
+    /** Human-readable detail. */
+    detail: string;
+    /** When this source was gathered. ISO 8601. */
+    timestamp?: string;
+}
+/** Core evidence object attached to every claim. */
+export interface Evidence {
+    /** Primary evidence class. */
+    class: EvidenceClass;
+    /** Confidence score 0.0–1.0. Must be >= class floor. */
+    confidence: number;
+    /** What produced this evidence (tool name, agent ID, API endpoint). */
+    source: string;
+    /** Human-readable reasoning. REQUIRED for conjecture class. */
+    reasoning?: string;
+    /** When the evidence was gathered. ISO 8601. */
+    timestamp: string;
+    /** Time-to-live in seconds. After expiry, class degrades to 'reported'. */
+    ttl?: number;
+    /** For compound evidence: multiple supporting sources. */
+    sources?: EvidenceSource[];
+}
+/** A single assertion with its epistemic basis. */
+export interface EvidentialClaim {
+    /** The assertion being made. */
+    claim: string;
+    /** Epistemic basis for this claim. */
+    evidence: Evidence;
+    /** Optional links to raw data backing this claim. */
+    refs?: string[];
+}
+/** Full evidential response wrapping any agent or tool output. */
+export interface EvidentialResponse<T = unknown> {
+    /** Protocol version. */
+    ep_version: "1.0";
+    /** The output payload. */
+    data: T;
+    /** All claims made in this response. */
+    claims: EvidentialClaim[];
+    /** Lowest evidence class among all claims. */
+    aggregate_class: EvidenceClass;
+    /** Weighted mean confidence across claims. */
+    aggregate_confidence: number;
+    /** Agent or tool that produced this response. */
+    producer: string;
+    /** ISO 8601 timestamp. */
+    produced_at: string;
+}
+/** Lightweight evidence tag for MCP tool responses. */
+export interface McpEvidenceTag {
+    /** Protocol version. */
+    ep_version: "1.0";
+    /** Evidence class. */
+    class: EvidenceClass;
+    /** Confidence score. */
+    confidence: number;
+    /** Source identifier. */
+    source: string;
+    /** ISO 8601 timestamp. */
+    timestamp: string;
+    /** TTL in seconds. */
+    ttl?: number;
+    /** Reasoning (required for conjecture). */
+    reasoning?: string;
+}
+/** Inline evidence marker for content pipelines. Format: [ev:class|source|confidence] */
+export interface ContentEvidenceMarker {
+    class: EvidenceClass;
+    source: string;
+    confidence: number;
+}
+/** Trust score result for a set of claims. */
+export interface TrustScore {
+    /** Weighted trust score 0.0–1.0. */
+    score: number;
+    /** Total claims evaluated. */
+    total_claims: number;
+    /** Breakdown by class. */
+    breakdown: Record<EvidenceClass, number>;
+    /** Whether human review is required (score < 0.5). */
+    requires_review: boolean;
+}
+/** MCP tool classification entry. */
+export interface ToolClassification {
+    /** Tool name or pattern (supports glob). */
+    tool: string;
+    /** Default evidence class for this tool's outputs. */
+    default_class: EvidenceClass;
+    /** Default TTL in seconds. */
+    default_ttl?: number;
+}
+/** Evidence degradation event. */
+export interface DegradationEvent {
+    /** Claim that degraded. */
+    claim_id: string;
+    /** Previous class. */
+    from_class: EvidenceClass;
+    /** New class after degradation. */
+    to_class: EvidenceClass;
+    /** Reason for degradation. */
+    reason: "ttl_expired" | "stale_24h" | "source_unavailable";
+    /** When degradation occurred. */
+    timestamp: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,28 @@
+/**
+ * Evidential Protocol v1.0 (EP-1)
+ *
+ * Matsés-inspired evidential metadata for AI systems.
+ * Every claim must declare its epistemic basis.
+ */
+/** Minimum confidence floors per class. */
+export const CONFIDENCE_FLOORS = {
+    direct: 0.9,
+    inferred: 0.5,
+    reported: 0.3,
+    conjecture: 0.1,
+};
+/** Weights for trust score computation. */
+export const CLASS_WEIGHTS = {
+    direct: 1.0,
+    inferred: 0.7,
+    reported: 0.4,
+    conjecture: 0.15,
+};
+/** Class strength ordering (higher = stronger). */
+export const CLASS_STRENGTH = {
+    direct: 4,
+    inferred: 3,
+    reported: 2,
+    conjecture: 1,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,2CAA2C;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAkC;IAC9D,MAAM,EAAE,GAAG;IACX,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;CACP,CAAC;AAEX,2CAA2C;AAC3C,MAAM,CAAC,MAAM,aAAa,GAAkC;IAC1D,MAAM,EAAE,GAAG;IACX,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,IAAI;CACR,CAAC;AAEX,mDAAmD;AACnD,MAAM,CAAC,MAAM,cAAc,GAAkC;IAC3D,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,CAAC;CACL,CAAC"}

package/dist/validate.d.ts

@@ -0,0 +1,26 @@
+/**
+ * EP-1 Validation — enforces protocol rules on evidential responses.
+ */
+import { type Evidence, type EvidentialClaim, type EvidentialResponse, type McpEvidenceTag } from "./types.js";
+/** Validation error with structured context. */
+export interface ValidationError {
+    rule: string;
+    message: string;
+    path?: string;
+    severity: "error" | "warning";
+}
+/** Validation result. */
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationError[];
+}
+/** Validate a single Evidence object. */
+export declare function validateEvidence(evidence: Evidence, path?: string): ValidationError[];
+/** Validate a single EvidentialClaim. */
+export declare function validateClaim(claim: EvidentialClaim, index: number): ValidationError[];
+/** Validate a full EvidentialResponse. */
+export declare function validateResponse(response: EvidentialResponse): ValidationResult;
+/** Validate an MCP evidence tag. */
+export declare function validateMcpTag(tag: McpEvidenceTag): ValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EAGpB,MAAM,YAAY,CAAC;AAEpB,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,yBAAyB;AACzB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,yCAAyC;AACzC,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,IAAI,SAAa,GAChB,eAAe,EAAE,CA4EnB;AAED,yCAAyC;AACzC,wBAAgB,aAAa,CAC3B,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,MAAM,GACZ,eAAe,EAAE,CAyBnB;AAED,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,kBAAkB,GAC3B,gBAAgB,CAwElB;AAED,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,gBAAgB,CA6BpE"}