@mneme-ai/core 2.19.25 → 2.19.27

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_gestation/dreamspace_gestation.test.d.ts

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

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

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

package/dist/dreamspace_gestation/dreamspace_gestation.test.js

@@ -0,0 +1,160 @@
+import { describe, it, expect } from "vitest";
+import { detectToolGaps, proposeToolSpec, verifyProposal, runGestationCycle, verifyGestationReport, formatProposalLine, } from "./index.js";
+const SECRET = "gestation-test-secret-997744";
+function sig(kind, label, relatedTools, count, ts = 1) {
+    return { v: 1, kind, label, relatedTools, count, ts };
+}
+describe("v2.19.26 GESTATION · detectToolGaps", () => {
+    it("filters below-threshold signals (default minGapCount=3)", () => {
+        const out = detectToolGaps({
+            signals: [
+                sig("reflex_cache_miss", "x", [], 2), // below threshold
+                sig("reflex_cache_miss", "y", [], 5), // above
+            ],
+        });
+        expect(out.length).toBe(1);
+        expect(out[0].label).toBe("y");
+    });
+    it("co-occurrence has higher threshold (default minCoOccurCount=4)", () => {
+        const out = detectToolGaps({
+            signals: [
+                sig("pattern_co_occurrence", "x", ["a", "b"], 3), // below co-threshold
+                sig("pattern_co_occurrence", "y", ["a", "b"], 5), // above
+            ],
+        });
+        expect(out.length).toBe(1);
+        expect(out[0].label).toBe("y");
+    });
+    it("sorts by count desc, then label asc", () => {
+        const out = detectToolGaps({
+            signals: [
+                sig("reflex_cache_miss", "b", [], 5),
+                sig("reflex_cache_miss", "a", [], 5),
+                sig("reflex_cache_miss", "c", [], 10),
+            ],
+        });
+        expect(out.map((g) => g.label)).toEqual(["c", "a", "b"]);
+    });
+});
+describe("v2.19.26 GESTATION · proposeToolSpec (3 gap kinds)", () => {
+    it("pattern_co_occurrence -> mneme.auto.X_then_Y chimera", () => {
+        const spec = proposeToolSpec({
+            gap: sig("pattern_co_occurrence", "git_commit:fix-prefix", ["mneme.ask", "mneme.why"], 6),
+            secret: SECRET,
+        });
+        expect(spec.proposedName).toBe("mneme.auto.ask_then_why");
+        expect(spec.composerKind).toBe("sequential");
+        expect(spec.composerRecipe.length).toBe(2);
+        expect(spec.composerRecipe[0].toolName).toBe("mneme.ask");
+        expect(spec.composerRecipe[1].toolName).toBe("mneme.why");
+    });
+    it("reflex_cache_miss with related tools -> handler chimera", () => {
+        const spec = proposeToolSpec({
+            gap: sig("reflex_cache_miss", "user_chat:thai-refresh", ["mneme.status", "mneme.whats_new"], 4),
+            secret: SECRET,
+        });
+        expect(spec.proposedName).toContain("mneme.auto.handle_");
+        expect(spec.composerRecipe.length).toBe(2);
+    });
+    it("reflex_cache_miss with NO related tools -> smart_do fallback", () => {
+        const spec = proposeToolSpec({
+            gap: sig("reflex_cache_miss", "unknown:x", [], 4),
+            secret: SECRET,
+        });
+        expect(spec.composerRecipe[0].toolName).toBe("mneme.smart_do");
+    });
+    it("user_chat_no_match -> intent handler with query schema", () => {
+        const spec = proposeToolSpec({
+            gap: sig("user_chat_no_match", "compress yesterday's commits", [], 5),
+            secret: SECRET,
+        });
+        expect(spec.proposedName).toContain("mneme.auto.intent_");
+        expect(spec.proposedInputSchema.required).toContain("query");
+    });
+    it("confidence scales with gap count (capped at 1.0)", () => {
+        const low = proposeToolSpec({ gap: sig("reflex_cache_miss", "x", [], 3), secret: SECRET, minGapCount: 3 });
+        const high = proposeToolSpec({ gap: sig("reflex_cache_miss", "x", [], 30), secret: SECRET, minGapCount: 3 });
+        expect(high.confidence).toBeGreaterThan(low.confidence);
+        expect(high.confidence).toBeLessThanOrEqual(1);
+    });
+    it("HMAC sig verifies untampered; rejects tamper", () => {
+        const spec = proposeToolSpec({ gap: sig("reflex_cache_miss", "x", [], 5), secret: SECRET });
+        expect(verifyProposal(spec, SECRET)).toBe(true);
+        expect(verifyProposal({ ...spec, confidence: 0.99 }, SECRET)).toBe(false);
+    });
+    it("MEASURED 100% determinism: same gap -> same proposal sig (30 trials)", () => {
+        const gap = sig("pattern_co_occurrence", "stable", ["mneme.ask", "mneme.why"], 8, 1_000_000);
+        const firstSig = proposeToolSpec({ gap, secret: SECRET }).sig;
+        let allEqual = true;
+        for (let i = 0; i < 30; i++) {
+            if (proposeToolSpec({ gap, secret: SECRET }).sig !== firstSig) {
+                allEqual = false;
+                break;
+            }
+        }
+        expect(allEqual).toBe(true);
+    });
+});
+describe("v2.19.26 GESTATION · runGestationCycle (full loop)", () => {
+    it("empty signals -> empty proposals", () => {
+        const r = runGestationCycle({ signals: [], cycleAt: 0, secret: SECRET });
+        expect(r.qualifyingGaps).toBe(0);
+        expect(r.proposals).toEqual([]);
+    });
+    it("mixed signals: only above-threshold yield proposals", () => {
+        const r = runGestationCycle({
+            signals: [
+                sig("reflex_cache_miss", "x", [], 2), // below
+                sig("reflex_cache_miss", "y", [], 5), // qualifies
+                sig("pattern_co_occurrence", "z", ["mneme.a", "mneme.b"], 4), // qualifies (co threshold 4)
+                sig("user_chat_no_match", "?", [], 1), // below
+            ],
+            cycleAt: 0,
+            secret: SECRET,
+        });
+        expect(r.totalSignals).toBe(4);
+        expect(r.qualifyingGaps).toBe(2);
+        expect(r.proposals.length).toBe(2);
+    });
+    it("HMAC sig verifies untampered; rejects tamper", () => {
+        const r = runGestationCycle({
+            signals: [sig("reflex_cache_miss", "x", [], 5)],
+            cycleAt: 0,
+            secret: SECRET,
+        });
+        expect(verifyGestationReport(r, SECRET)).toBe(true);
+        expect(verifyGestationReport({ ...r, totalSignals: 999 }, SECRET)).toBe(false);
+    });
+    it("MEASURED 100% determinism: same signals -> same report sig (30 trials)", () => {
+        const input = {
+            signals: [
+                sig("reflex_cache_miss", "x", [], 5, 1),
+                sig("pattern_co_occurrence", "y", ["mneme.a", "mneme.b"], 6, 2),
+            ],
+            cycleAt: 1_000_000,
+            secret: SECRET,
+        };
+        const first = runGestationCycle(input).sig;
+        let allEqual = true;
+        for (let i = 0; i < 30; i++) {
+            if (runGestationCycle(input).sig !== first) {
+                allEqual = false;
+                break;
+            }
+        }
+        expect(allEqual).toBe(true);
+    });
+});
+describe("v2.19.26 GESTATION · formatter", () => {
+    it("formatProposalLine includes name + step count + confidence + gap kind", () => {
+        const spec = proposeToolSpec({
+            gap: sig("pattern_co_occurrence", "x", ["mneme.a", "mneme.b"], 10),
+            secret: SECRET,
+        });
+        const line = formatProposalLine(spec);
+        expect(line).toContain("mneme.auto");
+        expect(line).toContain("2-step");
+        expect(line).toContain("sequential");
+    });
+});
+//# sourceMappingURL=dreamspace_gestation.test.js.map

