@blockrun/clawrouter 0.12.95 → 0.12.96

package/dist/journal.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Session Journal - Memory layer for ClawRouter
+ *
+ * Maintains a compact record of key actions per session, enabling agents
+ * to recall earlier work even when OpenClaw's sessions_history is truncated.
+ *
+ * How it works:
+ * 1. As LLM responses flow through, extracts key actions ("I created X", "I fixed Y")
+ * 2. Stores them in a compact journal per session
+ * 3. When a request mentions past work ("what did you do today?"), injects the journal
+ */
+export interface JournalEntry {
+    timestamp: number;
+    action: string;
+    model?: string;
+}
+export interface SessionJournalConfig {
+    /** Maximum entries per session (default: 100) */
+    maxEntries?: number;
+    /** Maximum age of entries in ms (default: 24 hours) */
+    maxAgeMs?: number;
+    /** Maximum events to extract per response (default: 5) */
+    maxEventsPerResponse?: number;
+}
+export declare class SessionJournal {
+    private journals;
+    private config;
+    constructor(config?: SessionJournalConfig);
+    /**
+     * Extract key events from assistant response content.
+     * Looks for patterns like "I created...", "I fixed...", "Successfully..."
+     */
+    extractEvents(content: string): string[];
+    /**
+     * Record events to the session journal.
+     */
+    record(sessionId: string, events: string[], model?: string): void;
+    /**
+     * Check if the user message indicates a need for historical context.
+     */
+    needsContext(lastUserMessage: string): boolean;
+    /**
+     * Format the journal for injection into system message.
+     * Returns null if journal is empty.
+     */
+    format(sessionId: string): string | null;
+    /**
+     * Get the raw journal entries for a session (for debugging/testing).
+     */
+    getEntries(sessionId: string): JournalEntry[];
+    /**
+     * Clear journal for a specific session.
+     */
+    clear(sessionId: string): void;
+    /**
+     * Clear all journals.
+     */
+    clearAll(): void;
+    /**
+     * Get stats about the journal.
+     */
+    getStats(): {
+        sessions: number;
+        totalEntries: number;
+    };
+}
+//# sourceMappingURL=journal.d.ts.map

package/dist/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../src/journal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAQD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,MAAM,CAAiC;gBAEnC,MAAM,CAAC,EAAE,oBAAoB;IAIzC;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IA2DxC;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAuBjE;;OAEG;IACH,YAAY,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO;IAqC9C;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAkBxC;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE;IAI7C;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;OAEG;IACH,QAAQ,IAAI;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;CAUvD"}

package/dist/journal.js

