@mneme-ai/core 2.19.9 → 2.19.11

package/dist/mortal_wrappers/mortal_wrappers.test.js

@@ -0,0 +1,372 @@
+import { describe, it, expect } from "vitest";
+import { birthMortalWrapper, mutateSignature, tickReincarnation, resolveMortalCall, recordCalibration, calibrationScore, globalStats, verifyMortalWrapper, emptyState, formatWrapperLine, } from "./index.js";
+const SECRET = "test-mortal-secret-9991122";
+const ARGS = ["topic", "limit", "outputFormat"];
+function newBorn(opts = { now: 1_000_000 }) {
+    return birthMortalWrapper({
+        baseToolName: opts.base ?? "mneme.arena.judge",
+        baseArgs: ARGS,
+        ttlMs: opts.ttl ?? 1000,
+        deprecationGravityMs: opts.gravity ?? 500,
+        nowMs: opts.now,
+        secret: SECRET,
+    });
+}
+describe("v2.19.11 MORTAL WRAPPERS · birth", () => {
+    it("births a generation-1 wrapper with alive=true, hmac-signed, alias suffixed gen1", () => {
+        const w = newBorn({ now: 1_000_000 });
+        expect(w.generation).toBe(1);
+        expect(w.parentGeneration).toBeNull();
+        expect(w.alive).toBe(true);
+        expect(w.deprecatedUntil).toBeNull();
+        expect(w.signature.alias).toBe("mneme.mortal.arena.judge.gen1");
+        expect(Object.keys(w.signature.argRenameMap).sort()).toEqual(ARGS.slice().sort());
+        expect(w.signature.argOrder).toEqual(ARGS);
+        expect(w.expiresAt).toBe(w.birthAt + w.ttlMs);
+        const v = verifyMortalWrapper(w, SECRET);
+        expect(v.ok).toBe(true);
+    });
+    it("rejects forged hmac", () => {
+        const w = newBorn();
+        const forged = { ...w, hmac: "deadbeef".repeat(8) };
+        expect(verifyMortalWrapper(forged, SECRET).ok).toBe(false);
+    });
+    it("birthing two wrappers for the same base at different times produces different IDs", () => {
+        const a = newBorn({ now: 1_000_000 });
+        const b = newBorn({ now: 1_000_001 });
+        expect(a.id).not.toBe(b.id);
+    });
+});
+describe("v2.19.11 MORTAL WRAPPERS · mutateSignature", () => {
+    it("rename_optional_field renames an arg and updates argOrder", () => {
+        const w = newBorn();
+        const out = mutateSignature({
+            base: w.signature,
+            baseToolName: w.baseToolName,
+            baseArgs: ARGS,
+            nextGen: 2,
+            kind: "rename_optional_field",
+            rng: () => 0.0, // pick first lexicographic
+        });
+        expect(out.alias).toBe("mneme.mortal.arena.judge.gen2");
+        // One key is renamed with _g2 suffix
+        const renamed = Object.keys(out.argRenameMap).filter((k) => k.endsWith("_g2"));
+        expect(renamed.length).toBe(1);
+        // The renamed key still maps to a canonical base arg
+        expect(ARGS).toContain(out.argRenameMap[renamed[0]]);
+        // argOrder reflects the rename (no canonical version remains for that slot)
+        expect(out.argOrder).toContain(renamed[0]);
+    });
+    it("add_optional_param appends a drift_gN_xxx param", () => {
+        const w = newBorn();
+        const out = mutateSignature({
+            base: w.signature,
+            baseToolName: w.baseToolName,
+            baseArgs: ARGS,
+            nextGen: 3,
+            kind: "add_optional_param",
+            rng: () => 0.5,
+        });
+        expect(out.addedOptionalParams.length).toBe(1);
+        const fresh = out.addedOptionalParams[0];
+        expect(fresh.startsWith("_drift_g3_")).toBe(true);
+        expect(out.argOrder).toContain(fresh);
+    });
+    it("swap_arg_order reorders two positions", () => {
+        const w = newBorn();
+        const out = mutateSignature({
+            base: w.signature,
+            baseToolName: w.baseToolName,
+            baseArgs: ARGS,
+            nextGen: 4,
+            kind: "swap_arg_order",
+            rng: (() => { let i = 0; return () => [0.0, 0.99][i++]; })(),
+        });
+        // First and last swapped (rng → 0 and ~end)
+        expect(out.argOrder).not.toEqual(ARGS);
+        // But the same SET of args is preserved
+        expect([...out.argOrder].sort()).toEqual([...ARGS].sort());
+    });
+});
+describe("v2.19.11 MORTAL WRAPPERS · tickReincarnation", () => {
+    function stateWith(wrappers) {
+        return { v: 1, wrappers, calibration: [] };
+    }
+    it("does nothing when no wrappers have expired", () => {
+        const w = newBorn({ now: 1_000_000, ttl: 10_000 });
+        const out = tickReincarnation({
+            state: stateWith([w]),
+            baseToolArgs: { [w.baseToolName]: ARGS },
+            nowMs: 1_000_001, // far before expiry
+            rngSeed: 42,
+            secret: SECRET,
+        });
+        expect(out.expired.length).toBe(0);
+        expect(out.reincarnated.length).toBe(0);
+        expect(out.state.wrappers.length).toBe(1);
+        expect(out.state.wrappers[0].alive).toBe(true);
+    });
+    it("expires and reincarnates exactly one wrapper at expiry boundary", () => {
+        const w = newBorn({ now: 1_000_000, ttl: 1000, gravity: 500 });
+        const out = tickReincarnation({
+            state: stateWith([w]),
+            baseToolArgs: { [w.baseToolName]: ARGS },
+            nowMs: 1_001_000, // at expiry
+            rngSeed: 7,
+            secret: SECRET,
+        });
+        expect(out.expired.length).toBe(1);
+        expect(out.reincarnated.length).toBe(1);
+        // Parent is now deprecated, child is gen2 with parentGeneration=1
+        const parent = out.state.wrappers.find((x) => x.id === w.id);
+        expect(parent.alive).toBe(false);
+        expect(parent.deprecatedUntil).toBe(1_001_000 + 500);
+        const child = out.reincarnated[0];
+        expect(child.generation).toBe(2);
+        expect(child.parentGeneration).toBe(1);
+        expect(child.alive).toBe(true);
+        expect(child.mutationsApplied.length).toBe(1);
+        // Parent's new HMAC is valid (re-signed on deprecation)
+        expect(verifyMortalWrapper(parent, SECRET).ok).toBe(true);
+        expect(verifyMortalWrapper(child, SECRET).ok).toBe(true);
+    });
+    it("budget caps mutations per tick to MAX_TICK_BATCH=3 (even if 5 are due)", () => {
+        const bases = ["mneme.a.x", "mneme.b.y", "mneme.c.z", "mneme.d.w", "mneme.e.v"];
+        const wrappers = bases.map((b) => newBorn({ now: 1_000_000, ttl: 1000, gravity: 500, base: b }));
+        const out = tickReincarnation({
+            state: stateWith(wrappers),
+            baseToolArgs: Object.fromEntries(bases.map((b) => [b, ARGS])),
+            nowMs: 1_001_000,
+            budget: 10, // user asks for many but cap is 3
+            rngSeed: 1,
+            secret: SECRET,
+        });
+        expect(out.reincarnated.length).toBe(3);
+        expect(out.expired.length).toBe(3);
+    });
+    it("drops deprecated wrappers after their gravity window elapses", () => {
+        const w = newBorn({ now: 1_000_000, ttl: 1000, gravity: 500 });
+        const t1 = tickReincarnation({
+            state: stateWith([w]),
+            baseToolArgs: { [w.baseToolName]: ARGS },
+            nowMs: 1_001_000,
+            rngSeed: 1,
+            secret: SECRET,
+        });
+        // Parent expires at 1_001_500. Tick again after that.
+        const t2 = tickReincarnation({
+            state: t1.state,
+            baseToolArgs: { [w.baseToolName]: ARGS },
+            nowMs: 1_001_600,
+            rngSeed: 2,
+            secret: SECRET,
+        });
+        // Parent (gen1) should be gone; only the child (gen2) remains alive.
+        const aliveLineage = t2.state.wrappers.filter((x) => x.baseToolName === w.baseToolName);
+        expect(aliveLineage.length).toBe(1);
+        expect(aliveLineage[0].generation).toBe(2);
+    });
+    it("respects MAX_GENERATIONS_PER_BASE loop guard", () => {
+        // Manually craft a gen=100 wrapper that is about to expire.
+        const expired = birthMortalWrapper({
+            baseToolName: "mneme.cap.test",
+            baseArgs: ARGS,
+            ttlMs: 1000,
+            nowMs: 1_000_000,
+            secret: SECRET,
+        });
+        // Build a gen-100 sibling that already exists in the lineage.
+        const gen100 = { ...expired, generation: 100, id: "mw-fake100", alive: true, expiresAt: 999 };
+        const state = { v: 1, wrappers: [gen100], calibration: [] };
+        const out = tickReincarnation({
+            state,
+            baseToolArgs: { "mneme.cap.test": ARGS },
+            nowMs: 2000,
+            rngSeed: 1,
+            secret: SECRET,
+        });
+        expect(out.reincarnated.length).toBe(0);
+        expect(out.skippedAtMaxGen).toContain("mneme.cap.test");
+    });
+});
+describe("v2.19.11 MORTAL WRAPPERS · resolveMortalCall", () => {
+    it("resolves a live alias and translates renamed keys back to base args", () => {
+        const w = newBorn({ now: 1_000_000 });
+        const state = tickReincarnation({
+            state: { v: 1, wrappers: [w], calibration: [] },
+            baseToolArgs: { [w.baseToolName]: ARGS },
+            nowMs: w.expiresAt, // force reincarnation
+            rngSeed: 11,
+            secret: SECRET,
+        }).state;
+        const child = state.wrappers.find((x) => x.alive);
+        // Call the child with its current schema — should translate cleanly.
+        const childArgs = {};
+        for (const [mortalKey, baseKey] of Object.entries(child.signature.argRenameMap)) {
+            childArgs[mortalKey] = `value-of-${baseKey}`;
+        }
+        const r = resolveMortalCall({
+            alias: child.signature.alias,
+            args: childArgs,
+            state,
+            nowMs: child.birthAt + 1,
+        });
+        expect(r.ok).toBe(true);
+        expect(r.baseToolName).toBe(w.baseToolName);
+        expect(r.deprecated).toBe(false);
+        expect(Object.keys(r.baseArgs).sort()).toEqual(ARGS.slice().sort());
+    });
+    it("flags a deprecated parent alias as deprecated=true (still callable during gravity)", () => {
+        const w = newBorn({ now: 1_000_000, ttl: 1000, gravity: 500 });
+        const state = tickReincarnation({
+            state: { v: 1, wrappers: [w], calibration: [] },
+            baseToolArgs: { [w.baseToolName]: ARGS },
+            nowMs: 1_001_000,
+            rngSeed: 11,
+            secret: SECRET,
+        }).state;
+        const args = Object.fromEntries(ARGS.map((a) => [a, `v-${a}`]));
+        const r = resolveMortalCall({
+            alias: "mneme.mortal.arena.judge.gen1",
+            args,
+            state,
+            nowMs: 1_001_100, // inside gravity
+        });
+        expect(r.ok).toBe(true);
+        expect(r.deprecated).toBe(true);
+    });
+    it("refuses a fully-expired alias past gravity and offers a live sibling hint", () => {
+        const w = newBorn({ now: 1_000_000, ttl: 1000, gravity: 500 });
+        const state = tickReincarnation({
+            state: { v: 1, wrappers: [w], calibration: [] },
+            baseToolArgs: { [w.baseToolName]: ARGS },
+            nowMs: 1_001_000,
+            rngSeed: 11,
+            secret: SECRET,
+        }).state;
+        const r = resolveMortalCall({
+            alias: "mneme.mortal.arena.judge.gen1",
+            args: { topic: "x" },
+            state,
+            nowMs: 1_002_000, // way past gravity
+        });
+        expect(r.ok).toBe(false);
+        expect(r.hint).toBeDefined();
+        expect(r.hint).toContain("mneme.mortal.arena.judge.gen2");
+    });
+    it("flags AI-agent overfit by failing on unknown keys with a helpful hint", () => {
+        const w = newBorn({ now: 1_000_000 });
+        const state = { v: 1, wrappers: [w], calibration: [] };
+        const r = resolveMortalCall({
+            alias: w.signature.alias,
+            args: { topic: "x", THIS_IS_STALE_FROM_GEN_MINUS_ONE: 42 },
+            state,
+        });
+        expect(r.ok).toBe(false);
+        expect(r.reason).toContain("schema drifted");
+        expect(r.hint).toContain("topic");
+    });
+    it("silently drops drift-bonus params (they're calibration tripwires, not errors)", () => {
+        const w = newBorn({ now: 1_000_000 });
+        // Manually inject an addedOptionalParam via mutation
+        const drifted = mutateSignature({
+            base: w.signature,
+            baseToolName: w.baseToolName,
+            baseArgs: ARGS,
+            nextGen: 2,
+            kind: "add_optional_param",
+            rng: () => 0.3,
+        });
+        const driftedWrapper = { ...w, signature: drifted };
+        const state = { v: 1, wrappers: [driftedWrapper], calibration: [] };
+        const fresh = drifted.addedOptionalParams[0];
+        const r = resolveMortalCall({
+            alias: drifted.alias,
+            args: { topic: "x", limit: 5, outputFormat: "json", [fresh]: "ignored" },
+            state,
+        });
+        expect(r.ok).toBe(true);
+        expect(r.baseArgs).not.toHaveProperty(fresh);
+    });
+});
+describe("v2.19.11 MORTAL WRAPPERS · calibration telemetry", () => {
+    it("calibration score climbs as the caller succeeds; verdict bands report adaptiveness", () => {
+        let state = emptyState();
+        for (let i = 0; i < 19; i++)
+            state = recordCalibration({ state, callerKey: "ai-fast-learner", alias: "x", ok: true });
+        state = recordCalibration({ state, callerKey: "ai-fast-learner", alias: "x", ok: false });
+        const s = calibrationScore({ state, callerKey: "ai-fast-learner" });
+        expect(s.totalCalls).toBe(20);
+        expect(s.successfulCalls).toBe(19);
+        expect(s.adaptivenessScore).toBeCloseTo(0.95, 5);
+        expect(s.verdict).toBe("world_class");
+    });
+    it("an AI that keeps failing earns the over_fit verdict", () => {
+        let state = emptyState();
+        for (let i = 0; i < 10; i++)
+            state = recordCalibration({ state, callerKey: "ai-overfitter", alias: "y", ok: false });
+        for (let i = 0; i < 2; i++)
+            state = recordCalibration({ state, callerKey: "ai-overfitter", alias: "y", ok: true });
+        const s = calibrationScore({ state, callerKey: "ai-overfitter" });
+        expect(s.verdict).toBe("over_fit");
+    });
+    it("low sample size returns the cautious 'drifting' verdict (not enough signal)", () => {
+        let state = emptyState();
+        for (let i = 0; i < 3; i++)
+            state = recordCalibration({ state, callerKey: "ai-newbie", alias: "z", ok: true });
+        const s = calibrationScore({ state, callerKey: "ai-newbie" });
+        expect(s.verdict).toBe("drifting");
+    });
+    it("zero calls returns 0 with drifting verdict", () => {
+        const state = emptyState();
+        const s = calibrationScore({ state, callerKey: "never-called" });
+        expect(s.totalCalls).toBe(0);
+        expect(s.adaptivenessScore).toBe(0);
+        expect(s.verdict).toBe("drifting");
+    });
+});
+describe("v2.19.11 MORTAL WRAPPERS · globalStats", () => {
+    it("aggregates alive / deprecated / mutation histogram correctly across many generations", () => {
+        // 3 lineages, each reincarnated 4 times (gen5 lives, gen1-4 deprecated)
+        let state = emptyState();
+        let now = 1_000_000;
+        for (const base of ["mneme.x.a", "mneme.y.b", "mneme.z.c"]) {
+            state = { ...state, wrappers: [...state.wrappers, birthMortalWrapper({ baseToolName: base, baseArgs: ARGS, ttlMs: 1000, deprecationGravityMs: 10_000_000, nowMs: now, secret: SECRET })] };
+        }
+        for (let i = 0; i < 4; i++) {
+            const t = tickReincarnation({
+                state,
+                baseToolArgs: { "mneme.x.a": ARGS, "mneme.y.b": ARGS, "mneme.z.c": ARGS },
+                nowMs: now + 1000 + i * 1000,
+                budget: 3,
+                rngSeed: 100 + i,
+                secret: SECRET,
+            });
+            state = t.state;
+        }
+        const s = globalStats(state);
+        // 3 lineages × 5 generations = 15 wrappers; 3 alive (latest gen of each), 12 deprecated
+        expect(s.uniqueBaseTools).toBe(3);
+        expect(s.alive).toBe(3);
+        expect(s.deprecated).toBe(12);
+        expect(s.totalGenerationsAcrossLineages).toBe(15);
+        // Each lineage carries 4 cumulative mutations on gen5 (plus 3+2+1+0 on lower gens). Just sanity-check non-zero.
+        expect(s.totalMutationsApplied).toBeGreaterThan(0);
+        const histSum = Object.values(s.mutationKindHistogram).reduce((a, b) => a + b, 0);
+        expect(histSum).toBe(s.totalMutationsApplied);
+    });
+});
+describe("v2.19.11 MORTAL WRAPPERS · formatters + edge cases", () => {
+    it("formatter shows 🌱 for alive and 💀 for deprecated", () => {
+        const w = newBorn();
+        expect(formatWrapperLine(w)).toContain("🌱");
+        const dead = { ...w, alive: false };
+        expect(formatWrapperLine(dead)).toContain("💀");
+    });
+    it("resolve on unknown alias returns helpful error message", () => {
+        const r = resolveMortalCall({ alias: "mneme.mortal.does.not.exist.gen1", args: {}, state: emptyState() });
+        expect(r.ok).toBe(false);
+        expect(r.reason).toContain("unknown");
+    });
+});
+//# sourceMappingURL=mortal_wrappers.test.js.map

