@mneme-ai/core 2.19.26 → 2.19.28

package/dist/dreamspace_federate/index.js

@@ -0,0 +1,209 @@
+/**
+ * v2.19.27 — MNEME DREAMSPACE · FEDERATE (stage 6 of 6)
+ *
+ *   "tools ที่ elite ใน 100+ instances → 'blessed'
+ *    shared via cosmic.mneme-ai.space/dreamspace
+ *    ผู้ใช้ใหม่ download starter pack จาก top 100 dreamt-born tools
+ *    ⇒ Mneme network effect ที่ไม่มี framework ไหนมี"
+ *                                          — user audit, 2026-05-17
+ *
+ *   Diagnosis: GESTATION proposes; EVOLUTION selects; PROBE measures;
+ *   CARTOGRAPHER maps; PAIR scores complementarity. All locally. The
+ *   network effect kicks in when ELITE tools spread across instances.
+ *
+ *   FEDERATE composes onto v2.19.16 FEDERATED TRUTH GRAVITY. Each
+ *   instance HMAC-signs an EliteAttestation for tools whose local
+ *   fitness >= threshold. Quorum across instances → "blessed" tag.
+ *   Starter pack export = top-N blessed tools, downloadable by new
+ *   users.
+ *
+ *   Composes onto:
+ *     - v2.19.16 FEDERATED TRUTH GRAVITY (cross-attestation pattern)
+ *     - v2.19.27 PROBE (local fitness source)
+ *     - v2.19.26 EVOLUTION (lifecycle bands; only MATURE eligible)
+ *     - v2.19.9 WRAPPER_GENESPLICING (blessed tools = composer recipes
+ *       that any instance can apply)
+ *
+ * Honest scope:
+ *   - PURE FUNCTION attestation + quorum. Caller does the actual
+ *     network sync via v2.19.16 mesh/nexus transport.
+ *   - Eligibility gate: only MATURE tools (v2.19.26 EVOLUTION) with
+ *     local fitness >= threshold get attested.
+ *   - HMAC-signed attestations; forged attestations dropped on verify.
+ *   - Quorum bands match v2.19.16: unanimous / supermajority / majority
+ *     / minority / conflict / orphan.
+ */
+import { createHmac, timingSafeEqual } from "node:crypto";
+const PROTOCOL_VERSION = 1;
+const DEFAULT_MIN_FITNESS = 0.7;
+function canon(v) {
+    if (v === null || typeof v !== "object")
+        return JSON.stringify(v);
+    if (Array.isArray(v))
+        return "[" + v.map(canon).join(",") + "]";
+    const keys = Object.keys(v).sort();
+    return "{" + keys.map((k) => JSON.stringify(k) + ":" + canon(v[k])).join(",") + "}";
+}
+function defaultSecret() {
+    return process.env["MNEME_DREAMSPACE_FEDERATE_SECRET"] || `mneme-dreamspace-federate-v${PROTOCOL_VERSION}`;
+}
+function hmacHex(body, secret) {
+    return createHmac("sha256", secret).update(canon(body)).digest("hex");
+}
+function safeEqHex(a, b) {
+    try {
+        return timingSafeEqual(Buffer.from(a, "hex"), Buffer.from(b, "hex"));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Issue an EliteAttestation for a tool. Refuses if fitness < threshold
+ * (we never attest mediocre tools). Caller-supplied instanceId from
+ * v2.19.16 FEDERATED identity.
+ */
+export function attestElite(input) {
+    const min = input.minFitness ?? DEFAULT_MIN_FITNESS;
+    if (input.localFitness < min)
+        return null;
+    const body = {
+        v: PROTOCOL_VERSION,
+        instanceId: input.instanceId,
+        toolName: input.toolName,
+        localFitness: input.localFitness,
+        localUseCount: input.localUseCount,
+        ts: input.ts ?? Date.now(),
+    };
+    const sig = hmacHex(body, input.secret ?? defaultSecret());
+    return { ...body, sig };
+}
+export function verifyAttestation(a, secret) {
+    const { sig, ...body } = a;
+    return safeEqHex(hmacHex(body, secret ?? defaultSecret()), sig);
+}
+/**
+ * Aggregate N attestations for a single tool into a BlessingQuorum.
+ *
+ * Bands (proportions of validAttestations / totalInstances):
+ *   unanimous     : >= 0.95
+ *   supermajority : >= 0.67
+ *   majority      : >= 0.51
+ *   minority      : >= 0.10
+ *   conflict      : > 0  and < 0.10
+ *   orphan        : 0 attestations
+ *
+ * Forged attestations (failed HMAC verify) are dropped silently and
+ * counted in `forgedDropped`. One-vote-per-instance: duplicates from
+ * same instanceId keep the latest by ts.
+ */
+export function aggregateBlessing(input) {
+    const sec = input.secret ?? defaultSecret();
+    // Drop forged
+    const valid = [];
+    let forgedDropped = 0;
+    for (const a of input.attestations) {
+        if (a.toolName !== input.toolName)
+            continue;
+        if (!verifyAttestation(a, sec)) {
+            forgedDropped++;
+            continue;
+        }
+        valid.push(a);
+    }
+    // One-vote-per-instance: keep latest ts
+    const byInstance = new Map();
+    for (const a of valid) {
+        const prev = byInstance.get(a.instanceId);
+        if (!prev || a.ts > prev.ts)
+            byInstance.set(a.instanceId, a);
+    }
+    const deduped = Array.from(byInstance.values());
+    const totalUseCount = deduped.reduce((s, a) => s + a.localUseCount, 0);
+    const meanFitness = deduped.length === 0
+        ? 0
+        : deduped.reduce((s, a) => s + a.localFitness, 0) / deduped.length;
+    const proportion = input.totalInstancesKnown === 0
+        ? 0
+        : deduped.length / input.totalInstancesKnown;
+    let band;
+    if (deduped.length === 0)
+        band = "orphan";
+    else if (proportion >= 0.95)
+        band = "unanimous";
+    else if (proportion >= 0.67)
+        band = "supermajority";
+    else if (proportion >= 0.51)
+        band = "majority";
+    else if (proportion >= 0.10)
+        band = "minority";
+    else
+        band = "conflict";
+    const isBlessed = band === "unanimous" || band === "supermajority";
+    const body = {
+        v: PROTOCOL_VERSION,
+        toolName: input.toolName,
+        totalAttestations: input.attestations.length,
+        validAttestations: deduped.length,
+        forgedDropped,
+        meanFitness,
+        totalUseCount,
+        band,
+        isBlessed,
+    };
+    const sig = hmacHex(body, sec);
+    return { ...body, sig };
+}
+export function verifyBlessingQuorum(q, secret) {
+    const { sig, ...body } = q;
+    return safeEqHex(hmacHex(body, secret ?? defaultSecret()), sig);
+}
+/**
+ * Export a starter pack of top-N blessed tools — downloaded by new
+ * users on first install. Sorted by isBlessed first, then meanFitness
+ * desc, then validAttestations desc.
+ */
+export function exportStarterPack(input) {
+    const topN = input.topN ?? 100;
+    const sorted = [...input.quorums].sort((a, b) => {
+        if (a.isBlessed !== b.isBlessed)
+            return a.isBlessed ? -1 : 1;
+        if (b.meanFitness !== a.meanFitness)
+            return b.meanFitness - a.meanFitness;
+        return b.validAttestations - a.validAttestations;
+    });
+    const entries = sorted.slice(0, topN).map((q) => ({
+        toolName: q.toolName,
+        band: q.band,
+        meanFitness: q.meanFitness,
+        attestationCount: q.validAttestations,
+    }));
+    const body = {
+        v: PROTOCOL_VERSION,
+        entries,
+        topN,
+        builtAt: input.builtAt ?? Date.now(),
+    };
+    const sig = hmacHex(body, input.secret ?? defaultSecret());
+    return { ...body, sig };
+}
+export function verifyStarterPack(p, secret) {
+    const { sig, ...body } = p;
+    return safeEqHex(hmacHex(body, secret ?? defaultSecret()), sig);
+}
+export const BLESSING_EMOJI = {
+    unanimous: "🏆",
+    supermajority: "🥇",
+    majority: "🥈",
+    minority: "🥉",
+    conflict: "⚖",
+    orphan: "🌌",
+};
+export function formatQuorumLine(q) {
+    return `${BLESSING_EMOJI[q.band]} FEDERATE ${q.toolName} · ${q.band} (${q.validAttestations}/${q.validAttestations + q.forgedDropped} valid · meanFit=${(q.meanFitness * 100).toFixed(0)}%)`;
+}
+export function formatStarterPackLine(p) {
+    const blessed = p.entries.filter((e) => e.band === "unanimous" || e.band === "supermajority").length;
+    return `🌍 STARTER-PACK · top-${p.topN} · ${p.entries.length} total · ${blessed} blessed`;
+}
+//# sourceMappingURL=index.js.map

package/dist/dreamspace_federate/index.js.map

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

package/dist/dreamspace_pair/dreamspace_pair.test.d.ts

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

package/dist/dreamspace_pair/dreamspace_pair.test.d.ts.map

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

package/dist/dreamspace_pair/dreamspace_pair.test.js

@@ -0,0 +1,176 @@
+import { describe, it, expect } from "vitest";
+import { scorePair, rankAllPairs, verifyPairReport, formatPairLine, } from "./index.js";
+const SECRET = "pair-test-secret-997744";
+function sample(toolName, result) {
+    return { toolName, result };
+}
+function schema(toolName, required, optional = []) {
+    return { toolName, requiredProps: required, optionalProps: optional };
+}
+describe("v2.19.27 PAIR · scorePair (mutual info approximation)", () => {
+    it("perfect coverage: A's output keys cover ALL of B's required + optional", () => {
+        const s = scorePair({
+            toolA: "A",
+            outputsA: [sample("A", { name: "x", count: 3 })],
+            schemaB: schema("B", ["name", "count"], []),
+        });
+        expect(s.requiredCoverage).toBe(1.0);
+        expect(s.optionalCoverage).toBe(1.0);
+        expect(s.mutualInfoScore).toBeCloseTo(0.5 + 0.3 + 0.2 * s.keyOverlapScore, 5);
+    });
+    it("zero required coverage: A's keys disjoint from B's required → low MI", () => {
+        const s = scorePair({
+            toolA: "A",
+            outputsA: [sample("A", { foo: 1 })],
+            schemaB: schema("B", ["name", "count"], ["other"]), // also non-empty optional
+        });
+        expect(s.requiredCoverage).toBe(0);
+        expect(s.optionalCoverage).toBe(0);
+        expect(s.mutualInfoScore).toBeLessThan(0.2);
+    });
+    it("partial required coverage rewards proportionally", () => {
+        const s = scorePair({
+            toolA: "A",
+            outputsA: [sample("A", { name: "x" })],
+            schemaB: schema("B", ["name", "count", "ts"]),
+        });
+        expect(s.requiredCoverage).toBeCloseTo(1 / 3, 5);
+    });
+    it("case-insensitive key matching", () => {
+        const s = scorePair({
+            toolA: "A",
+            outputsA: [sample("A", { NAME: "x" })],
+            schemaB: schema("B", ["name"]),
+        });
+        expect(s.requiredCoverage).toBe(1.0);
+    });
+    it("multiple samples union their keys", () => {
+        const s = scorePair({
+            toolA: "A",
+            outputsA: [sample("A", { name: "x" }), sample("A", { count: 1 })],
+            schemaB: schema("B", ["name", "count"]),
+        });
+        expect(s.requiredCoverage).toBe(1.0);
+    });
+    it("empty required + empty output -> vacuous 1.0 required coverage", () => {
+        const s = scorePair({
+            toolA: "A",
+            outputsA: [sample("A", {})],
+            schemaB: schema("B", [], []),
+        });
+        expect(s.requiredCoverage).toBe(1.0);
+        expect(s.optionalCoverage).toBe(1.0);
+    });
+});
+describe("v2.19.27 PAIR · rankAllPairs (full ordered ranking)", () => {
+    it("scores every ordered (A, B) pair; self-pairs excluded", () => {
+        const r = rankAllPairs({
+            toolOutputs: [
+                [sample("A", { name: "x", count: 1 })],
+                [sample("B", { name: "y" })],
+            ],
+            toolSchemas: [
+                schema("A", ["name"]), // B → A; A → A excluded
+                schema("B", ["name"]),
+            ],
+            minScore: 0,
+            builtAt: 0,
+            secret: SECRET,
+        });
+        // 2 tools, 2 schemas, no self-pairs -> 2 candidate pairs (A→B, B→A)
+        expect(r.totalCandidatePairs).toBe(2);
+    });
+    it("sorts by mutual info desc; filters below minScore", () => {
+        const r = rankAllPairs({
+            toolOutputs: [
+                [sample("good", { name: "x", count: 1, ts: 1 })],
+                [sample("bad", { unrelated: 1 })],
+            ],
+            toolSchemas: [
+                schema("good", []),
+                schema("bad", []),
+                schema("target", ["name", "count", "ts"]),
+            ],
+            minScore: 0.5,
+            builtAt: 0,
+            secret: SECRET,
+        });
+        // good → target should rank high; bad → target low (likely filtered)
+        expect(r.pairs[0].toolA).toBe("good");
+        expect(r.pairs[0].toolB).toBe("target");
+        expect(r.pairs.every((p) => p.mutualInfoScore >= 0.5)).toBe(true);
+    });
+    it("topN respected", () => {
+        const r = rankAllPairs({
+            toolOutputs: Array.from({ length: 5 }, (_, i) => [sample(`t${i}`, { x: 1 })]),
+            toolSchemas: Array.from({ length: 5 }, (_, i) => schema(`t${i}`, ["x"])),
+            minScore: 0,
+            topN: 3,
+            builtAt: 0,
+            secret: SECRET,
+        });
+        expect(r.pairs.length).toBeLessThanOrEqual(3);
+    });
+    it("HMAC sig verifies; rejects tamper", () => {
+        const r = rankAllPairs({
+            toolOutputs: [[sample("a", { x: 1 })]],
+            toolSchemas: [schema("a", []), schema("b", [])],
+            builtAt: 0,
+            secret: SECRET,
+        });
+        expect(verifyPairReport(r, SECRET)).toBe(true);
+        expect(verifyPairReport({ ...r, qualifyingPairs: 999 }, SECRET)).toBe(false);
+    });
+    it("MEASURED 100% determinism: same input -> same sig (30 trials)", () => {
+        const input = {
+            toolOutputs: [[sample("a", { x: 1 })], [sample("b", { y: 1 })]],
+            toolSchemas: [schema("a", ["x"]), schema("b", ["y"])],
+            builtAt: 1_000_000,
+            secret: SECRET,
+        };
+        const firstSig = rankAllPairs(input).sig;
+        let allEqual = true;
+        for (let i = 0; i < 30; i++) {
+            if (rankAllPairs(input).sig !== firstSig) {
+                allEqual = false;
+                break;
+            }
+        }
+        expect(allEqual).toBe(true);
+    });
+    it("MEASURED canonical scenario: truth.forensic→bug_prophet has high MI", () => {
+        // truth.forensic outputs { claim, sniffs, verdict, evidence }
+        // bug_prophet expects { claim, evidence } as input
+        const r = rankAllPairs({
+            toolOutputs: [
+                [sample("mneme.truth.forensic", { claim: "x", sniffs: [], verdict: "ACCEPTED", evidence: [] })],
+                [sample("mneme.bug_prophet", { prophecy: "..." })], // unrelated output
+            ],
+            toolSchemas: [
+                schema("mneme.bug_prophet", ["claim", "evidence"]),
+                schema("mneme.truth.forensic", ["claim"]),
+            ],
+            minScore: 0.3,
+            builtAt: 0,
+            secret: SECRET,
+        });
+        const tfToProphet = r.pairs.find((p) => p.toolA === "mneme.truth.forensic" && p.toolB === "mneme.bug_prophet");
+        expect(tfToProphet).toBeDefined();
+        expect(tfToProphet.mutualInfoScore).toBeGreaterThanOrEqual(0.5);
+    });
+});
+describe("v2.19.27 PAIR · formatter", () => {
+    it("formatPairLine includes A → B + MI% + required% + optional%", () => {
+        const s = scorePair({
+            toolA: "x",
+            outputsA: [sample("x", { name: "y" })],
+            schemaB: schema("y", ["name"]),
+        });
+        const line = formatPairLine(s);
+        expect(line).toContain("PAIR x → y");
+        expect(line).toContain("MI=");
+        expect(line).toContain("req=");
+        expect(line).toContain("opt=");
+    });
+});
+//# sourceMappingURL=dreamspace_pair.test.js.map

package/dist/dreamspace_pair/dreamspace_pair.test.js.map

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

package/dist/dreamspace_pair/index.d.ts

@@ -0,0 +1,99 @@
+/**
+ * v2.19.27 — MNEME DREAMSPACE · PAIR (stage 3 of 6)
+ *
+ *   "for every pair (A, B): score = mutual_info(output_A, expected_
+ *    input_B). top pairs → ผ่านขั้น 4"
+ *                                          — user audit, 2026-05-17
+ *
+ *   Diagnosis: v2.19.26 EVOLUTION.selectMatingPairs uses FREQUENCY
+ *   (how often A→B fires together). PAIR adds QUALITY — measures
+ *   how well A's output matches what B EXPECTS as input. High
+ *   mutual_info → A and B are genuinely complementary; safe to splice.
+ *
+ *   We approximate mutual information without LLM: compare key-name
+ *   overlap (Jaccard over object property names) AND value-type
+ *   compatibility. Both signals together approximate "would A's output
+ *   be a plausible input to B?".
+ *
+ *   Composes onto:
+ *     - v2.19.26 EVOLUTION (replaces co-occurrence ranking with quality)
+ *     - v2.19.27 PROBE (probe outputs feed PAIR's mutual_info)
+ *     - v2.19.9 WRAPPER_GENESPLICING (high-mutual-info pairs → chimera)
+ *     - v2.19.25 SLEEP TRAINING (PAIR fitness blends with jaccard reward)
+ *
+ * Honest scope:
+ *   - Mutual info APPROXIMATION via shape-matching, not full Shannon
+ *     information. Faster, deterministic, sufficient for "are these
+ *     two tools complementary?" decision.
+ *   - HMAC-signed PairReport so federation can ship verified pairs.
+ */
+declare const PROTOCOL_VERSION: 1;
+export interface ToolOutputSample {
+    toolName: string;
+    /** Object output (we focus on object-shape compatibility). */
+    result: Record<string, unknown>;
+}
+export interface ToolInputSchema {
+    toolName: string;
+    /** Required + optional property names. */
+    requiredProps: string[];
+    optionalProps: string[];
+}
+export interface PairScore {
+    toolA: string;
+    toolB: string;
+    /** Object key overlap A.outputs vs B.requiredProps (Jaccard 0..1). */
+    keyOverlapScore: number;
+    /** Required-coverage: fraction of B's required props that A produces. */
+    requiredCoverage: number;
+    /** Optional-coverage: fraction of B's optional props A also produces. */
+    optionalCoverage: number;
+    /** Final mutual_info approximation (weighted blend). */
+    mutualInfoScore: number;
+}
+export interface PairReport {
+    v: typeof PROTOCOL_VERSION;
+    pairs: PairScore[];
+    totalCandidatePairs: number;
+    qualifyingPairs: number;
+    minScore: number;
+    builtAt: number;
+    sig: string;
+}
+/**
+ * Score a single (A, B) pair: how complementary is A's output to B's
+ * expected input?
+ *
+ *   keyOverlapScore       = jaccard(unionOutputKeys(A), requiredProps(B) ∪ optionalProps(B))
+ *   requiredCoverage      = |outputKeys(A) ∩ requiredProps(B)| / |requiredProps(B)|
+ *   optionalCoverage      = |outputKeys(A) ∩ optionalProps(B)| / |optionalProps(B)|
+ *   mutualInfoScore       = 0.5 * requiredCoverage + 0.3 * optionalCoverage + 0.2 * keyOverlapScore
+ *
+ * Required-coverage dominates because B will THROW if a required prop
+ * is missing; optional is nice-to-have; raw key overlap captures broader
+ * signal compatibility.
+ */
+export declare function scorePair(input: {
+    toolA: string;
+    outputsA: ToolOutputSample[];
+    schemaB: ToolInputSchema;
+}): PairScore;
+/**
+ * Score ALL ordered (A, B) pairs across the supplied tools; filter
+ * above minScore; sort by mutualInfoScore desc. Self-pairs excluded.
+ *
+ * Returns top pairs ready to feed into v2.19.26 GESTATION as
+ * `pattern_co_occurrence` signals with quality (not just frequency).
+ */
+export declare function rankAllPairs(input: {
+    toolOutputs: ToolOutputSample[][];
+    toolSchemas: ToolInputSchema[];
+    minScore?: number;
+    topN?: number;
+    builtAt?: number;
+    secret?: string;
+}): PairReport;
+export declare function verifyPairReport(r: PairReport, secret?: string): boolean;
+export declare function formatPairLine(p: PairScore): string;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dreamspace_pair/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,QAAA,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAGpC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,eAAe,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,gBAAgB,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,gBAAgB,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AA0CD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,OAAO,EAAE,eAAe,CAAC;CAC1B,GAAG,SAAS,CAkBZ;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,WAAW,EAAE,gBAAgB,EAAE,EAAE,CAAC;IAClC,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,UAAU,CAgCb;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAGxE;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAGnD"}