@@ -0,0 +1,184 @@
+/**
+ * Session Journal - Memory layer for ClawRouter
+ *
+ * Maintains a compact record of key actions per session, enabling agents
+ * to recall earlier work even when OpenClaw's sessions_history is truncated.
+ *
+ * How it works:
+ * 1. As LLM responses flow through, extracts key actions ("I created X", "I fixed Y")
+ * 2. Stores them in a compact journal per session
+ * 3. When a request mentions past work ("what did you do today?"), injects the journal
+ */
+const DEFAULT_CONFIG = {
+    maxEntries: 100,
+    maxAgeMs: 24 * 60 * 60 * 1000, // 24 hours
+    maxEventsPerResponse: 5,
+};
+export class SessionJournal {
+    journals = new Map();
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Extract key events from assistant response content.
+     * Looks for patterns like "I created...", "I fixed...", "Successfully..."
+     */
+    extractEvents(content) {
+        if (!content || typeof content !== "string") {
+            return [];
+        }
+        const events = [];
+        const seen = new Set();
+        // Patterns for identifying key actions
+        // Note: Patterns allow optional words like "also", "then", "have" between "I" and verb
+        const patterns = [
+            // Creation patterns
+            /I (?:also |then |have |)?(?:created|implemented|added|wrote|built|generated|set up|initialized) ([^.!?\n]{10,150})/gi,
+            // Fix patterns
+            /I (?:also |then |have |)?(?:fixed|resolved|solved|patched|corrected|addressed|debugged) ([^.!?\n]{10,150})/gi,
+            // Completion patterns
+            /I (?:also |then |have |)?(?:completed|finished|done with|wrapped up) ([^.!?\n]{10,150})/gi,
+            // Update patterns
+            /I (?:also |then |have |)?(?:updated|modified|changed|refactored|improved|enhanced|optimized) ([^.!?\n]{10,150})/gi,
+            // Success patterns
+            /Successfully ([^.!?\n]{10,150})/gi,
+            // Tool usage patterns (when agent uses tools)
+            /I (?:also |then |have |)?(?:ran|executed|called|invoked) ([^.!?\n]{10,100})/gi,
+        ];
+        for (const pattern of patterns) {
+            // Reset pattern lastIndex for each iteration
+            pattern.lastIndex = 0;
+            let match;
+            while ((match = pattern.exec(content)) !== null) {
+                const action = match[0].trim();
+                // Skip if already seen (dedup)
+                const normalized = action.toLowerCase();
+                if (seen.has(normalized)) {
+                    continue;
+                }
+                // Validate length (not too short or too long)
+                if (action.length >= 15 && action.length <= 200) {
+                    events.push(action);
+                    seen.add(normalized);
+                }
+                // Stop if we have enough events
+                if (events.length >= this.config.maxEventsPerResponse) {
+                    break;
+                }
+            }
+            if (events.length >= this.config.maxEventsPerResponse) {
+                break;
+            }
+        }
+        return events;
+    }
+    /**
+     * Record events to the session journal.
+     */
+    record(sessionId, events, model) {
+        if (!sessionId || !events.length) {
+            return;
+        }
+        const journal = this.journals.get(sessionId) || [];
+        const now = Date.now();
+        for (const action of events) {
+            journal.push({
+                timestamp: now,
+                action,
+                model,
+            });
+        }
+        // Trim old entries and enforce max count
+        const cutoff = now - this.config.maxAgeMs;
+        const trimmed = journal.filter((e) => e.timestamp > cutoff).slice(-this.config.maxEntries);
+        this.journals.set(sessionId, trimmed);
+    }
+    /**
+     * Check if the user message indicates a need for historical context.
+     */
+    needsContext(lastUserMessage) {
+        if (!lastUserMessage || typeof lastUserMessage !== "string") {
+            return false;
+        }
+        const lower = lastUserMessage.toLowerCase();
+        // Trigger phrases that indicate user wants to recall past work
+        const triggers = [
+            // Direct questions about past work
+            "what did you do",
+            "what have you done",
+            "what did we do",
+            "what have we done",
+            // Temporal references
+            "earlier",
+            "before",
+            "previously",
+            "this session",
+            "today",
+            "so far",
+            // Summary requests
+            "remind me",
+            "summarize",
+            "summary of",
+            "recap",
+            // Progress inquiries
+            "your work",
+            "your progress",
+            "accomplished",
+            "achievements",
+            "completed tasks",
+        ];
+        return triggers.some((t) => lower.includes(t));
+    }
+    /**
+     * Format the journal for injection into system message.
+     * Returns null if journal is empty.
+     */
+    format(sessionId) {
+        const journal = this.journals.get(sessionId);
+        if (!journal?.length) {
+            return null;
+        }
+        const lines = journal.map((e) => {
+            const time = new Date(e.timestamp).toLocaleTimeString("en-US", {
+                hour: "2-digit",
+                minute: "2-digit",
+                hour12: true,
+            });
+            return `- ${time}: ${e.action}`;
+        });
+        return `[Session Memory - Key Actions]\n${lines.join("\n")}`;
+    }
+    /**
+     * Get the raw journal entries for a session (for debugging/testing).
+     */
+    getEntries(sessionId) {
+        return this.journals.get(sessionId) || [];
+    }
+    /**
+     * Clear journal for a specific session.
+     */
+    clear(sessionId) {
+        this.journals.delete(sessionId);
+    }
+    /**
+     * Clear all journals.
+     */
+    clearAll() {
+        this.journals.clear();
+    }
+    /**
+     * Get stats about the journal.
+     */
+    getStats() {
+        let totalEntries = 0;
+        for (const entries of this.journals.values()) {
+            totalEntries += entries.length;
+        }
+        return {
+            sessions: this.journals.size,
+            totalEntries,
+        };
+    }
+}
+//# sourceMappingURL=journal.js.map