package/dist/dreamspace_gestation/dreamspace_gestation.test.js.map

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

package/dist/dreamspace_gestation/index.d.ts

@@ -0,0 +1,136 @@
+/**
+ * v2.19.26 — MNEME DREAMSPACE · GESTATION (self-authoring MCP catalog · phase 1 of 2)
+ *
+ *   "Catalog ตัวมัน static — ไม่งอก ไม่ตาย ไม่จับคู่ ไม่เรียนรู้ที่จะ
+ *    author tool ใหม่. นั่นคือ gap ของกระบวนการ 'ของเดิม + ของใหม่ +
+ *    การเลือก' — ที่ DREAMS ปัจจุบันยังตอบไม่ได้"
+ *                                          — user audit, 2026-05-17
+ *
+ *   Diagnosis: every prior dreams primitive (vaccine_cycle, dream.run,
+ *   dreams.enqueue/resolve) is a PRODUCT factory — it manufactures
+ *   one specific artifact (vaccine / claim / verdict). GESTATION is
+ *   a TOOL factory — it watches for catalog gaps + proposes the
+ *   composer recipe for a brand-new MCP tool that closes the gap.
+ *
+ *   Three gap classes detected from caller-supplied signals:
+ *     1. REFLEX cache miss — user (or AI) tried an event that
+ *        had no cached prediction; nothing fired. Gap = no pattern
+ *        matched this event signature.
+ *     2. user_chat no-match — user typed a request; EVENT PATTERN
+ *        MATCH returned zero predictions. Gap = no semantic rule
+ *        recognised this phrase.
+ *     3. pattern co-occurrence — two tools always fire together in
+ *        sequence (e.g., mneme.ask then mneme.why). Gap = no single
+ *        composed tool does both — opportunity for chimera.
+ *
+ *   For each gap, propose a ProposedToolSpec with deterministic name,
+ *   description (from the originating signal), composer recipe (list
+ *   of existing tools to chain), and a JSON inputSchema derived as the
+ *   intersection of the composed tools' input schemas. Caller (daemon)
+ *   feeds the spec to v2.19.9 WRAPPER_GENESPLICING `splice` to actually
+ *   create the runtime chimera; this module is the PROPOSER, not the
+ *   executor.
+ *
+ *   Composes onto:
+ *     - v2.19.9  WRAPPER_GENESPLICING (real splice surface)
+ *     - v2.19.11 MORTAL (TTL for proposed tools)
+ *     - v2.19.22 REFLEX (cache miss signal)
+ *     - v2.19.24 EVENT PATTERN MATCH (no-match signal)
+ *     - v2.19.25 SLEEP TRAINING (fitness gradient feeds promotion)
+ *
+ * Honest scope:
+ *   - PURE FUNCTION proposer; HMAC-signed proposals so daemon can
+ *     audit forged specs.
+ *   - Composer recipes are SEQUENCES (Tool_A then Tool_B); we don't
+ *     synthesise parallelisable or conditional graphs. v2.19.9 supports
+ *     sequential/fan_out/first_success — we emit "sequential" only.
+ *   - Names use deterministic snake_case to avoid collisions:
+ *     `mneme.auto.<tool1>_then_<tool2>`. Caller can rename on promote.
+ *   - We do NOT execute or load code. Daemon picks specs to promote
+ *     based on usage telemetry from v2.19.26 EVOLUTION.
+ */
+declare const PROTOCOL_VERSION: 1;
+export type GapKind = "reflex_cache_miss" | "user_chat_no_match" | "pattern_co_occurrence";
+export interface GapSignal {
+    v: typeof PROTOCOL_VERSION;
+    kind: GapKind;
+    /** Human label (e.g., "git_commit:fix-prefix" / "user_chat:thai-รีเฟรช"). */
+    label: string;
+    /** Tool names already known to be relevant (empty for no_match). */
+    relatedTools: string[];
+    /** How many times this gap was observed yesterday. */
+    count: number;
+    ts: number;
+}
+export interface ProposedToolSpec {
+    v: typeof PROTOCOL_VERSION;
+    /** Deterministic name; daemon can rename on promote. */
+    proposedName: string;
+    /** Why this tool exists; derived from the originating signal. */
+    description: string;
+    /** Ordered list of EXISTING tools the chimera invokes. */
+    composerRecipe: Array<{
+        toolName: string;
+        argsPassthrough?: boolean;
+    }>;
+    /** Composer kind for v2.19.9 splice (always "sequential" for now). */
+    composerKind: "sequential" | "fan_out" | "first_success";
+    /** JSON Schema of the chimera's input (union of component inputs). */
+    proposedInputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required: string[];
+    };
+    /** Source gap signal that triggered this proposal. */
+    sourceGap: GapSignal;
+    /** Confidence 0..1 — based on signal count vs threshold. */
+    confidence: number;
+    sig: string;
+}
+/**
+ * Filter gap signals down to those above the minimum-count threshold.
+ * Below-threshold signals are noise; above-threshold signals are real
+ * gaps worth proposing a tool for.
+ */
+export declare function detectToolGaps(input: {
+    signals: GapSignal[];
+    minGapCount?: number;
+    minCoOccurCount?: number;
+}): GapSignal[];
+/**
+ * Propose a tool spec from a single gap signal. Pure function;
+ * deterministic over (signal + secret). The composer recipe defaults
+ * to sequential chaining of the related tools; for no-match gaps with
+ * empty relatedTools, the recipe is just `mneme.smart_do` as a fallback
+ * so caller has SOMETHING to splice.
+ */
+export declare function proposeToolSpec(input: {
+    gap: GapSignal;
+    secret?: string;
+    minGapCount?: number;
+}): ProposedToolSpec;
+export declare function verifyProposal(spec: ProposedToolSpec, secret?: string): boolean;
+export interface GestationReport {
+    v: typeof PROTOCOL_VERSION;
+    totalSignals: number;
+    qualifyingGaps: number;
+    proposals: ProposedToolSpec[];
+    cycleAt: number;
+    sig: string;
+}
+/**
+ * One-shot gestation cycle: filter signals → propose specs → HMAC-sign
+ * the whole report. Caller runs this during the daemon's idle/dream
+ * window (composes onto v2.19.23 THALAMUS dream tier).
+ */
+export declare function runGestationCycle(input: {
+    signals: GapSignal[];
+    cycleAt?: number;
+    minGapCount?: number;
+    minCoOccurCount?: number;
+    secret?: string;
+}): GestationReport;
+export declare function verifyGestationReport(r: GestationReport, secret?: string): boolean;
+export declare function formatProposalLine(p: ProposedToolSpec): string;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dreamspace_gestation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAIH,QAAA,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAIpC,MAAM,MAAM,OAAO,GAAG,mBAAmB,GAAG,oBAAoB,GAAG,uBAAuB,CAAC;AAE3F,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAC/B,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,cAAc,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACvE,sEAAsE;IACtE,YAAY,EAAE,YAAY,GAAG,SAAS,GAAG,eAAe,CAAC;IACzD,sEAAsE;IACtE,mBAAmB,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACjG,sDAAsD;IACtD,SAAS,EAAE,SAAS,CAAC;IACrB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AA0BD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,SAAS,EAAE,CAUd;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,GAAG,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB,CAgDlH;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAG/E;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,eAAe,CAgBlB;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAGlF;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAG9D"}