@mneme-ai/core 2.14.1 → 2.15.1

package/dist/arbitrage/index.js

@@ -0,0 +1,242 @@
+/**
+ * v2.15.0 — MNEME ARBITRAGE
+ *
+ *   "For every AI prompt, route to the cheapest vendor with acceptable
+ *    quality. Quality measured by BOUNTY's per-vendor falseRate AND
+ *    HIVE's per-pattern outcome history. Cost measured per token from
+ *    a maintained price table. Outcome feeds back into BOUNTY → router
+ *    learns over time."
+ *
+ * The hypercar feature: meta-AI router that gets BETTER as you use
+ * Mneme. After ~50 prompts, the router beats hand-picking — because it
+ * knows YOUR distribution of tasks + each vendor's measured trustability
+ * for that task class.
+ *
+ * Pure-function design (no network) — `chooseVendor` returns the
+ * recommended vendor + rationale. The caller routes the prompt.
+ * Optional `recordOutcome` feeds results back into BOUNTY.
+ *
+ * Wisdom: composes BOUNTY (vendor falseRate) + REPLICA (your historical
+ * decisions) + a price table. Never re-implements anything; pure
+ * orchestrator.
+ */
+import { createHmac } from "node:crypto";
+const PROTOCOL_VERSION = 1;
+/**
+ * Default vendor capability table. ORDER OF MAGNITUDE estimates only —
+ * actual values shift weekly. Real signal comes from your BOUNTY ledger
+ * once you have ≥50 samples per vendor.
+ */
+export const DEFAULT_VENDORS = [
+    {
+        vendor: "claude",
+        pricePer1kInput: 0.015, pricePer1kOutput: 0.075,
+        strengthByTask: {
+            code_generation: 0.92, code_review: 0.95, debugging: 0.93,
+            refactoring: 0.94, explanation: 0.95, structured_output: 0.93,
+            function_calling: 0.94, agentic_workflow: 0.95,
+            test_writing: 0.90, documentation: 0.93,
+        },
+        hasFree: false, fastPath: true, functionCalls: true,
+    },
+    {
+        vendor: "chatgpt",
+        pricePer1kInput: 0.01, pricePer1kOutput: 0.03,
+        strengthByTask: {
+            code_generation: 0.88, debugging: 0.85, refactoring: 0.84,
+            explanation: 0.92, summarization: 0.91, translation: 0.93,
+            creative_writing: 0.93, data_analysis: 0.88,
+            research: 0.86, structured_output: 0.90, function_calling: 0.92,
+        },
+        hasFree: true, fastPath: true, functionCalls: true,
+    },
+    {
+        vendor: "gemini",
+        pricePer1kInput: 0.0035, pricePer1kOutput: 0.0105,
+        strengthByTask: {
+            code_generation: 0.85, summarization: 0.93, translation: 0.92,
+            research: 0.95, data_analysis: 0.93, explanation: 0.88,
+            structured_output: 0.89, function_calling: 0.90,
+        },
+        hasFree: true, fastPath: true, functionCalls: true,
+    },
+    {
+        vendor: "deepseek",
+        pricePer1kInput: 0.00027, pricePer1kOutput: 0.0011,
+        strengthByTask: {
+            code_generation: 0.86, debugging: 0.85, refactoring: 0.83,
+            structured_output: 0.85, function_calling: 0.84,
+            test_writing: 0.83,
+        },
+        hasFree: false, fastPath: true, functionCalls: true,
+    },
+    {
+        vendor: "qwen",
+        pricePer1kInput: 0.0004, pricePer1kOutput: 0.0012,
+        strengthByTask: {
+            code_generation: 0.82, summarization: 0.86, translation: 0.91,
+            structured_output: 0.83,
+        },
+        hasFree: true, fastPath: true, functionCalls: true,
+    },
+    {
+        vendor: "llama",
+        pricePer1kInput: 0, pricePer1kOutput: 0,
+        strengthByTask: {
+            code_generation: 0.78, summarization: 0.84, translation: 0.85,
+            explanation: 0.83,
+        },
+        hasFree: true, fastPath: false, functionCalls: false,
+    },
+    {
+        vendor: "perplexity",
+        pricePer1kInput: 0.001, pricePer1kOutput: 0.001,
+        strengthByTask: {
+            research: 0.96, summarization: 0.92, explanation: 0.88,
+            data_analysis: 0.85,
+        },
+        hasFree: true, fastPath: true, functionCalls: false,
+    },
+];
+const QUALITY_THRESHOLD = {
+    ultra: 0.92, high: 0.85, balanced: 0.78, cheap: 0.70, free_only: 0.0,
+};
+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_ARBITRAGE_SECRET"] || `mneme-arbitrage-v${PROTOCOL_VERSION}`;
+}
+/**
+ * Recommend a vendor for a task. Pure function — does NOT call any AI.
+ *
+ * Algorithm:
+ *   1. For each candidate, compute qualityScore = strengthByTask[task]
+ *      (default 0.7 if unknown). If measured BOUNTY data exists for the
+ *      vendor, blend it in (qualityScore *= (1 - falseRateLB)).
+ *   2. Filter by qualityScore >= threshold[budget].
+ *   3. Compute estCost = (estTokens.input * pricePer1kInput + estTokens.
+ *      output * pricePer1kOutput) / 1000.
+ *   4. Score = qualityScore / max(estCost, 0.0001) — best quality per $.
+ *   5. Pick top scorer; provide ordered fallback.
+ */
+export function chooseVendor(input) {
+    const vendors = input.vendors ?? DEFAULT_VENDORS;
+    const budget = input.budget ?? "balanced";
+    const threshold = QUALITY_THRESHOLD[budget];
+    const tokens = input.estTokens ?? { input: 1000, output: 500 };
+    const candidates = vendors.filter((v) => !input.candidates || input.candidates.includes(v.vendor));
+    const considered = candidates.map((v) => {
+        const baseStrength = v.strengthByTask[input.task] ?? 0.7;
+        let qualityScore = baseStrength;
+        let scoreReason = `default strength ${baseStrength.toFixed(2)} on ${input.task}`;
+        const measured = input.measured?.[v.vendor];
+        if (measured && measured.samples >= 5) {
+            // Blend: measured trustworthiness penalty.
+            const adjustment = 1 - measured.falseRateLB;
+            qualityScore = baseStrength * adjustment;
+            scoreReason = `measured ${measured.samples} samples · falseRateLB ${measured.falseRateLB.toFixed(3)}`;
+        }
+        const estCostUsd = (tokens.input * v.pricePer1kInput + tokens.output * v.pricePer1kOutput) / 1000;
+        // Free tier respected when budget = free_only
+        const eligible = budget === "free_only"
+            ? v.hasFree
+            : qualityScore >= threshold;
+        const score = eligible
+            ? qualityScore / Math.max(estCostUsd, 0.0001)
+            : 0;
+        return {
+            vendor: v.vendor,
+            score: Math.round(score * 100) / 100,
+            qualityScore: Math.round(qualityScore * 1000) / 1000,
+            estCostUsd: Math.round(estCostUsd * 100000) / 100000,
+            eligible,
+            reason: scoreReason,
+        };
+    }).sort((a, b) => b.score - a.score);
+    const eligibleSorted = considered.filter((c) => c.eligible);
+    const top = eligibleSorted[0];
+    let decision = null;
+    let reason = "no candidate met the quality threshold";
+    if (top) {
+        const maxCost = Math.max(...eligibleSorted.map((c) => c.estCostUsd));
+        decision = {
+            vendor: top.vendor,
+            qualityScore: top.qualityScore,
+            estCostUsd: top.estCostUsd,
+            savingsVsTopUsd: Math.round((maxCost - top.estCostUsd) * 100000) / 100000,
+            fallback: eligibleSorted.slice(1, 4).map((c) => c.vendor),
+        };
+        reason = `${top.vendor} wins: quality ${top.qualityScore}, cost $${top.estCostUsd}, fallback=${decision.fallback.join(",") || "none"}`;
+    }
+    const generatedAt = new Date().toISOString();
+    const body = {
+        v: PROTOCOL_VERSION,
+        decision, reason, considered, generatedAt,
+    };
+    const sig = createHmac("sha256", input.secret ?? defaultSecret()).update(canon(body)).digest("hex");
+    return { ...body, sig };
+}
+/**
+ * Estimate token count from text length. Cheap heuristic — ~4 chars/
+ * token English; ~6 chars/token for code; ~2 chars/token for CJK.
+ */
+export function estimateTokens(text, opts = {}) {
+    const kind = opts.kind ?? "english";
+    const charsPerToken = kind === "code" ? 6 : kind === "cjk" ? 2 : 4;
+    return Math.ceil(text.length / charsPerToken);
+}
+/**
+ * After a routed request returns, record the outcome to feed back into
+ * BOUNTY for next-time routing. Composes onto the existing v2.14
+ * BOUNTY module — does not duplicate.
+ */
+export async function recordRoutingOutcome(input) {
+    try {
+        const bounty = await import("../bounty/index.js");
+        const claim = bounty.recordClaim({
+            vendor: input.vendor,
+            text: `[arbitrage] task=${input.task}`,
+            session: "arbitrage",
+            ...(input.repoDir ? { repoDir: input.repoDir } : {}),
+        });
+        bounty.recordVerdict({
+            claimId: claim.id,
+            vendor: input.vendor,
+            verdict: input.outcome === "correct" ? "true" : input.outcome === "wrong" ? "false" : "partial",
+            reason: input.detail.slice(0, 400),
+            ...(input.repoDir ? { repoDir: input.repoDir } : {}),
+        });
+    }
+    catch { /* bounty unavailable; non-fatal */ }
+}
+/**
+ * Read measured falseRateLB per vendor from BOUNTY for richer routing.
+ * Returns the input shape that chooseVendor accepts as `measured`.
+ */
+export async function snapshotMeasured(opts = {}) {
+    const out = {};
+    try {
+        const bounty = await import("../bounty/index.js");
+        const board = bounty.leaderboard({ ...(opts.repoDir ? { repoDir: opts.repoDir } : {}) });
+        for (const card of board) {
+            out[card.vendor] = { falseRateLB: card.falseRateLB, samples: card.totalVerdicts };
+        }
+    }
+    catch { /* bounty unavailable */ }
+    return out;
+}
+/** One-line pulse summary. */
+export function formatArbitrageLine(result) {
+    if (!result)
+        return "ARBITRAGE · idle";
+    if (!result.decision)
+        return `ARBITRAGE · NO MATCH (${result.considered.length} considered)`;
+    return `ARBITRAGE · ${result.decision.vendor} · q=${result.decision.qualityScore} · $${result.decision.estCostUsd} · save $${result.decision.savingsVsTopUsd}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/arbitrage/index.js.map

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

package/dist/bug_prophet/bug_prophet.test.d.ts

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

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

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

package/dist/bug_prophet/bug_prophet.test.js

@@ -0,0 +1,110 @@
+import { describe, it, expect } from "vitest";
+import { prophesy, formatBugProphetLine } from "./index.js";
+describe("v2.15.1 · MNEME BUG PROPHET — pre-bug detection", () => {
+    it("baseline empty corpora → low_risk verdict", async () => {
+        const r = await prophesy({ change: { description: "add a getter" }, stubs: {} });
+        expect(r.verdict).toBe("low_risk");
+        expect(r.regressionRisk).toBeLessThan(0.25);
+        expect(r.sig).toMatch(/^[0-9a-f]{64}$/);
+    });
+    it("SOUL scar match → high_risk", async () => {
+        const r = await prophesy({
+            change: { description: "deploy on Friday afternoon" },
+            stubs: {
+                soulFindings: { findings: [{ category: "scars", ruleId: "no-friday-deploys", severity: "block" }] },
+            },
+        });
+        expect(["high_risk", "very_high_risk"]).toContain(r.verdict);
+        expect(r.evidence.some((e) => e.source === "soul_scar")).toBe(true);
+    });
+    it("HIVE pattern with 80% bad outcomes → very_high_risk", async () => {
+        const r = await prophesy({
+            change: { description: "refactor auth flow" },
+            stubs: {
+                hiveLookup: {
+                    totalObservations: 20,
+                    byOutcome: { good: 4, bad: 12, regression: 4, unknown: 0 },
+                },
+            },
+        });
+        expect(["high_risk", "very_high_risk"]).toContain(r.verdict);
+        expect(r.evidence.some((e) => e.source === "hive_regression")).toBe(true);
+    });
+    it("BOUNTY high vendor falseRateLB → adds evidence + bumps risk", async () => {
+        const a = await prophesy({
+            change: { description: "small typo fix", proposedBy: "claude" },
+            stubs: { bountyFalseRateLB: 0.6 },
+        });
+        const b = await prophesy({
+            change: { description: "small typo fix", proposedBy: "claude" },
+            stubs: { bountyFalseRateLB: 0.0 },
+        });
+        expect(a.regressionRisk).toBeGreaterThan(b.regressionRisk);
+        expect(a.evidence.some((e) => e.source === "bounty_trust")).toBe(true);
+    });
+    it("compounding evidence: scar + replica bad + hive bad → very_high_risk", async () => {
+        const r = await prophesy({
+            change: { description: "deploy on Friday", proposedBy: "claude" },
+            stubs: {
+                soulFindings: { findings: [{ category: "scars", ruleId: "friday-deploy-incident", severity: "block" }] },
+                replicaSimilarBad: [{ question: "Friday afternoon deploy?", action: "shipped anyway" }],
+                hiveLookup: { totalObservations: 10, byOutcome: { good: 2, bad: 6, regression: 2, unknown: 0 } },
+                bountyFalseRateLB: 0.4,
+            },
+        });
+        expect(r.verdict).toBe("very_high_risk");
+        expect(r.regressionRisk).toBeGreaterThan(0.7);
+    });
+    it("mitigations include scar-specific advice when scar evidence present", async () => {
+        const r = await prophesy({
+            change: { description: "Friday deploy" },
+            stubs: { soulFindings: { findings: [{ category: "scars", ruleId: "x", severity: "block" }] } },
+        });
+        expect(r.mitigations.some((m) => /scar|past self/i.test(m))).toBe(true);
+    });
+    it("complexity heuristic surfaces evidence at score > 0.5", async () => {
+        const lots = Array.from({ length: 250 }, (_, i) => `function f${i}() { if (x) { for (let j = 0; j < 10; j++) try { call(); } catch (e) {} } }`).join("\n");
+        const r = await prophesy({
+            change: { description: "big refactor", content: lots, files: Array.from({ length: 10 }, (_, i) => `src/${i}.ts`) },
+            stubs: { complexityScore: 0.8 },
+        });
+        expect(r.evidence.some((e) => e.source === "complexity")).toBe(true);
+    });
+    it("low confidence on empty corpora (≤0.55)", async () => {
+        const r = await prophesy({ change: { description: "x" }, stubs: {} });
+        expect(r.confidence).toBeLessThanOrEqual(0.55);
+    });
+    it("confidence rises with richer corpora", async () => {
+        const r = await prophesy({
+            change: { description: "x" },
+            stubs: {
+                soulFindings: { findings: [] },
+                replicaBadCount: 50,
+                hiveLookup: { totalObservations: 100, byOutcome: { good: 80, bad: 10, regression: 10, unknown: 0 } },
+            },
+        });
+        expect(r.confidence).toBeGreaterThan(0.55);
+    });
+    it("HMAC sig on full report", async () => {
+        const r = await prophesy({ change: { description: "x" }, stubs: {} });
+        expect(r.sig).toMatch(/^[0-9a-f]{64}$/);
+    });
+    it("formatBugProphetLine summarises", async () => {
+        const r = await prophesy({ change: { description: "x" }, stubs: {} });
+        expect(formatBugProphetLine(r)).toContain("BUG PROPHET");
+        expect(formatBugProphetLine(r)).toContain("%");
+    });
+    it("verdict buckets are monotonic with risk", async () => {
+        const lo = await prophesy({ change: { description: "noop" }, stubs: {} });
+        const hi = await prophesy({
+            change: { description: "deploy on Friday", proposedBy: "claude" },
+            stubs: {
+                soulFindings: { findings: [{ category: "scars", ruleId: "x", severity: "block" }] },
+                hiveLookup: { totalObservations: 20, byOutcome: { good: 1, bad: 15, regression: 4, unknown: 0 } },
+                bountyFalseRateLB: 0.6,
+            },
+        });
+        expect(hi.regressionRisk).toBeGreaterThan(lo.regressionRisk);
+    });
+});
+//# sourceMappingURL=bug_prophet.test.js.map

package/dist/bug_prophet/bug_prophet.test.js.map

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

package/dist/bug_prophet/index.d.ts

@@ -0,0 +1,85 @@
+/**
+ * v2.15.1 — MNEME BUG PROPHET
+ *
+ *   "Predict bugs before they happen. The signal is already in your
+ *    Mneme data: PROJECT SOUL scars name the patterns you've paid for,
+ *    REPLICA decisions hold the outcomes, HIVE knows what patterns
+ *    fail elsewhere, BOUNTY tracks which vendor lied last. BUG PROPHET
+ *    fuses these four into a 0..1 regression risk for any proposed
+ *    change — BEFORE you ship it."
+ *
+ * The Nobel move: BUG PROPHET doesn't run any LLM. Pure inference over
+ * existing Mneme data + the proposed change. Returns:
+ *   - regressionRisk (0..1)
+ *   - aggregated evidence from SOUL / REPLICA / HIVE / BOUNTY
+ *   - mitigations tailored to the evidence
+ *
+ * Composes orthogonally with the existing v2.1 `prophet/` (which
+ * pre-fetches next-query topics) — different concern, different dir.
+ *
+ * Wisdom: BUG PROPHET gets stronger over time. Day 1 = conservative
+ * heuristic baseline. Day 90 with rich SOUL+REPLICA+HIVE+BOUNTY = real
+ * predictive power.
+ */
+declare const PROTOCOL_VERSION: 1;
+export interface ProposedChange {
+    description: string;
+    files?: string[];
+    addsDeps?: string[];
+    content?: string;
+    /** Which AI vendor proposed it — used for BOUNTY trust weighting. */
+    proposedBy?: string;
+    /** Task class for routing context. */
+    taskClass?: string;
+}
+export interface PropheticEvidence {
+    source: "soul_scar" | "replica_bad" | "hive_regression" | "bounty_trust" | "complexity" | "soul_block";
+    weight: number;
+    detail: string;
+    ref?: string;
+}
+export interface PropheticReport {
+    v: typeof PROTOCOL_VERSION;
+    regressionRisk: number;
+    confidence: number;
+    verdict: "low_risk" | "medium_risk" | "high_risk" | "very_high_risk";
+    headline: string;
+    evidence: PropheticEvidence[];
+    mitigations: string[];
+    signedAt: string;
+    sig: string;
+}
+export interface ProphesyInput {
+    change: ProposedChange;
+    repoDir?: string;
+    stubs?: {
+        soulFindings?: {
+            findings: Array<{
+                category: string;
+                ruleId: string;
+                severity: "warn" | "block";
+            }>;
+        };
+        replicaBadCount?: number;
+        replicaSimilarBad?: Array<{
+            question: string;
+            action: string;
+        }>;
+        hiveLookup?: {
+            totalObservations: number;
+            byOutcome: {
+                good: number;
+                bad: number;
+                regression: number;
+                unknown: number;
+            };
+        };
+        bountyFalseRateLB?: number;
+        complexityScore?: number;
+    };
+    secret?: string;
+}
+export declare function prophesy(input: ProphesyInput): Promise<PropheticReport>;
+export declare function formatBugProphetLine(r: PropheticReport): string;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bug_prophet/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,QAAA,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAEpC,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,GAAG,aAAa,GAAG,iBAAiB,GAAG,cAAc,GAAG,YAAY,GAAG,YAAY,CAAC;IACvG,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,UAAU,GAAG,aAAa,GAAG,WAAW,GAAG,gBAAgB,CAAC;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AA+BD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,YAAY,CAAC,EAAE;YAAE,QAAQ,EAAE,KAAK,CAAC;gBAAE,QAAQ,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAC;gBAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;QACrG,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAChE,UAAU,CAAC,EAAE;YAAE,iBAAiB,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,GAAG,EAAE,MAAM,CAAC;gBAAC,UAAU,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC;QAC1H,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAgI7E;AAyBD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAE/D"}