package/dist/journal.js.map

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

package/dist/journal.test.d.ts

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

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

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

package/dist/journal.test.js

@@ -0,0 +1,201 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { SessionJournal } from "./journal.js";
+describe("SessionJournal", () => {
+    let journal;
+    beforeEach(() => {
+        journal = new SessionJournal();
+    });
+    describe("extractEvents", () => {
+        it("should extract creation events", () => {
+            const content = `I created a new login component for the authentication system.`;
+            const events = journal.extractEvents(content);
+            expect(events).toHaveLength(1);
+            expect(events[0]).toContain("created");
+            expect(events[0]).toContain("login component");
+        });
+        it("should extract fix events", () => {
+            const content = `I fixed the authentication bug that was causing users to be logged out.`;
+            const events = journal.extractEvents(content);
+            expect(events).toHaveLength(1);
+            expect(events[0]).toContain("fixed");
+        });
+        it("should extract multiple events from one response", () => {
+            const content = `I created a new login component. Then I fixed the authentication bug that was causing issues. I also updated the user profile page.`;
+            const events = journal.extractEvents(content);
+            expect(events).toHaveLength(3);
+            expect(events.some((e) => e.includes("created"))).toBe(true);
+            expect(events.some((e) => e.includes("fixed"))).toBe(true);
+            expect(events.some((e) => e.includes("updated"))).toBe(true);
+        });
+        it("should extract success events", () => {
+            const content = `Successfully deployed the application to production.`;
+            const events = journal.extractEvents(content);
+            expect(events).toHaveLength(1);
+            expect(events[0]).toContain("Successfully deployed");
+        });
+        it("should limit to max 5 events per response by default", () => {
+            const content = `
+        I created component A.
+        I fixed bug B.
+        I implemented feature C.
+        I resolved issue D.
+        I added function E.
+        I wrote test F.
+        I built module G.
+      `;
+            const events = journal.extractEvents(content);
+            expect(events.length).toBeLessThanOrEqual(5);
+        });
+        it("should skip events that are too short", () => {
+            const content = `I fixed it.`; // Too short to be meaningful
+            const events = journal.extractEvents(content);
+            expect(events).toHaveLength(0);
+        });
+        it("should handle empty content", () => {
+            const events = journal.extractEvents("");
+            expect(events).toHaveLength(0);
+        });
+        it("should handle null/undefined content", () => {
+            const events = journal.extractEvents(null);
+            expect(events).toHaveLength(0);
+        });
+        it("should deduplicate similar events", () => {
+            const content = `I created a new login component. I also created a new login component for testing.`;
+            const events = journal.extractEvents(content);
+            // Should deduplicate based on normalized content
+            expect(events.length).toBeLessThanOrEqual(2);
+        });
+    });
+    describe("record", () => {
+        it("should record events to a session", () => {
+            journal.record("session1", ["Created login component", "Fixed auth bug"]);
+            const entries = journal.getEntries("session1");
+            expect(entries).toHaveLength(2);
+        });
+        it("should not record empty events", () => {
+            journal.record("session1", []);
+            const entries = journal.getEntries("session1");
+            expect(entries).toHaveLength(0);
+        });
+        it("should not record if sessionId is empty", () => {
+            journal.record("", ["Some event"]);
+            const entries = journal.getEntries("");
+            expect(entries).toHaveLength(0);
+        });
+        it("should store model with events", () => {
+            journal.record("session1", ["Created component"], "gpt-4");
+            const entries = journal.getEntries("session1");
+            expect(entries[0].model).toBe("gpt-4");
+        });
+        it("should append to existing session", () => {
+            journal.record("session1", ["Event 1"]);
+            journal.record("session1", ["Event 2"]);
+            const entries = journal.getEntries("session1");
+            expect(entries).toHaveLength(2);
+        });
+        it("should trim entries when exceeding maxEntries", () => {
+            const customJournal = new SessionJournal({ maxEntries: 3 });
+            customJournal.record("session1", ["Event 1"]);
+            customJournal.record("session1", ["Event 2"]);
+            customJournal.record("session1", ["Event 3"]);
+            customJournal.record("session1", ["Event 4"]);
+            const entries = customJournal.getEntries("session1");
+            expect(entries).toHaveLength(3);
+            // Should keep the most recent
+            expect(entries[2].action).toBe("Event 4");
+        });
+    });
+    describe("needsContext", () => {
+        it("should detect 'what did you do' questions", () => {
+            expect(journal.needsContext("what did you do today?")).toBe(true);
+            expect(journal.needsContext("What did you do earlier?")).toBe(true);
+        });
+        it("should detect 'what have you done' questions", () => {
+            expect(journal.needsContext("what have you done so far?")).toBe(true);
+        });
+        it("should detect temporal references", () => {
+            expect(journal.needsContext("show me what we did earlier")).toBe(true);
+            expect(journal.needsContext("what happened before this?")).toBe(true);
+            expect(journal.needsContext("what did we do previously?")).toBe(true);
+        });
+        it("should detect summary requests", () => {
+            expect(journal.needsContext("can you summarize your work?")).toBe(true);
+            expect(journal.needsContext("remind me what we accomplished")).toBe(true);
+            expect(journal.needsContext("give me a recap")).toBe(true);
+        });
+        it("should detect progress inquiries", () => {
+            expect(journal.needsContext("what's your progress?")).toBe(true);
+            expect(journal.needsContext("what have you accomplished?")).toBe(true);
+        });
+        it("should return false for normal requests", () => {
+            expect(journal.needsContext("please fix this bug")).toBe(false);
+            expect(journal.needsContext("create a new component")).toBe(false);
+            expect(journal.needsContext("what is JavaScript?")).toBe(false);
+        });
+        it("should handle empty input", () => {
+            expect(journal.needsContext("")).toBe(false);
+            expect(journal.needsContext(null)).toBe(false);
+        });
+    });
+    describe("format", () => {
+        it("should return null for empty journal", () => {
+            expect(journal.format("nonexistent")).toBeNull();
+        });
+        it("should format journal entries with timestamps", () => {
+            journal.record("session1", ["Created login component", "Fixed auth bug"]);
+            const formatted = journal.format("session1");
+            expect(formatted).not.toBeNull();
+            expect(formatted).toContain("[Session Memory");
+            expect(formatted).toContain("Created login component");
+            expect(formatted).toContain("Fixed auth bug");
+            // Should contain time format like "10:30 AM"
+            expect(formatted).toMatch(/\d{2}:\d{2}\s*(AM|PM)/i);
+        });
+        it("should format as bullet list", () => {
+            journal.record("session1", ["Event 1"]);
+            const formatted = journal.format("session1");
+            expect(formatted).toContain("- ");
+        });
+    });
+    describe("clear", () => {
+        it("should clear specific session", () => {
+            journal.record("session1", ["Event 1"]);
+            journal.record("session2", ["Event 2"]);
+            journal.clear("session1");
+            expect(journal.getEntries("session1")).toHaveLength(0);
+            expect(journal.getEntries("session2")).toHaveLength(1);
+        });
+    });
+    describe("clearAll", () => {
+        it("should clear all sessions", () => {
+            journal.record("session1", ["Event 1"]);
+            journal.record("session2", ["Event 2"]);
+            journal.clearAll();
+            expect(journal.getEntries("session1")).toHaveLength(0);
+            expect(journal.getEntries("session2")).toHaveLength(0);
+        });
+    });
+    describe("getStats", () => {
+        it("should return correct stats", () => {
+            journal.record("session1", ["Event 1", "Event 2"]);
+            journal.record("session2", ["Event 3"]);
+            const stats = journal.getStats();
+            expect(stats.sessions).toBe(2);
+            expect(stats.totalEntries).toBe(3);
+        });
+        it("should return zero stats for empty journal", () => {
+            const stats = journal.getStats();
+            expect(stats.sessions).toBe(0);
+            expect(stats.totalEntries).toBe(0);
+        });
+    });
+    describe("config options", () => {
+        it("should respect custom maxEventsPerResponse", () => {
+            const customJournal = new SessionJournal({ maxEventsPerResponse: 2 });
+            const content = `I created A. I fixed B. I implemented C. I built D.`;
+            const events = customJournal.extractEvents(content);
+            expect(events.length).toBeLessThanOrEqual(2);
+        });
+    });
+});
+//# sourceMappingURL=journal.test.js.map