package/dist/mortal_wrappers/mortal_wrappers.test.js.map

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

package/dist/proof_carrying/index.d.ts

@@ -0,0 +1,100 @@
+/**
+ * v2.19.10 — MNEME PROOF-CARRYING WRAPPER (zero-trust tool chain)
+ *
+ *   "Every tool output carries a cryptographic certificate attesting:
+ *      • which tool produced it
+ *      • what input produced it (sha256 of canonical input)
+ *      • when it was produced (ISO ts)
+ *      • who the caller was (AI-agent fingerprint key)
+ *      • what proof this output depends on (chain parent ID)
+ *    A downstream tool with `requiresParentProof: true` REFUSES to run
+ *    unless the supplied input.parentProof verifies. Prompt-injection
+ *    that fakes a tool output → fails sig → rejected. Ad-hoc tool
+ *    chains AI agents try to assemble → fail because chain is broken.
+ *    Regulators get a cryptographic chain-of-custody for every call.
+ *
+ *    First MCP primitive in the field with cryptographic identity
+ *    BETWEEN tools."
+ *
+ * Honest scope:
+ *   - HMAC-signed (single secret per Mneme instance); not yet asymmetric
+ *     PKI. Future v2.20 may add Ed25519 keypairs per AI agent.
+ *   - `parentProof` is single-parent; for fan-in chains use the latest
+ *     parent + record siblings in the proof's metadata.
+ *   - Loop detection: chain depth cap (default 32) + chainParent
+ *     duplicate detection.
+ *
+ * Composes onto every existing MCP tool (opt-in). Pure additive layer.
+ */
+declare const PROTOCOL_VERSION: 1;
+export interface ProofMetadata {
+    v: typeof PROTOCOL_VERSION;
+    proofId: string;
+    toolName: string;
+    inputSha256: string;
+    outputSha256: string;
+    callerKey: string;
+    chainParent: string | null;
+    chainDepth: number;
+    ts: string;
+    hmac: string;
+}
+export interface ProofedOutput<T = unknown> {
+    data: T;
+    proof: ProofMetadata;
+}
+export interface AttachProofInput<T> {
+    toolName: string;
+    input: unknown;
+    output: T;
+    callerKey: string;
+    parentProof?: ProofMetadata | null;
+    ts?: string;
+    secret?: string;
+}
+export declare function attachProof<T>(input: AttachProofInput<T>): ProofedOutput<T>;
+export interface VerifyResult {
+    ok: boolean;
+    reason?: string;
+}
+/** Verify ONE proof in isolation against the data it carries. */
+export declare function verifyProof(proofed: ProofedOutput, secret?: string): VerifyResult;
+/**
+ * Verify a chain of proofs. Caller passes the proofs in order
+ * (rootmost → most recent). Returns ok=true iff:
+ *   - each proof verifies in isolation
+ *   - each proof's chainParent equals the previous proof's proofId
+ *   - no two proofs share the same proofId (loop detection)
+ *   - chainDepth is strictly increasing
+ */
+export declare function verifyChain(proofedList: ProofedOutput[], secret?: string): {
+    ok: boolean;
+    brokenAt?: number;
+    reason?: string;
+    dagDepth: number;
+};
+/**
+ * Gate decorator: an MCP tool that requires its caller to supply a
+ * verifiable parentProof. Returns a wrapped handler that throws if the
+ * input is missing parentProof OR the proof doesn't verify.
+ *
+ * The wrapper then RUNS the inner handler and attaches a fresh proof
+ * with chainParent pointing at the supplied parentProof.
+ */
+export declare function requireParentProof<TArgs extends {
+    parentProof?: ProofMetadata;
+}, TOut>(opts: {
+    toolName: string;
+    callerKey: string;
+    inner: (args: TArgs) => Promise<TOut> | TOut;
+    secret?: string;
+}): (args: TArgs) => Promise<ProofedOutput<TOut>>;
+/** Build a fingerprint key for an AI agent: stable per (vendor + session-id + repo). */
+export declare function fingerprintCaller(input: {
+    vendor: string;
+    sessionId?: string;
+    repoPath?: string;
+}): string;
+export declare function formatProofLine(p: ProofMetadata): string;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/proof_carrying/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,QAAA,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAGpC,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,aAAa,CAAC;CACtB;AA0BD,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,CAAC,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAyB3E;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,CAejF;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,aAAa,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG;IAC1E,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CA2BA;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,SAAS;IAAE,WAAW,CAAC,EAAE,aAAa,CAAA;CAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IAC5F,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAuBhD;AAED,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAI1G;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAGxD"}