package/dist/journal.test.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Usage Logger
+ *
+ * Logs every LLM request as a JSON line to a daily log file.
+ * Files: ~/.openclaw/blockrun/logs/usage-YYYY-MM-DD.jsonl
+ *
+ * MVP: append-only JSON lines. No rotation, no cleanup.
+ * Logging never breaks the request flow — all errors are swallowed.
+ */
+export type UsageEntry = {
+    timestamp: string;
+    model: string;
+    tier: string;
+    cost: number;
+    baselineCost: number;
+    savings: number;
+    latencyMs: number;
+    /** Whether the request completed successfully or ended in an error */
+    status?: "success" | "error";
+    /** Input (prompt) tokens reported by the provider */
+    inputTokens?: number;
+    /** Output (completion) tokens reported by the provider */
+    outputTokens?: number;
+    /** Partner service ID (e.g., "x_users_lookup") — only set for partner API calls */
+    partnerId?: string;
+    /** Partner service name (e.g., "AttentionVC") — only set for partner API calls */
+    service?: string;
+};
+/**
+ * Log a usage entry as a JSON line.
+ */
+export declare function logUsage(entry: UsageEntry): Promise<void>;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IAC7B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAWF;;GAEG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAS/D"}

package/dist/logger.js

@@ -0,0 +1,35 @@
+/**
+ * Usage Logger
+ *
+ * Logs every LLM request as a JSON line to a daily log file.
+ * Files: ~/.openclaw/blockrun/logs/usage-YYYY-MM-DD.jsonl
+ *
+ * MVP: append-only JSON lines. No rotation, no cleanup.
+ * Logging never breaks the request flow — all errors are swallowed.
+ */
+import { appendFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const LOG_DIR = join(homedir(), ".openclaw", "blockrun", "logs");
+let dirReady = false;
+async function ensureDir() {
+    if (dirReady)
+        return;
+    await mkdir(LOG_DIR, { recursive: true });
+    dirReady = true;
+}
+/**
+ * Log a usage entry as a JSON line.
+ */
+export async function logUsage(entry) {
+    try {
+        await ensureDir();
+        const date = entry.timestamp.slice(0, 10); // YYYY-MM-DD
+        const file = join(LOG_DIR, `usage-${date}.jsonl`);
+        await appendFile(file, JSON.stringify(entry) + "\n");
+    }
+    catch {
+        // Never break the request flow
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAsBlC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;AACjE,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB,KAAK,UAAU,SAAS;IACtB,IAAI,QAAQ;QAAE,OAAO;IACrB,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAiB;IAC9C,IAAI,CAAC;QACH,MAAM,SAAS,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,IAAI,QAAQ,CAAC,CAAC;QAClD,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;IACjC,CAAC;AACH,CAAC"}